dual-brain 0.2.29 → 0.3.0

package/dist/src/setup-flow.d.ts

@@ -0,0 +1,63 @@
+interface DetectedEnvironment {
+    claude: boolean;
+    codex: boolean;
+    git: boolean;
+    gitBranch: string | null;
+    language: string;
+    existingConfig: boolean;
+}
+interface SetupAnswers {
+    subscription?: string;
+    workStyle?: string;
+    advanced?: AdvancedOptions;
+    setupMode?: string;
+}
+interface AdvancedOptions {
+    thinkEnabled?: boolean;
+    cascadeEnabled?: boolean;
+    learningEnabled?: boolean;
+    explorationRate?: number;
+    sessionLimitTokens?: number | null;
+    warnAtPercent?: number;
+    models?: Record<string, string>;
+}
+interface SetupConfig {
+    version: number;
+    subscription: string;
+    workStyle: string;
+    providers: {
+        claude: boolean;
+        openai: boolean;
+    };
+    routing: {
+        thinkEnabled: boolean;
+        cascadeEnabled: boolean;
+        learningEnabled: boolean;
+        explorationRate: number;
+    };
+    models: Record<string, string>;
+    budget: {
+        sessionLimitTokens: number | null;
+        warnAtPercent: number;
+    };
+    configuredAt: string;
+    setupMode: string;
+    detectedEnv: {
+        claude: boolean;
+        codex: boolean;
+        language: string;
+    };
+}
+interface SetupOptions {
+    nonInteractive?: boolean;
+    reconfigure?: boolean;
+    subscription?: string;
+    workStyle?: string;
+}
+export declare function detectEnvironment(cwd: string): DetectedEnvironment;
+export declare function renderWelcome(detected: DetectedEnvironment): string;
+export declare function renderConfirmation(config: SetupConfig): string;
+export declare function buildConfig(answers: SetupAnswers, detected: DetectedEnvironment): SetupConfig;
+export declare function saveConfig(config: SetupConfig, cwd: string): void;
+export declare function runSetup(cwd: string, options?: SetupOptions): Promise<SetupConfig | null>;
+export {};

package/dist/src/setup-flow.js

