@lumenflow/initiatives 4.21.0 → 4.23.0

package/dist/orchestrator/reconciliation.js

@@ -0,0 +1,245 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Evidence-based initiative reconciliation and advancement.
+ *
+ * WU-2619: Portable control-plane state machine for orchestration decisions.
+ * Callers provide durable execution evidence; the engine returns reconciled WU
+ * states, next-safe actions, and launch eligibility without assuming a specific
+ * local or cloud launcher implementation.
+ *
+ * @module orchestrator/reconciliation
+ */
+import { ORCHESTRATION_NEXT_SAFE_ACTION_TYPES, ORCHESTRATION_STATUS_VALUES, } from '@lumenflow/control-plane-sdk';
+import { getAllDependencies } from './shared.js';
+const ACTION_PRIORITY = {
+    [ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.RECOVER_WU]: 0,
+    [ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.FINISH_WU]: 1,
+    [ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.RELAUNCH_WU]: 2,
+    [ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.LAUNCH_WU]: 3,
+    [ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.WAIT]: 4,
+};
+function normalizeStatus(value) {
+    return typeof value === 'string' ? value.trim().toLowerCase() : '';
+}
+function calculateLogicalWaveMap(wus) {
+    const logicalWaveMap = new Map();
+    const allWuIds = new Set(wus.map((wu) => wu.id));
+    const adjacency = new Map();
+    const inDegree = new Map();
+    for (const wu of wus) {
+        adjacency.set(wu.id, []);
+        inDegree.set(wu.id, 0);
+    }
+    for (const wu of wus) {
+        const internalDeps = getAllDependencies(wu.doc).filter((depId) => allWuIds.has(depId));
+        inDegree.set(wu.id, internalDeps.length);
+        for (const depId of internalDeps) {
+            const children = adjacency.get(depId);
+            if (!children) {
+                continue;
+            }
+            children.push(wu.id);
+        }
+    }
+    const queue = wus
+        .filter((wu) => (inDegree.get(wu.id) ?? 0) === 0)
+        .sort((left, right) => left.id.localeCompare(right.id))
+        .map((wu) => wu.id);
+    while (queue.length > 0) {
+        const currentId = queue.shift();
+        const currentWave = logicalWaveMap.get(currentId) ?? 0;
+        const children = adjacency.get(currentId) ?? [];
+        for (const childId of children) {
+            const nextWave = currentWave + 1;
+            logicalWaveMap.set(childId, Math.max(logicalWaveMap.get(childId) ?? 0, nextWave));
+            const remainingInDegree = (inDegree.get(childId) ?? 0) - 1;
+            inDegree.set(childId, remainingInDegree);
+            if (remainingInDegree === 0) {
+                queue.push(childId);
+            }
+        }
+    }
+    for (const wu of wus) {
+        if (!logicalWaveMap.has(wu.id)) {
+            logicalWaveMap.set(wu.id, 0);
+        }
+    }
+    return logicalWaveMap;
+}
+function buildAction(type, wuId, reason, logicalWave) {
+    return { type, wu_id: wuId, reason, logical_wave: logicalWave };
+}
+function deriveExecutionState(wu, evidence, logicalWave) {
+    const yamlStatus = normalizeStatus(wu.doc.status);
+    if (evidence.stampPresent || yamlStatus === 'done') {
+        return {
+            state: ORCHESTRATION_STATUS_VALUES.DONE,
+            reason: evidence.stampPresent ? 'done stamp present' : 'WU YAML status is done',
+        };
+    }
+    if ((evidence.contaminatedPaths?.length ?? 0) > 0) {
+        return {
+            state: ORCHESTRATION_STATUS_VALUES.CONTAMINATED,
+            reason: `main checkout contamination detected (${evidence.contaminatedPaths.length} path${evidence.contaminatedPaths.length === 1 ? '' : 's'})`,
+            nextAction: buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.RECOVER_WU, wu.id, 'Recover contaminated work before advancing.', logicalWave),
+        };
+    }
+    if (evidence.stalled) {
+        return {
+            state: ORCHESTRATION_STATUS_VALUES.STALLED,
+            reason: 'delegated work appears stalled',
+            nextAction: buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.RECOVER_WU, wu.id, 'Recover or inspect stalled delegated work.', logicalWave),
+        };
+    }
+    if (yamlStatus === 'blocked' || evidence.blockedReason) {
+        return {
+            state: ORCHESTRATION_STATUS_VALUES.BLOCKED,
+            reason: evidence.blockedReason || 'WU YAML status is blocked',
+            nextAction: buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.WAIT, wu.id, evidence.blockedReason || 'Waiting for blocker resolution.', logicalWave),
+        };
+    }
+    if (evidence.readyForFinish || (evidence.workerReturned && evidence.worktreePresent)) {
+        return {
+            state: ORCHESTRATION_STATUS_VALUES.READY_FOR_FINISH,
+            reason: evidence.readyForFinish
+                ? 'durable evidence marks the WU ready for finish'
+                : 'worker returned with worktree present',
+            nextAction: buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.FINISH_WU, wu.id, 'Inspect the worktree and run wu:prep/wu:done if ready.', logicalWave),
+        };
+    }
+    if (evidence.needsRelaunch || (evidence.workerReturned && evidence.worktreePresent === false)) {
+        return {
+            state: ORCHESTRATION_STATUS_VALUES.NEEDS_RELAUNCH,
+            reason: evidence.needsRelaunch
+                ? 'durable evidence marks the WU for relaunch'
+                : 'worker returned without a surviving worktree',
+            nextAction: buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.RELAUNCH_WU, wu.id, 'Relaunch delegated work because no finishable worktree remains.', logicalWave),
+        };
+    }
+    if (evidence.workerReturned) {
+        return {
+            state: ORCHESTRATION_STATUS_VALUES.WORKER_RETURNED,
+            reason: 'worker returned without terminal completion evidence',
+            nextAction: buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.WAIT, wu.id, 'Inspect returned work before advancing.', logicalWave),
+        };
+    }
+    if (evidence.active || evidence.worktreePresent || yamlStatus === 'in_progress') {
+        return {
+            state: ORCHESTRATION_STATUS_VALUES.ACTIVE,
+            reason: evidence.worktreePresent ? 'worktree present' : 'WU YAML status is in_progress',
+            nextAction: buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.WAIT, wu.id, 'Work is still active.', logicalWave),
+        };
+    }
+    if (evidence.handoffEmitted) {
+        return {
+            state: ORCHESTRATION_STATUS_VALUES.HANDOFF_EMITTED,
+            reason: 'handoff emitted but launch not yet confirmed',
+            nextAction: buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.WAIT, wu.id, 'Await launch pickup or relaunch if it stalls.', logicalWave),
+        };
+    }
+    return {
+        state: ORCHESTRATION_STATUS_VALUES.ELIGIBLE,
+        reason: 'eligible for orchestration',
+    };
+}
+const DEFAULT_ACTION_PRIORITY = 4;
+function resolveActionPriority(type) {
+    return ACTION_PRIORITY[type] ?? DEFAULT_ACTION_PRIORITY;
+}
+function sortActions(actions) {
+    return [...actions].sort((left, right) => {
+        const byPriority = resolveActionPriority(left.type) - resolveActionPriority(right.type);
+        if (byPriority !== 0) {
+            return byPriority;
+        }
+        return (left.wu_id ?? '').localeCompare(right.wu_id ?? '');
+    });
+}
+export function reconcileInitiativeExecution(wus, evidence = [], options = {}) {
+    const logicalWaveMap = calculateLogicalWaveMap(wus);
+    const allWuIds = new Set(wus.map((wu) => wu.id));
+    const evidenceByWu = new Map(evidence.map((entry) => [entry.wuId, entry]));
+    const reconciled = wus.map((wu) => {
+        const wuEvidence = evidenceByWu.get(wu.id) ?? { wuId: wu.id };
+        const logicalWave = wuEvidence.logicalWave ?? logicalWaveMap.get(wu.id) ?? 0;
+        const derived = deriveExecutionState(wu, wuEvidence, logicalWave);
+        return {
+            wuId: wu.id,
+            title: wu.doc.title ?? wu.id,
+            lane: wu.doc.lane ?? 'unknown',
+            yamlStatus: normalizeStatus(wu.doc.status),
+            logicalWave,
+            launchAttempt: wuEvidence.launchAttempt,
+            state: derived.state,
+            reason: derived.reason,
+            dependencies: getAllDependencies(wu.doc).filter((depId) => allWuIds.has(depId)),
+            launchBlockedBy: [],
+            launchEligible: false,
+            nextAction: derived.nextAction,
+            evidence: wuEvidence,
+        };
+    });
+    const doneWuIds = new Set(reconciled.filter((wu) => wu.state === ORCHESTRATION_STATUS_VALUES.DONE).map((wu) => wu.wuId));
+    const blockedByIntegrity = reconciled.some((wu) => wu.state === ORCHESTRATION_STATUS_VALUES.CONTAMINATED ||
+        (options.blockOnIntegrity !== false && wu.state === ORCHESTRATION_STATUS_VALUES.STALLED));
+    const activeWorkerCount = reconciled.filter((wu) => wu.state === ORCHESTRATION_STATUS_VALUES.ACTIVE ||
+        wu.state === ORCHESTRATION_STATUS_VALUES.HANDOFF_EMITTED).length;
+    const maxActiveWorkers = typeof options.maxActiveWorkers === 'number' ? options.maxActiveWorkers : null;
+    const availableCapacity = maxActiveWorkers === null ? null : Math.max(maxActiveWorkers - activeWorkerCount, 0);
+    const launchableWuIds = [];
+    const queuedDueToCapacity = [];
+    const launchLanes = new Set();
+    for (const wu of [...reconciled].sort((left, right) => {
+        if (left.logicalWave !== right.logicalWave) {
+            return left.logicalWave - right.logicalWave;
+        }
+        return left.wuId.localeCompare(right.wuId);
+    })) {
+        if (wu.state !== ORCHESTRATION_STATUS_VALUES.ELIGIBLE) {
+            continue;
+        }
+        if (blockedByIntegrity) {
+            wu.launchBlockedBy = ['integrity'];
+            wu.nextAction = buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.WAIT, wu.wuId, 'Unsafe to advance while orchestration integrity issues remain.', wu.logicalWave);
+            continue;
+        }
+        const unmetDependencies = wu.dependencies.filter((depId) => !doneWuIds.has(depId));
+        if (unmetDependencies.length > 0) {
+            wu.launchBlockedBy = unmetDependencies;
+            wu.nextAction = buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.WAIT, wu.wuId, `Waiting for ${unmetDependencies.join(', ')} to complete.`, wu.logicalWave);
+            continue;
+        }
+        if (launchLanes.has(wu.lane)) {
+            wu.launchBlockedBy = ['lane'];
+            wu.nextAction = buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.WAIT, wu.wuId, `Queued behind another launch in lane ${wu.lane}.`, wu.logicalWave);
+            continue;
+        }
+        if (availableCapacity !== null && launchableWuIds.length >= availableCapacity) {
+            wu.launchBlockedBy = ['capacity'];
+            queuedDueToCapacity.push(wu.wuId);
+            wu.nextAction = buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.WAIT, wu.wuId, `Queued until worker capacity frees (remaining capacity: ${availableCapacity}).`, wu.logicalWave);
+            continue;
+        }
+        wu.launchEligible = true;
+        wu.nextAction = buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.LAUNCH_WU, wu.wuId, 'Ready to launch.', wu.logicalWave);
+        launchableWuIds.push(wu.wuId);
+        launchLanes.add(wu.lane);
+    }
+    const nextSafeActions = sortActions(reconciled
+        .map((wu) => wu.nextAction)
+        .filter((action) => action !== undefined));
+    if (queuedDueToCapacity.length > 0 && availableCapacity === 0) {
+        nextSafeActions.push(buildAction(ORCHESTRATION_NEXT_SAFE_ACTION_TYPES.WAIT, undefined, `Worker capacity is exhausted; queued WUs: ${queuedDueToCapacity.join(', ')}`));
+    }
+    return {
+        activeWorkerCount,
+        availableCapacity,
+        maxActiveWorkers,
+        blockedByIntegrity,
+        launchableWuIds,
+        nextSafeActions: sortActions(nextSafeActions),
+        wus: reconciled,
+    };
+}
+//# sourceMappingURL=reconciliation.js.map

