@cleocode/core 2026.9.20 → 2026.9.22

package/dist/orchestration/lead-rollup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lead-rollup.d.ts","sourceRoot":"","sources":["../../src/orchestration/lead-rollup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EAKd,UAAU,EACX,MAAM,qBAAqB,CAAC;AAM7B;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAgBzF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,UAAU,CAAC,CAyIrB;AAoBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,UAAU,CAAC,CAuBrB"}
+{"version":3,"file":"lead-rollup.d.ts","sourceRoot":"","sources":["../../src/orchestration/lead-rollup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EAKd,UAAU,EACX,MAAM,qBAAqB,CAAC;AAQ7B;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAgBzF;AAoBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,UAAU,CAAC,CAwIrB;AAoBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,UAAU,CAAC,CAsBrB"}

package/dist/orchestration/lead-rollup.js

@@ -34,10 +34,12 @@
  * @saga T10377
  * @adr ADR-070
  */
+import { ExitCode } from '@cleocode/contracts';
 import { getConfigValue } from '../config/registry.js';
+import { CleoError } from '../errors.js';
 import { resolveOrCwd } from '../paths.js';
 import { getTaskAccessor } from '../store/data-accessor.js';
-import { computeWaves } from './waves.js';
+import { planEpicWaves } from './waves.js';
 /**
  * Resolve the operative `leadRollup.mode` from the `.cleo/config.json` cascade.
  *
@@ -79,6 +81,19 @@ export async function resolveLeadRollupMode(projectRoot) {
     }
     return 'passive';
 }
+/**
+ * Refuse a wave number `cleo orchestrate waves` never prints. Roll-up counted
+ * from 0 while the waves listing counts from 1 (T12682); a 0 now fails loudly
+ * instead of silently meaning the first wave.
+ *
+ * @param waveId - Requested wave number.
+ * @throws {CleoError} When it is not an integer of at least 1.
+ */
+function assertWaveNumber(waveId) {
+    if (!Number.isInteger(waveId) || waveId < 1) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Wave ${waveId} does not exist: waves are numbered from 1, as \`cleo orchestrate waves\` prints them.`, { fix: 'cleo orchestrate waves <epicId>' });
+    }
+}
 /**
  * Compute a roll-up for a single wave of an epic.
  *
@@ -87,21 +102,24 @@ export async function resolveLeadRollupMode(projectRoot) {
  * Conflicting histories and failed reads reject rather than imply missing evidence.
  *
  * @param epicId - Parent epic ID.
- * @param waveId - Wave number (0 = first wave). Must match `cleo deps waves`
- *   output.
+ * @param waveId - Wave number as `cleo orchestrate waves` prints it (1 =
+ *   first wave, T12682). The same plan numbers the wave topic
+ *   `epic-<epicId>.wave-<waveId>` its workers publish on.
  * @param projectRoot - Optional project root for SDK consumers (test fixtures
  *   pass an explicit root; CLI consumers omit it). Also used to resolve the
  *   `leadRollup.mode` feature flag from the project config cascade.
  * @param options - Optional inputs (conduit messages).
  * @returns A `WaveRollup` shape. Returns an empty wave (`workers: []`) when
  *   the wave has no tasks.
- * @throws If manifest history conflicts or a canonical store read fails.
+ * @throws If manifest history conflicts or a canonical store read fails, or
+ *   `waveId` is not a wave number (from 1).
  * @example
  * ```ts
- * const wave = await rollupWaveStatus("T100", 0, "/project", {});
+ * const wave = await rollupWaveStatus("T100", 1, "/project", {});
  * ```
  */
 export async function rollupWaveStatus(epicId, waveId, projectRoot, options = {}) {
+    assertWaveNumber(waveId);
     const mode = await resolveLeadRollupMode(projectRoot);
     const accessor = await getTaskAccessor(projectRoot);
     // Load the epic and its children.
@@ -122,11 +140,10 @@ export async function rollupWaveStatus(epicId, waveId, projectRoot, options = {}
             capturedAt: new Date().toISOString(),
         };
     }
