@dmsdc-ai/aigentry-deliberation 0.0.34 → 0.0.36

package/README.md

@@ -15,10 +15,14 @@ MCP Deliberation Server — Multi-session AI deliberation with smart speaker ord
 - **Browser LLM integration**: CDP-based auto-turn for ChatGPT, Claude, Gemini browser tabs
 - **Chrome Extension support**: Side panel detection via title-based matching
 - **Cross-platform**: macOS (tmux + Terminal.app), Windows (Windows Terminal), Linux
+- **Telepty bus transport**: structured `turn_request` delivery for telepty-managed sessions
+- **User-confirmed speaker selection**: candidates must be confirmed before a session can start
 - **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)
+- **Split telepty timeouts**: 5s transport ack + 60s semantic response tracking
+- **Typed synthesis envelopes**: validated structured payloads for downstream automation
 - **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
@@ -102,6 +106,7 @@ Claude Code, Codex CLI, Gemini CLI의 MCP 설정을 자동 점검하고 문제
 | `deliberation_list` | List archived sessions |
 | `deliberation_reset` | Reset session(s) |
 | `deliberation_speaker_candidates` | List available speakers |
+| `deliberation_confirm_speakers` | Confirm the exact user-selected speaker set |
 | `deliberation_browser_llm_tabs` | List browser LLM tabs |
 | `deliberation_browser_auto_turn` | Auto-send turn to browser LLM |
 | `deliberation_route_turn` | Route turn to appropriate transport |
@@ -109,6 +114,29 @@ Claude Code, Codex CLI, Gemini CLI의 MCP 설정을 자동 점검하고 문제
 | `deliberation_cli_auto_turn` | Auto-send turn to CLI speaker |
 | `deliberation_cli_config` | Configure CLI settings |
 
+## Start Flow
+
+Manual participant selection is enforced for both CLI speakers and telepty sessions.
+
+```text
+1. deliberation_speaker_candidates(...)
+2. User picks speakers in the TUI
+3. deliberation_confirm_speakers(selection_token: "<candidate-token>", speakers: [...])
+4. deliberation_start(selection_token: "<confirmed-token>", speakers: [...])
+```
+
+Raw candidate tokens cannot start a deliberation.
+
+## Telepty Transport
+
+Telepty-managed sessions are now routed through the telepty bus instead of raw PTY inject guidance.
+
+- `deliberation_route_turn` publishes a typed `turn_request` envelope on `ws://localhost:3848/api/bus`
+- transport delivery is tracked with a 5-second `inject_written` ack window
+- semantic completion is tracked with a 60-second self-submit window
+- `session_health` bus events are cached for operator visibility
+- `deliberation_synthesize` validates and emits typed `deliberation_completed` envelopes for downstream automation
+
 ## Speaker Ordering Strategies
 
 | Strategy | Description |
@@ -179,6 +207,21 @@ cp skills/deliberation-gate/SKILL.md ~/.claude/skills/deliberation-gate/SKILL.md
 
 ## What's New
 
+### v0.0.36
+- **README refresh**: clarified the mandatory TUI speaker-selection flow and the confirmed-token handoff before `deliberation_start`
+- **Telepty candidate docs**: documented active telepty session discovery with lightweight `session_id` + `host/pid` locators instead of heavy persisted process snapshots
+- **Cross-project delivery docs**: clarified that active session lookup now resolves across project state directories, which unblocks cross-project `deliberation_respond` flows
+- **Operator guidance**: documented telepty bus transport as the automation path and unmanaged/manual sessions as the fallback path
+
+### v0.0.35
+- **Manual selection enforcement**: `deliberation_confirm_speakers` binds a fresh candidate snapshot to the exact user-picked speaker set before `deliberation_start`
+- **Telepty session candidates**: active telepty sessions appear in speaker discovery with lightweight host/pid locators
+- **Cross-project sessions**: session lookup/load/save now resolves active deliberations across project state directories
+- **Telepty bus routing**: telepty speakers route via typed `turn_request` envelopes with 5s transport and 60s semantic timeout tracking
+- **Structured synthesis envelopes**: `deliberation_synthesize` validates typed payloads before telepty bus publication
+- **Codex CLI hardening**: reduced prompt budgets, lower-friction exec profile, and clearer timeout diagnostics
+- **Packaging**: install path now preserves default config and includes required runtime modules (`clipboard.js`, `decision-engine.js`, `i18n.js`)
+
 ### 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`

package/clipboard.js

