harness-bujang 0.5.8 → 0.5.10

package/dist/adapt-VPWOYF6W.js

@@ -0,0 +1,404 @@
+// src/adapt.ts
+import * as fs from "fs/promises";
+import * as path from "path";
+var c = {
+  bold: (s) => `\x1B[1m${s}\x1B[22m`,
+  dim: (s) => `\x1B[2m${s}\x1B[22m`,
+  green: (s) => `\x1B[32m${s}\x1B[39m`,
+  red: (s) => `\x1B[31m${s}\x1B[39m`,
+  yellow: (s) => `\x1B[33m${s}\x1B[39m`,
+  cyan: (s) => `\x1B[36m${s}\x1B[39m`
+};
+async function runAdapt(args) {
+  const opts = parseArgs(args);
+  const agentsDir = path.join(opts.target, ".claude/agents");
+  if (!await exists(agentsDir)) {
+    console.log();
+    console.log(c.red("\u2716 No .claude/agents/ directory found at " + agentsDir));
+    console.log();
+    console.log("  Run " + c.bold("npx harness-bujang init") + " first to install the canonical agents,");
+    console.log("  then re-run this command to adapt them to your editor.");
+    console.log();
+    process.exitCode = 1;
+    return;
+  }
+  const agentFiles = await loadAgents(agentsDir);
+  if (agentFiles.length === 0) {
+    console.log();
+    console.log(c.red("\u2716 .claude/agents/ exists but contains no .md files."));
+    console.log();
+    process.exitCode = 1;
+    return;
+  }
+  console.log();
+  console.log(c.bold("\u{1F501} Harness-Bujang adapt"));
+  console.log(c.dim(`   Target:    ${opts.target}`));
+  console.log(c.dim(`   Agents:    ${agentFiles.length} files at .claude/agents/`));
+  console.log(c.dim(`   Adapting:  ${opts.to.join(", ")}`));
+  console.log();
+  for (const target of opts.to) {
+    if (target === "cursor") await adaptCursor(opts.target, agentFiles, opts.yes);
+    if (target === "cline") await adaptCline(opts.target, agentFiles, opts.yes);
+    if (target === "aider") await adaptAider(opts.target, agentFiles, opts.yes);
+    if (target === "codex") await adaptCodex(opts.target, agentFiles, opts.yes);
+    if (target === "gemini") await adaptGemini(opts.target, agentFiles, opts.yes);
+  }
+  console.log(c.bold(c.green("\u2705 Done.")));
+  console.log();
+  console.log("Next:");
+  if (opts.to.includes("cursor")) {
+    console.log(`   ${c.cyan("\u2022")} Cursor users: open the project \u2014 rules in ${c.bold(".cursor/rules/")} are auto-loaded`);
+  }
+  if (opts.to.includes("cline")) {
+    console.log(`   ${c.cyan("\u2022")} Cline users: rules in ${c.bold(".clinerules/")} are auto-loaded by Cline`);
+  }
+  if (opts.to.includes("aider")) {
+    console.log(`   ${c.cyan("\u2022")} Aider users: ${c.bold("CONVENTIONS.md")} is loaded via ${c.bold(".aider.conf.yml")} (read:)`);
+  }
+  if (opts.to.includes("codex")) {
+    console.log(`   ${c.cyan("\u2022")} Codex / Copilot Coding Agent users: ${c.bold("AGENTS.md")} at the project root is auto-loaded`);
+  }
+  if (opts.to.includes("gemini")) {
+    console.log(`   ${c.cyan("\u2022")} Antigravity / Gemini CLI / Code Assist: ${c.bold("GEMINI.md")} (highest precedence) + ${c.bold(".gemini/styleguide.md")} (PR reviews)`);
+  }
+  console.log();
+  console.log(c.dim("   When you change .claude/agents/ later, re-run this command to refresh."));
+  console.log();
+}
+async function adaptCursor(target, agents, overwrite) {
+  const dst = path.join(target, ".cursor/rules");
+  await fs.mkdir(dst, { recursive: true });
+  console.log(c.bold("\u{1F4C2} Cursor \u2014 .cursor/rules/"));
+  for (const a of agents) {
+    const file = path.join(dst, `bujang-${a.slug}.mdc`);
+    if (await exists(file) && !overwrite) {
+      console.log(`   ${c.yellow("\u26A0")}  bujang-${a.slug}.mdc ${c.dim("(exists, skipped \u2014 use --yes to overwrite)")}`);
+      continue;
+    }
+    const description = a.frontmatter.description || `Harness-Bujang ${a.slug}`;
+    const out = `---
+description: "Harness-Bujang ${a.slug}: ${escapeYamlString(description.replace(/\n/g, " ").slice(0, 240))}"
+alwaysApply: false
+---
+
+# Harness-Bujang \u2014 ${a.slug} role guide
+
+> Source of truth: \`.claude/agents/${a.slug}.md\` \u2014 re-run \`bujang adapt --to=cursor\` to sync.
+
+When the user request matches this role's domain (see description above), follow this guide as your primary system prompt for the response. Other rules under this directory describe sibling roles in the same harness.
+
+---
+
+` + a.body.trim() + `
+`;
+    await fs.writeFile(file, out);
+    console.log(`   ${c.green("\u2713")}  bujang-${a.slug}.mdc`);
+  }
+  console.log();
+}
+async function adaptCline(target, agents, overwrite) {
+  const dst = path.join(target, ".clinerules");
+  await fs.mkdir(dst, { recursive: true });
+  console.log(c.bold("\u{1F4C2} Cline \u2014 .clinerules/"));
+  for (const a of agents) {
+    const file = path.join(dst, `bujang-${a.slug}.md`);
+    if (await exists(file) && !overwrite) {
+      console.log(`   ${c.yellow("\u26A0")}  bujang-${a.slug}.md ${c.dim("(exists, skipped \u2014 use --yes to overwrite)")}`);
+      continue;
+    }
+    const description = a.frontmatter.description || "";
+    const out = `# Harness-Bujang \u2014 ${a.slug}
+
+` + (description ? `${description}
+
+` : "") + `> Source of truth: \`.claude/agents/${a.slug}.md\` \u2014 re-run \`bujang adapt --to=cline\` to sync.
+
+---
+
+` + a.body.trim() + `
+`;
+    await fs.writeFile(file, out);
+    console.log(`   ${c.green("\u2713")}  bujang-${a.slug}.md`);
+  }
+  console.log();
+}
+async function adaptAider(target, agents, overwrite) {
+  console.log(c.bold("\u{1F4C2} Aider \u2014 CONVENTIONS.md + .aider.conf.yml"));
+  const conventionsPath = path.join(target, "CONVENTIONS.md");
+  const conventionsExisted = await exists(conventionsPath);
+  if (conventionsExisted && !overwrite) {
+    console.log(`   ${c.yellow("\u26A0")}  CONVENTIONS.md ${c.dim("(exists, skipped \u2014 use --yes to overwrite)")}`);
+  } else {
+    let body = `# Project Conventions \u2014 Harness-Bujang
+
+`;
+    body += `> Source of truth: \`.claude/agents/*.md\` \u2014 re-run \`bujang adapt --to=aider\` to sync.
+
+`;
+    body += `This file collects the multi-agent harness role guides into a single conventions file that Aider can load via \`.aider.conf.yml\`. Aider does not natively dispatch to subagents, so when the user's request matches a specific role's domain, internally adopt that role's instructions for the response.
+
+`;
+    body += `## Roles
+
+`;
+    for (const a of agents) {
+      const desc = a.frontmatter.description || "";
+      body += `- **${a.slug}**${desc ? ` \u2014 ${desc.replace(/\n/g, " ").slice(0, 200)}` : ""}
+`;
+    }
+    body += `
+---
+
+`;
+    for (const a of agents) {
+      body += `## ${a.slug}
+
+`;
+      body += a.body.trim() + `
+
+---
+
+`;
+    }
+    await fs.writeFile(conventionsPath, body);
+    console.log(`   ${c.green("\u2713")}  CONVENTIONS.md ${c.dim(`(${agents.length} roles concatenated)`)}`);
+  }
+  const aiderConfPath = path.join(target, ".aider.conf.yml");
+  const existing = await exists(aiderConfPath) ? await fs.readFile(aiderConfPath, "utf8") : "";
+  if (existing.includes("CONVENTIONS.md")) {
+    console.log(`   ${c.dim("\u2022")}  .aider.conf.yml already references CONVENTIONS.md \u2014 left untouched`);
+  } else if (existing && !overwrite) {
+    console.log(`   ${c.yellow("\u26A0")}  .aider.conf.yml exists and does NOT reference CONVENTIONS.md \u2014 skipped`);
+    console.log(`     ${c.dim("Add manually:")}  read: CONVENTIONS.md`);
+  } else {
+    const out = existing ? existing.trimEnd() + `
+
+# Added by harness-bujang adapt
+read: CONVENTIONS.md
+` : `# Aider config \u2014 auto-loads Harness-Bujang conventions
+read: CONVENTIONS.md
+`;
+    await fs.writeFile(aiderConfPath, out);
+    console.log(`   ${c.green("\u2713")}  .aider.conf.yml ${c.dim("(read: CONVENTIONS.md)")}`);
+  }
+  console.log();
+}
+async function adaptCodex(target, agents, overwrite) {
+  console.log(c.bold("\u{1F4C2} Codex / Copilot Agent \u2014 AGENTS.md (project root)"));
+  const filePath = path.join(target, "AGENTS.md");
+  if (await exists(filePath) && !overwrite) {
+    console.log(`   ${c.yellow("\u26A0")}  AGENTS.md ${c.dim("(exists, skipped \u2014 use --yes to overwrite)")}`);
+    console.log();
+    return;
+  }
+  let body = `# AGENTS.md \u2014 Harness-Bujang multi-agent harness
+
+`;
+  body += `> Source of truth: \`.claude/agents/*.md\` \u2014 re-run \`bujang adapt --to=codex\` to sync.
+
+`;
+  body += `This file follows the AGENTS.md convention adopted by OpenAI Codex CLI, GitHub Copilot Coding Agent, and several other agentic coding tools. It collects the harness role guides into a single document.
+
+`;
+  body += `When the user's request matches one of the role domains below, internally adopt that role's instructions for the response. If the request spans multiple domains, follow the **director** role's dispatch logic.
+
+`;
+  body += `## Roles
+
+`;
+  for (const a of agents) {
+    const desc = a.frontmatter.description || "";
+    body += `- **${a.slug}**${desc ? ` \u2014 ${desc.replace(/\n/g, " ").slice(0, 200)}` : ""}
+`;
+  }
+  body += `
+---
+
+`;
+  for (const a of agents) {
+    body += `## ${a.slug}
+
+`;
+    body += a.body.trim() + `
+
+---
+
+`;
+  }
+  await fs.writeFile(filePath, body);
+  console.log(`   ${c.green("\u2713")}  AGENTS.md ${c.dim(`(${agents.length} roles concatenated, ${(body.length / 1024).toFixed(1)} KB)`)}`);
+  console.log();
+}
+async function adaptGemini(target, agents, overwrite) {
+  console.log(c.bold("\u{1F4C2} Gemini / Antigravity \u2014 GEMINI.md + .gemini/styleguide.md"));
+  const geminiMdPath = path.join(target, "GEMINI.md");
+  if (await exists(geminiMdPath) && !overwrite) {
+    console.log(`   ${c.yellow("\u26A0")}  GEMINI.md ${c.dim("(exists, skipped \u2014 use --yes to overwrite)")}`);
+  } else {
+    let body = `# GEMINI.md \u2014 Harness-Bujang multi-agent harness
+
+`;
+    body += `> Source of truth: \`.claude/agents/*.md\` \u2014 re-run \`bujang adapt --to=gemini\` to sync.
+
+`;
+    body += `This file is read by Google Antigravity (workspace highest priority), Gemini CLI, and Gemini Code Assist (workspace customization). It collects the harness role guides into a single document.
+
+`;
+    body += `When the user's request matches one of the role domains below, internally adopt that role's instructions for the response. If the request spans multiple domains, follow the **director** role's dispatch logic.
+
+`;
+    body += `## Roles
+
+`;
+    for (const a of agents) {
+      const desc = a.frontmatter.description || "";
+      body += `- **${a.slug}**${desc ? ` \u2014 ${desc.replace(/\n/g, " ").slice(0, 200)}` : ""}
+`;
+    }
+    body += `
+---
+
+`;
+    for (const a of agents) {
+      body += `## ${a.slug}
+
+`;
+      body += a.body.trim() + `
+
+---
+
+`;
+    }
+    await fs.writeFile(geminiMdPath, body);
+    console.log(`   ${c.green("\u2713")}  GEMINI.md ${c.dim(`(${agents.length} roles concatenated, ${(body.length / 1024).toFixed(1)} KB)`)}`);
+  }
+  const styleguideDir = path.join(target, ".gemini");
+  await fs.mkdir(styleguideDir, { recursive: true });
+  const styleguidePath = path.join(styleguideDir, "styleguide.md");
+  if (await exists(styleguidePath) && !overwrite) {
+    console.log(`   ${c.yellow("\u26A0")}  .gemini/styleguide.md ${c.dim("(exists, skipped)")}`);
+  } else {
+    const reviewRoles = ["code-review-team", "security-team", "db-guard-team", "verifier-team"];
+    const reviewAgents = agents.filter((a) => reviewRoles.includes(a.slug));
+    let body = `# Code Review Style Guide \u2014 Harness-Bujang
+
+`;
+    body += `> Source of truth: \`.claude/agents/*.md\` \u2014 re-run \`bujang adapt --to=gemini\` to sync.
+
+`;
+    body += `This style guide is read by Gemini Code Assist for GitHub when reviewing PRs. It distills the review-relevant subset of the Harness-Bujang harness (code review, security, DB guard, verifier teams) into review criteria.
+
+`;
+    body += `When reviewing a PR, apply the following audit lenses in order:
+
+`;
+    for (const a of reviewAgents) {
+      body += `## ${a.slug}
+
+`;
+      body += a.body.trim() + `
+
+---
+
+`;
+    }
+    if (reviewAgents.length === 0) {
+      body += `_(No review-team agents found in .claude/agents/. Re-run init to install the canonical set.)_
+`;
+    }
+    await fs.writeFile(styleguidePath, body);
+    console.log(`   ${c.green("\u2713")}  .gemini/styleguide.md ${c.dim(`(${reviewAgents.length} review roles)`)}`);
+  }
+  console.log();
+}
+async function loadAgents(agentsDir) {
+  const entries = await fs.readdir(agentsDir);
+  const out = [];
+  for (const name of entries) {
+    if (!name.endsWith(".md")) continue;
+    const src = path.join(agentsDir, name);
+    const raw = await fs.readFile(src, "utf8");
+    const slug = name.replace(/\.md$/, "");
+    const { frontmatter, body } = splitFrontmatter(raw);
+    out.push({ slug, frontmatter, body, src });
+  }
+  out.sort((a, b) => {
+    if (a.slug === "director") return -1;
+    if (b.slug === "director") return 1;
+    return a.slug.localeCompare(b.slug);
+  });
+  return out;
+}
+function splitFrontmatter(raw) {
+  if (!raw.startsWith("---\n")) {
+    return { frontmatter: {}, body: raw };
+  }
+  const end = raw.indexOf("\n---\n", 4);
+  if (end < 0) {
+    return { frontmatter: {}, body: raw };
+  }
+  const fmRaw = raw.slice(4, end);
+  const body = raw.slice(end + 5);
+  const frontmatter = {};
+  const lines = fmRaw.split(/\r?\n/);
+  let currentKey = null;
+  for (const line of lines) {
+    const m = /^([a-zA-Z_-]+):\s?(.*)$/.exec(line);
+    if (m && m[1] && !line.startsWith(" ") && !line.startsWith("	")) {
+      currentKey = m[1];
+      frontmatter[currentKey] = m[2] ?? "";
+    } else if (currentKey && (line.startsWith(" ") || line.startsWith("	"))) {
+      frontmatter[currentKey] = (frontmatter[currentKey] ?? "") + " " + line.trim();
+    }
+  }
+  return { frontmatter, body };
+}
+function escapeYamlString(s) {
+  return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function parseArgs(args) {
+  const targetRaw = getFlag(args, "--target") ?? ".";
+  const toRaw = getFlag(args, "--to");
+  if (!toRaw) {
+    throw new Error(
+      `--to=<cursor|cline|aider|codex|gemini|all> is required. Examples:
+  bujang adapt --to=cursor
+  bujang adapt --to=codex             # AGENTS.md at project root
+  bujang adapt --to=gemini            # GEMINI.md + .gemini/styleguide.md
+  bujang adapt --to=cursor,aider      # multiple
+  bujang adapt --to=all               # cursor + cline + aider + codex + gemini`
+    );
+  }
+  const targets = toRaw === "all" ? ["cursor", "cline", "aider", "codex", "gemini"] : toRaw.split(",").map((t) => t.trim());
+  for (const t of targets) {
+    if (!["cursor", "cline", "aider", "codex", "gemini"].includes(t)) {
+      throw new Error(`Unknown adapter target "${t}" \u2014 expected one of: cursor, cline, aider, codex, gemini, all`);
+    }
+  }
+  return {
+    target: path.resolve(targetRaw),
+    to: targets,
+    yes: args.includes("--yes") || args.includes("-y")
+  };
+}
+function getFlag(args, name) {
+  for (const a of args) {
+    if (a.startsWith(`${name}=`)) return a.slice(name.length + 1);
+  }
+  const idx = args.indexOf(name);
+  if (idx >= 0 && idx + 1 < args.length && !args[idx + 1].startsWith("--")) {
+    return args[idx + 1];
+  }
+  return void 0;
+}
+async function exists(p) {
+  try {
+    await fs.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+export {
+  runAdapt
+};