@lumenflow/cli 1.0.0

package/dist/mem-inbox.js

@@ -0,0 +1,373 @@
+#!/usr/bin/env node
+/**
+ * Memory Inbox CLI (WU-1474)
+ *
+ * Read coordination signals from other agents for real-time awareness
+ * of parallel agent progress. Filter by lane, WU, or time range.
+ * Supports watch mode for continuous monitoring.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * WU-2202: Added dependency validation before operations to prevent silent
+ * failures when node_modules is corrupted or incomplete.
+ *
+ * Usage:
+ *   pnpm mem:inbox [--lane <name>] [--wu <id>] [--since <time>] [--watch]
+ *
+ * @see {@link tools/lib/mem-signal-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-inbox.test.mjs} - Tests
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import ms from 'ms';
+import { loadSignals, markSignalsAsRead } from '@lumenflow/memory/dist/mem-signal-core.js';
+import { createWUParser, WU_OPTIONS } from '@lumenflow/core/dist/arg-parser.js';
+import { EXIT_CODES } from '@lumenflow/core/dist/wu-constants.js';
+import { validateInboxDependencies, formatDependencyError, } from '@lumenflow/core/dist/dependency-validator.js';
+/**
+ * Log prefix for mem:inbox output
+ */
+const LOG_PREFIX = '[mem:inbox]';
+/**
+ * Tool name for audit logging
+ */
+const TOOL_NAME = 'mem:inbox';
+/**
+ * Audit log file path
+ */
+const AUDIT_LOG_PATH = '.beacon/telemetry/tools.ndjson';
+/**
+ * Watch mode polling interval in milliseconds
+ */
+const WATCH_INTERVAL_MS = 1000;
+/**
+ * CLI argument options specific to mem:inbox
+ */
+const CLI_OPTIONS = {
+    since: {
+        name: 'since',
+        flags: '-s, --since <time>',
+        description: 'Filter signals since time (e.g., "1h", "30m", "2025-12-09")',
+    },
+    watch: {
+        name: 'watch',
+        flags: '-w, --watch',
+        description: 'Continuously monitor for new signals',
+    },
+    quiet: {
+        name: 'quiet',
+        flags: '-q, --quiet',
+        description: 'Suppress output except signal content',
+    },
+    noMark: {
+        name: 'noMark',
+        flags: '--no-mark',
+        description: 'Do not mark signals as read after display',
+        isNegated: true,
+    },
+    count: {
+        name: 'count',
+        flags: '-c, --count',
+        description: 'Output only signal count (lightweight polling for orchestrators)',
+    },
+};
+/**
+ * Write audit log entry for tool execution
+ *
+ * @param {string} baseDir - Base directory
+ * @param {object} entry - Audit log entry
+ */
+async function writeAuditLog(baseDir, entry) {
+    try {
+        const logPath = path.join(baseDir, AUDIT_LOG_PATH);
+        const logDir = path.dirname(logPath);
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- CLI tool creates known directory
+        await fs.mkdir(logDir, { recursive: true });
+        const line = `${JSON.stringify(entry)}\n`;
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- CLI tool writes audit log
+        await fs.appendFile(logPath, line, 'utf-8');
+    }
+    catch {
+        // Audit logging is non-fatal - silently ignore errors
+    }
+}
+/**
+ * Format signal count for --count flag output
+ * WU-2401: Lightweight polling for orchestrators
+ *
+ * @param {number} count - Number of unread signals
+ * @returns {string} Formatted count string
+ */
+export function formatCount(count) {
+    return `${count} unread signal(s)`;
+}
+/**
+ * Parse relative time string to Date object
+ * WU-1849: Replaced custom regex with ms package
+ *
+ * @param {string} timeStr - Time string like "1h", "30m", "2d", or ISO date
+ * @returns {Date} Parsed date
+ */
+export function parseTimeString(timeStr) {
+    // Try using ms package for relative time parsing (e.g., "1h", "30m", "2d", "1d")
+    const msValue = ms(timeStr);
+    if (typeof msValue === 'number') {
+        return new Date(Date.now() - msValue);
+    }
+    // Try ISO date or other date format
+    const date = new Date(timeStr);
+    if (isNaN(date.getTime())) {
+        throw new Error(`Invalid time format: ${timeStr}. Use "1h", "30m", "2d", or ISO date.`);
+    }
+    return date;
+}
+/**
+ * Format a signal for display
+ *
+ * @param {object} signal - Signal object
+ * @returns {string} Formatted signal string
+ */
+function formatSignal(signal) {
+    const timestamp = new Date(signal.created_at).toLocaleString();
+    const scope = [];
+    if (signal.wu_id) {
+        scope.push(signal.wu_id);
+    }
+    if (signal.lane) {
+        scope.push(signal.lane);
+    }
+    const scopeStr = scope.length > 0 ? ` [${scope.join(' | ')}]` : '';
+    const readIndicator = signal.read ? ' (read)' : '';
+    return `${timestamp}${scopeStr}${readIndicator}\n  ${signal.id}: ${signal.message}`;
+}
+/**
+ * Display signals to console
+ *
+ * @param {object[]} signals - Array of signal objects
+ * @param {boolean} quiet - Suppress headers
+ */
+function displaySignals(signals, quiet) {
+    if (signals.length === 0) {
+        if (!quiet) {
+            console.log(`${LOG_PREFIX} No signals found`);
+        }
+        return;
+    }
+    if (!quiet) {
+        console.log(`${LOG_PREFIX} ${signals.length} signal(s)\n`);
+    }
+    for (const signal of signals) {
+        console.log(formatSignal(signal));
+        console.log('');
+    }
+}
+/**
+ * Run inbox check once and optionally mark as read
+ *
+ * @param {string} baseDir - Project base directory
+ * @param {object} options - Filter options
+ * @param {boolean} markAsRead - Whether to mark signals as read
+ * @returns {Promise<object[]>} Signals found
+ */
+async function checkInbox(baseDir, options, markAsRead) {
+    const signals = await loadSignals(baseDir, options);
+    if (markAsRead && signals.length > 0) {
+        const signalIds = signals.map((s) => s.id);
+        await markSignalsAsRead(baseDir, signalIds);
+    }
+    return signals;
+}
+/**
+ * Run watch mode - continuously poll for new signals
+ *
+ * @param {string} baseDir - Project base directory
+ * @param {object} filterOptions - Filter options
+ * @param {boolean} markAsRead - Whether to mark signals as read
+ * @param {boolean} quiet - Suppress headers
+ */
+async function runWatchMode(baseDir, filterOptions, markAsRead, quiet) {
+    if (!quiet) {
+        console.log(`${LOG_PREFIX} Watch mode started (Ctrl+C to exit)\n`);
+    }
+    // Track the last check time to only show new signals
+    let lastCheckTime = new Date();
+    // Initial check with original filters
+    const initialSignals = await checkInbox(baseDir, filterOptions, markAsRead);
+    displaySignals(initialSignals, quiet);
+    // Poll for new signals
+    const poll = async () => {
+        try {
+            // Check for signals since last check, combined with original filters
+            const watchOptions = {
+                ...filterOptions,
+                since: lastCheckTime,
+                unreadOnly: true,
+            };
+            const newSignals = await checkInbox(baseDir, watchOptions, markAsRead);
+            if (newSignals.length > 0) {
+                console.log(`\n${LOG_PREFIX} ${newSignals.length} new signal(s)\n`);
+                displaySignals(newSignals, true);
+            }
+            lastCheckTime = new Date();
+        }
+        catch (error) {
+            console.error(`${LOG_PREFIX} Watch error: ${error.message}`);
+        }
+    };
+    // Set up polling interval
+    const intervalId = globalThis.setInterval(poll, WATCH_INTERVAL_MS);
+    // Handle graceful shutdown
+    const cleanup = () => {
+        globalThis.clearInterval(intervalId);
+        if (!quiet) {
+            console.log(`\n${LOG_PREFIX} Watch mode stopped`);
+        }
+        process.exit(EXIT_CODES.SUCCESS);
+    };
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+}
+/**
+ * Parse CLI arguments
+ *
+ * @returns {object} Parsed arguments
+ */
+function parseArguments() {
+    return createWUParser({
+        name: 'mem-inbox',
+        description: 'Read coordination signals from other agents',
+        options: [
+            WU_OPTIONS.wu,
+            WU_OPTIONS.lane,
+            CLI_OPTIONS.since,
+            CLI_OPTIONS.watch,
+            CLI_OPTIONS.quiet,
+            CLI_OPTIONS.noMark,
+            CLI_OPTIONS.count,
+        ],
+        required: [],
+        allowPositionalId: false,
+    });
+}
+function buildFilterOptions(args) {
+    const filterOptions = {
+        unreadOnly: true, // Default to unread only
+    };
+    if (args.wu) {
+        filterOptions.wuId = args.wu;
+    }
+    if (args.lane) {
+        filterOptions.lane = args.lane;
+    }
+    if (args.since) {
+        filterOptions.since = parseTimeString(args.since);
+    }
+    return filterOptions;
+}
+/**
+ * WU-2401: Run count mode - output only signal count
+ *
+ * @param {string} baseDir - Project base directory
+ * @param {object} filterOptions - Filter options
+ * @returns {Promise<number>} Signal count
+ */
+async function runCountMode(baseDir, filterOptions) {
+    const signals = await loadSignals(baseDir, filterOptions);
+    const count = signals.length;
+    console.log(formatCount(count));
+    return count;
+}
+/**
+ * Run standard check mode - display signals and optionally mark as read
+ *
+ * @param {string} baseDir - Project base directory
+ * @param {object} filterOptions - Filter options
+ * @param {boolean} markAsRead - Whether to mark signals as read
+ * @param {boolean} quiet - Suppress headers
+ * @returns {Promise<number>} Signal count
+ */
+async function runStandardMode(baseDir, filterOptions, markAsRead, quiet) {
+    const signals = await checkInbox(baseDir, filterOptions, markAsRead);
+    displaySignals(signals, quiet);
+    return signals.length;
+}
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    // WU-2202: Validate dependencies BEFORE any other operation
+    const depResult = await validateInboxDependencies();
+    if (!depResult.valid) {
+        console.error(formatDependencyError('mem:inbox', depResult.missing));
+        process.exit(EXIT_CODES.ERROR);
+    }
+    const args = parseArguments();
+    const baseDir = process.cwd();
+    const startedAt = new Date().toISOString();
+    const startTime = Date.now();
+    // Build filter options
+    let filterOptions;
+    try {
+        filterOptions = buildFilterOptions(args);
+    }
+    catch (error) {
+        console.error(`${LOG_PREFIX} Error: ${error.message}`);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    // Validate mode combinations
+    if (args.count && args.watch) {
+        console.error(`${LOG_PREFIX} Error: --count and --watch cannot be used together`);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    // Handle negated --no-mark option (Commander sets mark=false when --no-mark is used)
+    // In count mode, we never mark signals as read (lightweight polling)
+    const markAsRead = args.count ? false : args.mark !== false;
+    let signalCount = 0;
+    let error = null;
+    try {
+        if (args.count) {
+            signalCount = await runCountMode(baseDir, filterOptions);
+        }
+        else if (args.watch) {
+            await runWatchMode(baseDir, filterOptions, markAsRead, args.quiet);
+        }
+        else {
+            signalCount = await runStandardMode(baseDir, filterOptions, markAsRead, args.quiet);
+        }
+    }
+    catch (err) {
+        error = err.message;
+    }
+    const durationMs = Date.now() - startTime;
+    // Log audit entry (only for non-watch mode since watch runs indefinitely)
+    if (!args.watch) {
+        await writeAuditLog(baseDir, {
+            tool: TOOL_NAME,
+            status: error ? 'failed' : 'success',
+            startedAt,
+            completedAt: new Date().toISOString(),
+            durationMs,
+            input: {
+                wuId: args.wu,
+                lane: args.lane,
+                since: args.since,
+                watch: args.watch,
+                quiet: args.quiet,
+                count: args.count,
+                markAsRead,
+            },
+            output: {
+                signalCount,
+            },
+            error: error ? { message: error } : null,
+        });
+    }
+    if (error) {
+        console.error(`${LOG_PREFIX} Error: ${error}`);
+        process.exit(EXIT_CODES.ERROR);
+    }
+}
+main().catch((e) => {
+    console.error(`${LOG_PREFIX} ${e.message}`);
+    process.exit(EXIT_CODES.ERROR);
+});

package/dist/mem-inbox.js.map

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

package/dist/mem-init.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Memory Init CLI (WU-1464)
+ *
+ * Initialize memory layer in the repository.
+ * Creates .beacon/memory/ directory with memory.jsonl and config.yaml.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * Usage:
+ *   pnpm mem:init [--base-dir <path>] [--quiet]
+ *
+ * @see {@link tools/lib/mem-init-core.mjs} - Core logic
+ */
+export {};

package/dist/mem-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-init.d.ts","sourceRoot":"","sources":["../src/mem-init.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}

