@lumenflow/core 3.1.3 → 3.2.1

package/dist/state-cleanup-core.js.map

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

package/dist/state-doctor-core.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Issue type constants
+ */
+export declare const ISSUE_TYPES: {
+    /** WU has done status but no stamp file */
+    readonly ORPHANED_WU: "orphaned_wu";
+    /** Signal references a WU that doesn't exist */
+    readonly DANGLING_SIGNAL: "dangling_signal";
+    /** Event references a WU that doesn't exist */
+    readonly BROKEN_EVENT: "broken_event";
+    /** WU YAML status differs from state store derived status (WU-1420) */
+    readonly STATUS_MISMATCH: "status_mismatch";
+};
+/**
+ * Issue severity levels
+ */
+export declare const ISSUE_SEVERITY: {
+    /** Critical issues that may cause data loss */
+    readonly ERROR: "error";
+    /** Issues that should be fixed but aren't blocking */
+    readonly WARNING: "warning";
+    /** Informational findings */
+    readonly INFO: "info";
+};
+/**
+ * Issue type (union)
+ */
+export type IssueType = (typeof ISSUE_TYPES)[keyof typeof ISSUE_TYPES];
+/**
+ * Issue severity (union)
+ */
+export type IssueSeverity = (typeof ISSUE_SEVERITY)[keyof typeof ISSUE_SEVERITY];
+/**
+ * Mock WU YAML content
+ */
+export interface MockWU {
+    id: string;
+    status: string;
+    lane?: string;
+    title?: string;
+}
+/**
+ * Mock signal content
+ */
+export interface MockSignal {
+    id: string;
+    wuId?: string;
+    timestamp?: string;
+    message?: string;
+}
+/**
+ * Mock event content
+ */
+export interface MockEvent {
+    wuId: string;
+    type: string;
+    timestamp?: string;
+    lane?: string;
+    title?: string;
+    reason?: string;
+}
+/**
+ * Event to emit for fixing status mismatches (WU-1420)
+ */
+export interface EmitEventPayload {
+    wuId: string;
+    type: 'release' | 'complete';
+    reason?: string;
+    timestamp?: string;
+}
+/**
+ * Status mismatch details for fixing (WU-1420)
+ */
+export interface StatusMismatchDetails {
+    yamlStatus: string;
+    derivedStatus: string;
+}
+/**
+ * Dependencies for state doctor (injectable for testing)
+ */
+export interface StateDoctorDeps {
+    /** List all WU YAML files */
+    listWUs: () => Promise<MockWU[]>;
+    /** List all stamp file IDs */
+    listStamps: () => Promise<string[]>;
+    /** List all signals */
+    listSignals: () => Promise<MockSignal[]>;
+    /** List all events */
+    listEvents: () => Promise<MockEvent[]>;
+    /** Remove a signal by ID (for --fix) */
+    removeSignal?: (id: string) => Promise<void>;
+    /** Remove events for a WU (for --fix) */
+    removeEvent?: (wuId: string) => Promise<void>;
+    /** Create a stamp for a WU (for --fix) */
+    createStamp?: (wuId: string, title: string) => Promise<void>;
+    /** Emit an event to fix status mismatch (WU-1420) */
+    emitEvent?: (event: EmitEventPayload) => Promise<void>;
+}
+/**
+ * A detected issue in the state
+ */
+export interface DiagnosisIssue {
+    /** Type of issue */
+    type: IssueType;
+    /** Severity level */
+    severity: IssueSeverity;
+    /** WU ID involved (if applicable) */
+    wuId?: string;
+    /** Signal ID involved (if applicable) */
+    signalId?: string;
+    /** Human-readable description */
+    description: string;
+    /** Suggested fix */
+    suggestion: string;
+    /** Whether this issue can be auto-fixed */
+    canAutoFix: boolean;
+    /** Status mismatch details for fixing (WU-1420) */
+    statusMismatch?: StatusMismatchDetails;
+}
+/**
+ * A fix error that occurred during auto-repair
+ */
+export interface FixError {
+    /** Type of issue that failed to fix */
+    type: IssueType;
+    /** WU ID involved (if applicable) */
+    wuId?: string;
+    /** Signal ID involved (if applicable) */
+    signalId?: string;
+    /** Error message */
+    error: string;
+}
+/**
+ * Summary statistics
+ */
+export interface DiagnosisSummary {
+    /** Number of orphaned WUs */
+    orphanedWUs: number;
+    /** Number of dangling signals */
+    danglingSignals: number;
+    /** Number of broken events */
+    brokenEvents: number;
+    /** Number of status mismatches (WU-1420) */
+    statusMismatches: number;
+    /** Total number of issues */
+    totalIssues: number;
+}
+/**
+ * Options for diagnosis
+ */
+export interface DiagnosisOptions {
+    /** Whether to attempt auto-fixes */
+    fix?: boolean;
+    /** Dry-run mode (report what would be fixed) */
+    dryRun?: boolean;
+}
+/**
+ * Result of state diagnosis
+ */
+export interface StateDiagnosis {
+    /** Whether the state is healthy */
+    healthy: boolean;
+    /** List of detected issues */
+    issues: DiagnosisIssue[];
+    /** Summary statistics */
+    summary: DiagnosisSummary;
+    /** Issues that were fixed */
+    fixed: DiagnosisIssue[];
+    /** Errors that occurred during fixing */
+    fixErrors: FixError[];
+    /** Whether this was a dry-run */
+    dryRun?: boolean;
+    /** Issues that would be fixed (in dry-run mode) */
+    wouldFix?: DiagnosisIssue[];
+}
+export declare function diagnoseState(_baseDir: string, deps: StateDoctorDeps, options?: DiagnosisOptions): Promise<StateDiagnosis>;
+//# sourceMappingURL=state-doctor-core.d.ts.map

