v5.9 T7 verification — tracker and agent-doc hygiene
Status: docs and tooling verified on Linux; macOS/Herdr checklist is manual and unexecuted Date: 2026-11-05 Ticket: #112 Parent specification: #105 Branch: feat/v59-112 Base: integration/ensemble-v5.9 at a3bcb2c Merged integration tip: b638964 (T5 native-skill ADR, #110)
This record covers the tracker closure rule, the hygiene listing, the handoff reference split, and the repeatable macOS/Herdr checklist. It does not close the parent specification or this ticket. No historical closed specification was reopened, rewritten, or closed by this work.
Environment
| Item | Value |
|---|---|
| OS | Linux |
| Terminal host | tmux 3.5a |
| Node | 26.12.1 |
| npm | 12.2.1 |
| GitHub CLI | authenticated as the ticket-driving account |
macOS/Herdr was unavailable, so the checklist below remains a manual, unexecuted check.
Delivered
| Acceptance area | Result |
|---|---|
| Version-spec closure rule | docs/agents/issue-tracker.md now says when to close a completed version spec, requires the verification record, and keeps the product/reference specification open. |
| Hygiene listing | scripts/issue-hygiene.mjs and npm run issue:hygiene list parent issues whose sub-issues are all closed. --all audits already-closed parents; docs link the rule to the script. |
| Handoff split | AGENTS.md keeps one mandatory handoff line plus a pointer; docs/agents/handoff.md preserves the full delegation, batch-review, loop-guard, and mention contract. |
| macOS/Herdr checklist | docs/verification/macos-herdr-checklist.md covers shortcuts/key ownership, System Agent streaming, palette behavior, and init lifecycle/writes. |
| Recording the gap | The v5.8 verification record and this record link the checklist and mark it manual and unexecuted. The final v5.9 record carries the same link. |
| No historical rewrite | No closed specification was reopened or modified. The v5.6 and v5.7 records are untouched; only the current v5.8 record gained a checklist pointer in its existing "remaining limits" section. |
Commands
| Command | Result |
|---|---|
npm run verify | Pass — strict type check, then 641 tests passed, 0 failed, 0 skipped. |
npm run issue:hygiene | Pass — no open parent issues have all sub-issues closed. This is correct while #105 has 0/7 closed children. |
npm run issue:hygiene -- --all | Pass — identifies the known completed parents, including #99 (5/5, docs/verification/2026-11-05-v58.md), #90 (5/5, docs/verification/2026-11-05-v57.md), and #78 (11/11, docs/verification/2026-11-05-v56.md). |
| Doc link check | Pass — every relative markdown link in the changed documents resolves. |
| TDD hygiene tests | Pass — src/v2/issue-hygiene.test.ts covers open-only filtering, --all with a verification record, a missing version record, the v5/v5.8 filename boundary, and the later fix that requires a spec's own -v59.md record instead of a ticket record. |
The hygiene listing is read-only and uses gh issue list --json subIssuesSummary; it never closes or edits an issue. The --input and --root options let the tests run offline against fixtures.
Doc link check command (bash; checks changed markdown files):
files=$(git ls-files -m -o --exclude-standard -- '*.md')
for f in $files; do
while IFS= read -r link; do
case "$link" in http*|mailto:*|"") continue;; esac
clean=${link%%#*}; [ -z "$clean" ] && continue
[ -e "$(dirname "$f")/$clean" ] || echo "BROKEN: $f -> $link"
done < <(grep -oE '\]\([^)]+' "$f" | cut -c3-)
donemacOS/Herdr checklist
The repeatable checklist covers:
- terminal shortcuts, Herdr collisions, the
Escladder,Ctrl+G, native-key handoff, andF2 - System Agent init progress, terminal report, navigation during streaming, and failure reporting
/and$Agent /palette flags, scoping, grouping, triage, owner picker, and atomic validation- init writes,
.ensemble/init.json,AGENTS.mdidempotence, solo-only and workspace-only rules, cancellation, and restart reconciliation
Status: manual and unexecuted. It is not evidence of macOS/Herdr behavior. Only a recorded run on that host may change its result table from NOT RUN.
Not run / remaining manual check
- macOS/Herdr: not run. This environment is Linux/tmux. The checklist remains the explicit manual gap.
- Live matrices: not re-run for this ticket. The changes are documentation, a read-only GitHub script, and its tests; no product runtime or TUI behavior changed.
npm run verifycovers the script and the existing unit suite.
Tracker state
- #105 (v5.9 specification) remains open: its children are still in progress.
- #112 (this ticket) is not closed by this record.
- #99, #90, #78, and older delivered specifications were not reopened or rewritten.