dual-brain 0.2.30 → 0.3.0

package/src/provider-context.mjs

@@ -1,257 +0,0 @@
-import { existsSync, readFileSync, mkdirSync, writeFileSync, readdirSync } from 'node:fs';
-import { join } from 'node:path';
-
-// ── Provider capabilities registry ──────────────────────────────────────────
-
-const PROVIDER_CAPS = {
-  claude: {
-    name: 'Claude Code',
-    cli: 'claude',
-    hasNativeCompaction: true,
-    compactionStrategy: 'automatic',
-    contextFormat: 'markdown-blocks',
-    supportsSpecialists: true,
-    supportsSituationBrief: true,
-    maxContextTokens: 200_000,
-    sessionStorage: 'claude-internal',
-    authCheck: 'claude --version',
-    resumeSupport: 'receipt + handoff',
-  },
-  openai: {
-    name: 'Codex CLI',
-    cli: 'codex',
-    hasNativeCompaction: false,
-    compactionStrategy: 'none',
-    contextFormat: 'plain-text',
-    supportsSpecialists: false,
-    supportsSituationBrief: true,
-    maxContextTokens: 128_000,
-    sessionStorage: '~/.codex/sessions/YYYY/MM/DD/*.jsonl',
-    authCheck: 'codex --version',
-    resumeSupport: 'handoff-only',
-  },
-};
-
-export function getProviderCaps(provider) {
-  return PROVIDER_CAPS[provider] || PROVIDER_CAPS.claude;
-}
-
-// ── Provider-agnostic context injection ─────────────────────────────────────
-
-/**
- * Build a context block that works for any provider.
- * Adapts format based on provider capabilities.
- */
-export function buildContextBlock(provider, sections) {
-  const caps = getProviderCaps(provider);
-  const lines = [];
-
-  if (caps.contextFormat === 'markdown-blocks') {
-    for (const [label, content] of Object.entries(sections)) {
-      if (!content) continue;
-      lines.push(`[${label.toUpperCase()}]`);
-      lines.push(typeof content === 'string' ? content : JSON.stringify(content));
-      lines.push(`[/${label.toUpperCase()}]`);
-      lines.push('');
-    }
-  } else {
-    for (const [label, content] of Object.entries(sections)) {
-      if (!content) continue;
-      lines.push(`--- ${label} ---`);
-      lines.push(typeof content === 'string' ? content : JSON.stringify(content));
-      lines.push('');
-    }
-  }
-
-  return lines.join('\n').trim();
-}
-
-// ── Compaction survival for both providers ───────────────────────────────────
-
-/**
- * Build a compaction survival block tuned for the target provider.
- *
- * Claude: uses tagged blocks that survive automatic context compression.
- * Codex: no native compaction, but we prepend a compact state header that
- *        stays at the top of the context window and serves as a quick-reference
- *        for the model when the conversation gets long.
- */
-export function buildSurvivalBlock(provider, state) {
-  const caps = getProviderCaps(provider);
-
-  const coreLines = [];
-  if (state.activeTask) coreLines.push(`TASK: ${state.activeTask}`);
-  if (state.provider) coreLines.push(`PROVIDER: ${state.provider}/${state.model || 'default'}`);
-  if (state.tier) coreLines.push(`TIER: ${state.tier}`);
-  if (state.risk) coreLines.push(`RISK: ${state.risk}`);
-  if (state.filesInProgress?.length) coreLines.push(`FILES: ${state.filesInProgress.slice(0, 10).join(', ')}`);
-  if (state.decisions?.length) coreLines.push(`DECISIONS: ${state.decisions.slice(0, 3).join('; ')}`);
-  if (state.warnings?.length) coreLines.push(`WARNINGS: ${state.warnings.slice(0, 3).join('; ')}`);
-  if (state.routingRules?.length) coreLines.push(`ROUTING: ${state.routingRules.join('; ')}`);
-
-  if (caps.hasNativeCompaction) {
-    return `[DUAL-BRAIN CONTINUITY]\n${coreLines.join('\n')}\n[/DUAL-BRAIN CONTINUITY]`;
-  }
-
-  // Codex: compact header block — placed at prompt start for max visibility
-  return `## dual-brain state\n${coreLines.join('\n')}\n---`;
-}
-
-// ── Provider-agnostic handoff ───────────────────────────────────────────────
-
-/**
- * Generate a handoff receipt that works for both providers.
- * Accounts for Codex's lack of native resume support by writing
- * to a shared .dualbrain/handoffs/ directory that both providers can read.
- */
-export function generateProviderHandoff(sessionState, provider) {
-  const caps = getProviderCaps(provider);
-
-  const handoff = {
-    version: 2,
-    provider,
-    providerCaps: caps.name,
-    timestamp: new Date().toISOString(),
-    task: sessionState.taskDescription || null,
-    progress: {
-      filesChanged: (sessionState.filesChanged || []).slice(0, 20),
-      testsRun: sessionState.testsRun || [],
-      decisions: (sessionState.decisions || []).slice(0, 5),
-    },
-    unresolved: (sessionState.unresolved || []).slice(0, 5),
-    routing: {
-      lastProvider: provider,
-      lastModel: sessionState.routingHistory?.lastModel || null,
-      failedProviders: sessionState.routingHistory?.failedProviders || [],
-    },
-    resumeHint: sessionState.resumeHint || null,
-    resumeStrategy: caps.resumeSupport,
-  };
-
-  return handoff;
-}
-
-/**
- * Build a resume brief from the latest handoff, adapted for the resuming provider.
- * Codex gets a more verbose brief since it has no native session memory.
- */
-export function buildProviderResumeBrief(cwd, targetProvider) {
-  const dir = join(cwd || process.cwd(), '.dualbrain', 'handoffs');
-  if (!existsSync(dir)) return null;
-
-  const files = readdirSync(dir)
-    .filter(f => f.startsWith('handoff-') && f.endsWith('.json'))
-    .sort()
-    .reverse();
-  if (files.length === 0) return null;
-
-  let handoff;
-  try {
-    handoff = JSON.parse(readFileSync(join(dir, files[0]), 'utf8'));
-  } catch {
-    return null;
-  }
-
-  const age = (Date.now() - Date.parse(handoff.timestamp)) / 3600000;
-  if (age > 48) return null;
-
-  const caps = getProviderCaps(targetProvider);
-  const lines = [];
-
-  const ageLabel = age < 1 ? 'just now' : age < 24 ? `${Math.round(age)}h ago` : `${Math.round(age / 24)}d ago`;
-  lines.push(`Resuming from previous session (${ageLabel}, ran on ${handoff.provider || 'unknown'}):`);
-
-  if (handoff.task) lines.push(`  Task: ${handoff.task}`);
-  if (handoff.resumeHint) lines.push(`  Next: ${handoff.resumeHint}`);
-
-  if (handoff.progress?.filesChanged?.length) {
-    const shown = handoff.progress.filesChanged.slice(0, caps.hasNativeCompaction ? 5 : 10);
-    lines.push(`  Changed: ${shown.join(', ')}`);
-  }
-
-  if (handoff.unresolved?.length) {
-    lines.push(`  Unresolved: ${handoff.unresolved.join('; ')}`);
-  }
-
-  // Codex gets extra context since it has no native session memory
-  if (!caps.hasNativeCompaction && handoff.progress?.decisions?.length) {
-    lines.push(`  Prior routing: ${handoff.progress.decisions.map(d => `${d.provider}/${d.model}`).join(', ')}`);
-  }
-
-  if (handoff.routing?.failedProviders?.length) {
-    lines.push(`  Note: ${handoff.routing.failedProviders.join(', ')} failed last session`);
-  }
-
-  return lines.join('\n');
-}
-
-// ── Specialist/plugin injection (provider-aware) ────────────────────────────
-
-/**
- * Build a capability hint block for the target provider.
- * Claude: specialist prompts from agents/specialists/.
- * Codex: plugin hints from matched Codex plugins.
- */
-export function buildCapabilityHint(provider, prompt, cwd) {
-  if (provider === 'claude') {
-    return null; // Handled by dispatch.mjs specialist injection
-  }
-
-  // Codex: try to match plugins
-  try {
-    const { matchPluginsForTask } = require('./replit.mjs');
-    const matched = matchPluginsForTask(prompt, undefined, cwd);
-    if (matched.length > 0) {
-      const names = matched.slice(0, 3).map(m => m.plugin.id).join(', ');
-      return `[Available Codex plugins: ${names}. Consider using matching plugins for direct API access.]`;
-    }
-  } catch {}
-
-  return null;
-}
-
-// ── Context budget tracking (provider-aware) ────────────────────────────────
-
-/**
- * Estimate remaining context budget for a provider.
- */
-export function estimateContextBudget(provider, usedTokens) {
-  const caps = getProviderCaps(provider);
-  const remaining = caps.maxContextTokens - usedTokens;
-
-  return {
-    provider,
-    maxTokens: caps.maxContextTokens,
-    usedTokens,
-    remainingTokens: Math.max(0, remaining),
-    utilizationPct: Math.round((usedTokens / caps.maxContextTokens) * 100),
-    compactionRisk: remaining < 20_000 ? 'critical' : remaining < 50_000 ? 'high' : remaining < 100_000 ? 'medium' : 'low',
-    hasNativeCompaction: caps.hasNativeCompaction,
-    action: caps.hasNativeCompaction
-      ? (remaining < 20_000 ? 'survival-kit-injected' : 'none')
-      : (remaining < 30_000 ? 'manual-handoff-recommended' : 'none'),
-  };
-}
-
-// ── Cross-provider compatibility helpers ────────────────────────────────────
-
-/**
- * Get the opposite provider for cross-review.
- * Handles the case where the opposite provider isn't available.
- */
-export function getReviewProvider(workProvider, availableProviders) {
-  const opposite = workProvider === 'claude' ? 'openai' : 'claude';
-  if (availableProviders?.includes(opposite)) return opposite;
-
-  // Same-provider review with different model if opposite unavailable
-  return workProvider;
-}
-
-/**
- * Check if both providers are available for true dual-brain operation.
- */
-export function isDualProviderAvailable(profile) {
-  const claude = profile?.providers?.claude?.enabled !== false;
-  const openai = profile?.providers?.openai?.enabled && profile?.providers?.openai?.plan;
-  return { claude, openai, dual: claude && openai };
-}

