@aotter/mantle 0.1.4 → 0.2.0-alpha.1

package/dist/spec/domain/service/ManifestLocaleTrimmer.js

@@ -0,0 +1,76 @@
+import { isMap, parseAllDocuments, visit } from "yaml";
+import { toCanonicalLocale } from "./LocaleCanonicalizer.js";
+/**
+ * Drops every locale a project did not select from a manifest's localized
+ * `title` / `description` maps, preserving the rest of the document byte for
+ * byte. Provisioning calls this so a generated project's manifest carries
+ * only the locales it was created with.
+ *
+ * Lives in spec because manifest text is spec's material: it owns the YAML
+ * dependency and the shape of a localized-text node.
+ */
+export class ManifestLocaleTrimError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.reason = reason;
+        this.name = "ManifestLocaleTrimError";
+    }
+}
+/** Returns the manifest text unchanged when nothing needed trimming. */
+export function trimManifestLocales(text, locales) {
+    const documents = parseAllDocuments(text);
+    if (documents.some((document) => document.errors.length > 0)) {
+        throw new ManifestLocaleTrimError("invalid_yaml", "manifest is not valid YAML.");
+    }
+    let changed = false;
+    for (const document of documents) {
+        visit(document, {
+            Pair(_key, pair) {
+                const key = scalarValue(pair.key);
+                const localized = key === "title" || key === "description" ? localeMap(pair.value) : null;
+                if (!localized)
+                    return;
+                const entries = localized.items.map((item) => ({ item, locale: canonicalLocale(item.key) }));
+                const available = new Set(entries.map(({ locale }) => locale));
+                const missing = locales.filter((locale) => !available.has(locale));
+                if (missing.length > 0) {
+                    throw new ManifestLocaleTrimError("unsupported_locale", `manifest does not support locales: ${missing.join(", ")}`);
+                }
+                localized.items = entries.filter(({ locale }) => locales.includes(locale)).map(({ item }) => item);
+                changed ||= localized.items.length !== entries.length;
+                return visit.SKIP;
+            },
+        });
+    }
+    return changed ? documents.map(String).join("---\n") : text;
+}
+/** A localized-text node maps locale keys to scalar strings, nothing else. */
+function localeMap(node) {
+    if (!isMap(node))
+        return null;
+    const map = node;
+    if (map.items.length === 0)
+        return null;
+    for (const item of map.items) {
+        if (scalarValue(item.key) === "type")
+            return null;
+        if (typeof item.value?.value !== "string")
+            return null;
+        if (!canonicalLocale(item.key))
+            return null;
+    }
+    return map;
+}
+function canonicalLocale(node) {
+    try {
+        return toCanonicalLocale(scalarValue(node));
+    }
+    catch {
+        return null;
+    }
+}
+function scalarValue(node) {
+    return String(node?.value ?? "");
+}
+//# sourceMappingURL=ManifestLocaleTrimmer.js.map

package/dist/spec/domain/service/ManifestLocaleTrimmer.js.map

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

package/dist/spec/domain/service/ManifestParser.d.ts

