@lumenflow/cli 1.0.0

package/dist/mem-ready.js

@@ -0,0 +1,224 @@
+#!/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
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { queryReadyNodes } from '@lumenflow/memory/dist/mem-ready-core.js';
+import { createWUParser, WU_OPTIONS } from '@lumenflow/core/dist/arg-parser.js';
+import { EXIT_CODES } from '@lumenflow/core/dist/wu-constants.js';
+import { MEMORY_NODE_TYPES } from '@lumenflow/memory/dist/memory-schema.js';
+/**
+ * Log prefix for mem:ready output
+ */
+const LOG_PREFIX = '[mem:ready]';
+/**
+ * Tool name for audit logging
+ */
+const TOOL_NAME = 'mem:ready';
+/**
+ * Audit log file path
+ */
+const AUDIT_LOG_PATH = '.beacon/telemetry/tools.ndjson';
+/**
+ * CLI argument options specific to mem:ready
+ */
+const CLI_OPTIONS = {
+    type: {
+        name: 'type',
+        flags: '-t, --type <type>',
+        description: `Filter by node type (${MEMORY_NODE_TYPES.join(', ')})`,
+    },
+    format: {
+        name: 'format',
+        flags: '-f, --format <format>',
+        description: 'Output format (json, human). Default: human',
+    },
+    baseDir: {
+        name: 'baseDir',
+        flags: '-d, --base-dir <path>',
+        description: 'Base directory (defaults to current directory)',
+    },
+    quiet: {
+        name: 'quiet',
+        flags: '-q, --quiet',
+        description: 'Suppress header/footer output, only show nodes',
+    },
+};
+/**
+ * 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 a single node for human-readable output
+ *
+ * @param {object} node - Memory node
+ * @param {number} index - Position in list (0-indexed)
+ * @returns {string} Formatted output
+ */
+function formatNodeHuman(node, index) {
+    const priority = node.metadata?.priority || '-';
+    const lines = [
+        `${index + 1}. [${node.id}] (${node.type})`,
+        `   Priority:   ${priority}`,
+        `   Lifecycle:  ${node.lifecycle}`,
+        `   Created:    ${node.created_at}`,
+    ];
+    if (node.wu_id) {
+        lines.push(`   WU:         ${node.wu_id}`);
+    }
+    // Truncate content for display
+    const maxContentLen = 60;
+    const content = node.content.length > maxContentLen
+        ? `${node.content.slice(0, maxContentLen)}...`
+        : node.content;
+    lines.push(`   Content:    ${content}`);
+    return lines.join('\n');
+}
+/**
+ * Print nodes in human-readable format
+ *
+ * @param {object[]} nodes - Ready nodes
+ * @param {object} opts - CLI options
+ */
+function printHumanFormat(nodes, opts) {
+    if (!opts.quiet) {
+        console.log(`${LOG_PREFIX} Ready nodes for ${opts.wu}:`);
+        console.log('');
+    }
+    if (nodes.length === 0) {
+        if (!opts.quiet) {
+            console.log('  (no ready nodes)');
+            console.log('');
+        }
+        return;
+    }
+    for (const [i, node] of nodes.entries()) {
+        console.log(formatNodeHuman(node, i));
+        console.log('');
+    }
+    if (!opts.quiet) {
+        console.log(`${LOG_PREFIX} ${nodes.length} node(s) ready for processing`);
+    }
+}
+/**
+ * Print nodes in JSON format
+ *
+ * @param {object[]} nodes - Ready nodes
+ * @param {object} opts - CLI options
+ */
+function printJsonFormat(nodes, opts) {
+    const output = {
+        wuId: opts.wu,
+        type: opts.type || null,
+        count: nodes.length,
+        nodes,
+    };
+    console.log(JSON.stringify(output, null, 2));
+}
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    const args = createWUParser({
+        name: 'mem-ready',
+        description: 'Query ready nodes for a WU (deterministic ordering)',
+        options: [
+            WU_OPTIONS.wu,
+            CLI_OPTIONS.type,
+            CLI_OPTIONS.format,
+            CLI_OPTIONS.baseDir,
+            CLI_OPTIONS.quiet,
+        ],
+        required: ['wu'],
+    });
+    const baseDir = args.baseDir || process.cwd();
+    const format = args.format || 'human';
+    const startedAt = new Date().toISOString();
+    const startTime = Date.now();
+    // Validate format option
+    if (!['json', 'human'].includes(format)) {
+        console.error(`${LOG_PREFIX} Error: Invalid format "${format}". Use "json" or "human".`);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    // Validate type option if provided
+    if (args.type && !MEMORY_NODE_TYPES.includes(args.type)) {
+        console.error(`${LOG_PREFIX} Error: Invalid type "${args.type}". Valid types: ${MEMORY_NODE_TYPES.join(', ')}`);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    let nodes;
+    let error = null;
+    try {
+        nodes = await queryReadyNodes(baseDir, {
+            wuId: args.wu,
+            type: args.type,
+        });
+    }
+    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,
+            wuId: args.wu,
+            type: args.type,
+            format,
+        },
+        output: nodes
+            ? {
+                count: nodes.length,
+                nodeIds: nodes.map((n) => n.id),
+            }
+            : null,
+        error: error ? { message: error } : null,
+    });
+    if (error) {
+        console.error(`${LOG_PREFIX} Error: ${error}`);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    // Print output based on format
+    if (format === 'json') {
+        printJsonFormat(nodes, args);
+    }
+    else {
+        printHumanFormat(nodes, args);
+    }
+}
+main().catch((e) => {
+    console.error(`${LOG_PREFIX} ${e.message}`);
+    process.exit(EXIT_CODES.ERROR);
+});

