fivocell 4.4.1 → 4.6.0

package/dist/walls/07-runtime/cli/cli.js

@@ -189,6 +189,12 @@ switch (cmd) {
     case 'why':
         doWhy();
         break;
+    case 'handoff':
+        doHandoff();
+        break;
+    case 'memory':
+        doMemory();
+        break;
     case 'repl':
     case '-i':
     case '--interactive':
@@ -1847,6 +1853,7 @@ function doContext() {
     let host = '127.0.0.1';
     let shortMode = false;
     let fullMode = false;
+    let topicQuery = '';
     for (let i = 2; i < args.length; i++) {
         const a = args[i];
         if (a === '--no-live') {
@@ -1865,6 +1872,12 @@ function doContext() {
             fullMode = true;
             continue;
         }
+        if (a === '--topic' && i + 1 < args.length) {
+            topicQuery = args[++i];
+            continue;
+        }
+        if (typeof a === 'string' && a.startsWith('--topic='))
+            topicQuery = a.split('=').slice(1).join('=');
         if (typeof a === 'string' && a.startsWith('--port='))
             port = parseInt(a.split('=')[1], 10) || null;
         if (typeof a === 'string' && a.startsWith('--host='))
@@ -1987,6 +2000,27 @@ function doContext() {
             else {
                 console.log(text);
             }
+            // Topic-based context search
+            if (topicQuery) {
+                console.log('');
+                console.log(C.bold(`  ── Topic Context: "${topicQuery}" ──`));
+                try {
+                    const { searchMemoryEvents } = require('../../06-memory/stores/memory-event-store');
+                    const events = searchMemoryEvents(topicQuery, projectArg, 20);
+                    if (events.length > 0) {
+                        for (const ev of events) {
+                            const imp = ev.importance >= 8 ? C.success(`[IMP:${ev.importance}]`) : `[${ev.importance}]`;
+                            console.log(`  ${imp} ${C.dim(ev.created_at)} ${C.primary(ev.type)}: ${ev.summary}`);
+                        }
+                    }
+                    else {
+                        console.log(C.dim(`  No memory events found for "${topicQuery}"`));
+                    }
+                }
+                catch (e) {
+                    console.log(C.warn(`  Topic search failed: ${e?.message || String(e)}`));
+                }
+            }
             try {
                 const { markFirstContext } = require('../setup/cell-state');
                 markFirstContext();
@@ -3072,6 +3106,9 @@ function doHelp() {
     console.log(`  ${C.primary('cell evolution [dir] [--stack]')}  Project evolution map + stack timeline`);
     console.log(`  ${C.primary('cell focus [dir]')}     Focus report — active/stalled/abandoned projects`);
     console.log(`  ${C.primary('cell why <topic>')}     Search decisions by topic`);
+    console.log(`  ${C.primary('cell handoff')}        Show/update handoff context`);
+    console.log(`  ${C.primary('cell memory')}         Search/timeline/compact/verify/export memory`);
+    console.log(`  ${C.primary('cell context --topic')} Add topic-based memory search to context`);
     console.log(`  ${C.primary('cell repl')}        Interactive REPL with / completion (or just run \`cell\` in a TTY)`);
     console.log(`  ${C.primary('cell help')}        Show this help`);
     console.log();
@@ -3242,4 +3279,317 @@ function doWhy() {
     console.log();
 }
 // test touch 14:40:59
+// ─── cell handoff — show/update handoff context ──────────────────────────────
+function doHandoff() {
+    const sub = args[1] || '';
+    const cwd = process.cwd();
+    if (sub === '--update' || sub === '-u') {
+        console.log(C.primary('  Updating handoff...'));
+        try {
+            const { rotateHandoffIfNeeded } = require('../../06-memory/handoff/handoff-store');
+            const rotated = rotateHandoffIfNeeded(cwd);
+            if (rotated) {
+                console.log(C.success('  Handoff rotated (old content moved to monthly history).'));
+            }
+            else {
+                console.log(C.dim('  No rotation needed.'));
+            }
+            console.log(C.success('  Handoff updated.'));
+        }
+        catch (e) {
+            console.log(C.warn(`  Update failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === '--current' || sub === '-c' || sub === '') {
+        console.log(C.bold('  ── Current Handoff ──'));
+        try {
+            const { getCurrentHandoff, getHandoffStats } = require('../../06-memory/handoff/handoff-store');
+            const content = getCurrentHandoff(cwd);
+            console.log(content);
+            const stats = getHandoffStats(cwd);
+            console.log(C.dim(`\n  Lines: ${stats.currentLines} | History months: ${stats.historyMonths} | DB entries: ${stats.dbEntries} | Needs rotation: ${stats.needsRotation}`));
+        }
+        catch (e) {
+            console.log(C.warn(`  Handoff failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === '--history' || sub === '-h') {
+        const month = args[2] || undefined;
+        console.log(C.bold(`  ── Handoff History${month ? ` (${month})` : ''} ──`));
+        try {
+            const { getHistoryHandoff } = require('../../06-memory/handoff/handoff-store');
+            console.log(getHistoryHandoff(cwd, month));
+        }
+        catch (e) {
+            console.log(C.warn(`  History failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === '--log') {
+        const title = args[2] || 'Untitled';
+        const summary = args[3] || '';
+        if (!summary) {
+            console.log(C.warn('  Usage: cell handoff --log "title" "summary"'));
+            console.log();
+            return;
+        }
+        try {
+            const { saveHandoffEntry } = require('../../06-memory/handoff/handoff-store');
+            const { detectProject } = require('../setup/setup');
+            const project = detectProject(cwd).name;
+            saveHandoffEntry(cwd, {
+                project,
+                title,
+                summary,
+                status: 'done',
+                filesChanged: args.slice(4).filter(a => a.endsWith('.ts') || a.endsWith('.js') || a.endsWith('.json') || a.endsWith('.md')),
+            });
+            console.log(C.success(`  Handoff logged: ${title}`));
+        }
+        catch (e) {
+            console.log(C.warn(`  Log failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    console.log(C.bold('  Cell Handoff'));
+    console.log(C.dim('  ─────────'));
+    console.log(C.dim('  cell handoff                   Show current handoff'));
+    console.log(C.dim('  cell handoff --current          Show current handoff'));
+    console.log(C.dim('  cell handoff --history [YYYY-MM] Show monthly history'));
+    console.log(C.dim('  cell handoff --update           Rotate if too long'));
+    console.log(C.dim('  cell handoff --log "title" "summary"  Log new entry'));
+    console.log();
+}
+// ─── cell memory — search/timeline/compact/verify/export ─────────────────────
+function doMemory() {
+    const sub = args[1] || '';
+    const cwd = process.cwd();
+    if (sub === 'search' || sub === 's') {
+        const query = args[2] || '';
+        if (!query) {
+            console.log(C.warn('  Usage: cell memory search <query>'));
+            console.log();
+            return;
+        }
+        console.log(C.bold(`  ── Memory Search: "${query}" ──\n`));
+        try {
+            const { searchMemoryEvents } = require('../../06-memory/stores/memory-event-store');
+            const { detectProject } = require('../setup/setup');
+            const project = detectProject(cwd).name;
+            const events = searchMemoryEvents(query, project, 20);
+            if (events.length === 0) {
+                console.log(C.dim('  No matching memories found.'));
+            }
+            else {
+                for (const ev of events) {
+                    const imp = ev.importance >= 8 ? C.success(`[IMP:${ev.importance}]`) : ev.importance >= 5 ? C.primary(`[${ev.importance}]`) : C.dim(`[${ev.importance}]`);
+                    console.log(`  ${imp} ${C.dim(ev.created_at)} ${C.primary(ev.type)}: ${ev.summary}`);
+                    if (ev.topic)
+                        console.log(C.dim(`    topic: ${ev.topic}`));
+                    if (ev.files_json) {
+                        try {
+                            const files = JSON.parse(ev.files_json);
+                            if (files.length > 0)
+                                console.log(C.dim(`    files: ${files.join(', ')}`));
+                        }
+                        catch { }
+                    }
+                }
+                console.log(C.dim(`\n  ${events.length} result(s) found.`));
+            }
+        }
+        catch (e) {
+            console.log(C.warn(`  Search failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === 'timeline' || sub === 't') {
+        const days = parseInt(args[2] || '30', 10);
+        console.log(C.bold(`  ── Memory Timeline (${days} days) ──\n`));
+        try {
+            const { getMemoryTimeline } = require('../../06-memory/stores/memory-event-store');
+            const { detectProject } = require('../setup/setup');
+            const project = detectProject(cwd).name;
+            const timeline = getMemoryTimeline(project, days);
+            if (timeline.length === 0) {
+                console.log(C.dim('  No events in this period.'));
+            }
+            else {
+                for (const day of timeline) {
+                    const bar = '█'.repeat(Math.min(day.count, 30));
+                    console.log(`  ${C.dim(day.date)} ${C.primary(bar)} ${day.count} events`);
+                    const types = Object.entries(day.types).map(([t, c]) => `${t}:${c}`).join(', ');
+                    console.log(C.dim(`    ${types}`));
+                }
+            }
+        }
+        catch (e) {
+            console.log(C.warn(`  Timeline failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === 'compact' || sub === 'c') {
+        console.log(C.primary('  Compacting memory...'));
+        try {
+            const { rotateHandoffIfNeeded } = require('../../06-memory/handoff/handoff-store');
+            const rotated = rotateHandoffIfNeeded(cwd);
+            if (rotated)
+                console.log(C.success('  Handoff rotated.'));
+            else
+                console.log(C.dim('  No handoff rotation needed.'));
+            const { getMemoryStats } = require('../../06-memory/stores/memory-event-store');
+            const stats = getMemoryStats();
+            console.log(C.success(`  Memory events: ${stats.total} | Avg importance: ${stats.avgImportance}`));
+        }
+        catch (e) {
+            console.log(C.warn(`  Compact failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === 'verify' || sub === 'v') {
+        console.log(C.bold('  ── Memory Verify ──\n'));
+        try {
+            const { getMemoryStats } = require('../../06-memory/stores/memory-event-store');
+            const stats = getMemoryStats();
+            console.log(`  Events: ${C.num(String(stats.total))}`);
+            console.log(`  Avg importance: ${stats.avgImportance}`);
+            console.log(`  Oldest: ${stats.oldestEvent || 'none'}`);
+            console.log(`  Newest: ${stats.newestEvent || 'none'}`);
+            if (Object.keys(stats.byType).length > 0) {
+                console.log(C.dim('\n  By type:'));
+                for (const [type, count] of Object.entries(stats.byType).sort((a, b) => b[1] - a[1])) {
+                    console.log(`    ${type}: ${count}`);
+                }
+            }
+            const { getHandoffStats } = require('../../06-memory/handoff/handoff-store');
+            const hs = getHandoffStats(cwd);
+            console.log(C.dim('\n  Handoff:'));
+            console.log(`    Current lines: ${hs.currentLines}`);
+            console.log(`    History months: ${hs.historyMonths}`);
+            console.log(`    DB entries: ${hs.dbEntries}`);
+            console.log(`    Needs rotation: ${hs.needsRotation}`);
+        }
+        catch (e) {
+            console.log(C.warn(`  Verify failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === 'export' || sub === 'e') {
+        console.log(C.bold('  ── Memory Export ──\n'));
+        try {
+            const { getMemoryEvents, getMemoryStats } = require('../../06-memory/stores/memory-event-store');
+            const stats = getMemoryStats();
+            const events = getMemoryEvents({ limit: 500 });
+            const exportData = { stats, events, exportedAt: new Date().toISOString() };
+            const exportPath = require('path').join(cwd, '.cell', 'memory', 'export.json');
+            require('fs').writeFileSync(exportPath, JSON.stringify(exportData, null, 2));
+            console.log(C.success(`  Exported ${events.length} events to .cell/memory/export.json`));
+        }
+        catch (e) {
+            console.log(C.warn(`  Export failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === 'stats') {
+        console.log(C.bold('  ── Memory Stats ──\n'));
+        try {
+            const { getMemoryStats } = require('../../06-memory/stores/memory-event-store');
+            const stats = getMemoryStats();
+            console.log(`  Total events: ${C.num(String(stats.total))}`);
+            console.log(`  Avg importance: ${stats.avgImportance}`);
+            console.log(`  Oldest: ${stats.oldestEvent || 'none'}`);
+            console.log(`  Newest: ${stats.newestEvent || 'none'}`);
+            if (Object.keys(stats.byType).length > 0) {
+                console.log(C.dim('\n  By type:'));
+                for (const [type, count] of Object.entries(stats.byType).sort((a, b) => b[1] - a[1])) {
+                    console.log(`    ${type}: ${count}`);
+                }
+            }
+        }
+        catch (e) {
+            console.log(C.warn(`  Stats failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === 'health') {
+        console.log(C.bold('  ── Memory Health ──\n'));
+        try {
+            const { getMemoryHealth } = require('../../06-memory/archive/memory-compact');
+            const h = getMemoryHealth(cwd);
+            console.log(`  Events: ${C.num(String(h.eventCount))}`);
+            console.log(`  Archive chunks: ${h.archiveChunks}`);
+            console.log(`  Handoff lines: ${h.handoffLines}`);
+            console.log(`  Avg importance: ${h.avgImportance}`);
+            console.log(`  Oldest: ${h.oldestEvent || 'none'}`);
+            console.log(`  Newest: ${h.newestEvent || 'none'}`);
+        }
+        catch (e) {
+            console.log(C.warn(`  Health check failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === 'summary' || sub === 'sum') {
+        const period = args[2] || 'daily';
+        console.log(C.bold(`  ── Memory Summary (${period}) ──\n`));
+        try {
+            const { generateDailySummary, generateWeeklySummary } = require('../../06-memory/stores/summary-generator');
+            const { detectProject } = require('../setup/setup');
+            const project = detectProject(cwd).name;
+            const summary = period === 'weekly'
+                ? generateWeeklySummary(project, cwd)
+                : generateDailySummary(project);
+            console.log(`  Date: ${summary.date}`);
+            console.log(`  Project: ${summary.project}`);
+            console.log(`  Total events: ${summary.totalEvents}`);
+            console.log(`  Avg importance: ${summary.importance}`);
+            if (summary.topTopics.length > 0)
+                console.log(`  Top topics: ${summary.topTopics.join(', ')}`);
+            if (summary.keyDecisions.length > 0) {
+                console.log(C.dim('\n  Key decisions:'));
+                for (const d of summary.keyDecisions.slice(0, 5))
+                    console.log(`    ${C.primary('→')} ${d}`);
+            }
+            if (summary.errors.length > 0) {
+                console.log(C.dim('\n  Errors:'));
+                for (const e of summary.errors.slice(0, 5))
+                    console.log(`    ${C.warn('✗')} ${e}`);
+            }
+            if (Object.keys(summary.byType).length > 0) {
+                console.log(C.dim('\n  By type:'));
+                for (const [type, count] of Object.entries(summary.byType).sort((a, b) => b[1] - a[1])) {
+                    console.log(`    ${type}: ${count}`);
+                }
+            }
+        }
+        catch (e) {
+            console.log(C.warn(`  Summary failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    console.log(C.bold('  Cell Memory'));
+    console.log(C.dim('  ──────────'));
+    console.log(C.dim('  cell memory search <query>       Search memory events'));
+    console.log(C.dim('  cell memory timeline [days]      Show activity timeline'));
+    console.log(C.dim('  cell memory compact              Compact & rotate'));
+    console.log(C.dim('  cell memory verify               Verify memory health'));
+    console.log(C.dim('  cell memory health               Full memory health check'));
+    console.log(C.dim('  cell memory summary [daily|weekly] Generate summary'));
+    console.log(C.dim('  cell memory export               Export to JSON'));
+    console.log(C.dim('  cell memory stats                Show memory stats'));
+    console.log();
+}
 //# sourceMappingURL=cli.js.map