dual-brain 0.2.30 → 0.3.1

package/dist/src/agents/registry.js

@@ -0,0 +1,393 @@
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const AGENTS_DIR = __dirname;
+const SKILLS_DIR = join(AGENTS_DIR, '..', '..', 'skills');
+let _agents = null;
+let _skills = null;
+export function getAgents() {
+    if (_agents)
+        return _agents;
+    _agents = new Map();
+    // Load built-in agents
+    for (const agent of BUILT_IN_AGENTS) {
+        _agents.set(agent.id, agent);
+    }
+    // Load custom agents from .claude/agents/ if they exist
+    const customDir = join(AGENTS_DIR, '..', '..', '.claude', 'agents');
+    if (existsSync(customDir)) {
+        for (const file of readdirSync(customDir).filter(f => f.endsWith('.md'))) {
+            try {
+                const content = readFileSync(join(customDir, file), 'utf8');
+                const parsed = parseAgentMd(content);
+                if (parsed)
+                    _agents.set(parsed.id, parsed);
+            }
+            catch { }
+        }
+    }
+    return _agents;
+}
+export function getSkills() {
+    if (_skills)
+        return _skills;
+    _skills = new Map();
+    for (const skill of BUILT_IN_SKILLS) {
+        _skills.set(skill.command, skill);
+    }
+    return _skills;
+}
+export function matchAgent(intent, risk, taskType) {
+    const agents = getAgents();
+    const matches = [];
+    for (const [id, agent] of agents) {
+        let score = 0;
+        if (agent.intents && agent.intents.includes(intent))
+            score += 10;
+        if (agent.taskTypes && agent.taskTypes.some((t) => taskType.includes(t)))
+            score += 5;
+        if (agent.minRisk && riskLevel(risk) >= riskLevel(agent.minRisk))
+            score += 3;
+        if (score > 0)
+            matches.push({ ...agent, score });
+    }
+    return matches.sort((a, b) => b.score - a.score);
+}
+export function matchSkill(command) {
+    const skills = getSkills();
+    const cmd = command.replace(/^\//, '').split(' ')[0].toLowerCase();
+    return skills.get(cmd) || null;
+}
+export function skillToTaskBrief(command, args) {
+    const skill = matchSkill(command);
+    if (!skill)
+        return null;
+    return {
+        objective: skill.objective(args),
+        scope: skill.scope || [],
+        tier: skill.tier,
+        model: skill.model,
+        risk: skill.risk || 'low',
+        acceptanceCriteria: skill.acceptanceCriteria || [],
+        agentId: skill.agent,
+        cost: skill.cost,
+    };
+}
+function riskLevel(r) {
+    return { low: 1, medium: 2, high: 3, critical: 4 }[r] || 0;
+}
+function parseAgentMd(content) {
+    // Parse YAML frontmatter from .claude/agents/*.md
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return null;
+    const meta = {};
+    for (const line of match[1].split('\n')) {
+        const [key, ...rest] = line.split(':');
+        if (key && rest.length)
+            meta[key.trim()] = rest.join(':').trim();
+    }
+    return {
+        id: meta.name || 'unknown',
+        name: meta.name || 'Unknown Agent',
+        tier: meta.tier || 'execute',
+        model: meta.model || 'sonnet',
+        intents: (meta.intents || '').split(',').map((s) => s.trim()),
+        taskTypes: (meta.taskTypes || '').split(',').map((s) => s.trim()),
+        prompt: content.replace(/^---[\s\S]*?---\n/, ''),
+    };
+}
+// ── Built-in Agents ──────────────────────────────────────────────────────
+const BUILT_IN_AGENTS = [
+    {
+        id: 'reviewer',
+        name: 'Code Reviewer',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        intents: ['review', 'audit', 'check'],
+        taskTypes: ['code-review', 'pr-review', 'diff-review'],
+        contract: {
+            inputs: ['diff', 'base_branch', 'focus_areas'],
+            outputs: ['findings', 'severity', 'suggestions', 'verdict'],
+        },
+        prompt: `You are a code reviewer. Review the provided diff for: correctness, security issues, performance problems, code style, and test coverage gaps. For each finding, provide: severity (critical/high/medium/low), file and line, description, and suggested fix. Return structured JSON: { "verdict": "approve|request_changes|comment", "findings": [...], "summary": "..." }`,
+    },
+    {
+        id: 'debugger',
+        name: 'Debugger',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        intents: ['debug', 'fix', 'investigate', 'error'],
+        taskTypes: ['bug-fix', 'error-investigation', 'crash-analysis'],
+        contract: {
+            inputs: ['error_message', 'stack_trace', 'reproduction_steps', 'relevant_files'],
+            outputs: ['root_cause', 'patch', 'tests', 'confidence'],
+        },
+        prompt: `You are a debugger. Given an error, stack trace, or bug description: 1) Reproduce or trace the issue, 2) Identify root cause, 3) Implement the fix, 4) Add a regression test. Return: { "root_cause": "...", "files_changed": [...], "tests_added": [...], "confidence": "high|medium|low" }`,
+    },
+    {
+        id: 'test-writer',
+        name: 'Test Writer',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        intents: ['test', 'coverage', 'spec'],
+        taskTypes: ['test-generation', 'test-coverage', 'fixture-creation'],
+        contract: {
+            inputs: ['target_file', 'test_framework', 'existing_tests'],
+            outputs: ['test_file', 'test_count', 'coverage_areas', 'edge_cases'],
+        },
+        prompt: `You are a test writer. Given a source file, generate comprehensive tests covering: happy path, edge cases, error conditions, and boundary values. Match the existing test framework and style. Return: { "test_file": "...", "tests": [...], "edge_cases_covered": [...] }`,
+    },
+    {
+        id: 'architect',
+        name: 'Architect',
+        tier: 'think',
+        model: 'opus',
+        cost: 'full',
+        intents: ['design', 'architect', 'plan', 'structure'],
+        taskTypes: ['architecture', 'system-design', 'api-design', 'module-design'],
+        contract: {
+            inputs: ['goal', 'constraints', 'existing_architecture', 'scale_requirements'],
+            outputs: ['design', 'modules', 'interfaces', 'tradeoffs', 'risks'],
+        },
+        prompt: `You are a software architect. Design the system or module with: clear module boundaries, well-defined interfaces, explicit tradeoffs, and identified risks. Return: { "design": "...", "modules": [...], "interfaces": [...], "tradeoffs": [...], "risks": [...] }`,
+    },
+    {
+        id: 'security',
+        name: 'Security Auditor',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'full',
+        intents: ['security', 'vulnerability', 'owasp', 'secrets'],
+        taskTypes: ['security-audit', 'vulnerability-scan', 'secret-detection', 'auth-review'],
+        minRisk: 'medium',
+        contract: {
+            inputs: ['scope', 'diff', 'dependencies', 'config_files'],
+            outputs: ['vulnerabilities', 'severity', 'remediation', 'compliance'],
+        },
+        prompt: `You are a security auditor. Scan for: OWASP Top 10 vulnerabilities, hardcoded secrets, insecure dependencies, auth/authz issues, injection vectors, and data exposure. Return: { "vulnerabilities": [{ "type": "...", "severity": "critical|high|medium|low", "file": "...", "line": N, "remediation": "..." }], "clean": true/false }`,
+    },
+    {
+        id: 'refactor',
+        name: 'Refactorer',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        intents: ['refactor', 'cleanup', 'simplify', 'extract'],
+        taskTypes: ['refactoring', 'code-cleanup', 'extraction', 'rename'],
+        contract: {
+            inputs: ['target', 'goal', 'constraints', 'preserve_behavior'],
+            outputs: ['patch', 'behavior_preserved', 'tests_updated'],
+        },
+        prompt: `You are a refactoring specialist. Improve code structure while preserving behavior. Verify with existing tests. Return: { "changes": [...], "behavior_preserved": true, "tests_passing": true }`,
+    },
+    {
+        id: 'docs',
+        name: 'Documentation Writer',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        intents: ['document', 'readme', 'api-doc', 'explain'],
+        taskTypes: ['documentation', 'readme-update', 'api-docs', 'changelog'],
+        contract: {
+            inputs: ['files', 'audience', 'format', 'existing_docs'],
+            outputs: ['docs_patch', 'sections_updated'],
+        },
+        prompt: `You are a documentation writer. Generate clear, concise documentation for the specified code. Match existing doc style. Return: { "docs": "...", "sections": [...] }`,
+    },
+    {
+        id: 'researcher',
+        name: 'Research Agent',
+        tier: 'search',
+        model: 'haiku',
+        cost: 'cheap',
+        intents: ['research', 'lookup', 'find', 'search', 'explore'],
+        taskTypes: ['web-search', 'docs-lookup', 'api-exploration', 'codebase-search'],
+        contract: {
+            inputs: ['query', 'domains', 'freshness_requirement'],
+            outputs: ['sources', 'summary', 'references', 'confidence'],
+        },
+        prompt: `You are a research agent. Find accurate, current information. Cite sources. Distinguish facts from opinions. Return: { "answer": "...", "sources": [...], "confidence": "high|medium|low" }`,
+    },
+    {
+        id: 'performance',
+        name: 'Performance Optimizer',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        intents: ['optimize', 'performance', 'speed', 'profile', 'bottleneck'],
+        taskTypes: ['performance-optimization', 'profiling', 'bottleneck-detection'],
+        contract: {
+            inputs: ['hot_path', 'metrics', 'budget_ms'],
+            outputs: ['bottlenecks', 'optimizations', 'patch', 'expected_improvement'],
+        },
+        prompt: `You are a performance specialist. Profile, identify bottlenecks, and optimize. Measure before/after. Return: { "bottlenecks": [...], "optimizations": [...], "expected_speedup": "..." }`,
+    },
+    {
+        id: 'devops',
+        name: 'DevOps Engineer',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'full',
+        intents: ['deploy', 'ci', 'docker', 'infrastructure', 'pipeline'],
+        taskTypes: ['deployment', 'ci-cd', 'docker', 'infrastructure', 'monitoring'],
+        minRisk: 'medium',
+        contract: {
+            inputs: ['goal', 'environment', 'constraints', 'current_config'],
+            outputs: ['config', 'commands', 'risks', 'rollback_plan'],
+        },
+        prompt: `You are a DevOps engineer. Configure infrastructure, CI/CD, and deployment with: security best practices, rollback plans, and monitoring. Return: { "config_changes": [...], "commands": [...], "risks": [...], "rollback": "..." }`,
+    },
+];
+// ── Built-in Skills ──────────────────────────────────────────────────────
+const BUILT_IN_SKILLS = [
+    {
+        command: 'review',
+        agent: 'reviewer',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        description: 'Review current changes or a specific file',
+        objective: (args) => args ? `Review changes in ${args}` : 'Review all uncommitted changes',
+        acceptanceCriteria: ['All findings include severity and file location', 'Verdict is clear'],
+    },
+    {
+        command: 'debug',
+        agent: 'debugger',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        description: 'Investigate and fix an error',
+        objective: (args) => `Debug: ${args || 'investigate recent error'}`,
+        acceptanceCriteria: ['Root cause identified', 'Fix implemented', 'Regression test added'],
+    },
+    {
+        command: 'test',
+        agent: 'test-writer',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        description: 'Generate tests for a file',
+        objective: (args) => `Generate comprehensive tests for ${args || 'changed files'}`,
+        acceptanceCriteria: ['Tests cover happy path and edge cases', 'Tests pass'],
+    },
+    {
+        command: 'plan',
+        agent: 'architect',
+        tier: 'think',
+        model: 'opus',
+        cost: 'full',
+        description: 'Create an execution plan for a task',
+        objective: (args) => `Create execution plan: ${args || 'current task'}`,
+        acceptanceCriteria: ['Steps are concrete and ordered', 'Risks identified', 'Acceptance criteria per step'],
+    },
+    {
+        command: 'audit',
+        agent: 'security',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        description: 'Run a security, quality, or dependency audit',
+        objective: (args) => `Audit: ${args || 'security scan of current changes'}`,
+        acceptanceCriteria: ['All findings include severity', 'Remediation steps provided'],
+    },
+    {
+        command: 'fix',
+        agent: 'debugger',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        description: 'Fix a specific issue',
+        objective: (args) => `Fix: ${args}`,
+        acceptanceCriteria: ['Issue resolved', 'Tests pass', 'No regressions'],
+    },
+    {
+        command: 'explain',
+        agent: 'researcher',
+        tier: 'search',
+        model: 'haiku',
+        cost: 'cheap',
+        description: 'Explain how code works',
+        objective: (args) => `Explain: ${args || 'current file'}`,
+    },
+    {
+        command: 'refactor',
+        agent: 'refactor',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        description: 'Refactor code for clarity or performance',
+        objective: (args) => `Refactor: ${args || 'current file'}`,
+        acceptanceCriteria: ['Behavior preserved', 'Tests still pass'],
+    },
+    {
+        command: 'doc',
+        agent: 'docs',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        description: 'Generate or update documentation',
+        objective: (args) => `Document: ${args || 'changed files'}`,
+    },
+    {
+        command: 'brainstorm',
+        agent: 'architect',
+        tier: 'think',
+        model: 'sonnet',
+        cost: 'cheap',
+        description: 'Generate ideas and explore options',
+        objective: (args) => `Brainstorm: ${args || 'current challenge'}`,
+    },
+    {
+        command: 'search',
+        agent: 'researcher',
+        tier: 'search',
+        model: 'haiku',
+        cost: 'cheap',
+        description: 'Search web, docs, or codebase',
+        objective: (args) => `Search: ${args}`,
+    },
+    {
+        command: 'status',
+        agent: null, // deterministic, no agent needed
+        tier: 'free',
+        cost: 'free',
+        description: 'Show system health and status',
+        objective: () => 'Display system status',
+    },
+    {
+        command: 'deploy',
+        agent: 'devops',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'full',
+        risk: 'high',
+        description: 'Run deployment workflow',
+        objective: (args) => `Deploy: ${args || 'production'}`,
+        acceptanceCriteria: ['Deployment successful', 'Health check passes', 'Rollback plan documented'],
+    },
+    {
+        command: 'perf',
+        agent: 'performance',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        description: 'Profile and optimize performance',
+        objective: (args) => `Optimize performance: ${args || 'hot paths'}`,
+    },
+    {
+        command: 'release',
+        agent: 'docs',
+        tier: 'execute',
+        model: 'sonnet',
+        cost: 'cheap',
+        description: 'Generate changelog and release checklist',
+        objective: (args) => `Prepare release: ${args || 'current version'}`,
+        acceptanceCriteria: ['Changelog generated', 'Version bumped', 'Doctor passes'],
+    },
+];
+//# sourceMappingURL=registry.js.map

package/dist/src/agents/registry.js.map

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

package/dist/src/awareness.d.ts

@@ -0,0 +1,93 @@
+/**
+ * awareness.ts — Environment awareness layer for dual-brain.
+ * Scans runtime environment once on startup and caches results with TTL.
+ */
+interface ToolInfo {
+    available: boolean;
+    version?: string | null;
+}
+interface ContainerInfo {
+    type: string;
+    hostname: string;
+    nodeVersion: string;
+    platform: string;
+    arch: string;
+}
+interface ReplitToolsInfo {
+    installed: boolean;
+    version: string | null;
+    sessionArchivePath: string | null;
+    capabilities: string[];
+}
+interface ReplitInfo {
+    isReplit: boolean;
+    replId: string | null;
+    replSlug: string | null;
+    hasDatabase: boolean;
+    hasKV: boolean;
+    hasObjectStorage: boolean;
+    hasAuth: boolean;
+    hasDeployments: boolean;
+}
+interface ClaudeCodeInfo {
+    isInsideClaude: boolean;
+    hooksDir: string | null;
+    mcpConfigured: boolean;
+    settingsPath: string | null;
+}
+interface DualBrainInfo {
+    version: string;
+    livingDocsInit: boolean;
+    sessionCount: number;
+    hasLedger: boolean;
+    hasFailureMemory: boolean;
+}
+export interface EnvironmentReport {
+    scannedAt: number;
+    ttl: number;
+    container: ContainerInfo;
+    tools: Record<string, ToolInfo>;
+    secrets: Record<string, boolean>;
+    replitTools: ReplitToolsInfo;
+    replit: ReplitInfo;
+    claudeCode: ClaudeCodeInfo;
+    dualBrain: DualBrainInfo;
+}
+interface ScanOptions {
+    ttl?: number;
+    force?: boolean;
+}
+interface AmbiguityResult {
+    isAmbiguous: boolean;
+    reason: string | null;
+}
+interface AmbiguousResult {
+    ambiguous: boolean;
+    reason: string | null;
+    confidence: number;
+}
+export declare function scanEnvironment(cwd: string | undefined, options?: ScanOptions): EnvironmentReport;
+export declare function formatEnvironment(report: EnvironmentReport): string;
+export declare function getCapabilitySummary(report: EnvironmentReport): string[];
+export declare function invalidateCache(): void;
+/**
+ * Detect whether a prompt is ambiguous and needs clarification before dispatch.
+ *
+ * A prompt is considered ambiguous when ALL of the following are true:
+ *   1. It is very short (under 4 words)
+ *   2. No file context is provided
+ *   3. It lacks specific technical terms that narrow the intent
+ */
+export declare function detectAmbiguity(prompt: unknown, context?: {
+    files?: string[];
+}): AmbiguityResult;
+/**
+ * Detect whether a user prompt is too vague to act on confidently.
+ *
+ * Checks for:
+ *   - Very short prompts (under 10 chars)
+ *   - No file paths, function names, or specific identifiers
+ *   - Pronoun-only references without antecedents ("fix that thing", "change it")
+ */
+export declare function isAmbiguous(prompt: unknown): AmbiguousResult;
+export {};