dual-brain 0.2.30 → 0.3.1

package/dist/src/continuity.d.ts

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+export interface HandoffSessionState {
+    taskDescription?: string;
+    filesChanged?: string[];
+    testsRun?: string[];
+    decisions?: object[];
+    unresolved?: string[];
+    routingHistory?: {
+        lastProvider?: string;
+        lastModel?: string;
+        failedProviders?: string[];
+    };
+    activePreferences?: string[];
+    resumeHint?: string;
+    narrative?: string;
+}
+export interface Handoff {
+    version: number;
+    timestamp: string;
+    task: string | null;
+    progress: {
+        filesChanged: string[];
+        testsRun: string[];
+        decisions: object[];
+    };
+    unresolved: string[];
+    routing: {
+        lastProvider: string | null;
+        lastModel: string | null;
+        failedProviders: string[];
+    };
+    preferences: string[];
+    resumeHint: string | null;
+    narrative: string | null;
+}
+/**
+ * Generate a compact handoff object from current session state.
+ * Designed to fit in ~500 tokens when serialized.
+ */
+export declare function generateHandoff(sessionState: HandoffSessionState): Handoff;
+/**
+ * Persist a handoff object to .dualbrain/handoffs/.
+ */
+export declare function saveHandoff(handoff: Handoff, cwd?: string): string;
+/**
+ * Load the most recent handoff from .dualbrain/handoffs/.
+ * Returns null when no handoffs exist or all are unreadable.
+ */
+export declare function getLatestHandoff(cwd?: string): Handoff | null;
+/**
+ * Return the age of a handoff in hours.
+ * Returns Infinity when the handoff has no timestamp.
+ */
+export declare function getHandoffAge(handoff: Handoff | null): number;
+export interface CompactionState {
+    activeTask?: string;
+    routingRules?: string[];
+    criticalDecisions?: string[];
+    filesInProgress?: string[];
+    preferences?: string[];
+    warnings?: string[];
+}
+/**
+ * Build a compaction-safe summary string to inject before context compression.
+ */
+export declare function buildCompactionSurvivalKit(state: CompactionState): string;
+/**
+ * Check for a recent handoff and build a resume context string for a new session.
+ * Returns null when no usable handoff exists (missing, too stale, or unreadable).
+ */
+export declare function buildResumeBrief(cwd?: string): string | null;
+/**
+ * Remove old handoff files, keeping only the most recent `keep` entries.
+ */
+export declare function pruneHandoffs(cwd?: string, keep?: number): number;
+export interface RoutingPattern {
+    type: string;
+    value: string;
+    count: number;
+}
+export interface RoutingPatterns {
+    patterns: RoutingPattern[];
+    confidence: number;
+    sampleSize: number;
+}
+/**
+ * Extract routing patterns from handoff history to inform provider/model selection.
+ */
+export declare function extractRoutingPatterns(cwd?: string): RoutingPatterns;

package/dist/src/continuity.js

