@astra-spec/sdk 0.0.1

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0EAA0E;AAC1E,2EAA2E"}

package/dist/validation/index.d.ts

@@ -0,0 +1,4 @@
+export { validateAnalysisData, validateUniverseData, validateAnalysisFile, validateUniverseFile, isValidAnalysis, isValidUniverse, } from "./schema.js";
+export { SemanticError, validateAnalysis, validateUniverse, validateAnalysisFile as semanticValidateAnalysisFile, validateUniverseFile as semanticValidateUniverseFile, } from "./semantic.js";
+export { NarrativeWarning, validateNarrativeAnchors, validateNarrativeAnchorsFile, checkNarrativeCoverage, checkNarrativeCoverageFile, validateNarrativeSections, validateNarrativeSectionsFile, } from "./narrative.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,IAAI,4BAA4B,EACpD,oBAAoB,IAAI,4BAA4B,GACrD,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,4 @@
+export { validateAnalysisData, validateUniverseData, validateAnalysisFile, validateUniverseFile, isValidAnalysis, isValidUniverse, } from "./schema.js";
+export { SemanticError, validateAnalysis, validateUniverse, validateAnalysisFile as semanticValidateAnalysisFile, validateUniverseFile as semanticValidateUniverseFile, } from "./semantic.js";
+export { NarrativeWarning, validateNarrativeAnchors, validateNarrativeAnchorsFile, checkNarrativeCoverage, checkNarrativeCoverageFile, validateNarrativeSections, validateNarrativeSectionsFile, } from "./narrative.js";
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,IAAI,4BAA4B,EACpD,oBAAoB,IAAI,4BAA4B,GACrD,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC"}

package/dist/validation/narrative.d.ts

@@ -0,0 +1,23 @@
+import { SemanticError } from "./semantic.js";
+type Dict = Record<string, unknown>;
+export declare class NarrativeWarning {
+    readonly code: string;
+    readonly message: string;
+    readonly path?: string | undefined;
+    constructor(code: string, message: string, path?: string | undefined);
+    toString(): string;
+}
+export declare function validateNarrativeAnchors(data: Dict, options?: {
+    basePath?: string;
+}): SemanticError[];
+export declare function checkNarrativeCoverage(data: Dict, options?: {
+    basePath?: string;
+}): NarrativeWarning[];
+export declare function validateNarrativeSections(data: Dict, options?: {
+    basePath?: string;
+}): SemanticError[];
+export declare function validateNarrativeAnchorsFile(filePath: string): SemanticError[];
+export declare function checkNarrativeCoverageFile(filePath: string): NarrativeWarning[];
+export declare function validateNarrativeSectionsFile(filePath: string): SemanticError[];
+export {};
+//# sourceMappingURL=narrative.d.ts.map

package/dist/validation/narrative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative.d.ts","sourceRoot":"","sources":["../../src/validation/narrative.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AA2B9C,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAUpC,qBAAa,gBAAgB;aAET,IAAI,EAAE,MAAM;aACZ,OAAO,EAAE,MAAM;aACf,IAAI,CAAC,EAAE,MAAM;gBAFb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;IAE/B,QAAQ,IAAI,MAAM;CAGnB;AAuHD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,aAAa,EAAE,CAMjB;AAiED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,gBAAgB,EAAE,CAQpB;AAkFD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,aAAa,EAAE,CAMjB;AAiCD,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAE9E;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAE/E;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAE/E"}

package/dist/validation/narrative.js

