edsger 0.77.0 → 0.78.0

package/dist/index.js

@@ -1,1271 +1,1363 @@
 #!/usr/bin/env node
-import { Command } from 'commander';
-import { config as dotenvConfig } from 'dotenv';
-import { readFileSync } from 'fs';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-import { applyEnvStore } from './auth/env-store.js';
-import { runLogin, runLogout, runStatus } from './auth/login.js';
-import { runAdr } from './commands/adr/index.js';
-import { runAgentWorkflow } from './commands/agent-workflow/index.js';
-import { runAnalyzeLogs } from './commands/analyze-logs/index.js';
-import { runApiDocs } from './commands/api-docs/index.js';
-import { runAppStoreGeneration } from './commands/app-store/index.js';
-import { runArchitectureDiagram } from './commands/architecture-diagram/index.js';
-import { runBuild } from './commands/build/index.js';
-import { runChatServeCommand } from './commands/chat-serve/index.js';
-import { runChecklists } from './commands/checklists/index.js';
-import { runClassDiagram } from './commands/class-diagram/index.js';
-import { runCodeReview } from './commands/code-review/index.js';
-import { runConfigGet, runConfigList, runConfigSet, runConfigUnset, } from './commands/config/index.js';
-import { runDataFlow } from './commands/data-flow/index.js';
-import { runDiscover } from './commands/discover/index.js';
-import { runErDiagram } from './commands/er-diagram/index.js';
-import { runFeatures } from './commands/features/index.js';
-import { runFinancingDeck } from './commands/financing-deck/index.js';
-import { runFindArchitecture } from './commands/find-architecture/index.js';
-import { runFindBugs } from './commands/find-bugs/index.js';
-import { runFindFeatures } from './commands/find-features/index.js';
-import { parseCategoriesOption, runFindSmells, } from './commands/find-smells/index.js';
-import { runFlowchart } from './commands/flowchart/index.js';
-import { runGrowthAnalysis } from './commands/growth-analysis/index.js';
-import { runInit } from './commands/init/index.js';
-import { runIntelligence } from './commands/intelligence/index.js';
-import { runIssueAnalysisCommand } from './commands/issue-analysis/index.js';
-import { runPRResolve } from './commands/pr-resolve/index.js';
-import { runPRReview } from './commands/pr-review/index.js';
-import { runProductTestCases } from './commands/product-test-cases/index.js';
-import { runQualityBenchmarkCli } from './commands/quality-benchmark/index.js';
-import { runRecipes } from './commands/recipes/index.js';
-import { runRefactor } from './commands/refactor/refactor.js';
-import { runReleaseSyncCommand } from './commands/release-sync/index.js';
-import { runRunSheetCommand } from './commands/run-sheet/index.js';
-import { runScreenFlow } from './commands/screen-flow/index.js';
-import { runSequenceDiagram } from './commands/sequence-diagram/index.js';
-import { runSessionServeCommand } from './commands/session-serve/index.js';
-import { runSessionTurnCommand } from './commands/session-turn/index.js';
-import { runSmokeTestCommand } from './commands/smoke-test/index.js';
-import { runStateDiagram } from './commands/state-diagram/index.js';
-import { runSyncAws } from './commands/sync-aws/index.js';
-import { runSyncDatadog } from './commands/sync-datadog/index.js';
-import { runSyncGithubIssues } from './commands/sync-github-issues/index.js';
-import { runSyncGithubPullRequests } from './commands/sync-github-pull-requests/index.js';
-import { runSyncOrgRepos } from './commands/sync-org-repos/index.js';
-import { runSyncSentryIssues } from './commands/sync-sentry-issues/index.js';
-import { runSyncTerraform } from './commands/sync-terraform/index.js';
-import { runTaskWorker } from './commands/task-worker/index.js';
-import { runTechnicalDesignCommand } from './commands/technical-design/index.js';
-import { runTestCasesAnalysisCommand } from './commands/test-cases-analysis/index.js';
-import { runUserPsychologyAnalysis } from './commands/user-psychology/index.js';
-import { runUserStoriesAnalysisCommand } from './commands/user-stories-analysis/index.js';
-import { runWorkflow } from './commands/workflow/index.js';
-import { DEFAULT_MAX_FILES as FIND_ARCHITECTURE_DEFAULT_MAX_FILES } from './phases/find-architecture/index.js';
-import { DEFAULT_MAX_FILES as FIND_SMELLS_DEFAULT_MAX_FILES } from './phases/find-smells/index.js';
-import { SMELL_CATEGORIES, } from './phases/find-smells/types.js';
-import { deregisterSession, registerSession, startHeartbeat, } from './system/session-manager.js';
-import { logError, logInfo } from './utils/logger.js';
-// Get package.json version dynamically
-// eslint-disable-next-line @typescript-eslint/naming-convention -- ESM __filename/__dirname polyfill
-const __filename = fileURLToPath(import.meta.url);
-// eslint-disable-next-line @typescript-eslint/naming-convention -- ESM __filename/__dirname polyfill
-const __dirname = dirname(__filename);
-const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
-const { version } = packageJson;
-// Load environment variables (each only sets vars not already defined):
-// 1. Real environment variables (highest priority - already in process.env)
-// 2. .env file in cwd (medium priority - loaded first)
-// 3. ~/.edsger/env.json (lowest priority - loaded last)
-dotenvConfig({ path: join(process.cwd(), '.env') });
-applyEnvStore();
-const program = new Command();
-program
-    .name('edsger')
-    .description('AI-powered workflow automation and code review CLI tool')
-    .version(version);
-// When the desktop app spawns a streamed CLI it sets EDSGER_PROCESS_KEY (its
-// process-registry key with the `:output` marker stripped, e.g.
-// `sync-terraform` or `recipes:<productId>`). Open a cli_sessions row whose
-// `command` is that key so the originating tab can find the still-running
-// session and replay its logs across tab switches / restarts / devices.
-// registerSession is idempotent: commands that open their own (richer) session
-// just enrich the row started here (the process key stays in `command`), and
-// deregisterSession is a no-op once they've closed it.
-program.hook('preAction', async (_thisCommand, actionCommand) => {
-    if (process.env.EDSGER_PROCESS_KEY) {
-        await registerSession({ command: actionCommand.name() });
-        // Keep last_heartbeat fresh while the run is alive, so consumers of the
-        // cli_sessions row (the desktop's tab views) can tell a live session from
-        // a stale one left behind by a crash / SIGKILL.
-        startHeartbeat();
-    }
-});
-program.hook('postAction', async () => {
-    if (process.env.EDSGER_PROCESS_KEY) {
-        await deregisterSession();
-    }
-});
-/**
- * Mark the session row stopped (bounded, best-effort) and exit non-zero.
- *
- * Every command's catch block used to call `process.exit(1)` directly, which
- * skips the postAction hook above — the cli_sessions row stayed 'running'
- * forever and the desktop kept showing a ghost in-progress run that no Stop
- * button could clear.
- */
-function exitWithError(error) {
-    logError(error instanceof Error ? error.message : String(error));
-    void Promise.race([
-        deregisterSession(),
-        new Promise((resolve) => {
-            setTimeout(resolve, 3000);
-        }),
-    ]).finally(() => process.exit(1));
-}
-// The desktop's Stop button sends SIGTERM (escalating to SIGKILL after 5s).
-// Without a handler the process dies with its cli_sessions row still
-// 'running' — same ghost-run problem as the error path above. Finalize the
-// row (bounded) before exiting. Commands that install their own handlers
-// (build, agent-workflow, task-worker, chat-serve, ...) own the process
-// lifetime; in that case only the session row is finalized here.
-for (const signal of ['SIGTERM', 'SIGINT']) {
-    const onTermination = () => {
-        const finalize = Promise.race([
-            deregisterSession(),
-            new Promise((resolve) => {
-                setTimeout(resolve, 3000);
-            }),
-        ]);
-        const others = process
-            .listeners(signal)
-            .filter((listener) => listener !== onTermination);
-        if (others.length === 0) {
-            void finalize.finally(() => process.exit(signal === 'SIGINT' ? 130 : 143));
-        }
-    };
-    process.on(signal, onTermination);
-}
-// ============================================================
-// Subcommand: edsger login
-// ============================================================
-program
-    .command('login')
-    .description('Authenticate with edsger.ai - opens browser to get a CLI token')
-    .action(async () => {
-    try {
-        await runLogin();
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger logout
-// ============================================================
-program
-    .command('logout')
-    .description('Remove stored authentication credentials')
-    .action(() => {
-    try {
-        runLogout();
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger status
-// ============================================================
-program
-    .command('status')
-    .description('Show current login and session status')
-    .action(() => {
-    try {
-        runStatus();
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger config set/get/list/unset
-// ============================================================
-const configCmd = program
-    .command('config')
-    .description('Manage CLI environment variables (stored in ~/.edsger/env.json)');
-configCmd
-    .command('set <key=value>')
-    .description('Set an environment variable (e.g., edsger config set ELEVENLABS_API_KEY=sk-xxx)')
-    .action((pair) => {
-    runConfigSet(pair);
-});
-configCmd
-    .command('get <key>')
-    .description('Get the value of a stored environment variable')
-    .action((key) => {
-    runConfigGet(key);
-});
-configCmd
-    .command('unset <key>')
-    .description('Remove a stored environment variable')
-    .action((key) => {
-    runConfigUnset(key);
-});
-configCmd
-    .command('list')
-    .description('List all stored environment variables')
-    .action(() => {
-    runConfigList();
-});
-// ============================================================
-// Subcommand: edsger growth <productId>
-// ============================================================
-program
-    .command('growth <productId>')
-    .description('Run AI-powered growth analysis for a product')
-    .option('-v, --verbose', 'Verbose output')
-    .option('-g, --guidance <text>', 'Human direction for the AI (themes, audience, tone, etc.)')
-    .option('--analysis-id <id>', 'Update an existing pending analysis instead of creating new')
-    .action(async (productId, opts) => {
-    try {
-        await runGrowthAnalysis({
-            growthAnalysis: productId,
-            verbose: opts.verbose,
-            growthGuidance: opts.guidance,
-            growthAnalysisId: opts.analysisId,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger screen-flow <productId>
-// ============================================================
-program
-    .command('screen-flow [productId]')
-    .description('Generate a structured screen flow (screens + transitions) for a product (or standalone repository) from its source code')
-    .requiredOption('--diagram-id <id>', 'Pending diagrams row id to populate')
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('-g, --guidance <text>', 'Human direction for the AI (focus areas, exclusions)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        if (!productId && !opts.repoId) {
-            throw new Error('Provide a productId or --repo-id (repo-only mode) for screen-flow');
-        }
-        await runScreenFlow(productId, {
-            diagramId: opts.diagramId,
-            repoId: opts.repoId,
-            guidance: opts.guidance,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger data-flow <productId>
-// ============================================================
-program
-    .command('data-flow [productId]')
-    .description('Generate a structured data flow (sources, datasets, transforms, sinks, queues, models) for a product (or standalone repository) from its source code')
-    .requiredOption('--diagram-id <id>', 'Pending diagrams row id to populate')
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('-g, --guidance <text>', 'Human direction for the AI (focus areas, exclusions)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        if (!productId && !opts.repoId) {
-            throw new Error('Provide a productId or --repo-id (repo-only mode) for data-flow');
-        }
-        await runDataFlow(productId, {
-            diagramId: opts.diagramId,
-            repoId: opts.repoId,
-            guidance: opts.guidance,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger er-diagram <productId>
-// ============================================================
-program
-    .command('er-diagram [productId]')
-    .description('Generate a structured entity-relationship diagram (tables, views, enums, junctions + their relationships) for a product (or standalone repository) from its schema source')
-    .requiredOption('--diagram-id <id>', 'Pending diagrams row id to populate')
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('-g, --guidance <text>', 'Human direction for the AI (focus areas, exclusions)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        if (!productId && !opts.repoId) {
-            throw new Error('Provide a productId or --repo-id (repo-only mode) for er-diagram');
-        }
-        await runErDiagram(productId, {
-            diagramId: opts.diagramId,
-            repoId: opts.repoId,
-            guidance: opts.guidance,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger sequence-diagram <productId>
-// ============================================================
-program
-    .command('sequence-diagram [productId]')
-    .description('Generate a structured sequence diagram (participants + ordered messages for one scenario) for a product (or standalone repository) from its source code')
-    .requiredOption('--diagram-id <id>', 'Pending diagrams row id to populate')
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('-g, --guidance <text>', 'Human direction for the AI — the scenario to map (e.g. "user checkout")')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
+
+// src/index.ts
+import { resolve as resolve2 } from "path";
+import { Command, Option } from "commander";
+import pc6 from "picocolors";
+
+// src/commands/benchmark.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { basename, join as join3 } from "path";
+import pc2 from "picocolors";
+
+// src/core/assets.ts
+import { execFileSync } from "child_process";
+import { existsSync, readdirSync, statSync } from "fs";
+import { homedir } from "os";
+import { dirname, isAbsolute, join, resolve } from "path";
+import { fileURLToPath } from "url";
+
+// src/core/logger.ts
+import pc from "picocolors";
+var verbose = false;
+function setVerbose(v) {
+  verbose = v;
+}
+var log = {
+  info(msg) {
+    process.stderr.write(`${pc.cyan("\u2022")} ${msg}
+`);
+  },
+  success(msg) {
+    process.stderr.write(`${pc.green("\u2713")} ${msg}
+`);
+  },
+  warn(msg) {
+    process.stderr.write(`${pc.yellow("!")} ${msg}
+`);
+  },
+  error(msg) {
+    process.stderr.write(`${pc.red("\u2717")} ${msg}
+`);
+  },
+  step(msg) {
+    process.stderr.write(`${pc.dim("  \u2192")} ${pc.dim(msg)}
+`);
+  },
+  debug(msg) {
+    if (verbose) process.stderr.write(`${pc.dim(`  ${msg}`)}
+`);
+  },
+  /** Print a heading to stderr so structured stdout stays clean. */
+  heading(msg) {
+    process.stderr.write(`
+${pc.bold(msg)}
+`);
+  }
+};
+
+// src/util/yaml.ts
+import { readFileSync } from "fs";
+import yaml from "js-yaml";
+function loadStructured(path) {
+  const raw = readFileSync(path, "utf8");
+  return yaml.load(raw);
+}
+
+// src/core/assets.ts
+var moduleDir = dirname(fileURLToPath(import.meta.url));
+function findBundledAssetsDir() {
+  if (process.env.EDSGER_ASSETS_DIR && existsSync(process.env.EDSGER_ASSETS_DIR)) {
+    return process.env.EDSGER_ASSETS_DIR;
+  }
+  let dir = moduleDir;
+  for (let i = 0; i < 8; i++) {
+    const candidate = join(dir, "assets");
+    if (existsSync(join(candidate, "manifest.yaml"))) return candidate;
+    if (existsSync(join(dir, "manifest.yaml")) && existsSync(join(dir, "benchmark"))) {
+      return dir;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  throw new Error("Could not locate bundled assets. Reinstall edsger or set EDSGER_ASSETS_DIR.");
+}
+function loadLangConfig(assetsRoot) {
+  const cfgPath = join(assetsRoot, "languages.yaml");
+  if (!existsSync(cfgPath)) return null;
+  return loadStructured(cfgPath);
+}
+function scoreLanguages(names, cfg, minScore) {
+  const exts = new Set(names.map(extOf));
+  const scored = [];
+  for (const lang of cfg.languages) {
+    let score = 0;
+    for (const m of lang.markers) {
+      if (m.includes("*")) {
+        const re = globToRegExp(m);
+        if (names.some((f) => re.test(f))) score += 3;
+      } else if (names.includes(m)) {
+        score += 3;
+      }
+    }
+    let extHits = 0;
+    for (const e of lang.extensions) if (exts.has(e)) extHits++;
+    score += Math.min(extHits, cfg.maxExtensionMatches);
+    if (score >= minScore) scored.push({ id: lang.id, score });
+  }
+  return scored.sort((a, b) => b.score - a.score).map((s) => s.id);
+}
+function detectLanguages(cwd, assetsRoot) {
+  const cfg = loadLangConfig(assetsRoot);
+  if (!cfg) return [];
+  const names = readShallowTree(cwd, 3).map((e) => e.name);
+  return scoreLanguages(names, cfg, cfg.minScore);
+}
+function inferLanguagesFromFiles(paths, assetsRoot, minScore = 1) {
+  const cfg = loadLangConfig(assetsRoot);
+  if (!cfg) return [];
+  const names = paths.flatMap((p) => [p, p.split("/").pop() ?? p]);
+  return scoreLanguages(names, cfg, minScore);
+}
+function resolveStandard(kind, opts, config, configDir, forcedLanguages) {
+  const bundled = opts.assetsPath ? resolveRootPath(opts.assetsPath, opts.cwd) : findBundledAssetsDir();
+  const languages = opts.lang ? [normaliseLang(opts.lang)] : config.language ? [normaliseLang(config.language)] : pickDetected(detectLanguages(opts.cwd, bundled), forcedLanguages);
+  const roots = [
+    { path: bundled, label: opts.assetsPath ? `assets:${opts.assetsPath}` : "bundled" }
+  ];
+  const overrideSpec = (kind === "benchmark" ? config.benchmark?.standards : config.review?.standards) ?? config.standards;
+  if (overrideSpec && !opts.assetsPath) {
+    roots.push({ path: resolveRootPath(overrideSpec, configDir), label: `config:${overrideSpec}` });
+  }
+  const layers = [];
+  for (const root of roots) {
+    pushIfExists(layers, join(root.path, kind, "base.yaml"), `${root.label}/base`);
+    for (const lang of languages) {
+      pushIfExists(layers, join(root.path, kind, `${lang}.yaml`), `${root.label}/${lang}`);
+    }
+  }
+  const repoLocal = join(opts.cwd, ".edsger", kind);
+  if (existsSync(repoLocal)) {
+    pushIfExists(layers, join(repoLocal, "base.yaml"), `repo:.edsger/${kind}/base`);
+    for (const lang of languages) {
+      pushIfExists(layers, join(repoLocal, `${lang}.yaml`), `repo:.edsger/${kind}/${lang}`);
+    }
+  }
+  if (opts.standardPath) {
+    const p = resolveRootPath(opts.standardPath, opts.cwd);
+    if (existsSync(p) && statSync(p).isDirectory()) {
+      pushIfExists(layers, join(p, kind, "base.yaml"), `--standard/base`);
+      for (const lang of languages) {
+        pushIfExists(layers, join(p, kind, `${lang}.yaml`), `--standard/${lang}`);
+      }
+      pushIfExists(layers, join(p, "base.yaml"), `--standard/base`);
+    } else if (existsSync(p)) {
+      pushIfExists(layers, p, `--standard:${opts.standardPath}`);
+    } else {
+      throw new Error(`--standard path not found: ${p}`);
+    }
+  }
+  if (layers.length === 0) {
+    throw new Error(`No ${kind} standard found in any source.`);
+  }
+  const merged = mergeLayers(
+    kind,
+    layers.map((l) => l.data)
+  );
+  return { standard: merged, layers: layers.map((l) => l.label), languages };
+}
+function mergeLayers(kind, layers) {
+  if (kind === "benchmark") {
+    return layers.reduce(
+      (acc, layer) => mergeBenchmark(acc, layer),
+      {}
+    );
+  }
+  return layers.reduce(
+    (acc, layer) => mergeReview(acc, layer),
+    {}
+  );
+}
+function mergeBenchmark(base, overlay) {
+  const categories = mergeById(
+    base.categories ?? [],
+    overlay.categories ?? [],
+    (b, o) => ({
+      ...b,
+      ...o,
+      criteria: mergeById(b.criteria ?? [], o.criteria ?? [], (bc, oc) => ({
+        ...bc,
+        ...oc
+      }))
+    })
+  );
+  return {
+    ...base,
+    ...overlay,
+    // Preserve the base layer's identity rather than the last overlay's.
+    id: base.id ?? overlay.id,
+    name: base.name ?? overlay.name,
+    version: base.version ?? overlay.version,
+    kind: "benchmark",
+    scoreScale: overlay.scoreScale ?? base.scoreScale ?? 4,
+    categories
+  };
+}
+function mergeReview(base, overlay) {
+  const focusAreas = mergeById(
+    base.focusAreas ?? [],
+    overlay.focusAreas ?? [],
+    (b, o) => ({
+      ...b,
+      ...o
+    })
+  );
+  return {
+    ...base,
+    ...overlay,
+    id: base.id ?? overlay.id,
+    name: base.name ?? overlay.name,
+    version: base.version ?? overlay.version,
+    kind: "review",
+    policy: { ...base.policy ?? {}, ...overlay.policy ?? {} },
+    focusAreas
+  };
+}
+function mergeById(base, overlay, merge) {
+  const out = base.map((x) => ({ ...x }));
+  const index = new Map(out.map((x, i) => [x.id, i]));
+  for (const item of overlay) {
+    const at = index.get(item.id);
+    if (at === void 0) {
+      index.set(item.id, out.length);
+      out.push({ ...item });
+    } else {
+      out[at] = merge(out[at], item);
+    }
+  }
+  return out;
+}
+function pushIfExists(layers, path, label) {
+  if (existsSync(path)) {
+    layers.push({ data: loadStructured(path), label });
+    log.debug(`standard layer: ${label} (${path})`);
+  }
+}
+function resolveRootPath(spec, baseDir) {
+  if (spec.startsWith("git+") || /^(https?|git|ssh):\/\//.test(spec)) {
+    return cloneToCache(spec.replace(/^git\+/, ""));
+  }
+  return isAbsolute(spec) ? spec : resolve(baseDir, spec);
+}
+function cloneToCache(url) {
+  const [repo, ref] = url.split("#");
+  const safe = repo.replace(/[^a-zA-Z0-9._-]/g, "_");
+  const dest = join(homedir(), ".cache", "edsger", "standards", safe);
+  if (!existsSync(dest)) {
+    log.step(`cloning standards repo ${repo}`);
+    execFileSync("git", ["clone", "--depth", "1", ...ref ? ["--branch", ref] : [], repo, dest], {
+      stdio: "ignore"
+    });
+  }
+  return dest;
+}
+function readShallowTree(root, depth) {
+  const skip = /* @__PURE__ */ new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    "out",
+    "target",
+    "vendor",
+    ".venv",
+    "venv",
+    "__pycache__",
+    ".dart_tool"
+  ]);
+  const out = [];
+  const walk = (dir, level) => {
+    let items;
     try {
-        if (!productId && !opts.repoId) {
-            throw new Error('Provide a productId or --repo-id (repo-only mode) for sequence-diagram');
+      items = readdirSync(dir);
+    } catch {
+      return;
+    }
+    for (const name of items) {
+      if (skip.has(name)) continue;
+      out.push({ name });
+      if (level < depth) {
+        const full = join(dir, name);
+        try {
+          if (statSync(full).isDirectory()) walk(full, level + 1);
+        } catch {
         }
-        await runSequenceDiagram(productId, {
-            diagramId: opts.diagramId,
-            repoId: opts.repoId,
-            guidance: opts.guidance,
-            verbose: opts.verbose,
-        });
+      }
     }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-const diagramSubcommands = [
-    {
-        name: 'state-diagram',
-        description: 'Generate a state diagram (states + transitions for one lifecycle) for a product (or standalone repository) from its source code',
-        guidance: 'Human direction for the AI — the lifecycle to map',
-        run: runStateDiagram,
-    },
-    {
-        name: 'class-diagram',
-        description: 'Generate a UML class diagram (types + relationships) for a product (or standalone repository) from its source code',
-        guidance: 'Human direction for the AI (focus areas, exclusions)',
-        run: runClassDiagram,
-    },
-    {
-        name: 'architecture-diagram',
-        description: 'Generate an architecture/component diagram (components + dependencies) for a product (or standalone repository) from its source code',
-        guidance: 'Human direction for the AI (focus areas, exclusions)',
-        run: runArchitectureDiagram,
-    },
-    {
-        name: 'flowchart',
-        description: 'Generate a flowchart (control flow of one process/function) for a product (or standalone repository) from its source code',
-        guidance: 'Human direction for the AI — the process to map',
-        run: runFlowchart,
-    },
+  };
+  walk(root, 1);
+  return out;
+}
+function extOf(name) {
+  const i = name.lastIndexOf(".");
+  return i < 0 ? "" : name.slice(i);
+}
+function globToRegExp(glob) {
+  const escaped = glob.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+  return new RegExp(`^${escaped}$`);
+}
+function pickDetected(detected, fallback) {
+  return detected.length ? detected : fallback ?? [];
+}
+function normaliseLang(input) {
+  const v = input.trim().toLowerCase();
+  const aliases = {
+    ts: "typescript",
+    js: "typescript",
+    javascript: "typescript",
+    node: "typescript",
+    nodejs: "typescript",
+    py: "python",
+    golang: "go",
+    cs: "csharp",
+    "c#": "csharp",
+    dotnet: "csharp",
+    jvm: "java",
+    kotlin: "java",
+    flutter: "dart"
+  };
+  return aliases[v] ?? v;
+}
+
+// src/core/config.ts
+import { existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
+var CONFIG_FILENAMES = [
+  "edsger.config.yaml",
+  "edsger.config.yml",
+  "edsger.config.json",
+  ".edsgerrc.yaml",
+  ".edsgerrc.yml",
+  ".edsgerrc.json",
+  ".edsgerrc"
 ];
-for (const sub of diagramSubcommands) {
-    program
-        .command(`${sub.name} [productId]`)
-        .description(sub.description)
-        .requiredOption('--diagram-id <id>', 'Pending diagrams row id to populate')
-        .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-        .option('-g, --guidance <text>', sub.guidance)
-        .option('-v, --verbose', 'Verbose output')
-        .action(async (productId, opts) => {
+function loadConfig(cwd) {
+  const searchDirs = [cwd, join2(cwd, ".edsger")];
+  for (const dir of searchDirs) {
+    for (const name of CONFIG_FILENAMES) {
+      const p = join2(dir, name);
+      if (existsSync2(p)) {
         try {
-            if (!productId && !opts.repoId) {
-                throw new Error(`Provide a productId or --repo-id (repo-only mode) for ${sub.name}`);
-            }
-            await sub.run(productId, {
-                diagramId: opts.diagramId,
-                repoId: opts.repoId,
-                guidance: opts.guidance,
-                verbose: opts.verbose,
-            });
-        }
-        catch (error) {
-            exitWithError(error);
+          const config = loadStructured(p) ?? {};
+          return { config, path: p };
+        } catch {
         }
-    });
-}
-// ============================================================
-// Subcommand: edsger user-psychology <productId>
-// ============================================================
-program
-    .command('user-psychology <productId>')
-    .description('Research the product target users and produce a structured psychographic profile (personas + JTBD + Fogg + messaging angles)')
-    .option('-v, --verbose', 'Verbose output')
-    .option('-g, --guidance <text>', 'Human direction for the AI (audience focus, market, segment)')
-    .requiredOption('--analysis-id <id>', 'ID of the pending analysis row to fill in (reserved by the desktop UI)')
-    .action(async (productId, opts) => {
-    try {
-        await runUserPsychologyAnalysis({
-            userPsychology: productId,
-            verbose: opts.verbose,
-            userPsychologyGuidance: opts.guidance,
-            userPsychologyAnalysisId: opts.analysisId,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger financing-deck <productId>
-// ============================================================
-program
-    .command('financing-deck <productId>')
-    .description('Draft an investor pitch deck for a product (AI-generated)')
-    .requiredOption('--target-stage <stage>', 'Target stage: pre_seed | seed | series_a | series_b | series_c | growth')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runFinancingDeck({
-            financingDeck: productId,
-            financingTargetStage: opts.targetStage,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger intel <productId>
-// ============================================================
-program
-    .command('intel <productId>')
-    .description('Run AI-powered competitive intelligence analysis for a product')
-    .option('-v, --verbose', 'Verbose output')
-    .option('-t, --type <type>', 'Report type: competitive, market, pmf, research, comprehensive', 'competitive')
-    .option('-g, --guidance <text>', 'Human direction for the analysis focus')
-    .option('--report-id <id>', 'Update an existing pending report instead of creating new')
-    .option('--list-competitors', 'List discovered and confirmed competitors')
-    .option('--confirm-competitor <id>', 'Confirm a suggested competitor for tracking')
-    .option('--dismiss-competitor <id>', 'Dismiss a suggested competitor')
-    .action(async (productId, opts) => {
-    try {
-        await runIntelligence({
-            productId,
-            reportType: opts.type,
-            verbose: opts.verbose,
-            guidance: opts.guidance,
-            reportId: opts.reportId,
-            listCompetitors: opts.listCompetitors,
-            confirmCompetitor: opts.confirmCompetitor,
-            dismissCompetitor: opts.dismissCompetitor,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger adr <adrId>
-// ============================================================
-program
-    .command('adr <adrId>')
-    .description('Generate decision options (pros/cons) for a draft Architecture Decision Record')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (adrId, opts) => {
-    try {
-        await runAdr({ adrId, verbose: opts.verbose });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger app-store <productId>
-// ============================================================
-program
-    .command('app-store <productId>')
-    .description('Generate professional App Store / Play Store screenshots and listing content')
-    .option('-v, --verbose', 'Verbose output')
-    .option('--screenshots-only', 'Only generate screenshots')
-    .option('--listings-only', 'Only generate listing content')
-    .option('--store <type>', 'Target store: apple, google, or all (default: all)', 'all')
-    .option('--locale <locale>', 'Target locale (auto-detected from App Store Connect if omitted)')
-    .action(async (productId, opts) => {
-    try {
-        await runAppStoreGeneration({
-            appStoreProductId: productId,
-            verbose: opts.verbose,
-            screenshotsOnly: opts.screenshotsOnly,
-            listingsOnly: opts.listingsOnly,
-            store: opts.store,
-            locale: opts.locale,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger build <productId>
-// ============================================================
-program
-    .command('build <productId>')
-    .description('Build iOS/macOS app and optionally upload to App Store Connect')
-    .option('-v, --verbose', 'Verbose output')
-    .option('--scheme <name>', 'Xcode scheme (auto-detected if omitted)')
-    .option('--project <path>', 'Path to .xcworkspace or .xcodeproj (relative to repo root)')
-    .option('--configuration <name>', 'Build configuration (default: Release)', 'Release')
-    .option('--platform <platform>', 'Target platform: ios or macos (default: ios)', 'ios')
-    .option('--upload', 'Upload IPA to App Store Connect after building')
-    .option('--reselect', 'Re-discover project and scheme (ignore saved config)')
-    .option('--skip-archive', 'Skip build, only upload existing IPA')
-    .option('--ipa <path>', 'Upload a specific IPA file directly')
-    .action(async (productId, opts) => {
-    try {
-        await runBuild({
-            buildProductId: productId,
-            verbose: opts.verbose,
-            scheme: opts.scheme,
-            project: opts.project,
-            configuration: opts.configuration,
-            platform: opts.platform,
-            upload: opts.upload,
-            reselect: opts.reselect,
-            skipArchive: opts.skipArchive,
-            ipa: opts.ipa,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger checklists [productId] [--team-id <id>]
-// ============================================================
-program
-    .command('checklists [productId]')
-    .description('Analyse a local directory and sync product OR team checklists (create/update/delete) using AI. Pass a product ID positionally for product scope, or --team-id for team scope.')
-    .option('-v, --verbose', 'Verbose output')
-    .option('--dir <path>', 'Directory to analyse (defaults to current working directory)')
-    .option('--prompt <text>', 'Additional instructions for the AI agent')
-    .option('--team-id <id>', 'Sync TEAM-level checklists for this team instead of a product. The directory is treated as team standards / reference material.')
-    .action(async (productId, opts) => {
-    try {
-        if (!productId && !opts.teamId) {
-            throw new Error('Provide a product ID positionally or pass --team-id <id> for team scope.');
-        }
-        if (productId && opts.teamId) {
-            throw new Error('Pass either a product ID or --team-id, not both.');
-        }
-        await runChecklists({
-            checklistsProductId: productId,
-            checklistsTeamId: opts.teamId,
-            checklistsDir: opts.dir,
-            checklistsPrompt: opts.prompt,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger analyze-logs <productId>
-// ============================================================
-program
-    .command('analyze-logs <productId>')
-    .description('Analyze pending product logs and create feedback for issues found')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runAnalyzeLogs({
-            analyzeLogs: productId,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger release-sync <productId>
-// ============================================================
-program
-    .command('release-sync <productId>')
-    .description('Sync GitHub releases (and any unreleased snapshot version) into the releases table for a product')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runReleaseSyncCommand({
-            productId,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger issue-analysis <issueId>
-// ============================================================
-program
-    .command('issue-analysis <issueId>')
-    .description('Generate or refine the execution plan for an issue (issue_analysis phase, with verification loop)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (issueId, opts) => {
-    try {
-        await runIssueAnalysisCommand({ issueId, verbose: opts.verbose });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger session-turn <channelId>
-// ============================================================
-program
-    .command('session-turn <channelId>')
-    .description('Run one conversational agent turn for a chat session (ai_assistant channel)')
-    .requiredOption('--product <productId>', 'Product the session is bound to')
-    .option('--repos <ids>', 'Comma-separated repository IDs the agent may touch', '')
-    .option('--resume <sessionId>', 'SDK session id from a previous turn to resume the same conversation')
-    .option('--run-finished <runId>', 'Follow-up turn: report the results of a background cli_* run that finished')
-    .option('--run-command <command>', 'The command name of the finished run (used with --run-finished)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (channelId, opts) => {
-    try {
-        await runSessionTurnCommand({
-            channelId,
-            productId: opts.product,
-            repositoryIds: (opts.repos ?? '')
-                .split(',')
-                .map((s) => s.trim())
-                .filter(Boolean),
-            resumeSessionId: opts.resume,
-            runFinished: opts.runFinished
-                ? { runId: opts.runFinished, command: opts.runCommand }
-                : undefined,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger session-serve <channelId>
-// ============================================================
-program
-    .command('session-serve <channelId>')
-    .description('Run a long-lived conversational agent for a chat session, taking one turn per command read from stdin')
-    .requiredOption('--product <productId>', 'Product the session is bound to')
-    .option('--repos <ids>', 'Comma-separated repository IDs the agent may touch', '')
-    .option('--resume <sessionId>', 'SDK session id to resume on the first turn (e.g. after a crash-restart)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (channelId, opts) => {
-    try {
-        await runSessionServeCommand({
-            channelId,
-            productId: opts.product,
-            repositoryIds: (opts.repos ?? '')
-                .split(',')
-                .map((s) => s.trim())
-                .filter(Boolean),
-            resumeSessionId: opts.resume,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger chat-serve
-// ============================================================
-program
-    .command('chat-serve')
-    .description('Run a long-lived daemon that answers human messages on issue and product group chat channels')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (opts) => {
-    try {
-        await runChatServeCommand({ verbose: opts.verbose });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger user-stories-analysis <issueId>
-// ============================================================
-program
-    .command('user-stories-analysis <issueId>')
-    .description('Generate or refine user stories for an issue (user_stories_analysis phase, with verification loop)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (issueId, opts) => {
-    try {
-        await runUserStoriesAnalysisCommand({ issueId, verbose: opts.verbose });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger test-cases-analysis <issueId>
-// ============================================================
-program
-    .command('test-cases-analysis <issueId>')
-    .description('Generate or refine test cases for an issue (test_cases_analysis phase, with verification loop)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (issueId, opts) => {
-    try {
-        await runTestCasesAnalysisCommand({ issueId, verbose: opts.verbose });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger technical-design <issueId>
-// ============================================================
-program
-    .command('technical-design <issueId>')
-    .description('Generate or refine the technical design for an issue (technical_design phase, with verification loop)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (issueId, opts) => {
-    try {
-        await runTechnicalDesignCommand({ issueId, verbose: opts.verbose });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger smoke-test <releaseId>
-// ============================================================
-program
-    .command('smoke-test <releaseId>')
-    .description('Generate smoke-test cases for a specific release (requires the release to be synced first — see `edsger release-sync`)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (releaseId, opts) => {
-    try {
-        await runSmokeTestCommand({
-            releaseId,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
+      }
     }
-});
-// ============================================================
-// Subcommand: edsger run-sheet <releaseId>
-// ============================================================
-program
-    .command('run-sheet <releaseId>')
-    .description('Render the product run sheet template against a release (clones the repo at the release tag to resolve {{file:...}} placeholders)')
-    .option('-f, --force', 'Regenerate even if the cached run sheet is fresh')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (releaseId, opts) => {
-    try {
-        await runRunSheetCommand({
-            releaseId,
-            force: opts.force,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger pr-review <productId>
-// ============================================================
-program
-    .command('pr-review [productId]')
-    .description('AI-review a GitHub PR for a product (or standalone repository)')
-    .requiredOption('--pr-url <url>', 'GitHub PR URL')
-    .option('--pr-id <id>', 'Pull request record ID in database')
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        if (!productId && !opts.repoId) {
-            throw new Error('Provide a productId or --repo-id (repo-only mode) for pr-review');
+  }
+  return { config: {} };
+}
+
+// src/core/agent.ts
+import {
+  createSdkMcpServer,
+  query,
+  tool
+} from "@anthropic-ai/claude-agent-sdk";
+var READ_ONLY_DISALLOWED = ["Edit", "Write", "NotebookEdit"];
+async function runAgent(opts) {
+  assertAuth();
+  let captured;
+  const submitTool = tool(
+    "submit_result",
+    "Submit the final structured result. Call this exactly once when done.",
+    opts.resultShape,
+    async (args) => {
+      captured = args;
+      return { content: [{ type: "text", text: "Result recorded. You may stop now." }] };
+    }
+  );
+  const outServer = createSdkMcpServer({
+    name: "edsger_out",
+    version: "1.0.0",
+    tools: [submitTool]
+  });
+  const allowedTools = [
+    "Read",
+    "Grep",
+    "Glob",
+    "Bash",
+    "mcp__edsger_out__submit_result",
+    ...opts.allowWrite ? ["Edit", "Write", "MultiEdit"] : [],
+    ...opts.extraAllowedTools ?? []
+  ];
+  const mcpServers = {
+    edsger_out: outServer,
+    ...opts.extraMcpServers ?? {}
+  };
+  let costUsd = 0;
+  let numTurns = 0;
+  const controller = new AbortController();
+  const timer = opts.timeoutMs ? setTimeout(() => controller.abort(), opts.timeoutMs) : void 0;
+  const stream = query({
+    prompt: opts.prompt,
+    options: {
+      model: opts.model,
+      cwd: opts.cwd,
+      maxTurns: opts.maxTurns,
+      // Reproducible runs: do not load the target repo's settings/CLAUDE.md.
+      settingSources: [],
+      systemPrompt: {
+        type: "preset",
+        preset: "claude_code",
+        append: opts.systemPromptAppend
+      },
+      // The user explicitly invoked an agent to inspect/modify their own repo.
+      // Capability is shaped by allowedTools/disallowedTools rather than prompts:
+      // read-only runs have edit tools removed from context entirely (below).
+      permissionMode: "bypassPermissions",
+      allowedTools,
+      disallowedTools: opts.allowWrite ? [] : READ_ONLY_DISALLOWED,
+      mcpServers,
+      abortController: controller
+    }
+  });
+  try {
+    for await (const message of stream) {
+      if (message.type === "assistant") {
+        for (const block of message.message?.content ?? []) {
+          if (block.type === "tool_use") {
+            log.debug(`tool: ${block.name}`);
+          } else if (block.type === "text" && opts.verbose && block.text?.trim()) {
+            log.debug(block.text.trim().split("\n")[0] ?? "");
+          }
         }
-        await runPRReview(productId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger find-bugs <productId>
-// ============================================================
-program
-    .command('find-bugs [productId]')
-    .description("AI-audit a product's (or a standalone repository's) repo for bugs and file each new finding as an issue")
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('--full', 'Force a full scan even if previous-scan state exists')
-    .option('--branch <name>', 'Branch to scan (defaults to repo default branch)')
-    .option('--max-files <n>', 'Upper bound on files the auditor may Read (default 200)', (value) => {
-    const n = parseInt(value, 10);
-    if (Number.isNaN(n) || n <= 0) {
-        throw new Error('--max-files must be a positive integer');
-    }
-    return n;
-})
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runFindBugs(productId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger quality-benchmark <productId>
-// ============================================================
-program
-    .command('quality-benchmark [productId]')
-    .description("Run an industrial-grade code quality benchmark against the product's (or a standalone repository's) GitHub repo")
-    .option('--repo <path>', "Override the auto-clone with a local checkout (default: clone the product's repo into ~/edsger/quality-<owner>-<repo>)")
-    .option('--repo-id <id>', 'Benchmark a specific repository (id). With a productId, targets that linked repo; without a productId, runs in repo-only mode (no product)')
-    .option('--branch <name>', 'Override the detected default branch on the report envelope')
-    .option('--pkg-manager <name>', 'npm | pnpm | yarn (auto-detected if absent)')
-    .option('--no-install', 'Refuse to install missing tools; mark them unmeasured')
-    .option('--output <path>', 'Where to write the JSON report (default: ./quality-report-<commit>.json)')
-    .option('--no-save', 'Skip the quality_reports/save MCP call (local-only run)')
-    .option('--force', 'Overwrite any existing report row for this (product, commit, rubric)')
-    .option('--gate', "Evaluate the scope's quality gate against the report and exit non-zero if it fails (for CI). No-op when no gate is configured")
-    .option('-v, --verbose', 'Print every progress event')
-    .action(async (productId, opts) => {
-    try {
-        if (!productId && !opts.repoId) {
-            throw new Error('Provide a productId or --repo-id (repo-only mode) for quality-benchmark');
+      } else if (message.type === "result") {
+        costUsd = message.total_cost_usd ?? 0;
+        numTurns = message.num_turns ?? 0;
+        if (message.subtype && message.subtype !== "success") {
+          log.warn(`agent ended with: ${message.subtype}`);
         }
-        await runQualityBenchmarkCli(productId ?? '', opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger sync-github-issues <productId>
-// ============================================================
-program
-    .command('sync-github-issues <productId>')
-    .description("Mirror the product's connected GitHub repo issues into the local issues list (handles new, updated, closed, and deleted)")
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runSyncGithubIssues(productId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger sync-github-pull-requests <repoId>
-// ============================================================
-program
-    .command('sync-github-pull-requests <repoId>')
-    .description("Mirror a connected GitHub repo's pull requests into the local pull_requests list for the repo detail page (idempotent — refreshes, never duplicates)")
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (repoId, opts) => {
-    try {
-        await runSyncGithubPullRequests(repoId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger sync-org-repos <teamId>
-// ============================================================
-program
-    .command('sync-org-repos <teamId>')
-    .description("Sync a GitHub org's repos under a team via the Edsger GitHub App, falling back to your personal GitHub token.")
-    .option('-v, --verbose', 'Verbose output')
-    .option('--org <name>', "GitHub org name (defaults to the team's configured github_org)")
-    .action(async (teamId, opts) => {
-    try {
-        await runSyncOrgRepos(teamId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger sync-sentry-issues <productId>
-//
-// Requires SENTRY_AUTH_TOKEN, SENTRY_ORG, SENTRY_PROJECT in env (set via
-// `edsger config set`). Optional SENTRY_BASE_URL for self-hosted Sentry.
-// ============================================================
-program
-    .command('sync-sentry-issues <productId>')
-    .description('Mirror Sentry project issues into the local issues list (requires SENTRY_AUTH_TOKEN, SENTRY_ORG, SENTRY_PROJECT env)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runSyncSentryIssues(productId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger sync-datadog <teamId>
-//
-// Requires DD_API_KEY, DD_APP_KEY in env (set via `edsger config set`
-// or desktop Settings → Credentials → Datadog). Optional DD_SITE.
-// ============================================================
-program
-    .command('sync-datadog <teamId>')
-    .description('Import services from Datadog Service Catalog into the edsger service catalog (requires DD_API_KEY, DD_APP_KEY env)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (teamId, opts) => {
-    try {
-        await runSyncDatadog(teamId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
+      }
     }
-});
-// ============================================================
-// ============================================================
-// Subcommand: edsger sync-aws <teamId>
-//
-// Uses the standard AWS credential chain to discover services by
-// their Service tag and optionally pull cost data.
-// ============================================================
-program
-    .command('sync-aws <teamId>')
-    .description('Discover services from AWS by Service tag and pull cost data from Cost Explorer')
-    .option('-v, --verbose', 'Verbose output')
-    .option('--region <region>', 'AWS region (default: AWS_REGION env or us-east-1)')
-    .option('--no-cost', 'Skip Cost Explorer query')
-    .action(async (teamId, opts) => {
-    try {
-        await runSyncAws(teamId, {
-            verbose: opts.verbose,
-            region: opts.region,
-            noCost: opts.cost === false,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
-});
-// ============================================================
-// Subcommand: edsger discover <teamId> [runId]
-//
-// Scans every repo in the team's connected GitHub org and upserts an
-// inferred service for each into the service catalog. Drives an existing
-// discovery_runs row (created by the desktop) to running → success/failed.
-// ============================================================
-program
-    .command('discover <teamId> [runId]')
-    .description('Discover services by scanning every repo in the team’s connected GitHub organisation')
-    .option('-v, --verbose', 'Verbose output')
-    .option('--org <name>', 'Override the GitHub organisation to scan')
-    .action(async (teamId, runId, opts) => {
-    try {
-        await runDiscover(teamId, runId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
+  } catch (err) {
+    if (controller.signal.aborted) {
+      throw new Error(`Agent run timed out after ${Math.round((opts.timeoutMs ?? 0) / 1e3)}s.`);
     }
+    throw err;
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+  return { result: captured, costUsd, numTurns };
+}
+function assertAuth() {
+  if (!process.env.ANTHROPIC_API_KEY && !process.env.CLAUDE_CODE_OAUTH_TOKEN) {
+    throw new Error(
+      "No Anthropic credentials found. Set ANTHROPIC_API_KEY (or CLAUDE_CODE_OAUTH_TOKEN) before running edsger."
+    );
+  }
+}
+
+// src/core/report.ts
+function scoreBenchmark(standard, result) {
+  const scale = standard.scoreScale || 4;
+  const totalWeight = standard.categories.reduce((s, c) => s + c.weight, 0) || 1;
+  const scoreLookup = /* @__PURE__ */ new Map();
+  for (const cat of result.categories) {
+    for (const cr of cat.criteria) scoreLookup.set(`${cat.id}/${cr.id}`, cr.score);
+  }
+  const justifyLookup = /* @__PURE__ */ new Map();
+  for (const cat of result.categories) {
+    for (const cr of cat.criteria) {
+      justifyLookup.set(`${cat.id}/${cr.id}`, {
+        justification: cr.justification,
+        evidence: cr.evidence ?? []
+      });
+    }
+  }
+  const categories = standard.categories.map((cat) => {
+    const critWeightTotal = cat.criteria.reduce((s, c) => s + (c.weight ?? 1), 0) || 1;
+    const scored = cat.criteria.map((cr) => {
+      const raw = clamp(scoreLookup.get(`${cat.id}/${cr.id}`) ?? 0, 0, scale);
+      const meta = justifyLookup.get(`${cat.id}/${cr.id}`);
+      return {
+        id: cr.id,
+        title: cr.title,
+        weight: cr.weight ?? 1,
+        rawScore: raw,
+        maxScore: scale,
+        fraction: raw / scale,
+        justification: meta?.justification ?? "Not assessed.",
+        evidence: meta?.evidence ?? []
+      };
+    });
+    const fraction = scored.reduce((s, c) => s + c.fraction * c.weight, 0) / critWeightTotal;
+    const normWeight = cat.weight / totalWeight * 100;
+    return {
+      id: cat.id,
+      name: cat.name,
+      weight: round(normWeight, 1),
+      fraction,
+      points: round(normWeight * fraction, 1),
+      criteria: scored
+    };
+  });
+  const overall = round(
+    categories.reduce((s, c) => s + c.points, 0),
+    1
+  );
+  return {
+    standardName: standard.name,
+    standardVersion: standard.version,
+    overall,
+    grade: gradeFor(overall),
+    categories,
+    summary: result.summary,
+    strengths: result.strengths ?? [],
+    weaknesses: result.weaknesses ?? [],
+    recommendations: result.recommendations ?? []
+  };
+}
+function gradeFor(score) {
+  if (score >= 90) return "A";
+  if (score >= 80) return "B";
+  if (score >= 70) return "C";
+  if (score >= 60) return "D";
+  return "F";
+}
+function renderBenchmarkMarkdown(scored, meta) {
+  const lines = [];
+  lines.push(`# Edsger Benchmark Report`);
+  lines.push("");
+  lines.push(`**Score: ${scored.overall} / 100 (Grade ${scored.grade})**`);
+  lines.push("");
+  lines.push(`> ${scored.summary}`);
+  lines.push("");
+  lines.push(`| Field | Value |`);
+  lines.push(`| --- | --- |`);
+  lines.push(`| Repository | \`${meta.repo}\` |`);
+  lines.push(`| Languages | ${meta.languages.join(", ") || "n/a"} |`);
+  lines.push(`| Standard | ${scored.standardName} v${scored.standardVersion} |`);
+  lines.push(`| Sources | ${meta.layers.join(" \u2192 ")} |`);
+  lines.push(`| Model | ${meta.model} |`);
+  lines.push(`| Generated | ${meta.generatedAt} |`);
+  lines.push("");
+  lines.push(`## Category scores`);
+  lines.push("");
+  lines.push(`| Category | Weight | Score | Weighted |`);
+  lines.push(`| --- | ---: | ---: | ---: |`);
+  for (const c of scored.categories) {
+    lines.push(`| ${c.name} | ${c.weight}% | ${Math.round(c.fraction * 100)}% | ${c.points} |`);
+  }
+  lines.push(`| **Overall** | **100%** | | **${scored.overall}** |`);
+  lines.push("");
+  if (scored.strengths.length) {
+    lines.push(`## Strengths`);
+    lines.push("");
+    for (const s of scored.strengths) lines.push(`- ${s}`);
+    lines.push("");
+  }
+  if (scored.weaknesses.length) {
+    lines.push(`## Weaknesses`);
+    lines.push("");
+    for (const w of scored.weaknesses) lines.push(`- ${w}`);
+    lines.push("");
+  }
+  if (scored.recommendations.length) {
+    lines.push(`## Recommendations`);
+    lines.push("");
+    for (const r of scored.recommendations) {
+      lines.push(`- **[${r.priority}] ${r.title}** \u2014 ${r.detail}`);
+    }
+    lines.push("");
+  }
+  lines.push(`## Detailed findings`);
+  lines.push("");
+  for (const c of scored.categories) {
+    lines.push(`### ${c.name} \u2014 ${Math.round(c.fraction * 100)}%`);
+    lines.push("");
+    for (const cr of c.criteria) {
+      lines.push(`- **${cr.title}** (${cr.rawScore}/${cr.maxScore}) \u2014 ${cr.justification}`);
+      for (const e of cr.evidence) lines.push(`  - \`${e}\``);
+    }
+    lines.push("");
+  }
+  lines.push(`---`);
+  lines.push(`<sub>Generated by [edsger](https://www.npmjs.com/package/edsger).</sub>`);
+  return lines.join("\n");
+}
+function clamp(n, lo, hi) {
+  return Math.max(lo, Math.min(hi, n));
+}
+function round(n, dp) {
+  const f = 10 ** dp;
+  return Math.round(n * f) / f;
+}
+
+// src/core/schema.ts
+import { z } from "zod";
+var CriterionScoreSchema = z.object({
+  id: z.string().describe("Criterion id from the rubric"),
+  score: z.number().describe("Score for this criterion, 0..scoreScale"),
+  justification: z.string().describe("Why this score, in one or two sentences"),
+  evidence: z.array(z.string()).default([]).describe("File paths / snippets supporting the score")
 });
-// Subcommand: edsger sync-terraform <teamId>
-//
-// Clones the team's terraform repo (from teams.terraform_repo_full_name)
-// and lets the agent analyse .tf files to extract services, resources,
-// and dependencies. Alternatively, --dir for a local directory.
-// ============================================================
-program
-    .command('sync-terraform <teamId>')
-    .description('Scan a Terraform repo to discover services, AWS resources, and infrastructure dependencies')
-    .option('-v, --verbose', 'Verbose output')
-    .option('--dir <path>', 'Local directory to scan instead of cloning from GitHub')
-    .action(async (teamId, opts) => {
-    try {
-        await runSyncTerraform(teamId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
+var CategoryScoreSchema = z.object({
+  id: z.string().describe("Category id from the rubric"),
+  criteria: z.array(CriterionScoreSchema)
 });
-// ============================================================
-// Subcommand: edsger find-features <productId>
-// ============================================================
-program
-    .command('find-features <productId>')
-    .description("Synthesise feature opportunities from user feedback + intelligence reports + the product's codebase, and file each one as an issue")
-    .option('--branch <name>', 'Branch to scan (defaults to repo default branch)')
-    .option('--since <duration>', 'Feedback lookback window — e.g. "30d", "12h", "4w" (default 90d)')
-    .option('--min-cluster-size <n>', 'Min feedback mentions for a theme to count as high-confidence (default 3)', (value) => {
-    const n = parseInt(value, 10);
-    if (Number.isNaN(n) || n <= 0) {
-        throw new Error('--min-cluster-size must be a positive integer');
-    }
-    return n;
-})
-    .option('--max-suggestions <n>', 'Cap on opportunities the agent may surface (default 10)', (value) => {
-    const n = parseInt(value, 10);
-    if (Number.isNaN(n) || n <= 0) {
-        throw new Error('--max-suggestions must be a positive integer');
-    }
-    return n;
-})
-    .option('--against-report <id>', 'Narrow the run to opportunities implied by a specific intelligence report')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runFindFeatures(productId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
+var BenchmarkResultSchema = z.object({
+  categories: z.array(CategoryScoreSchema),
+  summary: z.string().describe("2-4 sentence overall assessment"),
+  strengths: z.array(z.string()).default([]),
+  weaknesses: z.array(z.string()).default([]),
+  recommendations: z.array(
+    z.object({
+      priority: z.enum(["high", "medium", "low"]),
+      title: z.string(),
+      detail: z.string()
+    })
+  ).default([])
 });
-// ============================================================
-// Subcommand: edsger find-smells <productId>
-// ============================================================
-program
-    .command('find-smells [productId]')
-    .description("AI-audit a product's (or a standalone repository's) repo for code smells (refactor candidates, perf cliffs, dead code, type-safety gaps) and file each new finding as an issue")
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('--full', 'Force a full scan even if previous-scan state exists')
-    .option('--branch <name>', 'Branch to scan (defaults to repo default branch)')
-    .option('--max-files <n>', `Upper bound on files the auditor may Read (default ${FIND_SMELLS_DEFAULT_MAX_FILES})`, (value) => {
-    const n = parseInt(value, 10);
-    if (Number.isNaN(n) || n <= 0) {
-        throw new Error('--max-files must be a positive integer');
-    }
-    return n;
-})
-    .option('--categories <list>', `Comma-separated category filter (${SMELL_CATEGORIES.join(',')})`, parseCategoriesOption)
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runFindSmells(productId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
+var SeveritySchema = z.enum(["critical", "high", "medium", "low", "info"]);
+var ReviewFindingSchema = z.object({
+  focusArea: z.string().describe("Focus area id this finding relates to"),
+  severity: SeveritySchema,
+  file: z.string().describe("Repo-relative file path, or '-' if general"),
+  line: z.number().nullable().default(null).describe("1-based line in the new file, if applicable"),
+  title: z.string(),
+  detail: z.string().describe("What is wrong and why it matters"),
+  suggestion: z.string().nullable().default(null).describe("Concrete suggested fix")
 });
-// ============================================================
-// Subcommand: edsger find-architecture <productId>
-// ============================================================
-program
-    .command('find-architecture [productId]')
-    .description("AI-audit a product's (or a standalone repository's) repo for architectural concerns (layering, coupling, cycles, missing/duplicated abstractions, responsibility creep) and file each new finding as an issue")
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('--full', 'Force a full scan even if previous-scan state exists')
-    .option('--branch <name>', 'Branch to scan (defaults to repo default branch)')
-    .option('--max-files <n>', `Upper bound on files the auditor may Read (default ${FIND_ARCHITECTURE_DEFAULT_MAX_FILES})`, (value) => {
-    const n = parseInt(value, 10);
-    if (Number.isNaN(n) || n <= 0) {
-        throw new Error('--max-files must be a positive integer');
-    }
-    return n;
-})
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runFindArchitecture(productId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
+var ReviewResultSchema = z.object({
+  summary: z.string().describe("Overall summary of the change and review"),
+  verdict: z.enum(["approve", "request_changes", "comment"]),
+  findings: z.array(ReviewFindingSchema).default([])
 });
-// ============================================================
-// Subcommand: edsger product-test-cases <productId>
-// ============================================================
-program
-    .command('product-test-cases <productId>')
-    .description("Generate product-level regression test cases by exploring the product's repo. Existing approved cases are preserved; replaceable (draft / pending_approval) ones may be deleted and replaced.")
-    .option('--branch <name>', 'Branch to scan (defaults to repo default branch)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runProductTestCases(productId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
+var ResolveResultSchema = z.object({
+  summary: z.string().describe("What was changed and why"),
+  changes: z.array(z.object({ file: z.string(), description: z.string() })).default([]),
+  testsRun: z.string().nullable().default(null).describe("Command used to verify, and its outcome"),
+  remaining: z.array(z.string()).default([]).describe("Anything still unresolved")
 });
-// ============================================================
-// Subcommand: edsger recipes <productId>
-// ============================================================
-program
-    .command('recipes [productId]')
-    .description("Scan a product's (or standalone repository's) repo for the implementation recipes it uses (which services/tools are chained together to deliver each capability) and persist them via the recipes / product_recipes (or repository_recipes) tables. Writes against the pending recipe_scans row identified by --scan-id.")
-    .requiredOption('--scan-id <id>', 'Pending recipe_scans row id to drive (created by the desktop UI before invocation)')
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('-g, --guidance <text>', 'Human direction for the AI (focus areas, exclusions)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
+
+// src/commands/benchmark.ts
+async function runBenchmark(opts) {
+  const { config, path: configPath } = loadConfig(opts.cwd);
+  const configDir = configPath ? join3(configPath, "..") : opts.cwd;
+  const resolved = resolveStandard("benchmark", opts, config, configDir);
+  const standard = resolved.standard;
+  log.info(
+    `Benchmarking ${pc2.bold(basename(opts.cwd))} against ${pc2.bold(standard.name)} (languages: ${resolved.languages.join(", ") || "generic"})`
+  );
+  log.debug(`standard layers: ${resolved.layers.join(" \u2192 ")}`);
+  const prompt = buildPrompt(standard, opts.cwd);
+  const { result, costUsd, numTurns } = await runAgent({
+    prompt,
+    cwd: opts.cwd,
+    model: opts.model,
+    maxTurns: opts.maxTurns,
+    timeoutMs: opts.timeoutMs,
+    allowWrite: false,
+    verbose: opts.verbose,
+    resultShape: BenchmarkResultSchema.shape,
+    systemPromptAppend: "You are Edsger, a meticulous staff-level engineer performing an objective repository assessment. Inspect the actual code and configuration before scoring. Be evidence-driven and fair; cite concrete files. Do not modify any files."
+  });
+  if (!result) {
+    log.error(
+      "The agent did not produce a result. Try increasing --max-turns or check credentials."
+    );
+    return 1;
+  }
+  const scored = scoreBenchmark(standard, result);
+  const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const md = renderBenchmarkMarkdown(scored, {
+    repo: basename(opts.cwd),
+    languages: resolved.languages,
+    layers: resolved.layers,
+    generatedAt,
+    model: opts.model
+  });
+  const jsonReport = {
+    schema: "edsger.benchmark/1",
+    generatedAt,
+    model: opts.model,
+    repo: basename(opts.cwd),
+    languages: resolved.languages,
+    standard: { name: standard.name, version: standard.version, layers: resolved.layers },
+    overall: scored.overall,
+    grade: scored.grade,
+    categories: scored.categories,
+    summary: scored.summary,
+    strengths: scored.strengths,
+    weaknesses: scored.weaknesses,
+    recommendations: scored.recommendations,
+    costUsd
+  };
+  if (!opts.noWrite && !opts.dryRun) {
+    const outDir = join3(opts.cwd, opts.out);
+    mkdirSync(outDir, { recursive: true });
+    writeFileSync(join3(outDir, "report.md"), md + "\n", "utf8");
+    writeFileSync(join3(outDir, "report.json"), JSON.stringify(jsonReport, null, 2) + "\n", "utf8");
+    log.success(`Report written to ${pc2.bold(join3(opts.out, "report.md"))}`);
+  }
+  printSummary(scored, numTurns, costUsd);
+  if (opts.json) process.stdout.write(JSON.stringify(jsonReport, null, 2) + "\n");
+  return 0;
+}
+function printSummary(scored, numTurns, costUsd) {
+  log.heading(`Score: ${scored.overall}/100  (Grade ${scored.grade})`);
+  for (const c of scored.categories) {
+    const pct = Math.round(c.fraction * 100);
+    process.stderr.write(`  ${bar(pct)} ${String(pct).padStart(3)}%  ${c.name}
+`);
+  }
+  log.step(`${numTurns} turns \xB7 ~$${costUsd.toFixed(3)}`);
+}
+function bar(pct) {
+  const width = 20;
+  const filled = Math.round(pct / 100 * width);
+  const color = pct >= 80 ? pc2.green : pct >= 60 ? pc2.yellow : pc2.red;
+  return color("\u2588".repeat(filled)) + pc2.dim("\u2591".repeat(width - filled));
+}
+function buildPrompt(standard, cwd) {
+  const rubric = standard.categories.map((cat) => {
+    const crits = cat.criteria.map((cr) => {
+      const anchors = cr.rubric ? Object.entries(cr.rubric).map(([k, v]) => `      - ${k}: ${v}`).join("\n") : "";
+      return `    - id: ${cat.id}/${cr.id}
+      title: ${cr.title}
+      guidance: ${cr.guidance.trim()}` + (anchors ? `
+      anchors:
+${anchors}` : "");
+    }).join("\n");
+    return `- category: ${cat.id} (${cat.name}, weight ${cat.weight})
+${crits}`;
+  }).join("\n");
+  return [
+    `Assess the repository located at: ${cwd}`,
+    ``,
+    `Score it against the rubric below. Each criterion is scored from 0 to ${standard.scoreScale}`,
+    `(0 = absent/harmful, ${standard.scoreScale} = exemplary), using the level anchors as a guide.`,
+    ``,
+    `Method:`,
+    `1. Explore the repository structure, key source files, configuration, CI, tests, and docs.`,
+    `   Use Read/Grep/Glob and read-only Bash (e.g. ls, cat, git log). Do NOT modify anything.`,
+    `2. For each criterion, gather concrete evidence (file paths) before deciding a score.`,
+    `3. Be objective and consistent. Absence of evidence for a practice means a low score.`,
+    `4. When finished, call submit_result exactly once with a score for EVERY criterion id below,`,
+    `   grouped by category. Include a short justification and evidence paths for each.`,
+    ``,
+    `Rubric:`,
+    rubric
+  ].join("\n");
+}
+
+// src/commands/pr-review.ts
+import pc3 from "picocolors";
+
+// src/core/gh.ts
+import { execFile } from "child_process";
+import { mkdtempSync, rmSync, writeFileSync as writeFileSync2 } from "fs";
+import { tmpdir } from "os";
+import { join as join4 } from "path";
+import { promisify } from "util";
+var exec = promisify(execFile);
+async function gh(args, cwd) {
+  const { stdout } = await exec("gh", args, {
+    cwd,
+    maxBuffer: 64 * 1024 * 1024,
+    env: process.env
+  });
+  return stdout;
+}
+async function ensureGhReady() {
+  try {
+    await exec("gh", ["--version"]);
+  } catch {
+    throw new Error(
+      "GitHub CLI (gh) not found. Install it from https://cli.github.com and run `gh auth login`."
+    );
+  }
+  try {
+    await exec("gh", ["auth", "status"]);
+  } catch {
+    throw new Error("Not authenticated with GitHub. Run `gh auth login` first.");
+  }
+}
+async function getPrContext(ref, repo, cwd) {
+  const repoArgs = repo ? ["--repo", repo] : [];
+  const fields = "number,title,body,author,baseRefName,headRefName,state,url,isCrossRepository,files";
+  const metaRaw = await gh(["pr", "view", ref, ...repoArgs, "--json", fields], cwd);
+  const meta = JSON.parse(metaRaw);
+  const diff = await gh(["pr", "diff", ref, ...repoArgs], cwd);
+  return {
+    number: meta.number,
+    title: meta.title,
+    body: meta.body ?? "",
+    author: meta.author?.login ?? "unknown",
+    baseRefName: meta.baseRefName,
+    headRefName: meta.headRefName,
+    state: meta.state,
+    url: meta.url,
+    isCrossRepository: Boolean(meta.isCrossRepository),
+    files: meta.files ?? [],
+    diff
+  };
+}
+async function checkoutPr(ref, repo, cwd) {
+  const repoArgs = repo ? ["--repo", repo] : [];
+  await gh(["pr", "checkout", ref, ...repoArgs], cwd);
+}
+async function postReview(ctx, repo, event, body, inline, cwd) {
+  const target = repo ?? await currentRepoSlug(cwd);
+  if (inline.length === 0) {
+    const flag = event === "APPROVE" ? "--approve" : event === "REQUEST_CHANGES" ? "--request-changes" : "--comment";
+    await gh(["pr", "review", String(ctx.number), "--repo", target, flag, "--body", body], cwd);
+    return;
+  }
+  const payload = {
+    body,
+    event,
+    comments: inline.map((c) => ({ path: c.path, line: c.line, side: "RIGHT", body: c.body }))
+  };
+  const dir = mkdtempSync(join4(tmpdir(), "edsger-review-"));
+  const file = join4(dir, "review.json");
+  writeFileSync2(file, JSON.stringify(payload), "utf8");
+  try {
+    await gh(
+      ["api", "--method", "POST", `repos/${target}/pulls/${ctx.number}/reviews`, "--input", file],
+      cwd
+    );
+  } catch {
+    const flag = event === "APPROVE" ? "--approve" : event === "REQUEST_CHANGES" ? "--request-changes" : "--comment";
+    await gh(["pr", "review", String(ctx.number), "--repo", target, flag, "--body", body], cwd);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+}
+async function currentRepoSlug(cwd) {
+  const raw = await gh(["repo", "view", "--json", "nameWithOwner"], cwd);
+  return JSON.parse(raw).nameWithOwner;
+}
+async function getPrFeedback(ctx, repo, cwd) {
+  const target = repo ?? await currentRepoSlug(cwd);
+  const reviewRaw = await gh(
+    ["api", `repos/${target}/pulls/${ctx.number}/comments`, "--paginate"],
+    cwd
+  ).catch(() => "[]");
+  const issueRaw = await gh(
+    ["api", `repos/${target}/issues/${ctx.number}/comments`, "--paginate"],
+    cwd
+  ).catch(() => "[]");
+  const review = JSON.parse(reviewRaw);
+  const issue = JSON.parse(issueRaw);
+  return {
+    reviewComments: review.map((c) => ({
+      author: c.user?.login ?? "unknown",
+      path: c.path,
+      line: c.line,
+      body: c.body
+    })),
+    issueComments: issue.map((c) => ({ author: c.user?.login ?? "unknown", body: c.body }))
+  };
+}
+
+// src/commands/pr-review.ts
+var SEVERITY_RANK = {
+  critical: 4,
+  high: 3,
+  medium: 2,
+  low: 1,
+  info: 0
+};
+async function runPrReview(opts) {
+  await ensureGhReady();
+  log.info(`Fetching PR ${pc3.bold(opts.pr)}${opts.repo ? ` from ${opts.repo}` : ""}`);
+  const ctx = await getPrContext(opts.pr, opts.repo, opts.cwd);
+  const { config, path: configPath } = loadConfig(opts.cwd);
+  const configDir = configPath ? `${configPath}/..` : opts.cwd;
+  const fileHint = inferLanguagesFromFiles(
+    ctx.files.map((f) => f.path),
+    findBundledAssetsDir()
+  );
+  const resolved = resolveStandard("review", opts, config, configDir, fileHint);
+  const standard = resolved.standard;
+  log.info(
+    `Reviewing "${pc3.bold(ctx.title)}" (#${ctx.number}, ${ctx.files.length} files) against ${pc3.bold(standard.name)}`
+  );
+  const { result, costUsd, numTurns } = await runAgent({
+    prompt: buildPrompt2(standard, ctx),
+    cwd: opts.cwd,
+    model: opts.model,
+    maxTurns: opts.maxTurns,
+    timeoutMs: opts.timeoutMs,
+    allowWrite: false,
+    verbose: opts.verbose,
+    resultShape: ReviewResultSchema.shape,
+    systemPromptAppend: "You are Edsger, a senior code reviewer. Review only what the diff changes, but read surrounding code for context. Be specific, kind, and actionable; prefer high-signal findings over nitpicks. Do not modify any files."
+  });
+  if (!result) {
+    log.error("The agent did not produce a review.");
+    return 1;
+  }
+  const event = decideEvent(result, standard);
+  const body = renderBody(result, ctx, standard, resolved.layers);
+  const inline = buildInlineComments(result, ctx, standard);
+  printPreview(result, event, numTurns, costUsd);
+  if (opts.json) {
+    process.stdout.write(
+      JSON.stringify(
+        { verdict: result.verdict, event, findings: result.findings, summary: result.summary },
+        null,
+        2
+      ) + "\n"
+    );
+  }
+  if (opts.post && !opts.dryRun) {
+    await postReview(ctx, opts.repo, event, body, inline, opts.cwd);
+    log.success(`Posted review (${event}) to ${ctx.url}`);
+  } else {
+    log.warn(`Preview only. Re-run with ${pc3.bold("--post")} to submit this review to GitHub.`);
+    process.stderr.write("\n" + body + "\n");
+  }
+  return 0;
+}
+function decideEvent(result, standard) {
+  const blocking = new Set(standard.policy.blockingSeverities);
+  const hasBlocking = result.findings.some((f) => blocking.has(f.severity));
+  if (hasBlocking) return "REQUEST_CHANGES";
+  if (result.verdict === "approve") return "APPROVE";
+  if (result.verdict === "request_changes") return "REQUEST_CHANGES";
+  return "COMMENT";
+}
+function buildInlineComments(result, ctx, standard) {
+  const changed = new Set(ctx.files.map((f) => f.path));
+  const sorted = [...result.findings].sort(
+    (a, b) => SEVERITY_RANK[b.severity] - SEVERITY_RANK[a.severity]
+  );
+  const out = [];
+  for (const f of sorted) {
+    if (out.length >= standard.policy.maxComments) break;
+    if (f.line && f.file && f.file !== "-" && changed.has(f.file)) {
+      out.push({ path: f.file, line: f.line, body: renderFinding(f) });
+    }
+  }
+  return out;
+}
+function renderFinding(f) {
+  const head = `**[${f.severity}] ${f.title}**`;
+  const fix = f.suggestion ? `
+
+_Suggestion:_ ${f.suggestion}` : "";
+  return `${head}
+
+${f.detail}${fix}`;
+}
+function renderBody(result, ctx, standard, layers) {
+  const counts = countBySeverity(result.findings);
+  const lines = [];
+  lines.push(`## Edsger review \u2014 ${verdictLabel(result.verdict)}`);
+  lines.push("");
+  lines.push(result.summary);
+  lines.push("");
+  lines.push(
+    `**Findings:** ` + ["critical", "high", "medium", "low", "info"].filter((s) => counts[s]).map((s) => `${counts[s]} ${s}`).join(", ") || "no blocking issues"
+  );
+  lines.push("");
+  const general = result.findings.filter((f) => !f.line || f.file === "-");
+  if (general.length) {
+    lines.push(`### General comments`);
+    lines.push("");
+    for (const f of general) lines.push(`- ${renderFinding(f).replace(/\n+/g, " ")}`);
+    lines.push("");
+  }
+  lines.push("---");
+  lines.push(
+    `<sub>Reviewed against ${standard.name} v${standard.version} (${layers.join(" \u2192 ")}) by [edsger](https://www.npmjs.com/package/edsger).</sub>`
+  );
+  void ctx;
+  return lines.join("\n");
+}
+function printPreview(result, event, numTurns, costUsd) {
+  log.heading(`Verdict: ${event}`);
+  const counts = countBySeverity(result.findings);
+  for (const s of ["critical", "high", "medium", "low", "info"]) {
+    if (counts[s]) process.stderr.write(`  ${sevColor(s)(s.padEnd(8))} ${counts[s]}
+`);
+  }
+  log.step(`${numTurns} turns \xB7 ~$${costUsd.toFixed(3)}`);
+}
+function countBySeverity(findings) {
+  const c = { critical: 0, high: 0, medium: 0, low: 0, info: 0 };
+  for (const f of findings) c[f.severity]++;
+  return c;
+}
+function sevColor(s) {
+  if (s === "critical" || s === "high") return pc3.red;
+  if (s === "medium") return pc3.yellow;
+  return pc3.dim;
+}
+function verdictLabel(v) {
+  return v === "approve" ? "Approve" : v === "request_changes" ? "Request changes" : "Comment";
+}
+function buildPrompt2(standard, ctx) {
+  const focus = standard.focusAreas.map((fa) => {
+    const checklist = (fa.checklist ?? []).map((c) => `    - ${c}`).join("\n");
+    return `- id: ${fa.id} (${fa.title}, default severity ${fa.defaultSeverity ?? "medium"})
+  guidance: ${fa.guidance.trim()}` + (checklist ? `
+  checklist:
+${checklist}` : "");
+  }).join("\n");
+  return [
+    `Review the following pull request.`,
+    ``,
+    `Title: ${ctx.title}`,
+    `Author: ${ctx.author}`,
+    `Base: ${ctx.baseRefName}  Head: ${ctx.headRefName}`,
+    `Description:`,
+    ctx.body ? indent(ctx.body) : "  (no description)",
+    ``,
+    `Changed files: ${ctx.files.map((f) => f.path).join(", ")}`,
+    ``,
+    `Method:`,
+    `1. Read the diff below. Use Read/Grep/Glob to inspect surrounding code in the working`,
+    `   directory for context when needed. Do NOT modify files.`,
+    `2. Evaluate the change against the focus areas. Assign each finding a severity`,
+    `   (critical/high/medium/low/info) and, where it maps to a changed line, the file path`,
+    `   and the 1-based line number in the NEW version of the file.`,
+    `3. Verify the change does what its description claims; flag missing tests for new logic.`,
+    `4. Choose a verdict: approve, request_changes, or comment. Then call submit_result once.`,
+    ``,
+    `Focus areas:`,
+    focus,
+    ``,
+    `Unified diff:`,
+    "```diff",
+    truncate(ctx.diff, 18e4),
+    "```"
+  ].join("\n");
+}
+function indent(s) {
+  return s.split("\n").map((l) => `  ${l}`).join("\n");
+}
+function truncate(s, max) {
+  return s.length > max ? s.slice(0, max) + "\n... [diff truncated] ..." : s;
+}
+
+// src/commands/pr-resolve.ts
+import { execFile as execFile2 } from "child_process";
+import { promisify as promisify2 } from "util";
+import pc4 from "picocolors";
+var exec2 = promisify2(execFile2);
+async function runPrResolve(opts) {
+  await ensureGhReady();
+  log.info(`Fetching PR ${pc4.bold(opts.pr)}${opts.repo ? ` from ${opts.repo}` : ""}`);
+  const ctx = await getPrContext(opts.pr, opts.repo, opts.cwd);
+  const feedback = await getPrFeedback(ctx, opts.repo, opts.cwd).catch(() => ({
+    reviewComments: [],
+    issueComments: []
+  }));
+  if (opts.checkout && !opts.dryRun) {
+    log.step(`checking out PR branch ${ctx.headRefName}`);
+    await checkoutPr(opts.pr, opts.repo, opts.cwd);
+  }
+  log.info(
+    `Resolving "${pc4.bold(ctx.title)}" (#${ctx.number}) \u2014 ${feedback.reviewComments.length} review comments`
+  );
+  const { result, costUsd, numTurns } = await runAgent({
+    prompt: buildPrompt3(ctx, feedback, opts.instruction),
+    cwd: opts.cwd,
+    model: opts.model,
+    maxTurns: Math.max(opts.maxTurns, 30),
+    timeoutMs: Math.max(opts.timeoutMs, 20 * 6e4),
+    allowWrite: true,
+    verbose: opts.verbose,
+    resultShape: ResolveResultSchema.shape,
+    systemPromptAppend: "You are Edsger, a careful senior engineer fixing a pull request. Make the smallest correct change that addresses the feedback. Match the existing code style. After editing, run the project's tests/linters to verify. Never weaken tests to make them pass, and never commit secrets."
+  });
+  if (!result) {
+    log.error("The agent did not produce a result.");
+    return 1;
+  }
+  printSummary2(result, numTurns, costUsd);
+  if (opts.json) process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+  if (opts.push && !opts.dryRun) {
+    const pushed = await commitAndPush(ctx, result, opts.cwd, opts.checkout);
+    if (pushed) log.success(`Committed and pushed to ${ctx.headRefName}`);
+    else log.warn("Nothing to commit \u2014 working tree is clean.");
+  } else {
+    log.warn(
+      `Changes left in the working tree. Review them, then commit/push (or re-run with ${pc4.bold("--push")}).`
+    );
+  }
+  return 0;
+}
+async function commitAndPush(ctx, result, cwd, checkedOut) {
+  const status = await exec2("git", ["status", "--porcelain"], { cwd });
+  if (!status.stdout.trim()) return false;
+  await exec2("git", ["add", "-A"], { cwd });
+  const message = `fix: address review feedback on #${ctx.number}
+
+${result.summary}`;
+  await exec2("git", ["commit", "-m", message], { cwd });
+  if (checkedOut) {
     try {
-        if (!productId && !opts.repoId) {
-            throw new Error('Provide a productId or --repo-id (repo-only mode) for recipes');
-        }
-        await runRecipes(productId, {
-            scanId: opts.scanId,
-            repoId: opts.repoId,
-            guidance: opts.guidance,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
+      await exec2("git", ["push"], { cwd });
+      return true;
+    } catch (err) {
+      if (ctx.isCrossRepository) {
+        throw new Error(
+          `Could not push to the fork's branch automatically: ${errText(err)}
+Push manually, or ensure the PR branch was checked out with gh.`
+        );
+      }
+    }
+  }
+  if (ctx.isCrossRepository) {
+    throw new Error(
+      "This PR is from a fork. Re-run without --no-checkout so gh can configure the push target, or commit and push to the fork manually."
+    );
+  }
+  await exec2("git", ["push", "origin", `HEAD:${ctx.headRefName}`], { cwd });
+  return true;
+}
+function errText(err) {
+  return err instanceof Error ? err.message.split("\n")[0] ?? "" : String(err);
+}
+function printSummary2(result, numTurns, costUsd) {
+  log.heading("Resolution summary");
+  process.stderr.write(`  ${result.summary}
+
+`);
+  if (result.changes.length) {
+    for (const c of result.changes)
+      process.stderr.write(`  ${pc4.green("~")} ${c.file} \u2014 ${c.description}
+`);
+  }
+  if (result.testsRun) log.step(`verification: ${result.testsRun}`);
+  if (result.remaining.length) {
+    log.warn("Remaining items:");
+    for (const r of result.remaining) process.stderr.write(`    - ${r}
+`);
+  }
+  log.step(`${numTurns} turns \xB7 ~$${costUsd.toFixed(3)}`);
+}
+function buildPrompt3(ctx, feedback, instruction) {
+  const reviewComments = feedback.reviewComments.length ? feedback.reviewComments.map((c) => `  - ${c.path}${c.line ? `:${c.line}` : ""} (${c.author}): ${c.body}`).join("\n") : "  (none)";
+  const issueComments = feedback.issueComments.length ? feedback.issueComments.map((c) => `  - ${c.author}: ${c.body}`).join("\n") : "  (none)";
+  return [
+    `Resolve the open items on this pull request by editing the code in the working directory.`,
+    ``,
+    `PR #${ctx.number}: ${ctx.title}`,
+    `Base: ${ctx.baseRefName}  Head: ${ctx.headRefName}`,
+    ``,
+    instruction ? `Primary instruction: ${instruction}` : `Primary goal: address the reviewer feedback below.`,
+    ``,
+    `Inline review comments:`,
+    reviewComments,
+    ``,
+    `Conversation comments:`,
+    issueComments,
+    ``,
+    `Method:`,
+    `1. Understand each requested change. Use Read/Grep/Glob to locate the relevant code.`,
+    `2. Make the minimal, correct edits with Edit/Write. Match existing conventions.`,
+    `3. Run the project's tests and linters (via Bash) to verify your changes pass.`,
+    `4. Do not weaken or delete tests to make them pass; do not introduce secrets.`,
+    `5. Call submit_result once with a summary, the list of files changed, how you verified,`,
+    `   and anything you could not resolve.`
+  ].join("\n");
+}
+
+// src/commands/skills.ts
+import {
+  cpSync,
+  existsSync as existsSync3,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync2,
+  readdirSync as readdirSync2,
+  rmSync as rmSync2,
+  statSync as statSync2,
+  writeFileSync as writeFileSync3
+} from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join5 } from "path";
+import pc5 from "picocolors";
+var MANAGED = ["benchmark", "pr-review", "pr-resolve"];
+function targetSkillsDir(scope) {
+  return scope.global ? join5(homedir2(), ".claude", "skills") : join5(scope.cwd, ".claude", "skills");
+}
+function sourceSkillsDir() {
+  return join5(findBundledAssetsDir(), "skills");
+}
+async function runSkillsInstall(opts) {
+  const assetsDir = findBundledAssetsDir();
+  const src = sourceSkillsDir();
+  if (!existsSync3(src)) {
+    log.error(`Bundled skills not found at ${src}. Reinstall edsger.`);
+    return 1;
+  }
+  const dest = targetSkillsDir(opts);
+  mkdirSync2(dest, { recursive: true });
+  const available = readdirSync2(src).filter((n) => existsSync3(join5(src, n, "SKILL.md")));
+  let installed = 0;
+  for (const name of available) {
+    const outDir = join5(dest, name);
+    if (existsSync3(outDir) && !opts.force) {
+      log.warn(`skill "${name}" already exists \u2014 use --force to overwrite`);
+      continue;
+    }
+    rmSync2(outDir, { recursive: true, force: true });
+    cpSync(join5(src, name), outDir, { recursive: true });
+    const skillFile = join5(outDir, "SKILL.md");
+    const rewritten = readFileSync2(skillFile, "utf8").split("${CLAUDE_PLUGIN_ROOT}").join(assetsDir);
+    writeFileSync3(skillFile, rewritten, "utf8");
+    installed++;
+    log.success(`installed /${name}`);
+  }
+  if (installed === 0) {
+    log.info("Nothing installed.");
+    return 0;
+  }
+  log.heading(`Installed ${installed} skill(s) into ${pc5.bold(dest)}`);
+  log.step(`scope: ${opts.global ? "user (all projects)" : "this project"}`);
+  log.step(`standards: ${assetsDir}`);
+  log.step("Open Claude Code and run /benchmark, /pr-review, or /pr-resolve.");
+  return 0;
+}
+async function runSkillsUninstall(opts) {
+  const dest = targetSkillsDir(opts);
+  let removed = 0;
+  for (const name of MANAGED) {
+    const dir = join5(dest, name);
+    if (existsSync3(dir)) {
+      rmSync2(dir, { recursive: true, force: true });
+      removed++;
+      log.success(`removed /${name}`);
+    }
+  }
+  log.info(removed ? `Removed ${removed} skill(s) from ${dest}` : "No edsger skills found.");
+  return 0;
+}
+async function runSkillsList(opts) {
+  for (const [label, scope] of [
+    ["user", { ...opts, global: true }],
+    ["project", { ...opts, global: false }]
+  ]) {
+    const dir = targetSkillsDir(scope);
+    const present = MANAGED.filter((n) => {
+      const p = join5(dir, n, "SKILL.md");
+      return existsSync3(p) && statSync2(p).isFile();
+    });
+    log.heading(`${label}: ${dir}`);
+    if (present.length) for (const n of present) process.stderr.write(`  ${pc5.green("\u2713")} /${n}
+`);
+    else process.stderr.write(`  ${pc5.dim("(none installed)")}
+`);
+  }
+  return 0;
+}
+
+// src/index.ts
+var VERSION = "0.78.0";
+var DEFAULT_MODEL = "claude-sonnet-4-6";
+function toGlobal(raw) {
+  setVerbose(Boolean(raw.verbose));
+  return {
+    cwd: resolve2(raw.cwd ?? process.cwd()),
+    model: raw.model ?? process.env.EDSGER_MODEL ?? DEFAULT_MODEL,
+    standardPath: raw.standard,
+    assetsPath: raw.assets,
+    lang: raw.lang,
+    json: Boolean(raw.json),
+    verbose: Boolean(raw.verbose),
+    dryRun: Boolean(raw.dryRun),
+    maxTurns: raw.maxTurns ? Number.parseInt(raw.maxTurns, 10) : 20,
+    timeoutMs: (raw.timeout ? Number.parseFloat(raw.timeout) : 15) * 6e4
+  };
+}
+function addGlobalOptions(cmd) {
+  return cmd.option("-C, --cwd <dir>", "directory of the repository to operate on").addOption(new Option("-m, --model <model>", "model id for the agent").default(void 0)).option("--standard <path>", "path to a custom standards dir or file (overrides bundled)").option("--assets <path>", "override the entire assets root").option("--lang <id>", "force a language id, skipping detection").option("--max-turns <n>", "max agentic turns").option("--timeout <minutes>", "hard wall-clock limit per agent run (default 15)").option("--json", "print machine-readable JSON to stdout").option("-v, --verbose", "verbose logging").option("--dry-run", "run the agent but make no persistent/external changes");
+}
+async function guard(fn) {
+  try {
+    const code = await fn();
+    process.exitCode = code;
+  } catch (err) {
+    log.error(err instanceof Error ? err.message : String(err));
+    if (process.env.EDSGER_DEBUG && err instanceof Error)
+      process.stderr.write((err.stack ?? "") + "\n");
+    process.exitCode = 1;
+  }
+}
+var program = new Command();
+program.name("edsger").description(
+  "Agentic CLI to benchmark repositories and review/resolve pull requests\nagainst industrial-grade standards (from edsger-assets, fully overridable)."
+).version(VERSION, "-V, --version");
+addGlobalOptions(
+  program.command("benchmark").description("Score a repository against a benchmark rubric and write a report").option("--out <dir>", "report output directory (relative to repo)", ".edsger/benchmark").option("--no-write", "do not write report files into the repo")
+).action(async (opts) => {
+  await guard(
+    () => runBenchmark({ ...toGlobal(opts), out: opts.out, noWrite: opts.write === false })
+  );
 });
-// ============================================================
-// Subcommand: edsger features <productId>
-// ============================================================
-program
-    .command('features <productId>')
-    .description('Scan every repository linked to a product for the user-facing features it delivers and persist them via the product_features table. Manually defined features are enriched, never rewritten. Writes against the pending feature_scans row identified by --scan-id.')
-    .requiredOption('--scan-id <id>', 'Pending feature_scans row id to drive (created by the desktop UI before invocation)')
-    .option('-g, --guidance <text>', 'Human direction for the AI (focus areas, exclusions)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        await runFeatures(productId, {
-            scanId: opts.scanId,
-            guidance: opts.guidance,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        exitWithError(error);
-    }
+addGlobalOptions(
+  program.command("pr-review").description("Review a pull request against the review standard (requires gh)").argument("<pr>", "PR number, URL, or branch").option("--repo <owner/repo>", "target repository (defaults to current)").option("--post", "submit the review to GitHub (otherwise preview only)")
+).action(async (pr, opts) => {
+  await guard(
+    () => runPrReview({ ...toGlobal(opts), pr, repo: opts.repo, post: Boolean(opts.post) })
+  );
 });
-// ============================================================
-// Subcommand: edsger api-docs <productId>
-// ============================================================
-program
-    .command('api-docs [productId]')
-    .description("Generate an API reference (Markdown + an optional OpenAPI 3.x document) for a product's (or standalone repository's) codebase by determining the API surface it exposes from its source. Writes against the pending api_doc_runs row identified by --run-id.")
-    .requiredOption('--run-id <id>', 'Pending api_doc_runs row id to drive (created by the desktop UI before invocation)')
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('-g, --guidance <text>', 'Human direction for the AI (focus areas, exclusions)')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        if (!productId && !opts.repoId) {
-            throw new Error('Provide a productId or --repo-id (repo-only mode) for api-docs');
-        }
-        await runApiDocs(productId, {
-            runId: opts.runId,
-            repoId: opts.repoId,
-            guidance: opts.guidance,
-            verbose: opts.verbose,
-        });
-    }
-    catch (error) {
-        logError(error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
+addGlobalOptions(
+  program.command("pr-resolve").description("Resolve review feedback / fix a pull request (requires gh)").argument("<pr>", "PR number, URL, or branch").option("--repo <owner/repo>", "target repository (defaults to current)").option("--instruction <text>", "what to do (defaults to addressing review comments)").option("--no-checkout", "do not check out the PR branch first").option("--push", "commit and push the changes when done")
+).action(
+  async (pr, opts) => {
+    await guard(
+      () => runPrResolve({
+        ...toGlobal(opts),
+        pr,
+        repo: opts.repo,
+        instruction: opts.instruction,
+        checkout: opts.checkout !== false,
+        push: Boolean(opts.push)
+      })
+    );
+  }
+);
+var skills = program.command("skills").description("install edsger as Claude Code skills (/benchmark, /pr-review, /pr-resolve)");
+skills.command("install").description("install the skills into Claude Code").option("--global", "install for the current user (~/.claude/skills) [default]").option("--project", "install into ./.claude/skills instead").option("-C, --cwd <dir>", "project directory (with --project)").option("--force", "overwrite existing skills").action(async (opts) => {
+  await guard(
+    () => runSkillsInstall({
+      cwd: resolve2(opts.cwd ?? process.cwd()),
+      global: opts.project ? false : true,
+      force: Boolean(opts.force)
+    })
+  );
 });
-// ============================================================
-// Subcommand: edsger pr-resolve <productId>
-// ============================================================
-program
-    .command('pr-resolve [productId]')
-    .description('AI-resolve change requests on a GitHub PR for a product (or standalone repository)')
-    .requiredOption('--pr-url <url>', 'GitHub PR URL')
-    .option('--pr-id <id>', 'Pull request record ID in database')
-    .option('--repo-id <id>', 'Run in repo-only mode against a single repositories row (no product context)')
-    .option('--no-learn', 'Skip checklist learning after resolve')
-    .option('-v, --verbose', 'Verbose output')
-    .action(async (productId, opts) => {
-    try {
-        if (!productId && !opts.repoId) {
-            throw new Error('Provide a productId or --repo-id (repo-only mode) for pr-resolve');
-        }
-        await runPRResolve(productId, opts);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
+skills.command("uninstall").description("remove the edsger skills from Claude Code").option("--global", "remove from the user scope (~/.claude/skills) [default]").option("--project", "remove from ./.claude/skills instead").option("-C, --cwd <dir>", "project directory (with --project)").action(async (opts) => {
+  await guard(
+    () => runSkillsUninstall({
+      cwd: resolve2(opts.cwd ?? process.cwd()),
+      global: opts.project ? false : true
+    })
+  );
 });
-// ============================================================
-// Default command (options-based, backward compatible)
-// ============================================================
-program
-    .option('-r, --review', 'Review code changes')
-    .option('-s, --staged', 'Review only staged changes')
-    .option('-f, --files <patterns...>', 'Review specific file patterns')
-    .option('--refactor', 'Refactor code in current directory')
-    .option('--init', 'Initialize .edsger directory with project templates')
-    .option('--product-level', 'Use legacy product-level workflow (requires EDSGER_PRODUCT_ID, EDSGER_MCP_SERVER_URL, EDSGER_MCP_TOKEN env vars)')
-    .option('--watch-tasks <productId>', 'Watch and execute pending tasks for a product')
-    .option('--concurrency <number>', 'Max concurrent issues to process (default: 3)', parseInt)
-    .option('-c, --config <path>', 'Path to config file')
-    .option('-v, --verbose', 'Verbose output');
-program.action(async (options, command) => {
-    // Commander silently falls through to this default action when the user
-    // passes a subcommand name that isn't registered (e.g. an old binary that
-    // doesn't yet know about `sync-sentry-issues`). That makes version-skew
-    // bugs look like the agent inexplicably running with the wrong intent.
-    // Treat any leftover positional arg as an unknown command and abort.
-    if (command.args.length > 0) {
-        logError(`Run 'edsger --help' to see available commands.`);
-        exitWithError(new Error(`Unknown command: ${command.args[0]}`));
-        return;
-    }
-    try {
-        await runEdsger(options);
-    }
-    catch (error) {
-        exitWithError(error);
-    }
+skills.command("list").description("show which edsger skills are installed").option("-C, --cwd <dir>", "project directory").action(async (opts) => {
+  await guard(() => runSkillsList({ cwd: resolve2(opts.cwd ?? process.cwd()), global: true }));
 });
-export const runEdsger = async (options) => {
-    // Handle init mode
-    if (options.init) {
-        await runInit(options);
-        return;
-    }
-    // Handle task watcher mode
-    if (options.watchTasks) {
-        await runTaskWorker(options);
-        return;
-    }
-    // Handle refactor mode
-    if (options.refactor) {
-        await runRefactor(options);
-        return;
-    }
-    // Handle code review mode
-    if (options.review || options.staged || options.files) {
-        await runCodeReview(options);
-        return;
-    }
-    // Handle legacy product-level workflow mode
-    if (options.productLevel) {
-        logInfo('Running in legacy product-level mode...');
-        await runWorkflow(options);
-        return;
-    }
-    // Auto-detect: if EDSGER_PRODUCT_ID is set, use legacy mode for backward compatibility
-    if (process.env.EDSGER_PRODUCT_ID) {
-        logInfo('EDSGER_PRODUCT_ID detected. Using legacy product-level mode. Use `edsger login` for the new cross-product mode.');
-        await runWorkflow(options);
-        return;
-    }
-    // Default: new agent workflow mode (cross-product)
-    await runAgentWorkflow(options);
-};
-// Only parse when this file is run directly (not imported as module)
-// Check if this is the main module being executed
-const isMainModule = import.meta.url === `file://${process.argv[1]}` ||
-    process.argv[1]?.endsWith('/edsger') ||
-    process.argv[1]?.endsWith('\\edsger') ||
-    process.argv[1]?.endsWith('index.js');
-if (isMainModule) {
-    program.parse();
-}
+program.addHelpText(
+  "after",
+  `
+Examples:
+  ${pc6.dim("$")} edsger benchmark
+  ${pc6.dim("$")} edsger benchmark -C ./my-repo --json
+  ${pc6.dim("$")} edsger pr-review 123 --post
+  ${pc6.dim("$")} edsger pr-resolve 123 --instruction "fix the failing test" --push
+  ${pc6.dim("$")} edsger skills install   ${pc6.dim("# enable /benchmark etc. in Claude Code")}
+
+Auth: set ANTHROPIC_API_KEY for the agent; run \`gh auth login\` for PR commands.
+`
+);
+program.parseAsync(process.argv);
+//# sourceMappingURL=index.js.map