@lumenflow/initiatives 4.20.2 → 4.22.0

package/dist/initiative-orchestrator.d.ts

@@ -17,13 +17,15 @@
  * @see {@link packages/@lumenflow/cli/src/lib/initiative-yaml.ts} - Initiative loading
  * @see {@link packages/@lumenflow/cli/src/lib/dependency-graph.ts} - Dependency graph utilities
  */
-export type { CheckpointOptions, CheckpointModeResult, AutoCheckpointResult, SkippedWUEntry, DeferredWUEntry, ExecutionPlan, ProgressStats, BottleneckWU, WaveManifestWU, WaveManifest, CheckpointWaveResult, DependencyFilterResult, LockPolicy, LaneConfig, LockPolicyOptions, LaneAvailabilityResult, } from './orchestrator/types.js';
+export type { CheckpointOptions, CheckpointModeResult, AutoCheckpointResult, SkippedWUEntry, DeferredWUEntry, ExecutionPlan, ProgressStats, BottleneckWU, WaveManifestWU, WaveManifest, CheckpointWaveResult, DependencyFilterResult, LockPolicy, LaneConfig, LockPolicyOptions, LaneAvailabilityResult, HandoffFormat, HandoffReceipt, OrchestrationArtifactBundle, OrchestrationExecutionState, OrchestrationActionType, WuExecutionEvidence, OrchestrationNextAction, ReconciledInitiativeWU, InitiativeExecutionSummary, } from './orchestrator/types.js';
 export { LOG_PREFIX } from './orchestrator/shared.js';
 export { buildExecutionPlan, buildExecutionPlanAsync, buildExecutionPlanWithLockPolicy, } from './orchestrator/execution-planning.js';
 export { CHECKPOINT_AUTO_THRESHOLDS, filterByDependencyStamps, shouldAutoEnableCheckpoint, shouldAutoEnableCheckpointAsync, resolveCheckpointMode, resolveCheckpointModeAsync, validateCheckpointFlags, buildCheckpointWave, } from './orchestrator/checkpoint.js';
+export { isXmlCapableClient, renderHandoffArtifact, writeCheckpointArtifacts, writeExecutionPlanArtifacts, } from './orchestrator/artifacts.js';
 export { formatExecutionPlan, generateSpawnCommands, calculateProgress, formatProgress, getBottleneckWUs, formatCheckpointOutput, generateEmbeddedSpawnPrompt, formatTaskInvocationWithEmbeddedSpawn, formatExecutionPlanWithEmbeddedSpawns, } from './orchestrator/formatting.js';
 export { getManifestWUStatus, isWUActuallySpawned, getSpawnCandidatesWithYAMLCheck, } from './orchestrator/spawn-status.js';
 export { getLockPolicyForLane, getLaneAvailability } from './orchestrator/lane-policy.js';
+export { reconcileInitiativeExecution } from './orchestrator/reconciliation.js';
 export { loadInitiativeWUs, loadMultipleInitiatives } from './orchestrator/initiative-loading.js';
 export { analyseScopeShape, formatScopeAdvisory, SCOPE_ADVISORY_THRESHOLDS, type ScopeAdvisory, type ScopeAdvisoryResult, type ScopeAdvisoryType, type ScopeAdvisorySeverity, } from './orchestrator/scope-advisory.js';
 //# sourceMappingURL=initiative-orchestrator.d.ts.map

package/dist/initiative-orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initiative-orchestrator.d.ts","sourceRoot":"","sources":["../src/initiative-orchestrator.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,GACjC,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,+BAA+B,EAC/B,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,EAC3B,qCAAqC,EACrC,qCAAqC,GACtC,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAG1F,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAGlG,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"initiative-orchestrator.d.ts","sourceRoot":"","sources":["../src/initiative-orchestrator.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,GACjC,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,+BAA+B,EAC/B,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,EAC3B,qCAAqC,EACrC,qCAAqC,GACtC,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAG1F,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAGhF,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAGlG,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,kCAAkC,CAAC"}

