@markbrutx/promptbook-core 0.1.0

package/dist/lint/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lint/rules/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAUtD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAO,GAAwB,EAAE;IAC5D,OAAO;QACL,WAAW,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,yBAAyB,EAAE;QAC3B,cAAc,EAAE;QAChB,YAAY,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,cAAc,EAAE;QAChB,iBAAiB,EAAE;QACnB,QAAQ,EAAE;KACX,CAAC;AACJ,CAAC;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAE7E,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/lint/rules/language-directive-position.d.ts

@@ -0,0 +1,16 @@
+import type { LintRule, Severity } from "../types.js";
+export interface LanguageDirectivePositionOptions {
+    /** Fragment `kind` that must sit at an edge. */
+    kind?: string;
+    /** How many leading/trailing positions count as an edge. */
+    edgeWindow?: number;
+    severity?: Severity;
+}
+/**
+ * `language-directive-position` (resolved): fragments of the configured kind
+ * must appear within the first or last `edgeWindow` positions of the final
+ * order. A language directive buried in the middle is easy for a model to
+ * miss, so it is flagged.
+ */
+export declare function languageDirectivePosition(options?: LanguageDirectivePositionOptions): LintRule;
+//# sourceMappingURL=language-directive-position.d.ts.map

package/dist/lint/rules/language-directive-position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-directive-position.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/language-directive-position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,gCAAgC;IAC/C,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,gCAAqC,GAAG,QAAQ,CAkClG"}

package/dist/lint/rules/language-directive-position.js

@@ -0,0 +1,42 @@
+/**
+ * `language-directive-position` (resolved): fragments of the configured kind
+ * must appear within the first or last `edgeWindow` positions of the final
+ * order. A language directive buried in the middle is easy for a model to
+ * miss, so it is flagged.
+ */
+export function languageDirectivePosition(options = {}) {
+    const kind = options.kind ?? "language-directive";
+    const edgeWindow = options.edgeWindow ?? 2;
+    const severity = options.severity ?? "warning";
+    return {
+        id: "language-directive-position",
+        description: `Fragments of kind "${kind}" should sit within the first/last ${edgeWindow} positions.`,
+        scope: "resolved",
+        check(input) {
+            const result = input.result;
+            if (result === undefined) {
+                return [];
+            }
+            const order = result.trace.finalOrder;
+            const total = order.length;
+            const findings = [];
+            order.forEach((id, position) => {
+                if (input.book.fragments.get(id)?.kind !== kind) {
+                    return;
+                }
+                const atStart = position < edgeWindow;
+                const atEnd = position >= total - edgeWindow;
+                if (!atStart && !atEnd) {
+                    findings.push({
+                        ruleId: "language-directive-position",
+                        severity,
+                        message: `fragment "${id}" (kind "${kind}") is at position ${position + 1} of ${total}, not within the first/last ${edgeWindow}`,
+                        fragmentId: id,
+                    });
+                }
+            });
+            return findings;
+        },
+    };
+}
+//# sourceMappingURL=language-directive-position.js.map

package/dist/lint/rules/language-directive-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-directive-position.js","sourceRoot":"","sources":["../../../src/lint/rules/language-directive-position.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAO,GAAqC,EAAE;IACtF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,oBAAoB,CAAC;IAClD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;IAC/C,OAAO;QACL,EAAE,EAAE,6BAA6B;QACjC,WAAW,EAAE,sBAAsB,IAAI,sCAAsC,UAAU,aAAa;QACpG,KAAK,EAAE,UAAU;QACjB,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;YACtC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;YAC3B,MAAM,QAAQ,GAAkB,EAAE,CAAC;YACnC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE;gBAC7B,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;oBAChD,OAAO;gBACT,CAAC;gBACD,MAAM,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;gBACtC,MAAM,KAAK,GAAG,QAAQ,IAAI,KAAK,GAAG,UAAU,CAAC;gBAC7C,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;oBACvB,QAAQ,CAAC,IAAI,CAAC;wBACZ,MAAM,EAAE,6BAA6B;wBACrC,QAAQ;wBACR,OAAO,EAAE,aAAa,EAAE,YAAY,IAAI,qBAAqB,QAAQ,GAAG,CAAC,OAAO,KAAK,+BAA+B,UAAU,EAAE;wBAChI,UAAU,EAAE,EAAE;qBACf,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lint/rules/token-budget.d.ts

