diffprism 1.3.3 → 1.4.1

package/README.md

@@ -89,7 +89,7 @@ Reviews are **one per repo**: opening a review for a repo that already has one u
 
 In a local review, **Ask agent now** in a line's comment form asks the agent while you're still reviewing: the agent's wait for your decision ends with your question, it answers in the thread, and goes back to waiting.
 
-PR reviews are opened with `diffprism review <PR URL>` or the dashboard — not by `open_review` — and your AI then works inside them with the tools above. Click a line to ask the agent about it; an agent listening with `wait_for_comments` answers in the thread.
+PR reviews are opened with `diffprism review <PR URL>` or the dashboard — not by `open_review` — and your AI then works inside them with the tools above. Click a line to ask the agent about it; an agent listening with `wait_for_comments` answers in the thread. Nothing starts an agent for you: if none has picked a question up, the thread says so and names the session to ask Claude Code about.
 
 When you're done, **Approve**, **Request changes** or **Comment** from the bar at the bottom: DiffPrism posts it to GitHub as a pull request review. Your threads are a conversation with the agent, so none of them goes to GitHub unless you tick it; a ticked thread posts your opening message as an inline review comment. The token comes from `GITHUB_TOKEN`, `gh auth token`, or `~/.diffprism/config.json`.
 
@@ -113,7 +113,7 @@ DiffPrism also works for reviewing local agent-generated changes:
 ```bash
 diffprism review                    # Review all changes (staged + unstaged)
 diffprism review --staged           # Staged changes only
-diffprism review HEAD~3             # Last 3 commits
+diffprism review HEAD~3..HEAD       # Last 3 commits
 diffprism review main..feature      # Branch diff
 ```
 
@@ -181,6 +181,7 @@ skill tells them so.
 ## CLI Reference
 
 ```bash
+diffprism demo                      # Open a sample review
 diffprism review <ref>              # Open a review (PR URL, git ref, or flags)
 diffprism setup                     # Configure Claude Code integration
 diffprism setup --global            # Global setup (no git repo needed)
@@ -189,10 +190,12 @@ diffprism server status             # Check server status
 diffprism server stop               # Stop the server
 diffprism hook install              # Gate commits on a review
 diffprism hook uninstall            # Remove the gate
+diffprism hook pre-commit           # Run the gate (what the installed hook calls)
 diffprism reply --session <id> <annotation-id> "…"  # Answer a reviewer's question, as the agent
 diffprism feedback                  # Share feedback as a prefilled GitHub issue
 diffprism feedback --bug            # Report a bug, including the last error
 diffprism teardown                  # Remove configuration
+diffprism serve                     # Run the MCP server over stdio (your MCP client launches this)
 ```
 
 ## Feedback
@@ -215,6 +218,7 @@ cd diffprism
 pnpm install
 pnpm test
 pnpm run build
+pnpm docs:check                     # Fail if docs disagree with the code (runs in CI)
 pnpm cli review --staged            # Run CLI from source
 ```
 

package/dist/bin.js

@@ -2,10 +2,10 @@
 import {
   isPrRef,
   parsePrRef
-} from "./chunk-EPU4F7WT.js";
+} from "./chunk-RFDSC6MC.js";
 import {
   demo
-} from "./chunk-4PXCENR6.js";
+} from "./chunk-GF455BBV.js";
 import {
   COMMIT_GATE_DIFF_REF,
   DEFAULT_DIFF_REF,
@@ -26,14 +26,14 @@ import {
   recordError,
   startGlobalServer,
   submitReviewToServer
-} from "./chunk-UWIDAULW.js";
+} from "./chunk-YGUHES4P.js";
 import {
   getDiff
-} from "./chunk-3GMPE2ZR.js";
+} from "./chunk-GGK6TIQZ.js";
 import "./chunk-DHCVZGHE.js";
 import "./chunk-JSBRDJBE.js";
 
-// cli/src/index.ts
+// cli/src/program.ts
 import { Command } from "commander";
 
 // cli/src/commands/hook.ts
@@ -518,6 +518,8 @@ The reviewer can also ask you questions on lines of the PR. Hold that conversati
 2. \`mcp__diffprism__reply\` \u2014 answer each thread, passing its \`annotation_id\`.
 3. Wait again. On \`timed_out\`, nothing new was said \u2014 keep waiting until the user tells you to stop.
 
+When no agent has read a question, the dashboard tells the reviewer so, and to ask you to answer their DiffPrism comments on a session id. When they do, run this loop with that \`session_id\`.
+
 A PR review and a working-copy review can be open for the same clone at once. If a tool reports more than one session, pass the \`session_id\` of the one you mean.
 
 ## Tool Reference
@@ -719,7 +721,7 @@ async function setupInteractive(flags) {
 }
 async function runDemo(dev) {
   console.log("");
-  const { demo: demo2 } = await import("./demo-WOT5AZBP.js");
+  const { demo: demo2 } = await import("./demo-F47GIDSV.js");
   await demo2({ dev });
 }
 async function setupBatch(flags) {
@@ -1216,33 +1218,38 @@ ${url}`
   }
 }
 
