@lumenflow/cli 1.0.0

package/dist/mem-cleanup.js

@@ -0,0 +1,267 @@
+#!/usr/bin/env node
+/**
+ * Memory Cleanup CLI (WU-1472, WU-1554)
+ *
+ * Prune closed memory nodes based on lifecycle policy and TTL.
+ * Implements compaction to prevent memory bloat.
+ *
+ * Features:
+ * - Remove ephemeral nodes (always discarded)
+ * - Remove session nodes when session is closed
+ * - Archive summarized nodes (marked with summarized_into)
+ * - Respect sensitive:true flag for stricter retention
+ * - Support dry-run mode for preview
+ * - Report compaction metrics (ratio, bytes freed)
+ * - WU-1554: TTL-based expiration (e.g., --ttl 30d)
+ * - WU-1554: Active session protection (never removed)
+ *
+ * Usage:
+ *   pnpm mem:cleanup                          # Cleanup based on lifecycle policy
+ *   pnpm mem:cleanup --dry-run                # Preview without changes
+ *   pnpm mem:cleanup --ttl 30d                # Remove nodes older than 30 days
+ *   pnpm mem:cleanup --ttl 7d --dry-run       # Preview TTL cleanup
+ *   pnpm mem:cleanup --session-id <uuid>      # Close specific session
+ *   pnpm mem:cleanup --json                   # Output as JSON
+ *
+ * @see {@link tools/lib/mem-cleanup-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-cleanup.test.mjs} - Tests
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { cleanupMemory } from '@lumenflow/memory/dist/mem-cleanup-core.js';
+import { createWUParser } from '@lumenflow/core/dist/arg-parser.js';
+import { EXIT_CODES } from '@lumenflow/core/dist/wu-constants.js';
+/**
+ * Log prefix for mem:cleanup output
+ */
+const LOG_PREFIX = '[mem:cleanup]';
+/**
+ * Tool name for audit logging
+ */
+const TOOL_NAME = 'mem:cleanup';
+/**
+ * Audit log file path
+ */
+const AUDIT_LOG_PATH = '.beacon/telemetry/tools.ndjson';
+/**
+ * Bytes per KB for formatting
+ */
+const BYTES_PER_KB = 1024;
+/**
+ * CLI argument options specific to mem:cleanup
+ */
+const CLI_OPTIONS = {
+    dryRun: {
+        name: 'dryRun',
+        flags: '--dry-run',
+        description: 'Preview cleanup without making changes',
+    },
+    ttl: {
+        name: 'ttl',
+        flags: '--ttl <duration>',
+        description: 'Remove nodes older than duration (e.g., 30d, 7d, 24h). Active sessions are protected.',
+    },
+    sessionId: {
+        name: 'sessionId',
+        flags: '--session-id <uuid>',
+        description: 'Session ID to consider closed (removes session lifecycle nodes)',
+    },
+    json: {
+        name: 'json',
+        flags: '--json',
+        description: 'Output as JSON',
+    },
+    quiet: {
+        name: 'quiet',
+        flags: '-q, --quiet',
+        description: 'Suppress output except errors',
+    },
+    baseDir: {
+        name: 'baseDir',
+        flags: '-b, --base-dir <path>',
+        description: 'Base directory (defaults to current directory)',
+    },
+};
+/**
+ * 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 bytes as human-readable string
+ *
+ * @param {number} bytes - Number of bytes
+ * @returns {string} 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`;
+}
+/**
+ * Format compaction ratio as percentage
+ *
+ * @param {number} ratio - Compaction ratio (0-1)
+ * @returns {string} Formatted percentage
+ */
+function formatRatio(ratio) {
+    return `${(ratio * 100).toFixed(1)}%`;
+}
+/**
+ * Parse CLI arguments
+ *
+ * @returns {object} Parsed arguments
+ */
+function parseArguments() {
+    return createWUParser({
+        name: 'mem-cleanup',
+        description: 'Prune closed memory nodes based on lifecycle policy and TTL',
+        options: [
+            CLI_OPTIONS.dryRun,
+            CLI_OPTIONS.ttl,
+            CLI_OPTIONS.sessionId,
+            CLI_OPTIONS.json,
+            CLI_OPTIONS.quiet,
+            CLI_OPTIONS.baseDir,
+        ],
+        required: [],
+        allowPositionalId: false,
+    });
+}
+/**
+ * Print cleanup result to console
+ *
+ * @param {object} result - Cleanup result
+ * @param {boolean} quiet - Suppress verbose output
+ * @param {string} [ttl] - TTL string if provided
+ */
+function printResult(result, quiet, ttl) {
+    if (result.dryRun) {
+        console.log(`${LOG_PREFIX} Dry-run: Would remove ${result.removedIds.length} node(s)`);
+    }
+    else {
+        console.log(`${LOG_PREFIX} Cleanup complete`);
+    }
+    if (quiet) {
+        console.log(`${result.removedIds.length} removed, ${result.retainedIds.length} retained`);
+        return;
+    }
+    console.log('');
+    console.log('Summary:');
+    console.log(`  Removed:          ${result.removedIds.length} node(s)`);
+    console.log(`  Retained:         ${result.retainedIds.length} node(s)`);
+    console.log(`  Bytes Freed:      ${formatBytes(result.bytesFreed)}`);
+    console.log(`  Compaction Ratio: ${formatRatio(result.compactionRatio)}`);
+    // WU-1554: Show TTL if provided
+    if (ttl) {
+        console.log(`  TTL:              ${ttl}`);
+    }
+    console.log('');
+    console.log('Breakdown by Lifecycle:');
+    console.log(`  Ephemeral:        ${result.breakdown.ephemeral} removed`);
+    console.log(`  Session:          ${result.breakdown.session} removed`);
+    console.log(`  WU (summarized):  ${result.breakdown.wu} removed`);
+    console.log(`  Sensitive:        ${result.breakdown.sensitive} retained (stricter policy)`);
+    // WU-1554: Show TTL breakdown
+    if (result.breakdown.ttlExpired > 0 || result.breakdown.activeSessionProtected > 0) {
+        console.log('');
+        console.log('TTL Breakdown:');
+        console.log(`  TTL Expired:      ${result.breakdown.ttlExpired} removed`);
+        console.log(`  Active Sessions:  ${result.breakdown.activeSessionProtected} protected`);
+    }
+    if (result.removedIds.length > 0 && !result.dryRun) {
+        console.log('');
+        console.log('Removed Node IDs:');
+        // Show first 10, then "and X more" if needed
+        const displayLimit = 10;
+        const displayIds = result.removedIds.slice(0, displayLimit);
+        for (const id of displayIds) {
+            console.log(`  - ${id}`);
+        }
+        if (result.removedIds.length > displayLimit) {
+            console.log(`  ... and ${result.removedIds.length - displayLimit} more`);
+        }
+    }
+    if (result.dryRun) {
+        console.log('');
+        console.log('To execute, run without --dry-run');
+    }
+}
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    const args = parseArguments();
+    const baseDir = args.baseDir || process.cwd();
+    const startedAt = new Date().toISOString();
+    const startTime = Date.now();
+    let result = null;
+    let error = null;
+    try {
+        result = await cleanupMemory(baseDir, {
+            dryRun: args.dryRun,
+            sessionId: args.sessionId,
+            ttl: args.ttl,
+        });
+    }
+    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: {
+            baseDir,
+            dryRun: args.dryRun,
+            sessionId: args.sessionId,
+            ttl: args.ttl,
+        },
+        output: result
+            ? {
+                success: result.success,
+                removedCount: result.removedIds.length,
+                retainedCount: result.retainedIds.length,
+                bytesFreed: result.bytesFreed,
+                compactionRatio: result.compactionRatio,
+                breakdown: result.breakdown,
+                dryRun: result.dryRun,
+                ttlMs: result.ttlMs,
+            }
+            : null,
+        error: error ? { message: error } : null,
+    });
+    if (error) {
+        console.error(`${LOG_PREFIX} Error: ${error}`);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    if (args.json) {
+        console.log(JSON.stringify(result, null, 2));
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    printResult(result, args.quiet, args.ttl);
+}
+main().catch((e) => {
+    console.error(`${LOG_PREFIX} ${e.message}`);
+    process.exit(EXIT_CODES.ERROR);
+});

package/dist/mem-cleanup.js.map

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

package/dist/mem-create.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * Memory Create CLI (WU-1469)
+ *
+ * Create memory nodes with discovered-from provenance.
+ * KEY DIFFERENTIATOR: supports discovered-from relationship for scope-creep
+ * forensics. Creates audit trail of WHY work expanded, not just WHAT changed.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * Usage:
+ *   pnpm mem:create 'title' [--type <type>] [--discovered-from <id>] [--wu <id>] [--quiet]
+ *
+ * @see {@link tools/lib/mem-create-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-create.test.mjs} - Tests
+ */
+export {};

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

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

package/dist/mem-create.js

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+/**
+ * Memory Create CLI (WU-1469)
+ *
+ * Create memory nodes with discovered-from provenance.
+ * KEY DIFFERENTIATOR: supports discovered-from relationship for scope-creep
+ * forensics. Creates audit trail of WHY work expanded, not just WHAT changed.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * Usage:
+ *   pnpm mem:create 'title' [--type <type>] [--discovered-from <id>] [--wu <id>] [--quiet]
+ *
+ * @see {@link tools/lib/mem-create-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-create.test.mjs} - Tests
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createMemoryNode } from '@lumenflow/memory/dist/mem-create-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:create output
+ */
+const LOG_PREFIX = '[mem:create]';
+/**
+ * Tool name for audit logging
+ */
+const TOOL_NAME = 'mem:create';
+/**
+ * Audit log file path
+ */
+const AUDIT_LOG_PATH = '.beacon/telemetry/tools.ndjson';
+/**
+ * CLI argument options specific to mem:create
+ */
+const CLI_OPTIONS = {
+    title: {
+        name: 'title',
+        flags: '-t, --title <text>',
+        description: 'Node title/content (required if not positional)',
+    },
+    type: {
+        name: 'type',
+        flags: '--type <type>',
+        description: `Node type: ${MEMORY_NODE_TYPES.join(', ')} (default: discovery). Aliases: bug, idea, question, dependency (stored as discovery + tags).`,
+    },
+    discoveredFrom: {
+        name: 'discoveredFrom',
+        flags: '-d, --discovered-from <id>',
+        description: 'Parent node ID for provenance tracking (mem-XXXX format)',
+    },
+    session: {
+        name: 'session',
+        flags: '-s, --session <id>',
+        description: 'Session ID to link node to (UUID)',
+    },
+    tags: {
+        name: 'tags',
+        flags: '--tags <tags>',
+        description: 'Comma-separated tags for categorization',
+    },
+    priority: {
+        name: 'priority',
+        flags: '-p, --priority <level>',
+        description: 'Priority level (P0, P1, P2, P3)',
+    },
+    baseDir: {
+        name: 'baseDir',
+        flags: '-b, --base-dir <path>',
+        description: 'Base directory (defaults to current directory)',
+    },
+    quiet: {
+        name: 'quiet',
+        flags: '-q, --quiet',
+        description: 'Suppress output except errors',
+    },
+};
+/**
+ * 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
+    }
+}
+/**
+ * Parse CLI arguments and extract the title
+ *
+ * @returns {{args: object, title: string|undefined}} Parsed args and title
+ */
+function parseArguments() {
+    const args = createWUParser({
+        name: 'mem-create',
+        description: 'Create a memory node with optional provenance tracking',
+        options: [
+            CLI_OPTIONS.title,
+            CLI_OPTIONS.type,
+            CLI_OPTIONS.discoveredFrom,
+            WU_OPTIONS.wu,
+            CLI_OPTIONS.session,
+            CLI_OPTIONS.tags,
+            CLI_OPTIONS.priority,
+            CLI_OPTIONS.baseDir,
+            CLI_OPTIONS.quiet,
+        ],
+        required: [],
+        allowPositionalId: true,
+    });
+    let title = args.title;
+    if (!title && process.argv.length > 2) {
+        const positionalArgs = process.argv.slice(2).filter((arg) => !arg.startsWith('-'));
+        if (positionalArgs.length > 0) {
+            title = positionalArgs[0];
+        }
+    }
+    return { args, title };
+}
+/**
+ * Print node details to console
+ *
+ * @param {object} result - Creation result with node and optional relationship
+ */
+function printNodeDetails(result) {
+    const { node, relationship } = result;
+    console.log(`${LOG_PREFIX} Node created (${node.id})`);
+    console.log('');
+    console.log('Node Details:');
+    console.log(`  ID:         ${node.id}`);
+    console.log(`  Type:       ${node.type}`);
+    console.log(`  Lifecycle:  ${node.lifecycle}`);
+    console.log(`  Created At: ${node.created_at}`);
+    if (node.wu_id) {
+        console.log(`  WU:         ${node.wu_id}`);
+    }
+    if (node.session_id) {
+        console.log(`  Session:    ${node.session_id}`);
+    }
+    console.log('');
+    console.log('Content:');
+    console.log(`  ${node.content}`);
+    if (node.tags && node.tags.length > 0) {
+        console.log('');
+        console.log('Tags:');
+        console.log(`  ${node.tags.join(', ')}`);
+    }
+    if (node.metadata) {
+        printMetadata(node.metadata);
+    }
+    if (relationship) {
+        console.log('');
+        console.log('Provenance:');
+        console.log(`  Discovered From: ${relationship.to_id}`);
+        console.log(`  Relationship:    ${relationship.type}`);
+    }
+    console.log('');
+}
+/**
+ * Print metadata section to console
+ *
+ * @param {object} metadata - Node metadata
+ */
+function printMetadata(metadata) {
+    console.log('');
+    console.log('Metadata:');
+    if (metadata.priority) {
+        console.log(`  Priority: ${metadata.priority}`);
+    }
+}
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    const { args, title } = parseArguments();
+    if (!title) {
+        console.error(`${LOG_PREFIX} Error: title is required`);
+        console.error('');
+        console.error("Usage: pnpm mem:create 'title' [options]");
+        console.error("       pnpm mem:create --title 'title' [options]");
+        console.error('');
+        console.error('Options:');
+        console.error('  --type <type>            Node type (discovery, session, checkpoint, note, summary) or alias (bug, idea, question, dependency)');
+        console.error('  --discovered-from <id>   Parent node ID for provenance (mem-XXXX)');
+        console.error('  --wu <id>                WU ID to link node to (WU-XXX)');
+        console.error('  --session <id>           Session ID to link node to (UUID)');
+        console.error('  --tags <tags>            Comma-separated tags');
+        console.error('  --priority <level>       Priority level (P0, P1, P2, P3)');
+        console.error('  --quiet                  Suppress output except errors');
+        process.exit(EXIT_CODES.ERROR);
+    }
+    const baseDir = args.baseDir || process.cwd();
+    const startedAt = new Date().toISOString();
+    const startTime = Date.now();
+    // Parse tags if provided
+    const tags = args.tags ? args.tags.split(',').map((t) => t.trim()) : undefined;
+    let result;
+    let error = null;
+    try {
+        result = await createMemoryNode(baseDir, {
+            title,
+            type: args.type,
+            wuId: args.wu,
+            sessionId: args.session,
+            discoveredFrom: args.discoveredFrom,
+            tags,
+            priority: args.priority,
+        });
+    }
+    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: {
+            baseDir,
+            title,
+            type: args.type,
+            wuId: args.wu,
+            sessionId: args.session,
+            discoveredFrom: args.discoveredFrom,
+            tags,
+            priority: args.priority,
+        },
+        output: result
+            ? {
+                success: result.success,
+                nodeId: result.node?.id,
+                wuId: result.node?.wu_id,
+                hasRelationship: !!result.relationship,
+            }
+            : 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.node.id);
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    printNodeDetails(result);
+}
+main().catch((e) => {
+    console.error(`${LOG_PREFIX} ${e.message}`);
+    process.exit(EXIT_CODES.ERROR);
+});

