@davidorex/pi-context 0.26.0

package/dist/samples-catalog.js

@@ -0,0 +1,128 @@
+/**
+ * Samples-catalog discovery surface (FGAP-068 closure; DEC-0037 packaged view).
+ *
+ * DEC-0037 (enacted) requires the conception present each block kind PACKAGED
+ * with its relation_types + invariants + lens. This module reads the
+ * extension's OWN bundled `samples/conception.json` + `samples/schemas/` and
+ * projects, per block kind: title, description, item shape, the relation_types
+ * for which the kind may be a source / target endpoint, the invariants ranging
+ * over it, and the lenses targeting it — plus the top-level relation_type /
+ * lens / invariant / layer / status_bucket registries.
+ *
+ * PACKAGE-INTRINSIC: there is no `cwd` parameter. The catalog reads the bundled
+ * samples directory resolved relative to this module (`../samples`), so it works
+ * the same from `src/` (tsx --test) and from `dist/` (post-build) and is
+ * independent of any installed project substrate.
+ *
+ * DEC-0019/0020 dual-surface: this library function backs both the Pi tool
+ * `read-samples-catalog` (in-pi LLM discovery) and the CLI script
+ * `scripts/orchestrator/read-samples-catalog.ts` (Claude-Code-side); all three
+ * ship as one unit.
+ *
+ * Never throws for unknown-kind / missing-description: defects surface as
+ * per-kind `warnings[]` and catalog-level `warnings[]` so a half-authored
+ * conception is diagnosable rather than fatal.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { schemaInfoFromPath } from "./context-sdk.js";
+/** Bundled samples directory — resolved relative to this module so it works from
+ * both `src/` (tsx) and `dist/` (built); `samples/` sits one level above either. */
+const SAMPLES_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "samples");
+/**
+ * Build the packaged samples catalog. With `opts.kind` set, the catalog's
+ * `kinds[]` is filtered to the single matching block kind (empty + a warning
+ * when no kind matches). The top-level registries are always returned in full.
+ */
+export function samplesCatalog(opts) {
+    const conception = JSON.parse(fs.readFileSync(path.join(SAMPLES_DIR, "conception.json"), "utf-8"));
+    const blockKinds = conception.block_kinds ?? [];
+    const relationTypes = conception.relation_types ?? [];
+    const lenses = conception.lenses ?? [];
+    const invariants = conception.invariants ?? [];
+    const warnings = [];
+    const knownKindIds = new Set(blockKinds.map((bk) => bk.canonical_id));
+    // Catalog-level: any source/target_kinds value that is neither "*" nor a
+    // known block_kind canonical_id is a misauthored endpoint declaration.
+    for (const rt of relationTypes) {
+        for (const k of rt.source_kinds ?? []) {
+            if (k !== "*" && !knownKindIds.has(k)) {
+                warnings.push(`relation_type '${rt.canonical_id}' names unknown kind '${k}' in source_kinds`);
+            }
+        }
+        for (const k of rt.target_kinds ?? []) {
+            if (k !== "*" && !knownKindIds.has(k)) {
+                warnings.push(`relation_type '${rt.canonical_id}' names unknown kind '${k}' in target_kinds`);
+            }
+        }
+    }
+    // Filter set: when opts.kind is given but unknown, emit a warning + empty kinds.
+    let selected = blockKinds;
+    if (opts?.kind !== undefined) {
+        selected = blockKinds.filter((bk) => bk.canonical_id === opts.kind);
+        if (selected.length === 0) {
+            warnings.push(`unknown kind '${opts.kind}' — not in block_kinds`);
+        }
+    }
+    const kinds = selected.map((bk) => buildSampleKind(bk, relationTypes, invariants, lenses));
+    return {
+        schema_version: String(conception.schema_version ?? ""),
+        kinds,
+        relationTypes,
+        lenses,
+        invariants,
+        layers: conception.layers ?? [],
+        status_buckets: conception.status_buckets ?? {},
+        warnings,
+    };
+}
+/** Project one block kind into a SampleKind, reading its bundled schema. */
+function buildSampleKind(bk, relationTypes, invariants, lenses) {
+    const kindWarnings = [];
+    // Read the schema once for the root description; schemaInfoFromPath handles
+    // title + item shape (it does not capture the root `description` field).
+    const schemaFile = path.join(SAMPLES_DIR, "schemas", `${bk.canonical_id}.schema.json`);
+    let description = null;
+    try {
+        const rawSchema = JSON.parse(fs.readFileSync(schemaFile, "utf-8"));
+        description = typeof rawSchema.description === "string" ? rawSchema.description : null;
+    }
+    catch {
+        description = null;
+    }
+    const info = schemaInfoFromPath(schemaFile, bk.canonical_id);
+    const title = info?.title ?? null;
+    const shape = info
+        ? { arrayKeys: info.arrayKeys, itemProperties: info.itemProperties ?? {} }
+        : null;
+    if (title === null)
+        kindWarnings.push(`kind '${bk.canonical_id}': schema title missing or unreadable`);
+    if (description === null)
+        kindWarnings.push(`kind '${bk.canonical_id}': schema description missing or unreadable`);
+    if (shape === null)
+        kindWarnings.push(`kind '${bk.canonical_id}': schema shape missing or unreadable`);
+    // Endpoint participation: R is as_source for K iff R.source_kinds includes
+    // "*" or K.canonical_id; as_target analogously. A relation with no
+    // source_kinds/target_kinds contributes to neither (metadata-less case).
+    const as_source = relationTypes.filter((r) => r.source_kinds !== undefined && (r.source_kinds.includes("*") || r.source_kinds.includes(bk.canonical_id)));
+    const as_target = relationTypes.filter((r) => r.target_kinds !== undefined && (r.target_kinds.includes("*") || r.target_kinds.includes(bk.canonical_id)));
+    const kindInvariants = invariants.filter((inv) => inv.block === bk.canonical_id);
+    const kindLenses = lenses.filter((lens) => lens.target === bk.canonical_id || (Array.isArray(lens.targets) && lens.targets.includes(bk.canonical_id)));
+    return {
+        canonical_id: bk.canonical_id,
+        display_name: bk.display_name,
+        prefix: bk.prefix,
+        array_key: bk.array_key,
+        data_path: bk.data_path,
+        schema_path: bk.schema_path,
+        title,
+        description,
+        shape,
+        relation_types: { as_source, as_target },
+        invariants: kindInvariants,
+        lenses: kindLenses,
+        warnings: kindWarnings,
+    };
+}
+//# sourceMappingURL=samples-catalog.js.map

