npm - @markbrutx/promptbook-cli - Versions diffs - 0.3.0 → 0.4.1 - Mend

@markbrutx/promptbook-cli 0.3.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/README.md +22 -6
package/dist/bin/promptbook.js +0 -0
package/dist/src/args.d.ts +5 -1
package/dist/src/args.d.ts.map +1 -1
package/dist/src/args.js +4 -0
package/dist/src/args.js.map +1 -1
package/dist/src/commands/bundle.d.ts +25 -5
package/dist/src/commands/bundle.d.ts.map +1 -1
package/dist/src/commands/bundle.js +135 -16
package/dist/src/commands/bundle.js.map +1 -1
package/dist/src/commands/watch.d.ts +19 -0
package/dist/src/commands/watch.d.ts.map +1 -0
package/dist/src/commands/watch.js +193 -0
package/dist/src/commands/watch.js.map +1 -0
package/dist/src/run.d.ts.map +1 -1
package/dist/src/run.js +11 -5
package/dist/src/run.js.map +1 -1
package/package.json +5 -4
package/src/args.ts +9 -1
package/src/commands/bundle.ts +163 -17
package/src/commands/watch.ts +221 -0
package/src/run.ts +11 -5

package/README.md CHANGED Viewed

@@ -10,15 +10,31 @@ npm i -D @markbrutx/promptbook-cli
 ## Commands
 ```
-promptbook resolve <name> --explain     # assemble a prompt; print the explain trace
-promptbook ls                           # list fragments / compositions / code-prompts
-promptbook lint <name>                  # static checks: token budget, banned tokens, dead rules…
-promptbook eval --case <fixture>        # run fixtures against a model adapter → pass-rate
-promptbook bundle -o book.generated.ts  # serialize a prompts folder to a portable module
-promptbook view                         # open the viewer (needs @markbrutx/promptbook-viewer)
+promptbook resolve <name> --explain         # assemble a prompt; print the explain trace
+promptbook ls                               # list fragments / compositions / code-prompts
+promptbook lint <name>                      # static checks: token budget, banned tokens, dead rules…
+promptbook eval --case <fixture>            # run fixtures against a model adapter → pass-rate
+promptbook bundle -o book.generated.ts      # serialize a prompts folder to a portable module
+promptbook bundle --all                     # rebundle every book in a workspace (one artifact per book)
+promptbook bundle --check [--all]           # CI gate: exit 1 when book.generated.ts is stale or missing
+promptbook bundle --exclude-code-prompts    # serialize code-prompts as an empty map (runtime-lean bundle)
+promptbook watch                            # rebundle book.generated.ts on every fragment/rule edit
+promptbook view                             # open the viewer (needs @markbrutx/promptbook-viewer)
 promptbook annotations list|resolve|clear
 ```
