cclaw-cli 6.14.4 → 7.0.0

package/dist/delegation.d.ts

@@ -7,6 +7,8 @@ export type DelegationMode = "mandatory" | "proactive";
 export type DelegationStatus = "scheduled" | "launched" | "acknowledged" | "completed" | "failed" | "waived" | "stale";
 export declare const DELEGATION_DISPATCH_SURFACES: readonly ["claude-task", "cursor-task", "opencode-agent", "codex-agent", "generic-task", "role-switch", "manual"];
 export type DelegationDispatchSurface = typeof DELEGATION_DISPATCH_SURFACES[number];
+/** Agents that declare `claimedPaths` for parallel/disjoint scheduling and fan-out caps. */
+export declare function isParallelTddSliceWorker(agent: string | undefined): boolean;
 /**
  * Per-surface allowed agent-definition path prefixes. Used by the generated
  * `.cclaw/hooks/delegation-record.mjs` helper to reject mismatched
@@ -63,9 +65,9 @@ export type DelegationEntry = {
     acceptedBy?: DelegationWaiverAcceptedBy;
     /**
      * Waiver approval token captured from `cclaw-cli internal waiver-grant`.
-     * Present on waiver rows written after v6.7.0. Legacy waiver rows omit
-     * these fields and are surfaced as the advisory linter finding
-     * `waiver_legacy_provenance`.
+     * Present on waiver rows that went through `cclaw-cli internal
+     * waiver-grant`. Legacy rows that lack provenance are surfaced as the
+     * advisory linter finding `waiver_legacy_provenance`.
      */
     approvalToken?: string;
     approvalReason?: string;
