harness-bujang 0.5.2 → 0.5.4

package/README.md

@@ -36,22 +36,69 @@ npx harness-bujang update
 > 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
+### 💬 Open the chat-room — two ways (natural language recommended)
 
+After install, just **say it in plain language** inside Claude Code — the Director will spawn the viewer in the background:
+
+```
+"Director, open the chat room"
+"부장님 톡방 열어주세요"
+"open chat" / "show the chat"
+```
+
+→ The Director auto-runs `npx harness-bujang chat` (background) → browser opens → http://localhost:7777 KakaoTalk-style room.
+
+To close, also natural language:
+```
+"close the chat room"
+"톡방 닫아줘"
+```
+
+Manual command (works on any stack — Next.js, Rails, Django, Express, …):
 ```bash
-# Standalone viewer (works on Next.js, Rails, Django, Express, …) — no setup
 npx harness-bujang chat
-# → opens http://localhost:7777 in your browser
 ```
 
-The standalone viewer reads `.harness/chat.db` directly, so it works on any
-project that uses the SQLite chat backend (the default). For projects that have
-not posted any messages yet, pass `--create` to bootstrap an empty DB and seed:
+→ Reads `.harness/chat.db` directly. From 0.5.3, the DB is auto-created on first run if missing.
 
-```bash
-npx harness-bujang chat --create
+### 🎬 How to use it — call by name
+
+After install, the harness runs **inside Claude Code** by addressing personas:
+
+```
+"Director, please add a refund API"
+"부장님, 결제 환불 API 만들어주세요"
+   ↓ Director persona
+   ├─ Pre-confirm: "Plan to invoke dev-team + security-team + db-guard. Proceed?"
+   ├─ Principal OK → parallel team dispatch (per mapping table)
+   ├─ Each step → chat-room INSERT (live in viewer)
+   └─ Consolidated principal report
+
+"Cofounder, is our BM viable?"
+"공동대표, 우리 BM 이대로 가도 될까?"
+   ↓ Cofounder persona (peer, not subordinate)
+   ├─ Equal debate + push-back
+   ├─ Calls consultant / research-team / analysis-team if data needed
+   └─ Pushes the decision
 ```
 
+**Calling rules**:
+
+| Trigger | What happens |
+|---------|--------------|
+| **"Director, ..."** / "부장님, ..." | Director persona — pre-confirm, mapping, chat INSERT, consolidated report |
+| **"Cofounder, ..."** / "공동대표, ..." | Cofounder persona — peer debate / strategy / decision push |
+| **plain "..."** (no name) | Plain Claude — knows harness rules but skips the full workflow |
+| **"dev-team, ..."** directly | ❌ Won't work — the 16 teams are dispatched **by** Director / Cofounder, not addressed directly by the principal |
+
+> 💡 **For the full workflow (pre-confirm + mapping + chat + consolidated report), name the persona.** For quick one-offs, plain Claude is fine.
+
+Natural-language triggers:
+- Open chat: `"부장님 톡방 열어주세요"` / `"open the chat room"`
+- Code review: `"Director, please review the PR"` / `"부장님 PR 리뷰 부탁드립니다"`
+- Onboard team: `"Director, hire a marketing team"` / `"부장님 마케팅팀 채용해주세요"`
+- Strategy: `"Cofounder, what do you think?"` / `"공동대표 의견 좀"`
+
 ## What it does
 
 1. **Scans** the project — framework (Next.js / SvelteKit / Astro / Rails / Django / …), language, DB (Supabase / Prisma / Drizzle / TypeORM), UI lib, payment integration, GitHub user.

package/dist/index.js

@@ -400,9 +400,30 @@ async function runInit(args) {
   if (scan.framework.startsWith("Next.js") && opts.installTemplate) {
     console.log(`   ${c.cyan("3.")} Watch ${c.bold(context.ADMIN_HARNESS_ROUTE)} for live updates (after env setup)`);
   } else {
-    console.log(`   ${c.cyan("3.")} Watch the chat room: ${c.bold("npx harness-bujang chat --create")} ${c.dim("\u2192 http://localhost:7777")}`);
+    console.log(`   ${c.cyan("3.")} Watch the chat room: ${c.bold("npx harness-bujang chat")} ${c.dim("\u2192 http://localhost:7777")}`);
   }
   console.log();
+  printRestartReminder(opts.lang);
+}
+function printRestartReminder(lang) {
+  const ko = lang === "ko";
+  const line = (s) => `   ${c.dim("\u2502")} ${s}`;
+  const top = `   ${c.dim("\u256D" + "\u2500".repeat(64) + "\u256E")}`;
+  const bot = `   ${c.dim("\u2570" + "\u2500".repeat(64) + "\u256F")}`;
+  console.log(top);
+  console.log(line(ko ? c.bold(c.yellow("\u26A0\uFE0F  Claude Code \uAC00 \uC774\uBBF8 \uB5A0 \uC788\uB2E4\uBA74 \uC5D0\uC774\uC804\uD2B8 \uC7AC\uB85C\uB4DC \uD544\uC694!")) : c.bold(c.yellow("\u26A0\uFE0F  Claude Code already running? Reload agents!"))));
+  console.log(line(""));
+  console.log(line(ko ? "\uC5D0\uC774\uC804\uD2B8 \uB4F1\uB85D\uC740 \uC138\uC158 \uC2DC\uC791 \uC2DC\uC810\uC5D0\uB9CC \uC77C\uC5B4\uB098\uBBC0\uB85C \uC0C8\uB85C \uAE50 \uD300\uC774" : "Agents are registered at session start only, so the new teams"));
+  console.log(line(ko ? "\uBC14\uB85C \uC778\uC2DD\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uB2E4\uC74C \uC911 \uD55C \uAC00\uC9C0\uB97C \uD574\uC8FC\uC138\uC694:" : "won't be visible yet. Pick one:"));
+  console.log(line(""));
+  console.log(line(`  ${c.green("A.")} ${c.bold(ko ? "Claude Code \uC548\uC5D0\uC11C: " : "Inside Claude Code: ")}${c.cyan("/agents")}`));
+  console.log(line(`     ${c.dim(ko ? "\u2192 \uC5D0\uC774\uC804\uD2B8 \uBA54\uB274\uC5D0\uC11C \uC7AC\uB85C\uB4DC" : "\u2192 open the agent menu / refresh")}`));
+  console.log(line(""));
+  console.log(line(`  ${c.green("B.")} ${c.bold(ko ? "\uC548\uB418\uBA74 Claude Code \uC644\uC804 \uC885\uB8CC \u2192 \uAC19\uC740 \uD3F4\uB354\uC5D0\uC11C \uB2E4\uC2DC \uC2DC\uC791" : "Or fully restart Claude Code in this folder")}`));
+  console.log(line(""));
+  console.log(line(c.dim(ko ? "/clear \uB294 \uCEE8\uD14D\uC2A4\uD2B8\uB9CC \uBE44\uC6C1\uB2C8\uB2E4 \u2014 \uC5D0\uC774\uC804\uD2B8 \uC7AC\uB4F1\uB85D \uC548 \uB428" : "/clear only wipes context \u2014 it does NOT re-register agents")));
+  console.log(bot);
+  console.log();
 }
 async function promptInteractive(opts, scan) {
   const lang = await select({
@@ -933,19 +954,6 @@ async function runChat(args) {
   }
   const dbPath = resolveDbPath(opts.target);
   if (!fs5.existsSync(dbPath)) {
-    if (!opts.create) {
-      console.log();
-      console.log(c4.red(`\u2716 Chat DB not found at ${c4.bold(dbPath)}`));
-      console.log();
-      console.log("  This usually means the harness has not posted any messages yet,");
-      console.log("  or the project does not use the SQLite chat backend.");
-      console.log();
-      console.log("  Run with " + c4.bold("--create") + " to create an empty DB and schema:");
-      console.log("    " + c4.cyan("bujang chat --create"));
-      console.log();
-      process.exitCode = 1;
-      return;
-    }
     fs5.mkdirSync(path5.dirname(dbPath), { recursive: true });
     await runSql(dbPath, SCHEMA_SQL);
     const seedId = `seed-${Date.now()}`;
@@ -954,7 +962,7 @@ async function runChat(args) {
       `INSERT INTO harness_messages (id, "from", "to", type, message, severity)
        VALUES ('${seedId}', '\uBD80\uC7A5', '\uB300\uD45C\uB2D8', 'info', '\uD1A1\uBC29\uC774 \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uCCAB \uBA85\uB839\uC744 \uB0B4\uB824\uC8FC\uC138\uC694.', 'info');`
     );
-    console.log(c4.dim(`   created empty DB + schema at ${dbPath}`));
+    console.log(c4.dim(`   created empty chat DB at ${dbPath}`));
   } else {
     await runSql(dbPath, SCHEMA_SQL);
   }
@@ -1950,6 +1958,7 @@ async function runUpdate(args) {
   console.log("   To overwrite everything (e.g. for a clean reset), use instead:");
   console.log(`     ${c6.cyan("npx harness-bujang init --yes")}`);
   console.log();
+  printRestartReminder(opts.lang);
 }
 async function resolveAssetPaths2() {
   const packaged = path7.resolve(__dirname3, "..", "templates");
@@ -2162,7 +2171,7 @@ async function main() {
       break;
     case "--version":
     case "-v":
-      console.log("0.5.2");
+      console.log("0.5.4");
       break;
     case "--help":
     case "-h":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harness-bujang",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "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",