@design-intelligence/ghost 0.0.0-next-20260715121453

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":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE/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,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,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,CAmDvB;AAoBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA8F/D"}

package/dist/review/review-packet.js

@@ -0,0 +1,128 @@
+import { join } from "node:path";
+import { GHOST_MATERIALS_DIR } from "../scan/constants.js";
+import { resolveGitRoot } from "../scan/package-paths.js";
+import { resolveBaseline } from "./baseline.js";
+import { runProbe } from "./probes.js";
+import { resolveReview } from "./resolve.js";
+export async function buildReviewPacket(fingerprint, diffText, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const resolution = resolveReview(fingerprint.catalog, fingerprint.checks, diffText, {
+        repoRoot: await resolveGitRoot(cwd),
+        packageDir: options.packageDir ?? join(cwd, ".ghost"),
+        materialsDir: GHOST_MATERIALS_DIR,
+    });
+    const materialNodes = resolution.materialNodes.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,
+        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("");
+        }
+    }
+    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;AAIzC,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,CA0D3B"}

package/dist/scan/check-files.js

@@ -0,0 +1,75 @@
+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";
+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 = [];
+    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 };
+}
+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":"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"}

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

@@ -0,0 +1,8 @@
+export interface AddChecksResult {
+    dir: string;
+    written: string[];
+    skipped: 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":"AAsBA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,0EAA0E;AAC1E,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAiC1B"}

package/dist/scan/check-scaffold.js

@@ -0,0 +1,53 @@
+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";
+import { loadPayloadFile } from "./packed-payloads.js";
+const EXAMPLE_CHECK_FILENAME = "example.md.example";
+const MEDIAN_TELLS_FILENAME = "median-tells.md";
+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}.`);
+    }
+    const written = [];
+    const skipped = [];
+    await mkdir(checksDir, { recursive: true });
+    if (await exists(join(packageDir, "cliche.median.md"))) {
+        await writeFile(join(checksDir, MEDIAN_TELLS_FILENAME), await loadPayloadFile("median", MEDIAN_TELLS_FILENAME), "utf-8");
+        written.push(MEDIAN_TELLS_FILENAME);
+    }
+    else {
+        skipped.push(`${MEDIAN_TELLS_FILENAME} (no cliche.median node)`);
+    }
+    await writeFile(join(checksDir, EXAMPLE_CHECK_FILENAME), EXAMPLE_CHECK_CONTENT, "utf-8");
+    written.push(EXAMPLE_CHECK_FILENAME);
+    return {
+        dir: checksDir,
+        written,
+        skipped,
+    };
+}
+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;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AACpD,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAEhD,MAAM,qBAAqB,GAAG;;;;;;;;;;;CAW7B,CAAC;AAQF,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,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,SAAS,CACb,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,EACtC,MAAM,eAAe,CAAC,QAAQ,EAAE,qBAAqB,CAAC,EACtD,OAAO,CACR,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,GAAG,qBAAqB,0BAA0B,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,SAAS,CACb,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,EACvC,qBAAqB,EACrB,OAAO,CACR,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAErC,OAAO;QACL,GAAG,EAAE,SAAS;QACd,OAAO;QACP,OAAO;KACR,CAAC;AACJ,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"}

package/dist/scan/file-kind.js

@@ -0,0 +1,114 @@
+import { parse as parseYaml } from "yaml";
+import { GhostFingerprintPackageManifestSchema, lintGhostCheck, lintGhostNode, } from "#ghost-core";
+import { GHOST_MATERIALS_DIR } from "./constants.js";
+/**
+ * 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 function detectFileKind(path, raw) {
+    const lowerPath = path.toLowerCase();
+    const filename = lowerPath.split(/[\\/]/).pop() ?? lowerPath;
+    if (filename === "manifest.yml") {
+        return "fingerprint-manifest";
+    }
+    if (filename === "manifest.yaml") {
+        return "fingerprint-manifest";
+    }
+    if (new RegExp(`(^|[\\\\/])${GHOST_MATERIALS_DIR}[\\\\/]`).test(lowerPath)) {
+        return "material";
+    }
+    // A markdown check lives under a `checks/` directory. Detected by location
+    // so the established agent-check format (no `schema:` field) is recognized.
+    if (filename.endsWith(".md") && /(^|[\\/])checks[\\/]/.test(lowerPath)) {
+        return "check";
+    }
+    // Any other markdown file is a node (ghost.node/v1). Its id is its path.
+    if (filename.endsWith(".md")) {
+        return "node";
+    }
+    if (/^\s*schema:\s*ghost\.fingerprint-package\/v1\b/m.test(raw)) {
+        return "fingerprint-manifest";
+    }
+    return "unsupported";
+}
+export function lintDetectedFileKind(kind, raw) {
+    return kind === "fingerprint-manifest"
+        ? lintFingerprintManifestFile(raw)
+        : kind === "check"
+            ? lintGhostCheck(raw)
+            : kind === "material"
+                ? emptyLintReport()
+                : kind === "node"
+                    ? lintGhostNode(raw)
+                    : lintUnsupportedFile();
+}
+function emptyLintReport() {
+    return { issues: [], errors: 0, warnings: 0, info: 0 };
+}
+function lintFingerprintManifestFile(raw) {
+    try {
+        return zodLintReport(GhostFingerprintPackageManifestSchema.safeParse(parseYaml(raw)));
+    }
+    catch (err) {
+        return yamlErrorReport("fingerprint-manifest-not-yaml", "manifest.yml", err);
+    }
+}
+function zodLintReport(result) {
+    if (result.success) {
+        return { issues: [], errors: 0, warnings: 0, info: 0 };
+    }
+    const issues = result.error?.issues.map((issue) => ({
+        severity: "error",
+        rule: `schema/${issue.code}`,
+        message: issue.message,
+        path: formatZodPath(issue.path),
+    })) ?? [];
+    return {
+        issues,
+        errors: issues.length,
+        warnings: 0,
+        info: 0,
+    };
+}
+function lintUnsupportedFile() {
+    return {
+        issues: [
+            {
+                severity: "error",
+                rule: "unsupported-artifact",
+                message: "File is not a recognized Ghost artifact. Use manifest.yml, a checks/*.md check, or a *.md node.",
+            },
+        ],
+        errors: 1,
+        warnings: 0,
+        info: 0,
+    };
+}
+function yamlErrorReport(rule, label, err) {
+    return {
+        issues: [
+            {
+                severity: "error",
+                rule,
+                message: `${label} is not valid YAML: ${err instanceof Error ? err.message : String(err)}`,
+            },
+        ],
+        errors: 1,
+        warnings: 0,
+        info: 0,
+    };
+}
+function formatZodPath(path) {
+    if (path.length === 0)
+        return undefined;
+    return path.reduce((formatted, segment) => {
+        if (typeof segment === "number")
+            return `${formatted}[${segment}]`;
+        const key = String(segment);
+        return formatted ? `${formatted}.${key}` : key;
+    }, "");
+}
+//# sourceMappingURL=file-kind.js.map

package/dist/scan/file-kind.js.map

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

package/dist/scan/fingerprint-package-lint.d.ts

@@ -0,0 +1,8 @@
+import type { LintReport } from "./lint.js";
+/**
+ * `validate` for a package: artifact shape, per-node validity, and the
+ * deterministic kind-prefix lint enabled by glossary.md. The catalog is flat;
+ * loading collects malformed nodes so they can be surfaced as structured issues.
+ */
+export declare function lintFingerprintPackage(dirArg: string | undefined, cwd?: string): Promise<LintReport>;
+//# sourceMappingURL=fingerprint-package-lint.d.ts.map

package/dist/scan/fingerprint-package-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-package-lint.d.ts","sourceRoot":"","sources":["../../src/scan/fingerprint-package-lint.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,SAAgB,GAClB,OAAO,CAAC,UAAU,CAAC,CA4DrB"}