harness-bujang 0.5.1 → 0.5.2

package/README.md

@@ -18,8 +18,24 @@ npx harness-bujang init --lang=en
 
 # Different folder, skip the chat-room UI
 npx harness-bujang init --target=./my-app --no-template
+
+# Upgrade an existing install — adds NEW team files only, never touches existing ones
+npx harness-bujang update
 ```
 
+> ## ⚠️ First-time vs upgrade — read this before re-running
+>
+> | Situation | Command | What it does |
+> |-----------|---------|-------------|
+> | **First install** (empty project) | `npx harness-bujang init` | Full install — director + 16 teams + cofounder |
+> | **Pulling new version** (already installed) | `npx harness-bujang update` | **Adds only NEW files.** Existing agent files are never touched |
+> | **Clean reset** (drop customizations) | `npx harness-bujang init --yes` | **Overwrites every agent file** ⚠️ |
+>
+> **If you've already been using harness-bujang, use `update`.** Running
+> `init --yes` to upgrade will destroy any domain rules / learned customizations
+> you've added to existing agent files. `CLAUDE.md` and
+> `docs/AGENT_LEARNING_LOG.md` are never touched by any of the three commands.
+
 ### See the chat-room — any stack
 
 ```bash
@@ -72,6 +88,49 @@ npx harness-bujang status [path]
 
 Verifies the install: agent files, `CLAUDE.md` section, learning log, chat-room UI. Counts unfilled `{{...}}` placeholders.
 
+### `update`
+
+```
+npx harness-bujang update [options]
+
+Options:
+  --target=<path>          Project root (default: cwd)
+  --lang=<ko|en>           Language for newly-added agents (default: ko)
+```
+
+**Safe additive update.** Adds NEW agent files only. Existing files are NEVER touched.
+
+Use this when you upgrade `harness-bujang` and want to pull in newly-introduced
+team members (e.g. the cofounder persona in 0.5.1, or the content-production
+teams in 0.5.0) without disturbing any local customizations.
+
+```
+$ npx harness-bujang update
+
+🔄 Harness-Bujang update
+📂 Checking .claude/agents/
+   =  consultant.md (exists, kept as-is)
+   =  dev-team.md (exists, kept as-is)
+   +  cofounder.md
+   +  image-team.md
+   ...
+
+📋 Summary
+   Added:  4   (new files only)
+   Kept:   14  (existing files untouched)
+```
+
+> ⚠️ **`update` vs `init --yes`** — pick the right one:
+>
+> | Command | What happens |
+> |---------|-------------|
+> | `npx harness-bujang update` | **Safe.** Adds only new files. Custom edits preserved. |
+> | `npx harness-bujang init --yes` | **Destructive.** Overwrites every agent file. Customizations lost. |
+>
+> Default to `update` for upgrades. Use `init --yes` only for a clean reset.
+
+`CLAUDE.md` and `docs/AGENT_LEARNING_LOG.md` are **never** touched by either command.
+
 ### `chat`
 
 ```

package/dist/index.js

@@ -862,11 +862,11 @@ async function upsertEnvVar(envFile, key, value) {
 }
 async function confirm2(message) {
   process.stdout.write(`${message} [y/N] `);
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     process.stdin.setEncoding("utf8");
     process.stdin.once("data", (chunk) => {
       const ans = chunk.toString().trim().toLowerCase();
-      resolve6(ans === "y" || ans === "yes");
+      resolve7(ans === "y" || ans === "yes");
       process.stdin.pause();
     });
   });
@@ -1009,7 +1009,7 @@ async function runChat(args) {
     res.writeHead(404);
     res.end("not found");
   });
-  await new Promise((resolve6) => server.listen(port, "127.0.0.1", resolve6));
+  await new Promise((resolve7) => server.listen(port, "127.0.0.1", resolve7));
   const url = `http://localhost:${port}`;
   console.log();
   console.log(c4.bold(c4.green("\u{1F7E2} \uD558\uB124\uC2A4 \uD1A1\uBC29 viewer")) + c4.dim(" \u2014 " + url));
