matterbridge-lg-thinq-plugin 0.1.0

package/.claude/statusline-command.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+input=$(cat)
+
+model=$(echo "$input" | jq -r '.model.display_name // "Claude"')
+cwd=$(echo "$input" | jq -r '.cwd // empty')
+effort=$(echo "$input" | jq -r '.effort.level // empty')
+thinking=$(echo "$input" | jq -r '.thinking.enabled // false')
+used=$(echo "$input" | jq -r '.context_window.used_percentage // empty')
+ctx_used_tokens=$(echo "$input" | jq -r '(.context_window.total_input_tokens // 0) + (.context_window.total_output_tokens // 0)')
+ctx_size_tokens=$(echo "$input" | jq -r '.context_window.context_window_size // empty')
+five_hour_pct=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
+five_hour_reset=$(echo "$input" | jq -r '.rate_limits.five_hour.resets_at // empty')
+seven_day_pct=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')
+seven_day_reset=$(echo "$input" | jq -r '.rate_limits.seven_day.resets_at // empty')
+
+RESET="\033[0m"
+DIM="\033[38;5;240m"
+FAINT="\033[38;5;244m"
+GREEN="\033[38;5;114m"
+YELLOW="\033[38;5;221m"
+RED="\033[38;5;203m"
+CYAN="\033[38;5;80m"
+MAGENTA="\033[38;5;176m"
+BLUE="\033[38;5;110m"
+
+# pct → green/yellow/red color
+pct_color() {
+  local pct=$1
+  if   [ "$pct" -ge 75 ]; then printf '%b' "$RED"
+  elif [ "$pct" -ge 50 ]; then printf '%b' "$YELLOW"
+  else                         printf '%b' "$GREEN"; fi
+}
+
+# 97923 → 97.9k, 1000000 → 1M
+fmt_tokens() {
+  local n=$1
+  if   [ "$n" -ge 1000000 ]; then awk -v n="$n" 'BEGIN { v = n / 1000000; printf (v == int(v)) ? "%.0fM" : "%.1fM", v }'
+  elif [ "$n" -ge 1000 ];    then awk -v n="$n" 'BEGIN { printf "%.1fk", n / 1000 }'
+  else printf '%d' "$n"; fi
+}
+
+render_bar() {
+  local pct=$1 bar_len=$2 color=$3
+  local filled=$(( (pct * bar_len + 50) / 100 ))
+  local empty=$(( bar_len - filled ))
+  local bar=""
+  [ "$filled" -gt 0 ] && for i in $(seq 1 $filled); do bar="${bar}▰"; done
+  bar="${color}${bar}${RESET}${DIM}"
+  [ "$empty" -gt 0 ] && for i in $(seq 1 $empty); do bar="${bar}▱"; done
+  printf '%b%b' "$bar" "$RESET"
+}
+
+# Row 1: model + effort + thinking
+printf "${MAGENTA}✦${RESET} ${CYAN}\033[1m%s${RESET}" "$model"
+if [ -n "$effort" ]; then
+  case "$effort" in
+    low)            ecolor="$GREEN"  ;;
+    medium)         ecolor="$CYAN"   ;;
+    high|xhigh|max) ecolor="$RED"    ;;
+    *)              ecolor="$MAGENTA";;
+  esac
+  printf " ${DIM}·${RESET} ${ecolor}⚡%s${RESET}" "$effort"
+fi
+if [ "$thinking" = "true" ]; then
+  printf " ${DIM}·${RESET} ${MAGENTA}✻ think:on${RESET}"
+else
+  printf " ${DIM}·${RESET} ${DIM}✻ think:off${RESET}"
+fi
+printf "\n"
+
+# Row 2: context bar
+if [ -n "$used" ]; then
+  used_int=$(printf "%.0f" "$used")
+  color=$(pct_color "$used_int")
+  printf "${FAINT}◍ ctx${RESET}  "
+  render_bar "$used_int" 18 "$color"
+  printf " ${color}%3d%%${RESET}" "$used_int"
+  if [ "$ctx_used_tokens" -gt 0 ] && [ -n "$ctx_size_tokens" ]; then
+    printf " ${DIM}⛁ %s/%s${RESET}" "$(fmt_tokens "$ctx_used_tokens")" "$(fmt_tokens "$ctx_size_tokens")"
+  fi
+fi
+printf "\n"
+
+# Row 3: 5h / 7d rate-limit bars
+if [ -n "$five_hour_pct" ]; then
+  pct_int=$(printf "%.0f" "$five_hour_pct")
+  color=$(pct_color "$pct_int")
+  printf "${FAINT}◔ 5h${RESET}   "
+  render_bar "$pct_int" 18 "$color"
+  printf " ${color}%3d%%${RESET}" "$pct_int"
+  if [ -n "$five_hour_reset" ]; then
+    reset_time=$(date -r "$five_hour_reset" +"%-I:%M%p" 2>/dev/null | tr '[:upper:]' '[:lower:]')
+    [ -n "$reset_time" ] && printf " ${DIM}↻ %s${RESET}" "$reset_time"
+  fi
+fi
+if [ -n "$seven_day_pct" ]; then
+  pct_int=$(printf "%.0f" "$seven_day_pct")
+  color=$(pct_color "$pct_int")
+  [ -n "$five_hour_pct" ] && printf "  ${DIM}│${RESET}  "
+  printf "${FAINT}◷ 7d${RESET} "
+  render_bar "$pct_int" 18 "$color"
+  printf " ${color}%d%%${RESET}" "$pct_int"
+  if [ -n "$seven_day_reset" ]; then
+    reset_time=$(date -r "$seven_day_reset" +"%d/%m %-I:%M%p" 2>/dev/null | tr '[:upper:]' '[:lower:]')
+    [ -n "$reset_time" ] && printf " ${DIM}↻ %s${RESET}" "$reset_time"
+  fi
+fi
+printf "\n"
+
+# Row 4: cwd with ~ for $HOME
+if [ -n "$cwd" ]; then
+  printf "${BLUE}📁 %s${RESET}" "${cwd/#$HOME/~}"
+fi
+printf "\n"
+
+# Row 5: git branch + commits ahead of origin/dev
+if [ -n "$cwd" ] && git -C "$cwd" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  branch=$(git -C "$cwd" branch --show-current 2>/dev/null)
+  if [ -n "$branch" ]; then
+    printf "${GREEN}⎇ %s${RESET}" "$branch"
+    if git -C "$cwd" rev-parse --verify --quiet origin/dev >/dev/null 2>&1; then
+      ahead=$(git -C "$cwd" rev-list --count origin/dev..HEAD 2>/dev/null)
+      if [ -n "$ahead" ]; then
+        if [ "$ahead" -gt 0 ]; then acolor="$YELLOW"; else acolor="$FAINT"; fi
+        printf " ${DIM}·${RESET} ${acolor}↑%s vs origin/dev${RESET}" "$ahead"
+      fi
+    fi
+  fi
+fi
+printf "\n"