package/dist/initiative-orchestrator.js

@@ -6,12 +6,16 @@ export { LOG_PREFIX } from './orchestrator/shared.js';
 export { buildExecutionPlan, buildExecutionPlanAsync, buildExecutionPlanWithLockPolicy, } from './orchestrator/execution-planning.js';
 // ── Checkpoint ────────────────────────────────────────────────────────────────
 export { CHECKPOINT_AUTO_THRESHOLDS, filterByDependencyStamps, shouldAutoEnableCheckpoint, shouldAutoEnableCheckpointAsync, resolveCheckpointMode, resolveCheckpointModeAsync, validateCheckpointFlags, buildCheckpointWave, } from './orchestrator/checkpoint.js';
+// ── Durable artifacts ────────────────────────────────────────────────────────
+export { isXmlCapableClient, renderHandoffArtifact, writeCheckpointArtifacts, writeExecutionPlanArtifacts, } from './orchestrator/artifacts.js';
 // ── Formatting ────────────────────────────────────────────────────────────────
 export { formatExecutionPlan, generateSpawnCommands, calculateProgress, formatProgress, getBottleneckWUs, formatCheckpointOutput, generateEmbeddedSpawnPrompt, formatTaskInvocationWithEmbeddedSpawn, formatExecutionPlanWithEmbeddedSpawns, } from './orchestrator/formatting.js';
 // ── Spawn status ──────────────────────────────────────────────────────────────
 export { getManifestWUStatus, isWUActuallySpawned, getSpawnCandidatesWithYAMLCheck, } from './orchestrator/spawn-status.js';
 // ── Lane policy ───────────────────────────────────────────────────────────────
 export { getLockPolicyForLane, getLaneAvailability } from './orchestrator/lane-policy.js';
+// ── Reconciliation / advancement ─────────────────────────────────────────────
+export { reconcileInitiativeExecution } from './orchestrator/reconciliation.js';
 // ── Initiative loading ────────────────────────────────────────────────────────
 export { loadInitiativeWUs, loadMultipleInitiatives } from './orchestrator/initiative-loading.js';
 // ── Scope advisory (WU-2142/WU-2155) ────────────────────────────────────────

