@scenar/mcp-server 0.2.1 → 0.4.0

package/README.md

@@ -2,9 +2,9 @@
 
 The [Model Context Protocol](https://modelcontextprotocol.io) server for
 [Scenar](https://github.com/stigmer/scenar) — it lets AI editors (Cursor, Claude
-Desktop, etc.) scan a React app, author a scenario tour, narrate it, pack it, and
-serve or publish the embed. A thin, type-safe wrapper over the `@scenar/cli`
-programmatic API.
+Desktop, etc.) bootstrap a demos project, author a scenario tour, narrate it,
+pack it, and serve or publish the embed. A thin, type-safe wrapper over the
+`@scenar/cli` programmatic API.
 
 ## Install in Cursor
 
@@ -31,8 +31,7 @@ Restart your editor.
 
 | Tool | What it does |
 |------|-------------|
-| `scenar_preview_init` | Scan a React project → `.scenar/` registry + report |
-| `scenar_preview_sync` | Re-scan after code changes (preserves your edits) |
+| `scenar_install` | Bootstrap a demos project → scaffold + add deps + starter tour |
 | `scenar_validate` | Validate a scenario YAML or directory |
 | `scenar_narrate` | Synthesize TTS audio for a scenario |
 | `scenar_pack` | Bundle a scenario into a static embed |
@@ -43,10 +42,8 @@ Restart your editor.
 
 ## Resources
 
-`scenar://registry/views`, `scenar://registry/report`,
-`scenar://registry/providers`, `scenar://scenario/{name}/steps`, and
-`scenar://scenario/{name}/manifest` expose read-only context the model can
-inspect.
+`scenar://scenario/{name}/steps` and `scenar://scenario/{name}/manifest` expose
+read-only context the model can inspect.
 
 See the [Scenar docs](https://github.com/stigmer/scenar/blob/main/docs/mcp-server.md)
 for configuration in other editors.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scenar/mcp-server",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Model Context Protocol server for Scenar — lets AI editors scan, author, narrate, pack, serve, and publish scenario tours.",
   "license": "Apache-2.0",
   "type": "module",
@@ -25,8 +25,7 @@
   "types": "./src/index.d.ts",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@scenar/cli": "0.2.1",
-    "@scenar/preview": "0.2.1",
+    "@scenar/cli": "0.4.0",
     "zod": "^3.23.8"
   }
 }

package/skill/SKILL.md

@@ -1,32 +1,32 @@
 ---
 name: scenar
 description: >-
