@lumenflow/core 3.1.2 → 3.2.0

package/dist/spawn-tree.d.ts

@@ -1,125 +0,0 @@
-/**
- * Spawn Tree Builder (WU-1950)
- *
- * Builds and formats spawn trees for visualization.
- * Used by spawn:list command to display parent-child relationships.
- *
- * Note: Domain-specific tree visualization for spawn registry.
- * Integrates with spawn-registry-store and spawn-registry-schema.
- * No external tree library needed - logic is tightly coupled to spawn data model.
- *
- * @see {@link packages/@lumenflow/cli/src/__tests__/spawn-list.test.ts} - Tests
- * @see {@link packages/@lumenflow/cli/src/spawn-list.ts} - CLI command
- * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-store.ts} - Data source
- */
-/**
- * Status indicators for terminal output.
- * Using unicode symbols for clear visual distinction.
- */
-export declare const STATUS_INDICATORS: Readonly<{
-    pending: "○";
-    completed: "✓";
-    timeout: "⏱";
-    crashed: "✗";
-}>;
-/**
- * Tree node structure
- * @typedef {object} SpawnTreeNode
- * @property {string} wuId - WU ID for this node
- * @property {string|null} spawnId - Spawn ID (null for root)
- * @property {string|null} status - Spawn status (null for root)
- * @property {string|null} lane - Lane (null for root)
- * @property {string|null} spawnedAt - Spawn timestamp (null for root)
- * @property {SpawnTreeNode[]} children - Child nodes
- */
-/**
- * Builds a spawn tree from flat spawn events.
- *
- * @param {import('./spawn-registry-schema.js').SpawnEvent[]} spawns - Array of spawn events
- * @param {string} rootWuId - Root WU ID to build tree from
- * @returns {SpawnTreeNode} Tree rooted at rootWuId
- *
- * @example
- * const tree = buildSpawnTree(spawns, 'WU-1000');
- * // { wuId: 'WU-1000', children: [{ wuId: 'WU-1001', ... }] }
- */
-export declare function buildSpawnTree(spawns: any, rootWuId: any): {
-    wuId: any;
-    spawnId: any;
-    status: any;
-    lane: any;
-    spawnedAt: any;
-    children: any[];
-};
-/**
- * Formats a spawn tree for terminal display with indentation and tree characters.
- *
- * @param {SpawnTreeNode} tree - Tree to format
- * @returns {string} Formatted tree string
- *
- * @example
- * const formatted = formatSpawnTree(tree);
- * // WU-1000 (root)
- * // ├── ○ WU-1001 [spawn-1111] (Operations: Tooling)
- * // │   └── ✓ WU-1002 [spawn-2222] (Core: Backend)
- * // └── ○ WU-1003 [spawn-3333] (Experience: Web)
- */
-export declare function formatSpawnTree(tree: any): string;
-/**
- * Gets all spawns for a WU (both where WU is parent and descendants).
- *
- * Returns all spawns needed to build the full tree from this WU.
- *
- * @param {string} wuId - WU ID to get spawns for
- * @param {string} baseDir - Directory containing spawn-registry.jsonl
- * @returns {Promise<import('./spawn-registry-schema.js').SpawnEvent[]>} Array of spawn events
- *
- * @example
- * const spawns = await getSpawnsByWU('WU-1000', '.lumenflow/state');
- */
-export declare function getSpawnsByWU(wuId: any, baseDir: any): Promise<any[]>;
-/**
- * Gets all spawns for an initiative.
- *
- * Reads WU YAML files to find which WUs belong to the initiative,
- * then returns all spawns where parent or target WU belongs to initiative.
- *
- * @param {string} initiativeId - Initiative ID (e.g., 'INIT-001')
- * @param {string} registryDir - Directory containing spawn-registry.jsonl
- * @param {string} wuDir - Directory containing WU YAML files
- * @returns {Promise<import('./spawn-registry-schema.js').SpawnEvent[]>} Array of spawn events
- *
- * @example
- * const spawns = await getSpawnsByInitiative('INIT-001', '.lumenflow/state', 'docs/04-operations/tasks/wu');
- */
-export declare function getSpawnsByInitiative(initiativeId: any, registryDir: any, wuDir: any): Promise<{
-    id: string;
-    parentWuId: string;
-    targetWuId: string;
-    lane: string;
-    spawnedAt: string;
-    status: "completed" | "timeout" | "pending" | "crashed" | "escalated";
-    intent?: "delegation" | "legacy-spawn";
-    completedAt?: string;
-    pickedUpAt?: string;
-    pickedUpBy?: string;
-}[]>;
-/**
- * Converts a spawn tree to JSON format.
- *
- * @param {SpawnTreeNode} tree - Tree to convert
- * @returns {object} JSON-serializable tree
- *
- * @example
- * const json = treeToJSON(tree);
- * console.log(JSON.stringify(json, null, 2));
- */
-export declare function treeToJSON(tree: any): {
-    wuId: any;
-    spawnId: any;
-    status: any;
-    lane: any;
-    spawnedAt: any;
-    children: any;
-};
-//# sourceMappingURL=spawn-tree.d.ts.map

