@lumenflow/cli 2.20.1 → 2.21.1

package/dist/__tests__/wu-validate-strict.test.js

@@ -1,113 +0,0 @@
-/**
- * @file wu-validate-strict.test.ts
- * Test suite for wu:validate strict validation behavior (WU-1329)
- *
- * WU-1329: Make wu:validate treat warnings as errors by default
- *
- * Tests:
- * - Default strict mode behavior (warnings treated as errors)
- * - --no-strict flag restores original behavior (warnings advisory)
- * - Help text documents strict default
- */
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { WU_OPTIONS, NEGATED_OPTIONS } from '@lumenflow/core/dist/arg-parser.js';
-describe('wu:validate strict validation (WU-1329)', () => {
-    describe('WU_OPTIONS.noStrict configuration', () => {
-        // WU-1329: Verify the noStrict option is properly configured
-        it('should have noStrict option defined in WU_OPTIONS', () => {
-            expect(WU_OPTIONS.noStrict).toBeDefined();
-            expect(WU_OPTIONS.noStrict.name).toBe('noStrict');
-            expect(WU_OPTIONS.noStrict.flags).toBe('--no-strict');
-            expect(WU_OPTIONS.noStrict.isNegated).toBe(true);
-        });
-        it('should include description about bypassing strict validation', () => {
-            expect(WU_OPTIONS.noStrict.description).toContain('Bypass strict validation');
-        });
-        // WU-1329: Verify 'strict' is in NEGATED_OPTIONS array
-        it('should include strict in NEGATED_OPTIONS array', () => {
-            expect(NEGATED_OPTIONS).toContain('strict');
-        });
-    });
-    describe('strict mode logic', () => {
-        // WU-1329: Verify the strict mode conversion pattern
-        it('should default to strict=true when noStrict is undefined', () => {
-            const args = { noStrict: undefined };
-            const strict = !args.noStrict;
-            expect(strict).toBe(true);
-        });
-        it('should set strict=false when noStrict is true (--no-strict flag)', () => {
-            const args = { noStrict: true };
-            const strict = !args.noStrict;
-            expect(strict).toBe(false);
-        });
-        it('should set strict=true when noStrict is false (explicit)', () => {
-            const args = { noStrict: false };
-            const strict = !args.noStrict;
-            expect(strict).toBe(true);
-        });
-    });
-    describe('--no-strict logging behavior', () => {
-        let consoleSpy;
-        beforeEach(() => {
-            consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
-        });
-        afterEach(() => {
-            consoleSpy.mockRestore();
-        });
-        // WU-1329: The logging behavior is implemented in main() functions
-        // This test documents the expected behavior pattern using the spy
-        it('should log when --no-strict bypass is used', () => {
-            // Simulate the logging pattern from wu-validate.ts main()
-            const noStrict = true;
-            const LOG_PREFIX = '[wu:validate]';
-            const message = `${LOG_PREFIX} WARNING: strict validation bypassed (--no-strict). Warnings will be advisory only.`;
-            if (noStrict) {
-                // Use the spy to simulate logging
-                consoleSpy(message);
-            }
-            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('strict validation bypassed'));
-        });
-        it('should not log when strict mode is active', () => {
-            // When noStrict is false, no logging should occur
-            const noStrict = false;
-            if (noStrict) {
-                consoleSpy('This should not be called');
-            }
-            expect(consoleSpy).not.toHaveBeenCalled();
-        });
-    });
-    describe('validateSingleWU strict mode behavior', () => {
-        // WU-1329: These tests document the expected behavior
-        // The actual validation is done by calling the CLI command
-        it('should treat warnings as errors by default (strict=true)', () => {
-            // In strict mode, any warnings from completeness validation
-            // should become errors and cause validation to fail
-            const strict = true;
-            const warnings = ['Missing recommended field: notes'];
-            const errors = [];
-            if (strict && warnings.length > 0) {
-                errors.push(...warnings.map((w) => `[STRICT] ${w}`));
-            }
-            expect(errors.length).toBeGreaterThan(0);
-            expect(errors[0]).toContain('[STRICT]');
-        });
-        it('should allow warnings when strict=false (--no-strict)', () => {
-            // In non-strict mode, warnings should remain warnings
-            // and validation should pass
-            const strict = false;
-            const warnings = ['Missing recommended field: notes'];
-            const errors = [];
-            if (strict && warnings.length > 0) {
-                errors.push(...warnings.map((w) => `[STRICT] ${w}`));
-            }
-            expect(errors.length).toBe(0);
-        });
-    });
-    describe('help text documentation', () => {
-        // WU-1329: Verify help text documents strict default
-        it('should document that --no-strict bypasses strict validation', () => {
-            const expectedDescription = 'Bypass strict validation';
-            expect(WU_OPTIONS.noStrict.description).toContain(expectedDescription);
-        });
-    });
-});

