@markbrutx/promptbook-cli 0.2.0 → 0.4.0

package/dist/src/config.d.ts

@@ -18,20 +18,32 @@ interface PromptbookConfig {
     lint?: unknown;
     eval?: unknown;
 }
+/** A loaded `promptbook.json`: parsed data plus the directory that held it. */
+export interface LoadedConfig {
+    /** Parsed JSON object (or `{}` when no file was found or parsing failed). */
+    data: PromptbookConfig;
+    /** Absolute directory where the config was found; `undefined` if nothing matched up the tree. */
+    dir?: string;
+}
 /** lint options sourced from the `lint` section of `promptbook.json`. */
 export interface LintConfig {
     maxTokens?: number;
     bannedTokens?: string[];
 }
 /**
- * Read and parse `promptbook.json` from cwd once. Missing, unreadable or
- * malformed config yields an empty object, so callers treat it as best-effort
- * and layer flags on top. Pass the result to {@link resolvePromptsDir} and
- * {@link lintConfigFrom} to avoid re-reading the file per command.
+ * Walk up from `io.cwd()` to find the first `promptbook.json`, parse it, and
+ * return its data + the directory it lived in. Walking up (rather than only
+ * checking cwd) is what makes `promptbook` work like `git`/`biome`/`eslint`:
+ * one config at the repo root reaches every subfolder. Path-valued keys
+ * (currently just `promptsDir`) are resolved relative to {@link LoadedConfig.dir}
+ * by {@link resolvePromptsDir}, not relative to wherever the shell happens to
+ * be — so `pnpm exec` snapping cwd to a workspace package cannot break the
+ * lookup. Missing, unreadable or malformed files yield an empty config
+ * (best-effort), so callers can layer flags on top.
  */
-export declare function loadConfig(io: IO): Promise<PromptbookConfig>;
+export declare function loadConfig(io: IO): Promise<LoadedConfig>;
 /** Extract the `lint` section from an already-loaded config. */
-export declare function lintConfigFrom(config: PromptbookConfig): LintConfig;
+export declare function lintConfigFrom(loaded: LoadedConfig): LintConfig;
 /** Convenience wrapper: load config and extract its `lint` section. */
 export declare function loadLintConfig(io: IO): Promise<LintConfig>;
 /** eval options sourced from the `eval` section of `promptbook.json`. */
@@ -40,17 +52,22 @@ export interface EvalConfig {
     baseUrl?: string;
 }
 /** Extract the `eval` section from an already-loaded config. */
-export declare function evalConfigFrom(config: PromptbookConfig): EvalConfig;
+export declare function evalConfigFrom(loaded: LoadedConfig): EvalConfig;
 /**
- * Resolve the prompts folder by priority: `--dir` flag > `promptbook.json`
- * (`promptsDir` key) in cwd > `./prompts`. All results are absolute. Pass a
- * preloaded `config` to reuse a single read; otherwise it is loaded here.
+ * Resolve the prompts folder by priority:
+ *   1. `--dir <path>` — relative to **cwd** (explicit per-invocation override).
+ *   2. `promptbook.json` `promptsDir` — relative to **the config file's directory**
+ *      (so the value can stay stable while the user shells around in subfolders).
+ *   3. `./prompts` — relative to cwd (back-compat default when no config exists).
+ *
+ * All results are absolute. Pass a preloaded {@link LoadedConfig} to reuse a
+ * single read; otherwise it is loaded here.
  */
-export declare function resolvePromptsDir(io: IO, dirFlag?: string, config?: PromptbookConfig): Promise<string>;
+export declare function resolvePromptsDir(io: IO, dirFlag?: string, loaded?: LoadedConfig): Promise<string>;
 /**
  * Resolve the prompts folder and confirm it exists. On a missing folder, write
  * a clear error to stderr and return null so the caller can exit non-zero.
  */
