Release 4.12.1

[islayjames]

[4.12.1] - 2026-10-04

/plan --implement finishes what a sweep list starts. Plan: docs/TRD/plan-sweep-chain.md.
Before this, a plan that split a finished spec into a sweep and a core always stopped and listed
four steps for the owner to run by hand, even with --implement.

Changed

• /plan --implement runs the sweep chain itself: /sweep on the sweep file, then
  /verify-build on it, then a commit of the swept fixes, then /implement-trd on the core.
  It runs on a feature branch, so the sweep commit never lands on main. Without --implement
  it still lists the four steps.
• The chain stops when the sweep's verification is not satisfied in that run. A
  verification state left from an earlier run never counts.
• Items the sweep cannot take are moved to the core automatically, once per run, and the
  run carries on. These are items deferred or too big, items sharing a file with the core, and
  items touching a never-unattended path. /plan adds a task for each to the core TRD (or
  writes one when none existed) and re-runs the checks that TRD's weight earns.
• The never-unattended brake is checked wherever work can begin. An unreadable list stops
  the chain. Sweep items touching a listed path are moved to the core. Folded tasks are checked
  on the core TRD. The whole commit list is checked before anything is staged.
  check-never-unattended gains a --files form for that last check.
• /sweep --chained and /verify-build --chained end with a hand-back line instead of a
  banner, so the run has one banner. command-status.md names them, and its size ceiling went
  from 12,500 to 13,000 bytes to make room.
• One step decider. sweepChainNext in fix-plan.js picks every next step and builds the
  stop banner, so no ending is worked out in prose.
• The commit is by pathspec only. It covers the files the sweep actually changed (from
  before/after git status and content hashes, not the fixers' claims), the sweep file and its
  state folder.

🤖 Generated with Claude Code

https://claude.ai/code/session_011L3ERmR4S1yPaaeiwUhGYS

Summary by CodeRabbit

• New Features

  • /plan --implement can now run a sweep, verify its results in the same run, commit swept fixes, and then implement the core plan. The chain stops if verification is not satisfied or required paths cannot be read.
  • Without --implement, /plan continues to list the four steps.
  • Added chained hand-back behavior for /sweep and /verify-build.

• Updates

  • Released version 4.12.1.

[coderabbitai]

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: be717421-449c-4e26-8afe-a468bfef6730

📥 Commits

Reviewing files that changed from the base of the PR and between ae6123b and 1fad423.

📒 Files selected for processing (5)

• .claude-plugin/marketplace.json
• CHANGELOG.md
• CLAUDE.md
• package.json
• packages/full/.claude-plugin/plugin.json

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

The changelog and project status document the 4.12.1 release. The package and plugin metadata versions change from 4.12.0 to 4.12.1.

Changes

4.12.1 release

Layer / File(s)	Summary
Release notes and status CHANGELOG.md, CLAUDE.md	The changelog describes the /plan --implement sweep-to-core chain and related checks. The project status updates release details, test counts, and the known-open item.
Version metadata package.json, .claude-plugin/marketplace.json, packages/full/.claude-plugin/plugin.json	The package, marketplace, and full plugin versions change from 4.12.0 to 4.12.1.

Priority: ➖ Normal

Estimated code review effort: 2 (Simple) | ~8 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 1fad4

The release records and version metadata are aligned, with no identified issue blocking merge.

Architecture Summary

Architecture risk: 🔵 Low · up to 1fad4

The change affects 4 systems.

Changed systems: CHANGELOG.md, CLAUDE.md, package.json, packages/full

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

• observed — CHANGELOG.md (service) was modified; 1 changed file maps to changed impact.
• observed — CLAUDE.md (service) was modified; 1 changed file maps to changed impact.
• observed — package.json (service) was modified; 1 changed file maps to changed impact.
• observed — packages/full (library) was modified; 1 changed file maps to changed impact.

Before / after behavior

• observed — Modified behavior in CHANGELOG.md: Adds the 4.12.1 changelog entry. It documents /plan --implement executing the sweep, same-run verification, swept-fix commit, and core implementation in sequence; stopping unless the current run’s sweep verification is satisfied; and moving deferred, oversized, core-file-sharing, or never-unattended-path items into the core TRD before continuing. It also records brake checks at work-start and before staging, the check-never-unattended --files form, chained hand-back lines for /sweep and /verify-build, the increased status-document size ceiling, sweepChainNext as the step and stop-banner decider, and commits limited to observed changed files plus the sweep file and state folder.
• observed — Modified behavior in CLAUDE.md: The status updates the release version, date, and Jest/BATS counts; adds the 4.12.1 /plan --implement entry; removes the 4.11.0 /audit-build entry; and revises the known-open item from 4.12.0 to 4.12.x with updated sweep wording.
• observed — Modified behavior in package.json: The package version changes from 4.12.0 to 4.12.1.
• observed — Modified behavior in packages/full/.claude-plugin/plugin.json: The plugin version changes from 4.12.0 to 4.12.1.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title identifies the 4.12.1 release, which matches the primary purpose of the pull request.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

_{Comment @coderabbitai help to get the list of available commands.}