package/dist/orchestrator/reconciliation.js.map

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

package/dist/orchestrator/shared.d.ts

@@ -2,6 +2,10 @@
  * Wave manifest directory path (gitignored).
  */
 export declare const WAVE_MANIFEST_DIR = ".lumenflow/artifacts/waves";
+/**
+ * Primary orchestration artifact directory path (gitignored).
+ */
+export declare const ORCHESTRATION_ARTIFACT_DIR = ".lumenflow/artifacts/orchestration";
 /**
  * Stamps directory path.
  */

package/dist/orchestrator/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/orchestrator/shared.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,UAAU,sBAAsB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,UAAU,6BAA6B,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IACtC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,MAAM,EAAE,CAOX"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/orchestrator/shared.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,0BAA0B,uCAAuC,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,UAAU,sBAAsB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,UAAU,6BAA6B,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IACtC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,MAAM,EAAE,CAOX"}

package/dist/orchestrator/shared.js

@@ -13,6 +13,10 @@ import { join } from 'node:path';
  * Wave manifest directory path (gitignored).
  */
 export const WAVE_MANIFEST_DIR = '.lumenflow/artifacts/waves';
+/**
+ * Primary orchestration artifact directory path (gitignored).
+ */
+export const ORCHESTRATION_ARTIFACT_DIR = '.lumenflow/artifacts/orchestration';
 /**
  * Stamps directory path.
  */

