@design-intelligence/ghost 0.0.0-next-20260715121453

package/dist/ghost-core/materials.js

@@ -0,0 +1,52 @@
+const URL_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
+/**
+ * Classify a material locator. `https://…` locators point outside the repo;
+ * everything else is a repo-relative path/glob after validation.
+ */
+export function classifyMaterialLocator(value) {
+    return value.startsWith("https://")
+        ? { kind: "url", value }
+        : { kind: "local", value };
+}
+/** Return a human-readable validation error, or null when the locator is valid. */
+export function validateMaterialLocator(value) {
+    if (value.trim() !== value) {
+        return "material locator must not have leading or trailing whitespace";
+    }
+    if (value.length === 0) {
+        return "material locator must not be empty";
+    }
+    if (URL_SCHEME.test(value)) {
+        if (!value.startsWith("https://")) {
+            return "material URL locators must use https://";
+        }
+        try {
+            const url = new URL(value);
+            if (url.protocol !== "https:" || url.hostname.length === 0) {
+                return "material URL locators must be absolute https URLs";
+            }
+            return null;
+        }
+        catch {
+            return "material URL locator is not a valid URL";
+        }
+    }
+    if (value.startsWith("/") || value.startsWith("\\")) {
+        return "local material locators must be repo-relative, not absolute paths";
+    }
+    if (/^[a-zA-Z]:[\\/]/.test(value)) {
+        return "local material locators must be repo-relative, not absolute paths";
+    }
+    const normalized = value.replace(/\\/g, "/");
+    if (normalized === ".." ||
+        normalized.startsWith("../") ||
+        normalized.endsWith("/..") ||
+        normalized.includes("/../")) {
+        return "local material locators must not escape the repo with '..'";
+    }
+    if (normalized.startsWith("~/")) {
+        return "local material locators must be repo-relative, not home-relative paths";
+    }
+    return null;
+}
+//# sourceMappingURL=materials.js.map