package/dist/mem-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-create.js","sourceRoot":"","sources":["../src/mem-create.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E;;GAEG;AACH,MAAM,UAAU,GAAG,cAAc,CAAC;AAElC;;GAEG;AACH,MAAM,SAAS,GAAG,YAAY,CAAC;AAE/B;;GAEG;AACH,MAAM,cAAc,GAAG,gCAAgC,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,iDAAiD;KAC/D;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,cAAc,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,+FAA+F;KACvJ;IACD,cAAc,EAAE;QACd,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,0DAA0D;KACxE;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,mCAAmC;KACjD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,yCAAyC;KACvD;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,iCAAiC;KAC/C;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,gDAAgD;KAC9D;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,+BAA+B;KAC7C;CACF,CAAC;AAEF;;;;;GAKG;AACH,KAAK,UAAU,aAAa,CAAC,OAAO,EAAE,KAAK;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAErC,uGAAuG;QACvG,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5C,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;QAC1C,gGAAgG;QAChG,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,cAAc,CAAC;QAC1B,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,wDAAwD;QACrE,OAAO,EAAE;YACP,WAAW,CAAC,KAAK;YACjB,WAAW,CAAC,IAAI;YAChB,WAAW,CAAC,cAAc;YAC1B,UAAU,CAAC,EAAE;YACb,WAAW,CAAC,OAAO;YACnB,WAAW,CAAC,IAAI;YAChB,WAAW,CAAC,QAAQ;YACpB,WAAW,CAAC,OAAO;YACnB,WAAW,CAAC,KAAK;SAClB;QACD,QAAQ,EAAE,EAAE;QACZ,iBAAiB,EAAE,IAAI;KACxB,CAAC,CAAC;IAEH,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACvB,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACnF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,MAAM;IAC9B,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAEtC,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,kBAAkB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAEhD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAEjC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,sBAAsB,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,sBAAsB,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,QAAQ;IAC7B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzB,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,cAAc,EAAE,CAAC;IAEzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,2BAA2B,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1B,OAAO,CAAC,KAAK,CACX,iIAAiI,CAClI,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACrF,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC3E,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9E,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC5E,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,yBAAyB;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/E,IAAI,MAAM,CAAC;IACX,IAAI,KAAK,GAAG,IAAI,CAAC;IAEjB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE;YACvC,KAAK;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,SAAS,EAAE,IAAI,CAAC,OAAO;YACvB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAE1C,MAAM,aAAa,CAAC,OAAO,EAAE;QAC3B,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACpC,SAAS;QACT,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,UAAU;QACV,KAAK,EAAE;YACL,OAAO;YACP,KAAK;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,SAAS,EAAE,IAAI,CAAC,OAAO;YACvB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB;QACD,MAAM,EAAE,MAAM;YACZ,CAAC,CAAC;gBACE,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK;gBACxB,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY;aACvC;YACH,CAAC,CAAC,IAAI;QACR,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI;KACzC,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,WAAW,KAAK,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC"}

package/dist/mem-inbox.d.ts

@@ -0,0 +1,35 @@
+#!/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
+ */
+/**
+ * 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 declare function formatCount(count: any): string;
+/**
+ * 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 declare function parseTimeString(timeStr: any): Date;

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

@@ -0,0 +1 @@
+{"version":3,"file":"mem-inbox.d.ts","sourceRoot":"","sources":["../src/mem-inbox.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AAoFH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,KAAA,UAEhC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,KAAA,QAatC"}