dual-brain 0.2.30 → 0.3.1

package/dist/src/debrief.js

@@ -0,0 +1,222 @@
+/**
+ * debrief.ts — Agent debrief parsing, integration, and wave summarization.
+ */
+// ─── Constants ───────────────────────────────────────────────────────────────
+const STATUSES = ['success', 'partial', 'blocked', 'pivoted'];
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function emptyDebrief() {
+    return {
+        status: 'partial',
+        findings: [],
+        blockers: [],
+        scopeChange: 'same',
+        confidence: 0.5,
+        recommendations: [],
+        artifacts: { filesChanged: [], filesRead: [], testsRun: 0 },
+        pivotReason: undefined,
+        unexpectedFindings: [],
+    };
+}
+// ─── Parse debrief from raw agent output ─────────────────────────────────────
+const FILE_PATH_RE = /(?:^|\s)([\w./-]+\.(?:mjs|js|ts|tsx|json|md|py|sh|yaml|yml|css|html))/gm;
+const TEST_COUNT_RE = /(\d+)\s*(?:tests?|specs?|assertions?)\s*(?:passed|ran|run|succeeded|ok)/i;
+function extractByPatterns(text, patterns, minLen, maxLen, limit) {
+    const results = [];
+    for (const re of patterns) {
+        for (const m of text.matchAll(re)) {
+            const v = m[1].trim();
+            if (v.length > minLen && v.length < maxLen)
+                results.push(v);
+        }
+    }
+    return [...new Set(results)].slice(0, limit);
+}
+const extractFindings = (t) => extractByPatterns(t, [
+    /(?:found|discovered|identified|noticed|see that|observed)\s+(?:that\s+)?(.+?)(?:\.|$)/gim,
+    /^[-•*]\s*(.+)$/gm,
+], 10, 300, 20);
+const extractBlockers = (t) => extractByPatterns(t, [
+    /(?:blocked by|couldn't|cannot|unable to|failed to|can't)\s+(.+?)(?:\.|$)/gim,
+    /(?:blocker|obstacle|issue|problem):\s*(.+?)(?:\.|$)/gim,
+], 5, 200, 10);
+const extractRecommendations = (t) => extractByPatterns(t, [
+    /(?:recommend|suggest|should|next step|consider)\s+(.+?)(?:\.|$)/gim,
+    /(?:TODO|ACTION):\s*(.+?)(?:\.|$)/gim,
+], 5, 200, 10);
+const extractUnexpected = (t) => extractByPatterns(t, [
+    /(?:also noticed|unexpected|surprisingly|interestingly|aside:)\s+(.+?)(?:\.|$)/gim,
+], 10, 200, 5);
+function inferStatus(text, blockers, findings) {
+    const lower = text.toLowerCase();
+    if (/pivoted|changed approach|switched to/i.test(lower))
+        return 'pivoted';
+    if (blockers.length > 0 && findings.length === 0)
+        return 'blocked';
+    if (blockers.length > 0)
+        return 'partial';
+    if (/complete|done|success|finished|all (?:tests )?pass/i.test(lower))
+        return 'success';
+    return 'partial';
+}
+function inferScopeChange(text) {
+    const lower = text.toLowerCase();
+    if (/scope.{0,20}(?:grew|larger|expanded|more than expected)/i.test(lower))
+        return 'larger';
+    if (/scope.{0,20}(?:smaller|reduced|simpler than)/i.test(lower))
+        return 'smaller';
+    if (/(?:different approach|completely different|pivoted to)/i.test(lower))
+        return 'different';
+    return 'same';
+}
+function inferConfidence(text, findings, blockers) {
+    if (/(?:very confident|high confidence|certain)/i.test(text))
+        return 0.9;
+    if (/(?:uncertain|not sure|low confidence|unsure)/i.test(text))
+        return 0.3;
+    if (blockers.length > 2)
+        return 0.3;
+    if (blockers.length > 0)
+        return 0.5;
+    if (findings.length > 3)
+        return 0.8;
+    return 0.6;
+}
+// ─── Exports ─────────────────────────────────────────────────────────────────
+export function parseDebrief(rawOutput) {
+    if (!rawOutput || typeof rawOutput !== 'string')
+        return emptyDebrief();
+    // Try JSON-structured debrief first
+    const jsonMatch = rawOutput.match(/```(?:json)?\s*(\{[\s\S]*?"status"[\s\S]*?\})\s*```/);
+    if (jsonMatch) {
+        try {
+            const parsed = JSON.parse(jsonMatch[1]);
+            if (parsed.status && STATUSES.includes(parsed.status)) {
+                const d = emptyDebrief();
+                return {
+                    ...d,
+                    ...parsed,
+                    artifacts: { ...d.artifacts, ...(parsed.artifacts || {}) },
+                };
+            }
+        }
+        catch { /* fall through to prose extraction */ }
+    }
+    // Best-effort extraction from prose
+    const findings = extractFindings(rawOutput);
+    const blockers = extractBlockers(rawOutput);
+    const recommendations = extractRecommendations(rawOutput);
+    const unexpectedFindings = extractUnexpected(rawOutput);
+    const filesAll = [...rawOutput.matchAll(FILE_PATH_RE)].map(m => m[1]);
+    const lower = rawOutput.toLowerCase();
+    const filesChanged = filesAll.filter(f => lower.includes(`wrote ${f.toLowerCase()}`) || lower.includes(`created ${f.toLowerCase()}`) || lower.includes(`modified ${f.toLowerCase()}`) || lower.includes(`edited ${f.toLowerCase()}`));
+    const filesRead = filesAll.filter(f => !filesChanged.includes(f));
+    const testMatch = rawOutput.match(TEST_COUNT_RE);
+    const testsRun = testMatch ? parseInt(testMatch[1], 10) : 0;
+    const pivotMatch = rawOutput.match(/pivoted?\s+(?:because|since|due to)\s+(.+?)(?:\.|$)/i);
+    return {
+        status: inferStatus(rawOutput, blockers, findings),
+        findings,
+        blockers,
+        scopeChange: inferScopeChange(rawOutput),
+        confidence: inferConfidence(rawOutput, findings, blockers),
+        recommendations,
+        artifacts: { filesChanged, filesRead, testsRun },
+        pivotReason: pivotMatch ? pivotMatch[1].trim() : undefined,
+        unexpectedFindings,
+    };
+}
+// ─── Generate debrief instruction for agent prompts ──────────────────────────
+const TIER_EMPHASIS = {
+    search: 'Focus on: findings, confidence, unexpectedFindings.',
+    execute: 'Focus on: artifacts (filesChanged, testsRun), blockers, scopeChange.',
+    think: 'Focus on: recommendations, confidence, pivotReason.',
+};
+export function generateDebriefInstruction(tier, contract) {
+    const emphasis = TIER_EMPHASIS[tier] || TIER_EMPHASIS.execute;
+    const scope = contract?.scope ? ` Scope: ${contract.scope}.` : '';
+    return `\n---\nRESPONSE FORMAT: End your response with a JSON block:\n\`\`\`json\n{"status":"success|partial|blocked|pivoted","findings":[],"blockers":[],"scopeChange":"same|larger|smaller|different","confidence":0.0-1.0,"recommendations":[],"artifacts":{"filesChanged":[],"filesRead":[],"testsRun":0},"pivotReason":"...if pivoted","unexpectedFindings":[]}\n\`\`\`\n${emphasis}${scope}`;
+}
+// ─── Integrate debrief into HEAD's situation model ───────────────────────────
+export function integrateDebrief(currentSituation, debrief) {
+    const sit = structuredClone(currentSituation);
+    // Update confidence on related ledger entries
+    if (!sit.ledger)
+        sit.ledger = [];
+    for (const finding of debrief.findings) {
+        const existing = sit.ledger.find(e => e.topic && finding.toLowerCase().includes(e.topic.toLowerCase()));
+        if (existing) {
+            existing.confidence = Math.min(1, (existing.confidence || 0.5) + 0.1);
+            existing.resolved = true;
+        }
+        else {
+            sit.ledger.push({ topic: finding.slice(0, 80), confidence: debrief.confidence, resolved: false });
+        }
+    }
+    // Blockers create new uncertainty entries
+    for (const blocker of debrief.blockers) {
+        sit.ledger.push({ topic: blocker.slice(0, 80), confidence: 0.3, resolved: false, isBlocker: true });
+    }
+    // Scope delta
+    if (debrief.scopeChange !== 'same') {
+        if (!sit.material)
+            sit.material = {};
+        sit.material.scopeTrend = debrief.scopeChange;
+        if (debrief.artifacts?.filesChanged) {
+            sit.material.touchedFiles = [
+                ...new Set([...(sit.material.touchedFiles || []), ...debrief.artifacts.filesChanged]),
+            ];
+        }
+    }
+    // Recommendations -> next wave planning
+    if (!sit.nextActions)
+        sit.nextActions = [];
+    sit.nextActions.push(...debrief.recommendations);
+    // Unexpected findings -> noticings
+    if (debrief.unexpectedFindings?.length) {
+        if (!sit.noticings)
+            sit.noticings = [];
+        sit.noticings.push(...debrief.unexpectedFindings);
+    }
+    // Overall confidence update
+    sit.confidence = sit.confidence
+        ? sit.confidence * 0.7 + debrief.confidence * 0.3
+        : debrief.confidence;
+    return sit;
+}
+// ─── Summarize a parallel wave of debriefs ───────────────────────────────────
+export function summarizeWaveOutcome(debriefs) {
+    if (!debriefs || debriefs.length === 0) {
+        return {
+            overallStatus: 'blocked',
+            aggregateConfidence: 0,
+            allFindings: [],
+            allBlockers: [],
+            scopeDelta: 'same',
+            nextActions: [],
+        };
+    }
+    const statusPriority = { blocked: 0, pivoted: 1, partial: 2, success: 3 };
+    const worstStatus = debriefs.reduce((worst, d) => (statusPriority[d.status] ?? 2) < (statusPriority[worst] ?? 2) ? d.status : worst, 'success');
+    const allFindings = [...new Set(debriefs.flatMap(d => d.findings || []))];
+    const allBlockers = [...new Set(debriefs.flatMap(d => d.blockers || []))];
+    const nextActions = [...new Set(debriefs.flatMap(d => d.recommendations || []))];
+    const aggregateConfidence = debriefs.reduce((sum, d) => sum + (d.confidence || 0.5), 0) / debriefs.length;
+    // Scope: any non-same scope wins, larger beats smaller, different beats all
+    const scopeDeltas = debriefs.map(d => d.scopeChange || 'same').filter(s => s !== 'same');
+    let scopeDelta = 'same';
+    if (scopeDeltas.includes('different'))
+        scopeDelta = 'different';
+    else if (scopeDeltas.includes('larger'))
+        scopeDelta = 'larger';
+    else if (scopeDeltas.includes('smaller'))
+        scopeDelta = 'smaller';
+    return {
+        overallStatus: worstStatus,
+        aggregateConfidence: Math.round(aggregateConfidence * 100) / 100,
+        allFindings,
+        allBlockers,
+        scopeDelta,
+        nextActions,
+    };
+}
+//# sourceMappingURL=debrief.js.map