package/dist/spawn-tree.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn-tree.d.ts","sourceRoot":"","sources":["../src/spawn-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;EAK5B,CAAC;AAEH;;;;;;;;;GASG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,KAAA,EAAE,QAAQ,KAAA;;;;;;;EA4C9C;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,KAAA,UAqCnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA,kBA0ChD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,KAAA,EAAE,WAAW,KAAA,EAAE,KAAK,KAAA;;;;;;;;;;;KAuB3E;AAyCD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,KAAA;;;;;;;EAS9B"}

package/dist/spawn-tree.js

@@ -1,286 +0,0 @@
-/**
- * Spawn Tree Builder (WU-1950)
- *
- * Builds and formats spawn trees for visualization.
- * Used by spawn:list command to display parent-child relationships.
- *
- * Note: Domain-specific tree visualization for spawn registry.
- * Integrates with spawn-registry-store and spawn-registry-schema.
- * No external tree library needed - logic is tightly coupled to spawn data model.
- *
- * @see {@link packages/@lumenflow/cli/src/__tests__/spawn-list.test.ts} - Tests
- * @see {@link packages/@lumenflow/cli/src/spawn-list.ts} - CLI command
- * @see {@link packages/@lumenflow/cli/src/lib/spawn-registry-store.ts} - Data source
- */
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { SpawnRegistryStore } from './spawn-registry-store.js';
-import { SpawnStatus } from './spawn-registry-schema.js';
-import { parse as parseYAML } from 'yaml';
-/**
- * Status indicators for terminal output.
- * Using unicode symbols for clear visual distinction.
- */
-export const STATUS_INDICATORS = Object.freeze({
-    [SpawnStatus.PENDING]: '\u25CB', // ○ (white circle)
-    [SpawnStatus.COMPLETED]: '\u2713', // ✓ (check mark)
-    [SpawnStatus.TIMEOUT]: '\u23F1', // ⏱ (stopwatch)
-    [SpawnStatus.CRASHED]: '\u2717', // ✗ (x mark)
-});
-/**
- * Tree node structure
- * @typedef {object} SpawnTreeNode
- * @property {string} wuId - WU ID for this node
- * @property {string|null} spawnId - Spawn ID (null for root)
- * @property {string|null} status - Spawn status (null for root)
- * @property {string|null} lane - Lane (null for root)
- * @property {string|null} spawnedAt - Spawn timestamp (null for root)
- * @property {SpawnTreeNode[]} children - Child nodes
- */
-/**
- * Builds a spawn tree from flat spawn events.
- *
- * @param {import('./spawn-registry-schema.js').SpawnEvent[]} spawns - Array of spawn events
- * @param {string} rootWuId - Root WU ID to build tree from
- * @returns {SpawnTreeNode} Tree rooted at rootWuId
- *
- * @example
- * const tree = buildSpawnTree(spawns, 'WU-1000');
- * // { wuId: 'WU-1000', children: [{ wuId: 'WU-1001', ... }] }
- */
-export function buildSpawnTree(spawns, rootWuId) {
-    // Create root node
-    /** @type {SpawnTreeNode} */
-    const root = {
-        wuId: rootWuId,
-        spawnId: null,
-        status: null,
-        lane: null,
-        spawnedAt: null,
-        children: [],
-    };
-    if (spawns.length === 0) {
-        return root;
-    }
-    // Build index of spawns by parent WU ID for efficient lookup
-    /** @type {Map<string, import('./spawn-registry-schema.js').SpawnEvent[]>} */
-    const spawnsByParent = new Map();
-    for (const spawn of spawns) {
-        const existing = spawnsByParent.get(spawn.parentWuId) ?? [];
-        existing.push(spawn);
-        spawnsByParent.set(spawn.parentWuId, existing);
-    }
-    // Recursive function to build tree
-    /**
-     * @param {string} parentWuId
-     * @returns {SpawnTreeNode[]}
-     */
-    function buildChildren(parentWuId) {
-        const childSpawns = spawnsByParent.get(parentWuId) ?? [];
-        return childSpawns.map((spawn) => ({
-            wuId: spawn.targetWuId,
-            spawnId: spawn.id,
-            status: spawn.status,
-            lane: spawn.lane,
-            spawnedAt: spawn.spawnedAt,
-            children: buildChildren(spawn.targetWuId),
-        }));
-    }
-    root.children = buildChildren(rootWuId);
-    return root;
-}
-/**
- * Tree branch characters for formatting
- */
-const TREE_CHARS = Object.freeze({
-    VERTICAL: '\u2502', // │
-    BRANCH: '\u251C', // ├
-    LAST_BRANCH: '\u2514', // └
-    HORIZONTAL: '\u2500', // ─
-    SPACE: ' ',
-});
-/**
- * Formats a spawn tree for terminal display with indentation and tree characters.
- *
- * @param {SpawnTreeNode} tree - Tree to format
- * @returns {string} Formatted tree string
- *
- * @example
- * const formatted = formatSpawnTree(tree);
- * // WU-1000 (root)
- * // ├── ○ WU-1001 [spawn-1111] (Operations: Tooling)
- * // │   └── ✓ WU-1002 [spawn-2222] (Core: Backend)
- * // └── ○ WU-1003 [spawn-3333] (Experience: Web)
- */
-export function formatSpawnTree(tree) {
-    const lines = [];
-    // Root line
-    lines.push(`${tree.wuId} (root)`);
-    if (tree.children.length === 0) {
-        lines.push(`  (no spawns)`);
-        return lines.join('\n');
-    }
-    // Recursive formatting
-    /**
-     * @param {SpawnTreeNode[]} children
-     * @param {string} prefix - Indentation prefix for this level
-     */
-    function formatChildren(children, prefix) {
-        children.forEach((child, index) => {
-            const isLast = index === children.length - 1;
-            const branch = isLast
-                ? `${TREE_CHARS.LAST_BRANCH}${TREE_CHARS.HORIZONTAL}${TREE_CHARS.HORIZONTAL}`
-                : `${TREE_CHARS.BRANCH}${TREE_CHARS.HORIZONTAL}${TREE_CHARS.HORIZONTAL}`;
-            const indicator = STATUS_INDICATORS[child.status] ?? '?';
-            const spawnInfo = child.spawnId ? ` [${child.spawnId}]` : '';
-            const laneInfo = child.lane ? ` (${child.lane})` : '';
-            lines.push(`${prefix}${branch} ${indicator} ${child.wuId}${spawnInfo}${laneInfo}`);
-            // Child prefix: use vertical bar if not last, space if last
-            const childPrefix = prefix + (isLast ? '    ' : `${TREE_CHARS.VERTICAL}   `);
-            formatChildren(child.children, childPrefix);
-        });
-    }
-    formatChildren(tree.children, '');
-    return lines.join('\n');
-}
-/**
- * Gets all spawns for a WU (both where WU is parent and descendants).
- *
- * Returns all spawns needed to build the full tree from this WU.
- *
- * @param {string} wuId - WU ID to get spawns for
- * @param {string} baseDir - Directory containing spawn-registry.jsonl
- * @returns {Promise<import('./spawn-registry-schema.js').SpawnEvent[]>} Array of spawn events
- *
- * @example
- * const spawns = await getSpawnsByWU('WU-1000', '.lumenflow/state');
- */
-export async function getSpawnsByWU(wuId, baseDir) {
-    const store = new SpawnRegistryStore(baseDir);
-    try {
-        await store.load();
-    }
-    catch (error) {
-        // Registry doesn't exist or is invalid
-        if (error.code === 'ENOENT') {
-            return [];
-        }
-        throw error;
-    }
-    // Get all spawns
-    const allSpawns = store.getAllSpawns();
-    if (allSpawns.length === 0) {
-        return [];
-    }
-    // Find all spawns in the tree rooted at wuId
-    // Start with direct children of wuId
-    const result = [];
-    const visited = new Set();
-    const queue = [wuId];
-    while (queue.length > 0) {
-        const currentWuId = queue.shift();
-        if (visited.has(currentWuId))
-            continue;
-        visited.add(currentWuId);
-        // Find spawns where current WU is the parent
-        const childSpawns = store.getByParent(currentWuId);
-        for (const spawn of childSpawns) {
-            if (!result.some((s) => s.id === spawn.id)) {
-                result.push(spawn);
-                queue.push(spawn.targetWuId);
-            }
-        }
-    }
-    return result;
-}
-/**
- * Gets all spawns for an initiative.
- *
- * Reads WU YAML files to find which WUs belong to the initiative,
- * then returns all spawns where parent or target WU belongs to initiative.
- *
- * @param {string} initiativeId - Initiative ID (e.g., 'INIT-001')
- * @param {string} registryDir - Directory containing spawn-registry.jsonl
- * @param {string} wuDir - Directory containing WU YAML files
- * @returns {Promise<import('./spawn-registry-schema.js').SpawnEvent[]>} Array of spawn events
- *
- * @example
- * const spawns = await getSpawnsByInitiative('INIT-001', '.lumenflow/state', 'docs/04-operations/tasks/wu');
- */
-export async function getSpawnsByInitiative(initiativeId, registryDir, wuDir) {
-    // Get all WUs belonging to initiative
-    const initiativeWuIds = await getWUsForInitiative(initiativeId, wuDir);
-    if (initiativeWuIds.size === 0) {
-        return [];
-    }
-    // Load spawn registry
-    const store = new SpawnRegistryStore(registryDir);
-    try {
-        await store.load();
-    }
-    catch (error) {
-        if (error.code === 'ENOENT') {
-            return [];
-        }
-        throw error;
-    }
-    // Filter spawns where parent belongs to initiative
-    const allSpawns = store.getAllSpawns();
-    return allSpawns.filter((spawn) => initiativeWuIds.has(spawn.parentWuId));
-}
-/**
- * Reads WU YAML files to find WUs belonging to an initiative.
- *
- * @param {string} initiativeId - Initiative ID
- * @param {string} wuDir - Directory containing WU YAML files
- * @returns {Promise<Set<string>>} Set of WU IDs belonging to initiative
- */
-async function getWUsForInitiative(initiativeId, wuDir) {
-    const wuIds = new Set();
-    let files;
-    try {
-        files = await fs.readdir(wuDir);
-    }
-    catch (error) {
-        if (error.code === 'ENOENT') {
-            return wuIds;
-        }
-        throw error;
-    }
-    const wuFiles = files.filter((f) => f.startsWith('WU-') && f.endsWith('.yaml'));
-    for (const file of wuFiles) {
-        try {
-            const content = await fs.readFile(path.join(wuDir, file), 'utf-8');
-            const doc = parseYAML(content);
-            if (doc.initiative === initiativeId) {
-                wuIds.add(doc.id);
-            }
-        }
-        catch {
-            // Skip files that can't be parsed
-            continue;
-        }
-    }
-    return wuIds;
-}
-/**
- * Converts a spawn tree to JSON format.
- *
- * @param {SpawnTreeNode} tree - Tree to convert
- * @returns {object} JSON-serializable tree
- *
- * @example
- * const json = treeToJSON(tree);
- * console.log(JSON.stringify(json, null, 2));
- */
-export function treeToJSON(tree) {
-    return {
-        wuId: tree.wuId,
-        spawnId: tree.spawnId,
-        status: tree.status,
-        lane: tree.lane,
-        spawnedAt: tree.spawnedAt,
-        children: tree.children.map((child) => treeToJSON(child)),
-    };
-}
-//# sourceMappingURL=spawn-tree.js.map

