Merge pull request #275 from Wolfvin/docs/agent-facing-subcheck-accuracy

docs: agent-facing sub-check accuracy (css/a11y/diagnostics/overview) + dropped-query fixes

Author: Wolfvin

README.md

@@ -109,9 +109,9 @@ CodeLens consolidates what used to be ~78 separate commands into **12 umbrella c
 |---|---|---|
 | `scan` | scan (default) · rescan | Build/refresh the workspace graph. Everything else depends on this having run once. |
 | `search` | semantic (default) · symbol · regex · graph | The grep replacement. `pattern` comes **first**, workspace second — opposite of every other command below. See [gotcha](#a-gotcha-worth-memorizing). |
-| `context` | orient (default) · outline · trace · context | Orientation, file structure, call-chain tracing, rich symbol context. |
+| `context` | orient (default) · outline · trace · context · diagnostics · overview | Orientation, file structure, call-chain tracing, rich symbol context, LSP diagnostics (`--file`), token-efficient symbol map. |
 | `deps` | affected · dependents · circular (default: all three) · import-snapshot · export-snapshot | Dependency graph: what's affected by a change, who imports what, circular imports, team snapshot sharing. |
-| `audit` | dead-code · complexity · smell · staleness · perf-hint · side-effect (default: all) | Code quality. `dead-code` cross-checked against `context --check trace` before you trust it. |
+| `audit` | dead-code · complexity · smell · staleness · perf-hint · side-effect · css · a11y (default: all) | Code quality. `dead-code` cross-checked against `context --check trace` before you trust it. `css` = deep CSS analysis, `a11y` = WCAG 2.1 accessibility. |
 | `security` | secrets · vuln-scan · taint · binary-scan · regex-audit (default: all) | Hardcoded secrets, CVE/OSV dependency scanning, AST taint analysis, ReDoS. **Taint is Python/JS/TS/TSX only** — no Rust source/sink rules yet. |
 | `summary` | summary (default) · dashboard · arch-metrics · architecture | Prioritized, anti-overload findings digest. Use `--lite` — it's designed to still be big without it. |
 | `impact` | impact (default) · diff · dataflow | Blast-radius analysis before you touch something. |

SKILL-QUICK.md

@@ -105,9 +105,9 @@ codelens search "pattern" . --mode regex --limit 5 --offset 10 --format compact
 |---|---|
 | `scan` | scan (default) · rescan |
 | `search "pattern" [workspace]` | semantic (default) · symbol · regex · graph — **pattern first, workspace second**, opposite of every command below |
-| `context [workspace]` | orient (default) · outline · trace (`--name X --direction up\|down\|both`) · context (`--name X`) |
+| `context [workspace]` | orient (default) · outline · trace (`--name X --direction up\|down\|both`) · context (`--name X`) · diagnostics (`--file X`, LSP) · overview (symbol map) |
 | `deps [workspace]` | affected (`--files ...`) · dependents (`--files ...`) · circular · import-snapshot (`--input path.gz`) · export-snapshot (`--output path.gz`) |
-| `audit [workspace]` | dead-code · complexity · smell · staleness · perf-hint · side-effect |
+| `audit [workspace]` | dead-code · complexity · smell · staleness · perf-hint · side-effect · css · a11y |
 | `security [workspace]` | secrets · vuln-scan · taint · binary-scan · regex-audit |
 | `summary [workspace]` | summary (default) · dashboard · arch-metrics · architecture |
 | `impact [workspace]` | impact (`--name X`, default) · diff · dataflow |

SKILL.md

@@ -43,9 +43,9 @@ codelens guard --pre --file X           →  DROPPED
 |---|---|
 | `scan` | scan (default) · rescan |
 | `search` | semantic (default) · symbol · regex · graph — **`pattern` comes first, workspace second**, opposite of every other command here |
-| `context` | orient (default) · outline · trace · context |
+| `context` | orient (default) · outline · trace · context · diagnostics (LSP lint, needs `--file`) · overview (token-efficient symbol map) |
 | `deps` | affected · dependents · circular (default: all three) · import-snapshot · export-snapshot |
-| `audit` | dead-code · complexity · smell · staleness · perf-hint · side-effect (default: all) |
+| `audit` | dead-code · complexity · smell · staleness · perf-hint · side-effect · css (deep CSS) · a11y (WCAG 2.1) (default: all) |
 | `security` | secrets · vuln-scan · taint · binary-scan · regex-audit (default: all) |
 | `summary` | summary (default) · dashboard · arch-metrics · architecture |
 | `impact` | impact (default) · diff · dataflow |

docs/install.md

@@ -12,9 +12,9 @@ This installs the `codelens` console command and all core dependencies.
 After install, run:
 
 ```bash
-codelens init /path/to/your/project
-codelens scan /path/to/your/project
-codelens query MyFunction /path/to/your/project
+codelens scan /path/to/your/project                       # builds the graph (also auto-inits)
+codelens search "MyFunction" /path/to/your/project --mode symbol
+codelens context /path/to/your/project --check context --name MyFunction
 ```
 
 ### With optional features

docs/installation/docker.md

@@ -96,7 +96,7 @@ registry without re-scanning:
 docker run --rm \
   -v "$(pwd):/workspace" \
   -v codelens-data:/home/codelens/.codelens \
-  ghcr.io/wolfvin/codelens query 'btn-primary' /workspace
+  ghcr.io/wolfvin/codelens search 'btn-primary' /workspace
 ```
 
 ### Shell alias
@@ -107,7 +107,7 @@ Add to `~/.bashrc` or `~/.zshrc`:
 alias codelens='docker run --rm -v "$(pwd):/workspace" -v codelens-data:/home/codelens/.codelens ghcr.io/wolfvin/codelens'
 ```
 
-Then use `codelens scan .`, `codelens query 'fn' .`, etc. exactly as if it
+Then use `codelens scan .`, `codelens search 'fn' .`, etc. exactly as if it
 were a locally installed binary.
 
 ### Deep analysis with LSP (maximal image only)