@@ -118,85 +120,63 @@ export type DelegationEntry = {
      */
     schemaVersion?: 1 | 2 | 3;
     /**
-     * v6.8.0 — when set, the operator explicitly opted into running this
+     * When set, the operator explicitly opted into running this
      * scheduled span concurrently with another active span on the same
      * `(stage, agent)` pair. Bypasses the dispatch-dedup check.
      */
     allowParallel?: boolean;
     /**
-     * v6.8.0 — set on synthetic terminal `stale` rows written via
+     * Set on synthetic terminal `stale` rows written via
      * `--supersede=<prevSpanId>`. References the new spanId that
      * superseded this span. Helps `/cc tree` and the linter report a
      * coherent successor chain.
      */
     supersededBy?: string;
     /**
-     * v6.10.0 (P1) — repo-relative paths the delegated unit will edit.
-     * Used by the slice-implementer file-overlap scheduler to either
-     * auto-allow parallel dispatch (disjoint paths) or block the row
-     * with `DispatchOverlapError` (overlapping paths). For agents
-     * other than slice-implementer the field is advisory.
+     * Repo-relative paths the delegated slice-builder will edit. Used by the
+     * file-overlap scheduler to either auto-allow parallel dispatch (disjoint
+     * paths) or block the row with `DispatchOverlapError` (overlapping paths).
+     * For agents other than `slice-builder` the field is advisory.
      *
      * keep in sync with the inline copy in
      * `src/content/hooks.ts::delegationRecordScript`.
      */
     claimedPaths?: string[];
     /**
-     * v6.11.0 (D1) — TDD slice identifier, e.g. `"S-1"`. Recorded by the
-     * controller when dispatching `test-author` / `slice-implementer` /
-     * `slice-documenter` so the artifact linter can auto-derive the
+     * TDD slice identifier, e.g. `"S-1"`. Recorded by the controller when
+     * dispatching `slice-builder` so the artifact linter can auto-derive the
      * Watched-RED Proof + Vertical Slice Cycle tables from
-     * `delegation-events.jsonl` instead of requiring agents to maintain
-     * the markdown by hand. Optional: legacy and non-TDD rows omit it.
+     * `delegation-events.jsonl` instead of requiring agents to maintain the
+     * markdown by hand. Optional on non-TDD rows.
      *
      * keep in sync with the inline copy in
      * `src/content/hooks.ts::delegationRecordScript`.
      */
     sliceId?: string;
     /**
-     * v6.11.0 (D1) — explicit phase tag for TDD slice events. Combined
-     * with `sliceId`, the linter validates RED -> GREEN -> REFACTOR
-     * monotonicity per slice. `refactor-deferred` requires a rationale
-     * either via `--refactor-rationale` (recorded into evidenceRefs[0])
-     * or an `evidenceRefs` entry that contains the rationale text.
-     * `doc` is reserved for the parallel `slice-documenter` subagent
-     * (Phase C). Optional: legacy and non-TDD rows omit it.
+     * Explicit phase tag for TDD slice events. Combined with `sliceId`, the
+     * linter validates RED → GREEN → REFACTOR → DOC monotonicity per slice.
+     * `refactor-deferred` requires a rationale either via
+     * `--refactor-rationale` (recorded into `evidenceRefs[0]`) or an
+     * `evidenceRefs` entry that contains the rationale text.
      *
      * keep in sync with the inline copy in
      * `src/content/hooks.ts::delegationRecordScript`.
      */
     phase?: "red" | "green" | "refactor" | "refactor-deferred" | "doc" | "resolve-conflict";
     /**
-     * v6.13.0 — opaque token tying scheduled work to terminal lifecycle rows
-     * under worktree-first execution (mandatory on new schedules).
-     */
-    claimToken?: string;
-    /** v6.13.0 — lane / worktree id owning the slice checkout. */
-    ownerLaneId?: string;
-    /** v6.13.0 — ISO lease expiry for reclaim sweeps. */
-    leasedUntil?: string;
-    /** v6.13.0 — lease bookkeeping for audit + reclaim tooling. */
-    leaseState?: "claimed" | "expired" | "released" | "reclaimed";
-    /** v6.13.0 — plan unit dependency ids echoed for scheduler diagnostics. */
-    dependsOn?: string[];
-    /**
-     * v6.13.0 — integration branch merge status after deterministic fan-in.
-     */
-    integrationState?: "pending" | "applied" | "conflict" | "resolved" | "abandoned";
-    /**
-     * v6.14.0 — refactor outcome folded into `phase=green` events so a single
-     * row can close RED→GREEN→REFACTOR for the slice without a separate
+     * Refactor outcome folded into `phase=green` events so a single row can
+     * close RED → GREEN → REFACTOR for the slice without a separate
      * `phase=refactor` / `phase=refactor-deferred` lifecycle pass.
      *
      * - `mode: "inline"` — refactor pass ran inline as part of the GREEN
      *   delegation (rationale optional but recommended for traceability).
      * - `mode: "deferred"` — refactor was intentionally deferred; rationale
      *   is required (carried in `rationale` and mirrored into
-     *   `evidenceRefs[0]` so legacy linters that read evidence still work).
+     *   `evidenceRefs[0]` so evidence-pointer linters keep matching).
      *
-     * `phase=refactor` and `phase=refactor-deferred` events remain valid
-     * for backward compatibility; the linter accepts either form for
-     * REFACTOR coverage.
+     * `phase=refactor` and `phase=refactor-deferred` events remain valid;
+     * the linter accepts either form for REFACTOR coverage.
      *
      * keep in sync with the inline copy in
      * `src/content/hooks.ts::delegationRecordScript`.
@@ -206,10 +186,10 @@ export type DelegationEntry = {
         rationale?: string;
     };
     /**
-     * v6.14.0 — risk tier hint copied from the plan slice. Used by
-     * `integrationCheckRequired()` to decide whether the
-     * integration-overseer must run. `low` and `medium` are advisory;
-     * `high` always triggers the overseer. Optional on every row.
+     * Risk tier hint copied from the plan slice. Used by
+     * `integrationCheckRequired()` to decide whether the integration-overseer
+     * must run. `low` and `medium` are advisory; `high` always triggers the
+     * overseer. Optional on every row.
      */
     riskTier?: "low" | "medium" | "high";
 };
