@lumenflow/cli 1.0.0

package/dist/initiative-status.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+/**
+ * Initiative Status Helper (WU-1247)
+ *
+ * Shows detailed initiative view with phases and WUs.
+ *
+ * Usage:
+ *   pnpm initiative:status INIT-001
+ *   pnpm initiative:status --id INIT-001 --format json
+ */
+import { createWUParser, WU_OPTIONS } from '@lumenflow/core/dist/arg-parser.js';
+import { die } from '@lumenflow/core/dist/error-handler.js';
+import { findInitiative, getInitiativeProgress, getInitiativeWUs, getInitiativePhases, } from '@lumenflow/initiatives/dist/initiative-yaml.js';
+import { OUTPUT_FORMATS } from '@lumenflow/initiatives/dist/initiative-constants.js';
+import { WU_STATUS } from '@lumenflow/core/dist/wu-constants.js';
+function getWUBlockers(doc) {
+    return doc.blocked_by || doc.dependencies || [];
+}
+function priorityRank(priority) {
+    const p = String(priority || '').toUpperCase();
+    const map = { P0: 0, P1: 1, P2: 2, P3: 3 };
+    return map[p] ?? 9;
+}
+function isRunnableReady(wu, wuById) {
+    if (wu.doc.status !== WU_STATUS.READY)
+        return false;
+    const blockers = getWUBlockers(wu.doc);
+    return blockers.every((blockerId) => {
+        const blocker = wuById.get(blockerId);
+        return !blocker || blocker.doc.status === WU_STATUS.DONE;
+    });
+}
+function renderDetailed(initiative, useColor) {
+    const { id, doc } = initiative;
+    const progress = getInitiativeProgress(id);
+    const wus = getInitiativeWUs(id);
+    const wuById = new Map(wus.map((wu) => [wu.id, wu]));
+    const phaseGroups = getInitiativePhases(id);
+    // Header
+    console.log(`\n${id}: ${doc.title}`);
+    console.log(`Status: ${doc.status} | Progress: ${progress.percentage}% (${progress.done}/${progress.total} WUs)`);
+    // Start here (actionable next steps)
+    console.log('\nStart here:');
+    console.log(`  1) Plan waves (recommended): pnpm orchestrate:initiative --initiative ${id} --dry-run`);
+    const runnableReady = wus
+        .filter((wu) => isRunnableReady(wu, wuById))
+        .sort((a, b) => {
+        const byPriority = priorityRank(a.doc.priority) - priorityRank(b.doc.priority);
+        if (byPriority !== 0)
+            return byPriority;
+        return a.id.localeCompare(b.id);
+    });
+    if (runnableReady.length > 0) {
+        const next = runnableReady[0];
+        console.log(`  2) Start next WU: pnpm wu:claim --id ${next.id} --lane "${next.doc.lane}"`);
+        console.log(`     Then cd into the created worktree (shown by wu:claim output)`);
+    }
+    else if (progress.inProgress > 0) {
+        console.log(`  2) Continue: ${progress.inProgress} WU(s) already in progress (finish those first)`);
+    }
+    else if (progress.blocked > 0) {
+        console.log(`  2) Unblock: ${progress.blocked} WU(s) blocked (resolve blockers first)`);
+    }
+    else {
+        console.log('  2) No runnable ready WUs found (check dependencies/blocked_by)');
+    }
+    if (doc.description) {
+        console.log(`\nDescription: ${doc.description}`);
+    }
+    if (doc.owner) {
+        console.log(`Owner: ${doc.owner}`);
+    }
+    if (doc.target_date) {
+        console.log(`Target: ${doc.target_date}`);
+    }
+    // Phases
+    if (doc.phases && doc.phases.length > 0) {
+        console.log('\nPhases:');
+        for (const phase of doc.phases) {
+            const phaseWUs = phaseGroups.get(phase.id) || [];
+            const phaseStatus = formatStatus(phase.status, useColor);
+            console.log(`  ${phase.id}. ${phase.title.padEnd(30)} [${phaseStatus}] ${phaseWUs.length} WUs`);
+        }
+        // WUs without phase
+        const unassigned = phaseGroups.get(null) || [];
+        if (unassigned.length > 0) {
+            console.log(`  -. Unassigned                       ${unassigned.length} WUs`);
+        }
+    }
+    // WU summary by status
+    console.log('\nWork Units by Status:');
+    const byStatus = groupWUsByStatus(wus);
+    for (const [status, statusWUs] of Object.entries(byStatus)) {
+        if (statusWUs.length > 0) {
+            console.log(`  ${capitalizeFirst(status)} (${statusWUs.length}):`);
+            for (const wu of statusWUs.slice(0, 5)) {
+                console.log(`    - ${wu.id}: ${truncate(wu.doc.title, 50)}`);
+            }
+            if (statusWUs.length > 5) {
+                console.log(`    ... and ${statusWUs.length - 5} more`);
+            }
+        }
+    }
+    // Success metrics
+    if (doc.success_metrics && doc.success_metrics.length > 0) {
+        console.log('\nSuccess Metrics:');
+        for (const metric of doc.success_metrics) {
+            console.log(`  - ${metric}`);
+        }
+    }
+    console.log('');
+}
+function renderJSON(initiative) {
+    const { id, doc } = initiative;
+    const progress = getInitiativeProgress(id);
+    const wus = getInitiativeWUs(id);
+    const phaseGroups = getInitiativePhases(id);
+    const output = {
+        id,
+        slug: doc.slug,
+        title: doc.title,
+        description: doc.description,
+        status: doc.status,
+        priority: doc.priority,
+        owner: doc.owner,
+        created: doc.created,
+        targetDate: doc.target_date,
+        progress: {
+            percentage: progress.percentage,
+            done: progress.done,
+            inProgress: progress.inProgress,
+            ready: progress.ready,
+            blocked: progress.blocked,
+            total: progress.total,
+        },
+        phases: (doc.phases || []).map((phase) => {
+            const phaseWUs = phaseGroups.get(phase.id) || [];
+            return {
+                id: phase.id,
+                title: phase.title,
+                status: phase.status,
+                wuCount: phaseWUs.length,
+                wus: phaseWUs.map((w) => ({ id: w.id, title: w.doc.title, status: w.doc.status })),
+            };
+        }),
+        workUnits: wus.map((w) => ({
+            id: w.id,
+            title: w.doc.title,
+            status: w.doc.status,
+            phase: w.doc.phase,
+        })),
+        successMetrics: doc.success_metrics || [],
+        labels: doc.labels || [],
+    };
+    console.log(JSON.stringify(output, null, 2));
+}
+function groupWUsByStatus(wus) {
+    const groups = {
+        [WU_STATUS.DONE]: [],
+        [WU_STATUS.IN_PROGRESS]: [],
+        [WU_STATUS.READY]: [],
+        [WU_STATUS.BLOCKED]: [],
+        other: [],
+    };
+    for (const wu of wus) {
+        const status = wu.doc.status;
+        if (groups[status]) {
+            groups[status].push(wu);
+        }
+        else {
+            groups.other.push(wu);
+        }
+    }
+    return groups;
+}
+function formatStatus(status, useColor) {
+    if (!useColor)
+        return status;
+    // Color support is opt-in, but we keep it simple for now
+    return status;
+}
+function truncate(str, maxLen) {
+    if (!str)
+        return '';
+    return str.length > maxLen ? `${str.substring(0, maxLen - 3)}...` : str;
+}
+function capitalizeFirst(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1).replace(/_/g, ' ');
+}
+async function main() {
+    const args = createWUParser({
+        name: 'initiative-status',
+        description: 'Show detailed initiative view with phases and WUs',
+        options: [WU_OPTIONS.id, WU_OPTIONS.format, WU_OPTIONS.color],
+        required: [],
+        allowPositionalId: true,
+    });
+    const initRef = args.id;
+    if (!initRef) {
+        die('Initiative ID or slug is required.\n\nUsage: pnpm initiative:status INIT-001');
+    }
+    const initiative = findInitiative(initRef);
+    if (!initiative) {
+        die(`Initiative not found: ${initRef}\n\n` +
+            `Run 'pnpm initiative:list' to see available initiatives.`);
+    }
+    const format = args.format || OUTPUT_FORMATS.TABLE;
+    switch (format) {
+        case OUTPUT_FORMATS.JSON:
+            renderJSON(initiative);
+            break;
+        default:
+            renderDetailed(initiative, args.color);
+            break;
+    }
+}
+// Guard main() for testability (WU-1366)
+import { fileURLToPath } from 'node:url';
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    main();
+}