-export declare function requirePromptsDir(io: IO, dirFlag?: string, config?: PromptbookConfig): Promise<string | null>;
+export declare function requirePromptsDir(io: IO, dirFlag?: string, loaded?: LoadedConfig): Promise<string | null>;
 export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AASlC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAWtD;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CActD;AAuBD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAalG;AAED,UAAU,gBAAgB;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAclE;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAanE;AAED,uEAAuE;AACvE,wBAAsB,cAAc,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAEhE;AAED,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAanE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,EAAE,EACN,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CASjB;AAYD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,EAAE,EACN,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AASlC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAWtD;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CActD;AAuBD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAalG;AAED,UAAU,gBAAgB;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,IAAI,EAAE,gBAAgB,CAAC;IACvB,iGAAiG;IACjG,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAwB9D;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAa/D;AAED,uEAAuE;AACvE,wBAAsB,cAAc,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAEhE;AAED,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAa/D;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CASxG;AAYD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,EAAE,EACN,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB"}

package/dist/src/config.js

@@ -1,4 +1,4 @@
-import { resolve as resolvePath } from "node:path";
+import { dirname, resolve as resolvePath } from "node:path";
 const NUMERIC = /^-?\d+(?:\.\d+)?$/;
 /** True for a plain JSON object: an object that is neither null nor an array. */
 function isJsonObject(value) {
@@ -79,31 +79,46 @@ export async function buildContext(io, pairs, contextFile) {
     return { ...fileContext, ...parseCtxPairs(pairs) };
 }
 /**
- * Read and parse `promptbook.json` from cwd once. Missing, unreadable or
- * malformed config yields an empty object, so callers treat it as best-effort
- * and layer flags on top. Pass the result to {@link resolvePromptsDir} and
- * {@link lintConfigFrom} to avoid re-reading the file per command.
+ * Walk up from `io.cwd()` to find the first `promptbook.json`, parse it, and
+ * return its data + the directory it lived in. Walking up (rather than only
+ * checking cwd) is what makes `promptbook` work like `git`/`biome`/`eslint`:
+ * one config at the repo root reaches every subfolder. Path-valued keys
+ * (currently just `promptsDir`) are resolved relative to {@link LoadedConfig.dir}
+ * by {@link resolvePromptsDir}, not relative to wherever the shell happens to
+ * be — so `pnpm exec` snapping cwd to a workspace package cannot break the
+ * lookup. Missing, unreadable or malformed files yield an empty config
+ * (best-effort), so callers can layer flags on top.
  */
 export async function loadConfig(io) {
-    const configPath = resolvePath(io.cwd(), "promptbook.json");
-    let raw;
-    try {
-        raw = await io.fs.readFile(configPath);
-    }
-    catch {
-        return {};
-    }
-    try {
-        const parsed = JSON.parse(raw);
-        return isJsonObject(parsed) ? parsed : {};
-    }
-    catch {
-        return {};
+    let dir = resolvePath(io.cwd());
+    for (;;) {
+        const configPath = resolvePath(dir, "promptbook.json");
+        let raw;
+        try {
+            raw = await io.fs.readFile(configPath);
+        }
+        catch {
+            // not found at this level; try the parent
+        }
+        if (raw !== undefined) {
+            try {
+                const parsed = JSON.parse(raw);
+                return { data: isJsonObject(parsed) ? parsed : {}, dir };
+            }
+            catch {
+                return { data: {}, dir };
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            return { data: {} };
+        }
+        dir = parent;
     }
 }
 /** Extract the `lint` section from an already-loaded config. */
-export function lintConfigFrom(config) {
-    const section = config.lint;
+export function lintConfigFrom(loaded) {
+    const section = loaded.data.lint;
     if (!isJsonObject(section)) {
         return {};
     }
@@ -121,8 +136,8 @@ export async function loadLintConfig(io) {
     return lintConfigFrom(await loadConfig(io));
 }
 /** Extract the `eval` section from an already-loaded config. */
-export function evalConfigFrom(config) {
-    const section = config.eval;
+export function evalConfigFrom(loaded) {
+    const section = loaded.data.eval;
     if (!isJsonObject(section)) {
         return {};
     }
@@ -136,17 +151,22 @@ export function evalConfigFrom(config) {
     return evalConfig;
 }
 /**
- * Resolve the prompts folder by priority: `--dir` flag > `promptbook.json`
- * (`promptsDir` key) in cwd > `./prompts`. All results are absolute. Pass a
- * preloaded `config` to reuse a single read; otherwise it is loaded here.
+ * Resolve the prompts folder by priority:
+ *   1. `--dir <path>` — relative to **cwd** (explicit per-invocation override).
+ *   2. `promptbook.json` `promptsDir` — relative to **the config file's directory**
+ *      (so the value can stay stable while the user shells around in subfolders).
+ *   3. `./prompts` — relative to cwd (back-compat default when no config exists).
+ *
+ * All results are absolute. Pass a preloaded {@link LoadedConfig} to reuse a
+ * single read; otherwise it is loaded here.
  */
-export async function resolvePromptsDir(io, dirFlag, config) {
+export async function resolvePromptsDir(io, dirFlag, loaded) {
     if (dirFlag !== undefined) {
         return resolvePath(io.cwd(), dirFlag);
     }
-    const resolved = config ?? (await loadConfig(io));
-    if (typeof resolved.promptsDir === "string") {
-        return resolvePath(io.cwd(), resolved.promptsDir);
+    const resolved = loaded ?? (await loadConfig(io));
+    if (typeof resolved.data.promptsDir === "string" && resolved.dir !== undefined) {
+        return resolvePath(resolved.dir, resolved.data.promptsDir);
     }
     return resolvePath(io.cwd(), "prompts");
 }
@@ -164,8 +184,8 @@ async function dirExists(io, dir) {
  * Resolve the prompts folder and confirm it exists. On a missing folder, write
  * a clear error to stderr and return null so the caller can exit non-zero.
  */
-export async function requirePromptsDir(io, dirFlag, config) {
-    const promptsDir = await resolvePromptsDir(io, dirFlag, config);
+export async function requirePromptsDir(io, dirFlag, loaded) {
+    const promptsDir = await resolvePromptsDir(io, dirFlag, loaded);
     if (!(await dirExists(io, promptsDir))) {
         io.stderr(`error: prompts folder not found: ${promptsDir}\n`);
         return null;

package/dist/src/config.js.map

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

package/dist/src/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"AAUA,OAAO,EAAa,KAAK,EAAE,EAAE,MAAM,SAAS,CAAC;AAsD7C;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,EAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyC/E"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"AAWA,OAAO,EAAa,KAAK,EAAE,EAAE,MAAM,SAAS,CAAC;AAyD7C;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,EAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2C/E"}

package/dist/src/run.js

@@ -8,6 +8,7 @@ import { cmdLint } from "./commands/lint.js";
 import { cmdLs } from "./commands/ls.js";
 import { cmdResolve } from "./commands/resolve.js";
 import { cmdView } from "./commands/view.js";
+import { cmdWatch } from "./commands/watch.js";
 import { defaultIO } from "./io.js";
 const HELP = `promptbook — compose prompts from reusable fragments
 
@@ -18,7 +19,8 @@ Commands:
   resolve [<book>/]<prompt>  Assemble a prompt and print it to stdout (--all: every book)
   lint [<prompt>]         Run static checks; with no prompt, book rules only
   eval [<name|glob>]      Run fixtures through a model adapter, report pass-rate
-  bundle [<dir>]          Compile a prompts folder into an importable book module
+  bundle [<dir>]          Compile a prompts folder into an importable book module (--all/--check)
+  watch [<dir>]           Rebuild book.generated.ts as fragments/rules/compositions change
   view                    Start the local web viewer over the workspace (book switcher)
   annotations <action>    Drain the viewer's feedback queue: list | resolve <id> | clear
   ls                      List compositions and fragments (--all: cross-book inventory)
@@ -38,13 +40,15 @@ Options:
   --samples N             eval: default samples per fixture (default 1; a fixture's own samples wins)
   --threshold R           eval: a fixture passes when passRate >= R (default 1)
   --lint                  eval: run a static lint gate over every variant first
-  -o, --out <file>        bundle: write the generated module to a file (default: stdout)
-  --plain                 bundle: emit a plain module (no type-only import; e.g. for Deno)
+  -o, --out <file>        bundle/watch: write to a file (default: stdout for bundle, <bookDir>/book.generated.ts for watch/--all)
+  --plain                 bundle/watch: emit a plain module (no type-only import; e.g. for Deno)
+  --check                 bundle: compare with the existing output; exit 1 on drift or missing artifact
+  --exclude-code-prompts  bundle/watch: serialize code-prompts as an empty map (runtime-lean bundle)
   --port N                view: port for the viewer server (default: a free port)
   --no-open               view: do not open the browser after starting
   --fragments             ls: list fragments only
   --compositions          ls: list compositions only
-  --all                   ls/resolve: span every book in the workspace
+  --all                   ls/resolve/bundle: span every book in the workspace
   -h, --help              Show this help
   -v, --version           Show the version
 
@@ -95,6 +99,8 @@ export async function run(argv, io = defaultIO()) {
             return cmdEval(args, io);
         case "bundle":
             return cmdBundle(args, io);
+        case "watch":
+            return cmdWatch(args, io);
         case "view":
             return cmdView(args, io);
         case "annotations":

package/dist/src/run.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markbrutx/promptbook-cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Thin terminal surface over @markbrutx/promptbook-core: resolve and ls for agents and CI.",
   "type": "module",
   "license": "MIT",
@@ -48,11 +48,12 @@
     "check": "biome check ."
   },
   "dependencies": {
-    "@markbrutx/promptbook-core": "^0.2.0",
-    "@markbrutx/promptbook-openrouter": "^0.2.0"
+    "@markbrutx/promptbook-core": "^0.3.0",
+    "@markbrutx/promptbook-openrouter": "^0.3.0",
+    "chokidar": "^4.0.3"
   },
   "optionalDependencies": {
-    "@markbrutx/promptbook-viewer": "^0.2.0"
+    "@markbrutx/promptbook-viewer": "^0.3.0"
   },
   "devDependencies": {
     "@biomejs/biome": "latest",

package/src/args.ts

@@ -20,8 +20,12 @@ export interface ParsedArgs {
   contextFile?: string;
   fragments: boolean;
   compositions: boolean;
-  /** ls/resolve: operate across every book in the workspace. */
+  /** ls/resolve/bundle: operate across every book in the workspace. */
   all: boolean;
+  /** bundle: compare the generated output with the existing artifact and exit non-zero on drift. */
+  check: boolean;
+  /** bundle: serialize without code-prompts so a runtime bundle stays lean. */
+  excludeCodePrompts: boolean;
   /** lint: estimated token ceiling for the token-budget rule. */
   maxTokens?: number;
   /** lint: treat warnings as failures for the exit code. */
@@ -91,6 +95,8 @@ export function parseCliArgs(argv: string[]): ParsedArgs {
       fragments: { type: "boolean" },
       compositions: { type: "boolean" },
       all: { type: "boolean" },
+      check: { type: "boolean" },
+      "exclude-code-prompts": { type: "boolean" },
       "max-tokens": { type: "string" },
       strict: { type: "boolean" },
       model: { type: "string" },
@@ -137,6 +143,8 @@ export function parseCliArgs(argv: string[]): ParsedArgs {
     fragments: values.fragments ?? false,
     compositions: values.compositions ?? false,
     all: values.all ?? false,
+    check: values.check ?? false,
+    excludeCodePrompts: values["exclude-code-prompts"] ?? false,
     maxTokens,
     strict: values.strict ?? false,
     model: values.model,

package/src/commands/bundle.ts

@@ -1,9 +1,13 @@
-import { isAbsolute, relative, resolve as resolvePath, sep } from "node:path";
+import { basename, isAbsolute, join, relative, resolve as resolvePath, sep } from "node:path";
 import type { PromptBook } from "@markbrutx/promptbook-core";
 import { loadPrompts, serializeBook, serializeBookJson } from "@markbrutx/promptbook-core";
 import type { ParsedArgs } from "../args.js";
 import { requirePromptsDir } from "../config.js";
 import { emitWarnings, type IO } from "../io.js";
+import { loadWorkspace } from "../workspace.js";
+
+/** Default name of the artifact file each book emits alongside its sources. */
+const BUNDLE_FILE = "book.generated.ts";
 
 /** Rewrite an absolute source path to a portable, forward-slash path relative to `dir`. */
 function relativizeSource(sourceFile: string, dir: string): string {
@@ -34,32 +38,124 @@ function portableBook(book: PromptBook, dir: string): PromptBook {
   };
 }
 
+/** Return the book with `codePrompts` cleared — used by `--exclude-code-prompts`. */
+function withoutCodePrompts(book: PromptBook): PromptBook {
+  return { ...book, codePrompts: new Map() };
+}
+
+/** Normalize EOL so a CRLF-checked-in artifact does not falsely look stale on an LF rebuild. */
+function normalizeEol(text: string): string {
+  return text.replace(/\r\n/g, "\n");
+}
+
+/** First 1-based line index where two strings differ; null when equal. */
+function firstDiffLine(actual: string, expected: string): number | null {
+  if (actual === expected) {
+    return null;
+  }
+  const a = actual.split("\n");
+  const b = expected.split("\n");
+  const max = Math.max(a.length, b.length);
+  for (let i = 0; i < max; i += 1) {
+    if (a[i] !== b[i]) {
+      return i + 1;
+    }
+  }
+  // Unreachable: if the strings differ, at least one index in [0, max) must too.
+  throw new Error("firstDiffLine: strings differ but no line diff found");
+}
+
+/** Build the output text for one book (TypeScript module or JSON). */
+function renderOutput(book: PromptBook, args: ParsedArgs): string {
+  return args.json ? serializeBookJson(book) : serializeBook(book, { typed: !args.plain });
+}
+
+/** Pick the artifact path: explicit `--out`, else `book.generated.ts` next to the prompts folder. */
+function targetPath(io: IO, args: ParsedArgs, promptsDir: string): string {
+  if (args.out !== undefined) {
+    return resolvePath(io.cwd(), args.out);
+  }
+  return join(promptsDir, BUNDLE_FILE);
+}
+
+/** One book's `--check` outcome: file present and matching, drifted, or missing. */
+type CheckOutcome =
+  | { status: "up-to-date"; path: string }
+  | { status: "stale"; reason: "missing"; path: string }
+  | { status: "stale"; reason: "diff"; firstDiffLine: number; path: string };
+
+async function checkOne(io: IO, output: string, path: string): Promise<CheckOutcome> {
+  let existing: string;
+  try {
+    existing = await io.fs.readFile(path);
+  } catch {
+    return { status: "stale", reason: "missing", path };
+  }
+  const line = firstDiffLine(normalizeEol(output), normalizeEol(existing));
+  if (line === null) {
+    return { status: "up-to-date", path };
+  }
+  return { status: "stale", reason: "diff", firstDiffLine: line, path };
+}
+
+function emitCheckResult(io: IO, args: ParsedArgs, bookName: string, outcome: CheckOutcome): void {
+  if (args.json) {
+    const diff =
+      outcome.status === "stale"
+        ? outcome.reason === "missing"
+          ? { reason: "missing", path: outcome.path }
+          : { reason: "diff", firstDiffLine: outcome.firstDiffLine }
+        : null;
+    io.stderr(`${JSON.stringify({ book: bookName, status: outcome.status, diff })}\n`);
+    return;
+  }
+  if (outcome.status === "up-to-date") {
+    io.stderr(`${bookName} up to date\n`);
+    return;
+  }
+  if (outcome.reason === "missing") {
+    io.stderr(`${bookName} stale (missing ${outcome.path})\n`);
+    return;
+  }
+  io.stderr(`${bookName} stale (first diff at line ${outcome.firstDiffLine})\n`);
+}
+
 /**
- * `bundle [<dir>]`: load a prompts folder and emit it as a single importable
- * module exporting `book: PromptBook` (so a runtime can import the book instead
- * of reading the disk). Writes to stdout, or to a file with `-o`. `--json`
- * emits a structured dump instead of the TypeScript module.
+ * Bundle one book: load → relativize → optionally drop code-prompts → serialize.
+ * Then either `--check` against the existing artifact, write to `--out`/the
+ * default `book.generated.ts`, or print to stdout (single-book, no `--out`).
  *
- * The folder comes from the positional `<dir>`, else `--dir`, else config /
- * `./prompts` (the standard resolution).
+ * Returns the exit code: 0 on success / up-to-date, 1 on drift / write failure.
+ * `bookName` is used in `--check` output and warnings; when `inWorkspace` is
+ * true the artifact is always written (not printed), matching `bundle --all`.
  */
-export async function cmdBundle(args: ParsedArgs, io: IO): Promise<number> {
-  const promptsDir = await requirePromptsDir(io, args.operands[0] ?? args.dir);
-  if (promptsDir === null) {
-    return 1;
-  }
-
-  const book = portableBook(await loadPrompts(promptsDir, io.fs), promptsDir);
+export async function bundleOne(
+  io: IO,
+  args: ParsedArgs,
+  promptsDir: string,
+  bookName: string,
+  inWorkspace: boolean,
+): Promise<number> {
+  const loaded = await loadPrompts(promptsDir, io.fs);
+  // `--exclude-code-prompts` discards them outright; skipping the relativize pass is the whole point.
+  const source = args.excludeCodePrompts ? withoutCodePrompts(loaded) : loaded;
+  const book = portableBook(source, promptsDir);
   emitWarnings(io, book.warnings);
 
-  const output = args.json ? serializeBookJson(book) : serializeBook(book, { typed: !args.plain });
+  const output = renderOutput(book, args);
 
-  if (args.out === undefined) {
+  if (args.check) {
+    const outcome = await checkOne(io, output, targetPath(io, args, promptsDir));
+    emitCheckResult(io, args, bookName, outcome);
+    return outcome.status === "up-to-date" ? 0 : 1;
+  }
+
+  if (args.out === undefined && !inWorkspace) {
     io.stdout(output);
     return 0;
   }
 
-  const outPath = resolvePath(io.cwd(), args.out);
+  const outPath = targetPath(io, args, promptsDir);
   try {
     await io.writeFile(outPath, output);
   } catch (error) {
@@ -69,3 +165,53 @@ export async function cmdBundle(args: ParsedArgs, io: IO): Promise<number> {
   io.stderr(`wrote ${outPath}\n`);
   return 0;
 }
+
+/** Run `bundleOne` over every book in the workspace in parallel; the worst exit code wins. */
+async function bundleAll(io: IO, args: ParsedArgs, root: string): Promise<number> {
+  const workspace = await loadWorkspace(io, root);
+  if (workspace.books.length === 0) {
+    io.stderr(`error: no books found under ${root}\n`);
+    return 1;
+  }
+  const codes = await Promise.all(
+    workspace.books.map((book) => bundleOne(io, args, book.dir, book.name, true)),
+  );
+  return Math.max(0, ...codes);
+}
+
+/**
+ * `bundle [<dir>]`: load a prompts folder and emit it as an importable module
+ * exporting `book: PromptBook`. Writes to stdout, or to a file with `-o`.
+ *
+ * Flags:
+ * - `--json` emits the structured dump instead of the TypeScript module.
+ * - `--plain` drops the type-only import (e.g. for Deno consumers).
+ * - `--exclude-code-prompts` serializes code-prompts as an empty map so the
+ *   runtime bundle stays lean while `code-prompts/` keeps living on disk as
+ *   metadata for `ls` / the viewer.
+ * - `--check` compares the would-be output against the existing artifact
+ *   (`book.generated.ts` next to the prompts folder, or `--out`); exits 1 on
+ *   drift or a missing artifact and prints a short hint on stderr.
+ * - `--all` walks every book in the workspace and writes each to its own
+ *   `book.generated.ts`; incompatible with `-o`.
+ *
+ * The folder comes from the positional `<dir>`, else `--dir`, else config /
+ * `./prompts`. `--all` does not accept a single-book `<dir>` operand differently.
+ */
+export async function cmdBundle(args: ParsedArgs, io: IO): Promise<number> {
+  if (args.all && args.out !== undefined) {
+    io.stderr("error: --all is not compatible with -o/--out\n");
+    return 1;
+  }
+
+  const promptsDir = await requirePromptsDir(io, args.operands[0] ?? args.dir);
+  if (promptsDir === null) {
+    return 1;
+  }
+
+  if (args.all) {
+    return bundleAll(io, args, promptsDir);
+  }
+
+  return bundleOne(io, args, promptsDir, basename(promptsDir), false);
+}