dual-brain 0.2.30 → 0.3.0

package/src/playbook.mjs

@@ -1,257 +0,0 @@
-#!/usr/bin/env node
-/**
- * playbook.mjs — Playbook loader and executor for the Dual-Brain Orchestrator.
- *
- * Exports:
- *   loadPlaybook(intent, cwd)           → playbook object | null
- *   listPlaybooks(cwd)                  → [{ name, source, stepCount }]
- *   executePlaybook(playbook, context)  → { steps, summary, runId }
- *   createRunArtifact(runId, results, cwd) → artifact path
- */
-
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join, dirname, basename } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { randomUUID } from 'node:crypto';
-
-import { loadProfile } from './profile.mjs';
-import { decideRoute, shouldDualBrain } from './decide.mjs';
-import { dispatch, dispatchDualBrain } from './dispatch.mjs';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const BUILTIN_DIR = join(__dirname, '..', 'playbooks');
-const GLOBAL_DIR  = join(homedir(), '.config', 'dual-brain', 'playbooks');
-
-// ─── Playbook resolution helpers ─────────────────────────────────────────────
-
-function projectDir(cwd) {
-  return join(cwd || process.cwd(), '.dualbrain', 'playbooks');
-}
-
-function readJson(path) {
-  try { return JSON.parse(readFileSync(path, 'utf8')); } catch { return null; }
-}
-
-function playbookPath(dir, intent) {
-  return join(dir, `${intent}.json`);
-}
-
-// ─── Exported: loadPlaybook ───────────────────────────────────────────────────
-
-/**
- * Find and return a playbook matching the given intent.
- * Search order: project-local → global user → built-in.
- * Returns null if no match found.
- * @param {string} intent
- * @param {string} [cwd]
- * @returns {object|null}
- */
-export function loadPlaybook(intent, cwd) {
-  if (!intent) return null;
-
-  const candidates = [
-    { dir: projectDir(cwd), source: 'project' },
-    { dir: GLOBAL_DIR,      source: 'global'  },
-    { dir: BUILTIN_DIR,     source: 'builtin' },
-  ];
-
-  for (const { dir, source } of candidates) {
-    const path = playbookPath(dir, intent);
-    if (existsSync(path)) {
-      const pb = readJson(path);
-      if (pb) return { ...pb, _source: source, _path: path };
-    }
-  }
-
-  return null;
-}
-
-// ─── Exported: listPlaybooks ──────────────────────────────────────────────────
-
-/**
- * Return all available playbooks across all sources, deduped (project wins).
- * @param {string} [cwd]
- * @returns {{ name: string, source: string, stepCount: number }[]}
- */
-export function listPlaybooks(cwd) {
-  const seen = new Map(); // name → entry (first write wins: project > global > builtin)
-
-  const sources = [
-    { dir: projectDir(cwd), source: 'project' },
-    { dir: GLOBAL_DIR,      source: 'global'  },
-    { dir: BUILTIN_DIR,     source: 'builtin' },
-  ];
-
-  for (const { dir, source } of sources) {
-    if (!existsSync(dir)) continue;
-    let files;
-    try { files = readdirSync(dir); } catch { continue; }
-
-    for (const file of files) {
-      if (!file.endsWith('.json')) continue;
-      const name = basename(file, '.json');
-      if (seen.has(name)) continue; // project-local already registered
-      const pb = readJson(join(dir, file));
-      if (!pb) continue;
-      seen.set(name, {
-        name: pb.name ?? name,
-        source,
-        stepCount: Array.isArray(pb.steps) ? pb.steps.length : 0,
-      });
-    }
-  }
-
-  return [...seen.values()];
-}
-
-// ─── Exported: createRunArtifact ─────────────────────────────────────────────
-
-/**
- * Persist a run manifest under .dualbrain/runs/<runId>/manifest.json.
- * @param {string} runId
- * @param {object[]} results  — step result objects
- * @param {string} [cwd]
- * @returns {string} path to the manifest file
- */
-export function createRunArtifact(runId, results, cwd) {
-  const dir = join(cwd || process.cwd(), '.dualbrain', 'runs', runId);
-  mkdirSync(dir, { recursive: true });
-  const path = join(dir, 'manifest.json');
-  const manifest = {
-    runId,
-    createdAt: new Date().toISOString(),
-    stepCount: results.length,
-    steps: results,
-  };
-  writeFileSync(path, JSON.stringify(manifest, null, 2));
-  return path;
-}
-
-// ─── Step prompt builder ──────────────────────────────────────────────────────
-
-function buildStepPrompt(step, priorOutputs, basePrompt) {
-  const parts = [];
-
-  if (basePrompt) parts.push(`Context: ${basePrompt}`);
-
-  if (priorOutputs.length > 0) {
-    parts.push('Prior step results:');
-    for (const prior of priorOutputs) {
-      parts.push(`  [${prior.stepId}] ${prior.summary ?? '(no output)'}`);
-    }
-  }
-
-  parts.push(`\nCurrent task — ${step.title}: ${step.goal}`);
-
-  if (step.output?.kind) {
-    parts.push(`Expected output format: ${step.output.kind}`);
-  }
-
-  return parts.join('\n');
-}
-
-// ─── Exported: executePlaybook ────────────────────────────────────────────────
-
-/**
- * Execute all steps in a playbook sequentially, feeding prior outputs forward.
- * @param {object} playbook
- * @param {{ profile?: object, prompt?: string, files?: string[], cwd?: string, dryRun?: boolean, verbose?: boolean }} context
- * @returns {Promise<{ steps: object[], summary: string, runId: string }>}
- */
-export async function executePlaybook(playbook, context = {}) {
-  const {
-    prompt = '',
-    files  = [],
-    cwd    = process.cwd(),
-    dryRun = false,
-    verbose = false,
-  } = context;
-
-  let { profile } = context;
-  if (!profile) {
-    try { profile = await loadProfile(cwd); } catch { profile = {}; }
-  }
-
-  const runId      = randomUUID();
-  const steps      = playbook.steps ?? [];
-  const results    = [];
-  const priorOuts  = [];
-
-  if (verbose) {
-    console.log(`[playbook] Starting "${playbook.name}" — ${steps.length} steps (runId: ${runId})`);
-  }
-
-  for (const step of steps) {
-    const stepPrompt = buildStepPrompt(step, priorOuts, prompt);
-
-    // Build synthetic detection that respects the step's declared tier
-    const detection = {
-      intent:     step.tier === 'think'  ? 'architecture'
-                : step.tier === 'search' ? 'search'
-                : 'edit',
-      tier:       step.tier ?? 'execute',
-      risk:       'medium',
-      complexity: 'moderate',
-      effort:     'medium',
-    };
-
-    // Force dual-brain if step declares consensus:true OR risk warrants it
-    const forceDual = step.consensus === true || shouldDualBrain(detection, profile);
-    const decision  = decideRoute({ profile, detection, cwd });
-    if (forceDual) decision.dualBrain = true;
-
-    if (verbose) {
-      const mode = forceDual ? 'dual-brain' : `${decision.provider}/${decision.model}`;
-      console.log(`[playbook] Step "${step.id}" → ${mode} (${decision.tier})`);
-    }
-
-    // Gate: log and continue (blocking gates are a future concern)
-    if (step.gate) {
-      console.log(`[playbook] Gate "${step.gate}" — checking (non-blocking in this version)`);
-    }
-
-    let result;
-    try {
-      if (forceDual) {
-        result = await dispatchDualBrain({ decision, prompt: stepPrompt, files, cwd, dryRun });
-        result = {
-          status:   result.consensus === 'both-failed' ? 'failed' : 'completed',
-          summary:  result.claude?.summary ?? result.openai?.summary ?? '(dual-brain)',
-          dualBrain: result,
-        };
-      } else {
-        result = await dispatch({ decision, prompt: stepPrompt, files, cwd, dryRun });
-      }
-    } catch (err) {
-      result = { status: 'error', summary: err.message, error: err.message };
-    }
-
-    const stepResult = {
-      stepId:   step.id,
-      title:    step.title,
-      tier:     step.tier ?? 'execute',
-      dualBrain: forceDual,
-      status:   result.status,
-      summary:  result.summary ?? null,
-      error:    result.error ?? null,
-    };
-
-    results.push(stepResult);
-    priorOuts.push({ stepId: step.id, summary: result.summary });
-
-    if (verbose) {
-      console.log(`[playbook]   → ${stepResult.status}: ${stepResult.summary ?? stepResult.error}`);
-    }
-  }
-
-  const passed  = results.filter(r => r.status === 'completed' || r.status === 'dry-run').length;
-  const failed  = results.filter(r => r.status === 'failed' || r.status === 'error').length;
-  const summary = `Playbook "${playbook.name}" finished: ${passed}/${steps.length} steps passed${failed ? `, ${failed} failed` : ''}.`;
-
-  if (!dryRun) {
-    try { createRunArtifact(runId, results, cwd); } catch {}
-  }
-
-  return { steps: results, summary, runId };
-}