+Dev loop:
+- `promptbook watch` keeps `book.generated.ts` in sync while you edit
+  `fragments/`, `rules/`, `code-prompts/` or `promptbook.json`
+  (one rebundle per book, debounced 250 ms; multi-book workspaces rebundle in
+  parallel).
+- `promptbook bundle --check --all` is the CI gate: it exits non-zero when any
+  book's checked-in `book.generated.ts` drifts from the prompts folder, so
+  `book.generated.ts` and the source files cannot fall out of sync silently.
+- `promptbook bundle --exclude-code-prompts` ships a runtime-lean bundle while
+  keeping `code-prompts/` on disk as metadata for `ls` / the viewer.
 The prompts folder is resolved from `--dir`, then `promptbook.json` (the
 nearest one found by walking up from the current directory — same model as
 `git`/`biome`/`eslint`; the `promptsDir` value is taken relative to wherever

package/dist/bin/promptbook.js CHANGED Viewed

File without changes

package/dist/src/args.d.ts CHANGED Viewed

@@ -18,8 +18,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. */

package/dist/src/args.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,~~8DAA8D~~;~~IAC9D~~,GAAG,EAAE,OAAO,CAAC;IACb,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,IAAI,EAAE,OAAO,CAAC;IACd,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;CACjB;AAgCD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,~~CAwEvD~~"}
1	+ {"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,qEAAqE;IACrE,GAAG,EAAE,OAAO,CAAC;IACb,kGAAkG;IAClG,KAAK,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,kBAAkB,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,IAAI,EAAE,OAAO,CAAC;IACd,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;CACjB;AAgCD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4EvD"}

package/dist/src/args.js CHANGED Viewed

@@ -39,6 +39,8 @@ export function parseCliArgs(argv) {
             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" },
@@ -85,6 +87,8 @@ export function parseCliArgs(argv) {
         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/dist/src/args.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;~~AAmDtC~~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"}
1	+ {"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/bundle.d.ts CHANGED Viewed

@@ -1,13 +1,33 @@
 import type { ParsedArgs } from "../args.js";
 import { type IO } from "../io.js";
 /**
- * `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`).
+ *
+ * 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 declare function bundleOne(io: IO, args: ParsedArgs, promptsDir: string, bookName: string, inWorkspace: boolean): Promise<number>;
+/**
+ * `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` (the standard resolution).
+ * `./prompts`. `--all` does not accept a single-book `<dir>` operand differently.
  */
 export declare function cmdBundle(args: ParsedArgs, io: IO): Promise<number>;
 //# sourceMappingURL=bundle.d.ts.map

package/dist/src/commands/bundle.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../src/commands/bundle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAgB,KAAK,EAAE,EAAE,MAAM,UAAU,CAAC;~~AA+BjD~~;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,~~CAyBzE~~"}
1	+ {"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../src/commands/bundle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAgB,KAAK,EAAE,EAAE,MAAM,UAAU,CAAC;AAqHjD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAeD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBzE"}

package/dist/src/commands/bundle.js CHANGED Viewed

@@ -1,7 +1,10 @@
-import { isAbsolute, relative, resolve as resolvePath, sep } from "node:path";
+import { basename, isAbsolute, join, relative, resolve as resolvePath, sep } from "node:path";
 import { loadPrompts, serializeBook, serializeBookJson } from "@markbrutx/promptbook-core";
 import { requirePromptsDir } from "../config.js";
 import { emitWarnings } 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, dir) {
     if (!isAbsolute(sourceFile)) {
@@ -26,28 +29,101 @@ function portableBook(book, dir) {
         warnings: book.warnings,
     };
 }
+/** Return the book with `codePrompts` cleared — used by `--exclude-code-prompts`. */
+function withoutCodePrompts(book) {
+    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) {
+    return text.replace(/\r\n/g, "\n");
+}
+/** First 1-based line index where two strings differ; null when equal. */
+function firstDiffLine(actual, expected) {
+    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, args) {
+    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, args, promptsDir) {
+    if (args.out !== undefined) {
+        return resolvePath(io.cwd(), args.out);
+    }
+    return join(promptsDir, BUNDLE_FILE);
+}
+async function checkOne(io, output, path) {
+    let existing;
+    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, args, bookName, outcome) {
+    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, io) {
-    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, args, promptsDir, bookName, inWorkspace) {
+    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 });
-    if (args.out === undefined) {
+    const output = renderOutput(book, args);
+    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);
     }
@@ -58,4 +134,47 @@ export async function cmdBundle(args, io) {
     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, args, root) {
+    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, io) {
+    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);
+}
 //# sourceMappingURL=bundle.js.map

package/dist/src/commands/bundle.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../../src/commands/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,IAAI,WAAW,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;~~AAE9E~~,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAW,MAAM,UAAU,CAAC;~~AAEjD~~,2FAA2F;AAC3F,SAAS,gBAAgB,CAAC,UAAkB,EAAE,GAAW;IACvD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,gEAAgE;AAChE,SAAS,aAAa,CAAmC,GAAmB,EAAE,GAAW;IACvF,OAAO,IAAI,GAAG,CACZ,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CACzG,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,IAAgB,EAAE,GAAW;IACjD,OAAO;QACL,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC;QAC7C,YAAY,EAAE,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC;QACnD,WAAW,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;QACjD,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC;AAED~~;;;;;;;;GAQG~~;~~AACH~~,MAAM,CAAC,KAAK,~~UAAU~~,SAAS,CAAC,IAAgB,EAAE,~~EAAM~~;IACtD,~~MAAM~~,UAAU,GAAG,~~MAAM~~,~~iBAAiB~~,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;~~IAC7E~~,IAAI,~~UAAU~~,KAAK,IAAI,EAAE,CAAC;~~QACxB~~,OAAO,CAAC,CAAC;~~IACX~~,CAAC;~~IAED~~,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;~~IAC5E~~,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,~~iBAAiB~~,CAAC,IAAI,~~CAAC~~,CAAC,CAAC,CAAC,~~aAAa~~,CAAC,~~IAAI~~,EAAE,EAAE,~~KAAK~~,EAAE,CAAC,~~IAAI~~,CAAC,KAAK,~~EAAE~~,CAAC,CAAC;~~IAEjG~~,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;~~QAC3B~~,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,~~WAAW~~,CAAC,EAAE,~~CAAC,GAAG,~~EAAE,~~EAAE,~~IAAI,~~CAAC~~,~~GAAG~~,CAAC,CAAC;~~IAChD~~,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,MAAM,CAAC,wBAAwB,OAAO,MAAO,KAAe,CAAC,OAAO,IAAI,CAAC,CAAC;QAC7E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,EAAE,CAAC,MAAM,CAAC,SAAS,OAAO,IAAI,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC;AACX,CAAC"}
1	+ {"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../../src/commands/bundle.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/watch.d.ts ADDED Viewed

@@ -0,0 +1,19 @@
+import type { ParsedArgs } from "../args.js";
+import { type IO } from "../io.js";
+/**
+ * `watch [<dir>]`: rebuild `book.generated.ts` whenever fragments, rules,
+ * compositions, code-prompts or `promptbook.json` change. Streams one short
+ * line per rebuild to stderr (`[clock] <book> bundled (<bytes> B, <ms>ms)`);
+ * stdout stays empty (the contract: stdout = payload, watch has no payload).
+ *
+ * Discovers every book under the prompts folder and rebuilds each once on
+ * startup, then debounces per-book events with a 250 ms window so a burst of
+ * edits collapses into one rebuild. SIGINT / SIGTERM closes the watcher and
+ * exits 0. Honors `--plain`, `--exclude-code-prompts`, `--json`, and the
+ * config / `--dir` resolution chain.
+ *
+ * `--out <file>` only works in a single-book workspace; the multi-book mode
+ * always writes each book's artifact next to its sources.
+ */
+export declare function cmdWatch(args: ParsedArgs, io: IO): Promise<number>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/src/commands/watch.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/commands/watch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAgB,KAAK,EAAE,EAAE,MAAM,UAAU,CAAC;AA8HjD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2ExE"}

package/dist/src/commands/watch.js ADDED Viewed

@@ -0,0 +1,193 @@
+import { relative, sep } from "node:path";
+import { watch as chokidarWatch } from "chokidar";
+import { requirePromptsDir } from "../config.js";
+import { colorEnabled } from "../io.js";
+import { makeStyle } from "../style.js";
+import { loadWorkspace } from "../workspace.js";
+import { bundleOne } from "./bundle.js";
+/** Folders inside a book whose edits warrant a rebuild (mirrors core's loader layout). */
+const BOOK_DIRS = ["fragments", "rules", "code-prompts"];
+/** Single-book root files we re-bundle on touch (config edits change the assembly). */
+const BOOK_FILES = ["promptbook.json"];
+/** Debounce window per book: a burst of edits collapses into one rebuild. */
+const DEBOUNCE_MS = 250;
+/** Local-time clock prefix (`hours:minutes:seconds`); slices off Date#toTimeString's TZ tail. */
+function clock() {
+    return new Date().toTimeString().slice(0, 8);
+}
+/** True when `event` happened inside one of the book's watched folders (or is a root file). */
+function eventInBook(book, eventPath) {
+    const rel = relative(book.dir, eventPath);
+    if (rel === "" || rel.startsWith("..")) {
+        return false;
+    }
+    const parts = rel.split(sep);
+    if (parts.length === 1) {
+        return BOOK_FILES.includes(parts[0]);
+    }
+    return BOOK_DIRS.includes(parts[0]);
+}
+/** Ignore artifacts, tests, fixtures, and everything VCS / dep manager touches. */
+function shouldIgnore(eventPath) {
+    const lower = eventPath.toLowerCase();
+    if (lower.endsWith("book.generated.ts")) {
+        return true;
+    }
+    if (lower.endsWith(".test.ts") || lower.endsWith(".test.js")) {
+        return true;
+    }
+    const segments = eventPath.split(sep);
+    for (const segment of segments) {
+        if (segment === "node_modules" || segment === ".git" || segment === "fixtures") {
+            return true;
+        }
+    }
+    return false;
+}
+/** Wrap `io` so `bundleOne`'s `wrote <path>` chatter is dropped and the artifact size is captured. */
+function captureBytes(io) {
+    let bytes = 0;
+    const sink = {
+        ...io,
+        stderr(text) {
+            if (text.startsWith("wrote ")) {
+                return;
+            }
+            io.stderr(text);
+        },
+        async writeFile(path, contents) {
+            bytes = contents.length;
+            await io.writeFile(path, contents);
+        },
+    };
+    return { sink, bytes: () => bytes };
+}
+function emitEvent(io, args, style, event, payload = {}) {
+    if (args.json) {
+        io.stderr(`${JSON.stringify({ event, ts: clock(), ...payload })}\n`);
+        return;
+    }
+    const ts = style.dim(`[${clock()}]`);
+    if (event === "started") {
+        const books = payload.books;
+        io.stderr(`${ts} watching ${books.length} book(s): ${books.join(", ")}\n`);
+        return;
+    }
+    if (event === "bundled") {
+        io.stderr(`${ts} ${payload.book} bundled (${payload.bytes} B, ${payload.ms}ms)\n`);
+        return;
+    }
+    if (event === "stopped") {
+        io.stderr("stopped\n");
+        return;
+    }
+    io.stderr(`${ts} ${payload.book} ${style.red("ERROR")}: ${payload.message}\n`);
+}
+async function rebuild(io, args, book) {
+    const start = Date.now();
+    const capture = captureBytes(io);
+    try {
+        const code = await bundleOne(capture.sink, args, book.dir, book.name, true);
+        if (code !== 0) {
+            return new Error(`bundle exited with code ${code}`);
+        }
+        return { bytes: capture.bytes(), ms: Date.now() - start };
+    }
+    catch (error) {
+        return error;
+    }
+}
+/** Run one rebuild and emit its bundled/error event. */
+async function rebuildAndReport(io, args, style, book) {
+    const result = await rebuild(io, args, book);
+    if (result instanceof Error) {
+        emitEvent(io, args, style, "error", { book: book.name, message: result.message });
+    }
+    else {
+        emitEvent(io, args, style, "bundled", { book: book.name, bytes: result.bytes, ms: result.ms });
+    }
+}
+/**
+ * `watch [<dir>]`: rebuild `book.generated.ts` whenever fragments, rules,
+ * compositions, code-prompts or `promptbook.json` change. Streams one short
+ * line per rebuild to stderr (`[clock] <book> bundled (<bytes> B, <ms>ms)`);
+ * stdout stays empty (the contract: stdout = payload, watch has no payload).
+ *
+ * Discovers every book under the prompts folder and rebuilds each once on
+ * startup, then debounces per-book events with a 250 ms window so a burst of
+ * edits collapses into one rebuild. SIGINT / SIGTERM closes the watcher and
+ * exits 0. Honors `--plain`, `--exclude-code-prompts`, `--json`, and the
+ * config / `--dir` resolution chain.
+ *
+ * `--out <file>` only works in a single-book workspace; the multi-book mode
+ * always writes each book's artifact next to its sources.
+ */
+export async function cmdWatch(args, io) {
+    if (args.check) {
+        io.stderr("error: --check is not supported by watch (run `bundle --check --all` from CI)\n");
+        return 1;
+    }
+    const promptsDir = await requirePromptsDir(io, args.operands[0] ?? args.dir);
+    if (promptsDir === null) {
+        return 1;
+    }
+    const workspace = await loadWorkspace(io, promptsDir);
+    if (workspace.books.length === 0) {
+        io.stderr(`error: no books found under ${promptsDir}\n`);
+        return 1;
+    }
+    if (args.out !== undefined && workspace.books.length > 1) {
+        io.stderr("error: --out requires a single book; drop --out to write each book's book.generated.ts\n");
+        return 1;
+    }
+    const style = makeStyle(colorEnabled(io));
+    emitEvent(io, args, style, "started", { books: workspace.books.map((b) => b.name) });
+    // Initial pass runs in parallel: each book writes its own artifact, no contention.
+    await Promise.all(workspace.books.map((book) => rebuildAndReport(io, args, style, book)));
+    const watcher = chokidarWatch(promptsDir, {
+        ignoreInitial: true,
+        awaitWriteFinish: { stabilityThreshold: 50, pollInterval: 25 },
+        ignored: (eventPath) => shouldIgnore(eventPath),
+    });
+    const timers = new Map();
+    const scheduleRebuild = (book) => {
+        const existing = timers.get(book.name);
+        if (existing !== undefined) {
+            clearTimeout(existing);
+        }
+        const timer = setTimeout(() => {
+            timers.delete(book.name);
+            void rebuildAndReport(io, args, style, book);
+        }, DEBOUNCE_MS);
+        timers.set(book.name, timer);
+    };
+    watcher.on("all", (_event, eventPath) => {
+        const book = workspace.books.find((b) => eventInBook(b, eventPath));
+        if (book === undefined) {
+            return;
+        }
+        scheduleRebuild(book);
+    });
+    // Hold the promise open until SIGINT / SIGTERM closes the watcher.
+    return new Promise((resolveDone) => {
+        let stopped = false;
+        const stop = async () => {
+            if (stopped) {
+                return;
+            }
+            stopped = true;
+            for (const timer of timers.values()) {
+                clearTimeout(timer);
+            }
+            timers.clear();
+            await watcher.close();
+            emitEvent(io, args, style, "stopped");
+            process.off("SIGINT", stop);
+            process.off("SIGTERM", stop);
+            resolveDone(0);
+        };
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/src/commands/watch.js.map ADDED Viewed

@@ -0,0 +1 @@

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

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

	@@ -1 +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"}
1	+ {"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 CHANGED Viewed

@@ -8,8 +8,9 @@ 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
+const HELP = `promptbook · compose prompts from reusable fragments
 Usage:
   promptbook <command> [options]
@@ -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 CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAW,MAAM,SAAS,CAAC;AAE7C,MAAM,IAAI,GAAG~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCZ~~,CAAC;AAEF,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAyB,CAAC;QAC3E,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,EAAE,GAAO,SAAS,EAAE;IAC5D,IAAI,IAAqC,CAAC;IAC1C,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,MAAM,CAAC,UAAW,KAAe,CAAC,OAAO,IAAI,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,EAAE,CAAC,MAAM,CAAC,GAAG,WAAW,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9B,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3B,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3B,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7B,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3B,KAAK,aAAa;YAChB,OAAO,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClC,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzB;YACE,EAAE,CAAC,MAAM,CAAC,2BAA2B,IAAI,CAAC,OAAO,+BAA+B,CAAC,CAAC;YAClF,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC"}
1	+ {"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@markbrutx/promptbook-cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "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.3.0",
-    "@markbrutx/promptbook-openrouter": "^0.3.0"
+    "@markbrutx/promptbook-core": "^0.4.1",
+    "@markbrutx/promptbook-openrouter": "^0.4.1",
+    "chokidar": "^4.0.3"
   },
   "optionalDependencies": {
-    "@markbrutx/promptbook-viewer": "^0.3.0"
+    "@markbrutx/promptbook-viewer": "^0.4.1"
   },
   "devDependencies": {
     "@biomejs/biome": "latest",

package/src/args.ts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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);
+}

package/src/commands/watch.ts ADDED Viewed

@@ -0,0 +1,221 @@
+import { relative, sep } from "node:path";
+import { watch as chokidarWatch } from "chokidar";
+import type { ParsedArgs } from "../args.js";
+import { requirePromptsDir } from "../config.js";
+import { colorEnabled, type IO } from "../io.js";
+import { makeStyle, type Style } from "../style.js";
+import { type Book, loadWorkspace } from "../workspace.js";
+import { bundleOne } from "./bundle.js";
+/** Folders inside a book whose edits warrant a rebuild (mirrors core's loader layout). */
+const BOOK_DIRS = ["fragments", "rules", "code-prompts"];
+/** Single-book root files we re-bundle on touch (config edits change the assembly). */
+const BOOK_FILES = ["promptbook.json"];
+/** Debounce window per book: a burst of edits collapses into one rebuild. */
+const DEBOUNCE_MS = 250;
+interface RebuildStats {
+  bytes: number;
+  ms: number;
+}
+/** Local-time clock prefix (`hours:minutes:seconds`); slices off Date#toTimeString's TZ tail. */
+function clock(): string {
+  return new Date().toTimeString().slice(0, 8);
+}
+/** True when `event` happened inside one of the book's watched folders (or is a root file). */
+function eventInBook(book: Book, eventPath: string): boolean {
+  const rel = relative(book.dir, eventPath);
+  if (rel === "" || rel.startsWith("..")) {
+    return false;
+  }
+  const parts = rel.split(sep);
+  if (parts.length === 1) {
+    return BOOK_FILES.includes(parts[0] as string);
+  }
+  return BOOK_DIRS.includes(parts[0] as string);
+}
+/** Ignore artifacts, tests, fixtures, and everything VCS / dep manager touches. */
+function shouldIgnore(eventPath: string): boolean {
+  const lower = eventPath.toLowerCase();
+  if (lower.endsWith("book.generated.ts")) {
+    return true;
+  }
+  if (lower.endsWith(".test.ts") || lower.endsWith(".test.js")) {
+    return true;
+  }
+  const segments = eventPath.split(sep);
+  for (const segment of segments) {
+    if (segment === "node_modules" || segment === ".git" || segment === "fixtures") {
+      return true;
+    }
+  }
+  return false;
+}
+/** Wrap `io` so `bundleOne`'s `wrote <path>` chatter is dropped and the artifact size is captured. */
+function captureBytes(io: IO): { sink: IO; bytes: () => number } {
+  let bytes = 0;
+  const sink: IO = {
+    ...io,
+    stderr(text) {
+      if (text.startsWith("wrote ")) {
+        return;
+      }
+      io.stderr(text);
+    },
+    async writeFile(path, contents) {
+      bytes = contents.length;
+      await io.writeFile(path, contents);
+    },
+  };
+  return { sink, bytes: () => bytes };
+}
+function emitEvent(
+  io: IO,
+  args: ParsedArgs,
+  style: Style,
+  event: "started" | "bundled" | "error" | "stopped",
+  payload: Record<string, unknown> = {},
+): void {
+  if (args.json) {
+    io.stderr(`${JSON.stringify({ event, ts: clock(), ...payload })}\n`);
+    return;
+  }
+  const ts = style.dim(`[${clock()}]`);
+  if (event === "started") {
+    const books = payload.books as string[];
+    io.stderr(`${ts} watching ${books.length} book(s): ${books.join(", ")}\n`);
+    return;
+  }
+  if (event === "bundled") {
+    io.stderr(`${ts} ${payload.book} bundled (${payload.bytes} B, ${payload.ms}ms)\n`);
+    return;
+  }
+  if (event === "stopped") {
+    io.stderr("stopped\n");
+    return;
+  }
+  io.stderr(`${ts} ${payload.book} ${style.red("ERROR")}: ${payload.message}\n`);
+}
+async function rebuild(io: IO, args: ParsedArgs, book: Book): Promise<RebuildStats | Error> {
+  const start = Date.now();
+  const capture = captureBytes(io);
+  try {
+    const code = await bundleOne(capture.sink, args, book.dir, book.name, true);
+    if (code !== 0) {
+      return new Error(`bundle exited with code ${code}`);
+    }
+    return { bytes: capture.bytes(), ms: Date.now() - start };
+  } catch (error) {
+    return error as Error;
+  }
+}
+/** Run one rebuild and emit its bundled/error event. */
+async function rebuildAndReport(io: IO, args: ParsedArgs, style: Style, book: Book): Promise<void> {
+  const result = await rebuild(io, args, book);
+  if (result instanceof Error) {
+    emitEvent(io, args, style, "error", { book: book.name, message: result.message });
+  } else {
+    emitEvent(io, args, style, "bundled", { book: book.name, bytes: result.bytes, ms: result.ms });
+  }
+}
+/**
+ * `watch [<dir>]`: rebuild `book.generated.ts` whenever fragments, rules,
+ * compositions, code-prompts or `promptbook.json` change. Streams one short
+ * line per rebuild to stderr (`[clock] <book> bundled (<bytes> B, <ms>ms)`);
+ * stdout stays empty (the contract: stdout = payload, watch has no payload).
+ *
+ * Discovers every book under the prompts folder and rebuilds each once on
+ * startup, then debounces per-book events with a 250 ms window so a burst of
+ * edits collapses into one rebuild. SIGINT / SIGTERM closes the watcher and
+ * exits 0. Honors `--plain`, `--exclude-code-prompts`, `--json`, and the
+ * config / `--dir` resolution chain.
+ *
+ * `--out <file>` only works in a single-book workspace; the multi-book mode
+ * always writes each book's artifact next to its sources.
+ */
+export async function cmdWatch(args: ParsedArgs, io: IO): Promise<number> {
+  if (args.check) {
+    io.stderr("error: --check is not supported by watch (run `bundle --check --all` from CI)\n");
+    return 1;
+  }
+  const promptsDir = await requirePromptsDir(io, args.operands[0] ?? args.dir);
+  if (promptsDir === null) {
+    return 1;
+  }
+  const workspace = await loadWorkspace(io, promptsDir);
+  if (workspace.books.length === 0) {
+    io.stderr(`error: no books found under ${promptsDir}\n`);
+    return 1;
+  }
+  if (args.out !== undefined && workspace.books.length > 1) {
+    io.stderr("error: --out requires a single book; drop --out to write each book's book.generated.ts\n");
+    return 1;
+  }
+  const style = makeStyle(colorEnabled(io));
+  emitEvent(io, args, style, "started", { books: workspace.books.map((b) => b.name) });
+  // Initial pass runs in parallel: each book writes its own artifact, no contention.
+  await Promise.all(workspace.books.map((book) => rebuildAndReport(io, args, style, book)));
+  const watcher = chokidarWatch(promptsDir, {
+    ignoreInitial: true,
+    awaitWriteFinish: { stabilityThreshold: 50, pollInterval: 25 },
+    ignored: (eventPath) => shouldIgnore(eventPath),
+  });
+  const timers = new Map<string, NodeJS.Timeout>();
+  const scheduleRebuild = (book: Book): void => {
+    const existing = timers.get(book.name);
+    if (existing !== undefined) {
+      clearTimeout(existing);
+    }
+    const timer = setTimeout(() => {
+      timers.delete(book.name);
+      void rebuildAndReport(io, args, style, book);
+    }, DEBOUNCE_MS);
+    timers.set(book.name, timer);
+  };
+  watcher.on("all", (_event, eventPath) => {
+    const book = workspace.books.find((b) => eventInBook(b, eventPath));
+    if (book === undefined) {
+      return;
+    }
+    scheduleRebuild(book);
+  });
+  // Hold the promise open until SIGINT / SIGTERM closes the watcher.
+  return new Promise<number>((resolveDone) => {
+    let stopped = false;
+    const stop = async (): Promise<void> => {
+      if (stopped) {
+        return;
+      }
+      stopped = true;
+      for (const timer of timers.values()) {
+        clearTimeout(timer);
+      }
+      timers.clear();
+      await watcher.close();
+      emitEvent(io, args, style, "stopped");
+      process.off("SIGINT", stop);
+      process.off("SIGTERM", stop);
+      resolveDone(0);
+    };
+    process.once("SIGINT", stop);
+    process.once("SIGTERM", stop);
+  });
+}

package/src/run.ts CHANGED Viewed

@@ -8,9 +8,10 @@ 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, type IO } from "./io.js";
-const HELP = `promptbook — compose prompts from reusable fragments
+const HELP = `promptbook · compose prompts from reusable fragments
 Usage:
   promptbook <command> [options]
@@ -19,7 +20,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)
@@ -39,13 +41,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
@@ -98,6 +102,8 @@ export async function run(argv: string[], io: IO = defaultIO()): Promise<number>
       return cmdEval(args, io);
     case "bundle":
       return cmdBundle(args, io);
+    case "watch":
+      return cmdWatch(args, io);
     case "view":
       return cmdView(args, io);
     case "annotations":