@@ -0,0 +1,18 @@
+import type { LintRule, Severity } from "../types.js";
+/** Heuristic token estimate: ~4 characters per token. Not a real tokenizer. */
+export declare function estimateTokensByChars(text: string): number;
+export interface TokenBudgetOptions {
+    /** Maximum estimated tokens before a finding is raised. */
+    maxTokens?: number;
+    /** Inject a real token counter; defaults to the chars/4 heuristic. */
+    estimateTokens?: (text: string) => number;
+    severity?: Severity;
+}
+/**
+ * `token-budget` (resolved): estimate the assembled text's token count and
+ * report when it exceeds `maxTokens`. The estimate is a deterministic
+ * heuristic (chars/4) so the core stays dependency-free; callers can inject a
+ * precise counter via `estimateTokens`.
+ */
+export declare function tokenBudget(options?: TokenBudgetOptions): LintRule;
+//# sourceMappingURL=token-budget.d.ts.map

package/dist/lint/rules/token-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/token-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,QAAQ,CA0BtE"}

package/dist/lint/rules/token-budget.js

@@ -0,0 +1,39 @@
+/** Heuristic token estimate: ~4 characters per token. Not a real tokenizer. */
+export function estimateTokensByChars(text) {
+    return Math.ceil(text.length / 4);
+}
+const DEFAULT_MAX_TOKENS = 8000;
+/**
+ * `token-budget` (resolved): estimate the assembled text's token count and
+ * report when it exceeds `maxTokens`. The estimate is a deterministic
+ * heuristic (chars/4) so the core stays dependency-free; callers can inject a
+ * precise counter via `estimateTokens`.
+ */
+export function tokenBudget(options = {}) {
+    const maxTokens = options.maxTokens ?? DEFAULT_MAX_TOKENS;
+    const estimate = options.estimateTokens ?? estimateTokensByChars;
+    const severity = options.severity ?? "warning";
+    return {
+        id: "token-budget",
+        description: `Resolved prompt should fit within ~${maxTokens} estimated tokens.`,
+        scope: "resolved",
+        check(input) {
+            const result = input.result;
+            if (result === undefined) {
+                return [];
+            }
+            const tokens = estimate(result.text);
+            if (tokens <= maxTokens) {
+                return [];
+            }
+            return [
+                {
+                    ruleId: "token-budget",
+                    severity,
+                    message: `estimated ${tokens} tokens exceeds budget of ${maxTokens}`,
+                },
+            ];
+        },
+    };
+}
+//# sourceMappingURL=token-budget.js.map

package/dist/lint/rules/token-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.js","sourceRoot":"","sources":["../../../src/lint/rules/token-budget.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAUD,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAO,GAAuB,EAAE;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,IAAI,qBAAqB,CAAC;IACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;IAC/C,OAAO;QACL,EAAE,EAAE,cAAc;QAClB,WAAW,EAAE,sCAAsC,SAAS,oBAAoB;QAChF,KAAK,EAAE,UAAU;QACjB,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC;gBACxB,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO;gBACL;oBACE,MAAM,EAAE,cAAc;oBACtB,QAAQ;oBACR,OAAO,EAAE,aAAa,MAAM,6BAA6B,SAAS,EAAE;iBACrE;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lint/rules/unused-fragment.d.ts

@@ -0,0 +1,11 @@
+import type { LintRule, Severity } from "../types.js";
+export interface UnusedFragmentOptions {
+    severity?: Severity;
+}
+/**
+ * `unused-fragment` (book): a fragment that no composition mentions — not in a
+ * base, order, or any rule (add/replace/forbid/order/after) — is dead weight
+ * and is flagged. Findings are sorted by id for deterministic output.
+ */
+export declare function unusedFragment(options?: UnusedFragmentOptions): LintRule;
+//# sourceMappingURL=unused-fragment.d.ts.map

package/dist/lint/rules/unused-fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-fragment.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/unused-fragment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,QAAQ,CAyB5E"}

package/dist/lint/rules/unused-fragment.js

