@dmsdc-ai/aigentry-deliberation 0.0.21 → 0.0.23

package/README.md

@@ -17,6 +17,12 @@ MCP Deliberation Server — Multi-session AI deliberation with smart speaker ord
 - **Cross-platform**: macOS (tmux + Terminal.app), Windows (Windows Terminal), Linux
 - **Obsidian archiving**: Auto-archive deliberation results to Obsidian vault
 - **Session monitoring**: Real-time tmux/terminal monitoring
+- **Vote enforcement**: Automatic [AGREE]/[DISAGREE]/[CONDITIONAL] vote marker requirement
+- **Dynamic CLI timeout**: Smart cold-start handling (180s first turn, 120s subsequent)
+- **Runtime logging**: Session lifecycle event logging for observability
+- **Resilient browser automation**: 5-stage degradation state machine with 60s SLO
+- **Model routing**: Dynamic per-provider model selection based on prompt analysis
+- **Role drift detection**: Structural heading markers + keyword analysis for accurate role inference
 
 ## Installation
 
@@ -31,6 +37,8 @@ npx @dmsdc-ai/aigentry-deliberation install
 2. npm 의존성 설치
 3. `~/.claude/.mcp.json`에 MCP 서버 자동 등록
 4. Claude Code 재시작하면 바로 사용 가능
+5. Gemini CLI MCP 서버 자동 등록 (`~/.gemini/settings.json`)
+6. deliberation-gate 스킬 자동 설치 (`~/.claude/skills/deliberation-gate/`)
 
 ### 기타 설치 방법
 
@@ -53,6 +61,8 @@ cd aigentry-deliberation && npm install && node install.js
 npx @dmsdc-ai/aigentry-deliberation uninstall
 ```
 
+MCP 서버 등록 해제 + 설치 파일 삭제 + 스킬 파일 정리까지 자동 처리됩니다.
+
 ## Forum Demo
 
 Deliberation이 완료되면 결과를 시각화하는 Forum View를 생성합니다.
@@ -68,6 +78,16 @@ Deliberation이 완료되면 결과를 시각화하는 Forum View를 생성합
 open demo/forum/index.html
 ```
 
+## Diagnostics
+
+MCP 연결 문제 자동 진단:
+
+```bash
+npx @dmsdc-ai/aigentry-deliberation doctor
+```
+
+Claude Code, Codex CLI, Gemini CLI의 MCP 설정을 자동 점검하고 문제를 진단합니다.
+
 ## MCP Tools
 
 | Tool | Description |
@@ -107,9 +127,37 @@ open demo/forum/index.html
 | `researcher` | Data, benchmarks, references |
 | `free` | No role constraint (default) |
 
+### Supported CLI Speakers
+
+| CLI | Command | Status |
+|-----|---------|--------|
+| Claude Code | `claude` | ✅ Tested |
+| Codex CLI | `codex` | ✅ Tested |
+| Gemini CLI | `gemini` | ✅ Tested |
+| Aider | `aider` | 🔧 Supported |
+| Cursor Agent | `cursor` | 🔧 Supported |
+| OpenCode | `opencode` | 🔧 Supported |
+| Continue | `continue` | 🔧 Supported |
+
+### Supported Browser LLMs
+
+| Provider | Transport | Status |
+|----------|-----------|--------|
+| ChatGPT | CDP / Clipboard | ✅ Tested |
+| Claude Web | CDP / Clipboard | ✅ Tested |
+| Gemini Web | CDP / Clipboard | ✅ Tested |
+| DeepSeek | CDP / Clipboard | ✅ Tested |
+| Qwen | CDP / Clipboard | ✅ Tested |
+| Poe | CDP / Clipboard | ✅ Tested |
+| Copilot | CDP / Clipboard | 🔧 Supported |
+| Perplexity | CDP / Clipboard | 🔧 Supported |
+| Mistral | CDP / Clipboard | 🔧 Supported |
+| Grok | CDP / Clipboard | 🔧 Supported |
+| HuggingChat | CDP / Clipboard | 🔧 Supported |
+
 ### deliberation-gate (Superpowers Integration)
 
