@mrciphersmith/keryx 0.2.50 → 0.2.52

package/dist/cli.js

@@ -17055,7 +17055,7 @@ function renderWrapUpMemoryEntry(input2) {
 
 Version: 0.1.0
 Type: task-note
-Status: draft
+Status: accepted
 Confidence: medium
 
 ## Summary
@@ -17155,7 +17155,7 @@ function renderWrapUpDecisionPage(input2) {
 
 Version: 0.1.0
 Type: decision
-Status: draft
+Status: accepted
 
 ## Summary
 
@@ -33709,6 +33709,21 @@ function renderMcpClientSnippet(projectRoot) {
   return `${JSON.stringify({ mcpServers: { [MCP_SERVER_NAME]: mcpServerEntry(projectRoot) } }, null, 2)}
 `;
 }
+async function mcpClientStatus(projectRoot, ids = mcpRuntimeIds()) {
+  const absoluteProjectRoot = path40.resolve(projectRoot);
+  const { runtimes } = resolveMcpRuntimes(ids);
+  const statuses = [];
+  for (const runtime of runtimes) {
+    const file = runtime.settingsPath(absoluteProjectRoot);
+    if (file === null) {
+      statuses.push({ id: runtime.id, filePath: null, connected: false });
+      continue;
+    }
+    const settings = await readSettings2(file);
+    statuses.push({ id: runtime.id, filePath: file, connected: runtime.hasManaged(settings) });
+  }
+  return statuses;
+}
 async function readSettings2(file) {
   if (!await pathExists(file)) {
     return {};
@@ -33752,7 +33767,7 @@ function buildMcpModuleEntry() {
     expose: {
       tools: true,
       resources: true,
-      modules: ["gdgraph", "gdctx", "security", "flow", "memory", "health", "testing", "wiki", "standard", "sac"]
+      modules: ["gdgraph", "gdctx", "security", "flow", "memory", "health", "testing", "wiki", "standard", "sac", "gdskills"]
     }
   };
 }
@@ -47120,6 +47135,8 @@ init_workspace_service();
 var HARNESS_PROVIDER_OPTIONS = [
   "fake",
   "anthropic",
+  "openai",
+  "gemini",
   "ollama",
   ...OPENAI_COMPAT_PROVIDERS.map((provider) => provider.name)
 ];
@@ -47285,6 +47302,20 @@ async function harnessCommand(args2, deps) {
       return;
     }
   }
+  if (provider === "openai") {
+    const apiKey = env.OPENAI_API_KEY;
+    if (apiKey === undefined || apiKey.length === 0) {
+      console.log("OPENAI_API_KEY is not set: the openai provider is required to have a credential and fails closed (no network was contacted).");
+      return;
+    }
+  }
+  if (provider === "gemini") {
+    const apiKey = env.GEMINI_API_KEY !== undefined && env.GEMINI_API_KEY.length > 0 ? env.GEMINI_API_KEY : env.GOOGLE_API_KEY;
+    if (apiKey === undefined || apiKey.length === 0) {
+      console.log("GEMINI_API_KEY (or GOOGLE_API_KEY) is not set: the gemini provider is required to have a credential and fails closed (no network was contacted).");
+      return;
+    }
+  }
   const providerPort = makeProvider(provider, model, {
     fetch: fetchImpl,
     env,
@@ -52920,7 +52951,7 @@ import { spawnSync as spawnSync2 } from "child_process";
 // package.json
 var package_default = {
   name: "@mrciphersmith/keryx",
-  version: "0.2.50",
+  version: "0.2.52",
   description: "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   private: false,
   publishConfig: {
@@ -53808,16 +53839,15 @@ var MODAL_PANEL_MARGIN = 1;
 var MODAL_PANEL_CHROME_X = 4;
 var MODAL_PANEL_MIN_WIDTH = 72;
 var MODAL_PANEL_MIN_HEIGHT = 18;
-var MODAL_PANEL_TARGET_WIDTH = 96;
-var MODAL_PANEL_TARGET_HEIGHT = 28;
+var MODAL_PANEL_SIZE_RATIO = 0.95;
 var MODAL_CHROME_ROWS = 5;
 var MODAL_PANEL_WIDTH = MODAL_PANEL_MIN_WIDTH;
 var MODAL_PANEL_HEIGHT = MODAL_PANEL_MIN_HEIGHT;
 var MODAL_PANEL_INNER_WIDTH = MODAL_PANEL_MIN_WIDTH - MODAL_PANEL_CHROME_X;
 function resolveModalPanelSize(cols, rows) {
   return {
-    width: Math.min(MODAL_PANEL_TARGET_WIDTH, Math.max(MODAL_PANEL_MIN_WIDTH, cols - 4)),
-    height: Math.min(MODAL_PANEL_TARGET_HEIGHT, Math.max(MODAL_PANEL_MIN_HEIGHT, rows - 4))
+    width: Math.max(MODAL_PANEL_MIN_WIDTH, Math.round(cols * MODAL_PANEL_SIZE_RATIO)),
+    height: Math.max(MODAL_PANEL_MIN_HEIGHT, Math.round(rows * MODAL_PANEL_SIZE_RATIO))
   };
 }
 function modalBodyRows(panelHeight) {
@@ -54231,6 +54261,7 @@ async function computeLifecycleFlags(cwd, now = () => new Date) {
 }
 
 // src/sac/catch-up.ts
+init_proposal_evidence();
 async function buildCatchUp(input2) {
   const [proposals, sessionCategories, lifecycleFlagsAll] = await Promise.all([
     collectProposals(input2.cwd, input2.workspaceId),
@@ -54250,8 +54281,20 @@ async function collectProposals(cwd, workspaceId) {
   const scoped = workspaceId === undefined ? groups : groups.filter((group) => group.workspace.id === workspaceId);
   const flattened = scoped.flatMap((group) => group.proposals.map((proposal) => ({ group, proposal })));
   return Promise.all(flattened.map(async ({ group, proposal }) => {
-    const fresh = await proposalService.isEvidenceFresh(proposal, actor);
-    return { type: "proposal", workspaceId: group.workspace.id, proposalId: proposal.id, fresh };
+    const [fresh, note2] = await Promise.all([
+      proposalService.isEvidenceFresh(proposal, actor),
+      readSidecarNote(cwd, group.workspace.id, proposal.id)
+    ]);
+    return {
+      type: "proposal",
+      workspaceId: group.workspace.id,
+      proposalId: proposal.id,
+      fresh,
+      kind: proposal.kind,
+      author: proposal.author,
+      createdAt: proposal.createdAt,
+      note: note2
+    };
   }));
 }
 async function classifySession(session) {
@@ -54822,7 +54865,7 @@ function openFlows(otui, chrome, options) {
 
 // src/tui/busy-dispatch.ts
 function classifyBusyDispatch(params) {
-  const { line, commandName, isSessionInfo, isFlows, isWorkspace, isReview } = params;
+  const { line, commandName, isSessionInfo, isFlows, isWorkspace, isReview, isMcp } = params;
   if (commandName === "/exit")
     return "exit";
   if (commandName === "/help")
@@ -54841,7 +54884,7 @@ function classifyBusyDispatch(params) {
     return "copy";
   if (commandName === "/mode")
     return "mode";
-  const isBusyReadonlyCommand = isSessionInfo || isFlows || isWorkspace || isReview;
+  const isBusyReadonlyCommand = isSessionInfo || isFlows || isWorkspace || isReview || isMcp;
   if (isBusyReadonlyCommand && isSessionInfo)
     return "session-info";
   if (isBusyReadonlyCommand && isFlows)
@@ -54850,6 +54893,8 @@ function classifyBusyDispatch(params) {
     return "workspace";
   if (isBusyReadonlyCommand && isReview)
     return "review";
+  if (isBusyReadonlyCommand && isMcp)
+    return "mcp";
   if (commandName !== undefined || line.startsWith("/"))
     return "deferred";
   return "not-a-command";
@@ -55109,7 +55154,8 @@ function openWorkspace(otui, chrome, options) {
 var REVIEW_COMMAND = "/review";
 var REVIEW_FOOTER = [
   { key: "[/]", label: "item" },
-  { key: "a y", label: "accept" },
+  { key: "a y", label: "accept proposal" },
+  { key: "d y", label: "decline proposal" },
   { key: "\u2191/\u2193", label: "scroll" },
   { key: "\u2190/\u2192", label: "tabs" },
   { key: "esc", label: "close" }
@@ -55127,7 +55173,7 @@ var TYPE_LABEL = {
 function summarizeReviewItem(item) {
   switch (item.type) {
     case "proposal":
-      return `${item.proposalId} in ${item.workspaceId}${item.fresh ? "" : " (stale)"}`;
+      return `${item.kind} ${item.proposalId} in ${item.workspaceId}${item.fresh ? "" : " (stale)"}`;
     case "blocked":
       return `${item.sessionId} \u2014 ${item.terminalState.reason}`;
     case "unbound-candidate":
@@ -55151,9 +55197,13 @@ function describeReviewItem(item) {
       return [
         `Proposal   ${item.proposalId}`,
         `Workspace  ${item.workspaceId}`,
+        `Kind       ${item.kind}`,
+        `Author     ${item.author}`,
+        `Created    ${item.createdAt}`,
         `Evidence   ${item.fresh ? "fresh" : "stale \u2014 evidence has drifted since this proposal was created; re-run wrap-up before deciding"}`,
+        ...item.note !== undefined ? ["", `Note       ${item.note}`] : [],
         "",
-        `Reject/dismiss from a terminal: keryx workspace review ${item.workspaceId} ${item.proposalId} --decision <rejected|dismissed>`
+        `Dismiss (archive with no decision) from a terminal: keryx workspace review ${item.workspaceId} ${item.proposalId} --decision dismissed`
       ];
     case "blocked":
       return [
@@ -55206,25 +55256,37 @@ function describeGroupOutcome(g) {
     }
   }
 }
+var DECISION_VERB = { accept: "Accept", decline: "Decline" };
+var DECISION_ING = { accept: "Accepting", decline: "Declining" };
+var DECISION_DONE = { accept: "Accepted", decline: "Declined" };
+var DECISION_COMMAND = {
+  accept: "running `keryx workspace confirm-review` then `keryx workspace review`",
+  decline: "running `keryx workspace review --decision rejected`"
+};
 function formatReviewDetailLines(item, status) {
   if (item === undefined) {
     return ["No item selected.", "", "Press Enter (or click a row) on the Review tab to view one."];
   }
   const lines = describeReviewItem(item);
   if (item.type !== "proposal") {
+    if (status.kind === "unavailable") {
+      return [...lines, "", `[${status.decision === "accept" ? "a" : "d"}] does nothing here \u2014 accept/decline only apply to a pending proposal, not to this item.`];
+    }
     return lines;
   }
   const withAction = [...lines, ""];
   if (status.kind === "armed") {
-    withAction.push("Press [y] to CONFIRM accept, any other key cancels.");
+    withAction.push(`Press [y] to CONFIRM ${status.decision}, any other key cancels.`);
   } else if (status.kind === "running") {
-    withAction.push("Accepting\u2026 running `keryx workspace confirm-review` then `keryx workspace review`.");
+    withAction.push(`${DECISION_ING[status.decision]}\u2026 ${DECISION_COMMAND[status.decision]}.`);
   } else if (status.kind === "done" && status.outcome.ok) {
-    withAction.push("\u2713 Accepted.");
+    withAction.push(`\u2713 ${DECISION_DONE[status.decision]}.`);
   } else if (status.kind === "done" && !status.outcome.ok) {
-    withAction.push(`\u2717 Accept failed: ${status.outcome.message}`);
+    withAction.push(`\u2717 ${DECISION_VERB[status.decision]} failed: ${status.outcome.message}`);
+  } else if (status.kind === "unavailable") {
+    withAction.push(`[${status.decision === "accept" ? "a" : "d"}] does nothing \u2014 no ${status.decision} handler is configured for this modal.`);
   } else {
-    withAction.push("[a] Accept this proposal");
+    withAction.push("[a] Accept this proposal   [d] Decline this proposal");
   }
   return withAction;
 }
@@ -55321,17 +55383,19 @@ function presentReview(openModal2, otui, chrome, options) {
     status = { kind: "idle" };
     paintSelection();
   };
-  const runAccept = () => {
+  const handlerFor = (decision) => decision === "accept" ? options.acceptProposal : options.declineProposal;
+  const runDecision = (decision) => {
     const item = items[selected];
-    if (item === undefined || item.type !== "proposal" || options.acceptProposal === undefined) {
+    const run = handlerFor(decision);
+    if (item === undefined || item.type !== "proposal" || run === undefined) {
       return;
     }
-    status = { kind: "running" };
+    status = { kind: "running", decision };
     paintSelection();
-    options.acceptProposal(item).then((outcome) => {
-      status = { kind: "done", outcome };
+    run(item).then((outcome) => {
+      status = { kind: "done", decision, outcome };
       if (outcome.ok) {
-        options.onAccepted?.(item);
+        options.onResolved?.(item);
       }
       paintSelection();
     });
@@ -55371,7 +55435,7 @@ function presentReview(openModal2, otui, chrome, options) {
       const onDetail = handle.activeTab() === "detail";
       if (onDetail && status.kind === "armed") {
         if (token === "y") {
-          runAccept();
+          runDecision(status.decision);
         } else {
           status = { kind: "idle" };
           paintSelection();
@@ -55390,8 +55454,9 @@ function presentReview(openModal2, otui, chrome, options) {
         handle.setTab("detail");
         return;
       }
-      if (onDetail && token === "a" && items[selected]?.type === "proposal" && options.acceptProposal !== undefined && status.kind !== "running") {
-        status = { kind: "armed" };
+      if (onDetail && (token === "a" || token === "d") && status.kind !== "running") {
+        const decision = token === "a" ? "accept" : "decline";
+        status = items[selected]?.type === "proposal" && handlerFor(decision) !== undefined ? { kind: "armed", decision } : { kind: "unavailable", decision };
         paintSelection();
         return;
       }
@@ -55455,6 +55520,285 @@ async function acceptProposalViaShell(run, workspaceId, proposalId) {
   }
   return { ok: true };
 }
+async function declineProposalViaShell(run, workspaceId, proposalId) {
+  const decline = await run(`keryx workspace review ${shQuote(workspaceId)} ${shQuote(proposalId)} --decision rejected`);
+  if (decline.isError) {
+    return { ok: false, message: decline.output };
+  }
+  return { ok: true };
+}
+
+// src/tui/mcp-inspector.ts
+var MCP_INSPECTOR_FOOTER = [
+  { key: "\u2191/\u2193", label: "select" },
+  { key: "click", label: "row: select/act" },
+  { key: "c/d", label: "connect/disconnect" },
+  { key: "y", label: "confirm" },
+  { key: "\u2190/\u2192", label: "tabs" },
+  { key: "esc", label: "close" }
+];
+var MCP_TOOLS_COMMAND = "/mcp";
+function isMcpToolsCommand(line) {
+  const token = line.trim().split(/\s+/)[0] ?? "";
+  return token === MCP_TOOLS_COMMAND;
+}
+var RUNTIME_LABELS = {
+  cursor: "Cursor",
+  claude: "Claude Code",
+  opencode: "opencode",
+  vscode: "VS Code",
+  generic: "Generic (manual)"
+};
+function runtimeLabel(id) {
+  return RUNTIME_LABELS[id] ?? id;
+}
+function formatToolRowLine(tool) {
+  const risk = (tool.risk ?? "read").padEnd(6);
+  const name = tool.name.padEnd(28);
+  return `${name} ${risk} ${tool.description ?? ""}`.trimEnd();
+}
+function isActionable(id) {
+  return id !== "generic";
+}
+function formatMcpRowLine(runtime, isSelected, status) {
+  const mark = isSelected ? ">" : " ";
+  const label = runtimeLabel(runtime.id).padEnd(20);
+  const statusText = runtime.connected ? "\u25CF connected" : "\u25CB not connected";
+  let action = "";
+  if (!isActionable(runtime.id)) {
+    action = "  (copy snippet manually)";
+  } else if (status.kind === "armed" && status.target.id === runtime.id) {
+    action = `  [click again or press y to ${status.target.action}]`;
+  } else if (status.kind === "running" && status.target.id === runtime.id) {
+    action = `  ${status.target.action === "connect" ? "connecting\u2026" : "disconnecting\u2026"}`;
+  } else if (status.kind === "done" && status.target.id === runtime.id) {
+    action = status.outcome.ok ? "  \u2713 done" : `  \u2717 ${status.outcome.message}`;
+  } else {
+    action = runtime.connected ? "  [d] disconnect" : "  [c] connect";
+  }
+  return `${mark} ${label} ${statusText}${action}`;
+}
+function asRowTarget(body) {
+  const parent = body;
+  if (parent.add === undefined || parent.getChildren === undefined || parent.remove === undefined) {
+    return;
+  }
+  return {
+    add: parent.add.bind(parent),
+    getChildren: parent.getChildren.bind(parent),
+    remove: parent.remove.bind(parent)
+  };
+}
+function presentMcpTools(openModal2, otui, chrome, options) {
+  const runtimes = options.runtimes.map((r) => ({ ...r }));
+  let mcpSelected = 0;
+  let toolsScroll = 0;
+  let mcpScroll = 0;
+  let status = { kind: "idle" };
+  let toolsBody;
+  let mcpBody;
+  let rowCtor;
+  let activeRenderer;
+  let unsubscribeKey;
+  const rendererHint = options.renderer ?? chrome?.renderer;
+  const bodyRows = options.visibleRows ?? (typeof rendererHint?.width === "number" && typeof rendererHint.height === "number" ? modalBodyRows(resolveModalPanelSize(rendererHint.width, rendererHint.height).height) : 13);
+  const paintToolsRows = () => {
+    if (toolsBody === undefined || rowCtor === undefined) {
+      return;
+    }
+    clearTranscriptChildren(toolsBody);
+    if (options.tools.length === 0) {
+      toolsBody.add(new rowCtor(activeRenderer, { id: "mcp-tools-empty", content: "No tools available." }));
+      return;
+    }
+    const start = clampScroll3(toolsScroll, options.tools.length, bodyRows);
+    for (const [i, tool] of options.tools.slice(start, start + bodyRows).entries()) {
+      toolsBody.add(new rowCtor(activeRenderer, { id: `mcp-tool-row-${start + i}`, content: formatToolRowLine(tool) }));
+    }
+  };
+  const paintMcpRows = () => {
+    if (mcpBody === undefined || rowCtor === undefined) {
+      return;
+    }
+    clearTranscriptChildren(mcpBody);
+    if (runtimes.length === 0) {
+      mcpBody.add(new rowCtor(activeRenderer, { id: "mcp-mcp-empty", content: "No MCP client runtimes registered." }));
+      return;
+    }
+    const start = clampScroll3(mcpScroll, runtimes.length, bodyRows);
+    for (const [i, runtime] of runtimes.slice(start, start + bodyRows).entries()) {
+      const index = start + i;
+      mcpBody.add(new rowCtor(activeRenderer, {
+        id: `mcp-row-${runtime.id}`,
+        content: formatMcpRowLine(runtime, index === mcpSelected, status),
+        onMouseDown: () => handleRowClick(runtime.id, index)
+      }));
+    }
+  };
+  const paint = () => {
+    toolsScroll = clampScroll3(toolsScroll, options.tools.length, bodyRows);
+    mcpScroll = scrollToReveal3(mcpSelected, mcpScroll, bodyRows);
+    mcpScroll = clampScroll3(mcpScroll, runtimes.length, bodyRows);
+    paintToolsRows();
+    paintMcpRows();
+  };
+  const moveMcpSelection = (next) => {
+    if (runtimes.length === 0) {
+      return;
+    }
+    const clamped = Math.min(runtimes.length - 1, Math.max(0, next));
+    if (clamped === mcpSelected) {
+      return;
+    }
+    mcpSelected = clamped;
+    status = { kind: "idle" };
+    paint();
+  };
+  const runAction = () => {
+    if (status.kind !== "armed") {
+      return;
+    }
+    const target = status.target;
+    status = { kind: "running", target };
+    paint();
+    const fn = target.action === "connect" ? options.connect : options.disconnect;
+    fn(target.id).then((outcome) => {
+      status = { kind: "done", target, outcome };
+      if (outcome.ok) {
+        const row = runtimes.find((r) => r.id === target.id);
+        if (row !== undefined) {
+          row.connected = target.action === "connect";
+        }
+      }
+      options.onStatusChange?.(runtimes);
+      paint();
+    });
+  };
+  const armFor = (id) => {
+    const index = runtimes.findIndex((r) => r.id === id);
+    const row = runtimes[index];
+    if (index < 0 || row === undefined || !isActionable(row.id) || status.kind === "running") {
+      return;
+    }
+    mcpSelected = index;
+    status = { kind: "armed", target: { id: row.id, action: row.connected ? "disconnect" : "connect" } };
+    paint();
+  };
+  const handleRowClick = (id, index) => {
+    if (status.kind === "armed" && status.target.id === id) {
+      runAction();
+      return;
+    }
+    if (status.kind === "running") {
+      return;
+    }
+    if (!isActionable(id)) {
+      if (index !== mcpSelected) {
+        mcpSelected = index;
+        status = { kind: "idle" };
+        paint();
+      }
+      return;
+    }
+    armFor(id);
+  };
+  const handle = openModal2(otui, chrome, {
+    title: "Tools & MCP",
+    tabs: [
+      { id: "tools", label: "Tools" },
+      { id: "mcp", label: "MCP" }
+    ],
+    initialTab: "tools",
+    footer: MCP_INSPECTOR_FOOTER,
+    renderTab: (tabId, body, ctx) => {
+      const renderer = options.renderer ?? chrome?.renderer;
+      const ctor = otui.TextRenderable;
+      const target = asRowTarget(body);
+      if (target === undefined || ctor === undefined) {
+        return;
+      }
+      rowCtor = ctor;
+      activeRenderer = renderer;
+      if (tabId === "tools") {
+        toolsBody = target;
+        toolsScroll = clampScroll3(toolsScroll, options.tools.length, bodyRows);
+        paintToolsRows();
+        return;
+      }
+      mcpBody = target;
+      mcpScroll = scrollToReveal3(mcpSelected, mcpScroll, bodyRows);
+      paintMcpRows();
+    },
+    onClose: () => {
+      unsubscribeKey?.();
+    }
+  });
+  if (handle === undefined) {
+    return;
+  }
+  if (options.onKeypress !== undefined) {
+    unsubscribeKey = options.onKeypress((key) => {
+      const token = key.name || key.sequence;
+      const onMcp = handle.activeTab() === "mcp";
+      if (onMcp && status.kind === "armed") {
+        if (token === "y") {
+          runAction();
+        } else {
+          status = { kind: "idle" };
+          paint();
+        }
+        return;
+      }
+      if (onMcp && token === "c") {
+        const row = runtimes[mcpSelected];
+        if (row !== undefined && isActionable(row.id) && !row.connected && status.kind !== "running") {
+          status = { kind: "armed", target: { id: row.id, action: "connect" } };
+          paint();
+        }
+        return;
+      }
+      if (onMcp && token === "d") {
+        const row = runtimes[mcpSelected];
+        if (row !== undefined && isActionable(row.id) && row.connected && status.kind !== "running") {
+          status = { kind: "armed", target: { id: row.id, action: "disconnect" } };
+          paint();
+        }
+        return;
+      }
+      if (token === "up" || token === "k") {
+        if (onMcp) {
+          moveMcpSelection(mcpSelected - 1);
+        } else {
+          toolsScroll = clampScroll3(toolsScroll - 1, options.tools.length, bodyRows);
+          paint();
+        }
+        return;
+      }
+      if (token === "down" || token === "j") {
+        if (onMcp) {
+          moveMcpSelection(mcpSelected + 1);
+        } else {
+          toolsScroll = clampScroll3(toolsScroll + 1, options.tools.length, bodyRows);
+          paint();
+        }
+        return;
+      }
+      if (token === "pageup" || token === "pagedown") {
+        const step = token === "pageup" ? -bodyRows : bodyRows;
+        if (onMcp) {
+          mcpScroll = clampScroll3(mcpScroll + step, runtimes.length, bodyRows);
+        } else {
+          toolsScroll = clampScroll3(toolsScroll + step, options.tools.length, bodyRows);
+        }
+        paint();
+      }
+    });
+  }
+  return handle;
+}
+function openMcpTools(otui, chrome, options) {
+  return presentMcpTools((hostOtui, hostChrome, input2) => openModal(hostOtui, hostChrome, input2), otui, chrome, options);
+}
 
 // src/tui/tui-shell.ts
 init_slate();
@@ -55825,6 +56169,11 @@ var AGENT_SLASH_COMMANDS = [
     description: "Show project-wide items needing review (proposals, blocked sessions)",
     modes: AGENT_ONLY
   },
+  {
+    name: "/mcp",
+    description: "Show available tools and MCP client connect status",
+    modes: AGENT_ONLY
+  },
   {
     name: "/compact",
     description: "Compact model context \u2014 /compact [focus] (archive kept)",
@@ -56403,6 +56752,10 @@ function onKeypress2(r, handler) {
   return () => r._internalKeyInput.offInternal("keypress", handler);
 }
 function showComposerChoice(otui, r, dock, request) {
+  if (dock.visible === true) {
+    request.onBusy?.();
+    return Promise.resolve(request.cancelId);
+  }
   return new Promise((resolve3) => {
     const options = request.options.map((o) => ({
       ...o,
@@ -60626,7 +60979,13 @@ async function launchTuiAgentShell(opts) {
     const sbContext = new otui.TextRenderable(r, { id: "sb-ctx-v", content: otui.t`${otui.dim("0 tokens")}` });
     sidebar.add(sbContext);
     sidebar.add(new otui.TextRenderable(r, { id: "sb-tools-k", content: otui.t`${otui.dim("Tools")}`, marginTop: 1 }));
-    sidebar.add(new otui.TextRenderable(r, { id: "sb-tools-v", content: otui.t`${otui.dim(`${deps.tools.length} available`)}` }));
+    sidebar.add(new otui.TextRenderable(r, {
+      id: "sb-tools-v",
+      content: otui.t`${otui.dim(`${deps.tools.length} available`)}`,
+      onMouseDown: () => {
+        showTools();
+      }
+    }));
     sidebar.add(new otui.TextRenderable(r, { id: "sb-status-k", content: otui.t`${otui.dim("Status")}`, marginTop: 1 }));
     const sbWorkers = new otui.TextRenderable(r, {
       id: "sb-status-v",
@@ -61401,7 +61760,8 @@ Staying in the current session.
         openReview(otui, chrome, {
           items,
           acceptProposal: (item) => acceptProposalViaShell(makeCommandRunner(cwd), item.workspaceId, item.proposalId),
-          onAccepted: () => {
+          declineProposal: (item) => declineProposalViaShell(makeCommandRunner(cwd), item.workspaceId, item.proposalId),
+          onResolved: () => {
             refreshReviewSidebar();
           },
           renderer: r,
@@ -61409,6 +61769,38 @@ Staying in the current session.
         });
       })();
     };
+    const showTools = () => {
+      (async () => {
+        const cwd = inspectorCwd();
+        const runtimes = await mcpClientStatus(cwd, mcpRuntimeIds());
+        openMcpTools(otui, chrome, {
+          tools: deps.tools.map((t) => t.definition),
+          runtimes,
+          connect: async (id) => {
+            try {
+              const report = await installMcpClient(cwd, [id]);
+              const outcome = report.outcomes[0];
+              if (outcome !== undefined && outcome.errors.length > 0) {
+                return { ok: false, message: outcome.errors.join("; ") };
+              }
+              return { ok: true };
+            } catch (error2) {
+              return { ok: false, message: error2 instanceof Error ? error2.message : String(error2) };
+            }
+          },
+          disconnect: async (id) => {
+            try {
+              await uninstallMcpClient(cwd, [id]);
+              return { ok: true };
+            } catch (error2) {
+              return { ok: false, message: error2 instanceof Error ? error2.message : String(error2) };
+            }
+          },
+          renderer: r,
+          ...inspectorKeys
+        });
+      })();
+    };
     const runModeCommand = (line) => {
       const modeArgs = line.trim().split(/\s+/).slice(1).filter((p) => p.length > 0);
       const wanted = modeArgs[0] ?? "";
@@ -61416,6 +61808,7 @@ Staying in the current session.
       const applyMode = async (next) => {
         if (next === "auto") {
           chrome.hideMenu();
+          let blockedByOpenDialog = false;
           const confirmId = await chrome.withOverlay(() => showComposerChoice(otui, r, chrome.dock, {
             title: "Switch to auto mode?",
             subtitle: "Skips confirmation for EVERY action, including destructive commands. Only credential-touching commands still ask.",
@@ -61423,9 +61816,16 @@ Staying in the current session.
             options: [
               { id: "confirm", label: "Confirm", description: "I understand the risk" },
               { id: "cancel", label: "Cancel", description: "Keep the current mode", recommended: true }
-            ]
+            ],
+            onBusy: () => {
+              blockedByOpenDialog = true;
+              chrome.showToast("Answer the open approval first, then retry /mode.");
+            }
           }));
           input2.focus();
+          if (blockedByOpenDialog) {
+            return;
+          }
           if (confirmId !== "confirm") {
             chrome.showToast("Cancelled \u2014 mode unchanged.");
             return;
@@ -61455,6 +61855,7 @@ Staying in the current session.
       const stored = getProjectPermissionMode(sessionCwd);
       chrome.hideMenu();
       (async () => {
+        let blockedByOpenDialog = false;
         const id = await chrome.withOverlay(() => showComposerChoice(otui, r, chrome.dock, {
           title: `Permission mode (current: ${permissionMode})`,
           subtitle: stored !== undefined ? `Project default: ${stored}` : "No project default set.",
@@ -61464,9 +61865,16 @@ Staying in the current session.
             label: m,
             description: MODE_PICKER_DESCRIPTIONS[m],
             recommended: m === permissionMode
-          }))
+          })),
+          onBusy: () => {
+            blockedByOpenDialog = true;
+            chrome.showToast("Answer the open approval first, then retry /mode.");
+          }
         }));
         input2.focus();
+        if (blockedByOpenDialog) {
+          return;
+        }
         if (isPermissionMode(id) && id !== permissionMode) {
           await applyMode(id);
         }
@@ -61864,7 +62272,8 @@ Staying in the current session.
           isSessionInfo: isSessionInfoCommand(line),
           isFlows: isFlowsCommand(line),
           isWorkspace: isWorkspaceCommand(line),
-          isReview: isReviewCommand(line)
+          isReview: isReviewCommand(line),
+          isMcp: isMcpToolsCommand(line)
         });
         switch (decision) {
           case "exit": {
@@ -61972,6 +62381,10 @@ Staying in the current session.
             showReview();
             return;
           }
+          case "mcp": {
+            showTools();
+            return;
+          }
           case "deferred": {
             transcript.add(new otui.TextRenderable(r, {
               id: `c${uid++}`,
@@ -61995,6 +62408,7 @@ Staying in the current session.
           return;
         }
         (async () => {
+          let blockedByOpenDialog = false;
           const chosen = await showComposerChoice(otui, r, chrome.dock, {
             title: "Main agent is busy",
             subtitle: line,
@@ -62002,8 +62416,17 @@ Staying in the current session.
               { id: "main", label: "Main queue", description: "queue for the main agent; remove/edit/force later", recommended: true },
               { id: "side", label: "Side-1", description: "read-only answer, outside main history (as before)" }
             ],
-            cancelId: "side"
+            cancelId: "side",
+            onBusy: () => {
+              blockedByOpenDialog = true;
+              chrome.showToast("Answer the open approval first, then resend.");
+            }
           });
+          if (blockedByOpenDialog) {
+            input2.value = line;
+            input2.focus();
+            return;
+          }
           if (chosen === "main") {
             const id = `mq${mainQueueSeq++}`;
             mainQueue.push({ id, question: line, displayQuestion: displayLine });
@@ -62182,6 +62605,10 @@ Staying in the current session.
           showReview();
           return;
         }
+        if (isMcpToolsCommand(command.name)) {
+          showTools();
+          return;
+        }
         if (command.name === "/copy") {
           const target = newestBlock();
           if (target === undefined || !copyBlock(target.id)) {
@@ -70868,7 +71295,7 @@ keryx workspace list-proposals [<workspace-id>]`);
 }
 function renderCatchUp(report, includeLifecycleFlags = true) {
   const sections = [];
-  sections.push(renderSection("Pending proposals", report.proposals, (item) => `- Accept, reject, or dismiss proposal ${item.proposalId} in workspace ${item.workspaceId}? ` + `Recommendation: ${item.fresh ? "evidence is fresh \u2014 review now (`keryx workspace review " + item.workspaceId + " " + item.proposalId + " --decision <accepted|rejected|dismissed>`)" : "evidence has drifted since this proposal was created \u2014 treat as stale, re-run wrap-up before deciding"}.`));
+  sections.push(renderSection("Pending proposals", report.proposals, (item) => `- Accept, reject, or dismiss ${item.kind} proposal ${item.proposalId} in workspace ${item.workspaceId}` + `${item.note !== undefined ? `: "${item.note}"` : ""}? ` + `Recommendation: ${item.fresh ? "evidence is fresh \u2014 review now (`keryx workspace review " + item.workspaceId + " " + item.proposalId + " --decision <accepted|rejected|dismissed>`)" : "evidence has drifted since this proposal was created \u2014 treat as stale, re-run wrap-up before deciding"}.`));
   sections.push(renderSection("Blocked sessions (stopped unattended)", report.blocked, (item) => `- Session ${item.sessionId} stopped unattended (${item.terminalState.reason}) at ${item.terminalState.occurredAt}. Resume it, or archive and move on? ` + `Recommendation: \`keryx shell -r ${item.sessionId}\` to resume and unblock it.`));
   sections.push(renderSection("Unbound candidates (wrap-up ran, no workspace bound)", report.unboundCandidates, (item) => `- Session ${item.sessionId} produced untriaged seeds with no workspace bound (${item.summary}). Bind to a workspace and propose, or discard? ` + `Recommendation: pick a workspace, then \`keryx workspace propose <workspace-id> --kind <kind> --session ${item.sessionId}\` (evidence: ${item.evidencePath}).`));
   sections.push(renderSection("Unknown (no resolution recorded)", report.unknown, (item) => `- Session ${item.sessionId} was last seen ${item.lastSeenAt} with no proposal, terminal state, or unbound-candidate artifact recorded. Investigate, or ignore? ` + `Recommendation: \`keryx sessions list\` / \`keryx shell -r ${item.sessionId}\` to see what happened.`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrciphersmith/keryx",
-  "version": "0.2.50",
+  "version": "0.2.52",
   "description": "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   "private": false,
   "publishConfig": {