package/.claude/statusline.md

@@ -0,0 +1,53 @@
+# Claude Code Status Line
+
+Shared status line for this repo. Enabled automatically via `.claude/settings.json` when you open the project in Claude Code.
+
+## Setup
+
+No manual config needed for this repo — `statusLine` is already in `.claude/settings.json`:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "bash .claude/statusline-command.sh"
+  }
+}
+```
+
+Make the script executable once after clone:
+
+```bash
+chmod +x .claude/statusline-command.sh
+```
+
+### Use globally (optional)
+
+To use the same status line in other repos, add to `~/.claude/settings.json`:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "bash /absolute/path/to/repo/.claude/statusline-command.sh"
+  }
+}
+```
+
+Replace `/absolute/path/to/repo` with your local clone path.
+
+## What it shows
+
+```
+Sonnet ~medium | context:34% ███████░░░░░░░░░░░░░ | 5h:12% █░░░░░░░░░░░░░░ reset: 3:45pm | 7d:45% ███████░░░░░░░░ reset: 29/06/2026 3:45pm | /path/to/project
+```
+
+- **Model name** — current model in cyan
+- **Effort level** — `~low`, `~medium`, `~high` (color-coded)
+- **Context bar** — 20-block bar, green < 70%, red ≥ 70%
+- **5h / 7d bars** — rate-limit usage with reset times
+- **Directory** — current working directory in magenta
+
+## Cursor CLI
+
+For Cursor, see [`.cursor/statusline.md`](../.cursor/statusline.md).

