@design-intelligence/ghost 0.0.0-next-20260715121453

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 { 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,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACpE,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,EAAE,gBAAgB,EAAyB,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { GhostCatalog } from "./types.js";
+/**
+ * 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 pulls applicable nodes;
+ * 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 a material locator, fenced example, or Skeleton. */
+    concrete: boolean;
+    /** True when this entry includes a substantial fenced example. */
+    hasFencedExample?: true;
+    /** True when this entry includes a Skeleton section. */
+    hasSkeleton?: 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): 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;;;;;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,oFAAoF;IACpF,QAAQ,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,IAAI,CAAC;IACxB,wDAAwD;IACxD,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,EAAE,CAkB1E"}

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

@@ -0,0 +1,23 @@
+/**
+ * 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) {
+    const entries = [];
+    for (const node of catalog.nodes.values()) {
+        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.hasFencedExample ? { hasFencedExample: true } : {}),
+            ...(node.hasSkeleton ? { hasSkeleton: 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":"AAuBA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,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,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,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,33 @@
+/**
+ * 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;
+    /** Retrieval payload shown in gather: what applies, when, and what it contributes. */
+    description?: string;
+    /** Optional material locators carried by the authored node. */
+    materials?: string[];
+    /** True when the node carries a material locator, substantial fence, or Skeleton. */
+    concrete: boolean;
+    /** True when the node body carries a fenced block of at least 3 lines. */
+    hasFencedExample: boolean;
+    /** True when the node declares a `## Skeleton` section. */
+    hasSkeleton: boolean;
+    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,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,qFAAqF;IACrF,QAAQ,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,2DAA2D;IAC3D,WAAW,EAAE,OAAO,CAAC;IACrB,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"}

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

@@ -0,0 +1,48 @@
+export declare const GHOST_CHECK_SCHEMA: "ghost.check/v1";
+/** Severity vocabulary, matching the established agent-check format. */
+export declare const GHOST_CHECK_SEVERITIES: readonly ["high", "medium", "low"];
+export type GhostCheckMarkdownSeverity = (typeof GHOST_CHECK_SEVERITIES)[number];
+/**
+ * A Ghost check: markdown + frontmatter, evaluated by an agent — never run by
+ * Ghost. Shape-compatible with the established `.agents/checks` format, plus the
+ * Ghost addition `source:` (the fingerprint prose the check enforces). Every
+ * check is offered to the reviewer; the agent judges relevance.
+ */
+export interface GhostCheckFrontmatter {
+    name: string;
+    description: string;
+    severity: GhostCheckMarkdownSeverity;
+    /** Tools the check is allowed to use (passthrough for the review pipeline). */
+    tools?: string[];
+    /** Max tool-use turns the check should spend (passthrough). */
+    turn_limit?: number;
+    /**
+     * The fingerprint prose this check enforces, as node path ids with optional
+     * `> Heading` anchors (`checkout/payment > Confirmation`). Unresolved refs are
+     * tolerated by validation as warnings: they may name not-yet-written prose.
+     */
+    references?: string[];
+    /** Deprecated single-reference alias retained for artifact-level linting. */
+    source?: string;
+    /** Optional repo-owned shell probe run by `ghost review` as evidence only. */
+    probe?: string;
+}
+export interface GhostCheckDocument {
+    frontmatter: GhostCheckFrontmatter;
+    /** The markdown body: prose instructions for the evaluating agent. */
+    body: string;
+}
+export type GhostCheckLintSeverity = "error" | "warning" | "info";
+export interface GhostCheckLintIssue {
+    severity: GhostCheckLintSeverity;
+    rule: string;
+    message: string;
+    path: string;
+}
+export interface GhostCheckLintReport {
+    issues: GhostCheckLintIssue[];
+    errors: number;
+    warnings: number;
+    info: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/check/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,EAAG,gBAAyB,CAAC;AAE5D,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,oCAAqC,CAAC;AACzE,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,0BAA0B,CAAC;IACrC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,qBAAqB,CAAC;IACnC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd"}

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

@@ -0,0 +1,4 @@
+export const GHOST_CHECK_SCHEMA = "ghost.check/v1";
+/** Severity vocabulary, matching the established agent-check format. */
+export const GHOST_CHECK_SEVERITIES = ["high", "medium", "low"];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/ghost-core/check/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAyB,CAAC;AAE5D,wEAAwE;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC"}

package/dist/ghost-core/errors.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The CLI exit-code contract, in one place so every command agrees and an agent
+ * can branch on the code:
+ *
+ * - `0` success
+ * - `1` ran, but unhappy: a lint/validate finding, or an unexpected error
+ * - `2` called wrong: a bad flag or argument, a missing package, an unknown
+ *   node or surface
+ * - `3` a command-specific refusal (e.g. `skill install` without `--force`)
+ *
+ * Usage errors (`2`) are often surfaced by throwing from deep in a helper
+ * (path validation, byte budgets, overwrite guards). Throwing `UsageError`
+ * instead of a plain `Error` lets the shared catch tell those apart from a
+ * genuine crash, so the contract holds without each call site picking a code.
+ */
+export declare const EXIT: {
+    readonly ok: 0;
+    readonly failure: 1;
+    readonly usage: 2;
+};
+/**
+ * A caller-facing "you used it wrong" error: bad flag or argument, missing
+ * package, invalid environment, or a refused overwrite. Reported at exit code
+ * 2, distinct from an unexpected crash (1).
+ */
+export declare class UsageError extends Error {
+    readonly exitCode: 2;
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/ghost-core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ghost-core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,IAAI;;;;CAIP,CAAC;AAEX;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,QAAQ,IAAc;gBACnB,OAAO,EAAE,MAAM;CAI5B"}