package/dist/orchestrator/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/orchestrator/shared.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAElE;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAGlC;IACC,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAE5C,0BAA0B;IAC1B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/orchestrator/shared.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,oCAAoC,CAAC;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAElE;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAGlC;IACC,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAE5C,0BAA0B;IAC1B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

package/dist/orchestrator/types.d.ts

@@ -5,7 +5,9 @@
  *
  * @module orchestrator/types
  */
+import { ORCHESTRATION_NEXT_SAFE_ACTION_TYPES, ORCHESTRATION_STATUS_VALUES, type OrchestrationHandoffFormat, type OrchestrationLaunchReceipt, type OrchestrationNextSafeAction, type OrchestrationNextSafeActionType, type OrchestrationStatusValue } from '@lumenflow/control-plane-sdk';
 import type { WUEntry } from '../initiative-yaml.js';
+export { ORCHESTRATION_NEXT_SAFE_ACTION_TYPES, ORCHESTRATION_STATUS_VALUES, type OrchestrationHandoffFormat, type OrchestrationLaunchReceipt, type OrchestrationNextSafeAction, type OrchestrationNextSafeActionType, type OrchestrationStatusValue, };
 /**
  * Options for checkpoint mode resolution.
  */
@@ -13,6 +15,11 @@ export interface CheckpointOptions {
     checkpointPerWave?: boolean;
     noCheckpoint?: boolean;
     dryRun?: boolean;
+    clientName?: string;
+    executionEvidence?: WuExecutionEvidence[];
+    maxActiveWorkers?: number;
+    blockOnIntegrity?: boolean;
+    executionSummary?: InitiativeExecutionSummary;
 }
 /**
  * Result of checkpoint mode resolution.
@@ -75,38 +82,125 @@ export interface BottleneckWU {
     blocksCount: number;
 }
 /**
- * Wave manifest WU entry.
+ * Handoff artifact format. Legacy alias for the SDK's {@link OrchestrationHandoffFormat}.
  */