-  Author Scenar scenario tours from a React app: scan components with `scenar
-  preview`, write steps.ts + index.tsx (or use the createScenario SDK), add
-  cursor/scroll/type interactions and narration, then pack, serve, and publish
-  the embed. Use when the user wants to build a product tour, demo, or
+  Author Scenar scenario tours from a React app: bootstrap a demos project with
+  `scenar install`, write steps.ts + index.tsx (or use the createScenario SDK),
+  add cursor/scroll/type interactions and narration, then pack, serve, and
+  publish the embed. Use when the user wants to build a product tour, demo, or
   interactive embed with Scenar; mentions the @scenar/* packages; or asks to run
-  scenar preview/validate/narrate/pack/serve/publish (directly or via the
-  @scenar/mcp-server tools scenar_preview_init, scenar_pack, scenar_serve,
+  scenar install/validate/narrate/pack/serve/publish (directly or via the
+  @scenar/mcp-server tools scenar_install, scenar_pack, scenar_serve,
   scenar_publish, etc.).
 ---
 
 # Authoring Scenar Scenarios
 
 Scenar turns a React app into a narrated, interactive embed (and an MP4). You,
-the AI, are the authoring engine: you scan the app, write the scenario, and run
-the pipeline. This skill is the source of truth for the model and the workflow.
+the AI, are the authoring engine: you bootstrap the project, write the scenario,
+and run the pipeline. This skill is the source of truth for the model and the
+workflow.
 
 ## The pipeline
 
 ```
-scan → wire providers → author → narrate → pack → serve / publish
+install → wire providers → author → narrate → pack → serve / publish
 ```
 
 | Step | CLI | MCP tool |
 |------|-----|----------|
-| Scan a React app into a view registry | `scenar preview init` | `scenar_preview_init` |
-| Re-scan after code changes | `scenar preview sync` | `scenar_preview_sync` |
+| Bootstrap a demos project + starter tour | `scenar install` | `scenar_install` |
 | Validate a scenario YAML | `scenar validate` | `scenar_validate` |
 | Generate narration audio (TTS) | `scenar narrate` | `scenar_narrate` |
 | Bundle into a static embed | `scenar pack` | `scenar_pack` |
@@ -40,15 +40,18 @@ structured results. Paths are resolved against the project root.
 ## Two authoring paths
 
 - **Path A — real components (recommended for real tours).** Run
-  `scenar preview init --source ./src`. It scans the project and writes a
-  `.scenar/` registry (`views.ts`, `views.custom.tsx`, `providers.tsx`,
-  `report.md`) plus an MSW service worker. You then author a scenario that
-  renders the user's *actual* components. The hard part is wiring
-  `.scenar/providers.tsx` (theme/router/data) and MSW handlers so the components
-  render without a live backend — do this deliberately, with the user.
+  `scenar install <your-component-package>`. It scaffolds a demos project, adds
+  the component package as a dependency, and writes a runnable starter tour under
+  `tours/example-tour/`. You then author a scenario whose `index.tsx`
+  **imports the user's actual components directly** (no registry, no scan). The
+  hard part is wiring the tour's `.scenar/providers.tsx` (client + provider +
+  mock data) so the components render without a live backend — do this
+  deliberately, with the user. The recommended mock for Connect-RPC SDKs is an
+  in-process router transport (`createRouterTransport`); resolve the embed theme
+  with `getEmbedColorMode()` from `@scenar/react`. See [reference.md](reference.md).
 - **Path B — illustrative components (fastest for generic flows).** Compose the
-  `@scenar/react` shells and page templates (no scan needed). The bundled
-  `welcome-tour` example is Path B; study it before authoring.
+  `@scenar/react` shells and page templates (no product dependency needed). The
+  bundled `welcome-tour` example is Path B; study it before authoring.
 
 Both paths produce the same artifact: a **scenario directory**.
 
@@ -163,7 +166,8 @@ templates. Common shells: `BrowserView`, `TerminalView`, `CodeEditorView`,
 `FormCard`, `DataTable`, `StatusBadge`, `PulseHighlight`.
 
 See [reference.md](reference.md) for the full catalog, the `createScenario` SDK
-(type-safe Path B), provider/MSW wiring for Path A, and the bundle constraints.
+(type-safe Path B), the provider + router-transport wiring for Path A, and the
+bundle constraints.
 
 ## The one hard constraint: the bundle allowlist
 
@@ -175,7 +179,7 @@ CSS-drawn UI; import raster assets normally (Vite hashes them at pack time).
 ## Workflow checklist
 
 ```
-- [ ] Path A: scenar_preview_init, review report.md, wire providers.tsx + MSW
+- [ ] Path A: scenar_install, then wire the tour's .scenar/providers.tsx (provider + mock data)
 - [ ] Write steps.ts (timeline, captions, narration, interactions)
 - [ ] Write index.tsx (renderStep with shells + data-cursor-target hooks)
 - [ ] scenar_narrate to synthesize audio

package/skill/reference.md

@@ -1,8 +1,8 @@
 # Scenar Authoring Reference
 
 Deep reference for the [scenar skill](SKILL.md): the shell catalog, page parts,
-the `createScenario` SDK (Path B), provider/MSW wiring (Path A), the proto/YAML
-shape, and bundle constraints.
+the `createScenario` SDK (Path B), provider + router-transport wiring (Path A),
+the proto/YAML shape, and bundle constraints.
 
 ## Canonical example
 
@@ -101,22 +101,54 @@ export default createScenario({
 `StepInput` uses `narrationText` (not `narration`) and carries `props` instead of
 a free-form `data`. The output plugs straight into `<ScenarioPlayer>`.
 
-## Path A — real components: provider + MSW wiring
-
-`scenar preview init --source ./src` writes `.scenar/`:
-
-- `views.generated.ts` — scanner-owned; never edit
-- `views.custom.tsx` — your hand-added views
-- `views.ts` — the merged registry you author against
-- `providers.tsx` — **you wire this**: wrap components in the theme/router/data
-  providers they need to render in isolation
-- `report.md` — what was discovered/skipped and why (read this first)
+## Path A — real components: provider + router-transport wiring
+
+`scenar install <your-component-package>` adds the package as a dependency and
+scaffolds a runnable starter tour. There is **no registry and no scan**: your
+`index.tsx` imports the real components directly, exactly like any React app.
+
+The one piece to wire by hand is each tour's `.scenar/providers.tsx`, which
+exports `PreviewProviders`. `scenar pack` (embed) and `scenar render` (video)
+both wrap every step of the tour in it, so this is where the components get the
+provider and the data they need to render with no live backend.
+
+For **Connect-RPC SDKs** (e.g. `@stigmer/react`), mock the RPCs your components
+call with an in-process router transport — no network, no service worker — and
+resolve the embed's light/dark mode with `getEmbedColorMode()` from
+`@scenar/react`:
+
+```tsx
+import type { ReactNode } from "react";
+import "@your-org/ui/styles.css";              // pack bundles JS, not Tailwind
+import { createRouterTransport } from "@connectrpc/connect";
+import { getEmbedColorMode } from "@scenar/react";
+import { YourClient } from "@your-org/sdk";
+import { YourProvider } from "@your-org/ui";
+import { ProjectController } from "@your-org/protos/project/v1/query_pb";
+
+const transport = createRouterTransport((router) => {
+  router.service(ProjectController, {
+    list: () => ({ projects: [{ id: "1", name: "checkout-api" }] }),
+  });
+});
+const client = new YourClient({ baseUrl: "/", customTransport: transport });
+
+export function PreviewProviders({ children }: { readonly children: ReactNode }) {
+  return (
+    <YourProvider client={client} colorMode={getEmbedColorMode()}>
+      {children}
+    </YourProvider>
+  );
+}
+```
 
-Also generates an MSW service worker. Add MSW handlers so components that fetch
-data render with realistic fixtures (no live backend). This wiring is the one
-step that can't be automated — do it explicitly with the user, using `report.md`
-to see what each component expects. Re-run `scenar preview sync` after code
-changes (it preserves `views.custom.tsx` and `providers.tsx`).
+If the SDK isn't Connect-RPC based, use whatever in-process mock the client
+accepts — the only contract is that `PreviewProviders` renders the components
+without a backend. The product glue (client + provider + stylesheet) repeats
+across tours, so factor it into one local helper and let each tour's
+`providers.tsx` pass only its fixtures. This wiring is the one step that can't be
+automated — do it explicitly with the user. Re-running `scenar install` never
+overwrites it.
 
 ## YAML / proto scenarios
 

package/src/__tests__/server.test.ts

@@ -21,10 +21,9 @@ describe("Scenar MCP server", () => {
     const names = tools.map((t) => t.name).sort();
     expect(names).toEqual(
       [
+        "scenar_install",
         "scenar_narrate",
         "scenar_pack",
-        "scenar_preview_init",
-        "scenar_preview_sync",
         "scenar_publish",
         "scenar_render",
         "scenar_serve",
@@ -34,14 +33,8 @@ describe("Scenar MCP server", () => {
     );
   });
 
-  it("exposes the registry resources and scenario templates", async () => {
+  it("exposes the per-scenario resource templates", async () => {
     const client = await connectClient();
-    const { resources } = await client.listResources();
-    const uris = resources.map((r) => r.uri);
-    expect(uris).toContain("scenar://registry/views");
-    expect(uris).toContain("scenar://registry/report");
-    expect(uris).toContain("scenar://registry/providers");
-
     const { resourceTemplates } = await client.listResourceTemplates();
     const templates = resourceTemplates.map((t) => t.uriTemplate);
     expect(templates).toContain("scenar://scenario/{name}/steps");
@@ -68,11 +61,13 @@ describe("Scenar MCP server", () => {
     }
   });
 
-  it("reads a registry resource, returning guidance when absent", async () => {
+  it("reads a scenario steps resource, returning guidance when absent", async () => {
     const client = await connectClient();
-    const result = await client.readResource({ uri: "scenar://registry/views" });
+    const result = await client.readResource({
+      uri: "scenar://scenario/nope/steps",
+    });
     expect(result.contents).toHaveLength(1);
-    // With no .scenar/ in the test cwd, the body should guide the user.
+    // With no such scenario in the test cwd, the body should guide the user.
     const text = String(result.contents[0]!.text);
     expect(text.length).toBeGreaterThan(0);
   });

package/src/project.d.ts

@@ -6,6 +6,4 @@
 export declare function projectRoot(): string;
 /** Resolve a possibly-relative path against the project root. */
 export declare function resolveInProject(path: string): string;
