@markbrutx/promptbook-cli 0.1.0

package/dist/src/commands/lint.js

@@ -0,0 +1,66 @@
+import { defaultRules, lint, loadPrompts, resolveBook } from "@markbrutx/promptbook-core";
+import { buildContext, lintConfigFrom, loadConfig, requirePromptsDir } from "../config.js";
+import { colorEnabled, emitWarnings } from "../io.js";
+import { renderLintReport } from "../render-lint.js";
+/**
+ * `lint [<prompt>]`: run static checks over the prompts folder. With a prompt
+ * it resolves under the given context and runs both book- and resolved-scope
+ * rules; without one it runs book-scope rules over the whole book. The report
+ * (human-readable or `--json`) goes to stdout; warnings go to stderr. Exit is
+ * non-zero when any error is found, or any warning under `--strict`.
+ */
+export async function cmdLint(args, io) {
+    const config = await loadConfig(io);
+    const promptsDir = await requirePromptsDir(io, args.dir, config);
+    if (promptsDir === null) {
+        return 1;
+    }
+    const lintConfig = lintConfigFrom(config);
+    const ruleOptions = {};
+    const maxTokens = args.maxTokens ?? lintConfig.maxTokens;
+    if (maxTokens !== undefined) {
+        ruleOptions.maxTokens = maxTokens;
+    }
+    if (lintConfig.bannedTokens !== undefined) {
+        ruleOptions.bannedTokens = lintConfig.bannedTokens;
+    }
+    const rules = defaultRules(ruleOptions);
+    const book = await loadPrompts(promptsDir, io.fs);
+    const prompt = args.operands[0];
+    let report;
+    let label;
+    let warnings = book.warnings;
+    try {
+        if (prompt !== undefined) {
+            const context = await buildContext(io, args.ctx, args.contextFile);
+            const result = resolveBook(book, prompt, context);
+            // trace.warnings already includes the load-time book.warnings.
+            warnings = result.trace.warnings;
+            report = lint({ book, result }, rules);
+            label = prompt;
+        }
+        else {
+            report = lint({ book }, rules);
+            label = "book";
+        }
+    }
+    catch (error) {
+        io.stderr(`error: ${error.message}\n`);
+        return 1;
+    }
+    emitWarnings(io, warnings);
+    if (args.json) {
+        io.stdout(`${JSON.stringify(report, null, 2)}\n`);
+    }
+    else {
+        io.stdout(renderLintReport(report, label, colorEnabled(io)));
+    }
+    if (report.errorCount > 0) {
+        return 1;
+    }
+    if (args.strict && report.warningCount > 0) {
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=lint.js.map

package/dist/src/commands/lint.js.map

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

package/dist/src/commands/ls.d.ts

@@ -0,0 +1,11 @@
+import type { ParsedArgs } from "../args.js";
+import { type IO } from "../io.js";
+/**
+ * `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.
+ */
+export declare function cmdLs(args: ParsedArgs, io: IO): Promise<number>;
+//# sourceMappingURL=ls.d.ts.map

package/dist/src/commands/ls.d.ts.map

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

package/dist/src/commands/ls.js

@@ -0,0 +1,84 @@
+import { relative } from "node:path";
+import { loadPrompts } from "@markbrutx/promptbook-core";
+import { requirePromptsDir } from "../config.js";
+import { emitWarnings } from "../io.js";
+/**
+ * `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.
+ */
+export async function cmdLs(args, io) {
+    const promptsDir = await requirePromptsDir(io, args.dir);
+    if (promptsDir === null) {
+        return 1;
+    }
+    const book = await loadPrompts(promptsDir, io.fs);
+    emitWarnings(io, book.warnings);
+    const onlyOneSection = args.fragments || args.compositions;
+    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 fragments = [...book.fragments.values()].sort((a, b) => a.id.localeCompare(b.id));
+    if (args.json) {
+        const out = {};
+        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,
+            }));
+        }
+        if (showFragments) {
+            out.fragments = fragments.map((f) => ({
+                id: f.id,
+                kind: f.kind ?? null,
+                tags: f.tags ?? [],
+                sourceFile: f.sourceFile,
+            }));
+        }
+        io.stdout(`${JSON.stringify(out, null, 2)}\n`);
+        return 0;
+    }
+    const lines = [];
+    if (showCompositions) {
+        lines.push("compositions:");
+        if (compositions.length === 0) {
+            lines.push("  (none)");
+        }
+        for (const c of compositions) {
+            lines.push(`  ${c.name}  base=${c.base.length}  rules=${c.rules.length}`);
+        }
+        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}`);
+            }
+        }
+    }
+    if (showFragments) {
+        if (lines.length > 0) {
+            lines.push("");
+        }
+        lines.push("fragments:");
+        if (fragments.length === 0) {
+            lines.push("  (none)");
+        }
+        for (const f of fragments) {
+            const tags = f.tags && f.tags.length > 0 ? f.tags.join(",") : "-";
+            const source = relative(promptsDir, f.sourceFile) || f.sourceFile;
+            lines.push(`  ${f.id}  kind=${f.kind ?? "-"}  tags=${tags}  ${source}`);
+        }
+    }
+    io.stdout(`${lines.join("\n")}\n`);
+    return 0;
+}
+//# sourceMappingURL=ls.js.map

package/dist/src/commands/ls.js.map

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

package/dist/src/commands/resolve.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedArgs } from "../args.js";
+import { type IO } from "../io.js";
+/**
+ * `resolve <prompt>`: assemble the prompt and print its text to stdout. With
+ * `--json`, print `{ text, trace }` instead; with `--explain`, additionally
+ * print the trace to stderr. Warnings always go to stderr so nothing is lost.
+ */
+export declare function cmdResolve(args: ParsedArgs, io: IO): Promise<number>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/src/commands/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/commands/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAA8B,KAAK,EAAE,EAAE,MAAM,UAAU,CAAC;AAG/D;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC1E"}

package/dist/src/commands/resolve.js

@@ -0,0 +1,41 @@
+import { resolve } from "@markbrutx/promptbook-core";
+import { buildContext, requirePromptsDir } from "../config.js";
+import { colorEnabled, emitWarnings } from "../io.js";
+import { renderExplain } from "../render-explain.js";
+/**
+ * `resolve <prompt>`: assemble the prompt and print its text to stdout. With
+ * `--json`, print `{ text, trace }` instead; with `--explain`, additionally
+ * print the trace to stderr. Warnings always go to stderr so nothing is lost.
+ */
+export async function cmdResolve(args, io) {
+    const prompt = args.operands[0];
+    if (prompt === undefined) {
+        io.stderr('error: resolve requires a <prompt> name. Run "promptbook --help".\n');
+        return 1;
+    }
+    const promptsDir = await requirePromptsDir(io, args.dir);
+    if (promptsDir === null) {
+        return 1;
+    }
+    let result;
+    try {
+        const context = await buildContext(io, args.ctx, args.contextFile);
+        result = await resolve({ promptsDir, prompt, context, fs: io.fs });
+    }
+    catch (error) {
+        io.stderr(`error: ${error.message}\n`);
+        return 1;
+    }
+    const { text, trace } = result;
+    emitWarnings(io, trace.warnings);
+    if (args.json) {
+        io.stdout(`${JSON.stringify({ text, trace }, null, 2)}\n`);
+        return 0;
+    }
+    if (args.explain) {
+        io.stderr(renderExplain(trace, colorEnabled(io)));
+    }
+    io.stdout(`${text}\n`);
+    return 0;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/src/commands/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/commands/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAW,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB,EAAE,EAAM;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,EAAE,CAAC,MAAM,CAAC,qEAAqE,CAAC,CAAC;QACjF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACnE,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACrE,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,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEjC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/src/commands/view.d.ts

@@ -0,0 +1,30 @@
+import type { ParsedArgs } from "../args.js";
+import type { IO } from "../io.js";
+/** Options forwarded to `@markbrutx/promptbook-viewer`'s `startViewer`. */
+export interface ViewerStartOptions {
+    promptsDir: string;
+    port?: number;
+    open: boolean;
+}
+/** The subset of the viewer's running handle the CLI uses. */
+export interface ViewerHandle {
+    url: string;
+    close(): Promise<void>;
+}
+/**
+ * Injectable seam for `view`: how to start the viewer and how to keep the
+ * process alive. Defaults dynamically import the optional `@markbrutx/promptbook-viewer`
+ * package and block until a termination signal; tests inject fakes so no
+ * server or signal handling is needed.
+ */
+export interface ViewDeps {
+    start(options: ViewerStartOptions): Promise<ViewerHandle>;
+    hold(handle: ViewerHandle): Promise<number>;
+}
+/**
+ * `view`: start the local web viewer over the prompts folder, print its URL,
+ * and keep running until interrupted. Render-only; the viewer makes no model
+ * calls. `--no-open` skips launching the browser; `--port` pins the port.
+ */
+export declare function cmdView(args: ParsedArgs, io: IO, deps?: ViewDeps): Promise<number>;
+//# sourceMappingURL=view.d.ts.map

package/dist/src/commands/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/commands/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AA8BD;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,GAAE,QAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBzG"}

package/dist/src/commands/view.js

@@ -0,0 +1,51 @@
+import { requirePromptsDir } from "../config.js";
+/** Thrown by the default `start` when the optional viewer package is absent. */
+class ViewerNotInstalledError extends Error {
+}
+const defaultViewDeps = {
+    async start(options) {
+        let mod;
+        try {
+            mod = (await import("@markbrutx/promptbook-viewer"));
+        }
+        catch {
+            throw new ViewerNotInstalledError();
+        }
+        return mod.startViewer(options);
+    },
+    hold(handle) {
+        return new Promise((resolve) => {
+            const shutdown = () => {
+                void handle.close().then(() => resolve(0));
+            };
+            process.once("SIGINT", shutdown);
+            process.once("SIGTERM", shutdown);
+        });
+    },
+};
+/**
+ * `view`: start the local web viewer over the prompts folder, print its URL,
+ * and keep running until interrupted. Render-only; the viewer makes no model
+ * calls. `--no-open` skips launching the browser; `--port` pins the port.
+ */
+export async function cmdView(args, io, deps = defaultViewDeps) {
+    const promptsDir = await requirePromptsDir(io, args.dir);
+    if (promptsDir === null) {
+        return 1;
+    }
+    let handle;
+    try {
+        handle = await deps.start({ promptsDir, port: args.port, open: !args.noOpen });
+    }
+    catch (error) {
+        if (error instanceof ViewerNotInstalledError) {
+            io.stderr('error: the viewer is not installed. Add it with "npm i -D @markbrutx/promptbook-viewer".\n');
+            return 1;
+        }
+        io.stderr(`error: ${error.message}\n`);
+        return 1;
+    }
+    io.stdout(`promptbook viewer running at ${handle.url}\n`);
+    return deps.hold(handle);
+}
+//# sourceMappingURL=view.js.map

package/dist/src/commands/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/commands/view.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA2BjD,gFAAgF;AAChF,MAAM,uBAAwB,SAAQ,KAAK;CAAG;AAM9C,MAAM,eAAe,GAAa;IAChC,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,IAAI,GAAiB,CAAC;QACtB,IAAI,CAAC;YACH,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAA4B,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,uBAAuB,EAAE,CAAC;QACtC,CAAC;QACD,OAAO,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,MAAM;QACT,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACrC,MAAM,QAAQ,GAAG,GAAS,EAAE;gBAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,CAAC,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAgB,EAAE,EAAM,EAAE,IAAI,GAAa,eAAe;IACtF,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAoB,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;YAC7C,EAAE,CAAC,MAAM,CAAC,4FAA4F,CAAC,CAAC;YACxG,OAAO,CAAC,CAAC;QACX,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,UAAW,KAAe,CAAC,OAAO,IAAI,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,EAAE,CAAC,MAAM,CAAC,gCAAgC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,56 @@
+import type { Context, ContextValue } from "@markbrutx/promptbook-core";
+import type { IO } from "./io.js";
+/**
+ * Coerce a raw `--ctx` value to a {@link ContextValue}: `true`/`false` become
+ * booleans, integer/decimal literals become numbers, everything else stays a
+ * string. For values that must stay strings (e.g. "123"), use `--context-file`.
+ */
+export declare function coerceScalar(raw: string): ContextValue;
+/** Parse repeated `key=value` pairs into a context bag, coercing each value. */
+export declare function parseCtxPairs(pairs: string[]): Context;
+/**
+ * Build the resolve context: `--context-file` first, then `--ctx` pairs layered
+ * on top so explicit flags win over the file.
+ */
+export declare function buildContext(io: IO, pairs: string[], contextFile?: string): Promise<Context>;
+interface PromptbookConfig {
+    promptsDir?: unknown;
+    lint?: unknown;
+    eval?: unknown;
+}
+/** 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.
+ */
+export declare function loadConfig(io: IO): Promise<PromptbookConfig>;
+/** Extract the `lint` section from an already-loaded config. */
+export declare function lintConfigFrom(config: PromptbookConfig): 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`. */
+export interface EvalConfig {
+    model?: string;
+    baseUrl?: string;
+}
+/** Extract the `eval` section from an already-loaded config. */
+export declare function evalConfigFrom(config: PromptbookConfig): 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.
+ */
+export declare function resolvePromptsDir(io: IO, dirFlag?: string, config?: PromptbookConfig): 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 {};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/config.js

