cclaw-cli 6.14.3 → 7.0.0

package/dist/content/hooks.js

@@ -294,22 +294,9 @@ async function readRunId(root) {
   }
 }
 
-async function readWorktreeExecutionModeInline(root) {
-  try {
-    const raw = await fs.readFile(path.join(root, RUNTIME_ROOT, "state", "flow-state.json"), "utf8");
-    const parsed = JSON.parse(raw);
-    if (parsed && parsed.worktreeExecutionMode === "worktree-first") {
-      return "worktree-first";
-    }
-    return "single-tree";
-  } catch {
-    return "single-tree";
-  }
-}
-
-// v6.14.2 — read \`tddGreenMinElapsedMs\` from flow-state.json. Defaults to
-// 4000ms when missing or invalid. Operators set 0 to disable the freshness
-// floor while keeping RED-test-name and passing-assertion checks active.
+// Read \`tddGreenMinElapsedMs\` from flow-state.json. Defaults to 4000ms
+// when missing or invalid. Operators set 0 to disable the freshness floor
+// while keeping RED-test-name and passing-assertion checks active.
 async function readTddGreenMinElapsedMsInline(root) {
   try {
     const raw = await fs.readFile(path.join(root, RUNTIME_ROOT, "state", "flow-state.json"), "utf8");
@@ -323,11 +310,11 @@ async function readTddGreenMinElapsedMsInline(root) {
   }
 }
 
-// v6.14.2 Fix 4 — match the RED test name into the GREEN evidenceRef.
-// Returns the basename or stem (without extension) of the most-specific
-// path token in the RED row's first evidenceRef. We deliberately use a
-// substring match, not equality, so callers can include richer text
-// like "REGRESSION: cargo test --test foo => 8 passed; 0 failed".
+// Match the RED test name into the GREEN evidenceRef. Returns the
+// basename or stem (without extension) of the most-specific path token
+// in the RED row's first evidenceRef. We deliberately use a substring
+// match, not equality, so callers can include richer text like
+// "REGRESSION: cargo test --test foo => 8 passed; 0 failed".
 function extractRedTestNameInline(redEvidenceRef) {
   if (typeof redEvidenceRef !== "string") return null;
   const trimmed = redEvidenceRef.trim();
@@ -351,8 +338,8 @@ function extractRedTestNameInline(redEvidenceRef) {
 //   pytest: "===== N passed in 0.42s ====="
 //   go test: "ok   pkg   0.123s"
 //   npm/jest/vitest: "Tests:  N passed"
-// We accept a generic shape: "=> N passed; 0 failed" (the example in
-// the v6.14.2 worker contract) plus four runner-specific patterns.
+// We accept a generic shape: "=> N passed; 0 failed" plus four
+// runner-specific patterns.
 const GREEN_PASS_PATTERNS = [
   /=>\\s*\\d+\\s+passed/iu,
   /\\b\\d+\\s+passed[;,]\\s*0\\s+failed\\b/iu,
@@ -403,7 +390,7 @@ function usage() {
     "  node .cclaw/hooks/delegation-record.mjs --stage=<stage> --agent=<agent> --mode=<mandatory|proactive> --status=<scheduled|launched|acknowledged|completed|failed|waived|stale> --span-id=<id> [--dispatch-id=<id>] [--worker-run-id=<id>] [--dispatch-surface=<surface>] [--agent-definition-path=<path>] [--ack-ts=<iso>] [--launched-ts=<iso>] [--completed-ts=<iso>] [--evidence-ref=<ref>] [--waiver-reason=<text>] [--supersede=<prevSpanId>] [--allow-parallel] [--paths=<comma-separated>] [--override-cap=<int>] [--json]",
     "  node .cclaw/hooks/delegation-record.mjs --rerecord --span-id=<id> --dispatch-id=<id> --dispatch-surface=<surface> --agent-definition-path=<path> [--ack-ts=<iso>] [--completed-ts=<iso>] [--evidence-ref=<ref>] [--json]",
     "  node .cclaw/hooks/delegation-record.mjs --repair --span-id=<id> --repair-reason=\\\"<why>\\\" [--json]",
-    "  node .cclaw/hooks/delegation-record.mjs --audit-kind=cclaw_integration_overseer_skipped [--audit-reason=\\\"<comma-separated reasons>\\\"] [--slice-ids=\\\"S-1,S-2\\\"] [--json]    # v6.14.1: emit non-delegation audit row only",
+    "  node .cclaw/hooks/delegation-record.mjs --audit-kind=cclaw_integration_overseer_skipped [--audit-reason=\\\"<comma-separated reasons>\\\"] [--slice-ids=\\\"S-1,S-2\\\"] [--json]    # non-delegation audit row",
     "",
     "Allowed --dispatch-surface values:",
     "  " + VALID_DISPATCH_SURFACES.join(", "),
@@ -411,25 +398,20 @@ function usage() {
     "Per-surface allowed --agent-definition-path prefixes:",
     ...VALID_DISPATCH_SURFACES.map((surface) => "  " + surface + ": " + (SURFACE_PATH_PREFIXES[surface].length === 0 ? "(any)" : SURFACE_PATH_PREFIXES[surface].join(", "))),
     "",
-    "Dispatch dedup (v6.8.0):",
+    "Dispatch dedup:",
     "  --supersede=<prevSpanId>  close the previous active span on this (stage, agent) as 'stale' before recording the new scheduled row",
     "  --allow-parallel          record both spans as concurrent; new row is tagged allowParallel: true",
     "",
-    "TDD parallel scheduler (v6.10.0):",
-    "  --paths=<a,b,c>           repo-relative paths the slice-implementer will edit; disjoint sets auto-promote to allowParallel, overlap throws DispatchOverlapError",
-    "  --override-cap=<int>      raise the slice-implementer fan-out cap once for this dispatch (default cap " + String(5) + ", env CCLAW_MAX_PARALLEL_SLICE_IMPLEMENTERS overrides globally)",
+    "TDD parallel scheduler:",
+    "  --paths=<a,b,c>           repo-relative paths the slice-builder will edit; disjoint sets auto-promote to allowParallel, overlap throws DispatchOverlapError",
+    "  --override-cap=<int>      raise the slice worker fan-out cap once for this dispatch (default cap " + String(5) + ", env CCLAW_MAX_PARALLEL_SLICE_BUILDERS overrides globally)",
     "",
-    "TDD slice phase tagging (v6.11.0):",
+    "TDD slice phase tagging:",
     "  --slice=<id>              TDD slice identifier (e.g. S-1) used by the linter to auto-derive the Watched-RED + Vertical Slice Cycle tables.",
     "  --phase=<phase>           one of " + VALID_DELEGATION_PHASES.join(", ") + ". Pair with --slice to record a TDD slice phase event.",
-    "  --refactor-rationale=<t>  required when --phase=refactor-deferred unless --evidence-ref carries the rationale text. v6.14.0: also paired with --refactor-outcome on phase=green.",
-    "  --claim-token=<opaque>    v6.13 — required for worktree-first slice-implementer schedules with --slice (echo on all terminal rows for the span).",
-    "  --lane-id=<id>            v6.13 — worktree lane id (ownerLaneId metadata).",
-    "  --lease-until=<iso>       v6.13 — ISO8601 lease expiry for reclaim tooling.",
-    "  --depends-on=<a,b>       v6.13 — comma-separated plan unit ids for scheduler diagnostics.",
-    "  --integration-state=<s>  v6.13 — one of pending|applied|conflict|resolved|abandoned.",
-    "  --refactor-outcome=<m>   v6.14.0 — one of inline|deferred. Folds REFACTOR into the phase=green event so a single row can close RED→GREEN→REFACTOR. Pair --refactor-outcome=deferred with --refactor-rationale.",
-    "  --risk-tier=<t>          v6.14.0 — one of low|medium|high. high triggers integration-overseer in conditional mode.",
+    "  --refactor-rationale=<t>  required when --phase=refactor-deferred unless --evidence-ref carries the rationale text; also paired with --refactor-outcome on phase=green.",
+    "  --refactor-outcome=<m>   one of inline|deferred. Folds REFACTOR into the phase=green event so a single row can close RED→GREEN→REFACTOR. Pair --refactor-outcome=deferred with --refactor-rationale.",
+    "  --risk-tier=<t>          one of low|medium|high. high triggers integration-overseer in conditional mode.",
     ""
   ].join("\\n") + "\\n");
 }
@@ -531,16 +513,15 @@ function buildRow(args, status, runId, now, options) {
   // Inherit the span's startTs from prior rows so monotonic validation
   // can compare against the original schedule, not the row write time.
   const startTs = (options && options.spanStartTs) || now;
-  // v6.10.0 (P1): claimedPaths from --paths=<comma-separated>. Empty
-  // arrays are dropped so the row stays compatible with v6.9 readers.
+  // claimedPaths from --paths=<comma-separated>. Empty arrays are dropped.
   const claimedPathsRaw = typeof args.paths === "string" ? args.paths : "";
   const claimedPaths = claimedPathsRaw
     .split(",")
     .map((value) => value.trim())
     .filter((value) => value.length > 0);
-  // v6.11.0 (D1+D2): TDD slice tagging via --slice / --phase. Phase
-  // must be one of the canonical enum values; the inline validator
-  // rejects unknown phases before the row hits the ledger.
+  // TDD slice tagging via --slice / --phase. Phase must be one of the
+  // canonical enum values; the inline validator rejects unknown phases
+  // before the row hits the ledger.
   const sliceId =
     typeof args.slice === "string" && args.slice.trim().length > 0
       ? args.slice.trim()
@@ -549,10 +530,10 @@ function buildRow(args, status, runId, now, options) {
     typeof args.phase === "string" && args.phase.trim().length > 0
       ? args.phase.trim()
       : undefined;
-  // v6.11.0 (D2): when --refactor-rationale is supplied it is folded
-  // into evidenceRefs[0] so the linter (which reads evidenceRefs only)
-  // can surface the rationale without touching new fields. The user
-  // may also pass --evidence-ref containing the rationale text.
+  // When --refactor-rationale is supplied it is folded into
+  // evidenceRefs[0] so the linter (which reads evidenceRefs only) can
+  // surface the rationale without touching new fields. The user may
+  // also pass --evidence-ref containing the rationale text.
   let resolvedEvidenceRefs = normalizeEvidenceRefs(args);
   if (
     phase === "refactor-deferred" &&
@@ -564,48 +545,12 @@ function buildRow(args, status, runId, now, options) {
       resolvedEvidenceRefs = [rationale, ...resolvedEvidenceRefs];
     }
   }
-  const integrationStateRaw =
-    typeof args["integration-state"] === "string" ? args["integration-state"].trim() : "";
-  const integrationStateAllowed = new Set([
-    "pending",
-    "applied",
-    "conflict",
-    "resolved",
-    "abandoned"
-  ]);
-  const integrationState =
-    integrationStateRaw.length > 0 && integrationStateAllowed.has(integrationStateRaw)
-      ? integrationStateRaw
-      : undefined;
-  const claimToken =
-    typeof args["claim-token"] === "string" && args["claim-token"].trim().length > 0
-      ? args["claim-token"].trim()
-      : undefined;
-  const ownerLaneId =
-    typeof args["lane-id"] === "string" && args["lane-id"].trim().length > 0
-      ? args["lane-id"].trim()
-      : undefined;
-  const leasedUntil =
-    typeof args["lease-until"] === "string" && args["lease-until"].trim().length > 0
-      ? args["lease-until"].trim()
-      : undefined;
-  const dependsOnRaw =
-    typeof args["depends-on"] === "string" ? args["depends-on"].trim() : "";
-  const dependsOn =
-    dependsOnRaw.length > 0
-      ? dependsOnRaw
-        .split(",")
-        .map((value) => value.trim())
-        .filter((value) => value.length > 0)
-      : undefined;
-  const leaseState =
-    leasedUntil && status === "scheduled" ? "claimed" : undefined;
-  // v6.14.0: refactorOutcome folds REFACTOR into a phase=green event. We
-  // also accept it on phase=refactor / phase=refactor-deferred for forward
-  // compatibility with controllers that emit it on the legacy lifecycle.
-  // When mode=deferred and a --refactor-rationale is supplied we also
-  // mirror the rationale into evidenceRefs[0] so legacy linters keep
-  // reading evidence (matches the v6.11.0 refactor-deferred behavior).
+  // refactorOutcome folds REFACTOR into a phase=green event. We also
+  // accept it on phase=refactor / phase=refactor-deferred for controllers
+  // that emit it on the per-phase lifecycle. When mode=deferred and a
+  // --refactor-rationale is supplied we mirror the rationale into
+  // evidenceRefs[0] so the linter keeps reading evidence (matches the
+  // refactor-deferred behavior).
   const refactorOutcomeMode =
     typeof args["refactor-outcome"] === "string"
       ? args["refactor-outcome"].trim()
@@ -659,12 +604,6 @@ function buildRow(args, status, runId, now, options) {
     claimedPaths: claimedPaths.length > 0 ? claimedPaths : undefined,
     sliceId,
     phase,
-    claimToken,
-    ownerLaneId,
-    leasedUntil,
-    leaseState,
-    dependsOn,
-    integrationState,
     refactorOutcome,
     riskTier
   };
@@ -690,9 +629,9 @@ function findActiveSpanForPairInline(stage, agent, runId, entries) {
   for (const entry of entries) {
     if (!entry || typeof entry !== "object") continue;
     if (typeof entry.spanId !== "string" || entry.spanId.length === 0) continue;
-    // Strict run-scope (v6.9.0 R7 fix): legacy entries without a runId
-    // are treated as foreign so they cannot keep an old span "active"
-    // across runs and trip dispatch_duplicate on a fresh dispatch.
+    // Strict run-scope: entries without a runId are treated as foreign so
+    // they cannot keep an old span "active" across runs and trip
+    // dispatch_duplicate on a fresh dispatch.
     if (typeof entry.runId !== "string" || entry.runId.length === 0) continue;
     if (entry.runId !== runId) continue;
     if (entry.stage !== stage || entry.agent !== agent) continue;
@@ -730,7 +669,7 @@ function computeActiveSubagentsInline(entries) {
 
 // keep in sync with validateFileOverlap in src/delegation.ts
 function validateFileOverlapInline(stamped, activeEntries) {
-  if (stamped.agent !== "slice-implementer" || stamped.stage !== "tdd") {
+  if (stamped.agent !== "slice-builder" || stamped.stage !== "tdd") {
     return { autoParallel: false, conflict: null };
   }
   const newPaths = Array.isArray(stamped.claimedPaths) ? stamped.claimedPaths : [];
@@ -767,10 +706,10 @@ function validateFileOverlapInline(stamped, activeEntries) {
   return { autoParallel: true, conflict: null };
 }
 
-const MAX_PARALLEL_SLICE_IMPLEMENTERS_INLINE = 5;
+const MAX_PARALLEL_SLICE_BUILDERS_INLINE = 5;
 
 function readMaxParallelOverrideFromEnvInline() {
-  const raw = process.env.CCLAW_MAX_PARALLEL_SLICE_IMPLEMENTERS;
+  const raw = process.env.CCLAW_MAX_PARALLEL_SLICE_BUILDERS;
   if (typeof raw !== "string" || raw.trim().length === 0) return null;
   const parsed = Number(raw);
   if (!Number.isFinite(parsed) || !Number.isInteger(parsed) || parsed < 1) return null;
@@ -779,13 +718,13 @@ function readMaxParallelOverrideFromEnvInline() {
 
 // keep in sync with validateFanOutCap in src/delegation.ts
 function validateFanOutCapInline(stamped, activeEntries, override) {
-  if (stamped.agent !== "slice-implementer" || stamped.stage !== "tdd") return null;
+  if (stamped.agent !== "slice-builder" || stamped.stage !== "tdd") return null;
   if (stamped.status !== "scheduled") return null;
   let cap;
   if (override !== null && override !== undefined && Number.isInteger(override) && override >= 1) {
     cap = override;
   } else {
-    cap = readMaxParallelOverrideFromEnvInline() || MAX_PARALLEL_SLICE_IMPLEMENTERS_INLINE;
+    cap = readMaxParallelOverrideFromEnvInline() || MAX_PARALLEL_SLICE_BUILDERS_INLINE;
   }
   const sameLaneActive = activeEntries.filter(
     (entry) =>
@@ -958,9 +897,9 @@ async function findLegacyEntry(root, spanId) {
   return ledger.entries.find((entry) => entry && entry.spanId === spanId) || null;
 }
 
-// v6.14.1 — allow-list of non-delegation audit events the controller
-// can emit via the helper. Keep in sync with NON_DELEGATION_AUDIT_EVENTS
-// in src/delegation.ts.
+// Allow-list of non-delegation audit events the controller can emit via
+// the helper. Keep in sync with NON_DELEGATION_AUDIT_EVENTS in
+// src/delegation.ts.
 const VALID_AUDIT_KINDS = new Set([
   "cclaw_integration_overseer_skipped"
 ]);
@@ -1258,8 +1197,8 @@ async function main() {
     return;
   }
 
-  // v6.14.1 — audit-only emit path. When the controller wants to record
-  // a non-delegation audit row (e.g. \`cclaw_integration_overseer_skipped\`
+  // Audit-only emit path. When the controller wants to record a
+  // non-delegation audit row (e.g. \`cclaw_integration_overseer_skipped\`
   // when the wave heuristic chose to skip the overseer dispatch), pass
   // --audit-kind=<event-name> [--audit-reason=<text>] [--slice-ids=<csv>]
   // and the helper appends a single line to delegation-events.jsonl
@@ -1287,11 +1226,11 @@ async function main() {
     return;
   }
 
-  // v6.11.0 (D2) — TDD slice phase tagging validation. --phase is
-  // strictly enum-bound; --slice must be a non-empty string when
-  // provided; --phase=refactor-deferred requires either an explicit
-  // --refactor-rationale or an --evidence-ref with rationale text so
-  // the linter has something to render.
+  // TDD slice phase tagging validation. --phase is strictly enum-bound;
+  // --slice must be a non-empty string when provided;
+  // --phase=refactor-deferred requires either an explicit
+  // --refactor-rationale or an --evidence-ref with rationale text so the
+  // linter has something to render.
   if (args.phase !== undefined && !VALID_DELEGATION_PHASES_SET.has(args.phase)) {
     problems.push("invalid --phase (allowed: " + VALID_DELEGATION_PHASES.join(", ") + ")");
     emitProblems(problems, json, 2);
@@ -1317,10 +1256,10 @@ async function main() {
     }
   }
 
-  // v6.14.0 — --refactor-outcome must be one of inline|deferred. When
-  // mode=deferred a rationale is required (either --refactor-rationale or
-  // --evidence-ref carrying the rationale text). --risk-tier must be one of
-  // low|medium|high if provided.
+  // --refactor-outcome must be one of inline|deferred. When mode=deferred
+  // a rationale is required (either --refactor-rationale or --evidence-ref
+  // carrying the rationale text). --risk-tier must be one of low|medium|high
+  // if provided.
   if (
     args["refactor-outcome"] !== undefined &&
     args["refactor-outcome"] !== "inline" &&
@@ -1442,9 +1381,9 @@ async function main() {
     return;
   }
 
-  // v6.10.0 (P1+P2): file-overlap scheduler + fan-out cap. Run before
-  // the legacy dispatch dedup so disjoint claimedPaths can auto-promote
-  // to allowParallel and bypass the duplicate guard.
+  // File-overlap scheduler + fan-out cap. Run before the dispatch
+  // dedup so disjoint claimedPaths can auto-promote to allowParallel and
+  // bypass the duplicate guard.
   if (status === "scheduled") {
     const sameRunPrior = priorLedger.filter((entry) => entry.runId === runId);
     const activeForRun = computeActiveSubagentsInline(sameRunPrior);
@@ -1494,8 +1433,8 @@ async function main() {
     }
   }
 
-  // v6.14.2 Fix 4 — GREEN evidence freshness contract for
-  // \`slice-implementer --phase green --status=completed\`. Three checks:
+  // GREEN evidence freshness contract for \`slice-builder --phase green
+  // --status=completed\`. Three checks:
   //   1. green_evidence_red_test_mismatch — evidenceRefs[0] must contain
   //      the basename/stem of the RED span's first evidenceRef.
   //   2. green_evidence_passing_assertion_missing — evidenceRefs[0]
@@ -1508,7 +1447,7 @@ async function main() {
   // --green-mode=observational. Both flags are required.
   if (
     clean.stage === "tdd" &&
-    clean.agent === "slice-implementer" &&
+    clean.agent === "slice-builder" &&
     clean.phase === "green" &&
     clean.status === "completed"
   ) {
@@ -1625,34 +1564,8 @@ async function main() {
     }
   }
 
-  if (
-    clean.stage === "tdd" &&
-    clean.agent === "slice-implementer" &&
-    clean.phase === "green" &&
-    (await readWorktreeExecutionModeInline(root)) === "worktree-first"
-  ) {
-    const tok = typeof clean.claimToken === "string" ? clean.claimToken.trim() : "";
-    const lane = typeof clean.ownerLaneId === "string" ? clean.ownerLaneId.trim() : "";
-    const lease = typeof clean.leasedUntil === "string" ? clean.leasedUntil.trim() : "";
-    if (tok.length === 0 || lane.length === 0 || lease.length === 0) {
-      const missing = [];
-      if (tok.length === 0) missing.push("--claim-token");
-      if (lane.length === 0) missing.push("--lane-id");
-      if (lease.length === 0) missing.push("--lease-until");
-      emitErrorJson(
-        "dispatch_lane_metadata_missing",
-        {
-          missing,
-          remediation:
-            "worktree-first mode requires --claim-token, --lane-id, and --lease-until on every slice-implementer --phase green delegation-record write (from scheduled through completed)."
-        },
-        json
-      );
-      return;
-    }
-  }
-
   await persistEntry(root, runId, clean, event);
+
   process.stdout.write(JSON.stringify({ ok: true, event }, null, 2) + "\\n");
 }
 

package/dist/content/idea.js

@@ -250,7 +250,7 @@ ${frameBullets}
    letters. Default = "Start /cc on the top recommendation". When the user
    picks the start option, plumb the chosen candidate forward via
    \`start-flow --from-idea-artifact=<path> --from-idea-candidate=I-<n>\`
-   (Wave 23 / v5.0.0) so brainstorm reuses the idea's divergent + critique +
+   so brainstorm reuses the idea's divergent + critique +
    rank work via \`interactionHints.brainstorm.fromIdeaArtifact\`; do NOT
    ask brainstorm to regenerate it.
 
@@ -395,7 +395,7 @@ Required options, in this order:
 ### Phase 6 - Execute the choice
 
 - Start /cc: load \`${RUNTIME_ROOT}/skills/using-cclaw/SKILL.md\` and run
-  \`/cc <phrase>\`. **Wave 23 (v5.0.0) handoff carry-forward (mandatory when starting from /cc-idea):**
+  \`/cc <phrase>\`. **Handoff carry-forward (mandatory when starting from /cc-idea):**
   the harness shim that turns \`/cc <phrase>\` into a \`start-flow\` invocation
   MUST forward the originating idea artifact and chosen candidate so brainstorm
   reuses divergent + critique + rank work instead of redoing it. Equivalent CLI

package/dist/content/iron-laws.js

@@ -158,7 +158,7 @@ function hardGateReference(law) {
         .join(", ");
 }
 export function ironLawsSkillMarkdown() {
-    // v6.9.0: Phase A purged the `PreToolUse` / `PostToolUse` / pre-tool
+    // Phase A purged the `PreToolUse` / `PostToolUse` / pre-tool
     // pipeline handlers, so `review-coverage-complete-before-ship` is no
     // longer hook-enforced — it now lives in the ship stage HARD-GATE.
     // Only `stop-clean-or-handoff` (Stop hook) is still hook-enforced;

package/dist/content/node-hooks.js

@@ -544,7 +544,7 @@ async function handleSessionStart(runtime) {
   );
   const knowledge = await buildKnowledgeDigest(runtime.root, state.currentStage, knowledgeRaw);
 
-  // Wave 21 honest-core: session-start no longer runs background helper
+  // honest-core: session-start no longer runs background helper
   // pipelines or digest caches. It rehydrates flow + knowledge only.
   const ralphLoopLine = "";
   const earlyLoopLine = "";
@@ -614,7 +614,7 @@ async function handleSessionStart(runtime) {
   if (metaContent.length > 0) {
     parts.push(metaContent);
   }
-  // v6.9.0: load iron-laws content into the session-start digest so the
+  // load iron-laws content into the session-start digest so the
   // non-negotiable workflow constraints are visible from the first turn,
   // not lazily on tool dispatch.
   if (ironLawsContent.length > 0) {

package/dist/content/skills-elicitation.js

@@ -47,7 +47,7 @@ These behaviors are the exact reason this skill exists. The linter will block yo
 - Use harness-native question tools first; prose fallback is allowed only when the tool is unavailable.
 - Keep a running Q&A trace in the active artifact under \`## Q&A Log\` in \`${RUNTIME_ROOT}/artifacts/\` as append-only rows.
 - **Early-loop ledger discipline**: Never append \`.cclaw/state/early-loop-log.jsonl\` rows whose \`iteration\` exceeds the active \`maxIterations\`. If the cap fired, escalate or accept convergence outcomes—do not bump the iteration counter afterward. \`deriveEarlyLoopStatus\` clamps persistence, but the log source should stay honest too.
-- **Convergence floor (a.k.a. "Q&A Ralph Loop" / "Elicitation Convergence")**: do NOT advance the stage (do NOT call \`stage-complete.mjs\`) until Q&A converges. The machine contract matches \`evaluateQaLogFloor\` in \`src/artifact-linter/shared.ts\` (rule \`qa_log_unconverged\`). Pass when ANY holds: (a) every forcing-question topic id is tagged \`[topic:<id>]\` on at least one \`## Q&A Log\` row; (b) the Q&A Ralph Loop detector fires (last 2 substantive rows are non-decision-changing: \`skip\`/\`continue\`/\`no-change\`/\`done\`/etc.) **and** the log has at least \`max(2, questionBudgetHint(discoveryMode, stage).min)\` substantive rows — **unless** \`discoveryMode\` is \`guided\` or \`deep\` with pending forcing-topic ids (then the Q&A Ralph Loop alone cannot pass until topics are tagged, a stop-signal is recorded, or \`--skip-questions\` downgrades the finding to advisory); (c) an explicit user stop-signal row; or (d) \`--skip-questions\` was persisted (unconverged is advisory only). Wave 24 (v6.0.0) made \`[topic:<id>]\` mandatory (no English keyword fallback). The "Q&A Ralph Loop" is the elicitation-stage convergence mechanism; the producer/critic Concern Ledger that drives early-stage iteration is the **Early-Loop**, persisted in \`.cclaw/state/early-loop-log.jsonl\` and \`early-loop.json\` — they are different machines, do not conflate them.
+- **Convergence floor (a.k.a. "Q&A Ralph Loop" / "Elicitation Convergence")**: do NOT advance the stage (do NOT call \`stage-complete.mjs\`) until Q&A converges. The machine contract matches \`evaluateQaLogFloor\` in \`src/artifact-linter/shared.ts\` (rule \`qa_log_unconverged\`). Pass when ANY holds: (a) every forcing-question topic id is tagged \`[topic:<id>]\` on at least one \`## Q&A Log\` row; (b) the Q&A Ralph Loop detector fires (last 2 substantive rows are non-decision-changing: \`skip\`/\`continue\`/\`no-change\`/\`done\`/etc.) **and** the log has at least \`max(2, questionBudgetHint(discoveryMode, stage).min)\` substantive rows — **unless** \`discoveryMode\` is \`guided\` or \`deep\` with pending forcing-topic ids (then the Q&A Ralph Loop alone cannot pass until topics are tagged, a stop-signal is recorded, or \`--skip-questions\` downgrades the finding to advisory); (c) an explicit user stop-signal row; or (d) \`--skip-questions\` was persisted (unconverged is advisory only). made \`[topic:<id>]\` mandatory (no English keyword fallback). The "Q&A Ralph Loop" is the elicitation-stage convergence mechanism; the producer/critic Concern Ledger that drives early-stage iteration is the **Early-Loop**, persisted in \`.cclaw/state/early-loop-log.jsonl\` and \`early-loop.json\` — they are different machines, do not conflate them.
 - **NEVER run shell hash commands** (\`shasum\`, \`sha256sum\`, \`md5sum\`, \`Get-FileHash\`, \`certutil\`, etc.) to compute artifact hashes. If a linter ever asks you for a hash, that is a linter bug — report failure and stop, do not auto-fix in bash.
 - **NEVER paste cclaw command lines into chat** (e.g. \`node .cclaw/hooks/stage-complete.mjs ... --evidence-json '{...}'\`). Run them via the tool layer; report only the resulting summary. The user does not run cclaw manually and seeing the command line is noise.
 
@@ -121,7 +121,7 @@ Default mapping note: \`lean\` maps to a lightweight specialist tier on early st
 
 ### Topic tagging (MANDATORY for forcing-question rows)
 
-Each forcing question has a stable topic id (kebab-case ASCII, e.g. \`pain\`, \`direct-path\`, \`data-flow\`). Tag the matching Q&A Log row's \`Decision impact\` cell with \`[topic:<id>]\` so the linter can verify coverage in any natural language. This is a **HARD requirement** in Wave 24 (v6.0.0): the linter no longer keyword-matches English question prose, so an un-tagged row does NOT count toward coverage even if the answer fully addresses the topic.
+Each forcing question has a stable topic id (kebab-case ASCII, e.g. \`pain\`, \`direct-path\`, \`data-flow\`). Tag the matching Q&A Log row's \`Decision impact\` cell with \`[topic:<id>]\` so the linter can verify coverage in any natural language. This is a **HARD requirement** in the linter no longer keyword-matches English question prose, so an un-tagged row does NOT count toward coverage even if the answer fully addresses the topic.
 
 RU example (after asking \`pain\` in Russian):
 

package/dist/content/skills.d.ts

@@ -19,15 +19,13 @@ export declare const INVESTIGATION_DISCIPLINE_STAGES: ReadonlySet<FlowStage>;
 export declare function investigationDisciplineBlock(): string;
 export declare function behaviorAnchorBlock(stage: FlowStage): string;
 /**
- * v6.12.0 Phase Ritual + Phase W — TDD-only top-of-skill sections that
- * sit immediately after the `<EXTREMELY-IMPORTANT>` Iron Law block and
- * before `## Quick Start`. They establish the per-slice three-dispatch
- * ritual + wave batch mode in imperative voice with literal commands so
- * pattern-matching on read works in our favor.
+ * TDD-only prelude after `<EXTREMELY-IMPORTANT>`: wave routing + canonical
+ * `slice-builder` dispatch. Uses literal commands so pattern-matching on read
+ * matches operator scripts.
  *
  * Empty for non-TDD stages.
  */
 export declare function tddTopOfSkillBlock(stage: FlowStage): string;
 export declare function stageSkillFolder(stage: FlowStage): string;
-export declare function stageSkillMarkdown(stage: FlowStage, track?: FlowTrack): string;
+export declare function stageSkillMarkdown(stage: FlowStage, track?: FlowTrack, _packageVersion?: string | null): string;
 export declare function executingWavesSkillMarkdown(): string;

package/dist/content/skills.js

@@ -103,7 +103,7 @@ Any "the failure is real" claim (failing test, broken build, regression catch, d
 
 \`proof: <iso-ts> | <observed snippet — first 200 chars> | source: <command or log path>\`
 
-For TDD specifically, this is the watched-RED proof and is required per new test before \`stage-complete\` accepts the stage. From v6.12.0 onward, every slice on every TDD run dispatches three roles in this exact order: (1) \`test-author --slice S-<id> --phase red\`, (2) ONE message with TWO concurrent Task calls — \`slice-implementer --slice S-<id> --phase green --paths <production paths>\` AND \`slice-documenter --slice S-<id> --phase doc --paths <artifacts-dir>/tdd-slices/S-<id>.md\`, (3) \`slice-implementer --phase refactor\` or \`--phase refactor-deferred --refactor-rationale "<why>"\`. The linter auto-derives the \`Watched-RED Proof\` and \`Vertical Slice Cycle\` tables in \`06-tdd.md\` from \`.cclaw/state/delegation-events.jsonl\`. Do NOT hand-edit those tables. \`slice-implementer\` and \`slice-documenter\` are mandatory regardless of \`discoveryMode\` (v6.12.0 Phase R/M); the controller MUST NOT write GREEN production code or per-slice prose itself. v6.10.0 sidecar (\`06-tdd-slices.jsonl\`) is removed; \`cclaw-cli sync\` cleans the file from existing installs.
+For TDD, watched-RED proof is mandatory before \`stage-complete\` accepts the slice. Dispatch \`slice-builder\` end-to-end: it owns RED/GREEN evidence rows, refactor coverage per the hook flags, \`<artifacts-dir>/tdd-slices/S-<id>.md\`, and (when wired) \`slice-completed\`. The linter mirrors phase history into auto-render markers in \`06-tdd.md\` — never hand-fill those fragments.
 `;
 }
 /**
@@ -172,67 +172,28 @@ ${items.map((item) => `- ${item}`).join("\n")}
 `;
 }
 /**
- * v6.12.0 Phase Ritual + Phase W — TDD-only top-of-skill sections that
- * sit immediately after the `<EXTREMELY-IMPORTANT>` Iron Law block and
- * before `## Quick Start`. They establish the per-slice three-dispatch
- * ritual + wave batch mode in imperative voice with literal commands so
- * pattern-matching on read works in our favor.
+ * TDD-only prelude after `<EXTREMELY-IMPORTANT>`: wave routing + canonical
+ * `slice-builder` dispatch. Uses literal commands so pattern-matching on read
+ * matches operator scripts.
  *
  * Empty for non-TDD stages.
  */
 export function tddTopOfSkillBlock(stage) {
     if (stage !== "tdd")
         return "";
-    return `## Per-Slice Ritual (v6.12.0+)
+    return `## TDD orchestration primer
 
-ONE slice = THREE dispatches, in this order. Do not skip, do not collapse.
+**Always first:** run \`node .cclaw/cli.mjs internal wave-status --json\` — it reads the managed plan markers; open \`05-plan.md\`/wave-plan files afterward for detail.
 
-1. **RED** — \`Task("test-author --slice S-<id> --phase red")\`.
-2. **Verify RED** — wait for the \`phase=red\` event in \`.cclaw/state/delegation-events.jsonl\` with non-empty \`evidenceRefs\`. No production edits.
-3. **GREEN+DOC fan-out** — ONE message, TWO concurrent Tasks:
-   \`\`\`
-   Task("slice-implementer --slice S-<id> --phase green --paths <prod paths>")
-   Task("slice-documenter  --slice S-<id> --phase doc   --paths <artifacts-dir>/tdd-slices/S-<id>.md")
-   \`\`\`
-   The file-overlap scheduler auto-allows parallel dispatch because \`claimedPaths\` are disjoint. Fire BOTH calls in the same message — never serialize independent work.
-4. **REFACTOR** — \`Task("slice-implementer --slice S-<id> --phase refactor")\` OR \`--phase refactor-deferred --refactor-rationale '<why>'\`.
+**Several ready lanes:** Issue exactly one AskQuestion (**launch parallel wave**, default vs **single slice**).
 
-**Rule 1 (v6.13.1):** Before any slice-routing question, read \`<artifacts-dir>/05-plan.md\` (managed \`## Parallel Execution Plan\`) **and** list \`<artifacts-dir>/wave-plans/wave-NN.md\`. Merge mentally: Parallel Execution Plan first, wave files second; duplicate slices with conflicting wave membership are invalid. If the merged plan shows a wave with **two or more** scheduler-ready slices, issue **exactly one** \`AskQuestion\`: \`Launch wave W-NN with N parallel lanes (S-a, S-b, ...)?\` with default option **launch wave** and alternate **single-slice instead**. Do not ask "which slice next?" when that question is redundant (single ready slice or no wave). After **launch wave** confirmation, execute RED checkpoint → parallel GREEN+DOC → per-lane REFACTOR without further routing asks. After **single-slice instead**, fall back to the legacy single-slice ritual. **Wave dispatch resume:** if part of the wave is already done, parallelize only the remaining members.
+**Delegation order:** Emit \`delegation-record\` \`--status=scheduled\` then \`--status=launched\` *before* every \`Task\`; workers ACK/complete locally.
 
-**FORBIDDEN:**
-- Controller writing GREEN production code. ALL GREEN goes through \`slice-implementer\` — linter rule \`tdd_slice_implementer_missing\` blocks the gate.
-- Controller writing per-slice prose into legacy \`06-tdd.md\` sections (Test Discovery / RED Evidence / GREEN Evidence / Watched-RED Proof / Vertical Slice Cycle / Per-Slice Review / Failure Analysis / Acceptance Mapping). \`slice-documenter\` owns \`tdd-slices/S-<id>.md\` — \`tdd_slice_documenter_missing\` blocks the gate.
-- Hand-editing auto-render blocks between \`auto-start: tdd-slice-summary\` / \`auto-start: slices-index\` markers — overwritten every lint.
+**Per slice worker:** Prefer \`Task("slice-builder --slice S-<id> ...")\`. Pass explicit \`--paths\`; parallel Tasks are okay when overlaps are disjoint. Follow any lane lease flags the helper still mandates on your ledger.
 
-Delegation-record signature (extend with lane metadata for every GREEN row in \`worktree-first\`):
-
-\`node .cclaw/hooks/delegation-record.mjs --stage=tdd --agent=slice-implementer --mode=mandatory --status=scheduled --span-id=<id> --dispatch-id=<id> --dispatch-surface=<surface> --agent-definition-path=<path> --slice=S-1 --phase=green --paths=src/a.ts --claim-token=<opaque> --lane-id=<lane> --lease-until=<iso8601> --json\`
-
-## Wave Batch Mode (v6.13.1+)
-
-**Triggers:** managed \`## Parallel Execution Plan\` in \`05-plan.md\` **or** any \`<artifacts-dir>/wave-plans/wave-NN.md\`, OR 2+ slices with disjoint \`claimedPaths\`. Cap = 5 \`slice-implementer\` lanes (10 subagents incl. paired documenters) via \`MAX_PARALLEL_SLICE_IMPLEMENTERS\`. **Preconditions:** Load both sources before routing. Worktree-first: every GREEN delegation-record MUST include \`--claim-token\`, \`--lane-id\`, \`--lease-until\` (hook exits \`2\`, \`dispatch_lane_metadata_missing\` otherwise).
-
-**Phase A — RED checkpoint** — ONE message, all test-authors:
-\`\`\`
-Task("test-author --slice S-1 --phase red")
-Task("test-author --slice S-2 --phase red")
-Task("test-author --slice S-3 --phase red")
-\`\`\`
-Wait for ALL Phase A REDs to land with non-empty \`evidenceRefs\` before Phase B. Linter \`tdd_red_checkpoint_violation\` (required: true) blocks any wave where a \`phase=green\` \`completedTs\` precedes the wave's last \`phase=red\` \`completedTs\`.
-
-**Phase B — GREEN+DOC fan-out** — ONE message; pair per slice (repeat for each lane, flags unique per lane):
-
-\`\`\`
-Task("slice-implementer --slice S-1 --phase green --paths <prod> --claim-token=<t> --lane-id=<lane-1> --lease-until=<iso>")
-Task("slice-documenter  --slice S-1 --phase doc   --paths <artifacts-dir>/tdd-slices/S-1.md")
-\`\`\`
-
-Launch every slice's pair in that same message. **Never serialize independent work.**
-
-**Phase C — REFACTOR per slice** — after GREEN+DOC lands, dispatch refactor/refactor-deferred per slice. **Fan-in (worktree-first):** echo claim/lane/lease on completed GREEN rows; stage-complete runs deterministic \`git apply --3way\` (no \`-X ours/theirs\`). Conflicts: \`slice-implementer --phase resolve-conflict\`. With 2+ lanes, still dispatch \`integration-overseer\` before review.
-
-**slice-documenter:** record the \`phase=doc\` row in the same message as GREEN; write a **provisional** row in \`tdd-slices/S-<id>.md\` immediately at dispatch, then **finalize** that file after the matching \`slice-implementer\` \`phase=green\` event lands (evidence-backed prose, not guesswork before GREEN exists).
+Wave resume: reuse \`wave-status\` outputs and parallelize unfinished members instead of restarting finished slices.
 
+---
 `;
 }
 function artifactTemplatePathForStage(stage) {
@@ -469,7 +430,7 @@ function mergedAntiPatterns(philosophy, execution) {
 }
 function completionParametersBlock(schema, track) {
     const gateList = schema.executionModel.requiredGates.map((g) => `\`${g.id}\``).join(", ");
-    // Wave 24 (v6.0.0): mandatory agents are dropped on `quick` track. Surface
+    // Mandatory agents are dropped on `quick` track. Surface
     // the empty list so the rendered SKILL.md doesn't tell quick-track runs to
     // dispatch agents the linter is going to skip.
     const trackAwareMandatoryAgents = track === "quick" ? [] : schema.reviewLens.mandatoryDelegations;
@@ -477,7 +438,7 @@ function completionParametersBlock(schema, track) {
     const mandatory = trackAwareMandatoryAgents.length > 0
         ? trackAwareMandatoryAgents.map((a) => `\`${a}\``).join(", ")
         : track === "quick" && schema.reviewLens.mandatoryDelegations.length > 0
-            ? "none (skipped: quick track — Wave 24)"
+            ? "none (skipped: quick track)"
             : "none";
     const resolvedNextStage = nextStageForTrack(schema.stage, track);
     const nextStage = resolvedNextStage ?? "done";
@@ -619,7 +580,7 @@ function dedupeGuidance(items, blockedBy) {
     }
     return result;
 }
-export function stageSkillMarkdown(stage, track = "standard") {
+export function stageSkillMarkdown(stage, track = "standard", _packageVersion) {
     const schema = stageSchema(stage, track);
     const trackContext = stageTrackRenderContext(track);
     const philosophy = schema.philosophy;

package/dist/content/stage-schema.d.ts

@@ -56,7 +56,7 @@ export declare function parseSkillEnvelope(raw: string): SkillEnvelope | null;
 /** Transition guard: agents with `mode: "mandatory"` in auto-subagent dispatch for this stage. */
 export declare function mandatoryDelegationsForStage(stage: FlowStage, complexityTier?: StageComplexityTier): string[];
 /**
- * Wave 24 (v6.0.0) — track-aware mandatory delegation lookup.
+ * Track-aware mandatory delegation lookup.
  *
  * Returns `[]` (skip the gate entirely) when the run is on a small-fix
  * track or classified as a software bugfix:
@@ -85,7 +85,7 @@ export declare function mandatoryDelegationsForStage(stage: FlowStage, complexit
 export type MandatoryDelegationTaskClass = "software-standard" | "software-trivial" | "software-bugfix";
 export declare function mandatoryAgentsFor(stage: FlowStage, track: FlowTrack, taskClass?: MandatoryDelegationTaskClass | null, complexityTier?: StageComplexityTier, discoveryMode?: DiscoveryMode): string[];
 /**
- * Wave 25 (v6.1.0) — track-aware artifact validation demotion.
+ * Track-aware artifact validation demotion.
  *
  * Mirrors `mandatoryAgentsFor`'s skip logic for the small-fix lanes.
  * Returns `true` when artifact-level "advanced" validation rules
@@ -96,7 +96,7 @@ export declare function mandatoryAgentsFor(stage: FlowStage, track: FlowTrack, t
  *   - `track === "quick"` — quick-tier runs (single-purpose
  *     landing-page edits, doc tweaks, config nudges). The advanced
  *     checks fire on architecture surfaces a quick-track artifact
- *     usually doesn't have. Same trigger as Wave 24 Phase B.
+ *     usually doesn't have.
  *   - `taskClass === "software-bugfix"` — bugfixes carry RED-first
  *     repro coverage; tdd/review own the safety surface.
  *