Skip to content

v5.9.0

Choose a tag to compare

@github-actions github-actions released this 15 Oct 14:55
· 2 commits to main since this release
37f5689

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-ticket again. 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-ticket and /fan-out still 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-ticket outranks 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-ticket text and writes only the old marker. Run /start-ticket again 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-bootcamp pane 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.sh and require-active-ticket.sh entries in .claude/settings.json set onFailure to block with timeouts of 20 and 10 seconds, taken from the profile in docs/perf/hook-fail-closed-profile-2026-10.md. onFailure needs Claude Code 2.1.295 or later. An older client ignores the field. docs/hooks-fail-closed.md describes the behavior, the claude --settings '{"disableAllHooks": true}' escape hatch, and the version finding. bin/hook-timing-profile.py measures hook timing. bin/check-escape-hatch.sh tests the escape hatch. A new workflow runs claude plugin validate --strict on the marketplace with a pinned Claude Code version.
  • bin/token-cost.py reports 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.md gives the usage and the counting rules. The 2026-10-10 baseline is in docs/perf/token-cost-baseline-2026-10-10.md.
  • apexyard-explainer shows one plain sentence for each tool call in a pane (#1661). It uses templates and keeps the last five lines in session memory. /explainer-toggle opens or closes the pane.

Changed

  • Inside dispatch-bash.sh, a crashed or killed require-active-ticket.sh now blocks the Bash call, as the merge gates do. It warned before. block-reviewer-ci-wait.sh stays 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 /status read the marker through one resolver. It finds a marker in a validated tree's git dir without a git process, so GIT_DIR and 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-ticket stops when the project's clone does not exist.
  • /fan-out writer 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-out creates each writer worktree from its task's own repo and writes the markers for it.
  • /approve-merge offers 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.sh skips five process launches whose result is known in advance, so one call of block-merge-on-red-ci.sh takes 81 ms instead of 139 ms on macOS. No gate decision changes. bin/run-hook-tests.sh packs --shard I/N by the measured weights in bin/hook-test-weights.txt and keeps round-robin when that file is missing. Five merge-gate tests write the same mock text in every case. The report is docs/perf/hook-test-profile-2026-10-round2.md.
  • A records PR may use the branch orbit/<initiative-id>-<description> and the title docs(orbit/<initiative-id>): <description> without a ticket (#1673). validate-branch-name.sh, validate-pr-create.sh and the PR title check allow this only when every changed file is under docs/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 carry Initiative: 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

Migration script

  • .claude/migrations/v5.8.0-to-v5.9.0.sh is included (report-only, AgDR-0241), and docs/upgrading.md has a matching row.

Testing

  1. After merge, confirm CI creates tag v5.9.0 on main (the auto-tag-on-release-pr-merge workflow run).
  2. Verify git describe --tags --abbrev=0 upstream/main returns v5.9.0.
  3. Run /release-sync v5.9.0 to sync main back to dev.
  4. 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