forgebook 0.1.0 → 0.1.3

package/README.md

@@ -5,12 +5,12 @@ per story, switches for theme, contrast, motion and language, and a props table
 
 > **Status:** 0.x, early. Its author's design system runs on it; the API may still change between minor versions,
 > and every change is in the
-> [changelog](https://github.com/Ensiria/forgebook/blob/develop/packages/forgebook/CHANGELOG.md).
+> [changelog](https://github.com/ensiria/forgebook/blob/develop/packages/forgebook/CHANGELOG.md).
 
 **Requirements:** Node 22.18 or later · Vite 8 (the catalogue is built on it; other bundlers are not supported) · React 19 today, through
 [`@forgebook/react`](https://www.npmjs.com/package/@forgebook/react); other frameworks plug in through the same
 adapter (the catalogue's own interface is React either way) · npm, pnpm, yarn or bun ·
-[MIT licence](https://github.com/Ensiria/forgebook/blob/develop/packages/forgebook/LICENSE)
+[MIT licence](https://github.com/ensiria/forgebook/blob/develop/packages/forgebook/LICENSE)
 
 ## Install
 
@@ -116,10 +116,31 @@ its name.
 | Command | What it does |
 |---|---|
 | `forgebook dev` / `forgebook build` | Runs the catalogue of `forgebook.config.ts`, or builds it into static files |
+| `forgebook stories` | Lists every story with its id and links; fails when the story index has problems |
+| `forgebook story <id>` | One story: its args, its component's props, its links in a view (`--view theme=dark`) |
+| `forgebook mcp` | Serves the same answers to an agent over the Model Context Protocol |
 | `forgebook-docs` | Writes a package's `CATALOG.md` from its exports, their TSDoc and its stories |
 | `forgebook-texts` | Checks a package's story texts and lists what each language still has to translate |
 
-Each command prints its options with `--help`.
+Each command prints its options with `--help`; `stories` and `story` print JSON with `--json`.
+
+## For agents
+
+A coding agent can use the catalogue while it works: find a story's id, read a story's args and its component's
+props, and hand a person the link that opens it. Add the MCP server to the project's agent configuration, for
+example `.mcp.json` for Claude Code:
+
+```json
+{ "mcpServers": { "forgebook": { "command": "npx", "args": ["forgebook", "mcp"] } } }
+```
+
+It offers three tools: `list_stories`, `get_story` and `story_address`. Run from the catalogue's folder (or give
+`--config`), it uses the running `forgebook dev` when there is one, and starts a dev server of its own otherwise,
+kept while the agent's session lasts. The links name `http://localhost:5173` unless `--url` (or `FORGEBOOK_URL`) says
+where `forgebook dev` runs.
+
+In CI, `forgebook stories --json` fails on a broken story file (a title taken twice, a title that cannot be placed),
+and its JSON lists every story for a script.
 
 ## Packages
 
@@ -133,5 +154,5 @@ Each command prints its options with `--help`.
 ## Contributing
 
 Bugs, proposals and pull requests:
-[CONTRIBUTING.md](https://github.com/Ensiria/forgebook/blob/develop/CONTRIBUTING.md). Security problems:
-[SECURITY.md](https://github.com/Ensiria/forgebook/blob/develop/SECURITY.md).
+[CONTRIBUTING.md](https://github.com/ensiria/forgebook/blob/develop/CONTRIBUTING.md). Security problems:
+[SECURITY.md](https://github.com/ensiria/forgebook/blob/develop/SECURITY.md).

package/dist/bin/forgebook/agentClient.d.ts

@@ -0,0 +1,22 @@
+import { type AgentAnswer } from "../../src/vite/agentRoutes.ts";
+import type { ResolvedConfig } from "../../src/vite/configFile.ts";
+/** Where `forgebook dev` serves when no port is given: Vite's default. */
+export declare const DEFAULT_ORIGIN = "http://localhost:5173";
+/** The catalogue's answers, from wherever they come. */
+export type CatalogueClient = {
+    /** Asks one of the API's paths (`stories`, `story`) with its query. */
+    readonly ask: (route: string, params: URLSearchParams) => Promise<AgentAnswer>;
+    /** Where the answers come from: the running server's address, or none for a server of its own. */
+    readonly runningAt: string | undefined;
+    /** Stops the server it started; nothing for a running one. */
+    readonly close: () => Promise<void>;
+};
+/**
+ * The catalogue's answers: the running dev server at the address when it serves this catalogue, a server of its own
+ * otherwise.
+ *
+ * @param config - the catalogue's configuration.
+ * @param url - where `forgebook dev` runs, when not at Vite's default address.
+ */
+export declare const catalogueClient: (config: ResolvedConfig, url: string | undefined) => Promise<CatalogueClient>;
+//# sourceMappingURL=agentClient.d.ts.map

package/dist/bin/forgebook/agentClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentClient.d.ts","sourceRoot":"","sources":["../../../bin/forgebook/agentClient.ts"],"names":[],"mappings":"AAcA,OAAO,EAAa,KAAK,WAAW,EAA4B,MAAM,+BAA+B,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,0EAA0E;AAC1E,eAAO,MAAM,cAAc,0BAA0B,CAAC;AAEtD,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/E,kGAAkG;IAClG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC,CAAC;AAiDF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,cAAc,EACtB,KAAK,MAAM,GAAG,SAAS,KACtB,OAAO,CAAC,eAAe,CAGzB,CAAC"}

package/dist/bin/forgebook/agentClient.js

@@ -0,0 +1,70 @@
+/**
+ * How `forgebook stories`, `forgebook story` and `forgebook mcp` get their answers: from the catalogue's running dev
+ * server when it serves this catalogue, otherwise from a dev server of their own, started without listening.
+ *
+ * @remarks
+ * A running `forgebook dev` answers at once and its links work. A server of their own is started in the same process
+ * (Vite in middleware mode: no port, nothing reachable from outside) and the same function answers; its links name
+ * where `forgebook dev` serves by default, so they work once it runs. A server found at the address is used only when
+ * it says it serves this catalogue's folder (`ROOT_HEADER`), never another project's catalogue on the same port.
+ *
+ * @module
+ */
+import { createServer } from "vite";
+import { AGENT_API, agentAnswer, ROOT_HEADER } from "../../src/vite/agentRoutes.js";
+import { catalogueVite } from "./catalogueVite.js";
+/** Where `forgebook dev` serves when no port is given: Vite's default. */
+export const DEFAULT_ORIGIN = "http://localhost:5173";
+/**
+ * Asks a running dev server, if one at the address serves this catalogue.
+ *
+ * @param origin - the address to try.
+ * @param config - the catalogue's configuration, whose folder the server must name.
+ * @returns the client, or none when nothing there serves this catalogue.
+ */
+const runningClient = async (origin, config) => {
+    const ask = async (route, params) => {
+        const response = await fetch(`${origin}${AGENT_API}${route}?${params.toString()}`);
+        return { status: response.status, body: await response.json() };
+    };
+    try {
+        const probe = await fetch(`${origin}${AGENT_API}stories`, { signal: AbortSignal.timeout(2000) });
+        if (probe.headers.get(ROOT_HEADER) !== config.dir)
+            return undefined;
+        await probe.body?.cancel();
+    }
+    catch {
+        return undefined;
+    }
+    return { ask, runningAt: origin, close: async () => undefined };
+};
+/**
+ * A dev server of its own, in middleware mode, and the answers from it.
+ *
+ * @param config - the catalogue's configuration.
+ * @param origin - the address the links name.
+ */
+const ownClient = async (config, origin) => {
+    const server = await createServer(await catalogueVite(config, {
+        server: { middlewareMode: true, hmr: false },
+        appType: "custom",
+        logLevel: "error"
+    }));
+    return {
+        ask: (route, params) => agentAnswer((id) => server.ssrLoadModule(id), config, route, params, origin),
+        runningAt: undefined,
+        close: () => server.close()
+    };
+};
+/**
+ * The catalogue's answers: the running dev server at the address when it serves this catalogue, a server of its own
+ * otherwise.
+ *
+ * @param config - the catalogue's configuration.
+ * @param url - where `forgebook dev` runs, when not at Vite's default address.
+ */
+export const catalogueClient = async (config, url) => {
+    const origin = (url ?? DEFAULT_ORIGIN).replace(/\/+$/, "");
+    return (await runningClient(origin, config)) ?? ownClient(config, origin);
+};
+//# sourceMappingURL=agentClient.js.map

package/dist/bin/forgebook/agentClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentClient.js","sourceRoot":"","sources":["../../../bin/forgebook/agentClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,YAAY,EAAsB,MAAM,MAAM,CAAC;AAExD,OAAO,EAAE,SAAS,EAAoB,WAAW,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEtG,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAYtD;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,KAAK,EACzB,MAAc,EACd,MAAsB,EACgB,EAAE;IACxC,MAAM,GAAG,GAAG,KAAK,EAAE,KAAa,EAAE,MAAuB,EAAwB,EAAE;QACjF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACnF,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAClE,CAAC,CAAC;IACF,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,GAAG,SAAS,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,MAAM,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QACpE,MAAM,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC;AAClE,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,SAAS,GAAG,KAAK,EAAE,MAAsB,EAAE,MAAc,EAA4B,EAAE;IAC3F,MAAM,MAAM,GAAkB,MAAM,YAAY,CAC9C,MAAM,aAAa,CAAC,MAAM,EAAE;QAC1B,MAAM,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE;QAC5C,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,OAAO;KAClB,CAAC,CACH,CAAC;IACF,OAAO;QACL,GAAG,EAAE,CAAC,KAAa,EAAE,MAAuB,EAAwB,EAAE,CACpE,WAAW,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;QACtF,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;KAC5B,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,MAAsB,EACtB,GAAuB,EACG,EAAE;IAC5B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,CAAC,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5E,CAAC,CAAC"}

package/dist/bin/forgebook/agentText.d.ts

@@ -0,0 +1,18 @@
+import type { OutputStyle } from "@ensiria/cli-kit/log.types";
+import type { StoriesDocument, StoryDocument } from "../../src/vite/agent.types.ts";
+/**
+ * The stories as a table: one row per story, its id first (what `forgebook story` takes, never cut), then its
+ * component's title and its name.
+ *
+ * @param document - the stories document.
+ * @param style - colours, glyphs and width.
+ */
+export declare const storiesText: (document: StoriesDocument, style: OutputStyle) => string;
+/**
+ * One story's facts: where it is, where it opens, its args and its component's props.
+ *
+ * @param document - the story document.
+ * @param style - colours, glyphs and width.
+ */
+export declare const storyText: (document: StoryDocument, style: OutputStyle) => string;
+//# sourceMappingURL=agentText.d.ts.map

package/dist/bin/forgebook/agentText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentText.d.ts","sourceRoot":"","sources":["../../../bin/forgebook/agentText.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAKpF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,eAAe,EAAE,OAAO,WAAW,KAAG,MAUzE,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,aAAa,EAAE,OAAO,WAAW,KAAG,MAYvE,CAAC"}

package/dist/bin/forgebook/agentText.js

@@ -0,0 +1,44 @@
+/**
+ * The answers of `forgebook stories` and `forgebook story` as text for a terminal: a table of the stories, one story's
+ * facts, and the problems. Pure: documents in, text out, laid out with cli-kit's helpers.
+ *
+ * @remarks
+ * Nothing is cut to the terminal's width: ids and links are what a reader copies, so a long line wraps instead.
+ *
+ * @module
+ */
+import { keyValue, table } from "@ensiria/cli-kit/layout";
+/** The style with no width to fit, so no cell is cut. */
+const uncut = (style) => ({ ...style, width: Number.POSITIVE_INFINITY });
+/**
+ * The stories as a table: one row per story, its id first (what `forgebook story` takes, never cut), then its
+ * component's title and its name.
+ *
+ * @param document - the stories document.
+ * @param style - colours, glyphs and width.
+ */
+export const storiesText = (document, style) => table(document.components.flatMap((component) => component.stories.map((story) => [
+    story.id,
+    `${component.title} › ${story.name}${story.isUnlisted ? " (unlisted)" : ""}`
+])), { columns: [{ header: "Id" }, { header: "Story", tone: "muted" }] }, uncut(style));
+/**
+ * One story's facts: where it is, where it opens, its args and its component's props.
+ *
+ * @param document - the story document.
+ * @param style - colours, glyphs and width.
+ */
+export const storyText = (document, style) => {
+    const entries = [
+        ["Story", `${document.component.title} › ${document.story.name}`],
+        ["Id", document.story.id],
+        ["File", document.component.file],
+        ["Opens at", document.story.links.address],
+        ["Frame", document.story.links.frame],
+        ["Args", JSON.stringify(document.args)],
+        ["Props", document.docs === undefined ? "none" : document.docs.props.map((prop) => prop.name).join(", ")]
+    ];
+    if (document.story.description !== undefined)
+        entries.push(["About", document.story.description]);
+    return keyValue(entries, uncut(style));
+};
+//# sourceMappingURL=agentText.js.map

package/dist/bin/forgebook/agentText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentText.js","sourceRoot":"","sources":["../../../bin/forgebook/agentText.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAK1D,yDAAyD;AACzD,MAAM,KAAK,GAAG,CAAC,KAAkB,EAAe,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAEnG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAyB,EAAE,KAAkB,EAAU,EAAE,CACnF,KAAK,CACH,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CACxC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE;IACR,GAAG,SAAS,CAAC,KAAK,MAAM,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE;CAC7E,CAAC,CACH,EACD,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,EACnE,KAAK,CAAC,KAAK,CAAC,CACb,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAuB,EAAE,KAAkB,EAAU,EAAE;IAC/E,MAAM,OAAO,GAAkC;QAC7C,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACjE,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;QACjC,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;QAC1C,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;QACrC,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC1G,CAAC;IACF,IAAI,QAAQ,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAClG,OAAO,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC"}

package/dist/bin/forgebook/forgebook.mjs

@@ -1,15 +1,25 @@
 #!/usr/bin/env node
 /**
  * The `forgebook` command: runs a catalogue from its `forgebook.config.ts` (`dev`, the dev server) or builds it into
- * static files (`build`), with no page or Vite configuration of the app's own.
+ * static files (`build`), with no page or Vite configuration of the app's own; and answers tools and agents
+ * (`stories`, `story`) with what the catalogue shows.
  *
  * @module
  */
 import { resolve } from "node:path";
-import { defineScript, ScriptError } from "@ensiria/cli-kit/script";
+import { createInterface } from "node:readline";
+import { defineCommands } from "@ensiria/cli-kit/commands";
+import { EXIT } from "@ensiria/cli-kit/constants";
+import { formatJson, readPackageVersion } from "@ensiria/cli-kit/files";
+import { ScriptError } from "@ensiria/cli-kit/script";
 import { build, createServer } from "vite";
+import { filteredStories, isStoriesDocument, isStoryDocument } from "../../src/vite/agentApi.js";
 import { CONFIG_FILES, findConfigFile, loadConfigFile } from "../../src/vite/configFile.js";
+import { answerMcpMessage, NEW_SESSION } from "../../src/vite/mcpProtocol.js";
+import { catalogueClient } from "./agentClient.js";
+import { storiesText, storyText } from "./agentText.js";
 import { catalogueVite } from "./catalogueVite.js";
+import { catalogueTools } from "./mcpTools.js";
 /** The command, as the hints print it. */
 const COMMAND = "forgebook";
 /**
@@ -31,63 +41,232 @@ const configOf = async (file) => {
         throw new ScriptError(error instanceof Error ? error.message : String(error));
     }
 };
-await defineScript({
+/**
+ * Asks the catalogue one of its answers, from its running dev server or one started for the answer.
+ *
+ * @param config - the catalogue's configuration.
+ * @param url - where `forgebook dev` runs, when not at Vite's default address.
+ * @param route - the answer (`stories`, `story`).
+ * @param params - its query.
+ * @param log - where to say where the answer comes from.
+ * @throws a `ScriptError` when the catalogue answers with an error.
+ */
+const askCatalogue = async (config, url, route, params, log) => {
+    const client = await catalogueClient(config, url);
+    log.debug(client.runningAt === undefined
+        ? "No catalogue running: answered by a server of its own"
+        : `Asked ${client.runningAt}`);
+    let answer;
+    try {
+        answer = await client.ask(route, params);
+    }
+    finally {
+        await client.close();
+    }
+    if (answer.status !== 200) {
+        const { body } = answer;
+        const message = typeof body === "object" && body !== null && "error" in body && typeof body.error === "string"
+            ? body.error
+            : `The catalogue answered ${answer.status}`;
+        throw new ScriptError(message);
+    }
+    return answer.body;
+};
+/**
+ * Prints an answer, its JSON with `--json`, its problems as warnings, and ends with a failure when it has problems,
+ * so a CI step fails on a broken story file.
+ *
+ * @param text - the answer as text for a terminal.
+ * @param document - the answer as data.
+ * @param problems - what is wrong in it.
+ * @param context - the run's io, logger and `--json` mode.
+ * @throws a reported `ScriptError` when there are problems.
+ */
+const printAnswer = (text, document, problems, context) => {
+    context.io.stdout.write(context.isJson ? formatJson(document) : `${text}\n`);
+    for (const problem of problems)
+        context.log.warn(problem);
+    if (problems.length > 0)
+        throw new ScriptError(`${problems.length} problems`, { exitCode: EXIT.failure, isReported: true });
+};
+await defineCommands({
     name: "forgebook",
     command: COMMAND,
-    summary: "Run a catalogue of stories from its forgebook.config.ts, or build it into static files.",
+    summary: "Run a catalogue of stories from its forgebook.config.ts, build it, or answer tools and agents about it.",
     icon: "docs",
     options: {
         config: {
             type: "string",
             valueName: "file",
             description: "The configuration file; forgebook.config.ts in the current folder by default."
-        },
-        port: {
-            type: "string",
-            valueName: "number",
-            description: "dev: the port to listen on; Vite's by default."
-        },
-        host: {
-            type: "string",
-            valueName: "address",
-            description: "dev: the address to listen on; localhost by default."
-        },
-        out: { type: "string", valueName: "folder", description: "build: the folder to write; dist by default." },
-        force: {
-            type: "boolean",
-            description: "dev: pre-bundle the dependencies again, ignoring Vite's cache (as a first start does)."
         }
     },
-    positionals: [{ name: "command", description: "What to do.", required: true, choices: ["dev", "build"] }],
-    examples: [
-        { command: `${COMMAND} dev`, description: "Run the catalogue of the folder you are in." },
-        { command: `${COMMAND} dev --port 6006`, description: "On a given port." },
-        { command: `${COMMAND} build --out site`, description: "Build it into static files." }
-    ],
-    run: async ({ args, options, log, onInterrupt }) => {
-        const config = await configOf(options.config);
-        if (args.command === "build") {
-            await build(await catalogueVite(config, { build: { outDir: resolve(config.dir, options.out ?? "dist") } }));
-            log.success(`${config.title} built`);
-            return;
-        }
-        const port = options.port === undefined ? undefined : Number(options.port);
-        if (port !== undefined && !Number.isInteger(port))
-            throw new ScriptError(`--port ${options.port} is not a port`);
-        const server = await createServer(await catalogueVite(config, {
-            server: {
-                ...(port === undefined ? {} : { port, strictPort: true }),
-                ...(options.host === undefined ? {} : { host: options.host })
+    commands: (forgebook) => ({
+        dev: forgebook.command({
+            summary: "Run the catalogue's dev server.",
+            options: {
+                port: {
+                    type: "string",
+                    valueName: "number",
+                    description: "The port to listen on; Vite's by default."
+                },
+                host: {
+                    type: "string",
+                    valueName: "address",
+                    description: "The address to listen on; localhost by default."
+                },
+                force: {
+                    type: "boolean",
+                    description: "Pre-bundle the dependencies again, ignoring Vite's cache (as a first start does)."
+                }
             },
-            ...(options.force === true ? { optimizeDeps: { force: true } } : {})
-        }));
-        await server.listen();
-        server.printUrls();
-        await new Promise((done) => {
-            onInterrupt(() => {
-                void server.close().then(done);
-            });
-        });
-    }
+            examples: [
+                { command: `${COMMAND} dev`, description: "Run the catalogue of the folder you are in." },
+                { command: `${COMMAND} dev --port 6006`, description: "On a given port." }
+            ],
+            run: async ({ options, onInterrupt }) => {
+                const config = await configOf(options.config);
+                const port = options.port === undefined ? undefined : Number(options.port);
+                if (port !== undefined && !Number.isInteger(port))
+                    throw new ScriptError(`--port ${options.port} is not a port`);
+                const server = await createServer(await catalogueVite(config, {
+                    server: {
+                        ...(port === undefined ? {} : { port, strictPort: true }),
+                        ...(options.host === undefined ? {} : { host: options.host })
+                    },
+                    ...(options.force === true ? { optimizeDeps: { force: true } } : {})
+                }));
+                await server.listen();
+                server.printUrls();
+                await new Promise((done) => {
+                    onInterrupt(() => {
+                        void server.close().then(done);
+                    });
+                });
+            }
+        }),
+        build: forgebook.command({
+            summary: "Build the catalogue into static files.",
+            options: {
+                out: { type: "string", valueName: "folder", description: "The folder to write; dist by default." }
+            },
+            examples: [{ command: `${COMMAND} build --out site`, description: "Build it into static files." }],
+            run: async ({ options, log }) => {
+                const config = await configOf(options.config);
+                await build(await catalogueVite(config, { build: { outDir: resolve(config.dir, options.out ?? "dist") } }));
+                log.success(`${config.title} built`);
+            }
+        }),
+        stories: forgebook.command({
+            summary: "List the catalogue's stories, with their ids and links; fail when the index has problems.",
+            json: true,
+            options: {
+                source: { type: "string", valueName: "id", description: "Only this source's stories." },
+                component: {
+                    type: "string",
+                    valueName: "text",
+                    description: "Only components whose title holds this text."
+                },
+                view: {
+                    type: "string",
+                    valueName: "query",
+                    description: "The view the links open in, as the catalogue's address writes it (theme=dark&lang=it)."
+                },
+                url: {
+                    type: "string",
+                    env: "FORGEBOOK_URL",
+                    valueName: "address",
+                    description: "Where forgebook dev runs, when not at Vite's default address (http://localhost:5173)."
+                }
+            },
+            examples: [
+                { command: `${COMMAND} stories`, description: "Every story." },
+                { command: `${COMMAND} stories --component button --json`, description: "The buttons, as JSON." }
+            ],
+            run: async ({ options, io, log, isJson, style }) => {
+                const config = await configOf(options.config);
+                const params = new URLSearchParams({ view: options.view ?? "" });
+                const body = await askCatalogue(config, options.url, "stories", params, log);
+                if (!isStoriesDocument(body))
+                    throw new ScriptError("The catalogue's answer has an unexpected shape");
+                const document = filteredStories(body, { source: options.source, component: options.component });
+                printAnswer(storiesText(document, style), document, document.problems, { io, log, isJson });
+            }
+        }),
+        mcp: forgebook.command({
+            summary: "Serve the catalogue's stories to an agent over the Model Context Protocol, on stdin and stdout.",
+            header: false,
+            options: {
+                url: {
+                    type: "string",
+                    env: "FORGEBOOK_URL",
+                    valueName: "address",
+                    description: "Where forgebook dev runs, when not at Vite's default address (http://localhost:5173)."
+                }
+            },
+            examples: [
+                {
+                    command: `${COMMAND} mcp`,
+                    description: "What an agent's MCP configuration runs (npx forgebook mcp)."
+                }
+            ],
+            run: async ({ options, io, log }) => {
+                const config = await configOf(options.config);
+                // kept for the server's life: an agent's questions in a row each answer at once
+                const client = await catalogueClient(config, options.url);
+                log.debug(client.runningAt === undefined ? "Answering from a server of its own" : `Asking ${client.runningAt}`);
+                const server = {
+                    info: { name: "forgebook", version: readPackageVersion(import.meta.dirname) },
+                    instructions: `The stories of the Forgebook catalogue "${config.title}". list_stories finds a story's id, get_story gives its args and its component's props, story_address gives the links a person opens to see it.`,
+                    tools: catalogueTools(client.ask)
+                };
+                let session = NEW_SESSION;
+                // stdout carries only the protocol's messages, one per line, answered in the order they came
+                for await (const line of createInterface({ input: io.stdin })) {
+                    if (line.trim() === "")
+                        continue;
+                    const step = await answerMcpMessage(line, session, server);
+                    session = step.session;
+                    if (step.reply !== undefined)
+                        io.stdout.write(`${step.reply}\n`);
+                }
+                await client.close();
+            }
+        }),
+        story: forgebook.command({
+            summary: "One story in detail: its args, its component's props, its links; fail when it cannot be read.",
+            json: true,
+            options: {
+                view: {
+                    type: "string",
+                    valueName: "query",
+                    description: "The view the links open in, as the catalogue's address writes it (theme=dark&lang=it)."
+                },
+                url: {
+                    type: "string",
+                    env: "FORGEBOOK_URL",
+                    valueName: "address",
+                    description: "Where forgebook dev runs, when not at Vite's default address (http://localhost:5173)."
+                }
+            },
+            positionals: [
+                { name: "id", description: "The story's id, as forgebook stories lists it.", required: true }
+            ],
+            examples: [
+                {
+                    command: `${COMMAND} story kit:actions-button--primary --view theme=dark --json`,
+                    description: "A story, its links in the dark theme, as JSON."
+                }
+            ],
+            run: async ({ args, options, io, log, isJson, style }) => {
+                const config = await configOf(options.config);
+                const params = new URLSearchParams({ id: args.id, view: options.view ?? "" });
+                const body = await askCatalogue(config, options.url, "story", params, log);
+                if (!isStoryDocument(body))
+                    throw new ScriptError("The catalogue's answer has an unexpected shape");
+                printAnswer(storyText(body, style), body, body.problems, { io, log, isJson });
+            }
+        })
+    })
 }).run();
 //# sourceMappingURL=forgebook.mjs.map

package/dist/bin/forgebook/forgebook.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"forgebook.mjs","sourceRoot":"","sources":["../../../bin/forgebook/forgebook.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"forgebook.mjs","sourceRoot":"","sources":["../../../bin/forgebook/forgebook.mts"],"names":[],"mappings":"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"}

package/dist/bin/forgebook/mcpTools.d.ts

@@ -0,0 +1,12 @@
+import type { AgentAnswer } from "../../src/vite/agentRoutes.ts";
+import type { McpTool } from "../../src/vite/mcpProtocol.ts";
+/** Asks the catalogue one of its answers. */
+type Ask = (route: string, params: URLSearchParams) => Promise<AgentAnswer>;
+/**
+ * The tools, asking the catalogue through `ask`.
+ *
+ * @param ask - asks the catalogue (the running dev server, or the server `forgebook mcp` keeps).
+ */
+export declare const catalogueTools: (ask: Ask) => readonly McpTool[];
+export {};
+//# sourceMappingURL=mcpTools.d.ts.map

package/dist/bin/forgebook/mcpTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpTools.d.ts","sourceRoot":"","sources":["../../../bin/forgebook/mcpTools.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,+BAA+B,CAAC;AAE5E,6CAA6C;AAC7C,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAqB5E;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,GAAG,KAAG,SAAS,OAAO,EAmEzD,CAAC"}