missing_docs: fix audit for Astro layout, refresh surface map, document Kitty keyboard protocol

The audit script assumed a `docs/` subdirectory layout and `.md` filenames,
so on the current Astro Starlight tree (`src/content/docs/`, `.mdx`) every
mapped doc resolved as missing. This refreshes the skill so it produces
useful signal again.

- audit_docs.py: resolve doc paths from the repo root, accept .md/.mdx
  interchangeably (and README.md → index.mdx), add --weak-coverage flag
  for the strict keyword check, broaden keyword extraction to handle
  slash-command flags (RewindSlashCommand → /rewind) and UI-suffix flags.
- feature_surface_map.md: update every entry to the actual `.mdx` paths,
  fix `agent-platform/warp-agents/*` mappings that should be either
  `local-agents/*` or `capabilities/*`, add ListSkills/SyncAmbientPlans
  to the ignore list (server-side).
- SKILL.md: document `--weak-coverage` and the `.md`/`.mdx` resolution.
- full-screen-apps.mdx: add a Kitty keyboard protocol section so the
  newly-shipped flag is documented where TUI users will look.

Default audit now runs clean for features/CLI/API; `--weak-coverage`
surfaces ~30 mapped pages where the feature isn't named verbatim, for
follow-up review.

Co-Authored-By: Oz <oz-agent@warp.dev>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: 3 people

.agents/skills/missing_docs/SKILL.md

@@ -21,18 +21,23 @@ Find documentation gaps and draft missing pages in one workflow.
 Run the audit script to identify gaps:
 
 ```bash
-python3 .warp/skills/missing_docs/scripts/audit_docs.py
+python3 .agents/skills/missing_docs/scripts/audit_docs.py
 ```
 
 Options:
 - `--category features|cli|api|staleness` — run a single audit category
 - `--severity high|medium|low` — filter by minimum severity
+- `--weak-coverage` — also flag GA features whose mapped doc exists but doesn't mention feature keywords (low-severity, noisy)
 - `--output report.json` — save JSON report to file
 - `--warp-internal PATH` — explicit path to warp-internal (auto-detected from sibling dirs)
 - `--warp-server PATH` — explicit path to warp-server (auto-detected from sibling dirs)
 
+The script resolves doc paths from the docs repo root and accepts `.md` and `.mdx`
+interchangeably (and `README.md` ↔ `index.mdx`), so surface-map entries can use the
+canonical filename even when the on-disk extension differs.
+
 The script performs 4 audits:
-1. **Feature flag coverage** — compares GA flags in `warp_core/src/features.rs` + `app/Cargo.toml` against doc mentions
+1. **Feature flag coverage** — compares GA flags in `crates/warp_features/src/lib.rs` + `app/Cargo.toml` against the surface map; default mode trusts a mapped entry as verified, `--weak-coverage` additionally checks the target page mentions feature keywords
 2. **CLI command coverage** — compares `warp_cli/src/lib.rs` subcommands against `src/content/docs/reference/cli/`
 3. **API endpoint coverage** — compares `router/router.go` routes against `src/content/docs/reference/api-and-sdk/` and the OpenAPI spec
 4. **Docs staleness** — checks for outdated terminology in existing docs