dual-brain 0.2.30 → 0.3.1

package/src/awareness.mjs

@@ -1,425 +0,0 @@
-/**
- * awareness.mjs — Environment awareness layer for dual-brain.
- * Scans runtime environment once on startup and caches results with TTL.
- */
-
-import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
-import { execSync } from 'node:child_process';
-import { join, resolve } from 'node:path';
-import { homedir } from 'node:os';
-
-let _cache = null;
-let _cacheTime = 0;
-
-function safeExec(cmd, timeoutMs = 2000) {
-  try {
-    return execSync(cmd, {
-      encoding: 'utf8',
-      stdio: ['ignore', 'pipe', 'ignore'],
-      timeout: timeoutMs,
-    }).trim();
-  } catch {
-    return null;
-  }
-}
-
-function extractVersion(output) {
-  if (!output) return null;
-  const m = output.match(/(\d+\.\d+[\.\d]*)/);
-  return m ? m[1] : null;
-}
-
-function probeToolAvailability(name) {
-  const path = safeExec(`which ${name}`);
-  if (!path) return { available: false, version: null };
-  if (name === 'rg' || name === 'replit' || name === 'gh') {
-    return { available: true };
-  }
-  const versionOutput = safeExec(`${name} --version`);
-  return { available: true, version: extractVersion(versionOutput) };
-}
-
-function detectContainerType() {
-  const env = process.env;
-  if (env.REPL_ID || env.REPL_SLUG) return 'replit';
-  if (env.CODESPACES) return 'codespace';
-  if (env.CI || env.GITHUB_ACTIONS || env.GITLAB_CI || env.JENKINS_URL) return 'ci';
-  return 'local';
-}
-
-function scanSecrets() {
-  const keys = [
-    'NPM_TOKEN',
-    'DATABASE_URL',
-    'GITHUB_TOKEN',
-    'REPLIT_DB_URL',
-  ];
-  const result = {};
-  for (const key of keys) {
-    result[key] = Boolean(process.env[key]);
-  }
-  return result;
-}
-
-function scanReplitTools() {
-  const home = homedir();
-  const candidates = [
-    join(home, '.replit-tools'),
-    join('/home/runner/workspace', '.replit-tools'),
-    join(process.cwd(), '.replit-tools'),
-  ];
-
-  let toolsDir = null;
-  for (const c of candidates) {
-    if (existsSync(c)) {
-      toolsDir = c;
-      break;
-    }
-  }
-
-  if (!toolsDir) {
-    return { installed: false, version: null, sessionArchivePath: null, capabilities: [] };
-  }
-
-  let version = null;
-  const versionFile = join(toolsDir, '.version');
-  if (existsSync(versionFile)) {
-    try { version = readFileSync(versionFile, 'utf8').trim() || null; } catch { /* skip */ }
-  }
-
-  const persistentBase = join(toolsDir, '.claude-persistent');
-  const projectDir = join(persistentBase, 'projects');
-  let sessionArchivePath = null;
-  if (existsSync(projectDir)) {
-    sessionArchivePath = projectDir;
-  } else if (existsSync(persistentBase)) {
-    sessionArchivePath = persistentBase;
-  }
-
-  const capabilities = [];
-  if (existsSync(join(toolsDir, '.claude-persistent'))) capabilities.push('sessions');
-  const hasSearch = existsSync(join(toolsDir, 'search')) || existsSync(join(toolsDir, 'search.mjs'));
-  if (hasSearch) capabilities.push('search');
-  const hasContext = existsSync(join(toolsDir, 'context')) || existsSync(join(toolsDir, 'context.mjs'));
-  if (hasContext) capabilities.push('context');
-  const hasMcp = existsSync(join(toolsDir, 'mcp-server')) || existsSync(join(toolsDir, 'mcp'));
-  if (hasMcp) capabilities.push('mcp');
-
-  return { installed: true, version, sessionArchivePath, capabilities };
-}
-
-/**
- * Basic Replit environment scan used for the awareness report.
- *
- * NOTE: Detailed Replit integration (auth status, replit-tools capabilities,
- * session archive, secrets listing, config planning, init flow) lives in
- * src/replit.mjs. When that module is available, prefer its
- * detectReplitEnvironment() over duplicating detection logic here.
- *
- * Usage (fail-safe):
- *   try {
- *     const { detectReplitEnvironment } = await import('./replit.mjs');
- *     const rich = detectReplitEnvironment(cwd);
- *     // rich has .isReplit, .replId, .version, .authStatus, .capabilities …
- *   } catch {
- *     // fall back to this scanReplit() result from scanEnvironment()
- *   }
- */
-function scanReplit(cwd) {
-  const env = process.env;
-  const isReplit = Boolean(env.REPL_ID || env.REPL_SLUG);
-
-  let hasDeployments = false;
-  const replitConfigPath = join(cwd, '.replit');
-  if (existsSync(replitConfigPath)) {
-    try {
-      const content = readFileSync(replitConfigPath, 'utf8');
-      hasDeployments = content.includes('[deployment]');
-    } catch { /* skip */ }
-  }
-
-  return {
-    isReplit,
-    replId: env.REPL_ID || null,
-    replSlug: env.REPL_SLUG || null,
-    hasDatabase: Boolean(env.DATABASE_URL),
-    hasKV: Boolean(env.REPLIT_DB_URL),
-    hasObjectStorage: Boolean(env.REPLIT_BUCKET_URL || env.OBJECT_STORAGE_URL),
-    hasAuth: existsSync(join(cwd, '.replit-auth')) || Boolean(env.REPLIT_AUTH),
-    hasDeployments,
-  };
-}
-
-function scanClaudeCode(cwd) {
-  const claudeDir = join(cwd, '.claude');
-  const homeClaudeDir = join(homedir(), '.claude');
-  const isInsideClaude = Boolean(
-    process.env.CLAUDE_CODE || process.env.CLAUDE_AGENT || process.env.ANTHROPIC_CLAUDE_CODE
-  );
-
-  let hooksDir = null;
-  const localHooks = join(claudeDir, 'hooks');
-  const rootHooks = join(cwd, 'hooks');
-  if (existsSync(localHooks)) {
-    hooksDir = localHooks;
-  } else if (existsSync(rootHooks)) {
-    hooksDir = rootHooks;
-  }
-
-  let mcpConfigured = false;
-  const mcpPaths = [
-    join(claudeDir, 'mcp.json'),
-    join(claudeDir, 'mcp_servers.json'),
-    join(homeClaudeDir, 'mcp.json'),
-  ];
-  for (const p of mcpPaths) {
-    if (existsSync(p)) { mcpConfigured = true; break; }
-  }
-
-  let settingsPath = null;
-  const settingsCandidates = [
-    join(claudeDir, 'settings.json'),
-    join(homeClaudeDir, 'settings.json'),
-  ];
-  for (const p of settingsCandidates) {
-    if (existsSync(p)) { settingsPath = p; break; }
-  }
-
-  return { isInsideClaude, hooksDir, mcpConfigured, settingsPath };
-}
-
-function scanDualBrain(cwd) {
-  let version = '0.0.0';
-  try {
-    const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf8'));
-    version = pkg.version ?? '0.0.0';
-  } catch { /* skip */ }
-
-  const livingDocsDir = join(cwd, '.dual-brain');
-  const livingDocsInit = existsSync(livingDocsDir);
-
-  let sessionCount = 0;
-  const sessionDir = join(cwd, '.dualbrain', 'sessions');
-  if (existsSync(sessionDir)) {
-    try {
-      sessionCount = readdirSync(sessionDir).filter(f => f.endsWith('.jsonl')).length;
-    } catch { /* skip */ }
-  }
-
-  const hasLedger = existsSync(join(cwd, '.dualbrain', 'ledger.jsonl'));
-  const hasFailureMemory = existsSync(join(cwd, '.dualbrain', 'failures.jsonl'));
-
-  return { version, livingDocsInit, sessionCount, hasLedger, hasFailureMemory };
-}
-
-export function scanEnvironment(cwd, options = {}) {
-  const ttl = options.ttl ?? 300000;
-  if (_cache && Date.now() - _cacheTime < ttl && !options.force) return _cache;
-
-  const resolvedCwd = resolve(cwd || process.cwd());
-
-  const container = {
-    type: detectContainerType(),
-    hostname: process.env.HOSTNAME || process.env.REPL_ID || 'unknown',
-    nodeVersion: process.version,
-    platform: process.platform,
-    arch: process.arch,
-  };
-
-  const toolNames = ['git', 'node', 'npm', 'codex', 'claude'];
-  const flagOnlyTools = ['rg', 'replit', 'gh'];
-  const tools = {};
-
-  for (const name of toolNames) {
-    tools[name] = probeToolAvailability(name);
-  }
-  for (const name of flagOnlyTools) {
-    const path = safeExec(`which ${name}`);
-    tools[name] = { available: Boolean(path) };
-  }
-
-  const secrets = scanSecrets();
-  const replitTools = scanReplitTools();
-  const replit = scanReplit(resolvedCwd);
-  const claudeCode = scanClaudeCode(resolvedCwd);
-  const dualBrain = scanDualBrain(resolvedCwd);
-
-  const report = {
-    scannedAt: Date.now(),
-    ttl,
-    container,
-    tools,
-    secrets,
-    replitTools,
-    replit,
-    claudeCode,
-    dualBrain,
-  };
-
-  _cache = report;
-  _cacheTime = Date.now();
-  return report;
-}
-
-export function formatEnvironment(report) {
-  const { container, tools, secrets, replitTools, replit, dualBrain } = report;
-
-  const nodeShort = container.nodeVersion.replace(/^v/, '').split('.')[0];
-  const containerLabel = container.type === 'replit'
-    ? 'Replit'
-    : container.type.charAt(0).toUpperCase() + container.type.slice(1);
-
-  const lines = [];
-
-  lines.push(`Environment: ${containerLabel} (node ${nodeShort}.x)`);
-
-  const toolEntries = [];
-  for (const [name, info] of Object.entries(tools)) {
-    if (info.available) toolEntries.push(`${name} ✓`);
-  }
-  if (toolEntries.length) lines.push(`Tools: ${toolEntries.join('  ')}`);
-
-  const secretMap = {
-    NPM_TOKEN: 'npm',
-    GITHUB_TOKEN: 'GitHub',
-    DATABASE_URL: 'PostgreSQL',
-    REPLIT_DB_URL: 'KV',
-  };
-  const secretEntries = [];
-  for (const [key, label] of Object.entries(secretMap)) {
-    if (secrets[key]) secretEntries.push(`${label} ✓`);
-  }
-  if (secretEntries.length) lines.push(`Secrets: ${secretEntries.join('  ')}`);
-
-  const platformParts = [];
-  if (replit.hasDatabase) platformParts.push('PostgreSQL ✓');
-  if (replit.hasKV) platformParts.push('KV ✓');
-  if (replit.hasObjectStorage) platformParts.push('ObjectStorage ✓');
-  if (replit.hasAuth) platformParts.push('Auth ✓');
-  if (replit.hasDeployments) platformParts.push('Deployments ✓');
-  if (platformParts.length) lines.push(`Platform: ${platformParts.join('  ')}`);
-
-  if (replitTools.installed) {
-    const ver = replitTools.version ? `v${replitTools.version}` : 'installed';
-    const caps = replitTools.capabilities.join(', ');
-    lines.push(`replit-tools: ${ver}${caps ? ` (${caps})` : ''}`);
-  }
-
-  const dbFlag = dualBrain.hasLedger ? ', ledger ✓' : '';
-  const docsFlag = dualBrain.livingDocsInit ? 'living docs ✓' : 'living docs ✗';
-  lines.push(`dual-brain: v${dualBrain.version} (${docsFlag}${dbFlag})`);
-
-  return lines.join('\n');
-}
-
-export function getCapabilitySummary(report) {
-  const caps = [];
-
-  if (report.container.type !== 'unknown') {
-    caps.push(`${report.container.type}-container`);
-  }
-
-  if (report.replit.hasDatabase) caps.push('postgresql');
-  if (report.replit.hasKV) caps.push('replit-kv');
-  if (report.replit.hasObjectStorage) caps.push('object-storage');
-  if (report.replit.hasAuth) caps.push('replit-auth');
-  if (report.replit.hasDeployments) caps.push('replit-deployments');
-
-  if (report.tools.codex?.available) caps.push('codex-cli');
-  if (report.tools.claude?.available) caps.push('claude-cli');
-  if (report.tools.git?.available) caps.push('git');
-  if (report.tools.gh?.available) caps.push('github-cli');
-  if (report.tools.rg?.available) caps.push('ripgrep');
-
-
-  if (report.replitTools.installed) {
-    for (const c of report.replitTools.capabilities) {
-      caps.push(`replit-tools-${c}`);
-    }
-  }
-
-  if (report.claudeCode.mcpConfigured) caps.push('mcp-configured');
-  if (report.claudeCode.hooksDir) caps.push('claude-hooks');
-
-  if (report.dualBrain.hasLedger) caps.push('dual-brain-ledger');
-  if (report.dualBrain.hasFailureMemory) caps.push('dual-brain-failure-memory');
-  if (report.dualBrain.livingDocsInit) caps.push('dual-brain-living-docs');
-
-  return caps;
-}
-
-export function invalidateCache() {
-  _cache = null;
-  _cacheTime = 0;
-}
-
-// ─── Ambiguity Detection ──────────────────────────────────────────────────────
-
-const TECHNICAL_TERMS = /\b(fix|bug|error|test|deploy|refactor|import|export|function|class|module|api|endpoint|auth|token|database|query|schema|migration|build|lint|type|interface|component|route|handler|middleware|config|env|secret|key|file|path|directory|repo|branch|commit|merge|pull|push|install|upgrade|package|dependency|version|release|publish|log|trace|debug|stack|exception|undefined|null|async|await|promise|fetch|request|response|status|server|client|socket|cache|session)\b/i;
-
-/**
- * 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
- *
- * @param {string} prompt — the user's raw prompt
- * @param {{ files?: string[] }} [context] — optional context (e.g. file paths)
- * @returns {{ isAmbiguous: boolean, reason: string|null }}
- */
-export function detectAmbiguity(prompt, context = {}) {
-  if (!prompt || typeof prompt !== 'string') {
-    return { isAmbiguous: true, reason: 'missing context: empty prompt' };
-  }
-
-  const words = prompt.trim().split(/\s+/).filter(Boolean);
-  const isTooShort = words.length < 4;
-  const hasFileContext = Array.isArray(context?.files) && context.files.length > 0;
-  const hasTechnicalTerms = TECHNICAL_TERMS.test(prompt);
-
-  if (isTooShort && !hasFileContext && !hasTechnicalTerms) {
-    return {
-      isAmbiguous: true,
-      reason: `unclear: prompt is vague ("${prompt.trim()}") — missing context about what to change and where`,
-    };
-  }
-
-  return { isAmbiguous: false, reason: null };
-}
-
-/**
- * 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")
- *
- * @param {string} prompt — the user's raw prompt
- * @returns {{ ambiguous: boolean, reason: string|null, confidence: number }}
- */
-export function isAmbiguous(prompt) {
-  if (!prompt || typeof prompt !== 'string') return { ambiguous: true, reason: 'empty-prompt', confidence: 1.0 };
-
-  const trimmed = prompt.trim();
-  if (trimmed.length < 10) return { ambiguous: true, reason: 'too-short', confidence: 0.9 };
-
-  // Check for file paths, function names, specific identifiers
-  const hasSpecifics = /[a-zA-Z_]\w*\.(mjs|js|ts|tsx|jsx|py|go|rs|java|rb|css|html|json|yaml|yml|md|sh)/.test(trimmed)
-    || /[a-zA-Z_]\w*\(\)/.test(trimmed)  // function calls
-    || /`[^`]+`/.test(trimmed)            // backtick-quoted identifiers
-    || /"[^"]{3,}"/.test(trimmed)         // quoted strings
-    || /\b(line|function|class|method|variable|module|component|endpoint|route|table|column)\s+\w+/i.test(trimmed);
-
-  // Vague pronoun patterns
-  const vaguePatterns = /^(fix|change|update|do|make|help|look at|check)\s+(this|that|it|the thing|stuff|things?)$/i;
-  if (vaguePatterns.test(trimmed)) return { ambiguous: true, reason: 'vague-reference', confidence: 0.85 };
-
-  if (!hasSpecifics && trimmed.split(/\s+/).length < 5) {
-    return { ambiguous: true, reason: 'lacks-specifics', confidence: 0.7 };
-  }
-
-  return { ambiguous: false, reason: null, confidence: 0.1 };
-}

package/src/brief.mjs

@@ -1,266 +0,0 @@
-#!/usr/bin/env node
-/**
- * brief.mjs — Delegation brief generator for the Dual-Brain Orchestrator HEAD.
- *
- * Generates typed delegation prompts from role-based templates. The HEAD's
- * primary skill is writing great agent briefs. Pure string construction —
- * no imports from sibling modules.
- *
- * Exports: generateBrief, compressPriorResults, listRoles
- */
-
-// ─── Brief templates (role-based) ────────────────────────────────────────────
-
-const TEMPLATES = {
-  researcher: {
-    prefix:       'You are a code researcher. READ ONLY — do NOT edit any files.',
-    outputFormat: 'Return: { findings: string, files: string[], lineRefs: string[], confidence: "high"|"medium"|"low" }',
-    constraints:  'Max 50 lines of quoted code. Focus on structure and relationships, not implementation details.',
-  },
-  implementer: {
-    prefix:       'You are a code implementer. Edit ONLY files in your ownership list.',
-    outputFormat: 'Return: { filesChanged: string[], testsRun: string[], decisions: string[], risks: string[] }',
-    constraints:  'Run tests after changes. Make minimal edits. Do not refactor beyond scope.',
-  },
-  reviewer: {
-    prefix:       'You are a code reviewer. READ ONLY — do NOT edit any files.',
-    outputFormat: 'Return: { issues: { severity: string, file: string, line: number, description: string }[], approved: boolean, risks: string[] }',
-    constraints:  'Focus on correctness, security, and behavior preservation. Ignore style.',
-  },
-  verifier: {
-    prefix:       'You are a test verifier. Run the test suite and report results.',
-    outputFormat: 'Return: { passed: boolean, failCount: number, failures: string[], rootCause: string | null }',
-    constraints:  'If tests fail, identify root cause but DO NOT fix. Report only.',
-  },
-};
-
-// ─── Exported: listRoles ──────────────────────────────────────────────────────
-
-/**
- * Return available role names and their short descriptions.
- * @returns {{ role: string, description: string }[]}
- */
-export function listRoles() {
-  return [
-    { role: 'researcher',  description: 'Read-only exploration and mapping. Returns findings, file refs, and confidence.' },
-    { role: 'implementer', description: 'Makes edits within ownership scope. Returns changed files, test results, and decisions.' },
-    { role: 'reviewer',    description: 'Read-only code review. Returns issues by severity and an approval verdict.' },
-    { role: 'verifier',    description: 'Runs the test suite and identifies failures. Does not fix anything.' },
-  ];
-}
-
-// ─── Exported: compressPriorResults ──────────────────────────────────────────
-
-/**
- * Take an array of prior wave results and return a compact string suitable for
- * injection into agent briefs. Strips code blocks, keeps decisions and file paths.
- *
- * @param {Array<{ stepId?: string, taskId?: string, summary?: string, output?: string, filesChanged?: string[], decisions?: string[], findings?: string }>} results
- * @returns {string}
- */
-export function compressPriorResults(results) {
-  if (!results || results.length === 0) return '';
-
-  const lines = [];
-  for (const r of results) {
-    const id = r.stepId ?? r.taskId ?? '?';
-    const parts = [];
-
-    // Extract summary or findings
-    const rawSummary = r.summary ?? r.findings ?? r.output ?? '';
-    if (rawSummary) {
-      // Strip code blocks
-      const cleaned = String(rawSummary)
-        .replace(/```[\s\S]*?```/g, '[code block]')
-        .replace(/`[^`]+`/g, (m) => m.replace(/\n/g, ' '))
-        .replace(/\n{3,}/g, '\n\n')
-        .trim();
-      // Keep only first 200 chars of text
-      const snippet = cleaned.length > 200 ? cleaned.slice(0, 197) + '...' : cleaned;
-      if (snippet) parts.push(snippet);
-    }
-
-    // Append file lists compactly
-    if (Array.isArray(r.filesChanged) && r.filesChanged.length > 0) {
-      parts.push(`files: ${r.filesChanged.join(', ')}`);
-    }
-
-    // Append key decisions
-    if (Array.isArray(r.decisions) && r.decisions.length > 0) {
-      parts.push(`decisions: ${r.decisions.slice(0, 3).join('; ')}`);
-    }
-
-    if (parts.length > 0) {
-      lines.push(`[${id}] ${parts.join(' | ')}`);
-    }
-  }
-
-  return lines.join('\n');
-}
-
-// ─── Section builders ─────────────────────────────────────────────────────────
-
-function buildOwnershipSection(owns) {
-  if (!owns || owns.length === 0) return null;
-  return `File ownership (ONLY edit these):\n  ${owns.join('\n  ')}`;
-}
-
-function buildPriorResultsSection(priorResults) {
-  const compressed = compressPriorResults(priorResults);
-  if (!compressed) return null;
-  return `Prior wave results (context only — do not repeat this work):\n${compressed}`;
-}
-
-function buildAcceptanceCriteria(task) {
-  const lines = [];
-
-  if (task.role === 'researcher') {
-    lines.push('- Return a structured findings object with file paths and line references');
-    lines.push('- Report confidence level based on coverage of the codebase you explored');
-  } else if (task.role === 'implementer') {
-    lines.push('- All edits must stay within the ownership list above');
-    lines.push('- Run existing tests; report any failures');
-    lines.push('- Document decisions made during implementation');
-  } else if (task.role === 'reviewer') {
-    lines.push('- Report every issue with severity (critical / high / medium / low)');
-    lines.push('- Provide a clear approved: true/false verdict');
-    lines.push('- Do not edit any files');
-  } else if (task.role === 'verifier') {
-    lines.push('- Run the full test suite');
-    lines.push('- If tests fail, identify root cause but do NOT fix');
-    lines.push('- Return pass/fail with failure details');
-  }
-
-  if (task.consensus) {
-    lines.push('- This task requires dual-brain consensus — be thorough and explicit in your reasoning');
-  }
-
-  return lines.length > 0 ? `Acceptance criteria:\n${lines.join('\n')}` : null;
-}
-
-// ─── Exported: generateBrief ──────────────────────────────────────────────────
-
-/**
- * Generate a full delegation prompt for a single agent task.
- *
- * @param {{
- *   id: string,
- *   title: string,
- *   goal: string,
- *   tier: string,
- *   role: 'researcher'|'implementer'|'reviewer'|'verifier',
- *   owns: string[],
- *   consensus: boolean,
- *   risk: string,
- * }} task — from decompose output
- * @param {{
- *   prompt?: string,
- *   priorResults?: object[],
- *   repo?: { projectType?: string, branch?: string, testCmd?: string, lintCmd?: string },
- *   cwd?: string,
- * }} [context]
- * @returns {string}  Full delegation prompt string
- */
-export function generateBrief(task, context = {}) {
-  const { prompt = '', priorResults = [], repo = {} } = context;
-  const role = task.role ?? 'implementer';
-  const template = TEMPLATES[role] ?? TEMPLATES.implementer;
-
-  const sections = [];
-
-  // 1. Role header
-  sections.push(template.prefix);
-  sections.push('');
-
-  // 2. Task identity
-  sections.push(`Task: ${task.title}`);
-  if (task.id) sections.push(`Task ID: ${task.id}`);
-  if (task.tier) sections.push(`Tier: ${task.tier}`);
-  sections.push('');
-
-  // 3. Goal
-  sections.push(`Goal:\n${task.goal}`);
-  sections.push('');
-
-  // 4. Original user request (for context)
-  if (prompt && prompt !== task.goal) {
-    const snippet = prompt.length > 300 ? prompt.slice(0, 297) + '...' : prompt;
-    sections.push(`Original request (for context):\n${snippet}`);
-    sections.push('');
-  }
-
-  // 5. File ownership
-  const ownershipSection = buildOwnershipSection(task.owns);
-  if (ownershipSection) {
-    sections.push(ownershipSection);
-    sections.push('');
-  }
-
-  // 6. Repository context (if available)
-  const repoLines = [];
-  if (repo.projectType) repoLines.push(`Project type: ${repo.projectType}`);
-  if (repo.branch)      repoLines.push(`Branch: ${repo.branch}`);
-  if (repo.testCmd)     repoLines.push(`Test command: ${repo.testCmd}`);
-  if (repo.lintCmd)     repoLines.push(`Lint command: ${repo.lintCmd}`);
-  if (repoLines.length > 0) {
-    sections.push(`Repository context:\n  ${repoLines.join('\n  ')}`);
-    sections.push('');
-  }
-
-  // 7. Prior results
-  const priorSection = buildPriorResultsSection(priorResults);
-  if (priorSection) {
-    sections.push(priorSection);
-    sections.push('');
-  }
-
-  // 8. Acceptance criteria
-  const criteriaSection = buildAcceptanceCriteria(task);
-  if (criteriaSection) {
-    sections.push(criteriaSection);
-    sections.push('');
-  }
-
-  // 9. Constraints
-  sections.push(`Constraints:\n${template.constraints}`);
-  sections.push('');
-
-  // 10. Output format requirement
-  sections.push(`Required output format:\n${template.outputFormat}`);
-
-  return sections.join('\n').trimEnd();
-}
-
-// ─── CLI ──────────────────────────────────────────────────────────────────────
-
-if (process.argv[1] && new URL(import.meta.url).pathname === process.argv[1]) {
-  const args = process.argv.slice(2);
-  const cmd = args[0];
-
-  if (cmd === 'roles') {
-    console.log(JSON.stringify(listRoles(), null, 2));
-    process.exit(0);
-  }
-
-  if (cmd === 'generate') {
-    const role = args[1] ?? 'implementer';
-    const goal = args[2] ?? 'No goal provided.';
-    const task = {
-      id:        'task-1',
-      title:     goal.slice(0, 60),
-      goal,
-      tier:      'execute',
-      role,
-      owns:      [],
-      consensus: false,
-      risk:      'medium',
-    };
-    console.log(generateBrief(task, { prompt: goal }));
-    process.exit(0);
-  }
-
-  console.error('Usage:');
-  console.error('  node src/brief.mjs roles');
-  console.error('  node src/brief.mjs generate <role> "<goal>"');
-  process.exit(1);
-}