@@ -0,0 +1,178 @@
+
+import { execFileSync, spawnSync } from "child_process";
+
+function commandExistsInPath(command) {
+  try {
+    const isWin = process.platform === "win32";
+    execFileSync(isWin ? "where" : "which", [command], { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function resolveClipboardReader() {
+  if (process.platform === "darwin") {
+    if (commandExistsInPath("pbpaste")) {
+      return { cmd: "pbpaste", args: [] };
+    }
+    return { cmd: "osascript", args: ["-e", "get the clipboard as «class utf8»"] };
+  }
+  if (process.platform === "win32") {
+    const windowsShell = ["powershell.exe", "powershell", "pwsh.exe", "pwsh"]
+      .find(cmd => commandExistsInPath(cmd));
+    if (windowsShell) {
+      return { cmd: windowsShell, args: ["-NoProfile", "-Command", "Get-Clipboard -Raw"] };
+    }
+  }
+  if (commandExistsInPath("wl-paste")) {
+    return { cmd: "wl-paste", args: ["-n"] };
+  }
+  if (commandExistsInPath("xclip")) {
+    return { cmd: "xclip", args: ["-selection", "clipboard", "-o"] };
+  }
+  if (commandExistsInPath("xsel")) {
+    return { cmd: "xsel", args: ["--clipboard", "--output"] };
+  }
+  return null;
+}
+
+function resolveClipboardWriter() {
+  if (process.platform === "darwin") {
+    if (commandExistsInPath("pbcopy")) {
+      return { cmd: "pbcopy", args: [] };
+    }
+    return null;
+  }
+  if (process.platform === "win32") {
+    if (commandExistsInPath("clip.exe") || commandExistsInPath("clip")) {
+      return { cmd: "clip", args: [] };
+    }
+    const windowsShell = ["powershell.exe", "powershell", "pwsh.exe", "pwsh"]
+      .find(cmd => commandExistsInPath(cmd));
+    if (windowsShell) {
+      return { cmd: windowsShell, args: ["-NoProfile", "-Command", "[Console]::In.ReadToEnd() | Set-Clipboard"] };
+    }
+  }
+  if (commandExistsInPath("wl-copy")) {
+    return { cmd: "wl-copy", args: [] };
+  }
+  if (commandExistsInPath("xclip")) {
+    return { cmd: "xclip", args: ["-selection", "clipboard"] };
+  }
+  if (commandExistsInPath("xsel")) {
+    return { cmd: "xsel", args: ["--clipboard", "--input"] };
+  }
+  return null;
+}
+
+const COMMON_ENV = {
+  LANG: "ko_KR.UTF-8",
+  LC_ALL: "ko_KR.UTF-8",
+  PATH: process.env.PATH
+};
+
+export function readClipboardText() {
+  const tool = resolveClipboardReader();
+  if (!tool) {
+    throw new Error("No supported clipboard read command found (pbpaste/wl-paste/xclip/xsel etc).");
+  }
+  const res = spawnSync(tool.cmd, tool.args, {
+    encoding: "utf-8",
+    stdio: ["ignore", "pipe", "pipe"],
+    maxBuffer: 10 * 1024 * 1024,
+    env: COMMON_ENV,
+    timeout: 3000,
+  });
+  
+  if (res.error) throw res.error;
+  if (res.status !== 0) {
+    const err = res.stderr ? res.stderr.toString() : "Unknown error";
+    throw new Error(`Clipboard read failed: ${err}`);
+  }
+  
+  return res.stdout.toString();
+}
+
+export function writeClipboardText(text) {
+  const tool = resolveClipboardWriter();
+  
+  // AppleScript fallback logic
+  const tryAppleScript = (txt) => {
+    if (process.platform !== "darwin") return false;
+    try {
+      const escaped = txt.replace(/["\\]/g, '\\$&');
+      const scriptRes = spawnSync("osascript", ["-e", `set the clipboard to "${escaped}"`], { timeout: 3000 });
+      return scriptRes.status === 0;
+    } catch {
+      return false;
+    }
+  };
+
+  if (!tool) {
+    if (tryAppleScript(text)) return;
+    throw new Error("No supported clipboard write command found.");
+  }
+  
+  const res = spawnSync(tool.cmd, tool.args, {
+    input: text,
+    encoding: "utf-8",
+    stdio: ["pipe", "ignore", "pipe"],
+    maxBuffer: 10 * 1024 * 1024,
+    timeout: 3000,
+    env: COMMON_ENV
+  });
+
+  if (res.error || res.status !== 0) {
+    if (tryAppleScript(text)) return;
+    throw res.error || new Error(`Clipboard write failed with status ${res.status}`);
+  }
+}
+
+/**
+ * Capture current clipboard image to a file (macOS only for now)
+ * @param {string} targetPath 
+ * @returns {boolean} success
+ */
+export function captureClipboardImage(targetPath) {
+  if (process.platform !== "darwin") return false;
+  
+  // Using osascript to save PNG data from clipboard
+  const script = `
+    try
+      set theFile to (POSIX file "${targetPath}")
+      set theImage to the clipboard as «class PNGf»
+      set theOpenFile to open for access theFile with write permission
+      set eof theOpenFile to 0
+      write theImage to theOpenFile
+      close access theOpenFile
+      return true
+    on error
+      try
+        close access theFile
+      end try
+      return false
+    end try
+  `;
+  
+  const res = spawnSync("osascript", ["-e", script], { timeout: 5000 });
+  return res.stdout.toString().trim() === "true";
+}
+
+/**
+ * Check if clipboard contains an image
+ * @returns {boolean}
+ */
+export function hasClipboardImage() {
+  if (process.platform !== "darwin") return false;
+  const script = `
+    try
+      (the clipboard as «class PNGf»)
+      return true
+    on error
+      return false
+    end try
+  `;
+  const res = spawnSync("osascript", ["-e", script], { timeout: 3000 });
+  return res.stdout.toString().trim() === "true";
+}