-Inserts multi-AI verification gates at key [superpowers](https://github.com/anthropics/superpowers) workflow decision points.
+Inserts multi-AI verification gates at key [superpowers](https://github.com/obra/superpowers) workflow decision points.
 
 **Scenarios:**
 - **brainstorming** → multi-AI design validation before writing plans
@@ -118,11 +166,35 @@ Inserts multi-AI verification gates at key [superpowers](https://github.com/anth
 
 **Trigger:** Semi-automatic — skill recommends deliberation, user approves.
 
-**Install:**
+**Fallback:** MCP 미설치 시 self-criticism 기반 자가 검증으로 대체 (Silver 등급). MCP 설치 시 멀티-AI 토론 (Gold 등급).
+
+**Install:** `npx @dmsdc-ai/aigentry-deliberation install` 실행 시 자동 설치됩니다.
+
+수동 설치:
 ```bash
 cp skills/deliberation-gate/SKILL.md ~/.claude/skills/deliberation-gate/SKILL.md
 ```
 
+**RFC:** [Prerequisites header for tool-dependent skills](https://github.com/obra/superpowers/issues/589)
+
+## What's New
+
+### v0.0.23
+- **Vote enforcement**: Turn prompts now require [AGREE]/[DISAGREE]/[CONDITIONAL] markers for reliable consensus measurement
+- **Dynamic CLI timeout**: First CLI invocation gets 180s (cold-start buffer), subsequent turns use default 120s
+- **Runtime logging**: INFO-level lifecycle logging (SESSION_CREATED, TURN, CLI_TURN, SYNTHESIZED) to `runtime.log`
+- **Role inference improvement**: Structural heading markers (e.g., `## 조사 결과` → researcher) with +5 weight prevent false role drift detection
+
+### v0.0.22
+- **Security**: CDP `--remote-allow-origins` restricted to `127.0.0.1:9222` (was `*`)
+- **Security**: Observer CORS restricted to localhost allowlist, server bound to `127.0.0.1`
+- **Performance**: Async sleep for Chrome CDP initialization (was blocking event loop)
+- **Bug fix**: Fabrication guard uses `detectCallerSpeaker()` instead of hardcoded `"claude"`
+- **Bug fix**: CLI reviewer uses per-CLI invocation flags via `CLI_INVOCATION_HINTS`
+- **Bug fix**: Windows monitor state directory path corrected
+- **Memory**: SSE client Map cleanup on disconnect prevents memory leak
+- **Code quality**: Removed unreachable dead code in browser-control-port
+
 ## aigentry Ecosystem
 
 aigentry-deliberation is one component of the unified aigentry platform. All packages work together to make AI decisions transparent and auditable.

package/browser-control-port.js

@@ -509,15 +509,6 @@ class DevToolsMcpAdapter extends BrowserControlPort {
         }
       }
 
-      const sendResult = { ok: true };
-
-      if (!sendResult.ok) {
-        return makeResult(false, null, {
-          code: "SEND_FAILED",
-          message: `Send button not found: ${binding.selectors.sendButton}`,
-        });
-      }
-
       sent.add(turnId);
       return makeResult(true, { turnId, sent: true });
     } catch (err) {

package/index.js

@@ -218,12 +218,25 @@ const ROLE_KEYWORDS = {
   researcher: /사례|데이터|연구|벤치마크|비교|논문|참고/,
 };
 
+const ROLE_HEADING_MARKERS = {
+  critic: /^##?\s*(Critic|비판|약점|심각도|위험\s*분석)/m,
+  implementer: /^##?\s*(코드\s*스케치|구현|Implementation|제안\s*코드)/m,
+  mediator: /^##?\s*(합의|종합|중재|Consensus|Mediation)/m,
+  researcher: /^##?\s*(조사\s*결과|비교\s*분석|Research|사례\s*연구|근거)/m,
+};
+
 function inferSuggestedRole(text) {
   const scores = {};
   for (const [role, pattern] of Object.entries(ROLE_KEYWORDS)) {
     const matches = (text.match(new RegExp(pattern, "g")) || []).length;
     if (matches > 0) scores[role] = matches;
   }
+  // Structural heading markers get extra weight (equivalent to 5 keyword matches)
+  for (const [role, pattern] of Object.entries(ROLE_HEADING_MARKERS)) {
+    if (pattern.test(text)) {
+      scores[role] = (scores[role] || 0) + 5;
+    }
+  }
   if (Object.keys(scores).length === 0) return "free";
   return Object.entries(scores).sort((a, b) => b[1] - a[1])[0][0];
 }
@@ -948,7 +961,7 @@ async function ensureCdpAvailable() {
 
     const launchArgs = [
       "--remote-debugging-port=9222",
-      "--remote-allow-origins=*",
+      "--remote-allow-origins=http://127.0.0.1:9222",
       `--user-data-dir=${cdpDataDir}`,
       `--profile-directory=${profileDir}`,
       "--no-first-run",
@@ -965,7 +978,7 @@ async function ensureCdpAvailable() {
     }
 
     // Wait for Chrome to initialize CDP
-    sleepMs(5000);
+    await new Promise(resolve => setTimeout(resolve, 5000));
 
     // Retry CDP connection after launch
     for (const endpoint of endpoints) {
@@ -2237,6 +2250,7 @@ ${recent}
 [response_rule]
 - 위 토론 맥락을 반영해 ${speaker}의 이번 턴 응답만 작성
 - 마크다운 본문만 출력 (불필요한 머리말/꼬리말 금지)${speakerRole !== "free" ? `\n- 배정된 역할(${speakerRole})의 관점에서 분석하고 응답` : ""}
+- 응답 마지막에 반드시 [AGREE], [DISAGREE], 또는 [CONDITIONAL: 사유] 중 하나를 포함
 [/response_rule]
 [/deliberation_turn_request]
 `;
@@ -2305,6 +2319,7 @@ function submitDeliberationTurn({ session_id, speaker, content, turn_id, channel
       suggested_next_role: suggestedRole !== "free" ? suggestedRole : undefined,
       role_drift: roleDrift || undefined,
     });
+    appendRuntimeLog("INFO", `TURN: ${state.id} | R${state.current_round} | speaker: ${normalizedSpeaker} | votes: ${votes.length > 0 ? votes.map(v => v.vote).join(",") : "none"} | channel: ${channel_used || "respond"}`);
 
     state.current_speaker = selectNextSpeaker(state);
 
@@ -2611,6 +2626,7 @@ server.tool(
       return `  - \`${p.speaker}\`: ${transport} (${p.type})`;
     }).join("\n");
 
+    appendRuntimeLog("INFO", `SESSION_CREATED: ${sessionId} | topic: ${topic.slice(0, 60)} | speakers: ${speakerOrder.join(",")} | rounds: ${rounds}`);
     return {
       content: [{
         type: "text",
@@ -2989,6 +3005,10 @@ server.tool(
       }] };
     }
 
+    // Dynamic timeout: first turn gets extra time for cold-start
+    const speakerPriorTurns = state.log.filter(e => e.speaker === speaker).length;
+    const effectiveTimeout = speakerPriorTurns === 0 ? Math.max(timeout_sec, 180) : timeout_sec;
+
     const hint = CLI_INVOCATION_HINTS[speaker];
     if (!hint) {
       return { content: [{ type: "text", text: `speaker "${speaker}"에 대한 CLI 호출 정보가 없습니다. CLI_INVOCATION_HINTS에 등록되지 않은 speaker입니다.` }] };
@@ -3039,8 +3059,8 @@ server.tool(
 
         const timer = setTimeout(() => {
           child.kill("SIGTERM");
-          reject(new Error(`CLI 타임아웃 (${timeout_sec}초)`));
-        }, timeout_sec * 1000);
+          reject(new Error(`CLI 타임아웃 (${effectiveTimeout}초)`));
+        }, effectiveTimeout * 1000);
 
         child.stdout.on("data", (data) => { stdout += data.toString(); });
         child.stderr.on("data", (data) => { stderr += data.toString(); });
@@ -3072,6 +3092,7 @@ server.tool(
       });
 
       const elapsedMs = Date.now() - startTime;
+      appendRuntimeLog("INFO", `CLI_TURN: ${resolved} | speaker: ${speaker} | cli: ${hint.cmd} | elapsed: ${elapsedMs}ms | response_len: ${response.length}`);
 
       if (!response) {
         return { content: [{ type: "text", text: `⚠️ CLI "${speaker}"가 빈 응답을 반환했습니다.` }] };
@@ -3124,7 +3145,8 @@ server.tool(
         const { transport } = resolveTransportForSpeaker(state, speaker);
         if (transport === "cli_respond" || transport === "browser_auto") {
           // Check if caller is the same speaker (legitimate self-response) or an impersonator
-          const callerIsSpeaker = (speaker === "claude"); // orchestrator can only legitimately respond as "claude"
+          const callerSpeaker = detectCallerSpeaker();
+          const callerIsSpeaker = callerSpeaker && (speaker === callerSpeaker);
           if (!callerIsSpeaker) {
             return {
               content: [{
@@ -3232,6 +3254,8 @@ server.tool(
       return lockedResult;
     }
 
+    appendRuntimeLog("INFO", `SYNTHESIZED: ${resolved} | turns: ${state.log.length} | rounds: ${state.max_rounds}`);
+
     // 토론 종료 즉시 모니터 터미널(물리 Terminal 포함) 강제 종료
     closeMonitorTerminal(state.id, getSessionWindowIds(state));
 
@@ -3448,15 +3472,36 @@ server.tool(
 // ── Request Review (auto-review) ───────────────────────────────
 
 function invokeCliReviewer(command, prompt, timeoutMs) {
-  const args = ["-p", prompt, "--no-input"];
+  const hint = CLI_INVOCATION_HINTS[command];
+  let args;
+  let opts = { encoding: "utf-8", timeout: timeoutMs, stdio: ["pipe", "pipe", "pipe"], maxBuffer: 5 * 1024 * 1024, windowsHide: true };
+  const env = { ...process.env };
+
+  switch (command) {
+    case "claude":
+      if (hint?.envPrefix?.includes("CLAUDECODE=")) delete env.CLAUDECODE;
+      args = ["-p", "--output-format", "text", "--no-input"];
+      opts.input = prompt;
+      opts.stdio = ["pipe", "pipe", "pipe"];
+      break;
+    case "codex":
+      args = ["exec", prompt];
+      opts.stdio = ["ignore", "pipe", "pipe"];
+      break;
+    case "gemini":
+      args = ["-p", prompt];
+      opts.stdio = ["ignore", "pipe", "pipe"];
+      break;
+    default: {
+      const flags = hint?.flags ? hint.flags.split(/\s+/).filter(Boolean) : ["-p"];
+      args = [...flags, prompt];
+      opts.stdio = ["ignore", "pipe", "pipe"];
+      break;
+    }
+  }
+
   try {
-    const result = execFileSync(command, args, {
-      encoding: "utf-8",
-      timeout: timeoutMs,
-      stdio: ["ignore", "pipe", "pipe"],
-      maxBuffer: 5 * 1024 * 1024,
-      windowsHide: true,
-    });
+    const result = execFileSync(command, args, { ...opts, env });
     return { ok: true, response: result.trim() };
   } catch (error) {
     if (error && error.killed) {
@@ -3736,4 +3781,4 @@ if (__entryFile && path.resolve(__currentFile) === __entryFile) {
 }
 
 // ── Test exports (used by vitest) ──
-export { selectNextSpeaker, loadRolePrompt, inferSuggestedRole, parseVotes, ROLE_KEYWORDS, loadRolePresets, applyRolePreset, detectDegradationLevels, formatDegradationReport, DEGRADATION_TIERS };
+export { selectNextSpeaker, loadRolePrompt, inferSuggestedRole, parseVotes, ROLE_KEYWORDS, ROLE_HEADING_MARKERS, loadRolePresets, applyRolePreset, detectDegradationLevels, formatDegradationReport, DEGRADATION_TIERS };

package/observer.js

@@ -261,7 +261,9 @@ function createServer(port) {
     const pathname = url.pathname;
 
     // CORS
-    res.setHeader("Access-Control-Allow-Origin", "*");
+    const origin = req.headers.origin || "";
+    const allowedOrigins = [`http://127.0.0.1:${port}`, `http://localhost:${port}`];
+    res.setHeader("Access-Control-Allow-Origin", allowedOrigins.includes(origin) ? origin : allowedOrigins[0]);
     res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
     res.setHeader("Access-Control-Allow-Headers", "Content-Type");
 
@@ -377,7 +379,13 @@ function createServer(port) {
 
       req.on("close", () => {
         const clients = sseClients.get(sessionId) || [];
-        sseClients.set(sessionId, clients.filter(c => c !== res));
+        const remaining = clients.filter(c => c !== res);
+        if (remaining.length === 0) {
+          sseClients.delete(sessionId);
+          sessionSnapshots.delete(sessionId);
+        } else {
+          sseClients.set(sessionId, remaining);
+        }
       });
       return;
     }
@@ -468,7 +476,7 @@ const server = createServer(port);
 // Poll every 1 second
 const pollInterval = setInterval(pollSessions, 1000);
 
-server.listen(port, () => {
+server.listen(port, "127.0.0.1", () => {
   console.log(`Deliberation Observer running at http://localhost:${port}`);
   console.log(`   Dashboard: http://localhost:${port}/`);
   console.log(`   API: http://localhost:${port}/api/sessions`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dmsdc-ai/aigentry-deliberation",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "MCP Deliberation Server — Multi-session AI deliberation with smart speaker ordering and persona roles",
   "type": "module",
   "license": "MIT",

package/session-monitor-win.js

@@ -14,7 +14,7 @@ if (!sessionId) {
 }
 
 const HOME = process.env.HOME || process.env.USERPROFILE || "";
-const stateDir = path.join(HOME, ".local", "state", "mcp-deliberation", project);
+const stateDir = path.join(HOME, ".local", "lib", "mcp-deliberation", "state", project);
 const stateFile = path.join(stateDir, `${sessionId}.json`);
 
 const BOLD = "\x1b[1m";