@lumenflow/cli 3.1.1 → 3.1.3

package/dist/orchestrate-initiative.js

@@ -16,9 +16,8 @@ import chalk from 'chalk';
 import { loadInitiativeWUs, loadMultipleInitiatives, buildExecutionPlanWithLockPolicy, resolveLaneConfigsFromConfig, formatExecutionPlan, formatExecutionPlanWithEmbeddedSpawns, calculateProgress, formatProgress, buildCheckpointWave, formatCheckpointOutput, validateCheckpointFlags, resolveCheckpointModeAsync, LOG_PREFIX, } from '@lumenflow/initiatives';
 import { EXIT_CODES } from '@lumenflow/core/wu-constants';
 import { getConfig } from '@lumenflow/core/config';
-function getErrorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
+import { getErrorMessage, ProcessExitError } from '@lumenflow/core/error-handler';
+import { runCLI } from './cli-entry-point.js';
 const program = new Command()
     .name('orchestrate-initiative')
     .description('Orchestrate initiative execution with parallel agent spawning')
@@ -34,16 +33,18 @@ const program = new Command()
         validateCheckpointFlags({ checkpointPerWave, dryRun, noCheckpoint });
     }
     catch (error) {
-        console.error(chalk.red(`${LOG_PREFIX} Error: ${getErrorMessage(error)}`));
-        process.exit(EXIT_CODES.ERROR);
+        const message = `${LOG_PREFIX} Error: ${getErrorMessage(error)}`;
+        console.error(chalk.red(message));
+        throw new ProcessExitError(message, EXIT_CODES.ERROR);
     }
     if (!initIds || initIds.length === 0) {
-        console.error(chalk.red(`${LOG_PREFIX} Error: --initiative is required`));
+        const message = `${LOG_PREFIX} Error: --initiative is required`;
+        console.error(chalk.red(message));
         console.error('');
         console.error('Usage:');
         console.error('  pnpm orchestrate:initiative --initiative INIT-001');
         console.error('  pnpm orchestrate:initiative --initiative INIT-001 --dry-run');
-        process.exit(EXIT_CODES.ERROR);
+        throw new ProcessExitError(message, EXIT_CODES.ERROR);
     }
     try {
         console.log(chalk.cyan(`${LOG_PREFIX} Loading initiative(s): ${initIds.join(', ')}`));
@@ -70,8 +71,9 @@ const program = new Command()
         const checkpointDecision = await resolveCheckpointModeAsync({ checkpointPerWave, noCheckpoint, dryRun }, wus);
         if (checkpointDecision.enabled) {
             if (initIds.length > 1) {
-                console.error(chalk.red(`${LOG_PREFIX} Error: Checkpoint mode only supports single initiative`));
-                process.exit(EXIT_CODES.ERROR);
+                const message = `${LOG_PREFIX} Error: Checkpoint mode only supports single initiative`;
+                console.error(chalk.red(message));
+                throw new ProcessExitError(message, EXIT_CODES.ERROR);
             }
             const waveData = buildCheckpointWave(initIds[0], { dryRun });
             if (!waveData) {
@@ -139,9 +141,18 @@ const program = new Command()
         console.log(chalk.cyan('Copy the spawn XML above to execute agents.'));
     }
     catch (error) {
-        console.error(chalk.red(`${LOG_PREFIX} Error: ${getErrorMessage(error)}`));
-        process.exit(EXIT_CODES.ERROR);
+        if (error instanceof ProcessExitError) {
+            throw error;
+        }
+        const message = `${LOG_PREFIX} Error: ${getErrorMessage(error)}`;
+        console.error(chalk.red(message));
+        throw new ProcessExitError(message, EXIT_CODES.ERROR);
     }
 });
-program.parse();
+export async function main() {
+    await program.parseAsync(process.argv);
+}
+if (import.meta.main) {
+    void runCLI(main);
+}
 //# sourceMappingURL=orchestrate-initiative.js.map

package/dist/orchestrate-monitor.js

@@ -25,8 +25,10 @@ import { Command } from 'commander';
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { EXIT_CODES, LUMENFLOW_PATHS, DelegationRegistryStore, analyzeDelegations, detectStuckDelegations, checkZombieLocks, generateSuggestions, formatMonitorOutput, formatRecoveryResults, runRecovery, processDelegationFailureSignals, formatSignalHandlerOutput, DEFAULT_THRESHOLD_MINUTES, calculateBackoff, } from '@lumenflow/core';
+import { ProcessExitError } from '@lumenflow/core/error-handler';
 import chalk from 'chalk';
 import ms, {} from 'ms';
