devrites 5.3.0 → 5.4.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to DevRites are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and DevRites adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Releases are generated automatically by [semantic-release](https://semantic-release.gitbook.io/) from Conventional Commits on `main`.
 
+## [5.4.0](https://github.com/ViktorsBaikers/DevRites/compare/v5.3.0...v5.4.0) (2026-09-13)
+
+### Added
+
+* **rite:** auto re-batch on frozen-lease scope defect ([#67](https://github.com/ViktorsBaikers/DevRites/issues/67)) ([6728385](https://github.com/ViktorsBaikers/DevRites/commit/6728385b522a5b34bebacb89a5855e81d54c0f68))
+
 ## [5.3.0](https://github.com/ViktorsBaikers/DevRites/compare/v5.2.4...v5.3.0) (2026-09-13)
 
 ### Added

package/README.md

@@ -33,7 +33,7 @@ project-conventional push, tag, or PR action, and archive the workspace.
 Unattended runs may create local WIP checkpoint commits along the way, but they
 remain local unless Ship's disclosed plan includes an approved remote action.
 
-**Status:** [`v5.3.0`](https://github.com/ViktorsBaikers/DevRites/releases/tag/v5.3.0): see [`CHANGELOG.md`](CHANGELOG.md) for release notes.
+**Status:** [`v5.4.0`](https://github.com/ViktorsBaikers/DevRites/releases/tag/v5.4.0): see [`CHANGELOG.md`](CHANGELOG.md) for release notes.
 
 This is the latest published release; `main` may contain unreleased work.
 

package/pack/.claude/skills/rite-build/SKILL.md

@@ -62,8 +62,10 @@ All-green serial integrate; a red/gap sibling gets a bounded repair round in
 its own worktree — never rebuilt from scratch while budget remains.
 Plan-owned gaps still route through Spec Drift Guard (batch sweep, one folded
 plan repair + one vet recheck inline); do not emit a human `Fix`. Exhausted
-repair blocks and preserves everything; `cleanup --force` (human discard
-path only) salvages slice branches before removing worktrees.
+repair blocks and preserves everything; `cleanup --force` salvages slice
+branches before removing worktrees — human-gated to abandon a batch,
+orchestrator-emitted only as the salvage step of an automatic frozen-lease
+re-batch.
 AFK charges after integrate only. Running lease blocks another
 `/rite-build`. Details: `parallel-batch.md`.
 

package/pack/.claude/skills/rite-build/reference/parallel-batch.md

@@ -59,12 +59,13 @@ Lease: `batch_id`, `created_at`, `base_sha`, `n`,
    landed in control, so `parallel cleanup` removes worktrees/branches.
    Blocked/human-stopped batches keep lease, worktrees, branches — nothing is
    removed while the batch may resume. `parallel abort` + `cleanup --force`
-   is the explicit human discard path, never orchestrator-emitted; it
-   salvages each sibling first (uncommitted allowlisted changes → slice-branch
-   commit; branches past `B` kept; a failed salvage keeps the worktree) and
-   prints retained refs for the abort record. `abort` marks the lease only —
-   never rewinds control: a moved HEAD is external work, reported not reset.
-   Never integrate a rejected transfer commit.
+   abandons the batch — the explicit human discard path; the single
+   orchestrator-emitted use is the automatic re-batch under Repair rounds,
+   where it acts as the salvage step only (uncommitted allowlisted changes →
+   slice-branch commit; branches past `B` kept; a failed salvage keeps the
+   worktree) and prints retained refs for the record. `abort` marks the lease
+   only — never rewinds control: a moved HEAD is external work, reported not
+   reset. Never integrate a rejected transfer commit.
 
 ## Repair rounds
 
@@ -79,9 +80,19 @@ while budget remains.
   [`spec-drift-guard.md`](spec-drift-guard.md): batch-sweep contract
   assumptions, one folded `/rite-plan repair` + one `/rite-vet` recheck
   inline, resume repair in the same worktrees under the amended contract;
-  never emit `Fix:`. **Reviewer stall/cancel or missing verdict** →
-  re-dispatch the reviewer, not the wright. **Product/policy/irreversible**
-  → stops for the human.
+  never emit `Fix:`. **Frozen-lease scope defect** — the amended contract or
+  a review requirement needs paths outside a slice's allowlist, or re-slices
+  the plan (a lease is immutable once written: its allowlists are the
+  disjointness guarantee) → **automatic re-batch, no human gate**:
+  `parallel cleanup --force` as the salvage step, record the retained refs in
+  the repair-round artifact, `parallel create` a fresh batch from control
+  `HEAD` under the corrected decomposition. Prior attempts stay reachable —
+  hand each new wright the salvaged branch ref
+  (`devrites/parallel/<slug>/<old-batch>/<slice>`) so it builds on what worked
+  instead of starting blind. If no corrected decomposition exists, that is
+  exhaustion → blocked, preserve, STOP. **Reviewer stall/cancel or missing
+  verdict** → re-dispatch the reviewer, not the wright. **Product/policy/
+  irreversible** → stops for the human.
 - Dispatch a fresh `devrites-slice-wright` (cwd = the sibling's worktree, same
   allowlist and host rules as step 3 — siblings may repair in parallel) with
   the original contract + verbatim findings + "preserve what works; fix the
@@ -107,7 +118,8 @@ devrites-engine parallel record-green --root <repo> --slug <slug> --slice <id> -
 devrites-engine parallel integrate --root <repo> --slug <slug> --apply-to-control
 devrites-engine parallel status --root <repo> --slug <slug>
 devrites-engine parallel lease-write|lease-read|lease-clear --root <repo> --slug <slug>
-# human discard only, never orchestrator-emitted:
+# abandoning the batch is human discard only; a frozen-lease re-batch may emit
+# cleanup --force as its salvage step (see Repair rounds):
 #   parallel abort --root <repo> --slug <slug>
 #   parallel cleanup --root <repo> --slug <slug> --force   (salvages, prints retained refs)
 ```

package/pack/generated/claude/skills/rite-build/SKILL.md

@@ -62,8 +62,10 @@ All-green serial integrate; a red/gap sibling gets a bounded repair round in
 its own worktree — never rebuilt from scratch while budget remains.
 Plan-owned gaps still route through Spec Drift Guard (batch sweep, one folded
 plan repair + one vet recheck inline); do not emit a human `Fix`. Exhausted
-repair blocks and preserves everything; `cleanup --force` (human discard
-path only) salvages slice branches before removing worktrees.
+repair blocks and preserves everything; `cleanup --force` salvages slice
+branches before removing worktrees — human-gated to abandon a batch,
+orchestrator-emitted only as the salvage step of an automatic frozen-lease
+re-batch.
 AFK charges after integrate only. Running lease blocks another
 `/rite-build`. Details: `parallel-batch.md`.
 

package/pack/generated/claude/skills/rite-build/reference/parallel-batch.md

@@ -59,12 +59,13 @@ Lease: `batch_id`, `created_at`, `base_sha`, `n`,
    landed in control, so `parallel cleanup` removes worktrees/branches.
    Blocked/human-stopped batches keep lease, worktrees, branches — nothing is
    removed while the batch may resume. `parallel abort` + `cleanup --force`
-   is the explicit human discard path, never orchestrator-emitted; it
-   salvages each sibling first (uncommitted allowlisted changes → slice-branch
-   commit; branches past `B` kept; a failed salvage keeps the worktree) and
-   prints retained refs for the abort record. `abort` marks the lease only —
-   never rewinds control: a moved HEAD is external work, reported not reset.
-   Never integrate a rejected transfer commit.
+   abandons the batch — the explicit human discard path; the single
+   orchestrator-emitted use is the automatic re-batch under Repair rounds,
+   where it acts as the salvage step only (uncommitted allowlisted changes →
+   slice-branch commit; branches past `B` kept; a failed salvage keeps the
+   worktree) and prints retained refs for the record. `abort` marks the lease
+   only — never rewinds control: a moved HEAD is external work, reported not
+   reset. Never integrate a rejected transfer commit.
 
 ## Repair rounds
 
@@ -79,9 +80,19 @@ while budget remains.
   [`spec-drift-guard.md`](spec-drift-guard.md): batch-sweep contract
   assumptions, one folded `/rite-plan repair` + one `/rite-vet` recheck
   inline, resume repair in the same worktrees under the amended contract;
-  never emit `Fix:`. **Reviewer stall/cancel or missing verdict** →
-  re-dispatch the reviewer, not the wright. **Product/policy/irreversible**
-  → stops for the human.
+  never emit `Fix:`. **Frozen-lease scope defect** — the amended contract or
+  a review requirement needs paths outside a slice's allowlist, or re-slices
+  the plan (a lease is immutable once written: its allowlists are the
+  disjointness guarantee) → **automatic re-batch, no human gate**:
+  `parallel cleanup --force` as the salvage step, record the retained refs in
+  the repair-round artifact, `parallel create` a fresh batch from control
+  `HEAD` under the corrected decomposition. Prior attempts stay reachable —
+  hand each new wright the salvaged branch ref
+  (`devrites/parallel/<slug>/<old-batch>/<slice>`) so it builds on what worked
+  instead of starting blind. If no corrected decomposition exists, that is
+  exhaustion → blocked, preserve, STOP. **Reviewer stall/cancel or missing
+  verdict** → re-dispatch the reviewer, not the wright. **Product/policy/
+  irreversible** → stops for the human.
 - Dispatch a fresh `devrites-slice-wright` (cwd = the sibling's worktree, same
   allowlist and host rules as step 3 — siblings may repair in parallel) with
   the original contract + verbatim findings + "preserve what works; fix the
@@ -107,7 +118,8 @@ devrites-engine parallel record-green --root <repo> --slug <slug> --slice <id> -
 devrites-engine parallel integrate --root <repo> --slug <slug> --apply-to-control
 devrites-engine parallel status --root <repo> --slug <slug>
 devrites-engine parallel lease-write|lease-read|lease-clear --root <repo> --slug <slug>
-# human discard only, never orchestrator-emitted:
+# abandoning the batch is human discard only; a frozen-lease re-batch may emit
+# cleanup --force as its salvage step (see Repair rounds):
 #   parallel abort --root <repo> --slug <slug>
 #   parallel cleanup --root <repo> --slug <slug> --force   (salvages, prints retained refs)
 ```

package/pack/generated/codex/skills/rite-build/SKILL.md

@@ -62,8 +62,10 @@ All-green serial integrate; a red/gap sibling gets a bounded repair round in
 its own worktree — never rebuilt from scratch while budget remains.
 Plan-owned gaps still route through Spec Drift Guard (batch sweep, one folded
 plan repair + one vet recheck inline); do not emit a human `Fix`. Exhausted
-repair blocks and preserves everything; `cleanup --force` (human discard
-path only) salvages slice branches before removing worktrees.
+repair blocks and preserves everything; `cleanup --force` salvages slice
+branches before removing worktrees — human-gated to abandon a batch,
+orchestrator-emitted only as the salvage step of an automatic frozen-lease
+re-batch.
 AFK charges after integrate only. Running lease blocks another
 `$rite-build`. Details: `parallel-batch.md`.
 

package/pack/generated/codex/skills/rite-build/reference/parallel-batch.md

@@ -59,12 +59,13 @@ Lease: `batch_id`, `created_at`, `base_sha`, `n`,
    landed in control, so `parallel cleanup` removes worktrees/branches.
    Blocked/human-stopped batches keep lease, worktrees, branches — nothing is
    removed while the batch may resume. `parallel abort` + `cleanup --force`
-   is the explicit human discard path, never orchestrator-emitted; it
-   salvages each sibling first (uncommitted allowlisted changes → slice-branch
-   commit; branches past `B` kept; a failed salvage keeps the worktree) and
-   prints retained refs for the abort record. `abort` marks the lease only —
-   never rewinds control: a moved HEAD is external work, reported not reset.
-   Never integrate a rejected transfer commit.
+   abandons the batch — the explicit human discard path; the single
+   orchestrator-emitted use is the automatic re-batch under Repair rounds,
+   where it acts as the salvage step only (uncommitted allowlisted changes →
+   slice-branch commit; branches past `B` kept; a failed salvage keeps the
+   worktree) and prints retained refs for the record. `abort` marks the lease
+   only — never rewinds control: a moved HEAD is external work, reported not
+   reset. Never integrate a rejected transfer commit.
 
 ## Repair rounds
 
@@ -79,9 +80,19 @@ while budget remains.
   [`spec-drift-guard.md`](spec-drift-guard.md): batch-sweep contract
   assumptions, one folded `$rite-plan repair` + one `$rite-vet` recheck
   inline, resume repair in the same worktrees under the amended contract;
-  never emit `Fix:`. **Reviewer stall/cancel or missing verdict** →
-  re-dispatch the reviewer, not the wright. **Product/policy/irreversible**
-  → stops for the human.
+  never emit `Fix:`. **Frozen-lease scope defect** — the amended contract or
+  a review requirement needs paths outside a slice's allowlist, or re-slices
+  the plan (a lease is immutable once written: its allowlists are the
+  disjointness guarantee) → **automatic re-batch, no human gate**:
+  `parallel cleanup --force` as the salvage step, record the retained refs in
+  the repair-round artifact, `parallel create` a fresh batch from control
+  `HEAD` under the corrected decomposition. Prior attempts stay reachable —
+  hand each new wright the salvaged branch ref
+  (`devrites/parallel/<slug>/<old-batch>/<slice>`) so it builds on what worked
+  instead of starting blind. If no corrected decomposition exists, that is
+  exhaustion → blocked, preserve, STOP. **Reviewer stall/cancel or missing
+  verdict** → re-dispatch the reviewer, not the wright. **Product/policy/
+  irreversible** → stops for the human.
 - Dispatch a fresh `devrites-slice-wright` (cwd = the sibling's worktree, same
   allowlist and host rules as step 3 — siblings may repair in parallel) with
   the original contract + verbatim findings + "preserve what works; fix the
@@ -107,7 +118,8 @@ devrites-engine parallel record-green --root <repo> --slug <slug> --slice <id> -
 devrites-engine parallel integrate --root <repo> --slug <slug> --apply-to-control
 devrites-engine parallel status --root <repo> --slug <slug>
 devrites-engine parallel lease-write|lease-read|lease-clear --root <repo> --slug <slug>
-# human discard only, never orchestrator-emitted:
+# abandoning the batch is human discard only; a frozen-lease re-batch may emit
+# cleanup --force as its salvage step (see Repair rounds):
 #   parallel abort --root <repo> --slug <slug>
 #   parallel cleanup --root <repo> --slug <slug> --force   (salvages, prints retained refs)
 ```

package/pack/generated/omp/skills/rite-build/SKILL.md

@@ -62,8 +62,10 @@ All-green serial integrate; a red/gap sibling gets a bounded repair round in
 its own worktree — never rebuilt from scratch while budget remains.
 Plan-owned gaps still route through Spec Drift Guard (batch sweep, one folded
 plan repair + one vet recheck inline); do not emit a human `Fix`. Exhausted
-repair blocks and preserves everything; `cleanup --force` (human discard
-path only) salvages slice branches before removing worktrees.
+repair blocks and preserves everything; `cleanup --force` salvages slice
+branches before removing worktrees — human-gated to abandon a batch,
+orchestrator-emitted only as the salvage step of an automatic frozen-lease
+re-batch.
 AFK charges after integrate only. Running lease blocks another
 `/rite-build`. Details: `parallel-batch.md`.
 

package/pack/generated/omp/skills/rite-build/reference/parallel-batch.md

@@ -59,12 +59,13 @@ Lease: `batch_id`, `created_at`, `base_sha`, `n`,
    landed in control, so `parallel cleanup` removes worktrees/branches.
    Blocked/human-stopped batches keep lease, worktrees, branches — nothing is
    removed while the batch may resume. `parallel abort` + `cleanup --force`
-   is the explicit human discard path, never orchestrator-emitted; it
-   salvages each sibling first (uncommitted allowlisted changes → slice-branch
-   commit; branches past `B` kept; a failed salvage keeps the worktree) and
-   prints retained refs for the abort record. `abort` marks the lease only —
-   never rewinds control: a moved HEAD is external work, reported not reset.
-   Never integrate a rejected transfer commit.
+   abandons the batch — the explicit human discard path; the single
+   orchestrator-emitted use is the automatic re-batch under Repair rounds,
+   where it acts as the salvage step only (uncommitted allowlisted changes →
+   slice-branch commit; branches past `B` kept; a failed salvage keeps the
+   worktree) and prints retained refs for the record. `abort` marks the lease
+   only — never rewinds control: a moved HEAD is external work, reported not
+   reset. Never integrate a rejected transfer commit.
 
 ## Repair rounds
 
@@ -79,9 +80,19 @@ while budget remains.
   [`spec-drift-guard.md`](spec-drift-guard.md): batch-sweep contract
   assumptions, one folded `/rite-plan repair` + one `/rite-vet` recheck
   inline, resume repair in the same worktrees under the amended contract;
-  never emit `Fix:`. **Reviewer stall/cancel or missing verdict** →
-  re-dispatch the reviewer, not the wright. **Product/policy/irreversible**
-  → stops for the human.
+  never emit `Fix:`. **Frozen-lease scope defect** — the amended contract or
+  a review requirement needs paths outside a slice's allowlist, or re-slices
+  the plan (a lease is immutable once written: its allowlists are the
+  disjointness guarantee) → **automatic re-batch, no human gate**:
+  `parallel cleanup --force` as the salvage step, record the retained refs in
+  the repair-round artifact, `parallel create` a fresh batch from control
+  `HEAD` under the corrected decomposition. Prior attempts stay reachable —
+  hand each new wright the salvaged branch ref
+  (`devrites/parallel/<slug>/<old-batch>/<slice>`) so it builds on what worked
+  instead of starting blind. If no corrected decomposition exists, that is
+  exhaustion → blocked, preserve, STOP. **Reviewer stall/cancel or missing
+  verdict** → re-dispatch the reviewer, not the wright. **Product/policy/
+  irreversible** → stops for the human.
 - Dispatch a fresh `devrites-slice-wright` (cwd = the sibling's worktree, same
   allowlist and host rules as step 3 — siblings may repair in parallel) with
   the original contract + verbatim findings + "preserve what works; fix the
@@ -107,7 +118,8 @@ devrites-engine parallel record-green --root <repo> --slug <slug> --slice <id> -
 devrites-engine parallel integrate --root <repo> --slug <slug> --apply-to-control
 devrites-engine parallel status --root <repo> --slug <slug>
 devrites-engine parallel lease-write|lease-read|lease-clear --root <repo> --slug <slug>
-# human discard only, never orchestrator-emitted:
+# abandoning the batch is human discard only; a frozen-lease re-batch may emit
+# cleanup --force as its salvage step (see Repair rounds):
 #   parallel abort --root <repo> --slug <slug>
 #   parallel cleanup --root <repo> --slug <slug> --force   (salvages, prints retained refs)
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devrites",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "description": "DevRites: a disciplined senior-engineer workflow pack for Claude Code and Codex",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://github.com/ViktorsBaikers/DevRites#readme",