Repository navigation
v5.9.0
Minor release — 25 features, 6 fixes, 41 improvements.
Behaviour change: the active ticket now lives in each working tree's git dir (#1576, AgDR-0222). /start-ticket writes apexyard-ticket into the git dir of the tree you run it in. Each linked worktree needs its own /start-ticket. git worktree remove deletes the marker with the worktree.
Upgrade notes
- After you run
/update, read/start-ticketagain. It now writes two markers. - Nothing that passed the ticket gate before this release is blocked by it. Old markers under
.claude/session/are still read wherever they were read before. A marker in a tree's git dir wins over them. /start-ticketand/fan-outstill write the old markers too. A rollback to the previous release, or a session that still runs the old hooks after/update, keeps its ticket.- A SessionStart notice lists the old markers it finds. It is information, not an error.
- A stale
<git dir>/apexyard-ticketoutranks a newer old-layout file in two cases. One is a rollback followed by a second/update. The other is a session that follows the old/start-tickettext and writes only the old marker. Run/start-ticketagain in each tree, or delete the stale marker. A staleness check is a follow-up (follow-up: to be filed). - The SessionStart notice lists only old markers that no marker in the same tree's git dir shadows.
- A later, explicitly breaking release stops reading and writing the old markers. Its upgrade notes will say so.
Added
- The optional
apexyard-bootcamppane guides students through nine Corner Shop modules (#1680). Commands control navigation. Matching tool calls tick checkpoints. The store keeps progress across restarts. - The Bash dispatcher and the ticket-first gate fail closed (#1623, AgDR-0228). The
dispatch-bash.shandrequire-active-ticket.shentries in.claude/settings.jsonsetonFailuretoblockwith timeouts of 20 and 10 seconds, taken from the profile indocs/perf/hook-fail-closed-profile-2026-10.md.onFailureneeds Claude Code 2.1.295 or later. An older client ignores the field.docs/hooks-fail-closed.mddescribes the behavior, theclaude --settings '{"disableAllHooks": true}'escape hatch, and the version finding.bin/hook-timing-profile.pymeasures hook timing.bin/check-escape-hatch.shtests the escape hatch. A new workflow runsclaude plugin validate --stricton the marketplace with a pinned Claude Code version. bin/token-cost.pyreports the token and time cost of a session (#1624). It has a session view, a reviewer view and a forge view of me2resh/apexyard PRs.docs/perf/token-cost.mdgives the usage and the counting rules. The 2026-10-10 baseline is indocs/perf/token-cost-baseline-2026-10-10.md.apexyard-explainershows one plain sentence for each tool call in a pane (#1661). It uses templates and keeps the last five lines in session memory./explainer-toggleopens or closes the pane.
Changed
- Inside
dispatch-bash.sh, a crashed or killedrequire-active-ticket.shnow blocks the Bash call, as the merge gates do. It warned before.block-reviewer-ci-wait.shstays fail open on purpose, because it is a cost guard (#1623). - The ticket gate, the migration gate, the AgDR spike exemptions, the tracker-repo guard and
/statusread the marker through one resolver. It finds a marker in a validated tree's git dir without a git process, soGIT_DIRand git config cannot redirect that lookup. The old-layout resolution keeps its old git calls until the breaking release. - A marker in a git dir counts only for the ops fork and registered clones. A registered clone sits under the workspace dir, or at the
workspace:path of its registry entry. Other trees use the old markers, as before. - The marker's repo must belong to its tree. A project clone takes only a ticket of its own registry entry, and the ops fork takes no ticket of a registered project.
/start-ticketstops when the project's clone does not exist. /fan-outwriter worktrees under.claude/worktrees/are gated since AgDR-0219, and the helper writes both markers for them.- A spike marker in one project no longer exempts a change in another project.
/fan-outcreates each writer worktree from its task's own repo and writes the markers for it./approve-mergeoffers to remove the merged PR's worktree. It asks first and never uses--force.- The macOS hook test run is cheaper (#1613, AgDR-0229).
_lib-extract-pr.shskips five process launches whose result is known in advance, so one call ofblock-merge-on-red-ci.shtakes 81 ms instead of 139 ms on macOS. No gate decision changes.bin/run-hook-tests.shpacks--shard I/Nby the measured weights inbin/hook-test-weights.txtand keeps round-robin when that file is missing. Five merge-gate tests write the same mock text in every case. The report isdocs/perf/hook-test-profile-2026-10-round2.md. - A records PR may use the branch
orbit/<initiative-id>-<description>and the titledocs(orbit/<initiative-id>): <description>without a ticket (#1673).validate-branch-name.sh,validate-pr-create.shand the PR title check allow this only when every changed file is underdocs/orbit/. They compare the branch with a remote-tracking trunk ref. They block when they cannot tell, and the message names the normal{type}/{TICKET-ID}-{description}shape. The branch resolves the longest existing Plan ID prefix and blocks unknown initiatives. The PR body and commits carryInitiative: plan-<initiative-id>. Records lint blocks cross-initiative records and unreferenced snapshots. Review gates, merge gates and per-PR approval do not change.
Added (feat)
- (#1722) ship the hardened typescript-nextjs starter — 454515c
- (#1721) let a slice PR propose the next slice — 9c60047
- (#1716) generate a project at the stack-agnostic floor — 1ddd8d7
- (#1714) let a slice PR carry its own ORBIT progress — fa31b70
- (#1709) add the hosting-first /scaffold interview and scaffold spec — 27de5bd
- (#1689) approve a merge or design review from a menu — f08a17d
- (#1685) let a sanctioned reviewer write to its session scratchpad — 3bae741
- (#1687) write the rule-body exclude per clone — d83489f
- (#1688) let agent reviews post as an opt-in GitHub App — e7d1c5f
- (#1681) add the Bootcamp pane, a guided presentation beside the session — d1cea51
- (#1678) start review and audit agents lean and trim Hakim and Tariq — e6ce53c
- (#1666) add the apexyard-explainer pane plugin — 832ed3b
- (#1676) ORBIT pane shows initiatives and work in flight — 739888b
- (#1663) make the skill bodies on the execution path short — e1d1f3a
- (#1652) trim Rex input tokens with omitClaudeMd and a floor-rules block — 9b25c83
- (#1651) run reviews in parallel by detecting review agents by type — 425a4ab
- (#1648) fail closed on the dispatcher and ticket-first gates — 4892938
- (#1631) add the apexyard-status band as a fork-only plugin — 919081a
- (#1634) reviewers check CI once and never wait — be687ba
- (#1633) add one script that reports token and time cost — f76b86f
- (#1630) add records lint, cycle PR flow and live status to /orbit — 49c39ad
- (#1629) mine Rex-approved commits that Hakim or Tariq rejected — bbb2ba4
- (#1608) add the apexyard plugin marketplace with the orbit plugin — d5b2095
- (#1584) store the ticket marker in each working tree's git dir — c40c4c7
- (#1583) load a managed project's context on first touch — ea23721
Fixed (fix)
- (#1672) add a blank line after a new Checks heading — 3ae6d00
- (#1668) read a brace for body like do in the reviewer CI-wait guard — 1b5454a
- (#1657) treat jq arguments as data in merge-command detection — 2854837
- (#1642) lint only changed text fields in records — 3e92ebe
- (#1606) govern ORBIT ticket prefixes from orbit.governed_prefixes — d276b2f
- (#1607) read every repo flag spelling in the merge gates — 4882614
Changed (refactor / chore / docs)
- (#1719) cut the o2 starter slice — 5929007
- (#1717) slice PRs propose the next slice (revision 5) — 7d1e09d
- (#1712) let Rex review a Reconciliation in the PR diff (revision 4) — 31804de
- (#1711) show slice progress at merge (revision 4) — 73267cc
- (#1710) name the initiative, reconcile o1 and cut the o2 floor slice — 0890c02
- (#1707) revision 2 and slice o1 — a9e9ab1
- (#1695) require a recorded operator interview before a Plan revision — 7fa4e16
- (#1667) fix disagreement miner grouping and verdict edge cases — e68ea13
- (#1691) light CI per PR, full matrix on merge, nightly and release — 14e0953
- (#1693) add scaffold initiative records — 81b0e54
- (#1692) reconcile o6 evidence — a64323a
- (#1686) keep ORBIT criteria short and record proof separately — edf0619
- (#1675) allow orbit/ records branches without a ticket — e3e2a60
- (#1683) accept a chain of clean base merges in carry-over — cba7a49
- (#1684) keep zsh path variables raw and silence the zsh export warning — e93df70
- (#1679) refresh ready-to-merge PRs after each merge — 400db9b
- (#1670) add the o5 effort spike and o2 build slices — 7ace6ba
- (#1659) cut macOS hook test cost with exact fast paths and weighted shards — 0eda785
- (#1656) close remaining reviewer CI-wait patterns and cut hook cost — 3a31d4e
- (#1658) let adopters add review agent types to the review lock — d740fbe
- (#1655) make the handoff leak-scrub test prove the scrub works — 5c7bee7
- (#1654) add the o5 and o6 slices and reconcile the token plan at 9b25c83 — d2af086
- (#1646) record the auto-compaction window spike and recommended setting — 8c7ef8b
- (#1647) add the o9 slice so reviews run in parallel — 7d314c0
- (#1645) record AgDR-0226, the ORBIT Initiative replaces Plan — ba80f6c
- (#1643) check Rex carry-over before a refresh re-review — cf3e407
- (#1635) record token plan r3 cycle after o1, o4 and o8 merged — db03eb0
- (#1628) reconcile the orbit-build plan at 49a2979 — 0234ea5
- (#1622) record token plan r2 cycle with AgDR-0225 — 49a2979
- (#1621) add the o1 slice of the token-efficiency plan — 692c17e
- (#1620) record the ORBIT plan for token efficiency — 9ae097a
- (#1617) record the ORBIT plan for gate hardening and golden paths — bace9db
- (#1615) profile the slowest hook tests and cut redundant work — 6d2ef1b
- (#1614) split the macOS hook-test job into four shards — 53f0bae
- (#1610) share one quoted-flag parser across four hooks — 2fe379f
- (#1611) share one awk-with-fallback helper and one line join — 20f721c
- (#1605) bump TypeScript to 7.0.2 in both harness adapters — 7a14213
- (#1609) bound project-context reads and read frontmatter safely — 072b440
- (#1600) credit NagyWesley as a code contributor — 7771238
- (#1602) batch the harness-adapter minor and patch bumps — 02392d0
- (#1597) credit new contributors and issue authors in the README — f3b2361
Closes
- Closes #1576
- Closes #1585
- Closes #1586
- Closes #1587
- Closes #1588
- Closes #1596
- Closes #1598
- Closes #1599
- Closes #1601
- Closes #1603
- Closes #1604
Migration script
-
.claude/migrations/v5.8.0-to-v5.9.0.shis included (report-only, AgDR-0241), anddocs/upgrading.mdhas a matching row.
Testing
- After merge, confirm CI creates tag
v5.9.0onmain(theauto-tag-on-release-pr-mergeworkflow run). - Verify
git describe --tags --abbrev=0 upstream/mainreturnsv5.9.0. - Run
/release-sync v5.9.0to syncmainback todev. - Verify the squash commit carries the trailer:
git log -1 --pretty=format:'%(trailers:key=Released-From,valueonly)' v5.9.0.
Refs #1728
Glossary
| Term | Definition |
|---|---|
| Squash merge | GitHub merges all commits on the PR branch into one new commit on main |
| Auto-tag | The workflow that tags the squash commit and creates the GitHub Release after the release PR merges |
/release-sync |
The follow-up skill that merges main back into dev after a squash-merge release |
Released-From trailer |
A commit trailer that records the exact dev SHA the release was cut from |
Released-From: 454515c