cognitive-core 0.2.4 → 0.3.1

package/src/bin/commands/learn.ts

@@ -1,100 +0,0 @@
-/**
- * Learning pipeline CLI commands — batch, maintenance, stats.
- */
-
-import { type CLIOptions, withAtlas } from '../cli-utils.js';
-
-export async function learnCommand(
-  command: string,
-  _positional: string[],
-  options: CLIOptions,
-): Promise<void> {
-  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: CLIOptions): Promise<void> {
-  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: CLIOptions): Promise<void> {
-  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: CLIOptions): Promise<void> {
-  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'}`);
-    }
-  });
-}

package/src/bin/commands/legacy.ts

@@ -1,182 +0,0 @@
-/**
- * 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 type { Trajectory, AtlasConfig } from '../../types/index.js';
-import {
-  type CLIOptions,
-  withAtlas,
-  resolveStorageDir,
-  formatPlaybook,
-} from '../cli-utils.js';
-
-export async function initCommand(options: CLIOptions): Promise<void> {
-  const dir = options.dir || resolveStorageDir();
-  await fs.mkdir(dir, { recursive: true });
-  const atlas = createAtlas({ storage: { baseDir: dir } } as Partial<AtlasConfig>);
-  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: string,
-  options: CLIOptions,
-): Promise<void> {
-  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: string,
-  options: CLIOptions,
-): Promise<void> {
-  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: CLIOptions): Promise<void> {
-  await withAtlas(options, async (atlas) => {
-    const allPlaybooks = await atlas.getMemory().playbooks.getAll();
-    const domainCounts = new Map<string, number>();
-
-    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: CLIOptions): Promise<void> {
-  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: string,
-  options: CLIOptions,
-): Promise<void> {
-  await withAtlas(options, async (atlas) => {
-    const raw = await fs.readFile(trajectoryFile, 'utf-8');
-    const trajectory = JSON.parse(raw) as Trajectory;
-
-    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}`);
-    }
-  });
-}

package/src/bin/commands/run.ts

@@ -1,113 +0,0 @@
-import { join } from 'node:path';
-import { createAtlas } from '../../atlas.js';
-import type { AtlasConfig } from '../../types/index.js';
-import { SessionBank } from '../../session-bank/session-bank.js';
-import { SessionTrajectorySource } from '../../learning/trajectory-sources/entire.js';
-import type { CLIOptions } from '../cli-utils.js';
-import { resolveStorageDir } from '../cli-utils.js';
-
-export async function runCommand(options: CLIOptions): Promise<void> {
-  const dir = options.dir || resolveStorageDir();
-  const atlas = createAtlas({
-    storage: { baseDir: dir },
-    knowledgeBank: { enabled: true },
-  } as Partial<AtlasConfig>);
-
-  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(): Promise<number> {
-    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())));
-    }
-  }
-}

package/src/bin/commands/sessions.ts

@@ -1,221 +0,0 @@
-/**
- * Session bank CLI commands.
- *
- * SessionBank is standalone — it reads SessionLog checkpoint data from
- * orphan branches and does NOT depend on Atlas.
- */
-
-import { join } from 'node:path';
-import { SessionBank } from '../../session-bank/session-bank.js';
-import type { SessionQuery, SessionRecord } from '../../session-bank/types.js';
-import type { CLIOptions } from '../cli-utils.js';
-import { outputJson, resolveStorageDir } from '../cli-utils.js';
-
-// ─── Local Lifecycle Wrapper ──────────────────────────────────────────
-
-async function withSessionBank<T>(
-  options: CLIOptions,
-  fn: (bank: SessionBank) => Promise<T>,
-): Promise<T> {
-  const stateDir = join(options.dir || resolveStorageDir(), 'session-bank');
-  const bank = new SessionBank({
-    repoPath: options.repo || process.cwd(),
-    stateDir,
-  });
-  try {
-    await bank.init();
-    if (!bank.isAvailable()) {
-      throw new Error(
-        'SessionLog not available. No checkpoint branch found in this repository.',
-      );
-    }
-    return await fn(bank);
-  } finally {
-    await bank.close();
-  }
-}
-
-// ─── Formatters ───────────────────────────────────────────────────────
-
-function formatSessionLine(s: SessionRecord): string {
-  const date = s.metadata.createdAt.toISOString().slice(0, 19).replace('T', ' ');
-  const files = s.metadata.filesTouched.length;
-  const agent = s.metadata.agent || 'unknown';
-  const branch = s.metadata.branch || '-';
-  return [
-    `  ${s.sessionId}`,
-    `    Checkpoint: ${s.checkpointId}`,
-    `    Date:       ${date}`,
-    `    Branch:     ${branch}`,
-    `    Agent:      ${agent}`,
-    `    Files:      ${files}`,
-  ].join('\n');
-}
-
-// ─── Subcommands ──────────────────────────────────────────────────────
-
-async function sessionsList(options: CLIOptions): Promise<void> {
-  await withSessionBank(options, async (bank) => {
-    let sessions = await bank.discover();
-
-    // Sort newest first
-    sessions.sort(
-      (a, b) => b.metadata.createdAt.getTime() - a.metadata.createdAt.getTime(),
-    );
-
-    // Apply limit
-    if (options.limit && options.limit > 0) {
-      sessions = sessions.slice(0, options.limit);
-    }
-
-    if (options.format === 'json') {
-      const summaries = sessions.map((s) => ({
-        sessionId: s.sessionId,
-        checkpointId: s.checkpointId,
-        createdAt: s.metadata.createdAt.toISOString(),
-        branch: s.metadata.branch,
-        agent: s.metadata.agent,
-        filesCount: s.metadata.filesTouched.length,
-        hasSummary: s.summary !== undefined,
-      }));
-      outputJson(summaries);
-      return;
-    }
-
-    if (sessions.length === 0) {
-      console.log('No sessions found.');
-      return;
-    }
-
-    console.log(`Found ${sessions.length} session(s):\n`);
-    for (const s of sessions) {
-      console.log(formatSessionLine(s));
-      console.log('');
-    }
-  });
-}
-
-async function sessionsGet(
-  sessionId: string,
-  options: CLIOptions,
-): Promise<void> {
-  await withSessionBank(options, async (bank) => {
-    const record = await bank.getBySessionId(sessionId);
-
-    if (!record) {
-      throw new Error(`Session not found: ${sessionId}`);
-    }
-
-    if (options.format === 'json') {
-      outputJson(record);
-      return;
-    }
-
-    const date = record.metadata.createdAt.toISOString().slice(0, 19).replace('T', ' ');
-    console.log(`Session: ${record.sessionId}`);
-    console.log(`Checkpoint: ${record.checkpointId}`);
-    console.log(`Date: ${date}`);
-    console.log(`Branch: ${record.metadata.branch}`);
-    console.log(`Agent: ${record.metadata.agent}`);
-    console.log(`Strategy: ${record.metadata.strategy}`);
-    console.log(`Files touched: ${record.metadata.filesTouched.length}`);
-    console.log(`Transcript messages: ${record.transcript.length}`);
-
-    if (record.summary) {
-      console.log('');
-      console.log('Summary:');
-      console.log(`  Intent: ${record.summary.intent}`);
-      console.log(`  Outcome: ${record.summary.outcome}`);
-    }
-
-    if (record.tokenUsage) {
-      console.log('');
-      console.log('Token usage:');
-      console.log(`  Input:  ${record.tokenUsage.inputTokens}`);
-      console.log(`  Output: ${record.tokenUsage.outputTokens}`);
-      console.log(`  Total:  ${record.tokenUsage.total}`);
-    }
-  });
-}
-
-async function sessionsQuery(options: CLIOptions): Promise<void> {
-  await withSessionBank(options, async (bank) => {
-    const query: SessionQuery = {};
-
-    if (options.agent) query.agent = options.agent;
-    if (options.since) query.since = new Date(options.since);
-    if (options.before) query.before = new Date(options.before);
-    if (options.limit) query.limit = options.limit;
-    if (options.branch) query.branch = options.branch;
-
-    const result = await bank.query(query);
-
-    if (options.format === 'json') {
-      const summaries = result.sessions.map((s) => ({
-        sessionId: s.sessionId,
-        checkpointId: s.checkpointId,
-        createdAt: s.metadata.createdAt.toISOString(),
-        branch: s.metadata.branch,
-        agent: s.metadata.agent,
-        filesCount: s.metadata.filesTouched.length,
-        hasSummary: s.summary !== undefined,
-      }));
-      outputJson({ sessions: summaries, total: result.total });
-      return;
-    }
-
-    if (result.sessions.length === 0) {
-      console.log('No sessions match the query.');
-      return;
-    }
-
-    console.log(`${result.sessions.length} of ${result.total} session(s):\n`);
-    for (const s of result.sessions) {
-      console.log(formatSessionLine(s));
-      console.log('');
-    }
-  });
-}
-
-// ─── Dispatcher ───────────────────────────────────────────────────────
-
-export async function sessionsCommand(
-  command: string,
-  positional: string[],
-  options: CLIOptions,
-): Promise<void> {
-  switch (command) {
-    case 'list':
-      await sessionsList(options);
-      break;
-
-    case 'get':
-      if (!positional[0]) {
-        console.error('Usage: cogcore sessions get <session-id>');
-        process.exit(1);
-      }
-      await sessionsGet(positional[0], options);
-      break;
-
-    case 'query':
-      await sessionsQuery(options);
-      break;
-
-    default:
-      console.log(`
-Sessions — interact with SessionLog checkpoint data
-
-Usage:
-  cogcore sessions list    [--limit <n>] [--json]
-  cogcore sessions get     <session-id> [--json]
-  cogcore sessions query   [--agent <name>] [--branch <branch>]
-                                  [--since <date>] [--before <date>]
-                                  [--limit <n>] [--json]
-`);
-      if (command) {
-        console.error(`Unknown sessions subcommand: ${command}`);
-        process.exit(1);
-      }
-      break;
-  }
-}