@@ -0,0 +1,49 @@
+import { type Diagnostic, type SourceLocation, type SourceSpan } from "../../kernel/diagnostic.js";
+import { type LifecycleMode, type ProcedureManifest, type SchemaManifest, type TriggerManifest, type ViewManifest } from "../model/ManifestGrammar.js";
+export { ManifestParseError } from "./ManifestFieldChecks.js";
+export { sourceLocationAt } from "./ManifestSourceSpans.js";
+/** One caller-owned manifest source. Core never resolves this ID as a path. */
+export interface ManifestSource {
+    readonly sourceId: string;
+    readonly text: string;
+}
+export interface ManifestSourceSet {
+    readonly sources: readonly ManifestSource[];
+}
+type ParsedSchemaManifest = Omit<SchemaManifest, "spec"> & {
+    readonly spec: Omit<SchemaManifest["spec"], "uniqueIndexes" | "indexes" | "searchableFields" | "localized" | "lifecycle"> & {
+        readonly uniqueIndexes: ReadonlyArray<ReadonlyArray<string>>;
+        readonly indexes: ReadonlyArray<ReadonlyArray<string>>;
+        readonly searchableFields: readonly string[];
+        readonly localized: boolean;
+        readonly lifecycle: LifecycleMode;
+    };
+};
+/** Canonical atom value after all static authoring defaults are materialized. */
+export type ParsedManifest = ParsedSchemaManifest | ViewManifest | ProcedureManifest | TriggerManifest;
+export interface ParsedManifestEntry {
+    readonly manifest: ParsedManifest;
+    readonly source: SourceLocation;
+    /** YAML-node spans keyed by JSON Pointer; source identity lives in `source`. */
+    readonly sourceSpans: Readonly<Record<string, SourceSpan>>;
+}
+declare const parsedManifestSetBrand: unique symbol;
+/** Parser-owned value. Consumers cannot construct it as an ordinary object literal. */
+export interface ParsedManifestSet {
+    readonly entries: readonly ParsedManifestEntry[];
+    readonly [parsedManifestSetBrand]: true;
+}
+export type ParseResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+    readonly diagnostics: readonly Diagnostic[];
+} | {
+    readonly ok: false;
+    readonly diagnostics: readonly Diagnostic[];
+};
+/**
+ * Pure, source-aware parse boundary. Any error withholds the sealed value so a
+ * later stage cannot consume a partial manifest graph.
+ */
+export declare function parseManifestSources(sourceSet: ManifestSourceSet): ParseResult<ParsedManifestSet>;
+//# sourceMappingURL=ManifestParser.d.ts.map

package/dist/spec/domain/service/ManifestParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestParser.d.ts","sourceRoot":"","sources":["../../../../src/spec/domain/service/ManifestParser.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvH,OAAO,EAAe,KAAK,aAAa,EAAoC,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMtM,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;CAC7C;AAED,KAAK,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG;IACzD,QAAQ,CAAC,IAAI,EAAE,IAAI,CACjB,cAAc,CAAC,MAAM,CAAC,EACtB,eAAe,GAAG,SAAS,GAAG,kBAAkB,GAAG,WAAW,GAAG,WAAW,CAC7E,GAAG;QACF,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;QAC7C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;KACnC,CAAC;CACH,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,cAAc,GACtB,oBAAoB,GACpB,YAAY,GACZ,iBAAiB,GACjB,eAAe,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;CAC5D;AAED,OAAO,CAAC,MAAM,sBAAsB,EAAE,OAAO,MAAM,CAAC;AAEpD,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC;CACzC;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,GACrF;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,CAAC;AAOxE;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,GAC3B,WAAW,CAAC,iBAAiB,CAAC,CAYhC"}

package/dist/spec/domain/service/ManifestParser.js