package/dist/__tests__/wu-validate.test.js

@@ -1,36 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { summarizeValidationResults } from '../wu-validate.js';
-describe('wu:validate JSON summary (WU-1441)', () => {
-    it('should summarize invalid WUs with totals', () => {
-        const results = [
-            { wuId: 'WU-1', valid: true, warnings: [], errors: [] },
-            { wuId: 'WU-2', valid: false, warnings: [], errors: ['[STRICT] Missing notes'] },
-        ];
-        const summary = summarizeValidationResults(results);
-        expect(summary.valid).toBe(false);
-        expect(summary.totalValid).toBe(1);
-        expect(summary.totalInvalid).toBe(1);
-        expect(summary.totalWarnings).toBe(0);
-        expect(summary.invalid).toEqual([
-            {
-                wuId: 'WU-2',
-                errors: ['[STRICT] Missing notes'],
-            },
-        ]);
-    });
-    it('should include warnings per WU', () => {
-        const results = [
-            { wuId: 'WU-3', valid: true, warnings: ['Warn'], errors: [] },
-            { wuId: 'WU-4', valid: true, warnings: [], errors: [] },
-        ];
-        const summary = summarizeValidationResults(results);
-        expect(summary.valid).toBe(true);
-        expect(summary.totalWarnings).toBe(1);
-        expect(summary.warnings).toEqual([
-            {
-                wuId: 'WU-3',
-                warnings: ['Warn'],
-            },
-        ]);
-    });
-});

package/dist/spawn-list.js