package/dist/initiative-status.js.map

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

package/dist/mem-checkpoint.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Memory Checkpoint CLI (WU-1467)
+ *
+ * Create a checkpoint node for context snapshots.
+ * Used before /clear or session handoff to preserve progress state.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * Usage:
+ *   pnpm mem:checkpoint 'note' [--session <id>] [--wu <id>] [--progress <text>] [--next-steps <text>] [--trigger <type>] [--quiet]
+ *
+ * @see {@link tools/lib/mem-checkpoint-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-checkpoint.test.mjs} - Tests
+ */
+export {};

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

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

package/dist/mem-checkpoint.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+/**
+ * Memory Checkpoint CLI (WU-1467)
+ *
+ * Create a checkpoint node for context snapshots.
+ * Used before /clear or session handoff to preserve progress state.
+ *
+ * Includes audit logging to .beacon/telemetry/tools.ndjson.
+ *
+ * Usage:
+ *   pnpm mem:checkpoint 'note' [--session <id>] [--wu <id>] [--progress <text>] [--next-steps <text>] [--trigger <type>] [--quiet]
+ *
+ * @see {@link tools/lib/mem-checkpoint-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-checkpoint.test.mjs} - Tests
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createCheckpoint } from '@lumenflow/memory/dist/mem-checkpoint-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:checkpoint output
+ */
+const LOG_PREFIX = '[mem:checkpoint]';
+/**
+ * Tool name for audit logging
+ */
+const TOOL_NAME = 'mem:checkpoint';
+/**
+ * Audit log file path
+ */
+const AUDIT_LOG_PATH = '.beacon/telemetry/tools.ndjson';
+/**
+ * CLI argument options specific to mem:checkpoint
+ */
+const CLI_OPTIONS = {
+    note: {
+        name: 'note',
+        flags: '-n, --note <text>',
+        description: 'Checkpoint note (required if not positional)',
+    },
+    session: {
+        name: 'session',
+        flags: '-s, --session <id>',
+        description: 'Session ID to link checkpoint to (UUID)',
+    },
+    progress: {
+        name: 'progress',
+        flags: '-p, --progress <text>',
+        description: 'Progress summary',
+    },
+    nextSteps: {
+        name: 'nextSteps',
+        flags: '--next-steps <text>',
+        description: 'Next steps description',
+    },
+    trigger: {
+        name: 'trigger',
+        flags: '-t, --trigger <type>',
+        description: 'Handoff trigger type (e.g., clear, handoff)',
+    },
+    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',
+    },
+};
+/**
+ * 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 note
+ *
+ * @returns {{args: object, note: string|undefined}} Parsed args and note
+ */
+function parseArguments() {
+    const args = createWUParser({
+        name: 'mem-checkpoint',
+        description: 'Create a checkpoint node for context snapshots',
+        options: [
+            CLI_OPTIONS.note,
+            CLI_OPTIONS.session,
+            WU_OPTIONS.wu,
+            CLI_OPTIONS.progress,
+            CLI_OPTIONS.nextSteps,
+            CLI_OPTIONS.trigger,
+            CLI_OPTIONS.baseDir,
+            CLI_OPTIONS.quiet,
+        ],
+        required: [],
+        allowPositionalId: true,
+    });
+    let note = args.note;
+    if (!note && process.argv.length > 2) {
+        const positionalArgs = process.argv.slice(2).filter((arg) => !arg.startsWith('-'));
+        if (positionalArgs.length > 0) {
+            note = positionalArgs[0];
+        }
+    }
+    return { args, note };
+}
+/**
+ * Print checkpoint details to console
+ *
+ * @param {object} checkpoint - The checkpoint node
+ */
+function printCheckpointDetails(checkpoint) {
+    console.log(`${LOG_PREFIX} Checkpoint created (${checkpoint.id})`);
+    console.log('');
+    console.log('Checkpoint Details:');
+    console.log(`  ID:         ${checkpoint.id}`);
+    console.log(`  Type:       ${checkpoint.type}`);
+    console.log(`  Lifecycle:  ${checkpoint.lifecycle}`);
+    console.log(`  Created At: ${checkpoint.created_at}`);
+    if (checkpoint.wu_id) {
+        console.log(`  WU:         ${checkpoint.wu_id}`);
+    }
+    if (checkpoint.session_id) {
+        console.log(`  Session:    ${checkpoint.session_id}`);
+    }
+    console.log('');
+    console.log('Content:');
+    console.log(`  ${checkpoint.content}`);
+    if (checkpoint.metadata) {
+        printMetadata(checkpoint.metadata);
+    }
+    console.log('');
+}
+/**
+ * Print metadata section to console
+ *
+ * @param {object} metadata - Checkpoint metadata
+ */
+function printMetadata(metadata) {
+    console.log('');
+    console.log('Metadata:');
+    if (metadata.progress) {
+        console.log(`  Progress:   ${metadata.progress}`);
+    }
+    if (metadata.nextSteps) {
+        console.log(`  Next Steps: ${metadata.nextSteps}`);
+    }
+    if (metadata.trigger) {
+        console.log(`  Trigger:    ${metadata.trigger}`);
+    }
+}
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    const { args, note } = parseArguments();
+    if (!note) {
+        console.error(`${LOG_PREFIX} Error: note is required`);
+        console.error('');
+        console.error("Usage: pnpm mem:checkpoint 'note' [options]");
+        console.error("       pnpm mem:checkpoint --note 'note' [options]");
+        process.exit(EXIT_CODES.ERROR);
+    }
+    const baseDir = args.baseDir || process.cwd();
+    const startedAt = new Date().toISOString();
+    const startTime = Date.now();
+    let result;
+    let error = null;
+    try {
+        result = await createCheckpoint(baseDir, {
+            note,
+            sessionId: args.session,
+            wuId: args.wu,
+            progress: args.progress,
+            nextSteps: args.nextSteps,
+            trigger: args.trigger,
+        });
+    }
+    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,
+            note,
+            sessionId: args.session,
+            wuId: args.wu,
+            progress: args.progress,
+            nextSteps: args.nextSteps,
+            trigger: args.trigger,
+        },
+        output: result
+            ? {
+                success: result.success,
+                checkpointId: result.checkpoint?.id,
+                wuId: result.checkpoint?.wu_id,
+            }
+            : 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.checkpoint.id);
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    printCheckpointDetails(result.checkpoint);
+}
+main().catch((e) => {
+    console.error(`${LOG_PREFIX} ${e.message}`);
+    process.exit(EXIT_CODES.ERROR);
+});