package/src/receipt.mjs

@@ -1,344 +0,0 @@
-import { mkdirSync, writeFileSync, appendFileSync, readFileSync, existsSync, readdirSync } from 'node:fs';
-import { join } from 'node:path';
-import { execSync } from 'node:child_process';
-
-const DIM   = '\x1b[2m';
-const GREEN = '\x1b[32m';
-const YELLOW= '\x1b[33m';
-const RED   = '\x1b[31m';
-const RESET = '\x1b[0m';
-
-const SEP = `${DIM}──────────────────────────────────${RESET}`;
-
-const AUTH_PAT = /\b(auth|credential|secret|token|password|encrypt|permission|oauth|jwt|api.?key)\b/i;
-
-function classifyRisk(plan, result) {
-  if (plan.risk) return plan.risk;
-  const files = result.filesChanged ?? [];
-  if (files.some(f => AUTH_PAT.test(f))) return 'critical';
-  if (plan.tier === 'think') return 'high';
-  if (plan.tier === 'execute') return 'medium';
-  return 'low';
-}
-
-function classifyChallenger(plan, result) {
-  const policy = plan.challengerPolicy;
-  if (!plan.useChallenger && (!policy || policy === 'none')) return 'not used';
-  if (!result.success) return 'blocked';
-  if (result.output && /concern|issue|warn|problem/i.test(String(result.output))) return 'concerns raised';
-  return 'pass';
-}
-
-function nextStep(result, plan, verification) {
-  const files = result.filesChanged ?? [];
-  const changed = files.length > 0;
-  const authFiles = files.some(f => AUTH_PAT.test(f));
-
-  if (!result.success) {
-    const retry = result.error && /test/i.test(String(result.error));
-    return retry ? 'fix failing tests' : 'retry with deeper analysis';
-  }
-
-  if (authFiles) return 'security review recommended';
-
-  if (changed) {
-    if (!verification.testsRun) return 'run tests to verify';
-    if (verification.testsPassed === false) return 'fix failing tests';
-    if (verification.testsPassed === true) return 'commit this patch';
-    return 'review the diff';
-  }
-
-  return 'review the output';
-}
-
-export function buildReceipt(result, plan, verification) {
-  const files = result.filesChanged ?? [];
-  const changed = files.length > 0 ? files.join(', ') : 'no files changed';
-
-  let verified;
-  if (verification.testsPassed === true) verified = 'tests passed';
-  else if (verification.filesVerified) verified = 'files confirmed changed';
-  else verified = 'not verified';
-
-  return {
-    changed,
-    verified,
-    risk: classifyRisk(plan, result),
-    challenger: classifyChallenger(plan, result),
-    next: nextStep(result, plan, verification),
-    success: result.success ?? false,
-  };
-}
-
-function colorRisk(risk) {
-  if (risk === 'low') return `${GREEN}${risk}${RESET}`;
-  if (risk === 'medium') return `${YELLOW}${risk}${RESET}`;
-  return `${RED}${risk}${RESET}`;
-}
-
-function colorChallenger(ch) {
-  if (ch === 'pass') return `${GREEN}${ch}${RESET}`;
-  if (ch === 'concerns raised') return `${YELLOW}${ch}${RESET}`;
-  if (ch === 'blocked') return `${RED}${ch}${RESET}`;
-  return `${DIM}${ch}${RESET}`;
-}
-
-export function formatReceipt(receipt) {
-  return [
-    SEP,
-    `  Changed:    ${receipt.changed}`,
-    `  Verified:   ${receipt.verified}`,
-    `  Risk:       ${colorRisk(receipt.risk)}`,
-    `  Challenger: ${colorChallenger(receipt.challenger)}`,
-    `  Next:       ${receipt.next}`,
-    SEP,
-  ].join('\n');
-}
-
-export function formatFailureReceipt(receipt, failureContext) {
-  const errorLine = failureContext ? `  Error:      ${failureContext}` : null;
-  const lines = [
-    SEP,
-    `  Changed:    ${receipt.changed}`,
-    `  Verified:   ${receipt.verified}`,
-    `  Risk:       ${colorRisk(receipt.risk)}`,
-    `  Challenger: ${colorChallenger(receipt.challenger)}`,
-  ];
-  if (errorLine) lines.push(errorLine);
-  lines.push(`  Next:       ${receipt.next}`, SEP);
-  return lines.join('\n');
-}
-
-// ─── Persistent session receipt ──────────────────────────────────────────────
-
-const RECEIPTS_DIR = '.dualbrain/receipts';
-
-function receiptsDir(cwd) {
-  return join(cwd, RECEIPTS_DIR);
-}
-
-function gitChangedFiles(cwd) {
-  try {
-    const out = execSync('git diff --name-only HEAD', { cwd, stdio: ['ignore', 'pipe', 'pipe'] })
-      .toString().trim();
-    if (!out) return [];
-    return out.split('\n').filter(Boolean);
-  } catch {
-    return [];
-  }
-}
-
-function readDecisionsRecent(cwd, limit = 5) {
-  try {
-    const raw = readFileSync(join(cwd, '.dualbrain', 'decisions.jsonl'), 'utf8');
-    const lines = raw.split('\n').filter(l => l.trim());
-    return lines.slice(-limit).map(l => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
-  } catch {
-    return [];
-  }
-}
-
-function ageLabel(ms) {
-  const mins = Math.round(ms / 60000);
-  if (mins < 60) return `${mins}m ago`;
-  const hours = Math.round(mins / 60);
-  if (hours < 24) return `${hours}h ago`;
-  return `${Math.round(hours / 24)}d ago`;
-}
-
-/**
- * Generate a persistent session receipt and append it to the receipts store.
- * @param {object} run  PipelineRun object (or any outcome object with compatible fields)
- * @param {string} cwd  Working directory
- * @returns {object}    The receipt object
- */
-export function generateReceipt(run = {}, cwd = process.cwd()) {
-  const now = new Date();
-  const ts = now.toISOString();
-
-  // Derive files changed — prefer run.result, fall back to git diff
-  const filesChanged = (run.result?.filesChanged?.length > 0)
-    ? run.result.filesChanged
-    : gitChangedFiles(cwd);
-
-  // Recent decisions from living docs
-  const decisionEntries = readDecisionsRecent(cwd, 5);
-  const decisions = decisionEntries.map(d => d.question || d.decision || '').filter(Boolean).slice(0, 3);
-
-  // Test results
-  const testsRun = run.verification?.ok !== undefined
-    ? (run.verification.ok ? 'passed' : 'failed')
-    : null;
-
-  // Unresolved risks from plan
-  const risksUnresolved = [];
-  if (run.plan?.approvalRequired && !run.outcome?.approved) {
-    risksUnresolved.push('approval required but not obtained');
-  }
-  if (run.verification && !run.verification.ok) {
-    risksUnresolved.push('verification failed');
-  }
-  const verNotes = run.verification?.notes ?? [];
-  for (const note of verNotes) {
-    if (/warn|risk|unverif|no file changes/i.test(note)) risksUnresolved.push(note.slice(0, 80));
-  }
-
-  // Blockers — gates that failed
-  const blockers = [];
-  for (const [name, g] of Object.entries(run.gates ?? {})) {
-    if (g && !g.passed) blockers.push(`${name}: ${g.reason?.slice(0, 80)}`);
-  }
-  if (run.result?.error) blockers.push(run.result.error.slice(0, 80));
-
-  // Derive status
-  const success = run.result && !run.result.error && (run.verification?.ok !== false);
-  const status = !run.result ? 'incomplete'
-    : blockers.length > 0 ? 'failed'
-    : success ? 'success'
-    : 'partial';
-
-  // Next action (reuse existing logic)
-  let nextAction = 'review the output';
-  if (status === 'success' && filesChanged.length > 0) {
-    nextAction = run.verification?.testsRun ? 'commit changes' : 'run tests, then commit';
-  } else if (status === 'failed') {
-    nextAction = 'investigate failure, retry with adjusted approach';
-  } else if (status === 'partial') {
-    nextAction = 'check partial output, verify manually';
-  }
-
-  const duration = (run.completedAt && run.startedAt)
-    ? Math.round((run.completedAt - run.startedAt) / 1000)
-    : null;
-
-  const receipt = {
-    timestamp: ts,
-    goal: (run.prompt ?? '').slice(0, 200),
-    filesChanged,
-    decisions,
-    testsRun,
-    risksUnresolved,
-    blockers,
-    nextAction,
-    provider: run.plan?.primaryProvider ?? run.result?.provider ?? null,
-    model: run.plan?.primaryModel ?? run.result?.model ?? null,
-    duration,
-    status,
-  };
-
-  // Store receipt
-  try {
-    const dir = receiptsDir(cwd);
-    mkdirSync(dir, { recursive: true });
-
-    const filename = ts.replace(/[:.]/g, '-').slice(0, 19) + '.json';
-    writeFileSync(join(dir, filename), JSON.stringify(receipt, null, 2));
-
-    // One-line summary for fast scanning
-    const summary = {
-      ts,
-      goal: receipt.goal.slice(0, 80),
-      status,
-      files: filesChanged.length,
-      next: nextAction.slice(0, 60),
-    };
-    appendFileSync(join(dir, 'index.jsonl'), JSON.stringify(summary) + '\n');
-  } catch {
-    // Storage failure is non-blocking
-  }
-
-  return receipt;
-}
-
-/**
- * Read the most recent receipt(s) and build a compact resume brief (max 500 chars).
- * @param {string} cwd
- * @returns {string|null}
- */
-export function buildResumeBrief(cwd = process.cwd()) {
-  try {
-    const dir = receiptsDir(cwd);
-    if (!existsSync(dir)) return null;
-
-    // Find the most recent receipt JSON file
-    const files = readdirSync(dir)
-      .filter(f => f.endsWith('.json') && f !== 'index.json')
-      .sort()
-      .reverse();
-
-    if (files.length === 0) return null;
-
-    const raw = readFileSync(join(dir, files[0]), 'utf8');
-    const r = JSON.parse(raw);
-
-    const age = ageLabel(Date.now() - Date.parse(r.timestamp));
-    const filesSummary = r.filesChanged?.length > 0
-      ? r.filesChanged.slice(0, 3).map(f => f.split('/').pop()).join(', ')
-        + (r.filesChanged.length > 3 ? ` +${r.filesChanged.length - 3}` : '')
-      : 'no files changed';
-    const riskLine = r.risksUnresolved?.length > 0
-      ? `Risk: ${r.risksUnresolved[0].slice(0, 60)}`
-      : null;
-
-    const lines = [
-      'RESUME CONTEXT:',
-      `Last session: ${age}`,
-      `Goal: ${(r.goal || 'unknown').slice(0, 80)}`,
-      `Done: ${filesSummary}`,
-      `Status: ${r.status}${r.testsRun ? ', tests ' + r.testsRun : ''}`,
-    ];
-    if (riskLine) lines.push(riskLine);
-    lines.push(`Next: ${(r.nextAction || '').slice(0, 80)}`);
-
-    const brief = lines.join('\n');
-    return brief.length > 500 ? brief.slice(0, 497) + '...' : brief;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Return the most recent receipt object, or null if none exists or the store is empty.
- * @param {string} cwd
- * @returns {object|null}
- */
-export function getLatestReceipt(cwd = process.cwd()) {
-  try {
-    const dir = receiptsDir(cwd);
-    if (!existsSync(dir)) return null;
-    const files = readdirSync(dir)
-      .filter(f => f.endsWith('.json') && f !== 'index.json')
-      .sort()
-      .reverse();
-    if (files.length === 0) return null;
-    const raw = readFileSync(join(dir, files[0]), 'utf8');
-    return JSON.parse(raw);
-  } catch {
-    return null;
-  }
-}
-
-export function buildReceiptFromOutcome(outcome = {}) {
-  const result = {
-    success: outcome.success ?? outcome.result?.success ?? false,
-    filesChanged: outcome.filesChanged ?? outcome.result?.filesChanged ?? [],
-    error: outcome.error ?? outcome.result?.error ?? null,
-    duration: outcome.duration ?? outcome.result?.duration ?? 0,
-    output: outcome.output ?? null,
-  };
-  const plan = {
-    primaryModel: outcome.primaryModel ?? '',
-    reasoningDepth: outcome.reasoningDepth ?? '',
-    challengerPolicy: outcome.challengerPolicy ?? 'none',
-    useChallenger: !!(outcome.challengerPolicy && outcome.challengerPolicy !== 'none'),
-    tier: outcome.tier ?? '',
-    workStyle: outcome.workStyle ?? '',
-    risk: outcome.risk ?? '',
-  };
-  const verification = {
-    filesVerified: outcome.verification?.filesVerified ?? false,
-    testsRun: outcome.verification?.testsRun ?? false,
-    testsPassed: outcome.verification?.testsPassed ?? null,
-  };
-  return buildReceipt(result, plan, verification);
-}