@dmsdc-ai/aigentry-deliberation 0.0.1 → 0.0.4

package/README.md

@@ -16,39 +16,37 @@ MCP Deliberation Server — Multi-session AI deliberation with smart speaker ord
 
 ## Installation
 
-### As standalone MCP server
+원클릭 설치 — 어떤 프로젝트 환경에서든 동작합니다:
 
 ```bash
-npm install -g @dmsdc-ai/aigentry-deliberation
+npx @dmsdc-ai/aigentry-deliberation install
 ```
 
-### Via aigentry-devkit
+이 명령은:
+1. `~/.local/lib/mcp-deliberation/`에 서버 파일 설치 (Windows: `%LOCALAPPDATA%/mcp-deliberation/`)
+2. npm 의존성 설치
+3. `~/.claude/.mcp.json`에 MCP 서버 자동 등록
+4. Claude Code 재시작하면 바로 사용 가능
+
+### 기타 설치 방법
 
 ```bash
-npx @dmsdc-ai/aigentry-devkit setup
-```
+# 글로벌 설치
+npm install -g @dmsdc-ai/aigentry-deliberation
+deliberation-install
 
-### Manual
+# aigentry-devkit 통합 설치
+npx @dmsdc-ai/aigentry-devkit setup
 
-```bash
+# 소스에서 직접 설치
 git clone https://github.com/dmsdc-ai/aigentry-deliberation.git
-cd aigentry-deliberation
-npm install
+cd aigentry-deliberation && npm install && node install.js
 ```
 
-## MCP Configuration
+### 제거
 
-Add to `~/.claude/.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "deliberation": {
-      "command": "node",
-      "args": ["/path/to/aigentry-deliberation/index.js"]
-    }
-  }
-}
+```bash
+npx @dmsdc-ai/aigentry-deliberation uninstall
 ```
 
 ## MCP Tools

package/index.js

@@ -1,4 +1,36 @@
 #!/usr/bin/env node
+
+// ── CLI command routing (must be before any imports) ──
+// Supports: npx @dmsdc-ai/aigentry-deliberation install
+//           npx @dmsdc-ai/aigentry-deliberation --help
+const _cliArg = process.argv[2];
+if (_cliArg === "install" || _cliArg === "uninstall" || _cliArg === "--uninstall") {
+  const { execFileSync } = await import("node:child_process");
+  const { fileURLToPath } = await import("node:url");
+  const { dirname, join } = await import("node:path");
+  const __installDir = dirname(fileURLToPath(import.meta.url));
+  const installArgs = _cliArg === "install" ? [] : ["--uninstall"];
+  try {
+    execFileSync(process.execPath, [join(__installDir, "install.js"), ...installArgs], { stdio: "inherit" });
+  } catch (e) {
+    process.exit(e.status || 1);
+  }
+  process.exit(0);
+}
+if (_cliArg === "--help" || _cliArg === "-h") {
+  console.log(`
+MCP Deliberation Server
+
+Usage:
+  npx @dmsdc-ai/aigentry-deliberation install     설치 (MCP 서버 등록)
+  npx @dmsdc-ai/aigentry-deliberation uninstall    제거
+  npx @dmsdc-ai/aigentry-deliberation              MCP 서버 실행 (stdio)
+
+설치 후 Claude Code를 재시작하면 자동으로 사용 가능합니다.
+`);
+  process.exit(0);
+}
+
 /**
  * MCP Deliberation Server (Global) — v2.5 Multi-Session + Transport Routing + Cross-Platform + BrowserControlPort
  *
@@ -2154,7 +2186,6 @@ server.tool(
     }
 
     const sessionId = generateSessionId(topic);
-    const hasManualSpeakers = Array.isArray(speakers) && speakers.length > 0;
     const candidateSnapshot = await collectSpeakerCandidates({ include_cli: true, include_browser: true });
 
     // Resolve effective settings from config
@@ -2165,12 +2196,26 @@ server.tool(
     // Resolve "auto": 2 speakers → cyclic, 3+ → weighted-random
     ordering_strategy = rawOrdering === "auto" ? undefined : rawOrdering; // resolved after speakers are known
 
+    // When require_speaker_selection is explicitly true in config,
+    // ignore LLM-provided speakers UNLESS require_manual_speakers: true is explicitly passed
+    // (which signals the user has confirmed the speaker selection)
+    const configRequiresSelection = config.require_speaker_selection === true;
+    const llmExplicitlyConfirmed = require_manual_speakers === true;
+    const hasManualSpeakers = Array.isArray(speakers) && speakers.length > 0
+      && (!configRequiresSelection || llmExplicitlyConfirmed);
+
     if (!hasManualSpeakers && effectiveRequireManual) {
       const candidateText = formatSpeakerCandidatesReport(candidateSnapshot);
+      const llmSuggested = Array.isArray(speakers) && speakers.length > 0
+        ? `\n\n💡 **LLM이 제안한 스피커:** ${speakers.join(", ")}\n위 제안을 사용하려면 \`require_manual_speakers: true\`와 함께 speakers를 다시 전달하세요.`
+        : "";
+      const configNote = configRequiresSelection
+        ? "\n\n⚙️ `require_speaker_selection: true` 설정에 의해 사용자가 직접 스피커를 선택해야 합니다."
+        : "";
       return {
         content: [{
           type: "text",
-          text: `스피커를 직접 선택해야 deliberation을 시작할 수 있습니다.\n\n${candidateText}\n\n예시:\n\ndeliberation_start(\n  topic: "${topic.replace(/"/g, '\\"')}",\n  rounds: ${rounds},\n  speakers: ["codex", "web-claude-1", "web-chatgpt-1"],\n  first_speaker: "codex"\n)\n\n먼저 deliberation_speaker_candidates를 호출해 현재 선택 가능한 스피커를 확인하세요.`,
+          text: `스피커를 직접 선택해야 deliberation을 시작할 수 있습니다.${configNote}${llmSuggested}\n\n${candidateText}\n\n예시:\n\ndeliberation_start(\n  topic: "${topic.replace(/"/g, '\\"')}",\n  rounds: ${rounds},\n  speakers: ["codex", "web-claude-1", "web-chatgpt-1"],\n  require_manual_speakers: true,\n  first_speaker: "codex"\n)\n\n먼저 deliberation_speaker_candidates를 호출해 현재 선택 가능한 스피커를 확인하세요.`,
         }],
       };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dmsdc-ai/aigentry-deliberation",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "description": "MCP Deliberation Server — Multi-session AI deliberation with smart speaker ordering and persona roles",
   "type": "module",
   "license": "MIT",
@@ -40,6 +40,7 @@
     "README.md"
   ],
   "scripts": {
+    "postinstall": "node install.js || true",
     "start": "node index.js",
     "test": "vitest run",
     "test:watch": "vitest"