package/dist/spawn-tree.js.map

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

package/dist/stamp-status-validator.d.ts

@@ -1,77 +0,0 @@
-/**
- * List of parent-only lanes that are deprecated (legacy).
- * WUs with these lanes are considered legacy artifacts and may have stamp-status mismatches.
- * Modern WUs should use sub-lanes like "Operations: Tooling".
- *
- * @type {readonly string[]}
- */
-export declare const LEGACY_PARENT_ONLY_LANES: readonly string[];
-/**
- * Check if a lane is a deprecated parent-only lane (no sub-lane specified).
- *
- * @param {string|null|undefined} lane - The lane to check
- * @returns {boolean} True if the lane is a parent-only legacy lane
- *
- * @example
- * isLegacyParentOnlyLane('Intelligence') // true
- * isLegacyParentOnlyLane('Operations: Tooling') // false
- */
-export declare function isLegacyParentOnlyLane(lane: UnsafeAny): boolean;
-/**
- * Check if a WU is a legacy artifact with stamp-status mismatch.
- *
- * A legacy stamped WU is one that:
- * - Has a .done stamp file
- * - Has a status that is NOT 'done'
- *
- * These WUs are historical artifacts from before validation was strict,
- * and should be exempted from the stamp-status consistency check.
- *
- * @param {object} wu - The parsed WU YAML object
- * @param {string} wu.id - WU ID (e.g., 'WU-100')
- * @param {string} wu.status - WU status (e.g., 'done', 'cancelled', 'ready')
- * @param {Set<string>} stampedIds - Set of WU IDs that have .done stamp files
- * @returns {boolean} True if this is a legacy stamped WU with mismatch
- *
- * @example
- * const stampedIds = new Set(['WU-100', 'WU-101']);
- * isLegacyStampedWU({ id: 'WU-100', status: 'cancelled' }, stampedIds) // true
- * isLegacyStampedWU({ id: 'WU-100', status: 'done' }, stampedIds) // false (no mismatch)
- * isLegacyStampedWU({ id: 'WU-999', status: 'cancelled' }, stampedIds) // false (no stamp)
- */
-export declare function isLegacyStampedWU(wu: UnsafeAny, stampedIds: UnsafeAny): boolean;
-/**
- * Check if a WU ID is exempted from stamp-status validation via config.
- *
- * The .lumenflow.config.yaml can specify exemptions for known historical
- * artifacts that cannot be fixed (e.g., WU-307, WU-311, WU-1152).
- *
- * @param {string} id - WU ID to check
- * @param {string[]|null|undefined} exemptions - List of exempted WU IDs from config
- * @returns {boolean} True if the WU is exempted
- *
- * @example
- * isExemptedFromStampStatusCheck('WU-307', ['WU-307', 'WU-311']) // true
- * isExemptedFromStampStatusCheck('WU-999', ['WU-307', 'WU-311']) // false
- */
-export declare function isExemptedFromStampStatusCheck(id: UnsafeAny, exemptions: UnsafeAny): boolean;
-/**
- * Determine if a WU should be exempted from stamp-status validation.
- *
- * A WU is exempted if:
- * 1. It's explicitly listed in the config exemptions, OR
- * 2. It's a legacy stamped WU (has stamp but status != done) AND has a legacy parent-only lane
- *
- * @param {object} wu - The parsed WU YAML object
- * @param {Set<string>} stampedIds - Set of WU IDs that have .done stamp files
- * @param {string[]} exemptions - List of exempted WU IDs from config
- * @returns {{ exempted: boolean, reason: string|null }} Whether exempted and why
- */
-export declare function shouldExemptFromStampStatusCheck(wu: UnsafeAny, stampedIds: UnsafeAny, exemptions?: never[]): {
-    exempted: boolean;
-    reason: string;
-} | {
-    exempted: boolean;
-    reason: null;
-};
-//# sourceMappingURL=stamp-status-validator.d.ts.map