+// cli/src/program.ts
+function createProgram() {
+  const program = new Command();
+  program.name("diffprism").description("Local-first code review tool for agent-generated changes").version(describeVersion(currentVersion()));
+  program.action(defaultAction);
+  program.command("demo").description("Open a sample review to see DiffPrism in action").option("--dev", "Use Vite dev server").action(demo);
+  program.command("review [ref]").description("Open a browser-based diff review (local git ref or GitHub PR ref like owner/repo#123)").option("--staged", "Review staged changes").option("--unstaged", "Review unstaged changes").option("-t, --title <title>", "Review title").option("--reasoning <text>", "Agent reasoning about the changes").option("--dev", "Use Vite dev server with HMR instead of static files").option("--post-to-github", "Automatically post review back to GitHub without prompting").action(review);
+  program.command("review-pr <pr>", { hidden: true }).action((pr, flags) => review(pr, flags));
+  const hookCmd = program.command("hook").description("Git hook integration \u2014 gate commits on a human review");
+  hookCmd.command("pre-commit").description("Run the review gate for the staged changes (called from a git hook)").option("--min-lines <n>", "Staged lines required to trigger a review (default: 120)").option("--dev", "Use Vite dev server").action((flags) => {
+    void preCommitHook(flags);
+  });
+  hookCmd.command("install").description("Add the diffprism gate to this repo's pre-commit hook").action(() => {
+    installHook();
+  });
+  hookCmd.command("uninstall").description("Remove the diffprism gate from this repo's pre-commit hook").action(() => {
+    uninstallHook();
+  });
+  program.command("feedback").description("Open a prefilled GitHub issue to share feedback or report a bug \u2014 you review it before anything is sent").option("--bug", "Report a bug, including the last error DiffPrism hit").option("-m, --message <text>", "Start the issue with this text").option("--print", "Print the issue URL instead of opening a browser").action((flags) => feedback(flags));
+  program.command("reply <annotation-id> <message...>").description("Answer a reviewer's question on an open review, as the agent").requiredOption("--session <id>", "The review the question is on").option("--agent <name>", "Name shown on the reply", "agent").action((annotationId, message2, flags) => reply(annotationId, message2, flags));
+  program.command("serve").description("Start the MCP server for Claude Code integration").action(serve);
+  program.command("setup").description("Configure DiffPrism for Claude Code integration").option("--global", "Configure globally (skill + permissions, no git repo required)").option("--force", "Overwrite existing configuration files").option("--dev", "Use Vite dev server").option("--no-demo", "Skip the demo review after setup").action((flags) => {
+    setup(flags);
+  });
+  program.command("teardown").description("Remove DiffPrism configuration from the current project").option("--global", "Remove global configuration (skill + permissions at ~/.claude/)").option("-q, --quiet", "Suppress output").action((flags) => {
+    teardown(flags);
+  });
+  const serverCmd = program.command("server").description("Start the global DiffPrism server for multi-session reviews").option("-p, --port <port>", "HTTP API port (default: 24680)").option("--ws-port <port>", "WebSocket port (default: 24681)").option("--dev", "Use Vite dev server with HMR instead of static files").option("--background", "Start server as a background daemon").option("--_daemon", "Internal: run as spawned daemon (do not use directly)").action(server);
+  serverCmd.command("status").description("Check if the global server is running and list active sessions").action(serverStatus);
+  serverCmd.command("stop").description("Stop the running global server").action(serverStop);
+  return program;
+}
+
 // cli/src/index.ts
