dual-brain 0.2.30 → 0.3.1

package/dist/src/receipt.js

@@ -0,0 +1,326 @@
+import { mkdirSync, writeFileSync, appendFileSync, readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+const DIM = '\x1b[2m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const RESET = '\x1b[0m';
+const SEP = `${DIM}──────────────────────────────────${RESET}`;
+const AUTH_PAT = /\b(auth|credential|secret|token|password|encrypt|permission|oauth|jwt|api.?key)\b/i;
+function classifyRisk(plan, result) {
+    if (plan.risk)
+        return plan.risk;
+    const files = result.filesChanged ?? [];
+    if (files.some(f => AUTH_PAT.test(f)))
+        return 'critical';
+    if (plan.tier === 'think')
+        return 'high';
+    if (plan.tier === 'execute')
+        return 'medium';
+    return 'low';
+}
+function classifyChallenger(plan, result) {
+    const policy = plan.challengerPolicy;
+    if (!plan.useChallenger && (!policy || policy === 'none'))
+        return 'not used';
+    if (!result.success)
+        return 'blocked';
+    if (result.output && /concern|issue|warn|problem/i.test(String(result.output)))
+        return 'concerns raised';
+    return 'pass';
+}
+function nextStep(result, plan, verification) {
+    const files = result.filesChanged ?? [];
+    const changed = files.length > 0;
+    const authFiles = files.some(f => AUTH_PAT.test(f));
+    if (!result.success) {
+        const retry = result.error && /test/i.test(String(result.error));
+        return retry ? 'fix failing tests' : 'retry with deeper analysis';
+    }
+    if (authFiles)
+        return 'security review recommended';
+    if (changed) {
+        if (!verification.testsRun)
+            return 'run tests to verify';
+        if (verification.testsPassed === false)
+            return 'fix failing tests';
+        if (verification.testsPassed === true)
+            return 'commit this patch';
+        return 'review the diff';
+    }
+    return 'review the output';
+}
+export function buildReceipt(result, plan, verification) {
+    const files = result.filesChanged ?? [];
+    const changed = files.length > 0 ? files.join(', ') : 'no files changed';
+    let verified;
+    if (verification.testsPassed === true)
+        verified = 'tests passed';
+    else if (verification.filesVerified)
+        verified = 'files confirmed changed';
+    else
+        verified = 'not verified';
+    return {
+        changed,
+        verified,
+        risk: classifyRisk(plan, result),
+        challenger: classifyChallenger(plan, result),
+        next: nextStep(result, plan, verification),
+        success: result.success ?? false,
+    };
+}
+function colorRisk(risk) {
+    if (risk === 'low')
+        return `${GREEN}${risk}${RESET}`;
+    if (risk === 'medium')
+        return `${YELLOW}${risk}${RESET}`;
+    return `${RED}${risk}${RESET}`;
+}
+function colorChallenger(ch) {
+    if (ch === 'pass')
+        return `${GREEN}${ch}${RESET}`;
+    if (ch === 'concerns raised')
+        return `${YELLOW}${ch}${RESET}`;
+    if (ch === 'blocked')
+        return `${RED}${ch}${RESET}`;
+    return `${DIM}${ch}${RESET}`;
+}
+export function formatReceipt(receipt) {
+    return [
+        SEP,
+        `  Changed:    ${receipt.changed}`,
+        `  Verified:   ${receipt.verified}`,
+        `  Risk:       ${colorRisk(receipt.risk)}`,
+        `  Challenger: ${colorChallenger(receipt.challenger)}`,
+        `  Next:       ${receipt.next}`,
+        SEP,
+    ].join('\n');
+}
+export function formatFailureReceipt(receipt, failureContext) {
+    const errorLine = failureContext ? `  Error:      ${failureContext}` : null;
+    const lines = [
+        SEP,
+        `  Changed:    ${receipt.changed}`,
+        `  Verified:   ${receipt.verified}`,
+        `  Risk:       ${colorRisk(receipt.risk)}`,
+        `  Challenger: ${colorChallenger(receipt.challenger)}`,
+    ];
+    if (errorLine)
+        lines.push(errorLine);
+    lines.push(`  Next:       ${receipt.next}`, SEP);
+    return lines.join('\n');
+}
+// --- Persistent session receipt ---
+const RECEIPTS_DIR = '.dualbrain/receipts';
+function receiptsDir(cwd) {
+    return join(cwd, RECEIPTS_DIR);
+}
+function gitChangedFiles(cwd) {
+    try {
+        const out = execSync('git diff --name-only HEAD', { cwd, stdio: ['ignore', 'pipe', 'pipe'] })
+            .toString().trim();
+        if (!out)
+            return [];
+        return out.split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function readDecisionsRecent(cwd, limit = 5) {
+    try {
+        const raw = readFileSync(join(cwd, '.dualbrain', 'decisions.jsonl'), 'utf8');
+        const lines = raw.split('\n').filter(l => l.trim());
+        return lines.slice(-limit).map(l => { try {
+            return JSON.parse(l);
+        }
+        catch {
+            return null;
+        } }).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function ageLabel(ms) {
+    const mins = Math.round(ms / 60000);
+    if (mins < 60)
+        return `${mins}m ago`;
+    const hours = Math.round(mins / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    return `${Math.round(hours / 24)}d ago`;
+}
+export function generateReceipt(run = {}, cwd = process.cwd()) {
+    const now = new Date();
+    const ts = now.toISOString();
+    // Derive files changed — prefer run.result, fall back to git diff
+    const filesChanged = (run.result?.filesChanged && run.result.filesChanged.length > 0)
+        ? run.result.filesChanged
+        : gitChangedFiles(cwd);
+    // Recent decisions from living docs
+    const decisionEntries = readDecisionsRecent(cwd, 5);
+    const decisions = decisionEntries.map(d => d.question || d.decision || '').filter(Boolean).slice(0, 3);
+    // Test results
+    const testsRun = run.verification?.ok !== undefined
+        ? (run.verification.ok ? 'passed' : 'failed')
+        : null;
+    // Unresolved risks from plan
+    const risksUnresolved = [];
+    if (run.plan?.approvalRequired && !run.outcome?.approved) {
+        risksUnresolved.push('approval required but not obtained');
+    }
+    if (run.verification && !run.verification.ok) {
+        risksUnresolved.push('verification failed');
+    }
+    const verNotes = run.verification?.notes ?? [];
+    for (const note of verNotes) {
+        if (/warn|risk|unverif|no file changes/i.test(note))
+            risksUnresolved.push(note.slice(0, 80));
+    }
+    // Blockers — gates that failed
+    const blockers = [];
+    for (const [name, g] of Object.entries(run.gates ?? {})) {
+        if (g && !g.passed)
+            blockers.push(`${name}: ${g.reason?.slice(0, 80)}`);
+    }
+    if (run.result?.error)
+        blockers.push(run.result.error.slice(0, 80));
+    // Derive status
+    const success = run.result && !run.result.error && (run.verification?.ok !== false);
+    const status = !run.result ? 'incomplete'
+        : blockers.length > 0 ? 'failed'
+            : success ? 'success'
+                : 'partial';
+    // Next action (reuse existing logic)
+    let nextAction = 'review the output';
+    if (status === 'success' && filesChanged.length > 0) {
+        nextAction = run.verification?.testsRun ? 'commit changes' : 'run tests, then commit';
+    }
+    else if (status === 'failed') {
+        nextAction = 'investigate failure, retry with adjusted approach';
+    }
+    else if (status === 'partial') {
+        nextAction = 'check partial output, verify manually';
+    }
+    const duration = (run.completedAt && run.startedAt)
+        ? Math.round((run.completedAt - run.startedAt) / 1000)
+        : null;
+    const receipt = {
+        timestamp: ts,
+        goal: (run.prompt ?? '').slice(0, 200),
+        filesChanged,
+        decisions,
+        testsRun,
+        risksUnresolved,
+        blockers,
+        nextAction,
+        provider: run.plan?.primaryProvider ?? run.result?.provider ?? null,
+        model: run.plan?.primaryModel ?? run.result?.model ?? null,
+        duration,
+        status,
+    };
+    // Store receipt
+    try {
+        const dir = receiptsDir(cwd);
+        mkdirSync(dir, { recursive: true });
+        const filename = ts.replace(/[:.]/g, '-').slice(0, 19) + '.json';
+        writeFileSync(join(dir, filename), JSON.stringify(receipt, null, 2));
+        // One-line summary for fast scanning
+        const summary = {
+            ts,
+            goal: receipt.goal.slice(0, 80),
+            status,
+            files: filesChanged.length,
+            next: nextAction.slice(0, 60),
+        };
+        appendFileSync(join(dir, 'index.jsonl'), JSON.stringify(summary) + '\n');
+    }
+    catch {
+        // Storage failure is non-blocking
+    }
+    return receipt;
+}
+export function buildResumeBrief(cwd = process.cwd()) {
+    try {
+        const dir = receiptsDir(cwd);
+        if (!existsSync(dir))
+            return null;
+        // Find the most recent receipt JSON file
+        const files = readdirSync(dir)
+            .filter(f => f.endsWith('.json') && f !== 'index.json')
+            .sort()
+            .reverse();
+        if (files.length === 0)
+            return null;
+        const raw = readFileSync(join(dir, files[0]), 'utf8');
+        const r = JSON.parse(raw);
+        const age = ageLabel(Date.now() - Date.parse(r.timestamp));
+        const filesSummary = r.filesChanged?.length > 0
+            ? r.filesChanged.slice(0, 3).map(f => f.split('/').pop()).join(', ')
+                + (r.filesChanged.length > 3 ? ` +${r.filesChanged.length - 3}` : '')
+            : 'no files changed';
+        const riskLine = r.risksUnresolved?.length > 0
+            ? `Risk: ${r.risksUnresolved[0].slice(0, 60)}`
+            : null;
+        const lines = [
+            'RESUME CONTEXT:',
+            `Last session: ${age}`,
+            `Goal: ${(r.goal || 'unknown').slice(0, 80)}`,
+            `Done: ${filesSummary}`,
+            `Status: ${r.status}${r.testsRun ? ', tests ' + r.testsRun : ''}`,
+        ];
+        if (riskLine)
+            lines.push(riskLine);
+        lines.push(`Next: ${(r.nextAction || '').slice(0, 80)}`);
+        const brief = lines.join('\n');
+        return brief.length > 500 ? brief.slice(0, 497) + '...' : brief;
+    }
+    catch {
+        return null;
+    }
+}
+export function getLatestReceipt(cwd = process.cwd()) {
+    try {
+        const dir = receiptsDir(cwd);
+        if (!existsSync(dir))
+            return null;
+        const files = readdirSync(dir)
+            .filter(f => f.endsWith('.json') && f !== 'index.json')
+            .sort()
+            .reverse();
+        if (files.length === 0)
+            return null;
+        const raw = readFileSync(join(dir, files[0]), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function buildReceiptFromOutcome(outcome = {}) {
+    const result = {
+        success: outcome.success ?? outcome.result?.success ?? false,
+        filesChanged: outcome.filesChanged ?? outcome.result?.filesChanged ?? [],
+        error: outcome.error ?? outcome.result?.error ?? null,
+        duration: outcome.duration ?? outcome.result?.duration ?? 0,
+        output: outcome.output ?? null,
+    };
+    const plan = {
+        primaryModel: outcome.primaryModel ?? '',
+        reasoningDepth: outcome.reasoningDepth ?? '',
+        challengerPolicy: outcome.challengerPolicy ?? 'none',
+        useChallenger: !!(outcome.challengerPolicy && outcome.challengerPolicy !== 'none'),
+        tier: outcome.tier ?? '',
+        workStyle: outcome.workStyle ?? '',
+        risk: outcome.risk ?? '',
+    };
+    const verification = {
+        filesVerified: outcome.verification?.filesVerified ?? false,
+        testsRun: outcome.verification?.testsRun ?? false,
+        testsPassed: outcome.verification?.testsPassed ?? null,
+    };
+    return buildReceipt(result, plan, verification);
+}
+//# sourceMappingURL=receipt.js.map

package/dist/src/receipt.js.map

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

package/dist/src/recommendations.d.ts

@@ -0,0 +1,13 @@
+interface Recommendation {
+    id: string;
+    priority: 'high' | 'medium' | 'low';
+    category: string;
+    title: string;
+    description: string;
+    action: string;
+    impact: string;
+}
+export declare function generateRecommendations(cwd: string | undefined): Recommendation[];
+export declare function formatRecommendations(recs: Recommendation[]): string;
+export declare function getTopRecommendation(cwd: string | undefined): Recommendation | null;
+export {};

package/dist/src/recommendations.js

@@ -0,0 +1,291 @@
+// recommendations.ts — Proactive settings recommendations from HEAD
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+function readJSON(path) {
+    try {
+        return existsSync(path) ? JSON.parse(readFileSync(path, 'utf8')) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function dbPath(cwd, ...parts) {
+    return join(cwd || process.cwd(), '.dualbrain', ...parts);
+}
+function loadRoutingState(cwd) {
+    return (readJSON(dbPath(cwd, 'routing-state.json')) || {});
+}
+function loadThinkMetrics(cwd) {
+    return (readJSON(dbPath(cwd, 'think-metrics.json')) || {});
+}
+function loadGovernance(cwd) {
+    return (readJSON(dbPath(cwd, 'governance-state.json')) || {});
+}
+function loadSubscription(cwd) {
+    return (readJSON(dbPath(cwd, 'subscription.json')) || {});
+}
+function loadOutcomes(cwd) {
+    try {
+        const dir = dbPath(cwd, 'outcomes');
+        if (!existsSync(dir))
+            return [];
+        return readdirSync(dir)
+            .filter(f => f.endsWith('.json'))
+            .map(f => readJSON(join(dir, f)))
+            .filter((v) => v !== null);
+    }
+    catch {
+        return [];
+    }
+}
+// --- Recommendation rules ---
+function thinkROI(metrics) {
+    const { hitRate, totalHits, totalMisses, avgTokensSaved } = metrics;
+    if (hitRate == null)
+        return null;
+    const observations = (totalHits || 0) + (totalMisses || 0);
+    if (observations < 5)
+        return null;
+    if (hitRate < 0.4) {
+        return {
+            id: 'think-roi-low',
+            priority: 'medium',
+            category: 'efficiency',
+            title: 'Think agent underperforming',
+            description: `${Math.round(hitRate * 100)}% hit rate — think preflight isn't saving tokens.`,
+            action: 'Consider disabling think triggers or narrowing trigger conditions.',
+            impact: 'Reduce latency and token overhead on low-complexity tasks.',
+        };
+    }
+    if (hitRate > 0.7) {
+        const savings = avgTokensSaved ? `~${Math.round(avgTokensSaved / 1000)}K tokens` : 'tokens';
+        return {
+            id: 'think-roi-high',
+            priority: 'medium',
+            category: 'efficiency',
+            title: 'Think agent performing well',
+            description: `${Math.round(hitRate * 100)}% hit rate, saving ${savings} per refined task.`,
+            action: 'No action needed, keep enabled.',
+            impact: 'Sustained token efficiency on complex dispatches.',
+        };
+    }
+    return null;
+}
+function modelMismatch(routingState) {
+    const recs = [];
+    for (const [taskType, models] of Object.entries(routingState)) {
+        if (taskType.startsWith('_'))
+            continue; // skip metadata keys
+        for (const [model, stats] of Object.entries(models)) {
+            const { ema, observations } = stats || {};
+            if (observations >= 10 && ema < 0.4) {
+                recs.push({
+                    id: `model-mismatch-low-${taskType}-${model}`,
+                    priority: 'high',
+                    category: 'routing',
+                    title: 'Model mismatch detected',
+                    description: `${model} scores ${ema.toFixed(2)} on ${taskType} tasks.`,
+                    action: `Route ${taskType} tasks away from ${model}.`,
+                    impact: 'Better task outcomes by avoiding poor model-task fit.',
+                });
+            }
+            else if (observations >= 10 && ema > 0.8 && (model === 'haiku' || model.includes('haiku'))) {
+                recs.push({
+                    id: `model-mismatch-promote-${taskType}-${model}`,
+                    priority: 'high',
+                    category: 'routing',
+                    title: 'Cheap model excelling',
+                    description: `${model} scores ${ema.toFixed(2)} on ${taskType} tasks.`,
+                    action: `Promote ${model} as default for ${taskType} tier — quality without the cost.`,
+                    impact: 'Same output quality at lower token cost.',
+                });
+            }
+        }
+    }
+    return recs;
+}
+function budgetTrajectory(governance) {
+    const { budgetUsedPct, sessionProgressPct, workStyle } = governance;
+    if (budgetUsedPct == null)
+        return null;
+    if (budgetUsedPct > 60 && sessionProgressPct != null && sessionProgressPct < 50) {
+        return {
+            id: 'budget-critical',
+            priority: 'high',
+            category: 'budget',
+            title: 'Budget burning fast',
+            description: `${Math.round(budgetUsedPct)}% budget used, ~${Math.round(sessionProgressPct)}% through estimated work.`,
+            action: 'Switch to cost-saver mode: `dual-brain config set workStyle cost-saver`.',
+            impact: 'Avoid hitting budget ceiling before work completes.',
+        };
+    }
+    if (budgetUsedPct < 20 && workStyle === 'cost-saver') {
+        return {
+            id: 'budget-underutilized',
+            priority: 'low',
+            category: 'budget',
+            title: 'Budget well under control',
+            description: `Only ${Math.round(budgetUsedPct)}% budget used in cost-saver mode.`,
+            action: 'You could afford quality-first mode for this session.',
+            impact: 'Better output quality while staying within budget.',
+        };
+    }
+    return null;
+}
+function failurePattern(outcomes) {
+    if (!outcomes.length)
+        return null;
+    const recent = outcomes.slice(-20);
+    const failures = recent.filter(o => o.success === false || (o.reward != null && o.reward < 0.3));
+    const failRate = failures.length / recent.length;
+    if (failRate > 0.3) {
+        const modelCounts = {};
+        failures.forEach(o => { if (o.model)
+            modelCounts[o.model] = (modelCounts[o.model] || 0) + 1; });
+        const worstModel = Object.entries(modelCounts).sort((a, b) => b[1] - a[1])[0];
+        const modelNote = worstModel && worstModel[1] >= 3
+            ? ` Failures cluster on ${worstModel[0]}.`
+            : '';
+        return {
+            id: 'failure-pattern',
+            priority: 'high',
+            category: 'quality',
+            title: 'High failure rate detected',
+            description: `${Math.round(failRate * 100)}% of recent tasks failed.${modelNote}`,
+            action: worstModel && worstModel[1] >= 3
+                ? `Route away from ${worstModel[0]} — or check task ambiguity.`
+                : 'Review task clarity and model-task fit.',
+            impact: 'Fewer retries, less wasted compute.',
+        };
+    }
+    return null;
+}
+function subscriptionUtilization(subscription, routingState) {
+    const { tier, maxMultiplier } = subscription;
+    if (!tier)
+        return null;
+    const routingCells = Object.entries(routingState)
+        .filter(([k]) => !k.startsWith('_')) // skip metadata keys
+        .map(([, v]) => v);
+    const opusUses = routingCells
+        .flatMap(m => Object.entries(m))
+        .filter(([model]) => model === 'opus' || model.includes('opus'))
+        .reduce((s, [, stats]) => s + (stats.observations || 0), 0);
+    const totalUses = routingCells
+        .flatMap(m => Object.values(m))
+        .reduce((s, stats) => s + (stats.observations || 0), 0);
+    if (!totalUses)
+        return null;
+    const opusPct = opusUses / totalUses;
+    if ((tier === 'max' || (maxMultiplier && maxMultiplier >= 20)) && opusPct < 0.15) {
+        return {
+            id: 'subscription-underutilized',
+            priority: 'medium',
+            category: 'profile',
+            title: 'Subscription underutilized',
+            description: `Max ${maxMultiplier || ''}x plan but opus used only ${Math.round(opusPct * 100)}% of dispatches.`,
+            action: 'Consider quality-first mode for better output.',
+            impact: 'Get more value from your subscription tier.',
+        };
+    }
+    if ((tier === 'free' || tier === 'pro') && opusPct > 0.4) {
+        return {
+            id: 'subscription-aggressive',
+            priority: 'medium',
+            category: 'profile',
+            title: 'Routing aggressively for plan',
+            description: `${Math.round(opusPct * 100)}% opus usage on a ${tier} plan.`,
+            action: 'Switch to balanced or cost-saver to stay within limits.',
+            impact: 'Avoid rate limits and unexpected cost overruns.',
+        };
+    }
+    return null;
+}
+function cascadeEffectiveness(metrics, outcomes) {
+    const { cascadeHits } = metrics;
+    if (!cascadeHits || cascadeHits < 3)
+        return null;
+    const cascaded = outcomes.filter(o => o.cascaded === true);
+    if (cascaded.length < 3)
+        return null;
+    const avgReward = cascaded.reduce((s, o) => s + (o.reward || 0), 0) / cascaded.length;
+    if (avgReward > 0.7) {
+        return {
+            id: 'cascade-effective',
+            priority: 'low',
+            category: 'efficiency',
+            title: 'Cascade routing working well',
+            description: `${cascadeHits} cascade hits, ${avgReward.toFixed(2)} avg reward on cascaded tasks.`,
+            action: 'Keep cascade enabled — it\'s delivering quality results.',
+            impact: 'Continued token efficiency on eligible tasks.',
+        };
+    }
+    return {
+        id: 'cascade-poor',
+        priority: 'low',
+        category: 'efficiency',
+        title: 'Cascade delivering poor results',
+        description: `${cascadeHits} cascade hits but only ${avgReward.toFixed(2)} avg reward.`,
+        action: 'Consider disabling cascade: `dual-brain config set cascade false`.',
+        impact: 'Better outcomes by routing cascade tasks to full models.',
+    };
+}
+// --- Export 1: generateRecommendations ---
+export function generateRecommendations(cwd) {
+    try {
+        const routingState = loadRoutingState(cwd);
+        const thinkMetrics = loadThinkMetrics(cwd);
+        const governance = loadGovernance(cwd);
+        const subscription = loadSubscription(cwd);
+        const outcomes = loadOutcomes(cwd);
+        const recs = [
+            ...modelMismatch(routingState),
+            failurePattern(outcomes),
+            budgetTrajectory(governance),
+            thinkROI(thinkMetrics),
+            subscriptionUtilization(subscription, routingState),
+            cascadeEffectiveness(thinkMetrics, outcomes),
+        ];
+        const filtered = recs.filter((r) => r !== null);
+        const order = { high: 0, medium: 1, low: 2 };
+        return filtered.sort((a, b) => (order[a.priority] ?? 9) - (order[b.priority] ?? 9));
+    }
+    catch {
+        return [];
+    }
+}
+// --- Export 2: formatRecommendations ---
+const ICONS = { high: '⚡', medium: '💡', low: '📊' };
+export function formatRecommendations(recs) {
+    const top = recs.slice(0, 4);
+    if (!top.length) {
+        return '╭─ Recommendations ─────────────────────────────────────────────╮\n' +
+            '│  No recommendations — configuration looks healthy.            │\n' +
+            '╰───────────────────────────────────────────────────────────────╯';
+    }
+    const WIDTH = 63;
+    // Truncate + pad to fit inside box: WIDTH - 4 accounts for '| ' and ' |'
+    const INNER = WIDTH - 4;
+    const clip = (str) => str.length > INNER ? str.slice(0, INNER - 1) + '…' : str;
+    const pad = (str) => clip(str).padEnd(INNER);
+    const line = (content) => `│ ${pad(content)} │`;
+    const lines = [
+        '╭─ Recommendations ' + '─'.repeat(WIDTH - 20) + '╮',
+        line(''),
+    ];
+    for (const rec of top) {
+        const icon = ICONS[rec.priority] || '•';
+        lines.push(line(`${icon} ${rec.priority.toUpperCase()}: ${rec.title}`));
+        lines.push(line(`   ${rec.description}`));
+        lines.push(line(`   → ${rec.action}`));
+        lines.push(line(''));
+    }
+    lines.push('╰' + '─'.repeat(WIDTH - 2) + '╯');
+    return lines.join('\n');
+}
+// --- Export 3: getTopRecommendation ---
+export function getTopRecommendation(cwd) {
+    const recs = generateRecommendations(cwd);
+    return recs.length ? recs[0] : null;
+}
+//# sourceMappingURL=recommendations.js.map