@design-intelligence/ghost 0.20.0

package/dist/ghost-core/material-transport.js

@@ -0,0 +1,231 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import { TextDecoder } from "node:util";
+import { hasGlobMagic, matchesGlob, normalizeGlobPath } from "./glob.js";
+import { classifyMaterialLocator } from "./materials.js";
+const DEFAULT_MATERIALS_DIR = "materials";
+const DEFAULT_GLOB_CAP = 12;
+const DEFAULT_REFERENCED_INLINE_BYTES = 8 * 1024;
+const textDecoder = new TextDecoder("utf-8", { fatal: true });
+export async function transportMaterials(locators, options) {
+    const materials = [];
+    let inlined = 0;
+    let omitted = 0;
+    for (const locator of locators ?? []) {
+        const classified = classifyMaterialLocator(locator);
+        if (classified.kind === "url") {
+            materials.push({
+                locator,
+                tier: "url",
+                omitted: true,
+                reason: "HTTPS URL; fetch it only if the task requires it",
+            });
+            omitted += 1;
+            continue;
+        }
+        const expanded = await expandLocalMaterialLocator(locator, options, {
+            cap: options.globCap ?? DEFAULT_GLOB_CAP,
+        });
+        const globbed = hasGlobMagic(locator);
+        if (expanded.matches.length === 0) {
+            materials.push({
+                locator,
+                tier: expanded.tier,
+                omitted: true,
+                reason: "matched no local files",
+            });
+            omitted += 1;
+            continue;
+        }
+        for (const match of expanded.matches) {
+            const transported = await transportFile(globbed ? match.repoRelativePath : locator, match, expanded.tier, options);
+            materials.push(transported);
+            if (transported.inlined !== undefined)
+                inlined += 1;
+            if (transported.omitted)
+                omitted += 1;
+        }
+        if (expanded.truncated) {
+            materials.push({
+                locator,
+                tier: expanded.tier,
+                omitted: true,
+                reason: `glob matched more than ${options.globCap ?? DEFAULT_GLOB_CAP} files; omitted the rest`,
+            });
+            omitted += 1;
+        }
+    }
+    return { materials, inlined, omitted };
+}
+export async function expandLocalMaterialLocator(locator, options, expandOptions = {}) {
+    const resolved = resolveLocalMaterialLocator(locator, options);
+    const cap = expandOptions.cap ?? Number.POSITIVE_INFINITY;
+    if (!hasGlobMagic(locator)) {
+        const absolutePath = resolve(options.repoRoot, resolved.pattern);
+        try {
+            const s = await stat(absolutePath);
+            return {
+                locator,
+                tier: resolved.tier,
+                pattern: resolved.pattern,
+                matches: s.isFile()
+                    ? [{ absolutePath, repoRelativePath: resolved.pattern }]
+                    : [],
+                truncated: false,
+            };
+        }
+        catch {
+            return {
+                locator,
+                tier: resolved.tier,
+                pattern: resolved.pattern,
+                matches: [],
+                truncated: false,
+            };
+        }
+    }
+    const base = globLiteralBase(resolved.pattern);
+    const baseAbs = resolve(options.repoRoot, base);
+    const found = [];
+    await walkFiles(baseAbs, options.repoRoot, found, cap + 1, resolved.pattern);
+    return {
+        locator,
+        tier: resolved.tier,
+        pattern: resolved.pattern,
+        matches: found.slice(0, cap),
+        truncated: found.length > cap,
+    };
+}
+export async function listBundledMaterialFiles(options) {
+    const materialsDir = options.materialsDir ?? DEFAULT_MATERIALS_DIR;
+    const bundledDir = join(options.packageDir, materialsDir);
+    const files = [];
+    await walkFiles(bundledDir, options.repoRoot, files, Number.POSITIVE_INFINITY);
+    return files.map((file) => file.repoRelativePath).sort();
+}
+export function materialLocatorClaimsPath(locator, repoRelativePath, options) {
+    if (classifyMaterialLocator(locator).kind === "url")
+        return false;
+    const resolved = resolveLocalMaterialLocator(locator, options);
+    const normalizedPath = normalizeGlobPath(repoRelativePath);
+    return hasGlobMagic(locator)
+        ? matchesGlob(resolved.pattern, normalizedPath)
+        : resolved.pattern === normalizedPath;
+}
+export function resolveLocalMaterialLocator(locator, options) {
+    const materialsDir = options.materialsDir ?? DEFAULT_MATERIALS_DIR;
+    const normalized = normalizeGlobPath(locator);
+    const packageMaterialsDir = resolve(options.packageDir, materialsDir);
+    const packageRelative = normalized === materialsDir || normalized.startsWith(`${materialsDir}/`);
+    const pattern = packageRelative
+        ? toRepoRelative(resolve(options.packageDir, normalized), options.repoRoot)
+        : normalized;
+    const absolutePattern = resolve(options.repoRoot, pattern);
+    const tier = packageRelative || isInsideOrEqual(absolutePattern, packageMaterialsDir)
+        ? "bundled"
+        : "referenced";
+    return { tier, pattern };
+}
+async function transportFile(locator, match, tier, options) {
+    const base = { locator, tier, path: match.repoRelativePath };
+    let s;
+    try {
+        s = await stat(match.absolutePath);
+    }
+    catch {
+        return {
+            ...base,
+            omitted: true,
+            reason: "matched file could not be read",
+        };
+    }
+    if (!s.isFile()) {
+        return { ...base, omitted: true, reason: "not a file" };
+    }
+    const inlineLimit = options.referencedInlineBytes ?? DEFAULT_REFERENCED_INLINE_BYTES;
+    if (tier === "referenced" && s.size > inlineLimit) {
+        return {
+            ...base,
+            omitted: true,
+            reason: `exceeds ${formatBytes(inlineLimit)} inline limit`,
+        };
+    }
+    let buffer;
+    try {
+        buffer = await readFile(match.absolutePath);
+    }
+    catch {
+        return {
+            ...base,
+            omitted: true,
+            reason: "matched file could not be read",
+        };
+    }
+    if (isBinary(buffer)) {
+        return {
+            ...base,
+            omitted: true,
+            reason: "binary inspect-pointer",
+        };
+    }
+    try {
+        return { ...base, inlined: textDecoder.decode(buffer) };
+    }
+    catch {
+        return { ...base, omitted: true, reason: "not valid UTF-8 text" };
+    }
+}
+async function walkFiles(dir, repoRoot, files, limit, glob) {
+    if (files.length >= limit)
+        return;
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (files.length >= limit)
+            return;
+        if (entry.name === ".git")
+            continue;
+        const absolutePath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await walkFiles(absolutePath, repoRoot, files, limit, glob);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        const repoRelativePath = toRepoRelative(absolutePath, repoRoot);
+        if (glob === undefined || matchesGlob(glob, repoRelativePath)) {
+            files.push({ absolutePath, repoRelativePath });
+        }
+    }
+}
+function globLiteralBase(pattern) {
+    const segments = normalizeGlobPath(pattern).split("/");
+    const literal = [];
+    for (const segment of segments) {
+        if (hasGlobMagic(segment))
+            break;
+        literal.push(segment);
+    }
+    const base = literal.join("/");
+    return base === "" ? "." : base;
+}
+function toRepoRelative(path, repoRoot) {
+    const rel = relative(repoRoot, path);
+    return normalizeGlobPath(rel === "" ? "." : rel);
+}
+function isInsideOrEqual(child, parent) {
+    const rel = relative(parent, child);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+function isBinary(buffer) {
+    return buffer.includes(0);
+}
+function formatBytes(bytes) {
+    return bytes % 1024 === 0 ? `${bytes / 1024} KB` : `${bytes} bytes`;
+}
+//# sourceMappingURL=material-transport.js.map

package/dist/ghost-core/material-transport.js.map

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

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

@@ -0,0 +1,14 @@
+/** Material locator support for fingerprint nodes. */
+export type GhostMaterialLocatorKind = "local" | "url";
+export interface ClassifiedGhostMaterialLocator {
+    kind: GhostMaterialLocatorKind;
+    value: string;
+}
+/**
+ * Classify a material locator. `https://…` locators point outside the repo;
+ * everything else is a repo-relative path/glob after validation.
+ */
+export declare function classifyMaterialLocator(value: string): ClassifiedGhostMaterialLocator;
+/** Return a human-readable validation error, or null when the locator is valid. */
+export declare function validateMaterialLocator(value: string): string | null;
+//# sourceMappingURL=materials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../src/ghost-core/materials.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GACZ,8BAA8B,CAIhC;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0CpE"}

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, 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,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, 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,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,11 @@
+import type { GhostNodeDocument, GhostNodeFrontmatter } from "./types.js";
+/**
+ * Serialize a node back to its `---\n<yaml>\n---\n<body>` markdown form. Keys
+ * are emitted in a stable order (description) 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;AAE1E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAY7D;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

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

@@ -0,0 +1,21 @@
+import { stringify as stringifyYaml } from "yaml";
+/**
+ * Serialize a node back to its `---\n<yaml>\n---\n<body>` markdown form. Keys
+ * are emitted in a stable order (description) 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 = {};
+    if (fm.description !== undefined)
+        ordered.description = fm.description;
+    // 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;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;IAC5B,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,IAAI,EAAE,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,CAAC,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC;IAEvE,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,18 @@
+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 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,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,65 @@
+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 ||
+        hasThreeLineFence(input.body) ||
+        extractSkeletonSections(input.body).length > 0);
+}
+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