+import { runCLI } from './cli-entry-point.js';
 // ============================================================================
 // WU-1242: Watch Mode Constants
 // ============================================================================
@@ -187,8 +189,9 @@ async function runDelegationMonitoring(opts) {
     const baseDir = process.cwd();
     const thresholdMinutes = parseInt(opts.threshold, 10);
     if (isNaN(thresholdMinutes) || thresholdMinutes <= 0) {
-        console.error(chalk.red(`${LOG_PREFIX} Invalid threshold: ${opts.threshold}`));
-        process.exit(EXIT_CODES.FAILURE);
+        const message = `${LOG_PREFIX} Invalid threshold: ${opts.threshold}`;
+        console.error(chalk.red(message));
+        throw new ProcessExitError(message, EXIT_CODES.FAILURE);
     }
     console.log(chalk.cyan(`${LOG_PREFIX} Analyzing delegation health...`));
     console.log(chalk.gray(`  Threshold: ${thresholdMinutes} minutes`));
@@ -209,7 +212,7 @@ async function runDelegationMonitoring(opts) {
         console.log(formatSignalHandlerOutput(signalResult));
     }
     if (result.stuckDelegations.length > 0 || result.zombieLocks.length > 0) {
-        process.exit(EXIT_CODES.ERROR);
+        throw new ProcessExitError(`${LOG_PREFIX} Delegation monitor detected stuck delegations or zombie locks.`, EXIT_CODES.ERROR);
     }
 }
 /**
@@ -378,8 +381,9 @@ async function runWatchMode(opts) {
     const baseDir = process.cwd();
     const thresholdMinutes = parseInt(opts.threshold, 10);
     if (isNaN(thresholdMinutes) || thresholdMinutes <= 0) {
-        console.error(chalk.red(`${LOG_PREFIX} Invalid threshold: ${opts.threshold}`));
-        process.exit(EXIT_CODES.FAILURE);
+        const message = `${LOG_PREFIX} Invalid threshold: ${opts.threshold}`;
+        console.error(chalk.red(message));
+        throw new ProcessExitError(message, EXIT_CODES.FAILURE);
     }
     const watchOptions = parseWatchOptions(opts);
     console.log(chalk.cyan(`${LOG_PREFIX} Starting continuous patrol mode...`));
@@ -403,7 +407,7 @@ async function runWatchMode(opts) {
     // Handle graceful shutdown
     const shutdown = () => {
         runner.stop();
-        process.exit(0);
+        process.exitCode = EXIT_CODES.SUCCESS;
     };
     process.on('SIGINT', shutdown);
     process.on('SIGTERM', shutdown);
@@ -438,10 +442,18 @@ const program = new Command()
         await runDelegationMonitoring(opts);
     }
     catch (err) {
+        if (err instanceof ProcessExitError) {
+            throw err;
+        }
         const message = err instanceof Error ? err.message : String(err);
         console.error(chalk.red(`${LOG_PREFIX} Error: ${message}`));
-        process.exit(EXIT_CODES.ERROR);
+        throw new ProcessExitError(message, EXIT_CODES.ERROR);
     }
 });
-program.parse();
+export async function main() {
+    await program.parseAsync(process.argv);
+}
+if (import.meta.main) {
+    void runCLI(main);
+}
 //# sourceMappingURL=orchestrate-monitor.js.map

package/dist/pack-scaffold.js

@@ -112,7 +112,7 @@ LumenFlow domain pack - version ${version}
 
 ## Overview
 
-This pack provides domain-specific tools and policies for the LumenFlow kernel.
+This pack provides pack-specific tools and policies for the LumenFlow kernel.
 
 ## Structure
 

package/dist/plan-create.js

@@ -139,7 +139,7 @@ export function getCommitMessage(id, title) {
     const idLower = id.toLowerCase();
     return `docs: create plan for ${idLower} - ${title}`;
 }
-async function main() {
+export async function main() {
     const args = createWUParser({
         name: 'plan-create',
         description: 'Create a new plan file in repo plansDir',
@@ -195,6 +195,4 @@ import { runCLI } from './cli-entry-point.js';
 if (import.meta.main) {
     void runCLI(main);
 }
-// Export for testing
-export { main };
 //# sourceMappingURL=plan-create.js.map

package/dist/plan-edit.js

@@ -164,7 +164,7 @@ export function getCommitMessage(id, section) {
     const idLower = id.toLowerCase();
     return `docs: update ${section} section in ${idLower} plan`;
 }
-async function main() {
+export async function main() {
     const SECTION_OPTION = {
         name: 'section',
         flags: '--section <name>',
@@ -257,6 +257,4 @@ import { runCLI } from './cli-entry-point.js';
 if (import.meta.main) {
     void runCLI(main);
 }
-// Export for testing
-export { main };
 //# sourceMappingURL=plan-edit.js.map

package/dist/plan-link.js

@@ -200,7 +200,7 @@ export function getCommitMessage(id, planUri) {
     const filename = planUri.replace(PLAN_URI_SCHEME, '');
     return `docs: link plan ${filename} to ${idLower}`;
 }
-async function main() {
+export async function main() {
     const PLAN_OPTION = {
         name: 'plan',
         flags: '--plan <uri>',
@@ -269,6 +269,4 @@ import { runCLI } from './cli-entry-point.js';
 if (import.meta.main) {
     void runCLI(main);
 }
-// Export for testing
-export { main };
 //# sourceMappingURL=plan-link.js.map

package/dist/plan-promote.js

@@ -154,7 +154,7 @@ export function getCommitMessage(id) {
     const idLower = id.toLowerCase();
     return `docs: promote ${idLower} plan to approved`;
 }
-async function main() {
+export async function main() {
     const FORCE_OPTION = {
         name: 'force',
         flags: '-f, --force',
@@ -227,6 +227,4 @@ import { runCLI } from './cli-entry-point.js';
 if (import.meta.main) {
     void runCLI(main);
 }
-// Export for testing
-export { main };
 //# sourceMappingURL=plan-promote.js.map

package/dist/release.js

@@ -317,7 +317,7 @@ export async function pushTagWithForce(git, tagName, reason = 'release: tag push
  * Main release function
  * WU-1085: Renamed --version to --release-version to avoid conflict with CLI --version flag
  */