@@ -0,0 +1,203 @@
+import { LineCounter, parseAllDocuments } from "yaml";
+import { validateDiagnostic } from "../../kernel/diagnostic.js";
+import { API_VERSION } from "../model/ManifestGrammar.js";
+import { KNOWN_KINDS, ManifestParseError, rejectUnknownKeys } from "./ManifestFieldChecks.js";
+import { collectSourceSpans, sourceLocation, sourceLocationForNode } from "./ManifestSourceSpans.js";
+import { validateProcedureSpec, validateViewSpec } from "./ProcedureViewSpecChecks.js";
+import { validateSchemaSpec } from "./SchemaSpecChecks.js";
+import { validateTriggerSpec } from "./TriggerSpecChecks.js";
+export { ManifestParseError } from "./ManifestFieldChecks.js";
+export { sourceLocationAt } from "./ManifestSourceSpans.js";
+/**
+ * Pure, source-aware parse boundary. Any error withholds the sealed value so a
+ * later stage cannot consume a partial manifest graph.
+ */
+export function parseManifestSources(sourceSet) {
+    const parsed = parseManifestSourcesInternal(sourceSet);
+    if (parsed.diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return { ok: false, diagnostics: parsed.diagnostics };
+    }
+    return {
+        ok: true,
+        value: Object.freeze({
+            entries: Object.freeze(parsed.entries),
+        }),
+        diagnostics: parsed.diagnostics,
+    };
+}
+function parseManifestSourcesInternal(sourceSet) {
+    const entries = [];
+    const diagnostics = [];
+    const sources = sourceSet?.sources;
+    if (!Array.isArray(sources)) {
+        diagnostics.push(invalidSourceDiagnostic("/sources", "ManifestSourceSet.sources must be an array"));
+        return { entries, diagnostics };
+    }
+    const seenIds = new Set();
+    for (let index = 0; index < sources.length; index++) {
+        const source = sources[index];
+        if (!source || typeof source !== "object") {
+            diagnostics.push(invalidSourceDiagnostic(`/sources/${index}`, "manifest source must be an object"));
+            continue;
+        }
+        if (typeof source.sourceId !== "string" || source.sourceId.length === 0) {
+            diagnostics.push(invalidSourceDiagnostic(`/sources/${index}/sourceId`, "manifest sourceId must be a non-empty string"));
+            continue;
+        }
+        if (seenIds.has(source.sourceId)) {
+            diagnostics.push(invalidSourceDiagnostic(`/sources/${index}/sourceId`, `manifest sourceId '${source.sourceId}' is duplicated`, source.sourceId));
+            continue;
+        }
+        seenIds.add(source.sourceId);
+        if (typeof source.text !== "string") {
+            diagnostics.push(invalidSourceDiagnostic(`/sources/${index}/text`, `manifest source '${source.sourceId}' text must be a string`, source.sourceId));
+            continue;
+        }
+        parseOneStream(source, entries, diagnostics);
+    }
+    return { entries, diagnostics };
+}
+function invalidSourceDiagnostic(path, message, sourceId) {
+    return validateDiagnostic({
+        code: "INVALID_MANIFEST_ENVELOPE",
+        severity: "error",
+        path,
+        ...(sourceId
+            ? { source: { sourceId, documentIndex: 0, path } }
+            : {}),
+        message,
+    });
+}
+function parseOneStream(source, entries, diagnostics) {
+    const lineCounter = new LineCounter();
+    const docs = parseAllDocuments(source.text, { merge: false, lineCounter });
+    for (let i = 0; i < docs.length; i++) {
+        const doc = docs[i];
+        const docIndex = i;
+        if (doc.errors.length > 0) {
+            const error = doc.errors[0];
+            const location = sourceLocation(source.sourceId, docIndex, "/", lineCounter, error?.pos ?? doc.range);
+            diagnostics.push(validateDiagnostic({
+                code: "INVALID_MANIFEST_ENVELOPE",
+                severity: "error",
+                path: "/",
+                source: location,
+                message: `[doc ${docIndex}] YAML parse error: ${doc.errors.map((e) => e.message).join("; ")}`,
+            }));
+            continue;
+        }
+        // `maxAliasCount: 100` matches the yaml library's recommended safe
+        // default; the prior `-1` (unlimited) leaves the parser open to YAML
+        // bombs (`a: &a [{a: *a, ...}]`) that can exhaust memory before any
+        // grammar validator runs. The lib throws a ReferenceError when the
+        // cap trips — surface as a structured diagnostic, not an uncaught.
+        let value;
+        try {
+            value = doc.toJS({ maxAliasCount: 100 });
+        }
+        catch (e) {
+            diagnostics.push(validateDiagnostic({
+                code: "INVALID_MANIFEST_ENVELOPE",
+                severity: "error",
+                path: "/",
+                source: sourceLocationForNode(source.sourceId, docIndex, "/", doc, lineCounter),
+                message: `[doc ${docIndex}] YAML alias-expansion limit exceeded: ${e instanceof Error ? e.message : String(e)}`,
+            }));
+            continue;
+        }
+        if (value == null)
+            continue;
+        try {
+            entries.push({
+                manifest: normalizeManifest(validateEnvelope(value, docIndex)),
+                source: sourceLocationForNode(source.sourceId, docIndex, "/", doc, lineCounter),
+                sourceSpans: collectSourceSpans(doc.contents, lineCounter),
+            });
+        }
+        catch (e) {
+            if (e instanceof ManifestParseError) {
+                const path = e.pointer ?? "/";
+                diagnostics.push(validateDiagnostic({
+                    code: e.code,
+                    severity: "error",
+                    path,
+                    source: sourceLocationForNode(source.sourceId, docIndex, path, doc, lineCounter),
+                    ...e.details,
+                    message: e.message,
+                }));
+            }
+            else {
+                diagnostics.push(validateDiagnostic({
+                    code: "INVALID_MANIFEST_ENVELOPE",
+                    severity: "error",
+                    path: "/",
+                    source: sourceLocationForNode(source.sourceId, docIndex, "/", doc, lineCounter),
+                    message: e instanceof Error
+                        ? `[doc ${docIndex}] ${e.message}`
+                        : `[doc ${docIndex}] unknown parse error`,
+                }));
+            }
+        }
+    }
+}
+function normalizeManifest(manifest) {
+    if (manifest.kind === "Schema") {
+        return {
+            ...manifest,
+            spec: {
+                ...manifest.spec,
+                uniqueIndexes: manifest.spec.uniqueIndexes ?? [],
+                indexes: manifest.spec.indexes ?? [],
+                searchableFields: manifest.spec.searchableFields ?? [],
+                localized: manifest.spec.localized ?? false,
+                lifecycle: manifest.spec.lifecycle ?? "publishing",
+            },
+        };
+    }
+    return manifest;
+}
+function pointerFor(docIndex, jsonPointer) {
+    const ptr = jsonPointer.startsWith("/") ? jsonPointer : `/${jsonPointer}`;
+    return `manifest:doc/${docIndex}#${ptr}`;
+}
+function validateEnvelope(raw, docIndex) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        throw new ManifestParseError("manifest must be a YAML mapping", docIndex);
+    }
+    const m = raw;
+    rejectUnknownKeys(m, ["apiVersion", "kind", "metadata", "spec"], docIndex, "/");
+    if (m["apiVersion"] !== API_VERSION) {
+        throw new ManifestParseError(`apiVersion must be "${API_VERSION}"; got ${JSON.stringify(m["apiVersion"])}` +
+            (m["apiVersion"] === "cms.mantle.aotter.net/v1" ? " (a 0.1.x manifest: follow node_modules/@aotter/mantle/docs/upgrade-0.1-to-0.2.md)" : ""), docIndex, "/apiVersion");
+    }
+    const kind = m["kind"];
+    if (typeof kind !== "string" || !KNOWN_KINDS.has(kind)) {
+        throw new ManifestParseError(`kind must be one of ${[...KNOWN_KINDS].join(", ")}; got ${JSON.stringify(kind)}`, docIndex, "/kind");
+    }
+    const meta = m["metadata"];
+    if (typeof meta !== "object" || meta === null) {
+        throw new ManifestParseError("metadata is required and must be a mapping", docIndex, "/metadata");
+    }
+    const name = meta["name"];
+    rejectUnknownKeys(meta, ["name"], docIndex, "/metadata");
+    if (typeof name !== "string" || name.length === 0) {
+        throw new ManifestParseError("metadata.name is required (non-empty string)", docIndex, "/metadata/name");
+    }
+    const spec = m["spec"];
+    if (typeof spec !== "object" || spec === null) {
+        throw new ManifestParseError("spec is required and must be a mapping", docIndex, "/spec");
+    }
+    switch (kind) {
+        case "Schema":
+            return validateSchemaSpec(raw, docIndex);
+        case "View":
+            return validateViewSpec(raw, docIndex);
+        case "Procedure":
+            return validateProcedureSpec(raw, docIndex);
+        case "Trigger":
+            return validateTriggerSpec(raw, docIndex);
+        default:
+            throw new ManifestParseError(`unhandled kind ${kind}`, docIndex);
+    }
+}
+//# sourceMappingURL=ManifestParser.js.map