package/dist/initiative-orchestrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"initiative-orchestrator.js","sourceRoot":"","sources":["../src/initiative-orchestrator.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AA0CzC,iFAAiF;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,iFAAiF;AACjF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,GACjC,MAAM,sCAAsC,CAAC;AAE9C,iFAAiF;AACjF,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,+BAA+B,EAC/B,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,iFAAiF;AACjF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,EAC3B,qCAAqC,EACrC,qCAAqC,GACtC,MAAM,8BAA8B,CAAC;AAEtC,iFAAiF;AACjF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,gCAAgC,CAAC;AAExC,iFAAiF;AACjF,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAE1F,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAElG,+EAA+E;AAC/E,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,GAK1B,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"initiative-orchestrator.js","sourceRoot":"","sources":["../src/initiative-orchestrator.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAmDzC,iFAAiF;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,iFAAiF;AACjF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,GACjC,MAAM,sCAAsC,CAAC;AAE9C,iFAAiF;AACjF,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,+BAA+B,EAC/B,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,gFAAgF;AAChF,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAErC,iFAAiF;AACjF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,EAC3B,qCAAqC,EACrC,qCAAqC,GACtC,MAAM,8BAA8B,CAAC;AAEtC,iFAAiF;AACjF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,gCAAgC,CAAC;AAExC,iFAAiF;AACjF,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAE1F,gFAAgF;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAEhF,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAElG,+EAA+E;AAC/E,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,GAK1B,MAAM,kCAAkC,CAAC"}

package/dist/orchestrator/artifacts.d.ts

@@ -0,0 +1,17 @@
+import type { WUEntry } from '../initiative-yaml.js';
+import type { CheckpointOptions, ExecutionPlan, HandoffFormat, OrchestrationArtifactBundle } from './types.js';
+interface RenderedHandoffArtifact {
+    content: string;
+    extension: string;
+    format: HandoffFormat;
+}
+interface HandoffWU {
+    id: string;
+    doc: WUEntry['doc'];
+}
+export declare function isXmlCapableClient(clientName?: string): boolean;
+export declare function renderHandoffArtifact(wu: HandoffWU, clientName?: string): RenderedHandoffArtifact;
+export declare function writeExecutionPlanArtifacts(initId: string, allWUs: WUEntry[], plan: ExecutionPlan, options?: CheckpointOptions): OrchestrationArtifactBundle;
+export declare function writeCheckpointArtifacts(initId: string, allWUs: WUEntry[], selectedWUs: WUEntry[], options?: CheckpointOptions): OrchestrationArtifactBundle;
+export {};
+//# sourceMappingURL=artifacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/orchestrator/artifacts.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,aAAa,EAEb,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAgBpB,UAAU,uBAAuB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;CACvB;AAOD,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAQD,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,uBAAuB,CAiBjG;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EAAE,EACjB,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,iBAAsB,GAC9B,2BAA2B,CAG7B;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EAAE,EACjB,WAAW,EAAE,OAAO,EAAE,EACtB,OAAO,GAAE,iBAAsB,GAC9B,2BAA2B,CAO7B"}

package/dist/orchestrator/artifacts.js

@@ -0,0 +1,248 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Durable artifact writing for initiative orchestration.
+ *
+ * WU-2617: Persist plan/launch/status artifacts and per-WU handoff receipts so
+ * orchestration can distinguish dependency waves from repeated launch attempts.
+ *
+ * @module orchestrator/artifacts
+ */
+import { existsSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getAllDependencies, ORCHESTRATION_ARTIFACT_DIR, WAVE_MANIFEST_DIR } from './shared.js';
+import { generateCodexPrompt, generateTaskInvocation } from '@lumenflow/core/wu-spawn';
+import { SpawnStrategyFactory } from '@lumenflow/core/spawn-strategy';
+const XML_CAPABLE_CLIENTS = new Set(['claude-code', 'claude']);
+const ATTEMPT_PREFIX = 'attempt-';
+const HANDOFFS_DIRNAME = 'handoffs';
+const PLAN_FILENAME = 'plan.json';
+const LAUNCH_FILENAME = 'launch.json';
+const STATUS_FILENAME = 'status.json';
+const MARKDOWN_EXTENSION = 'md';
+const XML_EXTENSION = 'xml';
+const FALLBACK_LOGICAL_WAVE = 0;
+const FALLBACK_ATTEMPT = -1;
+export function isXmlCapableClient(clientName) {
+    return clientName !== undefined && XML_CAPABLE_CLIENTS.has(clientName.toLowerCase());
+}
+export function renderHandoffArtifact(wu, clientName) {
+    const resolvedClient = clientName || 'generic';
+    const strategy = SpawnStrategyFactory.create(resolvedClient);
+    if (isXmlCapableClient(resolvedClient)) {
+        return {
+            content: generateTaskInvocation(wu.doc, wu.id, strategy),
+            extension: XML_EXTENSION,
+            format: 'xml',
+        };
+    }
+    return {
+        content: generateCodexPrompt(wu.doc, wu.id, strategy),
+        extension: MARKDOWN_EXTENSION,
+        format: 'markdown',
+    };
+}
+export function writeExecutionPlanArtifacts(initId, allWUs, plan, options = {}) {
+    const waveGroups = plan.waves.map((wus, plannedWave) => ({ plannedWave, wus }));
+    return writeOrchestrationAttemptArtifacts(initId, allWUs, waveGroups, options);
+}
+export function writeCheckpointArtifacts(initId, allWUs, selectedWUs, options = {}) {
+    return writeOrchestrationAttemptArtifacts(initId, allWUs, [{ plannedWave: 0, wus: selectedWUs }], options);
+}
+function writeOrchestrationAttemptArtifacts(initId, allWUs, waveGroups, options = {}) {
+    const { clientName, dryRun = false } = options;
+    const executionSummary = options.executionSummary;
+    const launchAttempt = getNextLaunchAttempt(initId);
+    const artifactDir = join(ORCHESTRATION_ARTIFACT_DIR, initId, `${ATTEMPT_PREFIX}${launchAttempt}`);
+    const planPath = join(artifactDir, PLAN_FILENAME);
+    const launchPath = join(artifactDir, LAUNCH_FILENAME);
+    const statusPath = join(artifactDir, STATUS_FILENAME);
+    const handoffDir = join(artifactDir, HANDOFFS_DIRNAME);
+    const createdAt = new Date().toISOString();
+    const logicalWaveMap = calculateLogicalWaveMap(allWUs);
+    const launchableWUs = flattenWaveGroups(waveGroups, logicalWaveMap);
+    const logicalWaves = Array.from(new Set(launchableWUs.map((entry) => entry.logicalWave))).sort((left, right) => left - right);
+    const handoffReceipts = launchableWUs.map((entry) => createHandoffReceipt(entry, launchAttempt, handoffDir, clientName, createdAt, dryRun));
+    if (!dryRun) {
+        mkdirSync(handoffDir, { recursive: true });
+        for (let index = 0; index < handoffReceipts.length; index++) {
+            const receipt = handoffReceipts[index];
+            const launchableWU = launchableWUs[index];
+            const rendered = renderHandoffArtifact(launchableWU.wu, clientName);
+            writeFileSync(receipt.handoff_artifact_path, rendered.content, 'utf8');
+        }
+        const planData = {
+            initiative: initId,
+            created_at: createdAt,
+            launch_attempt: launchAttempt,
+            logical_waves: logicalWaves,
+            waves: waveGroups.map((group) => {
+                const groupEntries = launchableWUs.filter((entry) => entry.plannedWave === group.plannedWave);
+                const groupLogicalWaves = Array.from(new Set(groupEntries.map((entry) => entry.logicalWave))).sort((left, right) => left - right);
+                return {
+                    planned_wave: group.plannedWave,
+                    logical_wave: groupLogicalWaves[0] ?? FALLBACK_LOGICAL_WAVE,
+                    logical_waves: groupLogicalWaves,
+                    wus: groupEntries.map((entry) => ({
+                        id: entry.wu.id,
+                        lane: entry.wu.doc.lane,
+                        logical_wave: entry.logicalWave,
+                    })),
+                };
+            }),
+        };
+        const launchData = {
+            initiative: initId,
+            created_at: createdAt,
+            launch_attempt: launchAttempt,
+            logical_waves: logicalWaves,
+            handoffs: handoffReceipts,
+        };
+        const statusData = {
+            initiative: initId,
+            created_at: createdAt,
+            launch_attempt: launchAttempt,
+            logical_waves: logicalWaves,
+            actual_launch_confirmed: false,
+            treat_handoff_as_completed: false,
+            available_capacity: executionSummary?.availableCapacity ?? null,
+            max_active_workers: executionSummary?.maxActiveWorkers ?? null,
+            blocked_by_integrity: executionSummary?.blockedByIntegrity ?? false,
+            next_safe_actions: executionSummary?.nextSafeActions.map((action) => ({
+                type: action.type,
+                wu_id: action.wuId,
+                reason: action.reason,
+                logical_wave: action.logicalWave,
+            })) ?? [],
+            wus: allWUs.map((wu) => {
+                const summaryEntry = executionSummary?.wus.find((entry) => entry.wuId === wu.id);
+                const launchableEntry = launchableWUs.find((entry) => entry.wu.id === wu.id);
+                const handoffState = handoffReceipts.find((receipt) => receipt.wu_id === wu.id);
+                return {
+                    wu_id: wu.id,
+                    lane: wu.doc.lane,
+                    logical_wave: summaryEntry?.logicalWave ?? launchableEntry?.logicalWave ?? FALLBACK_LOGICAL_WAVE,
+                    orchestration_state: launchableEntry || handoffState ? 'handoff_emitted' : (summaryEntry?.state ?? 'ready'),
+                    yaml_status: wu.doc.status ?? 'unknown',
+                };
+            }),
+        };
+        writeFileSync(planPath, JSON.stringify(planData, null, 2), 'utf8');
+        writeFileSync(launchPath, JSON.stringify(launchData, null, 2), 'utf8');
+        writeFileSync(statusPath, JSON.stringify(statusData, null, 2), 'utf8');
+    }
+    return {
+        artifactDir,
+        planPath,
+        launchPath,
+        statusPath,
+        logicalWaves,
+        launchAttempt,
+        handoffReceipts,
+    };
+}
+function flattenWaveGroups(waveGroups, logicalWaveMap) {
+    return waveGroups.flatMap((group) => group.wus.map((wu) => ({
+        logicalWave: logicalWaveMap.get(wu.id) ?? FALLBACK_LOGICAL_WAVE,
+        plannedWave: group.plannedWave,
+        wu,
+    })));
+}
+function createHandoffReceipt(entry, launchAttempt, handoffDir, clientName, emittedAt, dryRun) {
+    const rendered = renderHandoffArtifact(entry.wu, clientName);
+    const handoffArtifactPath = join(handoffDir, `${entry.wu.id}.${rendered.extension}`);
+    if (!dryRun && !existsSync(handoffDir)) {
+        mkdirSync(handoffDir, { recursive: true });
+    }
+    return {
+        wu_id: entry.wu.id,
+        lane: entry.wu.doc.lane,
+        logical_wave: entry.logicalWave,
+        launch_attempt: launchAttempt,
+        handoff_artifact_path: handoffArtifactPath,
+        handoff_format: rendered.format,
+        orchestration_state: 'handoff_emitted',
+        emitted_at: emittedAt,
+    };
+}
+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 dependants = adjacency.get(depId);
+            if (dependants) {
+                dependants.push(wu.id);
+            }
+        }
+    }
+    const queue = Array.from(inDegree.entries())
+        .filter(([, degree]) => degree === 0)
+        .map(([wuId]) => wuId)
+        .sort();
+    for (const wuId of queue) {
+        logicalWaveMap.set(wuId, FALLBACK_LOGICAL_WAVE);
+    }
+    while (queue.length > 0) {
+        const currentId = queue.shift();
+        if (!currentId) {
+            continue;
+        }
+        const currentWave = logicalWaveMap.get(currentId) ?? FALLBACK_LOGICAL_WAVE;
+        const dependants = adjacency.get(currentId) ?? [];
+        for (const dependantId of dependants) {
+            const nextWave = currentWave + 1;
+            logicalWaveMap.set(dependantId, Math.max(logicalWaveMap.get(dependantId) ?? 0, nextWave));
+            const remainingDegree = (inDegree.get(dependantId) ?? 1) - 1;
+            inDegree.set(dependantId, remainingDegree);
+            if (remainingDegree === 0) {
+                queue.push(dependantId);
+                queue.sort();
+            }
+        }
+    }
+    for (const wu of wus) {
+        if (!logicalWaveMap.has(wu.id)) {
+            logicalWaveMap.set(wu.id, FALLBACK_LOGICAL_WAVE);
+        }
+    }
+    return logicalWaveMap;
+}
+function getNextLaunchAttempt(initId) {
+    const attemptDirsPath = join(ORCHESTRATION_ARTIFACT_DIR, initId);
+    const legacyPattern = new RegExp(`^${initId}-wave-(\\d+)\\.json$`);
+    let maxAttempt = FALLBACK_ATTEMPT;
+    if (existsSync(attemptDirsPath)) {
+        for (const entry of readdirSync(attemptDirsPath, { withFileTypes: true })) {
+            if (!entry.isDirectory() || !entry.name.startsWith(ATTEMPT_PREFIX)) {
+                continue;
+            }
+            const parsed = Number.parseInt(entry.name.slice(ATTEMPT_PREFIX.length), 10);
+            if (!Number.isNaN(parsed)) {
+                maxAttempt = Math.max(maxAttempt, parsed);
+            }
+        }
+    }
+    if (existsSync(WAVE_MANIFEST_DIR)) {
+        for (const file of readdirSync(WAVE_MANIFEST_DIR)) {
+            const match = file.match(legacyPattern);
+            if (!match) {
+                continue;
+            }
+            const parsed = Number.parseInt(match[1] ?? '', 10);
+            if (!Number.isNaN(parsed)) {
+                maxAttempt = Math.max(maxAttempt, parsed);
+            }
+        }
+    }
+    return maxAttempt + 1;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/orchestrator/artifacts.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/orchestrator/checkpoint.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EAEpB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAWpB;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;IACrC,6EAA6E;;IAE7E,uEAAuE;;CAExE,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAqCtF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,oBAAoB,CA6C/E;AAED;;;;;GAKG;AACH,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,OAAO,EAAE,GACb,OAAO,CAAC,oBAAoB,CAAC,CA6C/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,OAAO,EAAE,GACb,oBAAoB,CAqCtB;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,OAAO,EAAE,GACb,OAAO,CAAC,oBAAoB,CAAC,CAqC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAmBxE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,oBAAoB,GAAG,IAAI,CA2F7B"}
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/orchestrator/checkpoint.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EAEpB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAapB;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;IACrC,6EAA6E;;IAE7E,uEAAuE;;CAExE,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAqCtF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,oBAAoB,CA6C/E;AAED;;;;;GAKG;AACH,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,OAAO,EAAE,GACb,OAAO,CAAC,oBAAoB,CAAC,CA6C/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,OAAO,EAAE,GACb,oBAAoB,CAqCtB;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,OAAO,EAAE,GACb,OAAO,CAAC,oBAAoB,CAAC,CAqC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAmBxE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,oBAAoB,GAAG,IAAI,CAoP7B"}

package/dist/orchestrator/checkpoint.js

@@ -13,6 +13,8 @@ import { join } from 'node:path';
 import { findInitiative, getInitiativeWUs } from '../initiative-yaml.js';
 import { WAVE_MANIFEST_DIR, hasStamp, getAllDependencies } from './shared.js';
 import { buildExecutionPlan, buildExecutionPlanAsync } from './execution-planning.js';
+import { writeCheckpointArtifacts } from './artifacts.js';
+import { reconcileInitiativeExecution } from './reconciliation.js';
 import { createError, ErrorCodes } from '@lumenflow/core/error-handler';
 import { WU_STATUS } from '@lumenflow/core/wu-constants';
 /**
@@ -302,7 +304,7 @@ export function validateCheckpointFlags(options) {
  *   Wave data or null if all WUs complete
  */
 export function buildCheckpointWave(initRef, options = {}) {
-    const { dryRun = false } = options;
+    const { dryRun = false, clientName, executionEvidence = [], maxActiveWorkers, blockOnIntegrity = true, } = options;
     // Load initiative and WUs
     const initData = findInitiative(initRef);
     if (!initData) {
@@ -310,6 +312,18 @@ export function buildCheckpointWave(initRef, options = {}) {
     }
     const initId = initData.id;
     const wus = getInitiativeWUs(initRef);
+    const stampAwareEvidence = wus.map((wu) => {
+        const existing = executionEvidence.find((entry) => entry.wuId === wu.id);
+        return {
+            wuId: wu.id,
+            stampPresent: hasStamp(wu.id),
+            ...existing,
+        };
+    });
+    const executionSummary = reconcileInitiativeExecution(wus, stampAwareEvidence, {
+        maxActiveWorkers,
+        blockOnIntegrity,
+    });
     // Filter to spawn candidates:
     // 1. status: ready only (from YAML - authoritative)
     // 2. No stamp exists (idempotency)
@@ -322,9 +336,48 @@ export function buildCheckpointWave(initRef, options = {}) {
         }
         return true;
     });
-    // If no ready candidates, all work is done
     if (readyCandidates.length === 0) {
-        return null;
+        const unfinishedActions = executionSummary.nextSafeActions.filter((action) => action.type !== 'launch');
+        const hasIncompleteExecution = executionSummary.wus.some((wu) => wu.state !== 'done');
+        if (!hasIncompleteExecution) {
+            return null;
+        }
+        return {
+            initiative: initId,
+            wave: -1,
+            wus: [],
+            manifestPath: null,
+            artifactDir: '',
+            planPath: '',
+            launchPath: '',
+            statusPath: '',
+            waitingMessage: 'No ready WUs can launch yet. Finish or recover in-flight work first.',
+            logicalWaves: [],
+            launchAttempt: -1,
+            handoffReceipts: [],
+            availableCapacity: executionSummary.availableCapacity,
+            nextSafeActions: unfinishedActions,
+            executionSummary,
+        };
+    }
+    if (executionSummary.blockedByIntegrity) {
+        return {
+            initiative: initId,
+            wave: -1,
+            wus: [],
+            manifestPath: null,
+            artifactDir: '',
+            planPath: '',
+            launchPath: '',
+            statusPath: '',
+            waitingMessage: 'Unsafe to advance while orchestration integrity issues remain.',
+            logicalWaves: [],
+            launchAttempt: -1,
+            handoffReceipts: [],
+            availableCapacity: executionSummary.availableCapacity,
+            nextSafeActions: executionSummary.nextSafeActions,
+            executionSummary,
+        };
     }
     // WU-2040: Filter by dependency stamps (wait-for-completion pattern)
     const depResult = filterByDependencyStamps(readyCandidates);
@@ -335,34 +388,111 @@ export function buildCheckpointWave(initRef, options = {}) {
             wave: -1,
             wus: [],
             manifestPath: null,
+            artifactDir: '',
+            planPath: '',
+            launchPath: '',
+            statusPath: '',
             blockedBy: depResult.blockingDeps,
             waitingMessage: depResult.waitingMessage,
+            logicalWaves: [],
+            launchAttempt: -1,
+            handoffReceipts: [],
+            availableCapacity: executionSummary.availableCapacity,
+            nextSafeActions: executionSummary.nextSafeActions,
+            executionSummary,
+        };
+    }
+    const launchableIds = new Set(executionSummary.launchableWuIds);
+    const launchableCandidates = depResult.spawnable.filter((wu) => launchableIds.has(wu.id));
+    if (launchableCandidates.length === 0) {
+        return {
+            initiative: initId,
+            wave: -1,
+            wus: [],
+            manifestPath: null,
+            artifactDir: '',
+            planPath: '',
+            launchPath: '',
+            statusPath: '',
+            waitingMessage: executionSummary.nextSafeActions.length > 0
+                ? 'No WUs can launch yet. Follow the next safe actions before advancing.'
+                : 'No WUs are currently eligible to launch.',
+            logicalWaves: [],
+            launchAttempt: -1,
+            handoffReceipts: [],
+            availableCapacity: executionSummary.availableCapacity,
+            nextSafeActions: executionSummary.nextSafeActions,
+            executionSummary,
         };
     }