package/dist/samples-catalog.js.map

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

package/dist/schema-migrations.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Schema migration registry — closes FGAP-006 (schema versioning + identity +
+ * composition + migration story) at the runtime-migration layer. Pairs with
+ * the `$id` + `version` schema-identity surface landed alongside this module
+ * in the framework schemas under `packages/pi-context/schemas/`.
+ *
+ * Aim: when a block file declares `schema_version: "1.0.0"` but the schema
+ * itself has advanced to `"2.0.0"`, a registered chain of MigrationFns walks
+ * the data forward one step at a time — `1.0.0 → 1.1.0 → 2.0.0` — before AJV
+ * validates against the current schema. Per-step migrations are pure data
+ * transforms that take and return `unknown`; the registry resolves the chain
+ * by looking up each (schemaName, fromVersion) entry and following its
+ * `toVersion` forward until it lands on `targetVersion` or fails.
+ *
+ * Design notes (intentions, not absolutes):
+ *   - In-memory module via `createRegistry()` returning the typed surface;
+ *     a singleton is not exported because per-process / per-test isolation
+ *     simplifies coverage and avoids cross-test contamination.
+ *   - Linear chain only — no branching / no diamond resolution. If a future
+ *     schema has multiple `1.x → 2.x` paths the registry as written will
+ *     follow the first registered edge from each (schemaName, fromVersion);
+ *     callers should register exactly one outgoing edge per node.
+ *   - Cycle detection is bounded by tracking visited (schemaName, version)
+ *     tuples during `resolve`; an unbounded walk would hang on a misregistered
+ *     `1.0.0 → 1.0.0` self-loop.
+ *   - `runMigrations` with `currentVersion === targetVersion` is a no-op
+ *     pass-through — no registry lookup, no copy, no error.
+ *   - `register` rejects duplicate (schemaName, fromVersion) entries with a
+ *     descriptive Error so accidental double-registration surfaces at startup
+ *     rather than as silent override.
+ *
+ * Out of scope here:
+ *   - On-disk migration of existing block files. Migration runs at READ time
+ *     when a future `validateBlockWithMigration` (schema-validator.ts) is
+ *     called; it does not rewrite the source file.
+ *   - Cross-schema migrations (e.g. splitting one block into two). Those
+ *     would compose at a higher layer than this per-schema chain.
+ */
+/**
+ * A single forward migration step. Receives the block data as it exists at
+ * `fromVersion` and returns the data shaped to match `toVersion`. The function
+ * is expected to be pure; it should not perform I/O.
+ */
+export type MigrationFn = (data: unknown) => unknown;
+/**
+ * One registered edge in the migration graph. `schemaName` is the canonical
+ * schema id (matches the schema's `$id` minus the URN prefix, e.g. `"config"`,
+ * `"relations"`, `"priority"`). `fromVersion` and `toVersion` are semver
+ * strings matching the schema's `version` field at those points in time.
+ */
+export interface MigrationRegistryEntry {
+    schemaName: string;
+    fromVersion: string;
+    toVersion: string;
+    migrate: MigrationFn;
+}
+/**
+ * Typed surface returned by `createRegistry()`. `register` adds an edge;
+ * `resolve` walks the registered edges to produce an ordered list of
+ * MigrationFns from `fromVersion` to `toVersion`. `resolve` throws when no
+ * path exists (including when the registry is empty for that schemaName).
+ */
+export interface MigrationRegistry {
+    register(entry: MigrationRegistryEntry): void;
+    resolve(schemaName: string, fromVersion: string, toVersion: string): MigrationFn[];
+}
+/**
+ * Construct a fresh, empty migration registry. Each call returns an
+ * independent instance — there is no shared global state — so callers needing
+ * isolation (notably tests) get it for free.
+ */
+export declare function createRegistry(): MigrationRegistry;
+/**
+ * Resolve the migration chain for `schemaName` from `currentVersion` to
+ * `targetVersion` and apply each step in order to `data`. Returns the final
+ * migrated data. When `currentVersion === targetVersion` the input is
+ * returned unchanged (no allocation, no registry lookup).
+ *
+ * Throws when no migration path exists (`registry.resolve` propagates).
+ */
+export declare function runMigrations(registry: MigrationRegistry, schemaName: string, currentVersion: string, targetVersion: string, data: unknown): unknown;
+//# sourceMappingURL=schema-migrations.d.ts.map

