dual-brain 0.2.29 → 0.3.0

package/dist/src/prompt-intel.js

@@ -0,0 +1,321 @@
+// prompt-intel.mjs — Layer 3 prompt analysis, enrichment, risk detection, and intervention routing.
+// Pure functions only. No I/O, no exec. Caller provides projectBrief and calibration.
+const INTENT_PATTERNS = {
+    fix: /\b(?:fix|bug|broken|error|crash|failing|fails|wrong|issue|problem|broken|not\s+working|doesn't\s+work|doesn't\s+work)\b/i,
+    feature: /\b(?:add|create|build|implement|new|introduce|support|enable)\b/i,
+    refactor: /\b(?:refactor|clean\s+up|reorganize|simplify|extract|restructure|dedup|consolidate|move)\b/i,
+    review: /\b(?:review|check|audit|look\s+at|examine|inspect|assess|evaluate)\b/i,
+    ship: /\b(?:ship|deploy|publish|release|push|merge|go\s+live|launch)\b/i,
+    explore: /\b(?:what|how|why|where|find|search|explain|show\s+me|tell\s+me|list|which)\b/i,
+    test: /\b(?:test|spec|coverage|assert|jest|mocha|vitest|unit\s+test|integration)\b/i,
+    docs: /\b(?:doc|readme|comment|jsdoc|document|explain|annotate)\b/i,
+    deploy: /\b(?:deploy|provision|infrastructure|ci|cd|pipeline|k8s|kubernetes|docker)\b/i,
+};
+const RISK_PATTERNS = [
+    { type: 'destructive', severity: 'block', re: /\b(?:delete\s+all|remove\s+all|drop\s+all|wipe|destroy|rm\s+-rf|truncate\s+all|nuke)\b/i, detail: 'Prompt contains mass-destructive operation' },
+    { type: 'force_push', severity: 'block', re: /(?:force\s+push|--force|-f\s+origin|reset\s+--hard)/i, detail: 'Prompt implies forced git operation' },
+    { type: 'secret', severity: 'warn', re: /\b(?:api\s+key|access\s+token|secret\s+key|\.env|private\s+key|bearer\s+token)\b/i, detail: 'Touches secret or credential material' },
+    { type: 'auth', severity: 'warn', re: /\b(?:auth(?:entication)?|login|logout|password|credential|jwt|oauth|session\s+token)\b/i, detail: 'Touches authentication code' },
+    { type: 'deploy', severity: 'warn', re: /\b(?:ship\s+to|deploy\s+to|release\s+to|push\s+to\s+prod)\b/i, detail: 'Targets a deployment action' },
+    { type: 'data_loss', severity: 'warn', re: /\b(?:drop\s+table|alter\s+table|schema\s+migration|migrate\s+data|database\s+reset)\b/i, detail: 'Touches schema or migration — data loss risk' },
+    { type: 'production', severity: 'warn', re: /\b(?:production|prod\b|live\s+environment|live\s+site)\b/i, detail: 'References production environment' },
+];
+const FILE_REF_RE = /(?:src\/|\.mjs|\.tsx?|\.jsx?|\.json|\.ya?ml|\.sh|line\s+\d+|\bL\d+\b)/i;
+const FUNC_REF_RE = /\b\w+\((?:\)|[^)]{0,40}\))/;
+const STEP_RE = /\b(?:step\s+\d|first[,\s]|then[,\s]|finally[,\s]|must|should\s+(?:use|call|return|handle))\b/i;
+const CRITERIA_RE = /\b(?:accept(?:ance)?\s+criteria|definition\s+of\s+done|constraints?|requirements?|must\s+(?:not|be|have)|should\s+not)\b/i;
+function clamp(v, min = 1, max = 5) {
+    return Math.min(max, Math.max(min, v));
+}
+function scoreSpecificity(prompt) {
+    const hasFile = FILE_REF_RE.test(prompt);
+    const hasFunc = FUNC_REF_RE.test(prompt);
+    const hasLine = /\bL\d+\b|\bline\s+\d+/i.test(prompt);
+    const words = prompt.trim().split(/\s+/).length;
+    if (hasFile && (hasFunc || hasLine))
+        return 5;
+    if (hasFile || hasFunc)
+        return 4;
+    if (words >= 10)
+        return 3;
+    if (words >= 5)
+        return 2;
+    return 1;
+}
+function scoreActionability(prompt) {
+    const hasStep = STEP_RE.test(prompt);
+    const hasVerb = /\b(?:fix|add|remove|refactor|create|update|write|delete|move|rename|replace|ensure|make)\b/i.test(prompt);
+    const hasOutcome = /\b(?:so\s+that|in\s+order\s+to|result(?:ing)?\s+in|should\s+(?:return|output|produce|show))\b/i.test(prompt);
+    const words = prompt.trim().split(/\s+/).length;
+    if (hasStep && hasVerb)
+        return 5;
+    if (hasOutcome && hasVerb)
+        return 4;
+    if (hasVerb && words >= 6)
+        return 3;
+    if (hasVerb)
+        return 2;
+    return 1;
+}
+function scoreSafety(risks) {
+    if (risks.some(r => r.severity === 'block'))
+        return 1;
+    if (risks.some(r => r.type === 'auth' || r.type === 'secret' || r.type === 'production'))
+        return 2;
+    if (risks.some(r => r.type === 'deploy' || r.type === 'data_loss'))
+        return 3;
+    if (risks.length > 0)
+        return 4;
+    return 5;
+}
+function scoreCompleteness(prompt) {
+    const hasCriteria = CRITERIA_RE.test(prompt);
+    const hasContext = /\b(?:because|since|currently|right\s+now|the\s+issue\s+is|error\s+is|it\s+(?:crashes|fails|returns))\b/i.test(prompt);
+    const hasScope = FILE_REF_RE.test(prompt);
+    const words = prompt.trim().split(/\s+/).length;
+    if (hasCriteria && hasContext && hasScope)
+        return 5;
+    if ((hasCriteria || hasContext) && hasScope)
+        return 4;
+    if (hasContext || (hasScope && words >= 8))
+        return 3;
+    if (words >= 6)
+        return 2;
+    return 1;
+}
+function detectIntent(prompt) {
+    const counts = {};
+    for (const [type, re] of Object.entries(INTENT_PATTERNS)) {
+        const matches = prompt.match(new RegExp(re.source, 'gi')) ?? [];
+        if (matches.length > 0)
+            counts[type] = matches.length;
+    }
+    const entries = Object.entries(counts).sort((a, b) => b[1] - a[1]);
+    if (entries.length === 0) {
+        return { type: 'unknown', confidence: 0, keywords: [] };
+    }
+    const [topType, topCount] = entries[0];
+    const totalMatches = Object.values(counts).reduce((s, n) => s + n, 0);
+    const confidence = Math.min(1, topCount / Math.max(totalMatches, 1) * (entries.length === 1 ? 1.5 : 1));
+    const patternRe = INTENT_PATTERNS[topType];
+    const allWords = prompt.match(new RegExp(patternRe.source, 'gi')) ?? [];
+    const keywords = [...new Set(allWords.map(w => w.toLowerCase().trim()))].slice(0, 5);
+    return { type: topType, confidence: Math.round(confidence * 100) / 100, keywords };
+}
+function detectRisks(prompt) {
+    const found = [];
+    for (const { type, severity, re, detail } of RISK_PATTERNS) {
+        if (re.test(prompt)) {
+            found.push({ type, severity, detail });
+        }
+    }
+    return found;
+}
+function findMissingInfo(prompt, intent, specificity, completeness) {
+    const missing = [];
+    if (intent.type === 'fix') {
+        if (!/error|exception|crash|fail|wrong|issue/i.test(prompt))
+            missing.push('error description or failure symptom');
+        if (!FILE_REF_RE.test(prompt))
+            missing.push('affected file or component');
+        if (!/repro|reproduce|steps|trigger|when\s+I/i.test(prompt))
+            missing.push('reproduction steps');
+    }
+    if (intent.type === 'feature') {
+        if (!FILE_REF_RE.test(prompt))
+            missing.push('target file or module to add feature to');
+        if (!/user\s+(?:can|should|will)|should\s+(?:allow|enable|support)/i.test(prompt))
+            missing.push('user-facing outcome');
+    }
+    if (intent.type === 'refactor' && !FILE_REF_RE.test(prompt)) {
+        missing.push('which file or function to refactor');
+    }
+    if (specificity < 2)
+        missing.push('file name or component reference');
+    if (completeness < 2)
+        missing.push('context about current behavior');
+    return [...new Set(missing)].slice(0, 3);
+}
+function chooseIntervention(quality, risks, calibration) {
+    if (risks.some(r => r.severity === 'block'))
+        return 'block';
+    const autonomy = calibration?.autonomy ?? 3;
+    const specificity = calibration?.specificity ?? 3;
+    if (quality.score >= 4 && risks.length === 0 && autonomy > 4)
+        return 'pass';
+    if (quality.score < 2 && specificity < 3)
+        return 'confirm_rewrite';
+    if (quality.score < 3 && quality.completeness <= 2)
+        return 'clarify_once';
+    return 'silent_enrich';
+}
+export function analyzePrompt(prompt, projectBrief, calibration) {
+    const risks = detectRisks(prompt);
+    const intent = detectIntent(prompt);
+    const specificity = scoreSpecificity(prompt);
+    const actionability = scoreActionability(prompt);
+    const safety = scoreSafety(risks);
+    const completeness = scoreCompleteness(prompt);
+    const score = Math.round(((specificity + actionability + safety + completeness) / 4) * 10) / 10;
+    const quality = { score, specificity, actionability, safety, completeness };
+    const missingInfo = findMissingInfo(prompt, intent, specificity, completeness);
+    const intervention = chooseIntervention(quality, risks, calibration);
+    return {
+        original: prompt,
+        quality,
+        intent,
+        risks,
+        missingInfo,
+        intervention,
+    };
+}
+function relevantDirtyFiles(dirtyFiles, intent) {
+    if (!Array.isArray(dirtyFiles) || dirtyFiles.length === 0)
+        return [];
+    const INTENT_HINTS = {
+        fix: /\bfix|bug|error\b/i,
+        ship: /.*/,
+        review: /.*/,
+        feature: /src\//i,
+        refactor: /src\//i,
+        test: /test|spec/i,
+        docs: /\.md$|readme/i,
+    };
+    const re = INTENT_HINTS[intent.type] ?? /src\//i;
+    return dirtyFiles.filter((f) => re.test(f)).slice(0, 4);
+}
+export function enrichPrompt(prompt, projectBrief, analysis) {
+    if (!projectBrief)
+        return prompt;
+    const lines = [prompt, ''];
+    const branch = projectBrief.branch;
+    const dirtyFiles = (projectBrief.dirtyFiles ?? []);
+    const recentCommits = (projectBrief.recentCommits ?? []);
+    const aheadOfRemote = (projectBrief.aheadOfRemote ?? 0);
+    const recentFailures = (projectBrief.recentFailures ?? []);
+    const intent = analysis.intent;
+    const uncommitted = dirtyFiles.length;
+    if (branch || uncommitted > 0) {
+        const parts = [];
+        if (branch)
+            parts.push(`${branch} branch`);
+        if (uncommitted > 0)
+            parts.push(`${uncommitted} uncommitted file${uncommitted !== 1 ? 's' : ''}`);
+        if (aheadOfRemote > 0)
+            parts.push(`${aheadOfRemote} ahead of remote`);
+        lines.push(`[Context: ${parts.join(', ')}]`);
+    }
+    const relFiles = relevantDirtyFiles(dirtyFiles, intent);
+    if (relFiles.length > 0) {
+        lines.push(`[Files: ${relFiles.join(', ')}]`);
+    }
+    if (recentCommits.length > 0 && ['fix', 'review', 'ship'].includes(intent.type)) {
+        lines.push(`[Recent: ${recentCommits[0].slice(0, 80)}]`);
+    }
+    if (recentFailures.length > 0) {
+        const related = recentFailures.find((f) => {
+            const fp = (f.prompt ?? '').toLowerCase();
+            const pp = prompt.toLowerCase();
+            const words = pp.split(/\s+/).filter(w => w.length > 3);
+            return words.some(w => fp.includes(w));
+        });
+        if (related) {
+            lines.push(`[Failures: previous attempt failed — ${(related.error ?? 'unknown error').slice(0, 80)}]`);
+        }
+    }
+    return lines.slice(0, lines.length).join('\n');
+}
+export function formatRiskWarning(risks) {
+    if (!risks || risks.length === 0)
+        return '';
+    const lines = ['⚠️  RISK DETECTED'];
+    for (const risk of risks) {
+        const icon = risk.severity === 'block' ? '🔴' : '🟡';
+        const suffix = risk.severity === 'block' ? ' (BLOCKED)' : ' (proceed with caution)';
+        lines.push(`  ${icon} ${risk.type}: ${risk.detail}${suffix}`);
+    }
+    return lines.join('\n');
+}
+export function formatQuality(analysis) {
+    const quality = analysis.quality;
+    const intent = analysis.intent;
+    const intervention = analysis.intervention;
+    const q = quality;
+    return `Quality: ${q.score}/5 (specificity:${q.specificity} action:${q.actionability} safety:${q.safety} complete:${q.completeness})\nIntent: ${intent.type} (${intent.confidence}) | Intervention: ${intervention}`;
+}
+export function suggestImprovement(analysis) {
+    const intent = analysis.intent;
+    const missingInfo = analysis.missingInfo;
+    const templates = {
+        fix: `Fix the [specific function or behavior] in [file path] — it [symptom/error], causing [impact]`,
+        feature: `Add [feature name] to [file/component] — it should [user outcome] when [condition]`,
+        refactor: `Refactor [function/module] in [file] to [desired outcome] — keep [what to preserve]`,
+        review: `Review [file or PR] for [concern] — focus on [specific area or risk]`,
+        ship: `Ship [branch/feature] — verify [test status], then merge and publish`,
+        explore: `Explain how [specific mechanism] works in [file/component]`,
+        test: `Write tests for [function/module] in [file] covering [edge cases]`,
+        docs: `Document [function or module] in [file] — cover [params, return, examples]`,
+        deploy: `Deploy [service] to [environment] — confirm [readiness checks]`,
+        unknown: `Describe what you want changed, which file it's in, and what the expected result is`,
+    };
+    const base = templates[intent.type] ?? templates.unknown;
+    const tips = missingInfo.length > 0
+        ? ` (missing: ${missingInfo.join(', ')})`
+        : '';
+    return `Try: '${base}'${tips}`;
+}
+export function getTaskTemplate(intentType) {
+    const templates = {
+        fix: {
+            needs: ['error_description', 'affected_files', 'reproduction_steps'],
+            auto_add: ['test_expectations', 'rollback_plan'],
+        },
+        feature: {
+            needs: ['feature_description', 'affected_area'],
+            auto_add: ['test_plan', 'acceptance_criteria'],
+        },
+        refactor: {
+            needs: ['target_code', 'desired_outcome'],
+            auto_add: ['test_preservation', 'scope_boundary'],
+        },
+        review: {
+            needs: ['scope'],
+            auto_add: ['recent_changes', 'risk_areas'],
+        },
+        ship: {
+            needs: ['readiness_check'],
+            auto_add: ['test_status', 'git_status', 'uncommitted_changes'],
+        },
+        explore: {
+            needs: ['topic'],
+            auto_add: ['related_files', 'recent_changes'],
+        },
+        test: {
+            needs: ['target_function', 'test_framework'],
+            auto_add: ['edge_cases', 'existing_coverage'],
+        },
+        docs: {
+            needs: ['target_module'],
+            auto_add: ['param_descriptions', 'usage_example'],
+        },
+        deploy: {
+            needs: ['target_environment', 'service_name'],
+            auto_add: ['pre_deploy_checks', 'rollback_plan'],
+        },
+        unknown: {
+            needs: ['prompt_clarification'],
+            auto_add: [],
+        },
+    };
+    return templates[intentType] ?? templates.unknown;
+}
+export function shouldBlock(analysis) {
+    const risks = analysis.risks;
+    return risks.some(r => r.severity === 'block');
+}
+export function getBlockReason(analysis) {
+    const risks = analysis.risks;
+    const blocking = risks.find(r => r.severity === 'block');
+    return blocking ? blocking.detail : null;
+}
+//# sourceMappingURL=prompt-intel.js.map