-var program = new Command();
-program.name("diffprism").description("Local-first code review tool for agent-generated changes").version(describeVersion(currentVersion()));
-program.action(defaultAction);
-program.command("demo").description("Open a sample review to see DiffPrism in action").option("--dev", "Use Vite dev server").action(demo);
-program.command("review [ref]").description("Open a browser-based diff review (local git ref or GitHub PR ref like owner/repo#123)").option("--staged", "Review staged changes").option("--unstaged", "Review unstaged changes").option("-t, --title <title>", "Review title").option("--reasoning <text>", "Agent reasoning about the changes").option("--dev", "Use Vite dev server with HMR instead of static files").option("--post-to-github", "Automatically post review back to GitHub without prompting").action(review);
-program.command("review-pr <pr>", { hidden: true }).action((pr, flags) => review(pr, flags));
-var hookCmd = program.command("hook").description("Git hook integration \u2014 gate commits on a human review");
-hookCmd.command("pre-commit").description("Run the review gate for the staged changes (called from a git hook)").option("--min-lines <n>", "Staged lines required to trigger a review (default: 120)").option("--dev", "Use Vite dev server").action((flags) => {
-  void preCommitHook(flags);
-});
-hookCmd.command("install").description("Add the diffprism gate to this repo's pre-commit hook").action(() => {
-  installHook();
-});
-hookCmd.command("uninstall").description("Remove the diffprism gate from this repo's pre-commit hook").action(() => {
-  uninstallHook();
-});
-program.command("feedback").description("Open a prefilled GitHub issue to share feedback or report a bug \u2014 you review it before anything is sent").option("--bug", "Report a bug, including the last error DiffPrism hit").option("-m, --message <text>", "Start the issue with this text").option("--print", "Print the issue URL instead of opening a browser").action((flags) => feedback(flags));
-program.command("reply <annotation-id> <message...>").description("Answer a reviewer's question on an open review, as the agent").requiredOption("--session <id>", "The review the question is on").option("--agent <name>", "Name shown on the reply", "agent").action((annotationId, message2, flags) => reply(annotationId, message2, flags));
-program.command("serve").description("Start the MCP server for Claude Code integration").action(serve);
-program.command("setup").description("Configure DiffPrism for Claude Code integration").option("--global", "Configure globally (skill + permissions, no git repo required)").option("--force", "Overwrite existing configuration files").option("--dev", "Use Vite dev server").option("--no-demo", "Skip the demo review after setup").action((flags) => {
-  setup(flags);
-});
-program.command("teardown").description("Remove DiffPrism configuration from the current project").option("--global", "Remove global configuration (skill + permissions at ~/.claude/)").option("-q, --quiet", "Suppress output").action((flags) => {
-  teardown(flags);
-});
-var serverCmd = program.command("server").description("Start the global DiffPrism server for multi-session reviews").option("-p, --port <port>", "HTTP API port (default: 24680)").option("--ws-port <port>", "WebSocket port (default: 24681)").option("--dev", "Use Vite dev server with HMR instead of static files").option("--background", "Start server as a background daemon").option("--_daemon", "Internal: run as spawned daemon (do not use directly)").action(server);
-serverCmd.command("status").description("Check if the global server is running and list active sessions").action(serverStatus);
-serverCmd.command("stop").description("Stop the running global server").action(serverStop);
-program.parse();
+createProgram().parse();

package/dist/{chunk-4PXCENR6.js → chunk-GF455BBV.js}

@@ -1,10 +1,10 @@
 import {
   ensureServer,
   submitReviewToServer
-} from "./chunk-UWIDAULW.js";
+} from "./chunk-YGUHES4P.js";
 import {
   parseDiff
-} from "./chunk-3GMPE2ZR.js";
+} from "./chunk-GGK6TIQZ.js";
 import {
   analyze
 } from "./chunk-DHCVZGHE.js";