package/dist/schema-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-migrations.d.ts","sourceRoot":"","sources":["../src/schema-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACnF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CA0DlD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,OAAO,GACX,OAAO,CAST"}

package/dist/schema-migrations.js

@@ -0,0 +1,106 @@
+/**
+ * Schema migration registry — closes FGAP-006 (schema versioning + identity +
+ * composition + migration story) at the runtime-migration layer. Pairs with
+ * the `$id` + `version` schema-identity surface landed alongside this module
+ * in the framework schemas under `packages/pi-context/schemas/`.
+ *
+ * Aim: when a block file declares `schema_version: "1.0.0"` but the schema
+ * itself has advanced to `"2.0.0"`, a registered chain of MigrationFns walks
+ * the data forward one step at a time — `1.0.0 → 1.1.0 → 2.0.0` — before AJV
+ * validates against the current schema. Per-step migrations are pure data
+ * transforms that take and return `unknown`; the registry resolves the chain
+ * by looking up each (schemaName, fromVersion) entry and following its
+ * `toVersion` forward until it lands on `targetVersion` or fails.
+ *
+ * Design notes (intentions, not absolutes):
+ *   - In-memory module via `createRegistry()` returning the typed surface;
+ *     a singleton is not exported because per-process / per-test isolation
+ *     simplifies coverage and avoids cross-test contamination.
+ *   - Linear chain only — no branching / no diamond resolution. If a future
+ *     schema has multiple `1.x → 2.x` paths the registry as written will
+ *     follow the first registered edge from each (schemaName, fromVersion);
+ *     callers should register exactly one outgoing edge per node.
+ *   - Cycle detection is bounded by tracking visited (schemaName, version)
+ *     tuples during `resolve`; an unbounded walk would hang on a misregistered
+ *     `1.0.0 → 1.0.0` self-loop.
+ *   - `runMigrations` with `currentVersion === targetVersion` is a no-op
+ *     pass-through — no registry lookup, no copy, no error.
+ *   - `register` rejects duplicate (schemaName, fromVersion) entries with a
+ *     descriptive Error so accidental double-registration surfaces at startup
+ *     rather than as silent override.
+ *
+ * Out of scope here:
+ *   - On-disk migration of existing block files. Migration runs at READ time
+ *     when a future `validateBlockWithMigration` (schema-validator.ts) is
+ *     called; it does not rewrite the source file.
+ *   - Cross-schema migrations (e.g. splitting one block into two). Those
+ *     would compose at a higher layer than this per-schema chain.
+ */
+/**
+ * Construct a fresh, empty migration registry. Each call returns an
+ * independent instance — there is no shared global state — so callers needing
+ * isolation (notably tests) get it for free.
+ */
+export function createRegistry() {
+    // Outer map: schemaName → inner map keyed by fromVersion. Each inner-map
+    // entry holds the single outgoing edge (toVersion + migrate). One outgoing
+    // edge per (schemaName, fromVersion) keeps the walk deterministic.
+    const edges = new Map();
+    function register(entry) {
+        let perSchema = edges.get(entry.schemaName);
+        if (!perSchema) {
+            perSchema = new Map();
+            edges.set(entry.schemaName, perSchema);
+        }
+        if (perSchema.has(entry.fromVersion)) {
+            throw new Error(`MigrationRegistry: duplicate edge for schema '${entry.schemaName}' fromVersion '${entry.fromVersion}'`);
+        }
+        perSchema.set(entry.fromVersion, { toVersion: entry.toVersion, migrate: entry.migrate });
+    }
+    function resolve(schemaName, fromVersion, toVersion) {
+        if (fromVersion === toVersion)
+            return [];
+        const perSchema = edges.get(schemaName);
+        if (!perSchema || perSchema.size === 0) {
+            throw new Error(`MigrationRegistry: no migrations registered for schema '${schemaName}' (need ${fromVersion} → ${toVersion})`);
+        }
+        const chain = [];
+        const visited = new Set();
+        let cursor = fromVersion;
+        // Walk forward step by step. Each step looks up the outgoing edge from
+        // `cursor`; if there is none, the requested `toVersion` is unreachable.
+        while (cursor !== toVersion) {
+            if (visited.has(cursor)) {
+                throw new Error(`MigrationRegistry: cycle detected at schema '${schemaName}' version '${cursor}' while resolving ${fromVersion} → ${toVersion}`);
+            }
+            visited.add(cursor);
+            const next = perSchema.get(cursor);
+            if (!next) {
+                throw new Error(`MigrationRegistry: no path from ${fromVersion} to ${toVersion} for schema '${schemaName}' (stuck at '${cursor}')`);
+            }
+            chain.push(next.migrate);
+            cursor = next.toVersion;
+        }
+        return chain;
+    }
+    return { register, resolve };
+}
+/**
+ * Resolve the migration chain for `schemaName` from `currentVersion` to
+ * `targetVersion` and apply each step in order to `data`. Returns the final
+ * migrated data. When `currentVersion === targetVersion` the input is
+ * returned unchanged (no allocation, no registry lookup).
+ *
+ * Throws when no migration path exists (`registry.resolve` propagates).
+ */
+export function runMigrations(registry, schemaName, currentVersion, targetVersion, data) {
+    if (currentVersion === targetVersion)
+        return data;
+    const chain = registry.resolve(schemaName, currentVersion, targetVersion);
+    let cursor = data;
+    for (const step of chain) {
+        cursor = step(cursor);
+    }
+    return cursor;
+}
+//# sourceMappingURL=schema-migrations.js.map

