harness-bujang 0.5.3 → 0.5.5

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({
@@ -1323,7 +1344,7 @@ function render() {
   html += '</div>';
   html += '</div>';
 
-  html += '<div class="flex-1 overflow-y-auto">';
+  html += '<div id="room-list" class="flex-1 overflow-y-auto">';
   // When 'unread' filter is active, only show rooms with unread > 0.
   const visibleRooms = state.filter === 'unread'
     ? ROOMS.filter((r) => unreadByRoom[r.id] > 0)
@@ -1410,8 +1431,27 @@ function render() {
   }
   html += '</div>';
 
+  // Save scroll positions BEFORE replacing innerHTML \u2014 otherwise every 2s poll
+  // resets the sidebar room-list scroll to top, and the conversation re-snaps
+  // to the bottom even if the user was reading older messages.
+  const oldRoomList = document.getElementById('room-list');
+  const oldConv = document.getElementById('conversation');
+  const savedRoomScroll = oldRoomList ? oldRoomList.scrollTop : 0;
+  let savedConvScroll = null;
+  let convWasAtBottom = true;
+  if (oldConv) {
+    savedConvScroll = oldConv.scrollTop;
+    // "At bottom" within ~80px \u2014 if user was at bottom we keep them at bottom
+    // (so new messages stay visible). If they scrolled up, preserve position.
+    convWasAtBottom = (oldConv.scrollHeight - oldConv.scrollTop - oldConv.clientHeight) < 80;
+  }
+
   root.innerHTML = html;
 
+  // Restore scroll positions.
+  const newRoomList = document.getElementById('room-list');
+  if (newRoomList) newRoomList.scrollTop = savedRoomScroll;
+
   // Re-bind filter buttons (\uC804\uCCB4 / \uC548\uC77D\uC74C).
   document.querySelectorAll('[data-filter]').forEach((el) => {
     el.addEventListener('click', () => {
@@ -1434,11 +1474,20 @@ function render() {
     });
   });
 
-  // Auto-scroll the selected room to the bottom on first render of that room.
+  // Conversation scroll handling:
+  //  - First render of a room \u2192 scroll to bottom (latest msg visible)
+  //  - User was at bottom \u2192 keep at new bottom (so new msgs auto-show)
+  //  - User scrolled up to read history \u2192 preserve their position
   const conv = document.getElementById('conversation');
-  if (conv && conv.dataset.scrolled !== state.selectedRoom) {
-    conv.scrollTop = conv.scrollHeight;
-    conv.dataset.scrolled = state.selectedRoom;
+  if (conv) {
+    if (conv.dataset.scrolled !== state.selectedRoom) {
+      conv.scrollTop = conv.scrollHeight;
+      conv.dataset.scrolled = state.selectedRoom;
+    } else if (convWasAtBottom) {
+      conv.scrollTop = conv.scrollHeight;
+    } else if (savedConvScroll !== null) {
+      conv.scrollTop = savedConvScroll;
+    }
   }
 }
 
@@ -1937,6 +1986,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");
@@ -2149,7 +2199,7 @@ async function main() {
       break;
     case "--version":
     case "-v":
-      console.log("0.5.2");
+      console.log("0.5.5");
       break;
     case "--help":
     case "-h":

package/package.json

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

package/templates/project-template/app/api/harness/logs/route.ts

@@ -28,7 +28,7 @@ export async function GET(request: NextRequest) {
     const before = searchParams.get('before') ?? undefined;
     const limit = parseInt(searchParams.get('limit') ?? '50', 10);
 
-    const db = getHarnessDb();
+    const db = await getHarnessDb();
     const messages = before ? await db.list({ before, limit }) : await db.list({ days });
 
     return NextResponse.json({ data: messages });
@@ -81,7 +81,7 @@ export async function POST(request: NextRequest) {
       from = trimmed;
     }
 
-    const db = getHarnessDb();
+    const db = await getHarnessDb();
 
     let msgId = id;
     if (!msgId) {

package/templates/project-template/app/api/harness/reply/route.ts

@@ -22,7 +22,7 @@ export async function POST(request: NextRequest) {
       return NextResponse.json({ error: 'message is required' }, { status: 400 });
     }
 
-    const db = getHarnessDb();
+    const db = await getHarnessDb();
     const total = await db.count();
 
     const msg: ChatMessage = {

package/templates/project-template/lib/harness-db/index.ts

@@ -5,20 +5,30 @@
 //   - "supabase"           — cloud Postgres via Supabase, prod-ready
 //
 // To switch later, run `bujang migrate --to=supabase` (or back to sqlite).
+//
+// IMPORTANT: adapters are loaded with **dynamic `import()`** so that a project
+// using only the SQLite backend doesn't pay for `@supabase/supabase-js` at
+// bundle / install time, and vice versa. (Static imports here would force
+// Next.js / webpack / turbopack to compile both adapters into every chunk
+// that touches the DB — discovered in nextjs-e2e-test against a sqlite-only
+// install where supabase-js wasn't installed and the build failed.)
 
 import type { HarnessDb, HarnessDbMode } from './types';
-import { createSqliteAdapter } from './sqlite';
-import { createSupabaseAdapter } from './supabase';
 
 export type { HarnessDb, ChatMessage, ListOptions, HarnessDbMode } from './types';
-export { createSqliteAdapter, createSupabaseAdapter };
 
 let _instance: HarnessDb | null = null;
+let _pending: Promise<HarnessDb> | null = null;
 
-export function getHarnessDb(): HarnessDb {
-  if (_instance) return _instance;
-  _instance = createAdapter(currentMode());
-  return _instance;
+export function getHarnessDb(): Promise<HarnessDb> {
+  if (_instance) return Promise.resolve(_instance);
+  if (_pending) return _pending;
+  _pending = createAdapter(currentMode()).then((db) => {
+    _instance = db;
+    _pending = null;
+    return db;
+  });
+  return _pending;
 }
 
 export function currentMode(): HarnessDbMode {
@@ -29,11 +39,13 @@ export function currentMode(): HarnessDbMode {
   );
 }
 
-export function createAdapter(mode: HarnessDbMode): HarnessDb {
-  switch (mode) {
-    case 'sqlite':   return createSqliteAdapter();
-    case 'supabase': return createSupabaseAdapter();
+export async function createAdapter(mode: HarnessDbMode): Promise<HarnessDb> {
+  if (mode === 'sqlite') {
+    const { createSqliteAdapter } = await import('./sqlite');
+    return createSqliteAdapter();
   }
+  const { createSupabaseAdapter } = await import('./supabase');
+  return createSupabaseAdapter();
 }
 
 /**
@@ -42,4 +54,5 @@ export function createAdapter(mode: HarnessDbMode): HarnessDb {
  */
 export function resetHarnessDb(): void {
   _instance = null;
+  _pending = null;
 }