@markbrutx/promptbook-cli 0.1.0 → 0.3.0

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;AAkD7C;;;;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":"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"}

package/dist/src/run.js

@@ -15,13 +15,16 @@ Usage:
   promptbook <command> [options]
 
 Commands:
-  resolve <prompt>        Assemble a prompt and print it to stdout
+  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
-  view                    Start the local web viewer over the prompts folder
+  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
+  ls                      List compositions and fragments (--all: cross-book inventory)
+
+A <book>/<comp> operand addresses one book in a multi-book workspace; a bare
+name resolves by uniqueness. With a single-book --dir, names work unqualified.
 
 Options:
   --dir <path>            Prompts folder (default: promptbook.json promptsDir, else ./prompts)
@@ -41,6 +44,7 @@ Options:
   --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
   -h, --help              Show this help
   -v, --version           Show the version
 

package/dist/src/run.js.map

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

package/dist/src/workspace.d.ts

@@ -0,0 +1,51 @@
+import type { PromptBook } from "@markbrutx/promptbook-core";
+import type { IO } from "./io.js";
+/** A discovered prompts book: its folder name and absolute directory. */
+export interface Book {
+    name: string;
+    dir: string;
+}
+/** A workspace root and the books found directly under it (sorted by name). */
+export interface Workspace {
+    root: string;
+    books: Book[];
+}
+/** A `<book>/<comp>` operand split into its parts (`book` absent for bare names). */
+export interface Address {
+    book?: string;
+    comp: string;
+}
+/** A bare/qualified operand resolved to a concrete book + composition name. */
+export interface ResolvedAddress {
+    book: Book;
+    comp: string;
+    /** The matched book, already loaded during bare-name resolution (reuse to skip a reload). */
+    loaded?: PromptBook;
+}
+/** True when `dir` looks like a prompts book (has a config or a loadable form). */
+export declare function isBook(io: IO, dir: string): Promise<boolean>;
+/**
+ * Find the books directly under `rootDir`: each non-internal subfolder that is
+ * itself a book. One level deep, not recursive; sorted by name for a stable
+ * menu. Dot/underscore folders and book internals are skipped.
+ */
+export declare function discoverBooks(io: IO, rootDir: string): Promise<Book[]>;
+/**
+ * Read a workspace from `rootDir`. When the root is itself a book it is the only
+ * book (back-compat single-book path, named after the folder); otherwise the
+ * root is a workspace of its sub-books.
+ */
+export declare function loadWorkspace(io: IO, rootDir: string): Promise<Workspace>;
+/** Split an operand on the first `/`: `book/comp` (comp may itself contain `/`). */
+export declare function parseAddress(operand: string): Address;
+/** A book's directory relative to the workspace root (`.` when it is the root). */
+export declare function bookDir(workspace: Workspace, book: Book): string;
+/**
+ * Resolve an operand to a concrete book + composition. A `<book>/<comp>` prefix
+ * that names a known book addresses it directly; otherwise the whole operand is
+ * a bare composition name, resolved by uniqueness across the workspace's books
+ * (a single-book workspace always uses its one book). Throws a clear error when
+ * a bare name is missing or ambiguous.
+ */
+export declare function resolveAddress(io: IO, workspace: Workspace, operand: string): Promise<ResolvedAddress>;
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/workspace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAElC,yEAAyE;AACzE,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,+EAA+E;AAC/E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,qFAAqF;AACrF,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAQD,mFAAmF;AACnF,wBAAsB,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQlE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAkB5E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAK/E;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMrD;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhE;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC,CAiC1B"}

package/dist/src/workspace.js