package/dist/schema-migrations.js.map

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

package/dist/schema-validator.d.ts

@@ -0,0 +1,76 @@
+import type { ErrorObject } from "ajv";
+import { type MigrationRegistry } from "./schema-migrations.js";
+/**
+ * Error class for validation failures.
+ * Contains the original AJV errors and a formatted message.
+ */
+export declare class ValidationError extends Error {
+    readonly label: string;
+    readonly errors: ErrorObject[];
+    constructor(label: string, errors: ErrorObject[]);
+}
+/**
+ * Validate data against a JSON Schema object.
+ * Throws ValidationError with formatted error messages on failure.
+ * Returns the validated data on success (pass-through).
+ *
+ * `$ref` to any pre-registered framework schema (URN form
+ * `pi-context://schemas/<name>`) resolves synchronously because those schemas
+ * were added to the shared AJV instance at module init.
+ *
+ * When the supplied schema carries an `$id` that already matches a registered
+ * schema on this AJV instance (e.g. the framework `config` / `relations`
+ * schemas pre-registered above), the cached compiled validator is reused
+ * rather than re-adding the schema — re-adding a duplicate `$id` throws
+ * "schema with key or id ... already exists".
+ */
+export declare function validate(schema: Record<string, unknown>, data: unknown, label: string): unknown;
+/**
+ * Validate that `schema` itself is a structurally-valid JSON Schema.
+ * Routes through AJV's bundled draft-07 meta-schema via `ajv.validateSchema`,
+ * which is the canonical "is this a schema?" check on the same AJV instance
+ * already in use for data validation. Throws `ValidationError` listing every
+ * meta-schema violation when the schema is malformed (e.g. unknown keyword
+ * combinations, invalid `type` value, malformed `properties`). Returns the
+ * input on success (pass-through, mirrors `validate`).
+ *
+ * Reusing the module-internal `ajv` instance is intentional per the rebuild
+ * arc — the schema-write surface (FGAP-011) must not stand up a parallel AJV
+ * instance with diverging strictness / format settings.
+ */
+export declare function validateSchemaAgainstMeta(schema: unknown, label: string): unknown;
+/**
+ * Load a JSON Schema from a file path and validate data against it.
+ * Throws if the schema file doesn't exist or is invalid JSON.
+ * Throws ValidationError on validation failure.
+ */
+export declare function validateFromFile(schemaPath: string, data: unknown, label: string): unknown;
+/**
+ * Migration-aware block validation (FGAP-006 read-time migration surface).
+ *
+ * Aim: read a block file from disk, compare its declared `schema_version`
+ * against the framework schema's `version`, run any registered migrations
+ * forward via `runMigrations`, then validate the migrated data against the
+ * current schema. This is the single entry point that lets a project on an
+ * older block format keep loading after a schema bump, without rewriting the
+ * file on disk.
+ *
+ * Behaviour:
+ *   - `cwd` resolves to `<contextDir>/schemas/<schemaName>.schema.json` for
+ *     the schema; user-state schemas under `.project/schemas/` win over
+ *     framework schemas because that path is computed relative to `cwd`.
+ *   - `data.schema_version` is read off the supplied data when present. When
+ *     it is missing, the data is validated as-is (no migration attempted) —
+ *     pre-FGAP-006 blocks have no version field and should pass through.
+ *   - `registry` is optional; when omitted and the versions differ, the
+ *     function throws (no chain to apply).
+ *   - On match (`block.schema_version === schema.version`) or missing
+ *     `schema_version` field, no migration runs and the data goes straight
+ *     to `validate()`.
+ *   - The migrated data is what gets validated; the input is not mutated.
+ *
+ * Out of scope: writing the migrated form back to disk — call sites that need
+ * persistence handle that themselves via the block-write surface.
+ */
+export declare function validateBlockWithMigration(cwd: string, schemaName: string, data: unknown, registry?: MigrationRegistry): unknown;
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../src/schema-validator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAIvC,OAAO,EAAE,KAAK,iBAAiB,EAAiB,MAAM,wBAAwB,CAAC;AAsE/E;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;gBAEnB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE;CAOhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAqB/F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAMjF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAgB1F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,0BAA0B,CACzC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,EACb,QAAQ,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAgCT"}

