cognitive-core 0.1.0 → 0.2.0

package/dist/bin/commands/kb.js

@@ -0,0 +1,240 @@
+/**
+ * Knowledge bank CLI commands — search, list, get, stats, defrag.
+ */
+import { withAtlas, requireKnowledgeBank, outputJson } from '../cli-utils.js';
+// ─── Main Dispatcher ────────────────────────────────────────────────
+export async function kbCommand(command, positional, options) {
+    switch (command) {
+        case 'search':
+            if (!positional[0]) {
+                console.error('Error: search requires a query');
+                console.error('Usage: cogcore kb search <query> [--limit <n>]');
+                process.exit(1);
+            }
+            await kbSearch(positional[0], options);
+            break;
+        case 'list':
+            await kbList(options);
+            break;
+        case 'get':
+            if (!positional[0]) {
+                console.error('Error: get requires an ID or name');
+                console.error('Usage: cogcore kb get <id-or-name>');
+                process.exit(1);
+            }
+            await kbGet(positional[0], options);
+            break;
+        case 'stats':
+            await kbStats(options);
+            break;
+        case 'defrag':
+            await kbDefrag(options);
+            break;
+        default:
+            if (command) {
+                console.error(`Unknown kb command: ${command}`);
+            }
+            showKbHelp();
+            process.exit(command ? 1 : 0);
+    }
+}
+// ─── Subcommands ────────────────────────────────────────────────────
+async function kbSearch(query, options) {
+    await withAtlas(options, async (atlas) => {
+        const kb = requireKnowledgeBank(atlas);
+        const matches = await kb.search(query, { maxResults: options.limit || 10 });
+        if (options.format === 'json') {
+            outputJson(matches.map((m) => ({
+                id: m.note.frontmatter.id,
+                type: m.note.frontmatter.type,
+                score: m.score,
+                body: m.note.body.slice(0, 200),
+            })));
+        }
+        else {
+            if (matches.length === 0) {
+                console.log('No knowledge notes found matching your query.');
+                return;
+            }
+            console.log(`Found ${matches.length} note(s) matching "${query}":\n`);
+            for (const m of matches) {
+                const snippet = m.note.body.slice(0, 100).replace(/\n/g, ' ');
+                console.log(`  ${m.note.frontmatter.id} [${m.note.frontmatter.type}] (score: ${Math.round(m.score * 100)}%)`);
+                console.log(`    ${snippet}`);
+                console.log('');
+            }
+        }
+    });
+}
+async function kbList(options) {
+    await withAtlas(options, async (atlas) => {
+        const kb = requireKnowledgeBank(atlas);
+        if (options.type === 'entities') {
+            const entities = await kb.listEntities();
+            if (options.format === 'json') {
+                outputJson(entities);
+            }
+            else {
+                if (entities.length === 0) {
+                    console.log('No entities found.');
+                    return;
+                }
+                console.log('Entities:\n');
+                for (const name of entities) {
+                    console.log(`  ${name}`);
+                }
+            }
+            return;
+        }
+        if (options.type === 'domains') {
+            const domains = await kb.listDomains();
+            if (options.format === 'json') {
+                outputJson(domains);
+            }
+            else {
+                if (domains.length === 0) {
+                    console.log('No domains found.');
+                    return;
+                }
+                console.log('Domains:\n');
+                for (const name of domains) {
+                    console.log(`  ${name}`);
+                }
+            }
+            return;
+        }
+        // Default: all notes summary
+        const notes = await kb.getAllNotes();
+        if (options.format === 'json') {
+            outputJson(notes.map((n) => ({
+                id: n.frontmatter.id,
+                type: n.frontmatter.type,
+                domain: n.frontmatter.domain,
+                confidence: n.frontmatter.confidence,
+            })));
+        }
+        else {
+            if (notes.length === 0) {
+                console.log('No knowledge notes found.');
+                return;
+            }
+            console.log(`${notes.length} knowledge note(s):\n`);
+            for (const n of notes) {
+                const domains = n.frontmatter.domain.join(', ') || '(none)';
+                console.log(`  ${n.frontmatter.id}  ${n.frontmatter.type.padEnd(16)} conf=${Math.round(n.frontmatter.confidence * 100)}%  domains=${domains}`);
+            }
+        }
+    });
+}
+async function kbGet(idOrName, options) {
+    await withAtlas(options, async (atlas) => {
+        const kb = requireKnowledgeBank(atlas);
+        // Cascade: note by ID → entity by name → domain summary by name
+        let note = await kb.getNote(idOrName);
+        if (!note)
+            note = await kb.getEntity(idOrName);
+        if (!note)
+            note = await kb.getDomainSummary(idOrName);
+        if (!note) {
+            throw new Error(`Not found: ${idOrName}`);
+        }
+        if (options.format === 'json') {
+            outputJson(note);
+        }
+        else {
+            const fm = note.frontmatter;
+            console.log(`ID: ${fm.id}`);
+            console.log(`Type: ${fm.type}`);
+            console.log(`Domain: ${fm.domain.join(', ') || '(none)'}`);
+            console.log(`Entities: ${fm.entities.join(', ') || '(none)'}`);
+            console.log(`Confidence: ${Math.round(fm.confidence * 100)}%`);
+            console.log(`Tags: ${fm.tags.join(', ') || '(none)'}`);
+            console.log(`Created: ${fm.created}`);
+            console.log(`Updated: ${fm.updated}`);
+            console.log('');
+            console.log(note.body);
+        }
+    });
+}
+async function kbStats(options) {
+    await withAtlas(options, async (atlas) => {
+        const kb = requireKnowledgeBank(atlas);
+        const stats = await kb.getStats();
+        if (options.format === 'json') {
+            outputJson(stats);
+        }
+        else {
+            console.log('Knowledge Bank Statistics\n');
+            console.log(`Observations: ${stats.observationCount}`);
+            console.log(`Entities: ${stats.entityCount}`);
+            console.log(`Domains: ${stats.domainCount}`);
+            console.log(`Inbox: ${stats.inboxCount}`);
+            console.log(`Avg Confidence: ${Math.round(stats.avgConfidence * 100)}%`);
+            console.log(`Stale Notes: ${stats.staleCount}`);
+            console.log('');
+            console.log('Graph:');
+            console.log(`  Nodes: ${stats.graph.nodeCount}`);
+            console.log(`  Layers: ${stats.graph.enabledLayers.join(', ') || '(none)'}`);
+            for (const [layer, count] of Object.entries(stats.graph.edgeCountByLayer)) {
+                console.log(`  ${layer} edges: ${count}`);
+            }
+            if (Object.keys(stats.domainBreakdown).length > 0) {
+                console.log('');
+                console.log('Domain Breakdown:');
+                for (const [domain, count] of Object.entries(stats.domainBreakdown)) {
+                    console.log(`  ${domain}: ${count} note(s)`);
+                }
+            }
+        }
+    });
+}
+async function kbDefrag(options) {
+    await withAtlas(options, async (atlas) => {
+        const kb = requireKnowledgeBank(atlas);
+        const result = await kb.defragment();
+        if (options.format === 'json') {
+            outputJson(result);
+        }
+        else {
+            console.log('Knowledge Bank Defragmentation Complete\n');
+            console.log('Inbox:');
+            console.log(`  Processed: ${result.inbox.processed}`);
+            console.log(`  Failed: ${result.inbox.failed}`);
+            console.log(`  → Observations: ${result.inbox.movedToObservations}`);
+            console.log(`  → Entities: ${result.inbox.movedToEntities}`);
+            console.log(`  → Domains: ${result.inbox.movedToDomains}`);
+            console.log('');
+            console.log(`Consolidated: ${result.consolidated}`);
+            console.log(`Contradictions: ${result.contradictions}`);
+            console.log(`Graph Rebuilt: ${result.graphRebuilt}`);
+            console.log(`Domain Summaries Regenerated: ${result.domainSummariesRegenerated}`);
+            console.log('');
+            console.log('Decay:');
+            console.log(`  Decayed: ${result.decay.decayed}`);
+            console.log(`  Newly Stale: ${result.decay.newlyStale}`);
+            console.log(`  Already Stale: ${result.decay.alreadyStale}`);
+        }
+    });
+}
+// ─── Help ───────────────────────────────────────────────────────────
+function showKbHelp() {
+    console.log(`
+Knowledge Bank Commands
+
+Usage:
+  cogcore kb <command> [options]
+
+Commands:
+  search <query>      Search knowledge notes
+  list                List all notes (or --type entities|domains)
+  get <id-or-name>    Get a note by ID, entity name, or domain name
+  stats               Show knowledge bank statistics
+  defrag              Run defragmentation (inbox, consolidation, decay)
+
+Options:
+  --limit <n>         Max results for search (default: 10)
+  --type <type>       For list: entities | domains
+  --json              Output in JSON format
+`);
+}
+//# sourceMappingURL=kb.js.map

