nntrivi2001
c7dbaf2d9f
Two leftovers from the rebrand, done together because they touch the same docs and manifests. **Data directory.** `agent-dashboard` could not simply be renamed in the source: it names a real directory holding the live SQLite database. Startup now moves it once, via `migrateLegacyDataDir()` in `server/lib/claude-home.js` — a same-filesystem rename, so it is instant even at multiple gigabytes and cannot leave two divergent copies. `getDataDir()` stays PURE and resolves to the legacy path until the move happens; the first version of this put the rename inside the getter, which meant `npm run test:server` relocated the developer's real database as a side effect. The call sits behind `require.main === module` and ahead of the router requires, because those pull in db.js, which opens SQLite at module load. A failed rename is silent and the old directory keeps being used: an unfashionable directory name beats a blank database beside an unreachable one. Same treatment for the port-discovery file (`.agent-dashboard.json` → `.agenthub.json`, old one dropped on write). Not renamed on purpose: the Sagi localStorage keys (renaming silently resets everyone's prefs) and the PWA manifest `id` (changing it orphans an installed app). **MCP server.** 4 tool calls in 46 days across 577,132 events, against 4,556 lines of TypeScript, a 2 MB committed build artifact, and a pre-commit guard that had already blocked commits twice. Deleted: `mcp/`, the maintainer skills and `mcp-reviewer` agent, the build check, `plugins/agenthub/.mcp.json`, `docs/MCP.md`, 12 npm scripts, 5 Makefile targets, and every doc section describing it. Kept, because they are unrelated things sharing the name: the Config Explorer's MCP tab and its API, per-lane Playwright MCP, the agenthub-config plugin's MCP audit, and the historical `mcp__plugin_agenthub_*` events that analytics must keep attributing. Verified: server 1432/1432, client 459/459, tsc clean, prettier clean. Both directions of the migration proven — a sandbox-HOME test run leaves the legacy directory untouched, and a real boot moves it with its contents intact.
57 lines
1.6 KiB
Bash
Executable File
57 lines
1.6 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# doc-coverage.sh — verify that one or more terms (a new env var, event type,
|
|
# route, identifier, feature name, …) are documented across this repo's
|
|
# canonical doc surface. Prints a HIT/miss matrix so a docs update can be
|
|
# checked for "full coverage" before finishing.
|
|
#
|
|
# Usage:
|
|
# skills/update-project-docs/scripts/doc-coverage.sh DASHBOARD_SESSION_SYNC_MS
|
|
# skills/update-project-docs/scripts/doc-coverage.sh Interrupted pendingInterrupt
|
|
#
|
|
# Run from the repo root. Exit code is non-zero if any term is missing from a
|
|
# doc that the change-type mapping (see references/doc-map.md) says it belongs
|
|
# in — but treat the matrix as advisory: not every term belongs in every file.
|
|
# @author Nguyễn Ngọc Trí Vĩ <vinnt@smartgift.vn>
|
|
|
|
set -u
|
|
|
|
# The canonical doc set kept in sync. Translations + HTML + per-area READMEs.
|
|
DOCS=(
|
|
"README.md"
|
|
"ARCHITECTURE.md"
|
|
"server/README.md"
|
|
"client/README.md"
|
|
"docs/HOOKS.md"
|
|
"docs/DATABASE.md"
|
|
"docs/API.md"
|
|
"docs/PLUGINS.md"
|
|
"docs/I18N.md"
|
|
".env.example"
|
|
)
|
|
|
|
if [ "$#" -eq 0 ]; then
|
|
echo "usage: $0 <term> [term2 ...]" >&2
|
|
exit 2
|
|
fi
|
|
|
|
missing_any=0
|
|
for term in "$@"; do
|
|
echo "── coverage for: $term ──────────────────────────────"
|
|
for doc in "${DOCS[@]}"; do
|
|
if [ ! -f "$doc" ]; then
|
|
printf " %-26s (absent)\n" "$doc"
|
|
continue
|
|
fi
|
|
n=$(grep -Fc -- "$term" "$doc" 2>/dev/null || true)
|
|
n=${n:-0}
|
|
if [ "$n" -gt 0 ]; then
|
|
printf " ✅ %-26s %s\n" "$doc" "$n"
|
|
else
|
|
printf " · %-26s 0\n" "$doc"
|
|
fi
|
|
done
|
|
echo
|
|
done
|
|
|
|
exit $missing_any
|