@@ -1,143 +0,0 @@
-#!/usr/bin/env node
-/**
- * Spawn List Command (WU-1950)
- *
- * Displays spawn trees for WUs or initiatives.
- * WU-1604: Includes explicit delegation lineage records from wu:delegate.
- * Shows parent-child relationships with status indicators.
- *
- * Usage:
- *   pnpm spawn:list --wu WU-XXX          # Spawns for a specific WU
- *   pnpm spawn:list --initiative INIT-XXX # All spawns in an initiative
- *   pnpm spawn:list --json               # JSON output
- *
- * @see {@link packages/@lumenflow/cli/src/lib/spawn-tree.ts} - Tree builder
- * @see {@link packages/@lumenflow/cli/src/__tests__/spawn-list.test.ts} - Tests
- */
-import { createWUParser, WU_OPTIONS } from '@lumenflow/core/arg-parser';
-import { die } from '@lumenflow/core/error-handler';
-import { PATTERNS, LUMENFLOW_PATHS } from '@lumenflow/core/wu-constants';
-import { WU_PATHS } from '@lumenflow/core/wu-paths';
-/** Local EMOJI constants for spawn-list output */
-const EMOJI = {
-    WARNING: '⚠️',
-    ERROR: '❌',
-};
-/** Custom options for spawn-list command */
-const SPAWN_LIST_OPTIONS = {
-    initiative: {
-        name: 'initiative',
-        flags: '--initiative <initId>',
-        description: 'Initiative ID to show all spawns for (e.g., INIT-001)',
-    },
-    json: {
-        name: 'json',
-        flags: '--json',
-        description: 'Output as JSON',
-        default: false,
-    },
-};
-import { buildSpawnTree, formatSpawnTree, getSpawnsByWU, getSpawnsByInitiative, treeToJSON, STATUS_INDICATORS, } from '@lumenflow/core/spawn-tree';
-import { SpawnStatus } from '@lumenflow/core/spawn-registry-schema';
-import { runCLI } from './cli-entry-point.js';
-const LOG_PREFIX = '[spawn:list]';
-/** Default paths for spawn registry and WU files (WU-1301: uses config-based paths) */
-const DEFAULT_PATHS = Object.freeze({
-    REGISTRY_DIR: LUMENFLOW_PATHS.STATE_DIR,
-    WU_DIR: WU_PATHS.WU_DIR(),
-});
-/** Initiative ID pattern */
-const INIT_PATTERN = /^INIT-\d+$/;
-/**
- * Prints the legend for status indicators
- */
-function printLegend() {
-    console.log('\nLegend:');
-    console.log(`  ${STATUS_INDICATORS[SpawnStatus.PENDING]} pending`);
-    console.log(`  ${STATUS_INDICATORS[SpawnStatus.COMPLETED]} completed`);
-    console.log(`  ${STATUS_INDICATORS[SpawnStatus.TIMEOUT]} timeout`);
-    console.log(`  ${STATUS_INDICATORS[SpawnStatus.CRASHED]} crashed`);
-}
-/**
- * Main entry point
- */
-async function main() {
-    const args = createWUParser({
-        name: 'spawn-list',
-        description: 'Display spawn trees for WUs or initiatives',
-        options: [WU_OPTIONS.wu, SPAWN_LIST_OPTIONS.initiative, SPAWN_LIST_OPTIONS.json],
-        required: [],
-        allowPositionalId: false,
-    });
-    const { wu, initiative, json } = args;
-    // Validate: exactly one of --wu or --initiative required
-    if (!wu && !initiative) {
-        die('Either --wu or --initiative is required.\n\nUsage:\n  pnpm spawn:list --wu WU-XXX\n  pnpm spawn:list --initiative INIT-XXX');
-    }
-    if (wu && initiative) {
-        die('Cannot specify both --wu and --initiative. Choose one.');
-    }
-    // Handle --wu
-    if (wu) {
-        const wuId = wu.toUpperCase();
-        if (!PATTERNS.WU_ID.test(wuId)) {
-            die(`Invalid WU ID format: ${wu}. Expected format: WU-XXX`);
-        }
-        const spawns = await getSpawnsByWU(wuId, DEFAULT_PATHS.REGISTRY_DIR);
-        if (json) {
-            const tree = buildSpawnTree(spawns, wuId);
-            console.log(JSON.stringify(treeToJSON(tree), null, 2));
-            return;
-        }
-        if (spawns.length === 0) {
-            console.log(`${LOG_PREFIX} ${EMOJI.WARNING} No spawns found for ${wuId}`);
-            console.log(`\n${wuId} (root)`);
-            console.log('  (no spawns)');
-            return;
-        }
-        console.log(`${LOG_PREFIX} Spawn tree for ${wuId}:\n`);
-        const tree = buildSpawnTree(spawns, wuId);
-        console.log(formatSpawnTree(tree));
-        printLegend();
-        console.log(`\nTotal: ${spawns.length} spawn(s)`);
-        return;
-    }
-    // Handle --initiative
-    if (initiative) {
-        const initId = initiative.toUpperCase();
-        if (!INIT_PATTERN.test(initId)) {
-            die(`Invalid initiative ID format: ${initiative}. Expected format: INIT-XXX`);
-        }
-        const spawns = await getSpawnsByInitiative(initId, DEFAULT_PATHS.REGISTRY_DIR, DEFAULT_PATHS.WU_DIR);
-        if (json) {
-            // For initiative, output flat list since there may be multiple root WUs
-            console.log(JSON.stringify(spawns, null, 2));
-            return;
-        }
-        if (spawns.length === 0) {
-            console.log(`${LOG_PREFIX} ${EMOJI.WARNING} No spawns found for ${initId}`);
-            return;
-        }
-        // Group spawns by parent WU and display trees
-        console.log(`${LOG_PREFIX} Spawns for ${initId}:\n`);
-        // Find unique root WUs (parents that are not targets of other spawns)
-        const typedSpawns = spawns;
-        const targetWuIds = new Set(typedSpawns.map((s) => s.targetWuId));
-        const rootWuIds = [...new Set(typedSpawns.map((s) => s.parentWuId))].filter((id) => !targetWuIds.has(id));
-        for (const rootWuId of rootWuIds) {
-            const tree = buildSpawnTree(spawns, rootWuId);
-            console.log(formatSpawnTree(tree));
-            console.log('');
-        }
-        printLegend();
-        console.log(`\nTotal: ${spawns.length} spawn(s) across ${rootWuIds.length} root WU(s)`);
-    }
-}
-// WU-1181: Use import.meta.main instead of process.argv[1] comparison
-// The old pattern fails with pnpm symlinks because process.argv[1] is the symlink
-// path but import.meta.url resolves to the real path - they never match
-// WU-1537: Use import.meta.main + runCLI for consistent EPIPE and error handling
-if (import.meta.main) {
-    void runCLI(main);
-}
-//# sourceMappingURL=spawn-list.js.map