@@ -0,0 +1,337 @@
+// Narrative validation: anchor resolution, coverage warnings, and the
+// section-required-when-data-present rule.
+import { loadYaml, resolveAnalysisTree } from "../helpers.js";
+import { SemanticError } from "./semantic.js";
+const HREF_RE = /\[[^\]]*\]\(([^)\s]+)\)/g;
+const PARENT_PATH_FORM_RE = /^(?:\.\.\/)+#/;
+const CATEGORIES = new Set([
+    "inputs",
+    "outputs",
+    "decisions",
+    "findings",
+    "prior_insights",
+    "analyses",
+]);
+const ANALYSES_PREFIX_FORM_RE = new RegExp(`^analyses\\.[^.]+\\.(?:${[...CATEGORIES].sort().join("|")})(?:\\.|$)`);
+const COVERAGE_LABELS = {
+    decisions: "Decision",
+    findings: "Finding",
+    outputs: "Output",
+    analyses: "Sub-analysis",
+};
+const NARRATIVE_SECTIONS = ["summary", "findings", "methods", "inputs", "outputs"];
+function asDict(v) {
+    return v && typeof v === "object" && !Array.isArray(v) ? v : undefined;
+}
+function asArray(v) {
+    return Array.isArray(v) ? v : [];
+}
+export class NarrativeWarning {
+    code;
+    message;
+    path;
+    constructor(code, message, path) {
+        this.code = code;
+        this.message = message;
+        this.path = path;
+    }
+    toString() {
+        return this.path ? `[${this.code}] ${this.path}: ${this.message}` : `[${this.code}] ${this.message}`;
+    }
+}
+function parseAnchor(raw) {
+    let up = 0;
+    let remaining = raw;
+    while (remaining.startsWith("../")) {
+        up += 1;
+        remaining = remaining.slice(3);
+    }
+    if (!remaining)
+        return null;
+    const segments = remaining.split(".");
+    if (segments.some((s) => !s))
+        return null;
+    let catIdx = -1;
+    for (let i = 0; i < segments.length; i++) {
+        if (CATEGORIES.has(segments[i])) {
+            catIdx = i;
+            break;
+        }
+    }
+    if (catIdx === -1)
+        return null;
+    const subPath = segments.slice(0, catIdx);
+    const category = segments[catIdx];
+    const tail = segments.slice(catIdx + 1);
+    if (tail.length === 0)
+        return null;
+    const elementId = tail[0];
+    let optionId = null;
+    if (category === "decisions") {
+        if (tail.length === 3 && tail[1] === "options")
+            optionId = tail[2];
+        else if (tail.length > 1)
+            return null;
+    }
+    else if (tail.length > 1) {
+        return null;
+    }
+    return { raw, upLevels: up, subPath, category, elementId, optionId };
+}
+function getNodeAt(root, path) {
+    let current = root;
+    for (const seg of path) {
+        const analyses = asDict(current.analyses) ?? {};
+        if (!(seg in analyses))
+            return null;
+        const next = asDict(analyses[seg]);
+        if (!next)
+            return null;
+        current = next;
+    }
+    return current;
+}
+function lookupElement(node, category, elementId, optionId) {
+    if (category === "inputs") {
+        const ids = asArray(node.inputs).map((i) => i?.id).filter(Boolean);
+        return ids.includes(elementId);
+    }
+    if (category === "outputs") {
+        const ids = asArray(node.outputs).map((o) => o?.id).filter(Boolean);
+        return ids.includes(elementId);
+    }
+    if (category === "decisions") {
+        const decisions = asDict(node.decisions) ?? {};
+        if (!(elementId in decisions))
+            return false;
+        if (optionId === null)
+            return true;
+        const options = asDict(decisions[elementId].options) ?? {};
+        return optionId in options;
+    }
+    if (category === "findings")
+        return elementId in (asDict(node.findings) ?? {});
+    if (category === "prior_insights")
+        return elementId in (asDict(node.prior_insights) ?? {});
+    if (category === "analyses")
+        return elementId in (asDict(node.analyses) ?? {});
+    return false;
+}
+function resolveAnchor(anchor, hostingPath, root) {
+    if (anchor.upLevels > hostingPath.length)
+        return null;
+    const base = hostingPath.slice(0, hostingPath.length - anchor.upLevels);
+    const targetPath = [...base, ...anchor.subPath];
+    const targetNode = getNodeAt(root, targetPath);
+    if (!targetNode)
+        return null;
+    if (!lookupElement(targetNode, anchor.category, anchor.elementId, anchor.optionId))
+        return null;
+    return { targetPath, category: anchor.category, elementId: anchor.elementId, optionId: anchor.optionId };
+}
+function* iterSections(narrative) {
+    const dict = asDict(narrative);
+    if (!dict)
+        return;
+    for (const section of NARRATIVE_SECTIONS) {
+        const content = dict[section];
+        if (typeof content === "string" && content)
+            yield [section, content];
+    }
+}
+function* extractSectionHrefs(narrative) {
+    for (const [section, content] of iterSections(narrative)) {
+        HREF_RE.lastIndex = 0;
+        let match;
+        while ((match = HREF_RE.exec(content)) !== null) {
+            yield [section, match[1]];
+        }
+    }
+}
+function nodePathStr(path) {
+    return path.map((seg) => `analyses.${seg}`).join(".");
+}
+function narrativeReportPath(base, section) {
+    return base ? `${base}.narrative.${section}` : `narrative.${section}`;
+}
+export function validateNarrativeAnchors(data, options = {}) {
+    let working = data;
+    if (options.basePath)
+        working = resolveAnalysisTree(data, options.basePath);
+    const errors = [];
+    walkAnchors(working, [], working, errors);
+    return errors;
+}
+function walkAnchors(node, path, root, errors) {
+    const narrative = node.narrative;
+    if (narrative) {
+        const base = nodePathStr(path);
+        for (const [section, href] of extractSectionHrefs(narrative)) {
+            const narrPath = narrativeReportPath(base, section);
+            if (PARENT_PATH_FORM_RE.test(href)) {
+                errors.push(new SemanticError("INVALID_NARRATIVE_ANCHOR", `Anchor '${href}' uses non-canonical parent escape; move '../' inside the fragment ` +
+                    `(e.g. '#../target' instead of '../#target')`, narrPath));
+                continue;
+            }
+            if (!href.startsWith("#"))
+                continue;
+            const raw = href.slice(1);
+            if (!raw.includes("."))
+                continue;
+            const parsed = parseAnchor(raw);
+            if (!parsed) {
+                let stripped = raw;
+                while (stripped.startsWith("../"))
+                    stripped = stripped.slice(3);
+                if (ANALYSES_PREFIX_FORM_RE.test(stripped)) {
+                    errors.push(new SemanticError("INVALID_NARRATIVE_ANCHOR", `Anchor '${href}' starts with 'analyses.<sub>' but drilling below the sub-analysis ` +
+                        `node uses the tree-path form: write '#<sub>.<category>.<id>' (or ` +
+                        `'#../<sib>.<category>.<id>' from a sibling) instead.`, narrPath));
+                    continue;
+                }
+                errors.push(new SemanticError("INVALID_NARRATIVE_ANCHOR", `Anchor '#${raw}' does not match the narrative anchor grammar`, narrPath));
+                continue;
+            }
+            if (resolveAnchor(parsed, path, root) === null) {
+                errors.push(new SemanticError("BROKEN_NARRATIVE_ANCHOR", `Anchor '#${raw}' does not resolve to a declared element`, narrPath));
+            }
+        }
+    }
+    const subAnalyses = asDict(node.analyses) ?? {};
+    for (const [subId, raw] of Object.entries(subAnalyses)) {
+        const sub = asDict(raw);
+        if (sub)
+            walkAnchors(sub, [...path, subId], root, errors);
+    }
+}
+export function checkNarrativeCoverage(data, options = {}) {
+    let working = data;
+    if (options.basePath)
+        working = resolveAnalysisTree(data, options.basePath);
+    const mentioned = new Set();
+    collectMentioned(working, [], working, mentioned);
+    const warnings = [];
+    walkCoverage(working, [], mentioned, warnings);
+    return warnings;
+}
+function mentionKey(path, category, elementId) {
+    return `${path.join("/")}|${category}|${elementId}`;
+}
+function collectMentioned(node, path, root, mentioned) {
+    const narrative = node.narrative;
+    if (narrative) {
+        for (const [, href] of extractSectionHrefs(narrative)) {
+            if (!href.startsWith("#"))
+                continue;
+            const raw = href.slice(1);
+            if (!raw.includes("."))
+                continue;
+            const parsed = parseAnchor(raw);
+            if (!parsed)
+                continue;
+            const resolved = resolveAnchor(parsed, path, root);
+            if (!resolved)
+                continue;
+            mentioned.add(mentionKey(resolved.targetPath, resolved.category, resolved.elementId));
+            // Each ancestor sub-analysis along the resolved target counts as mentioned.
+            for (let i = 0; i < resolved.targetPath.length; i++) {
+                mentioned.add(mentionKey(resolved.targetPath.slice(0, i), "analyses", resolved.targetPath[i]));
+            }
+        }
+    }
+    const subAnalyses = asDict(node.analyses) ?? {};
+    for (const [subId, raw] of Object.entries(subAnalyses)) {
+        const sub = asDict(raw);
+        if (sub)
+            collectMentioned(sub, [...path, subId], root, mentioned);
+    }
+}
+function* iterCoverageIds(node, category) {
+    if (category === "decisions") {
+        const decisions = asDict(node.decisions) ?? {};
+        for (const [did, decision] of Object.entries(decisions)) {
+            if (decision && decision.from)
+                continue;
+            yield did;
+        }
+    }
+    else if (category === "outputs") {
+        for (const out of asArray(node.outputs)) {
+            const oid = out?.id;
+            if (oid)
+                yield oid;
+        }
+    }
+    else {
+        yield* Object.keys(asDict(node[category]) ?? {});
+    }
+}
+function walkCoverage(node, path, mentioned, warnings) {
+    const base = nodePathStr(path);
+    for (const [category, label] of Object.entries(COVERAGE_LABELS)) {
+        for (const eid of iterCoverageIds(node, category)) {
+            if (mentioned.has(mentionKey(path, category, eid)))
+                continue;
+            const elementPath = base ? `${base}.${category}.${eid}` : `${category}.${eid}`;
+            warnings.push(new NarrativeWarning("NARRATIVE_UNMENTIONED", `${label} '${eid}' is not mentioned in any narrative`, elementPath));
+        }
+    }
+    const subAnalyses = asDict(node.analyses) ?? {};
+    for (const [subId, raw] of Object.entries(subAnalyses)) {
+        const sub = asDict(raw);
+        if (sub)
+            walkCoverage(sub, [...path, subId], mentioned, warnings);
+    }
+}
+const DATA_TRIGGERED_SECTIONS = {
+    findings: ["findings"],
+    methods: ["decisions", "analyses"],
+    inputs: ["inputs"],
+    outputs: ["outputs"],
+};
+export function validateNarrativeSections(data, options = {}) {
+    let working = data;
+    if (options.basePath)
+        working = resolveAnalysisTree(data, options.basePath);
+    const errors = [];
+    walkSectionRequirements(working, [], errors);
+    return errors;
+}
+function walkSectionRequirements(node, path, errors) {
+    const narrative = asDict(node.narrative) ?? {};
+    const base = nodePathStr(path);
+    for (const [section, triggers] of Object.entries(DATA_TRIGGERED_SECTIONS)) {
+        const present = triggers.filter((k) => {
+            const v = node[k];
+            if (Array.isArray(v))
+                return v.length > 0;
+            if (v && typeof v === "object")
+                return Object.keys(v).length > 0;
+            return Boolean(v);
+        });
+        if (present.length === 0)
+            continue;
+        const content = narrative[section];
+        if (typeof content === "string" && content.trim())
+            continue;
+        const triggersStr = present.map((k) => `'${k}'`).join(" and ");
+        errors.push(new SemanticError("NARRATIVE_SECTION_REQUIRED", `Narrative section '${section}' is required because ${triggersStr} has entries`, narrativeReportPath(base, section)));
+    }
+    const subAnalyses = asDict(node.analyses) ?? {};
+    for (const [subId, raw] of Object.entries(subAnalyses)) {
+        const sub = asDict(raw);
+        if (sub)
+            walkSectionRequirements(sub, [...path, subId], errors);
+    }
+}
+import { dirname } from "node:path";
+export function validateNarrativeAnchorsFile(filePath) {
+    return validateNarrativeAnchors(loadYaml(filePath), { basePath: dirname(filePath) });
+}
+export function checkNarrativeCoverageFile(filePath) {
+    return checkNarrativeCoverage(loadYaml(filePath), { basePath: dirname(filePath) });
+}
+export function validateNarrativeSectionsFile(filePath) {
+    return validateNarrativeSections(loadYaml(filePath), { basePath: dirname(filePath) });
+}
+//# sourceMappingURL=narrative.js.map