@@ -0,0 +1,33 @@
+import { iterateReferences } from "../references.js";
+/**
+ * `unused-fragment` (book): a fragment that no composition mentions — not in a
+ * base, order, or any rule (add/replace/forbid/order/after) — is dead weight
+ * and is flagged. Findings are sorted by id for deterministic output.
+ */
+export function unusedFragment(options = {}) {
+    const severity = options.severity ?? "warning";
+    return {
+        id: "unused-fragment",
+        description: "Every fragment should be referenced by at least one composition or rule.",
+        scope: "book",
+        check(input) {
+            const referenced = new Set();
+            for (const reference of iterateReferences(input.book)) {
+                referenced.add(reference.id);
+            }
+            const findings = [];
+            for (const id of [...input.book.fragments.keys()].sort()) {
+                if (!referenced.has(id)) {
+                    findings.push({
+                        ruleId: "unused-fragment",
+                        severity,
+                        message: `fragment "${id}" is not referenced by any composition or rule`,
+                        fragmentId: id,
+                    });
+                }
+            }
+            return findings;
+        },
+    };
+}
+//# sourceMappingURL=unused-fragment.js.map

package/dist/lint/rules/unused-fragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-fragment.js","sourceRoot":"","sources":["../../../src/lint/rules/unused-fragment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAA0B,EAAE;IAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;IAC/C,OAAO;QACL,EAAE,EAAE,iBAAiB;QACrB,WAAW,EAAE,0EAA0E;QACvF,KAAK,EAAE,MAAM;QACb,KAAK,CAAC,KAAK;YACT,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;YACrC,KAAK,MAAM,SAAS,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtD,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC/B,CAAC;YACD,MAAM,QAAQ,GAAkB,EAAE,CAAC;YACnC,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBACzD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBACxB,QAAQ,CAAC,IAAI,CAAC;wBACZ,MAAM,EAAE,iBAAiB;wBACzB,QAAQ;wBACR,OAAO,EAAE,aAAa,EAAE,gDAAgD;wBACxE,UAAU,EAAE,EAAE;qBACf,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lint/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Public types for the lint engine.
+ *
+ * Lint is static and deterministic: it runs pluggable rules over an assembled
+ * `{ text, trace }` and/or the book structure. It never calls a model and adds
+ * no runtime dependencies.
+ */
+import type { PromptBook, ResolveResult } from "../types.js";
+/** How serious a finding is. `error` drives a non-zero CLI exit. */
+export type Severity = "error" | "warning" | "info";
+/** When a rule can run: over a resolved prompt, or over the book structure. */
+export type LintScope = "resolved" | "book";
+/** A single problem a rule reports. */
+export interface LintFinding {
+    /** Id of the rule that produced this finding. */
+    ruleId: string;
+    severity: Severity;
+    /** Human-readable, domain-agnostic description. */
+    message: string;
+    /** Fragment the finding points at, when applicable. */
+    fragmentId?: string;
+    /** Composition rule index the finding points at, when applicable. */
+    ruleIndex?: number;
+}
+/** What lint runs against. `result` is present only for resolved-scope rules. */
+export interface LintInput {
+    book: PromptBook;
+    result?: ResolveResult;
+}
+/**
+ * A pluggable rule. Created by a factory so thresholds are configurable, e.g.
+ * `tokenBudget({ maxTokens })`. `check` is pure: same input, same findings.
+ */
+export interface LintRule {
+    /** Stable id, e.g. "token-budget". */
+    id: string;
+    /** One-line explanation of what the rule enforces. */
+    description: string;
+    /** Scope decides whether the rule needs `input.result`. */
+    scope: LintScope;
+    /** Inspect the input and return zero or more findings. */
+    check(input: LintInput): LintFinding[];
+}
+/** The aggregated outcome of a lint run. */
+export interface LintReport {
+    findings: LintFinding[];
+    errorCount: number;
+    warningCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lint/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lint/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7D,oEAAoE;AACpE,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5C,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,KAAK,EAAE,SAAS,CAAC;IACjB,0DAA0D;IAC1D,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,EAAE,CAAC;CACxC;AAED,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/lint/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lint/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lint/types.ts"],"names":[],"mappings":""}

package/dist/load.d.ts

@@ -0,0 +1,12 @@
+import type { FsAdapter, PromptBook } from "./types.js";
+/**
+ * Load a prompts folder (`fragments/` + `rules/` + optional `code-prompts/`)
+ * into a {@link PromptBook}.
+ *
+ * Throws only on structural errors (missing/duplicate fragment id, malformed
+ * rule). Soft issues (empty rules file, duplicate composition name, broken
+ * code-prompt manifest/sample) become warnings. Code-prompts hold snapshot text
+ * only — the builder is never executed. Reference checks happen in `resolve`.
+ */
+export declare function loadPrompts(promptsDir: string, fs?: FsAdapter): Promise<PromptBook>;
+//# sourceMappingURL=load.d.ts.map

package/dist/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAOV,SAAS,EACT,UAAU,EAGX,MAAM,YAAY,CAAC;AAwPpB;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAE,SAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAQnG"}

package/dist/load.js

@@ -0,0 +1,238 @@
+import { parse as parseYaml } from "yaml";
+import { parseFrontmatter } from "./frontmatter.js";
+import { nodeFs } from "./fs.js";
+import { isContextValue, isMapping } from "./guards.js";
+import { joinPath, listFiles, stripExt } from "./paths.js";
+const ACTION_KEYS = ["add", "replace", "forbid", "order"];
+function toStringArray(raw) {
+    if (!Array.isArray(raw)) {
+        return [];
+    }
+    return raw.map((value) => String(value));
+}
+function toScalar(value) {
+    return isContextValue(value) ? value : String(value);
+}
+function parseWhen(raw) {
+    if (!isMapping(raw)) {
+        return {};
+    }
+    const when = {};
+    for (const [key, value] of Object.entries(raw)) {
+        when[key] = toScalar(value);
+    }
+    return when;
+}
+/** Parse a context bag, or `undefined` when absent/empty (keeps the field optional). */
+function parseContextBag(raw) {
+    const bag = parseWhen(raw);
+    return Object.keys(bag).length > 0 ? bag : undefined;
+}
+/**
+ * Load every `.yaml`/`.yml` file in `dir` into a name-keyed map. Owns the shared
+ * scaffold: parallel reads, skip-with-warning on a non-mapping doc, and the
+ * duplicate-name warning (later wins). The caller's `build` turns one parsed doc
+ * into a named value; `noun` labels the warnings ("Composition", "Code-prompt").
+ */
+async function loadYamlDir(fs, dir, noun, warnings, build) {
+    const map = new Map();
+    const files = await listFiles(fs, dir, [".yaml", ".yml"]);
+    const loaded = await Promise.all(files.map(async (file) => {
+        const full = joinPath(dir, file);
+        return { file, full, raw: await fs.readFile(full) };
+    }));
+    for (const { file, full, raw } of loaded) {
+        const doc = parseYaml(raw);
+        if (!isMapping(doc)) {
+            warnings.push(`${noun} file "${full}" is empty or not a mapping; skipped.`);
+            continue;
+        }
+        const value = await build(doc, file, full);
+        const previous = map.get(value.name);
+        if (previous) {
+            warnings.push(`Duplicate ${noun.toLowerCase()} name "${value.name}" in "${previous.sourceFile}" and "${full}"; using the latter.`);
+        }
+        map.set(value.name, value);
+    }
+    return map;
+}
+function parseReplaceMap(raw, index, file) {
+    if (!isMapping(raw)) {
+        throw new Error(`Rule #${index} in "${file}" has a "replace" that is not a mapping.`);
+    }
+    const map = {};
+    for (const [from, to] of Object.entries(raw)) {
+        map[from] = String(to);
+    }
+    return map;
+}
+function parseRule(entry, index, file) {
+    if (!isMapping(entry)) {
+        throw new Error(`Rule #${index} in "${file}" must be a mapping.`);
+    }
+    const obj = entry;
+    const present = ACTION_KEYS.filter((key) => obj[key] !== undefined);
+    if (present.length !== 1) {
+        throw new Error(`Rule #${index} in "${file}" must declare exactly one action (${ACTION_KEYS.join(" / ")}); found ${present.length}.`);
+    }
+    const action = present[0];
+    const rule = { index, when: parseWhen(obj.when), action };
+    switch (action) {
+        case "add":
+            rule.add = toStringArray(obj.add);
+            if (typeof obj.after === "string") {
+                rule.after = obj.after;
+            }
+            break;
+        case "replace":
+            rule.replace = parseReplaceMap(obj.replace, index, file);
+            break;
+        case "forbid":
+            rule.forbid = toStringArray(obj.forbid);
+            break;
+        case "order":
+            rule.order = toStringArray(obj.order);
+            break;
+    }
+    return rule;
+}
+function parseRules(raw, file) {
+    if (raw === undefined || raw === null) {
+        return [];
+    }
+    if (!Array.isArray(raw)) {
+        throw new Error(`"rules" in "${file}" must be a list.`);
+    }
+    return raw.map((entry, index) => parseRule(entry, index, file));
+}
+async function loadFragments(fs, dir) {
+    const fragments = new Map();
+    const sourceById = new Map();
+    const fragmentsDir = joinPath(dir, "fragments");
+    const files = await listFiles(fs, fragmentsDir, [".md", ".markdown"]);
+    // Reads run in parallel; the sorted file order still drives processing,
+    // so duplicate detection and output stay deterministic.
+    const loaded = await Promise.all(files.map(async (file) => {
+        const full = joinPath(fragmentsDir, file);
+        return { full, raw: await fs.readFile(full) };
+    }));
+    for (const { full, raw } of loaded) {
+        const { data, body } = parseFrontmatter(raw);
+        const id = typeof data.id === "string" ? data.id : undefined;
+        if (!id) {
+            throw new Error(`Fragment "${full}" is missing a string "id" in its frontmatter.`);
+        }
+        const existing = sourceById.get(id);
+        if (existing) {
+            throw new Error(`Duplicate fragment id "${id}" in "${existing}" and "${full}".`);
+        }
+        sourceById.set(id, full);
+        const fragment = { id, body: body.trim(), sourceFile: full };
+        if (typeof data.kind === "string") {
+            fragment.kind = data.kind;
+        }
+        if (Array.isArray(data.tags)) {
+            fragment.tags = data.tags.map((tag) => String(tag));
+        }
+        fragments.set(id, fragment);
+    }
+    return fragments;
+}
+function loadCompositions(fs, dir, warnings) {
+    return loadYamlDir(fs, joinPath(dir, "rules"), "Composition", warnings, (obj, file, full) => {
+        const name = typeof obj.name === "string" ? obj.name : stripExt(file);
+        const composition = {
+            name,
+            base: toStringArray(obj.base),
+            rules: parseRules(obj.rules, full),
+            sourceFile: full,
+        };
+        if (obj.order !== undefined) {
+            composition.order = toStringArray(obj.order);
+        }
+        return composition;
+    });
+}
+/**
+ * Load the captured output samples of one code-prompt manifest. A sample's text
+ * comes inline (`output`) or from a sibling file (`file`). Malformed entries
+ * and missing files become warnings, never throws — the core never runs the
+ * builder, so a broken snapshot just drops out of the menu.
+ */
+async function loadCodePromptSamples(fs, codeDir, raw, manifest, warnings) {
+    if (raw === undefined || raw === null) {
+        return [];
+    }
+    if (!Array.isArray(raw)) {
+        warnings.push(`"samples" in "${manifest}" must be a list; ignored.`);
+        return [];
+    }
+    const samples = [];
+    for (let index = 0; index < raw.length; index++) {
+        const entry = raw[index];
+        if (!isMapping(entry)) {
+            warnings.push(`Sample #${index} in "${manifest}" must be a mapping; skipped.`);
+            continue;
+        }
+        const label = typeof entry.label === "string" ? entry.label : undefined;
+        if (!label) {
+            warnings.push(`Sample #${index} in "${manifest}" is missing a string "label"; skipped.`);
+            continue;
+        }
+        let output;
+        if (typeof entry.output === "string") {
+            output = entry.output;
+        }
+        else if (typeof entry.file === "string") {
+            try {
+                output = await fs.readFile(joinPath(codeDir, entry.file));
+            }
+            catch {
+                warnings.push(`Sample "${label}" in "${manifest}" references missing file "${entry.file}"; skipped.`);
+                continue;
+            }
+        }
+        else {
+            warnings.push(`Sample "${label}" in "${manifest}" must set "output" or "file"; skipped.`);
+            continue;
+        }
+        const sample = { label, output };
+        const context = parseContextBag(entry.context);
+        if (context !== undefined) {
+            sample.context = context;
+        }
+        samples.push(sample);
+    }
+    return samples;
+}
+function loadCodePrompts(fs, dir, warnings) {
+    const codeDir = joinPath(dir, "code-prompts");
+    return loadYamlDir(fs, codeDir, "Code-prompt", warnings, async (obj, file, full) => {
+        const name = typeof obj.name === "string" ? obj.name : stripExt(file);
+        const samples = await loadCodePromptSamples(fs, codeDir, obj.samples, full, warnings);
+        const codePrompt = { name, samples, sourceFile: full };
+        if (typeof obj.description === "string") {
+            codePrompt.description = obj.description;
+        }
+        return codePrompt;
+    });
+}
+/**
+ * Load a prompts folder (`fragments/` + `rules/` + optional `code-prompts/`)
+ * into a {@link PromptBook}.
+ *
+ * Throws only on structural errors (missing/duplicate fragment id, malformed
+ * rule). Soft issues (empty rules file, duplicate composition name, broken
+ * code-prompt manifest/sample) become warnings. Code-prompts hold snapshot text
+ * only — the builder is never executed. Reference checks happen in `resolve`.
+ */
+export async function loadPrompts(promptsDir, fs = nodeFs()) {
+    const warnings = [];
+    const [fragments, compositions, codePrompts] = await Promise.all([
+        loadFragments(fs, promptsDir),
+        loadCompositions(fs, promptsDir, warnings),
+        loadCodePrompts(fs, promptsDir, warnings),
+    ]);
+    return { fragments, compositions, codePrompts, warnings };
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,12 @@
+import type { FsAdapter } from "./types.js";
+/** Join a directory and child with a single `/`, tolerating a trailing slash. */
+export declare function joinPath(dir: string, child: string): string;
+/** Drop a file extension, e.g. `assistant.yaml` -> `assistant`. */
+export declare function stripExt(name: string): string;
+/**
+ * List files in `dir` whose name ends with one of `exts`, sorted for
+ * deterministic processing. A missing/unreadable directory yields `[]` so
+ * callers can treat an absent folder as "no files".
+ */
+export declare function listFiles(fs: FsAdapter, dir: string, exts: string[]): Promise<string[]>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ7F"}

package/dist/paths.js

@@ -0,0 +1,25 @@
+/** Join a directory and child with a single `/`, tolerating a trailing slash. */
+export function joinPath(dir, child) {
+    return dir.endsWith("/") ? `${dir}${child}` : `${dir}/${child}`;
+}
+/** Drop a file extension, e.g. `assistant.yaml` -> `assistant`. */
+export function stripExt(name) {
+    const dot = name.lastIndexOf(".");
+    return dot === -1 ? name : name.slice(0, dot);
+}
+/**
+ * List files in `dir` whose name ends with one of `exts`, sorted for
+ * deterministic processing. A missing/unreadable directory yields `[]` so
+ * callers can treat an absent folder as "no files".
+ */
+export async function listFiles(fs, dir, exts) {
+    let entries;
+    try {
+        entries = await fs.readDir(dir);
+    }
+    catch {
+        return [];
+    }
+    return entries.filter((name) => exts.some((ext) => name.endsWith(ext))).sort();
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,KAAa;IACjD,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;AAClE,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAa,EAAE,GAAW,EAAE,IAAc;IACxE,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACjF,CAAC"}

package/dist/resolve-book.d.ts

@@ -0,0 +1,15 @@
+import type { Context, ContextValue, PromptBook, ResolveResult } from "./types.js";
+/**
+ * Pure resolver over an already-loaded {@link PromptBook}. No filesystem, no
+ * YAML, no Node builtins — the entire dependency footprint is {@link interpolate}
+ * and type-only imports. This is the determinism boundary: given the same book
+ * and context, the returned `text` is byte-for-byte stable, and the module
+ * bundles to a self-contained artifact for edge runtimes (see `edge.ts`).
+ *
+ * Conflict strategy: rules apply in declaration order, later wins (cascade).
+ * `forbid` is the one exception — it is applied as a final filter and always
+ * wins, so a forbidden id never reaches the output even if added earlier.
+ */
+export declare function resolveBook(book: PromptBook, prompt: string, context: Context): ResolveResult;
+export declare function valuesEqual(a: ContextValue, b: ContextValue): boolean;
+//# sourceMappingURL=resolve-book.d.ts.map

package/dist/resolve-book.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-book.d.ts","sourceRoot":"","sources":["../src/resolve-book.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,OAAO,EACP,YAAY,EAEZ,UAAU,EAEV,aAAa,EAKd,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CA8G7F;AAoBD,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAErE"}