v4.6.0

v4.6.0 (2026-07-12)

• fix(release): make the documented install path provably work end to end (#327)
• fix(bootstrap): clear error when --version ref is missing (#326)
• chore: archive closed plans (#322)
• Ratchet planning — pending issues (#323)
• feat(herd): combined character cards, modal log console, config-reload resilience (port of the downstream dashboard iteration) (#321)
• plan: revise 0136 to the delivered dashboard design (modal log, combined cards) (#320)
• Ratchet planning — pending issues (#318)
• feat(herd-ui): flip dashboard columns — agents/workers/logs left, errors right, 100vh scroll regions (#317)
• Ratchet planning — pending issues (#315)
• feat(herd-ui): show worked issue number and worker status on agent cards (#314)
• Lay out errors & escalations top-left with active agents to the right (#313)
• fix(workflows): grant contents:read to four framework workflows (#312)
• fix(herd-ui): rename dashboard header to "Ratchet herd dashboard" (#311)
• feat(herd-ui): supervisor status details, live dot green when online (#309)
• plan: four framework workflows drop contents:read, checkout fails (#308)
• Ratchet planning — pending issues (#303)
• feat: herd deck cards track live workers, not configured roster (#302)
• Create index.html (#301)
• Ratchet planning — pending issues (#299)
• feat: ship mascots/ to host projects via install manifest (#298)
• feat(herd-ui): vinyl-figure mascot deck with pop-out treatment (#297)
• fix: reflect herd.json avatar edits on the dashboard without a restart (#296)
• fix: deck header tally counts live workers, vitals label reads Launched (#295)
• fix: keep herd heartbeat alive across the dispatch claim wait (#285) (#294)
• fix: short-circuit herd claim wait when the worker exits early (#293)
• Ratchet planning — pending issues (#292)
• Ratchet/mascot (#290)
• Ratchet planning — pending issues (#284)
• feat(herd-ui): add the Active Agents mascot deck (#276) (#283)
• feat(herd-ui): Santorini reskin — incidents aside & log console (#282)
• feat(herd-ui): Santorini reskin — sections, summary strip, work rows (#281)
• feat(herd-ui): Santorini reskin foundation — palette, type, header, grid (#280)
• plan: split herd dashboard Santorini reskin into 3 slices (#277)
• Ratchet planning — pending issues (#274)
• docs: require branch update onto main before review; document conflicted-PR CI gap (#273)
• feat: scheduled reconciliation sweep for missed Request Changes verdicts (#272)
• feat: label conflicted open PRs on a schedule (#271)
• fix: review-verdict workflow cannot check out the repo — grant contents:read (#270)
• Ratchet planning — pending issues (#265)
• chore: archive closed plans (#264)
• fix: stop plugin descriptions from naming a stale subset of skills (#263)
• Closes #260 (#262)
• Ratchet planning — pending issues (#259)
• docs: bootstrap install/update/uninstall flow + e2e lifecycle test (#258)
• feat: hash-based modified-file protection for ratchet-update (#257)
• fix: strip CI credentials from pr-size-check.test.mjs subprocess env (#256)
• Ratchet planning — pending issues (#254)
• feat: manifest- and profile-aware ratchet-update (#253)
• feat: manifest-driven ratchet-uninstall (#252)
• test(manifest-check): add per-criterion tests for #248 (#251)
• Ratchet planning — pending issues (#249)
• Ratchet planning — pending issues (#247)
• feat(bootstrap): scaffold generated files with clean templates (#246)
• Separate runtime scripts from framework tests and development files (#245)
• Build a bootstrap installer that installs Ratchet into a host project (#244)
• Define the canonical install manifest and core/optional profiles (#243)
• Ratchet planning — pending issues (#235)
• Move RTK guidance into memory (#234)
• Ratchet planning — pending issues (#232)
• fix: record resolved update version (#231)
• Fix gate parsing with extra tables (#230)
• docs: document remaining knobs and fix workflow inventory drift (#229)
• fix: release from version bump commit (#228)
• Degrade the size check gracefully on API failure and document glob rules (#227)
• fix(gates): make all-TODO run red in PR checks list (#226)
• feat: fail verification when framework version strings disagree (#82) (#225)
• feat: desktop notification on new herd escalation (#183) (#224)
• feat: one-glance summary strip on the herd dashboard (#177) (#222)
• Bound events.jsonl and herd-escalations.md growth with retention (#175) (#223)
• feat: escalation blocks get copy-command and acknowledge actions (#221)
• feat: aggregate repeated adapter failures into one per-adapter alert (#185) (#220)
• Herd reacts to PR review verdicts — changes-requested triggers rework (#193) (#219)
• feat: state-set instructions remove the previous state label (#213) (#218)
• fix: herd-ui self-count must not read an archivable plan file at runtime (#217)
• feat: review-verdict workflow flips issue to changes-requested (#216)
• Enforce mutually exclusive state:* labels (#207) (#215)
• feat: exclude generated skill mirrors from pr-size-check (#212) (#214)
• Ratchet planning — pending issues (#211)
• feat(herd-ui): deduplicate and auto-resolve escalations (#210)
• Per-issue activity timeline from the event stream (#209)
• Show per-worker cost and token usage in the herd dashboard (#208)
• Ready-for-review rows show PR CI status (#204)
• feat(herd): dashboard shows a supervisor heartbeat, not just UI-server liveness (#201)
• feat(herd): group dashboard rows by lifecycle — live first, terminal last (#205)
• Ratchet planning — pending issues (#206)
• Worker rows show issue titles, not bare numbers (#200)
• fix(herd): anchor .ratchet paths at the repo root, not the cwd (#202)
• Stale-claim detection distinguishes closed issues from blocked open ones (#199)
• feat(herd-ui): search and filter in the worker log drill-down (#203)
• fix(herd): stop survey/monitor ping-pong re-escalating stale claims (#195)
• feat(herd): per-adapter mascot avatars in the dashboard (#188)
• Dashboard shows claim age only for live workers, last activity for the rest (#198)
• plan: review-verdict label workflow (0098); 0097 defers label flip to it (#196)
• fix: prune terminal herd state entries with no pid and no open PR (#194)
• Ratchet planning — pending issues (#192)
• Show herd errors and escalations in a toggleable side panel (#190)
• plan: fix herd-ui.test coupling to archived plan file (0096) (#189)
• feat(herd): capture per-worker cost and token usage on the exit event (#187)
• Ratchet planning — pending issues (#186)
• chore: archive closed plans (#167)
• Ratchet planning — pending issues (#168)
• Ratchet planning — pending issues (#162)
• Round-robin herd dispatch across available adapters (#156) (#161)
• Document an opencode/OpenRouter herd adapter as a claude→codex fallback (#160)
• Fall back to the next available herd adapter when the preferred one is unavailable (#159)
• Ratchet planning — pending issues (#157)
• feat: pin a herd adapter to a model via {model} placeholder (#155) (#158)
• Ratchet planning — pending issues (#154)
• feat: default herd adapters let a headless worker claim without a permission prompt (#153)
• Ratchet planning — pending issues (#150)
• Ratchet planning — pending issues (#148)
• feat: local web dashboard for the herd (scripts/herd-ui.mjs) (#147)
• Emit herd event stream (#146)
• feat: detect and escalate stale agent/issue-N claim branches (#138) (#145)
• feat: bound herd worker log growth with a retention knob (#141)
• Ratchet planning — pending issues (#142)
• fix: prune concluded herd state entries so re-queued issues dispatch again (#140)
• Ratchet planning — pending issues (#136)
• Pin the herd worker prompt to its dispatched issue (#135)
• fix: name the missing claim ref in the dispatch-timeout escalation (#134)
• Ratchet planning — pending issues (#131)
• chore: bump framework version 3.4.0 -> 3.4.1 (#130)
• Detect herd worker claims by the branch ref, not the state:ready label (#129)
• fix: survive a herd worker spawn failure instead of crashing the supervisor (#128)
• Ratchet planning — pending issues (#125)
• feat: bump framework version to 3.4.0 for herd supervisor series (#124)
• Guard cross-agent skill parity so every skill works on all three agents (#123)
• fix: stop ratchet-update from overwriting a consumer's .env.example (#122)
• Ratchet planning — pending issues (#118)
• Update .gitignore (#117)
• feat(herd): add ratchet-herd skill wrapping the supervisor (#108) (#116)
• docs(herd): document config schema, adapter contract, and invariants (#115)
• Verify herd-opened PRs deterministically and route conflict rework (#114)
• feat: monitor herd workers, resume crashes, escalate blocked exits (#106) (#113)
• feat: dispatch herd workers with claim-window serialization (#105) (#112)
• feat: herd survey/reconcile loop, state file, and escalation writer (#104) (#111)
• feat: ratchet-herd config loader, validation, and init (#103) (#110)
• chore: archive closed plans (#101)
• Ratchet planning — pending issues (#102)
• Judge PRs against base-branch gate config, not their own edits (#97)
• Ratchet planning — pending issues (#98)
• Harden stale sweep PR detection (#96)
• Filter reserved plan labels case-insensitively (#95)
• Bind ratchet-run verification to picked issue (#94)
• Fix gates coverage parser drift (#93)
• fix(release): discriminate tag-collision 422 and target the default branch (#92)
• Ratchet planning — pending issues (#80)
• Add optional deploy gate to release lane (#79)
• Parse GATES.md rows with pipes in commands correctly (#78)
• fix(metrics): count all three sweep types in ratchet-metrics (#77)
• Run every scripts test suite through the GATES.md table (#76)
• fix(sweep): requeue swept issues safely — criteria re-check and label race (#74)
• feat(archive): run closed-plan archive automatically as a PR (#75)
• Close the title and comment injection channels in ratchet-run (#73)
• Make the release lane idempotent and version-aware (#72)
• fix(archive): duplicate-marker veto + no-overwrite guard in archive-closed-plans (#71)
• Ship every workflow-invoked script in ratchet-update (#70)
• Untrack local editor artifacts (#69)
• Refresh docs for shipped Ratchet mechanisms (#68)
• fix: exclude generated paths from size check (#67)
• Make CI checks binding under branch protection (#66)
• fix: scope acceptance criteria check (#65)
• Stop sweep misreading merged PRs and racing rework (#64)
• fix: harden plan sync validation visibility (#63)
• Ratchet planning — pending issues (#45)
• Extract workflow logic into testable scripts with regression tests (#44)
• Hygiene pass — README duplication, stale model id, action pinning, PR template (#22) (#43)
• Add a read-only ratchet-metrics skill for loop health (#42)
• Add a read-only ratchet-metrics engine script (GitHub loop metrics) (#41)
• Archive plan files whose issues are closed (#38)
• Harden ratchet-run against issue-body prompt injection (#17) (#39)
• Extend the stale sweep to in-review and changes-requested states (#35)
• Extend the plan format for non-functional requirements and extra test guidance (#18) (#37)
• Add an opt-in release lane (versioning, changelog, tagging) after merge (#36)
• Make the claim lease renewable via a heartbeat (#8) (#34)
• Enforce the agent PR size limit mechanically in CI (#33)
• Offer branch protection for main during ratchet-init (#10) (#32)
• Define a sanctioned hotfix/revert fast lane for production breakage (#31)
• Detect blocked_by cycles in plan-sync and report them in ratchet-status (#27)
• Re-check acceptance criteria before promoting unblocked issues (#5) (#30)
• Run the GATES.md gates in CI on every agent PR (#29)
• Detect security gates (dependency audit, secret scan) in ratchet-init (#16) (#28)
• Validate plan-file frontmatter in plan-sync (#26)
• Add a concurrency guard to the plan-sync workflow (#25)
• Fix stale-sweep timing fresh claims from the branch tip (#4) (#24)
• Initialize project docs and gap analysis (#23)
• Ratchet planning — pending issues (#3)

187 merged PR(s) since the start of the project.