@@ -0,0 +1,233 @@
+// setup-flow.ts — Interactive first-run setup for dual-brain
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { execSync } from 'node:child_process';
+// ── ANSI helpers ──────────────────────────────────────────────────────────────
+const c = {
+    bold: (s) => `\x1b[1m${s}\x1b[0m`,
+    dim: (s) => `\x1b[2m${s}\x1b[0m`,
+    green: (s) => `\x1b[32m${s}\x1b[0m`,
+    yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+    cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+    red: (s) => `\x1b[31m${s}\x1b[0m`,
+};
+// ── Detection ─────────────────────────────────────────────────────────────────
+export function detectEnvironment(cwd) {
+    const tryCmd = (cmd) => { try {
+        execSync(cmd, { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    } };
+    let language = 'unknown';
+    if (existsSync(join(cwd, 'package.json')))
+        language = 'node';
+    else if (existsSync(join(cwd, 'pyproject.toml')) ||
+        existsSync(join(cwd, 'setup.py')))
+        language = 'python';
+    else if (existsSync(join(cwd, 'go.mod')))
+        language = 'go';
+    else if (existsSync(join(cwd, 'Cargo.toml')))
+        language = 'rust';
+    else if (existsSync(join(cwd, 'pom.xml')))
+        language = 'java';
+    let gitBranch = null;
+    try {
+        gitBranch = execSync('git -C "' + cwd + '" branch --show-current', { stdio: 'pipe' }).toString().trim();
+    }
+    catch { }
+    return {
+        claude: tryCmd('claude --version'),
+        codex: tryCmd('codex --version'),
+        git: !!gitBranch,
+        gitBranch: gitBranch || null,
+        language,
+        existingConfig: existsSync(join(cwd, '.dualbrain', 'config.json')),
+    };
+}
+// ── Welcome banner ────────────────────────────────────────────────────────────
+export function renderWelcome(detected) {
+    const row = (ok, label) => c.cyan('│') + `   ${ok ? c.green('✓') : c.dim('✗')} ${ok ? label : c.dim(label)}`.padEnd(49) + c.cyan('│');
+    const bar = (s) => c.cyan('│') + s.padEnd(49) + c.cyan('│');
+    return [
+        c.cyan('╭' + '─'.repeat(49) + '╮'),
+        bar(''),
+        bar(`   ${c.bold('dual-brain')} — intelligent model orchestration`),
+        bar(''),
+        bar('   Detected:'),
+        row(detected.claude, 'Claude CLI available'),
+        row(detected.codex, 'Codex CLI available'),
+        row(detected.git, `Git repository (${detected.gitBranch || 'no branch'} branch)`),
+        row(detected.language !== 'unknown', `${detected.language} project`),
+        bar(''),
+        c.cyan('╰' + '─'.repeat(49) + '╯'),
+    ].join('\n');
+}
+const SUB_LABELS = {
+    'claude-pro': 'Claude Pro', 'claude-max-5x': 'Claude Max 5x',
+    'claude-max-20x': 'Claude Max 20x', 'chatgpt-plus': 'ChatGPT Plus',
+    'chatgpt-pro': 'ChatGPT Pro', 'dual-pro': 'Both Pro tiers', 'dual-max': 'Max + Pro tiers',
+};
+// ── Confirmation display ──────────────────────────────────────────────────────
+export function renderConfirmation(config) {
+    const row = (k, v) => `  ${c.dim(k.padEnd(16))} ${c.cyan(v)}`;
+    return [
+        '', c.bold('  Configuration:'), '',
+        row('Subscription:', SUB_LABELS[config.subscription] || config.subscription),
+        row('Work style:', config.workStyle),
+        row('Primary model:', config.models.execute),
+        row('Think agent:', config.routing.thinkEnabled ? 'enabled' : 'disabled'),
+        row('Learning:', config.routing.learningEnabled ? 'on' : 'off'),
+        '',
+    ].join('\n');
+}
+// ── Config builder ────────────────────────────────────────────────────────────
+export function buildConfig(answers, detected) {
+    const { subscription = 'claude-pro', workStyle = 'balanced', advanced = {}, setupMode = 'quick' } = answers;
+    const dual = subscription.startsWith('dual-');
+    const isMax = subscription.includes('max') || subscription === 'chatgpt-pro';
+    const topModel = isMax ? 'opus' : 'sonnet';
+    const exploreRate = { aggressive: 0.3, conservative: 0.1, auto: 0.25 }[workStyle] ?? 0.2;
+    return {
+        version: 1, subscription, workStyle,
+        providers: { claude: subscription.startsWith('claude-') || dual, openai: subscription.startsWith('chatgpt-') || dual },
+        routing: {
+            thinkEnabled: advanced.thinkEnabled ?? true,
+            cascadeEnabled: advanced.cascadeEnabled ?? true,
+            learningEnabled: advanced.learningEnabled ?? true,
+            explorationRate: advanced.explorationRate ?? exploreRate,
+        },
+        models: advanced.models || { search: 'haiku', execute: 'sonnet', think: topModel, review: topModel },
+        budget: { sessionLimitTokens: advanced.sessionLimitTokens ?? null, warnAtPercent: advanced.warnAtPercent ?? 80 },
+        configuredAt: new Date().toISOString(),
+        setupMode,
+        detectedEnv: { claude: detected.claude, codex: detected.codex, language: detected.language },
+    };
+}
+// ── Save config ───────────────────────────────────────────────────────────────
+export function saveConfig(config, cwd) {
+    const dir = join(cwd, '.dualbrain');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, 'config.json'), JSON.stringify(config, null, 2), 'utf8');
+    const orchPath = join(cwd, '.claude', 'orchestrator.json');
+    if (existsSync(orchPath)) {
+        try {
+            const orch = JSON.parse(readFileSync(orchPath, 'utf8'));
+            if (!orch.providers)
+                orch.providers = {};
+            orch.providers.claude = { ...(orch.providers.claude || {}), enabled: config.providers.claude, subscription: config.subscription };
+            orch.providers.openai = { ...(orch.providers.openai || {}), enabled: config.providers.openai };
+            if (config.routing)
+                orch.routing = { ...(orch.routing || {}), ...config.routing };
+            writeFileSync(orchPath, JSON.stringify(orch, null, 2), 'utf8');
+        }
+        catch { /* non-fatal */ }
+    }
+}
+// ── Readline prompt helper ────────────────────────────────────────────────────
+async function ask(rl, question, options) {
+    const lines = options.map((o, i) => `  ${c.cyan(String(i + 1) + ')')} ${o.label}${o.description ? c.dim(' — ' + o.description) : ''}`);
+    const prompt = `\n${c.bold(question)}\n${lines.join('\n')}\n${c.dim('> ')}`;
+    return new Promise(resolve => {
+        rl.question(prompt, answer => {
+            const trimmed = answer.trim();
+            const idx = parseInt(trimmed, 10) - 1;
+            if (idx >= 0 && idx < options.length)
+                resolve(options[idx].value);
+            else
+                resolve(options[0].value);
+        });
+    });
+}
+async function askYN(rl, question, defaultYes = true) {
+    return new Promise(resolve => {
+        rl.question(`\n${c.bold(question)} ${c.dim(defaultYes ? '(Y/n)' : '(y/N)')} `, answer => {
+            const t = answer.trim().toLowerCase();
+            if (!t)
+                resolve(defaultYes);
+            else
+                resolve(t === 'y' || t === 'yes');
+        });
+    });
+}
+// ── Main entry point ──────────────────────────────────────────────────────────
+export async function runSetup(cwd, options = {}) {
+    const detected = detectEnvironment(cwd);
+    // Non-TTY fast path — stdin is piped or in CI
+    if (!process.stdin.isTTY && !options.nonInteractive) {
+        process.stderr.write('[dual-brain] Non-interactive terminal detected. Use --non-interactive flag or run in a TTY.\n');
+        const config = buildConfig({ subscription: 'claude-pro', workStyle: 'balanced' }, detected);
+        saveConfig(config, cwd);
+        return config;
+    }
+    // Non-interactive fast path
+    if (options.nonInteractive) {
+        const config = buildConfig({
+            subscription: options.subscription || 'claude-pro',
+            workStyle: options.workStyle || 'balanced',
+            setupMode: 'non-interactive',
+        }, detected);
+        saveConfig(config, cwd);
+        return config;
+    }
+    // Already configured?
+    if (detected.existingConfig && !options.reconfigure) {
+        console.log('\n' + c.yellow('dual-brain is already configured.') + ' Pass --reconfigure to change settings.\n');
+        return JSON.parse(readFileSync(join(cwd, '.dualbrain', 'config.json'), 'utf8'));
+    }
+    console.log('\n' + renderWelcome(detected) + '\n');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const close = () => rl.close();
+    try {
+        const mode = await ask(rl, 'Setup mode:', [
+            { label: 'Quick setup', value: 'quick', description: '3 questions, ~20 seconds' },
+            { label: 'Advanced', value: 'advanced', description: 'full control over routing, budgets, models' },
+        ]);
+        const subscription = await ask(rl, 'Your AI subscription:', [
+            { label: 'Claude Pro ($20/mo)', value: 'claude-pro' },
+            { label: 'Claude Max 5x ($100/mo)', value: 'claude-max-5x' },
+            { label: 'Claude Max 20x ($200/mo)', value: 'claude-max-20x' },
+            { label: 'ChatGPT Plus ($20/mo)', value: 'chatgpt-plus' },
+            { label: 'ChatGPT Pro ($200/mo)', value: 'chatgpt-pro' },
+            { label: 'Both providers (Pro tiers)', value: 'dual-pro' },
+            { label: 'Both providers (Max tiers)', value: 'dual-max' },
+        ]);
+        const workStyle = await ask(rl, 'How should dual-brain route your work?', [
+            { label: 'Balanced', value: 'balanced', description: 'smart defaults, asks before expensive ops' },
+            { label: 'Conservative', value: 'conservative', description: 'minimize tokens, prefer cheaper models' },
+            { label: 'Aggressive', value: 'aggressive', description: 'best model available, maximize quality' },
+            { label: 'Full auto', value: 'auto', description: 'never ask, optimize silently' },
+        ]);
+        let advanced = {};
+        if (mode === 'advanced') {
+            const thinkEnabled = await askYN(rl, 'Enable think agent?', true);
+            const cascadeEnabled = await askYN(rl, 'Enable cascade routing?', true);
+            const learningEnabled = await askYN(rl, 'Enable learning (improves routing over time)?', true);
+            const explorationRate = await ask(rl, 'Routing exploration rate:', [
+                { label: 'Low (0.1)', value: 0.1, description: 'rarely tries new routes' },
+                { label: 'Medium (0.2)', value: 0.2, description: 'balanced' },
+                { label: 'High (0.3)', value: 0.3, description: 'frequently explores alternatives' },
+            ]);
+            advanced = { thinkEnabled, cascadeEnabled, learningEnabled, explorationRate };
+        }
+        const config = buildConfig({ subscription, workStyle, advanced, setupMode: mode }, detected);
+        console.log(renderConfirmation(config));
+        if (!await askYN(rl, 'Save and start?', true)) {
+            console.log('\n' + c.yellow('Setup cancelled.') + '\n');
+            close();
+            return null;
+        }
+        saveConfig(config, cwd);
+        console.log('\n' + c.green('✓') + ' ' + c.bold('dual-brain configured.') + ' Config saved to ' + c.cyan('.dualbrain/config.json') + '\n');
+        close();
+        return config;
+    }
+    catch (err) {
+        close();
+        throw err;
+    }
+}
+//# sourceMappingURL=setup-flow.js.map