package/dist/bin/commands/kb.js.map

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

package/dist/bin/commands/learn.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Learning pipeline CLI commands — batch, maintenance, stats.
+ */
+import { type CLIOptions } from '../cli-utils.js';
+export declare function learnCommand(command: string, _positional: string[], options: CLIOptions): Promise<void>;
+//# sourceMappingURL=learn.d.ts.map

package/dist/bin/commands/learn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/learn.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAa,MAAM,iBAAiB,CAAC;AAE7D,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/bin/commands/learn.js

@@ -0,0 +1,91 @@
+/**
+ * Learning pipeline CLI commands — batch, maintenance, stats.
+ */
+import { withAtlas } from '../cli-utils.js';
+export async function learnCommand(command, _positional, options) {
+    switch (command) {
+        case 'batch':
+            return learnBatch(options);
+        case 'maintenance':
+            return learnMaintenance(options);
+        case 'stats':
+            return learnStats(options);
+        default:
+            if (command) {
+                console.error(`Unknown learn command: ${command}`);
+            }
+            console.log('Usage: cogcore learn <command>\n');
+            console.log('Commands:');
+            console.log('  batch         Run batch learning on accumulated trajectories');
+            console.log('  maintenance   Run maintenance cycle (defrag, healing, meta-strategies)');
+            console.log('  stats         Show learning pipeline statistics');
+            process.exit(command ? 1 : 0);
+    }
+}
+async function learnBatch(options) {
+    await withAtlas(options, async (atlas) => {
+        const result = await atlas.runBatchLearning();
+        if (options.format === 'json') {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log('Batch Learning Results:\n');
+            console.log(`  Trajectories processed: ${result.trajectoriesProcessed}`);
+            console.log(`  Playbooks extracted:    ${result.playbooksExtracted}`);
+            console.log(`  Experiences pruned:     ${result.experiencesPruned}`);
+            console.log(`  Compression:`);
+            console.log(`    Promoted: ${result.experiencesCompressed.promoted}`);
+            console.log(`    Demoted:  ${result.experiencesCompressed.demoted}`);
+            console.log(`    Evicted:  ${result.experiencesCompressed.evicted}`);
+            console.log(`  Experiences clustered:  ${result.experiencesClustered}`);
+            console.log(`  Knowledge extracted:    ${result.knowledgeExtracted}`);
+            console.log(`  Success rate:           ${Math.round(result.successRate * 100)}%`);
+            console.log(`  Trigger reasons:        ${result.triggerReasons.join(', ') || 'manual'}`);
+        }
+    });
+}
+async function learnMaintenance(options) {
+    await withAtlas(options, async (atlas) => {
+        const result = await atlas.getLearning().runMaintenance({ force: true });
+        if (options.format === 'json') {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            if (!result.ran) {
+                console.log(`Maintenance skipped: ${result.skipReason ?? 'unknown reason'}`);
+                return;
+            }
+            console.log('Maintenance Results:\n');
+            for (const task of result.taskResults) {
+                const status = task.success ? 'OK' : 'FAILED';
+                console.log(`  [${status}] ${task.taskName} (${task.durationMs}ms)`);
+                if (task.details) {
+                    for (const [key, value] of Object.entries(task.details)) {
+                        console.log(`         ${key}: ${value}`);
+                    }
+                }
+            }
+            console.log(`\n  Total duration: ${result.totalDurationMs}ms`);
+        }
+    });
+}
+async function learnStats(options) {
+    await withAtlas(options, async (atlas) => {
+        const stats = atlas.getLearning().getStats();
+        if (options.format === 'json') {
+            console.log(JSON.stringify(stats, null, 2));
+        }
+        else {
+            console.log('Learning Pipeline Stats:\n');
+            console.log(`  Total processed:              ${stats.totalProcessed}`);
+            console.log(`  Batch cycles run:             ${stats.batchCyclesRun}`);
+            console.log(`  Maintenance cycles run:       ${stats.maintenanceCyclesRun}`);
+            console.log(`  Pending for batch:            ${stats.pendingForBatch}`);
+            console.log(`  Batches since maintenance:    ${stats.batchesSinceLastMaintenance}`);
+            console.log(`  Maintenance tasks:            ${stats.maintenanceTasks.join(', ') || 'none'}`);
+            console.log(`  Anomaly detectors:            ${stats.anomalyDetectors.join(', ') || 'none'}`);
+            console.log(`  Repair strategies:            ${stats.repairStrategies.join(', ') || 'none'}`);
+        }
+    });
+}
+//# sourceMappingURL=learn.js.map