package/dist/stamp-status-validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stamp-status-validator.d.ts","sourceRoot":"","sources":["../src/stamp-status-validator.ts"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,mBAMnC,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,WAUrD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,WAwBrE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,WAMlF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gCAAgC,CAC9C,EAAE,EAAE,SAAS,EACb,UAAU,EAAE,SAAS,EACrB,UAAU,UAAK;;;;;;EAkBhB"}

package/dist/stamp-status-validator.js

@@ -1,138 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * @fileoverview Stamp-status validation utilities
- *
- * WU-1781: Provides utilities to detect and handle legacy WUs with stamp-status mismatches.
- *
- * The problem: WUs with .done stamps but non-done status (e.g., cancelled, ready) cause
- * wu:validate to fail, which blocks husky pre-push and prevents wu:done from completing.
- *
- * The solution: Detect these legacy artifacts and exempt them from validation to prevent
- * deadlocks, while still enforcing validation on new/active WUs.
- */
-import { WU_STATUS } from './wu-constants.js';
-/**
- * List of parent-only lanes that are deprecated (legacy).
- * WUs with these lanes are considered legacy artifacts and may have stamp-status mismatches.
- * Modern WUs should use sub-lanes like "Operations: Tooling".
- *
- * @type {readonly string[]}
- */
-export const LEGACY_PARENT_ONLY_LANES = Object.freeze([
-    'Intelligence',
-    'Core Systems',
-    'Operations',
-    'Experience',
-    'Discovery',
-]);
-/**
- * Check if a lane is a deprecated parent-only lane (no sub-lane specified).
- *
- * @param {string|null|undefined} lane - The lane to check
- * @returns {boolean} True if the lane is a parent-only legacy lane
- *
- * @example
- * isLegacyParentOnlyLane('Intelligence') // true
- * isLegacyParentOnlyLane('Operations: Tooling') // false
- */
-export function isLegacyParentOnlyLane(lane) {
-    if (!lane || typeof lane !== 'string') {
-        return false;
-    }
-    const normalizedLane = lane.trim();
-    // Check if it's an exact match to a parent-only lane (case-insensitive)
-    const lowerLane = normalizedLane.toLowerCase();
-    return LEGACY_PARENT_ONLY_LANES.some((parentLane) => parentLane.toLowerCase() === lowerLane);
-}
-/**
- * Check if a WU is a legacy artifact with stamp-status mismatch.
- *
- * A legacy stamped WU is one that:
- * - Has a .done stamp file
- * - Has a status that is NOT 'done'
- *
- * These WUs are historical artifacts from before validation was strict,
- * and should be exempted from the stamp-status consistency check.
- *
- * @param {object} wu - The parsed WU YAML object
- * @param {string} wu.id - WU ID (e.g., 'WU-100')
- * @param {string} wu.status - WU status (e.g., 'done', 'cancelled', 'ready')
- * @param {Set<string>} stampedIds - Set of WU IDs that have .done stamp files
- * @returns {boolean} True if this is a legacy stamped WU with mismatch
- *
- * @example
- * const stampedIds = new Set(['WU-100', 'WU-101']);
- * isLegacyStampedWU({ id: 'WU-100', status: 'cancelled' }, stampedIds) // true
- * isLegacyStampedWU({ id: 'WU-100', status: 'done' }, stampedIds) // false (no mismatch)
- * isLegacyStampedWU({ id: 'WU-999', status: 'cancelled' }, stampedIds) // false (no stamp)
- */
-export function isLegacyStampedWU(wu, stampedIds) {
-    if (!wu || !wu.id || !stampedIds) {
-        return false;
-    }
-    // Must have a stamp
-    const hasStamp = stampedIds.has(wu.id);
-    if (!hasStamp) {
-        return false;
-    }
-    // Must have a status that is NOT done
-    const status = wu.status;
-    if (!status || typeof status !== 'string') {
-        return false;
-    }
-    // If status is 'done', this is a normal WU (no mismatch)
-    if (status.toLowerCase() === WU_STATUS.DONE) {
-        return false;
-    }
-    // Has stamp + status != done = legacy mismatch
-    return true;
-}
-/**
- * Check if a WU ID is exempted from stamp-status validation via config.
- *
- * The .lumenflow.config.yaml can specify exemptions for known historical
- * artifacts that cannot be fixed (e.g., WU-307, WU-311, WU-1152).
- *
- * @param {string} id - WU ID to check
- * @param {string[]|null|undefined} exemptions - List of exempted WU IDs from config
- * @returns {boolean} True if the WU is exempted
- *
- * @example
- * isExemptedFromStampStatusCheck('WU-307', ['WU-307', 'WU-311']) // true
- * isExemptedFromStampStatusCheck('WU-999', ['WU-307', 'WU-311']) // false
- */
-export function isExemptedFromStampStatusCheck(id, exemptions) {
-    if (!id || !exemptions || !Array.isArray(exemptions)) {
-        return false;
-    }
-    return exemptions.includes(id);
-}
-/**
- * Determine if a WU should be exempted from stamp-status validation.
- *
- * A WU is exempted if:
- * 1. It's explicitly listed in the config exemptions, OR
- * 2. It's a legacy stamped WU (has stamp but status != done) AND has a legacy parent-only lane
- *
- * @param {object} wu - The parsed WU YAML object
- * @param {Set<string>} stampedIds - Set of WU IDs that have .done stamp files
- * @param {string[]} exemptions - List of exempted WU IDs from config
- * @returns {{ exempted: boolean, reason: string|null }} Whether exempted and why
- */
-export function shouldExemptFromStampStatusCheck(wu, stampedIds, exemptions = []) {
-    const id = wu?.id;
-    // Check config exemption first
-    if (isExemptedFromStampStatusCheck(id, exemptions)) {
-        return { exempted: true, reason: 'config exemption' };
-    }
-    // Check if it's a legacy stamped WU with a legacy lane
-    if (isLegacyStampedWU(wu, stampedIds)) {
-        const lane = wu.lane;
-        if (isLegacyParentOnlyLane(lane)) {
-            return { exempted: true, reason: 'legacy parent-only lane with stamp' };
-        }
-    }
-    return { exempted: false, reason: null };
-}
-//# sourceMappingURL=stamp-status-validator.js.map

