@lumenflow/core 3.2.0 → 3.2.1

package/dist/wu-lint.js

@@ -0,0 +1,338 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Spec Linter (WU-2252)
+ *
+ * Validates WU specs against two critical rules:
+ * 1. Acceptance criteria cannot reference file paths absent from code_paths
+ * 2. Acceptance/code_paths cannot conflict with invariants.yml
+ *
+ * Shared phase-aware checks are delegated to wu-rules-engine.
+ */
+import { existsSync } from 'node:fs';
+import { minimatch } from 'minimatch';
+import { loadInvariants, INVARIANT_TYPES } from './invariants-runner.js';
+import { WU_STATUS } from './wu-constants.js';
+import { CLI_PACKAGE_JSON_PATH, REGISTRATION_SURFACES as RULE_REGISTRATION_SURFACES, RULE_CODES, normalizeValidationIssue, validateWURulesSync, } from './wu-rules-engine.js';
+/**
+ * Error type constants for WU spec linting
+ */
+export const WU_LINT_ERROR_TYPES = {
+    ACCEPTANCE_PATH_NOT_IN_CODE_PATHS: 'acceptance_path_not_in_code_paths',
+    CODE_PATH_CONFLICTS_INVARIANT: 'code_path_conflicts_invariant',
+    ACCEPTANCE_CONFLICTS_INVARIANT: 'acceptance_conflicts_invariant',
+    /** CLI registration parity surface missing */
+    REGISTRATION_PARITY_MISSING: 'registration_parity_missing',
+    /** Backward-compatible key for minimum test intent */
+    UNIT_TESTS_REQUIRED: 'unit_tests_required',
+    /** Canonical minimum test intent key */
+    MINIMUM_TEST_INTENT_REQUIRED: 'minimum_test_intent_required',
+};
+/**
+ * Registration surface paths required when CLI bin changes.
+ */
+export const REGISTRATION_SURFACES = {
+    PUBLIC_MANIFEST: RULE_REGISTRATION_SURFACES.PUBLIC_MANIFEST,
+    MCP_TOOLS: RULE_REGISTRATION_SURFACES.MCP_TOOLS,
+};
+/**
+ * Paths historically used to indicate CLI command surface changes.
+ * Kept exported for compatibility and docs/tests.
+ */
+export const CLI_COMMAND_PATTERNS = [CLI_PACKAGE_JSON_PATH];
+/**
+ * WU-1504: Patterns that exclude files from parity check trigger.
+ * Kept for backwards compatibility; parity is now reality-phase + diff-aware.
+ */
+const CLI_COMMAND_EXCLUDE_PATTERNS = [
+    '__tests__/',
+    '/lib/',
+    '/shared/',
+    '/commands/',
+    '/init.ts',
+    REGISTRATION_SURFACES.PUBLIC_MANIFEST,
+    REGISTRATION_SURFACES.MCP_TOOLS,
+];
+/**
+ * Regex to detect file paths in acceptance criteria text
+ */
+const FILE_PATH_PATTERN = /(?:^|[\s'"`])([a-zA-Z0-9_-]+\/[a-zA-Z0-9_./-]+\.[a-zA-Z0-9]+)/g;
+function extractFilePaths(text) {
+    const paths = [];
+    let match;
+    while ((match = FILE_PATH_PATTERN.exec(text)) !== null) {
+        paths.push(match[1]);
+    }
+    FILE_PATH_PATTERN.lastIndex = 0;
+    return paths;
+}
+/**
+ * Check if a file path matches UnsafeAny pattern in code_paths
+ */
+function pathMatchesCodePaths(filePath, codePaths) {
+    for (const pattern of codePaths) {
+        if (filePath === pattern) {
+            return true;
+        }
+        if (minimatch(filePath, pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Validate that acceptance criteria only reference paths in code_paths
+ */
+export function validateAcceptanceCodePaths(wu) {
+    const { id, acceptance = [], code_paths = [] } = wu;
+    const errors = [];
+    for (const criterion of acceptance) {
+        const referencedPaths = extractFilePaths(criterion);
+        for (const referencedPath of referencedPaths) {
+            if (!pathMatchesCodePaths(referencedPath, code_paths)) {
+                errors.push({
+                    type: WU_LINT_ERROR_TYPES.ACCEPTANCE_PATH_NOT_IN_CODE_PATHS,
+                    wuId: id,
+                    path: referencedPath,
+                    criterion,
+                    message: `Acceptance criterion references '${referencedPath}' which is not in code_paths`,
+                    suggestion: `Add '${referencedPath}' to code_paths or remove the reference from acceptance criteria`,
+                });
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+function checkForbiddenFileInvariant(invariant, wu) {
+    const { id, acceptance = [], code_paths = [] } = wu;
+    const errors = [];
+    if (code_paths.includes(invariant.path)) {
+        errors.push({
+            type: WU_LINT_ERROR_TYPES.CODE_PATH_CONFLICTS_INVARIANT,
+            wuId: id,
+            invariantId: invariant.id,
+            path: invariant.path,
+            message: `code_paths includes '${invariant.path}' which conflicts with invariant ${invariant.id}: ${invariant.description}`,
+            suggestion: invariant.message || `Remove '${invariant.path}' from code_paths`,
+        });
+    }
+    for (const criterion of acceptance) {
+        if (criterion.includes(invariant.path)) {
+            errors.push({
+                type: WU_LINT_ERROR_TYPES.ACCEPTANCE_CONFLICTS_INVARIANT,
+                wuId: id,
+                invariantId: invariant.id,
+                path: invariant.path,
+                criterion,
+                message: `Acceptance criterion references forbidden file '${invariant.path}' (${invariant.id}: ${invariant.description})`,
+                suggestion: invariant.message,
+            });
+        }
+    }
+    return errors;
+}
+function checkMutualExclusivityInvariant(invariant, wu) {
+    const { id, code_paths = [] } = wu;
+    const errors = [];
+    const conflictingPaths = invariant.paths.filter((p) => code_paths.includes(p));
+    if (conflictingPaths.length > 1) {
+        errors.push({
+            type: WU_LINT_ERROR_TYPES.CODE_PATH_CONFLICTS_INVARIANT,
+            wuId: id,
+            invariantId: invariant.id,
+            paths: conflictingPaths,
+            message: `code_paths includes multiple mutually exclusive files (${invariant.id}): ${conflictingPaths.join(', ')}`,
+            suggestion: invariant.message || `Only one of these files should exist: ${invariant.paths.join(', ')}`,
+        });
+    }
+    return errors;
+}
+/**
+ * Validate that code_paths and acceptance do not conflict with invariants
+ */
+export function validateInvariantsCompliance(wu, invariants) {
+    const errors = [];
+    for (const invariant of invariants) {
+        if (invariant.type === INVARIANT_TYPES.FORBIDDEN_FILE) {
+            errors.push(...checkForbiddenFileInvariant(invariant, wu));
+        }
+        else if (invariant.type === INVARIANT_TYPES.MUTUAL_EXCLUSIVITY) {
+            errors.push(...checkMutualExclusivityInvariant(invariant, wu));
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Legacy parity trigger helper kept for compatibility tests/docs.
+ */
+function isCliCommandPath(codePath) {
+    const matchesCommand = CLI_COMMAND_PATTERNS.some((pattern) => codePath.includes(pattern));
+    if (!matchesCommand)
+        return false;
+    const isExcluded = CLI_COMMAND_EXCLUDE_PATTERNS.some((pattern) => codePath.includes(pattern));
+    return !isExcluded;
+}
+const TERMINAL_STATUSES = new Set([
+    WU_STATUS.DONE,
+    WU_STATUS.CANCELLED,
+    WU_STATUS.COMPLETED,
+    WU_STATUS.ABANDONED,
+    WU_STATUS.SUPERSEDED,
+]);
+const LINT_TYPE_BY_RULE_CODE = {
+    [RULE_CODES.MINIMUM_TEST_INTENT]: WU_LINT_ERROR_TYPES.MINIMUM_TEST_INTENT_REQUIRED,
+    [RULE_CODES.PARITY_MISSING_SURFACE]: WU_LINT_ERROR_TYPES.REGISTRATION_PARITY_MISSING,
+};
+function toLintIssue(wuId, issue) {
+    const normalized = normalizeValidationIssue(issue, {
+        wuId,
+        typeByCode: LINT_TYPE_BY_RULE_CODE,
+    });
+    return {
+        type: normalized.type,
+        wuId,
+        message: normalized.message,
+        suggestion: normalized.suggestion,
+    };
+}
+/**
+ * Backward-compatible adapter for minimum test intent.
+ */
+export function validateUnitTestsRequirement(wu) {
+    const result = validateWURulesSync({
+        id: wu.id,
+        type: wu.type,
+        status: wu.status,
+        code_paths: wu.code_paths,
+        tests: wu.tests,
+    }, { phase: 'structural' });
+    const errors = result.errors
+        .filter((issue) => issue.code === RULE_CODES.MINIMUM_TEST_INTENT)
+        .map((issue) => ({
+        ...toLintIssue(wu.id, issue),
+        type: WU_LINT_ERROR_TYPES.UNIT_TESTS_REQUIRED,
+    }));
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Adapter for parity surface validation.
+ *
+ * Parity is enforced in reality-phase preflight where git diff context is available.
+ * This adapter only enforces when caller explicitly confirms `binChanged`.
+ */
+export function validateRegistrationParity(wu, options = {}) {
+    const { id, code_paths = [], status } = wu;
+    const errors = [];
+    const warnings = [];
+    if (status && TERMINAL_STATUSES.has(status)) {
+        return { valid: true, errors, warnings };
+    }
+    if (!options.binChanged) {
+        const hasCliCommandPath = code_paths.some((p) => isCliCommandPath(p));
+        if (hasCliCommandPath) {
+            warnings.push({
+                type: WU_LINT_ERROR_TYPES.REGISTRATION_PARITY_MISSING,
+                wuId: id,
+                message: 'Parity check requires diff context and is enforced in reality phase (wu:prep/wu:done preflight).',
+                suggestion: 'Run wu:prep or wu:done preflight to evaluate bin-diff-aware registration parity.',
+            });
+        }
+        return { valid: true, errors, warnings };
+    }
+    const hasPublicManifest = code_paths.includes(REGISTRATION_SURFACES.PUBLIC_MANIFEST);
+    const hasMcpTools = code_paths.includes(REGISTRATION_SURFACES.MCP_TOOLS);
+    if (!hasPublicManifest) {
+        errors.push({
+            type: WU_LINT_ERROR_TYPES.REGISTRATION_PARITY_MISSING,
+            wuId: id,
+            message: `CLI bin change detected but '${REGISTRATION_SURFACES.PUBLIC_MANIFEST}' is not in code_paths`,
+            suggestion: `Add '${REGISTRATION_SURFACES.PUBLIC_MANIFEST}' to code_paths`,
+        });
+    }
+    if (!hasMcpTools) {
+        errors.push({
+            type: WU_LINT_ERROR_TYPES.REGISTRATION_PARITY_MISSING,
+            wuId: id,
+            message: `CLI bin change detected but '${REGISTRATION_SURFACES.MCP_TOOLS}' is not in code_paths`,
+            suggestion: `Add '${REGISTRATION_SURFACES.MCP_TOOLS}' to code_paths`,
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Lint a WU spec against all rules
+ */
+export function lintWUSpec(wu, options = {}) {
+    const allErrors = [];
+    const allWarnings = [];
+    const phase = options.phase || 'structural';
+    const acceptanceResult = validateAcceptanceCodePaths(wu);
+    allErrors.push(...acceptanceResult.errors);
+    let invariants = options.invariants || [];
+    if (!options.invariants && options.invariantsPath) {
+        try {
+            if (existsSync(options.invariantsPath)) {
+                invariants = loadInvariants(options.invariantsPath);
+            }
+        }
+        catch {
+            // Continue without invariants when loading fails.
+        }
+    }
+    if (invariants.length > 0) {
+        const invariantsResult = validateInvariantsCompliance(wu, invariants);
+        allErrors.push(...invariantsResult.errors);
+    }
+    const rulesResult = validateWURulesSync({
+        id: wu.id,
+        type: wu.type,
+        status: wu.status,
+        code_paths: wu.code_paths,
+        tests: wu.tests || wu.test_paths,
+        cwd: options.context?.cwd,
+        baseRef: options.context?.baseRef,
+        headRef: options.context?.headRef,
+    }, { phase });
+    for (const issue of rulesResult.errors) {
+        allErrors.push(toLintIssue(wu.id, issue));
+    }
+    for (const issue of rulesResult.warnings) {
+        allWarnings.push(toLintIssue(wu.id, issue));
+    }
+    return {
+        valid: allErrors.length === 0,
+        errors: allErrors,
+        warnings: allWarnings,
+    };
+}
+/**
+ * Format lint errors for display
+ */
+export function formatLintErrors(errors) {
+    if (errors.length === 0) {
+        return '';
+    }
+    const lines = ['WU SPEC LINT ERRORS:', ''];
+    for (const error of errors) {
+        lines.push(`- ${error.message}`);
+        if (error.suggestion) {
+            lines.push(`  Fix: ${error.suggestion}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=wu-lint.js.map

package/dist/wu-lint.js.map

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

package/dist/wu-list.d.ts

@@ -0,0 +1,76 @@
+/**
+ * WU list entry returned by listWUs.
+ * Contains essential fields for display and filtering.
+ */
+export interface WUListEntry {
+    /** WU identifier (e.g., 'WU-100') */
+    id: string;
+    /** Short title describing the work */
+    title: string;
+    /** Lane assignment (e.g., 'Framework: Core') */
+    lane: string;
+    /** Current status (from state store or YAML) */
+    status: string;
+    /** Work type (feature, bug, documentation, etc.) */
+    type: string;
+    /** Priority level (P0-P3) */
+    priority: string;
+    /** Parent initiative reference (optional) */
+    initiative?: string;
+    /** Phase number within parent initiative (optional) */
+    phase?: number;
+    /** Creation date (YYYY-MM-DD) */
+    created?: string;
+}
+/**
+ * Options for listWUs function.
+ */
+export interface ListWUsOptions {
+    /** Project root directory (default: cwd) */
+    projectRoot?: string;
+    /** Filter by status (e.g., 'in_progress', 'blocked', 'done') */
+    status?: string;
+    /** Filter by lane (e.g., 'Framework: Core') */
+    lane?: string;
+    /**
+     * Direct path to WU directory (overrides config-based path).
+     * Useful for testing with virtual filesystems.
+     */
+    wuDir?: string;
+    /**
+     * Direct path to state directory (overrides config-based path).
+     * Useful for testing with virtual filesystems.
+     */
+    stateDir?: string;
+}
+/**
+ * Lists WUs by merging state store status with YAML metadata.
+ *
+ * The state store contains the most current status (claim, block, complete events),
+ * while YAML files contain the full metadata (title, lane, type, etc.).
+ *
+ * Status precedence:
+ * 1. State store status (if WU has events)
+ * 2. YAML status (fallback if not in state store)
+ *
+ * @param options - Listing options
+ * @returns Array of WU list entries
+ *
+ * @example
+ * // List all WUs
+ * const allWUs = await listWUs();
+ *
+ * @example
+ * // Filter by status
+ * const inProgress = await listWUs({ status: 'in_progress' });
+ *
+ * @example
+ * // Filter by lane
+ * const coreWUs = await listWUs({ lane: 'Framework: Core' });
+ *
+ * @example
+ * // Filter by both
+ * const blockedCore = await listWUs({ status: 'blocked', lane: 'Framework: Core' });
+ */
+export declare function listWUs(options?: ListWUsOptions): Promise<WUListEntry[]>;
+//# sourceMappingURL=wu-list.d.ts.map

package/dist/wu-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-list.d.ts","sourceRoot":"","sources":["../src/wu-list.ts"],"names":[],"mappings":"AA6BA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAwFlF"}

package/dist/wu-list.js

@@ -0,0 +1,181 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU List Helper (WU-1411)
+ *
+ * Provides a consistent list of WUs by merging WUStateStore with YAML metadata.
+ * MCP server and other tools can use this instead of duplicating listing logic.
+ *
+ * Key behaviors:
+ * - Status from state store takes precedence over YAML status (more current)
+ * - Falls back to YAML status when WU is not in state store
+ * - Supports filtering by status and lane
+ * - Gracefully handles errors (missing files, invalid YAML)
+ *
+ * @module wu-list
+ * @see {@link ./wu-state-store.ts} - State store for runtime status
+ * @see {@link ./wu-yaml.ts} - YAML operations
+ * @see {@link ./wu-paths.ts} - Path utilities
+ */
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { readFile } from 'node:fs/promises';
+import { WUStateStore } from './wu-state-store.js';
+import { getConfig } from './lumenflow-config.js';
+import { WU_STATUS } from './wu-constants.js';
+/**
+ * Lists WUs by merging state store status with YAML metadata.
+ *
+ * The state store contains the most current status (claim, block, complete events),
+ * while YAML files contain the full metadata (title, lane, type, etc.).
+ *
+ * Status precedence:
+ * 1. State store status (if WU has events)
+ * 2. YAML status (fallback if not in state store)
+ *
+ * @param options - Listing options
+ * @returns Array of WU list entries
+ *
+ * @example
+ * // List all WUs
+ * const allWUs = await listWUs();
+ *
+ * @example
+ * // Filter by status
+ * const inProgress = await listWUs({ status: 'in_progress' });
+ *
+ * @example
+ * // Filter by lane
+ * const coreWUs = await listWUs({ lane: 'Framework: Core' });
+ *
+ * @example
+ * // Filter by both
+ * const blockedCore = await listWUs({ status: 'blocked', lane: 'Framework: Core' });
+ */
+export async function listWUs(options = {}) {
+    const { projectRoot = process.cwd(), status: filterStatus, lane: filterLane, wuDir: wuDirOverride, stateDir: stateDirOverride, } = options;
+    // Determine paths: use overrides if provided, otherwise use config
+    let wuDir;
+    let stateDir;
+    if (wuDirOverride && stateDirOverride) {
+        // Direct paths provided (e.g., for testing)
+        wuDir = wuDirOverride;
+        stateDir = stateDirOverride;
+    }
+    else {
+        // Get configuration for paths
+        const config = getConfig({ projectRoot });
+        wuDir = wuDirOverride ?? join(projectRoot, config.directories.wuDir);
+        stateDir = stateDirOverride ?? join(projectRoot, config.state.stateDir);
+    }
+    // Load state store for runtime statuses
+    const stateMap = await loadStateStore(stateDir);
+    // Read all WU YAML files
+    const wuEntries = await readWUYamlFiles(wuDir);
+    // Merge state store status with YAML data
+    const entries = [];
+    for (const yamlData of wuEntries) {
+        // Skip invalid entries
+        if (!yamlData.id || typeof yamlData.id !== 'string') {
+            continue;
+        }
+        const wuId = yamlData.id;
+        // Get status: state store takes precedence
+        const stateEntry = stateMap.get(wuId);
+        const yamlStatus = typeof yamlData.status === 'string' ? yamlData.status : WU_STATUS.READY;
+        const status = stateEntry?.status ?? yamlStatus;
+        // Get lane: prefer state store (more current), fall back to YAML
+        const yamlLane = typeof yamlData.lane === 'string' ? yamlData.lane : '';
+        const lane = stateEntry?.lane ?? yamlLane;
+        // Extract string fields with type guards
+        const yamlTitle = typeof yamlData.title === 'string' ? yamlData.title : '';
+        const yamlType = typeof yamlData.type === 'string' ? yamlData.type : 'feature';
+        const yamlPriority = typeof yamlData.priority === 'string' ? yamlData.priority : 'P2';
+        // Build entry
+        const entry = {
+            id: wuId,
+            title: stateEntry?.title ?? yamlTitle,
+            lane,
+            status,
+            type: yamlType,
+            priority: yamlPriority,
+        };
+        // Add optional fields if present with type guards
+        if (typeof yamlData.initiative === 'string') {
+            entry.initiative = yamlData.initiative;
+        }
+        if (typeof yamlData.phase === 'number') {
+            entry.phase = yamlData.phase;
+        }
+        if (typeof yamlData.created === 'string') {
+            entry.created = yamlData.created;
+        }
+        // Apply filters
+        if (filterStatus && status !== filterStatus) {
+            continue;
+        }
+        if (filterLane && lane !== filterLane) {
+            continue;
+        }
+        entries.push(entry);
+    }
+    return entries;
+}
+/**
+ * Loads state store and returns a map of WU ID to state entry.
+ * Returns empty map on errors (graceful degradation).
+ */
+async function loadStateStore(stateDir) {
+    const map = new Map();
+    try {
+        const store = new WUStateStore(stateDir);
+        await store.load();
+        // Collect all known statuses
+        const statuses = [WU_STATUS.IN_PROGRESS, WU_STATUS.BLOCKED, WU_STATUS.DONE, WU_STATUS.READY];
+        for (const status of statuses) {
+            const wuIds = store.getByStatus(status);
+            for (const wuId of wuIds) {
+                const state = store.getWUState(wuId);
+                if (state) {
+                    map.set(wuId, state);
+                }
+            }
+        }
+    }
+    catch {
+        // Graceful degradation: return empty map on errors
+    }
+    return map;
+}
+/**
+ * Reads all WU YAML files from the WU directory.
+ * Skips invalid files (graceful degradation).
+ */
+async function readWUYamlFiles(wuDir) {
+    const entries = [];
+    try {
+        const files = await readdir(wuDir);
+        for (const file of files) {
+            // Only process WU-*.yaml files
+            if (!file.startsWith('WU-') || !file.endsWith('.yaml')) {
+                continue;
+            }
+            try {
+                const content = await readFile(join(wuDir, file), 'utf-8');
+                const parsed = parseYaml(content);
+                if (parsed && typeof parsed === 'object') {
+                    entries.push(parsed);
+                }
+            }
+            catch {
+                // Skip invalid YAML files
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+    }
+    return entries;
+}
+//# sourceMappingURL=wu-list.js.map

package/dist/wu-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-list.js","sourceRoot":"","sources":["../src/wu-list.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAqB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAiD9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,UAA0B,EAAE;IACxD,MAAM,EACJ,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,EAC3B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,gBAAgB,GAC3B,GAAG,OAAO,CAAC;IAEZ,mEAAmE;IACnE,IAAI,KAAa,CAAC;IAClB,IAAI,QAAgB,CAAC;IAErB,IAAI,aAAa,IAAI,gBAAgB,EAAE,CAAC;QACtC,4CAA4C;QAC5C,KAAK,GAAG,aAAa,CAAC;QACtB,QAAQ,GAAG,gBAAgB,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,8BAA8B;QAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAC1C,KAAK,GAAG,aAAa,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACrE,QAAQ,GAAG,gBAAgB,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1E,CAAC;IAED,wCAAwC;IACxC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEhD,yBAAyB;IACzB,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IAE/C,0CAA0C;IAC1C,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,uBAAuB;QACvB,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC;QAEzB,2CAA2C;QAC3C,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;QAC3F,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,IAAI,UAAU,CAAC;QAEhD,iEAAiE;QACjE,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,GAAG,UAAU,EAAE,IAAI,IAAI,QAAQ,CAAC;QAE1C,yCAAyC;QACzC,MAAM,SAAS,GAAG,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,MAAM,YAAY,GAAG,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QAEtF,cAAc;QACd,MAAM,KAAK,GAAgB;YACzB,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,SAAS;YACrC,IAAI;YACJ,MAAM;YACN,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,YAAY;SACvB,CAAC;QAEF,kDAAkD;QAClD,IAAI,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC5C,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QACzC,CAAC;QACD,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzC,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QACnC,CAAC;QAED,gBAAgB;QAChB,IAAI,YAAY,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5C,SAAS;QACX,CAAC;QACD,IAAI,UAAU,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACtC,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,cAAc,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QAEnB,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QAE7F,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,KAAK,EAAE,CAAC;oBACV,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,eAAe,CAAC,KAAa;IAC1C,MAAM,OAAO,GAAmC,EAAE,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,+BAA+B;YAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvD,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;gBAC3D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;gBAElC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACzC,OAAO,CAAC,IAAI,CAAC,MAAiC,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/wu-lock-manager.d.ts

@@ -0,0 +1,28 @@
+import type { LockData } from './ports/wu-state.ports.js';
+export type { LockData };
+/**
+ * Check if a lock is stale (expired or dead process)
+ *
+ * WU-2240: Prepared for proper-lockfile integration
+ */
+export declare function isLockStale(lockData: LockData): boolean;
+/**
+ * Acquire a file lock for the events file
+ *
+ * Uses a JSON lock file containing PID, timestamp, and hostname.
+ * Implements stale lock detection via:
+ * - PID check (on same host)
+ * - 5-minute timeout (across hosts)
+ *
+ * WU-2240: Prepared for proper-lockfile integration
+ *
+ * @throws Error If lock cannot be acquired after retries
+ */
+export declare function acquireLock(lockPath: string): Promise<void>;
+/**
+ * Release a file lock
+ *
+ * WU-2240: Prepared for proper-lockfile integration
+ */
+export declare function releaseLock(lockPath: string): void;
+//# sourceMappingURL=wu-lock-manager.d.ts.map

package/dist/wu-lock-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-lock-manager.d.ts","sourceRoot":"","sources":["../src/wu-lock-manager.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,YAAY,EAAE,QAAQ,EAAE,CAAC;AA4BzB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAiBvD;AAmED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAElD"}