package/dist/spec/domain/service/ManifestParser.js.map

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

package/dist/spec/domain/service/ManifestPartition.d.ts

@@ -0,0 +1,9 @@
+import type { Manifest, ProcedureManifest, SchemaManifest, TriggerManifest, ViewManifest } from "../model/ManifestGrammar.js";
+/** Bucketize already parsed/generated manifests without importing the YAML parser. */
+export declare function partitionManifests(manifests: readonly Manifest[]): {
+    schemas: SchemaManifest[];
+    views: ViewManifest[];
+    procedures: ProcedureManifest[];
+    triggers: TriggerManifest[];
+};
+//# sourceMappingURL=ManifestPartition.d.ts.map

package/dist/spec/domain/service/ManifestPartition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestPartition.d.ts","sourceRoot":"","sources":["../../../../src/spec/domain/service/ManifestPartition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACb,MAAM,6BAA6B,CAAC;AAErC,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG;IAClE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAYA"}

package/dist/spec/domain/service/ManifestPartition.js

@@ -0,0 +1,19 @@
+/** Bucketize already parsed/generated manifests without importing the YAML parser. */
+export function partitionManifests(manifests) {
+    const schemas = [];
+    const views = [];
+    const procedures = [];
+    const triggers = [];
+    for (const manifest of manifests) {
+        if (manifest.kind === "Schema")
+            schemas.push(manifest);
+        else if (manifest.kind === "View")
+            views.push(manifest);
+        else if (manifest.kind === "Procedure")
+            procedures.push(manifest);
+        else
+            triggers.push(manifest);
+    }
+    return { schemas, views, procedures, triggers };
+}
+//# sourceMappingURL=ManifestPartition.js.map