@@ -0,0 +1,103 @@
+import { basename, join, relative } from "node:path";
+import { loadPrompts } from "@markbrutx/promptbook-core";
+/** Folder names that are book internals or noise, never workspace sub-books. */
+const NON_BOOK_DIRS = new Set(["node_modules", "fragments", "rules", "code-prompts"]);
+/** Markers that make a folder a loadable book (a config or a loadable form). */
+const BOOK_MARKERS = ["promptbook.json", "rules", "code-prompts"];
+/** True when `dir` looks like a prompts book (has a config or a loadable form). */
+export async function isBook(io, dir) {
+    let entries;
+    try {
+        entries = await io.fs.readDir(dir);
+    }
+    catch {
+        return false;
+    }
+    return BOOK_MARKERS.some((marker) => entries.includes(marker));
+}
+/**
+ * Find the books directly under `rootDir`: each non-internal subfolder that is
+ * itself a book. One level deep, not recursive; sorted by name for a stable
+ * menu. Dot/underscore folders and book internals are skipped.
+ */
+export async function discoverBooks(io, rootDir) {
+    let entries;
+    try {
+        entries = await io.fs.readDir(rootDir);
+    }
+    catch {
+        return [];
+    }
+    const books = [];
+    for (const name of [...entries].sort()) {
+        if (name.startsWith(".") || name.startsWith("_") || NON_BOOK_DIRS.has(name)) {
+            continue;
+        }
+        const dir = join(rootDir, name);
+        if (await isBook(io, dir)) {
+            books.push({ name, dir });
+        }
+    }
+    return books;
+}
+/**
+ * Read a workspace from `rootDir`. When the root is itself a book it is the only
+ * book (back-compat single-book path, named after the folder); otherwise the
+ * root is a workspace of its sub-books.
+ */
+export async function loadWorkspace(io, rootDir) {
+    if (await isBook(io, rootDir)) {
+        return { root: rootDir, books: [{ name: basename(rootDir), dir: rootDir }] };
+    }
+    return { root: rootDir, books: await discoverBooks(io, rootDir) };
+}
+/** Split an operand on the first `/`: `book/comp` (comp may itself contain `/`). */
+export function parseAddress(operand) {
+    const slash = operand.indexOf("/");
+    if (slash === -1) {
+        return { comp: operand };
+    }
+    return { book: operand.slice(0, slash), comp: operand.slice(slash + 1) };
+}
+/** A book's directory relative to the workspace root (`.` when it is the root). */
+export function bookDir(workspace, book) {
+    return relative(workspace.root, book.dir) || ".";
+}
+/**
+ * Resolve an operand to a concrete book + composition. A `<book>/<comp>` prefix
+ * that names a known book addresses it directly; otherwise the whole operand is
+ * a bare composition name, resolved by uniqueness across the workspace's books
+ * (a single-book workspace always uses its one book). Throws a clear error when
+ * a bare name is missing or ambiguous.
+ */
+export async function resolveAddress(io, workspace, operand) {
+    const address = parseAddress(operand);
+    if (address.book !== undefined) {
+        const book = workspace.books.find((b) => b.name === address.book);
+        if (book !== undefined) {
+            return { book, comp: address.comp };
+        }
+        // Prefix names no book: fall through and treat the whole operand as a
+        // (possibly path-like) bare composition name.
+    }
+    if (workspace.books.length === 1) {
+        return { book: workspace.books[0], comp: operand };
+    }
+    const matches = [];
+    for (const book of workspace.books) {
+        const loaded = await loadPrompts(book.dir, io.fs);
+        if (loaded.compositions.has(operand)) {
+            matches.push({ book, loaded });
+        }
+    }
+    const [first] = matches;
+    if (matches.length === 1 && first !== undefined) {
+        return { book: first.book, comp: operand, loaded: first.loaded };
+    }
+    if (matches.length === 0) {
+        throw new Error(`Unknown prompt "${operand}" in any book. Qualify it as <book>/<comp>.`);
+    }
+    const names = matches.map((m) => m.book.name).join(", ");
+    throw new Error(`Ambiguous prompt "${operand}"; found in ${matches.length} books (${names}). Qualify it as <book>/<comp>.`);
+}
+//# sourceMappingURL=workspace.js.map

package/dist/src/workspace.js.map

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

package/package.json

