@design-intelligence/ghost 0.20.0

package/dist/ghost-core/catalog/closest.js

@@ -0,0 +1,63 @@
+/**
+ * Closest-id suggestions for an unknown node/surface name. When an agent names
+ * a node that is not in the package, the surface-naming commands
+ * (`gather`/`checks`/`review`) emit a "did you mean" hint rather than silently
+ * routing to nothing. This is that hint: deterministic, LLM-free, bounded.
+ *
+ * It is not a search engine. An inexact `gather <query>` shows the node menu
+ * and lets the agent re-pick by description; this only nominates the few ids a
+ * typo most likely meant.
+ */
+/**
+ * Suggest the ids closest to `query`, nearest first. Substring matches always
+ * rank above pure edit-distance neighbours.
+ */
+export function closestIds(query, ids, max = 3) {
+    const needle = query.trim().toLowerCase();
+    if (needle.length === 0)
+        return [];
+    const scored = [];
+    for (const id of ids) {
+        const lower = id.toLowerCase();
+        const segment = lower.split("/").pop() ?? lower;
+        const distance = Math.min(levenshtein(needle, lower), levenshtein(needle, segment));
+        const substring = lower.includes(needle) || needle.includes(lower);
+        if (substring) {
+            scored.push({ id, rank: 0, distance });
+        }
+        else if (distance <= fuzzyThreshold(needle)) {
+            scored.push({ id, rank: 1, distance });
+        }
+    }
+    scored.sort((a, b) => a.rank - b.rank || a.distance - b.distance || a.id.localeCompare(b.id));
+    return scored.slice(0, Math.max(0, max)).map((entry) => entry.id);
+}
+/** A length-proportional edit-distance threshold for typo tolerance. */
+function fuzzyThreshold(needle) {
+    if (needle.length <= 4)
+        return 1;
+    if (needle.length <= 8)
+        return 2;
+    return 3;
+}
+/** Classic iterative Levenshtein distance. Dependency-free, O(n*m). */
+function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+    let curr = new Array(b.length + 1);
+    for (let i = 1; i <= a.length; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min((prev[j] ?? 0) + 1, (curr[j - 1] ?? 0) + 1, (prev[j - 1] ?? 0) + cost);
+        }
+        [prev, curr] = [curr, prev];
+    }
+    return prev[b.length] ?? 0;
+}
+//# sourceMappingURL=closest.js.map

package/dist/ghost-core/catalog/closest.js.map

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

package/dist/ghost-core/catalog/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public surface for the in-memory fingerprint catalog — a flat map of prose
+ * nodes assembled from the package's markdown files. No edges, no cascade, no
+ * traversal: the agent selects from the menu (`gather`).
+ */
+export { type AssembleCatalogInput, assembleCatalog, type PlacedNode, } from "./assemble.js";
+export { closestIds } from "./closest.js";
+export { type BuildCatalogMenuOptions, buildCatalogMenu, type CatalogMenuEntry, } from "./menu.js";
+export type { GhostCatalog, GhostCatalogNode } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ghost-core/catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,oBAAoB,EACzB,eAAe,EACf,KAAK,UAAU,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/ghost-core/catalog/index.js

@@ -0,0 +1,9 @@
+/**
+ * Public surface for the in-memory fingerprint catalog — a flat map of prose
+ * nodes assembled from the package's markdown files. No edges, no cascade, no
+ * traversal: the agent selects from the menu (`gather`).
+ */
+export { assembleCatalog, } from "./assemble.js";
+export { closestIds } from "./closest.js";
+export { buildCatalogMenu, } from "./menu.js";
+//# sourceMappingURL=index.js.map

package/dist/ghost-core/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ghost-core/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,eAAe,GAEhB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAEL,gBAAgB,GAEjB,MAAM,WAAW,CAAC"}

package/dist/ghost-core/catalog/menu.d.ts