@@ -238,31 +218,9 @@ export type DelegationEvent = DelegationEntry & {
  */
 export declare function isTrustBoundaryPath(filePath: string): boolean;
 export declare function readDelegationLedger(projectRoot: string): Promise<DelegationLedger>;
-/** Parsed `cclaw_fanin_*` audit rows from `delegation-events.jsonl`. */
-export interface FanInAuditRecord {
-    event: "cclaw_fanin_applied" | "cclaw_fanin_conflict" | "cclaw_fanin_resolved" | "cclaw_fanin_abandoned";
-    runId?: string;
-    laneId?: string;
-    sliceIds?: string[];
-    integrationBranch?: string;
-    details?: string;
-    ts: string;
-}
-/**
- * Append a deterministic fan-in audit row (not a delegation lifecycle event).
- */
-export declare function recordCclawFanInAudit(projectRoot: string, params: {
-    kind: FanInAuditRecord["event"];
-    runId: string;
-    laneId: string;
-    sliceIds: string[];
-    integrationBranch: string;
-    details?: string;
-}): Promise<void>;
 export declare function readDelegationEvents(projectRoot: string): Promise<{
     events: DelegationEvent[];
     corruptLines: number[];
-    fanInAudits: FanInAuditRecord[];
 }>;
 /**
  * Fold ledger entries to the latest row per `spanId` and keep only spans
@@ -284,7 +242,7 @@ export declare function readDelegationEvents(projectRoot: string): Promise<{
  */
 export declare function computeActiveSubagents(entries: DelegationEntry[]): DelegationEntry[];
 /**
- * v6.8.0 — thrown by `validateMonotonicTimestamps` when an incoming row
+ * Thrown by `validateMonotonicTimestamps` when an incoming row
  * would push a span's timeline backwards. Carries enough context that
  * the CLI / hook surface can format a `delegation_timestamp_non_monotonic`
  * JSON payload without re-deriving the offending field.
@@ -299,7 +257,7 @@ export declare class DelegationTimestampError extends Error {
     constructor(field: string, actual: string, priorBound: string);
 }
 /**
- * v6.8.0 — enforce that lifecycle timestamps on a delegation span move
+ * Enforce that lifecycle timestamps on a delegation span move
  * forward (or stay equal). Validates both per-row invariants
  * (`startTs ≤ launchedTs ≤ ackTs ≤ completedTs`) and a cross-row
  * invariant: the union of prior rows for this `spanId` plus the
@@ -313,7 +271,7 @@ export declare class DelegationTimestampError extends Error {
  */
 export declare function validateMonotonicTimestamps(stamped: DelegationEntry, prior: DelegationEntry[]): void;
 /**
- * v6.8.0 — thrown by `appendDelegation` when the operator opens a
+ * Thrown by `appendDelegation` when the operator opens a
  * second `scheduled` span on the same `(stage, agent)` pair while an
  * earlier span on the same pair is still active. Callers can catch and
  * either pass the existing span id via `--supersede=<id>` (which
@@ -339,13 +297,12 @@ export declare class DispatchDuplicateError extends Error {
     });
 }
 /**
- * v6.10.0 (P1) — thrown by `validateFileOverlap` when a new
- * `slice-implementer` is scheduled on a TDD stage with at least one
- * `claimedPaths` entry that overlaps an active span. The cclaw scheduler
- * auto-allows parallel dispatch when paths are disjoint, so an explicit
- * overlap is treated as a serialization signal: the operator must wait
- * for the existing span to terminate or pass `--allow-parallel`
- * deliberately to acknowledge the conflict.
+ * Thrown by `validateFileOverlap` when a new `slice-builder` is scheduled
+ * on a TDD stage with at least one `claimedPaths` entry that overlaps an
+ * active span. The scheduler auto-allows parallel dispatch when paths are
+ * disjoint, so an explicit overlap is treated as a serialization signal:
+ * the operator must wait for the existing span to terminate or pass
+ * `--allow-parallel` deliberately to acknowledge the conflict.
  */
 export declare class DispatchOverlapError extends Error {
     readonly existingSpanId: string;
@@ -366,11 +323,10 @@ export declare class DispatchOverlapError extends Error {
     });
 }
 /**
- * v6.10.0 (P2) — thrown when the count of active `slice-implementer`
- * spans (after fold) reaches `MAX_PARALLEL_SLICE_IMPLEMENTERS` and a new
- * scheduled row would push it past the cap. Cap can be overridden once
- * via `--override-cap=N` on the hook flag or globally via
- * `CCLAW_MAX_PARALLEL_SLICE_IMPLEMENTERS=<N>` env.
+ * Thrown when the count of active `slice-builder` spans reaches
+ * `MAX_PARALLEL_SLICE_BUILDERS` and a new scheduled row would push it past
+ * the cap. Cap can be overridden once via `--override-cap=N` on the hook
+ * flag or globally via `CCLAW_MAX_PARALLEL_SLICE_BUILDERS=<N>` env.
  */
 export declare class DispatchCapError extends Error {
     readonly cap: number;
@@ -389,17 +345,10 @@ export declare class DispatchCapError extends Error {
     });
 }
 /**
- * v6.13.0 — claim / lease contract violation for worktree-first TDD rows.
- */
-export declare class DispatchClaimInvalidError extends Error {
-    constructor(message: string);
-}
-/**
- * v6.10.0 (P2) — default cap on active `slice-implementer` spans in a
- * single TDD run. Aligned with evanflow's parallel cap. Override via
- * `CCLAW_MAX_PARALLEL_SLICE_IMPLEMENTERS=<int>` (validated `>=1`).
+ * Default cap on active `slice-builder` spans in a single TDD run. Override
+ * via `CCLAW_MAX_PARALLEL_SLICE_BUILDERS=<int>` (validated `>=1`).
  */