-/** Read a project-relative text file, or null if it is missing/unreadable. */
-export declare function readProjectFile(relativePath: string): Promise<string | null>;
 //# sourceMappingURL=project.d.ts.map

package/src/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/project.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,8EAA8E;AAC9E,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMlF"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/project.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/src/project.js

@@ -1,5 +1,4 @@
 import { resolve, isAbsolute, join } from "node:path";
-import { readFile } from "node:fs/promises";
 /**
  * The project root the server reads relative paths against. Cursor launches the
  * MCP server with its working directory set to the workspace, but an explicit
@@ -12,13 +11,4 @@ export function projectRoot() {
 export function resolveInProject(path) {
     return isAbsolute(path) ? path : join(projectRoot(), path);
 }
-/** Read a project-relative text file, or null if it is missing/unreadable. */
-export async function readProjectFile(relativePath) {
-    try {
-        return await readFile(join(projectRoot(), relativePath), "utf-8");
-    }
-    catch {
-        return null;
-    }
-}
 //# sourceMappingURL=project.js.map

package/src/project.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,YAAoB;IACxD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/src/project.ts

@@ -1,5 +1,4 @@
 import { resolve, isAbsolute, join } from "node:path";
-import { readFile } from "node:fs/promises";
 
 /**
  * The project root the server reads relative paths against. Cursor launches the
@@ -14,12 +13,3 @@ export function projectRoot(): string {
 export function resolveInProject(path: string): string {
   return isAbsolute(path) ? path : join(projectRoot(), path);
 }
-
-/** Read a project-relative text file, or null if it is missing/unreadable. */
-export async function readProjectFile(relativePath: string): Promise<string | null> {
-  try {
-    return await readFile(join(projectRoot(), relativePath), "utf-8");
-  } catch {
-    return null;
-  }
-}