@@ -0,0 +1,36 @@
+import type { GhostCatalog } from "./types.js";
+export interface BuildCatalogMenuOptions {
+    /** Include kinds that declare `posture: wild`; default menus omit them. */
+    includeWild?: boolean;
+}
+/**
+ * One entry in the gather menu: a node presented as `id` + `kind` +
+ * `description` — the retrieval payload the agent selects against. The agent
+ * matches a natural-language ask against these and reads what it judges
+ * relevant; Ghost does no NLP and no selection.
+ */
+export interface CatalogMenuEntry {
+    id: string;
+    /** The node's kind (filename prefix), when it declares one. */
+    kind?: string;
+    description?: string;
+    /** Count of material locators available after pulling this node. */
+    materials?: number;
+    /** True when this entry carries concrete material by derived structure. */
+    concrete: boolean;
+    /** True when this entry includes a Skeleton section. */
+    hasSkeleton?: true;
+    /** Consumption posture for this menu entry. */
+    posture: "steady" | "wild" | "guard";
+    /** True when this entry pushes past the fingerprint rather than conforming to it. */
+    wild?: true;
+    /** True when this entry is review-critical guard posture. */
+    guard?: true;
+}
+/**
+ * Build the gather menu: every authored node, with its kind and description,
+ * sorted by id for stable output. A flat catalog — no anchor, no hierarchy;
+ * the agent selects from it.
+ */
+export declare function buildCatalogMenu(catalog: GhostCatalog, options?: BuildCatalogMenuOptions): CatalogMenuEntry[];
+//# sourceMappingURL=menu.d.ts.map

package/dist/ghost-core/catalog/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/catalog/menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,uBAAuB;IACtC,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,+CAA+C;IAC/C,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,qFAAqF;IACrF,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,6DAA6D;IAC7D,KAAK,CAAC,EAAE,IAAI,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,EAAE,CAqBpB"}

package/dist/ghost-core/catalog/menu.js

@@ -0,0 +1,27 @@
+/**
+ * Build the gather menu: every authored node, with its kind and description,
+ * sorted by id for stable output. A flat catalog — no anchor, no hierarchy;
+ * the agent selects from it.
+ */
+export function buildCatalogMenu(catalog, options = {}) {
+    const entries = [];
+    for (const node of catalog.nodes.values()) {
+        if (node.wild && !options.includeWild)
+            continue;
+        entries.push({
+            id: node.id,
+            ...(node.kind !== undefined ? { kind: node.kind } : {}),
+            ...(node.description ? { description: node.description } : {}),
+            ...(node.materials !== undefined && node.materials.length > 0
+                ? { materials: node.materials.length }
+                : {}),
+            concrete: node.concrete,
+            ...(node.hasSkeleton ? { hasSkeleton: true } : {}),
+            posture: node.posture,
+            ...(node.wild ? { wild: true } : {}),
+            ...(node.guard ? { guard: true } : {}),
+        });
+    }
+    return entries.sort((a, b) => a.id.localeCompare(b.id));
+}
+//# sourceMappingURL=menu.js.map