package/dist/ghost-core/materials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materials.js","sourceRoot":"","sources":["../../src/ghost-core/materials.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAa;IAEb,OAAO,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;QACjC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE;QACxB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;QAC3B,OAAO,+DAA+D,CAAC;IACzE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,oCAAoC,CAAC;IAC9C,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,OAAO,yCAAyC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3D,OAAO,mDAAmD,CAAC;YAC7D,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,yCAAyC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,OAAO,mEAAmE,CAAC;IAC7E,CAAC;IACD,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,mEAAmE,CAAC;IAC7E,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7C,IACE,UAAU,KAAK,IAAI;QACnB,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC;QAC5B,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC1B,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC3B,CAAC;QACD,OAAO,4DAA4D,CAAC;IACtE,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,wEAAwE,CAAC;IAClF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/ghost-core/node/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Public surface for `ghost.node/v1` — the node artifact: markdown +
+ * frontmatter, the single unit a fingerprint corpus is made of: schema +
+ * types + parse + serialize.
+ */
+export { lintGhostNode, type ParseNodeResult, parseNode } from "./parse.js";
+export { GhostNodeFrontmatterSchema, NodeIdSchema, NodeRefSchema, } from "./schema.js";
+export { serializeNode } from "./serialize.js";
+export { carriesConcreteMaterial, extractSkeletonFences, extractSkeletonSections, type FencedBlock, hasSubstantialFencedExample, hasThreeLineFence, type SkeletonSection, stripSkeletonSections, } from "./steering.js";
+export { GHOST_NODE_SCHEMA, type GhostNodeDocument, type GhostNodeFrontmatter, type GhostNodeLintIssue, type GhostNodeLintReport, type GhostNodeLintSeverity, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ghost-core/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/node/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EACL,0BAA0B,EAC1B,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,WAAW,EAChB,2BAA2B,EAC3B,iBAAiB,EACjB,KAAK,eAAe,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Public surface for `ghost.node/v1` — the node artifact: markdown +
+ * frontmatter, the single unit a fingerprint corpus is made of: schema +
+ * types + parse + serialize.
+ */
+export { lintGhostNode, parseNode } from "./parse.js";
+export { GhostNodeFrontmatterSchema, NodeIdSchema, NodeRefSchema, } from "./schema.js";
+export { serializeNode } from "./serialize.js";
+export { carriesConcreteMaterial, extractSkeletonFences, extractSkeletonSections, hasSubstantialFencedExample, hasThreeLineFence, stripSkeletonSections, } from "./steering.js";
+export { GHOST_NODE_SCHEMA, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/ghost-core/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ghost-core/node/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAwB,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EACL,0BAA0B,EAC1B,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EAEvB,2BAA2B,EAC3B,iBAAiB,EAEjB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,GAMlB,MAAM,YAAY,CAAC"}

package/dist/ghost-core/node/parse.d.ts

@@ -0,0 +1,16 @@
+import type { GhostNodeDocument, GhostNodeLintReport } from "./types.js";
+export interface ParseNodeResult {
+    /** The validated node, or null when the artifact failed to parse/validate. */
+    node: GhostNodeDocument | null;
+    report: GhostNodeLintReport;
+}
+/**
+ * Parse and validate a single `ghost.node/v1` markdown artifact (frontmatter +
+ * prose body) in isolation. Per-node only: frontmatter shape, material
+ * locators, and a non-empty prose body. Corpus-level rules (glossary kind
+ * prefixes, check references) are a later phase.
+ */
+export declare function parseNode(raw: string): ParseNodeResult;
+/** Lint a node artifact, returning only the report (per-node validation). */
+export declare function lintGhostNode(raw: string): GhostNodeLintReport;
+//# sourceMappingURL=parse.d.ts.map

package/dist/ghost-core/node/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/node/parse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EAEjB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAWD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAuCtD;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAE9D"}

package/dist/ghost-core/node/parse.js

@@ -0,0 +1,55 @@
+import { splitMarkdownFrontmatter } from "../markdown.js";
+import { GhostNodeFrontmatterSchema } from "./schema.js";
+function finalize(issues) {
+    return {
+        issues,
+        errors: issues.filter((i) => i.severity === "error").length,
+        warnings: issues.filter((i) => i.severity === "warning").length,
+        info: issues.filter((i) => i.severity === "info").length,
+    };
+}
+/**
+ * Parse and validate a single `ghost.node/v1` markdown artifact (frontmatter +
+ * prose body) in isolation. Per-node only: frontmatter shape, material
+ * locators, and a non-empty prose body. Corpus-level rules (glossary kind
+ * prefixes, check references) are a later phase.
+ */
+export function parseNode(raw) {
+    const { frontmatter, body } = splitMarkdownFrontmatter(raw);
+    if (frontmatter === null) {
+        return {
+            node: null,
+            report: finalize([
+                {
+                    severity: "error",
+                    rule: "node-missing-frontmatter",
+                    message: "node must begin with a YAML frontmatter block (---\\n<yaml>\\n---)",
+                },
+            ]),
+        };
+    }
+    // The body is design-expression content; surrounding blank lines are not
+    // meaningful. Normalize them so serialize → parse round-trips are stable.
+    const normalizedBody = body.replace(/^\n+/, "").replace(/\s+$/, "");
+    const result = GhostNodeFrontmatterSchema.safeParse(frontmatter);
+    if (!result.success) {
+        return {
+            node: null,
+            report: finalize(result.error.issues.map((issue) => ({
+                severity: "error",
+                rule: `schema/${issue.code}`,
+                message: issue.message,
+                path: issue.path.length ? issue.path.join(".") : undefined,
+            }))),
+        };
+    }
+    return {
+        node: { frontmatter: result.data, body: normalizedBody },
+        report: finalize([]),
+    };
+}
+/** Lint a node artifact, returning only the report (per-node validation). */
+export function lintGhostNode(raw) {
+    return parseNode(raw).report;
+}
+//# sourceMappingURL=parse.js.map

package/dist/ghost-core/node/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/ghost-core/node/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAazD,SAAS,QAAQ,CAAC,MAA4B;IAC5C,OAAO;QACL,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;QAC3D,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM;QAC/D,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;KACzD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC5D,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,QAAQ,CAAC;gBACf;oBACE,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,0BAA0B;oBAChC,OAAO,EACL,oEAAoE;iBACvE;aACF,CAAC;SACH,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,0EAA0E;IAC1E,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,QAAQ,CACd,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAClC,QAAQ,EAAE,OAAgB;gBAC1B,IAAI,EAAE,UAAU,KAAK,CAAC,IAAI,EAAE;gBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3D,CAAC,CAAC,CACJ;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE;QACxD,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;KACrB,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;AAC/B,CAAC"}

package/dist/ghost-core/node/schema.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+declare const NodeIdSchema: z.ZodString;
+declare const NodeRefSchema: z.ZodString;
+/**
+ * Zod schema for a `ghost.node/v1` frontmatter block.
+ *
+ * Validates a node in isolation. Identity and containment are not here: they
+ * come from the node's file path. Kind is the filename prefix, never a
+ * frontmatter field.
+ */
+export declare const GhostNodeFrontmatterSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    materials: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    relates: z.ZodOptional<z.ZodNever>;
+}, z.core.$loose>;
+export { NodeIdSchema, NodeRefSchema };
+//# sourceMappingURL=schema.d.ts.map

package/dist/ghost-core/node/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/node/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,QAAA,MAAM,YAAY,aAGhB,CAAC;AAEH,QAAA,MAAM,aAAa,aAEjB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;iBAuBvB,CAAC;AAEjB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/ghost-core/node/schema.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { validateMaterialLocator } from "../materials.js";
+/**
+ * A node id is its path within the package, `.md` dropped (`marketing/email`).
+ * Directory nesting is only file organization; it does not create parents,
+ * ancestors, or semantic hierarchy. A segment is a permissive lowercase slug
+ * (alphanumeric plus `.` `_` `-`); segments join with `/`. No leading,
+ * trailing, or doubled slash. Ids are computed by the loader from the file
+ * path, never authored in frontmatter.
+ */
+const NODE_ID_PATTERN = /^[a-z0-9][a-z0-9._-]*(?:\/[a-z0-9][a-z0-9._-]*)*$/;
+const NodeIdSchema = z.string().min(1).regex(NODE_ID_PATTERN, {
+    message: "node id must be a path of lowercase slug segments joined by '/' (alphanumeric plus . _ -, no leading/trailing/doubled slash)",
+});
+const NodeRefSchema = z.string().min(1).regex(NODE_ID_PATTERN, {
+    message: "node ref must be a path id like 'marketing/email'",
+});
+/**
+ * Zod schema for a `ghost.node/v1` frontmatter block.
+ *
+ * Validates a node in isolation. Identity and containment are not here: they
+ * come from the node's file path. Kind is the filename prefix, never a
+ * frontmatter field.
+ */
+export const GhostNodeFrontmatterSchema = z
+    .object({
+    description: z.string().min(1).optional(),
+    materials: z
+        .array(z
+        .string()
+        .min(1)
+        .superRefine((locator, ctx) => {
+        const message = validateMaterialLocator(locator);
+        if (message !== null)
+            ctx.addIssue({ code: "custom", message });
+    }))
+        .optional(),
+    // `relates` (and all typed edges) were removed. Reject it with a message
+    // that names the key so authors get a clear signal.
+    relates: z
+        .never({ message: "`relates` is a removed key (edges no longer exist)" })
+        .optional(),
+})
+    // Passthrough, not strict: authors may add free-form descriptive keys
+    // (e.g. `audience`, `stage`) that describe what the node is. Ghost does not
+    // gate on them — they ride along as part of the node's descriptive surface.
+    .passthrough();
+export { NodeIdSchema, NodeRefSchema };
+//# sourceMappingURL=schema.js.map

package/dist/ghost-core/node/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/ghost-core/node/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,eAAe,GAAG,mDAAmD,CAAC;AAE5E,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,EAAE;IAC5D,OAAO,EACL,8HAA8H;CACjI,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,EAAE;IAC7D,OAAO,EAAE,mDAAmD;CAC7D,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,SAAS,EAAE,CAAC;SACT,KAAK,CACJ,CAAC;SACE,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,WAAW,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,IAAI;YAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CACL;SACA,QAAQ,EAAE;IACb,yEAAyE;IACzE,oDAAoD;IACpD,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;SACxE,QAAQ,EAAE;CACd,CAAC;IACF,sEAAsE;IACtE,4EAA4E;IAC5E,4EAA4E;KAC3E,WAAW,EAAE,CAAC;AAEjB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/ghost-core/node/serialize.d.ts

@@ -0,0 +1,12 @@
+import type { GhostNodeDocument, GhostNodeFrontmatter } from "./types.js";
+/**
+ * Serialize a node back to its `---\n<yaml>\n---\n<body>` markdown form. Known
+ * keys are emitted first in a stable order (description, materials), followed
+ * by any free-form descriptive keys in alphabetical order so round-trips and
+ * diffs are deterministic. Identity and kind are not serialized — they come
+ * from the node's file path and optional filename prefix. Undefined fields are
+ * omitted; a node with no frontmatter fields emits an empty block.
+ */
+export declare function serializeNode(node: GhostNodeDocument): string;
+export type { GhostNodeFrontmatter };
+//# sourceMappingURL=serialize.d.ts.map

package/dist/ghost-core/node/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/node/serialize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAQ1E;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CA0B7D;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/ghost-core/node/serialize.js

@@ -0,0 +1,39 @@
+import { stringify as stringifyYaml } from "yaml";
+const FRONTMATTER_KEY_ORDER = ["description", "materials"];
+function shouldSerializeFrontmatterValue(value) {
+    return value !== undefined;
+}
+/**
+ * Serialize a node back to its `---\n<yaml>\n---\n<body>` markdown form. Known
+ * keys are emitted first in a stable order (description, materials), followed
+ * by any free-form descriptive keys in alphabetical order so round-trips and
+ * diffs are deterministic. Identity and kind are not serialized — they come
+ * from the node's file path and optional filename prefix. Undefined fields are
+ * omitted; a node with no frontmatter fields emits an empty block.
+ */
+export function serializeNode(node) {
+    const fm = node.frontmatter;
+    const ordered = {};
+    const emitted = new Set();
+    for (const key of FRONTMATTER_KEY_ORDER) {
+        const value = fm[key];
+        if (shouldSerializeFrontmatterValue(value)) {
+            ordered[key] = value;
+            emitted.add(key);
+        }
+    }
+    for (const key of Object.keys(fm).sort()) {
+        if (emitted.has(key))
+            continue;
+        const value = fm[key];
+        if (shouldSerializeFrontmatterValue(value))
+            ordered[key] = value;
+    }
+    // An empty frontmatter object stringifies to "{}"; emit a bare block instead.
+    const yaml = Object.keys(ordered).length === 0
+        ? ""
+        : `${stringifyYaml(ordered).trimEnd()}\n`;
+    const body = node.body.replace(/^\n+/, "");
+    return `---\n${yaml}---\n${body.length ? `\n${body}\n` : "\n"}`;
+}
+//# sourceMappingURL=serialize.js.map

package/dist/ghost-core/node/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../../src/ghost-core/node/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAGlD,MAAM,qBAAqB,GAAG,CAAC,aAAa,EAAE,WAAW,CAAU,CAAC;AAEpE,SAAS,+BAA+B,CAAC,KAAc;IACrD,OAAO,KAAK,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,MAAM,EAAE,GAAG,IAAI,CAAC,WAAsC,CAAC;IACvD,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,MAAM,GAAG,IAAI,qBAAqB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,+BAA+B,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/B,MAAM,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,+BAA+B,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnE,CAAC;IAED,8EAA8E;IAC9E,MAAM,IAAI,GACR,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;QAC/B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,QAAQ,IAAI,QAAQ,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC"}

package/dist/ghost-core/node/steering.d.ts

@@ -0,0 +1,19 @@
+export interface FencedBlock {
+    fence: string;
+    info?: string;
+    content: string;
+}
+export interface SkeletonSection {
+    body: string;
+    fences: FencedBlock[];
+}
+export declare function carriesConcreteMaterial(input: {
+    materials?: string[];
+    body: string;
+}): boolean;
+export declare function hasSubstantialFencedExample(body: string): boolean;
+export declare function hasThreeLineFence(body: string): boolean;
+export declare function extractSkeletonSections(body: string): SkeletonSection[];
+export declare function extractSkeletonFences(body: string): FencedBlock[];
+export declare function stripSkeletonSections(body: string): string;
+//# sourceMappingURL=steering.d.ts.map

package/dist/ghost-core/node/steering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/node/steering.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAMV;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKvD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CASvE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAEjE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAc1D"}

package/dist/ghost-core/node/steering.js

@@ -0,0 +1,68 @@
+const FENCED_BLOCK_PATTERN = /(^|\n)(`{3,}|~{3,})[^\n]*\n([\s\S]*?)\n\2[ \t]*(?=\n|$)/g;
+const SKELETON_HEADING_PATTERN = /^##[ \t]+Skeleton[ \t]*$/gim;
+export function carriesConcreteMaterial(input) {
+    return ((input.materials?.length ?? 0) > 0 ||
+        hasSubstantialFencedExample(input.body) ||
+        extractSkeletonSections(input.body).length > 0);
+}
+export function hasSubstantialFencedExample(body) {
+    return hasThreeLineFence(stripSkeletonSections(body));
+}
+export function hasThreeLineFence(body) {
+    for (const block of extractFencedBlocks(body)) {
+        if (block.content.split(/\r?\n/).length >= 3)
+            return true;
+    }
+    return false;
+}
+export function extractSkeletonSections(body) {
+    const headings = [...body.matchAll(SKELETON_HEADING_PATTERN)];
+    return headings.map((heading, index) => {
+        const start = (heading.index ?? 0) + heading[0].length;
+        const next = headings[index + 1];
+        const end = next?.index ?? findNextHeading(body, start);
+        const sectionBody = body.slice(start, end).trim();
+        return { body: sectionBody, fences: extractFencedBlocks(sectionBody) };
+    });
+}
+export function extractSkeletonFences(body) {
+    return extractSkeletonSections(body).flatMap((section) => section.fences);
+}
+export function stripSkeletonSections(body) {
+    const headings = [...body.matchAll(SKELETON_HEADING_PATTERN)];
+    if (headings.length === 0)
+        return body;
+    let stripped = "";
+    let cursor = 0;
+    for (const heading of headings) {
+        const start = heading.index ?? 0;
+        const end = findNextHeading(body, start + heading[0].length);
+        stripped += body.slice(cursor, start);
+        cursor = end;
+    }
+    stripped += body.slice(cursor);
+    return stripped.replace(/\n{3,}/g, "\n\n").trim();
+}
+function extractFencedBlocks(body) {
+    const blocks = [];
+    for (const match of body.matchAll(FENCED_BLOCK_PATTERN)) {
+        const openingLine = body
+            .slice((match.index ?? 0) + (match[1]?.length ?? 0))
+            .split(/\r?\n/, 1)[0];
+        const open = /^(?<fence>`{3,}|~{3,})(?<info>.*)$/.exec(openingLine);
+        const fence = open?.groups?.fence ?? match[2] ?? "```";
+        const info = open?.groups?.info?.trim();
+        blocks.push({
+            fence,
+            ...(info ? { info } : {}),
+            content: match[3] ?? "",
+        });
+    }
+    return blocks;
+}
+function findNextHeading(body, start) {
+    const rest = body.slice(start);
+    const match = /^#{1,6}[ \t]+.+$/m.exec(rest);
+    return match?.index === undefined ? body.length : start + match.index;
+}
+//# sourceMappingURL=steering.js.map