-export interface WaveManifestWU {
-    id: string;
-    lane?: string;
-    status?: string;
+export type HandoffFormat = OrchestrationHandoffFormat;
+/**
+ * Receipt written for each emitted orchestration handoff. Alias of the SDK
+ * {@link OrchestrationLaunchReceipt} contract for intra-package readability.
+ */
+export type HandoffReceipt = OrchestrationLaunchReceipt;
+/**
+ * Durable orchestration artifact bundle for one launch attempt.
+ */
+export interface OrchestrationArtifactBundle {
+    artifactDir: string;
+    planPath: string;
+    launchPath: string;
+    statusPath: string;
+    logicalWaves: number[];
+    launchAttempt: number;
+    handoffReceipts: OrchestrationLaunchReceipt[];
 }
 /**
- * Wave manifest structure.
+ * Per-WU entry in a checkpoint wave result.
  */
-export interface WaveManifest {
-    initiative: string;
-    wave: number;
-    created_at?: string;
-    wus: WaveManifestWU[];
-    lane_validation?: string;
-    done_criteria?: string;
+export interface CheckpointWaveWU {
+    id: string;
+    lane?: string;
+    status?: string;
+    logical_wave?: number;
+    handoff_artifact_path?: string;
+    handoff_format?: HandoffFormat;
 }
 /**
  * Checkpoint wave result.
  */
-export interface CheckpointWaveResult {
+export interface CheckpointWaveResult extends OrchestrationArtifactBundle {
     initiative: string;
     wave: number;
-    wus: WaveManifestWU[];
+    wus: CheckpointWaveWU[];
     manifestPath: string | null;
     blockedBy?: string[];
     waitingMessage?: string;
+    availableCapacity?: number | null;
+    nextSafeActions?: OrchestrationNextSafeAction[];
+    executionSummary?: InitiativeExecutionSummary;
     dryRun?: boolean;
     /** WU-2375: Client name for output format selection */
     clientName?: string;
 }
+/**
+ * Internal alias of the SDK {@link ORCHESTRATION_STATUS_VALUES} constant so existing
+ * callsites keep the `ORCHESTRATION_EXECUTION_STATES` name while sharing one vocabulary
+ * with the control-plane contract.
+ */
+export declare const ORCHESTRATION_EXECUTION_STATES: {
+    readonly PLANNED: "planned";
+    readonly ELIGIBLE: "eligible";
+    readonly HANDOFF_EMITTED: "handoff_emitted";
+    readonly CLAIMED: "claimed";
+    readonly ACTIVE: "active";
+    readonly WORKER_RETURNED: "worker_returned";
+    readonly READY_FOR_FINISH: "ready_for_finish";
+    readonly AWAITING_MERGE: "awaiting_merge";
+    readonly BLOCKED: "blocked";
+    readonly CONTAMINATED: "contaminated";
+    readonly STALLED: "stalled";
+    readonly NEEDS_RELAUNCH: "needs_relaunch";
+    readonly DONE: "done";
+};
+export type OrchestrationExecutionState = OrchestrationStatusValue;
+/**
+ * Internal alias of the SDK {@link OrchestrationNextSafeActionType}. Use this when a
+ * callsite only needs the union of action kinds; import the SDK type directly when
+ * constructing an action object.
+ */
+export type OrchestrationActionType = OrchestrationNextSafeActionType;
+export interface WuExecutionEvidence {
+    wuId: string;
+    handoffEmitted?: boolean;
+    active?: boolean;
+    workerReturned?: boolean;
+    stampPresent?: boolean;
+    worktreePresent?: boolean;
+    logicalWave?: number;
+    launchAttempt?: number;
+    blockedReason?: string;
+    contaminatedPaths?: string[];
+    stalled?: boolean;
+    readyForFinish?: boolean;
+    needsRelaunch?: boolean;
+}
+/**
+ * Legacy alias of the SDK {@link OrchestrationNextSafeAction}. Prefer importing the
+ * SDK name directly in new code.
+ */
+export type OrchestrationNextAction = OrchestrationNextSafeAction;
+export interface ReconciledInitiativeWU {
+    wuId: string;
+    title: string;
+    lane: string;
+    yamlStatus: string;
+    logicalWave: number;
+    launchAttempt?: number;
+    state: OrchestrationStatusValue;
+    reason: string;
+    dependencies: string[];
+    launchBlockedBy: string[];
+    launchEligible: boolean;
+    nextAction?: OrchestrationNextSafeAction;
+    evidence: WuExecutionEvidence;
+}
+export interface InitiativeExecutionSummary {
+    activeWorkerCount: number;
+    availableCapacity: number | null;
+    maxActiveWorkers: number | null;
+    blockedByIntegrity: boolean;
+    launchableWuIds: string[];
+    nextSafeActions: OrchestrationNextSafeAction[];
+    wus: ReconciledInitiativeWU[];
+}
 /**
  * Dependency filter result.
  */

package/dist/orchestrator/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/orchestrator/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/orchestrator/types.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,OAAO,EACL,oCAAoC,EACpC,2BAA2B,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,EAC9B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EACL,oCAAoC,EACpC,2BAA2B,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,GAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB,EAAE,cAAc,EAAE,CAAC;IACrC,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,0BAA0B,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,aAAa,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,2BAA2B;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,gBAAgB,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,2BAA2B,EAAE,CAAC;IAChD,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;CAA8B,CAAC;AAC1E,MAAM,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,+BAA+B,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,wBAAwB,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,2BAA2B,EAAE,CAAC;IAC/C,GAAG,EAAE,sBAAsB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/orchestrator/types.js

@@ -1,4 +1,18 @@
 // Copyright (c) 2026 Hellmai Ltd
 // SPDX-License-Identifier: AGPL-3.0-only
-export {};
+/**
+ * Type definitions for initiative orchestration.
+ *
+ * All shared interfaces and types used across orchestration domain modules.
+ *
+ * @module orchestrator/types
+ */
+import { ORCHESTRATION_NEXT_SAFE_ACTION_TYPES, ORCHESTRATION_STATUS_VALUES, } from '@lumenflow/control-plane-sdk';
+export { ORCHESTRATION_NEXT_SAFE_ACTION_TYPES, ORCHESTRATION_STATUS_VALUES, };
+/**
+ * Internal alias of the SDK {@link ORCHESTRATION_STATUS_VALUES} constant so existing
+ * callsites keep the `ORCHESTRATION_EXECUTION_STATES` name while sharing one vocabulary
+ * with the control-plane contract.
+ */
+export const ORCHESTRATION_EXECUTION_STATES = ORCHESTRATION_STATUS_VALUES;
 //# sourceMappingURL=types.js.map

package/dist/orchestrator/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/orchestrator/types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/orchestrator/types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;GAMG;AAEH,OAAO,EACL,oCAAoC,EACpC,2BAA2B,GAM5B,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACL,oCAAoC,EACpC,2BAA2B,GAM5B,CAAC;AAyIF;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,2BAA2B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/initiatives",
-  "version": "4.21.0",
+  "version": "4.23.0",
   "description": "Initiative tracking for LumenFlow workflow framework - multi-phase project coordination",
   "keywords": [
     "lumenflow",
@@ -40,7 +40,8 @@
   ],
   "dependencies": {
     "zod": "^4.3.6",
-    "@lumenflow/core": "4.21.0"
+    "@lumenflow/control-plane-sdk": "4.23.0",
+    "@lumenflow/core": "4.23.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",