@@ -1,11 +1,28 @@
 {
   "name": "@markbrutx/promptbook-cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Thin terminal surface over @markbrutx/promptbook-core: resolve and ls for agents and CI.",
   "type": "module",
   "license": "MIT",
+  "keywords": [
+    "prompt",
+    "prompt-engineering",
+    "prompt-management",
+    "llm",
+    "ai",
+    "cli",
+    "composition",
+    "storybook"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/markbrutx/promptbook.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/markbrutx/promptbook#readme",
+  "bugs": "https://github.com/markbrutx/promptbook/issues",
   "bin": {
-    "promptbook": "./dist/bin/promptbook.js"
+    "promptbook": "dist/bin/promptbook.js"
   },
   "exports": {
     ".": {
@@ -31,11 +48,11 @@
     "check": "biome check ."
   },
   "dependencies": {
-    "@markbrutx/promptbook-core": "^0.1.0",
-    "@markbrutx/promptbook-openrouter": "^0.1.0"
+    "@markbrutx/promptbook-core": "^0.3.0",
+    "@markbrutx/promptbook-openrouter": "^0.3.0"
   },
   "optionalDependencies": {
-    "@markbrutx/promptbook-viewer": "^0.1.0"
+    "@markbrutx/promptbook-viewer": "^0.3.0"
   },
   "devDependencies": {
     "@biomejs/biome": "latest",

package/src/args.ts

@@ -20,6 +20,8 @@ export interface ParsedArgs {
   contextFile?: string;
   fragments: boolean;
   compositions: boolean;
+  /** ls/resolve: operate across every book in the workspace. */
+  all: boolean;
   /** lint: estimated token ceiling for the token-budget rule. */
   maxTokens?: number;
   /** lint: treat warnings as failures for the exit code. */
@@ -88,6 +90,7 @@ export function parseCliArgs(argv: string[]): ParsedArgs {
       "context-file": { type: "string" },
       fragments: { type: "boolean" },
       compositions: { type: "boolean" },
+      all: { type: "boolean" },
       "max-tokens": { type: "string" },
       strict: { type: "boolean" },
       model: { type: "string" },
@@ -133,6 +136,7 @@ export function parseCliArgs(argv: string[]): ParsedArgs {
     contextFile: values["context-file"],
     fragments: values.fragments ?? false,
     compositions: values.compositions ?? false,
+    all: values.all ?? false,
     maxTokens,
     strict: values.strict ?? false,
     model: values.model,

package/src/commands/ls.ts

@@ -1,15 +1,112 @@
-import { relative } from "node:path";
-import { loadPrompts } from "@markbrutx/promptbook-core";
+import { basename, relative } from "node:path";
+import type { PromptBook, RequiredContext } from "@markbrutx/promptbook-core";
+import { loadPrompts, requiredContext } from "@markbrutx/promptbook-core";
 import type { ParsedArgs } from "../args.js";
 import { requirePromptsDir } from "../config.js";
 import { emitWarnings, type IO } from "../io.js";
+import { bookDir, loadWorkspace } from "../workspace.js";
+
+interface CompositionEntry {
+  name: string;
+  base: number;
+  rules: number;
+  requiredContext: RequiredContext;
+}
+
+interface CodePromptEntry {
+  name: string;
+  description: string | null;
+  samples: number;
+}
+
+/** Composition rows for the menu: counts plus the statically-declared context. */
+function compositionEntries(book: PromptBook): CompositionEntry[] {
+  return [...book.compositions.values()]
+    .sort((a, b) => a.name.localeCompare(b.name))
+    .map((c) => ({
+      name: c.name,
+      base: c.base.length,
+      rules: c.rules.length,
+      requiredContext: requiredContext(book, c.name),
+    }));
+}
+
+/** Code-prompt rows: builder metadata only (opaque; no requiredContext). */
+function codePromptEntries(book: PromptBook): CodePromptEntry[] {
+  return [...book.codePrompts.values()]
+    .sort((a, b) => a.name.localeCompare(b.name))
+    .map((c) => ({ name: c.name, description: c.description ?? null, samples: c.samples.length }));
+}
+
+/** Compact one-line context summary for the plain `--all` tree. */
+function ctxSummary(rc: RequiredContext): string {
+  const vars = rc.vars.length > 0 ? rc.vars.join(",") : "-";
+  const axes =
+    Object.entries(rc.axes)
+      .map(([key, values]) => `${key}=${values.join("|")}`)
+      .join(" ") || "-";
+  return `vars=${vars} axes=${axes}`;
+}
+
+/**
+ * `ls --all`: a cross-book inventory of the whole workspace. Discovers every
+ * book under the root, loads each, and emits the menu (compositions with their
+ * required context + code-prompts) — `--json` as `{ workspace, books[] }`,
+ * plain as an indented book→composition tree. Order is deterministic (books and
+ * compositions sorted by name).
+ */
+async function cmdLsAll(io: IO, root: string, json: boolean): Promise<number> {
+  const workspace = await loadWorkspace(io, root);
+  const books = await Promise.all(
+    workspace.books.map(async (b) => {
+      const book = await loadPrompts(b.dir, io.fs);
+      return {
+        name: b.name,
+        dir: bookDir(workspace, b),
+        compositions: compositionEntries(book),
+        codePrompts: codePromptEntries(book),
+        warnings: book.warnings,
+      };
+    }),
+  );
+
+  if (json) {
+    io.stdout(`${JSON.stringify({ workspace: basename(workspace.root), books }, null, 2)}\n`);
+    return 0;
+  }
+
+  const lines: string[] = [`workspace: ${basename(workspace.root)}`];
+  if (books.length === 0) {
+    lines.push("  (no books found)");
+  }
+  for (const book of books) {
+    lines.push("", `${book.name}  (${book.dir})`);
+    lines.push("  compositions:");
+    if (book.compositions.length === 0) {
+      lines.push("    (none)");
+    }
+    for (const c of book.compositions) {
+      lines.push(`    ${c.name}  base=${c.base} rules=${c.rules}  ctx: ${ctxSummary(c.requiredContext)}`);
+    }
+    if (book.codePrompts.length > 0) {
+      lines.push("  code-prompts:");
+      for (const c of book.codePrompts) {
+        lines.push(`    ${c.name}  kind=code samples=${c.samples}`);
+      }
+    }
+    emitWarnings(io, book.warnings);
+  }
+  io.stdout(`${lines.join("\n")}\n`);
+  return 0;
+}
 
 /**
- * `ls`: list compositions (name, base length, rule count), code-prompts
- * (name, description, sample count) and fragments (id, kind, tags, source) —
- * the unified menu of every prompt in the book. `--fragments`/`--compositions`
- * narrow the output (code-prompts ride with compositions, both being prompts);
- * `--json` emits a structured list instead of the human-readable tree.
+ * `ls`: list compositions (name, base length, rule count, required context),
+ * code-prompts (name, description, sample count) and fragments (id, kind, tags,
+ * source) — the unified menu of every prompt in the book. `--fragments`/
+ * `--compositions` narrow the output (code-prompts ride with compositions, both
+ * being prompts); `--json` emits a structured list; `--all` spans every book in
+ * the workspace instead of one folder.
  */
 export async function cmdLs(args: ParsedArgs, io: IO): Promise<number> {
   const promptsDir = await requirePromptsDir(io, args.dir);
@@ -17,6 +114,10 @@ export async function cmdLs(args: ParsedArgs, io: IO): Promise<number> {
     return 1;
   }
 
+  if (args.all) {
+    return cmdLsAll(io, promptsDir, args.json);
+  }
+
   const book = await loadPrompts(promptsDir, io.fs);
   emitWarnings(io, book.warnings);
 
@@ -24,23 +125,15 @@ export async function cmdLs(args: ParsedArgs, io: IO): Promise<number> {
   const showCompositions = args.compositions || !onlyOneSection;
   const showFragments = args.fragments || !onlyOneSection;
 
-  const compositions = [...book.compositions.values()].sort((a, b) => a.name.localeCompare(b.name));
-  const codePrompts = [...book.codePrompts.values()].sort((a, b) => a.name.localeCompare(b.name));
+  const compositions = compositionEntries(book);
+  const codePrompts = codePromptEntries(book);
   const fragments = [...book.fragments.values()].sort((a, b) => a.id.localeCompare(b.id));
 
   if (args.json) {
     const out: Record<string, unknown> = {};
     if (showCompositions) {
-      out.compositions = compositions.map((c) => ({
-        name: c.name,
-        base: c.base.length,
-        rules: c.rules.length,
-      }));
-      out.codePrompts = codePrompts.map((c) => ({
-        name: c.name,
-        description: c.description ?? null,
-        samples: c.samples.length,
-      }));
+      out.compositions = compositions;
+      out.codePrompts = codePrompts;
     }
     if (showFragments) {
       out.fragments = fragments.map((f) => ({
@@ -61,13 +154,13 @@ export async function cmdLs(args: ParsedArgs, io: IO): Promise<number> {
       lines.push("  (none)");
     }
     for (const c of compositions) {
-      lines.push(`  ${c.name}  base=${c.base.length}  rules=${c.rules.length}`);
+      lines.push(`  ${c.name}  base=${c.base}  rules=${c.rules}`);
     }
     if (codePrompts.length > 0) {
       lines.push("");
       lines.push("code-prompts:");
       for (const c of codePrompts) {
-        lines.push(`  ${c.name}  kind=code  samples=${c.samples.length}`);
+        lines.push(`  ${c.name}  kind=code  samples=${c.samples}`);
       }
     }
   }