dual-brain 0.2.30 → 0.3.0

package/dist/src/simmer.js

@@ -0,0 +1,224 @@
+// simmer.mjs — Ideas that aren't tasks yet. They sit, gather heat, and crystallize.
+//
+// The "song" insight: users drop ideas casually. HEAD tends to acknowledge them
+// verbally then move on. The simmer buffer catches these — every idea gets stored
+// with a heat score. Heat rises when: the idea recurs, evidence supports it,
+// adjacent work makes it more relevant, or time passes and it keeps nagging.
+// When heat crosses a threshold, the idea crystallizes into an actionable item
+// and surfaces to HEAD during deliberation.
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+const STATE_DIR = join(process.cwd(), '.dualbrain');
+const SIMMER_FILE = join(STATE_DIR, 'simmer.json');
+const CRYSTALLIZE_THRESHOLD = 5;
+const MAX_ITEMS = 30;
+const HEAT_DECAY_PER_HOUR = 0.3;
+/**
+ * @typedef {object} SimmerItem
+ * @property {string} id
+ * @property {string} idea - The raw idea in prose
+ * @property {string} origin - Where it came from (user quote, observation, debrief finding)
+ * @property {number} heat - Current heat score
+ * @property {number} createdAt
+ * @property {number} lastHeated - Last time heat was added
+ * @property {string[]} signals - Evidence trail (why heat was added)
+ * @property {boolean} crystallized - Whether it's crossed the threshold
+ * @property {string|null} crystallizedAs - What it became (task description, architecture decision, etc)
+ */
+/**
+ * Add a new idea to the simmer buffer.
+ * If a similar idea already exists (fuzzy match), heat it instead of duplicating.
+ *
+ * @param {string} idea - The idea in natural language
+ * @param {object} opts
+ * @param {string} opts.origin - Where this came from
+ * @param {number} opts.initialHeat - Starting heat (default 1)
+ * @returns {SimmerItem} The created or heated item
+ */
+export function add(idea, { origin = 'observation', initialHeat = 1 } = {}) {
+    const items = _load();
+    // Check for similar existing idea
+    const existing = _findSimilar(items, idea);
+    if (existing) {
+        return heat(existing.id, initialHeat, `Recurrence: "${idea.slice(0, 60)}"`);
+    }
+    const item = {
+        id: Date.now().toString(36) + Math.random().toString(36).slice(2, 5),
+        idea,
+        origin,
+        heat: initialHeat,
+        createdAt: Date.now(),
+        lastHeated: Date.now(),
+        signals: [`Created from: ${origin}`],
+        crystallized: false,
+        crystallizedAs: null,
+    };
+    items.push(item);
+    _save(items);
+    return item;
+}
+/**
+ * Add heat to an existing item. If it crosses the threshold, mark as crystallized.
+ *
+ * @param {string} id
+ * @param {number} amount - Heat to add (default 1)
+ * @param {string} signal - Why heat is being added
+ * @returns {SimmerItem|null}
+ */
+export function heat(id, amount = 1, signal = '') {
+    const items = _load();
+    const item = items.find(i => i.id === id);
+    if (!item)
+        return null;
+    item.heat += amount;
+    item.lastHeated = Date.now();
+    if (signal)
+        item.signals.push(signal);
+    // Cap signals array
+    if (item.signals.length > 10) {
+        item.signals = item.signals.slice(-10);
+    }
+    // Check crystallization
+    if (!item.crystallized && item.heat >= CRYSTALLIZE_THRESHOLD) {
+        item.crystallized = true;
+    }
+    _save(items);
+    return item;
+}
+/**
+ * Get all items that have crystallized but haven't been surfaced yet.
+ * These should be presented to HEAD during deliberation.
+ *
+ * @returns {SimmerItem[]}
+ */
+export function harvest() {
+    const items = _load();
+    return items.filter(i => i.crystallized && !i.crystallizedAs);
+}
+/**
+ * Mark a crystallized item as actioned — record what it became.
+ *
+ * @param {string} id
+ * @param {string} became - Description of what action was taken
+ */
+export function resolve(id, became) {
+    const items = _load();
+    const item = items.find(i => i.id === id);
+    if (!item)
+        return;
+    item.crystallizedAs = became;
+    _save(items);
+}
+/**
+ * Get all active (non-resolved) simmering items, sorted by heat descending.
+ * Used by the narrative to include "what's brewing" context.
+ *
+ * @returns {SimmerItem[]}
+ */
+export function active() {
+    const items = _load();
+    _applyDecay(items);
+    return items
+        .filter(i => !i.crystallizedAs)
+        .sort((a, b) => b.heat - a.heat);
+}
+/**
+ * Check if an idea already exists in the buffer (for deduplication).
+ * @param {string} idea
+ * @returns {SimmerItem|null}
+ */
+export function find(idea) {
+    const items = _load();
+    return _findSimilar(items, idea);
+}
+/**
+ * Generate a brief for HEAD showing what's simmering.
+ * Included in the narrative context so HEAD is aware of brewing ideas.
+ *
+ * @returns {string} Prose summary of active simmer items, or empty string
+ */
+export function brief() {
+    const items = active();
+    if (items.length === 0)
+        return '';
+    const crystallized = items.filter(i => i.crystallized);
+    const hot = items.filter(i => !i.crystallized && i.heat >= 3);
+    const warm = items.filter(i => !i.crystallized && i.heat >= 1.5 && i.heat < 3);
+    const parts = [];
+    if (crystallized.length > 0) {
+        parts.push(`Crystallized (ready to act): ${crystallized.map(i => i.idea.slice(0, 80)).join('; ')}`);
+    }
+    if (hot.length > 0) {
+        parts.push(`Hot (building momentum): ${hot.map(i => `${i.idea.slice(0, 60)} [heat:${i.heat.toFixed(1)}]`).join('; ')}`);
+    }
+    if (warm.length > 0 && parts.length < 2) {
+        parts.push(`Warm: ${warm.slice(0, 3).map(i => i.idea.slice(0, 50)).join('; ')}`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Prune resolved and cold-dead items.
+ */
+export function prune() {
+    let items = _load();
+    _applyDecay(items);
+    // Remove: resolved items older than 1h, or items with heat <= 0
+    const cutoff = Date.now() - 60 * 60 * 1000;
+    items = items.filter(i => {
+        if (i.crystallizedAs && i.lastHeated < cutoff)
+            return false;
+        if (i.heat <= 0)
+            return false;
+        return true;
+    });
+    _save(items);
+}
+// ── Internal ──────────────────────────────────────────────────────────────────
+function _load() {
+    try {
+        if (existsSync(SIMMER_FILE)) {
+            return JSON.parse(readFileSync(SIMMER_FILE, 'utf8'));
+        }
+    }
+    catch { }
+    return [];
+}
+function _save(items) {
+    // Cap total items
+    if (items.length > MAX_ITEMS) {
+        items.sort((a, b) => b.heat - a.heat);
+        items = items.slice(0, MAX_ITEMS);
+    }
+    mkdirSync(STATE_DIR, { recursive: true });
+    writeFileSync(SIMMER_FILE, JSON.stringify(items, null, 2));
+}
+function _applyDecay(items) {
+    const now = Date.now();
+    for (const item of items) {
+        if (item.crystallized)
+            continue; // Crystallized items don't decay
+        const hoursSinceHeat = (now - item.lastHeated) / (60 * 60 * 1000);
+        if (hoursSinceHeat > 1) {
+            item.heat -= HEAT_DECAY_PER_HOUR * hoursSinceHeat;
+            if (item.heat < 0)
+                item.heat = 0;
+        }
+    }
+}
+function _findSimilar(items, idea) {
+    const normalized = idea.toLowerCase().replace(/[^a-z0-9\s]/g, '');
+    const words = normalized.split(/\s+/).filter(w => w.length > 4);
+    if (words.length === 0)
+        return null;
+    for (const item of items) {
+        if (item.crystallizedAs)
+            continue; // Skip resolved
+        const itemNorm = item.idea.toLowerCase().replace(/[^a-z0-9\s]/g, '');
+        const matchCount = words.filter(w => itemNorm.includes(w)).length;
+        if (matchCount >= Math.ceil(words.length * 0.5)) {
+            return item;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=simmer.js.map

package/dist/src/simmer.js.map

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

package/dist/src/state-export.d.ts

@@ -0,0 +1,129 @@
+/**
+ * state-export.ts — JSON state export for external consumers (web panels, dashboards).
+ *
+ * Writes orchestrator state to `.dual-brain/state/` as typed JSON files.
+ * All writes are atomic (write .tmp then rename) for crash safety.
+ * All functions are non-throwing.
+ */
+export interface ExportedProviderEntry {
+    provider: string;
+    status: string;
+    lastCheck: string;
+    lastSuccess: string;
+    cooldownUntil?: string;
+    remainingCapacity: number;
+    recentDispatches: number;
+    consecutiveFailures: number;
+}
+export interface ExportedProviders {
+    exportedAt: string;
+    providers: ExportedProviderEntry[];
+}
+export interface ExportedRoutingPerformer {
+    cell: string;
+    model: string;
+    ema: number;
+    observations: number;
+}
+export interface ExportedRouting {
+    exportedAt: string;
+    totalObservations: number;
+    topPerformers: ExportedRoutingPerformer[];
+    worstPerformers: ExportedRoutingPerformer[];
+    cells: Record<string, Record<string, {
+        ema: number;
+        observations: number;
+    }>>;
+}
+export interface ExportedRoomEntry {
+    id: string;
+    status: string;
+    taskDescription: string;
+    created: string;
+    workerCount: number;
+    workerStatuses: Record<string, string>;
+}
+export interface ExportedRooms {
+    exportedAt: string;
+    rooms: ExportedRoomEntry[];
+}
+export interface ExportedDecisionEntry {
+    timestamp: string;
+    promptSummary: string;
+    model: string;
+    provider: string;
+    tier: string;
+    reason: string;
+}
+export interface ExportedDecisions {
+    exportedAt: string;
+    decisions: ExportedDecisionEntry[];
+}
+export interface ExportedCosts {
+    exportedAt: string;
+    period: string;
+    totalCost: number;
+    totalTokens: number;
+    totalActions: number;
+    cacheHits: number;
+    tokensSaved: number;
+    costSaved: number;
+    savingsRate: number;
+    byTier: Record<string, {
+        count: number;
+        tokens: number;
+        cost: number;
+    }>;
+    byModel: Record<string, {
+        count: number;
+        tokens: number;
+        cost: number;
+    }>;
+    trend: string;
+}
+export interface ExportedOutcomeEntry {
+    timestamp: string;
+    roomId: string;
+    outcome: Record<string, unknown>;
+}
+export interface ExportedOutcomes {
+    exportedAt: string;
+    outcomes: ExportedOutcomeEntry[];
+}
+export interface ExportedState {
+    exportedAt: string;
+    providers: ExportedProviders;
+    routing: ExportedRouting;
+    rooms: ExportedRooms;
+    decisions: ExportedDecisions;
+    costs: ExportedCosts;
+    outcomes: ExportedOutcomes;
+}
+/**
+ * Export full orchestrator state to `.dual-brain/state/`.
+ * Writes providers.json, routing.json, rooms.json, decisions.json, costs.json.
+ * Non-throwing: returns true on success, false on failure.
+ */
+export declare function exportState(cwd?: string): boolean;
+/**
+ * Append a routing decision to decisions.json (ring buffer, max 50 entries).
+ * Non-throwing.
+ */
+export declare function exportDecision(decision: {
+    provider?: string;
+    model?: string;
+    tier?: string;
+    explanation?: string;
+    [key: string]: unknown;
+}, prompt: string, cwd?: string): void;
+/**
+ * Append an outcome to outcomes.json log.
+ * Non-throwing.
+ */
+export declare function exportOutcome(roomId: string, outcome: Record<string, unknown>, cwd?: string): void;
+/**
+ * Read all exported state files and return a combined object.
+ * Suitable for HTTP API or MCP tool responses.
+ * Non-throwing: returns partial data if some files are missing/corrupt.
+ */
+export declare function getExportedState(cwd?: string): ExportedState;

package/dist/src/state-export.js

@@ -0,0 +1,233 @@
+/**
+ * state-export.ts — JSON state export for external consumers (web panels, dashboards).
+ *
+ * Writes orchestrator state to `.dual-brain/state/` as typed JSON files.
+ * All writes are atomic (write .tmp then rename) for crash safety.
+ * All functions are non-throwing.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { getAllProviderStates } from './provider-manager.js';
+import { getRoutingStats } from './routing-advisor.js';
+import { listRooms, getWorkerStatuses } from './room.js';
+import { getCostSummary } from './cost-tracker.js';
+// ─── Constants ────────────────────────────────────────────────────────────
+const STATE_DIR = '.dual-brain/state';
+const MAX_DECISIONS = 50;
+const MAX_OUTCOMES = 200;
+// ─── Helpers ──────────────────────────────────────────────────────────────
+function stateDir(cwd) {
+    return join(cwd || process.cwd(), STATE_DIR);
+}
+function stateFile(name, cwd) {
+    return join(stateDir(cwd), name);
+}
+/**
+ * Atomic write: write to .tmp then rename for crash safety.
+ */
+function atomicWrite(filePath, data) {
+    const dir = dirname(filePath);
+    mkdirSync(dir, { recursive: true });
+    const tmp = `${filePath}.tmp.${process.pid}.${Date.now()}`;
+    const json = JSON.stringify(data, null, 2) + '\n';
+    writeFileSync(tmp, json, 'utf8');
+    renameSync(tmp, filePath);
+}
+/**
+ * Safely read and parse a JSON file. Returns null on any error.
+ */
+function readJson(filePath) {
+    try {
+        if (!existsSync(filePath))
+            return null;
+        const raw = readFileSync(filePath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Truncate a prompt to a short summary for the decisions log.
+ */
+function summarizePrompt(prompt) {
+    const cleaned = prompt.replace(/\s+/g, ' ').trim();
+    if (cleaned.length <= 120)
+        return cleaned;
+    return cleaned.slice(0, 117) + '...';
+}
+// ─── Public API ───────────────────────────────────────────────────────────
+/**
+ * Export full orchestrator state to `.dual-brain/state/`.
+ * Writes providers.json, routing.json, rooms.json, decisions.json, costs.json.
+ * Non-throwing: returns true on success, false on failure.
+ */
+export function exportState(cwd) {
+    try {
+        const now = new Date().toISOString();
+        const resolvedCwd = cwd || process.cwd();
+        // ── providers.json
+        const providerStates = getAllProviderStates(resolvedCwd);
+        const providers = {
+            exportedAt: now,
+            providers: providerStates.map((ps) => ({
+                provider: ps.provider,
+                status: ps.status,
+                lastCheck: ps.lastCheck,
+                lastSuccess: ps.lastSuccess,
+                cooldownUntil: ps.cooldownUntil,
+                remainingCapacity: ps.remainingCapacity,
+                recentDispatches: ps.recentDispatches,
+                consecutiveFailures: ps.consecutiveFailures,
+            })),
+        };
+        atomicWrite(stateFile('providers.json', resolvedCwd), providers);
+        // ── routing.json
+        const stats = getRoutingStats(resolvedCwd);
+        const routing = {
+            exportedAt: now,
+            totalObservations: stats.totalObservations,
+            topPerformers: stats.topPerformers,
+            worstPerformers: stats.worstPerformers,
+            cells: stats.cells,
+        };
+        atomicWrite(stateFile('routing.json', resolvedCwd), routing);
+        // ── rooms.json
+        const roomSummaries = listRooms(resolvedCwd);
+        const roomEntries = roomSummaries.map((rs) => ({
+            id: rs.id,
+            status: rs.status,
+            taskDescription: rs.taskDescription,
+            created: rs.created,
+            workerCount: rs.workerCount,
+            workerStatuses: getWorkerStatuses(rs.id, resolvedCwd),
+        }));
+        const rooms = {
+            exportedAt: now,
+            rooms: roomEntries,
+        };
+        atomicWrite(stateFile('rooms.json', resolvedCwd), rooms);
+        // ── decisions.json — preserve existing, just update exportedAt
+        const existingDecisions = readJson(stateFile('decisions.json', resolvedCwd));
+        const decisions = {
+            exportedAt: now,
+            decisions: existingDecisions?.decisions ?? [],
+        };
+        atomicWrite(stateFile('decisions.json', resolvedCwd), decisions);
+        // ── costs.json
+        const costSummary = getCostSummary(resolvedCwd, 7);
+        const costs = {
+            exportedAt: now,
+            period: costSummary.period,
+            totalCost: costSummary.totalCost,
+            totalTokens: costSummary.totalTokens,
+            totalActions: costSummary.totalActions,
+            cacheHits: costSummary.cacheHits,
+            tokensSaved: costSummary.tokensSaved,
+            costSaved: costSummary.costSaved,
+            savingsRate: costSummary.savingsRate,
+            byTier: costSummary.byTier,
+            byModel: costSummary.byModel,
+            trend: costSummary.trend,
+        };
+        atomicWrite(stateFile('costs.json', resolvedCwd), costs);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Append a routing decision to decisions.json (ring buffer, max 50 entries).
+ * Non-throwing.
+ */
+export function exportDecision(decision, prompt, cwd) {
+    try {
+        const resolvedCwd = cwd || process.cwd();
+        const filePath = stateFile('decisions.json', resolvedCwd);
+        const existing = readJson(filePath);
+        const entries = existing?.decisions ?? [];
+        const entry = {
+            timestamp: new Date().toISOString(),
+            promptSummary: summarizePrompt(prompt),
+            model: decision.model ?? 'unknown',
+            provider: decision.provider ?? 'unknown',
+            tier: decision.tier ?? 'unknown',
+            reason: decision.explanation ?? '',
+        };
+        entries.push(entry);
+        // Ring buffer: keep only the last MAX_DECISIONS entries
+        const trimmed = entries.length > MAX_DECISIONS
+            ? entries.slice(entries.length - MAX_DECISIONS)
+            : entries;
+        const output = {
+            exportedAt: new Date().toISOString(),
+            decisions: trimmed,
+        };
+        atomicWrite(filePath, output);
+    }
+    catch {
+        // non-throwing
+    }
+}
+/**
+ * Append an outcome to outcomes.json log.
+ * Non-throwing.
+ */
+export function exportOutcome(roomId, outcome, cwd) {
+    try {
+        const resolvedCwd = cwd || process.cwd();
+        const filePath = stateFile('outcomes.json', resolvedCwd);
+        const existing = readJson(filePath);
+        const entries = existing?.outcomes ?? [];
+        const entry = {
+            timestamp: new Date().toISOString(),
+            roomId,
+            outcome,
+        };
+        entries.push(entry);
+        // Keep bounded (MAX_OUTCOMES)
+        const trimmed = entries.length > MAX_OUTCOMES
+            ? entries.slice(entries.length - MAX_OUTCOMES)
+            : entries;
+        const output = {
+            exportedAt: new Date().toISOString(),
+            outcomes: trimmed,
+        };
+        atomicWrite(filePath, output);
+    }
+    catch {
+        // non-throwing
+    }
+}
+/**
+ * Read all exported state files and return a combined object.
+ * Suitable for HTTP API or MCP tool responses.
+ * Non-throwing: returns partial data if some files are missing/corrupt.
+ */
+export function getExportedState(cwd) {
+    const resolvedCwd = cwd || process.cwd();
+    const now = new Date().toISOString();
+    const providers = readJson(stateFile('providers.json', resolvedCwd))
+        ?? { exportedAt: now, providers: [] };
+    const routing = readJson(stateFile('routing.json', resolvedCwd))
+        ?? { exportedAt: now, totalObservations: 0, topPerformers: [], worstPerformers: [], cells: {} };
+    const rooms = readJson(stateFile('rooms.json', resolvedCwd))
+        ?? { exportedAt: now, rooms: [] };
+    const decisions = readJson(stateFile('decisions.json', resolvedCwd))
+        ?? { exportedAt: now, decisions: [] };
+    const costs = readJson(stateFile('costs.json', resolvedCwd))
+        ?? { exportedAt: now, period: '7 days', totalCost: 0, totalTokens: 0, totalActions: 0, cacheHits: 0, tokensSaved: 0, costSaved: 0, savingsRate: 0, byTier: {}, byModel: {}, trend: 'stable' };
+    const outcomes = readJson(stateFile('outcomes.json', resolvedCwd))
+        ?? { exportedAt: now, outcomes: [] };
+    return {
+        exportedAt: now,
+        providers,
+        routing,
+        rooms,
+        decisions,
+        costs,
+        outcomes,
+    };
+}
+//# sourceMappingURL=state-export.js.map

package/dist/src/state-export.js.map

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

package/dist/src/strategy.d.ts

@@ -0,0 +1,54 @@
+interface StrategyApplicability {
+    maxFiles?: number;
+    maxComplexity?: string;
+    maxRisk?: string;
+    minFiles?: number;
+    minComplexity?: string;
+    minRisk?: string;
+}
+interface StrategyDef {
+    id: string;
+    label: string;
+    description: string;
+    applicability: StrategyApplicability;
+    cost: number;
+}
+export declare const STRATEGIES: Record<string, StrategyDef>;
+interface Detection {
+    fileCount?: number;
+    files?: number;
+    complexity?: string;
+    risk?: string;
+    prompt?: string;
+    description?: string;
+}
+interface StrategyResult {
+    strategy: string;
+    reason: string;
+    alternatives: string[];
+}
+export declare function selectStrategy(detection: Detection, decision: {
+    model?: string;
+}, profile: {
+    workStyle?: string;
+    bias?: string;
+}): StrategyResult;
+export declare function describeStrategy(strategyId: string): string;
+interface PlanStep {
+    role: string;
+    model: string;
+    description: string;
+}
+interface StrategyWithPlan extends StrategyResult {
+    plan: {
+        steps: PlanStep[];
+    };
+}
+export declare function getStrategyForTask(detection: Detection, cwd?: string): StrategyWithPlan;
+export declare function listStrategies(): {
+    id: string;
+    label: string;
+    description: string;
+    cost: number;
+}[];
+export {};