-export declare const MAX_PARALLEL_SLICE_IMPLEMENTERS: 5;
+export declare const MAX_PARALLEL_SLICE_BUILDERS: 5;
 export interface ReadySliceUnit {
     unitId: string;
     sliceId: string;
@@ -413,7 +362,6 @@ export interface SelectReadySlicesOptions {
     activePathHolders: ReadonlyArray<{
         paths: string[];
     }>;
-    legacyContinuation: boolean;
 }
 /**
  * Return up to `cap` slice units whose dependsOn are satisfied, avoiding
@@ -421,18 +369,18 @@ export interface SelectReadySlicesOptions {
  */
 export declare function selectReadySlices(units: ReadySliceUnit[], opts: SelectReadySlicesOptions): ReadySliceUnit[];
 /**
- * v6.13.1 — build scheduler rows from merged parallel wave definitions + plan units.
+ * Build scheduler rows from merged parallel wave definitions + plan units.
  */
 export declare function readySliceUnitsFromMergedWaves(mergedWaves: ParsedParallelWave[], planMarkdown: string, options?: ParseImplementationUnitParallelOptions): ReadySliceUnit[];
 /**
- * v6.14.0 — verdict from `integrationCheckRequired()`.
+ * Verdict from `integrationCheckRequired()`.
  *
  * `required: true` means the controller MUST dispatch
  * `integration-overseer` before stage-complete; `reasons[]` lists the
  * triggers that fired so the controller can quote them in artifacts.
  *
  * `required: false` means the integration check can be safely skipped
- * (disjoint paths, no high-risk slices, no fan-in conflicts). Callers
+ * (disjoint paths and no high-risk slices). Callers
  * that skip dispatch should append a `cclaw_integration_overseer_skipped`
  * audit row to `delegation-events.jsonl` so the run log stays honest
  * about the decision.
@@ -442,16 +390,14 @@ export interface IntegrationCheckVerdict {
     reasons: string[];
 }
 /**
- * v6.14.0 — heuristic helper deciding whether a multi-slice wave needs
+ * Heuristic helper deciding whether a multi-slice wave needs
  * the `integration-overseer` dispatch.
  *
  * Triggers (any one):
  *   - **two or more closed slices share import boundaries** (heuristic:
  *     two slices declare a `claimedPaths` whose first 2 path segments
  *     match — same package/module directory);
- *   - any slice has `riskTier === "high"`;
- *   - any `cclaw_fanin_conflict` audit row exists in the supplied
- *     events list (regardless of slice).
+ *   - any slice has `riskTier === "high"`.
  *
  * When none fire, the verdict is `{ required: false, reasons: ["disjoint-paths"] }`
  * and the caller should record a `cclaw_integration_overseer_skipped`
@@ -462,9 +408,8 @@ export interface IntegrationCheckVerdict {
  * Use `readDelegationEvents(projectRoot)` in production paths.
  */
 export declare function integrationCheckRequired(events: DelegationEvent[]): IntegrationCheckVerdict;
-export declare function integrationCheckRequired(events: DelegationEvent[], fanInAudits: FanInAuditRecord[]): IntegrationCheckVerdict;
 /**
- * v6.14.0 — append a non-delegation audit event recording that the
+ * Append a non-delegation audit event recording that the
  * integration-overseer dispatch was skipped because
  * `integrationCheckRequired()` returned `required: false`. Best-effort;
  * never throws.
@@ -475,58 +420,53 @@ export declare function recordIntegrationOverseerSkipped(projectRoot: string, pa
     sliceIds: string[];
 }): Promise<void>;
 /**
- * v6.13.1 — load merged wave plan (Parallel Execution Plan block + wave-plans/) and map to `ReadySliceUnit[]`.
+ * Load merged wave plan (Parallel Execution Plan block + wave-plans/) and map to `ReadySliceUnit[]`.
  */
 export declare function loadTddReadySlicePool(planMarkdown: string, artifactsDir: string, options?: ParseImplementationUnitParallelOptions): Promise<ReadySliceUnit[]>;
 /**
- * v6.10.0 (P1) — when scheduling a `slice-implementer` on a TDD stage,
- * compare `claimedPaths` against every currently active span on the
- * same `(stage, agent)` pair. Overlap → throw `DispatchOverlapError`;
- * disjoint paths → return `{ autoParallel: true }` so the caller can
- * mark the new entry `allowParallel = true` without explicit operator
- * intent. When the agent is not a slice-implementer or no
- * `claimedPaths` are supplied, the function returns
- * `{ autoParallel: false }` and the legacy dedup path takes over.
+ * When scheduling a `slice-builder` on a TDD stage, compare `claimedPaths`
+ * against every currently active span on the same `(stage, agent)` pair.
+ * Overlap → throw `DispatchOverlapError`; disjoint paths → return
+ * `{ autoParallel: true }` so the caller can mark the new entry
+ * `allowParallel = true` without explicit operator intent. When the agent
+ * is not a slice-builder or no `claimedPaths` are supplied, the function
+ * returns `{ autoParallel: false }` and the standard dedup path takes over.
  */
 export declare function validateFileOverlap(stamped: DelegationEntry, activeEntries: DelegationEntry[]): {
     autoParallel: boolean;
 };
 /**
- * v6.10.0 (P2) — enforce the slice-implementer fan-out cap. The new
- * scheduled row pushes the active count from N to N+1; if that would
- * exceed the cap (default 5, env-overridable), throw `DispatchCapError`.
+ * Enforce the slice-builder fan-out cap. The new scheduled row pushes the
+ * active count from N to N+1; if that would exceed the cap (default 5,
+ * env-overridable via `CCLAW_MAX_PARALLEL_SLICE_BUILDERS`), throw
+ * `DispatchCapError`.
  *
- * Caller passes the already-folded list of active entries (latest row
- * per spanId, ACTIVE statuses only). The function counts entries that
- * match the agent on the same `stage`. The new row's own spanId is
- * excluded so re-recording a `scheduled` doesn't trip the cap on a
- * span that's already counted.
+ * Caller passes the already-folded list of active entries (latest row per
+ * spanId, ACTIVE statuses only). The function counts entries that match
+ * the agent on the same `stage`. The new row's own spanId is excluded so
+ * re-recording a `scheduled` doesn't trip the cap on a span that's already
+ * counted.
  */
 export declare function validateFanOutCap(stamped: DelegationEntry, activeEntries: DelegationEntry[], override?: number | null): void;
 /**
- * v6.9.0 — find the latest active span for a given `(stage, agent)`
+ * Find the latest active span for a given `(stage, agent)`
  * pair in the supplied ledger entries. Returns the row whose latest
  * status (after the latest-by-spanId fold) is still in the active set
  * (`scheduled | launched | acknowledged`).
  *
  * Run-scope is **strict**: only entries whose `runId` matches the
  * supplied `runId` are folded. Entries with empty/missing `runId`
- * (legacy ledgers from v6.8 and earlier) are treated as NOT belonging
+ * (older ledgers without explicit run scoping) are treated as NOT belonging
  * to the current run, so they cannot keep an old span "active" across
  * a fresh dispatch and trip a spurious `dispatch_duplicate`. This
- * fixes R7: a slice-implementer that ran in run-1 must not block a
- * slice-implementer scheduled in run-2.
+ * Ensures a slice-builder that ran in run-1 does not block a
+ * slice-builder scheduled in run-2.
  *
  * keep in sync with the inline copy in
  * `src/content/hooks.ts::delegationRecordScript`.
  */
 export declare function findActiveSpanForPair(stage: string, agent: string, runId: string, ledger: DelegationLedger): DelegationEntry | null;
 export declare function appendDelegation(projectRoot: string, entry: DelegationEntry): Promise<void>;
-/**
- * Scan delegation events for expired `leasedUntil` timestamps and append
- * best-effort `cclaw_slice_lease_expired` audit rows (one per span/slice key).
- */
-export declare function reclaimExpiredDelegationClaims(projectRoot: string, now?: Date): Promise<number>;
 /**
  * Aggregate the fulfillment mode cclaw expects for the active harness set.
  * Priority native > generic-dispatch > role-switch > waiver — the best
@@ -539,10 +479,10 @@ export declare function checkMandatoryDelegations(projectRoot: string, stage: Fl
     /**
      * Optional task class for the active run. When set to
      * `"software-bugfix"`, the mandatory delegation gate is skipped
-     * entirely (Wave 24). Callers that don't classify the run leave
+     * entirely. Callers that don't classify the run leave
      * this undefined; the function then falls back to
      * `flowState.taskClass` (persisted in `flow-state.json`) so the
-     * Wave 24 bugfix-skip remains active across the `cclaw advance-stage`
+     * Bugfix-skip remains active across the `cclaw advance-stage`
      * code path even when no caller forwards an explicit override.
      */
     taskClass?: MandatoryDelegationTaskClass | null;
@@ -564,7 +504,7 @@ export declare function checkMandatoryDelegations(projectRoot: string, stage: Fl
     /** Expected fulfillment mode for the active harness set. */
     expectedMode: DelegationFulfillmentMode;
     /**
-     * Wave 24 (v6.0.0): true when `mandatoryAgentsFor` returned [] for
+     * `true` when `mandatoryAgentsFor` returned [] for
      * this (track, taskClass) combination — i.e. the gate was skipped
      * entirely on quick track or software-bugfix runs. The skip is also
      * recorded as a `mandatory_delegations_skipped_by_track` event in
@@ -573,12 +513,12 @@ export declare function checkMandatoryDelegations(projectRoot: string, stage: Fl
     skippedByTrack: boolean;
 }>;
 /**
- * Wave 25 (v6.1.0) — append a non-delegation audit event recording
+ * Append a non-delegation audit event recording
  * that one or more required artifact-validation findings were
  * demoted from blocking to advisory because the active run is on a
  * small-fix lane (`track === "quick"` or `taskClass === "software-bugfix"`).
  *
- * The event mirrors the Wave 24 `mandatory_delegations_skipped_by_track`
+ * The event mirrors `mandatory_delegations_skipped_by_track`
  * audit pattern: best-effort write to `delegation-events.jsonl`, no
  * agent payload, recognized by `readDelegationEvents` so it does not
  * corrupt downstream parsers. Failures are swallowed.
@@ -591,12 +531,12 @@ export declare function recordArtifactValidationDemotedByTrack(projectRoot: stri
     sections: string[];
 }): Promise<void>;
 /**
- * Wave 25 (v6.1.0) — append a non-delegation audit event recording
+ * Append a non-delegation audit event recording
  * that the scope-stage Expansion Strategist (`product-discovery`)
  * delegation requirement was skipped because the active run is on a
  * small-fix lane (`track === "quick"` or `taskClass === "software-bugfix"`).
  *
- * Mirrors the Wave 24 `mandatory_delegations_skipped_by_track`
+ * Mirrors the `mandatory_delegations_skipped_by_track`
  * audit pattern: best-effort write to `delegation-events.jsonl`, no
  * agent payload, recognized by `readDelegationEvents` so it does not
  * corrupt downstream parsers. Failures are swallowed.