package/dist/mem-ready.js.map

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

package/dist/mem-signal.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Memory Signal CLI (WU-1473)
+ *
+ * Send coordination signals between parallel agents for sub-100ms
+ * multi-agent swarm coordination without git sync latency.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * Usage:
+ *   pnpm mem:signal 'message' [--wu <id>] [--lane <name>] [--quiet]
+ *
+ * @see {@link tools/lib/mem-signal-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-signal.test.mjs} - Tests
+ */
+export {};

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

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

package/dist/mem-signal.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env node
+/**
+ * Memory Signal CLI (WU-1473)
+ *
+ * Send coordination signals between parallel agents for sub-100ms
+ * multi-agent swarm coordination without git sync latency.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * Usage:
+ *   pnpm mem:signal 'message' [--wu <id>] [--lane <name>] [--quiet]
+ *
+ * @see {@link tools/lib/mem-signal-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-signal.test.mjs} - Tests
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createSignal } 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';
+/**
+ * Log prefix for mem:signal output
+ */
+const LOG_PREFIX = '[mem:signal]';
+/**
+ * Tool name for audit logging
+ */
+const TOOL_NAME = 'mem:signal';
+/**
+ * Audit log file path
+ */
+const AUDIT_LOG_PATH = '.beacon/telemetry/tools.ndjson';
+/**
+ * CLI argument options specific to mem:signal
+ */
+const CLI_OPTIONS = {
+    message: {
+        name: 'message',
+        flags: '-m, --message <text>',
+        description: 'Signal message (required if not positional)',
+    },
+    quiet: {
+        name: 'quiet',
+        flags: '-q, --quiet',
+        description: 'Suppress output except errors (outputs signal ID only)',
+    },
+};
+/**
+ * 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
+    }
+}
+/**
+ * Flags that expect a value argument
+ */
+const FLAGS_WITH_VALUES = new Set(['-m', '--message', '--wu', '-l', '--lane']);
+/**
+ * Extract positional arguments from argv (skipping flags and their values)
+ *
+ * @returns {string[]} Positional arguments
+ */
+function extractPositionalArgs() {
+    const positionalArgs = [];
+    let skipNext = false;
+    for (let i = 2; i < process.argv.length; i++) {
+        const arg = process.argv[i];
+        if (skipNext) {
+            skipNext = false;
+            continue;
+        }
+        if (arg.startsWith('-')) {
+            skipNext = FLAGS_WITH_VALUES.has(arg);
+            continue;
+        }
+        positionalArgs.push(arg);
+    }
+    return positionalArgs;
+}
+/**
+ * Parse CLI arguments and extract the message
+ *
+ * @returns {{args: object, message: string|undefined}} Parsed args and message
+ */
+function parseArguments() {
+    const args = createWUParser({
+        name: 'mem-signal',
+        description: 'Send a coordination signal to other agents',
+        options: [CLI_OPTIONS.message, WU_OPTIONS.wu, WU_OPTIONS.lane, CLI_OPTIONS.quiet],
+        required: [],
+        allowPositionalId: true,
+    });
+    let message = args.message;
+    if (!message && process.argv.length > 2) {
+        const positionalArgs = extractPositionalArgs();
+        if (positionalArgs.length > 0) {
+            [message] = positionalArgs;
+        }
+    }
+    return { args, message };
+}
+/**
+ * Print signal details to console
+ *
+ * @param {object} result - Creation result with signal
+ */
+function printSignalDetails(result) {
+    const { signal } = result;
+    console.log(`${LOG_PREFIX} Signal sent (${signal.id})`);
+    console.log('');
+    console.log('Signal Details:');
+    console.log(`  ID:         ${signal.id}`);
+    console.log(`  Message:    ${signal.message}`);
+    console.log(`  Created At: ${signal.created_at}`);
+    if (signal.wu_id) {
+        console.log(`  WU:         ${signal.wu_id}`);
+    }
+    if (signal.lane) {
+        console.log(`  Lane:       ${signal.lane}`);
+    }
+    console.log('');
+}
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    const { args, message } = parseArguments();
+    if (!message) {
+        console.error(`${LOG_PREFIX} Error: message is required`);
+        console.error('');
+        console.error("Usage: pnpm mem:signal 'message' [options]");
+        console.error("       pnpm mem:signal --message 'message' [options]");
+        console.error('');
+        console.error('Options:');
+        console.error('  --wu <id>      WU ID to scope signal to (e.g., WU-1473)');
+        console.error('  --lane <name>  Lane to target signal to (e.g., "Operations: Tooling")');
+        console.error('  --quiet        Suppress output except errors');
+        process.exit(EXIT_CODES.ERROR);
+    }
+    const baseDir = process.cwd();
+    const startedAt = new Date().toISOString();
+    const startTime = Date.now();
+    let result;
+    let error = null;
+    try {
+        result = await createSignal(baseDir, {
+            message,
+            wuId: args.wu,
+            lane: args.lane,
+        });
+    }
+    catch (err) {
+        error = err.message;
+    }
+    const durationMs = Date.now() - startTime;
+    await writeAuditLog(baseDir, {
+        tool: TOOL_NAME,
+        status: error ? 'failed' : 'success',
+        startedAt,
+        completedAt: new Date().toISOString(),
+        durationMs,
+        input: {
+            message,
+            wuId: args.wu,
+            lane: args.lane,
+        },
+        output: result
+            ? {
+                success: result.success,
+                signalId: result.signal?.id,
+                wuId: result.signal?.wu_id,
+                lane: result.signal?.lane,
+            }
+            : null,
+        error: error ? { message: error } : null,
+    });
+    if (error) {
+        console.error(`${LOG_PREFIX} Error: ${error}`);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    if (args.quiet) {
+        console.log(result.signal.id);
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    printSignalDetails(result);
+}
+main().catch((e) => {
+    console.error(`${LOG_PREFIX} ${e.message}`);
+    process.exit(EXIT_CODES.ERROR);
+});

package/dist/mem-signal.js.map

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

package/dist/mem-start.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Memory Start CLI (WU-1466)
+ *
+ * Create a session node linked to a WU.
+ * Called by wu:claim enhancement for context restoration after /clear.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * Usage:
+ *   pnpm mem:start --wu WU-1234 [--agent-type <type>] [--context-tier <tier>] [--quiet]
+ *
+ * @see {@link tools/lib/mem-start-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-start.test.mjs} - Tests
+ */
+export {};

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

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

package/dist/mem-start.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+/**
+ * Memory Start CLI (WU-1466)
+ *
+ * Create a session node linked to a WU.
+ * Called by wu:claim enhancement for context restoration after /clear.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * Usage:
+ *   pnpm mem:start --wu WU-1234 [--agent-type <type>] [--context-tier <tier>] [--quiet]
+ *
+ * @see {@link tools/lib/mem-start-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-start.test.mjs} - Tests
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { startSession } from '@lumenflow/memory/dist/mem-start-core.js';
+import { createWUParser, WU_OPTIONS } from '@lumenflow/core/dist/arg-parser.js';
+import { EXIT_CODES } from '@lumenflow/core/dist/wu-constants.js';
+/**
+ * Log prefix for mem:start output
+ */
+const LOG_PREFIX = '[mem:start]';
+/**
+ * Tool name for audit logging
+ */
+const TOOL_NAME = 'mem:start';
+/**
+ * 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 specific to mem:start
+ */
+const CLI_OPTIONS = {
+    agentType: {
+        name: 'agentType',
+        flags: '-a, --agent-type <type>',
+        description: 'Agent type (e.g., general-purpose, explore, test-engineer)',
+    },
+    contextTier: {
+        name: 'contextTier',
+        flags: '-c, --context-tier <tier>',
+        description: 'Context tier (core, full, minimal)',
+    },
+    baseDir: {
+        name: 'baseDir',
+        flags: '-d, --base-dir <path>',
+        description: 'Base directory (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-start',
+        description: 'Create a session node linked to a WU',
+        options: [
+            WU_OPTIONS.wu,
+            CLI_OPTIONS.agentType,
+            CLI_OPTIONS.contextTier,
+            CLI_OPTIONS.baseDir,
+            CLI_OPTIONS.quiet,
+        ],
+        required: ['wu'],
+    });
+    const baseDir = args.baseDir || process.cwd();
+    const startedAt = new Date().toISOString();
+    const startTime = Date.now();
+    let result;
+    let error = null;
+    try {
+        result = await startSession(baseDir, {
+            wuId: args.wu,
+            agentType: args.agentType,
+            contextTier: args.contextTier,
+        });
+    }
+    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,
+            wuId: args.wu,
+            agentType: args.agentType,
+            contextTier: args.contextTier,
+        },
+        output: result
+            ? {
+                success: result.success,
+                sessionId: result.session?.id,
+                wuId: result.session?.wu_id,
+            }
+            : null,
+        error: error ? { message: error } : null,
+    });
+    if (error) {
+        console.error(`${LOG_PREFIX} Error: ${error}`);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    if (args.quiet) {
+        // In quiet mode, just output the session ID for piping
+        console.log(result.session.id);
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    // Output results
+    console.log(`${LOG_PREFIX} Session started (${result.session.id})`);
+    console.log('');
+    console.log('Session Details:');
+    console.log(`  ID:           ${result.session.id}`);
+    console.log(`  WU:           ${result.session.wu_id}`);
+    console.log(`  Session UUID: ${result.session.session_id}`);
+    console.log(`  Agent Type:   ${result.session.metadata.agentType}`);
+    console.log(`  Context Tier: ${result.session.metadata.contextTier}`);
+    console.log(`  Created At:   ${result.session.created_at}`);
+    console.log('');
+}
+main().catch((e) => {
+    console.error(`${LOG_PREFIX} ${e.message}`);
+    process.exit(EXIT_CODES.ERROR);
+});

package/dist/mem-start.js.map

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

package/dist/mem-summarize.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * Memory Summarize CLI (WU-1471)
+ *
+ * Rollup older memory nodes into summary nodes for compaction.
+ * Implements forgetting as first-class feature.
+ *
+ * Features:
+ * - Aggregate checkpoint/note/discovery nodes into summaries
+ * - Mark originals for cleanup after summary creation
+ * - Respect lifecycle TTL (ephemeral, session, wu, project)
+ * - Support dry-run mode for preview
+ *
+ * Usage:
+ *   pnpm mem:summarize --wu WU-1234           # Create summary from WU nodes
+ *   pnpm mem:summarize --wu WU-1234 --dry-run # Preview without changes
+ *   pnpm mem:summarize --wu WU-1234 --json    # Output as JSON
+ *
+ * @see {@link tools/lib/mem-summarize-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-summarize.test.mjs} - Tests
+ */
+export {};