@astra-spec/sdk 0.0.1

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Lightcone Research
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,117 @@
+# astra-typescript
+
+TypeScript SDK for the **Agentic Schema for Transparent Research Analysis (ASTRA)** — published as `@astra-spec/sdk`.
+
+Parse, validate, and inspect ASTRA analysis specifications. The package mirrors the validation surface of the Python `astra-tools` SDK and is intended as a foundation for downstream TypeScript tooling (editors, web validators, agent harnesses).
+
+The canonical specification lives at https://astra-spec.org/.
+
+## Install
+
+```bash
+npm install @astra-spec/sdk
+```
+
+Requires Node ≥18 (uses global `fetch`).
+
+## Schema source
+
+The package does **not** bundle the JSON Schema. It fetches a frozen, versioned copy from astra-spec.org on first use and caches it:
+
+- in memory for the current process
+- on disk under `<tmpdir>/astra-schema-cache/<hash>.json` for re-runs
+
+```ts
+import { loadAstraSchema, astraSchemaUrl } from "@astra-spec/sdk";
+
+// Defaults to https://astra-spec.org/latest/schema/astra.schema.json
+await loadAstraSchema();
+
+// Pin a specific version
+await loadAstraSchema({ version: "0.0.10" });
+// → https://astra-spec.org/0.0.10/schema/astra.schema.json
+
+// Or supply your own URL (https:// or file://)
+await loadAstraSchema({ url: "file:///path/to/astra.schema.json" });
+
+// Or pre-install a schema you already have
+import { setAstraSchema } from "@astra-spec/sdk";
+setAstraSchema(mySchema, { version: "latest" });
+```
+
+Disable disk caching with `cacheDir: false`. Force a refetch with `force: true`.
+
+## Validate an analysis
+
+```ts
+import {
+  validateAnalysisFile,          // structural (JSON Schema)
+  semanticValidateAnalysisFile,  // cross-references, constraints, from-paths
+  validateNarrativeAnchorsFile,  // markdown anchor resolution
+} from "@astra-spec/sdk";
+
+const structural = await validateAnalysisFile("astra.yaml");          // string[]
+const semantic = semanticValidateAnalysisFile("astra.yaml");          // SemanticError[]
+const narrative = validateNarrativeAnchorsFile("astra.yaml");         // SemanticError[]
+
+if (structural.length || semantic.length || narrative.length) {
+  for (const e of [...structural, ...semantic, ...narrative]) console.error(String(e));
+  process.exit(1);
+}
+```
+
+Pin to a specific spec version per call:
+
+```ts
+await validateAnalysisFile("astra.yaml", { version: "0.0.10" });
+```
+
+## Validate a universe
+
+```ts
+import {
+  validateUniverseFile,   // structural
+  validateUniverse,       // semantic, against an analysis
+  loadYaml,
+} from "@astra-spec/sdk";
+
+const structural = await validateUniverseFile("universes/baseline.yaml");
+const semantic = validateUniverse(
+  loadYaml("universes/baseline.yaml"),
+  loadYaml("astra.yaml"),
+);
+```
+
+## What ships
+
+| Module | Exports |
+|---|---|
+| Schema loader | `loadAstraSchema`, `setAstraSchema`, `clearAstraSchemaCache`, `astraSchemaUrl`, `ASTRA_SPEC_HOST`, `JsonSchema`, `SchemaLoadOptions` |
+| Structural validation | `validateAnalysisData`, `validateAnalysisFile`, `validateUniverseData`, `validateUniverseFile`, `isValidAnalysis`, `isValidUniverse` (all async) |
+| Semantic validation | `validateAnalysis`, `validateUniverse`, `semanticValidateAnalysisFile`, `semanticValidateUniverseFile`, `SemanticError` |
+| Narrative validation | `validateNarrativeAnchors`, `checkNarrativeCoverage`, `validateNarrativeSections` (and `*File` variants), `NarrativeWarning` |
+| Helpers | `loadYaml`, `parseYamlString`, `isConditionMet`, `collectNodeDecisions`, `resolveAnalysisTree`, `getInputIds`, `getOutputIds` |
+| Types | `Analysis`, `Universe`, `UniverseNode`, `Input`, `Output`, `Decision`, `Option`, `Recipe`, `Resources`, `Insight`, `Evidence`, `Narrative`, `TextQuoteSelector`, `FragmentSelector` |
+
+## Validation layers
+
+ASTRA validation is layered, matching the Python implementation:
+
+1. **Structural** — JSON Schema (Ajv, draft 2019-09). Shape, types, required fields, ID patterns, `from`-alias forbidden-field rules. Async because it fetches/loads the schema.
+2. **Semantic** — cross-references and constraint resolution: duplicate IDs, default option existence, `from:` direction rules, `Output.inputs` / `Output.decisions` resolution, recipe template placeholders, output dependency cycles, universe selections, constraint compatibility. Synchronous.
+3. **Narrative** — Markdown anchor resolution, coverage warnings (decisions/findings/outputs/sub-analyses unmentioned), and section-required-when-data-present. Synchronous.
+
+## Development
+
+```bash
+npm install
+npm test          # vitest
+npm run build     # tsc → dist/
+npm run typecheck
+```
+
+The test suite runs offline against a sibling `astra-spec` checkout (expected at `../astra-spec` relative to this repo). It pulls the schema, fixtures, and example projects from there rather than vendoring copies.
+
+## License
+
+BSD-3-Clause. See `LICENSE`.