package/dist/stamp-status-validator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stamp-status-validator.js","sourceRoot":"","sources":["../src/stamp-status-validator.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,cAAc;IACd,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,WAAW;CACZ,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAe;IACpD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAEnC,wEAAwE;IACxE,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;IAC/C,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAa,EAAE,UAAqB;IACpE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oBAAoB;IACpB,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sCAAsC;IACtC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;IACzB,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yDAAyD;IACzD,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+CAA+C;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,8BAA8B,CAAC,EAAa,EAAE,UAAqB;IACjF,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gCAAgC,CAC9C,EAAa,EACb,UAAqB,EACrB,UAAU,GAAG,EAAE;IAEf,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IAElB,+BAA+B;IAC/B,IAAI,8BAA8B,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC;QACnD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACxD,CAAC;IAED,uDAAuD;IACvD,IAAI,iBAAiB,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC;QACrB,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC3C,CAAC"}

package/dist/stamp-tracking.d.ts

@@ -1,12 +0,0 @@
-interface TrackedStampOptions {
-    projectRoot: string;
-    stampsDir: string;
-    gitRaw?: (args: string[]) => Promise<string>;
-}
-/**
- * Return tracked WU stamp IDs from git index.
- * Returns null when git query is unavailable so callers can safely fall back.
- */
-export declare function listTrackedWUStampIds({ projectRoot, stampsDir, gitRaw, }: TrackedStampOptions): Promise<Set<string> | null>;
-export {};
-//# sourceMappingURL=stamp-tracking.d.ts.map

package/dist/stamp-tracking.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stamp-tracking.d.ts","sourceRoot":"","sources":["../src/stamp-tracking.ts"],"names":[],"mappings":"AAMA,UAAU,mBAAmB;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAeD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,WAAW,EACX,SAAS,EACT,MAAM,GACP,EAAE,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAmBnD"}