@@ -1061,12 +1061,12 @@ async function findOpenPort(preferred) {
   throw new Error(`Could not find a free port in range ${preferred}-${preferred + 19}`);
 }
 function portIsFree(port) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const tester = http.createServer();
-    tester.once("error", () => resolve6(false));
+    tester.once("error", () => resolve7(false));
     tester.once("listening", () => {
       tester.close();
-      resolve6(true);
+      resolve7(true);
     });
     tester.listen(port, "127.0.0.1");
   });
@@ -1080,10 +1080,10 @@ function openBrowser(url) {
   }
 }
 function readBody(req) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     const chunks = [];
     req.on("data", (chunk) => chunks.push(chunk));
-    req.on("end", () => resolve6(Buffer.concat(chunks).toString("utf8")));
+    req.on("end", () => resolve7(Buffer.concat(chunks).toString("utf8")));
     req.on("error", reject);
   });
 }
@@ -1883,7 +1883,12 @@ async function exists5(p) {
   }
 }
 
-// src/index.ts
+// src/update.ts
+import * as fs7 from "fs/promises";
+import * as path7 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var __filename3 = fileURLToPath2(import.meta.url);
+var __dirname3 = path7.dirname(__filename3);
 var c6 = {
   bold: (s) => `\x1B[1m${s}\x1B[22m`,
   dim: (s) => `\x1B[2m${s}\x1B[22m`,
@@ -1892,18 +1897,184 @@ var c6 = {
   yellow: (s) => `\x1B[33m${s}\x1B[39m`,
   cyan: (s) => `\x1B[36m${s}\x1B[39m`
 };
-var HELP = `
-${c6.bold("harness-bujang")} \u2014 Korean-style multi-agent harness director for Claude Code
-${c6.dim("https://github.com/bjcho4141/harness-bujang")}
-
-${c6.bold("Usage:")}
-  npx harness-bujang ${c6.cyan("init")}     [options]    Install the harness into a project
-  npx harness-bujang ${c6.cyan("status")}   [options]    Verify the harness install
-  npx harness-bujang ${c6.cyan("chat")}     [options]    Open the standalone chat-room viewer (any stack)
-  npx harness-bujang ${c6.cyan("adapt")}    --to=<cursor|cline|aider|codex|gemini|all>  Convert .claude/agents/ for other tools
-  npx harness-bujang ${c6.cyan("migrate")}  --to=<sqlite|supabase>  Move chat data between backends
+async function runUpdate(args) {
+  const opts = parseArgs5(args);
+  const assets = await resolveAssetPaths2();
+  const agentsSrc = path7.join(assets.agents, opts.lang);
+  const agentsDst = path7.join(opts.target, ".claude/agents");
+  console.log();
+  console.log(c6.bold("\u{1F504} Harness-Bujang update"));
+  console.log(c6.dim(`   Target:    ${opts.target}`));
+  console.log(c6.dim(`   Language:  ${opts.lang}`));
+  console.log();
+  if (!await exists6(agentsDst)) {
+    console.log(c6.yellow("\u26A0  No .claude/agents/ directory found."));
+    console.log();
+    console.log("  This project has not been initialized yet. Run:");
+    console.log(`    ${c6.cyan("npx harness-bujang init")}`);
+    console.log();
+    return;
+  }
+  const scan = await scanProject(opts.target);
+  const context = await buildContext(opts, scan);
+  const agentFiles = (await fs7.readdir(agentsSrc)).filter((f) => f.endsWith(".md"));
+  agentFiles.sort();
+  const added = [];
+  const kept = [];
+  console.log(c6.bold("\u{1F4C2} Checking .claude/agents/"));
+  for (const f of agentFiles) {
+    const dst = path7.join(agentsDst, f);
+    if (await exists6(dst)) {
+      kept.push(f);
+      console.log(`   ${c6.dim("=")}  ${f} ${c6.dim("(exists, kept as-is)")}`);
+      continue;
+    }
+    const raw = await fs7.readFile(path7.join(agentsSrc, f), "utf8");
+    await fs7.writeFile(dst, renderTemplate(raw, context));
+    added.push(f);
+    console.log(`   ${c6.green("+")}  ${f}`);
+  }
+  console.log();
+  console.log(c6.bold("\u{1F4CB} Summary"));
+  console.log(`   ${c6.green("Added")}:  ${added.length}  ${added.length ? c6.dim("(new files only)") : ""}`);
+  console.log(`   ${c6.dim("Kept")}:   ${kept.length}  ${c6.dim("(existing files untouched)")}`);
+  console.log();
+  if (added.length === 0) {
+    console.log(c6.dim("   Nothing new to install \u2014 your harness is already up to date."));
+    console.log();
+    return;
+  }
+  console.log(c6.bold(c6.green("\u2705 Update done.")));
+  console.log();
+  console.log("   Existing agent files were not modified. Your customizations are safe.");
+  console.log("   To overwrite everything (e.g. for a clean reset), use instead:");
+  console.log(`     ${c6.cyan("npx harness-bujang init --yes")}`);
+  console.log();
+}
+async function resolveAssetPaths2() {
+  const packaged = path7.resolve(__dirname3, "..", "templates");
+  if (await exists6(packaged)) {
+    return {
+      agents: path7.join(packaged, "agents"),
+      templates: path7.join(packaged, "templates"),
+      projectTemplate: path7.join(packaged, "project-template"),
+      mode: "packaged"
+    };
+  }
+  const monorepoRoot = path7.resolve(__dirname3, "../../..");
+  const sharedDir = path7.join(monorepoRoot, "shared");
+  if (await exists6(sharedDir)) {
+    return {
+      agents: path7.join(sharedDir, "agents"),
+      templates: path7.join(sharedDir, "templates"),
+      projectTemplate: path7.join(monorepoRoot, "packages/template"),
+      mode: "monorepo"
+    };
+  }
+  throw new Error(
+    `Could not locate harness-bujang assets. Tried:
+  - ${packaged}
+  - ${sharedDir}
+`
+  );
+}
+async function buildContext(opts, scan) {
+  return {
+    PROJECT_PATH: opts.target,
+    PROJECT_NAME: path7.basename(opts.target),
+    PROJECT_CATEGORY: scan.framework.startsWith("Next.js") ? "Web application" : "Software project",
+    DIFFERENTIATION: "(define your project differentiation here if relevant)",
+    STACK_FRAMEWORK: scan.framework,
+    STACK_LANGUAGE: scan.language,
+    STACK_DB: scan.db,
+    STACK_UI: scan.ui,
+    STACK_PAYMENT: scan.payment,
+    STACK_EXTRA: "(none)",
+    HARNESS_TABLE: "harness_messages",
+    ADMIN_HARNESS_ROUTE: "/admin/harness",
+    LEARNING_LOG_PATH: "docs/AGENT_LEARNING_LOG.md",
+    TASKS_TRACKER_GLOB: "docs/TASKS_*.md",
+    BENCHMARK_DOC_PATH: "docs/BENCHMARK.md",
+    GH_USER: scan.ghUser,
+    BUILD_CMD: scan.buildCmd || "(no build script)",
+    TYPECHECK_CMD: scan.typecheckCmd || "(no type-check command)",
+    TEST_CMD: scan.testCmd || "(no tests configured)",
+    E2E_CMD: scan.e2eCmd || "(no E2E setup)",
+    DEV_URL: "http://localhost:3000",
+    DB_TYPES_PATH: scan.dbTypesPath,
+    DB_CLIENT_PATTERN: `Use the project's existing DB client convention. See ${scan.dbTypesPath}.`,
+    KNOWN_SCHEMA_DRIFT: "(none documented yet)",
+    COMMON_FK_HINTS: "(extract from your schema as you go)",
+    ACCESS_POLICY_NOTES: "(document RLS / middleware as encountered)",
+    MIGRATION_NAMING: "supabase/migrations/XXXXX_name.sql (or per-stack)",
+    MIGRATION_APPLY_CMD: "supabase db push (or stack-specific)",
+    ROUTE_GROUPS: scan.routeGroups,
+    MIDDLEWARE_PATH: scan.middlewarePath,
+    KEY_RELATIONSHIPS: "(document key entity relations as you go)",
+    AUTH_GUARD_PATTERN: "(stack-specific)",
+    ADMIN_GUARD_PATTERN: "(stack-specific)",
+    API_RESPONSE_SHAPE: "{ data, error, message }",
+    PRIMARY_COLOR: "#6366F1",
+    FRAMEWORK_REVIEW_RULES: "",
+    TEST_ACCOUNTS: "(define your test accounts here)",
+    LEGAL_CONTEXT: "(no special legal context)",
+    LANG_CODE: opts.lang,
+    TODAY: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+    COMPLETED_DOCS_PATTERN: "docs/\uC644\uB8CC_*.md"
+  };
+}
+function parseArgs5(args) {
+  const lang = getFlag5(args, "--lang") ?? "ko";
+  if (!["ko", "en"].includes(lang)) {
+    throw new Error(`--lang must be "ko" or "en", got "${lang}"`);
+  }
+  const targetRaw = getFlag5(args, "--target") ?? ".";
+  return {
+    target: path7.resolve(targetRaw),
+    lang
+  };
+}
+function getFlag5(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 exists6(p) {
+  try {
+    await fs7.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
 
-${c6.bold("Options for init:")}
+// src/index.ts
+var c7 = {
+  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`
+};
+var HELP = `
+${c7.bold("harness-bujang")} \u2014 Korean-style multi-agent harness director for Claude Code
+${c7.dim("https://github.com/bjcho4141/harness-bujang")}
+
+${c7.bold("Usage:")}
+  npx harness-bujang ${c7.cyan("init")}     [options]    Install the harness into a project
+  npx harness-bujang ${c7.cyan("update")}   [options]    Pull NEW agents only \u2014 existing files untouched
+  npx harness-bujang ${c7.cyan("status")}   [options]    Verify the harness install
+  npx harness-bujang ${c7.cyan("chat")}     [options]    Open the standalone chat-room viewer (any stack)
+  npx harness-bujang ${c7.cyan("adapt")}    --to=<cursor|cline|aider|codex|gemini|all>  Convert .claude/agents/ for other tools
+  npx harness-bujang ${c7.cyan("migrate")}  --to=<sqlite|supabase>  Move chat data between backends
+
+${c7.bold("Options for init:")}
   --lang=<ko|en>           Agent language (default: ko \u2014 full \uBD80\uC7A5 persona)
   --chat=<sqlite|supabase> Chat-room backend (default: sqlite \u2014 local file, no setup)
   --commit-chat            Don't gitignore .harness/ (for solo cross-machine sync via git)
@@ -1915,49 +2086,56 @@ ${c6.bold("Options for init:")}
   --no-learning-log        Skip learning log seed
   --yes, -y                Skip prompts and overwrite (non-interactive \u2014 for CI / scripts)
 
-${c6.dim("Run without --yes for an interactive setup (prompts for language, backend, etc.).")}
+${c7.dim("Run without --yes for an interactive setup (prompts for language, backend, etc.).")}
 
-${c6.bold("Options for chat:")}
+${c7.bold("Options for chat:")}
   --target=<path>          Project root (default: cwd)
   --port=<number>          Preferred port (default: 7777, falls forward if busy)
   --no-open                Don't auto-open the browser
   --create                 Create an empty chat DB + schema if none exists yet
 
-${c6.bold("Options for adapt:")}
+${c7.bold("Options for adapt:")}
   --to=<cursor|cline|aider|codex|gemini|all>   Required \u2014 comma-separated list also OK
   --target=<path>          Project root (default: cwd)
   --yes, -y                Overwrite existing adapter files
 
-${c6.dim("Adapter targets:")}
-${c6.dim("  cursor  \u2192 .cursor/rules/bujang-*.mdc          (Cursor IDE)")}
-${c6.dim("  cline   \u2192 .clinerules/bujang-*.md             (Cline)")}
-${c6.dim("  aider   \u2192 CONVENTIONS.md + .aider.conf.yml    (Aider)")}
-${c6.dim("  codex   \u2192 AGENTS.md                           (Codex CLI / Copilot Coding Agent / Cody)")}
-${c6.dim("  gemini  \u2192 GEMINI.md + .gemini/styleguide.md   (Antigravity / Gemini CLI / Code Assist)")}
+${c7.bold("Options for update:")}
+  --target=<path>          Project root (default: cwd)
+  --lang=<ko|en>           Language for newly-added agents (default: ko)
+
+${c7.dim("  update only adds NEW agent files. Existing files are NEVER touched.")}
+${c7.dim("  For a clean overwrite (resets all agents), use: bujang init --yes")}
+
+${c7.dim("Adapter targets:")}
+${c7.dim("  cursor  \u2192 .cursor/rules/bujang-*.mdc          (Cursor IDE)")}
+${c7.dim("  cline   \u2192 .clinerules/bujang-*.md             (Cline)")}
+${c7.dim("  aider   \u2192 CONVENTIONS.md + .aider.conf.yml    (Aider)")}
+${c7.dim("  codex   \u2192 AGENTS.md                           (Codex CLI / Copilot Coding Agent / Cody)")}
+${c7.dim("  gemini  \u2192 GEMINI.md + .gemini/styleguide.md   (Antigravity / Gemini CLI / Code Assist)")}
 
-${c6.bold("Options for migrate:")}
+${c7.bold("Options for migrate:")}
   --to=<sqlite|supabase>   Required \u2014 target backend
   --target=<path>          Project root (default: cwd)
   --yes, -y                Skip confirmation
 
-${c6.bold("Examples:")}
-  ${c6.dim("# Install Korean Bujang persona, SQLite chat (default \u2014 zero setup)")}
+${c7.bold("Examples:")}
+  ${c7.dim("# Install Korean Bujang persona, SQLite chat (default \u2014 zero setup)")}
   npx harness-bujang init --lang=ko
 
-  ${c6.dim("# Open the standalone chat-room \u2014 works on ANY stack (Next.js, Rails, Django, \u2026)")}
+  ${c7.dim("# Open the standalone chat-room \u2014 works on ANY stack (Next.js, Rails, Django, \u2026)")}
   npx harness-bujang chat
-  ${c6.dim("# \u2192 opens http://localhost:7777 in your browser")}
+  ${c7.dim("# \u2192 opens http://localhost:7777 in your browser")}
 
-  ${c6.dim("# Solo, multiple machines \u2014 sync chat history via git")}
+  ${c7.dim("# Solo, multiple machines \u2014 sync chat history via git")}
   npx harness-bujang init --commit-chat
 
-  ${c6.dim("# Production project with team sharing \u2014 Supabase backend")}
+  ${c7.dim("# Production project with team sharing \u2014 Supabase backend")}
   npx harness-bujang init --chat=supabase
 
-  ${c6.dim("# Started solo, now scaling up \u2014 promote to cloud")}
+  ${c7.dim("# Started solo, now scaling up \u2014 promote to cloud")}
   bujang migrate --to=supabase
 
-  ${c6.dim("# Going back to solo / archive \u2014 pull cloud data into local SQLite")}
+  ${c7.dim("# Going back to solo / archive \u2014 pull cloud data into local SQLite")}
   bujang migrate --to=sqlite
 `;
 async function main() {
@@ -1976,12 +2154,15 @@ async function main() {
     case "adapt":
       await runAdapt(args.slice(1));
       break;
+    case "update":
+      await runUpdate(args.slice(1));
+      break;
     case "migrate":
       await runMigrate(args.slice(1));
       break;
     case "--version":
     case "-v":
-      console.log("0.5.1");
+      console.log("0.5.2");
       break;
     case "--help":
     case "-h":
@@ -1989,13 +2170,13 @@ async function main() {
       console.log(HELP);
       break;
     default:
-      console.error(c6.red(`Unknown command: ${command}`));
+      console.error(c7.red(`Unknown command: ${command}`));
       console.log(HELP);
       process.exit(1);
   }
 }
 main().catch((err) => {
-  console.error(c6.red(`
+  console.error(c7.red(`
 \u2716 ${err.message}`));
   if (process.env.DEBUG) console.error(err.stack);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harness-bujang",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Install the Harness-Bujang multi-agent harness into any project — Director, 7 specialist teams, real-time chat-room UI. Korean and English personas. Works with Claude Code, Cursor, Cline, Aider, or any tool that reads .claude/agents/.",
   "keywords": [
     "claude-code",