@@ -0,0 +1,175 @@
+import { 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) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Coerce a raw `--ctx` value to a {@link ContextValue}: `true`/`false` become
+ * booleans, integer/decimal literals become numbers, everything else stays a
+ * string. For values that must stay strings (e.g. "123"), use `--context-file`.
+ */
+export function coerceScalar(raw) {
+    if (raw === "true") {
+        return true;
+    }
+    if (raw === "false") {
+        return false;
+    }
+    if (NUMERIC.test(raw)) {
+        return Number(raw);
+    }
+    return raw;
+}
+/** Parse repeated `key=value` pairs into a context bag, coercing each value. */
+export function parseCtxPairs(pairs) {
+    const context = {};
+    for (const pair of pairs) {
+        const eq = pair.indexOf("=");
+        if (eq === -1) {
+            throw new Error(`invalid --ctx "${pair}"; expected key=value`);
+        }
+        const key = pair.slice(0, eq);
+        if (key === "") {
+            throw new Error(`invalid --ctx "${pair}"; key is empty`);
+        }
+        context[key] = coerceScalar(pair.slice(eq + 1));
+    }
+    return context;
+}
+function parseContextFile(raw, path) {
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`context file "${path}" is not valid JSON: ${error.message}`);
+    }
+    if (!isJsonObject(data)) {
+        throw new Error(`context file "${path}" must be a JSON object`);
+    }
+    const context = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            context[key] = value;
+        }
+        else {
+            throw new Error(`context file "${path}" key "${key}" must be a string, number or boolean`);
+        }
+    }
+    return context;
+}
+/**
+ * Build the resolve context: `--context-file` first, then `--ctx` pairs layered
+ * on top so explicit flags win over the file.
+ */
+export async function buildContext(io, pairs, contextFile) {
+    let fileContext = {};
+    if (contextFile !== undefined) {
+        const path = resolvePath(io.cwd(), contextFile);
+        let raw;
+        try {
+            raw = await io.fs.readFile(path);
+        }
+        catch {
+            throw new Error(`context file not found: ${path}`);
+        }
+        fileContext = parseContextFile(raw, path);
+    }
+    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.
+ */
+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 {};
+    }
+}
+/** Extract the `lint` section from an already-loaded config. */
+export function lintConfigFrom(config) {
+    const section = config.lint;
+    if (!isJsonObject(section)) {
+        return {};
+    }
+    const lint = {};
+    if (typeof section.maxTokens === "number") {
+        lint.maxTokens = section.maxTokens;
+    }
+    if (Array.isArray(section.bannedTokens)) {
+        lint.bannedTokens = section.bannedTokens.filter((token) => typeof token === "string");
+    }
+    return lint;
+}
+/** Convenience wrapper: load config and extract its `lint` section. */
+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;
+    if (!isJsonObject(section)) {
+        return {};
+    }
+    const evalConfig = {};
+    if (typeof section.model === "string") {
+        evalConfig.model = section.model;
+    }
+    if (typeof section.baseUrl === "string") {
+        evalConfig.baseUrl = section.baseUrl;
+    }
+    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.
+ */
+export async function resolvePromptsDir(io, dirFlag, config) {
+    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);
+    }
+    return resolvePath(io.cwd(), "prompts");
+}
+/** Whether a directory can be listed; used to give a clear missing-folder error. */
+async function dirExists(io, dir) {
+    try {
+        await io.fs.readDir(dir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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);
+    if (!(await dirExists(io, promptsDir))) {
+        io.stderr(`error: prompts folder not found: ${promptsDir}\n`);
+        return null;
+    }
+    return promptsDir;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export type { ParsedArgs } from "./args.js";
+export type { IO } from "./io.js";
+export { run } from "./run.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,2 @@
+export { run } from "./run.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/io.d.ts

@@ -0,0 +1,43 @@
+import type { FsAdapter, ModelAdapter } from "@markbrutx/promptbook-core";
+/** Options the `eval` command needs to build a model adapter. */
+export interface AdapterOptions {
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+}
+/**
+ * Injectable side-effect surface for the CLI.
+ *
+ * Keeping stdout/stderr/cwd/fs behind this interface lets {@link run} be driven
+ * from tests without spawning a process. The stream contract is fixed:
+ * **stdout = payload** (prompt text or JSON), **stderr = explanations/errors**.
+ */
+export interface IO {
+    /** Write payload bytes verbatim (the command appends its own newlines). */
+    stdout(text: string): void;
+    /** Write explanations, warnings and errors verbatim. */
+    stderr(text: string): void;
+    /** Write a file to disk, creating parent directories as needed (e.g. `bundle -o`). */
+    writeFile(path: string, contents: string): Promise<void>;
+    /** Current working directory, used to resolve relative paths and config. */
+    cwd(): string;
+    /** Environment bag, consulted for `NO_COLOR`. */
+    env: Record<string, string | undefined>;
+    /** Filesystem adapter passed straight through to the core. */
+    fs: FsAdapter;
+    /** Whether color is allowed when `NO_COLOR` is unset (true on a TTY). */
+    colorDefault: boolean;
+    /**
+     * Build the model adapter for `eval`. Tests inject a fake so no network or
+     * key is needed; when unset, the command falls back to the OpenRouter
+     * adapter built from flags/config/env.
+     */
+    makeAdapter?(options: AdapterOptions): ModelAdapter;
+}
+/** Real-process IO: stdout/stderr streams, Node fs, live env and cwd. */
+export declare function defaultIO(): IO;
+/** Emit each warning to stderr with the standard `warning:` prefix. */
+export declare function emitWarnings(io: IO, warnings: string[]): void;
+/** Resolve whether colored output is allowed: off if `NO_COLOR` is set. */
+export declare function colorEnabled(io: IO): boolean;
+//# sourceMappingURL=io.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/io.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1E,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,EAAE;IACjB,2EAA2E;IAC3E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wDAAwD;IACxD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sFAAsF;IACtF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,4EAA4E;IAC5E,GAAG,IAAI,MAAM,CAAC;IACd,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,8DAA8D;IAC9D,EAAE,EAAE,SAAS,CAAC;IACd,yEAAyE;IACzE,YAAY,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAAC;CACrD;AAED,yEAAyE;AACzE,wBAAgB,SAAS,IAAI,EAAE,CAiB9B;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAI7D;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAM5C"}