@design-intelligence/ghost 0.20.0

package/dist/commands/pulse-command.js

@@ -0,0 +1,257 @@
+import { buildCatalogMenu } from "#ghost-core";
+import { resolveFingerprintPackage } from "../fingerprint.js";
+import { readGhostEvents, } from "../observability-events.js";
+import { loadFingerprintPackage } from "../scan/fingerprint-package.js";
+import { failFromError } from "./errors.js";
+export function registerPulseCommand(cli) {
+    cli
+        .command("pulse", "Summarize local gather/pull events from .ghost/.events.")
+        .option("--package <dir>", "Use this fingerprint package directory (default: ./.ghost)")
+        .option("--format <fmt>", "Output format: markdown or json", {
+        default: "markdown",
+    })
+        .action(async (opts) => {
+        try {
+            if (opts.format !== "markdown" && opts.format !== "json") {
+                console.error("Error: --format must be 'markdown' or 'json'");
+                process.exit(2);
+                return;
+            }
+            const paths = resolveFingerprintPackage(opts.package, process.cwd());
+            const loaded = await loadFingerprintPackage(paths);
+            const menu = buildCatalogMenu(loaded.catalog, { includeWild: true });
+            const events = await readGhostEvents(paths.packageDir);
+            const report = buildPulseReport(events, menu);
+            if (opts.format === "json") {
+                process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+            }
+            else {
+                process.stdout.write(formatPulseMarkdown(report));
+            }
+            process.exit(0);
+        }
+        catch (err) {
+            failFromError(err);
+        }
+    });
+}
+function buildPulseReport(events, currentMenu) {
+    const exposureCounts = new Map();
+    const pullCounts = new Map();
+    const missCounts = new Map();
+    const nodeKinds = new Map(currentMenu.map((entry) => [entry.id, entry.kind ?? "(no kind)"]));
+    const nodeConcrete = new Map(currentMenu.map((entry) => [entry.id, entry.concrete]));
+    let gathers = 0;
+    let pulls = 0;
+    let wildExposures = 0;
+    let wildPulls = 0;
+    let abandonedGathers = 0;
+    let activeGatherHasPull = false;
+    let sawGather = false;
+    for (const event of events) {
+        if (event.event === "gather") {
+            if (sawGather && !activeGatherHasPull)
+                abandonedGathers += 1;
+            sawGather = true;
+            activeGatherHasPull = false;
+            gathers += 1;
+            for (const id of event.menu) {
+                exposureCounts.set(id, (exposureCounts.get(id) ?? 0) + 1);
+            }
+            wildExposures += event.wildIds?.length ?? 0;
+            continue;
+        }
+        pulls += 1;
+        if (sawGather)
+            activeGatherHasPull = true;
+        for (const id of event.ids) {
+            pullCounts.set(id, (pullCounts.get(id) ?? 0) + 1);
+        }
+        wildPulls += event.wildIds?.length ?? 0;
+        for (const miss of event.missed ?? []) {
+            recordMiss(missCounts, miss);
+        }
+    }
+    if (sawGather && !activeGatherHasPull)
+        abandonedGathers += 1;
+    const nodeIds = new Set([...nodeKinds.keys(), ...exposureCounts.keys()]);
+    const nodes = [...nodeIds]
+        .map((id) => {
+        const exposures = exposureCounts.get(id) ?? 0;
+        const nodePulls = pullCounts.get(id) ?? 0;
+        return {
+            id,
+            exposures,
+            pulls: nodePulls,
+            hitRate: exposures > 0 ? nodePulls / exposures : 0,
+        };
+    })
+        .sort((a, b) => {
+        if (b.exposures !== a.exposures)
+            return b.exposures - a.exposures;
+        if (b.pulls !== a.pulls)
+            return b.pulls - a.pulls;
+        return a.id.localeCompare(b.id);
+    });
+    const kindCounts = new Map();
+    for (const node of nodes) {
+        const kind = nodeKinds.get(node.id) ?? "(no kind)";
+        const counts = kindCounts.get(kind) ?? {
+            exposures: 0,
+            pulls: 0,
+            coldNodes: [],
+        };
+        counts.exposures += node.exposures;
+        counts.pulls += node.pulls;
+        if (node.exposures > 0 && node.pulls === 0) {
+            counts.coldNodes.push(node.id);
+        }
+        kindCounts.set(kind, counts);
+    }
+    const concreteness = buildConcretenessReport(nodes, nodeConcrete);
+    return {
+        kind: "pulse",
+        events: events.length,
+        gathers,
+        pulls,
+        abandonedGathers,
+        pullsPerGather: gathers > 0 ? pulls / gathers : 0,
+        nodes,
+        kinds: [...kindCounts.entries()]
+            .map(([kind, counts]) => ({
+            kind,
+            exposures: counts.exposures,
+            pulls: counts.pulls,
+            hitRate: counts.exposures > 0 ? counts.pulls / counts.exposures : 0,
+            coldNodes: counts.coldNodes.sort(),
+        }))
+            .sort((a, b) => {
+            if (b.exposures !== a.exposures)
+                return b.exposures - a.exposures;
+            if (b.pulls !== a.pulls)
+                return b.pulls - a.pulls;
+            return a.kind.localeCompare(b.kind);
+        }),
+        coldNodes: nodes
+            .filter((node) => node.exposures > 0 && node.pulls === 0)
+            .map((node) => node.id),
+        misses: [...missCounts.entries()]
+            .map(([requested, value]) => ({
+            requested,
+            count: value.count,
+            suggested: [...value.suggested].sort(),
+        }))
+            .sort((a, b) => b.count - a.count || a.requested.localeCompare(b.requested)),
+        wild: {
+            exposures: wildExposures,
+            pulls: wildPulls,
+        },
+        concreteness,
+    };
+}
+function buildConcretenessReport(nodes, nodeConcrete) {
+    const counts = {
+        concrete: { exposures: 0, pulls: 0 },
+        proseOnly: { exposures: 0, pulls: 0 },
+    };
+    for (const node of nodes) {
+        const bucket = nodeConcrete.get(node.id)
+            ? counts.concrete
+            : counts.proseOnly;
+        bucket.exposures += node.exposures;
+        bucket.pulls += node.pulls;
+    }
+    return {
+        concrete: {
+            ...counts.concrete,
+            hitRate: counts.concrete.exposures > 0
+                ? counts.concrete.pulls / counts.concrete.exposures
+                : 0,
+        },
+        proseOnly: {
+            ...counts.proseOnly,
+            hitRate: counts.proseOnly.exposures > 0
+                ? counts.proseOnly.pulls / counts.proseOnly.exposures
+                : 0,
+        },
+    };
+}
+function recordMiss(missCounts, miss) {
+    const existing = missCounts.get(miss.requested) ?? {
+        count: 0,
+        suggested: new Set(),
+    };
+    existing.count += 1;
+    for (const suggestion of miss.suggested)
+        existing.suggested.add(suggestion);
+    missCounts.set(miss.requested, existing);
+}
+function formatPulseMarkdown(report) {
+    const lines = [
+        "# Ghost Pulse",
+        "",
+        `- Events: ${report.events}`,
+        `- Gathers: ${report.gathers}`,
+        `- Pulls: ${report.pulls}`,
+        `- Pulls per gather: ${formatRatio(report.pullsPerGather)}`,
+        `- Abandoned gathers: ${report.abandonedGathers}`,
+        "",
+        "## Concrete vs prose-only",
+        "",
+        "| Segment | Seen on menus | Pulled | Hit rate |",
+        "|---|---:|---:|---:|",
+        `| Concrete material | ${report.concreteness.concrete.exposures} | ${report.concreteness.concrete.pulls} | ${formatPercent(report.concreteness.concrete.hitRate)} |`,
+        `| Prose-only | ${report.concreteness.proseOnly.exposures} | ${report.concreteness.proseOnly.pulls} | ${formatPercent(report.concreteness.proseOnly.hitRate)} |`,
+        "",
+        "## Node hit rates",
+        "",
+    ];
+    if (report.nodes.length === 0) {
+        lines.push("No nodes found.");
+    }
+    else {
+        lines.push("| Node | Seen on menus | Pulled | Hit rate |", "|---|---:|---:|---:|");
+        for (const node of report.nodes) {
+            lines.push(`| \`${node.id}\` | ${node.exposures} | ${node.pulls} | ${formatPercent(node.hitRate)} |`);
+        }
+    }
+    lines.push("", "## Kind hit rates", "");
+    if (report.kinds.length === 0) {
+        lines.push("No kinds found.");
+    }
+    else {
+        lines.push("| Kind | Seen on menus | Pulled | Hit rate | Cold nodes |", "|---|---:|---:|---:|---:|");
+        for (const kind of report.kinds) {
+            lines.push(`| \`${kind.kind}\` | ${kind.exposures} | ${kind.pulls} | ${formatPercent(kind.hitRate)} | ${kind.coldNodes.length} |`);
+        }
+    }
+    lines.push("", "## Cold nodes", "");
+    if (report.coldNodes.length === 0) {
+        lines.push("None.");
+    }
+    else {
+        for (const id of report.coldNodes)
+            lines.push(`- \`${id}\``);
+    }
+    lines.push("", "## Wild usage", "", `- Wild exposures: ${report.wild.exposures}`, `- Wild pulls: ${report.wild.pulls}`);
+    lines.push("", "## Misses", "");
+    if (report.misses.length === 0) {
+        lines.push("None.");
+    }
+    else {
+        for (const miss of report.misses) {
+            const suggestions = miss.suggested.length > 0
+                ? ` — suggested: ${miss.suggested.map((s) => `\`${s}\``).join(", ")}`
+                : "";
+            lines.push(`- \`${miss.requested}\` × ${miss.count}${suggestions}`);
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
+function formatRatio(value) {
+    return Number.isFinite(value) ? value.toFixed(2) : "0.00";
+}
+function formatPercent(value) {
+    return `${Math.round(value * 100)}%`;
+}
+//# sourceMappingURL=pulse-command.js.map