package/dist/schema-validator.js

@@ -0,0 +1,219 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import _Ajv from "ajv";
+import _addFormats from "ajv-formats";
+import { schemaPath as schemaPathHelper } from "./context-dir.js";
+import { runMigrations } from "./schema-migrations.js";
+// Node16 module resolution + CJS interop: default import is the module namespace
+const Ajv = _Ajv.default ?? _Ajv;
+const addFormats = _addFormats.default ?? _addFormats;
+const ajv = new Ajv({ allErrors: true, strict: false });
+addFormats(ajv);
+/**
+ * Pre-register the eight framework schemas (`config`, `relations`, plus the
+ * six FGAP-016 shared enums: priority, status, severity, source, layer,
+ * verification-method) at AJV-instance construction so cross-schema `$ref`
+ * to `pi-context://schemas/<name>` resolves synchronously without an async
+ * `loadSchema` hook. Pre-registration also makes the URN identity surface
+ * (FGAP-006 closure) usable from any caller of this module without each
+ * caller restating the schemas.
+ *
+ * Pre-registration is best-effort: if a schema file is missing or malformed
+ * (which would only happen during local dev with a half-applied edit), the
+ * load throws synchronously at module init — the failure surfaces immediately
+ * rather than as a confusing late `$ref` resolution error.
+ *
+ * The schema directory is resolved relative to this file, which means the
+ * pre-registration works the same way whether the package is consumed from
+ * source (via tsx) or from `dist/` post-build, because the schemas/ directory
+ * sits one level above either `src/` or `dist/`.
+ */
+const FRAMEWORK_SCHEMA_NAMES = [
+    "config",
+    "relations",
+    "bootstrap",
+    "priority",
+    "status",
+    "severity",
+    "source",
+    "layer",
+    "verification-method",
+];
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// `__dirname` points at either `<pkg>/src/` (tsx) or `<pkg>/dist/` (built).
+// Either way, `../schemas/` lands at `<pkg>/schemas/` because both `src/` and
+// `dist/` are direct children of the package root.
+const SCHEMAS_ROOT = path.resolve(__dirname, "..", "schemas");
+for (const name of FRAMEWORK_SCHEMA_NAMES) {
+    const schemaPath = path.join(SCHEMAS_ROOT, `${name}.schema.json`);
+    if (!fs.existsSync(schemaPath)) {
+        throw new Error(`schema-validator: framework schema missing at module init: ${schemaPath}`);
+    }
+    const raw = fs.readFileSync(schemaPath, "utf-8");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`schema-validator: failed to parse framework schema ${schemaPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // addSchema is idempotent when the same key is registered twice with
+    // identical content, but we guard anyway so reloads in test contexts
+    // (which they are not currently doing, but might in future) do not throw
+    // on duplicate-id errors.
+    const id = parsed.$id;
+    if (id && ajv.getSchema(id)) {
+        continue;
+    }
+    ajv.addSchema(parsed, id);
+}
+/**
+ * Error class for validation failures.
+ * Contains the original AJV errors and a formatted message.
+ */
+export class ValidationError extends Error {
+    label;
+    errors;
+    constructor(label, errors) {
+        const details = errors.map((e) => `${e.instancePath || ""}: ${e.message}`).join("; ");
+        super(`Validation failed for ${label}: ${details}`);
+        this.name = "ValidationError";
+        this.label = label;
+        this.errors = errors;
+    }
+}
+/**
+ * Validate data against a JSON Schema object.
+ * Throws ValidationError with formatted error messages on failure.
+ * Returns the validated data on success (pass-through).
+ *
+ * `$ref` to any pre-registered framework schema (URN form
+ * `pi-context://schemas/<name>`) resolves synchronously because those schemas
+ * were added to the shared AJV instance at module init.
+ *
+ * When the supplied schema carries an `$id` that already matches a registered
+ * schema on this AJV instance (e.g. the framework `config` / `relations`
+ * schemas pre-registered above), the cached compiled validator is reused
+ * rather than re-adding the schema — re-adding a duplicate `$id` throws
+ * "schema with key or id ... already exists".
+ */
+export function validate(schema, data, label) {
+    const id = typeof schema.$id === "string" ? schema.$id : undefined;
+    let valid;
+    let errors;
+    if (id) {
+        const cached = ajv.getSchema(id);
+        if (cached) {
+            valid = cached(data);
+            errors = cached.errors;
+        }
+        else {
+            valid = ajv.validate(schema, data);
+            errors = ajv.errors;
+        }
+    }
+    else {
+        valid = ajv.validate(schema, data);
+        errors = ajv.errors;
+    }
+    if (!valid) {
+        throw new ValidationError(label, errors ?? []);
+    }
+    return data;
+}
+/**
+ * Validate that `schema` itself is a structurally-valid JSON Schema.
+ * Routes through AJV's bundled draft-07 meta-schema via `ajv.validateSchema`,
+ * which is the canonical "is this a schema?" check on the same AJV instance
+ * already in use for data validation. Throws `ValidationError` listing every
+ * meta-schema violation when the schema is malformed (e.g. unknown keyword
+ * combinations, invalid `type` value, malformed `properties`). Returns the
+ * input on success (pass-through, mirrors `validate`).
+ *
+ * Reusing the module-internal `ajv` instance is intentional per the rebuild
+ * arc — the schema-write surface (FGAP-011) must not stand up a parallel AJV
+ * instance with diverging strictness / format settings.
+ */
+export function validateSchemaAgainstMeta(schema, label) {
+    const valid = ajv.validateSchema(schema);
+    if (valid !== true) {
+        throw new ValidationError(label, ajv.errors ?? []);
+    }
+    return schema;
+}
+/**
+ * Load a JSON Schema from a file path and validate data against it.
+ * Throws if the schema file doesn't exist or is invalid JSON.
+ * Throws ValidationError on validation failure.
+ */
+export function validateFromFile(schemaPath, data, label) {
+    let content;
+    try {
+        content = fs.readFileSync(schemaPath, "utf-8");
+    }
+    catch {
+        throw new Error(`Schema file not found: ${schemaPath}`);
+    }
+    let schema;
+    try {
+        schema = JSON.parse(content);
+    }
+    catch (err) {
+        throw new Error(`Invalid JSON in schema file: ${schemaPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return validate(schema, data, label);
+}
+/**
+ * Migration-aware block validation (FGAP-006 read-time migration surface).
+ *
+ * Aim: read a block file from disk, compare its declared `schema_version`
+ * against the framework schema's `version`, run any registered migrations
+ * forward via `runMigrations`, then validate the migrated data against the
+ * current schema. This is the single entry point that lets a project on an
+ * older block format keep loading after a schema bump, without rewriting the
+ * file on disk.
+ *
+ * Behaviour:
+ *   - `cwd` resolves to `<contextDir>/schemas/<schemaName>.schema.json` for
+ *     the schema; user-state schemas under `.project/schemas/` win over
+ *     framework schemas because that path is computed relative to `cwd`.
+ *   - `data.schema_version` is read off the supplied data when present. When
+ *     it is missing, the data is validated as-is (no migration attempted) —
+ *     pre-FGAP-006 blocks have no version field and should pass through.
+ *   - `registry` is optional; when omitted and the versions differ, the
+ *     function throws (no chain to apply).
+ *   - On match (`block.schema_version === schema.version`) or missing
+ *     `schema_version` field, no migration runs and the data goes straight
+ *     to `validate()`.
+ *   - The migrated data is what gets validated; the input is not mutated.
+ *
+ * Out of scope: writing the migrated form back to disk — call sites that need
+ * persistence handle that themselves via the block-write surface.
+ */
+export function validateBlockWithMigration(cwd, schemaName, data, registry) {
+    const schemaPath = schemaPathHelper(cwd, schemaName);
+    if (!fs.existsSync(schemaPath)) {
+        throw new Error(`validateBlockWithMigration: schema file not found at ${schemaPath}`);
+    }
+    let schema;
+    try {
+        schema = JSON.parse(fs.readFileSync(schemaPath, "utf-8"));
+    }
+    catch (err) {
+        throw new Error(`validateBlockWithMigration: invalid JSON in ${schemaPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const schemaVersion = typeof schema.version === "string" ? schema.version : undefined;
+    const blockVersion = data && typeof data === "object" && "schema_version" in data
+        ? data.schema_version
+        : undefined;
+    let toValidate = data;
+    if (schemaVersion && blockVersion && schemaVersion !== blockVersion) {
+        if (!registry) {
+            throw new Error(`validateBlockWithMigration: block at ${schemaName} declares schema_version '${blockVersion}' but schema is at '${schemaVersion}' and no MigrationRegistry was supplied`);
+        }
+        toValidate = runMigrations(registry, schemaName, blockVersion, schemaVersion, data);
+    }
+    return validate(schema, toValidate, schemaName);
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/schema-validator.js.map

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