@lumenflow/cli 3.1.2 → 3.2.0

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

@@ -65,6 +65,14 @@ const CHANGESET_DIR = '.changeset';
 const LUMENFLOW_FORCE_ENV = 'LUMENFLOW_FORCE';
 /** Environment variable to provide reason for force bypass */
 const LUMENFLOW_FORCE_REASON_ENV = 'LUMENFLOW_FORCE_REASON';
+/** Release phase label for pre-release clean-tree validation */
+const RELEASE_CLEAN_CHECK_PHASE_BEFORE_RELEASE = 'before release';
+/** Release phase label for post-publish clean-tree validation */
+const RELEASE_CLEAN_CHECK_PHASE_AFTER_PUBLISH = 'after npm publish';
+/** Command shown when release fails due to dirty working tree */
+const GIT_STATUS_SHORT_COMMAND = 'git status --short';
+/** Guidance shown when generated artifacts dirty the repository */
+const CLEAN_TREE_RECOVERY_GUIDANCE = 'Commit, stash, or clean generated files before retrying release.';
 /**
  * Environment variable for WU tool identification (WU-1296)
  * Pre-push hook checks this to allow approved tool operations
@@ -101,6 +109,22 @@ export async function withReleaseEnv(fn) {
         }
     }
 }
+/**
+ * Assert the current git working tree is clean.
+ *
+ * @param git - Git adapter with cleanliness check
+ * @param phase - Human-readable release phase label
+ */
+export async function assertWorkingTreeClean(git, phase) {
+    const isClean = await git.isClean();
+    if (isClean) {
+        return;
+    }
+    die(`Working directory has uncommitted changes ${phase}.\n\n` +
+        `Run this command to inspect unexpected artifacts:\n` +
+        `  ${GIT_STATUS_SHORT_COMMAND}\n` +
+        `${CLEAN_TREE_RECOVERY_GUIDANCE}`);
+}
 /**
  * Validate that a string is a valid semver version
  *
@@ -317,7 +341,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')
@@ -345,13 +369,7 @@ async function main() {
     const git = getGitForCwd();
     await ensureOnMain(git);
     // Check for uncommitted changes
-    const isClean = await git.isClean();
-    if (!isClean) {
-        die(`Working directory has uncommitted changes.\n\n` +
-            `Commit or stash changes before releasing:\n` +
-            `  git status\n` +
-            `  git stash  # or git commit`);
-    }
+    await assertWorkingTreeClean(git, RELEASE_CLEAN_CHECK_PHASE_BEFORE_RELEASE);
     // Find all @lumenflow/* packages to update
     const packagePaths = findPackageJsonPaths();
     if (packagePaths.length === 0) {
@@ -443,6 +461,7 @@ async function main() {
         else {
             console.log(`${LOG_PREFIX} Publishing packages to npm...`);
             runCommand(`${PKG_MANAGER} -r publish --access public --no-git-checks`, { label: 'publish' });
+            await assertWorkingTreeClean(git, RELEASE_CLEAN_CHECK_PHASE_AFTER_PUBLISH);
             console.log(`${LOG_PREFIX} ✅ Packages published to npm`);
         }
     }
@@ -468,8 +487,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();