package/src/resources.d.ts

@@ -1,10 +1,9 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 /**
- * Register read-only resources the AI can inspect for authoring context: the
- * generated view registry + scan report (in .scenar/), and per-scenario steps +
- * pack manifest. All are read relative to the project root; a missing file
- * returns a short explanatory body rather than an error so the client degrades
- * gracefully.
+ * Register read-only resources the AI can inspect for authoring context: a
+ * scenario's steps and its packed bundle's manifest. Both are read relative to
+ * the project root; a missing file returns a short explanatory body rather than
+ * an error so the client degrades gracefully.
  */
 export declare function registerResources(server: McpServer): void;
 //# sourceMappingURL=resources.d.ts.map

package/src/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/resources.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAGtF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+EzD"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/resources.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAGtF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmDzD"}

package/src/resources.js

@@ -1,18 +1,14 @@
 import { join } from "node:path";
 import { readFile } from "node:fs/promises";
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { projectRoot, readProjectFile } from "./project.js";
+import { projectRoot } from "./project.js";
 /**
- * Register read-only resources the AI can inspect for authoring context: the
- * generated view registry + scan report (in .scenar/), and per-scenario steps +
- * pack manifest. All are read relative to the project root; a missing file
- * returns a short explanatory body rather than an error so the client degrades
- * gracefully.
+ * Register read-only resources the AI can inspect for authoring context: a
+ * scenario's steps and its packed bundle's manifest. Both are read relative to
+ * the project root; a missing file returns a short explanatory body rather than
+ * an error so the client degrades gracefully.
  */
 export function registerResources(server) {
-    registerRegistryFile(server, "scenar-views", "scenar://registry/views", "Scenar view registry", "The generated .scenar/views.ts — the components available to scenarios.", ".scenar/views.ts", "text/plain");
-    registerRegistryFile(server, "scenar-report", "scenar://registry/report", "Scenar scan report", "The .scenar/report.md — what the scanner discovered, skipped, and why.", ".scenar/report.md", "text/markdown");
-    registerRegistryFile(server, "scenar-providers", "scenar://registry/providers", "Scenar provider wiring", "The .scenar/providers.tsx — how real components are wrapped for preview.", ".scenar/providers.tsx", "text/plain");
     // Per-scenario resources: {name} is a scenario directory under the project.
     server.registerResource("scenar-scenario-steps", new ResourceTemplate("scenar://scenario/{name}/steps", { list: undefined }), {
         title: "Scenario steps",
@@ -53,20 +49,6 @@ export function registerResources(server) {
         };
     });
 }