package/dist/src/prompt-intel.js.map

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

package/dist/src/provider-context.d.ts

@@ -0,0 +1,121 @@
+export interface ProviderCapabilities {
+    name: string;
+    cli: string;
+    hasNativeCompaction: boolean;
+    compactionStrategy: string;
+    contextFormat: string;
+    supportsSpecialists: boolean;
+    supportsSituationBrief: boolean;
+    maxContextTokens: number;
+    sessionStorage: string;
+    authCheck: string;
+    resumeSupport: string;
+}
+export declare function getProviderCaps(provider: string): ProviderCapabilities;
+/**
+ * Build a context block that works for any provider.
+ * Adapts format based on provider capabilities.
+ */
+export declare function buildContextBlock(provider: string, sections: Record<string, string | object | null | undefined>): string;
+export interface SurvivalState {
+    activeTask?: string;
+    provider?: string;
+    model?: string;
+    tier?: string;
+    risk?: string;
+    filesInProgress?: string[];
+    decisions?: string[];
+    warnings?: string[];
+    routingRules?: string[];
+}
+/**
+ * Build a compaction survival block tuned for the target provider.
+ */
+export declare function buildSurvivalBlock(provider: string, state: SurvivalState): string;
+export interface SessionState {
+    taskDescription?: string;
+    filesChanged?: string[];
+    testsRun?: string[];
+    decisions?: Array<{
+        provider?: string;
+        model?: string;
+    }>;
+    unresolved?: string[];
+    routingHistory?: {
+        lastProvider?: string;
+        lastModel?: string;
+        failedProviders?: string[];
+    };
+    resumeHint?: string;
+}
+export interface ProviderHandoff {
+    version: number;
+    provider: string;
+    providerCaps: string;
+    timestamp: string;
+    task: string | null;
+    progress: {
+        filesChanged: string[];
+        testsRun: string[];
+        decisions: Array<{
+            provider?: string;
+            model?: string;
+        }>;
+    };
+    unresolved: string[];
+    routing: {
+        lastProvider: string;
+        lastModel: string | null;
+        failedProviders: string[];
+    };
+    resumeHint: string | null;
+    resumeStrategy: string;
+}
+/**
+ * Generate a handoff receipt that works for both providers.
+ */
+export declare function generateProviderHandoff(sessionState: SessionState, provider: string): ProviderHandoff;
+/**
+ * Build a resume brief from the latest handoff, adapted for the resuming provider.
+ */
+export declare function buildProviderResumeBrief(cwd: string | undefined, targetProvider: string): string | null;
+/**
+ * Build a capability hint block for the target provider.
+ */
+export declare function buildCapabilityHint(provider: string, prompt: string, cwd?: string): string | null;
+export interface ContextBudget {
+    provider: string;
+    maxTokens: number;
+    usedTokens: number;
+    remainingTokens: number;
+    utilizationPct: number;
+    compactionRisk: 'critical' | 'high' | 'medium' | 'low';
+    hasNativeCompaction: boolean;
+    action: string;
+}
+/**
+ * Estimate remaining context budget for a provider.
+ */
+export declare function estimateContextBudget(provider: string, usedTokens: number): ContextBudget;
+/**
+ * Get the opposite provider for cross-review.
+ */
+export declare function getReviewProvider(workProvider: string, availableProviders?: string[]): string;
+/**
+ * Check if both providers are available for true dual-brain operation.
+ */
+export declare function isDualProviderAvailable(profile: {
+    providers?: {
+        claude?: {
+            enabled?: boolean;
+        };
+        openai?: {
+            enabled?: boolean;
+            plan?: string;
+        };
+    };
+} | null | undefined): {
+    claude: boolean;
+    openai: boolean;
+    dual: boolean;
+};