package/dist/src/setup-flow.js.map

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

package/dist/src/signal.d.ts

@@ -0,0 +1,19 @@
+import type { Tier, TaskOutcome } from './types.ts';
+export declare const EXPECTED_DURATION_MS: Record<Tier, number>;
+export declare function scoreDurationRatio(durationMs: number, tier: Tier): number | null;
+export declare function measureFileSurvival(outcome: TaskOutcome, cwd: string): number | null;
+interface ScoreOutcomeContext {
+    fileSurvival?: number | null;
+}
+interface OutcomeScoreResult {
+    reward: number;
+    confidence: number;
+    signals: {
+        exitSuccess: number | boolean;
+        durationRatio: number | null;
+        tokenEfficiency: number | null;
+        fileSurvival: number | null;
+    };
+}
+export declare function scoreOutcome(outcome: TaskOutcome, context?: ScoreOutcomeContext): OutcomeScoreResult;
+export {};

package/dist/src/signal.js

@@ -0,0 +1,122 @@
+// signal.ts — Compound outcome signal scoring
+// Combines multiple weak signals into one reliable reward score.
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+export const EXPECTED_DURATION_MS = {
+    search: 15000,
+    execute: 45000,
+    think: 30000,
+    review: 40000,
+};
+export function scoreDurationRatio(durationMs, tier) {
+    try {
+        if (durationMs <= 0)
+            return null;
+        const expectedMs = EXPECTED_DURATION_MS[tier] || EXPECTED_DURATION_MS.execute;
+        const ratio = durationMs / expectedMs;
+        if (ratio >= 0.5 && ratio <= 1.5)
+            return 1.0;
+        if (ratio < 0.2)
+            return 0.5;
+        if (ratio > 3.0)
+            return 0.3;
+        if (ratio < 0.5)
+            return 0.5 + ((ratio - 0.2) / (0.5 - 0.2)) * 0.5;
+        // ratio 1.5–3.0
+        return 1.0 - ((ratio - 1.5) / (3.0 - 1.5)) * 0.7;
+    }
+    catch {
+        return null;
+    }
+}
+export function measureFileSurvival(outcome, cwd) {
+    try {
+        const files = Array.isArray(outcome.filesChanged)
+            ? outcome.filesChanged
+            : [];
+        if (files.length === 0)
+            return 1.0;
+        let changed;
+        try {
+            changed = new Set(execSync('git diff --name-only', { cwd, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+                .split('\n')
+                .map(f => f.trim())
+                .filter(Boolean));
+        }
+        catch {
+            changed = new Set();
+        }
+        const survived = files.filter(f => {
+            const abs = join(cwd, f);
+            return existsSync(abs) && !changed.has(f);
+        });
+        return survived.length / files.length;
+    }
+    catch {
+        return null;
+    }
+}
+export function scoreOutcome(outcome, context = {}) {
+    try {
+        const tier = (outcome.tier ?? 'execute');
+        const signals = [];
+        // Signal 1: exit success (weight 0.3)
+        let exitVal;
+        if (outcome.success === true)
+            exitVal = 1.0;
+        else if (outcome.status === 'partial')
+            exitVal = 0.4;
+        else
+            exitVal = 0.0;
+        signals.push({ name: 'exitSuccess', value: exitVal, weight: 0.3 });
+        // Signal 2: duration ratio (weight 0.25)
+        const durationMs = outcome.durationMs ?? 0;
+        const durVal = durationMs > 0 ? scoreDurationRatio(durationMs, tier) : null;
+        signals.push({ name: 'durationRatio', value: durVal, weight: 0.25 });
+        // Signal 3: token efficiency (weight 0.25)
+        let effVal = null;
+        const filesChanged = outcome.filesChanged ?? 0;
+        const fileCount = Array.isArray(filesChanged) ? filesChanged.length : (typeof filesChanged === 'number' ? filesChanged : 0);
+        if (!(fileCount === 0 && tier === 'think')) {
+            const tokensUsed = outcome.tokensUsed?.output ??
+                (durationMs > 0 ? Math.round(durationMs / 100) : null);
+            if (tokensUsed !== null && tokensUsed !== undefined) {
+                const efficiency = fileCount / Math.max(1, tokensUsed / 1000);
+                if (efficiency > 2)
+                    effVal = 1.0;
+                else if (efficiency >= 0.5)
+                    effVal = 0.5 + ((efficiency - 0.5) / 1.5) * 0.5;
+                else if (efficiency < 0.1)
+                    effVal = 0.2;
+                else
+                    effVal = 0.2 + ((efficiency - 0.1) / 0.4) * 0.3;
+            }
+        }
+        signals.push({ name: 'tokenEfficiency', value: effVal, weight: 0.25 });
+        // Signal 4: file survival (weight 0.2) — delayed, may be null
+        const survivalVal = context.fileSurvival ?? null;
+        signals.push({ name: 'fileSurvival', value: survivalVal, weight: 0.2 });
+        // Compound score with weight redistribution
+        const active = signals.filter(s => s.value !== null);
+        const totalWeight = active.reduce((sum, s) => sum + s.weight, 0);
+        const reward = totalWeight > 0
+            ? active.reduce((sum, s) => sum + (s.value * s.weight / totalWeight), 0)
+            : 0;
+        const confidence = totalWeight;
+        return {
+            reward: Math.min(1, Math.max(0, reward)),
+            confidence: Math.min(1, confidence),
+            signals: {
+                exitSuccess: exitVal,
+                durationRatio: durVal,
+                tokenEfficiency: effVal,
+                fileSurvival: survivalVal,
+            },
+        };
+    }
+    catch {
+        return { reward: 0, confidence: 0, signals: { exitSuccess: false, durationRatio: null, tokenEfficiency: null, fileSurvival: null } };
+    }
+}
+//# sourceMappingURL=signal.js.map

package/dist/src/signal.js.map

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

package/dist/src/simmer.d.ts

@@ -0,0 +1,85 @@
+interface SimmerItem {
+    id: string;
+    idea: string;
+    origin: string;
+    heat: number;
+    createdAt: number;
+    lastHeated: number;
+    signals: string[];
+    crystallized: boolean;
+    crystallizedAs: string | null;
+}
+/**
+ * @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 declare function add(idea: string, { origin, initialHeat }?: {
+    origin?: string;
+    initialHeat?: number;
+}): SimmerItem;
+/**
+ * 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 declare function heat(id: string, amount?: number, signal?: string): SimmerItem | null;
+/**
+ * Get all items that have crystallized but haven't been surfaced yet.
+ * These should be presented to HEAD during deliberation.
+ *
+ * @returns {SimmerItem[]}
+ */
+export declare function harvest(): SimmerItem[];
+/**
+ * Mark a crystallized item as actioned — record what it became.
+ *
+ * @param {string} id
+ * @param {string} became - Description of what action was taken
+ */
+export declare function resolve(id: string, became: string): void;
+/**
+ * Get all active (non-resolved) simmering items, sorted by heat descending.
+ * Used by the narrative to include "what's brewing" context.
+ *
+ * @returns {SimmerItem[]}
+ */
+export declare function active(): SimmerItem[];
+/**
+ * Check if an idea already exists in the buffer (for deduplication).
+ * @param {string} idea
+ * @returns {SimmerItem|null}
+ */
+export declare function find(idea: string): SimmerItem | null;
+/**
+ * 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 declare function brief(): string;
+/**
+ * Prune resolved and cold-dead items.
+ */
+export declare function prune(): void;
+export {};