package/src/pr-agent.mjs

@@ -1,214 +0,0 @@
-// pr-agent.mjs — PR workflow module for dual-brain.
-// Provides issue/task → branch → implement → PR automation using the gh CLI.
-// Exports: hasGitHub, getBranchInfo, createBranch, getDiffSummary, createPR,
-//          listPRs, getPRDetails, buildPRBody
-
-import { execSync } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-
-/**
- * Check if gh CLI is available and authenticated.
- * @returns {{ available: boolean, authenticated: boolean }}
- */
-export function hasGitHub() {
-  try {
-    execSync('gh auth status', { stdio: 'pipe', timeout: 5000 });
-    return { available: true, authenticated: true };
-  } catch {
-    try {
-      execSync('which gh', { stdio: 'pipe', timeout: 2000 });
-      return { available: true, authenticated: false };
-    } catch {
-      return { available: false, authenticated: false };
-    }
-  }
-}
-
-/**
- * Get current branch info including distance from default branch.
- * @param {string} [cwd]
- * @returns {{ branch: string|null, defaultBranch: string, ahead: number, behind: number, isDefault: boolean }}
- */
-export function getBranchInfo(cwd) {
-  const dir = cwd ?? process.cwd();
-  try {
-    const branch = execSync('git rev-parse --abbrev-ref HEAD', { cwd: dir, encoding: 'utf8', timeout: 3000 }).trim();
-    const defaultBranch = execSync(
-      'git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null || echo refs/remotes/origin/main',
-      { cwd: dir, encoding: 'utf8', timeout: 3000 },
-    ).trim().replace('refs/remotes/origin/', '');
-    const ahead = parseInt(
-      execSync(`git rev-list --count ${defaultBranch}..HEAD 2>/dev/null || echo 0`, { cwd: dir, encoding: 'utf8', timeout: 3000 }).trim(),
-    ) || 0;
-    const behind = parseInt(
-      execSync(`git rev-list --count HEAD..${defaultBranch} 2>/dev/null || echo 0`, { cwd: dir, encoding: 'utf8', timeout: 3000 }).trim(),
-    ) || 0;
-    return { branch, defaultBranch, ahead, behind, isDefault: branch === defaultBranch };
-  } catch {
-    return { branch: null, defaultBranch: 'main', ahead: 0, behind: 0, isDefault: true };
-  }
-}
-
-/**
- * Create a feature branch from a task description.
- * Branch name is prefixed with "db/" and slugified from the description.
- * @param {string} taskDescription
- * @param {string} [cwd]
- * @returns {{ success: boolean, branch: string, error?: string }}
- */
-export function createBranch(taskDescription, cwd) {
-  const dir = cwd ?? process.cwd();
-  const slug = taskDescription
-    .toLowerCase()
-    .replace(/[^a-z0-9\s-]/g, '')
-    .trim()
-    .replace(/\s+/g, '-')
-    .slice(0, 50);
-  const branchName = `db/${slug}`;
-
-  try {
-    execSync(`git checkout -b "${branchName}"`, { cwd: dir, stdio: 'pipe', timeout: 5000 });
-    return { success: true, branch: branchName };
-  } catch (err) {
-    return { success: false, branch: branchName, error: err.message };
-  }
-}
-
-/**
- * Get diff summary for PR description generation.
- * @param {string} baseBranch  Base branch name (e.g. 'main')
- * @param {string} [cwd]
- * @returns {{ stat: string, files: string[], summary: string, fileCount: number }}
- */
-export function getDiffSummary(baseBranch, cwd) {
-  const dir = cwd ?? process.cwd();
-  try {
-    const stat = execSync(`git diff --stat ${baseBranch}...HEAD`, { cwd: dir, encoding: 'utf8', timeout: 10000 }).trim();
-    const files = execSync(`git diff --name-only ${baseBranch}...HEAD`, { cwd: dir, encoding: 'utf8', timeout: 5000 })
-      .trim()
-      .split('\n')
-      .filter(Boolean);
-    const summary = execSync(`git diff --shortstat ${baseBranch}...HEAD`, { cwd: dir, encoding: 'utf8', timeout: 5000 }).trim();
-    return { stat, files, summary, fileCount: files.length };
-  } catch {
-    return { stat: '', files: [], summary: '', fileCount: 0 };
-  }
-}
-
-/**
- * Create a PR using the gh CLI. Pushes the current branch first.
- * @param {object} opts
- * @param {string} opts.title
- * @param {string} opts.body
- * @param {string} [opts.baseBranch]
- * @param {boolean} [opts.draft]
- * @param {string[]} [opts.labels]
- * @param {string} [opts.cwd]
- * @returns {{ success: boolean, url?: string, error?: string }}
- */
-export function createPR(opts) {
-  const { title, body, baseBranch, draft, labels, cwd } = opts;
-  const dir = cwd ?? process.cwd();
-
-  try {
-    // Push current branch to origin first
-    const branch = execSync('git rev-parse --abbrev-ref HEAD', { cwd: dir, encoding: 'utf8', timeout: 3000 }).trim();
-    execSync(`git push -u origin "${branch}"`, { cwd: dir, stdio: 'pipe', timeout: 30000 });
-
-    // Build gh pr create args
-    const args = ['gh', 'pr', 'create', '--title', JSON.stringify(title), '--body', JSON.stringify(body)];
-    if (baseBranch) args.push('--base', baseBranch);
-    if (draft) args.push('--draft');
-    if (labels?.length) args.push('--label', labels.join(','));
-
-    const result = execSync(args.join(' '), { cwd: dir, encoding: 'utf8', timeout: 30000 });
-    const url = result.trim();
-    return { success: true, url };
-  } catch (err) {
-    return { success: false, error: err.message };
-  }
-}
-
-/**
- * List open (or other state) PRs for the current repo.
- * @param {string} [cwd]
- * @param {object} [opts]
- * @param {'open'|'closed'|'merged'|'all'} [opts.state]
- * @param {number} [opts.limit]
- * @returns {object[]}
- */
-export function listPRs(cwd, opts = {}) {
-  const dir = cwd ?? process.cwd();
-  const { state = 'open', limit = 10 } = opts;
-  try {
-    const json = execSync(
-      `gh pr list --state ${state} --limit ${limit} --json number,title,headRefName,author,createdAt,isDraft`,
-      { cwd: dir, encoding: 'utf8', timeout: 10000 },
-    );
-    return JSON.parse(json);
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Get PR details including diff stats, comments, and CI checks.
- * @param {number|string} prNumber
- * @param {string} [cwd]
- * @returns {object|null}
- */
-export function getPRDetails(prNumber, cwd) {
-  const dir = cwd ?? process.cwd();
-  try {
-    const json = execSync(
-      `gh pr view ${prNumber} --json title,body,headRefName,baseRefName,state,additions,deletions,changedFiles,reviews,comments,statusCheckRollup`,
-      { cwd: dir, encoding: 'utf8', timeout: 10000 },
-    );
-    return JSON.parse(json);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Build a PR body from a task description and dispatch results.
- * @param {string} taskDescription
- * @param {object} results  Dispatch result object (filesChanged, testsRun, decisions, etc.)
- * @returns {string}
- */
-export function buildPRBody(taskDescription, results) {
-  const lines = [];
-  lines.push('## Summary');
-  lines.push(taskDescription);
-  lines.push('');
-
-  if (results.filesChanged?.length) {
-    lines.push('## Changes');
-    for (const f of results.filesChanged) {
-      lines.push(`- \`${f}\``);
-    }
-    lines.push('');
-  }
-
-  if (results.testsRun?.length) {
-    lines.push('## Tests');
-    for (const t of results.testsRun) {
-      lines.push(`- ${t}`);
-    }
-    lines.push('');
-  }
-
-  if (results.decisions?.length) {
-    lines.push('## Routing');
-    for (const d of results.decisions) {
-      lines.push(`- ${d}`);
-    }
-    lines.push('');
-  }
-
-  lines.push('---');
-  lines.push('Generated by [dual-brain](https://npmjs.com/package/dual-brain)');
-
-  return lines.join('\n');
-}