package/dist/spec/domain/service/ManifestPartition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestPartition.js","sourceRoot":"","sources":["../../../../src/spec/domain/service/ManifestPartition.ts"],"names":[],"mappings":"AAQA,sFAAsF;AACtF,MAAM,UAAU,kBAAkB,CAAC,SAA8B;IAM/D,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aAClD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aACnD,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW;YAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;;YAC7D,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC"}

package/dist/spec/domain/service/ManifestPathDiagnoser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Diagnostic-path helpers for cross-manifest validators. Pure
+ * functions, no env.
+ *
+ * `manifestPath` formats a JSON Pointer path the CLI / boot validator
+ * can render either as a synthetic `manifest:Kind/name#/...` URI or
+ * (when the caller supplies a file-paths map) as the consumer's actual
+ * `file.yaml#/<docIndex>/...` source location.
+ *
+ * `bestMatch` runs Levenshtein edit distance against a candidate list
+ * and returns the closest match within distance < 3. Used for "did you
+ * mean?" suggestions in `TRIGGER_TARGET_PROCEDURE_UNKNOWN`,
+ * `LIFECYCLE_SCHEMA_UNKNOWN`, etc.
+ */
+/** Per-manifest source location surfaced by the CLI loader. */
+export interface ManifestSourceLocation {
+    readonly file: string;
+    readonly docIndex: number;
+}
+/**
+ * Multi-occurrence file-paths map: each `kind/name` key holds an
+ * ordered list of source locations (length > 1 when the same name
+ * appears in multiple YAML docs/files, which is itself a
+ * DUPLICATE_NAME error but the locations need to remain individually
+ * addressable so duplicate diagnostics point at the right copies).
+ */
+export type ManifestFilePaths = ReadonlyMap<string, readonly ManifestSourceLocation[]>;
+export declare function manifestPath(kind: string, name: string, jsonPointer: string, filePaths?: ManifestFilePaths, 
+/** 1-based occurrence index when the name has multiple file
+ *  locations (duplicate manifests). Defaults to 1 (first copy). */
+occurrence?: number): string;
+export declare function bestMatch(target: string, candidates: ReadonlyArray<string>): string | undefined;
+//# sourceMappingURL=ManifestPathDiagnoser.d.ts.map

package/dist/spec/domain/service/ManifestPathDiagnoser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestPathDiagnoser.d.ts","sourceRoot":"","sources":["../../../../src/spec/domain/service/ManifestPathDiagnoser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAAC;AAEvF,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,iBAAiB;AAC7B;mEACmE;AACnE,UAAU,GAAE,MAAU,GACrB,MAAM,CAKR;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAW/F"}

package/dist/spec/domain/service/ManifestPathDiagnoser.js

