mergen-server 1.4.0

package/dist/commands/github.js

@@ -0,0 +1,632 @@
+import { execSync } from "child_process";
+import { writeFileSync } from "fs";
+import { log, success, error, hr, ask } from "./shared.js";
+async function prCommand(args) {
+  const copyFlag = args.includes("--copy");
+  const outputFile = args.find((a) => a.startsWith("--out="))?.slice(6) ?? null;
+  let port = 3e3;
+  for (let p = 3e3; p <= 3010; p++) {
+    try {
+      const r = await fetch(`http://127.0.0.1:${p}/health`, { signal: AbortSignal.timeout(500) });
+      if (r.ok) {
+        port = p;
+        break;
+      }
+    } catch {
+    }
+  }
+  const [health, calibRaw, freqRaw] = await Promise.all([
+    fetch(`http://127.0.0.1:${port}/health`, { signal: AbortSignal.timeout(1500) }).then((r) => r.json()).catch(() => ({})),
+    fetch(`http://127.0.0.1:${port}/calibration`, { signal: AbortSignal.timeout(1500) }).then((r) => r.json()).catch(() => ({})),
+    fetch(`http://127.0.0.1:${port}/error-frequency`, { signal: AbortSignal.timeout(1500) }).then((r) => r.json()).catch(() => ({}))
+  ]);
+  let branch = "unknown-branch";
+  let commits = [];
+  let changedFiles = [];
+  try {
+    branch = execSync("git rev-parse --abbrev-ref HEAD", { encoding: "utf8" }).trim();
+    commits = execSync("git log origin/main..HEAD --oneline --no-merges 2>/dev/null || git log HEAD~5..HEAD --oneline --no-merges", { encoding: "utf8" }).trim().split("\n").filter(Boolean);
+    changedFiles = execSync("git diff --name-only origin/main 2>/dev/null || git diff --name-only HEAD~1", { encoding: "utf8" }).trim().split("\n").filter(Boolean);
+  } catch {
+  }
+  const errors = health.errors ?? 0;
+  const netErrs = health.networkErrors ?? 0;
+  const warns = health.warnings ?? 0;
+  const detectors = calibRaw.perDetector ?? [];
+  const trusted = detectors.filter((d) => d.trusted && d.accuracy >= 0.5);
+  const suppressed = detectors.filter((d) => d.trusted && d.accuracy < 0.2);
+  const lines = [];
+  lines.push(`## Summary`);
+  lines.push("");
+  if (commits.length > 0) {
+    for (const c of commits.slice(0, 5)) {
+      const msg = c.replace(/^[0-9a-f]+\s+/, "").replace(/^(fix|feat|chore|refactor|docs|test):\s*/i, "");
+      lines.push(`- ${msg}`);
+    }
+  } else {
+    lines.push(`- Changes on branch \`${branch}\``);
+  }
+  lines.push("");
+  lines.push(`## Runtime verification`);
+  lines.push("");
+  lines.push(`_Captured by Mergen during development on branch \`${branch}\`_`);
+  lines.push("");
+  if (errors === 0 && netErrs === 0 && warns === 0) {
+    lines.push("\u2705 **Buffer clean** \u2014 no console errors, network failures, or warnings at time of PR creation.");
+  } else {
+    if (errors > 0 || netErrs > 0) {
+      lines.push(`\u26A0\uFE0F **${errors + netErrs} error(s) remain in buffer** \u2014 review before merging.`);
+    }
+    if (warns > 0) {
+      lines.push(`\u26A0\uFE0F **${warns} warning(s)** in buffer.`);
+    }
+  }
+  const consoleFreq = freqRaw.console ?? [];
+  const netFreq = freqRaw.network ?? [];
+  if (consoleFreq.length > 0 || netFreq.length > 0) {
+    lines.push("");
+    lines.push("**Error patterns seen during development:**");
+    for (const e of consoleFreq.slice(0, 3)) {
+      lines.push(`- \`${e.fingerprint}\` \u2014 ${e.count}\xD7 \u2014 "${e.sample.slice(0, 80)}"`);
+    }
+    for (const n of netFreq.slice(0, 2)) {
+      lines.push(`- ${n.sample.slice(0, 100)} \u2014 ${n.count}\xD7`);
+    }
+  }
+  if (suppressed.length > 0) {
+    lines.push("");
+    lines.push(`**Suppressed noise patterns:** ${suppressed.map((d) => `\`${d.tag}\``).join(", ")}`);
+    lines.push("_(Mergen suppresses detectors with < 20% accuracy \u2014 these fired but were consistently wrong)_");
+  }
+  lines.push("");
+  lines.push(`## Files changed (${changedFiles.length})`);
+  lines.push("");
+  const grouped = {};
+  for (const f of changedFiles.slice(0, 20)) {
+    const dir = f.includes("/") ? f.split("/").slice(0, 2).join("/") : ".";
+    grouped[dir] = grouped[dir] ?? [];
+    grouped[dir].push(f);
+  }
+  for (const [dir, files] of Object.entries(grouped)) {
+    lines.push(`**${dir}/**`);
+    for (const f of files) lines.push(`- \`${f}\``);
+  }
+  if (changedFiles.length > 20) lines.push(`_...and ${changedFiles.length - 20} more_`);
+  lines.push("");
+  lines.push(`## Test plan`);
+  lines.push("");
+  lines.push("- [ ] Manually reproduced the scenario in the browser");
+  lines.push("- [ ] Mergen buffer clean before merge (`mergen-server guard`)");
+  lines.push("- [ ] Unit tests pass");
+  if (changedFiles.some((f) => /api|route|endpoint|controller|handler/i.test(f))) {
+    lines.push("- [ ] API contract unchanged (or migration included)");
+  }
+  if (changedFiles.some((f) => /auth|login|token|session/i.test(f))) {
+    lines.push("- [ ] Auth flow tested (login, logout, token refresh)");
+  }
+  lines.push("");
+  lines.push(`---`);
+  lines.push(`_Generated by [Mergen](https://github.com/omertt27/Mergen) \u2014 runtime context captured automatically during development._`);
+  const output = lines.join("\n");
+  if (outputFile) {
+    writeFileSync(outputFile, output, "utf8");
+    success(`PR description written to ${outputFile}`);
+  } else if (copyFlag) {
+    try {
+      const clipCmd = process.platform === "darwin" ? "pbcopy" : process.platform === "win32" ? "clip" : "xclip -selection clipboard";
+      const { execSync: exec2 } = await import("child_process");
+      exec2(`echo ${JSON.stringify(output)} | ${clipCmd}`);
+      success("PR description copied to clipboard.");
+    } catch {
+      console.log(output);
+      log("(Could not copy to clipboard \u2014 output above)");
+    }
+  } else {
+    console.log("\n" + output + "\n");
+    log("Tip: --copy to copy to clipboard, --out=pr.md to write to file");
+  }
+}
+async function connectGitHubCommand(args) {
+  const { randomBytes } = await import("crypto");
+  const { mkdirSync: mkdirSync2, writeFileSync: writeFileSync2, readFileSync: readFileSync2, existsSync: existsSync2 } = await import("fs");
+  const { join: join2 } = await import("path");
+  const { homedir: homedir2 } = await import("os");
+  let repo = "";
+  let token = process.env.GITHUB_TOKEN ?? "";
+  let mergenUrl = "";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--repo" && args[i + 1]) {
+      repo = args[++i];
+      continue;
+    }
+    if (args[i] === "--token" && args[i + 1]) {
+      token = args[++i];
+      continue;
+    }
+    if (args[i] === "--mergen-url" && args[i + 1]) {
+      mergenUrl = args[++i];
+      continue;
+    }
+    if (args[i].startsWith("--repo=")) {
+      repo = args[i].slice(7);
+      continue;
+    }
+    if (args[i].startsWith("--token=")) {
+      token = args[i].slice(8);
+      continue;
+    }
+    if (args[i].startsWith("--mergen-url=")) {
+      mergenUrl = args[i].slice(13);
+      continue;
+    }
+  }
+  console.log("\nMergen \xD7 GitHub \u2014 Automated Webhook Setup\n");
+  hr();
+  if (!repo) {
+    repo = await ask("GitHub repo (owner/repo, e.g. acme/api): ");
+    repo = repo.trim();
+  }
+  if (!/^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/.test(repo)) {
+    error(`Invalid repo format: "${repo}". Expected owner/repo.`);
+    process.exit(1);
+  }
+  if (!token) {
+    console.log("\nA GitHub Personal Access Token with repo:admin scope is required.");
+    console.log("Create one at: https://github.com/settings/tokens/new");
+    console.log('  \u2192 Required scope: "repo" (or "admin:repo_hook" for fine-grained tokens)\n');
+    token = await ask("GitHub Personal Access Token: ");
+    token = token.trim();
+  }
+  if (!token) {
+    error("Token is required. Set GITHUB_TOKEN env var or pass --token.");
+    process.exit(1);
+  }
+  if (!mergenUrl) {
+    const port = process.env.HTTP_PORT ?? "3000";
+    const defaultUrl = `http://127.0.0.1:${port}`;
+    const input = await ask(`Mergen server URL [${defaultUrl}]: `);
+    mergenUrl = input.trim() || defaultUrl;
+  }
+  mergenUrl = mergenUrl.replace(/\/$/, "");
+  const webhookUrl = `${mergenUrl}/webhooks/github`;
+  const webhookSecret = randomBytes(32).toString("hex");
+  process.stdout.write("\nChecking existing webhooks... ");
+  let existingId = null;
+  try {
+    const listRes = await fetch(`https://api.github.com/repos/${repo}/hooks`, {
+      headers: {
+        Authorization: `Bearer ${token}`,
+        Accept: "application/vnd.github+json",
+        "X-GitHub-Api-Version": "2022-11-28"
+      },
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!listRes.ok) {
+      console.log("\u2717");
+      const body = await listRes.text();
+      if (listRes.status === 401) {
+        error("GitHub authentication failed. Check your personal access token.");
+      } else if (listRes.status === 403) {
+        error('Permission denied. Token needs "repo" or "admin:repo_hook" scope.');
+      } else if (listRes.status === 404) {
+        error(`Repository "${repo}" not found. Check the name and token permissions.`);
+      } else {
+        error(`GitHub API error ${listRes.status}: ${body.slice(0, 150)}`);
+      }
+      process.exit(1);
+    }
+    const hooks = await listRes.json();
+    const existing2 = hooks.find((h) => h.config?.url?.includes("/webhooks/github"));
+    if (existing2) {
+      existingId = existing2.id;
+      console.log(`\u2713 (found existing Mergen webhook id=${existingId})`);
+    } else {
+      console.log("\u2713 (none found)");
+    }
+  } catch (e) {
+    console.log("\u2717");
+    error(`Could not reach GitHub API: ${e instanceof Error ? e.message : String(e)}`);
+    process.exit(1);
+  }
+  const hookPayload = {
+    name: "web",
+    active: true,
+    events: ["pull_request", "pull_request_review", "push"],
+    config: {
+      url: webhookUrl,
+      content_type: "json",
+      secret: webhookSecret,
+      insecure_ssl: "0"
+    }
+  };
+  if (existingId) {
+    process.stdout.write(`Updating webhook ${existingId}... `);
+  } else {
+    process.stdout.write("Registering webhook... ");
+  }
+  try {
+    const method = existingId ? "PATCH" : "POST";
+    const hookUrl = existingId ? `https://api.github.com/repos/${repo}/hooks/${existingId}` : `https://api.github.com/repos/${repo}/hooks`;
+    const createRes = await fetch(hookUrl, {
+      method,
+      headers: {
+        Authorization: `Bearer ${token}`,
+        Accept: "application/vnd.github+json",
+        "Content-Type": "application/json",
+        "X-GitHub-Api-Version": "2022-11-28"
+      },
+      body: JSON.stringify(hookPayload),
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!createRes.ok) {
+      console.log("\u2717");
+      const body = await createRes.text();
+      error(`GitHub API error ${createRes.status}: ${body.slice(0, 200)}`);
+      process.exit(1);
+    }
+    const hook = await createRes.json();
+    console.log(`\u2713  (id=${hook.id})`);
+  } catch (e) {
+    console.log("\u2717");
+    error(`Webhook registration failed: ${e instanceof Error ? e.message : String(e)}`);
+    process.exit(1);
+  }
+  const configDir = join2(homedir2(), ".mergen");
+  const configPath = join2(configDir, "config.json");
+  let existing = {};
+  if (existsSync2(configPath)) {
+    try {
+      existing = JSON.parse(readFileSync2(configPath, "utf8"));
+    } catch {
+    }
+  }
+  mkdirSync2(configDir, { recursive: true });
+  const github = existing.github ?? {};
+  const repos = github.repos ?? [];
+  if (!repos.includes(repo)) repos.push(repo);
+  const config = {
+    ...existing,
+    github: { ...github, webhookSecret, repos, token }
+  };
+  writeFileSync2(configPath, JSON.stringify(config, null, 2), { encoding: "utf8", mode: 384 });
+  const secretFile = join2(configDir, "github-webhook-secret");
+  writeFileSync2(secretFile, webhookSecret, { encoding: "utf8", mode: 384 });
+  hr();
+  success(`GitHub webhook registered for ${repo}`);
+  console.log("");
+  console.log("What happens next:");
+  console.log("  \xB7 Every merged PR now populates the intent archive automatically");
+  console.log('  \xB7 In your AI IDE: ask "explain why service X has a 30s timeout"');
+  console.log("  \xB7 The archive grows with every commit \u2014 no manual steps needed");
+  console.log("");
+  console.log("To verify the webhook is receiving events:");
+  console.log("  mergen-server doctor   (checks GitHub webhook status)");
+  console.log("");
+  log("Restart the server to load the new secret: mergen-server start", "\u2139");
+  process.env.GITHUB_WEBHOOK_SECRET = webhookSecret;
+}
+async function backfillGitHubCommand(args) {
+  const path2 = await import("path");
+  const os2 = await import("os");
+  const fs = await import("fs");
+  let repo = "";
+  let token = process.env.GITHUB_TOKEN ?? "";
+  let sinceMs = Date.now() - 180 * 24 * 60 * 60 * 1e3;
+  for (let i = 0; i < args.length; i++) {
+    if ((args[i] === "--repo" || args[i] === "-r") && args[i + 1]) {
+      repo = args[++i];
+      continue;
+    }
+    if ((args[i] === "--token" || args[i] === "-t") && args[i + 1]) {
+      token = args[++i];
+      continue;
+    }
+    if (args[i] === "--since" && args[i + 1]) {
+      const raw = args[++i];
+      const daysMatch = raw.match(/^(\d+)d$/i);
+      if (daysMatch) {
+        sinceMs = Date.now() - parseInt(daysMatch[1]) * 24 * 60 * 60 * 1e3;
+      } else {
+        const parsed = Date.parse(raw);
+        if (!isNaN(parsed)) sinceMs = parsed;
+        else {
+          error(`Invalid --since value: "${raw}". Use e.g. 180d or 2024-01-01`);
+          process.exit(1);
+        }
+      }
+      continue;
+    }
+    if (args[i].startsWith("--repo=")) {
+      repo = args[i].slice(7);
+      continue;
+    }
+    if (args[i].startsWith("--token=")) {
+      token = args[i].slice(8);
+      continue;
+    }
+    if (args[i].startsWith("--since=")) {
+      const raw = args[i].slice(8);
+      const daysMatch = raw.match(/^(\d+)d$/i);
+      if (daysMatch) sinceMs = Date.now() - parseInt(daysMatch[1]) * 24 * 60 * 60 * 1e3;
+      else {
+        const parsed = Date.parse(raw);
+        if (!isNaN(parsed)) sinceMs = parsed;
+      }
+      continue;
+    }
+  }
+  console.log("\nMergen \u2014 GitHub Historical Backfill\n");
+  hr();
+  if (!repo) {
+    repo = await ask("GitHub repo (owner/repo): ");
+    repo = repo.trim();
+  }
+  if (!/^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/.test(repo)) {
+    error(`Invalid repo format: "${repo}". Expected owner/repo.`);
+    process.exit(1);
+  }
+  if (!token) {
+    const configPath = path2.join(os2.homedir(), ".mergen", "config.json");
+    try {
+      const cfg = JSON.parse(fs.readFileSync(configPath, "utf8"));
+      const gh = cfg.github ?? {};
+      if (typeof gh.token === "string") token = gh.token;
+    } catch {
+    }
+  }
+  if (!token) {
+    console.log("\nA GitHub Personal Access Token with repo read scope is required.");
+    token = await ask("GitHub Personal Access Token: ");
+    token = token.trim();
+  }
+  if (!token) {
+    error("Token is required. Set GITHUB_TOKEN env var or pass --token.");
+    process.exit(1);
+  }
+  const sinceDate = new Date(sinceMs).toISOString().slice(0, 10);
+  log(`Importing merged PRs for ${repo} since ${sinceDate}...`);
+  console.log("");
+  let upsertFn = null;
+  try {
+    const { commitContextStore } = await import("../sensor/commit-context-store.js");
+    await commitContextStore.init();
+    upsertFn = (ctx) => commitContextStore.upsert(ctx);
+  } catch (e) {
+    error(`Could not initialise commit context store: ${e instanceof Error ? e.message : String(e)}`);
+    process.exit(1);
+  }
+  const { extractLinkedIssues } = await import("../sensor/commit-context-store.js");
+  const { detectAiCommit } = await import("../intelligence/ai-commit.js");
+  const headers = {
+    Authorization: `Bearer ${token}`,
+    Accept: "application/vnd.github+json",
+    "X-GitHub-Api-Version": "2022-11-28"
+  };
+  let page = 1;
+  let imported = 0;
+  let skipped = 0;
+  let done = false;
+  const PAGE_SIZE = 100;
+  process.stdout.write("Fetching: ");
+  while (!done) {
+    const url = `https://api.github.com/repos/${repo}/pulls?state=closed&sort=updated&direction=desc&per_page=${PAGE_SIZE}&page=${page}`;
+    let prs;
+    try {
+      const res = await fetch(url, { headers, signal: AbortSignal.timeout(15e3) });
+      if (!res.ok) {
+        console.log("");
+        if (res.status === 401) {
+          error("GitHub authentication failed \u2014 check your token.");
+        } else if (res.status === 403) {
+          const remaining = res.headers.get("x-ratelimit-remaining");
+          const reset = res.headers.get("x-ratelimit-reset");
+          if (remaining === "0" && reset) {
+            const waitSec = Math.ceil(parseInt(reset) - Date.now() / 1e3);
+            error(`GitHub rate limit hit. Try again in ${waitSec}s, or use a different token.`);
+          } else {
+            error('GitHub permission denied \u2014 token needs "repo" read scope.');
+          }
+        } else if (res.status === 404) {
+          error(`Repository "${repo}" not found. Check the name and token permissions.`);
+        } else {
+          error(`GitHub API error ${res.status}: ${await res.text().then((t) => t.slice(0, 120))}`);
+        }
+        process.exit(1);
+      }
+      prs = await res.json();
+    } catch (e) {
+      console.log("");
+      error(`Network error: ${e instanceof Error ? e.message : String(e)}`);
+      process.exit(1);
+    }
+    if (!Array.isArray(prs) || prs.length === 0) break;
+    for (const pr of prs) {
+      const mergedAt = pr.merged_at ? Date.parse(String(pr.merged_at)) : null;
+      if (!mergedAt) {
+        skipped++;
+        continue;
+      }
+      if (mergedAt < sinceMs) {
+        done = true;
+        break;
+      }
+      const sha = String(
+        pr.merge_commit_sha ?? (pr.head?.sha ?? "")
+      );
+      if (!sha) {
+        skipped++;
+        continue;
+      }
+      const prNumber = typeof pr.number === "number" ? pr.number : null;
+      const prTitle = typeof pr.title === "string" ? pr.title : null;
+      const prBody = typeof pr.body === "string" ? pr.body : null;
+      const author = pr.user?.login;
+      const branch = pr.head?.ref;
+      const headSha = String(pr.head?.sha ?? "");
+      const aiResult = detectAiCommit(prTitle ?? "", typeof author === "string" ? author : void 0);
+      const linkedIssues = extractLinkedIssues(prBody ?? "");
+      const reviewers = pr.requested_reviewers ?? [];
+      const approvers = reviewers.map((r) => String(r.login ?? "")).filter(Boolean);
+      upsertFn({
+        sha,
+        repo,
+        branch: typeof branch === "string" ? branch : null,
+        prNumber,
+        prTitle,
+        prBody,
+        author: typeof author === "string" ? author : null,
+        approvers,
+        linkedIssues,
+        aiGenerated: aiResult.detected,
+        aiTool: aiResult.tool ?? null,
+        filesChanged: [],
+        // skipped for backfill — requires 1 extra API call per PR
+        capturedAt: Date.now(),
+        mergedAt
+      });
+      imported++;
+      if (imported % 10 === 0) process.stdout.write(".");
+    }
+    if (prs.length < PAGE_SIZE) break;
+    page++;
+  }
+  console.log("");
+  hr();
+  success(`Imported ${imported} PRs from ${repo}`);
+  if (skipped > 0) log(`${skipped} PRs skipped (unmerged or outside date window)`, "\u2139");
+  console.log("");
+  console.log("The intent archive is now populated. Try it:");
+  console.log(`  Ask your AI IDE: "explain why <service> works the way it does"`);
+  console.log(`  Or run:          mergen-server timeline`);
+  console.log("");
+  log(`To keep the archive current, connect the live webhook: mergen-server connect github --repo ${repo}`, "\u2139");
+}
+async function prShadowCommand() {
+  let port = 0;
+  for (let p = 3e3; p <= 3010; p++) {
+    try {
+      const r = await fetch(`http://127.0.0.1:${p}/health`, { signal: AbortSignal.timeout(600) });
+      if (r.ok) {
+        port = p;
+        break;
+      }
+    } catch {
+    }
+  }
+  if (!port) {
+    error("Server not running. Start with: mergen-server start");
+    process.exit(1);
+  }
+  let data;
+  try {
+    const r = await fetch(`http://127.0.0.1:${port}/pr-shadow/stats`, { signal: AbortSignal.timeout(3e3) });
+    data = await r.json();
+  } catch (err) {
+    error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+  hr();
+  console.log("\u2B21 Mergen PR Shadow Mode\n");
+  const readyIcon = data.readyForPRComments ? "\u2713" : "\u25CB";
+  const enabledLabel = data.prCommentsEnabled ? " (ENABLED)" : " (shadow only)";
+  console.log(`${readyIcon} PR Comments: ${data.readyForPRComments ? "ready to enable" : "not ready"}${enabledLabel}
+`);
+  console.log(`  PRs analyzed:       ${data.totalAnalyzed}`);
+  console.log(`  Would have shown:   ${data.wouldHaveShown}`);
+  console.log(`  Useful rate:        ${data.wouldHaveBeenUsefulRate ?? "N/A"}%  (need \u2265${data.readyConditions.wouldHaveBeenUsefulRateThreshold}%)`);
+  console.log(`  Avg relevance:      ${data.avgRelevanceScore ?? "N/A"}`);
+  console.log(`  Helpful rate (7d):  ${data.readyConditions.helpfulRate7d ?? "N/A"}%  (need \u2265${data.readyConditions.helpfulRateThreshold}%)`);
+  if (data.topTriggers.length > 0) {
+    console.log(`
+  Top triggers:`);
+    for (const t of data.topTriggers.slice(0, 3)) {
+      console.log(`    ${t.trigger}: ${t.count}`);
+    }
+  }
+  if (data.nextSteps.length > 0) {
+    console.log("\n  Next steps:");
+    for (const step of data.nextSteps) {
+      console.log(`    ${step}`);
+    }
+  }
+  hr();
+}
+async function feedbackCommand(args) {
+  const id = args[0];
+  const flag = args[1];
+  if (!id || flag !== "--yes" && flag !== "--no") {
+    error("Usage: mergen-server feedback <id> --yes|--no");
+    error("Example: mergen-server feedback ew-1a2b3c --yes");
+    process.exit(1);
+  }
+  const helpful = flag === "--yes";
+  let port = 0;
+  for (let p = 3e3; p <= 3010; p++) {
+    try {
+      const r = await fetch(`http://127.0.0.1:${p}/health`, { signal: AbortSignal.timeout(600) });
+      if (r.ok) {
+        port = p;
+        break;
+      }
+    } catch {
+    }
+  }
+  if (!port) {
+    error("Server not running. Start with: mergen-server start");
+    process.exit(1);
+  }
+  try {
+    const r = await fetch(`http://127.0.0.1:${port}/explain-why/feedback`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ id, helpful }),
+      signal: AbortSignal.timeout(3e3)
+    });
+    if (!r.ok) {
+      const body = await r.text().catch(() => "");
+      error(`Server returned ${r.status}: ${body}`);
+      process.exit(1);
+    }
+    success(helpful ? "Marked as helpful. Thanks!" : "Marked as not helpful. We'll use this to improve results.");
+  } catch (err) {
+    error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}
+async function backfillCommand(args) {
+  const sub = args[0];
+  if (sub === "github") {
+    await backfillGitHubCommand(args.slice(1));
+    return;
+  }
+  console.log("Usage: mergen-server backfill <source>");
+  console.log("");
+  console.log("Available sources:");
+  console.log("  github   Import historical merged PRs into the intent archive");
+  console.log("");
+  console.log("Example:");
+  console.log("  mergen-server backfill github --repo acme/api --since 180d");
+}
+async function connectCommand(args) {
+  const sub = args[0];
+  if (sub === "github") {
+    await connectGitHubCommand(args.slice(1));
+    return;
+  }
+  console.log("Usage: mergen-server connect <integration>");
+  console.log("");
+  console.log("Available integrations:");
+  console.log("  github   Auto-register GitHub PR/push webhook \u2192 populates intent archive");
+  console.log("");
+  console.log("Example:");
+  console.log("  mergen-server connect github --repo acme/api");
+}
+export {
+  backfillCommand,
+  backfillGitHubCommand,
+  connectCommand,
+  connectGitHubCommand,
+  feedbackCommand,
+  prCommand,
+  prShadowCommand
+};