package/dist/mem-init.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+/**
+ * Memory Init CLI (WU-1464)
+ *
+ * Initialize memory layer in the repository.
+ * Creates .beacon/memory/ directory with memory.jsonl and config.yaml.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * Usage:
+ *   pnpm mem:init [--base-dir <path>] [--quiet]
+ *
+ * @see {@link tools/lib/mem-init-core.mjs} - Core logic
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { initMemory } from '@lumenflow/memory/dist/mem-init-core.js';
+import { createWUParser } from '@lumenflow/core/dist/arg-parser.js';
+import { EXIT_CODES, STRING_LITERALS } from '@lumenflow/core/dist/wu-constants.js';
+/**
+ * Log prefix for mem:init output
+ */
+const LOG_PREFIX = '[mem:init]';
+/**
+ * Tool name for audit logging
+ */
+const TOOL_NAME = 'mem:init';
+/**
+ * Audit log file path
+ */
+const AUDIT_LOG_PATH = '.beacon/telemetry/tools.ndjson';
+/**
+ * Write audit log entry for tool execution
+ *
+ * @param {string} baseDir - Base directory
+ * @param {object} entry - Audit log entry
+ */
+async function writeAuditLog(baseDir, entry) {
+    try {
+        const logPath = path.join(baseDir, AUDIT_LOG_PATH);
+        const logDir = path.dirname(logPath);
+        // Ensure telemetry directory exists
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- CLI tool creates known directory
+        await fs.mkdir(logDir, { recursive: true });
+        // Append NDJSON entry
+        const line = `${JSON.stringify(entry)}\n`;
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- CLI tool writes audit log
+        await fs.appendFile(logPath, line, 'utf-8');
+    }
+    catch {
+        // Audit logging is non-fatal - silently ignore errors
+    }
+}
+/**
+ * CLI argument options
+ */
+const CLI_OPTIONS = {
+    baseDir: {
+        name: 'baseDir',
+        flags: '-d, --base-dir <path>',
+        description: 'Base directory to initialize (defaults to current directory)',
+    },
+    quiet: {
+        name: 'quiet',
+        flags: '-q, --quiet',
+        description: 'Suppress output except errors',
+    },
+};
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    const args = createWUParser({
+        name: 'mem-init',
+        description: 'Initialize memory layer in repository',
+        options: [CLI_OPTIONS.baseDir, CLI_OPTIONS.quiet],
+    });
+    const baseDir = args.baseDir || process.cwd();
+    const startedAt = new Date().toISOString();
+    const startTime = Date.now();
+    let result;
+    let error = null;
+    try {
+        result = await initMemory(baseDir);
+    }
+    catch (err) {
+        error = err.message;
+    }
+    const durationMs = Date.now() - startTime;
+    // Write audit log entry
+    await writeAuditLog(baseDir, {
+        tool: TOOL_NAME,
+        status: error ? 'failed' : 'success',
+        startedAt,
+        completedAt: new Date().toISOString(),
+        durationMs,
+        input: { baseDir },
+        output: result
+            ? {
+                initialized: result.success,
+                alreadyInitialized: result.alreadyInitialized,
+                created: result.created,
+            }
+            : null,
+        error: error ? { message: error } : null,
+    });
+    if (error) {
+        console.error(`${LOG_PREFIX} Error: ${error}`);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    if (args.quiet) {
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    // Output results
+    console.log(`${STRING_LITERALS.NEWLINE}${LOG_PREFIX} Memory layer initialization complete`);
+    console.log('');
+    if (result.alreadyInitialized) {
+        console.log('Status: Already initialized (no changes made)');
+    }
+    else {
+        console.log('Status: Initialized');
+    }
+    console.log('');
+    console.log('Paths:');
+    console.log(`  Directory:    ${result.paths.memoryDir}`);
+    console.log(`  Memory file:  ${result.paths.memoryJsonl}`);
+    console.log(`  Config file:  ${result.paths.configYaml}`);
+    if (!result.alreadyInitialized) {
+        console.log('');
+        console.log('Created:');
+        if (result.created.directory) {
+            console.log('  - .beacon/memory/ directory');
+        }
+        if (result.created.memoryJsonl) {
+            console.log('  - memory.jsonl (empty)');
+        }
+        if (result.created.configYaml) {
+            console.log('  - config.yaml (default settings)');
+        }
+    }
+    console.log('');
+}
+main().catch((e) => {
+    console.error(`${LOG_PREFIX} ${e.message}`);
+    process.exit(EXIT_CODES.ERROR);
+});

package/dist/mem-init.js.map

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

package/dist/mem-ready.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Memory Ready CLI (WU-1468)
+ *
+ * Deterministic ready-work query for "what next?" oracle.
+ * Returns unblocked open nodes, ordered by priority then createdAt.
+ *
+ * Usage:
+ *   pnpm mem:ready --wu WU-1234 [--type <type>] [--format <json|human>] [--quiet]
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * @see {@link tools/lib/mem-ready-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-ready.test.mjs} - Tests
+ */
+export {};

package/dist/mem-ready.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-ready.d.ts","sourceRoot":"","sources":["../src/mem-ready.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}