@lumenflow/core 3.1.1 → 3.1.3

package/dist/state-doctor-core.js

@@ -1,395 +0,0 @@
-// 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',
-};
-/**
- * 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) {
-        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) {
-            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: `Emit corrective event using: pnpm state:doctor --fix`,
-                canAutoFix: true,
-                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

@@ -1 +0,0 @@
-{"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

@@ -1,10 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}

package/dist/state-machine.js

@@ -1,89 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * State Machine Validation Library
- *
- * Enforces canonical WU state transitions according to LumenFlow §2.4
- * Prevents illegal state changes (e.g., done → in_progress) and ensures workflow integrity.
- *
- * Canonical state machine:
- * - ready → in_progress (claim)
- * - in_progress → blocked (block)
- * - in_progress → waiting (implementation complete, awaiting sign-off)
- * - in_progress → done (direct completion)
- * - in_progress → ready (release - WU-1080: orphan recovery)
- * - blocked → in_progress (unblock)
- * - blocked → done (blocker resolved, direct completion)
- * - waiting → in_progress (changes requested)
- * - waiting → done (approved)
- * - done → (terminal, no transitions)
- */
-import { createError, ErrorCodes } from './error-handler.js';
-/**
- * Valid WU states as defined in LumenFlow §2.4
- */
-const VALID_STATES = new Set(['ready', 'in_progress', 'blocked', 'waiting', 'done']);
-/**
- * Transition table mapping each state to its allowed next states
- * Based on LumenFlow §2.4 Flow States & Lanes
- */
-const TRANSITIONS = {
-    ready: ['in_progress'],
-    in_progress: ['blocked', 'waiting', 'done', 'ready'], // WU-1080: 'ready' via release for orphan recovery
-    blocked: ['in_progress', 'done'],
-    waiting: ['in_progress', 'done'],
-    done: [], // Terminal state - no outgoing transitions
-};
-/**
- * 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 function assertTransition(from, to, wuid) {
-    // Validate states exist and are non-empty
-    if (from === null || from === undefined || from === '') {
-        throw createError(ErrorCodes.STATE_ERROR, `Invalid state: ${from}`, {
-            wuid,
-            from,
-            to,
-            reason: 'from state is null/undefined/empty',
-        });
-    }
-    if (to === null || to === undefined || to === '') {
-        throw createError(ErrorCodes.STATE_ERROR, `Invalid state: ${to}`, {
-            wuid,
-            from,
-            to,
-            reason: 'to state is null/undefined/empty',
-        });
-    }
-    // Validate states are recognized
-    if (!VALID_STATES.has(from)) {
-        throw createError(ErrorCodes.STATE_ERROR, `Invalid state: ${from}`, {
-            wuid,
-            from,
-            to,
-            validStates: Array.from(VALID_STATES),
-        });
-    }
-    if (!VALID_STATES.has(to)) {
-        throw createError(ErrorCodes.STATE_ERROR, `Invalid state: ${to}`, {
-            wuid,
-            from,
-            to,
-            validStates: Array.from(VALID_STATES),
-        });
-    }
-    // Check if transition is allowed
-    const fromState = from;
-    const toState = to;
-    const allowedNextStates = TRANSITIONS[fromState];
-    if (!allowedNextStates.includes(toState)) {
-        const terminalHint = from === 'done' ? ' (done is a terminal state)' : '';
-        throw createError(ErrorCodes.STATE_ERROR, `Illegal state transition for ${wuid}: ${from} → ${to}${terminalHint}`, { wuid, from, to, allowedNextStates });
-    }
-}
-//# sourceMappingURL=state-machine.js.map

package/dist/state-machine.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;GAEG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAGrF;;;GAGG;AACH,MAAM,WAAW,GAA+B;IAC9C,KAAK,EAAE,CAAC,aAAa,CAAC;IACtB,WAAW,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mDAAmD;IACzG,OAAO,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC;IAChC,IAAI,EAAE,EAAE,EAAE,2CAA2C;CACtD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAA+B,EAC/B,EAA6B,EAC7B,IAAY;IAEZ,0CAA0C;IAC1C,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACvD,MAAM,WAAW,CAAC,UAAU,CAAC,WAAW,EAAE,kBAAkB,IAAI,EAAE,EAAE;YAClE,IAAI;YACJ,IAAI;YACJ,EAAE;YACF,MAAM,EAAE,oCAAoC;SAC7C,CAAC,CAAC;IACL,CAAC;IACD,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,MAAM,WAAW,CAAC,UAAU,CAAC,WAAW,EAAE,kBAAkB,EAAE,EAAE,EAAE;YAChE,IAAI;YACJ,IAAI;YACJ,EAAE;YACF,MAAM,EAAE,kCAAkC;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,iCAAiC;IACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAe,CAAC,EAAE,CAAC;QACvC,MAAM,WAAW,CAAC,UAAU,CAAC,WAAW,EAAE,kBAAkB,IAAI,EAAE,EAAE;YAClE,IAAI;YACJ,IAAI;YACJ,EAAE;YACF,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAa,CAAC,EAAE,CAAC;QACrC,MAAM,WAAW,CAAC,UAAU,CAAC,WAAW,EAAE,kBAAkB,EAAE,EAAE,EAAE;YAChE,IAAI;YACJ,IAAI;YACJ,EAAE;YACF,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IAED,iCAAiC;IACjC,MAAM,SAAS,GAAG,IAAe,CAAC;IAClC,MAAM,OAAO,GAAG,EAAa,CAAC;IAC9B,MAAM,iBAAiB,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,WAAW,CACf,UAAU,CAAC,WAAW,EACtB,gCAAgC,IAAI,KAAK,IAAI,MAAM,EAAE,GAAG,YAAY,EAAE,EACtE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,iBAAiB,EAAE,CACtC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/stream-error-handler.d.ts

@@ -1,68 +0,0 @@
-/**
- * Stream Error Handler
- *
- * WU-1233: Centralized EPIPE protection for CLI commands.
- *
- * When CLI output is piped through head/tail, the pipe may close before
- * all output is written. Node.js throws EPIPE errors in this case.
- * This handler catches those errors and exits gracefully.
- *
- * Unix convention: Exit with code 0 on EPIPE (the consumer got what it needed).
- *
- * @example
- * ```typescript
- * import { StreamErrorHandler } from '@lumenflow/core';
- *
- * // In CLI entry point:
- * const handler = StreamErrorHandler.createWithDefaults();
- * handler.attach();
- * ```
- */
-import type { WriteStream } from 'node:tty';
-/**
- * Dependencies for StreamErrorHandler
- *
- * Uses dependency injection for testability.
- */
-export interface StreamErrorHandlerDeps {
-    /** Standard output stream */
-    stdout: WriteStream;
-    /** Standard error stream */
-    stderr: WriteStream;
-    /** Exit function (defaults to process.exit) */
-    exitFn: (code: number) => void;
-}
-/**
- * StreamErrorHandler
- *
- * Attaches error listeners to stdout/stderr to handle EPIPE errors gracefully.
- * Follows single responsibility principle - only handles stream errors.
- */
-export declare class StreamErrorHandler {
-    private readonly deps;
-    private attached;
-    private stdoutHandler;
-    private stderrHandler;
-    constructor(deps: StreamErrorHandlerDeps);
-    /**
-     * Create a handler with default dependencies (process.stdout, process.stderr, process.exit)
-     */
-    static createWithDefaults(): StreamErrorHandler;
-    /**
-     * Attach error listeners to stdout and stderr
-     *
-     * Safe to call multiple times - will not attach duplicate listeners.
-     */
-    attach(): void;
-    /**
-     * Detach error listeners from stdout and stderr
-     *
-     * Safe to call even if not attached.
-     */
-    detach(): void;
-    /**
-     * Create an error handler that catches EPIPE and exits gracefully
-     */
-    private createErrorHandler;
-}
-//# sourceMappingURL=stream-error-handler.d.ts.map

