@design-intelligence/ghost 0.23.0 → 0.25.0

package/dist/embed/pull.js

@@ -0,0 +1,96 @@
+import { classifyMaterialLocator, closestIds, extractSkeletonFences, resolveLocalMaterialLocator, stripSkeletonSections, transportMaterials, } from "#ghost-core";
+import { GHOST_MATERIALS_DIR } from "../scan/constants.js";
+export async function pullGhostNodes(snapshot, options) {
+    const requested = [...new Set(options.ids)];
+    const allIds = [...snapshot.catalog.nodes.keys()];
+    const known = requested.filter((id) => snapshot.catalog.nodes.has(id));
+    const missed = requested
+        .filter((id) => !snapshot.catalog.nodes.has(id))
+        .map((id) => ({ requested: id, suggested: closestIds(id, allIds) }));
+    const givenNodes = known.map((id) => snapshot.catalog.nodes.get(id));
+    const orderedNodes = (options.order ?? "steering") === "given"
+        ? givenNodes
+        : orderPulledNodes(givenNodes, snapshot.cover.state === "resolved" ? snapshot.cover.id : undefined);
+    const packageDir = snapshot.package.dir;
+    const pulledNodes = await resolvePulledNodes(orderedNodes, options.repoRoot, packageDir, options.inlineMaterials !== false);
+    const materialCounts = sumMaterialCounts(pulledNodes);
+    return {
+        kind: "pull",
+        requested,
+        ids: known,
+        missed,
+        nodes: pulledNodes.map(({ node, materials }) => ({
+            id: node.id,
+            ...(node.kind !== undefined ? { kind: node.kind } : {}),
+            ...(node.description ? { description: node.description } : {}),
+            ...(node.materials !== undefined
+                ? { declaredMaterials: [...node.materials] }
+                : {}),
+            ...(node.materials !== undefined
+                ? { materials: materials.materials }
+                : {}),
+            body: stripSkeletonSections(node.body),
+        })),
+        skeletons: pulledSkeletons(pulledNodes),
+        materialCounts,
+    };
+}
+async function resolvePulledNodes(nodes, repoRoot, packageDir, inlineMaterials) {
+    return Promise.all(nodes.map(async (node) => ({
+        node,
+        materials: inlineMaterials
+            ? await transportMaterials(node.materials, {
+                repoRoot,
+                packageDir,
+                materialsDir: GHOST_MATERIALS_DIR,
+            })
+            : locatorOnlyMaterials(node.materials, repoRoot, packageDir),
+    })));
+}
+function orderPulledNodes(nodes, coverId) {
+    return nodes
+        .map((node, index) => ({
+        node,
+        index,
+        bucket: steeringBucket(node, coverId),
+    }))
+        .sort((a, b) => a.bucket - b.bucket || a.index - b.index)
+        .map((entry) => entry.node);
+}
+function steeringBucket(node, coverId) {
+    if (coverId !== undefined && node.id === coverId)
+        return 0;
+    if (node.concrete)
+        return 1;
+    return 2;
+}
+function locatorOnlyMaterials(locators, repoRoot, packageDir) {
+    return {
+        materials: (locators ?? []).map((locator) => ({
+            locator,
+            tier: classifyMaterialLocator(locator).kind === "url"
+                ? "url"
+                : resolveLocalMaterialLocator(locator, {
+                    repoRoot,
+                    packageDir,
+                    materialsDir: GHOST_MATERIALS_DIR,
+                }).tier,
+        })),
+        inlined: 0,
+        omitted: 0,
+    };
+}
+function sumMaterialCounts(nodes) {
+    return nodes.reduce((sum, { materials }) => ({
+        inlined: sum.inlined + materials.inlined,
+        omitted: sum.omitted + materials.omitted,
+    }), { inlined: 0, omitted: 0 });
+}
+function pulledSkeletons(nodes) {
+    return nodes.flatMap(({ node }) => extractSkeletonFences(node.body).map((fence) => ({
+        nodeId: node.id,
+        ...(fence.info ? { info: fence.info } : {}),
+        content: fence.content,
+    })));
+}
+//# sourceMappingURL=pull.js.map

package/dist/embed/pull.js.map

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

package/dist/embed/readonly-map.d.ts

@@ -0,0 +1,3 @@
+export type ReadOnlySnapshotMap<K, V> = ReadonlyMap<K, V>;
+export declare function snapshotMap<K, V>(source: ReadonlyMap<K, V>): ReadOnlySnapshotMap<K, V>;
+//# sourceMappingURL=readonly-map.d.ts.map