package/dist/helpers.d.ts

@@ -0,0 +1,26 @@
+import type { Analysis, Decision, Universe } from "./types.js";
+/** Parse a YAML string into an unknown record. */
+export declare function parseYamlString(text: string): Record<string, unknown>;
+/** Read a YAML file from disk as a parsed object. */
+export declare function loadYaml(filePath: string): Record<string, unknown>;
+/** Evaluate a `when` clause (string | string[] | undefined) against a
+ *  flat decision selection. AND across entries; `~` prefix negates. */
+export declare function isConditionMet(when: string | string[] | undefined | null, selections: Record<string, string>): boolean;
+/** Locally-defined decisions on a node (skips `from:` aliases). */
+export declare function collectNodeDecisions(node: Record<string, unknown>): Record<string, Decision>;
+export declare function getInputIds(node: Record<string, unknown>): Set<string>;
+export declare function getOutputIds(node: Record<string, unknown>): Set<string>;
+/** Walk `analyses.*.path` references and inline external `astra.yaml`
+ *  files. Returns a new object only if at least one path was resolved. */
+export declare function resolveAnalysisTree(data: Record<string, unknown>, basePath: string): Record<string, unknown>;
+/** Inject mapping keys as `id` fields on each value, mirroring the
+ *  Python-side preprocessing. ASTRA YAML is keyed-dict, but the JSON
+ *  Schema requires `id` to be set. Mutates the supplied data in place. */
+export declare function injectAnalysisIdsInPlace(data: Record<string, unknown>): void;
+export declare function injectUniverseIdsInPlace(node: Record<string, unknown>): void;
+/** Deep clone via JSON round-trip. ASTRA documents are pure data — no
+ *  cycles, no functions — so this is sufficient and avoids a dep. */
+export declare function deepClone<T>(value: T): T;
+export declare function dirOf(filePath: string): string;
+export type { Analysis, Universe };
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAiB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9E,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMrE;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGlE;AAED;uEACuE;AACvE,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,EAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAgBT;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAQ1B;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAKtE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAKvE;AAED;0EAC0E;AAC1E,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCzB;AAED;;0EAE0E;AAC1E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAwB5E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAU5E;AAED;qEACqE;AACrE,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAExC;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9C;AAGD,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC"}

package/dist/helpers.js