-    const children = await accessor.getChildren(epicId);
-    // Compute wave structure for this epic. computeWaves expects all child tasks
-    // and groups them by dependency depth.
-    const waves = computeWaves(children);
-    const wave = waves[waveId];
+    // T12682: the plan `cleo orchestrate waves` prints — same dependency
+    // lookup, same 1-based numbers — never a second, differently indexed one.
+    const { children, waves } = await planEpicWaves(epicId, accessor);
+    const wave = waves.find((w) => w.waveNumber === waveId);
     if (!wave) {
         return {
             epicId,
@@ -259,7 +276,8 @@ function applyActiveModeHook(_workers, _blockers) {
  * @param projectRoot - Optional explicit project root.
  * @param options - Optional pre-collected conduit messages.
  * @returns Rollups for every dependency wave and aggregate worker counts.
- * @throws If manifest history conflicts or a canonical store read fails.
+ * @throws If manifest history conflicts or a canonical store read fails, or
+ *   `waveId` is not a wave number (from 1).
  * @example
  * ```ts
  * const epic = await rollupEpicStatus("T100", "/project", {});
@@ -267,11 +285,10 @@ function applyActiveModeHook(_workers, _blockers) {
  */
 export async function rollupEpicStatus(epicId, projectRoot, options = {}) {
     const accessor = await getTaskAccessor(projectRoot);
-    const children = await accessor.getChildren(epicId);
-    const waves = computeWaves(children);
+    const { waves } = await planEpicWaves(epicId, accessor);
     const waveRollups = [];
-    for (let i = 0; i < waves.length; i++) {
-        waveRollups.push(await rollupWaveStatus(epicId, i, projectRoot, options));
+    for (const wave of waves) {
+        waveRollups.push(await rollupWaveStatus(epicId, wave.waveNumber, projectRoot, options));
     }
     const totalWorkers = waveRollups.reduce((sum, w) => sum + w.workers.length, 0);
     const doneWorkers = waveRollups.reduce((sum, w) => sum + w.workers.filter((x) => x.verificationPassed).length, 0);

package/dist/orchestration/lead-rollup.js.map

@@ -1 +1 @@
-{"version":3,"file":"lead-rollup.js","sourceRoot":"","sources":["../../src/orchestration/lead-rollup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lead-rollup.js","sourceRoot":"","sources":["../../src/orchestration/lead-rollup.ts"],"names":[],"mappings":"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"}

package/dist/orchestration/owner-decision-readiness.d.ts

@@ -0,0 +1,88 @@
+/**
+ * System One needs-human-decision check for the readiness grill gate (T12494).
+ *
+ * `classifyReadiness` flags `OWNER_DECISION_REQUIRED` when `blockedBy`
+ * contains "owner" or "decision" as a substring, so "blocked on T12 (decision
+ * store refactor)" grills and "waiting on legal to choose a vendor" does not.
+ * This module asks ONE `noul` question — "does this block need a human
+ * owner's decision, approval or choice?" — and hands the answer to the pure
+ * predicate as {@link ReadinessSignals.ownerDecision}.
+ *
+ * Escalate-only: the answer can ADD the flag the substring rule missed, never
+ * clear one the rule or the label raised (a false positive stays a grill).
+ * Silently removing a flag would route around the owner. A flagged task
+ * grills, and the grill is routed to the owner through the orchestrator's ask
+ * tool (the HITL rule); System One never answers the owner's question itself.
+ *
+ * - Asked only when the task has a non-blank `blockedBy` and no
+ *   `owner-decision` label (the label is authoritative). In `on` mode it is
+ *   also skipped when the substring rule already flags: an answer could not
+ *   change the verdict. `shadow` still asks, so the audit measures agreement.
+ * - Title, `blockedBy` and description are redacted, then clipped, before they
+ *   leave the machine.
+ * - Provider wait is bounded by {@link OWNER_DECISION_BUDGET_MS}; the budget
+ *   starts once the decision modules are loaded.
+ *
+ * Mode comes from `decide.sites.ownerDecision` (`off | shadow | on`): `shadow`
+ * (the default once a provider is configured) audits the answer next to the
+ * substring rule and returns no signal, so the verdict is unchanged; `on`
+ * returns the signal, which the predicate uses to add a flag when its
+ * confidence is at least {@link OWNER_DECISION_MIN_CONFIDENCE}. No provider configured → `off`, no
+ * network call.
+ *
+ * @task T12494
+ * @epic T12486
+ */
+import type { DecisionRequest, Task } from '@cleocode/contracts';
+import type { DecideOptions } from '../decide/client.js';
+import { type DecisionSiteMode } from '../decide/site.js';
+import { type OwnerDecisionSignal, type ReadinessResult, type ReadinessSignals } from './classify-readiness.js';
+/** Wait budget for the owner-decision question, in ms (module load excluded; see `askSiteDecision`). */
+export declare const OWNER_DECISION_BUDGET_MS = 300;
+/** Call-site id for the owner-decision question; keys the audit line. */
+export declare const OWNER_DECISION_SITE = "orchestration.owner-decision";
+/** Config key selecting the System One mode for the owner-decision check. */
+export declare const OWNER_DECISION_MODE_KEY = "decide.sites.ownerDecision";
+/**
+ * Build the decision request: title, `blockedBy` and description as state and
+ * one `noul` question.
+ *
+ * @param task - The task being classified.
+ * @param redact - Redaction applied to every field BEFORE clipping.
+ * @returns The request.
+ */
+export declare function buildOwnerDecisionRequest(task: Pick<Task, 'title' | 'blockedBy' | 'description'>, redact: (s: string) => string): DecisionRequest;
+/** Options for {@link resolveOwnerDecisionSignal}. */
+export interface OwnerDecisionOptions {
+    /** Explicit mode; wins over config when a provider is configured. */
+    readonly mode?: DecisionSiteMode;
+    /** Provider, connection, budget, cache and audit wiring forwarded to `decide()`. */
+    readonly decide?: DecideOptions;
+    /** Project root for config lookup and the default audit sink. */
+    readonly projectRoot?: string;
+}
+/**
+ * Ask System One whether the task's `blockedBy` needs an owner decision.
+ *
+ * Never throws and never waits longer than {@link OWNER_DECISION_BUDGET_MS}
+ * once a decision is asked.
+ *
+ * @param task - The task being classified.
+ * @param opts - Mode, wiring and project root.
+ * @returns The signal in `on` mode when a valid answer arrived; otherwise `null`
+ *   (not asked, `shadow`, or fallback) — and the substring rule decides.
+ */
+export declare function resolveOwnerDecisionSignal(task: Task, opts?: OwnerDecisionOptions): Promise<OwnerDecisionSignal | null>;
+/**
+ * {@link classifyReadiness} with the owner-decision signal resolved first.
+ *
+ * Equivalent to `classifyReadiness(task, signals)` whenever System One is
+ * unconfigured, `off`, `shadow`, or does not answer in budget.
+ *
+ * @param task - Task record to classify.
+ * @param signals - Pre-fetched supporting state; an explicit `ownerDecision` is kept.
+ * @param opts - Mode, wiring and project root for the owner-decision question.
+ * @returns The readiness verdict.
+ */
+export declare function classifyReadinessWithDecision(task: Task, signals?: ReadinessSignals, opts?: OwnerDecisionOptions): Promise<ReadinessResult>;
+//# sourceMappingURL=owner-decision-readiness.d.ts.map

package/dist/orchestration/owner-decision-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-decision-readiness.d.ts","sourceRoot":"","sources":["../../src/orchestration/owner-decision-readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAkB,eAAe,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,KAAK,gBAAgB,EAAkB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,wGAAwG;AACxG,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AAkBpE;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC,EACvD,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAC5B,eAAe,CASjB;AAED,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,iEAAiE;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,IAAI,EACV,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA6CrC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,gBAAqB,EAC9B,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAM1B"}

package/dist/orchestration/owner-decision-readiness.js

@@ -0,0 +1,152 @@
+/**
+ * System One needs-human-decision check for the readiness grill gate (T12494).
+ *
+ * `classifyReadiness` flags `OWNER_DECISION_REQUIRED` when `blockedBy`
+ * contains "owner" or "decision" as a substring, so "blocked on T12 (decision
+ * store refactor)" grills and "waiting on legal to choose a vendor" does not.
+ * This module asks ONE `noul` question — "does this block need a human
+ * owner's decision, approval or choice?" — and hands the answer to the pure
+ * predicate as {@link ReadinessSignals.ownerDecision}.
+ *
+ * Escalate-only: the answer can ADD the flag the substring rule missed, never
+ * clear one the rule or the label raised (a false positive stays a grill).
+ * Silently removing a flag would route around the owner. A flagged task
+ * grills, and the grill is routed to the owner through the orchestrator's ask
+ * tool (the HITL rule); System One never answers the owner's question itself.
+ *
+ * - Asked only when the task has a non-blank `blockedBy` and no
+ *   `owner-decision` label (the label is authoritative). In `on` mode it is
+ *   also skipped when the substring rule already flags: an answer could not
+ *   change the verdict. `shadow` still asks, so the audit measures agreement.
+ * - Title, `blockedBy` and description are redacted, then clipped, before they
+ *   leave the machine.
+ * - Provider wait is bounded by {@link OWNER_DECISION_BUDGET_MS}; the budget
+ *   starts once the decision modules are loaded.
+ *
+ * Mode comes from `decide.sites.ownerDecision` (`off | shadow | on`): `shadow`
+ * (the default once a provider is configured) audits the answer next to the
+ * substring rule and returns no signal, so the verdict is unchanged; `on`
+ * returns the signal, which the predicate uses to add a flag when its
+ * confidence is at least {@link OWNER_DECISION_MIN_CONFIDENCE}. No provider configured → `off`, no
+ * network call.
+ *
+ * @task T12494
+ * @epic T12486
+ */
+import { redactThenClip } from '../decide/site.js';
+import { blockedByMentionsOwnerDecision, classifyReadiness, OWNER_DECISION_MIN_CONFIDENCE, } from './classify-readiness.js';
+/** Wait budget for the owner-decision question, in ms (module load excluded; see `askSiteDecision`). */
+export const OWNER_DECISION_BUDGET_MS = 300;
+/** Call-site id for the owner-decision question; keys the audit line. */
+export const OWNER_DECISION_SITE = 'orchestration.owner-decision';
+/** Config key selecting the System One mode for the owner-decision check. */
+export const OWNER_DECISION_MODE_KEY = 'decide.sites.ownerDecision';
+/** Label that already marks an owner decision; mirrors `classify-readiness.ts`. */
+const OWNER_DECISION_LABEL = 'owner-decision';
+/** The single question's name. */
+const QUESTION = 'owner';
+/** Per-field character caps. */
+const TITLE_MAX_CHARS = 160;
+const BLOCKED_BY_MAX_CHARS = 300;
+const DESCRIPTION_MAX_CHARS = 440;
+const CRITERIA = 'Work on this task cannot start until a human owner makes a decision, approval or choice ' +
+    '(as described by "blockedBy"). It is NOT enough to be waiting on another task, a tool, ' +
+    'a build, an external service or another agent.';
+/**
+ * Build the decision request: title, `blockedBy` and description as state and
+ * one `noul` question.
+ *
+ * @param task - The task being classified.
+ * @param redact - Redaction applied to every field BEFORE clipping.
+ * @returns The request.
+ */
+export function buildOwnerDecisionRequest(task, redact) {
+    return {
+        state: {
+            title: redactThenClip(task.title, TITLE_MAX_CHARS, redact),
+            blockedBy: redactThenClip(task.blockedBy ?? '', BLOCKED_BY_MAX_CHARS, redact),
+            description: redactThenClip(task.description ?? '', DESCRIPTION_MAX_CHARS, redact),
+        },
+        questions: { [QUESTION]: { type: 'noul', criteria: CRITERIA } },
+    };
+}
+/**
+ * Ask System One whether the task's `blockedBy` needs an owner decision.
+ *
+ * Never throws and never waits longer than {@link OWNER_DECISION_BUDGET_MS}
+ * once a decision is asked.
+ *
+ * @param task - The task being classified.
+ * @param opts - Mode, wiring and project root.
+ * @returns The signal in `on` mode when a valid answer arrived; otherwise `null`
+ *   (not asked, `shadow`, or fallback) — and the substring rule decides.
+ */
+export async function resolveOwnerDecisionSignal(task, opts = {}) {
+    if ((task.blockedBy ?? '').trim() === '')
+        return null;
+    if ((task.labels ?? []).some((l) => l.toLowerCase() === OWNER_DECISION_LABEL))
+        return null;
+    try {
+        const { askSiteDecision, resolveDecisionSiteSettings } = await import('../decide/site.js');
+        const { mode } = await resolveDecisionSiteSettings({
+            modeKey: OWNER_DECISION_MODE_KEY,
+            mode: opts.mode,
+            wiring: opts.decide,
+            projectRoot: opts.projectRoot,
+        });
+        if (mode === 'off')
+            return null;
+        const substring = blockedByMentionsOwnerDecision(task);
+        // Escalate-only: once the rule flags, no answer can change the verdict.
+        if (mode === 'on' && substring)
+            return null;
+        const heuristicAnswer = {
+            type: 'noul',
+            value: substring,
+            probability: substring ? 1 : 0,
+            confidence: 0.5,
+        };
+        const decision = await askSiteDecision({
+            siteId: OWNER_DECISION_SITE,
+            budgetMs: OWNER_DECISION_BUDGET_MS,
+            minConfidence: OWNER_DECISION_MIN_CONFIDENCE,
+            mode,
+            heuristicVerdict: substring ? 'owner-decision' : 'none',
+            buildRequest: (redact) => buildOwnerDecisionRequest(task, redact),
+            heuristicAnswers: { [QUESTION]: heuristicAnswer },
+            agree: (answers) => answers[QUESTION]?.value === substring,
+            shadowExtras: { subjects: { [QUESTION]: task.id } },
+            wiring: opts.decide,
+            projectRoot: opts.projectRoot,
+        });
+        const answer = decision?.answers[QUESTION];
+        if (mode !== 'on' || answer?.type !== 'noul')
+            return null;
+        return {
+            required: answer.value,
+            probability: answer.probability,
+            confidence: answer.confidence,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * {@link classifyReadiness} with the owner-decision signal resolved first.
+ *
+ * Equivalent to `classifyReadiness(task, signals)` whenever System One is
+ * unconfigured, `off`, `shadow`, or does not answer in budget.
+ *
+ * @param task - Task record to classify.
+ * @param signals - Pre-fetched supporting state; an explicit `ownerDecision` is kept.
+ * @param opts - Mode, wiring and project root for the owner-decision question.
+ * @returns The readiness verdict.
+ */
+export async function classifyReadinessWithDecision(task, signals = {}, opts = {}) {
+    const ownerDecision = signals.ownerDecision !== undefined
+        ? signals.ownerDecision
+        : await resolveOwnerDecisionSignal(task, opts);
+    return classifyReadiness(task, { ...signals, ownerDecision });
+}
+//# sourceMappingURL=owner-decision-readiness.js.map

package/dist/orchestration/owner-decision-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-decision-readiness.js","sourceRoot":"","sources":["../../src/orchestration/owner-decision-readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,OAAO,EAAyB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACL,8BAA8B,EAC9B,iBAAiB,EACjB,6BAA6B,GAI9B,MAAM,yBAAyB,CAAC;AAEjC,wGAAwG;AACxG,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAElE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;AAEpE,mFAAmF;AACnF,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAE9C,kCAAkC;AAClC,MAAM,QAAQ,GAAG,OAAO,CAAC;AAEzB,gCAAgC;AAChC,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACjC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,MAAM,QAAQ,GACZ,0FAA0F;IAC1F,yFAAyF;IACzF,gDAAgD,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAuD,EACvD,MAA6B;IAE7B,OAAO;QACL,KAAK,EAAE;YACL,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC;YAC1D,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,oBAAoB,EAAE,MAAM,CAAC;YAC7E,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE,qBAAqB,EAAE,MAAM,CAAC;SACnF;QACD,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;KAChE,CAAC;AACJ,CAAC;AAYD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAU,EACV,OAA6B,EAAE;IAE/B,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,oBAAoB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3F,IAAI,CAAC;QACH,MAAM,EAAE,eAAe,EAAE,2BAA2B,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC3F,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,2BAA2B,CAAC;YACjD,OAAO,EAAE,uBAAuB;YAChC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;QACH,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QAEhC,MAAM,SAAS,GAAG,8BAA8B,CAAC,IAAI,CAAC,CAAC;QACvD,wEAAwE;QACxE,IAAI,IAAI,KAAK,IAAI,IAAI,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,eAAe,GAAmB;YACtC,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,UAAU,EAAE,GAAG;SAChB,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC;YACrC,MAAM,EAAE,mBAAmB;YAC3B,QAAQ,EAAE,wBAAwB;YAClC,aAAa,EAAE,6BAA6B;YAC5C,IAAI;YACJ,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM;YACvD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC;YACjE,gBAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,eAAe,EAAE;YACjD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,KAAK,SAAS;YAC1D,YAAY,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE;YACnD,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,EAAE,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAC1D,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,KAAK;YACtB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAAU,EACV,UAA4B,EAAE,EAC9B,OAA6B,EAAE;IAE/B,MAAM,aAAa,GACjB,OAAO,CAAC,aAAa,KAAK,SAAS;QACjC,CAAC,CAAC,OAAO,CAAC,aAAa;QACvB,CAAC,CAAC,MAAM,0BAA0B,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,OAAO,iBAAiB,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/orchestration/parallel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../src/orchestration/parallel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,UAAU,aAAa;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAaD,2CAA2C;AAC3C,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CA0CD;AAED,yCAAyC;AACzC,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC,CAuCD;AAED,4CAA4C;AAC5C,wBAAsB,iBAAiB,CACrC,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,aAAa,CAAC,CAGxB"}
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../src/orchestration/parallel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,UAAU,aAAa;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAaD,2CAA2C;AAC3C,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAmCD;AAED,yCAAyC;AACzC,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC,CAuCD;AAED,4CAA4C;AAC5C,wBAAsB,iBAAiB,CACrC,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,aAAa,CAAC,CAGxB"}

package/dist/orchestration/parallel.js

@@ -5,7 +5,7 @@
 import { ExitCode } from '@cleocode/contracts';
 import { CleoError } from '../errors.js';
 import { getTaskAccessor } from '../store/data-accessor.js';
-import { computeWaves } from './waves.js';
+import { isTerminalWaveStatus, planEpicWaves } from './waves.js';
 const PARALLEL_STATE_KEY = 'parallel_state';
 async function readParallelState(accessor) {
     const state = await accessor.getMetaValue(PARALLEL_STATE_KEY);
@@ -25,28 +25,21 @@ export async function startParallelExecution(epicId, wave, cwd, accessor) {
     if (!epic) {
         throw new CleoError(ExitCode.NOT_FOUND, `Epic ${epicId} not found`);
     }
-    const children = await acc.getChildren(epicId);
-    const waves = computeWaves(children);
+    // T12682: the same stable plan `orchestrate waves` prints; the wave's
+    // finished tasks keep their number but are not run again.
+    const { children, waves } = await planEpicWaves(epicId, acc);
     const targetWave = waves.find((w) => w.waveNumber === wave);
     if (!targetWave) {
         throw new CleoError(ExitCode.INVALID_INPUT, `Wave ${wave} not found for epic ${epicId}`);
     }
     const startedAt = new Date().toISOString();
-    const state = {
-        active: true,
-        epicId,
-        wave,
-        startedAt,
-        tasks: targetWave.tasks,
-    };
+    const tasks = targetWave.tasks.filter((id) => {
+        const status = children.find((c) => c.id === id)?.status;
+        return status === undefined || !isTerminalWaveStatus(status);
+    });
+    const state = { active: true, epicId, wave, startedAt, tasks };
     await writeParallelState(state, acc);
-    return {
-        epicId,
-        wave,
-        tasks: targetWave.tasks,
-        taskCount: targetWave.tasks.length,
-        startedAt,
-    };
+    return { epicId, wave, tasks, taskCount: tasks.length, startedAt };
 }
 /** End parallel execution for a wave. */
 export async function endParallelExecution(epicId, wave, cwd, accessor) {

package/dist/orchestration/parallel.js.map

@@ -1 +1 @@
-{"version":3,"file":"parallel.js","sourceRoot":"","sources":["../../src/orchestration/parallel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parallel.js","sourceRoot":"","sources":["../../src/orchestration/parallel.ts"],"names":[],"mappings":"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"}

package/dist/orchestration/psyche-memory-budget.d.ts

@@ -0,0 +1,105 @@
+/**
+ * PSYCHE-MEMORY block budgeting for spawn prompts (T12519 · E-TOKEN-ECONOMY).
+ *
+ * `buildRetrievalBundle` returns up to ~400 cold-pass user-profile traits plus
+ * the ten most recent learnings, patterns and decisions. It does not consider
+ * the task being spawned. Rendering all of it made the PSYCHE-MEMORY block
+ * about 51 % of a tier-1 prompt (measured 2026-09-27: ~3,844 of 7,497 tokens).
+ * Most of that was operation receipts ("Cleo tasks update operation
+ * succeeded") and dispatch traces.
+ *
+ * This module turns a bundle into a bounded block:
+ *
+ * 1. **Exclude noise.** Drop entries that only record an operation succeeding,
+ *    and serialized dispatch traces. See {@link isOperationReceiptText} for why
+ *    this is a text match rather than a field match.
+ * 2. **Rank by relevance to the spawned task.** First by overlap with the
+ *    task's id, epic, labels and files. Then by stored quality score. Then by
+ *    citation count.
+ * 3. **Cap at a token budget** ({@link PSYCHE_MEMORY_TOKEN_BUDGET}) using the
+ *    repo's `estimateTokens` (chars / 4). Entries are admitted whole or not at
+ *    all, never cut mid-entry. The omitted count is surfaced as a single
+ *    `cleo memory find` pointer line.
+ *
+ * @module orchestration/psyche-memory-budget
+ * @task T12519
+ * @epic T12484
+ */
+import type { RetrievalBundle, Task } from '@cleocode/contracts';
+/** Default token budget for the whole `## PSYCHE-MEMORY` block (T12519). */
+export declare const PSYCHE_MEMORY_TOKEN_BUDGET = 800;
+/**
+ * Whether memory text only records that an operation succeeded, or is a
+ * serialized dispatch trace. Such text carries no knowledge a spawned agent
+ * can act on.
+ *
+ * @param text - Entry text (trait value, pattern, insight, title, …).
+ * @returns `true` when the entry is noise and must not be injected.
+ */
+export declare function isOperationReceiptText(text: string): boolean;
+/** Task facts used to rank memory entries by relevance. */
+export interface PsycheRelevanceContext {
+    /** Id of the task being spawned. */
+    taskId: string;
+    /** Parent (epic) id of the spawned task, when it has one. */
+    epicId?: string | null;
+    /** Task labels. */
+    labels?: readonly string[];
+    /** Files the task declares. */
+    files?: readonly string[];
+}
+/**
+ * Derive a {@link PsycheRelevanceContext} from a task record.
+ *
+ * @param task - The task being spawned.
+ * @returns The relevance context for ranking memory entries.
+ */
+export declare function relevanceContextFromTask(task: Task): PsycheRelevanceContext;
+/** Inputs for {@link buildBudgetedPsycheMemoryBlock}. */
+export interface BudgetedPsycheMemoryInput {
+    /** Retrieval bundle from `buildRetrievalBundle`. */
+    bundle: RetrievalBundle;
+    /** Relevance facts of the spawned task. */
+    relevance: PsycheRelevanceContext;
+    /** Pre-rendered, already-bounded Tier-2 attention digest lines (T11374). */
+    attentionDigestLines?: readonly string[];
+    /** Token budget for the whole block. Defaults to {@link PSYCHE_MEMORY_TOKEN_BUDGET}. */
+    tokenBudget?: number;
+}
+/** Result of {@link buildBudgetedPsycheMemoryBlock}. */
+export interface BudgetedPsycheMemoryResult {
+    /** The rendered `## PSYCHE-MEMORY` markdown section. */
+    block: string;
+    /** Estimated tokens of `block` (chars / 4). */
+    tokens: number;
+    /** Entries rendered. */
+    shown: number;
+    /** Relevant (non-noise) entries omitted because the budget ran out. */
+    omitted: number;
+    /** Entries dropped as operation receipts / dispatch traces. */
+    excludedNoise: number;
+}
+/**
+ * Render the `## PSYCHE-MEMORY` block under a token budget.
+ *
+ * The header, the attention digest (already bounded by its own renderer) and
+ * the sigil card are fixed. Every other entry competes for the remaining
+ * budget in rank order: pinned first, then overlap score, then quality, then
+ * citations, then bundle (recency) order. An entry that does not fit is skipped
+ * whole, and a smaller one further down may still fit. Admitted entries render
+ * grouped under their usual section headings, in rank order within each
+ * section.
+ *
+ * @param input - Bundle, relevance context, attention lines and budget.
+ * @returns The rendered block plus accounting.
+ *
+ * @example
+ * ```ts
+ * const { block } = buildBudgetedPsycheMemoryBlock({
+ *   bundle,
+ *   relevance: relevanceContextFromTask(task),
+ * });
+ * ```
+ */
+export declare function buildBudgetedPsycheMemoryBlock(input: BudgetedPsycheMemoryInput): BudgetedPsycheMemoryResult;
+//# sourceMappingURL=psyche-memory-budget.d.ts.map

package/dist/orchestration/psyche-memory-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psyche-memory-budget.d.ts","sourceRoot":"","sources":["../../src/orchestration/psyche-memory-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAIjE,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAgC9C;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI5D;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mBAAmB;IACnB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,sBAAsB,CAO3E;AA8ND,yDAAyD;AACzD,MAAM,WAAW,yBAAyB;IACxC,oDAAoD;IACpD,MAAM,EAAE,eAAe,CAAC;IACxB,2CAA2C;IAC3C,SAAS,EAAE,sBAAsB,CAAC;IAClC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wDAAwD;AACxD,MAAM,WAAW,0BAA0B;IACzC,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,yBAAyB,GAC/B,0BAA0B,CA6F5B"}