package/dist/bin/commands/learn.js.map

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

package/dist/bin/commands/legacy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Legacy CLI commands — init, search, get, domains, stats, store.
+ * All migrated to use Atlas-backed withAtlas lifecycle.
+ */
+import { type CLIOptions } from '../cli-utils.js';
+export declare function initCommand(options: CLIOptions): Promise<void>;
+export declare function searchCommand(query: string, options: CLIOptions): Promise<void>;
+export declare function getCommand(playbookId: string, options: CLIOptions): Promise<void>;
+export declare function domainsCommand(options: CLIOptions): Promise<void>;
+export declare function statsCommand(options: CLIOptions): Promise<void>;
+export declare function storeCommand(trajectoryFile: string, options: CLIOptions): Promise<void>;
+//# sourceMappingURL=legacy.d.ts.map

package/dist/bin/commands/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/legacy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,iBAAiB,CAAC;AAEzB,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBpE;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCvE;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBrE;AAED,wBAAsB,YAAY,CAChC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/bin/commands/legacy.js

@@ -0,0 +1,142 @@
+/**
+ * Legacy CLI commands — init, search, get, domains, stats, store.
+ * All migrated to use Atlas-backed withAtlas lifecycle.
+ */
+import * as fs from 'node:fs/promises';
+import { createAtlas } from '../../atlas.js';
+import { withAtlas, resolveStorageDir, formatPlaybook, } from '../cli-utils.js';
+export async function initCommand(options) {
+    const dir = options.dir || resolveStorageDir();
+    await fs.mkdir(dir, { recursive: true });
+    const atlas = createAtlas({ storage: { baseDir: dir } });
+    await atlas.init();
+    await atlas.close();
+    if (options.format === 'json') {
+        console.log(JSON.stringify({ initialized: true, dir }));
+    }
+    else {
+        console.log(`Initialized cogcore storage at ${dir}`);
+        console.log('\nNext steps:');
+        console.log('  cogcore store <trajectory.json>  — ingest a trajectory');
+        console.log('  cogcore search "<query>"          — find playbooks');
+        console.log('  cogcore stats                     — view system stats');
+    }
+}
+export async function searchCommand(query, options) {
+    await withAtlas(options, async (atlas) => {
+        const matches = await atlas.getMemory().playbooks.findMatching(query, {
+            k: options.limit || 5,
+            domains: options.domain ? [options.domain] : undefined,
+            minConfidence: 0.3,
+        });
+        if (options.format === 'json') {
+            const results = matches.map((m) => ({
+                id: m.playbook.id,
+                name: m.playbook.name,
+                score: m.score,
+                matchType: m.matchType,
+                confidence: m.playbook.confidence,
+                strategy: m.playbook.guidance.strategy,
+                tactics: m.playbook.guidance.tactics,
+                domains: m.playbook.applicability.domains,
+            }));
+            console.log(JSON.stringify(results, null, 2));
+        }
+        else {
+            if (matches.length === 0) {
+                console.log('No matching playbooks found.');
+                return;
+            }
+            console.log(`Found ${matches.length} matching playbook(s):\n`);
+            for (const m of matches) {
+                console.log(formatPlaybook(m.playbook));
+                console.log(`  Match: ${m.matchType} (score: ${m.score.toFixed(2)})\n`);
+            }
+        }
+    });
+}
+export async function getCommand(playbookId, options) {
+    await withAtlas(options, async (atlas) => {
+        const playbook = await atlas.getMemory().playbooks.get(playbookId);
+        if (!playbook) {
+            if (options.format === 'json') {
+                console.log(JSON.stringify({ error: 'Playbook not found' }));
+            }
+            else {
+                console.error(`Playbook not found: ${playbookId}`);
+            }
+            process.exit(1);
+        }
+        if (options.format === 'json') {
+            console.log(JSON.stringify(playbook, null, 2));
+        }
+        else {
+            console.log(formatPlaybook(playbook, true));
+        }
+    });
+}
+export async function domainsCommand(options) {
+    await withAtlas(options, async (atlas) => {
+        const allPlaybooks = await atlas.getMemory().playbooks.getAll();
+        const domainCounts = new Map();
+        for (const playbook of allPlaybooks) {
+            for (const domain of playbook.applicability.domains) {
+                domainCounts.set(domain, (domainCounts.get(domain) ?? 0) + 1);
+            }
+        }
+        const sorted = Array.from(domainCounts.entries()).sort((a, b) => b[1] - a[1]);
+        if (options.format === 'json') {
+            console.log(JSON.stringify({ domains: sorted.map(([name, playbookCount]) => ({ name, playbookCount })) }, null, 2));
+        }
+        else {
+            if (sorted.length === 0) {
+                console.log('No domains found.');
+                return;
+            }
+            console.log('Domains:\n');
+            for (const [name, count] of sorted) {
+                console.log(`  ${name} (${count} playbook${count !== 1 ? 's' : ''})`);
+            }
+        }
+    });
+}
+export async function statsCommand(options) {
+    await withAtlas(options, async (atlas) => {
+        const stats = await atlas.getStats();
+        const capacity = await atlas.getMemory().getCapacityStatus();
+        if (options.format === 'json') {
+            console.log(JSON.stringify({ stats, capacity }, null, 2));
+        }
+        else {
+            console.log('System Stats:\n');
+            console.log(`  Experiences: ${stats.memory.experienceCount}`);
+            console.log(`  Playbooks:   ${stats.memory.playbookCount}`);
+            console.log(`  Trajectories processed: ${stats.learning.trajectoriesProcessed}`);
+            console.log(`  Pending trajectories:   ${stats.learning.pendingTrajectories}`);
+            console.log('\nCapacity:');
+            console.log(`  Experiences: ${capacity.experiences.current}/${capacity.experiences.limit}`);
+            console.log(`  Playbooks:   ${capacity.playbooks.current}/${capacity.playbooks.limit}`);
+        }
+    });
+}
+export async function storeCommand(trajectoryFile, options) {
+    await withAtlas(options, async (atlas) => {
+        const raw = await fs.readFile(trajectoryFile, 'utf-8');
+        const trajectory = JSON.parse(raw);
+        const result = await atlas.processTrajectory(trajectory);
+        if (options.format === 'json') {
+            console.log(JSON.stringify({
+                stored: true,
+                trajectoryId: trajectory.id,
+                experienceId: result.instantLoop.experienceId,
+                batchTriggered: result.batchTriggered,
+            }, null, 2));
+        }
+        else {
+            console.log(`Stored trajectory: ${trajectory.id}`);
+            console.log(`  Experience ID:   ${result.instantLoop.experienceId}`);
+            console.log(`  Batch triggered: ${result.batchTriggered}`);
+        }
+    });
+}
+//# sourceMappingURL=legacy.js.map