package/dist/embed/readonly-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readonly-map.d.ts","sourceRoot":"","sources":["../../src/embed/readonly-map.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,CAAC,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE1D,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAC9B,MAAM,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GACxB,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAiC3B"}

package/dist/embed/readonly-map.js

@@ -0,0 +1,33 @@
+export function snapshotMap(source) {
+    const map = new Map(source.entries());
+    const readonlyMap = {
+        get size() {
+            return map.size;
+        },
+        get(key) {
+            return map.get(key);
+        },
+        has(key) {
+            return map.has(key);
+        },
+        entries() {
+            return map.entries();
+        },
+        keys() {
+            return map.keys();
+        },
+        values() {
+            return map.values();
+        },
+        forEach(callback, thisArg) {
+            map.forEach((value, key) => {
+                callback.call(thisArg, value, key, readonlyMap);
+            });
+        },
+        [Symbol.iterator]() {
+            return map[Symbol.iterator]();
+        },
+    };
+    return Object.freeze(readonlyMap);
+}
+//# sourceMappingURL=readonly-map.js.map

package/dist/embed/readonly-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readonly-map.js","sourceRoot":"","sources":["../../src/embed/readonly-map.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CACzB,MAAyB;IAEzB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAO,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAE5C,MAAM,WAAW,GAA8B;QAC7C,IAAI,IAAI;YACN,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;QACD,GAAG,CAAC,GAAG;YACL,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,GAAG,CAAC,GAAG;YACL,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,OAAO;YACL,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QACD,IAAI;YACF,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QACD,MAAM;YACJ,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,CAAC,QAAQ,EAAE,OAAO;YACvB,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACzB,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;QACL,CAAC;QACD,CAAC,MAAM,CAAC,QAAQ,CAAC;YACf,OAAO,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,CAAC;KACF,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC"}

package/dist/embed/snapshot.d.ts

@@ -0,0 +1,4 @@
+import type { GhostPackagePaths } from "../scan/fingerprint-package.js";
+import type { GhostEmbedSnapshot } from "./types.js";
+export declare function loadGhostSnapshot(paths: GhostPackagePaths): Promise<GhostEmbedSnapshot>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/embed/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/embed/snapshot.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,KAAK,EAAmB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEtE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAsB7B"}

package/dist/embed/snapshot.js