package/dist/validation/narrative.js.map

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

package/dist/validation/schema.d.ts

@@ -0,0 +1,16 @@
+import { type JsonSchema, type SchemaLoadOptions } from "../schema/index.js";
+export interface ValidateOptions extends SchemaLoadOptions {
+    /** Pre-loaded schema. Wins over any loader options. */
+    schema?: JsonSchema;
+}
+/** Validate an Analysis dict against the JSON Schema. Returns error
+ *  strings (empty when valid). The schema is fetched from astra-spec.org
+ *  on first use unless `opts.schema` is provided. */
+export declare function validateAnalysisData(data: Record<string, unknown>, opts?: ValidateOptions): Promise<string[]>;
+export declare function validateUniverseData(data: Record<string, unknown>, opts?: ValidateOptions): Promise<string[]>;
+export declare function validateAnalysisFile(filePath: string, opts?: ValidateOptions): Promise<string[]>;
+export declare function validateUniverseFile(filePath: string, opts?: ValidateOptions): Promise<string[]>;
+export declare function isValidAnalysis(filePath: string, opts?: ValidateOptions): Promise<boolean>;
+export declare function isValidUniverse(filePath: string, opts?: ValidateOptions): Promise<boolean>;
+export { astraSchemaUrl, loadAstraSchema } from "../schema/index.js";
+//# sourceMappingURL=schema.d.ts.map