package/dist/ghost-core/catalog/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../../src/ghost-core/catalog/menu.ts"],"names":[],"mappings":"AAgCA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAqB,EACrB,UAAmC,EAAE;IAErC,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW;YAAE,SAAS;QAChD,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;gBAC3D,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;gBACtC,CAAC,CAAC,EAAE,CAAC;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/ghost-core/catalog/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A node in the fingerprint catalog — pure prose plus its filename-derived
+ * identity. The body is the design expression; there are no structured content
+ * fields. Kind comes from the filename prefix; there is no traversal or
+ * containment model — the catalog is a flat map the agent selects from.
+ */
+export interface GhostCatalogNode {
+    id: string;
+    /** Optional filename prefix before the first dot (`principle.density`). */
+    kind?: string;
+    /** Filename slug: bare name, or the part after the first dot. */
+    slug: string;
+    /** One-line "what this is / when to gather it" — the retrieval payload. */
+    description?: string;
+    /** Optional material locators carried by the authored node. */
+    materials?: string[];
+    /** True when the node carries materials, a substantial fence, or a Skeleton. */
+    concrete: boolean;
+    /** True when the node declares a `## Skeleton` section. */
+    hasSkeleton: boolean;
+    /** Consumption posture derived from the node's glossary kind. */
+    posture: "steady" | "wild" | "guard";
+    /** True when the node's declared kind has `posture: wild` in the glossary. */
+    wild?: true;
+    /** True when the node's declared kind has `posture: guard` in the glossary. */
+    guard?: true;
+    body: string;
+}
+/**
+ * The in-memory fingerprint catalog: prose nodes indexed by id. A flat map —
+ * no edges, no cascade, no traversal. Identity comes from each file's path.
+ */
+export interface GhostCatalog {
+    /** Every node, indexed by id. */
+    nodes: Map<string, GhostCatalogNode>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ghost-core/catalog/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/catalog/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,WAAW,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,8EAA8E;IAC9E,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,+EAA+E;IAC/E,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACtC"}

package/dist/ghost-core/catalog/types.js

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

package/dist/ghost-core/catalog/types.js.map

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

package/dist/ghost-core/check/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public surface for `ghost.check/v1` — markdown + frontmatter checks an agent
+ * evaluates (Ghost never runs them). Every check is offered to the reviewer;
+ * the agent judges relevance against the diff and the grounded prose. A check's
+ * optional `source:` names the fingerprint prose it enforces.
+ */
+export { lintGhostCheck } from "./lint.js";
+export { loadGhostCheck } from "./load.js";
+export { type ParsedCheckMarkdown, parseCheckMarkdown } from "./parse.js";
+export { type ParsedSourceRef, parseSourceRef, sliceNodeSection, } from "./source-ref.js";
+export { GHOST_CHECK_SCHEMA, GHOST_CHECK_SEVERITIES, type GhostCheckDocument, type GhostCheckFrontmatter, type GhostCheckLintIssue, type GhostCheckLintReport, type GhostCheckLintSeverity, type GhostCheckMarkdownSeverity, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ghost-core/check/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/check/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,KAAK,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EACL,KAAK,eAAe,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,GAChC,MAAM,YAAY,CAAC"}

package/dist/ghost-core/check/index.js

@@ -0,0 +1,12 @@
+/**
+ * Public surface for `ghost.check/v1` — markdown + frontmatter checks an agent
+ * evaluates (Ghost never runs them). Every check is offered to the reviewer;
+ * the agent judges relevance against the diff and the grounded prose. A check's
+ * optional `source:` names the fingerprint prose it enforces.
+ */
+export { lintGhostCheck } from "./lint.js";
+export { loadGhostCheck } from "./load.js";
+export { parseCheckMarkdown } from "./parse.js";
+export { parseSourceRef, sliceNodeSection, } from "./source-ref.js";
+export { GHOST_CHECK_SCHEMA, GHOST_CHECK_SEVERITIES, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/ghost-core/check/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ghost-core/check/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAA4B,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAEL,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,GAOvB,MAAM,YAAY,CAAC"}

package/dist/ghost-core/check/lint.d.ts

@@ -0,0 +1,9 @@
+import { type GhostCheckLintReport } from "./types.js";
+/**
+ * Lint a Ghost check markdown file (`ghost.check/v1`): required frontmatter
+ * (`name`, `description`, `severity`), an optional `source:` provenance pointer,
+ * and a non-empty body. Ghost never executes the check — this only validates
+ * that it is well-formed.
+ */
+export declare function lintGhostCheck(raw: string): GhostCheckLintReport;
+//# sourceMappingURL=lint.d.ts.map

package/dist/ghost-core/check/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/check/lint.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAwGhE"}

package/dist/ghost-core/check/lint.js

@@ -0,0 +1,119 @@
+import { parseCheckMarkdown } from "./parse.js";
+import { parseSourceRef } from "./source-ref.js";
+import { GHOST_CHECK_SEVERITIES, } from "./types.js";
+/**
+ * Lint a Ghost check markdown file (`ghost.check/v1`): required frontmatter
+ * (`name`, `description`, `severity`), an optional `source:` provenance pointer,
+ * and a non-empty body. Ghost never executes the check — this only validates
+ * that it is well-formed.
+ */
+export function lintGhostCheck(raw) {
+    const issues = [];
+    const { frontmatter, body } = parseCheckMarkdown(raw);
+    if (frontmatter === null) {
+        issues.push({
+            severity: "error",
+            rule: "check-frontmatter-missing",
+            message: "check must begin with a YAML frontmatter block delimited by `---` lines",
+            path: "<frontmatter>",
+        });
+        return finalize(issues);
+    }
+    requireString(frontmatter, "name", issues);
+    requireString(frontmatter, "description", issues);
+    const severity = frontmatter.severity;
+    if (severity === undefined) {
+        issues.push({
+            severity: "error",
+            rule: "check-severity-missing",
+            message: "frontmatter must declare a severity",
+            path: "severity",
+        });
+    }
+    else if (typeof severity !== "string" ||
+        !GHOST_CHECK_SEVERITIES.includes(severity)) {
+        issues.push({
+            severity: "error",
+            rule: "check-severity-invalid",
+            message: `severity must be one of: ${GHOST_CHECK_SEVERITIES.join(", ")}`,
+            path: "severity",
+        });
+    }
+    const references = frontmatter.references;
+    if (references !== undefined) {
+        if (!Array.isArray(references)) {
+            issues.push({
+                severity: "error",
+                rule: "check-references-invalid",
+                message: "references must be an array of node refs",
+                path: "references",
+            });
+        }
+        else {
+            references.forEach((reference, index) => {
+                if (typeof reference !== "string" ||
+                    parseSourceRef(reference) === null) {
+                    issues.push({
+                        severity: "warning",
+                        rule: "check-reference-malformed",
+                        message: "references entries should be node path ids with optional `> Heading` anchors (e.g. 'checkout/payment > Confirmation')",
+                        path: `references[${index}]`,
+                    });
+                }
+            });
+        }
+    }
+    const probe = frontmatter.probe;
+    if (probe !== undefined &&
+        (typeof probe !== "string" || probe.trim() === "")) {
+        issues.push({
+            severity: "error",
+            rule: "check-probe-invalid",
+            message: "probe must be a non-empty shell command string",
+            path: "probe",
+        });
+    }
+    const source = frontmatter.source;
+    if (source !== undefined) {
+        // `source:` is a deprecated soft provenance pointer: `<node-id>` with an
+        // optional `> <heading>` anchor. Keep linting it so older standalone check
+        // files still get useful feedback.
+        if (typeof source !== "string" || parseSourceRef(source) === null) {
+            issues.push({
+                severity: "warning",
+                rule: "check-source-malformed",
+                message: "source should be a node path id with an optional `> Heading` anchor (e.g. 'checkout/payment > Confirmation')",
+                path: "source",
+            });
+        }
+    }
+    if (body.trim().length === 0) {
+        issues.push({
+            severity: "error",
+            rule: "check-body-empty",
+            message: "check body must contain instructions for the evaluating agent",
+            path: "<body>",
+        });
+    }
+    return finalize(issues);
+}
+function requireString(frontmatter, key, issues) {
+    const value = frontmatter[key];
+    if (typeof value !== "string" || value.trim().length === 0) {
+        issues.push({
+            severity: "error",
+            rule: `check-${key}-missing`,
+            message: `frontmatter must declare a non-empty ${key}`,
+            path: key,
+        });
+    }
+}
+function finalize(issues) {
+    return {
+        issues,
+        errors: issues.filter((issue) => issue.severity === "error").length,
+        warnings: issues.filter((issue) => issue.severity === "warning").length,
+        info: issues.filter((issue) => issue.severity === "info").length,
+    };
+}
+//# sourceMappingURL=lint.js.map

package/dist/ghost-core/check/lint.js.map

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

package/dist/ghost-core/check/load.d.ts

@@ -0,0 +1,7 @@
+import type { GhostCheckDocument } from "./types.js";
+/**
+ * Parse a well-formed Ghost check into a typed document. Assumes the input has
+ * already passed `lintGhostCheck` (throws on missing required frontmatter).
+ */
+export declare function loadGhostCheck(raw: string): GhostCheckDocument;
+//# sourceMappingURL=load.d.ts.map

package/dist/ghost-core/check/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/check/load.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CA+C9D"}

package/dist/ghost-core/check/load.js

@@ -0,0 +1,44 @@
+import { parseCheckMarkdown } from "./parse.js";
+/**
+ * Parse a well-formed Ghost check into a typed document. Assumes the input has
+ * already passed `lintGhostCheck` (throws on missing required frontmatter).
+ */
+export function loadGhostCheck(raw) {
+    const { frontmatter, body } = parseCheckMarkdown(raw);
+    if (frontmatter === null) {
+        throw new Error("Ghost check is missing a YAML frontmatter block.");
+    }
+    const name = frontmatter.name;
+    const description = frontmatter.description;
+    const severity = frontmatter.severity;
+    if (typeof name !== "string" || typeof description !== "string") {
+        throw new Error("Ghost check frontmatter is missing name or description.");
+    }
+    const tools = Array.isArray(frontmatter.tools)
+        ? frontmatter.tools.filter((tool) => typeof tool === "string")
+        : undefined;
+    const turnLimit = typeof frontmatter["turn-limit"] === "number"
+        ? frontmatter["turn-limit"]
+        : typeof frontmatter.turn_limit === "number"
+            ? frontmatter.turn_limit
+            : undefined;
+    const references = Array.isArray(frontmatter.references)
+        ? frontmatter.references.filter((reference) => typeof reference === "string")
+        : undefined;
+    const source = typeof frontmatter.source === "string" ? frontmatter.source : undefined;
+    const probe = typeof frontmatter.probe === "string" ? frontmatter.probe : undefined;
+    return {
+        frontmatter: {
+            name,
+            description,
+            severity: severity,
+            ...(tools ? { tools } : {}),
+            ...(turnLimit !== undefined ? { turn_limit: turnLimit } : {}),
+            ...(references ? { references } : {}),
+            ...(source ? { source } : {}),
+            ...(probe ? { probe } : {}),
+        },
+        body,
+    };
+}
+//# sourceMappingURL=load.js.map

package/dist/ghost-core/check/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../src/ghost-core/check/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMhD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAC9B,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC;IAC5C,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;IACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;QAC5C,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CACtB,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CACnD;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,SAAS,GACb,OAAO,WAAW,CAAC,YAAY,CAAC,KAAK,QAAQ;QAC3C,CAAC,CAAE,WAAW,CAAC,YAAY,CAAY;QACvC,CAAC,CAAC,OAAO,WAAW,CAAC,UAAU,KAAK,QAAQ;YAC1C,CAAC,CAAE,WAAW,CAAC,UAAqB;YACpC,CAAC,CAAC,SAAS,CAAC;IAClB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC;QACtD,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAC3B,CAAC,SAAS,EAAuB,EAAE,CAAC,OAAO,SAAS,KAAK,QAAQ,CAClE;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,MAAM,GACV,OAAO,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,MAAM,KAAK,GACT,OAAO,WAAW,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,OAAO;QACL,WAAW,EAAE;YACX,IAAI;YACJ,WAAW;YACX,QAAQ,EAAE,QAAsC;YAChD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5B;QACD,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/ghost-core/check/parse.d.ts

@@ -0,0 +1,12 @@
+import { type ParsedMarkdown } from "../markdown.js";
+export type ParsedCheckMarkdown = ParsedMarkdown;
+/**
+ * Split a markdown check into its YAML frontmatter and body. A check file is
+ * `---\n<yaml>\n---\n<body>`. Returns `frontmatter: null` when there is no
+ * leading frontmatter block (the caller's lint reports it as an error).
+ *
+ * Thin alias over the shared {@link splitMarkdownFrontmatter}; checks and nodes
+ * share one envelope splitter.
+ */
+export declare function parseCheckMarkdown(raw: string): ParsedCheckMarkdown;
+//# sourceMappingURL=parse.d.ts.map

package/dist/ghost-core/check/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/check/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAA4B,MAAM,gBAAgB,CAAC;AAE/E,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAEnE"}

package/dist/ghost-core/check/parse.js

@@ -0,0 +1,13 @@
+import { splitMarkdownFrontmatter } from "../markdown.js";
+/**
+ * Split a markdown check into its YAML frontmatter and body. A check file is
+ * `---\n<yaml>\n---\n<body>`. Returns `frontmatter: null` when there is no
+ * leading frontmatter block (the caller's lint reports it as an error).
+ *
+ * Thin alias over the shared {@link splitMarkdownFrontmatter}; checks and nodes
+ * share one envelope splitter.
+ */
+export function parseCheckMarkdown(raw) {
+    return splitMarkdownFrontmatter(raw);
+}
+//# sourceMappingURL=parse.js.map

package/dist/ghost-core/check/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/ghost-core/check/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAI/E;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,wBAAwB,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC"}

package/dist/ghost-core/check/source-ref.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A parsed `source:` reference: the node path id it points at, plus the
+ * optional heading anchor (`checkout/payment > Confirmation` → nodeId
+ * `checkout/payment`, heading `Confirmation`).
+ */
+export interface ParsedSourceRef {
+    nodeId: string;
+    heading?: string;
+}
+/**
+ * Parse the check `source:` reference grammar — `<node-id> > <Heading>`.
+ * Splits on the *first* `>` and trims both parts. Returns `null` when the
+ * node-id part is not a valid node path id (or the input is empty); the
+ * heading is present only when a non-empty anchor follows the `>`. This is
+ * shape validation only — whether the node (or heading) exists is the
+ * caller's concern: an unresolved ref may name not-yet-written prose.
+ */
+export declare function parseSourceRef(raw: string): ParsedSourceRef | null;
+/**
+ * Slice the section a heading anchor points at out of a node body. Matches the
+ * first markdown heading line (any level) whose text equals `heading`
+ * case-insensitively, then returns everything up to the next heading of the
+ * same or higher level (or end of body), trimmed. Returns `null` when no
+ * heading matches.
+ */
+export declare function sliceNodeSection(body: string, heading: string): string | null;
+//# sourceMappingURL=source-ref.d.ts.map

package/dist/ghost-core/check/source-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-ref.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/check/source-ref.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAUlE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgC7E"}

package/dist/ghost-core/check/source-ref.js

@@ -0,0 +1,58 @@
+import { NodeIdSchema } from "../node/schema.js";
+/**
+ * Parse the check `source:` reference grammar — `<node-id> > <Heading>`.
+ * Splits on the *first* `>` and trims both parts. Returns `null` when the
+ * node-id part is not a valid node path id (or the input is empty); the
+ * heading is present only when a non-empty anchor follows the `>`. This is
+ * shape validation only — whether the node (or heading) exists is the
+ * caller's concern: an unresolved ref may name not-yet-written prose.
+ */
+export function parseSourceRef(raw) {
+    const splitAt = raw.indexOf(">");
+    const nodePart = (splitAt === -1 ? raw : raw.slice(0, splitAt)).trim();
+    if (!NodeIdSchema.safeParse(nodePart).success) {
+        return null;
+    }
+    const heading = splitAt === -1 ? "" : raw.slice(splitAt + 1).trim();
+    return heading.length > 0
+        ? { nodeId: nodePart, heading }
+        : { nodeId: nodePart };
+}
+/**
+ * Slice the section a heading anchor points at out of a node body. Matches the
+ * first markdown heading line (any level) whose text equals `heading`
+ * case-insensitively, then returns everything up to the next heading of the
+ * same or higher level (or end of body), trimmed. Returns `null` when no
+ * heading matches.
+ */
+export function sliceNodeSection(body, heading) {
+    const wanted = heading.trim().toLowerCase();
+    const lines = body.split("\n");
+    const headingPattern = /^(#{1,6})\s+(.*)$/;
+    let startLine = -1;
+    let level = 0;
+    for (let i = 0; i < lines.length; i += 1) {
+        const match = headingPattern.exec(lines[i]);
+        if (match && match[2].trim().toLowerCase() === wanted) {
+            startLine = i;
+            level = match[1].length;
+            break;
+        }
+    }
+    if (startLine === -1) {
+        return null;
+    }
+    let endLine = lines.length;
+    for (let i = startLine + 1; i < lines.length; i += 1) {
+        const match = headingPattern.exec(lines[i]);
+        if (match && match[1].length <= level) {
+            endLine = i;
+            break;
+        }
+    }
+    return lines
+        .slice(startLine + 1, endLine)
+        .join("\n")
+        .trim();
+}
+//# sourceMappingURL=source-ref.js.map

package/dist/ghost-core/check/source-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-ref.js","sourceRoot":"","sources":["../../../src/ghost-core/check/source-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAYjD;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE;QAC/B,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAe;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,cAAc,GAAG,mBAAmB,CAAC;IAE3C,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YACtD,SAAS,GAAG,CAAC,CAAC;YACd,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACxB,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC,CAAC;YACZ,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,KAAK;SACT,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC;SAC7B,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;AACZ,CAAC"}