@@ -0,0 +1,105 @@
+import { readFile } from "node:fs/promises";
+import { parseGlossary } from "#ghost-core";
+import { isMissingPathError } from "../internal/fs.js";
+import { loadGhostPackage } from "../scan/fingerprint-package.js";
+import { snapshotMap } from "./readonly-map.js";
+export async function loadGhostSnapshot(paths) {
+    const loaded = await loadGhostPackage(paths);
+    const nodes = snapshotMap(cloneNodeMap(loaded.catalog.nodes));
+    const cover = resolveCoverState(loaded.manifest.cover, nodes);
+    const glossary = await loadSnapshotGlossary(paths.glossary);
+    return deepFreeze({
+        package: {
+            id: loaded.manifest.id,
+            dir: paths.packageDir,
+            manifest: loaded.manifest,
+            manifestRaw: loaded.manifestRaw,
+        },
+        catalog: {
+            nodes,
+        },
+        cover,
+        ...(glossary ? { glossary } : {}),
+        checks: snapshotMap(cloneCheckMap(loaded.checks)),
+        invalid: loaded.invalid.map((entry) => ({ ...entry })),
+        invalidChecks: loaded.invalidChecks.map((entry) => ({ ...entry })),
+    });
+}
+function resolveCoverState(coverId, nodes) {
+    if (coverId === undefined)
+        return { state: "absent" };
+    const node = nodes.get(coverId);
+    if (node === undefined)
+        return { state: "dangling", id: coverId };
+    return { state: "resolved", id: coverId, node };
+}
+function cloneNodeMap(source) {
+    return new Map([...source.entries()].map(([id, node]) => [
+        id,
+        deepFreeze({
+            ...node,
+            ...(node.materials ? { materials: [...node.materials] } : {}),
+        }),
+    ]));
+}
+function cloneCheckMap(source) {
+    return new Map([...source.entries()].map(([id, check]) => [
+        id,
+        deepFreeze({
+            id: check.id,
+            doc: {
+                frontmatter: cloneCheckFrontmatter(check.doc.frontmatter),
+                body: check.doc.body,
+            },
+            references: [...check.references],
+        }),
+    ]));
+}
+function cloneCheckFrontmatter(frontmatter) {
+    return {
+        ...frontmatter,
+        ...(frontmatter.tools ? { tools: [...frontmatter.tools] } : {}),
+        ...(frontmatter.references
+            ? { references: [...frontmatter.references] }
+            : {}),
+    };
+}
+async function loadSnapshotGlossary(glossaryPath) {
+    let raw;
+    try {
+        raw = await readFile(glossaryPath, "utf-8");
+    }
+    catch (err) {
+        if (isMissingPathError(err))
+            return undefined;
+        throw err;
+    }
+    const result = parseGlossary(raw);
+    if (result.glossary === null)
+        return undefined;
+    return {
+        path: glossaryPath,
+        kinds: result.glossary.kinds.map((kind) => ({ ...kind })),
+    };
+}
+function deepFreeze(value) {
+    if (value && typeof value === "object") {
+        if (value instanceof Map) {
+            for (const [key, item] of value) {
+                deepFreeze(key);
+                deepFreeze(item);
+            }
+        }
+        else if (Array.isArray(value)) {
+            for (const item of value)
+                deepFreeze(item);
+        }
+        else {
+            for (const item of Object.values(value))
+                deepFreeze(item);
+        }
+        Object.freeze(value);
+    }
+    return value;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/embed/snapshot.js.map

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

package/dist/embed/types.d.ts

@@ -0,0 +1,156 @@
+import type { CatalogMenuEntry, GhostCatalogNode, GhostGlossaryKind, GhostPackageManifest, TransportedMaterial } from "#ghost-core";
+import type { PullMiss } from "../observability-events.js";
+import type { LoadedCheck } from "../scan/check-files.js";
+import type { ReadOnlySnapshotMap } from "./readonly-map.js";
+export type GhostCoverState = {
+    state: "resolved";
+    id: string;
+    node: Readonly<GhostCatalogNode>;
+} | {
+    state: "absent";
+} | {
+    state: "dangling";
+    id: string;
+};
+export interface GhostGlossarySnapshot {
+    path: string;
+    kinds: readonly Readonly<GhostGlossaryKind>[];
+}
+export interface GhostEmbedSnapshot {
+    package: Readonly<{
+        id: string;
+        dir: string;
+        manifest: Readonly<GhostPackageManifest>;
+        manifestRaw: string;
+    }>;
+    catalog: Readonly<{
+        nodes: ReadOnlySnapshotMap<string, Readonly<GhostCatalogNode>>;
+    }>;
+    cover: GhostCoverState;
+    glossary?: Readonly<GhostGlossarySnapshot>;
+    checks: ReadOnlySnapshotMap<string, Readonly<LoadedCheck>>;
+    invalid: readonly Readonly<{
+        file: string;
+        message: string;
+    }>[];
+    invalidChecks: readonly Readonly<{
+        file: string;
+        message: string;
+    }>[];
+}
+export interface GhostMenuKind {
+    name: string;
+    purpose: string;
+}
+export interface GhostGatherCoverage {
+    nodes: number;
+    concrete: number;
+    payloads: {
+        materials: number;
+        fencedExamples: number;
+        skeletons: number;
+    };
+    undescribed: number;
+}
+export interface GhostGatherContract {
+    completeness: {
+        complete: true;
+        filtered: false;
+        ranked: false;
+        selectedByGhost: false;
+    };
+    selection: {
+        basis: "applicability";
+        instruction: string;
+        topicOverlapAloneIsApplicability: false;
+        addForCompleteness: false;
+        omitApplicableForCount: false;
+    };
+    noAsk: string;
+}
+export interface GhostGatherResult {
+    kind: "menu";
+    ask?: string;
+    source: {
+        artifact: "ghost package";
+        list: "Available guidance";
+    };
+    contract: GhostGatherContract;
+    cover: GhostCoverState;
+    silence: {
+        ifNoneApply: string;
+    };
+    coverage: GhostGatherCoverage;
+    kinds?: readonly GhostMenuKind[];
+    /** Selectable menu entries. A resolved cover is intentionally separated. */
+    nodes: readonly CatalogMenuEntry[];
+}
+export type GhostPullOrder = "steering" | "given";
+export interface GhostPulledSkeleton {
+    nodeId: string;
+    info?: string;
+    content: string;
+}
+export interface GhostPulledNode {
+    id: string;
+    kind?: string;
+    description?: string;
+    declaredMaterials?: readonly string[];
+    materials?: readonly TransportedMaterial[];
+    body: string;
+}
+export interface GhostPullResult {
+    kind: "pull";
+    requested: readonly string[];
+    ids: readonly string[];
+    missed: readonly PullMiss[];
+    nodes: readonly GhostPulledNode[];
+    skeletons: readonly GhostPulledSkeleton[];
+    materialCounts: {
+        inlined: number;
+        omitted: number;
+    };
+}
+export type GhostInspectLocalPolicy = "bundled" | "bundled-and-referenced";
+export interface GhostInspectPolicy {
+    local?: GhostInspectLocalPolicy;
+    maxBytes?: number;
+    allowedMimeTypes?: readonly string[];
+}
+export interface InspectGhostMaterialRequest {
+    nodeId: string;
+    locator: string;
+    repoRoot: string;
+    policy?: GhostInspectPolicy;
+}
+export type InspectGhostMaterialResult = {
+    ok: true;
+    nodeId: string;
+    locator: string;
+    tier: "bundled" | "referenced";
+    path: string;
+    byteLength: number;
+    mime: string;
+    contentKind: "text";
+    encoding: "utf-8";
+    text: string;
+} | {
+    ok: true;
+    nodeId: string;
+    locator: string;
+    tier: "bundled" | "referenced";
+    path: string;
+    byteLength: number;
+    mime: string;
+    contentKind: "image" | "binary";
+} | {
+    ok: false;
+    nodeId: string;
+    locator: string;
+    reason: string;
+    tier?: "bundled" | "referenced" | "url";
+    path?: string;
+    byteLength?: number;
+    mime?: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embed/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,MAAM,eAAe,GACvB;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;CAClC,GACD;IACE,KAAK,EAAE,QAAQ,CAAC;CACjB,GACD;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEN,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,QAAQ,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QACzC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,CAAC;QAChB,KAAK,EAAE,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;KAChE,CAAC,CAAC;IACH,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAC3C,MAAM,EAAE,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3D,OAAO,EAAE,SAAS,QAAQ,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAChE,aAAa,EAAE,SAAS,QAAQ,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;CACvE;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE;QACZ,QAAQ,EAAE,IAAI,CAAC;QACf,QAAQ,EAAE,KAAK,CAAC;QAChB,MAAM,EAAE,KAAK,CAAC;QACd,eAAe,EAAE,KAAK,CAAC;KACxB,CAAC;IACF,SAAS,EAAE;QACT,KAAK,EAAE,eAAe,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,gCAAgC,EAAE,KAAK,CAAC;QACxC,kBAAkB,EAAE,KAAK,CAAC;QAC1B,sBAAsB,EAAE,KAAK,CAAC;KAC/B,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,QAAQ,EAAE,eAAe,CAAC;QAC1B,IAAI,EAAE,oBAAoB,CAAC;KAC5B,CAAC;IACF,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,KAAK,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,4EAA4E;IAC5E,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpC;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,SAAS,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAClC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,cAAc,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,wBAAwB,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,MAAM,0BAA0B,GAClC;IACE,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,GAAG,YAAY,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,GAAG,YAAY,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC;CACjC,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,KAAK,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/embed/types.js

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

package/dist/embed/types.js.map

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

package/dist/fingerprint.d.ts

@@ -1,5 +1,6 @@
+/** @deprecated Import from `@design-intelligence/ghost/package`. */
 export { FINGERPRINT_MANIFEST_FILENAME, FINGERPRINT_PACKAGE_DIR, } from "./scan/constants.js";
-export type { FingerprintPackagePaths, LoadedFingerprintPackage, } from "./scan/fingerprint-package.js";
+export type { FingerprintPackagePaths, InitFingerprintPackageOptions, InitFingerprintPackageResult, LoadedFingerprintPackage, } from "./scan/fingerprint-package.js";
 export { initFingerprintPackage, lintFingerprintPackage, loadFingerprintPackage, resolveFingerprintPackage, } from "./scan/fingerprint-package.js";
 export type { LintIssue, LintReport, LintSeverity } from "./scan/lint.js";
 //# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,uBAAuB,EACvB,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/fingerprint.js

@@ -1,3 +1,4 @@
+/** @deprecated Import from `@design-intelligence/ghost/package`. */
 export { FINGERPRINT_MANIFEST_FILENAME, FINGERPRINT_PACKAGE_DIR, } from "./scan/constants.js";
 export { initFingerprintPackage, lintFingerprintPackage, loadFingerprintPackage, resolveFingerprintPackage, } from "./scan/fingerprint-package.js";
 //# sourceMappingURL=fingerprint.js.map

package/dist/fingerprint.js.map

@@ -1 +1 @@
-{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/catalog/assemble.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,iBAAiB,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAsBzE"}
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/catalog/assemble.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,iBAAiB,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAuBzE"}

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

@@ -1,4 +1,4 @@
-import { carriesConcreteMaterial, extractSkeletonSections, } from "../node/steering.js";
+import { carriesConcreteMaterial, extractSkeletonSections, hasSubstantialFencedExample, } from "../node/steering.js";
 /**
  * Assemble package node files into one flat in-memory catalog. Each node's id
  * is its path; kind/slug come from its filename. No edges, no cascade — the
@@ -19,6 +19,7 @@ export function assembleCatalog(input) {
             ...(fm.description !== undefined ? { description: fm.description } : {}),
             ...(fm.materials !== undefined ? { materials: fm.materials } : {}),
             concrete,
+            hasFencedExample: hasSubstantialFencedExample(placed.doc.body),
             hasSkeleton: extractSkeletonSections(placed.doc.body).length > 0,
             body: placed.doc.body,
         });

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

@@ -1 +1 @@
-{"version":3,"file":"assemble.js","sourceRoot":"","sources":["../../../src/ghost-core/catalog/assemble.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAuB7B;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAElD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;QAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QAClC,MAAM,QAAQ,GAAG,uBAAuB,CAAC;YACvC,SAAS,EAAE,EAAE,CAAC,SAAS;YACvB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;SACtB,CAAC,CAAC;QACH,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE;YACnB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,EAAE;YAC5D,GAAG,CAAC,EAAE,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,QAAQ;YACR,WAAW,EAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAChE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}
+{"version":3,"file":"assemble.js","sourceRoot":"","sources":["../../../src/ghost-core/catalog/assemble.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAuB7B;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAElD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;QAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QAClC,MAAM,QAAQ,GAAG,uBAAuB,CAAC;YACvC,SAAS,EAAE,EAAE,CAAC,SAAS;YACvB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;SACtB,CAAC,CAAC;QACH,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE;YACnB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,EAAE;YAC5D,GAAG,CAAC,EAAE,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,QAAQ;YACR,gBAAgB,EAAE,2BAA2B,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAC9D,WAAW,EAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAChE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}

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

@@ -1,9 +1,9 @@
 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 reads what it judges
- * relevant; Ghost does no NLP and no selection.
+ * `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;
@@ -12,8 +12,10 @@ export interface CatalogMenuEntry {
     description?: string;
     /** Count of material locators available after pulling this node. */
     materials?: number;
-    /** True when this entry carries concrete material by derived structure. */
+    /** 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;
 }

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

@@ -1 +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,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,EAAE,CAiB1E"}
+{"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

@@ -14,6 +14,7 @@ export function buildCatalogMenu(catalog) {
                 ? { materials: node.materials.length }
                 : {}),
             concrete: node.concrete,
+            ...(node.hasFencedExample ? { hasFencedExample: true } : {}),
             ...(node.hasSkeleton ? { hasSkeleton: true } : {}),
         });
     }

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

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

@@ -10,12 +10,14 @@ export interface GhostCatalogNode {
     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. */
+    /** 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 materials, a substantial fence, or a Skeleton. */
+    /** 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;

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

@@ -1 +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,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACtC"}
+{"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/check/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Public surface for `ghost.check/v1` — markdown + frontmatter checks an agent
- * evaluates (Ghost never runs them). Every check is offered to the reviewer;
+ * 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.
  */

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

@@ -1,6 +1,6 @@
 /**
  * Public surface for `ghost.check/v1` — markdown + frontmatter checks an agent
- * evaluates (Ghost never runs them). Every check is offered to the reviewer;
+ * 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.
  */

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

@@ -1,8 +1,8 @@
 import { type GhostCheckLintReport } from "./types.js";
 /**
- * Lint a Ghost check markdown file (`ghost.check/v1`): required frontmatter
+ * 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
+ * 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;

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

@@ -2,9 +2,9 @@ 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
+ * 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
+ * and a non-empty body. ghost never executes the check — this only validates
  * that it is well-formed.
  */
 export function lintGhostCheck(raw) {

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

@@ -1,6 +1,6 @@
 import type { GhostCheckDocument } from "./types.js";
 /**
- * Parse a well-formed Ghost check into a typed document. Assumes the input has
+ * 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;