package/dist/bin/commands/legacy.js.map

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

package/dist/bin/commands/run.d.ts

@@ -0,0 +1,3 @@
+import type { CLIOptions } from '../cli-utils.js';
+export declare function runCommand(options: CLIOptions): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/bin/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwGnE"}

package/dist/bin/commands/run.js

@@ -0,0 +1,99 @@
+import { join } from 'node:path';
+import { createAtlas } from '../../atlas.js';
+import { SessionBank } from '../../session-bank/session-bank.js';
+import { SessionTrajectorySource } from '../../learning/trajectory-sources/entire.js';
+import { resolveStorageDir } from '../cli-utils.js';
+export async function runCommand(options) {
+    const dir = options.dir || resolveStorageDir();
+    const atlas = createAtlas({
+        storage: { baseDir: dir },
+        knowledgeBank: { enabled: true },
+    });
+    const stateDir = join(dir, 'session-bank');
+    const bank = new SessionBank({
+        repoPath: options.repo || process.cwd(),
+        stateDir,
+    });
+    const source = new SessionTrajectorySource(bank);
+    await atlas.init();
+    try {
+        await bank.init();
+    }
+    catch (error) {
+        await atlas.close();
+        throw error;
+    }
+    if (!bank.isAvailable()) {
+        console.error('SessionLog not available. No checkpoint branch found in this repository.');
+        await bank.close();
+        await atlas.close();
+        process.exit(1);
+    }
+    let running = true;
+    const cleanup = async () => {
+        if (!running)
+            return;
+        running = false;
+        await bank.close();
+        await atlas.close();
+    };
+    process.on('SIGINT', () => {
+        console.log('\nShutting down...');
+        cleanup().then(() => process.exit(0)).catch(() => process.exit(1));
+    });
+    process.on('SIGTERM', () => {
+        cleanup().then(() => process.exit(0)).catch(() => process.exit(1));
+    });
+    const intervalMs = (options.interval || 30) * 1000;
+    async function processNewSessions() {
+        const sessions = await bank.discover();
+        const unprocessed = sessions.filter(s => !bank.isProcessed(s.sessionId));
+        let count = 0;
+        for (const session of unprocessed) {
+            try {
+                const trajectory = source.synthesize(session);
+                await atlas.processTrajectory(trajectory);
+                await bank.markProcessed(session.sessionId, {
+                    trajectoryId: trajectory.id,
+                    processedAt: new Date().toISOString(),
+                });
+                count++;
+                console.log(`Processed: ${session.sessionId} → ${trajectory.id}`);
+            }
+            catch (error) {
+                console.error(`Failed to process ${session.sessionId}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return count;
+    }
+    // --once mode: process all unprocessed and exit
+    if (options.once) {
+        const count = await processNewSessions();
+        console.log(`Processed ${count} session(s).`);
+        await cleanup();
+        return;
+    }
+    // Continuous mode: poll loop
+    console.log(`Watching for new sessions (poll interval: ${intervalMs / 1000}s)...`);
+    console.log(`Storage: ${dir}`);
+    console.log(`Repository: ${options.repo || process.cwd()}`);
+    console.log('');
+    while (running) {
+        try {
+            bank.invalidateCache();
+            const count = await processNewSessions();
+            if (count > 0) {
+                console.log(`--- Cycle complete: ${count} session(s) processed ---`);
+            }
+        }
+        catch (error) {
+            console.error(`Poll error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Sleep, but check running flag periodically for faster shutdown
+        const sleepEnd = Date.now() + intervalMs;
+        while (running && Date.now() < sleepEnd) {
+            await new Promise(resolve => setTimeout(resolve, Math.min(1000, sleepEnd - Date.now())));
+        }
+    }
+}
+//# sourceMappingURL=run.js.map