-async function main() {
+export async function main() {
     const program = new Command()
         .name('lumenflow-release')
         .description('Release @lumenflow/* packages to npm with version bump, tag, and publish')
@@ -468,8 +468,6 @@ async function main() {
         console.log(`  - Verify packages: npm view @lumenflow/cli version`);
     }
 }
-// Export for testing
-export { main };
 // Guard main() for testability
 if (import.meta.main) {
     void runCLI(main);

package/dist/signal-cleanup.js

@@ -29,6 +29,7 @@ import { cleanupSignals } from '@lumenflow/memory/signal-cleanup-core';
 import { createWUParser } from '@lumenflow/core/arg-parser';
 import { EXIT_CODES, LUMENFLOW_PATHS, PROTECTED_WU_STATUSES } from '@lumenflow/core/wu-constants';
 import { getConfig } from '@lumenflow/core/config';
+import { formatBytes } from './constants.js';
 import { runCLI } from './cli-entry-point.js';
 /**
  * Log prefix for signal:cleanup output
@@ -38,10 +39,7 @@ const LOG_PREFIX = '[signal:cleanup]';
  * Tool name for audit logging
  */
 const TOOL_NAME = 'signal:cleanup';
-/**
- * Bytes per KB for formatting
- */
-const BYTES_PER_KB = 1024;
+// WU-2044: BYTES_PER_KB imported from ./constants.js
 /**
  * CLI argument options specific to signal:cleanup
  */
@@ -100,19 +98,7 @@ async function writeAuditLog(baseDir, entry) {
         // Audit logging is non-fatal - silently ignore errors
     }
 }
-/**
- * Format bytes as human-readable string
- *
- * @param bytes - Number of bytes
- * @returns Formatted string (e.g., "1.5 KB")
- */
-function formatBytes(bytes) {
-    if (bytes < BYTES_PER_KB) {
-        return `${bytes} B`;
-    }
-    const kb = (bytes / BYTES_PER_KB).toFixed(1);
-    return `${kb} KB`;
-}
+// WU-2044: formatBytes imported from ./constants.js
 /**
  * Format compaction ratio as percentage
  *
@@ -227,7 +213,7 @@ function printResult(result, quiet) {
 /**
  * Main CLI entry point
  */
-async function main() {
+export async function main() {
     const args = parseArguments();
     const baseDir = args.baseDir || process.cwd();
     const startedAt = new Date().toISOString();

package/dist/state-bootstrap.js

@@ -18,7 +18,8 @@ import path from 'node:path';
 import { parse as parseYaml } from 'yaml';
 import { readFileSync } from 'node:fs';
 import { WU_PATHS } from '@lumenflow/core/wu-paths';
-import { CLI_FLAGS, EXIT_CODES, EMOJI, STRING_LITERALS } from '@lumenflow/core/wu-constants';
+import { CLI_FLAGS, EXIT_CODES, EMOJI, STRING_LITERALS, WU_STATUS, } from '@lumenflow/core/wu-constants';
+import { WU_EVENT_TYPE } from '@lumenflow/core/wu-state-schema';
 /** Log prefix for consistent output */
 const LOG_PREFIX = '[state-bootstrap]';
 /**
@@ -99,36 +100,38 @@ function toTimestamp(dateStr, fallback) {
 export function inferEventsFromWu(wu) {
     const events = [];
     // Ready WUs have no events (not yet in the lifecycle)
-    if (wu.status === 'ready' || wu.status === 'backlog' || wu.status === 'todo') {
+    if (wu.status === WU_STATUS.READY ||
+        wu.status === WU_STATUS.BACKLOG ||
+        wu.status === WU_STATUS.TODO) {
         return events;
     }
     // All other states start with a claim event
     const claimTimestamp = toTimestamp(wu.claimed_at, wu.created);
     events.push({
-        type: 'claim',
+        type: WU_EVENT_TYPE.CLAIM,
         wuId: wu.id,
         lane: wu.lane,
         title: wu.title,
         timestamp: claimTimestamp,
     });
     // Handle completed/done status
-    if (wu.status === 'done' || wu.status === 'completed') {
+    if (wu.status === WU_STATUS.DONE || wu.status === WU_STATUS.COMPLETED) {
         const completeTimestamp = toTimestamp(wu.completed_at, wu.created);
         events.push({
-            type: 'complete',
+            type: WU_EVENT_TYPE.COMPLETE,
             wuId: wu.id,
             timestamp: completeTimestamp,
         });
         return events;
     }
     // Handle blocked status
-    if (wu.status === 'blocked') {
+    if (wu.status === WU_STATUS.BLOCKED) {
         // Block event timestamp should be after claim
         // We don't have exact block time, so use claim time + 1 second
         const claimDate = new Date(claimTimestamp);
         claimDate.setSeconds(claimDate.getSeconds() + 1);
         events.push({
-            type: 'block',
+            type: WU_EVENT_TYPE.BLOCK,
             wuId: wu.id,
             timestamp: claimDate.toISOString(),
             reason: 'Bootstrapped from WU YAML (original reason unknown)',
@@ -266,7 +269,7 @@ Supported WU statuses:
 /**
  * Main function
  */
-async function main() {
+export async function main() {
     const args = parseStateBootstrapArgs(process.argv);
     if (args.help) {
         printHelp();

package/dist/state-cleanup.js

@@ -12,7 +12,7 @@
  * Cleanup order: signals -> memory -> events (dependency order)
  *
  * Features:
- * - Respects config from .lumenflow.config.yaml
+ * - Respects config from workspace.yaml
  * - Supports --dry-run for preview
  * - Supports --signals-only, --memory-only, --events-only for selective cleanup
  * - Non-fatal: warns on errors but continues with other cleanups
@@ -40,6 +40,7 @@ import { EXIT_CODES, LUMENFLOW_PATHS, PROTECTED_WU_STATUSES } from '@lumenflow/c
 import { getConfig } from '@lumenflow/core/config';
 import fg from 'fast-glob';
 import { parse as parseYaml } from 'yaml';
+import { formatBytes } from './constants.js';
 import { runCLI } from './cli-entry-point.js';
 /**
  * Log prefix for state:cleanup output
@@ -49,10 +50,7 @@ const LOG_PREFIX = '[state:cleanup]';
  * Tool name for audit logging
  */
 const TOOL_NAME = 'state:cleanup';
-/**
- * Bytes per KB for formatting
- */
-const BYTES_PER_KB = 1024;
+// WU-2044: BYTES_PER_KB imported from ./constants.js
 /**
  * Labels for output formatting
  */
@@ -117,19 +115,7 @@ async function writeAuditLog(baseDir, entry) {
         // Audit logging is non-fatal - silently ignore errors
     }
 }
-/**
- * Format bytes as human-readable string
- *
- * @param bytes - Number of bytes
- * @returns Formatted string (e.g., "1.5 KB")
- */
-function formatBytes(bytes) {
-    if (bytes < BYTES_PER_KB) {
-        return `${bytes} B`;
-    }
-    const kb = (bytes / BYTES_PER_KB).toFixed(1);
-    return `${kb} KB`;
-}
+// WU-2044: formatBytes imported from ./constants.js
 /**
  * Get active WU IDs (in_progress or blocked) by scanning WU YAML files.
  *
@@ -264,7 +250,7 @@ function printResult(result, quiet) {
 /**
  * Main CLI entry point
  */
-async function main() {
+export async function main() {
     const args = parseArguments();
     const baseDir = args.baseDir || process.cwd();
     const startedAt = new Date().toISOString();