harness-bujang 0.4.2 → 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);
   });
 }
@@ -1165,37 +1165,63 @@ var CLIENT_JS = (
   /* js */
   `
 const ROLES = {
-  '\uB300\uD45C\uB2D8':           { icon: '\u{1F454}', color: 'text-purple-700', bg: 'bg-purple-100', label: '\uB300\uD45C\uB2D8' },
-  '\uBD80\uC7A5':             { icon: '\u{1F9D1}\u200D\u{1F4BC}', color: 'text-blue-700',   bg: 'bg-blue-100',   label: '\uBD80\uC7A5' },
-  'consultant':       { icon: '\u{1F91D}', color: 'text-indigo-700', bg: 'bg-indigo-100', label: '\uCEE8\uC124\uD134\uD2B8' },
-  'dev-team':         { icon: '\u{1F4BB}', color: 'text-violet-700', bg: 'bg-violet-100', label: '\uAC1C\uBC1C\uD300' },
-  'architect-team':   { icon: '\u{1F3D7}\uFE0F', color: 'text-cyan-700',   bg: 'bg-cyan-100',   label: '\uC544\uD0A4\uD14D\uCC98\uD300' },
-  'code-review-team': { icon: '\u{1F4DD}', color: 'text-yellow-700', bg: 'bg-yellow-100', label: '\uCF54\uB4DC\uB9AC\uBDF0\uD300' },
-  'doc-sync-team':    { icon: '\u{1F4C4}', color: 'text-orange-700', bg: 'bg-orange-100', label: '\uBB38\uC11C\uAD00\uB9AC\uD300' },
-  'security-team':    { icon: '\u{1F6E1}\uFE0F', color: 'text-red-700',    bg: 'bg-red-100',    label: '\uBCF4\uC548\uD300' },
-  'db-guard-team':    { icon: '\u{1F5C4}\uFE0F', color: 'text-green-700',  bg: 'bg-green-100',  label: 'DB\uD300' },
-  'qa-team':          { icon: '\u{1F9EA}', color: 'text-teal-700',   bg: 'bg-teal-100',   label: 'QA\uD300' },
-  'verifier-team':    { icon: '\u2705', color: 'text-emerald-700', bg: 'bg-emerald-100', label: '\uAC80\uC218\uD300' },
+  '\uB300\uD45C\uB2D8':            { icon: '\u{1F454}', color: 'text-purple-700', bg: 'bg-purple-100', label: '\uB300\uD45C\uB2D8' },
+  '\uACF5\uB3D9\uB300\uD45C':          { icon: '\u2B50', color: 'text-violet-700', bg: 'bg-violet-100', label: '\uACF5\uB3D9\uB300\uD45C' },
+  '\uBD80\uC7A5':              { icon: '\u{1F9D1}\u200D\u{1F4BC}', color: 'text-blue-700',   bg: 'bg-blue-100',   label: '\uBD80\uC7A5' },
+  '\uC678\uBD80\uD300\uC6D0':          { icon: '\u{1F310}', color: 'text-gray-700',   bg: 'bg-gray-100',   label: '\uC678\uBD80\uD300\uC6D0' },
+  // Engineering core teams
+  'consultant':        { icon: '\u{1F91D}', color: 'text-indigo-700', bg: 'bg-indigo-100', label: '\uCEE8\uC124\uD134\uD2B8' },
+  'dev-team':          { icon: '\u{1F4BB}', color: 'text-violet-700', bg: 'bg-violet-100', label: '\uAC1C\uBC1C\uD300' },
+  'architect-team':    { icon: '\u{1F3D7}\uFE0F', color: 'text-cyan-700',   bg: 'bg-cyan-100',   label: '\uC544\uD0A4\uD14D\uCC98\uD300' },
+  'code-review-team':  { icon: '\u{1F4DD}', color: 'text-yellow-700', bg: 'bg-yellow-100', label: '\uCF54\uB4DC\uB9AC\uBDF0\uD300' },
+  'doc-sync-team':     { icon: '\u{1F4C4}', color: 'text-orange-700', bg: 'bg-orange-100', label: '\uBB38\uC11C\uAD00\uB9AC\uD300' },
+  'security-team':     { icon: '\u{1F6E1}\uFE0F', color: 'text-red-700',    bg: 'bg-red-100',    label: '\uBCF4\uC548\uD300' },
+  'db-guard-team':     { icon: '\u{1F5C4}\uFE0F', color: 'text-green-700',  bg: 'bg-green-100',  label: 'DB\uD300' },
+  'qa-team':           { icon: '\u{1F9EA}', color: 'text-teal-700',   bg: 'bg-teal-100',   label: 'QA\uD300' },
+  'verifier-team':     { icon: '\u2705', color: 'text-emerald-700', bg: 'bg-emerald-100', label: '\uAC80\uC218\uD300' },
+  // Content production teams (added 0.5.0)
+  'research-team':     { icon: '\u{1F50D}', color: 'text-sky-700',    bg: 'bg-sky-100',    label: '\uB9AC\uC11C\uCE58\uD300' },
+  'analysis-team':     { icon: '\u{1F4CA}', color: 'text-amber-700',  bg: 'bg-amber-100',  label: '\uBD84\uC11D\uD300' },
+  'script-team':       { icon: '\u270D\uFE0F', color: 'text-pink-700',   bg: 'bg-pink-100',   label: '\uB300\uBCF8\uD300' },
+  'image-team':        { icon: '\u{1F3A8}', color: 'text-fuchsia-700',bg: 'bg-fuchsia-100',label: '\uC774\uBBF8\uC9C0\uD300' },
+  'voice-team':        { icon: '\u{1F399}\uFE0F', color: 'text-rose-700',   bg: 'bg-rose-100',   label: '\uC74C\uC131\uD300' },
+  'edit-team':         { icon: '\u{1F3AC}', color: 'text-stone-700',  bg: 'bg-stone-100',  label: '\uD3B8\uC9D1\uD300' },
+  'content-qa-team':   { icon: '\u{1F50E}', color: 'text-lime-700',   bg: 'bg-lime-100',   label: '\uCF58\uD150\uCE20\uAC80\uC218\uD300' },
 };
 
 const ROOMS = [
-  { id: '\uB300\uD45C\uB2D8',           name: '\uB300\uD45C \uBCF4\uACE0',     icon: '\u{1F454}', members: ['\uB300\uD45C\uB2D8', 'consultant', '\uBD80\uC7A5'] },
+  // Top-level
+  { id: '\uB300\uD45C\uB2D8',           name: '\uB300\uD45C \uBCF4\uACE0',     icon: '\u{1F454}', members: ['\uB300\uD45C\uB2D8', '\uACF5\uB3D9\uB300\uD45C', 'consultant', '\uBD80\uC7A5'] },
+  { id: '\uACF5\uB3D9\uB300\uD45C',         name: '\uACF5\uB3D9\uB300\uD45C',      icon: '\u2B50', members: ['\uB300\uD45C\uB2D8', '\uACF5\uB3D9\uB300\uD45C', '\uBD80\uC7A5'] },
   { id: 'consultant',       name: '\uCEE8\uC124\uD134\uD2B8',      icon: '\u{1F91D}', members: ['consultant', '\uBD80\uC7A5'] },
+  // Engineering teams
   { id: 'architect-team',   name: '\uC544\uD0A4\uD14D\uCC98\uD300',    icon: '\u{1F3D7}\uFE0F', members: ['\uBD80\uC7A5', 'architect-team'] },
+  { id: 'dev-team',         name: '\uAC1C\uBC1C\uD300',        icon: '\u{1F4BB}', members: ['\uBD80\uC7A5', 'dev-team'] },
   { id: 'code-review-team', name: '\uCF54\uB4DC\uB9AC\uBDF0\uD300',    icon: '\u{1F4DD}', members: ['\uBD80\uC7A5', 'code-review-team'] },
-  { id: 'doc-sync-team',    name: '\uBB38\uC11C\uAD00\uB9AC\uD300',    icon: '\u{1F4C4}', members: ['\uBD80\uC7A5', 'doc-sync-team'] },
   { id: 'security-team',    name: '\uBCF4\uC548\uD300',        icon: '\u{1F6E1}\uFE0F', members: ['\uBD80\uC7A5', 'security-team'] },
   { id: 'db-guard-team',    name: 'DB\uD300',          icon: '\u{1F5C4}\uFE0F', members: ['\uBD80\uC7A5', 'db-guard-team'] },
   { id: 'qa-team',          name: 'QA\uD300',          icon: '\u{1F9EA}', members: ['\uBD80\uC7A5', 'qa-team'] },
   { id: 'verifier-team',    name: '\uAC80\uC218\uD300',        icon: '\u2705', members: ['\uBD80\uC7A5', 'verifier-team'] },
-  { id: 'dev-team',         name: '\uAC1C\uBC1C\uD300',        icon: '\u{1F4BB}', members: ['\uBD80\uC7A5', 'dev-team'] },
+  { id: 'doc-sync-team',    name: '\uBB38\uC11C\uAD00\uB9AC\uD300',    icon: '\u{1F4C4}', members: ['\uBD80\uC7A5', 'doc-sync-team'] },
+  // Content production teams (added 0.5.0)
+  { id: 'research-team',    name: '\uB9AC\uC11C\uCE58\uD300',      icon: '\u{1F50D}', members: ['\uBD80\uC7A5', 'research-team'] },
+  { id: 'analysis-team',    name: '\uBD84\uC11D\uD300',        icon: '\u{1F4CA}', members: ['\uBD80\uC7A5', 'analysis-team'] },
+  { id: 'script-team',      name: '\uB300\uBCF8\uD300',        icon: '\u270D\uFE0F', members: ['\uBD80\uC7A5', 'script-team'] },
+  { id: 'image-team',       name: '\uC774\uBBF8\uC9C0\uD300',      icon: '\u{1F3A8}', members: ['\uBD80\uC7A5', 'image-team'] },
+  { id: 'voice-team',       name: '\uC74C\uC131\uD300',        icon: '\u{1F399}\uFE0F', members: ['\uBD80\uC7A5', 'voice-team'] },
+  { id: 'edit-team',         name: '\uD3B8\uC9D1\uD300',       icon: '\u{1F3AC}', members: ['\uBD80\uC7A5', 'edit-team'] },
+  { id: 'content-qa-team',  name: '\uCF58\uD150\uCE20\uAC80\uC218\uD300',  icon: '\u{1F50E}', members: ['\uBD80\uC7A5', 'content-qa-team'] },
+  // External (0.5.1) \u2014 catches any from/to == '\uC678\uBD80\uD300\uC6D0' (Director's external dispatch logging)
+  { id: '\uC678\uBD80\uD300\uC6D0',         name: '\uC678\uBD80\uD300\uC6D0',      icon: '\u{1F310}', members: ['\uBD80\uC7A5', '\uC678\uBD80\uD300\uC6D0', '\uACF5\uB3D9\uB300\uD45C'] },
 ];
 
 const STORAGE_KEY = 'harness-bujang-read';
+const FILTER_KEY = 'harness-bujang-filter';
 const state = {
   messages: [],
   selectedRoom: null,
   readCounts: JSON.parse(localStorage.getItem(STORAGE_KEY) || '{}'),
+  filter: localStorage.getItem(FILTER_KEY) || 'all',  // 'all' | 'unread'
   loading: true,
 };
 
@@ -1272,6 +1298,16 @@ function render() {
   const warnings = state.messages.filter((m) => m.severity === 'warning').length;
   const infos    = state.messages.filter((m) => m.severity === 'info').length;
 
+  // Pre-compute unread per room (for the filter button + badges).
+  const unreadByRoom = {};
+  let totalUnread = 0;
+  for (const room of ROOMS) {
+    const count = filterMessages(state.messages, room.id).length;
+    const unread = Math.max(0, count - (state.readCounts[room.id] || 0));
+    unreadByRoom[room.id] = unread;
+    totalUnread += unread;
+  }
+
   let html = '<div class="w-80 border-r border-gray-200 bg-white flex flex-col h-full">';
   html += '<div class="p-4 border-b border-gray-200">';
   html += '<h1 class="text-lg font-bold text-gray-900">\uD558\uB124\uC2A4 \uD1A1\uBC29</h1>';
@@ -1283,14 +1319,38 @@ function render() {
     if (infos)    html += '<span class="px-2 py-0.5 text-xs font-bold bg-green-100 text-green-700 rounded-full">INFO ' + infos + '</span>';
     html += '</div>';
   }
+
+  // Filter buttons \u2014 KakaoTalk-style: \uC804\uCCB4 / \uC548\uC77D\uC74C
+  html += '<div class="flex gap-2 mt-3">';
+  html += '<button data-filter="all" class="px-3 py-1.5 text-xs font-semibold rounded-full border transition-colors ' +
+          (state.filter === 'all' ? 'bg-gray-900 text-white border-gray-900' : 'bg-white text-gray-700 border-gray-300 hover:bg-gray-50') +
+          '">\uC804\uCCB4</button>';
+  html += '<button data-filter="unread" class="px-3 py-1.5 text-xs font-semibold rounded-full border transition-colors flex items-center gap-1.5 ' +
+          (state.filter === 'unread' ? 'bg-gray-900 text-white border-gray-900' : 'bg-white text-gray-700 border-gray-300 hover:bg-gray-50') +
+          '">';
+  html += '<span>\u{1F4AC} \uC548\uC77D\uC74C</span>';
+  if (totalUnread > 0) {
+    html += '<span class="px-1.5 py-0.5 text-[10px] font-bold bg-red-500 text-white rounded-full">' + totalUnread + '</span>';
+  }
+  html += '</button>';
+  html += '</div>';
   html += '</div>';
 
   html += '<div class="flex-1 overflow-y-auto">';
-  for (const room of ROOMS) {
+  // When 'unread' filter is active, only show rooms with unread > 0.
+  const visibleRooms = state.filter === 'unread'
+    ? ROOMS.filter((r) => unreadByRoom[r.id] > 0)
+    : ROOMS;
+
+  if (visibleRooms.length === 0) {
+    html += '<div class="px-4 py-12 text-center"><p class="text-3xl mb-2">\u{1F4ED}</p><p class="text-xs text-gray-500">\uC548\uC77D\uC740 \uD1A1\uBC29\uC774 \uC5C6\uC2B5\uB2C8\uB2E4</p></div>';
+  }
+
+  for (const room of visibleRooms) {
     const last = getLastMessage(state.messages, room.id);
     const count = filterMessages(state.messages, room.id).length;
     const isSelected = state.selectedRoom === room.id;
-    const unread = count - (state.readCounts[room.id] || 0);
+    const unread = unreadByRoom[room.id];
     html += '<button data-room-id="' + escapeHtml(room.id) + '" class="w-full flex items-center gap-3 px-4 py-3 text-left transition-colors ' +
             (isSelected ? 'bg-indigo-50' : 'hover:bg-gray-50') + '">';
     html += '<div class="flex-shrink-0 w-12 h-12 rounded-2xl bg-gray-100 flex items-center justify-center text-2xl">' + room.icon + '</div>';
@@ -1365,6 +1425,15 @@ function render() {
 
   root.innerHTML = html;
 
+  // Re-bind filter buttons (\uC804\uCCB4 / \uC548\uC77D\uC74C).
+  document.querySelectorAll('[data-filter]').forEach((el) => {
+    el.addEventListener('click', () => {
+      state.filter = el.getAttribute('data-filter');
+      localStorage.setItem(FILTER_KEY, state.filter);
+      render();
+    });
+  });
+
   // Re-bind room-click handlers (room list).
   document.querySelectorAll('[data-room-id]').forEach((el) => {
     el.addEventListener('click', () => {
@@ -1814,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`,
@@ -1823,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)
@@ -1846,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)
 
-${c6.bold("Options for migrate:")}
+${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)")}
+
+${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() {
@@ -1907,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.4.2");
+      console.log("0.5.2");
       break;
     case "--help":
     case "-h":
@@ -1920,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.4.2",
+  "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",