package/dist/mem-checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-checkpoint.js","sourceRoot":"","sources":["../src/mem-checkpoint.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEjE;;GAEG;AACH,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAEtC;;GAEG;AACH,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAEnC;;GAEG;AACH,MAAM,cAAc,GAAG,gCAAgC,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,8CAA8C;KAC5D;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,yCAAyC;KACvD;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,kBAAkB;KAChC;IACD,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,wBAAwB;KACtC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,6CAA6C;KAC3D;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,gBAAgB;QACtB,WAAW,EAAE,gDAAgD;QAC7D,OAAO,EAAE;YACP,WAAW,CAAC,IAAI;YAChB,WAAW,CAAC,OAAO;YACnB,UAAU,CAAC,EAAE;YACb,WAAW,CAAC,QAAQ;YACpB,WAAW,CAAC,SAAS;YACrB,WAAW,CAAC,OAAO;YACnB,WAAW,CAAC,OAAO;YACnB,WAAW,CAAC,KAAK;SAClB;QACD,QAAQ,EAAE,EAAE;QACZ,iBAAiB,EAAE,IAAI;KACxB,CAAC,CAAC;IAEH,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACrB,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,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,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB,CAAC,UAAU;IACxC,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,wBAAwB,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;IAEtD,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAEvC,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IACD,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,iBAAiB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAC;IAExC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,0BAA0B,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpE,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,IAAI,MAAM,CAAC;IACX,IAAI,KAAK,GAAG,IAAI,CAAC;IAEjB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE;YACvC,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,OAAO;YACvB,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,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,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,OAAO;YACvB,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB;QACD,MAAM,EAAE,MAAM;YACZ,CAAC,CAAC;gBACE,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE;gBACnC,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK;aAC/B;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,UAAU,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,sBAAsB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5C,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-cleanup.d.ts

@@ -0,0 +1,29 @@
+#!/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
+ */
+export {};

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

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