+    const capacityLimit = executionSummary.availableCapacity === null
+        ? Number.POSITIVE_INFINITY
+        : executionSummary.availableCapacity;
     // Apply lane WIP=1 constraint: max one WU per lane per wave
     const selectedWUs = [];
     const usedLanes = new Set();
     for (const wu of depResult.spawnable) {
+        if (!launchableIds.has(wu.id)) {
+            continue;
+        }
+        if (selectedWUs.length >= capacityLimit) {
+            break;
+        }
         const lane = wu.doc.lane;
         if (!usedLanes.has(lane)) {
             selectedWUs.push(wu);
             usedLanes.add(lane);
         }
     }
-    // Determine wave number
-    const waveNum = getNextWaveNumber(initId);
-    // Build manifest
+    if (selectedWUs.length === 0) {
+        return {
+            initiative: initId,
+            wave: -1,
+            wus: [],
+            manifestPath: null,
+            artifactDir: '',
+            planPath: '',
+            launchPath: '',
+            statusPath: '',
+            waitingMessage: 'No WUs fit the remaining capacity or lane limits in this launch.',
+            logicalWaves: [],
+            launchAttempt: -1,
+            handoffReceipts: [],
+            availableCapacity: executionSummary.availableCapacity,
+            nextSafeActions: executionSummary.nextSafeActions,
+            executionSummary,
+        };
+    }
+    const artifactBundle = writeCheckpointArtifacts(initId, wus, selectedWUs, {
+        clientName,
+        dryRun,
+        executionSummary,
+    });
+    const waveNum = artifactBundle.launchAttempt;
+    // Build compatibility manifest
     const manifest = {
         initiative: initId,
         wave: waveNum,
+        launch_attempt: artifactBundle.launchAttempt,
+        logical_waves: artifactBundle.logicalWaves,
         created_at: new Date().toISOString(),
-        wus: selectedWUs.map((wu) => ({
-            id: wu.id,
-            lane: wu.doc.lane,
-            status: MANIFEST_WU_STATUS,
-        })),
+        wus: selectedWUs.map((wu) => {
+            const receipt = artifactBundle.handoffReceipts.find((entry) => entry.wu_id === wu.id);
+            return {
+                id: wu.id,
+                lane: wu.doc.lane,
+                status: MANIFEST_WU_STATUS,
+                logical_wave: receipt?.logical_wave,
+                handoff_artifact_path: receipt?.handoff_artifact_path,
+                handoff_format: receipt?.handoff_format,
+            };
+        }),
         lane_validation: 'pass',
         done_criteria: 'All stamps exist in .lumenflow/stamps/',
+        artifact_dir: artifactBundle.artifactDir,
+        plan_path: artifactBundle.planPath,
+        launch_path: artifactBundle.launchPath,
+        status_path: artifactBundle.statusPath,
     };
     // WU-2277: Skip file creation in dry-run mode
     const manifestPath = join(WAVE_MANIFEST_DIR, `${initId}-wave-${waveNum}.json`);
