@design-intelligence/ghost 0.0.0-next-20260715121453

package/dist/scan/fingerprint-package-lint.js

@@ -0,0 +1,284 @@
+import { readFile } from "node:fs/promises";
+import { relative, resolve } from "node:path";
+import { classifyMaterialLocator, closestIds, expandLocalMaterialLocator, extractSkeletonSections, listBundledMaterialFiles, materialLocatorClaimsPath, parseGlossary, parseSourceRef, sliceNodeSection, } from "#ghost-core";
+import { isMissingPathError } from "../internal/fs.js";
+import { GHOST_GLOSSARY_FILENAME, GHOST_MATERIALS_DIR } from "./constants.js";
+import { resolveFingerprintPackage, } from "./fingerprint-package.js";
+import { lintFingerprintPackageManifest, loadFingerprintPackage, } from "./fingerprint-package-loader.js";
+import { resolveGitRoot } from "./package-paths.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 async function lintFingerprintPackage(dirArg, cwd = process.cwd()) {
+    const paths = resolveFingerprintPackage(dirArg, cwd);
+    const issues = [];
+    const manifestRaw = await readRequired(paths.manifest, "manifest.yml", issues);
+    if (manifestRaw !== undefined) {
+        // shape pass: manifest well-formed.
+        const beforeManifestErrors = issues.filter((issue) => issue.severity === "error").length;
+        lintFingerprintPackageManifest(manifestRaw, issues);
+        const manifestHasErrors = issues.filter((issue) => issue.severity === "error").length >
+            beforeManifestErrors;
+        if (manifestHasErrors)
+            return finalize(issues);
+        // catalog pass: load + validate the node catalog.
+        try {
+            const { manifest, catalog, checks, invalid, invalidChecks } = await loadFingerprintPackage(paths);
+            // node pass: a node that failed its own schema was skipped while loading
+            // the catalog; surface it here so a malformed node is loud, not silent.
+            issues.push(...invalid.map((entry) => ({
+                severity: "error",
+                rule: "node-invalid",
+                message: entry.message,
+                path: entry.file,
+            })));
+            issues.push(...invalidChecks.map((entry) => ({
+                severity: "error",
+                rule: "check-invalid",
+                message: entry.message,
+                path: entry.file,
+            })));
+            await lintGlossary(paths.glossary, issues);
+            lintCover(manifest.cover, catalog, issues);
+            await lintKindPrefixes(paths, catalog, issues);
+            lintNodeDescriptions(catalog, issues);
+            lintSkeletonSections(catalog, issues);
+            await lintMaterialLocators(paths, catalog, issues, cwd);
+            lintCheckReferences(catalog, checks, issues);
+        }
+        catch (err) {
+            issues.push({
+                severity: "error",
+                rule: "package-catalog-invalid",
+                message: err instanceof Error ? err.message : String(err),
+                path: ".ghost",
+            });
+        }
+    }
+    return finalize(issues);
+}
+async function lintGlossary(glossaryPath, issues) {
+    let raw;
+    try {
+        raw = await readFile(glossaryPath, "utf-8");
+    }
+    catch (err) {
+        if (isMissingPathError(err))
+            return;
+        throw err;
+    }
+    const result = parseGlossary(raw);
+    if (result.glossary !== null)
+        return;
+    issues.push(...result.errors.map((message) => ({
+        severity: "error",
+        rule: "glossary-invalid",
+        message,
+        path: GHOST_GLOSSARY_FILENAME,
+    })));
+}
+function lintCover(coverId, catalog, issues) {
+    if (coverId === undefined) {
+        issues.push({
+            severity: "warning",
+            rule: "cover-undeclared",
+            message: 'no cover declared in manifest.yml — fingerprints steer better with one node guaranteed in context; add "cover: <node-id>"',
+            path: "manifest.yml.cover",
+        });
+        return;
+    }
+    const cover = catalog.nodes.get(coverId);
+    if (cover === undefined) {
+        issues.push({
+            severity: "error",
+            rule: "cover-missing",
+            message: `manifest cover "${coverId}" does not match any node`,
+            path: "manifest.yml.cover",
+        });
+        return;
+    }
+    const bytes = Buffer.byteLength(cover.body, "utf-8");
+    if (bytes > 1500) {
+        issues.push({
+            severity: "warning",
+            rule: "cover-oversized",
+            message: `cover node "${coverId}" body is ${bytes} bytes — the cover is a one-screen budget; element-scoped rules belong in foundation chapters`,
+            path: `${coverId}.md`,
+        });
+    }
+}
+async function lintKindPrefixes(paths, catalog, issues) {
+    const declaredKinds = await readDeclaredGlossaryKinds(paths.glossary);
+    if (declaredKinds === undefined)
+        return;
+    const declared = new Set(declaredKinds);
+    for (const node of catalog.nodes.values()) {
+        if (node.kind === undefined || declared.has(node.kind))
+            continue;
+        const suggestions = closestIds(node.kind, declaredKinds, 1);
+        const suggestion = suggestions[0];
+        issues.push({
+            severity: "warning",
+            rule: "kind-undeclared",
+            message: `Kind prefix \`${node.kind}\` is not declared in ${GHOST_GLOSSARY_FILENAME}.` +
+                (suggestion === undefined
+                    ? " Drop the prefix if this node has no kind."
+                    : ` Did you mean \`${suggestion}\`? Drop the prefix if this node has no kind.`),
+            path: `${node.id}.md`,
+        });
+    }
+}
+/**
+ * The `description` is a node's entire retrieval payload: `gather` lists it as
+ * the text the agent selects against. A node without one renders as a bare id
+ * and cannot show when it applies, so `validate` makes that loud. Warning,
+ * not error: an undescribed node is legal, just undiscoverable.
+ */
+function lintNodeDescriptions(catalog, issues) {
+    for (const node of catalog.nodes.values()) {
+        if (node.description !== undefined && node.description.trim().length > 0) {
+            continue;
+        }
+        issues.push({
+            severity: "warning",
+            rule: "node-description-missing",
+            message: "node has no `description`, so `gather` lists it as a bare id without applicability context; add a one-line description of what this truth governs, when it applies, and what it contributes",
+            path: `${node.id}.md`,
+        });
+    }
+}
+function lintSkeletonSections(catalog, issues) {
+    for (const node of catalog.nodes.values()) {
+        const sections = extractSkeletonSections(node.body);
+        for (const section of sections) {
+            if (section.fences.length === 1)
+                continue;
+            issues.push({
+                severity: "warning",
+                rule: "skeleton-fence-count",
+                message: "## Skeleton section should contain exactly one fenced block; pull will emit all found skeleton fences",
+                path: `${node.id}.md`,
+            });
+        }
+    }
+}
+async function lintMaterialLocators(paths, catalog, issues, cwd) {
+    const repoRoot = await resolveGitRoot(cwd);
+    const options = {
+        repoRoot,
+        packageDir: paths.packageDir,
+        materialsDir: GHOST_MATERIALS_DIR,
+    };
+    const claimedLocators = [];
+    for (const node of catalog.nodes.values()) {
+        for (const locator of node.materials ?? []) {
+            if (classifyMaterialLocator(locator).kind === "url")
+                continue;
+            claimedLocators.push(locator);
+            const expanded = await expandLocalMaterialLocator(locator, options, {
+                cap: Number.POSITIVE_INFINITY,
+            });
+            if (expanded.matches.length > 0)
+                continue;
+            issues.push({
+                severity: "warning",
+                rule: "material-locator-dead",
+                message: `material locator '${locator}' matches no local files`,
+                path: `${node.id}.md.materials`,
+            });
+        }
+    }
+    const bundledFiles = await listBundledMaterialFiles(options);
+    for (const file of bundledFiles) {
+        const claimed = claimedLocators.some((locator) => materialLocatorClaimsPath(locator, file, options));
+        if (claimed)
+            continue;
+        issues.push({
+            severity: "warning",
+            rule: "material-orphaned",
+            message: "bundled material is not claimed by any node `materials` locator",
+            path: toPackageRelative(file, repoRoot, paths.packageDir),
+        });
+    }
+}
+function toPackageRelative(repoRelativePath, repoRoot, packageDir) {
+    const packageRelative = relative(packageDir, resolve(repoRoot, repoRelativePath))
+        .replace(/\\/g, "/")
+        .replace(/^\.\//, "");
+    return packageRelative.startsWith("../") ? repoRelativePath : packageRelative;
+}
+function lintCheckReferences(catalog, checks, issues) {
+    for (const check of checks.values()) {
+        for (const raw of check.references) {
+            const parsed = parseSourceRef(raw);
+            if (parsed === null) {
+                issues.push({
+                    severity: "error",
+                    rule: "check-reference-malformed",
+                    message: `check reference '${raw}' is not a node id with optional '> Heading' anchor`,
+                    path: `checks/${check.id}.md.references`,
+                });
+                continue;
+            }
+            const node = catalog.nodes.get(parsed.nodeId);
+            if (node === undefined) {
+                issues.push({
+                    severity: "warning",
+                    rule: "check-reference-unresolved",
+                    message: `check reference '${raw}' does not resolve to a fingerprint node — if you pruned this rule from the node, delete its paired flag in the check too`,
+                    path: `checks/${check.id}.md.references`,
+                });
+                continue;
+            }
+            if (parsed.heading !== undefined &&
+                sliceNodeSection(node.body, parsed.heading) === null) {
+                issues.push({
+                    severity: "warning",
+                    rule: "check-reference-heading-missing",
+                    message: `check reference '${raw}' names a heading that was not found — if you pruned this rule from the node, delete its paired flag in the check too`,
+                    path: `checks/${check.id}.md.references`,
+                });
+            }
+        }
+    }
+}
+async function readDeclaredGlossaryKinds(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 [];
+    return result.glossary.frontmatter.kinds.map((kind) => kind.name);
+}
+async function readRequired(path, label, issues) {
+    try {
+        return await readFile(path, "utf-8");
+    }
+    catch {
+        issues.push({
+            severity: "error",
+            rule: "package-artifact-missing",
+            message: `Fingerprint package is missing ${label}.`,
+            path: label,
+        });
+        return undefined;
+    }
+}
+function finalize(issues) {
+    return {
+        issues,
+        errors: issues.filter((issue) => issue.severity === "error").length,
+        warnings: issues.filter((issue) => issue.severity === "warning").length,
+        info: issues.filter((issue) => issue.severity === "info").length,
+    };
+}
+//# sourceMappingURL=fingerprint-package-lint.js.map

package/dist/scan/fingerprint-package-lint.js.map

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

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

@@ -0,0 +1,5 @@
+import type { FingerprintPackagePaths, LoadedFingerprintPackage } from "./fingerprint-package.js";
+import type { LintIssue } from "./lint.js";
+export declare function loadFingerprintPackage(paths: FingerprintPackagePaths): Promise<LoadedFingerprintPackage>;
+export declare function lintFingerprintPackageManifest(raw: string, issues: LintIssue[]): void;
+//# sourceMappingURL=fingerprint-package-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-package-loader.d.ts","sourceRoot":"","sources":["../../src/scan/fingerprint-package-loader.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CA8BnC;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EAAE,GAClB,IAAI,CAkBN"}

package/dist/scan/fingerprint-package-loader.js

@@ -0,0 +1,78 @@
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+import { assembleCatalog, GhostFingerprintPackageManifestSchema, UsageError, } from "#ghost-core";
+import { isMissingPathError } from "../internal/fs.js";
+import { loadCheckFiles } from "./check-files.js";
+import { loadNodeFiles } from "./node-files.js";
+export async function loadFingerprintPackage(paths) {
+    let manifestRaw;
+    try {
+        manifestRaw = await readFile(paths.manifest, "utf-8");
+    }
+    catch (err) {
+        // A missing package is a usage error (run `ghost init`), not a crash.
+        if (isMissingPathError(err)) {
+            throw new UsageError(`No Ghost fingerprint package found at ${paths.packageDir} (expected manifest.yml). Run \`ghost init\` or pass --package <dir>.`);
+        }
+        throw err;
+    }
+    const manifest = parseManifest(manifestRaw, "manifest.yml");
+    // The catalog is flat and valid by construction — no edges to resolve.
+    // Per-node schema failures are collected as `invalid`.
+    const { nodes: placedNodes, invalid } = await loadNodeFiles(paths.packageDir);
+    const checkFiles = await loadCheckFiles(paths.packageDir);
+    const catalog = assembleCatalog({ placedNodes });
+    return {
+        manifest,
+        manifestRaw,
+        catalog,
+        hasChecksDir: checkFiles.hasChecksDir,
+        checks: checkFiles.checks,
+        invalid,
+        invalidChecks: checkFiles.invalid,
+    };
+}
+export function lintFingerprintPackageManifest(raw, issues) {
+    const manifest = parseYamlSafe(raw, "manifest.yml", issues);
+    if (manifest === undefined)
+        return;
+    const manifestResult = GhostFingerprintPackageManifestSchema.safeParse(manifest);
+    if (!manifestResult.success) {
+        issues.push(...manifestResult.error.issues.map((issue) => ({
+            severity: "error",
+            rule: `schema/${issue.code}`,
+            message: issue.message,
+            path: issue.path.length
+                ? `manifest.yml.${issue.path.join(".")}`
+                : "manifest.yml",
+        })));
+        return;
+    }
+}
+function parseManifest(raw, label) {
+    const parsed = parseYamlStrict(raw, label);
+    return GhostFingerprintPackageManifestSchema.parse(parsed);
+}
+function parseYamlStrict(raw, label) {
+    try {
+        return parseYaml(raw);
+    }
+    catch (err) {
+        throw new Error(`${label} is not valid YAML: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function parseYamlSafe(raw, label, issues) {
+    try {
+        return parseYaml(raw);
+    }
+    catch (err) {
+        issues.push({
+            severity: "error",
+            rule: "package-yaml-invalid",
+            message: `${label} is not valid YAML: ${err instanceof Error ? err.message : String(err)}`,
+            path: label,
+        });
+        return undefined;
+    }
+}
+//# sourceMappingURL=fingerprint-package-loader.js.map

package/dist/scan/fingerprint-package-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-package-loader.js","sourceRoot":"","sources":["../../src/scan/fingerprint-package-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EACL,eAAe,EAEf,qCAAqC,EACrC,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA8B;IAE9B,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,sEAAsE;QACtE,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,UAAU,CAClB,yCAAyC,KAAK,CAAC,UAAU,uEAAuE,CACjI,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAE5D,uEAAuE;IACvE,uDAAuD;IACvD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAEjD,OAAO;QACL,QAAQ;QACR,WAAW;QACX,OAAO;QACP,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,OAAO;QACP,aAAa,EAAE,UAAU,CAAC,OAAO;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,GAAW,EACX,MAAmB;IAEnB,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAC5D,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,MAAM,cAAc,GAClB,qCAAqC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5D,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CACT,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7C,QAAQ,EAAE,OAAgB;YAC1B,IAAI,EAAE,UAAU,KAAK,CAAC,IAAI,EAAE;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;gBACrB,CAAC,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;gBACxC,CAAC,CAAC,cAAc;SACnB,CAAC,CAAC,CACJ,CAAC;QACF,OAAO;IACT,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,GAAW,EACX,KAAa;IAEb,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,qCAAqC,CAAC,KAAK,CAChD,MAAM,CAC4B,CAAC;AACvC,CAAC;AAED,SAAS,eAAe,CAAC,GAAW,EAAE,KAAa;IACjD,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,uBACN,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,GAAW,EACX,KAAa,EACb,MAAmB;IAEnB,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,GAAG,KAAK,uBACf,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE;YACF,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,66 @@
+import { type GhostCatalog, type GhostFingerprintPackageManifest } from "#ghost-core";
+import type { LoadedCheck } from "./check-files.js";
+import { loadFingerprintPackage } from "./fingerprint-package-loader.js";
+export { lintFingerprintPackage } from "./fingerprint-package-lint.js";
+export { loadFingerprintPackage };
+export interface FingerprintPackagePaths {
+    dir: string;
+    packageDir: string;
+    manifest: string;
+    glossary: string;
+    /** Legacy facet paths — used only to detect pre-flat-corpus packages. */
+    intent: string;
+    inventory: string;
+    composition: string;
+}
+export interface LoadedFingerprintPackage {
+    manifest: GhostFingerprintPackageManifest;
+    manifestRaw: string;
+    /** The in-memory flat node catalog — the only fingerprint model. */
+    catalog: GhostCatalog;
+    /** Whether `.ghost/checks/` exists; `ghost review` requires it. */
+    hasChecksDir: boolean;
+    /** Checks from `.ghost/checks/`; never part of gather/pull. */
+    checks: Map<string, LoadedCheck>;
+    /**
+     * Nodes that failed per-node lint and were skipped while loading the catalog,
+     * each with its package-relative file path and first error message. Carried
+     * so `validate` can surface a malformed node instead of silently dropping it.
+     */
+    invalid: Array<{
+        file: string;
+        message: string;
+    }>;
+    /** Check files that failed lint/loading. */
+    invalidChecks: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+export interface InitFingerprintPackageOptions {
+    /** Init template name (default: "skeleton"). Mutually exclusive with `body`. */
+    template?: string;
+    /**
+     * Init body name (e.g. "vessel-light"): a full inhabited package with
+     * answered dials, materials, and its own checks. Mutually exclusive with
+     * `template`.
+     */
+    body?: string;
+    force?: boolean;
+}
+export interface InitFingerprintPackageResult {
+    paths: FingerprintPackagePaths;
+    /** Package-relative paths of the files the template wrote. */
+    written: string[];
+}
+/**
+ * Resolve the fingerprint package directory. `dirArg` (an explicit
+ * `--package <dir>`) always wins and is used exactly as given — it may be
+ * absolute or relative, unlike `GHOST_PACKAGE_DIR`. When `dirArg` is
+ * omitted, `GHOST_PACKAGE_DIR` is honored so every command — not just `init`
+ * and `validate` — respects a host-configured package location. Falls back
+ * to the default `.ghost` when neither is set.
+ */
+export declare function resolveFingerprintPackage(dirArg: string | undefined, cwd?: string): FingerprintPackagePaths;
+export declare function initFingerprintPackage(dirArg: string | undefined, cwd?: string, options?: InitFingerprintPackageOptions): Promise<InitFingerprintPackageResult>;
+//# sourceMappingURL=fingerprint-package.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-package.d.ts","sourceRoot":"","sources":["../../src/scan/fingerprint-package.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,+BAA+B,EAErC,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAazE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,OAAO,EAAE,YAAY,CAAC;IACtB,mEAAmE;IACnE,YAAY,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjC;;;;OAIG;IACH,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,4CAA4C;IAC5C,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,6BAA6B;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,uBAAuB,CAAC;IAC/B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,SAAgB,GAClB,uBAAuB,CAYzB;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,SAAgB,EACnB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,4BAA4B,CAAC,CAiDvC"}

package/dist/scan/fingerprint-package.js

@@ -0,0 +1,101 @@
+import { access, mkdir, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { UsageError, } from "#ghost-core";
+import { isExistingPathError, isMissingPathError } from "../internal/fs.js";
+import { FINGERPRINT_COMPOSITION_FILENAME, FINGERPRINT_INTENT_FILENAME, FINGERPRINT_INVENTORY_FILENAME, FINGERPRINT_MANIFEST_FILENAME, GHOST_GLOSSARY_FILENAME, } from "./constants.js";
+import { loadFingerprintPackage } from "./fingerprint-package-loader.js";
+import { resolveGhostDirDefault } from "./package-paths.js";
+import { DEFAULT_TEMPLATE_NAME, getInitBody, getInitTemplate, listInitBodies, listInitTemplates, } from "./templates.js";
+// The lint pass lives beside this module; re-export it so `validate` callers
+// keep a single import site for package loading and linting.
+export { lintFingerprintPackage } from "./fingerprint-package-lint.js";
+export { loadFingerprintPackage };
+/**
+ * Resolve the fingerprint package directory. `dirArg` (an explicit
+ * `--package <dir>`) always wins and is used exactly as given — it may be
+ * absolute or relative, unlike `GHOST_PACKAGE_DIR`. When `dirArg` is
+ * omitted, `GHOST_PACKAGE_DIR` is honored so every command — not just `init`
+ * and `validate` — respects a host-configured package location. Falls back
+ * to the default `.ghost` when neither is set.
+ */
+export function resolveFingerprintPackage(dirArg, cwd = process.cwd()) {
+    const dir = resolve(cwd, dirArg ?? resolveGhostDirDefault());
+    const packageDir = dir;
+    return {
+        dir,
+        packageDir,
+        manifest: join(packageDir, FINGERPRINT_MANIFEST_FILENAME),
+        glossary: join(packageDir, GHOST_GLOSSARY_FILENAME),
+        intent: join(packageDir, FINGERPRINT_INTENT_FILENAME),
+        inventory: join(packageDir, FINGERPRINT_INVENTORY_FILENAME),
+        composition: join(packageDir, FINGERPRINT_COMPOSITION_FILENAME),
+    };
+}
+export async function initFingerprintPackage(dirArg, cwd = process.cwd(), options = {}) {
+    if (options.body !== undefined && options.template !== undefined) {
+        throw new UsageError("--body and --template are mutually exclusive. A template is a shape of emptiness; a body is a full inhabited package — pick one.");
+    }
+    let source;
+    if (options.body !== undefined) {
+        const body = getInitBody(options.body);
+        if (!body) {
+            throw new UsageError(`Unknown init body '${options.body}'. Available: ${listInitBodies().join(", ")}.`);
+        }
+        source = body;
+    }
+    else {
+        const templateName = options.template ?? DEFAULT_TEMPLATE_NAME;
+        const template = getInitTemplate(templateName);
+        if (!template) {
+            throw new UsageError(`Unknown init template '${templateName}'. Available: ${listInitTemplates().join(", ")}.`);
+        }
+        source = template;
+    }
+    const paths = resolveFingerprintPackage(dirArg, cwd);
+    await mkdir(paths.packageDir, { recursive: true });
+    const files = (await source.files()).map((file) => ({
+        relativePath: file.relativePath,
+        path: join(paths.packageDir, file.relativePath),
+        content: file.content,
+    }));
+    if (!options.force) {
+        await assertInitDoesNotOverwrite(files.map((file) => file.path));
+    }
+    // Create any nested directories the template needs (e.g. nodes/).
+    const dirs = new Set(files.map((file) => dirname(file.path)));
+    await Promise.all([...dirs].map((dir) => mkdir(dir, { recursive: true })));
+    await Promise.all(files.map((file) => writeInitFile(file.path, file.content, options.force)));
+    return { paths, written: files.map((file) => file.relativePath) };
+}
+async function writeInitFile(path, content, force = false) {
+    try {
+        await writeFile(path, content, typeof content === "string"
+            ? { encoding: "utf-8", flag: force ? "w" : "wx" }
+            : { flag: force ? "w" : "wx" });
+    }
+    catch (err) {
+        if (!force && isExistingPathError(err)) {
+            throw new UsageError(`Refusing to overwrite existing Ghost fingerprint file:\n  ${path}\nPass --force to overwrite.`);
+        }
+        throw err;
+    }
+}
+async function assertInitDoesNotOverwrite(paths) {
+    const existing = [];
+    for (const path of paths) {
+        try {
+            await access(path);
+            existing.push(path);
+        }
+        catch (err) {
+            if (isMissingPathError(err))
+                continue;
+            throw err;
+        }
+    }
+    if (existing.length > 0) {
+        const formatted = existing.map((path) => `  ${path}`).join("\n");
+        throw new UsageError(`Refusing to overwrite existing Ghost fingerprint file(s):\n${formatted}\nPass --force to overwrite.`);
+    }
+}
+//# sourceMappingURL=fingerprint-package.js.map

package/dist/scan/fingerprint-package.js.map

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

package/dist/scan/index.d.ts

@@ -0,0 +1,3 @@
+export { FINGERPRINT_PACKAGE_DIR } from "./constants.js";
+export { GHOST_PACKAGE_DIR_ENV, normalizeGhostDir, resolveGhostDirDefault, resolveGitRoot, } from "./package-paths.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,GACf,MAAM,oBAAoB,CAAC"}

package/dist/scan/index.js

@@ -0,0 +1,3 @@
+export { FINGERPRINT_PACKAGE_DIR } from "./constants.js";
+export { GHOST_PACKAGE_DIR_ENV, normalizeGhostDir, resolveGhostDirDefault, resolveGitRoot, } from "./package-paths.js";
+//# sourceMappingURL=index.js.map

package/dist/scan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,GACf,MAAM,oBAAoB,CAAC"}

package/dist/scan/lint.d.ts

@@ -0,0 +1,15 @@
+export type LintSeverity = "error" | "warning" | "info";
+export interface LintIssue {
+    severity: LintSeverity;
+    rule: string;
+    message: string;
+    /** Dotted path in the file (e.g. "intent.principles[0].evidence"). */
+    path?: string;
+}
+export interface LintReport {
+    issues: LintIssue[];
+    errors: number;
+    warnings: number;
+    info: number;
+}
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/scan/lint.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/scan/lint.js

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

package/dist/scan/lint.js.map

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

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

@@ -0,0 +1,25 @@
+import { type PlacedNode } from "#ghost-core";
+export interface LoadedNodeFiles {
+    nodes: PlacedNode[];
+    /** Files that failed lint, with their first error message (path-relative id). */
+    invalid: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/**
+ * Load authored prose nodes from the package directory. The corpus is flat:
+ * there is no hierarchy, no inheritance, no edges. Nesting into directories is a
+ * browsing convenience only.
+ *
+ * Every `*.md` file under the package directory is a node. Its id is its path
+ * with `.md` dropped, uniformly (`marketing/email.md` → `marketing/email`,
+ * `index.md` → `index`). The reserved root entries — `manifest.yml`,
+ * `glossary.md`, `materials/`, and `checks/` — are skipped.
+ *
+ * A file that fails per-node lint is collected in `invalid` (with its first
+ * error) and skipped rather than throwing, so one bad node does not block
+ * loading the rest. A missing package directory or empty corpus yields no nodes.
+ */
+export declare function loadNodeFiles(packageDir: string): Promise<LoadedNodeFiles>;
+//# sourceMappingURL=node-files.d.ts.map