package/dist/{chunk-3GMPE2ZR.js → chunk-GGK6TIQZ.js}

@@ -210,6 +210,27 @@ function getRepoRoot(options) {
     return null;
   }
 }
+function getGitHubRemotes(options) {
+  const cwd = options?.cwd ?? process.cwd();
+  let output;
+  try {
+    output = execSync("git remote -v", {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+  } catch {
+    return [];
+  }
+  const repos = /* @__PURE__ */ new Set();
+  for (const line of output.split("\n")) {
+    const match = /github\.com[:/]([^/\s]+)\/([^/\s]+?)(?:\.git)?\s/i.exec(line);
+    if (match) {
+      repos.add(`${match[1]}/${match[2]}`.toLowerCase());
+    }
+  }
+  return Array.from(repos);
+}
 
 // packages/git/src/parser.ts
 import path2 from "path";
@@ -456,6 +477,7 @@ export {
   listCommits,
   detectWorktree,
   getRepoRoot,
+  getGitHubRemotes,
   parseDiff,
   getDiff
 };

package/dist/{chunk-EPU4F7WT.js → chunk-RFDSC6MC.js}

@@ -1,6 +1,6 @@
 import {
   parseDiff
-} from "./chunk-3GMPE2ZR.js";
+} from "./chunk-GGK6TIQZ.js";
 import {
   analyze
 } from "./chunk-DHCVZGHE.js";

package/dist/{chunk-UWIDAULW.js → chunk-YGUHES4P.js}

@@ -1,10 +1,11 @@
 import {
   getCurrentBranch,
   getDiff,
+  getGitHubRemotes,
   getRepoRoot,
   listBranches,
   listCommits
-} from "./chunk-3GMPE2ZR.js";
+} from "./chunk-GGK6TIQZ.js";
 import {
   analyze
 } from "./chunk-DHCVZGHE.js";
@@ -79,12 +80,38 @@ async function isServerAlive() {
   }
 }
 
