@lumenflow/core 3.2.0 → 3.2.2

package/dist/wu-create-validators.d.ts

@@ -0,0 +1,89 @@
+/**
+ * WU-1069: Check if a path is a repo-internal path that should be rejected
+ *
+ * Repo-internal paths start with ./ or .lumenflow/ and indicate the agent
+ * is attempting to store plans inside the repository instead of externally.
+ *
+ * @param {string} path - Path to check
+ * @returns {boolean} True if path is repo-internal and should be rejected
+ */
+export declare function isRepoInternalPath(path: string): boolean;
+/**
+ * WU-1069: Build error message for repo-internal path rejection
+ *
+ * @param {string} path - The rejected path
+ * @returns {string} Error message with correct format examples
+ */
+export declare function buildRepoInternalPathError(path: string): string;
+/**
+ * Generate a warning message when provided lane differs from inferred lane.
+ *
+ * Returns empty string if lanes match (no warning needed).
+ *
+ * @param {string} providedLane - Lane provided by the user
+ * @param {string} inferredLane - Lane suggested by inference
+ * @param {number} confidence - Confidence score (0-100)
+ * @returns {string} Warning message or empty string if lanes match
+ */
+export declare function generateLaneMismatchWarning(providedLane: UnsafeAny, inferredLane: UnsafeAny, confidence: UnsafeAny): string;
+/**
+ * Check if lane validation should show a suggestion
+ *
+ * @param {string} providedLane - Lane provided by the user
+ * @param {string[]} codePaths - Code paths from WU
+ * @param {string} description - WU description
+ * @param {Function} inferSubLane - Lane inference function
+ * @returns {{ shouldWarn: boolean, warning: string }} Validation result
+ */
+export declare function validateLaneWithInference(providedLane: UnsafeAny, codePaths: UnsafeAny, description: UnsafeAny, inferSubLane: UnsafeAny): {
+    shouldWarn: boolean;
+    warning: string;
+    inferredLane?: undefined;
+    confidence?: undefined;
+} | {
+    shouldWarn: boolean;
+    warning: string;
+    inferredLane: any;
+    confidence: any;
+};
+/**
+ * WU-1062: Validate spec_refs paths
+ *
+ * Accepts:
+ * - Repo-relative paths: docs/04-operations/plans/WU-XXX-plan.md
+ * - External paths: lumenflow://plans/WU-XXX-plan.md
+ * - Tilde paths: ~/.lumenflow/plans/WU-XXX-plan.md
+ * - Env var paths: $LUMENFLOW_HOME/plans/WU-XXX-plan.md
+ *
+ * @param {string[]} specRefs - Array of spec reference paths
+ * @returns {{ valid: boolean, errors: string[], warnings: string[] }} Validation result
+ */
+export declare function validateSpecRefs(specRefs: string[]): {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * WU-1062: Check if spec_refs contains external paths
+ *
+ * @param {string[]} specRefs - Array of spec reference paths
+ * @returns {boolean} True if UnsafeAny spec_ref is an external path
+ */
+export declare function hasExternalSpecRefs(specRefs: string[]): boolean;
+/**
+ * WU-1429: Check if spec_refs is non-empty
+ *
+ * @param {string[]|undefined} specRefs - Array of spec reference paths
+ * @returns {boolean} True if spec_refs contains at least one entry
+ */
+export declare function hasSpecRefs(specRefs: string[] | undefined): boolean;
+/**
+ * WU-1062: Normalize all spec_refs paths
+ *
+ * Expands external paths to absolute paths while keeping repo-relative paths unchanged.
+ *
+ * @param {string[]} specRefs - Array of spec reference paths
+ * @returns {string[]} Normalized paths
+ */
+export declare function normalizeSpecRefs(specRefs: string[]): string[];
+//# sourceMappingURL=wu-create-validators.d.ts.map

package/dist/wu-create-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-create-validators.d.ts","sourceRoot":"","sources":["../src/wu-create-validators.ts"],"names":[],"mappings":"AA6BA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,SAAS,EACvB,YAAY,EAAE,SAAS,EACvB,UAAU,EAAE,SAAS,UAoBtB;AAwCD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,SAAS,EACvB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,EACtB,YAAY,EAAE,SAAS;;;;;;;;;;EAqBxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CA4CA;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAK/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAEnE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAK9D"}

package/dist/wu-create-validators.js

@@ -0,0 +1,215 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Create Validators (WU-2107, WU-1062)
+ *
+ * Validation helpers for wu:create, including:
+ * - Lane inference surfacing (WU-2107)
+ * - External spec_refs validation (WU-1062)
+ *
+ * When agents create WUs, this module helps surface lane inference suggestions
+ * to guide better lane selection and improve parallelization.
+ *
+ * WU-1062: Validates spec_refs paths, accepting both repo-relative paths
+ * and external paths (lumenflow://, ~/.lumenflow/, $LUMENFLOW_HOME/).
+ *
+ * NOTE: This is domain-specific WU workflow code, not a general utility.
+ * No external library exists for LumenFlow lane inference validation.
+ */
+import { isExternalPath, normalizeSpecRef } from './lumenflow-home.js';
+import { PATH_LITERALS } from './wu-constants.js';
+/** Confidence threshold for showing suggestion (percentage) */
+const CONFIDENCE_THRESHOLD_LOW = 30;
+/** Prefixes that indicate repo-internal paths (WU-1069, WU-1430: Use centralized constants) */
+const REPO_INTERNAL_PREFIXES = [PATH_LITERALS.CURRENT_DIR_PREFIX, PATH_LITERALS.LUMENFLOW_PREFIX];
+/**
+ * WU-1069: Check if a path is a repo-internal path that should be rejected
+ *
+ * Repo-internal paths start with ./ or .lumenflow/ and indicate the agent
+ * is attempting to store plans inside the repository instead of externally.
+ *
+ * @param {string} path - Path to check
+ * @returns {boolean} True if path is repo-internal and should be rejected
+ */
+export function isRepoInternalPath(path) {
+    return REPO_INTERNAL_PREFIXES.some((prefix) => path.startsWith(prefix));
+}
+/**
+ * WU-1069: Build error message for repo-internal path rejection
+ *
+ * @param {string} path - The rejected path
+ * @returns {string} Error message with correct format examples
+ */
+export function buildRepoInternalPathError(path) {
+    return (`Rejected repo-internal spec_ref path: "${path}"\n` +
+        `Plans must be stored externally, not inside the repository.\n\n` +
+        `Valid path formats:\n` +
+        `  - lumenflow://plans/WU-XXXX-plan.md (recommended)\n` +
+        `  - ~/.lumenflow/plans/WU-XXXX-plan.md\n` +
+        `  - $LUMENFLOW_HOME/plans/WU-XXXX-plan.md\n\n` +
+        `Use --plan flag to auto-create: pnpm wu:create --plan --id WU-XXXX ...`);
+}
+/**
+ * Generate a warning message when provided lane differs from inferred lane.
+ *
+ * Returns empty string if lanes match (no warning needed).
+ *
+ * @param {string} providedLane - Lane provided by the user
+ * @param {string} inferredLane - Lane suggested by inference
+ * @param {number} confidence - Confidence score (0-100)
+ * @returns {string} Warning message or empty string if lanes match
+ */
+export function generateLaneMismatchWarning(providedLane, inferredLane, confidence) {
+    // Normalize lanes for comparison (handle parent-only vs sub-lane)
+    const normalizedProvided = providedLane.trim();
+    const normalizedInferred = inferredLane.trim();
+    // If lanes match exactly, no warning needed
+    if (normalizedProvided === normalizedInferred) {
+        return '';
+    }
+    // Check if provided is parent-only and inferred is a sub-lane of that parent
+    const inferredParent = normalizedInferred.split(':')[0].trim();
+    if (normalizedProvided === inferredParent) {
+        // User provided parent-only, suggest the specific sub-lane
+        return formatWarningMessage(normalizedInferred, confidence, true);
+    }
+    // Lanes are different, show suggestion
+    return formatWarningMessage(normalizedInferred, confidence, false);
+}
+/**
+ * Format the warning message based on confidence level
+ *
+ * @param {string} suggestedLane - The suggested lane
+ * @param {number} confidence - Confidence score (0-100)
+ * @param {boolean} isSubLaneSuggestion - True if suggesting sub-lane for parent-only input
+ * @returns {string} Formatted warning message
+ */
+function formatWarningMessage(suggestedLane, confidence, isSubLaneSuggestion) {
+    const confidenceStr = `${confidence}%`;
+    if (confidence < CONFIDENCE_THRESHOLD_LOW) {
+        return (`Lane suggestion (low confidence ${confidenceStr}): "${suggestedLane}"\n` +
+            `Run: pnpm wu:infer-lane --id WU-XXX to verify\n` +
+            `See: .lumenflow.lane-inference.yaml for lane taxonomy`);
+    }
+    if (isSubLaneSuggestion) {
+        return (`Suggested sub-lane (${confidenceStr} confidence): "${suggestedLane}"\n` +
+            `Using specific sub-lanes improves parallelization.\n` +
+            `Run: pnpm wu:infer-lane --id WU-XXX to verify`);
+    }
+    return (`Lane inference suggests: "${suggestedLane}" (${confidenceStr} confidence)\n` +
+        `Consider using the inferred lane for better lane distribution.\n` +
+        `Run: pnpm wu:infer-lane --id WU-XXX to verify`);
+}
+/**
+ * Check if lane validation should show a suggestion
+ *
+ * @param {string} providedLane - Lane provided by the user
+ * @param {string[]} codePaths - Code paths from WU
+ * @param {string} description - WU description
+ * @param {Function} inferSubLane - Lane inference function
+ * @returns {{ shouldWarn: boolean, warning: string }} Validation result
+ */
+export function validateLaneWithInference(providedLane, codePaths, description, inferSubLane) {
+    // Skip inference if no code paths provided
+    if (!codePaths || codePaths.length === 0) {
+        return { shouldWarn: false, warning: '' };
+    }
+    try {
+        const { lane: inferredLane, confidence } = inferSubLane(codePaths, description);
+        const warning = generateLaneMismatchWarning(providedLane, inferredLane, confidence);
+        return {
+            shouldWarn: warning.length > 0,
+            warning,
+            inferredLane,
+            confidence,
+        };
+    }
+    catch {
+        // Inference failed, don't block creation
+        return { shouldWarn: false, warning: '' };
+    }
+}
+/**
+ * WU-1062: Validate spec_refs paths
+ *
+ * Accepts:
+ * - Repo-relative paths: docs/04-operations/plans/WU-XXX-plan.md
+ * - External paths: lumenflow://plans/WU-XXX-plan.md
+ * - Tilde paths: ~/.lumenflow/plans/WU-XXX-plan.md
+ * - Env var paths: $LUMENFLOW_HOME/plans/WU-XXX-plan.md
+ *
+ * @param {string[]} specRefs - Array of spec reference paths
+ * @returns {{ valid: boolean, errors: string[], warnings: string[] }} Validation result
+ */
+export function validateSpecRefs(specRefs) {
+    const errors = [];
+    const warnings = [];
+    if (!specRefs || specRefs.length === 0) {
+        return { valid: true, errors, warnings };
+    }
+    for (const ref of specRefs) {
+        // Check for empty refs
+        if (!ref || ref.trim().length === 0) {
+            errors.push('Empty spec_ref detected');
+            continue;
+        }
+        // WU-1069: Reject repo-internal paths (paths starting with ./ or .lumenflow/)
+        // This prevents agents from storing plans inside the repository
+        if (isRepoInternalPath(ref)) {
+            errors.push(buildRepoInternalPathError(ref));
+            continue;
+        }
+        // External paths are valid (will be resolved at runtime)
+        if (isExternalPath(ref)) {
+            // Add informational warning about external paths
+            warnings.push(`External spec_ref: "${ref}" - ensure plan exists at ${normalizeSpecRef(ref)}`);
+            continue;
+        }
+        // Repo-relative paths should follow conventions (docs/ without ./ prefix)
+        const isValidRepoPath = ref.startsWith('docs/') || ref.endsWith('.md');
+        if (!isValidRepoPath) {
+            warnings.push(`Unconventional spec_ref path: "${ref}" - consider using docs/04-operations/plans/ or lumenflow://plans/`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * WU-1062: Check if spec_refs contains external paths
+ *
+ * @param {string[]} specRefs - Array of spec reference paths
+ * @returns {boolean} True if UnsafeAny spec_ref is an external path
+ */
+export function hasExternalSpecRefs(specRefs) {
+    if (!specRefs || specRefs.length === 0) {
+        return false;
+    }
+    return specRefs.some((ref) => isExternalPath(ref));
+}
+/**
+ * WU-1429: Check if spec_refs is non-empty
+ *
+ * @param {string[]|undefined} specRefs - Array of spec reference paths
+ * @returns {boolean} True if spec_refs contains at least one entry
+ */
+export function hasSpecRefs(specRefs) {
+    return Array.isArray(specRefs) && specRefs.length > 0;
+}
+/**
+ * WU-1062: Normalize all spec_refs paths
+ *
+ * Expands external paths to absolute paths while keeping repo-relative paths unchanged.
+ *
+ * @param {string[]} specRefs - Array of spec reference paths
+ * @returns {string[]} Normalized paths
+ */
+export function normalizeSpecRefs(specRefs) {
+    if (!specRefs || specRefs.length === 0) {
+        return [];
+    }
+    return specRefs.map((ref) => normalizeSpecRef(ref));
+}
+//# sourceMappingURL=wu-create-validators.js.map

package/dist/wu-create-validators.js.map

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

package/dist/wu-delegation-cutover.d.ts

@@ -0,0 +1,5 @@
+/** True when stateDir is <repo>/.lumenflow/state */
+export declare function isCanonicalStateDir(stateDir: string): boolean;
+/** Run delegation cutover migration if needed. */
+export declare function runDelegationCutoverIfNeeded(baseDir: string, eventsFilePath: string): Promise<void>;
+//# sourceMappingURL=wu-delegation-cutover.d.ts.map

package/dist/wu-delegation-cutover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-delegation-cutover.d.ts","sourceRoot":"","sources":["../src/wu-delegation-cutover.ts"],"names":[],"mappings":"AAuDA,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK7D;AA0KD,kDAAkD;AAClD,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/wu-delegation-cutover.js

@@ -0,0 +1,231 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Delegation Cutover (WU-2013, WU-1674)
+ *
+ * One-time migration from spawn-era to delegation-era state files.
+ * Archives legacy state and rebuilds wu-events.jsonl from WU YAML specs.
+ *
+ * @see {@link ./wu-event-sourcer.ts} - Calls this during first load
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, readdirSync, statSync, renameSync, unlinkSync, } from 'node:fs';
+import path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { validateWUEvent, WU_EVENT_TYPE } from './wu-state-schema.js';
+import { LUMENFLOW_PATHS, PATTERNS, WU_STATUS } from './wu-constants.js';
+const CUTOVER = Object.freeze({
+    MARKER_FILE: '.delegation-cutover-done',
+    ARCHIVE_DIR: 'archive',
+    ARCHIVE_PREFIX: 'delegation-cutover-',
+    LEGACY_REGISTRY_FILE: 'spawn-registry.jsonl',
+    DELEGATION_REGISTRY_FILE: 'delegation-registry.jsonl',
+    LEGACY_EVENT_TYPE: 'spawn',
+    DONE_STAMP_SUFFIX: '.done',
+    WU_FILE_PREFIX: 'WU-',
+});
+const WU_DOCS_SEGMENTS = ['docs', '04-operations', 'tasks', 'wu'];
+const STAMP_SEGMENTS = [LUMENFLOW_PATHS.BASE, 'stamps'];
+const BLOCKED_REASON = 'Bootstrapped from WU YAML (original reason unknown)';
+/** True when stateDir is <repo>/.lumenflow/state */
+export function isCanonicalStateDir(stateDir) {
+    return (path.basename(stateDir) === path.basename(LUMENFLOW_PATHS.STATE_DIR) &&
+        path.basename(path.dirname(stateDir)) === LUMENFLOW_PATHS.BASE);
+}
+function sanitizeTimestamp(ts) {
+    return ts.replace(/[:.]/g, '-');
+}
+function toIsoTimestamp(raw, fallback) {
+    const candidate = raw ?? fallback;
+    if (!candidate)
+        return new Date().toISOString();
+    const parsed = new Date(candidate);
+    return Number.isNaN(parsed.getTime()) ? new Date().toISOString() : parsed.toISOString();
+}
+function readLegacyEventTypes(eventPath) {
+    const types = new Set();
+    if (!existsSync(eventPath))
+        return types;
+    for (const rawLine of readFileSync(eventPath, 'utf-8').split('\n')) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        try {
+            const p = JSON.parse(line);
+            if (typeof p.type === 'string')
+                types.add(p.type);
+        }
+        catch {
+            types.add(CUTOVER.LEGACY_EVENT_TYPE);
+            break;
+        }
+    }
+    return types;
+}
+function isLegacyCutoverRequired(stateDir, eventsPath) {
+    if (existsSync(path.join(stateDir, CUTOVER.LEGACY_REGISTRY_FILE)))
+        return true;
+    return readLegacyEventTypes(eventsPath).has(CUTOVER.LEGACY_EVENT_TYPE);
+}
+function resolveProjectRoot(stateDir) {
+    let current = stateDir;
+    for (let depth = 0; depth < 6; depth++) {
+        if (existsSync(path.join(current, ...WU_DOCS_SEGMENTS)))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    if (isCanonicalStateDir(stateDir))
+        return path.dirname(path.dirname(stateDir));
+    return path.dirname(stateDir);
+}
+function moveFileToArchive(src, dest) {
+    if (!existsSync(src))
+        return;
+    mkdirSync(path.dirname(dest), { recursive: true });
+    try {
+        renameSync(src, dest);
+    }
+    catch (e) {
+        if (e.code === 'EXDEV') {
+            copyFileSync(src, dest);
+            unlinkSync(src);
+            return;
+        }
+        throw e;
+    }
+}
+function loadWuBootstrapInfo(filePath) {
+    try {
+        const p = parseYaml(readFileSync(filePath, 'utf-8'));
+        if (!p || typeof p !== 'object')
+            return null;
+        const id = typeof p.id === 'string' ? p.id : undefined;
+        if (!id || !PATTERNS.WU_ID.test(id))
+            return null;
+        const str = (k) => (typeof p[k] === 'string' ? p[k] : undefined);
+        return {
+            id,
+            status: str('status') ?? WU_STATUS.READY,
+            lane: str('lane') ?? 'Unknown',
+            title: str('title') ?? 'Untitled',
+            created: str('created'),
+            claimed_at: str('claimed_at'),
+            completed_at: str('completed_at'),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function readBootstrapWUs(projectRoot) {
+    const wuDir = path.join(projectRoot, ...WU_DOCS_SEGMENTS);
+    if (!existsSync(wuDir))
+        return [];
+    const results = [];
+    for (const entry of readdirSync(wuDir, { withFileTypes: true })) {
+        if (!entry.isFile() ||
+            !entry.name.startsWith(CUTOVER.WU_FILE_PREFIX) ||
+            !entry.name.endsWith('.yaml'))
+            continue;
+        const info = loadWuBootstrapInfo(path.join(wuDir, entry.name));
+        if (info)
+            results.push(info);
+    }
+    return results;
+}
+function readDoneStampTimes(projectRoot) {
+    const stampDir = path.join(projectRoot, ...STAMP_SEGMENTS);
+    const stamps = new Map();
+    if (!existsSync(stampDir))
+        return stamps;
+    for (const entry of readdirSync(stampDir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith(CUTOVER.DONE_STAMP_SUFFIX))
+            continue;
+        const wuId = entry.name.slice(0, -CUTOVER.DONE_STAMP_SUFFIX.length);
+        if (!PATTERNS.WU_ID.test(wuId))
+            continue;
+        try {
+            stamps.set(wuId, statSync(path.join(stampDir, entry.name)).mtime.toISOString());
+        }
+        catch {
+            /* ignore unreadable stamps */
+        }
+    }
+    return stamps;
+}
+function buildBootstrapEvents(wus, doneStampTimes) {
+    const events = [];
+    for (const wu of wus) {
+        const st = wu.status.toLowerCase();
+        const stampAt = doneStampTimes.get(wu.id);
+        const isDone = st === WU_STATUS.DONE || st === WU_STATUS.COMPLETED || stampAt !== undefined;
+        const isReadyLike = st === WU_STATUS.READY || st === WU_STATUS.BACKLOG || st === WU_STATUS.TODO;
+        if (isReadyLike && !isDone)
+            continue;
+        const claimTs = toIsoTimestamp(wu.claimed_at, wu.created ?? stampAt);
+        events.push({
+            type: WU_EVENT_TYPE.CLAIM,
+            wuId: wu.id,
+            lane: wu.lane,
+            title: wu.title,
+            timestamp: claimTs,
+        });
+        if (st === WU_STATUS.BLOCKED && !isDone) {
+            const blockedAt = new Date(claimTs);
+            blockedAt.setSeconds(blockedAt.getSeconds() + 1);
+            events.push({
+                type: WU_EVENT_TYPE.BLOCK,
+                wuId: wu.id,
+                reason: BLOCKED_REASON,
+                timestamp: blockedAt.toISOString(),
+            });
+            continue;
+        }
+        if (isDone) {
+            events.push({
+                type: WU_EVENT_TYPE.COMPLETE,
+                wuId: wu.id,
+                timestamp: toIsoTimestamp(wu.completed_at, stampAt ?? claimTs),
+            });
+        }
+    }
+    return events.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+}
+function writeBootstrappedEvents(eventsPath, events) {
+    mkdirSync(path.dirname(eventsPath), { recursive: true });
+    const lines = events.map((e) => {
+        const v = validateWUEvent(e);
+        if (!v.success)
+            throw new Error('Generated bootstrap event failed validation');
+        return JSON.stringify(v.data);
+    });
+    writeFileSync(eventsPath, lines.length > 0 ? `${lines.join('\n')}\n` : '', 'utf-8');
+}
+/** Run delegation cutover migration if needed. */
+export async function runDelegationCutoverIfNeeded(baseDir, eventsFilePath) {
+    if (!isCanonicalStateDir(baseDir))
+        return;
+    const markerPath = path.join(baseDir, CUTOVER.MARKER_FILE);
+    if (existsSync(markerPath))
+        return;
+    if (!isLegacyCutoverRequired(baseDir, eventsFilePath))
+        return;
+    const archiveDir = path.join(baseDir, CUTOVER.ARCHIVE_DIR, `${CUTOVER.ARCHIVE_PREFIX}${sanitizeTimestamp(new Date().toISOString())}`);
+    mkdirSync(archiveDir, { recursive: true });
+    moveFileToArchive(eventsFilePath, path.join(archiveDir, path.basename(eventsFilePath)));
+    moveFileToArchive(path.join(baseDir, CUTOVER.LEGACY_REGISTRY_FILE), path.join(archiveDir, CUTOVER.LEGACY_REGISTRY_FILE));
+    const projectRoot = resolveProjectRoot(baseDir);
+    const bootstrapEvents = buildBootstrapEvents(readBootstrapWUs(projectRoot), readDoneStampTimes(projectRoot));
+    writeBootstrappedEvents(eventsFilePath, bootstrapEvents);
+    const delegationReg = path.join(baseDir, CUTOVER.DELEGATION_REGISTRY_FILE);
+    if (!existsSync(delegationReg))
+        writeFileSync(delegationReg, '', 'utf-8');
+    writeFileSync(markerPath, `${JSON.stringify({
+        migratedAt: new Date().toISOString(),
+        archiveDir,
+        bootstrapEvents: bootstrapEvents.length,
+    }, null, 2)}\n`, 'utf-8');
+}
+//# sourceMappingURL=wu-delegation-cutover.js.map

package/dist/wu-delegation-cutover.js.map

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

package/dist/wu-doc-types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * WU Document Type Definitions (WU-2044)
+ *
+ * Canonical type for parsed WU YAML documents. Previously independently
+ * defined in 7+ files (spawn-agent-guidance.ts, wu-done-paths.ts,
+ * code-path-validator.ts, lane-checker.ts, wu-repair-core.ts,
+ * wu-status-transition.ts, wu-transaction-collectors.ts).
+ *
+ * This module defines a base type covering the superset of fields
+ * needed across consumers. Files needing only a subset can use
+ * Pick<WUDocBase, 'field1' | 'field2'>.
+ *
+ * @module wu-doc-types
+ */
+/**
+ * Base WU document interface representing a parsed WU YAML file.
+ *
+ * All fields are optional since they may not be present depending
+ * on the WU's lifecycle stage or type.
+ */
+export interface WUDocBase extends Record<string, unknown> {
+    id?: string;
+    title?: string;
+    lane?: string;
+    type?: string;
+    status?: string;
+    description?: string;
+    acceptance?: string[];
+    code_paths?: string[];
+    spec_refs?: string[];
+    notes?: string;
+    risks?: string[];
+    initiative?: string;
+    worktree_path?: string;
+    claimed_mode?: string;
+    claimed_branch?: string;
+    claimed_at?: string;
+    locked?: boolean;
+    created?: unknown;
+    completed?: unknown;
+    completed_at?: string;
+    tests?: {
+        manual?: string[];
+        unit?: string[];
+        e2e?: string[];
+    };
+}
+//# sourceMappingURL=wu-doc-types.d.ts.map

package/dist/wu-doc-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-doc-types.d.ts","sourceRoot":"","sources":["../src/wu-doc-types.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CACH"}

package/dist/wu-doc-types.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+export {};
+//# sourceMappingURL=wu-doc-types.js.map

package/dist/wu-doc-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-doc-types.js","sourceRoot":"","sources":["../src/wu-doc-types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC"}