@@ -0,0 +1,230 @@
+#!/usr/bin/env node
+// continuity.ts — Session continuity for dual-brain.
+// Generates handoff receipts so the next session can pick up seamlessly
+// when a session hits context limits, crashes, or is manually ended.
+//
+// Exports: generateHandoff, saveHandoff, getLatestHandoff, getHandoffAge,
+//          buildCompactionSurvivalKit, buildResumeBrief, pruneHandoffs,
+//          extractRoutingPatterns
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { load as loadNarrative } from './narrative.js';
+/**
+ * Generate a compact handoff object from current session state.
+ * Designed to fit in ~500 tokens when serialized.
+ */
+export function generateHandoff(sessionState) {
+    return {
+        version: 2,
+        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: sessionState.routingHistory?.lastProvider || null,
+            lastModel: sessionState.routingHistory?.lastModel || null,
+            failedProviders: sessionState.routingHistory?.failedProviders || [],
+        },
+        preferences: sessionState.activePreferences || [],
+        resumeHint: sessionState.resumeHint || null,
+        narrative: sessionState.narrative || loadNarrative() || null,
+    };
+}
+// ─── Handoff persistence ──────────────────────────────────────────────────────
+/**
+ * Persist a handoff object to .dualbrain/handoffs/.
+ */
+export function saveHandoff(handoff, cwd) {
+    const dir = join(cwd || process.cwd(), '.dualbrain', 'handoffs');
+    mkdirSync(dir, { recursive: true });
+    const filename = `handoff-${Date.now()}.json`;
+    writeFileSync(join(dir, filename), JSON.stringify(handoff, null, 2));
+    return join(dir, filename);
+}
+/**
+ * Load the most recent handoff from .dualbrain/handoffs/.
+ * Returns null when no handoffs exist or all are unreadable.
+ */
+export function getLatestHandoff(cwd) {
+    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;
+    try {
+        return JSON.parse(readFileSync(join(dir, files[0]), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Return the age of a handoff in hours.
+ * Returns Infinity when the handoff has no timestamp.
+ */
+export function getHandoffAge(handoff) {
+    if (!handoff?.timestamp)
+        return Infinity;
+    return (Date.now() - Date.parse(handoff.timestamp)) / 3600000;
+}
+/**
+ * Build a compaction-safe summary string to inject before context compression.
+ */
+export function buildCompactionSurvivalKit(state) {
+    const lines = [];
+    lines.push('[DUAL-BRAIN CONTINUITY]');
+    if (state.activeTask) {
+        lines.push(`TASK: ${state.activeTask}`);
+    }
+    if (state.routingRules?.length) {
+        lines.push(`ROUTING: ${state.routingRules.join('; ')}`);
+    }
+    if (state.criticalDecisions?.length) {
+        lines.push(`DECISIONS: ${state.criticalDecisions.join('; ')}`);
+    }
+    if (state.filesInProgress?.length) {
+        lines.push(`FILES: ${state.filesInProgress.join(', ')}`);
+    }
+    if (state.preferences?.length) {
+        lines.push(`PREFS: ${state.preferences.join('; ')}`);
+    }
+    if (state.warnings?.length) {
+        lines.push(`WARNINGS: ${state.warnings.join('; ')}`);
+    }
+    lines.push('[/DUAL-BRAIN CONTINUITY]');
+    return lines.join('\n');
+}
+// ─── Resume brief builder ─────────────────────────────────────────────────────
+/**
+ * Check for a recent handoff and build a resume context string for a new session.
+ * Returns null when no usable handoff exists (missing, too stale, or unreadable).
+ */
+export function buildResumeBrief(cwd) {
+    const handoff = getLatestHandoff(cwd);
+    if (!handoff)
+        return null;
+    const ageHours = getHandoffAge(handoff);
+    if (ageHours > 48)
+        return null; // too stale to be useful
+    const lines = [];
+    const ageLabel = ageHours < 1
+        ? 'just now'
+        : ageHours < 24
+            ? `${Math.round(ageHours)}h ago`
+            : `${Math.round(ageHours / 24)}d ago`;
+    lines.push(`Resuming from previous session (${ageLabel}):`);
+    // Narrative first — most valuable context for immersion
+    if (handoff.narrative) {
+        lines.push(`  Context: ${handoff.narrative.slice(0, 300)}`);
+    }
+    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, 5);
+        const extra = handoff.progress.filesChanged.length > 5
+            ? ` (+${handoff.progress.filesChanged.length - 5} more)`
+            : '';
+        lines.push(`  Changed: ${shown.join(', ')}${extra}`);
+    }
+    if (handoff.unresolved?.length) {
+        lines.push(`  Unresolved: ${handoff.unresolved.join('; ')}`);
+    }
+    if (handoff.routing?.failedProviders?.length) {
+        lines.push(`  Note: ${handoff.routing.failedProviders.join(', ')} failed last session`);
+    }
+    return lines.join('\n');
+}
+// ─── Handoff cleanup ──────────────────────────────────────────────────────────
+/**
+ * Remove old handoff files, keeping only the most recent `keep` entries.
+ */
+export function pruneHandoffs(cwd, keep = 10) {
+    const dir = join(cwd || process.cwd(), '.dualbrain', 'handoffs');
+    if (!existsSync(dir))
+        return 0;
+    const files = readdirSync(dir)
+        .filter(f => f.startsWith('handoff-') && f.endsWith('.json'))
+        .sort()
+        .reverse();
+    let pruned = 0;
+    for (const f of files.slice(keep)) {
+        try {
+            unlinkSync(join(dir, f));
+            pruned++;
+        }
+        catch {
+            // Skip files that can't be removed — best-effort
+        }
+    }
+    return pruned;
+}
+/**
+ * Extract routing patterns from handoff history to inform provider/model selection.
+ */
+export function extractRoutingPatterns(cwd) {
+    const dir = join(cwd || process.cwd(), '.dualbrain', 'handoffs');
+    if (!existsSync(dir))
+        return { patterns: [], confidence: 0, sampleSize: 0 };
+    const files = readdirSync(dir)
+        .filter(f => f.startsWith('handoff-') && f.endsWith('.json'))
+        .sort()
+        .reverse()
+        .slice(0, 20);
+    const handoffs = files
+        .map(f => {
+        try {
+            return JSON.parse(readFileSync(join(dir, f), 'utf8'));
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter((h) => h !== null);
+    // Count provider/model usage patterns
+    const providerCounts = {};
+    const modelCounts = {};
+    const failureCounts = {};
+    for (const h of handoffs) {
+        if (h.routing?.lastProvider) {
+            providerCounts[h.routing.lastProvider] = (providerCounts[h.routing.lastProvider] || 0) + 1;
+        }
+        if (h.routing?.lastModel) {
+            modelCounts[h.routing.lastModel] = (modelCounts[h.routing.lastModel] || 0) + 1;
+        }
+        for (const fp of (h.routing?.failedProviders || [])) {
+            failureCounts[fp] = (failureCounts[fp] || 0) + 1;
+        }
+    }
+    const patterns = [];
+    // Most used provider
+    const topProvider = Object.entries(providerCounts).sort((a, b) => b[1] - a[1])[0];
+    if (topProvider) {
+        patterns.push({ type: 'preferred_provider', value: topProvider[0], count: topProvider[1] });
+    }
+    // Most used model
+    const topModel = Object.entries(modelCounts).sort((a, b) => b[1] - a[1])[0];
+    if (topModel) {
+        patterns.push({ type: 'preferred_model', value: topModel[0], count: topModel[1] });
+    }
+    // Frequently failing provider (threshold: 3+ failures)
+    const topFailure = Object.entries(failureCounts).sort((a, b) => b[1] - a[1])[0];
+    if (topFailure && topFailure[1] >= 3) {
+        patterns.push({ type: 'unreliable_provider', value: topFailure[0], count: topFailure[1] });
+    }
+    return {
+        patterns,
+        confidence: Math.min(1, handoffs.length / 10),
+        sampleSize: handoffs.length,
+    };
+}
+//# sourceMappingURL=continuity.js.map

package/dist/src/continuity.js.map

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

package/dist/src/cost-tracker.d.ts

@@ -0,0 +1,47 @@
+interface CostAction {
+    action?: string;
+    model?: string;
+    tokensEstimated?: number;
+    tier?: string;
+    wasCacheHit?: boolean;
+    tokensSaved?: number;
+}
+interface CostEntry {
+    timestamp: string;
+    action: string;
+    model: string;
+    tokensEstimated: number;
+    costEstimated: number;
+    tier: string;
+    wasCacheHit: boolean;
+    tokensSaved: number;
+}
+interface TierBreakdown {
+    count: number;
+    tokens: number;
+    cost: number;
+}
+interface ModelBreakdown {
+    count: number;
+    tokens: number;
+    cost: number;
+}
+interface CostSummary {
+    period: string;
+    totalCost: number;
+    totalTokens: number;
+    totalActions: number;
+    cacheHits: number;
+    tokensSaved: number;
+    costSaved: number;
+    savingsRate: number;
+    byTier: Record<string, TierBreakdown>;
+    byModel: Record<string, ModelBreakdown>;
+    trend: 'stable' | 'improving' | 'degrading';
+}
+export declare function estimateTokenCost(model: string, tokens: number): number;
+export declare function trackCost(action: CostAction, cwd?: string): CostEntry | null;
+export declare function getCostSummary(cwd?: string, days?: number): CostSummary;
+export declare function formatCostReport(summary: CostSummary): string;
+export declare function getEfficiencyScore(cwd?: string): number;
+export {};

package/dist/src/cost-tracker.js

@@ -0,0 +1,170 @@
+// cost-tracker.ts — Lightweight cost estimation and efficiency tracking for .dualbrain/costs.jsonl.
+import { readFileSync, appendFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const TOKEN_COSTS = {
+    'claude-opus-4-6': 0.03,
+    'claude-sonnet-4-6': 0.006,
+    'claude-haiku-4-5-20251001': 0.001,
+    'gpt-5.5': 0.04,
+    'o3': 0.03,
+    'gpt-4o': 0.005,
+    'gpt-4o-mini': 0.0003,
+    'default': 0.01,
+};
+export function estimateTokenCost(model, tokens) {
+    const rate = TOKEN_COSTS[model] ?? TOKEN_COSTS['default'];
+    return (tokens / 1000) * rate;
+}
+export function trackCost(action, cwd = process.cwd()) {
+    try {
+        const dir = join(cwd, '.dualbrain');
+        mkdirSync(dir, { recursive: true });
+        const entry = {
+            timestamp: new Date().toISOString(),
+            action: action.action ?? 'execute',
+            model: action.model ?? 'default',
+            tokensEstimated: action.tokensEstimated ?? 0,
+            costEstimated: estimateTokenCost(action.model ?? 'default', action.tokensEstimated ?? 0),
+            tier: action.tier ?? 'standard',
+            wasCacheHit: action.wasCacheHit ?? false,
+            tokensSaved: action.tokensSaved ?? 0,
+        };
+        appendFileSync(join(dir, 'costs.jsonl'), JSON.stringify(entry) + '\n', 'utf8');
+        return entry;
+    }
+    catch {
+        return null;
+    }
+}
+function readCostLines(cwd) {
+    const p = join(cwd, '.dualbrain', 'costs.jsonl');
+    if (!existsSync(p))
+        return [];
+    try {
+        return readFileSync(p, 'utf8').trim().split('\n').filter(Boolean).flatMap(line => {
+            try {
+                return [JSON.parse(line)];
+            }
+            catch {
+                return [];
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+}
+export function getCostSummary(cwd = process.cwd(), days = 7) {
+    const cutoff = new Date(Date.now() - days * 86400000).toISOString();
+    const all = readCostLines(cwd).filter(e => e.timestamp >= cutoff);
+    if (all.length === 0) {
+        return {
+            period: `${days} days`,
+            totalCost: 0, totalTokens: 0, totalActions: 0,
+            cacheHits: 0, tokensSaved: 0, costSaved: 0, savingsRate: 0,
+            byTier: {}, byModel: {}, trend: 'stable',
+        };
+    }
+    let totalCost = 0, totalTokens = 0, cacheHits = 0, tokensSaved = 0;
+    const byTier = {};
+    const byModel = {};
+    for (const e of all) {
+        totalCost += e.costEstimated ?? 0;
+        totalTokens += e.tokensEstimated ?? 0;
+        if (e.wasCacheHit) {
+            cacheHits++;
+            tokensSaved += e.tokensSaved ?? 0;
+        }
+        const tier = e.tier ?? 'standard';
+        if (!byTier[tier])
+            byTier[tier] = { count: 0, tokens: 0, cost: 0 };
+        byTier[tier].count += 1;
+        byTier[tier].tokens += e.tokensEstimated ?? 0;
+        byTier[tier].cost += e.costEstimated ?? 0;
+        const model = e.model ?? 'default';
+        if (!byModel[model])
+            byModel[model] = { count: 0, tokens: 0, cost: 0 };
+        byModel[model].count += 1;
+        byModel[model].tokens += e.tokensEstimated ?? 0;
+        byModel[model].cost += e.costEstimated ?? 0;
+    }
+    const costSaved = estimateTokenCost('default', tokensSaved);
+    const savingsRate = (tokensSaved + totalTokens) > 0
+        ? tokensSaved / (tokensSaved + totalTokens)
+        : 0;
+    // Trend: compare first half vs second half savings rate
+    const mid = Math.floor(all.length / 2);
+    const first = all.slice(0, mid);
+    const second = all.slice(mid);
+    const halfSavings = (half) => {
+        const ts = half.reduce((s, e) => s + (e.tokensSaved ?? 0), 0);
+        const tt = half.reduce((s, e) => s + (e.tokensEstimated ?? 0), 0);
+        return (ts + tt) > 0 ? ts / (ts + tt) : 0;
+    };
+    let trend = 'stable';
+    if (all.length >= 4) {
+        const delta = halfSavings(second) - halfSavings(first);
+        if (delta > 0.05)
+            trend = 'improving';
+        else if (delta < -0.05)
+            trend = 'degrading';
+    }
+    return {
+        period: `${days} days`,
+        totalCost, totalTokens, totalActions: all.length,
+        cacheHits, tokensSaved, costSaved, savingsRate,
+        byTier, byModel, trend,
+    };
+}
+export function formatCostReport(summary) {
+    const { period, totalCost, totalTokens, totalActions, cacheHits, tokensSaved, costSaved, savingsRate, byTier, trend, } = summary;
+    const lines = [`COST EFFICIENCY (${period})`];
+    const fmtK = (n) => n >= 1000 ? `${Math.round(n / 1000)}K` : String(Math.round(n));
+    const fmtD = (n) => `~$${n.toFixed(2)}`;
+    lines.push(`  Total: ${fmtD(totalCost)} (${fmtK(totalTokens)} tokens, ${totalActions} actions)`);
+    if (cacheHits > 0) {
+        const pct = Math.round(savingsRate * 100);
+        lines.push(`  Saved: ${fmtD(costSaved)} (${fmtK(tokensSaved)} tokens from ${cacheHits} cache hits)`);
+        lines.push(`  Savings rate: ${pct}%`);
+    }
+    const tierOrder = ['recall', 'quick', 'standard', 'deep', 'ultra'];
+    const tierKeys = [...new Set([...tierOrder, ...Object.keys(byTier)])].filter(k => byTier[k]);
+    if (tierKeys.length > 0) {
+        lines.push('');
+        lines.push('  Tier breakdown:');
+        for (const tier of tierKeys) {
+            const t = byTier[tier];
+            const isRecall = tier === 'recall' && (t.cost < 0.001 || t.tokens === 0);
+            const costStr = isRecall ? '$0.00  (cache hits!)' : fmtD(t.cost);
+            lines.push(`    ${tier.padEnd(10)}${String(t.count).padStart(4)} actions  ${costStr}`);
+        }
+    }
+    const trendIcon = trend === 'improving' ? '↗' : trend === 'degrading' ? '↘' : '→';
+    lines.push('');
+    if (trend !== 'stable') {
+        lines.push(`  Trend: ${trendIcon} ${trend} (savings rate ${trend === 'improving' ? 'up' : 'down'} vs last half)`);
+    }
+    else {
+        lines.push(`  Trend: ${trendIcon} stable`);
+    }
+    return lines.join('\n');
+}
+export function getEfficiencyScore(cwd = process.cwd()) {
+    const summary = getCostSummary(cwd, 7);
+    if (summary.totalActions === 0)
+        return 50;
+    const TIER_WEIGHTS = { recall: 0, quick: 1, standard: 2, deep: 4, ultra: 6 };
+    const totalTierCost = Object.entries(summary.byTier).reduce((s, [tier, v]) => {
+        return s + (TIER_WEIGHTS[tier] ?? 2) * v.count;
+    }, 0);
+    const maxPossible = summary.totalActions * (TIER_WEIGHTS['ultra'] ?? 6);
+    const tierScore = maxPossible > 0 ? 1 - (totalTierCost / maxPossible) : 0.5;
+    const cacheScore = summary.savingsRate;
+    const trendBonus = summary.trend === 'improving' ? 10 : summary.trend === 'degrading' ? -10 : 0;
+    const raw = Math.round(tierScore * 40 +
+        cacheScore * 40 +
+        20 +
+        trendBonus);
+    return Math.max(1, Math.min(100, raw));
+}
+//# sourceMappingURL=cost-tracker.js.map

package/dist/src/cost-tracker.js.map

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

package/dist/src/debrief.d.ts

@@ -0,0 +1,53 @@
+/**
+ * debrief.ts — Agent debrief parsing, integration, and wave summarization.
+ */
+type DebriefStatus = 'success' | 'partial' | 'blocked' | 'pivoted';
+type ScopeChange = 'same' | 'larger' | 'smaller' | 'different';
+export interface DebriefArtifacts {
+    filesChanged: string[];
+    filesRead: string[];
+    testsRun: number;
+}
+export interface Debrief {
+    status: DebriefStatus;
+    findings: string[];
+    blockers: string[];
+    scopeChange: ScopeChange;
+    confidence: number;
+    recommendations: string[];
+    artifacts: DebriefArtifacts;
+    pivotReason: string | undefined;
+    unexpectedFindings: string[];
+}
+interface LedgerEntry {
+    topic: string;
+    confidence: number;
+    resolved: boolean;
+    isBlocker?: boolean;
+}
+interface SituationModel {
+    ledger?: LedgerEntry[];
+    material?: {
+        scopeTrend?: ScopeChange;
+        touchedFiles?: string[];
+    };
+    nextActions?: string[];
+    noticings?: string[];
+    confidence?: number;
+    [key: string]: unknown;
+}
+export interface WaveOutcome {
+    overallStatus: DebriefStatus | 'blocked';
+    aggregateConfidence: number;
+    allFindings: string[];
+    allBlockers: string[];
+    scopeDelta: ScopeChange;
+    nextActions: string[];
+}
+export declare function parseDebrief(rawOutput: unknown): Debrief;
+export declare function generateDebriefInstruction(tier: string, contract?: {
+    scope?: string;
+}): string;
+export declare function integrateDebrief(currentSituation: SituationModel, debrief: Debrief): SituationModel;
+export declare function summarizeWaveOutcome(debriefs: Debrief[] | null | undefined): WaveOutcome;
+export {};