+// packages/core/src/threads.ts
+function lastAuthor(annotation) {
+  const replies = annotation.replies ?? [];
+  return replies.length > 0 ? replies[replies.length - 1].author : annotation.author ?? "agent";
+}
+function awaitingAgent(annotation) {
+  return !annotation.dismissed && lastAuthor(annotation) === "reviewer";
+}
+function lastMessageAt(annotation) {
+  const replies = annotation.replies ?? [];
+  return replies.length > 0 ? replies[replies.length - 1].createdAt : annotation.createdAt;
+}
+function pickedUpByAgent(annotation, agentReadAt) {
+  return agentReadAt !== void 0 && agentReadAt > lastMessageAt(annotation);
+}
+
+// packages/core/src/diff-scope.ts
+var DEFAULT_DIFF_REF = "working-copy";
+var COMMIT_GATE_DIFF_REF = "staged";
+var DIFF_REF_DESCRIPTION = 'Which changes to review. "working-copy" (the default): everything not yet committed, staged and unstaged shown as separate groups. "staged": only what the next commit would contain. "unstaged": only edits not yet staged. Or a ref range such as "HEAD~3..HEAD" or "main..feature".';
+
+// packages/core/src/feedback.ts
+import fs3 from "fs";
+import os2 from "os";
+import path3 from "path";
+
 // packages/core/src/build-info.ts
 import fs2 from "fs";
 import path2 from "path";
 import { fileURLToPath } from "url";
 function builtAt() {
-  return true ? 1789610984376 : null;
+  return true ? 1789619886717 : null;
 }
 function getBuildInfo() {
   let dir = path2.dirname(fileURLToPath(import.meta.url));
@@ -110,19 +137,11 @@ function describeVersion(version) {
   return info.dev ? `${version} (dev build \u2014 ${info.root})` : version;
 }
 
-// packages/core/src/diff-scope.ts
-var DEFAULT_DIFF_REF = "working-copy";
-var COMMIT_GATE_DIFF_REF = "staged";
-var DIFF_REF_DESCRIPTION = 'Which changes to review. "working-copy" (the default): everything not yet committed, staged and unstaged shown as separate groups. "staged": only what the next commit would contain. "unstaged": only edits not yet staged. Or a ref range such as "HEAD~3..HEAD" or "main..feature".';
-
 // packages/core/src/feedback.ts
-import fs3 from "fs";
-import os2 from "os";
-import path3 from "path";
 var ISSUES_NEW_URL = "https://github.com/CodeJonesW/diffprism/issues/new";
 var MAX_ERROR_CHARS = 1500;
 function currentVersion() {
-  return true ? "1.3.3" : "0.0.0-dev";
+  return true ? "1.4.1" : "0.0.0-dev";
 }
 function describeEnvironment() {
   return {
@@ -211,15 +230,6 @@ ${errorText}
   return `${ISSUES_NEW_URL}?${params.toString()}`;
 }
 
-// packages/core/src/threads.ts
-function lastAuthor(annotation) {
-  const replies = annotation.replies ?? [];
-  return replies.length > 0 ? replies[replies.length - 1].author : annotation.author ?? "agent";
-}
-function awaitingAgent(annotation) {
-  return !annotation.dismissed && lastAuthor(annotation) === "reviewer";
-}
-
 // packages/core/src/server-client.ts
 import { spawn } from "child_process";
 import fs4 from "fs";
@@ -393,7 +403,7 @@ async function waitForDecision(serverInfo, sessionId, maxWaitMs, pollIntervalMs
     if (result) {
       return result;
     }
-    const annotationsResponse = await fetch(`${base}/annotations`);
+    const annotationsResponse = await fetch(`${base}/annotations?reader=agent`);
     if (!annotationsResponse.ok) {
       throw new Error(`Could not read threads for ${sessionId}: server returned ${annotationsResponse.status}`);
     }
@@ -413,7 +423,7 @@ async function submitReviewToServer(serverInfo, diffRef, options = {}) {
   if (options.injectedPayload) {
     payload = options.injectedPayload;
   } else {
-    const { getDiff: getDiff2, getCurrentBranch: getCurrentBranch2, detectWorktree } = await import("./src-OZQ32NDN.js");
+    const { getDiff: getDiff2, getCurrentBranch: getCurrentBranch2, detectWorktree } = await import("./src-XT4XP6TC.js");
     const { analyze: analyze2 } = await import("./src-JMPTSU3P.js");
     const { diffSet, rawDiff } = getDiff2(diffRef, { cwd });
     if (diffSet.files.length === 0) {
@@ -800,6 +810,14 @@ var IDLE_SESSION_TTL_MS = 24 * 60 * 60 * 1e3;
 function touch(session) {
   session.lastActivityAt = Date.now();
 }
+function recordAgentRead(session) {
+  const previous = session.agentReadAt;
+  session.agentReadAt = Date.now();
+  touch(session);
+  if (session.annotations.some((a) => awaitingAgent(a) && !pickedUpByAgent(a, previous))) {
+    broadcastSessionUpdate(session);
+  }
+}
 var sessions = /* @__PURE__ */ new Map();
 function listedSummaries() {
   return Array.from(sessions.values()).filter((session) => session.closedAt === void 0).map(toSummary);
@@ -943,7 +961,8 @@ function toSummary(session) {
     hasNewChanges: session.hasNewChanges,
     needsAttention: needsAttention(session),
     diffRef: session.diffRef,
-    source: session.source
+    source: session.source,
+    agentReadAt: session.agentReadAt
   };
 }
 function readBody(req) {
@@ -1260,7 +1279,7 @@ async function handleApiRequest(req, res) {
         fetchPullRequest,
         fetchPullRequestDiff,
         normalizePr
-      } = await import("./src-DNNNQ2RD.js");
+      } = await import("./src-LLACFIIT.js");
       if (!isPrRef(prUrl)) {
         jsonResponse(res, 400, {
           error: "Invalid PR URL. Expected https://github.com/owner/repo/pull/123 or owner/repo#123"
@@ -1283,20 +1302,7 @@ async function handleApiRequest(req, res) {
         fetchPullRequestDiff(client, owner, repo, prNumber)
       ]);
       const normalized = normalizePr(rawDiff, prMetadata);
-      let localRepoPath = null;
-      try {
-        const { execSync } = await import("child_process");
-        const remoteOutput = execSync("git remote -v", {
-          cwd: process.cwd(),
-          encoding: "utf-8",
-          stdio: ["pipe", "pipe", "pipe"]
-        });
-        const repoPattern = new RegExp(`github\\.com[:/]${owner}/${repo}(\\.git)?\\s`, "i");
-        if (repoPattern.test(remoteOutput)) {
-          localRepoPath = process.cwd();
-        }
-      } catch {
-      }
+      const localRepoPath = getGitHubRemotes({ cwd: process.cwd() }).includes(`${owner}/${repo}`.toLowerCase()) ? process.cwd() : null;
       const { session, reused } = openSession({
         key: `pr:${owner}/${repo}#${prNumber}`.toLowerCase(),
         repoRoot: localRepoPath ? getRepoRoot({ cwd: localRepoPath }) ?? localRepoPath : null,
@@ -1373,7 +1379,13 @@ async function handleApiRequest(req, res) {
       return true;
     }
     const repoRoot = getRepoRoot({ cwd: rawPath }) ?? path7.resolve(rawPath);
-    const matches = Array.from(sessions.values()).filter((session) => session.closedAt === void 0 && session.repoRoot === repoRoot).map(toSummary);
+    const remotes = getGitHubRemotes({ cwd: repoRoot });
+    const matches = Array.from(sessions.values()).filter((session) => {
+      if (session.closedAt !== void 0) return false;
+      if (session.repoRoot === repoRoot) return true;
+      const pr = session.payload.metadata.githubPr;
+      return pr !== void 0 && remotes.includes(`${pr.owner}/${pr.repo}`.toLowerCase());
+    }).map(toSummary);
     jsonResponse(res, 200, { repoRoot, sessions: matches });
     return true;
   }
@@ -1527,6 +1539,9 @@ async function handleApiRequest(req, res) {
       jsonResponse(res, 404, { error: "Session not found" });
       return true;
     }
+    if (new URL(req.url ?? "/", "http://localhost").searchParams.get("reader") === "agent") {
+      recordAgentRead(session);
+    }
     jsonResponse(res, 200, { annotations: session.annotations });
     return true;
   }
@@ -1592,7 +1607,7 @@ async function handleApiRequest(req, res) {
       jsonResponse(res, 400, { error: built.error });
       return true;
     }
-    const { resolveGitHubToken, createGitHubClient, submitGitHubReview } = await import("./src-DNNNQ2RD.js");
+    const { resolveGitHubToken, createGitHubClient, submitGitHubReview } = await import("./src-LLACFIIT.js");
     let token;
     try {
       token = resolveGitHubToken();
@@ -2072,6 +2087,7 @@ function mcpToolPermission(name) {
 export {
   readServerFile,
   isServerAlive,
+  awaitingAgent,
   getBuildInfo,
   describeVersion,
   DEFAULT_DIFF_REF,
@@ -2083,7 +2099,6 @@ export {
   REPORT_HINT,
   buildFeedbackUrl,
   startGlobalServer,
-  awaitingAgent,
   ensureServer,
   ReviewTimeoutError,
   ReviewerAskedError,

package/dist/{demo-WOT5AZBP.js → demo-F47GIDSV.js}

@@ -1,8 +1,8 @@
 import {
   demo
-} from "./chunk-4PXCENR6.js";
-import "./chunk-UWIDAULW.js";
-import "./chunk-3GMPE2ZR.js";
+} from "./chunk-GF455BBV.js";
+import "./chunk-YGUHES4P.js";
+import "./chunk-GGK6TIQZ.js";
 import "./chunk-DHCVZGHE.js";
 import "./chunk-JSBRDJBE.js";
 export {

package/dist/mcp-server.js

@@ -1,6 +1,6 @@
 import {
   isPrRef
-} from "./chunk-EPU4F7WT.js";
+} from "./chunk-RFDSC6MC.js";
 import {
   DEFAULT_DIFF_REF,
   DIFF_REF_DESCRIPTION,
@@ -14,10 +14,10 @@ import {
   recordError,
   submitReviewToServer,
   waitForDecision
-} from "./chunk-UWIDAULW.js";
+} from "./chunk-YGUHES4P.js";
 import {
   getDiff
-} from "./chunk-3GMPE2ZR.js";
+} from "./chunk-GGK6TIQZ.js";
 import {
   analyze
 } from "./chunk-DHCVZGHE.js";
@@ -73,7 +73,7 @@ ${candidates}`
 }
 async function readThreads(serverInfo, sessionId) {
   const response = await fetch(
-    `http://localhost:${serverInfo.httpPort}/api/reviews/${sessionId}/annotations`
+    `http://localhost:${serverInfo.httpPort}/api/reviews/${sessionId}/annotations?reader=agent`
   );
   if (!response.ok) {
     return null;
@@ -124,7 +124,7 @@ var annotationSchema = z.object({
     "other"
   ]).optional().describe("Category of the finding (defaults to 'other')")
 });
-async function startMcpServer() {
+function createMcpServer() {
   const server = new McpServer({
     name: "diffprism",
     version: currentVersion()
@@ -354,7 +354,7 @@ ${REPORT_HINT}`);
     async ({ session_id, repo_path }) => withSession({ session_id, repo_path }, async ({ serverInfo, sessionId }) => {
       const [sessionResponse, annotationsResponse] = await Promise.all([
         fetch(`http://localhost:${serverInfo.httpPort}/api/reviews/${sessionId}`),
-        fetch(`http://localhost:${serverInfo.httpPort}/api/reviews/${sessionId}/annotations`)
+        fetch(`http://localhost:${serverInfo.httpPort}/api/reviews/${sessionId}/annotations?reader=agent`)
       ]);
       if (!sessionResponse.ok) {
         return toolError(`Session not found: ${sessionId}`);
@@ -568,11 +568,16 @@ ${available.join("\n")}`);
       });
     })
   );
+  return server;
+}
+async function startMcpServer() {
+  const server = createMcpServer();
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
 export {
   DEFAULT_WAIT_MS,
+  createMcpServer,
   resolveTarget,
   startMcpServer
 };

package/dist/{src-DNNNQ2RD.js → src-LLACFIIT.js}

@@ -7,8 +7,8 @@ import {
   parsePrRef,
   resolveGitHubToken,
   submitGitHubReview
-} from "./chunk-EPU4F7WT.js";
-import "./chunk-3GMPE2ZR.js";
+} from "./chunk-RFDSC6MC.js";
+import "./chunk-GGK6TIQZ.js";
 import "./chunk-DHCVZGHE.js";
 import "./chunk-JSBRDJBE.js";
 export {

package/dist/{src-OZQ32NDN.js → src-XT4XP6TC.js}

@@ -3,17 +3,19 @@ import {
   getCurrentBranch,
   getDiff,
   getGitDiff,
+  getGitHubRemotes,
   getRepoRoot,
   listBranches,
   listCommits,
   parseDiff
-} from "./chunk-3GMPE2ZR.js";
+} from "./chunk-GGK6TIQZ.js";
 import "./chunk-JSBRDJBE.js";
 export {
   detectWorktree,
   getCurrentBranch,
   getDiff,
   getGitDiff,
+  getGitHubRemotes,
   getRepoRoot,
   listBranches,
   listCommits,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffprism",
-  "version": "1.3.3",
+  "version": "1.4.1",
   "type": "module",
   "description": "Local-first code review tool for agent-generated code changes",
   "bin": {
@@ -16,6 +16,7 @@
     "dev": "pnpm -r run dev",
     "lint": "pnpm -r run lint",
     "test": "pnpm -r run test",
+    "docs:check": "pnpm -F diffprism-cli docs:check",
     "cli": "pnpm -F @diffprism/ui build && tsx cli/src/index.ts",
     "prepublishOnly": "pnpm run build"
   },