package/dist/commands/pulse-command.js.map

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

package/dist/commands/review-command.d.ts

@@ -0,0 +1,3 @@
+import type { CAC } from "cac";
+export declare function registerReviewCommand(cli: CAC): void;
+//# sourceMappingURL=review-command.d.ts.map

package/dist/commands/review-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-command.d.ts","sourceRoot":"","sources":["../../src/commands/review-command.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAW/B,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAqDpD"}

package/dist/commands/review-command.js

@@ -0,0 +1,77 @@
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { promisify } from "node:util";
+import { resolveFingerprintPackage } from "../fingerprint.js";
+import { buildReviewPacket, formatReviewPacket, } from "../review/review-packet.js";
+import { loadFingerprintPackage } from "../scan/fingerprint-package.js";
+import { failFromError } from "./errors.js";
+const execFileAsync = promisify(execFile);
+export function registerReviewCommand(cli) {
+    cli
+        .command("review", "Emit an advisory review packet for a diff using material-backed nodes and checks.")
+        .option("--package <dir>", "Use this fingerprint package directory (default: ./.ghost)")
+        .option("--base <ref>", "Git ref to diff against (default: HEAD)")
+        .option("--diff <path>", "Read diff from a file, or '-' for stdin")
+        .option("--format <fmt>", "Output format: markdown or json", {
+        default: "markdown",
+    })
+        .option("--json", "Emit the raw JSON packet")
+        .option("--no-probes", "Skip check probe shell commands")
+        .action(async (opts) => {
+        try {
+            const format = opts.json ? "json" : opts.format;
+            if (format !== "markdown" && format !== "json") {
+                console.error("Error: --format must be 'markdown' or 'json'");
+                process.exit(2);
+                return;
+            }
+            const paths = resolveFingerprintPackage(opts.package, process.cwd());
+            const fingerprint = await loadFingerprintPackage(paths);
+            if (!fingerprint.hasChecksDir) {
+                console.error("No checks directory. Run `ghost checks init` to add review assertions.");
+                process.exit(2);
+                return;
+            }
+            const diffText = await resolveDiff({
+                base: opts.base,
+                diff: opts.diff,
+            });
+            const packet = await buildReviewPacket(fingerprint, diffText, {
+                runProbes: opts.probes !== false,
+                cwd: process.cwd(),
+            });
+            process.stdout.write(format === "json"
+                ? `${JSON.stringify(packet, null, 2)}\n`
+                : formatReviewPacket(packet));
+            process.exit(0);
+        }
+        catch (err) {
+            failFromError(err);
+        }
+    });
+}
+async function resolveDiff(options) {
+    if (options.diff === "-")
+        return readStdin();
+    if (options.diff !== undefined) {
+        return readFile(resolve(process.cwd(), options.diff), "utf8");
+    }
+    const base = options.base ?? "HEAD";
+    const { stdout } = await execFileAsync("git", ["diff", base], {
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    return stdout;
+}
+function readStdin() {
+    return new Promise((resolvePromise, reject) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on("end", () => resolvePromise(data));
+        process.stdin.on("error", reject);
+    });
+}
+//# sourceMappingURL=review-command.js.map

package/dist/commands/review-command.js.map

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

package/dist/commands/skill-command.d.ts

@@ -0,0 +1,3 @@
+import type { CAC } from "cac";
+export declare function registerSkillCommand(cli: CAC): void;
+//# sourceMappingURL=skill-command.d.ts.map

package/dist/commands/skill-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-command.d.ts","sourceRoot":"","sources":["../../src/commands/skill-command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAkB/B,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAsDnD"}

package/dist/commands/skill-command.js

@@ -0,0 +1,96 @@
+import { existsSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadSkillBundle, UsageError } from "#ghost-core";
+import { failFromError } from "./errors.js";
+// The bundle assets are copied to `dist/skill-bundle` (sibling of `commands/`).
+const SKILL_BUNDLE_ROOT = fileURLToPath(new URL("../skill-bundle", import.meta.url));
+const SUPPORTED_AGENTS = [
+    "claude",
+    "cursor",
+    "codex",
+    "opencode",
+    "goose",
+];
+export function registerSkillCommand(cli) {
+    cli
+        .command("skill <action>", "Install the unified Ghost skill bundle.")
+        .option("--dest <path>", "Install destination (default: detected agent skills directory + /ghost)")
+        .option("--agent <name>", "Agent destination to use when --dest is omitted: claude, cursor, codex, opencode, goose")
+        .option("--force", "Overwrite an existing installed Ghost skill")
+        .action(async (action, opts) => {
+        try {
+            if (action !== "install") {
+                console.error("Error: ghost skill currently supports only `install`");
+                process.exit(2);
+                return;
+            }
+            const agent = parseAgent(opts.agent);
+            const outDir = resolve(process.cwd(), typeof opts.dest === "string"
+                ? opts.dest
+                : `${agentSkillDir(agent ?? detectAgent())}/ghost`);
+            if (existsSync(resolve(outDir, "SKILL.md")) && !opts.force) {
+                console.error(`Error: ${outDir} already contains SKILL.md. Pass --force to reinstall.`);
+                process.exit(3);
+                return;
+            }
+            const bundle = loadSkillBundle(SKILL_BUNDLE_ROOT);
+            const written = [];
+            for (const file of bundle) {
+                const outPath = resolve(outDir, file.path);
+                await mkdir(dirname(outPath), { recursive: true });
+                await writeFile(outPath, file.content, "utf-8");
+                written.push(file.path);
+            }
+            process.stdout.write(`Wrote ${written.length} file${written.length === 1 ? "" : "s"} to ${outDir}:\n`);
+            for (const file of written)
+                process.stdout.write(`  ${file}\n`);
+            process.exit(0);
+        }
+        catch (err) {
+            failFromError(err);
+        }
+    });
+}
+function parseAgent(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (typeof raw === "string" &&
+        SUPPORTED_AGENTS.includes(raw)) {
+        return raw;
+    }
+    throw new UsageError(`--agent must be one of: ${SUPPORTED_AGENTS.join(", ")}`);
+}
+function detectAgent() {
+    const home = homedir();
+    if (existsSync(resolve(home, ".claude")))
+        return "claude";
+    if (existsSync(resolve(home, ".cursor")))
+        return "cursor";
+    if (existsSync(resolve(home, ".codex")))
+        return "codex";
+    if (existsSync(resolve(home, ".opencode")))
+        return "opencode";
+    if (existsSync(resolve(home, ".goose")) ||
+        existsSync(resolve(home, ".config", "goose"))) {
+        return "goose";
+    }
+    return "claude";
+}
+function agentSkillDir(agent) {
+    const home = homedir();
+    if (agent === "claude")
+        return resolve(home, ".claude", "skills");
+    if (agent === "cursor")
+        return resolve(home, ".cursor", "skills");
+    if (agent === "codex")
+        return resolve(home, ".codex", "skills");
+    if (agent === "opencode")
+        return resolve(home, ".opencode", "skills");
+    // Goose's canonical writable global skills location is ~/.agents/skills —
+    // the agent-neutral path it scans first among global roots.
+    return resolve(home, ".agents", "skills");
+}
+//# sourceMappingURL=skill-command.js.map

package/dist/commands/skill-command.js.map

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

package/dist/fingerprint.d.ts

@@ -0,0 +1,5 @@
+export { FINGERPRINT_MANIFEST_FILENAME, FINGERPRINT_PACKAGE_DIR, } from "./scan/constants.js";
+export type { FingerprintPackagePaths, 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

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

package/dist/fingerprint.js

@@ -0,0 +1,3 @@
+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

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

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

@@ -0,0 +1,30 @@
+import type { GhostNodeDocument } from "../node/types.js";
+import type { GhostCatalog } from "./types.js";
+/**
+ * One local node located in the package files: its computed path id,
+ * its filename-derived kind/slug, and the parsed document. There is no
+ * containment axis — the catalog is flat.
+ */
+export interface PlacedNode {
+    id: string;
+    /** Optional filename prefix before the first dot (`principle.density`). */
+    kind?: string;
+    /** Filename slug: the bare name, or the part after the first dot. */
+    slug?: string;
+    doc: GhostNodeDocument;
+}
+export interface AssembleCatalogInput {
+    /** Local nodes located in the package files. */
+    placedNodes?: PlacedNode[];
+    /** Kinds whose glossary kind declares `posture: wild`. */
+    wildKinds?: Iterable<string>;
+    /** Kinds whose glossary kind declares `posture: guard`. */
+    guardKinds?: Iterable<string>;
+}
+/**
+ * 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
+ * agent selects from the catalog.
+ */
+export declare function assembleCatalog(input: AssembleCatalogInput): GhostCatalog;
+//# sourceMappingURL=assemble.d.ts.map

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

@@ -0,0 +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;IAC3B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAiCzE"}

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

@@ -0,0 +1,38 @@
+import { carriesConcreteMaterial, extractSkeletonSections, } 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
+ * agent selects from the catalog.
+ */
+export function assembleCatalog(input) {
+    const nodes = new Map();
+    const wildKinds = new Set(input.wildKinds ?? []);
+    const guardKinds = new Set(input.guardKinds ?? []);
+    for (const placed of input.placedNodes ?? []) {
+        const fm = placed.doc.frontmatter;
+        const concrete = carriesConcreteMaterial({
+            materials: fm.materials,
+            body: placed.doc.body,
+        });
+        const posture = placed.kind !== undefined && wildKinds.has(placed.kind)
+            ? "wild"
+            : placed.kind !== undefined && guardKinds.has(placed.kind)
+                ? "guard"
+                : "steady";
+        nodes.set(placed.id, {
+            id: placed.id,
+            ...(placed.kind !== undefined ? { kind: placed.kind } : {}),
+            slug: placed.slug ?? placed.id.split("/").pop() ?? placed.id,
+            ...(fm.description !== undefined ? { description: fm.description } : {}),
+            ...(fm.materials !== undefined ? { materials: fm.materials } : {}),
+            concrete,
+            hasSkeleton: extractSkeletonSections(placed.doc.body).length > 0,
+            posture,
+            ...(posture === "wild" ? { wild: true } : {}),
+            ...(posture === "guard" ? { guard: true } : {}),
+            body: placed.doc.body,
+        });
+    }
+    return { nodes };
+}
+//# sourceMappingURL=assemble.js.map

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

@@ -0,0 +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;AA2B7B;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAEnD,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,MAAM,OAAO,GACX,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YACrD,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;gBACxD,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,QAAQ,CAAC;QACjB,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,OAAO;YACP,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,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/closest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 declare function closestIds(query: string, ids: Iterable<string>, max?: number): string[];
+//# sourceMappingURL=closest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"closest.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/catalog/closest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EACrB,GAAG,SAAI,GACN,MAAM,EAAE,CAyBV"}