-function registerRegistryFile(server, id, uri, title, description, relativePath, mimeType) {
-    server.registerResource(id, uri, { title, description, mimeType }, async (u) => {
-        const body = await readProjectFile(relativePath);
-        return {
-            contents: [
-                {
-                    uri: u.href,
-                    mimeType,
-                    text: body ?? `No ${relativePath} yet. Run scenar_preview_init to generate it.`,
-                },
-            ],
-        };
-    });
-}
 async function readFirstExisting(paths) {
     for (const path of paths) {
         try {

package/src/resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/resources.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,4EAA4E;IAC5E,MAAM,CAAC,gBAAgB,CACrB,uBAAuB,EACvB,IAAI,gBAAgB,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAC3E;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,oEAAoE;KAClF,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC;YACnC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC;YACrC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC;SACvC,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,IAAI,IAAI,mCAAmC,IAAI,WAAW,WAAW,EAAE,GAAG;iBACjF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACrB,0BAA0B,EAC1B,IAAI,gBAAgB,CAAC,mCAAmC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAC9E;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,8EAA8E;KAC5F,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC;YACnC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,IAAI,SAAS,EAAE,oBAAoB,CAAC;YAC3D,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,oBAAoB,CAAC;SAChD,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,IAAI,oCAAoC,IAAI,2BAA2B;iBAClF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,KAAe;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,WAAW;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/src/resources.ts

@@ -1,44 +1,15 @@
 import { join } from "node:path";
 import { readFile } from "node:fs/promises";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { projectRoot, readProjectFile } from "./project.js";
+import { projectRoot } from "./project.js";
 
 /**
- * Register read-only resources the AI can inspect for authoring context: the
- * generated view registry + scan report (in .scenar/), and per-scenario steps +
- * pack manifest. All are read relative to the project root; a missing file
- * returns a short explanatory body rather than an error so the client degrades
- * gracefully.
+ * Register read-only resources the AI can inspect for authoring context: a
+ * scenario's steps and its packed bundle's manifest. Both are read relative to
+ * the project root; a missing file returns a short explanatory body rather than
+ * an error so the client degrades gracefully.
  */
 export function registerResources(server: McpServer): void {
-  registerRegistryFile(
-    server,
-    "scenar-views",
-    "scenar://registry/views",
-    "Scenar view registry",
-    "The generated .scenar/views.ts — the components available to scenarios.",
-    ".scenar/views.ts",
-    "text/plain",
-  );
-  registerRegistryFile(
-    server,
-    "scenar-report",
-    "scenar://registry/report",
-    "Scenar scan report",
-    "The .scenar/report.md — what the scanner discovered, skipped, and why.",
-    ".scenar/report.md",
-    "text/markdown",
-  );
-  registerRegistryFile(
-    server,
-    "scenar-providers",
-    "scenar://registry/providers",
-    "Scenar provider wiring",
-    "The .scenar/providers.tsx — how real components are wrapped for preview.",
-    ".scenar/providers.tsx",
-    "text/plain",
-  );
-
   // Per-scenario resources: {name} is a scenario directory under the project.
   server.registerResource(
     "scenar-scenario-steps",
@@ -91,29 +62,6 @@ export function registerResources(server: McpServer): void {
   );
 }
 
-function registerRegistryFile(
-  server: McpServer,
-  id: string,
-  uri: string,
-  title: string,
-  description: string,
-  relativePath: string,
-  mimeType: string,
-): void {
-  server.registerResource(id, uri, { title, description, mimeType }, async (u) => {
-    const body = await readProjectFile(relativePath);
-    return {
-      contents: [
-        {
-          uri: u.href,
-          mimeType,
-          text: body ?? `No ${relativePath} yet. Run scenar_preview_init to generate it.`,
-        },
-      ],
-    };
-  });
-}
-
 async function readFirstExisting(paths: string[]): Promise<string | null> {
   for (const path of paths) {
     try {

package/src/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsCzE,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAUrD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsCzE,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CASrD"}