fivocell 6.0.2 → 6.1.0

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

@@ -3134,6 +3134,9 @@ function doHelp() {
     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 memory doctor')}   Full health check — .cell structure + archive + memory`);
+    console.log(`  ${C.primary('cell memory mirror')}   Sync DB → .cell portable readable files`);
+    console.log(`  ${C.primary('cell memory context')}   Show context (--short/--full/--topic <name>)`);
     console.log(`  ${C.primary('cell cross-project')}  Share/list/insights from cross-project memory`);
     console.log(`  ${C.primary('cell dashboard')}     Open web dashboard in browser`);
     console.log(`  ${C.primary('cell perf')}         Show performance stats & cache info`);
@@ -3720,6 +3723,124 @@ function doMemory() {
         console.log();
         return;
     }
+    if (sub === 'doctor' || sub === 'd') {
+        console.log(C.bold('  ── Memory Doctor ──\n'));
+        try {
+            const project = path.basename(cwd);
+            const { verifyCellHealth } = require('../../06-memory/mirror/cell-mirror');
+            const { verifyArchiveIntegrity } = require('../../06-memory/archive/archive-versioning');
+            const { getMemoryStats } = require('../../06-memory/stores/memory-event-store');
+            // Cell mirror health
+            const cellHealth = verifyCellHealth(cwd);
+            console.log(C.dim('  .cell Structure:'));
+            const checks = [
+                ['handoff/current.md', cellHealth.handoffCurrent],
+                ['handoff/history/', cellHealth.handoffHistory],
+                ['summaries/daily/', cellHealth.summariesDaily],
+                ['summaries/weekly/', cellHealth.summariesWeekly],
+                ['summaries/monthly/', cellHealth.summariesMonthly],
+                ['patterns/code-patterns.json', cellHealth.patternsCode],
+                ['patterns/error-patterns.json', cellHealth.patternsError],
+                ['patterns/fix-patterns.json', cellHealth.patternsFix],
+                ['patterns/architecture-patterns.json', cellHealth.patternsArch],
+                ['style/developer-style.json', cellHealth.styleDeveloper],
+                ['style/project-style.json', cellHealth.styleProject],
+                ['style/communication.md', cellHealth.styleCommunication],
+                ['context/short.md', cellHealth.contextShort],
+                ['context/full.md', cellHealth.contextFull],
+                ['context/last-session.md', cellHealth.contextLastSession],
+                ['memory/archive/', cellHealth.archiveDir],
+                ['private/', cellHealth.privateDir],
+            ];
+            for (const [name, ok] of checks) {
+                console.log(`    ${ok ? C.success('✓') : C.warn('✗')} ${name}`);
+            }
+            console.log(`  Total .cell files: ${C.num(String(cellHealth.totalFiles))}`);
+            // Archive integrity
+            console.log(C.dim('\n  Archive Integrity:'));
+            const archiveHealth = verifyArchiveIntegrity(cwd);
+            console.log(`    Total chunks: ${archiveHealth.totalChunks}`);
+            console.log(`    Versioned: ${archiveHealth.versionedChunks}`);
+            console.log(`    Unversioned: ${archiveHealth.unversionedChunks}`);
+            console.log(`    Total events: ${archiveHealth.totalEvents}`);
+            if (archiveHealth.issues.length > 0) {
+                for (const issue of archiveHealth.issues) {
+                    console.log(`    ${C.warn('⚠')} ${issue}`);
+                }
+            }
+            else {
+                console.log(`    ${C.success('All chunks healthy')}`);
+            }
+            // Memory stats
+            console.log(C.dim('\n  Memory Stats:'));
+            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'}`);
+            // Overall verdict
+            const totalIssues = cellHealth.issues.length + archiveHealth.issues.length;
+            console.log();
+            if (totalIssues === 0) {
+                console.log(C.success('  Doctor verdict: HEALTHY ✓'));
+            }
+            else {
+                console.log(C.warn(`  Doctor verdict: ${totalIssues} issue(s) found`));
+                for (const issue of cellHealth.issues) {
+                    console.log(`    ${C.warn('⚠')} ${issue}`);
+                }
+            }
+        }
+        catch (e) {
+            console.log(C.warn(`  Doctor failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === 'mirror' || sub === 'm') {
+        console.log(C.bold('  ── Cell Mirror Sync ──\n'));
+        try {
+            const project = path.basename(cwd);
+            const { syncCellMirror } = require('../../06-memory/mirror/cell-mirror');
+            syncCellMirror(cwd, project);
+            console.log(C.success('  .cell mirror synced successfully'));
+            console.log(`  Project: ${project}`);
+            console.log(`  Location: ${path.join(cwd, '.cell')}`);
+            const { verifyCellHealth } = require('../../06-memory/mirror/cell-mirror');
+            const health = verifyCellHealth(cwd);
+            console.log(`  Files: ${health.totalFiles}`);
+            if (health.issues.length > 0) {
+                console.log(C.dim(`  Note: ${health.issues.length} missing items`));
+            }
+        }
+        catch (e) {
+            console.log(C.warn(`  Mirror sync failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
+    if (sub === 'context' || sub === 'ctx') {
+        const ctxMode = args[0] || '--short';
+        console.log(C.bold(`  ── Context (${ctxMode}) ──\n`));
+        try {
+            const project = path.basename(cwd);
+            const { buildContext } = require('../../06-memory/retrieval/context-pipeline');
+            const topic = args[1];
+            const result = buildContext({
+                project,
+                projectDir: cwd,
+                mode: ctxMode === '--full' ? 'full' : ctxMode === '--topic' ? 'topic' : 'short',
+                topic,
+            });
+            console.log(result.compactContext);
+            console.log(C.dim(`\n  Sources: ${result.stats.totalSources} | Events: ${result.stats.totalEvents} | Score: ${result.stats.relevanceScore.toFixed(1)}`));
+        }
+        catch (e) {
+            console.log(C.warn(`  Context failed: ${e?.message || String(e)}`));
+        }
+        console.log();
+        return;
+    }
     if (sub === 'export' || sub === 'e') {
         console.log(C.bold('  ── Memory Export ──\n'));
         try {