@design-intelligence/ghost 0.20.0

package/dist/review/resolve.js

@@ -0,0 +1,87 @@
+import { classifyMaterialLocator, parseSourceRef, } from "#ghost-core";
+import { parseTouchedFiles } from "./diff.js";
+import { matchesGlob } from "./glob.js";
+export function resolveReview(catalog, checks, diffText) {
+    const touchedFiles = parseTouchedFiles(diffText);
+    const materialNodeIds = new Set();
+    const matched = new Map();
+    const claimedFiles = new Set();
+    for (const node of catalog.nodes.values()) {
+        const localLocators = (node.materials ?? []).filter((locator) => classifyMaterialLocator(locator).kind === "local");
+        if (localLocators.length === 0)
+            continue;
+        materialNodeIds.add(node.id);
+        for (const file of touchedFiles) {
+            const locators = localLocators.filter((locator) => matchesGlob(locator, file.path));
+            if (locators.length === 0)
+                continue;
+            claimedFiles.add(file.path);
+            const entry = matched.get(node.id) ?? {
+                files: new Set(),
+                locators: new Set(),
+            };
+            entry.files.add(file.path);
+            for (const locator of locators)
+                entry.locators.add(locator);
+            matched.set(node.id, entry);
+        }
+    }
+    const touchedMaterialNodes = new Set(matched.keys());
+    const referencedMaterialNodes = new Set();
+    const offeredChecks = [];
+    for (const check of checks.values()) {
+        const matchedRefs = [];
+        let referencesMaterial = false;
+        for (const raw of check.references) {
+            const ref = parseSourceRef(raw);
+            if (ref === null)
+                continue;
+            if (materialNodeIds.has(ref.nodeId)) {
+                referencesMaterial = true;
+                referencedMaterialNodes.add(ref.nodeId);
+                if (touchedMaterialNodes.has(ref.nodeId))
+                    matchedRefs.push(raw);
+            }
+        }
+        if (matchedRefs.length > 0 || !referencesMaterial) {
+            offeredChecks.push({
+                id: check.id,
+                severity: check.doc.frontmatter.severity,
+                offered: matchedRefs.length > 0 ? "matched" : "always",
+                via: matchedRefs.length > 0 ? matchedRefs : check.references.slice(),
+            });
+        }
+    }
+    const gaps = [];
+    const unmatched = touchedFiles
+        .map((file) => file.path)
+        .filter((path) => !claimedFiles.has(path));
+    if (unmatched.length > 0) {
+        gaps.push({
+            kind: "unmatched-file",
+            detail: "changed files match no node `materials` locators — no fingerprint material claims them",
+            files: unmatched,
+        });
+    }
+    const unguarded = [...touchedMaterialNodes].filter((id) => !referencedMaterialNodes.has(id));
+    if (unguarded.length > 0) {
+        gaps.push({
+            kind: "unguarded-material",
+            detail: "touched material-backed nodes have no check referencing them — review coverage is missing",
+            nodes: unguarded,
+        });
+    }
+    const matchedNodes = [...matched].map(([id, entry]) => ({
+        id,
+        files: [...entry.files].sort(),
+        locators: [...entry.locators].sort(),
+    }));
+    return {
+        touchedFiles,
+        materialNodes: matchedNodes,
+        guardNodes: matchedNodes.filter((node) => catalog.nodes.get(node.id)?.guard),
+        offeredChecks,
+        gaps,
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/review/resolve.js.map

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

package/dist/review/review-packet.d.ts

@@ -0,0 +1,40 @@
+import type { LoadedFingerprintPackage } from "../scan/fingerprint-package.js";
+import { type BaselineProse } from "./baseline.js";
+import { type ProbeEvidence } from "./probes.js";
+import type { CoverageGap } from "./resolve.js";
+export type { BaselineProse, ProbeEvidence };
+export interface PacketMaterialNode {
+    id: string;
+    kind?: string;
+    description?: string;
+    prose: string;
+    materials: string[];
+    matchedMaterials: string[];
+    files: string[];
+}
+export interface PacketCheck {
+    id: string;
+    severity: string | undefined;
+    offered: "matched" | "always";
+    via: string[];
+    prose: string;
+    baseline: BaselineProse[];
+    probe?: ProbeEvidence;
+}
+export interface ReviewPacket {
+    fingerprintId: string;
+    touchedFiles: string[];
+    materialNodes: PacketMaterialNode[];
+    guardNodes: PacketMaterialNode[];
+    checks: PacketCheck[];
+    gaps: CoverageGap[];
+    diff: string;
+}
+export interface BuildReviewPacketOptions {
+    runProbes?: boolean;
+    cwd?: string;
+    probeTimeoutMs?: number;
+}
+export declare function buildReviewPacket(fingerprint: LoadedFingerprintPackage, diffText: string, options?: BuildReviewPacketOptions): Promise<ReviewPacket>;
+export declare function formatReviewPacket(packet: ReviewPacket): string;
+//# sourceMappingURL=review-packet.d.ts.map

package/dist/review/review-packet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-packet.d.ts","sourceRoot":"","sources":["../../src/review/review-packet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,wBAAwB,EACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,YAAY,CAAC,CAkDvB;AAoBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA6G/D"}

package/dist/review/review-packet.js

@@ -0,0 +1,139 @@
+import { resolveBaseline } from "./baseline.js";
+import { runProbe } from "./probes.js";
+import { resolveReview } from "./resolve.js";
+export async function buildReviewPacket(fingerprint, diffText, options = {}) {
+    const resolution = resolveReview(fingerprint.catalog, fingerprint.checks, diffText);
+    const materialNodes = resolution.materialNodes.map((matched) => materialNodeFromMatch(fingerprint, matched));
+    const guardNodes = resolution.guardNodes.map((matched) => materialNodeFromMatch(fingerprint, matched));
+    const checks = await Promise.all(resolution.offeredChecks.map(async (offered) => {
+        const check = fingerprint.checks.get(offered.id);
+        const probeCommand = check?.doc.frontmatter.probe;
+        const probe = options.runProbes !== false && probeCommand !== undefined
+            ? await runProbe(probeCommand, {
+                cwd: options.cwd ?? process.cwd(),
+                timeoutMs: options.probeTimeoutMs,
+            })
+            : undefined;
+        return {
+            id: offered.id,
+            severity: offered.severity,
+            offered: offered.offered,
+            via: offered.via,
+            prose: check?.doc.body.trim() ?? "",
+            baseline: check?.references
+                .map((ref) => resolveBaseline(ref, fingerprint.catalog))
+                .filter((ref) => ref !== null) ?? [],
+            ...(probe ? { probe } : {}),
+        };
+    }));
+    return {
+        fingerprintId: fingerprint.manifest.id,
+        touchedFiles: resolution.touchedFiles.map((file) => file.path),
+        materialNodes,
+        guardNodes,
+        checks,
+        gaps: resolution.gaps,
+        diff: diffText,
+    };
+}
+function materialNodeFromMatch(fingerprint, matched) {
+    const node = fingerprint.catalog.nodes.get(matched.id);
+    return {
+        id: node.id,
+        ...(node.kind !== undefined ? { kind: node.kind } : {}),
+        ...(node.description !== undefined
+            ? { description: node.description }
+            : {}),
+        prose: node.body,
+        materials: node.materials ?? [],
+        matchedMaterials: matched.locators,
+        files: matched.files,
+    };
+}
+export function formatReviewPacket(packet) {
+    const out = [];
+    out.push(`# Ghost review — fingerprint \`${packet.fingerprintId}\``, "");
+    out.push("You are reviewing a diff against a Ghost fingerprint. The command has", "assembled the touched files, matched material-backed nodes, offered", "checks, and optional probe evidence. Probes are repo-owned shell commands", "with the same trust class as npm scripts; git review is the boundary.", "Weigh which checks apply. Do not invent obligations that are not grounded", "in the fingerprint prose or check text.", "");
+    if (packet.touchedFiles.length > 0) {
+        out.push("## Touched files");
+        for (const file of packet.touchedFiles)
+            out.push(`- \`${file}\``);
+        out.push("");
+    }
+    if (packet.materialNodes.length > 0) {
+        out.push("## Matched material-backed nodes");
+        for (const node of packet.materialNodes) {
+            const kind = node.kind ? ` _(${node.kind})_` : "";
+            out.push(`### \`${node.id}\`${kind}`);
+            if (node.description)
+                out.push(`_${node.description}_`, "");
+            out.push(node.prose, "");
+            out.push("Matched materials:");
+            for (const locator of node.matchedMaterials)
+                out.push(`- \`${locator}\``);
+            out.push("Files:");
+            for (const file of node.files)
+                out.push(`- \`${file}\``);
+            out.push("");
+        }
+    }
+    if (packet.guardNodes.length > 0) {
+        out.push("## Matched guard nodes — review-critical");
+        for (const node of packet.guardNodes) {
+            const kind = node.kind ? ` _(${node.kind})_` : "";
+            out.push(`### \`${node.id}\`${kind}`);
+            if (node.description)
+                out.push(`_${node.description}_`, "");
+            out.push(node.prose, "");
+            out.push("Matched materials:");
+            for (const locator of node.matchedMaterials)
+                out.push(`- \`${locator}\``);
+            out.push("Files:");
+            for (const file of node.files)
+                out.push(`- \`${file}\``);
+            out.push("");
+        }
+    }
+    out.push("## Offered checks — weigh which apply");
+    if (packet.checks.length === 0) {
+        out.push("_No checks were offered for this diff._", "");
+    }
+    else {
+        for (const check of packet.checks) {
+            out.push(`### checks/${check.id}${check.severity ? ` · ${check.severity}` : ""}`);
+            const refs = check.via.map((ref) => `\`${ref}\``).join(", ");
+            out.push(check.offered === "matched"
+                ? `Offered via material match: ${refs}`
+                : `Always offered — no referenced material-backed node gates it: ${refs}`, "");
+            if (check.baseline.length > 0) {
+                out.push("Baseline prose:");
+                for (const baseline of check.baseline) {
+                    out.push(`- ${baseline.ref}`);
+                    if (baseline.warning)
+                        out.push(`  - ⚠ ${baseline.warning}`);
+                }
+                out.push("");
+            }
+            if (check.probe) {
+                out.push("Probe evidence (shell run by Ghost; evidence only, not a pass/fail verdict):", `- command: \`${check.probe.command}\``, `- exit code: ${check.probe.exitCode ?? "unknown"}${check.probe.timedOut ? " (timed out)" : ""}`, "- stdout:", "```", check.probe.stdout.trimEnd(), "```", "- stderr:", "```", check.probe.stderr.trimEnd(), "```", "");
+            }
+            out.push(check.prose, "");
+        }
+    }
+    if (packet.gaps.length > 0) {
+        out.push("## Coverage gaps — report, do not grade");
+        for (const gap of packet.gaps) {
+            out.push(`- **${gap.kind}**: ${gap.detail}`);
+            for (const file of gap.files ?? [])
+                out.push(`  - \`${file}\``);
+            for (const node of gap.nodes ?? [])
+                out.push(`  - \`${node}\``);
+        }
+        out.push("");
+    }
+    out.push("## Diff", "```diff", packet.diff.trimEnd(), "```", "");
+    out.push("## Produce findings");
+    out.push("For each applicable check, emit findings with severity, location, baseline,", "observable, and smallest coherent fix. If nothing drifts, say so plainly.");
+    return `${out.join("\n")}\n`;
+}
+//# sourceMappingURL=review-packet.js.map

package/dist/review/review-packet.js.map

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

package/dist/scan/check-files.d.ts

@@ -0,0 +1,23 @@
+import { type GhostCheckDocument } from "#ghost-core";
+/** Reserved package-root directory holding review checks. */
+export declare const GHOST_CHECKS_DIR = "checks";
+export interface LoadedCheck {
+    id: string;
+    doc: GhostCheckDocument;
+    references: string[];
+}
+export interface LoadedCheckFiles {
+    /** Whether `.ghost/checks/` exists (even if empty). */
+    hasChecksDir: boolean;
+    checks: Map<string, LoadedCheck>;
+    invalid: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/**
+ * Load the optional flat `.ghost/checks/` directory. Checks are feed-back
+ * only: nothing loaded here is ever served by `gather` or `pull`.
+ */
+export declare function loadCheckFiles(packageDir: string): Promise<LoadedCheckFiles>;
+//# sourceMappingURL=check-files.d.ts.map

package/dist/scan/check-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-files.d.ts","sourceRoot":"","sources":["../../src/scan/check-files.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,aAAa,CAAC;AAErB,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAOzC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,kBAAkB,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CA4D3B"}

package/dist/scan/check-files.js

@@ -0,0 +1,90 @@
+import { readdir, readFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { lintGhostCheck, loadGhostCheck, parseCheckMarkdown, } from "#ghost-core";
+/** Reserved package-root directory holding review checks. */
+export const GHOST_CHECKS_DIR = "checks";
+/** Pre-flat location for checks; detected only to warn on stale packages. */
+const LEGACY_HAUNTS_DIR = "haunts";
+const CHECK_ID_PATTERN = /^[a-z0-9][a-z0-9._-]*$/;
+/**
+ * Load the optional flat `.ghost/checks/` directory. Checks are feed-back
+ * only: nothing loaded here is ever served by `gather` or `pull`.
+ */
+export async function loadCheckFiles(packageDir) {
+    const checks = new Map();
+    const invalid = [];
+    await detectLegacyHauntsDir(packageDir, invalid);
+    const checksDir = join(packageDir, GHOST_CHECKS_DIR);
+    let entries;
+    try {
+        entries = await readdir(checksDir, { withFileTypes: true });
+    }
+    catch {
+        return { hasChecksDir: false, checks, invalid };
+    }
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (entry.name.startsWith("."))
+            continue;
+        if (entry.isDirectory()) {
+            invalid.push({
+                file: `checks/${entry.name}`,
+                message: "checks/ is flat; nested directories are not allowed",
+            });
+            continue;
+        }
+        if (!entry.name.endsWith(".md"))
+            continue;
+        const id = basename(entry.name, ".md");
+        if (!CHECK_ID_PATTERN.test(id)) {
+            invalid.push({
+                file: `checks/${entry.name}`,
+                message: "check id must be a single lowercase slug (a-z, 0-9, '.', '_', '-')",
+            });
+            continue;
+        }
+        const raw = await readFile(join(checksDir, entry.name), "utf-8");
+        const lint = lintGhostCheck(raw);
+        if (lint.errors > 0) {
+            const first = lint.issues.find((issue) => issue.severity === "error");
+            invalid.push({
+                file: `checks/${entry.name}`,
+                message: first?.message ?? "invalid check",
+            });
+            continue;
+        }
+        const { frontmatter } = parseCheckMarkdown(raw);
+        const references = referencesFromFrontmatter(frontmatter);
+        if (references.length === 0) {
+            invalid.push({
+                file: `checks/${entry.name}`,
+                message: "check must declare at least one reference in `references`",
+            });
+            continue;
+        }
+        checks.set(id, { id, doc: loadGhostCheck(raw), references });
+    }
+    return { hasChecksDir: true, checks, invalid };
+}
+async function detectLegacyHauntsDir(packageDir, invalid) {
+    try {
+        await readdir(join(packageDir, LEGACY_HAUNTS_DIR));
+    }
+    catch {
+        return;
+    }
+    invalid.push({
+        file: LEGACY_HAUNTS_DIR,
+        message: "the haunts/ directory is no longer supported; move haunts/checks/*.md to checks/ and delete haunts/",
+    });
+}
+function referencesFromFrontmatter(frontmatter) {
+    if (frontmatter === null)
+        return [];
+    if (Array.isArray(frontmatter.references)) {
+        return frontmatter.references.filter((reference) => typeof reference === "string");
+    }
+    // Deprecated compatibility for single-file linting; package checks should use
+    // `references`, but this keeps older check files loadable during local edits.
+    return typeof frontmatter.source === "string" ? [frontmatter.source] : [];
+}
+//# sourceMappingURL=check-files.js.map

package/dist/scan/check-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-files.js","sourceRoot":"","sources":["../../src/scan/check-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAEL,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,6DAA6D;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAEzC,6EAA6E;AAC7E,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAEnC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAelD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB;IAElB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,MAAM,OAAO,GAAgC,EAAE,CAAC;IAEhD,MAAM,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEjD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACrD,IAAI,OAAwD,CAAC;IAC7D,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAClD,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACzE,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACzC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,UAAU,KAAK,CAAC,IAAI,EAAE;gBAC5B,OAAO,EAAE,qDAAqD;aAC/D,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAE1C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,UAAU,KAAK,CAAC,IAAI,EAAE;gBAC5B,OAAO,EACL,oEAAoE;aACvE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;YACtE,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,UAAU,KAAK,CAAC,IAAI,EAAE;gBAC5B,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,eAAe;aAC3C,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;QAC1D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,UAAU,KAAK,CAAC,IAAI,EAAE;gBAC5B,OAAO,EAAE,2DAA2D;aACrE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,UAAkB,EAClB,OAAoC;IAEpC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,OAAO,CAAC,IAAI,CAAC;QACX,IAAI,EAAE,iBAAiB;QACvB,OAAO,EACL,qGAAqG;KACxG,CAAC,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAChC,WAA2C;IAE3C,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,OAAO,WAAW,CAAC,UAAU,CAAC,MAAM,CAClC,CAAC,SAAS,EAAuB,EAAE,CAAC,OAAO,SAAS,KAAK,QAAQ,CAClE,CAAC;IACJ,CAAC;IACD,8EAA8E;IAC9E,8EAA8E;IAC9E,OAAO,OAAO,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC"}

package/dist/scan/check-scaffold.d.ts

@@ -0,0 +1,7 @@
+export interface AddChecksResult {
+    dir: string;
+    written: string[];
+}
+/** Scaffold the flat `.ghost/checks/` directory with an example check. */
+export declare function addChecksDir(packageDir: string): Promise<AddChecksResult>;
+//# sourceMappingURL=check-scaffold.d.ts.map

package/dist/scan/check-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-scaffold.d.ts","sourceRoot":"","sources":["../../src/scan/check-scaffold.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,0EAA0E;AAC1E,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAa1B"}

package/dist/scan/check-scaffold.js

@@ -0,0 +1,37 @@
+import { access, mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { UsageError } from "#ghost-core";
+import { GHOST_CHECKS_DIR } from "./check-files.js";
+const EXAMPLE_CHECK_FILENAME = "example.md.example";
+const EXAMPLE_CHECK_CONTENT = `---
+name: logo-clearspace-holds
+description: Logo usage preserves clearspace, lockup integrity, and glyph rules.
+severity: medium
+references:
+  - asset.logo
+---
+
+Grade whether the change preserves the logo guidance in \`asset.logo\`. Flag
+compressed clearspace, altered lockups, stretched marks, or cases where the glyph
+is used when the full lockup is required.
+`;
+/** Scaffold the flat `.ghost/checks/` directory with an example check. */
+export async function addChecksDir(packageDir) {
+    const checksDir = join(packageDir, GHOST_CHECKS_DIR);
+    if (await exists(checksDir)) {
+        throw new UsageError(`checks/ already exists at ${checksDir}.`);
+    }
+    await mkdir(checksDir, { recursive: true });
+    await writeFile(join(checksDir, EXAMPLE_CHECK_FILENAME), EXAMPLE_CHECK_CONTENT, "utf-8");
+    return { dir: checksDir, written: [EXAMPLE_CHECK_FILENAME] };
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=check-scaffold.js.map

package/dist/scan/check-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-scaffold.js","sourceRoot":"","sources":["../../src/scan/check-scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAEpD,MAAM,qBAAqB,GAAG;;;;;;;;;;;CAW7B,CAAC;AAOF,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAkB;IAElB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACrD,IAAI,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAAC,6BAA6B,SAAS,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,CACb,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,EACvC,qBAAqB,EACrB,OAAO,CACR,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,sBAAsB,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/scan/constants.d.ts

@@ -0,0 +1,21 @@
+/** Canonical directory for the Ghost fingerprint package. */
+export declare const FINGERPRINT_PACKAGE_DIR = ".ghost";
+/** Portable fingerprint package manifest filename. */
+export declare const FINGERPRINT_MANIFEST_FILENAME = "manifest.yml";
+/** Reserved package-root glossary filename. */
+export declare const GHOST_GLOSSARY_FILENAME = "glossary.md";
+/** Reserved package-root directory for bundled materials. */
+export declare const GHOST_MATERIALS_DIR = "materials";
+/** Append-only events tape for gather/pull events. */
+export declare const GHOST_EVENTS_FILENAME = ".events";
+/** Legacy pull events tape, retained for compatibility only. */
+export declare const LEGACY_PULL_HISTORY_FILENAME = ".pulls";
+/**
+ * Legacy facet filenames from the pre-flat-corpus package shape — retained
+ * only so path helpers can still name them when detecting legacy packages.
+ * There is no automated migration; legacy packages are re-authored by hand.
+ */
+export declare const FINGERPRINT_INTENT_FILENAME = "intent.yml";
+export declare const FINGERPRINT_INVENTORY_FILENAME = "inventory.yml";
+export declare const FINGERPRINT_COMPOSITION_FILENAME = "composition.yml";
+//# sourceMappingURL=constants.d.ts.map

package/dist/scan/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/scan/constants.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAEhD,sDAAsD;AACtD,eAAO,MAAM,6BAA6B,iBAAiB,CAAC;AAE5D,+CAA+C;AAC/C,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AAErD,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAE/C,sDAAsD;AACtD,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C,gEAAgE;AAChE,eAAO,MAAM,4BAA4B,WAAW,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,eAAe,CAAC;AACxD,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAC9D,eAAO,MAAM,gCAAgC,oBAAoB,CAAC"}

package/dist/scan/constants.js

@@ -0,0 +1,21 @@
+/** Canonical directory for the Ghost fingerprint package. */
+export const FINGERPRINT_PACKAGE_DIR = ".ghost";
+/** Portable fingerprint package manifest filename. */
+export const FINGERPRINT_MANIFEST_FILENAME = "manifest.yml";
+/** Reserved package-root glossary filename. */
+export const GHOST_GLOSSARY_FILENAME = "glossary.md";
+/** Reserved package-root directory for bundled materials. */
+export const GHOST_MATERIALS_DIR = "materials";
+/** Append-only events tape for gather/pull events. */
+export const GHOST_EVENTS_FILENAME = ".events";
+/** Legacy pull events tape, retained for compatibility only. */
+export const LEGACY_PULL_HISTORY_FILENAME = ".pulls";
+/**
+ * Legacy facet filenames from the pre-flat-corpus package shape — retained
+ * only so path helpers can still name them when detecting legacy packages.
+ * There is no automated migration; legacy packages are re-authored by hand.
+ */
+export const FINGERPRINT_INTENT_FILENAME = "intent.yml";
+export const FINGERPRINT_INVENTORY_FILENAME = "inventory.yml";
+export const FINGERPRINT_COMPOSITION_FILENAME = "composition.yml";
+//# sourceMappingURL=constants.js.map

package/dist/scan/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/scan/constants.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAC;AAEhD,sDAAsD;AACtD,MAAM,CAAC,MAAM,6BAA6B,GAAG,cAAc,CAAC;AAE5D,+CAA+C;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAErD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAE/C,sDAAsD;AACtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAC;AAE/C,gEAAgE;AAChE,MAAM,CAAC,MAAM,4BAA4B,GAAG,QAAQ,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,YAAY,CAAC;AACxD,MAAM,CAAC,MAAM,8BAA8B,GAAG,eAAe,CAAC;AAC9D,MAAM,CAAC,MAAM,gCAAgC,GAAG,iBAAiB,CAAC"}

package/dist/scan/file-kind.d.ts

@@ -0,0 +1,12 @@
+import type { LintReport } from "./lint.js";
+export type DetectedFileKind = "fingerprint-manifest" | "check" | "material" | "node" | "unsupported";
+/**
+ * Decide whether a file is a bundle artifact. The manifest routes to its
+ * artifact linter; files under a root `materials/` directory are material
+ * files; markdown under a `checks/` directory is a check; any other markdown
+ * is a node (its path is its id). Unknown files remain unsupported
+ * instead of being guessed at.
+ */
+export declare function detectFileKind(path: string, raw: string): DetectedFileKind;
+export declare function lintDetectedFileKind(kind: DetectedFileKind, raw: string): LintReport;
+//# sourceMappingURL=file-kind.d.ts.map

package/dist/scan/file-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-kind.d.ts","sourceRoot":"","sources":["../../src/scan/file-kind.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GACxB,sBAAsB,GACtB,OAAO,GACP,UAAU,GACV,MAAM,GACN,aAAa,CAAC;AAElB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAyB1E;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,gBAAgB,EACtB,GAAG,EAAE,MAAM,GACV,UAAU,CAUZ"}