package/.claude/templates/approval-packet.template.html

@@ -0,0 +1,171 @@
+<!--
+  Approval Packet template — filled by technical-architect (implement mode).
+  Copy to workspace/<task>/approval-packet.html and replace every <!--{{SLOT_*}}--> marker.
+  The EM publishes the result as an Artifact at the approval gate. Self-contained: no external assets.
+  Slots:
+    {{TASK_TITLE}}     plain task name (also used in <title>)
+    {{COMPLEXITY}}     low | medium | high
+    {{SLOT_BRIEF}}     business-brief.md as HTML (h3 sections + p / ul.keys)
+    {{SLOT_CHANGEMAP}} the <pre class="mermaid">…</pre> block from change-map.md + legend/notes
+    {{SLOT_PLAN}}      Files to Modify/Create as a table + Implementation Steps as ul.keys
+    {{SLOT_TESTS}}     Cases to Cover as ul.keys, or a "no test step" note
+-->
+<title><!--{{TASK_TITLE}}--> — Approval Packet</title>
+<style>
+  :root {
+    --bg: #eef1f5; --surface: #ffffff; --surface-2: #f6f8fb; --ink: #16202b; --ink-soft: #33404e;
+    --muted: #5c6b7a; --border: #dbe2ea; --accent: #0b8f94; --accent-ink: #ffffff;
+    --done-fg: #1a7d4b; --done-bg: #e0f2e6; --pending-fg: #a9640a; --pending-bg: #f7ebd6;
+    --defer-fg: #5a6b7c; --defer-bg: #e7edf3; --info-fg: #2f6fb0; --info-bg: #e2edf8;
+    --shadow: 0 1px 2px rgba(20,32,43,.06), 0 8px 24px rgba(20,32,43,.06);
+    --mono: ui-monospace, "SF Mono", "JetBrains Mono", Menlo, Consolas, monospace;
+    --sans: system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+  }
+  @media (prefers-color-scheme: dark) {
+    :root {
+      --bg: #0c1219; --surface: #141d28; --surface-2: #101823; --ink: #e7eef5; --ink-soft: #c2cedb;
+      --muted: #8394a4; --border: #223041; --accent: #2bd4d9; --accent-ink: #052226;
+      --done-fg: #48d38c; --done-bg: #123528; --pending-fg: #e6ab48; --pending-bg: #382a13;
+      --defer-fg: #93a3b4; --defer-bg: #1c2833; --info-fg: #6db0ec; --info-bg: #14293c;
+      --shadow: 0 1px 2px rgba(0,0,0,.3), 0 10px 30px rgba(0,0,0,.35);
+    }
+  }
+  :root[data-theme="light"] {
+    --bg: #eef1f5; --surface: #ffffff; --surface-2: #f6f8fb; --ink: #16202b; --ink-soft: #33404e;
+    --muted: #5c6b7a; --border: #dbe2ea; --accent: #0b8f94; --accent-ink: #ffffff;
+    --done-fg: #1a7d4b; --done-bg: #e0f2e6; --pending-fg: #a9640a; --pending-bg: #f7ebd6;
+    --defer-fg: #5a6b7c; --defer-bg: #e7edf3; --info-fg: #2f6fb0; --info-bg: #e2edf8;
+    --shadow: 0 1px 2px rgba(20,32,43,.06), 0 8px 24px rgba(20,32,43,.06);
+  }
+  :root[data-theme="dark"] {
+    --bg: #0c1219; --surface: #141d28; --surface-2: #101823; --ink: #e7eef5; --ink-soft: #c2cedb;
+    --muted: #8394a4; --border: #223041; --accent: #2bd4d9; --accent-ink: #052226;
+    --done-fg: #48d38c; --done-bg: #123528; --pending-fg: #e6ab48; --pending-bg: #382a13;
+    --defer-fg: #93a3b4; --defer-bg: #1c2833; --info-fg: #6db0ec; --info-bg: #14293c;
+    --shadow: 0 1px 2px rgba(0,0,0,.3), 0 10px 30px rgba(0,0,0,.35);
+  }
+  * { box-sizing: border-box; }
+  body { margin: 0; background: var(--bg); color: var(--ink); font-family: var(--sans); line-height: 1.55; -webkit-font-smoothing: antialiased; }
+  .wrap { max-width: 940px; margin: 0 auto; padding: 30px 20px 64px; }
+  header.masthead { display: flex; flex-direction: column; gap: 8px; }
+  .eyebrow { font-family: var(--mono); font-size: 11.5px; letter-spacing: .14em; text-transform: uppercase; color: var(--accent); font-weight: 600; }
+  h1 { font-size: clamp(21px, 3.2vw, 28px); line-height: 1.15; margin: 0; letter-spacing: -.02em; text-wrap: balance; }
+  .metaline { display: flex; flex-wrap: wrap; gap: 8px 10px; align-items: center; margin: 6px 0 0; }
+  .chip { font-family: var(--mono); font-size: 11.5px; font-weight: 600; letter-spacing: .02em; padding: 3px 9px; border-radius: 999px; border: 1px solid transparent; white-space: nowrap; }
+  .chip.done { color: var(--done-fg); background: var(--done-bg); }
+  .chip.pending { color: var(--pending-fg); background: var(--pending-bg); }
+  .chip.defer { color: var(--defer-fg); background: var(--defer-bg); }
+  .chip.info { color: var(--info-fg); background: var(--info-bg); }
+  .chip.file { color: var(--muted); background: var(--surface-2); border-color: var(--border); }
+
+  .tabbar { display: flex; gap: 4px; border-bottom: 1px solid var(--border); margin: 22px 0; overflow-x: auto; scrollbar-width: thin; position: sticky; top: 0; background: var(--bg); z-index: 5; padding-top: 4px; }
+  .tab { appearance: none; border: 0; background: transparent; color: var(--muted); cursor: pointer; font-family: var(--sans); font-size: 13.5px; font-weight: 550; padding: 11px 15px 13px; white-space: nowrap; border-bottom: 2px solid transparent; margin-bottom: -1px; border-radius: 8px 8px 0 0; transition: color .15s, background .15s; }
+  .tab:hover { color: var(--ink-soft); background: var(--surface-2); }
+  .tab[aria-selected="true"] { color: var(--accent); border-bottom-color: var(--accent); }
+  .tab:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+
+  .panel { display: none; animation: fade .22s ease; }
+  .panel.active { display: block; }
+  @keyframes fade { from { opacity: 0; transform: translateY(4px); } to { opacity: 1; transform: none; } }
+  @media (prefers-reduced-motion: reduce) { .panel { animation: none; } }
+
+  .card { background: var(--surface); border: 1px solid var(--border); border-radius: 14px; padding: 22px 24px; box-shadow: var(--shadow); }
+  .card h2 { margin: 0 0 6px; font-size: 18px; letter-spacing: -.015em; text-wrap: balance; }
+  .card h3 { margin: 20px 0 8px; font-size: 13px; text-transform: uppercase; letter-spacing: .06em; color: var(--muted); }
+  .card h3:first-child, .card h2:first-child { margin-top: 0; }
+  .card p { margin: 10px 0; color: var(--ink-soft); font-size: 14.5px; }
+  .card p.lede { color: var(--ink); font-size: 15.5px; }
+  code { font-family: var(--mono); font-size: .88em; background: var(--surface-2); border: 1px solid var(--border); padding: 1px 5px; border-radius: 5px; color: var(--ink); }
+
+  ul.keys { margin: 8px 0; padding: 0; list-style: none; display: flex; flex-direction: column; gap: 8px; }
+  ul.keys li { position: relative; padding-left: 20px; font-size: 14.5px; color: var(--ink-soft); }
+  ul.keys li::before { content: ""; position: absolute; left: 3px; top: 9px; width: 6px; height: 6px; border-radius: 2px; background: var(--accent); }
+
+  .tablewrap { overflow-x: auto; margin: 10px 0; border: 1px solid var(--border); border-radius: 10px; }
+  table { border-collapse: collapse; width: 100%; font-size: 13.5px; min-width: 440px; }
+  th, td { text-align: left; padding: 9px 12px; border-bottom: 1px solid var(--border); vertical-align: top; }
+  th { background: var(--surface-2); font-size: 11.5px; text-transform: uppercase; letter-spacing: .05em; color: var(--muted); font-weight: 600; }
+  tr:last-child td { border-bottom: 0; }
+  td code { background: transparent; border: 0; padding: 0; color: var(--accent); }
+
+  .diagram { background: var(--surface-2); border: 1px solid var(--border); border-radius: 12px; padding: 14px; margin: 12px 0; overflow-x: auto; }
+  .diagram pre.mermaid { margin: 0; text-align: center; }
+  .legend { display: flex; flex-wrap: wrap; gap: 6px 14px; margin: 8px 2px 0; font-size: 12px; color: var(--muted); font-family: var(--mono); }
+
+  footer { margin-top: 26px; padding-top: 14px; border-top: 1px solid var(--border); color: var(--muted); font-size: 12.5px; }
+  @media (max-width: 620px) { .card { padding: 18px 16px; } }
+</style>
+
+<div class="wrap">
+  <header class="masthead">
+    <span class="eyebrow">Approval Packet</span>
+    <h1><!--{{TASK_TITLE}}--></h1>
+    <div class="metaline">
+      <span class="chip pending">AWAITING APPROVAL</span>
+      <span class="chip defer">Complexity: <!--{{COMPLEXITY}}--></span>
+    </div>
+  </header>
+
+  <div class="tabbar" role="tablist" aria-label="Approval packet">
+    <button class="tab" role="tab" aria-selected="true" aria-controls="p-brief" id="t-brief">Brief</button>
+    <button class="tab" role="tab" aria-selected="false" aria-controls="p-map" id="t-map" tabindex="-1">Change Map</button>
+    <button class="tab" role="tab" aria-selected="false" aria-controls="p-plan" id="t-plan" tabindex="-1">Plan</button>
+    <button class="tab" role="tab" aria-selected="false" aria-controls="p-tests" id="t-tests" tabindex="-1">Tests</button>
+  </div>
+
+  <section class="panel active" role="tabpanel" id="p-brief" aria-labelledby="t-brief">
+    <div class="card">
+      <!--{{SLOT_BRIEF}}-->
+    </div>
+  </section>
+
+  <section class="panel" role="tabpanel" id="p-map" aria-labelledby="t-map" hidden>
+    <div class="card">
+      <h2>Change Map — before → after</h2>
+      <!--{{SLOT_CHANGEMAP}}-->
+    </div>
+  </section>
+
+  <section class="panel" role="tabpanel" id="p-plan" aria-labelledby="t-plan" hidden>
+    <div class="card">
+      <h2>Plan at a glance</h2>
+      <!--{{SLOT_PLAN}}-->
+    </div>
+  </section>
+
+  <section class="panel" role="tabpanel" id="p-tests" aria-labelledby="t-tests" hidden>
+    <div class="card">
+      <h2>Test plan</h2>
+      <!--{{SLOT_TESTS}}-->
+    </div>
+  </section>
+
+  <footer>Approve or request changes in chat. This packet is a private snapshot of the task folder.</footer>
+</div>
+
+<script>
+  (function () {
+    var tabs = Array.prototype.slice.call(document.querySelectorAll('.tab'));
+    var panels = Array.prototype.slice.call(document.querySelectorAll('.panel'));
+    function select(i) {
+      tabs.forEach(function (t, j) {
+        var on = i === j;
+        t.setAttribute('aria-selected', on ? 'true' : 'false');
+        t.tabIndex = on ? 0 : -1;
+        panels[j].classList.toggle('active', on);
+        if (on) { panels[j].removeAttribute('hidden'); } else { panels[j].setAttribute('hidden', ''); }
+      });
+    }
+    tabs.forEach(function (t, i) {
+      t.addEventListener('click', function () { select(i); });
+      t.addEventListener('keydown', function (e) {
+        var n = null;
+        if (e.key === 'ArrowRight') n = (i + 1) % tabs.length;
+        else if (e.key === 'ArrowLeft') n = (i - 1 + tabs.length) % tabs.length;
+        else if (e.key === 'Home') n = 0;
+        else if (e.key === 'End') n = tabs.length - 1;
+        if (n !== null) { e.preventDefault(); select(n); tabs[n].focus(); }
+      });
+    });
+  })();
+</script>