package/dist/ghost-core/node/steering.js.map

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

package/dist/ghost-core/node/types.d.ts

@@ -0,0 +1,43 @@
+export declare const GHOST_NODE_SCHEMA: "ghost.node/v1";
+/**
+ * A node's frontmatter: descriptive properties only. Identity, kind, and
+ * containment are not here — the file path is the node id, and the optional
+ * filename prefix is the kind. The prose body carries the design expression;
+ * why / with-what / how-assembled are drafting prompts, never fields.
+ */
+export interface GhostNodeFrontmatter {
+    /** Free-form descriptive properties parsed from node frontmatter. */
+    [key: string]: unknown;
+    /**
+     * Retrieval payload shown by gather: what the node governs, the observable
+     * condition under which it applies, and what it contributes where useful.
+     * Together with the node's id, it is how an agent decides applicability.
+     * Optional, but strongly encouraged on any node worth anchoring a task at.
+     */
+    description?: string;
+    /**
+     * Optional locators for the concrete materials this truth is about: repo-relative
+     * paths/globs and absolute https URLs. Guidance stays in prose; this list is
+     * only where the agent or review harness can find the material.
+     */
+    materials?: string[];
+}
+export interface GhostNodeDocument {
+    frontmatter: GhostNodeFrontmatter;
+    /** The markdown body: prose design expression. */
+    body: string;
+}
+export type GhostNodeLintSeverity = "error" | "warning" | "info";
+export interface GhostNodeLintIssue {
+    severity: GhostNodeLintSeverity;
+    rule: string;
+    message: string;
+    path?: string;
+}
+export interface GhostNodeLintReport {
+    issues: GhostNodeLintIssue[];
+    errors: number;
+    warnings: number;
+    info: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ghost-core/node/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,EAAG,eAAwB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,oBAAoB,CAAC;IAClC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/ghost-core/node/types.js

@@ -0,0 +1,2 @@
+export const GHOST_NODE_SCHEMA = "ghost.node/v1";
+//# sourceMappingURL=types.js.map

package/dist/ghost-core/node/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/ghost-core/node/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAwB,CAAC"}

package/dist/ghost-core/package-manifest.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export declare const GHOST_FINGERPRINT_PACKAGE_SCHEMA: "ghost.fingerprint-package/v1";
+/** `manifest.yml` — anchors a `.ghost/` package. */
+export declare const GhostFingerprintPackageManifestSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"ghost.fingerprint-package/v1">;
+    id: z.ZodString;
+    cover: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export interface GhostFingerprintPackageManifest {
+    schema: typeof GHOST_FINGERPRINT_PACKAGE_SCHEMA;
+    id: string;
+    /**
+     * Optional id of the cover node: the one node gather inlines above the menu on
+     * every invocation. Guaranteed presence for content selection cannot retrieve
+     * — essence, temperature, brand-level refusals.
+     */
+    cover?: string;
+}
+//# sourceMappingURL=package-manifest.d.ts.map

package/dist/ghost-core/package-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manifest.d.ts","sourceRoot":"","sources":["../../src/ghost-core/package-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gCAAgC,EAC3C,8BAAuC,CAAC;AAe1C,oDAAoD;AACpD,eAAO,MAAM,qCAAqC;;;;kBAWvC,CAAC;AAEZ,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,OAAO,gCAAgC,CAAC;IAChD,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/ghost-core/package-manifest.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export const GHOST_FINGERPRINT_PACKAGE_SCHEMA = "ghost.fingerprint-package/v1";
+const SlugIdSchema = z
+    .string()
+    .min(1)
+    .regex(/^[a-z0-9][a-z0-9._-]*$/, "id must be a lowercase slug (a-z, 0-9, '.', '_', '-')");
+const NodeIdSchema = z
+    .string()
+    .min(1)
+    .regex(/^[a-z0-9][a-z0-9./_-]*$/, "cover must be a node id");
+/** `manifest.yml` — anchors a `.ghost/` package. */
+export const GhostFingerprintPackageManifestSchema = z
+    .object({
+    schema: z.literal(GHOST_FINGERPRINT_PACKAGE_SCHEMA),
+    id: SlugIdSchema,
+    /**
+     * Optional id of the cover node: the one node gather inlines above the menu
+     * on every invocation. Guaranteed presence for content selection cannot
+     * retrieve — essence, temperature, brand-level refusals.
+     */
+    cover: NodeIdSchema.optional(),
+})
+    .strict();
+//# sourceMappingURL=package-manifest.js.map

package/dist/ghost-core/package-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manifest.js","sourceRoot":"","sources":["../../src/ghost-core/package-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gCAAgC,GAC3C,8BAAuC,CAAC;AAE1C,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,KAAK,CACJ,wBAAwB,EACxB,uDAAuD,CACxD,CAAC;AAEJ,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,KAAK,CAAC,yBAAyB,EAAE,yBAAyB,CAAC,CAAC;AAE/D,oDAAoD;AACpD,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC;KACnD,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gCAAgC,CAAC;IACnD,EAAE,EAAE,YAAY;IAChB;;;;OAIG;IACH,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE;CAC/B,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/ghost-core/skill-bundle-loader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Generic loader for an agentskills.io-compatible skill bundle.
+ *
+ * Each tool in the Ghost monorepo (`ghost`, `ghost`, …) ships
+ * its own skill bundle as real markdown under `src/skill-bundle/` and copies
+ * it verbatim to `dist/skill-bundle/` at build time. This loader walks any
+ * given root directory and returns a flat, deterministically ordered list of
+ * files so the unified `ghost skill install` verb can write them into a target
+ * project.
+ *
+ * Spec: https://agentskills.io/specification
+ */
+export interface SkillBundleFile {
+    /** Path relative to the skill root (e.g. "SKILL.md", "references/schema.md"). */
+    path: string;
+    content: string;
+}
+/**
+ * Load a skill bundle from disk.
+ *
+ * `bundleRoot` should point to a directory containing at least a `SKILL.md`
+ * file at the top level (typically `dist/skill-bundle/` after the host
+ * package's build step has copied the markdown sources from `src/`).
+ *
+ * The returned list is sorted with `SKILL.md` first, then alphabetically.
+ */
+export declare function loadSkillBundle(bundleRoot: string): SkillBundleFile[];
+//# sourceMappingURL=skill-bundle-loader.d.ts.map

package/dist/ghost-core/skill-bundle-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-bundle-loader.d.ts","sourceRoot":"","sources":["../../src/ghost-core/skill-bundle-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE,CASrE"}

package/dist/ghost-core/skill-bundle-loader.js

@@ -0,0 +1,51 @@
+/**
+ * Generic loader for an agentskills.io-compatible skill bundle.
+ *
+ * Each tool in the Ghost monorepo (`ghost`, `ghost`, …) ships
+ * its own skill bundle as real markdown under `src/skill-bundle/` and copies
+ * it verbatim to `dist/skill-bundle/` at build time. This loader walks any
+ * given root directory and returns a flat, deterministically ordered list of
+ * files so the unified `ghost skill install` verb can write them into a target
+ * project.
+ *
+ * Spec: https://agentskills.io/specification
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { join, relative } from "node:path";
+function walk(dir, root, out) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const absolute = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walk(absolute, root, out);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        out.push({
+            path: relative(root, absolute),
+            content: readFileSync(absolute, "utf-8"),
+        });
+    }
+}
+/**
+ * Load a skill bundle from disk.
+ *
+ * `bundleRoot` should point to a directory containing at least a `SKILL.md`
+ * file at the top level (typically `dist/skill-bundle/` after the host
+ * package's build step has copied the markdown sources from `src/`).
+ *
+ * The returned list is sorted with `SKILL.md` first, then alphabetically.
+ */
+export function loadSkillBundle(bundleRoot) {
+    const out = [];
+    walk(bundleRoot, bundleRoot, out);
+    out.sort((a, b) => {
+        if (a.path === "SKILL.md")
+            return -1;
+        if (b.path === "SKILL.md")
+            return 1;
+        return a.path.localeCompare(b.path);
+    });
+    return out;
+}
+//# sourceMappingURL=skill-bundle-loader.js.map

package/dist/ghost-core/skill-bundle-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-bundle-loader.js","sourceRoot":"","sources":["../../src/ghost-core/skill-bundle-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAQ3C,SAAS,IAAI,CAAC,GAAW,EAAE,IAAY,EAAE,GAAsB;IAC7D,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAC9B,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;YAC9B,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAClC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAChB,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * as fingerprint from "./fingerprint.js";
+export * as core from "./ghost-core/index.js";
+/** @deprecated Use `fingerprint` or `@design-intelligence/ghost/fingerprint`. */
+export * as scan from "./scan/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,iFAAiF;AACjF,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * as fingerprint from "./fingerprint.js";
+export * as core from "./ghost-core/index.js";
+/** @deprecated Use `fingerprint` or `@design-intelligence/ghost/fingerprint`. */
+export * as scan from "./scan/index.js";
+//# sourceMappingURL=index.js.map