@@ -0,0 +1,165 @@
+// Dict-based helpers that operate on parsed YAML data structures. Mirrors
+// the Python `astra.helpers` module so semantic validation can resolve
+// `from:` paths, `when:` conditions, and tree lookups without requiring a
+// strongly-typed model.
+import { readFileSync } from "node:fs";
+import { dirname, isAbsolute, resolve as resolvePath } from "node:path";
+import { parse as parseYaml } from "yaml";
+/** Parse a YAML string into an unknown record. */
+export function parseYamlString(text) {
+    const data = parseYaml(text);
+    if (data == null || typeof data !== "object" || Array.isArray(data)) {
+        throw new Error("YAML root must be a mapping/object");
+    }
+    return data;
+}
+/** Read a YAML file from disk as a parsed object. */
+export function loadYaml(filePath) {
+    const text = readFileSync(filePath, "utf8");
+    return parseYamlString(text);
+}
+/** Evaluate a `when` clause (string | string[] | undefined) against a
+ *  flat decision selection. AND across entries; `~` prefix negates. */
+export function isConditionMet(when, selections) {
+    if (when == null)
+        return true;
+    const conditions = typeof when === "string" ? [when] : when;
+    for (const cond of conditions) {
+        const negate = cond.startsWith("~");
+        const ref = negate ? cond.slice(1) : cond;
+        const dot = ref.indexOf(".");
+        if (dot < 0)
+            return false;
+        const decisionId = ref.slice(0, dot);
+        const optionId = ref.slice(dot + 1);
+        const selected = selections[decisionId];
+        let match = selected === optionId;
+        if (negate)
+            match = !match;
+        if (!match)
+            return false;
+    }
+    return true;
+}
+/** Locally-defined decisions on a node (skips `from:` aliases). */
+export function collectNodeDecisions(node) {
+    const out = {};
+    const decisions = (node.decisions ?? {});
+    for (const [id, decision] of Object.entries(decisions)) {
+        if (decision && typeof decision === "object" && decision.from)
+            continue;
+        out[id] = decision;
+    }
+    return out;
+}
+export function getInputIds(node) {
+    const inputs = (node.inputs ?? []);
+    const out = new Set();
+    for (const inp of inputs)
+        if (inp?.id)
+            out.add(inp.id);
+    return out;
+}
+export function getOutputIds(node) {
+    const outputs = (node.outputs ?? []);
+    const out = new Set();
+    for (const o of outputs)
+        if (o?.id)
+            out.add(o.id);
+    return out;
+}
+/** Walk `analyses.*.path` references and inline external `astra.yaml`
+ *  files. Returns a new object only if at least one path was resolved. */
+export function resolveAnalysisTree(data, basePath) {
+    const analyses = data.analyses;
+    if (!analyses || typeof analyses !== "object")
+        return data;
+    const resolved = {};
+    let changed = false;
+    for (const [id, raw] of Object.entries(analyses)) {
+        if (!raw || typeof raw !== "object") {
+            resolved[id] = raw;
+            continue;
+        }
+        const node = raw;
+        const subPath = node.path;
+        if (typeof subPath === "string" && subPath) {
+            const absDir = isAbsolute(subPath) ? subPath : resolvePath(basePath, subPath);
+            const yamlPath = resolvePath(absDir, "astra.yaml");
+            try {
+                const subData = loadYaml(yamlPath);
+                subData.path = subPath;
+                resolved[id] = resolveAnalysisTree(subData, absDir);
+                changed = true;
+            }
+            catch {
+                // If the file doesn't exist, leave the stub in place — a
+                // higher-layer warning surfaces the problem.
+                resolved[id] = node;
+            }
+        }
+        else {
+            const sub = resolveAnalysisTree(node, basePath);
+            resolved[id] = sub;
+            if (sub !== node)
+                changed = true;
+        }
+    }
+    if (!changed)
+        return data;
+    return { ...data, analyses: resolved };
+}
+/** Inject mapping keys as `id` fields on each value, mirroring the
+ *  Python-side preprocessing. ASTRA YAML is keyed-dict, but the JSON
+ *  Schema requires `id` to be set. Mutates the supplied data in place. */
+export function injectAnalysisIdsInPlace(data) {
+    for (const field of ["decisions", "analyses", "prior_insights", "findings"]) {
+        const mapping = data[field];
+        if (!mapping || typeof mapping !== "object" || Array.isArray(mapping))
+            continue;
+        for (const [key, value] of Object.entries(mapping)) {
+            if (!value || typeof value !== "object" || Array.isArray(value))
+                continue;
+            const obj = value;
+            if (obj.id === undefined)
+                obj.id = key;
+            if (field === "decisions") {
+                const opts = obj.options;
+                if (opts && typeof opts === "object" && !Array.isArray(opts)) {
+                    for (const [okey, ovalue] of Object.entries(opts)) {
+                        if (ovalue && typeof ovalue === "object" && !Array.isArray(ovalue)) {
+                            const o = ovalue;
+                            if (o.id === undefined)
+                                o.id = okey;
+                        }
+                    }
+                }
+            }
+            if (field === "analyses") {
+                injectAnalysisIdsInPlace(obj);
+            }
+        }
+    }
+}
+export function injectUniverseIdsInPlace(node) {
+    const analyses = node.analyses;
+    if (!analyses || typeof analyses !== "object" || Array.isArray(analyses))
+        return;
+    for (const [key, value] of Object.entries(analyses)) {
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+            const obj = value;
+            if (obj.id === undefined)
+                obj.id = key;
+            injectUniverseIdsInPlace(obj);
+        }
+    }
+}
+/** Deep clone via JSON round-trip. ASTRA documents are pure data — no
+ *  cycles, no functions — so this is sufficient and avoids a dep. */
+export function deepClone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+export function dirOf(filePath) {
+    return dirname(filePath);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { Analysis, Decision, Evidence, FragmentSelector, Input, InputType, Insight, Narrative, Option, Output, OutputType, Recipe, Resources, TextQuoteSelector, Universe, UniverseNode, } from "./types.js";
+export { loadYaml, parseYamlString, isConditionMet, collectNodeDecisions, resolveAnalysisTree, injectAnalysisIdsInPlace, injectUniverseIdsInPlace, getInputIds, getOutputIds, } from "./helpers.js";
+export { validateAnalysisData, validateUniverseData, validateAnalysisFile, validateUniverseFile, isValidAnalysis, isValidUniverse, SemanticError, validateAnalysis, validateUniverse, semanticValidateAnalysisFile, semanticValidateUniverseFile, NarrativeWarning, validateNarrativeAnchors, validateNarrativeAnchorsFile, checkNarrativeCoverage, checkNarrativeCoverageFile, validateNarrativeSections, validateNarrativeSectionsFile, } from "./validation/index.js";
+export { type JsonSchema, type SchemaLoadOptions, ASTRA_SPEC_HOST, astraSchemaUrl, loadAstraSchema, setAstraSchema, clearAstraSchemaCache, } from "./schema/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,SAAS,EACT,OAAO,EACP,SAAS,EACT,MAAM,EACN,MAAM,EACN,UAAU,EACV,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,WAAW,EACX,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EAGf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAG5B,gBAAgB,EAChB,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// Public API for @astra-spec/sdk. The package focuses on parsing and
+// validating ASTRA analyses; downstream tools layer their own UX on top.
+export { loadYaml, parseYamlString, isConditionMet, collectNodeDecisions, resolveAnalysisTree, injectAnalysisIdsInPlace, injectUniverseIdsInPlace, getInputIds, getOutputIds, } from "./helpers.js";
+export { 
+// Structural (JSON Schema)
+validateAnalysisData, validateUniverseData, validateAnalysisFile, validateUniverseFile, isValidAnalysis, isValidUniverse, 
+// Semantic
+SemanticError, validateAnalysis, validateUniverse, semanticValidateAnalysisFile, semanticValidateUniverseFile, 
+// Narrative
+NarrativeWarning, validateNarrativeAnchors, validateNarrativeAnchorsFile, checkNarrativeCoverage, checkNarrativeCoverageFile, validateNarrativeSections, validateNarrativeSectionsFile, } from "./validation/index.js";
+export { ASTRA_SPEC_HOST, astraSchemaUrl, loadAstraSchema, setAstraSchema, clearAstraSchemaCache, } from "./schema/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,yEAAyE;AAqBzE,OAAO,EACL,QAAQ,EACR,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,WAAW,EACX,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO;AACL,2BAA2B;AAC3B,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe;AAEf,WAAW;AACX,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B;AAE5B,YAAY;AACZ,gBAAgB,EAChB,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAGL,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}

package/dist/schema/index.d.ts

@@ -0,0 +1,35 @@
+export type JsonSchema = Record<string, unknown>;
+export interface SchemaLoadOptions {
+    /** Version segment in the URL path. Defaults to "latest". */
+    version?: string;
+    /** Explicit URL override. Wins over `version`. Supports `https://` and `file://`. */
+    url?: string;
+    /**
+     * Directory used as the on-disk cache. Set to `null` (or `false`) to
+     * disable disk caching entirely. Defaults to `<tmpdir>/astra-schema-cache`.
+     */
+    cacheDir?: string | null | false;
+    /** Bypass both in-memory and on-disk caches and fetch fresh. */
+    force?: boolean;
+}
+export declare const ASTRA_SPEC_HOST = "https://astra-spec.org";
+/** Build the canonical schema URL for a given version. */
+export declare function astraSchemaUrl(version?: string): string;
+/**
+ * Load the ASTRA JSON Schema. Default source is
+ * `https://astra-spec.org/latest/schema/astra.schema.json`.
+ *
+ * Subsequent calls with the same URL hit an in-memory cache. With disk
+ * caching enabled (the default), the schema is also persisted under
+ * `<tmpdir>/astra-schema-cache` so future processes don't have to refetch.
+ */
+export declare function loadAstraSchema(opts?: SchemaLoadOptions): Promise<JsonSchema>;
+/** Install a pre-loaded schema in the in-memory cache. Useful for tests
+ *  and for environments where the consumer prefers to manage fetching. */
+export declare function setAstraSchema(schema: JsonSchema, opts?: {
+    url?: string;
+    version?: string;
+}): void;
+/** Drop all cached schemas from memory. */
+export declare function clearAstraSchemaCache(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IACjC,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAID,eAAO,MAAM,eAAe,2BAA2B,CAAC;AAExD,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,OAAO,SAAW,GAAG,MAAM,CAEzD;AAuBD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoCvF;AAED;0EAC0E;AAC1E,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CAGtG;AAED,2CAA2C;AAC3C,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/schema/index.js

@@ -0,0 +1,85 @@
+// Schema loader. The package no longer bundles the JSON Schema —
+// instead we fetch the frozen, versioned artifact from astra-spec.org
+// (cached in memory, with an optional on-disk cache for repeat runs).
+import { createHash } from "node:crypto";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+const _memoryCache = new Map();
+export const ASTRA_SPEC_HOST = "https://astra-spec.org";
+/** Build the canonical schema URL for a given version. */
+export function astraSchemaUrl(version = "latest") {
+    return `${ASTRA_SPEC_HOST}/${version}/schema/astra.schema.json`;
+}
+function defaultCacheDir() {
+    return join(tmpdir(), "astra-schema-cache");
+}
+function cacheFileFor(url, dir) {
+    const hash = createHash("sha256").update(url).digest("hex").slice(0, 16);
+    return join(dir, `${hash}.json`);
+}
+async function readUrl(url) {
+    if (url.startsWith("file://")) {
+        const text = readFileSync(fileURLToPath(url), "utf8");
+        return JSON.parse(text);
+    }
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`Failed to fetch ASTRA schema from ${url}: HTTP ${res.status}`);
+    }
+    return (await res.json());
+}
+/**
+ * Load the ASTRA JSON Schema. Default source is
+ * `https://astra-spec.org/latest/schema/astra.schema.json`.
+ *
+ * Subsequent calls with the same URL hit an in-memory cache. With disk
+ * caching enabled (the default), the schema is also persisted under
+ * `<tmpdir>/astra-schema-cache` so future processes don't have to refetch.
+ */
+export async function loadAstraSchema(opts = {}) {
+    const url = opts.url ?? astraSchemaUrl(opts.version ?? "latest");
+    if (!opts.force) {
+        const cached = _memoryCache.get(url);
+        if (cached)
+            return cached;
+    }
+    const useDisk = opts.cacheDir !== null && opts.cacheDir !== false;
+    const cacheDir = typeof opts.cacheDir === "string" ? opts.cacheDir : defaultCacheDir();
+    const cachePath = useDisk ? cacheFileFor(url, cacheDir) : null;
+    if (cachePath && !opts.force) {
+        try {
+            const text = readFileSync(cachePath, "utf8");
+            const schema = JSON.parse(text);
+            _memoryCache.set(url, schema);
+            return schema;
+        }
+        catch {
+            // Fall through to network fetch.
+        }
+    }
+    const schema = await readUrl(url);
+    _memoryCache.set(url, schema);
+    if (cachePath) {
+        try {
+            mkdirSync(cacheDir, { recursive: true });
+            writeFileSync(cachePath, JSON.stringify(schema));
+        }
+        catch {
+            // Best-effort cache; ignore write failures.
+        }
+    }
+    return schema;
+}
+/** Install a pre-loaded schema in the in-memory cache. Useful for tests
+ *  and for environments where the consumer prefers to manage fetching. */
+export function setAstraSchema(schema, opts = {}) {
+    const url = opts.url ?? astraSchemaUrl(opts.version ?? "latest");
+    _memoryCache.set(url, schema);
+}
+/** Drop all cached schemas from memory. */
+export function clearAstraSchemaCache() {
+    _memoryCache.clear();
+}
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,122 @@
+export type InputType = "data" | "analysis";
+export type OutputType = "metric" | "figure" | "table" | "data" | "report";
+export interface TextQuoteSelector {
+    exact: string;
+    prefix?: string;
+    suffix?: string;
+}
+export interface FragmentSelector {
+    value?: string;
+    page?: number;
+}
+export interface Evidence {
+    id: string;
+    doi?: string;
+    artifact?: string;
+    version?: number;
+    snapshot?: string;
+    source_commit?: string;
+    quote?: TextQuoteSelector;
+    location?: FragmentSelector;
+}
+export interface Insight {
+    id: string;
+    label?: string;
+    claim: string;
+    created_at: string;
+    evidence: Evidence[];
+    derived?: boolean;
+    scope?: string;
+    tags?: string[];
+    notes?: string;
+}
+export interface Resources {
+    cpus?: number;
+    memory?: string;
+    time_limit?: string;
+    disk?: string;
+    gpus?: number;
+}
+export interface Recipe {
+    command?: string;
+    resources?: Resources;
+    container?: string;
+}
+export interface Input {
+    id: string;
+    label?: string;
+    type?: InputType;
+    description?: string;
+    source?: string;
+    ref?: string;
+    ref_version?: string;
+    use_outputs?: string[];
+    from?: string;
+}
+export interface Output {
+    id: string;
+    label?: string;
+    type?: OutputType;
+    description?: string;
+    inputs?: string[];
+    decisions?: string[];
+    recipe?: Recipe;
+    from?: string;
+    when?: string[];
+}
+export interface Option {
+    id?: string;
+    label: string;
+    description?: string;
+    insights?: string[];
+    incompatible_with?: string[];
+    requires?: string[];
+    excluded?: boolean;
+    excluded_reason?: string;
+}
+export interface Decision {
+    id?: string;
+    label?: string;
+    rationale?: string;
+    tags?: string[];
+    default?: string;
+    options?: Record<string, Option>;
+    from?: string;
+    when?: string[];
+}
+export interface Narrative {
+    summary?: string;
+    findings?: string;
+    methods?: string;
+    inputs?: string;
+    outputs?: string;
+}
+export interface Analysis {
+    id?: string;
+    version?: string;
+    name?: string;
+    narrative?: Narrative;
+    authors?: string[];
+    tags?: string[];
+    inputs?: Input[];
+    outputs?: Output[];
+    decisions?: Record<string, Decision>;
+    prior_insights?: Record<string, Insight>;
+    findings?: Record<string, Insight>;
+    container?: string;
+    path?: string;
+    analyses?: Record<string, Analysis>;
+}
+export interface UniverseNode {
+    id?: string;
+    universe?: string;
+    decisions?: Record<string, string>;
+    analyses?: Record<string, UniverseNode>;
+}
+export interface Universe {
+    id: string;
+    description?: string;
+    decisions?: Record<string, string>;
+    analyses?: Record<string, UniverseNode>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+// Hand-curated TypeScript types matching the LinkML schema published at
+// https://astra-spec.org/. The shapes are deliberately permissive (string
+// IDs, optional fields) — strict structural checks happen in `validation`.
+export {};
+//# sourceMappingURL=types.js.map