Agentic Review: Introduce Review addon

code/.storybook/main.ts

@@ -69,6 +69,10 @@ const config = defineMain({
       directory: '../addons/a11y/src',
       titlePrefix: 'addons/accessibility',
     },
+    {
+      directory: '../addons/review/src',
+      titlePrefix: 'addons/review',
+    },
     {
       directory: '../addons/a11y/template/stories',
       titlePrefix: 'addons/accessibility',
@@ -122,6 +126,7 @@ const config = defineMain({
     '@storybook/addon-vitest',
     '@storybook/addon-a11y',
     '@storybook/addon-mcp',
+    '@storybook/addon-review',
     'storybook-addon-pseudo-states',
     '@chromatic-com/storybook',
     './services-preset.ts',

code/addons/review/README.md

@@ -0,0 +1,53 @@
+# @storybook/addon-review
+
+Renders an agent-pushed review of a code change inside Storybook.
+
+An ADE agent pushes a review payload via the companion MCP server
+(`@storybook/addon-mcp`); the dev server enriches it with the current git
+branch, caches it, and broadcasts it over the Storybook channel. This addon's
+page receives the payload (and requests a replay on mount so late or refreshed
+tabs catch up) and renders it as a dedicated review experience:
+
+- **Summary** — the review title and narrative, with the affected stories
+  grouped into Collections (agent-curated clusters) or by Components, plus
+  search and expand/collapse.
+- **Details** — a focused, full-screen story preview with previous/next
+  navigation through the reviewed stories and a link back to the summary.
+
+## Channel contract
+
+Event names live in `src/constants.ts` and are the cross-repo contract with
+`@storybook/addon-mcp`. They must match the emitter's constants exactly.
+
+- `…/push-review` — agent → server: a new review payload.
+- `…/display-review` — server → tabs: broadcast a review (`createdAt`-stamped).
+- `…/request-review` — tab → server: replay the cached review (on mount).
+
+## Review state shape
+
+See `src/review-state.ts`. It is a duplicate of the canonical valibot schema
+that lives in the MCP addon; this side only renders, so it needs the type, not
+the validator.
+
+## Baseline comparison
+
+The detail screen can render the reviewed story side-by-side against a baseline
+Storybook. The baseline source is configured with a single environment variable:
+
+```sh
+STORYBOOK_REVIEW_BASELINE=...
+```
+
+It accepts either of:
+
+- **A project-relative path to a static build** (e.g. `storybook-static`). The
+  directory is served directly. Paths must stay inside the project — absolute
+  paths and paths that escape the working directory via `..` are rejected.
+- **A remote origin URL** (e.g. `https://my-app.chromatic.com`). Requests are
+  proxied to that origin.
+
+The dev server exposes the baseline under an internal proxy path, so baseline
+previews and the baseline index load from the same origin as Storybook. If the
+variable is unset, or is neither a valid relative path nor a valid URL, no
+baseline is served (a warning is logged for invalid values) and the comparison
+controls stay hidden.

code/addons/review/build-config.ts

@@ -0,0 +1,26 @@
+import type { BuildEntries } from '../../../scripts/build/utils/entry-utils.ts';
+
+const config: BuildEntries = {
+  entries: {
+    browser: [
+      {
+        exportEntries: ['.'],
+        entryPoint: './src/index.ts',
+      },
+      {
+        exportEntries: ['./manager'],
+        entryPoint: './src/manager.tsx',
+        dts: false,
+      },
+    ],
+    node: [
+      {
+        exportEntries: ['./preset'],
+        entryPoint: './src/preset.ts',
+        dts: false,
+      },
+    ],
+  },
+};
+
+export default config;

code/addons/review/manager.js

@@ -0,0 +1 @@
+export * from './dist/manager.js';

code/addons/review/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@storybook/addon-review",
+  "version": "10.5.0-alpha.5",
+  "description": "Storybook addon that renders agent-pushed reviews",
+  "keywords": [
+    "storybook",
+    "storybook-addon",
+    "review",
+    "mcp",
+    "agent"
+  ],
+  "homepage": "https://github.com/storybookjs/storybook/tree/next/code/addons/review",
+  "bugs": {
+    "url": "https://github.com/storybookjs/storybook/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/storybookjs/storybook.git",
+    "directory": "code/addons/review"
+  },
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/storybook"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "code": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./manager": "./dist/manager.js",
+    "./package.json": "./package.json",
+    "./preset": "./dist/preset.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "*.js",
+    "*.d.ts",
+    "!src/**/*"
+  ],
+  "devDependencies": {
+    "http-proxy-middleware": "^4.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "sirv": "^2.0.4",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "storybook": "workspace:^"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "storybook": {
+    "displayName": "Review",
+    "unsupportedFrameworks": [
+      "react-native"
+    ]
+  }
+}

code/addons/review/preset.js

@@ -0,0 +1 @@
+export * from './dist/preset.js';

code/addons/review/project.json

@@ -0,0 +1,10 @@
+{
+  "name": "addon-review",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "projectType": "library",
+  "targets": {
+    "compile": {},
+    "check": {}
+  },
+  "tags": ["library"]
+}