forgebook 0.1.3 → 0.1.5

package/README.md

@@ -84,23 +84,90 @@ Badge's page shows its stories, each in its own frame, and an API table read fro
 ## What a catalogue gives you
 
 - **One frame per story**, so a story's styles and globals never leak into another, and its address opens it alone.
-- **Switches** in the toolbar for theme, contrast and motion, and the languages you declare; a library adds its own
-  (density, brand) through a preset.
+- **Switches** for theme, contrast and motion, and the languages you declare; a library adds its own (density, brand)
+  through a preset. A direction switch draws every story right to left, and a language declared `dir: "rtl"` does
+  it by itself.
+- **A toolbar each reader arranges**: whoever uses the catalogue pins the controls they use to the toolbar, orders
+  them and hides the rest in the View menu; their browser keeps it ([below](#the-toolbar)).
+- **A light and a dark catalogue**: the reader picks Light, Dark or System at the sidebar's foot (their browser keeps
+  it); `appearance` in the configuration sets the default. The stories keep their own theme, from the view's switches.
+- **Keys and named views**: a key cycles a control's values (`t` the theme, Shift+`t` back); the catalogue sets the
+  key of any control (`keys: { width: "w" }`), a reader changes theirs in the View menu. The View menu's values are
+  saved under a name and picked again; `views` in the configuration offers some to every reader. A dot marks each
+  control whose value is not its default.
+- **Touch on the computer**: the Touch switch turns the mouse into a finger for the stories, two with Shift
+  ([below](#touch)); `forgebook dev --touch` opens Chromium with its real touch emulation.
 - **Widths** to draw a story at, and a **compare** view that draws the same story once per value of one or two
   switches (every theme at both contrasts), per text size or per style sheet, side by side.
 - **Props from the types**: the API table and the panel's controls come from the component's TypeScript props and
   their TSDoc, nothing written twice.
+- **The worst case in one press**: the Props tab's Worst case button gives every text prop a long text with a word too
+  long to break and every number a huge one, kept in the address; the elements that then spill out of their parents
+  are outlined and counted, as the browser tests find them. Reset undoes it.
+- **Examples that fill the page**: on a component's page, any story's box opens over the page, at a width of its own,
+  without loading its story again.
+- **Used in**: a component's page lists the other components whose stories use it, directly or through another
+  component (Tree renders Row, Row renders DropLine), each with the stories to open; read from the types, never kept
+  by hand. A reader folds it away; `usedIn: false` in the configuration turns it off.
 - **Interaction states and motion**: `:hover`, `:active`, `:focus`, `:focus-visible` and `:focus-within` forced on a
   story without a pointer; motion replayed on demand.
 - **Packages as sources**: a library ships its stories (`StorySource`), and an app's catalogue lists them beside its
   own, each with its name, logo and texts.
-- **`CATALOG.md`** for coding agents: `forgebook-docs` writes one dense line per component, hook and helper of a
+- **`CATALOG.md`** for coding agents: `forgebook docs` writes one dense line per component, hook and helper of a
   package, from its exports, their TSDoc and its stories.
 - **Tests from the stories**, with [`@forgebook/testing`](https://www.npmjs.com/package/@forgebook/testing): every
   story in the browser with axe, spills and overlays, screenshots, and every story rendered on the server.
 
 It adds about a dozen packages to a React and Vite project.
 
+## The toolbar
+
+The View menu holds every control: the catalogue's switches, and Forgebook's own (the background, the style sheets, the
+text size, the story's width). The catalogue says which start on the toolbar and which it does without; each reader
+then pins, orders and hides them, and that arrangement stays in their browser, per catalogue, never in the address
+(a link shares the values, not someone's toolbar).
+
+```ts
+// forgebook.config.ts
+export default defineConfig({
+  framework: react(),
+  title: "My components",
+  stories: ["src/**/*.stories.tsx"],
+  // what starts on the toolbar, in this order: a switch's id, or "backdrop", "sheets", "text", "width"
+  toolbar: ["theme", "contrast", "width", "text"],
+  // Forgebook's own controls this catalogue does without (direction: false drops the direction switch)
+  controls: { sheets: false }
+});
+```
+
+Without `toolbar`, the colour scheme, the contrast and the width start there. A control turned off in `controls`
+shows nowhere, not even on the toolbar, and keeps its default (the width can still be dragged on the stage). A preset
+may set both; the catalogue's `toolbar` wins, and a control is off when any of them turns it off. A name in `toolbar`
+that is no control at all stops the catalogue with an error saying which.
+
+## Touch
+
+The Touch switch (in View, `m` by default) lets a story be tried as on a phone, from the computer:
+
+- the story receives a finger's events: `pointerdown`/`move`/`up` of the `touch` type and, in Chromium,
+  `touchstart`/`move`/`end`; a tap clicks, a press held half a second opens the context menu;
+- its CSS answers as a phone's: `(hover: none)` and `(pointer: coarse)` match, the mouse's `:hover` does not;
+  `navigator.maxTouchPoints` says 5;
+- the cursor is a round dot; Shift fixes a centre, and a press then puts a second finger mirrored around it, so a drag
+  pinches and rotates;
+- a drag scrolls what it can, as the `touch-action` on the way allows, and flings on.
+
+A story reads the switch in its globals (`context.globals.touch`, `"mouse"` or `"touch"`) to draw only the version
+that fits the pointer, and follows the switch live; a story fixes it with `globals: { touch: "touch" }`.
+
+**It is a simulation.** Events made by a page are not trusted, so the browser's own reactions do not follow them:
+its native scrolling (the drag's scrolling is an approximation, without the rubber band), focus and selection from a
+touch, and `touch-action` applied by the browser. In Safari and Firefox the stories get pointer events only (only
+Chromium lets a page build touch events). A virtual keyboard, the viewport shrinking under it, safe areas and real iOS
+Safari need a device. For real touch events and native scrolling, `forgebook dev --touch` opens the catalogue in a
+Chromium window with Chromium's own touch emulation (it needs `@forgebook/testing` and Playwright, as `check` does).
+`controls: { touch: false }` takes the switch away.
+
 ## Coming from Storybook
 
 Forgebook reads Storybook's story files as they are: CSF 3 and CSF 2 (`Template.bind({})`), titles of any depth and
@@ -111,6 +178,13 @@ titles from the file's path, `args` and `argTypes` (with their controls), action
 It does not read MDX, doc blocks or addons. Actions are explicit only: an `on*` prop is not turned into an action by
 its name.
 
+To try it on a Storybook project, run `npx forgebook init --from storybook` in the folder that holds `.storybook`. It
+writes `forgebook.config.ts`: the story globs of `main` (the MDX pages left out), the preview as Forgebook's preview,
+and a switch for each toolbar global of the preview, applied by code as its decorators expect. `main` is loaded, so a
+computed `stories` list is read too; the preview is read from its source, so only `globalTypes` written as plain values
+become switches. It reads React on Vite (`@storybook/react-vite`) only, never replaces a configuration without
+`--force`, and lists what it left out.
+
 ## Commands
 
 | Command | What it does |
@@ -118,14 +192,24 @@ its name.
 | `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 init --from storybook` | Writes `forgebook.config.ts` from a project's `.storybook` folder: its story globs, preview and toolbar globals |
+| `forgebook new <file>` | Writes a component's first stories from its props: the main story, one per choice, the worst case |
+| `forgebook check <id>` | Runs the catalogue's browser checks on a story (or a component's stories): accessibility, spills, overlays, errors; with `@forgebook/testing` |
+| `forgebook errors` | Lists what the open frames reported while you edited (a story that could not be shown, a failed play); `--follow` keeps listing |
+| `forgebook shot <id>` | Takes a story's pictures, one PNG per view, at the view's width and the story's height; with `@forgebook/testing` |
 | `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 agents` | Adds Forgebook's instructions to the project's `AGENTS.md` (and a Claude Code skill with `--skill`) |
+| `forgebook docs` | Writes a package's `CATALOG.md` and `llms.txt` 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`; `stories` and `story` print JSON with `--json`.
 
 ## For agents
 
+`forgebook agents` gives a project's coding agents what they need without being told: how to write a story file here,
+and the commands that check one, as a section of `AGENTS.md` (renewed in place when it runs again; `--skill` writes
+the same as a Claude Code skill).
+
 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:
@@ -134,12 +218,21 @@ example `.mcp.json` for Claude Code:
 { "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
+It offers seven tools: `list_stories`, `get_story`, `story_address`, `new_stories`, which writes a component's first stories from its props and answers the text without writing a file, `check_story`, which runs the catalogue's browser checks on a story and answers its problems (the project needs `@forgebook/testing` and Playwright for it), `recent_errors`, what the frames open in a browser reported while the agent edited (numbered: `since` gives only the new ones), and `story_shot`, a story's pictures in the answer itself, so the agent looks at what it made. `check`, `shot` and their tools take a view in the address's form (`theme=dark&width=360`) or as words (`"dark it 360"`). `get_story` also gives the components whose stories use the story's component (`usedIn`), so an agent finds a real use before writing one; `list_stories` gives it for every component when asked (`usedIn: true`, or `forgebook stories --used-in`), since it reads the package's import graph. 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),
+A library tells agents what it offers with `forgebook docs`, run in its folder: `CATALOG.md`, one dense line per
+component, hook, helper and style module (what it is, how to import it, its props, the id of a story that shows it),
+and `llms.txt`, which points an agent to it. The file's name, its sections and the subpaths left out are set in the
+package's `package.json`:
+
+```json
+{ "forgebook": { "catalog": { "file": "CATALOG.md", "sections": ["components", "modules"], "exclude": ["./internal/*"] } } }
+```
+
+`forgebook docs --check` fails in CI when either file is stale. 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

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

@@ -11,6 +11,23 @@ export type CatalogueClient = {
     /** Stops the server it started; nothing for a running one. */
     readonly close: () => Promise<void>;
 };
+/** A catalogue a browser can open: its address, and how to let it go. */
+export type ServedCatalogue = {
+    /** Its address (`http://localhost:5173`). */
+    readonly origin: string;
+    /** Where it was already running, or none for a server started for the command. */
+    readonly runningAt: string | undefined;
+    /** Stops the server it started; nothing for a running one. */
+    readonly close: () => Promise<void>;
+};
+/**
+ * The catalogue served over HTTP, for a browser to open its frames: the running dev server at the address when it
+ * serves this catalogue, else a dev server of its own on a free port (its answers' middleware has no address).
+ *
+ * @param config - the catalogue's configuration.
+ * @param url - where `forgebook dev` runs, when not at Vite's default address.
+ */
+export declare const servedCatalogue: (config: ResolvedConfig, url: string | undefined) => Promise<ServedCatalogue>;
 /**
  * The catalogue's answers: the running dev server at the address when it serves this catalogue, a server of its own
  * otherwise.

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

@@ -1 +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"}
+{"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,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,cAAc,EACtB,KAAK,MAAM,GAAG,SAAS,KACtB,OAAO,CAAC,eAAe,CAczB,CAAC;AAEF;;;;;;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

@@ -56,6 +56,27 @@ const ownClient = async (config, origin) => {
         close: () => server.close()
     };
 };
+/**
+ * The catalogue served over HTTP, for a browser to open its frames: the running dev server at the address when it
+ * serves this catalogue, else a dev server of its own on a free port (its answers' middleware has no address).
+ *
+ * @param config - the catalogue's configuration.
+ * @param url - where `forgebook dev` runs, when not at Vite's default address.
+ */
+export const servedCatalogue = async (config, url) => {
+    const origin = (url ?? DEFAULT_ORIGIN).replace(/\/+$/, "");
+    const running = await runningClient(origin, config);
+    if (running !== undefined)
+        return { origin, runningAt: origin, close: async () => undefined };
+    const server = await createServer(await catalogueVite(config, { server: { port: 0, host: "127.0.0.1" }, logLevel: "error" }));
+    await server.listen();
+    const address = server.resolvedUrls?.local[0]?.replace(/\/+$/, "");
+    if (address === undefined) {
+        await server.close();
+        throw new Error("The catalogue's dev server started with no address");
+    }
+    return { origin: address, 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.

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

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

package/dist/bin/forgebook/agentLoopCommands.d.mts

@@ -0,0 +1,9 @@
+import type { CommandNode, CommandScope } from "@ensiria/cli-kit/commands.types";
+import { type ForgebookOptions } from "./catalogueCommands.ts";
+/**
+ * The commands.
+ *
+ * @param forgebook - the scope of the `forgebook` command, whose options every command takes.
+ */
+export declare const agentLoopCommands: (forgebook: CommandScope<ForgebookOptions>) => Readonly<Record<string, CommandNode>>;
+//# sourceMappingURL=agentLoopCommands.d.mts.map

package/dist/bin/forgebook/agentLoopCommands.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentLoopCommands.d.mts","sourceRoot":"","sources":["../../../bin/forgebook/agentLoopCommands.mts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAQjF,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAIlF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,YAAY,CAAC,gBAAgB,CAAC,KACxC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAoMrC,CAAC"}

package/dist/bin/forgebook/agentLoopCommands.mjs

@@ -0,0 +1,217 @@
+/**
+ * The commands of an agent's loop besides the answers: `agents` (the instructions a project's agents read), `check`
+ * (the catalogue's checks on a story, in a browser), `errors` (what the open frames reported while it edited), `shot`
+ * (a story's pictures, to look at it).
+ *
+ * @remarks
+ * Defined here, on the scope `forgebook.mts` hands them, so the entry stays a list of commands; their work lives in
+ * their own modules (`agentsText.ts`, `storyCheckRun.ts`, `errorsRun.ts`).
+ *
+ * @module
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, relative, resolve } from "node:path";
+import { EXIT } from "@ensiria/cli-kit/constants";
+import { formatJson } from "@ensiria/cli-kit/files";
+import { ScriptError } from "@ensiria/cli-kit/script";
+import { catalogueClient } from "./agentClient.js";
+import { agentsSkill, withAgentsSection } from "./agentsText.js";
+import { checkText, errorsOutput, shotText } from "./agentText.js";
+import { COMMAND, configOf } from "./catalogueCommands.js";
+import { askErrors, followErrors, sinceOf } from "./errorsRun.js";
+import { runStoryCheck, runStoryShot } from "./storyCheckRun.js";
+/**
+ * The commands.
+ *
+ * @param forgebook - the scope of the `forgebook` command, whose options every command takes.
+ */
+export const agentLoopCommands = (forgebook) => ({
+    check: forgebook.command({
+        summary: "Run the catalogue's checks on a story in a browser: accessibility, spills, overlays, errors.",
+        json: true,
+        options: {
+            view: {
+                type: "string",
+                multiple: true,
+                valueName: "query",
+                description: "A view to check it in, as the catalogue's address writes it (theme=dark&width=360); the default view when none."
+            },
+            "all-variants": {
+                type: "boolean",
+                description: "Check every variant the catalogue's browser tests check."
+            },
+            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: "A story's id, or a component's for its listed stories.", required: true }
+        ],
+        examples: [
+            {
+                command: `${COMMAND} check kit:inputs-select--overview`,
+                description: "One story, in the default view."
+            },
+            {
+                command: `${COMMAND} check kit:inputs-select --view "theme=dark" --json`,
+                description: "Every story of a component, in the dark theme, as JSON."
+            }
+        ],
+        run: async ({ args, options, io, isJson, style }) => {
+            const config = await configOf(options.config);
+            const report = await runStoryCheck(config, options.url, {
+                id: args.id,
+                views: options.view ?? [],
+                isAllVariants: options["all-variants"] === true
+            });
+            if (typeof report === "string")
+                throw new ScriptError(report);
+            io.stdout.write(isJson ? formatJson(report) : `${checkText(report, style)}\n`);
+            const problems = report.results.reduce((count, result) => count + result.problems.length, 0);
+            if (problems > 0)
+                throw new ScriptError(`${problems} problems`, { exitCode: EXIT.failure, isReported: true });
+        }
+    }),
+    errors: forgebook.command({
+        summary: "List what the open frames reported while you edited: stories that could not be shown, plays that failed.",
+        json: true,
+        options: {
+            since: {
+                type: "string",
+                valueName: "n",
+                description: "Only the errors after this number (the last answer's `last`)."
+            },
+            follow: { type: "boolean", description: "Keep listing new errors as they come, until stopped." },
+            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} errors --json`,
+                description: "The errors so far, and the story index's problems."
+            },
+            { command: `${COMMAND} errors --follow`, description: "New errors as you edit." }
+        ],
+        run: async ({ options, io, log, isJson, style }) => {
+            const config = await configOf(options.config);
+            const client = await catalogueClient(config, options.url);
+            if (client.runningAt === undefined)
+                log.warn("No catalogue running there: only frames open in a browser report, so there is nothing to list");
+            const since = sinceOf(options.since);
+            try {
+                if (options.follow === true) {
+                    // each new error once, as it comes: one JSON line each with --json
+                    const stopped = await followErrors(client.ask, since, (document) => io.stdout.write(errorsOutput(document, { isJson, isFollowing: true }, style)));
+                    if (stopped !== undefined)
+                        throw new ScriptError(stopped);
+                    return;
+                }
+                const document = await askErrors(client.ask, since);
+                if (typeof document === "string")
+                    throw new ScriptError(document);
+                io.stdout.write(errorsOutput(document, { isJson, isFollowing: false }, style));
+                for (const problem of document.problems)
+                    log.warn(problem);
+                const count = document.errors.length + document.problems.length;
+                if (count > 0)
+                    throw new ScriptError(`${count} errors and problems`, { exitCode: EXIT.failure, isReported: true });
+            }
+            finally {
+                await client.close();
+            }
+        }
+    }),
+    shot: forgebook.command({
+        summary: "Take a story's pictures in a browser, one PNG per view, to look at it.",
+        json: true,
+        options: {
+            view: {
+                type: "string",
+                multiple: true,
+                valueName: "view",
+                description: 'A view to picture it in: the address\'s form (theme=dark&width=360) or words ("dark it 360"); the default view when none.'
+            },
+            "all-variants": {
+                type: "boolean",
+                description: "Picture every variant the catalogue's browser tests check."
+            },
+            out: {
+                type: "string",
+                default: "forgebook-shots",
+                valueName: "folder",
+                description: "The folder the pictures go in."
+            },
+            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: "A story's id, or a component's for its listed stories.", required: true }
+        ],
+        examples: [
+            {
+                command: `${COMMAND} shot kit:data-badge--default --view "dark 360"`,
+                description: "Dark, 360 px wide."
+            },
+            {
+                command: `${COMMAND} shot kit:data-badge --all-variants --json`,
+                description: "Every story of a component in every variant, listed as JSON."
+            }
+        ],
+        run: async ({ args, options, io, isJson, style }) => {
+            const config = await configOf(options.config);
+            const report = await runStoryShot(config, options.url, { id: args.id, views: options.view ?? [], isAllVariants: options["all-variants"] === true }, resolve(options.out));
+            if (typeof report === "string")
+                throw new ScriptError(report);
+            io.stdout.write(isJson ? formatJson(report) : `${shotText(report, (file) => relative(process.cwd(), file), style)}\n`);
+        }
+    }),
+    agents: forgebook.command({
+        summary: "Add Forgebook's instructions for coding agents to the project's AGENTS.md: how to write and check stories.",
+        options: {
+            file: {
+                type: "string",
+                default: "AGENTS.md",
+                valueName: "path",
+                description: "The file the instructions go in; its other sections are left as they are."
+            },
+            skill: {
+                type: "boolean",
+                description: "Also write them as a Claude Code skill, .claude/skills/forgebook/SKILL.md."
+            },
+            print: { type: "boolean", description: "Print the instructions instead of writing them." }
+        },
+        examples: [
+            { command: `${COMMAND} agents`, description: "Add or renew Forgebook's section of AGENTS.md." },
+            { command: `${COMMAND} agents --skill`, description: "And the Claude Code skill." }
+        ],
+        run: ({ options, io, log }) => {
+            const section = readFileSync(new URL("./agents.md", import.meta.url), "utf8");
+            if (options.print) {
+                io.stdout.write(section);
+                return;
+            }
+            const file = resolve(options.file);
+            const isNew = !existsSync(file);
+            writeFileSync(file, withAgentsSection(isNew ? undefined : readFileSync(file, "utf8"), section));
+            log.success(`${relative(process.cwd(), file)}: Forgebook's section ${isNew ? "written" : "renewed"}`);
+            if (options.skill !== true)
+                return;
+            const skill = resolve(".claude", "skills", "forgebook", "SKILL.md");
+            mkdirSync(dirname(skill), { recursive: true });
+            writeFileSync(skill, agentsSkill(section));
+            log.success(`${relative(process.cwd(), skill)} written`);
+        }
+    })
+});
+//# sourceMappingURL=agentLoopCommands.mjs.map

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

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

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

@@ -1,5 +1,6 @@
 import type { OutputStyle } from "@ensiria/cli-kit/log.types";
-import type { StoriesDocument, StoryDocument } from "../../src/vite/agent.types.ts";
+import type { StoryCheckReport, StoryShotReport } from "../../src/storyCheck.ts";
+import type { ErrorsDocument, 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.
@@ -15,4 +16,39 @@ export declare const storiesText: (document: StoriesDocument, style: OutputStyle
  * @param style - colours, glyphs and width.
  */
 export declare const storyText: (document: StoryDocument, style: OutputStyle) => string;
+/**
+ * A check's report as a table: one row per problem, its story, its view and its kind; a story that passes in a view gets
+ * one row saying so.
+ *
+ * @param report - the check's report.
+ * @param style - colours, glyphs and width.
+ */
+export declare const checkText: (report: StoryCheckReport, style: OutputStyle) => string;
+/**
+ * The frames' errors as a table: their number, the story, what went wrong; nothing when there are none.
+ *
+ * @param document - the errors document.
+ * @param style - colours, glyphs and width.
+ */
+export declare const errorsText: (document: ErrorsDocument, style: OutputStyle) => string;
+/**
+ * What `forgebook errors` prints of an answer: its JSON (one line per error while following, so each can be read as it
+ * comes), or its table.
+ *
+ * @param document - the errors document.
+ * @param mode - whether as JSON, and whether following.
+ * @param style - colours, glyphs and width.
+ */
+export declare const errorsOutput: (document: ErrorsDocument, mode: {
+    readonly isJson: boolean;
+    readonly isFollowing: boolean;
+}, style: OutputStyle) => string;
+/**
+ * The pictures taken as a table: the story, the view, the file.
+ *
+ * @param report - the picture run's report.
+ * @param shownFile - how a file is written for the reader (relative to where the command runs).
+ * @param style - colours, glyphs and width.
+ */
+export declare const shotText: (report: StoryShotReport, shownFile: (file: string) => string, style: OutputStyle) => string;
 //# sourceMappingURL=agentText.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"agentText.d.ts","sourceRoot":"","sources":["../../../bin/forgebook/agentText.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAKpG;;;;;;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;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,gBAAgB,EAAE,OAAO,WAAW,KAAG,MAatE,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,cAAc,EAAE,OAAO,WAAW,KAAG,MAOnE,CAAC;AAER;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,cAAc,EACxB,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAAE,EACjE,OAAO,WAAW,KACjB,MAIF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GACnB,QAAQ,eAAe,EACvB,WAAW,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACnC,OAAO,WAAW,KACjB,MAKA,CAAC"}

package/dist/bin/forgebook/agentText.js

@@ -1,12 +1,13 @@
 /**
- * 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.
+ * The answers of `forgebook stories`, `forgebook story`, `forgebook check` and `forgebook errors` as text for a
+ * terminal: a table of the stories, one story's facts, a check's problems, the frames' errors, the pictures taken. 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 { formatJson } from "@ensiria/cli-kit/files";
 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 });
@@ -41,4 +42,50 @@ export const storyText = (document, style) => {
         entries.push(["About", document.story.description]);
     return keyValue(entries, uncut(style));
 };
+/**
+ * A check's report as a table: one row per problem, its story, its view and its kind; a story that passes in a view gets
+ * one row saying so.
+ *
+ * @param report - the check's report.
+ * @param style - colours, glyphs and width.
+ */
+export const checkText = (report, style) => table(report.results.flatMap((result) => result.problems.length === 0
+    ? [[result.storyId, result.view || "default", "passes"]]
+    : result.problems.map((problem) => [
+        result.storyId,
+        result.view || "default",
+        `${problem.kind}: ${problem.message}`
+    ])), { columns: [{ header: "Story" }, { header: "View", tone: "muted" }, { header: "Result" }] }, uncut(style));
+/**
+ * The frames' errors as a table: their number, the story, what went wrong; nothing when there are none.
+ *
+ * @param document - the errors document.
+ * @param style - colours, glyphs and width.
+ */
+export const errorsText = (document, style) => document.errors.length === 0
+    ? ""
+    : table(document.errors.map((error) => [String(error.n), error.storyId, `${error.kind}: ${error.message}`]), { columns: [{ header: "#", tone: "muted" }, { header: "Story" }, { header: "Error" }] }, uncut(style));
+/**
+ * What `forgebook errors` prints of an answer: its JSON (one line per error while following, so each can be read as it
+ * comes), or its table.
+ *
+ * @param document - the errors document.
+ * @param mode - whether as JSON, and whether following.
+ * @param style - colours, glyphs and width.
+ */
+export const errorsOutput = (document, mode, style) => {
+    if (!mode.isJson)
+        return `${errorsText(document, style)}\n`;
+    if (mode.isFollowing)
+        return document.errors.map((error) => `${JSON.stringify(error)}\n`).join("");
+    return formatJson(document);
+};
+/**
+ * The pictures taken as a table: the story, the view, the file.
+ *
+ * @param report - the picture run's report.
+ * @param shownFile - how a file is written for the reader (relative to where the command runs).
+ * @param style - colours, glyphs and width.
+ */
+export const shotText = (report, shownFile, style) => table(report.shots.map((shot) => [shot.storyId, shot.view || "default", shownFile(shot.file)]), { columns: [{ header: "Story" }, { header: "View", tone: "muted" }, { header: "Picture" }] }, uncut(style));
 //# sourceMappingURL=agentText.js.map

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

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