Skip to content

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 ​

ItemValue
OSLinux
Terminal hosttmux 3.5a
Node26.12.1
npm12.2.1
GitHub CLIauthenticated as the ticket-driving account

macOS/Herdr was unavailable, so the checklist below remains a manual, unexecuted check.

Delivered ​

Acceptance areaResult
Version-spec closure ruledocs/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 listingscripts/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 splitAGENTS.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 checklistdocs/verification/macos-herdr-checklist.md covers shortcuts/key ownership, System Agent streaming, palette behavior, and init lifecycle/writes.
Recording the gapThe 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 rewriteNo 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 ​

CommandResult
npm run verifyPass — strict type check, then 641 tests passed, 0 failed, 0 skipped.
npm run issue:hygienePass — no open parent issues have all sub-issues closed. This is correct while #105 has 0/7 closed children.
npm run issue:hygiene -- --allPass — 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 checkPass — every relative markdown link in the changed documents resolves.
TDD hygiene testsPass — 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):

sh
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-)
done

macOS/Herdr checklist ​

The repeatable checklist covers:

  • terminal shortcuts, Herdr collisions, the Esc ladder, Ctrl+G, native-key handoff, and F2
  • 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.md idempotence, 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 verify covers 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.

Released under the MIT License.