@@ -379,6 +509,16 @@ export function buildCheckpointWave(initRef, options = {}) {
         wave: waveNum,
         wus: manifest.wus,
         manifestPath,
+        artifactDir: artifactBundle.artifactDir,
+        planPath: artifactBundle.planPath,
+        launchPath: artifactBundle.launchPath,
+        statusPath: artifactBundle.statusPath,
+        logicalWaves: artifactBundle.logicalWaves,
+        launchAttempt: artifactBundle.launchAttempt,
+        handoffReceipts: artifactBundle.handoffReceipts,
+        availableCapacity: executionSummary.availableCapacity,
+        nextSafeActions: executionSummary.nextSafeActions,
+        executionSummary,
     };
 }
 // ── Internal helpers ──────────────────────────────────────────────────────────
@@ -429,18 +569,4 @@ function _getSpawnedWUIds(initId) {
     }
     return spawnedIds;
 }
-/**
- * Determine the next wave number for an initiative.
- *
- * @param {string} initId - Initiative ID
- * @returns {number} Next wave number (0-indexed)
- */
-function getNextWaveNumber(initId) {
-    const manifests = getExistingWaveManifests(initId);
-    if (manifests.length === 0) {
-        return 0;
-    }
-    const maxWave = Math.max(...manifests.map((m) => m.wave));
-    return maxWave + 1;
-}
 //# sourceMappingURL=checkpoint.js.map