package/dist/spawn-list.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn-list.js","sourceRoot":"","sources":["../src/spawn-list.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,kDAAkD;AAClD,MAAM,KAAK,GAAG;IACZ,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,GAAG;CACX,CAAC;AAEF,4CAA4C;AAC5C,MAAM,kBAAkB,GAAG;IACzB,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,uDAAuD;KACrE;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,KAAK;KACf;CACF,CAAC;AACF,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAa9C,MAAM,UAAU,GAAG,cAAc,CAAC;AAElC,uFAAuF;AACvF,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,YAAY,EAAE,eAAe,CAAC,SAAS;IACvC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,4BAA4B;AAC5B,MAAM,YAAY,GAAG,YAAY,CAAC;AAElC;;GAEG;AACH,SAAS,WAAW;IAClB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,KAAK,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,KAAK,iBAAiB,CAAC,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,KAAK,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,KAAK,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,cAAc,CAAC;QAC1B,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,CAAC,IAAI,CAAC;QAChF,QAAQ,EAAE,EAAE;QACZ,iBAAiB,EAAE,KAAK;KACzB,CAAC,CAAC;IAEH,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEtC,yDAAyD;IACzD,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACvB,GAAG,CACD,4HAA4H,CAC7H,CAAC;IACJ,CAAC;IAED,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;QACrB,GAAG,CAAC,wDAAwD,CAAC,CAAC;IAChE,CAAC;IAED,cAAc;IACd,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,yBAAyB,EAAE,2BAA2B,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;QAErE,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,KAAK,CAAC,OAAO,wBAAwB,IAAI,EAAE,CAAC,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,mBAAmB,IAAI,KAAK,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,WAAW,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IAED,sBAAsB;IACtB,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,iCAAiC,UAAU,6BAA6B,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,qBAAqB,CACxC,MAAM,EACN,aAAa,CAAC,YAAY,EAC1B,aAAa,CAAC,MAAM,CACrB,CAAC;QAEF,IAAI,IAAI,EAAE,CAAC;YACT,wEAAwE;YACxE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,KAAK,CAAC,OAAO,wBAAwB,MAAM,EAAE,CAAC,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,8CAA8C;QAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,eAAe,MAAM,KAAK,CAAC,CAAC;QAErD,sEAAsE;QACtE,MAAM,WAAW,GAAG,MAAsB,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CACzE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAC7B,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAED,WAAW,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,oBAAoB,SAAS,CAAC,MAAM,aAAa,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,kFAAkF;AAClF,wEAAwE;AACxE,iFAAiF;AACjF,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC"}