package/dist/stream-error-handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-error-handler.d.ts","sourceRoot":"","sources":["../src/stream-error-handler.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,4BAA4B;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,+CAA+C;IAC/C,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AASD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAiD;IACtE,OAAO,CAAC,aAAa,CAAiD;gBAE1D,IAAI,EAAE,sBAAsB;IAIxC;;OAEG;IACH,MAAM,CAAC,kBAAkB,IAAI,kBAAkB;IAQ/C;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAcd;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAkBd;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAW3B"}

package/dist/stream-error-handler.js

@@ -1,77 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-import { STREAM_ERRORS, EXIT_CODES } from './wu-constants.js';
-/**
- * StreamErrorHandler
- *
- * Attaches error listeners to stdout/stderr to handle EPIPE errors gracefully.
- * Follows single responsibility principle - only handles stream errors.
- */
-export class StreamErrorHandler {
-    deps;
-    attached = false;
-    stdoutHandler = null;
-    stderrHandler = null;
-    constructor(deps) {
-        this.deps = deps;
-    }
-    /**
-     * Create a handler with default dependencies (process.stdout, process.stderr, process.exit)
-     */
-    static createWithDefaults() {
-        return new StreamErrorHandler({
-            stdout: process.stdout,
-            stderr: process.stderr,
-            exitFn: (code) => process.exit(code),
-        });
-    }
-    /**
-     * Attach error listeners to stdout and stderr
-     *
-     * Safe to call multiple times - will not attach duplicate listeners.
-     */
-    attach() {
-        if (this.attached) {
-            return;
-        }
-        this.stdoutHandler = this.createErrorHandler();
-        this.stderrHandler = this.createErrorHandler();
-        this.deps.stdout.on('error', this.stdoutHandler);
-        this.deps.stderr.on('error', this.stderrHandler);
-        this.attached = true;
-    }
-    /**
-     * Detach error listeners from stdout and stderr
-     *
-     * Safe to call even if not attached.
-     */
-    detach() {
-        if (!this.attached) {
-            return;
-        }
-        if (this.stdoutHandler) {
-            this.deps.stdout.removeListener('error', this.stdoutHandler);
-            this.stdoutHandler = null;
-        }
-        if (this.stderrHandler) {
-            this.deps.stderr.removeListener('error', this.stderrHandler);
-            this.stderrHandler = null;
-        }
-        this.attached = false;
-    }
-    /**
-     * Create an error handler that catches EPIPE and exits gracefully
-     */
-    createErrorHandler() {
-        return (err) => {
-            // Only handle EPIPE errors
-            if (err.code === STREAM_ERRORS.EPIPE) {
-                // Exit gracefully with success code (Unix convention)
-                // The consumer of the pipe got what it needed
-                this.deps.exitFn(EXIT_CODES.SUCCESS);
-            }
-            // Non-EPIPE errors are not handled here - let them propagate
-        };
-    }
-}
-//# sourceMappingURL=stream-error-handler.js.map

package/dist/stream-error-handler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-error-handler.js","sourceRoot":"","sources":["../src/stream-error-handler.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAwBzC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAuB9D;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACZ,IAAI,CAAyB;IACtC,QAAQ,GAAG,KAAK,CAAC;IACjB,aAAa,GAA4C,IAAI,CAAC;IAC9D,aAAa,GAA4C,IAAI,CAAC;IAEtE,YAAY,IAA4B;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB;QACvB,OAAO,IAAI,kBAAkB,CAAC;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAqB;YACrC,MAAM,EAAE,OAAO,CAAC,MAAqB;YACrC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;SAC7C,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC/C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAE/C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAEjD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAC7D,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAC7D,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,kBAAkB;QACxB,OAAO,CAAC,GAAoB,EAAE,EAAE;YAC9B,2BAA2B;YAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,CAAC,KAAK,EAAE,CAAC;gBACrC,sDAAsD;gBACtD,8CAA8C;gBAC9C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;YACD,6DAA6D;QAC/D,CAAC,CAAC;IACJ,CAAC;CACF"}