package/dist/state-doctor-core.d.ts.map

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

package/dist/state-doctor-core.js

@@ -0,0 +1,420 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * State Doctor Core (WU-1209, WU-1420)
+ *
+ * Integrity checker for LumenFlow state that detects:
+ * - Orphaned WUs (done status but no stamp)
+ * - Dangling signals (reference non-existent WUs)
+ * - Broken memory relationships (events for missing WU specs)
+ * - Status mismatches between WU YAML and state store (WU-1420)
+ *
+ * Inspired by Beads bd doctor command.
+ *
+ * Design principles:
+ * - Non-destructive by default (read-only diagnosis)
+ * - --fix flag for safe auto-repair of resolvable issues
+ * - Dependency injection for testability
+ * - Human-readable output with actionable suggestions
+ *
+ * @see {@link packages/@lumenflow/cli/src/state-doctor.ts} - CLI wrapper
+ * @see {@link packages/@lumenflow/core/src/__tests__/state-doctor-core.test.ts} - Tests
+ */
+import { WU_STATUS } from './wu-constants.js';
+/**
+ * Issue type constants
+ */
+export const ISSUE_TYPES = {
+    /** WU has done status but no stamp file */
+    ORPHANED_WU: 'orphaned_wu',
+    /** Signal references a WU that doesn't exist */
+    DANGLING_SIGNAL: 'dangling_signal',
+    /** Event references a WU that doesn't exist */
+    BROKEN_EVENT: 'broken_event',
+    /** WU YAML status differs from state store derived status (WU-1420) */
+    STATUS_MISMATCH: 'status_mismatch',
+};
+/**
+ * Issue severity levels
+ */
+export const ISSUE_SEVERITY = {
+    /** Critical issues that may cause data loss */
+    ERROR: 'error',
+    /** Issues that should be fixed but aren't blocking */
+    WARNING: 'warning',
+    /** Informational findings */
+    INFO: 'info',
+};
+/**
+ * Statuses representable by wu-events transitions.
+ *
+ * WU YAML supports additional metadata statuses (e.g. superseded) that do not
+ * have event transitions in the state store. Those statuses are intentionally
+ * excluded from mismatch comparisons to avoid false positives.
+ */
+const EVENT_REPRESENTABLE_STATUSES = new Set([
+    WU_STATUS.READY,
+    WU_STATUS.IN_PROGRESS,
+    WU_STATUS.BLOCKED,
+    WU_STATUS.DONE,
+]);
+const STATUS_MISMATCH_SUGGESTION = {
+    AUTO_FIX: 'Emit corrective event using: pnpm state:doctor --fix',
+    MANUAL_FIX: 'Manual reconciliation required: state transition is not representable via corrective events',
+};
+/**
+ * Derive WU status from events (WU-1420)
+ *
+ * Replays events to determine the current derived status:
+ * - claim/create -> in_progress
+ * - release -> ready
+ * - complete -> done
+ * - block -> blocked
+ * - unblock -> in_progress
+ *
+ * @param events - All events for this WU
+ * @returns Derived status or undefined if no events
+ */
+function deriveStatusFromEvents(events) {
+    if (events.length === 0) {
+        return undefined;
+    }
+    let status = undefined;
+    for (const event of events) {
+        switch (event.type) {
+            case 'claim':
+            case 'create':
+                status = WU_STATUS.IN_PROGRESS;
+                break;
+            case 'release':
+                status = WU_STATUS.READY;
+                break;
+            case 'complete':
+                status = WU_STATUS.DONE;
+                break;
+            case 'block':
+                status = WU_STATUS.BLOCKED;
+                break;
+            case 'unblock':
+                status = WU_STATUS.IN_PROGRESS;
+                break;
+            // checkpoint doesn't change status
+        }
+    }
+    return status;
+}
+/**
+ * Detect status mismatches between WU YAML and state store (WU-1420)
+ *
+ * Compares the status field in WU YAML against the derived status from events.
+ * Only reports issues for WUs that have events in the state store.
+ */
+function detectStatusMismatches(wus, events) {
+    const issues = [];
+    // Group events by WU ID
+    const eventsByWu = new Map();
+    for (const event of events) {
+        const existing = eventsByWu.get(event.wuId) || [];
+        existing.push(event);
+        eventsByWu.set(event.wuId, existing);
+    }
+    for (const wu of wus) {
+        if (!EVENT_REPRESENTABLE_STATUSES.has(wu.status)) {
+            // YAML-only lifecycle states (e.g. superseded) are not representable in
+            // wu-events; skip mismatch detection to avoid false positives.
+            continue;
+        }
+        const wuEvents = eventsByWu.get(wu.id);
+        if (!wuEvents || wuEvents.length === 0) {
+            // No events for this WU - nothing to compare
+            continue;
+        }
+        const derivedStatus = deriveStatusFromEvents(wuEvents);
+        if (derivedStatus && derivedStatus !== wu.status) {
+            const eventType = getCorrectiveEventType(wu.status, derivedStatus);
+            issues.push({
+                type: ISSUE_TYPES.STATUS_MISMATCH,
+                severity: ISSUE_SEVERITY.WARNING,
+                wuId: wu.id,
+                description: `WU ${wu.id} YAML status is '${wu.status}' but state store says '${derivedStatus}'`,
+                suggestion: eventType
+                    ? STATUS_MISMATCH_SUGGESTION.AUTO_FIX
+                    : STATUS_MISMATCH_SUGGESTION.MANUAL_FIX,
+                canAutoFix: eventType !== null,
+                statusMismatch: {
+                    yamlStatus: wu.status,
+                    derivedStatus,
+                },
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Detect orphaned WUs (done status but no stamp)
+ */
+function detectOrphanedWUs(wus, stamps) {
+    const issues = [];
+    for (const wu of wus) {
+        if (wu.status === WU_STATUS.DONE && !stamps.has(wu.id)) {
+            issues.push({
+                type: ISSUE_TYPES.ORPHANED_WU,
+                severity: ISSUE_SEVERITY.WARNING,
+                wuId: wu.id,
+                description: `WU ${wu.id} has status '${WU_STATUS.DONE}' but no stamp file exists`,
+                suggestion: `Create stamp file for ${wu.id} using: pnpm state:doctor --fix`,
+                canAutoFix: true,
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Detect dangling signals (reference non-existent WUs)
+ */
+function detectDanglingSignals(signals, wuIds) {
+    const issues = [];
+    for (const signal of signals) {
+        // Skip signals without WU references
+        if (!signal.wuId) {
+            continue;
+        }
+        if (!wuIds.has(signal.wuId)) {
+            issues.push({
+                type: ISSUE_TYPES.DANGLING_SIGNAL,
+                severity: ISSUE_SEVERITY.WARNING,
+                wuId: signal.wuId,
+                signalId: signal.id,
+                description: `Signal ${signal.id} references non-existent WU ${signal.wuId}`,
+                suggestion: `Remove dangling signal using: pnpm state:doctor --fix`,
+                canAutoFix: true,
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Detect broken events (reference non-existent WUs)
+ */
+function detectBrokenEvents(events, wuIds) {
+    const issues = [];
+    const seenWuIds = new Set();
+    for (const event of events) {
+        // Only report once per WU
+        if (seenWuIds.has(event.wuId)) {
+            continue;
+        }
+        if (!wuIds.has(event.wuId)) {
+            seenWuIds.add(event.wuId);
+            issues.push({
+                type: ISSUE_TYPES.BROKEN_EVENT,
+                severity: ISSUE_SEVERITY.WARNING,
+                wuId: event.wuId,
+                description: `Events exist for non-existent WU ${event.wuId}`,
+                suggestion: `Archive or remove events for missing WU using: pnpm state:doctor --fix`,
+                canAutoFix: true,
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Calculate summary statistics from issues
+ */
+function calculateSummary(issues) {
+    let orphanedWUs = 0;
+    let danglingSignals = 0;
+    let brokenEvents = 0;
+    let statusMismatches = 0;
+    for (const issue of issues) {
+        switch (issue.type) {
+            case ISSUE_TYPES.ORPHANED_WU:
+                orphanedWUs++;
+                break;
+            case ISSUE_TYPES.DANGLING_SIGNAL:
+                danglingSignals++;
+                break;
+            case ISSUE_TYPES.BROKEN_EVENT:
+                brokenEvents++;
+                break;
+            case ISSUE_TYPES.STATUS_MISMATCH:
+                statusMismatches++;
+                break;
+        }
+    }
+    return {
+        orphanedWUs,
+        danglingSignals,
+        brokenEvents,
+        statusMismatches,
+        totalIssues: issues.length,
+    };
+}
+/**
+ * Determine the corrective event type for a status mismatch (WU-1420)
+ *
+ * When YAML says X but state says Y, emit event to transition state to X:
+ * - YAML=ready, state=in_progress -> emit release
+ * - YAML=done, state=in_progress -> emit complete
+ * - YAML=in_progress, state=ready -> cannot fix (would need claim with lane/title)
+ * - YAML=in_progress, state=done -> cannot fix (cannot un-complete)
+ */
+function getCorrectiveEventType(yamlStatus, derivedStatus) {
+    // Transition from in_progress to ready: emit release
+    if (yamlStatus === WU_STATUS.READY && derivedStatus === WU_STATUS.IN_PROGRESS) {
+        return 'release';
+    }
+    // Transition from in_progress to done: emit complete
+    if (yamlStatus === WU_STATUS.DONE && derivedStatus === WU_STATUS.IN_PROGRESS) {
+        return 'complete';
+    }
+    // Other transitions are not auto-fixable by emitting events
+    // - ready -> in_progress would need claim (requires lane/title context)
+    // - done -> in_progress would need to revert complete (not supported)
+    return null;
+}
+/**
+ * Attempt to fix an issue
+ */
+async function fixIssue(issue, deps, wus) {
+    try {
+        switch (issue.type) {
+            case ISSUE_TYPES.DANGLING_SIGNAL:
+                if (deps.removeSignal && issue.signalId) {
+                    await deps.removeSignal(issue.signalId);
+                    return { fixed: true };
+                }
+                return { fixed: false, error: 'No removeSignal function provided' };
+            case ISSUE_TYPES.BROKEN_EVENT:
+                if (deps.removeEvent && issue.wuId) {
+                    await deps.removeEvent(issue.wuId);
+                    return { fixed: true };
+                }
+                return { fixed: false, error: 'No removeEvent function provided' };
+            case ISSUE_TYPES.ORPHANED_WU:
+                if (deps.createStamp && issue.wuId) {
+                    const wu = wus.find((w) => w.id === issue.wuId);
+                    await deps.createStamp(issue.wuId, wu?.title || `WU ${issue.wuId}`);
+                    return { fixed: true };
+                }
+                return { fixed: false, error: 'No createStamp function provided' };
+            case ISSUE_TYPES.STATUS_MISMATCH: {
+                if (!deps.emitEvent) {
+                    return { fixed: false, error: 'No emitEvent function provided' };
+                }
+                if (!issue.wuId || !issue.statusMismatch) {
+                    return { fixed: false, error: 'Missing WU ID or status mismatch details' };
+                }
+                const { yamlStatus, derivedStatus } = issue.statusMismatch;
+                const eventType = getCorrectiveEventType(yamlStatus, derivedStatus);
+                if (!eventType) {
+                    return {
+                        fixed: false,
+                        error: `Cannot auto-fix: transition from '${derivedStatus}' to '${yamlStatus}' requires manual intervention`,
+                    };
+                }
+                await deps.emitEvent({
+                    wuId: issue.wuId,
+                    type: eventType,
+                    reason: `state:doctor --fix: reconciling state store with YAML status '${yamlStatus}'`,
+                    timestamp: new Date().toISOString(),
+                });
+                return { fixed: true };
+            }
+            default:
+                return { fixed: false, error: `Unknown issue type: ${issue.type}` };
+        }
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        return { fixed: false, error };
+    }
+}
+/**
+ * Diagnose state integrity issues.
+ *
+ * Detects:
+ * - Orphaned WUs (done status but no stamp)
+ * - Dangling signals (reference non-existent WUs)
+ * - Broken events (events for missing WU specs)
+ *
+ * @param baseDir - Project base directory
+ * @param deps - Dependency functions for reading/writing state
+ * @param options - Diagnosis options
+ * @returns Diagnosis result with issues and optional fixes
+ *
+ * @example
+ * // Diagnose without fixing
+ * const result = await diagnoseState(baseDir, deps);
+ *
+ * @example
+ * // Diagnose and fix
+ * const result = await diagnoseState(baseDir, deps, { fix: true });
+ *
+ * @example
+ * // Dry-run (report what would be fixed)
+ * const result = await diagnoseState(baseDir, deps, { fix: true, dryRun: true });
+ */
+/**
+ * Apply fixes to auto-fixable issues
+ */
+async function applyFixes(issues, deps, wus, result) {
+    const fixableIssues = issues.filter((i) => i.canAutoFix);
+    for (const issue of fixableIssues) {
+        const fixResult = await fixIssue(issue, deps, wus);
+        if (fixResult.fixed) {
+            result.fixed.push(issue);
+        }
+        else if (fixResult.error) {
+            result.fixErrors.push({
+                type: issue.type,
+                wuId: issue.wuId,
+                signalId: issue.signalId,
+                error: fixResult.error,
+            });
+        }
+    }
+}
+export async function diagnoseState(_baseDir, deps, options = {}) {
+    const { fix = false, dryRun = false } = options;
+    // Gather state data
+    const [wus, stamps, signals, events] = await Promise.all([
+        deps.listWUs(),
+        deps.listStamps(),
+        deps.listSignals(),
+        deps.listEvents(),
+    ]);
+    // Build lookup sets
+    const wuIds = new Set(wus.map((wu) => wu.id));
+    const stampIds = new Set(stamps);
+    // Detect issues
+    const orphanedWUissues = detectOrphanedWUs(wus, stampIds);
+    const danglingSignalIssues = detectDanglingSignals(signals, wuIds);
+    const brokenEventIssues = detectBrokenEvents(events, wuIds);
+    const statusMismatchIssues = detectStatusMismatches(wus, events);
+    const issues = [
+        ...orphanedWUissues,
+        ...danglingSignalIssues,
+        ...brokenEventIssues,
+        ...statusMismatchIssues,
+    ];
+    const summary = calculateSummary(issues);
+    // Initialize result
+    const result = {
+        healthy: issues.length === 0,
+        issues,
+        summary,
+        fixed: [],
+        fixErrors: [],
+    };
+    // Handle fixing
+    if (fix && dryRun) {
+        result.dryRun = true;
+        result.wouldFix = issues.filter((i) => i.canAutoFix);
+    }
+    else if (fix) {
+        await applyFixes(issues, deps, wus, result);
+    }
+    return result;
+}
+//# sourceMappingURL=state-doctor-core.js.map

package/dist/state-doctor-core.js.map

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

package/dist/state-machine.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validates a state transition and throws if illegal
+ *
+ * @param {string|null|undefined} from - Current WU status
+ * @param {string|null|undefined} to - Desired WU status
+ * @param {string} wuid - Work Unit ID (e.g., 'WU-416') for error messages
+ * @throws {Error} If transition is illegal or states are invalid
+ */
+export declare function assertTransition(from: string | null | undefined, to: string | null | undefined, wuid: string): void;
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AA0CA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,QAkDb"}