ambek .planning

2026-10-23 22:37:55 +08:00
parent e512104d5e
commit 275879a18b
54 changed files with 9921 additions and 0 deletions
@@ -0,0 +1,119 @@
+{
+  "canonical_queue": [
+    {
+      "type": "readme",
+      "resolved_path": "README.md",
+      "mode": "create",
+      "preservation_mode": "regenerate",
+      "wave": 1,
+      "status": "verified"
+    },
+    {
+      "type": "architecture",
+      "resolved_path": "docs/ARCHITECTURE.md",
+      "mode": "create",
+      "preservation_mode": null,
+      "wave": 1,
+      "status": "verified"
+    },
+    {
+      "type": "configuration",
+      "resolved_path": "docs/CONFIGURATION.md",
+      "mode": "create",
+      "preservation_mode": null,
+      "wave": 1,
+      "status": "verified"
+    },
+    {
+      "type": "getting_started",
+      "resolved_path": "docs/GETTING-STARTED.md",
+      "mode": "create",
+      "preservation_mode": null,
+      "wave": 2,
+      "status": "verified"
+    },
+    {
+      "type": "development",
+      "resolved_path": "docs/DEVELOPMENT.md",
+      "mode": "create",
+      "preservation_mode": null,
+      "wave": 2,
+      "status": "verified"
+    },
+    {
+      "type": "testing",
+      "resolved_path": "docs/TESTING.md",
+      "mode": "create",
+      "preservation_mode": null,
+      "wave": 2,
+      "status": "verified"
+    },
+    {
+      "type": "readme",
+      "resolved_path": "theme/README.md",
+      "mode": "create",
+      "preservation_mode": null,
+      "wave": 3,
+      "status": "verified",
+      "scope": "per_package",
+      "package_dir": "theme"
+    },
+    {
+      "type": "readme",
+      "resolved_path": "bot/README.md",
+      "mode": "create",
+      "preservation_mode": null,
+      "wave": 3,
+      "status": "verified",
+      "scope": "per_package",
+      "package_dir": "bot"
+    },
+    {
+      "type": "readme",
+      "resolved_path": "web/README.md",
+      "mode": "create",
+      "preservation_mode": null,
+      "wave": 3,
+      "status": "verified",
+      "scope": "per_package",
+      "package_dir": "web"
+    }
+  ],
+  "review_queue": [
+    {
+      "path": "AGENTS.md",
+      "type": "hand-written",
+      "status": "verified"
+    },
+    {
+      "path": "DESIGN.md",
+      "type": "hand-written",
+      "status": "verified"
+    },
+    {
+      "path": "GSD_FIX.md",
+      "type": "hand-written",
+      "status": "verified"
+    },
+    {
+      "path": "IDEAS.md",
+      "type": "hand-written",
+      "status": "verified"
+    }
+  ],
+  "gap_queue": [],
+  "notes": {
+    "user_provided_facts": {
+      "project_display_name": "arah²",
+      "bot_name": "arah2bot",
+      "repo_url": "http://gitmirah:3000/c-fu/arah2.git",
+      "repo_visibility": "private Gitea repo — push EVERYTHING when done"
+    },
+    "style_requirements": "Colored mermaid diagrams wherever diagrams help (architecture, data flow, setup). Mermaid syntax rule: every label inside square brackets MUST be wrapped in double quotes, e.g. A[\"Mini App\"].",
+    "commit_override": "commit_docs=false in config, but user explicitly requested commit + push of everything to the private Gitea repo — commit and push at the end (respect .gitignore: .planning/, dist/, node_modules/ stay out).",
+    "doc_writer_model": "opencode-go/minimax-m3"
+  },
+  "created_at": "2026-10-23T19:04:42+08:00",
+  "fix_iterations": 2,
+  "final_verification": "all 13 docs pass; 2 residual claims corrected by orchestrator (ARCHITECTURE KvLike framing, GSD_FIX 755/843)"
+}
@@ -0,0 +1,7 @@
+{
+  "doc_path": "AGENTS.md",
+  "claims_checked": 78,
+  "claims_passed": 78,
+  "claims_failed": 0,
+  "failures": []
+}
@@ -0,0 +1,14 @@
+{
+  "doc_path": "docs/ARCHITECTURE.md",
+  "claims_checked": 143,
+  "claims_passed": 142,
+  "claims_failed": 1,
+  "failures": [
+    {
+      "line": 433,
+      "claim": "bot/test/commands.test.mjs gates that the `/privacy` copy still matches the `SessionClaim` fields in `sessions.ts`",
+      "expected": "a gate in commands.test.mjs asserting privacy copy against SessionClaim's field names (user_id, chat_id, issued_at, language_code)",
+      "actual": "commands.test.mjs test CS3 asserts only that privacyNotStored names four never-facts (location/routes/history/profile) in both locales, and a second CS3 test asserts '15 minutes'/'15 minit' TTL wording. No assertion references SessionClaim or any of its fields; commands.test.mjs never reads sessions.ts. The copy is instead kept in step by prose convention in bot/src/i18n/strings.ts lines 15-18."
+    }
+  ]
+}
@@ -0,0 +1,14 @@
+{
+  "doc_path": "docs/ARCHITECTURE.md",
+  "claims_checked": 118,
+  "claims_passed": 117,
+  "claims_failed": 1,
+  "failures": [
+    {
+      "line": 348,
+      "claim": "`KvLike` | `bot/src/kv/*.ts` | Structural KV interface — lets tests pass a fake without depending on Workers types",
+      "expected": "listed as a `Key Abstractions` entry, i.e. an importable named export",
+      "actual": "`interface KvLike` exists in both bot/src/kv/sessions.ts:53 and bot/src/kv/location-pin.ts:34 but is NOT exported (module-private). Only the derived `MintSessionKv` / `LocationPinKv` are exported, so no module can import `KvLike`. The structural-KV and fake-test description is otherwise accurate; only the abstraction-table framing is imprecise."
+    }
+  ]
+}
@@ -0,0 +1,7 @@
+{
+  "doc_path": "docs/CONFIGURATION.md",
+  "claims_checked": 96,
+  "claims_passed": 96,
+  "claims_failed": 0,
+  "failures": []
+}
@@ -0,0 +1,38 @@
+{
+  "doc_path": "DESIGN.md",
+  "claims_checked": 14,
+  "claims_passed": 14,
+  "claims_failed": 0,
+  "failures": [],
+  "warnings": [
+    {
+      "line": 69,
+      "claim": "Map Snapshots: Grayscale tiles with accent overlays",
+      "reason": "Partially unverifiable from source. grep for 'grayscale|snapshot' across theme/src and web/src returned zero matches — no grayscale/snapshot feature is implemented. Supporting evidence exists only in prose (AGENTS.md names Maptiler for grayscale snapshots and Cloudflare R2 for storage; thread status: no Maptiler/R2 dependency in any package.json). The implemented basemap (theme/basemap/liberty-rams.json) is a low-saturation color style, not grayscale tiles. Not scored as FAIL because the claim describes a design-system intent, not implemented behavior, and DESIGN.md lines 1-2 explicitly scope the doc to 'Rams design philosophy only'."
+    },
+    {
+      "line": 2,
+      "claim": "Consult the token package (see README.md) for specific value definitions",
+      "reason": "README.md exists and references theme/src/tokens.css 6 times, with sections 'Consuming the design tokens' (line 140) and 'Design system' (line 162). The doc's parenthetical '(see README.md)' is accurate in substance, though README.md has no section literally named 'token package'. Scored PASS on substance."
+    }
+  ],
+  "verified_pass": [
+    "Line 2: README.md exists and documents the token package (theme/src/tokens.css referenced 6x, 'Consuming the design tokens' section at line 140, 'Design system' section at line 162).",
+    "Line 3: '55 color tokens (8 Rams brand colors + Material-style neutrals)' — grep counts exactly 55 '--color-' declarations in theme/src/tokens.css; lines 67-75 define exactly 8 Rams brand tokens (--color-signal-orange, --color-matte-black, --color-soft-beige, --color-functional-red, --color-olive-green, --color-chassis-subtle, --color-surface-dark, --color-pure-white). FIXED (previously FAIL).",
+    "Line 13: '8px baseline grid' — tokens.css line 77 comment: 'Spacing: 8px baseline grid (verbatim; never recomputed — D-07)'; all --spacing-* tokens (lines 78-87) are multiples of 0.25rem/0.5rem/1rem/1.5rem/2rem/3rem.",
+    "Line 21: 'Geist (body) / Space Grotesk (headings and telemetry numbers)' — tokens.css line 93 --font-sans/--font-geist = 'Geist', line 95 --font-space-grotesk = 'Space Grotesk'; headline/display tokens (lines 144-154) all use var(--font-space-grotesk). FIXED (previously claimed Helvetica/Inter, which was false).",
+    "Line 21: 'no Helvetica/Inter anywhere in the design system' — grep -riE 'helvetica|\\binter\\b' across theme/src and web/src returned zero matches.",
+    "Line 25: '14px body (body-md), 20px/32px headings (headline-md/lg), display-lg 48px ... exact scale lives in theme/src/tokens.css' — tokens.css: --type-body-md: 400 14px/20px (line 160), --type-headline-md: 600 20px/26px (line 152), --type-headline-lg: 700 32px/38px (line 148), --type-display-lg: 700 48px/52px (line 144). All four sizes and token names match exactly. FIXED (previously FAIL).",
+    "Line 27: 'Line heights are per-token absolute leading (ratios ~1.08–1.43), defined in theme/src/tokens.css' — every --type-* token uses absolute px leading (e.g. 48px/52px, 32px/38px, 20px/26px, 14px/20px). Computed ratios span 52/48=1.08 (display-lg, the stated floor) to 20/14=1.43 (body-md, the stated ceiling). The stated range is accurate. FIXED (previously claimed 1.4x multiplier, which was false).",
+    "Line 31: Signal Orange #EB8008 — tokens.css line 68 --color-signal-orange: #EB8008 (exact match).",
+    "Line 33: Functional Red #ED3F1C — tokens.css line 71 --color-functional-red: #ED3F1C (exact match).",
+    "Line 35: Olive Green #736B1E — tokens.css line 72 --color-olive-green: #736B1E (exact match).",
+    "Line 37: Soft Beige #D9D2C6 — tokens.css line 70 --color-soft-beige: #D9D2C6 (exact match).",
+    "Line 39: Matte Black #1A1A1A — tokens.css line 69 --color-matte-black: #1A1A1A (exact match).",
+    "Line 43: 'Background: --color-background #FFF8F0 (warm white); Soft Beige #D9D2C6 remains a surface/accent token, not the background' — tokens.css line 64 --color-background: #fff8f0 (exact match); --color-soft-beige (#D9D2C6, line 70) is a distinct surface token. FIXED (previously claimed background was Soft Beige, which was false).",
+    "Line 73: 'Report Event (target flow, not built) ... no /report command exists yet (implemented commands: /start + /mula, /help, /privacy + /privasi)' — grep for '\"(report|navigate)\"' across bot/src returned zero matches; actual bot.command() registrations are exactly start.ts:30 'start', start.ts:31 'mula', help.ts:29 'help', privacy.ts:31 'privacy', privacy.ts:32 'privasi'. Command list is complete and accurate. FIXED (previously asserted /report exists).",
+    "Line 75: 'Navigation (target flow, not built) ... no /navigate command and no routing engine wired in yet (routing-adjacent stack today: MapLibre GL + OpenFreeMap tiles); validated future stack is Valhalla + Photon' — grep -i 'osrm' across bot/src, web/src, theme/src, web/basemap returned zero matches (no routing engine). web/package.json line 14 declares maplibre-gl ^6.15.0. Valhalla/Photon appear in no package.json, consistent with 'validated future stack' framing. FIXED (previously asserted /navigate + OSRM exist).",
+    "Lines 57-61 icon semantics (Accident = Red triangle, Traffic = Orange car, Speed Cam = Green circle) — grep for accident/speedcam/speedtrap across the four stitch mockup code.html files returns matches in 3 files (community_incident_reporter, navigate_map_overview, telegram_live_traffic_feed); the color semantics (red/orange/green per event type) match AGENTS.md's documented event-type convention. Consistent, no contradiction found."
+  ],
+  "notes": "Re-verification after the fix pass: all 7 previously-failing claims are now correct. The doc was rewritten so every numeric/token claim is prefixed by an explicit pointer to theme/src/tokens.css rather than asserting standalone values, and both Interaction Flows (lines 73, 75) now lead with '(target flow, not built)' and enumerate the actually-implemented commands/stack. Grep for the old stale strings ('Helvetica', 'Inter ', '/report ', '/navigate ', 'OSRM', '1.4×', '24px title') returns matches only on lines 21, 73, 75 where they now appear inside accurate negative/clarifying statements — no false assertions remain. The remaining open item is line 69 (Map Snapshots: grayscale tiles), which is design intent with no implementation in theme/ or web/ source; it is out of scope for a philosophy-only doc per lines 1-2, and the low-saturation basemap style is not grayscale, so a future reader could still over-read this line."
+}
@@ -0,0 +1,7 @@
+{
+  "doc_path": "docs/DEVELOPMENT.md",
+  "claims_checked": 132,
+  "claims_passed": 132,
+  "claims_failed": 0,
+  "failures": []
+}
@@ -0,0 +1,7 @@
+{
+  "doc_path": "docs/GETTING-STARTED.md",
+  "claims_checked": 78,
+  "claims_passed": 78,
+  "claims_failed": 0,
+  "failures": []
+}
@@ -0,0 +1,40 @@
+{
+  "doc_path": "docs/GETTING-STARTED.md",
+  "claims_checked": 78,
+  "claims_passed": 76,
+  "claims_failed": 2,
+  "failures": [
+    {
+      "line": 198,
+      "claim": "Register the persistent command menu (English + Bahasa Melayu) once, so `/start`, `/help`, and `/privacy` appear in the Telegram UI",
+      "expected": "`npm run bot:commands` (bot/scripts/register-commands.mjs) registers /start, /help, and /privacy in the Telegram command menu",
+      "actual": "register-commands.mjs registers ONLY two commands. Line 61: `return [\"help\", \"privacy\"].map((command) => {`. Its header comment (lines 9-10) states: \"D-03: the menu lists ONLY commands that exist in this phase (/help, /privacy) — no stub entries reserved for future commands.\" /start is a real command handler (bot/src/bot/commands/start.ts, registered in bot.ts:32) but is deliberately excluded from the persistent menu."
+    },
+    {
+      "line": 292,
+      "claim": "`Missing BOT_TOKEN, WEBHOOK_SECRET, WEBHOOK_URL` and exit code `1`",
+      "expected": "set-webhook.mjs prints exactly `Missing BOT_TOKEN, WEBHOOK_SECRET, WEBHOOK_URL`",
+      "actual": "Variable order differs. bot/scripts/set-webhook.mjs:48 filters `[\"BOT_TOKEN\", \"WEBHOOK_URL\", \"WEBHOOK_SECRET\"]` and line 52 prints `Missing ${missing.join(\", \")}`, so the real output is `Missing BOT_TOKEN, WEBHOOK_URL, WEBHOOK_SECRET`. Exit code 1 (line 53) and the names-only, never-echoing behavior are correct."
+    }
+  ],
+  "warnings": [
+    {
+      "line": 173,
+      "claim": "`npm run deploy --workspace bot` inside the 'Expose the webhook' step",
+      "expected": "a step-appropriate command",
+      "actual": "NPM rejects `--workspace` passed after the script name when combined with this shape, and the surrounding prose immediately retracts it ('which is the wrong tool for local work'). Retracted on the next lines, so not counted as a failure, but the code block itself is misleading — the real invocation is `node bot/scripts/set-webhook.mjs` on line 181."
+    },
+    {
+      "line": 147,
+      "claim": "Unknown paths are 404 — the Worker's fetch handler routes exactly four paths",
+      "expected": "exactly four routed paths",
+      "actual": "Accurate: webhook.ts routes /telegram/webhook (line 57), /api/session (73), /api/location (76), /api/location-fallback (79) — four paths. However `run_worker_first` is [\"/api/*\", \"/telegram/*\"], so the /api/* namespace falls through to the ASSETS binding for unlisted sub-paths; with `not_found_handling: \"none\"` this yields an assets 404 rather than the Worker's own fallthrough. Behavior matches the doc's stated outcome."
+    },
+    {
+      "line": 233,
+      "claim": "the `/api/*` calls stay stubbed under `npm run web:dev`",
+      "expected": "API calls stubbed in Vite dev without a Worker",
+      "actual": "Unverifiable from filesystem alone (runtime fetch behavior). The static basis checks out: web/src/main.ts:228 gates the mock on `(__ARAHARAH_HARNESS__ || import.meta.env.DEV) && !window.__ARAHARAH_MOCK__`, and vite.config.ts defines `__ARAHARAH_HARNESS__` as JSON.stringify(false) outside harness mode, leaving import.meta.env.DEV as the live trigger. Not a false claim, but a runtime assertion."
+    }
+  ]
+}
@@ -0,0 +1,75 @@
+{
+  "doc_path": "GSD_FIX.md",
+  "claims_checked": 24,
+  "claims_passed": 23,
+  "claims_failed": 1,
+  "warnings": [
+    {
+      "line": 28,
+      "claim": "Verified against the running service via `opencode api get /api/command`: every command was registered as `gsd/gsd-*`",
+      "note": "Historical runtime observation about service state prior to the fix. Cannot be re-verified from the filesystem because the pre-fix state no longer exists and the live service was not queried."
+    },
+    {
+      "line": 40,
+      "claim": "OpenCode hot-reloads command files, so the `/gsd-*` names registered immediately (confirmed via the `/api/command` endpoint — 88 flat `gsd-*` commands, zero `gsd/gsd-*` entries).",
+      "note": "Filesystem-verifiable portion CONFIRMED: exactly 88 flat gsd-*.md files exist at ~/.config/opencode/commands/ and zero gsd/gsd-* entries remain. The hot-reload behavior itself is corroborated by the cited OpenCode V2 docs ('OpenCode reloads command files and configuration changes automatically'). The live /api/command enumeration was not re-queried."
+    },
+    {
+      "line": 53,
+      "claim": "Every GSD command/agent shells out to `gsd-sdk query ...`; when the npx cache is pruned, all of those calls die silently.",
+      "note": "PARTIALLY VERIFIED. `gsd-sdk query` invocations are confirmed present in the installed command files (e.g. gsd-manager.md line 34, gsd-workstreams.md lines 39-70). The word 'every' is an overstatement — not all 88 commands invoke gsd-sdk. The 'die silently' failure mode is a behavioral/runtime claim, unverifiable from the filesystem."
+    },
+    {
+      "line": 69,
+      "claim": "That shim has since been removed and is no longer on the current PATH.",
+      "note": "PARTIALLY VERIFIED / potentially misleading. No /mnt/c path segment exists in the current shell PATH and no /mnt/c entry is present in ~/.bashrc, ~/.profile, or ~/.zshrc — consistent with 'no longer on the current PATH'. However, the shim file itself still exists on disk at /mnt/c/Users/C-Fu/AppData/Roaming/npm/gsd-opencode (a POSIX shell script, 415 bytes, dated Jul 13). 'Removed' is accurate only in the PATH sense."
+    },
+    {
+      "line": 83,
+      "claim": "Agents / skills / rules / sdk files — untouched, integrity verified",
+      "note": "PARTIALLY VERIFIED. The directories exist (~/.config/opencode/agents with 33 entries, skills with 12, rules present, sdk present with dist/docs) and `gsd-opencode check` reports all required directories OK with 755 non-command files verified. That 'untouched' implies a before/after diff, which the filesystem cannot supply. Note this row's 755 is not the same figure as line 31's 755/755 — see the line 31 failure."
+    },
+    {
+      "line": 83,
+      "claim": "gsd-sdk CLI — stable symlink to global npm install (`~/.nvm/.../bin/gsd-sdk`)",
+      "note": "CONFIRMED via filesystem: ~/.local/bin/gsd-sdk -> ~/.nvm/versions/node/v24.18.0/bin/gsd-sdk -> ../lib/node_modules/gsd-opencode/bin/gsd-sdk.cjs (the resolved target is a global npm install, not an npx cache path). Functional behavior confirmed: `gsd-sdk query state.load` and `gsd-sdk --version` (v0.1.0) both succeed."
+    }
+  ],
+  "failures": [
+    {
+      "line": 31,
+      "claim": "the installer's `gsd-opencode check` reported 755/755 files intact, which is exactly why the health check did not catch this",
+      "expected": "`gsd-opencode check` reports 755/755 files intact in the pre-fix state",
+      "actual": "No pre-fix state exists to inspect, but the checker's own output format and current run prove the total is 843, not 755: `gsd-opencode check` now prints '\u2713 755/843 files verified' followed by exactly 88 'File not found or unreadable' lines (one per flattened gsd-*.md). 755 is the PASSING subset and 843 the total. The claim that integrity was '755/755' is arithmetically impossible given 88 files were later reported missing from the same 843-file manifest, and the checker's success line is emitted as `${passedCount}/${totalChecked} files verified` (bin/dm/src/commands/check.js line 104). The intended point — that the health check did not flag the namespacing problem — remains correct; only the 755/755 figure is wrong."
+    }
+  ],
+  "passes_detail": {
+    "line_4": "Package `gsd-opencode` v1.38.5 — CONFIRMED: ~/.nvm/versions/node/v24.18.0/lib/node_modules/gsd-opencode/package.json declares \"version\": \"1.38.5\"; `gsd-opencode --version` prints 1.38.5. Install scope '~/.config/opencode/' — CONFIRMED: the commands, agents, skills, rules, and sdk directories are all present there.",
+    "line_14": "The v1.38.5 distribution manager installs the 88 GSD command files into a nested subdirectory — CONFIRMED: 88 files, and the installer's canonical layout is the nested path (bin/dm/lib/constants.js line 135 'New structure: commands/gsd/ (plural)'; structure-detector.js and install.js line 436 use 'commands/gsd').",
+    "line_17": "`~/.config/opencode/commands/gsd/gsd-plan-phase.md` — CONFIRMED as the installer's expected path; correctly no longer exists on disk post-fix (flattening worked as documented).",
+    "line_18": "`~/.config/opencode/commands/gsd/gsd-execute-phase.md` — CONFIRMED likewise; correctly no longer exists.",
+    "line_23": "OpenCode V2 nested-path namespacing is documented at https://opencode.ai/v2/docs/commands/ — CONFIRMED by fetching the URL: 'Nested paths become command names with `/` separators ... Run the nested command as `/team/review`.' The cited URL is correct and states exactly the rule the doc relies on.",
+    "line_25": "`commands/gsd/gsd-execute-phase.md` maps to `/gsd/gsd-execute-phase` — CONFIRMED by the same V2 docs rule.",
+    "line_36": "`mv ~/.config/opencode/commands/gsd/*.md ~/.config/opencode/commands/` — consistent with observed end state: 88 gsd-*.md now sit flat in ~/.config/opencode/commands/.",
+    "line_37": "`rmdir ~/.config/opencode/commands/gsd` — CONFIRMED: the directory no longer exists ('No such file or directory'); only the 88 flat .md files and the commands dir itself remain (total .md count in commands/ = 88).",
+    "line_41": "88 flat gsd-* commands, zero gsd/gsd-* entries — CONFIRMED: `ls ~/.config/opencode/commands/gsd-*.md | wc -l` = 88; all 88 .md files in commands/ are gsd-*; zero nested gsd/ entries.",
+    "line_46": "npx leaves 'global' binaries pointing into `~/.npm/_npx/*.*/node_modules/.bin/` — CONFIRMED: the path pattern exists with 12 cache dirs, including the exact dir cited at line 49 (2ada84fac427087c) which still contains node_modules/.bin/gsd-sdk -> ../gsd-opencode/bin/gsd-sdk.cjs.",
+    "line_49": "`~/.local/bin/gsd-sdk -> ~/.npm/_npx/2ada84fac427087c/node_modules/.bin/gsd-sdk` (the fragile pre-fix state) — CONFIRMED as a historical path that genuinely existed and still exists in the npx cache; the symlink has since been re-pointed (line 59), which is exactly the documented fix.",
+    "line_58": "`npm install -g gsd-opencode` — CONFIRMED: gsd-opencode is installed as a global npm package under the nvm node prefix (lib/node_modules/gsd-opencode) with gsd-opencode/gsd-sdk/gsd-install binaries in ~/.nvm/versions/node/v24.18.0/bin/.",
+    "line_59": "`ln -sf ~/.nvm/versions/node/v24.18.0/bin/gsd-sdk ~/.local/bin/gsd-sdk` — CONFIRMED exactly: readlink shows ~/.local/bin/gsd-sdk -> /home/C-Fu/.nvm/versions/node/v24.18.0/bin/gsd-sdk, and that node version directory genuinely exists.",
+    "line_62": "Verified with `gsd-sdk query state.load` (succeeds) and `gsd-sdk --version` — CONFIRMED by execution: state.load returns JSON config, and --version prints 'gsd-sdk v0.1.0'.",
+    "line_66": "`which gsd-opencode` resolved to a Windows npm shim under `/mnt/c/Users/.../npm/` — CONFIRMED as existing: /mnt/c/Users/C-Fu/AppData/Roaming/npm/gsd-opencode (plus .cmd and .ps1 variants) are present as npm shim scripts.",
+    "line_68": "Linux binaries under `~/.nvm/.../bin` now take precedence for `gsd-sdk` — CONFIRMED: the active ~/.local/bin/gsd-sdk symlink target is under ~/.nvm/versions/node/v24.18.0/bin/.",
+    "line_71": "The installer's health checker still expects the old nested `commands/gsd/` layout — CONFIRMED: `gsd-opencode check` output lists each flattened file under its nested expected path (e.g. 'commands/gsd/gsd-add-backlog.md - File not found or unreadable'), exactly matching constants.js line 135 and structure-detector.js.",
+    "line_74": "The package requires a full OpenCode restart after changing GSD model profiles (agent->model mappings come from opencode.jsonc and are read at startup) — PARTIALLY VERIFIED: ~/.config/opencode/opencode.jsonc exists (123 bytes, dated Oct 22, consistent with a recent profile edit), so the referenced file is real. The 'read at startup / requires restart' behavior is a runtime claim not verifiable from the filesystem; note the same docs page that confirms command hot-reload does state that command/config changes reload automatically, which is in tension with a blanket restart requirement for config changes — flagging as a soft risk.",
+    "line_81": "88 registered flat at ~/.config/opencode/commands/ — CONFIRMED: 88 flat gsd-*.md files, zero nested entries.",
+    "line_84": "`gsd-opencode check` reports false 'missing files' (stale checker) — CONFIRMED: current run reports exactly 88 'File not found or unreadable' lines, all of which are files that verifiably exist at ~/.config/opencode/commands/<name>.md. The 'false positive' characterization is correct."
+  },
+  "metadata": {
+    "project_root": "/home/C-Fu/araharah",
+    "doc_lines": 84,
+    "verification_method": "filesystem only (ls/readlink/find/grep/read), plus read-only execution of `gsd-opencode check`, `gsd-opencode --version`, `gsd-sdk query state.load`, `gsd-sdk --version` to resolve dynamic counts. No project files modified.",
+    "reverification": "fix iteration 2",
+    "accounting_note": "claims_checked counts discrete PASS+FAIL claims only (24). The 'warnings' array holds 6 additional runtime/behavioral or overstatement notes attached to claims that otherwise PASSed on their filesystem-verifiable portions; they are advisory annotations, not extra claims, so claims_checked + warnings intentionally exceeds claims_checked."
+  }
+}
@@ -0,0 +1,7 @@
+{
+  "doc_path": "IDEAS.md",
+  "claims_checked": 26,
+  "claims_passed": 26,
+  "claims_failed": 0,
+  "failures": []
+}
@@ -0,0 +1,7 @@
+{
+  "doc_path": "README.md",
+  "claims_checked": 74,
+  "claims_passed": 74,
+  "claims_failed": 0,
+  "failures": []
+}
@@ -0,0 +1,7 @@
+{
+  "doc_path": "docs/TESTING.md",
+  "claims_checked": 92,
+  "claims_passed": 92,
+  "claims_failed": 0,
+  "failures": []
+}
@@ -0,0 +1,7 @@
+{
+  "doc_path": "bot/README.md",
+  "claims_checked": 68,
+  "claims_passed": 68,
+  "claims_failed": 0,
+  "failures": []
+}
@@ -0,0 +1,7 @@
+{
+  "doc_path": "theme/README.md",
+  "claims_checked": 68,
+  "claims_passed": 68,
+  "claims_failed": 0,
+  "failures": []
+}
@@ -0,0 +1,7 @@
+{
+  "doc_path": "web/README.md",
+  "claims_checked": 62,
+  "claims_passed": 62,
+  "claims_failed": 0,
+  "failures": []
+}