package/.claude/templates/reference-workspaces.md

@@ -0,0 +1,16 @@
+# Reference Workspaces (allowlist)
+
+External codebases agents may consult, **read-only**. Investigator and technical-architect may ONLY read paths listed here — anything not listed is out of bounds.
+
+**Priority = list order.** Agents consult top-first and stop early once the question is answered.
+
+| Name                                                | Path       | Notes                      |
+| --------------------------------------------------- | ---------- | -------------------------- |
+| `/Volumes/ExternalSSD/code/references/matterbridge` | TypeScript | Matterbridge SDK reference |
+
+## Rules
+
+- Read-only — never modify, format, or stage files in these paths.
+- CodeGraph does NOT work here (it indexes this repo only) — use Grep/Glob/Read.
+- Cite findings as `<workspace-name>/path/to/file:line` in answers.
+- To add a workspace: append a row here (with a one-line note on what it is good for) — no other change needed.

package/.claude/tools/cli-runner-server.cjs

@@ -0,0 +1,220 @@
+'use strict';
+
+// MCP stdio server — runs this project's compiled CLI (dist/cli.js) and
+// captures its output for investigation. Node built-ins only; no npm deps.
+
+const { execFileSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const CLI_PATH = path.resolve(__dirname, '..', '..', 'dist', 'cli.js');
+
+const TIMEOUT_MS = 30000;
+
+// Commands allowed through this tool. `login` is intentionally excluded —
+// the user handles authentication manually via `npm run cli -- --command login`.
+const ALLOWED_COMMANDS = [
+  'devices',
+  'status',
+  'start',
+  'stop',
+  'pause',
+  'resume',
+  'ping',
+  'clean-mode',
+  'room-info',
+  'map-info',
+  'legacy-map-info',
+  'legacy-map-info-v2',
+  'b01-pose-info',
+  'scenes',
+  'network-info',
+  'custom',
+];
+
+// ---------------------------------------------------------------------------
+// Transport helpers
+// ---------------------------------------------------------------------------
+
+function send(obj) {
+  process.stdout.write(JSON.stringify(obj) + '\n');
+}
+
+function sendResult(id, content) {
+  send({
+    jsonrpc: '2.0',
+    id,
+    result: {
+      content: [{ type: 'text', text: content }],
+    },
+  });
+}
+
+function sendError(id, code, message) {
+  send({
+    jsonrpc: '2.0',
+    id,
+    error: { code, message },
+  });
+}
+
+// ---------------------------------------------------------------------------
+// RunCli tool implementation
+// ---------------------------------------------------------------------------
+
+function runCli({ command, duid, local, debug, detail, method, params, send: sendFlag }) {
+  if (!command) {
+    return 'Error: "command" is required.';
+  }
+
+  if (command === 'login') {
+    return 'Error: the "login" command is not available through this tool. Run it manually yourself: npm run cli -- --command login';
+  }
+
+  if (!ALLOWED_COMMANDS.includes(command)) {
+    return `Error: unknown or disallowed command "${command}". Allowed commands: ${ALLOWED_COMMANDS.join(', ')}`;
+  }
+
+  if (!fs.existsSync(CLI_PATH)) {
+    return `Error: compiled CLI not found at ${CLI_PATH}. Build the project first: npm run build`;
+  }
+
+  const args = ['--command', command];
+  if (duid) args.push('--duid', String(duid));
+  if (local) args.push('--local', 'true');
+  if (debug) args.push('--debug', 'true');
+  if (detail) args.push('--detail', 'true');
+  if (method) args.push('--method', String(method));
+  if (params) args.push('--params', String(params));
+  if (sendFlag) args.push('--send', 'true');
+
+  let stdout = '';
+  let stderr = '';
+  let timedOut = false;
+  let exitCode = 0;
+
+  try {
+    stdout = execFileSync(process.execPath, [CLI_PATH, ...args], {
+      encoding: 'utf8',
+      timeout: TIMEOUT_MS,
+      killSignal: 'SIGKILL',
+      stdio: ['ignore', 'pipe', 'pipe'],
+    });
+  } catch (err) {
+    stdout = err.stdout ? err.stdout.toString() : '';
+    stderr = err.stderr ? err.stderr.toString() : '';
+    timedOut = err.signal === 'SIGKILL' || err.signal === 'SIGTERM' || err.killed === true;
+    exitCode = typeof err.status === 'number' ? err.status : 1;
+  }
+
+  const parts = [];
+  if (stdout.trim().length > 0) parts.push(`--- stdout ---\n${stdout.trim()}`);
+  if (stderr.trim().length > 0) parts.push(`--- stderr ---\n${stderr.trim()}`);
+  if (parts.length === 0) parts.push('(no output)');
+  if (timedOut) parts.push(`--- note ---\nProcess timed out after ${TIMEOUT_MS}ms and was killed. Output above is what was captured before the timeout.`);
+  else if (exitCode !== 0) parts.push(`--- note ---\nProcess exited with non-zero exit code: ${exitCode}`);
+
+  return parts.join('\n\n');
+}
+
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+
+const TOOL_DEFINITIONS = [
+  {
+    name: 'RunCli',
+    description:
+      "Run this project's compiled CLI (dist/cli.js) and capture stdout/stderr for investigation. Does not support the 'login' command — handle authentication manually first.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        command: {
+          type: 'string',
+          enum: ALLOWED_COMMANDS,
+          description: 'CLI command to run (login is not supported here — run it manually)',
+        },
+        duid: { type: 'string', description: 'Device UID (required by most device commands)' },
+        local: { type: 'boolean', description: 'Send via local network (TCP) instead of MQTT' },
+        debug: { type: 'boolean', description: 'Enable debug logging' },
+        detail: { type: 'boolean', description: 'Show extra detail (only meaningful for "scenes")' },
+        method: { type: 'string', description: 'MQTT method name (required by "custom")' },
+        params: { type: 'string', description: 'JSON string of params (used by "custom")' },
+        send: { type: 'boolean', description: 'Fire-and-forget send (used by "custom")' },
+      },
+      required: ['command'],
+    },
+  },
+];
+
+// ---------------------------------------------------------------------------
+// Request dispatcher
+// ---------------------------------------------------------------------------
+
+function handleRequest(req) {
+  const { id, method, params } = req;
+
+  // Notifications (no id) — no response
+  if (id === undefined || id === null) {
+    return;
+  }
+
+  if (method === 'initialize') {
+    send({
+      jsonrpc: '2.0',
+      id,
+      result: {
+        protocolVersion: '2024-11-05',
+        serverInfo: { name: 'cli-runner-server', version: '1.0.0' },
+        capabilities: { tools: {} },
+      },
+    });
+    return;
+  }
+
+  if (method === 'tools/list') {
+    send({
+      jsonrpc: '2.0',
+      id,
+      result: { tools: TOOL_DEFINITIONS },
+    });
+    return;
+  }
+
+  if (method === 'tools/call') {
+    const { name, arguments: args } = params || {};
+    try {
+      let text;
+      if (name === 'RunCli') {
+        text = runCli(args || {});
+      } else {
+        sendError(id, -32601, `Unknown tool: ${name}`);
+        return;
+      }
+      sendResult(id, text);
+    } catch (err) {
+      sendResult(id, `Error: ${err.message}`);
+    }
+    return;
+  }
+
+  sendError(id, -32601, `Method not found: ${method}`);
+}
+
+// ---------------------------------------------------------------------------
+// Main — read newline-delimited JSON from stdin
+// ---------------------------------------------------------------------------
+
+const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
+
+rl.on('line', (line) => {
+  const trimmed = line.trim();
+  if (!trimmed) return;
+  try {
+    const req = JSON.parse(trimmed);
+    handleRequest(req);
+  } catch (_) {
+    // Malformed JSON — ignore
+  }
+});