diffprism 1.4.0 → 1.4.1

package/README.md

@@ -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

@@ -5,7 +5,7 @@ import {
 } from "./chunk-RFDSC6MC.js";
 import {
   demo
-} from "./chunk-6P6QJPWT.js";
+} from "./chunk-GF455BBV.js";
 import {
   COMMIT_GATE_DIFF_REF,
   DEFAULT_DIFF_REF,
@@ -26,14 +26,14 @@ import {
   recordError,
   startGlobalServer,
   submitReviewToServer
-} from "./chunk-SCQFIDIK.js";
+} from "./chunk-YGUHES4P.js";
 import {
   getDiff
 } 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
@@ -721,7 +721,7 @@ async function setupInteractive(flags) {
 }
 async function runDemo(dev) {
   console.log("");
-  const { demo: demo2 } = await import("./demo-GHOE7YNU.js");
+  const { demo: demo2 } = await import("./demo-F47GIDSV.js");
   await demo2({ dev });
 }
 async function setupBatch(flags) {
@@ -1218,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-6P6QJPWT.js → chunk-GF455BBV.js}

@@ -1,7 +1,7 @@
 import {
   ensureServer,
   submitReviewToServer
-} from "./chunk-SCQFIDIK.js";
+} from "./chunk-YGUHES4P.js";
 import {
   parseDiff
 } from "./chunk-GGK6TIQZ.js";

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

@@ -96,12 +96,22 @@ 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 ? 1789619773143 : null;
+  return true ? 1789619886717 : null;
 }
 function getBuildInfo() {
   let dir = path2.dirname(fileURLToPath(import.meta.url));
@@ -127,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.4.0" : "0.0.0-dev";
+  return true ? "1.4.1" : "0.0.0-dev";
 }
 function describeEnvironment() {
   return {

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

@@ -1,7 +1,7 @@
 import {
   demo
-} from "./chunk-6P6QJPWT.js";
-import "./chunk-SCQFIDIK.js";
+} from "./chunk-GF455BBV.js";
+import "./chunk-YGUHES4P.js";
 import "./chunk-GGK6TIQZ.js";
 import "./chunk-DHCVZGHE.js";
 import "./chunk-JSBRDJBE.js";

package/dist/mcp-server.js

@@ -14,7 +14,7 @@ import {
   recordError,
   submitReviewToServer,
   waitForDecision
-} from "./chunk-SCQFIDIK.js";
+} from "./chunk-YGUHES4P.js";
 import {
   getDiff
 } from "./chunk-GGK6TIQZ.js";
@@ -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()
@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffprism",
-  "version": "1.4.0",
+  "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"
   },