package/dist/src/debrief.js.map

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

package/dist/src/decide.d.ts

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+/**
+ * decide.ts — Routing decision module for the Dual-Brain Orchestrator.
+ *
+ * Given a task detection + user profile, decides which provider/model/effort/mode
+ * to use and explains why in one sentence.
+ *
+ * Exports: decideRoute, getModelCapabilities, getAvailableModels,
+ *          WORK_STYLES, getWorkStyle, estimateBudgetPressure,
+ *          shouldDualBrain, explainDecision, getFailoverOrder
+ */
+export interface WorkStyleDef {
+    label: string;
+    defaultWorker: string;
+    complexWorker: string;
+    challengerPolicy: 'never' | 'high-risk' | 'medium-risk';
+    checkpointPolicy: 'never' | 'risky-ops' | 'all-edits';
+    reviewPolicy: string;
+    description: string;
+}
+export declare const WORK_STYLES: Record<string, WorkStyleDef>;
+export interface WorkStyleWithKey extends WorkStyleDef {
+    key: string;
+}
+export declare function getWorkStyle(profile: {
+    workStyle?: string;
+    work_style?: string;
+} | undefined): WorkStyleWithKey;
+interface ModelCapability {
+    provider: string;
+    tierFit: string[];
+    contextWindow: number;
+    strengths: string[];
+    weaknesses: string[];
+    effortLevels: string[] | null;
+    costTier: string;
+}
+export declare function getModelCapabilities(model: string): ModelCapability | null;
+export declare function getAvailableModels(profile: {
+    providers?: Record<string, {
+        enabled?: boolean;
+        models?: string[];
+    }>;
+}): {
+    claude: string[];
+    openai: string[];
+};
+export declare function estimateBudgetPressure(_profile: unknown, _cwd?: string): {
+    claude: number;
+    openai: number;
+};
+export declare function shouldDualBrain(detection: {
+    intent?: string;
+    risk?: string;
+    complexity?: string;
+    designImpact?: boolean;
+}, profile: {
+    dual_brain_enabled?: boolean;
+    providers?: Record<string, {
+        enabled?: boolean;
+        plan?: string;
+    }>;
+}): boolean;
+export declare function explainDecision(decision: Record<string, unknown>, detection: Record<string, unknown>, profile: Record<string, unknown>): string;
+export interface PreferenceSignals {
+    biasOverride: 'cost-saver' | 'quality-first' | null;
+    preferProvider: 'claude' | 'openai' | null;
+    avoidProvider: 'claude' | 'openai' | null;
+    alwaysDualBrain: boolean;
+    neverDualBrain: boolean;
+    preferModel: string | null;
+}
+export declare function parsePreferences(preferences: Array<{
+    text: string;
+    enabled: boolean;
+    scope: string;
+}> | undefined): PreferenceSignals;
+export declare function decideRoute({ profile, detection, cwd, thinkResult, sessionContext }?: {
+    profile?: Record<string, unknown>;
+    detection?: Record<string, unknown>;
+    cwd?: string;
+    thinkResult?: {
+        tier?: string;
+    } | null;
+    sessionContext?: Record<string, unknown> | null;
+}): Record<string, unknown>;
+export declare function getFailoverOrder(decision: {
+    provider: string;
+    model: string;
+    tier?: string;
+}, profile: Record<string, unknown>): Array<{
+    provider: string;
+    model: string;
+    label: string;
+}>;
+export {};