@dmsdc-ai/aigentry-deliberation 0.0.22 → 0.0.24

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
 
@@ -121,6 +127,34 @@ Claude Code, Codex CLI, Gemini CLI의 MCP 설정을 자동 점검하고 문제
 | `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/obra/superpowers) workflow decision points.
@@ -143,6 +177,30 @@ 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.24
+- **Role inference**: Heading marker weight increased from +5 to +8, added critic(검증/평가/Review) and researcher(데이터/Data) patterns to reduce false positives
+- **Logging payload**: TURN log includes `suggested_role`, `role_drift`; CLI_TURN log includes `prior_turns`, `effective_timeout`
+- **Vote marker warning**: WARN-level `INVALID_TURN` logged when response lacks [AGREE]/[DISAGREE]/[CONDITIONAL] markers
+- **Auto-deploy**: `postversion` hook auto-installs to MCP server path after `npm version`
+
+### 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/index.js

@@ -218,12 +218,25 @@ const ROLE_KEYWORDS = {
   researcher: /사례|데이터|연구|벤치마크|비교|논문|참고/,
 };
 
+const ROLE_HEADING_MARKERS = {
+  critic: /^##?\s*(Critic|비판|약점|심각도|위험\s*분석|검증|평가|Review)/m,
+  implementer: /^##?\s*(코드\s*스케치|구현|Implementation|제안\s*코드)/m,
+  mediator: /^##?\s*(합의|종합|중재|Consensus|Mediation)/m,
+  researcher: /^##?\s*(조사\s*결과|비교\s*분석|Research|사례\s*연구|근거|데이터|Data)/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) + 8;
+    }
+  }
   if (Object.keys(scores).length === 0) return "free";
   return Object.entries(scores).sort((a, b) => b[1] - a[1])[0][0];
 }
@@ -2237,6 +2250,7 @@ ${recent}
 [response_rule]
 - 위 토론 맥락을 반영해 ${speaker}의 이번 턴 응답만 작성
 - 마크다운 본문만 출력 (불필요한 머리말/꼬리말 금지)${speakerRole !== "free" ? `\n- 배정된 역할(${speakerRole})의 관점에서 분석하고 응답` : ""}
+- 응답 마지막에 반드시 [AGREE], [DISAGREE], 또는 [CONDITIONAL: 사유] 중 하나를 포함
 [/response_rule]
 [/deliberation_turn_request]
 `;
@@ -2290,6 +2304,9 @@ function submitDeliberationTurn({ session_id, speaker, content, turn_id, channel
     }
 
     const votes = parseVotes(content);
+    if (votes.length === 0) {
+      appendRuntimeLog("WARN", `INVALID_TURN: ${state.id} | R${state.current_round} | speaker: ${normalizedSpeaker} | reason: no_vote_marker`);
+    }
     const suggestedRole = inferSuggestedRole(content);
     const assignedRole = (state.speaker_roles || {})[normalizedSpeaker] || "free";
     const roleDrift = assignedRole !== "free" && suggestedRole !== "free" && assignedRole !== suggestedRole;
@@ -2305,6 +2322,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"} | suggested_role: ${suggestedRole} | role_drift: ${roleDrift || false}`);
 
     state.current_speaker = selectNextSpeaker(state);
 
@@ -2611,6 +2629,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 +3008,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 +3062,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 +3095,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} | prior_turns: ${speakerPriorTurns} | effective_timeout: ${effectiveTimeout}s`);
 
       if (!response) {
         return { content: [{ type: "text", text: `⚠️ CLI "${speaker}"가 빈 응답을 반환했습니다.` }] };
@@ -3233,6 +3257,8 @@ server.tool(
       return lockedResult;
     }
 
+    appendRuntimeLog("INFO", `SYNTHESIZED: ${resolved} | turns: ${state.log.length} | rounds: ${state.max_rounds}`);
+
     // 토론 종료 즉시 모니터 터미널(물리 Terminal 포함) 강제 종료
     closeMonitorTerminal(state.id, getSessionWindowIds(state));
 
@@ -3758,4 +3784,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dmsdc-ai/aigentry-deliberation",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "MCP Deliberation Server — Multi-session AI deliberation with smart speaker ordering and persona roles",
   "type": "module",
   "license": "MIT",
@@ -48,6 +48,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "prepublishOnly": "vitest run",
+    "postversion": "node install.js",
     "release:patch": "npm version patch && git push && git push --tags",
     "release:minor": "npm version minor && git push && git push --tags",
     "release:major": "npm version major && git push && git push --tags"