dual-brain 0.2.30 → 0.3.0

package/dist/src/living-docs.d.ts

@@ -0,0 +1,14 @@
+export declare function initLivingDocs(cwd?: string): {
+    created: boolean;
+    path: string;
+};
+export declare function appendAction(action: Record<string, unknown>, cwd?: string): Record<string, unknown>;
+export declare function appendDecision(decision: Record<string, unknown>, cwd?: string): Record<string, unknown>;
+export declare function createCheckpoint(summary: string, cwd?: string): Record<string, unknown>;
+export declare function updateState(newContent: string, cwd?: string): void;
+export declare function updateRoadmap(newContent: string, cwd?: string): void;
+export declare function updateVision(newContent: string, cwd?: string): void;
+export declare function getProjectState(cwd?: string): Record<string, unknown>;
+export declare function getRecentActions(cwd?: string, limit?: number): Record<string, unknown>[];
+export declare function getOpenTasks(cwd?: string): Record<string, unknown>[];
+export declare function updateProject(updates: Record<string, unknown>, cwd?: string): Record<string, unknown>;

package/dist/src/living-docs.js

@@ -0,0 +1,197 @@
+// living-docs.mjs — Living document system for .dualbrain/.
+// Manages project.json, vision.md, roadmap.md, state.md, actions.jsonl, decisions.jsonl, checkpoints.jsonl.
+import { readFileSync, writeFileSync, appendFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+const DIR = '.dualbrain';
+function docsDir(cwd = process.cwd()) {
+    return join(cwd, DIR);
+}
+function ensureDir(cwd) {
+    mkdirSync(docsDir(cwd), { recursive: true });
+}
+function filePath(name, cwd) {
+    return join(docsDir(cwd), name);
+}
+function readFileSafe(name, cwd, fallback = '') {
+    try {
+        return readFileSync(filePath(name, cwd), 'utf8');
+    }
+    catch {
+        return fallback;
+    }
+}
+function readJsonSafe(name, cwd, fallback = {}) {
+    try {
+        return JSON.parse(readFileSync(filePath(name, cwd), 'utf8'));
+    }
+    catch {
+        return fallback;
+    }
+}
+function readPackageJson(cwd) {
+    try {
+        return JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function gitExec(cmd, cwd) {
+    try {
+        return execSync(cmd, { cwd, stdio: ['ignore', 'pipe', 'pipe'] }).toString().trim();
+    }
+    catch {
+        return null;
+    }
+}
+export function initLivingDocs(cwd = process.cwd()) {
+    const dir = docsDir(cwd);
+    const existed = existsSync(dir);
+    ensureDir(cwd);
+    const pkg = readPackageJson(cwd);
+    if (!existsSync(filePath('project.json', cwd))) {
+        const project = {
+            name: pkg.name ?? '',
+            version: pkg.version ?? '0.0.1',
+            created: new Date().toISOString(),
+            workStyle: 'balanced',
+            userCalibration: { specificity: 3, corrections: 3, autonomy: 3 },
+            team: [],
+            providers: {},
+        };
+        writeFileSync(filePath('project.json', cwd), JSON.stringify(project, null, 2));
+    }
+    if (!existsSync(filePath('vision.md', cwd))) {
+        writeFileSync(filePath('vision.md', cwd), '# Vision\n\n_Not yet defined. Type your vision and HEAD will maintain this document._\n');
+    }
+    if (!existsSync(filePath('roadmap.md', cwd))) {
+        writeFileSync(filePath('roadmap.md', cwd), '# Roadmap\n\n_No roadmap yet. As you work, HEAD will build this from your actions._\n');
+    }
+    if (!existsSync(filePath('state.md', cwd))) {
+        writeFileSync(filePath('state.md', cwd), '# Current State\n\n_Fresh project. No history yet._\n');
+    }
+    for (const log of ['actions.jsonl', 'decisions.jsonl', 'checkpoints.jsonl']) {
+        if (!existsSync(filePath(log, cwd))) {
+            writeFileSync(filePath(log, cwd), '');
+        }
+    }
+    return { created: !existed, path: dir };
+}
+export function appendAction(action, cwd = process.cwd()) {
+    ensureDir(cwd);
+    const entry = {
+        id: `act_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`,
+        timestamp: new Date().toISOString(),
+        type: 'task',
+        intent: '',
+        status: 'started',
+        owner: 'head',
+        files: [],
+        proof: null,
+        cost: null,
+        result: null,
+        ...action,
+    };
+    appendFileSync(filePath('actions.jsonl', cwd), JSON.stringify(entry) + '\n');
+    return entry;
+}
+export function appendDecision(decision, cwd = process.cwd()) {
+    ensureDir(cwd);
+    const entry = {
+        id: `dec_${Date.now()}`,
+        timestamp: new Date().toISOString(),
+        question: '',
+        decision: '',
+        reasoning: '',
+        participants: [],
+        supersedes: null,
+        ...decision,
+    };
+    appendFileSync(filePath('decisions.jsonl', cwd), JSON.stringify(entry) + '\n');
+    return entry;
+}
+export function createCheckpoint(summary, cwd = process.cwd()) {
+    ensureDir(cwd);
+    const gitRef = gitExec('git rev-parse HEAD', cwd) ?? 'unknown';
+    const branch = gitExec('git rev-parse --abbrev-ref HEAD', cwd) ?? 'unknown';
+    const stateSnapshot = readFileSafe('state.md', cwd, '');
+    const entry = {
+        id: `cp_${Date.now()}`,
+        timestamp: new Date().toISOString(),
+        gitRef,
+        branch,
+        summary,
+        stateSnapshot,
+    };
+    appendFileSync(filePath('checkpoints.jsonl', cwd), JSON.stringify(entry) + '\n');
+    return entry;
+}
+export function updateState(newContent, cwd = process.cwd()) {
+    ensureDir(cwd);
+    writeFileSync(filePath('state.md', cwd), newContent);
+}
+export function updateRoadmap(newContent, cwd = process.cwd()) {
+    ensureDir(cwd);
+    writeFileSync(filePath('roadmap.md', cwd), newContent);
+}
+export function updateVision(newContent, cwd = process.cwd()) {
+    ensureDir(cwd);
+    const prev = readFileSafe('vision.md', cwd, '');
+    writeFileSync(filePath('vision.md', cwd), newContent);
+    if (prev !== newContent) {
+        appendDecision({
+            question: 'What is the project vision?',
+            decision: newContent.slice(0, 200),
+            reasoning: 'Vision document updated.',
+            participants: ['head'],
+            supersedes: null,
+        }, cwd);
+    }
+}
+export function getProjectState(cwd = process.cwd()) {
+    const project = readJsonSafe('project.json', cwd, {});
+    const state = readFileSafe('state.md', cwd, '');
+    const actions = getRecentActions(cwd, 20);
+    const decisions = readLastLines('decisions.jsonl', cwd, 5);
+    const checkpoints = readLastLines('checkpoints.jsonl', cwd, 1);
+    return {
+        project,
+        state,
+        recentActions: actions,
+        recentDecisions: decisions,
+        lastCheckpoint: checkpoints[0] ?? null,
+    };
+}
+function readLastLines(name, cwd, n) {
+    const raw = readFileSafe(name, cwd, '');
+    const lines = raw.split('\n').filter(l => l.trim());
+    return lines.slice(-n).map(l => { try {
+        return JSON.parse(l);
+    }
+    catch {
+        return null;
+    } }).filter(Boolean);
+}
+export function getRecentActions(cwd = process.cwd(), limit = 20) {
+    return readLastLines('actions.jsonl', cwd, limit);
+}
+export function getOpenTasks(cwd = process.cwd()) {
+    const raw = readFileSafe('actions.jsonl', cwd, '');
+    const lines = raw.split('\n').filter(l => l.trim());
+    const entries = lines.map(l => { try {
+        return JSON.parse(l);
+    }
+    catch {
+        return null;
+    } }).filter(Boolean);
+    return entries.filter(e => e.status === 'started' || e.status === 'blocked');
+}
+export function updateProject(updates, cwd = process.cwd()) {
+    ensureDir(cwd);
+    const current = readJsonSafe('project.json', cwd, {});
+    const merged = { ...current, ...updates };
+    writeFileSync(filePath('project.json', cwd), JSON.stringify(merged, null, 2));
+    return merged;
+}
+//# sourceMappingURL=living-docs.js.map

package/dist/src/living-docs.js.map

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

package/dist/src/memory-tiers.d.ts

@@ -0,0 +1,37 @@
+interface MemoryItem {
+    source: string;
+    content: string;
+}
+interface MemoryContext {
+    narrative: string;
+    simmerBrief: string;
+    warmItems: MemoryItem[];
+    combined: string;
+}
+interface HotMemory {
+    narrative: string;
+    simmerBrief: string;
+    combined: string;
+}
+interface Signals {
+    userMessage?: string;
+    files?: string[];
+    intent?: string;
+}
+/**
+ * Load hot memory — always returned, every turn.
+ */
+export declare function loadHot(): HotMemory;
+/**
+ * Load warm memory — contextually relevant items paged in based on signals.
+ */
+export declare function loadWarm(signals?: Signals): MemoryItem[];
+/**
+ * Load cold memory — only when explicitly requested or when signals strongly indicate need.
+ */
+export declare function loadCold(query: string): MemoryItem[];
+/**
+ * Full context assembly — combines hot + warm based on current signals.
+ */
+export declare function assemble(signals?: Signals): MemoryContext;
+export {};

package/dist/src/memory-tiers.js

@@ -0,0 +1,160 @@
+// memory-tiers.ts — Hot/Warm/Cold memory with active paging.
+//
+// Hot: loaded every turn (narrative + active simmer). Always in HEAD's context.
+// Warm: loaded on demand (recent debriefs, narrative history, relevant past decisions).
+// Cold: past sessions, archived patterns. Only retrieved when explicitly needed.
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import * as narrative from './narrative.js';
+import * as simmer from './simmer.js';
+const STATE_DIR = join(process.cwd(), '.dualbrain');
+/**
+ * Load hot memory — always returned, every turn.
+ */
+export function loadHot() {
+    const narr = narrative.load();
+    const simmering = simmer.brief();
+    const parts = [];
+    if (narr)
+        parts.push(narr);
+    if (simmering)
+        parts.push(`[Simmering]\n${simmering}`);
+    return {
+        narrative: narr,
+        simmerBrief: simmering,
+        combined: parts.join('\n\n'),
+    };
+}
+/**
+ * Load warm memory — contextually relevant items paged in based on signals.
+ */
+export function loadWarm(signals = {}) {
+    const items = [];
+    // Recent narrative history if we're resuming or context feels thin
+    if (_looksLikeResume(signals.userMessage) || !narrative.load()) {
+        const history = narrative.recentHistory(3);
+        if (history.length > 0) {
+            items.push({
+                source: 'narrative-history',
+                content: history.map((h) => h.text).join('\n---\n'),
+            });
+        }
+    }
+    // Recent debriefs if we're continuing dispatch work
+    if (signals.intent === 'dispatch' || signals.intent === 'proceed') {
+        const debriefs = _loadRecentDebriefs(3);
+        if (debriefs.length > 0) {
+            items.push({
+                source: 'recent-debriefs',
+                content: debriefs.map((d) => `[${d.status}] ${d.objective || d.summary || ''}`).join('\n'),
+            });
+        }
+    }
+    // Routing decisions if making a new routing choice
+    if (signals.intent === 'route' || signals.intent === 'dispatch') {
+        const decisions = _loadRecentDecisions(5);
+        if (decisions.length > 0) {
+            items.push({
+                source: 'routing-history',
+                content: decisions.map((d) => `${d.provider}/${d.model}: ${d.reason || ''}`).join('\n'),
+            });
+        }
+    }
+    return items;
+}
+/**
+ * Load cold memory — only when explicitly requested or when signals strongly indicate need.
+ */
+export function loadCold(query) {
+    const items = [];
+    // Search past handoffs (from continuity.mjs)
+    const handoffs = _searchHandoffs(query);
+    if (handoffs.length > 0) {
+        items.push({
+            source: 'past-sessions',
+            content: handoffs.map((h) => `[${h.timestamp}] ${h.task || ''}: ${h.resumeHint || ''}`).join('\n'),
+        });
+    }
+    return items;
+}
+/**
+ * Full context assembly — combines hot + warm based on current signals.
+ */
+export function assemble(signals = {}) {
+    const hot = loadHot();
+    const warm = loadWarm(signals);
+    const parts = [];
+    if (hot.combined)
+        parts.push(hot.combined);
+    if (warm.length > 0) {
+        const warmText = warm.map(w => `[${w.source}]\n${w.content}`).join('\n\n');
+        parts.push(warmText);
+    }
+    return {
+        narrative: hot.narrative,
+        simmerBrief: hot.simmerBrief,
+        warmItems: warm,
+        combined: parts.join('\n\n---\n\n'),
+    };
+}
+// -- Internal helpers --
+function _looksLikeResume(msg) {
+    if (!msg)
+        return false;
+    const lower = msg.toLowerCase();
+    return /continue|where were we|pick up|resume|what's next|whats next/.test(lower);
+}
+function _loadRecentDebriefs(n) {
+    try {
+        const loopFile = join(STATE_DIR, 'cognitive-loop.json');
+        if (!existsSync(loopFile))
+            return [];
+        const loop = JSON.parse(readFileSync(loopFile, 'utf8'));
+        return (loop.debriefs || []).slice(-n);
+    }
+    catch {
+        return [];
+    }
+}
+function _loadRecentDecisions(n) {
+    try {
+        const file = join(STATE_DIR, 'decisions.jsonl');
+        if (!existsSync(file))
+            return [];
+        const lines = readFileSync(file, 'utf8').trim().split('\n').filter(Boolean);
+        return lines.slice(-n).map(l => { try {
+            return JSON.parse(l);
+        }
+        catch {
+            return null;
+        } }).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function _searchHandoffs(query) {
+    try {
+        const handoffDir = join(STATE_DIR, 'handoffs');
+        if (!existsSync(handoffDir))
+            return [];
+        const files = readdirSync(handoffDir).filter(f => f.endsWith('.json')).slice(-10);
+        const results = [];
+        const queryLower = query.toLowerCase();
+        for (const f of files) {
+            try {
+                const data = JSON.parse(readFileSync(join(handoffDir, f), 'utf8'));
+                const text = JSON.stringify(data).toLowerCase();
+                if (text.includes(queryLower)) {
+                    results.push(data);
+                }
+            }
+            catch { }
+        }
+        return results.slice(-3);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=memory-tiers.js.map

package/dist/src/memory-tiers.js.map

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

package/dist/src/model-profiles.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Static capability profiles for AI models used by the dual-brain orchestrator.
+ * Used for routing decisions, pairing assessments, and task-model matching.
+ *
+ * Version bumped when profiles are added/modified — consumers can cache-invalidate on this.
+ */
+import type { ModelProfile, Provider, LatencyTier, CostTier } from './types.ts';
+export declare const PROFILES: ModelProfile[];
+/**
+ * Look up a model profile by ID. Supports fuzzy matching:
+ * 'opus' matches 'claude-opus-4-6', 'sonnet' matches 'claude-sonnet-4-6', etc.
+ */
+export declare function getProfile(modelId: string | null | undefined): ModelProfile | null;
+interface TraitComparisonEntry {
+    [modelId: string]: number | string;
+    delta: number;
+    advantage: string;
+}
+interface CompareResult {
+    models: [string, string];
+    traits: Record<string, TraitComparisonEntry>;
+    languages: Record<string, TraitComparisonEntry>;
+    summary: Record<string, {
+        advantages: string[];
+        tier: number;
+        cost: CostTier;
+        speed: LatencyTier;
+    }>;
+}
+interface CompareError {
+    error: string;
+}
+/**
+ * Compare two models, returning relative strengths across all dimensions.
+ */
+export declare function compareModels(idA: string, idB: string): CompareResult | CompareError;
+interface FindBestOptions {
+    provider?: Provider;
+    tier?: number;
+    maxTier?: number;
+    costTier?: CostTier;
+}
+/**
+ * Find the best model for a given trait, with optional constraints.
+ */
+export declare function findBestFor(trait: string, options?: FindBestOptions): ModelProfile | null;
+interface PairingAssessment {
+    models: [string, string];
+    balance: 'complementary' | 'redundant' | 'lopsided';
+    description: string;
+    strengths: string[];
+    gaps: string[];
+}
+interface PairingError {
+    error: string;
+}
+/**
+ * Assess how well two models pair together for dual-brain work.
+ */
+export declare function getPairingAssessment(idA: string, idB: string): PairingAssessment | PairingError;
+/**
+ * Returns the current profile version for cache invalidation.
+ */
+export declare function getProfileVersion(): string;
+export default PROFILES;