devrites 7.0.0 → 7.0.2

package/pack/generated/pi/skills/rite-autocomplete/reference/lookahead.md

@@ -0,0 +1,50 @@
+# Sequence lookahead (`--lookahead`)
+
+> Root-only: not inlined in --role bundles.
+
+A second session plans the next sequence continuation while the active
+workspace builds, so the child's Spec → Vet overlaps its predecessor's
+Build → Seal. The main loop later resumes the planned child instead of
+specifying it again.
+
+## Start and target
+
+The operator starts the second host session with `/rite-autocomplete
+--lookahead` once the `.devrites/ACTIVE` workspace is in Build or later. The
+agent never launches a session itself. The target is the next recorded
+continuation after the active workspace: the entry
+[sequence continuation](loop.md#sequence-continuation) would open. Stop with
+nothing to do when the active workspace is before Build, no entry remains,
+`continue_sequence: false`, or the sequence budget is spent.
+
+## Lease
+
+Before any write, take the workspace lease:
+`devrites-engine claim add --session lookahead-<target> --ttl 240 --workspace <target> --reason lookahead`.
+Exit 3 means another session holds the target: stop. Re-add the lease with the
+same session at each phase start, and release it with `devrites-engine claim
+release` on every stop. A crashed session's lease reads `dead` and frees itself.
+
+## Rules
+
+- Never read or write `.devrites/ACTIVE`. Pass the target slug explicitly to every
+  skill and engine command, including `/rite-spec <target> "<objective>"` and
+  `devrites-engine handoff <target> --resume`.
+- After the workspace exists, run `devrites-engine state set <target> sequence_lookahead=yes`.
+- Run Spec → Clarify → Temper → Define → Plan → Vet as the main loop does.
+  Define and Plan read the predecessor's current tree and plan. Record an
+  assumption for each predecessor interface the plan relies on.
+- At Vet, beside the readiness binding, record exactly one line
+  `Predecessor readiness: <active-slug> <digest>` in `eng-review.md`. `<digest>`
+  is the hex that `devrites-engine check readiness --emit-binding <active-slug>`
+  prints. When the predecessor later changes its planning inputs, the child's
+  readiness check blocks with `DRV-GATE-READINESS-STALE` and the main loop
+  re-vets the child before Build.
+- Never Build, never write product source or tests, never commit, and never
+  arm or rewrite `.devrites/AFK`. Owner questions go to the target's
+  `questions.md` and stop the lookahead.
+- Stop at Vet `READY` with `next_action: build after predecessor Seal GO`, at a
+  human gate, or when the target's lease is lost.
+
+**Failing case:** the lookahead passes Vet and starts Build while the
+predecessor is still sealing, so two root sessions write one tree.

package/pack/generated/pi/skills/rite-autocomplete/reference/loop.md

@@ -93,6 +93,13 @@ step 10 does not end the run: leave the sealed workspace unshipped with its
 (`/rite-spec <parent>-<n> "<objective>"` from the parent's `decisions.md` sequence)
 and re-enter step 1. Spend one workspace per opened continuation.
 
+When that workspace already exists because a [lookahead](lookahead.md) session
+planned it, do not specify it again. Wait while `devrites-engine claim check
+--workspace <child>` exits 3 (a live lookahead holds it), then set
+`.devrites/ACTIVE` to the child and resume from its cursor at step 1. A
+predecessor replan since its Vet blocks the child's readiness with
+`DRV-GATE-READINESS-STALE`; route that to `/rite-vet` before Build.
+
 Spend accounting is durable in `state.md` cursors, not chat. Before invoking the
 continuation, ensure the current workspace's `sequence_workspaces_remaining` is
 set — absent, write `max_workspaces - 1` and `sequence_position: 1` first — and

package/pack/generated/pi/skills/rite-build/reference/spec-drift-guard.md

@@ -12,6 +12,10 @@ phases. Never silently code against a known-wrong plan.
 - the design system / existing UX pattern contradicts the planned UI;
 - a missing user decision that affects product behavior surfaces.
 
+A timing gate that fails with no code cause is a protocol or environment defect
+([performance.md § Performance gate protocol](../../devrites-lib/reference/standards/performance.md#performance-gate-protocol)),
+never another wright round.
+
 ## Workflow
 ```
 1. STOP coding.

package/pack/generated/pi/skills/rite-spec/SKILL.md

@@ -124,7 +124,8 @@ load a routed standard to discover required behavior, not to prescribe implement
    owned prerequisites. Keep a build checkpoint only for unavailable pre-code evidence or a
    mandatory action-time approval. **Completion:** no foreseeable human choice is deferred.
 5. **Create or update the workspace** + set `.devrites/ACTIVE` from
-   [state-workspace](reference/state-workspace.md). If the slug already exists,
+   [state-workspace](reference/state-workspace.md); a `--lookahead` run
+   leaves `.devrites/ACTIVE` unchanged. If the slug already exists,
    update the existing workspace rather than overwrite it; preserve history and
    unrelated settled content. Write every required artifact and conditional
    annex exactly from [spec-template](reference/spec-template.md)

package/pack/generated/pi/skills/rite-vet/SKILL.md

@@ -211,7 +211,9 @@ plan declares a root-authored executable workflow file, read
    `marker sweep:` line is recorded in `eng-review.md`; a kept hit blocks READY. Write phase/next step and emit one
    `Readiness inputs SHA-256` with
    `devrites-engine check readiness --emit-binding <slug>`; normal readiness check
-   must pass. Record the per-input drift baseline alongside it:
+   must pass. A `sequence_lookahead: yes` workspace also records one
+   `Predecessor readiness: <predecessor> <digest>` line from the predecessor's
+   `--emit-binding` hex; readiness re-checks it. Record the per-input drift baseline alongside it:
    `devrites-engine check drift <slug> --record` — a later stale binding then
    names the exact artifact that moved instead of "something changed". An `ADVISORY
    proportion:` line names a slice whose proof outgrew its ACs: move its rows without a

package/package.json

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