@@ -0,0 +1,43 @@
+export function manifestPath(kind, name, jsonPointer, filePaths, 
+/** 1-based occurrence index when the name has multiple file
+ *  locations (duplicate manifests). Defaults to 1 (first copy). */
+occurrence = 1) {
+    const locations = filePaths?.get(`${kind}/${name}`);
+    const fp = locations?.[Math.max(0, occurrence - 1)] ?? locations?.[0];
+    if (fp)
+        return `${fp.file}#/${fp.docIndex}${jsonPointer}`;
+    return `manifest:${kind}/${name}#${jsonPointer}`;
+}
+export function bestMatch(target, candidates) {
+    let best;
+    let bestD = 3;
+    for (const c of candidates) {
+        const d = editDistance(target, c);
+        if (d < bestD) {
+            bestD = d;
+            best = c;
+        }
+    }
+    return best;
+}
+function editDistance(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const dp = Array.from({ length: a.length + 1 }, () => Array(b.length + 1).fill(0));
+    for (let i = 0; i <= a.length; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= b.length; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[a.length][b.length];
+}
+//# sourceMappingURL=ManifestPathDiagnoser.js.map

package/dist/spec/domain/service/ManifestPathDiagnoser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestPathDiagnoser.js","sourceRoot":"","sources":["../../../../src/spec/domain/service/ManifestPathDiagnoser.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,IAAY,EACZ,WAAmB,EACnB,SAA6B;AAC7B;mEACmE;AACnE,aAAqB,CAAC;IAEtB,MAAM,SAAS,GAAG,SAAS,EAAE,GAAG,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,EAAE;QAAE,OAAO,GAAG,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC1D,OAAO,YAAY,IAAI,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,UAAiC;IACzE,IAAI,IAAwB,CAAC;IAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;YACd,KAAK,GAAG,CAAC,CAAC;YACV,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,CAAS,EAAE,CAAS;IACxC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,GAAe,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,CAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,IAAI,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC;AAClC,CAAC"}

package/dist/spec/domain/service/ManifestSourceSpans.d.ts

@@ -0,0 +1,10 @@
+/** Authored YAML spans: where a parsed semantic path came from, for diagnostics. */
+import { LineCounter, type Document, type Node } from "yaml";
+import type { SourceLocation, SourceSpan } from "../../kernel/diagnostic.js";
+import type { ParsedManifestEntry } from "./ManifestParser.js";
+/** Resolve the narrowest retained authored span for a parsed semantic path. */
+export declare function sourceLocationAt(entry: ParsedManifestEntry, path: string): SourceLocation;
+export declare function collectSourceSpans(root: Node | null, lineCounter: LineCounter): Readonly<Record<string, SourceSpan>>;
+export declare function sourceLocationForNode(sourceId: string, documentIndex: number, path: string, doc: Document.Parsed, lineCounter: LineCounter): SourceLocation;
+export declare function sourceLocation(sourceId: string, documentIndex: number, path: string, lineCounter: LineCounter, range?: readonly number[] | null): SourceLocation;
+//# sourceMappingURL=ManifestSourceSpans.d.ts.map

package/dist/spec/domain/service/ManifestSourceSpans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestSourceSpans.d.ts","sourceRoot":"","sources":["../../../../src/spec/domain/service/ManifestSourceSpans.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,WAAW,EAAkC,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,mBAAmB,EAC1B,IAAI,EAAE,MAAM,GACX,cAAc,CAchB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,WAAW,EAAE,WAAW,GACvB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAoBtC;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,QAAQ,CAAC,MAAM,EACpB,WAAW,EAAE,WAAW,GACvB,cAAc,CAehB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,EACxB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAC/B,cAAc,CAGhB"}

package/dist/spec/domain/service/ManifestSourceSpans.js

@@ -0,0 +1,76 @@
+/** Authored YAML spans: where a parsed semantic path came from, for diagnostics. */
+import { isMap, isNode, isScalar, isSeq } from "yaml";
+/** Resolve the narrowest retained authored span for a parsed semantic path. */
+export function sourceLocationAt(entry, path) {
+    let candidate = path;
+    let span = entry.sourceSpans[candidate];
+    while (!span && candidate !== "/") {
+        const slash = candidate.lastIndexOf("/");
+        candidate = slash <= 0 ? "/" : candidate.slice(0, slash);
+        span = entry.sourceSpans[candidate];
+    }
+    return {
+        sourceId: entry.source.sourceId,
+        documentIndex: entry.source.documentIndex,
+        path,
+        ...(span ? { span } : {}),
+    };
+}
+export function collectSourceSpans(root, lineCounter) {
+    const spans = {};
+    const visit = (node, path) => {
+        if (!node)
+            return;
+        const span = sourceSpan(lineCounter, node.range);
+        if (span)
+            spans[path] = span;
+        if (isMap(node)) {
+            for (const pair of node.items) {
+                if (!isScalar(pair.key))
+                    continue;
+                const key = String(pair.key.value).replace(/~/g, "~0").replace(/\//g, "~1");
+                visit(isNode(pair.value) ? pair.value : null, path === "/" ? `/${key}` : `${path}/${key}`);
+            }
+        }
+        else if (isSeq(node)) {
+            node.items.forEach((item, index) => visit(isNode(item) ? item : null, path === "/" ? `/${index}` : `${path}/${index}`));
+        }
+    };
+    visit(root, "/");
+    return Object.freeze(spans);
+}
+export function sourceLocationForNode(sourceId, documentIndex, path, doc, lineCounter) {
+    const parts = path === "/"
+        ? []
+        : path.slice(1).split("/").map((part) => {
+            const decoded = part.replace(/~1/g, "/").replace(/~0/g, "~");
+            return /^\d+$/.test(decoded) ? Number(decoded) : decoded;
+        });
+    let range;
+    for (let length = parts.length; length >= 0 && !range; length--) {
+        const node = length === 0 ? doc.contents : doc.getIn(parts.slice(0, length), true);
+        if (node && typeof node === "object" && "range" in node) {
+            range = node.range;
+        }
+    }
+    return sourceLocation(sourceId, documentIndex, path, lineCounter, range ?? doc.range);
+}
+export function sourceLocation(sourceId, documentIndex, path, lineCounter, range) {
+    const span = sourceSpan(lineCounter, range);
+    return { sourceId, documentIndex, path, ...(span ? { span } : {}) };
+}
+function sourceSpan(lineCounter, range) {
+    if (!range || range.length < 2)
+        return undefined;
+    const startOffset = range[0];
+    const endOffset = range.length > 2 ? range[2] : range[1];
+    if (startOffset === undefined || endOffset === undefined)
+        return undefined;
+    const start = lineCounter.linePos(startOffset);
+    const end = lineCounter.linePos(endOffset);
+    return {
+        start: { line: start.line, column: start.col, offset: startOffset },
+        end: { line: end.line, column: end.col, offset: endOffset },
+    };
+}
+//# sourceMappingURL=ManifestSourceSpans.js.map

package/dist/spec/domain/service/ManifestSourceSpans.js.map

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

package/dist/spec/domain/service/McpToolNaming.d.ts

@@ -0,0 +1,25 @@
+import { type AuthorizationRequirements, type JsonSchema, type ProcedureMcpAnnotations } from "../model/ManifestGrammar.js";
+import type { RuntimePlan } from "../model/RuntimePlan.js";
+/**
+ * A View or Procedure name → MCP tool name: lowercase, kebab to snake. The one place the rule lives; the graph validator's
+ * collision check and the MCP surface both use it.
+ */
+export declare function mcpToolNameSegment(name: string): string;
+/** One MCP tool and the Procedure or View it comes from. */
+export interface McpTool {
+    readonly name: string;
+    readonly kind: "procedure" | "view";
+    readonly source: string;
+    readonly title?: string;
+    readonly description: string;
+    readonly inputSchema: JsonSchema;
+    readonly outputSchema?: JsonSchema;
+    readonly annotations?: ProcedureMcpAnnotations;
+    readonly requires: AuthorizationRequirements | undefined;
+}
+/**
+ * The tools an MCP surface lists (ADR-0032 decision 9): each Procedure bound by an `mcp` Trigger of the surface and each View of it,
+ * never a Schema. `createMcpSurface` registers exactly these, and Admin's `/webmcp` publishes them, so the two cannot disagree.
+ */
+export declare function mcpTools(plan: RuntimePlan, surface: "public" | "staff", locale?: string): McpTool[];
+//# sourceMappingURL=McpToolNaming.d.ts.map

package/dist/spec/domain/service/McpToolNaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpToolNaming.d.ts","sourceRoot":"","sources":["../../../../src/spec/domain/service/McpToolNaming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,yBAAyB,EAAE,KAAK,UAAU,EAAsB,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtK,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,4DAA4D;AAC5D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,GAAG,SAAS,CAAC;CAC1D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,MAAM,SAAO,GAAG,OAAO,EAAE,CAgCjG"}