@massa-ai/core 1.2.1

package/dist/services/structural/resolvers/typescript.js

@@ -0,0 +1,370 @@
+import path from "node:path";
+import { StructuralFqnRegistry, normalizeStructuralFile, } from "../fqn-codec.js";
+export const TYPESCRIPT_RESOLVER_VERSION = "1.0.0";
+const DIALECT_PROBES = Object.freeze({
+    typescript: ["", ".ts", ".tsx", ".js", ".jsx", "/index.ts", "/index.tsx", "/index.js", "/index.jsx"],
+    tsx: ["", ".ts", ".tsx", ".js", ".jsx", "/index.ts", "/index.tsx", "/index.js", "/index.jsx"],
+    javascript: ["", ".js", ".jsx", ".ts", ".tsx", "/index.js", "/index.jsx", "/index.ts", "/index.tsx"],
+    jsx: ["", ".js", ".jsx", ".ts", ".tsx", "/index.js", "/index.jsx", "/index.ts", "/index.tsx"],
+    sfc: ["", ".ts", ".tsx", ".js", ".jsx", "/index.ts", "/index.tsx", "/index.js", "/index.jsx"],
+    python: ["", ".py", "/__init__.py"], ruby: ["", ".rb"], php: ["", ".php"],
+    "lua-luajit": ["", ".lua"],
+    c: ["", ".c", ".h"], "header-default-c": ["", ".c", ".h"],
+    cpp: ["", ".cpp", ".hpp", ".h"], header: ["", ".cpp", ".hpp", ".h"], "header-cpp": ["", ".cpp", ".hpp", ".h"],
+    go: ["", ".go"], rust: ["", ".rs"], zig: ["", ".zig"],
+    java: ["", ".java"], kotlin: ["", ".kt", ".kts"], "kotlin-script": ["", ".kt", ".kts"],
+    scala: ["", ".scala"], csharp: ["", ".cs"], swift: ["", ".swift"], dart: ["", ".dart"],
+    elixir: ["", ".ex", ".exs"], "elixir-script": ["", ".ex", ".exs"], erlang: ["", ".erl"],
+    clojure: ["", ".clj"], ocaml: ["", ".ml"], haskell: ["", ".hs"],
+});
+function candidates(identities) {
+    return Object.freeze(identities.map((identity) => Object.freeze({
+        fqn: identity.fqn,
+        file: identity.file,
+        name: identity.name,
+        displayName: identity.displayName,
+        qualifiedName: identity.qualifiedName,
+        kind: identity.kind,
+        signatureHash: identity.signatureHash,
+    })).sort((left, right) => {
+        for (const [a, b] of [
+            [left.file, right.file],
+            [left.qualifiedName, right.qualifiedName],
+            [left.kind, right.kind],
+            [left.signatureHash, right.signatureHash],
+            [left.fqn, right.fqn],
+        ]) {
+            if (a < b)
+                return -1;
+            if (a > b)
+                return 1;
+        }
+        return 0;
+    }));
+}
+function outcome(reference, matches, source) {
+    const unique = [...new Map(matches.map((match) => [match.identity.fqn, match])).values()];
+    if (unique.length === 0)
+        return undefined;
+    if (unique.length === 1) {
+        const identity = unique[0].identity;
+        return Object.freeze({ status: "resolved", fqn: identity.fqn, identity, source });
+    }
+    return Object.freeze({
+        status: "ambiguous",
+        name: reference.name,
+        ...(reference.qualifier ? { qualifier: reference.qualifier } : {}),
+        candidates: candidates(unique.map((match) => match.identity)),
+    });
+}
+function normalizedReference(reference) {
+    if (reference.target.status === "resolved") {
+        return Object.freeze({
+            kind: reference.kind,
+            span: reference.span,
+            existingFqn: reference.target.fqn,
+            name: reference.target.fqn,
+            ...(reference.lexicalScope ? { lexicalScope: reference.lexicalScope.normalize("NFC").trim() } : {}),
+        });
+    }
+    const rawName = reference.target.name.normalize("NFC").trim();
+    const name = rawName.startsWith("#") ? `%23${rawName.slice(1)}` : rawName;
+    const qualifier = reference.target.qualifier?.normalize("NFC").trim();
+    if (!name)
+        throw new TypeError("reference name must not be empty");
+    if (reference.target.qualifier !== undefined && !qualifier)
+        throw new TypeError("reference qualifier must not be empty");
+    const lexicalScope = reference.lexicalScope?.normalize("NFC").trim();
+    return Object.freeze({
+        kind: reference.kind,
+        span: reference.span,
+        name,
+        ...(qualifier ? { qualifier } : {}),
+        ...(lexicalScope ? { lexicalScope } : {}),
+    });
+}
+function indexDefinitions(definitions) {
+    const registry = new StructuralFqnRegistry();
+    const indexed = definitions.map((definition) => {
+        const name = definition.identity.name.startsWith("#") ? `%23${definition.identity.name.slice(1)}` : definition.identity.name;
+        const qualifiedName = definition.identity.qualifiedName.split(".").map((part) => part.startsWith("#") ? `%23${part.slice(1)}` : part).join(".");
+        const identity = definition.resolvedIdentity ?? registry.register({ ...definition.identity, name, qualifiedName });
+        return Object.freeze({
+            identity,
+            arity: definition.identity.arity,
+            exported: definition.exported,
+            defaultExport: definition.defaultExport === true,
+        });
+    });
+    return { registry, definitions: Object.freeze(indexed) };
+}
+function candidateKind(reference, definition) {
+    if (reference.kind === "type_ref" || reference.kind === "extend" || reference.kind === "implement") {
+        return ["class", "interface", "trait", "enum", "type", "type_parameter"].includes(definition.identity.kind);
+    }
+    if (reference.kind === "call" || reference.kind === "data_flow" || reference.kind === "http_call") {
+        return ["function", "method", "constructor", "class", "field", "variable", "constant", "export"].includes(definition.identity.kind);
+    }
+    return false;
+}
+function probe(base, known, dialect = "typescript") {
+    const bases = /\.[cm]?jsx?$/u.test(base)
+        ? [base.replace(/\.[cm]?jsx?$/u, ".ts"), base.replace(/\.[cm]?jsx?$/u, ".tsx"), base]
+        : [base];
+    for (const candidateBase of bases)
+        for (const suffix of DIALECT_PROBES[dialect] ?? [""]) {
+            const value = path.posix.normalize(`${candidateBase}${suffix}`);
+            if (!value.startsWith("../") && value !== ".." && known.has(value))
+                return value;
+        }
+    return undefined;
+}
+export function resolveStructuralSpecifier(specifier, fromFile, build, dialect = "typescript") {
+    const known = new Set(build.knownFiles.map(normalizeStructuralFile));
+    if (specifier.startsWith("./") || specifier.startsWith("../")) {
+        return probe(path.posix.join(path.posix.dirname(fromFile), specifier), known, dialect);
+    }
+    const aliases = build.pathAliasesByFile?.[normalizeStructuralFile(fromFile)] ?? build.pathAliases ?? [];
+    for (const alias of aliases) {
+        const star = alias.pattern.indexOf("*");
+        let capture;
+        if (star < 0) {
+            if (specifier !== alias.pattern)
+                continue;
+            capture = "";
+        }
+        else {
+            const prefix = alias.pattern.slice(0, star);
+            const suffix = alias.pattern.slice(star + 1);
+            if (!specifier.startsWith(prefix) || !specifier.endsWith(suffix))
+                continue;
+            capture = specifier.slice(prefix.length, specifier.length - suffix.length);
+        }
+        for (const target of alias.targets) {
+            const resolved = probe(target.replace("*", capture), known, dialect);
+            if (resolved)
+                return resolved;
+        }
+    }
+    return undefined;
+}
+export function matchesStructuralPathAlias(specifier, aliases) {
+    return aliases.some((alias) => {
+        const star = alias.pattern.indexOf("*");
+        if (star < 0)
+            return specifier === alias.pattern;
+        const prefix = alias.pattern.slice(0, star);
+        const suffix = alias.pattern.slice(star + 1);
+        return specifier.startsWith(prefix) && specifier.endsWith(suffix) &&
+            specifier.length >= prefix.length + suffix.length;
+    });
+}
+function exportedMatches(file, sought, defaultOnly, definitions, build, visited = new Set()) {
+    const key = `${file}\0${sought}\0${defaultOnly}`;
+    if (visited.has(key))
+        return [];
+    visited.add(key);
+    const direct = definitions.filter((definition) => definition.identity.file === file && definition.exported && (defaultOnly
+        ? definition.defaultExport
+        : definition.identity.qualifiedName === sought));
+    const concrete = direct.filter((definition) => definition.identity.kind !== "export");
+    if (concrete.length > 0) {
+        if (!defaultOnly)
+            return concrete;
+        const namedDefault = concrete.filter((definition) => definition.identity.name !== "default");
+        return namedDefault.length > 0 ? namedDefault : concrete;
+    }
+    const forwarded = [];
+    for (const reexport of build.importsByFile?.[file] ?? []) {
+        if (reexport.form !== "esm_re_export")
+            continue;
+        const targetFile = resolveStructuralSpecifier(reexport.specifier, file, build);
+        if (!targetFile)
+            continue;
+        for (const binding of reexport.bindings) {
+            if (binding.local !== sought && binding.imported !== "*")
+                continue;
+            forwarded.push(...exportedMatches(targetFile, binding.imported === "*" ? sought : binding.imported, defaultOnly || binding.imported === "default", definitions, build, visited));
+        }
+    }
+    if (forwarded.length > 0)
+        return forwarded;
+    if (!defaultOnly)
+        return direct;
+    const namedDefault = direct.filter((definition) => definition.identity.name !== "default");
+    return namedDefault.length > 0 ? namedDefault : direct;
+}
+// require()-style imports can rebind the same local name at a narrower scope
+// (e.g. a function-scoped `const lib = require("./b")` shadowing a module-scope
+// `const lib = require("./a")`). Only the nearest preceding require should claim
+// a reference; otherwise inner-scope member access resolves to the wrong module.
+// Only require-style forms are shadowers — ESM/typed redeclarations are illegal
+// in JS/TS, so an esm_import with the same local name can't shadow. Lexical-scope
+// tracking would be exact, but resolver definitions carry no span, so this
+// positional approximation handles the common inner-shadow pattern.
+const REQUIRE_IMPORT_FORMS = new Set(["commonjs_require", "dynamic_import", "ruby_require", "lua_require"]);
+function importedMatches(file, reference, definitions, build) {
+    const matches = [];
+    let claimed = false;
+    for (const imported of file.imports) {
+        if (!["esm_import", "commonjs_require", "dynamic_import", "python_import", "ruby_require", "php_use", "lua_require", "c_include", "cpp_include", "go_import", "rust_use", "zig_import", "java_import", "java_static_import", "kotlin_import", "scala_import", "dart_import", "elixir_alias", "elixir_import", "elixir_require", "elixir_use", "erlang_import", "clojure_require", "clojure_import", "ocaml_open", "ocaml_include", "ocaml_module_alias", "haskell_import"].includes(imported.form))
+            continue;
+        const typeEdge = reference.kind === "type_ref" || reference.kind === "extend" || reference.kind === "implement";
+        for (const binding of imported.bindings) {
+            let sought;
+            let defaultOnly = false;
+            const qualifier = reference.qualifier?.split(".") ?? [];
+            if (binding.imported === "*" && qualifier[0] === binding.local) {
+                const member = [...qualifier.slice(1), reference.name].join(".");
+                sought = ["elixir_alias", "clojure_require", "haskell_import"].includes(imported.form)
+                    ? `${imported.specifier.replaceAll("/", ".")}.${member}`
+                    : member;
+            }
+            else if (binding.imported === "default") {
+                if (qualifier[0] === binding.local)
+                    sought = [...qualifier.slice(1), reference.name].join(".");
+                else if (!reference.qualifier && reference.name === binding.local)
+                    defaultOnly = true;
+                else
+                    continue;
+            }
+            else if (!reference.qualifier && reference.name === binding.local) {
+                sought = binding.imported;
+            }
+            else {
+                continue;
+            }
+            claimed = true;
+            if (REQUIRE_IMPORT_FORMS.has(imported.form) && imported.span.startByte <= reference.span.startByte) {
+                let shadowed = false;
+                for (const candidate of file.imports) {
+                    if (candidate === imported || !REQUIRE_IMPORT_FORMS.has(candidate.form))
+                        continue;
+                    if (candidate.span.startByte <= reference.span.startByte &&
+                        candidate.span.startByte > imported.span.startByte &&
+                        candidate.bindings.some((b) => b.local === binding.local)) {
+                        shadowed = true;
+                        break;
+                    }
+                }
+                if (shadowed)
+                    continue;
+            }
+            if ((imported.typeOnly || binding.typeOnly) && !typeEdge)
+                continue;
+            const importedFile = resolveStructuralSpecifier(imported.specifier, file.file, build, file.dialect) ??
+                (["python_import", "ruby_require", "php_use", "lua_require", "c_include", "cpp_include", "go_import", "rust_use", "zig_import", "java_import", "java_static_import", "kotlin_import", "scala_import", "dart_import", "elixir_alias", "elixir_import", "elixir_require", "elixir_use", "erlang_import", "clojure_require", "clojure_import", "ocaml_open", "ocaml_include", "ocaml_module_alias", "haskell_import"].includes(imported.form)
+                    ? probe(imported.specifier.replace(/^\.\//u, ""), new Set(build.knownFiles.map(normalizeStructuralFile)), file.dialect)
+                    : undefined);
+            if (!importedFile)
+                continue;
+            const esmDefaultMember = imported.form === "esm_import" &&
+                binding.imported === "default" && qualifier[0] === binding.local;
+            if (esmDefaultMember && sought !== undefined) {
+                const owners = exportedMatches(importedFile, "default", true, definitions, build);
+                for (const owner of owners) {
+                    const ownerMember = `${owner.identity.qualifiedName}.${sought}`;
+                    matches.push(...definitions.filter((definition) => definition.identity.file === owner.identity.file &&
+                        definition.exported &&
+                        definition.identity.qualifiedName === ownerMember));
+                }
+                continue;
+            }
+            if (defaultOnly)
+                matches.push(...exportedMatches(importedFile, "default", true, definitions, build));
+            else if (sought !== undefined)
+                matches.push(...exportedMatches(importedFile, sought, false, definitions, build).filter((definition) => binding.arity === undefined || definition.arity === binding.arity));
+        }
+    }
+    return { matches, claimed };
+}
+function sameFileMatches(file, reference, definitions) {
+    const local = definitions.filter((definition) => definition.identity.file === file);
+    if (reference.qualifier && reference.qualifier !== "this") {
+        const exact = `${reference.qualifier}.${reference.name}`;
+        return local.filter((definition) => definition.identity.qualifiedName === exact);
+    }
+    const lexical = reference.lexicalScope?.split(".").filter(Boolean) ?? [];
+    if (lexical.length > 0)
+        lexical.pop();
+    for (let length = lexical.length; length >= 0; length -= 1) {
+        const prefix = lexical.slice(0, length).join(".");
+        const exact = prefix ? `${prefix}.${reference.name}` : reference.name;
+        const matches = local.filter((definition) => definition.identity.qualifiedName === exact);
+        if (matches.length > 0)
+            return matches;
+        if (reference.qualifier === "this")
+            break;
+    }
+    return [];
+}
+export const TYPESCRIPT_LANGUAGE_RESOLVER = Object.freeze({
+    version: TYPESCRIPT_RESOLVER_VERSION,
+    dialects: Object.freeze(["typescript", "tsx", "javascript", "jsx"]),
+    resolve(file, rawReference, rawDefinitions, build) {
+        const normalizedFile = normalizeStructuralFile(file.file);
+        const reference = normalizedReference(rawReference);
+        const familyDialects = ["typescript", "tsx", "javascript", "jsx", "sfc"];
+        const scopedDefinitions = familyDialects.includes(file.dialect)
+            ? rawDefinitions.filter((definition) => familyDialects.includes(definition.identity.dialect))
+            : rawDefinitions;
+        const { registry, definitions: allDefinitions } = indexDefinitions(scopedDefinitions);
+        const definitions = allDefinitions.filter((definition) => candidateKind(reference, definition));
+        if (reference.existingFqn) {
+            const prepared = definitions.find((definition) => definition.identity.fqn === reference.existingFqn)?.identity;
+            const exact = prepared ? { found: true, identity: prepared } : registry.resolveModern(reference.existingFqn);
+            return exact.found
+                ? Object.freeze({ status: "resolved", fqn: exact.identity.fqn, identity: exact.identity, source: "exact" })
+                : Object.freeze({ status: "unresolved", name: reference.existingFqn });
+        }
+        const soughtQualified = reference.qualifier ? `${reference.qualifier}.${reference.name}` : reference.name;
+        const local = sameFileMatches(normalizedFile, reference, definitions);
+        const localOutcome = outcome(reference, local, "same_file");
+        if (localOutcome)
+            return localOutcome;
+        const imported = importedMatches({ ...file, file: normalizedFile }, reference, definitions, build);
+        const importOutcome = outcome(reference, imported.matches, "import");
+        if (importOutcome)
+            return importOutcome;
+        if (imported.claimed)
+            return Object.freeze({
+                status: "unresolved",
+                name: reference.name,
+                ...(reference.qualifier ? { qualifier: reference.qualifier } : {}),
+            });
+        const global = definitions.filter((definition) => definition.exported && (reference.qualifier
+            ? definition.identity.qualifiedName === soughtQualified
+            : definition.identity.name === reference.name &&
+                definition.identity.qualifiedName === definition.identity.name));
+        return outcome(reference, global, "global") ?? Object.freeze({
+            status: "unresolved",
+            name: reference.name,
+            ...(reference.qualifier ? { qualifier: reference.qualifier } : {}),
+        });
+    },
+    resolveLegacy(legacyFqn, rawDefinitions) {
+        const { registry, definitions } = indexDefinitions(rawDefinitions);
+        const materialized = definitions.filter((definition) => definition.identity.legacyFqn === legacyFqn);
+        const materializedOutcome = outcome({ kind: "call", span: { startByte: 0, endByte: 0, start: { row: 0, column: 0 }, end: { row: 0, column: 0 } }, name: legacyFqn }, materialized, "legacy");
+        if (materializedOutcome)
+            return materializedOutcome;
+        const result = registry.resolve(legacyFqn);
+        if (result.found) {
+            return Object.freeze({
+                status: "resolved",
+                fqn: result.identity.fqn,
+                identity: result.identity,
+                source: "legacy",
+            });
+        }
+        if (result.ambiguous) {
+            return Object.freeze({
+                status: "ambiguous",
+                name: legacyFqn,
+                candidates: result.candidates,
+            });
+        }
+        return Object.freeze({ status: "unresolved", name: legacyFqn });
+    },
+});
+//# sourceMappingURL=typescript.js.map

package/dist/services/structural/resolvers/typescript.js.map

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

package/dist/services/structural/schema-version.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Schema-ahead guard for persisted structural / checkpoint data.
+ *
+ * Structural identity and checkpoint state embed a schema version on write.
+ * The read paths used to pattern-match (or ignore) the embedded version, which
+ * silently decodes rows written by NEWER code than the running binary — risking
+ * identity drift on the index and unreadable checkpoint state.
+ *
+ * This module centralizes the typed error + the strict-newer comparison so every
+ * read-side guard funnels through one helper. It NEVER throws on equal, older,
+ * missing, or malformed version stamps — those are valid (current row,
+ * forward-compatible old row, legacy pre-version row, or corrupt-but-untouched
+ * payload). Only a STRICTLY-NEWER stored version throws.
+ */
+/** Semantic kinds of versioned payloads that flow through this guard. */
+export type SchemaVersionKind = "fqn" | "checkpoint" | string;
+export interface SchemaAheadContext {
+    readonly stored: string;
+    readonly supported: string;
+    readonly kind: SchemaVersionKind;
+}
+/**
+ * Thrown when persisted data carries a schema version NEWER than the running
+ * code understands. Carries enough context for callers to log / surface which
+ * payload kind drifted and by how much.
+ */
+export declare class SchemaAheadError extends Error {
+    readonly code: "schema_ahead";
+    readonly context: SchemaAheadContext;
+    constructor(context: SchemaAheadContext);
+}
+/**
+ * Assert that `stored` is not strictly newer than `supported`. Throws
+ * `SchemaAheadError` only when the stored version is ahead; passes through
+ * unchanged for equal, older, missing (`""`), or malformed (`"abc"`) stamps.
+ *
+ * Pass `""` (or any non-semver string) for legacy payloads that carry no
+ * version — the guard treats them as unknown and does NOT throw, preserving
+ * forward-compat with pre-version rows.
+ */
+export declare function assertSchemaSupported(kind: SchemaVersionKind, stored: string, supported: string): void;
+//# sourceMappingURL=schema-version.d.ts.map

package/dist/services/structural/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../../../src/services/structural/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,yEAAyE;AACzE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,YAAY,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IACxC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;gBAEzB,OAAO,EAAE,kBAAkB;CAOxC;AA4CD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,IAAI,CAGN"}

package/dist/services/structural/schema-version.js

@@ -0,0 +1,80 @@
+/**
+ * Schema-ahead guard for persisted structural / checkpoint data.
+ *
+ * Structural identity and checkpoint state embed a schema version on write.
+ * The read paths used to pattern-match (or ignore) the embedded version, which
+ * silently decodes rows written by NEWER code than the running binary — risking
+ * identity drift on the index and unreadable checkpoint state.
+ *
+ * This module centralizes the typed error + the strict-newer comparison so every
+ * read-side guard funnels through one helper. It NEVER throws on equal, older,
+ * missing, or malformed version stamps — those are valid (current row,
+ * forward-compatible old row, legacy pre-version row, or corrupt-but-untouched
+ * payload). Only a STRICTLY-NEWER stored version throws.
+ */
+/**
+ * Thrown when persisted data carries a schema version NEWER than the running
+ * code understands. Carries enough context for callers to log / surface which
+ * payload kind drifted and by how much.
+ */
+export class SchemaAheadError extends Error {
+    code = "schema_ahead";
+    context;
+    constructor(context) {
+        super(`schema-ahead: ${context.kind} stored version ${context.stored} is newer than supported ${context.supported}`);
+        this.name = "SchemaAheadError";
+        this.context = context;
+    }
+}
+const SEMVER_PATTERN = /^(\d+)\.(\d+)\.(\d+)$/u;
+/**
+ * Parse a `major.minor.patch` (numeric, no pre-release) version into a tuple.
+ * Returns `null` for anything that is not exactly three non-negative integer
+ * components (legacy / unknown / malformed stamps). The caller treats `null` as
+ * "do not gate" — never throw on unparseable input.
+ */
+function parseSemver(version) {
+    const match = SEMVER_PATTERN.exec(version.trim());
+    if (!match)
+        return null;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    const patch = Number(match[3]);
+    if (!Number.isSafeInteger(major) ||
+        !Number.isSafeInteger(minor) ||
+        !Number.isSafeInteger(patch) ||
+        major < 0 ||
+        minor < 0 ||
+        patch < 0) {
+        return null;
+    }
+    return [major, minor, patch];
+}
+/**
+ * Strict-greater-than semver compare. Returns `false` for any non-semver input
+ * (equal/older/missing/malformed never count as "ahead").
+ */
+function isStrictlyNewer(stored, supported) {
+    const a = parseSemver(stored);
+    const b = parseSemver(supported);
+    if (!a || !b)
+        return false;
+    return (a[0] > b[0] ||
+        (a[0] === b[0] && a[1] > b[1]) ||
+        (a[0] === b[0] && a[1] === b[1] && a[2] > b[2]));
+}
+/**
+ * Assert that `stored` is not strictly newer than `supported`. Throws
+ * `SchemaAheadError` only when the stored version is ahead; passes through
+ * unchanged for equal, older, missing (`""`), or malformed (`"abc"`) stamps.
+ *
+ * Pass `""` (or any non-semver string) for legacy payloads that carry no
+ * version — the guard treats them as unknown and does NOT throw, preserving
+ * forward-compat with pre-version rows.
+ */
+export function assertSchemaSupported(kind, stored, supported) {
+    if (!isStrictlyNewer(stored, supported))
+        return;
+    throw new SchemaAheadError({ stored, supported, kind });
+}
+//# sourceMappingURL=schema-version.js.map

package/dist/services/structural/schema-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.js","sourceRoot":"","sources":["../../../src/services/structural/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,GAAG,cAAuB,CAAC;IAC/B,OAAO,CAAqB;IAErC,YAAY,OAA2B;QACrC,KAAK,CACH,iBAAiB,OAAO,CAAC,IAAI,mBAAmB,OAAO,CAAC,MAAM,4BAA4B,OAAO,CAAC,SAAS,EAAE,CAC9G,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAEhD;;;;;GAKG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC5B,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC5B,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC5B,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC,EACT,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,MAAc,EAAE,SAAiB;IACxD,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,CACL,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACX,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAChD,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAuB,EACvB,MAAc,EACd,SAAiB;IAEjB,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC;QAAE,OAAO;IAChD,MAAM,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/services/structural/source-span.d.ts

@@ -0,0 +1,26 @@
+import type { SourcePoint, SourceSpan } from "./types.js";
+export interface LegacyLineRange {
+    /** One-based inclusive line containing the span start. */
+    lineStart: number;
+    /** One-based inclusive line containing span content. */
+    lineEnd: number;
+}
+/** Byte-addressed index over one immutable snapshot of UTF-8 source. */
+export declare class SourceIndex {
+    #private;
+    constructor(source: string | Buffer);
+    get byteLength(): number;
+    /** Defensive copy: callers cannot mutate indexed source after construction. */
+    sourceBytes(): Buffer;
+    lineStarts(): readonly number[];
+    pointAt(byteOffset: number): SourcePoint;
+    span(startByte: number, endByte: number): SourceSpan;
+    validateSpan(span: SourceSpan): SourceSpan;
+    snippetBytes(span: SourceSpan): Buffer;
+    snippet(span: SourceSpan): string;
+    /** Remap a child-parser span relative to an exact host byte slice. */
+    remapChildSpan(hostSlice: SourceSpan, childSpan: SourceSpan): SourceSpan;
+}
+/** Derive legacy one-based inclusive line fields from an end-exclusive span. */
+export declare function deriveLegacyLineRange(span: SourceSpan): LegacyLineRange;
+//# sourceMappingURL=source-span.d.ts.map

package/dist/services/structural/source-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-span.d.ts","sourceRoot":"","sources":["../../../src/services/structural/source-span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD,wEAAwE;AACxE,qBAAa,WAAW;;gBAIV,MAAM,EAAE,MAAM,GAAG,MAAM;IAcnC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,+EAA+E;IAC/E,WAAW,IAAI,MAAM;IAIrB,UAAU,IAAI,SAAS,MAAM,EAAE;IAI/B,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW;IAaxC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU;IAUpD,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU;IAiB1C,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAKtC,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAIjC,sEAAsE;IACtE,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,UAAU;CA8BzE;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAUvE"}