package/dist/validation/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/validation/schema.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,iBAAiB,EAGvB,MAAM,oBAAoB,CAAC;AAQ5B,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,uDAAuD;IACvD,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAkDD;;qDAEqD;AACrD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,OAAO,CAAC,CAElB;AAGD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/validation/schema.js

@@ -0,0 +1,82 @@
+// Structural (JSON Schema) validation. The schema itself is fetched on
+// demand from astra-spec.org via `loadAstraSchema` and cached in memory
+// + on disk; consumers can also pass a pre-loaded schema directly.
+import Ajv2019 from "ajv/dist/2019.js";
+import addFormats from "ajv-formats";
+import { loadAstraSchema, } from "../schema/index.js";
+import { deepClone, injectAnalysisIdsInPlace, injectUniverseIdsInPlace, loadYaml, } from "../helpers.js";
+const _compiledCache = new WeakMap();
+function compileFor(schema) {
+    const cached = _compiledCache.get(schema);
+    if (cached)
+        return cached;
+    // The published spec uses JSON Schema draft 2019-09.
+    const ajv = new Ajv2019({ allErrors: true, strict: false, allowUnionTypes: true });
+    addFormats(ajv);
+    const analysis = ajv.compile(schema);
+    // Wrap to validate against `#/$defs/Universe`. Don't spread the root —
+    // its top-level Analysis keywords would still apply alongside `$ref`.
+    const universeWrapper = {
+        $schema: schema.$schema,
+        $defs: schema.$defs,
+        $ref: "#/$defs/Universe",
+    };
+    const universe = ajv.compile(universeWrapper);
+    const compiled = { analysis, universe };
+    _compiledCache.set(schema, compiled);
+    return compiled;
+}
+async function resolveSchema(opts) {
+    if (opts.schema)
+        return opts.schema;
+    return loadAstraSchema(opts);
+}
+function formatAjvError(err) {
+    const path = err.instancePath
+        ? err.instancePath.replace(/^\//, "").split("/").join(".")
+        : "(root)";
+    let msg = err.message ?? "validation error";
+    if (err.keyword === "required" && err.params.missingProperty) {
+        const missing = err.params.missingProperty;
+        msg = `missing required property '${missing}'`;
+    }
+    return path === "(root)" ? `(root): ${msg}` : `${path}: ${msg}`;
+}
+/** Validate an Analysis dict against the JSON Schema. Returns error
+ *  strings (empty when valid). The schema is fetched from astra-spec.org
+ *  on first use unless `opts.schema` is provided. */
+export async function validateAnalysisData(data, opts = {}) {
+    const schema = await resolveSchema(opts);
+    const { analysis } = compileFor(schema);
+    const prepared = deepClone(data);
+    if (prepared.id === undefined)
+        prepared.id = "root";
+    injectAnalysisIdsInPlace(prepared);
+    if (analysis(prepared))
+        return [];
+    return (analysis.errors ?? []).map(formatAjvError);
+}
+export async function validateUniverseData(data, opts = {}) {
+    const schema = await resolveSchema(opts);
+    const { universe } = compileFor(schema);
+    const prepared = deepClone(data);
+    injectUniverseIdsInPlace(prepared);
+    if (universe(prepared))
+        return [];
+    return (universe.errors ?? []).map(formatAjvError);
+}
+export async function validateAnalysisFile(filePath, opts = {}) {
+    return validateAnalysisData(loadYaml(filePath), opts);
+}
+export async function validateUniverseFile(filePath, opts = {}) {
+    return validateUniverseData(loadYaml(filePath), opts);
+}
+export async function isValidAnalysis(filePath, opts = {}) {
+    return (await validateAnalysisFile(filePath, opts)).length === 0;
+}
+export async function isValidUniverse(filePath, opts = {}) {
+    return (await validateUniverseFile(filePath, opts)).length === 0;
+}
+// Re-export for convenience so callers don't need to import from two paths.
+export { astraSchemaUrl, loadAstraSchema } from "../schema/index.js";
+//# sourceMappingURL=schema.js.map

package/dist/validation/schema.js.map

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

package/dist/validation/semantic.d.ts

@@ -0,0 +1,18 @@
+import type { Analysis } from "../types.js";
+export declare class SemanticError {
+    readonly code: string;
+    readonly message: string;
+    readonly path?: string | undefined;
+    constructor(code: string, message: string, path?: string | undefined);
+    toString(): string;
+}
+type Dict = Record<string, unknown>;
+/** Validate an Analysis dict semantically. Returns the list of errors. */
+export declare function validateAnalysis(data: Analysis | Dict, options?: {
+    basePath?: string;
+}): SemanticError[];
+export declare function validateUniverse(universeData: Dict, analysisData: Dict): SemanticError[];
+export declare function validateAnalysisFile(filePath: string): SemanticError[];
+export declare function validateUniverseFile(universePath: string, analysisPath: string): SemanticError[];
+export {};
+//# sourceMappingURL=semantic.d.ts.map

package/dist/validation/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/validation/semantic.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,qBAAa,aAAa;aAEN,IAAI,EAAE,MAAM;aACZ,OAAO,EAAE,MAAM;aACf,IAAI,CAAC,EAAE,MAAM;gBAFb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;IAG/B,QAAQ,IAAI,MAAM;CAGnB;AAID,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAgDpC,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,GAAG,IAAI,EACrB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,aAAa,EAAE,CAwFjB;AAovBD,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,IAAI,EAClB,YAAY,EAAE,IAAI,GACjB,aAAa,EAAE,CAEjB;AA8LD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAEtE;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,aAAa,EAAE,CAEjB"}