@massa-ai/core 1.2.1

package/dist/services/structural/symbol-signature.js

@@ -0,0 +1,319 @@
+import { SYMBOL_KINDS } from "./query-pack-registry.js";
+import { text, frozenSpan, field, descendants, symbolName, ancestor, } from "./native-node-helpers.js";
+function symbolKind(captureName, source, node) {
+    const requested = captureName.slice("symbol.".length);
+    if (!SYMBOL_KINDS.has(requested))
+        return null;
+    if (requested === "method" && symbolName(source, node) === "constructor")
+        return "constructor";
+    if (requested === "function" && node.type === "function_definition" &&
+        ancestor(node, "class_specifier"))
+        return "method";
+    if (requested === "namespace" && text(source, node).trimStart().startsWith("module "))
+        return "module";
+    if (requested === "variable") {
+        const value = field(node, "value");
+        if (value?.type === "arrow_function" || value?.type === "function_expression")
+            return "function";
+        const parentText = node.parent ? text(source, node.parent).trimStart() : "";
+        return parentText.startsWith("const ") ? "constant" : "variable";
+    }
+    if (node.type === "type_spec") {
+        const value = field(node, "type");
+        if (value?.type === "struct_type")
+            return "class";
+        if (value?.type === "interface_type")
+            return "interface";
+    }
+    if (node.type === "variable_declaration") {
+        const value = node.namedChildren?.[1];
+        if (value?.type === "struct_declaration")
+            return "class";
+        if (value?.type === "enum_declaration")
+            return "enum";
+    }
+    return requested;
+}
+function leadingDocumentation(source, startByte) {
+    const prefix = source.subarray(0, startByte).toString("utf8");
+    const match = prefix.match(/(?:\/\*\*[\s\S]*?\*\/|(?:\/\/[^\n]*(?:\n|$))+)[\t ]*\r?\n?[\t ]*$/u);
+    return match?.[0].trim();
+}
+function declarationExportWrapper(node) {
+    const wrapper = ancestor(node, "export_statement");
+    if (!wrapper)
+        return undefined;
+    const declaration = field(wrapper, "declaration") ?? field(wrapper, "value");
+    if (declaration === node)
+        return wrapper;
+    if (declaration?.type === "lexical_declaration" && ancestor(node, "lexical_declaration") === declaration)
+        return wrapper;
+    return undefined;
+}
+function normalizedTypeToken(source, node) {
+    return text(source, node).replace(/^\s*:\s*/u, "").trim();
+}
+function signatureOwner(node) {
+    const value = field(node, "value");
+    return value?.type === "arrow_function" || value?.type === "function_expression" ? value : node;
+}
+function structuralSignature(source, draft) {
+    const owner = signatureOwner(draft.node);
+    const body = field(owner, "body");
+    const value = field(draft.node, "value");
+    let endByte = body?.startIndex ?? draft.node.endIndex;
+    if (!body && value && owner === draft.node &&
+        ["variable_declarator", "public_field_definition", "field_definition"].includes(draft.node.type))
+        endByte = value.startIndex;
+    let valuePrefix = "";
+    if (owner !== draft.node) {
+        valuePrefix = text(source, draft.node).slice(0, owner.startIndex - draft.node.startIndex);
+    }
+    // Short-circuit empty bodies before the fingerprint work: when the sliceable
+    // region is empty there is nothing to sign, and the trailing trim/regex chain
+    // would return "" anyway. Skip the wasted computation (cbm b9797ec — don't
+    // compute a signature over nothing). Output is byte-identical to the fall-
+    // through for empty regions; the dedup key is untouched.
+    if (endByte <= owner.startIndex && valuePrefix === "")
+        return "";
+    const raw = `${valuePrefix}${source.subarray(owner.startIndex, endByte).toString("utf8")}`.trim();
+    return raw.replace(/(?:=>|=|\{)\s*$/u, "").replace(/;\s*$/u, "").trim();
+}
+function signatureMaterial(source, draft) {
+    const owner = signatureOwner(draft.node);
+    const callable = ["function", "method", "constructor"].includes(draft.kind);
+    const elixirHead = owner.type === "call" && field(owner, "target") && ["def", "defp", "defmacro", "defmacrop"].includes(text(source, field(owner, "target")))
+        ? owner.namedChildren?.find((node) => node.type === "arguments")?.namedChildren?.find((node) => node.type === "call")
+        : undefined;
+    const parameters = callable ? field(elixirHead ?? owner, "parameters") ?? field(elixirHead ?? owner, "args") ?? field(elixirHead ?? owner, "patterns") ??
+        (elixirHead ? elixirHead.namedChildren?.find((node) => node.type === "arguments") : undefined) ??
+        (owner.type === "class_parameters" ? owner : undefined) ?? descendants(owner).find((node) => ["formal_parameters", "formal_parameter_list", "function_value_parameters", "class_parameters", "parameter_clause", "expr_args", "patterns"].includes(node.type)) : undefined;
+    const parameterTypes = new Set(["parameter", "formal_parameter", "class_parameter", "required_parameter", "optional_formal_parameter"]);
+    const parameterNodes = parameters
+        ? ["expr_args", "arguments", "patterns"].includes(parameters.type)
+            ? (parameters.namedChildren ?? [])
+            : (parameters.namedChildren ?? []).filter((node) => parameterTypes.has(node.type))
+        : callable ? (owner.namedChildren ?? []).filter((node) => parameterTypes.has(node.type)) : [];
+    const typeTokens = [];
+    for (const parameter of parameterNodes) {
+        const typeNode = field(parameter, "type") ?? ["user_type", "type_identifier", "predefined_type", "nullable_type", "identifier"]
+            .map((type) => parameter.namedChildren?.find((node) => node.type === type)).find((node) => Boolean(node));
+        if (typeNode)
+            typeTokens.push(normalizedTypeToken(source, typeNode));
+    }
+    const returnType = field(owner, "return_type") ?? field(owner, "returns") ?? field(draft.node, "type");
+    if (returnType)
+        typeTokens.push(normalizedTypeToken(source, returnType));
+    if (draft.node.type === "type_alias_declaration") {
+        const value = field(draft.node, "value");
+        if (value)
+            typeTokens.push(normalizedTypeToken(source, value));
+    }
+    const knownModifiers = new Set([
+        "abstract", "async", "declare", "default", "export", "get", "override",
+        "private", "protected", "public", "readonly", "set", "static",
+    ]);
+    const modifiers = [];
+    let modifierOwner = draft.node;
+    if (draft.node.type === "variable_declarator") {
+        let current = draft.node.parent ?? undefined;
+        while (current) {
+            if (["field_declaration", "constant_declaration", "event_field_declaration"].includes(current.type)) {
+                modifierOwner = current;
+                break;
+            }
+            if (!["variable_declaration"].includes(current.type))
+                break;
+            current = current.parent ?? undefined;
+        }
+    }
+    const directChildren = owner === modifierOwner
+        ? (modifierOwner.children ?? [])
+        : [...(modifierOwner.children ?? []), ...(owner.children ?? [])];
+    for (const child of directChildren) {
+        if (knownModifiers.has(child.type))
+            modifiers.push(child.type);
+        else if (child.type === "modifiers") {
+            for (const modifier of child.children ?? []) {
+                const value = knownModifiers.has(modifier.type) ? modifier.type : text(source, modifier).trim();
+                if (knownModifiers.has(value))
+                    modifiers.push(value);
+            }
+        }
+        else if (child.type === "accessibility_modifier") {
+            const value = text(source, child).trim();
+            if (knownModifiers.has(value))
+                modifiers.push(value);
+        }
+        else {
+            const value = text(source, child).trim();
+            if (knownModifiers.has(value))
+                modifiers.push(value);
+        }
+    }
+    const exportWrapper = declarationExportWrapper(draft.node);
+    if (exportWrapper && !modifiers.includes("export"))
+        modifiers.push("export");
+    if (exportWrapper && text(source, exportWrapper).trimStart().startsWith("export default") && !modifiers.includes("default")) {
+        modifiers.push("default");
+    }
+    if (draft.kind === "export") {
+        if (!modifiers.includes("export"))
+            modifiers.push("export");
+        if (text(source, draft.node).trimStart().startsWith("export default") && !modifiers.includes("default"))
+            modifiers.push("default");
+    }
+    return Object.freeze({
+        arity: parameterNodes.length,
+        typeTokens: Object.freeze(typeTokens),
+        modifiers: Object.freeze(modifiers.sort()),
+    });
+}
+function buildSymbols(captures, source, index, includeDocumentation, family = "typescript") {
+    const drafts = [];
+    for (const capture of captures) {
+        if (!capture.name.startsWith("symbol."))
+            continue;
+        if (capture.node.type === "property_signature" && capture.node.parent?.type !== "interface_body")
+            continue;
+        const kind = symbolKind(capture.name, source, capture.node);
+        if (capture.node.type === "function_signature" && ancestor(capture.node, "method_signature"))
+            continue;
+        const name = symbolName(source, capture.node);
+        if (!kind || !name)
+            continue;
+        drafts.push({ kind, name, node: capture.node, qualifiedName: name });
+    }
+    for (const capture of captures.filter((item) => item.name === "export.statement")) {
+        const defaultExport = text(source, capture.node).trimStart().startsWith("export default");
+        if (defaultExport) {
+            drafts.push({ kind: "export", name: "default", node: capture.node, qualifiedName: "default" });
+        }
+        if (field(capture.node, "declaration") || field(capture.node, "value"))
+            continue;
+        const specifiers = descendants(capture.node).filter((node) => node.type === "export_specifier");
+        const names = specifiers.map((specifier) => field(specifier, "alias") ?? field(specifier, "name")).filter((node) => Boolean(node));
+        for (const nameNode of names) {
+            const name = text(source, nameNode).normalize("NFC");
+            drafts.push({ kind: "export", name, node: nameNode, qualifiedName: name });
+        }
+    }
+    drafts.sort((left, right) => left.node.startIndex - right.node.startIndex || right.node.endIndex - left.node.endIndex);
+    // Precompute each draft's byte range once. The wrapped capture node's
+    // startIndex/endIndex are getter-backed byte-offset computations; resolving
+    // them inside the O(drafts^2) parent scan re-runs that work on every
+    // comparison. Containment is monotonic, so the precomputed byte ranges
+    // identify the same smallest-enclosing parent.
+    const draftRanges = drafts.map((draft) => ({ start: draft.node.startIndex, end: draft.node.endIndex }));
+    for (let i = 0; i < drafts.length; i += 1) {
+        const draft = drafts[i];
+        const draftRange = draftRanges[i];
+        let parentIndex = -1;
+        for (let j = 0; j < drafts.length; j += 1) {
+            if (j === i)
+                continue;
+            const candidate = drafts[j];
+            if (candidate.kind === "export" || candidate.kind === "constructor")
+                continue;
+            const candidateRange = draftRanges[j];
+            if (candidateRange.start <= draftRange.start && candidateRange.end >= draftRange.end) {
+                if (parentIndex === -1 || candidateRange.end - candidateRange.start < draftRanges[parentIndex].end - draftRanges[parentIndex].start) {
+                    parentIndex = j;
+                }
+            }
+        }
+        draft.qualifiedName = parentIndex >= 0 ? `${drafts[parentIndex].qualifiedName}.${draft.name}` : draft.name;
+    }
+    // Precompute the documentation captures once; the per-draft filter below
+    // would otherwise allocate + scan every capture for every symbol.
+    const documentationCaptures = captures.filter((capture) => capture.name === "documentation");
+    let symbols = drafts.map((draft) => {
+        const nameNode = field(draft.node, "name") ?? field(draft.node, "property") ??
+            (["pair", "block_mapping_pair", "flow_pair"].includes(draft.node.type) ? field(draft.node, "key") : undefined) ??
+            (["atx_heading", "setext_heading"].includes(draft.node.type) ? field(draft.node, "heading_content") : undefined);
+        const documentationStart = draft.node.parent?.type === "export_statement"
+            ? draft.node.parent.startIndex
+            : draft.node.type === "type_spec" && draft.node.parent?.type === "type_declaration"
+                ? draft.node.parent.startIndex
+                : draft.node.startIndex;
+        const capturedDocumentation = documentationCaptures
+            .find((capture) => {
+            if (capture.node.startIndex >= draft.node.startIndex && capture.node.endIndex <= draft.node.endIndex) {
+                return family === "python" && !captures.some((item) => item.name.startsWith("symbol.") && item.node !== draft.node &&
+                    item.node.startIndex <= capture.node.startIndex && item.node.endIndex >= capture.node.endIndex);
+            }
+            if (capture.node.endIndex > documentationStart)
+                return false;
+            for (let offset = capture.node.endIndex; offset < documentationStart; offset += 1) {
+                if (family === "elixir") {
+                    const chained = captures.find((item) => item.name === "documentation" && item.node.startIndex <= offset && item.node.endIndex > offset);
+                    if (chained) {
+                        offset = chained.node.endIndex - 1;
+                        continue;
+                    }
+                }
+                const byte = source[offset];
+                if (byte !== 9 && byte !== 10 && byte !== 13 && byte !== 32)
+                    return false;
+            }
+            return true;
+        });
+        const documentation = includeDocumentation
+            ? capturedDocumentation ? family === "elixir"
+                ? documentationCaptures.filter((item) => item.node.startIndex >= capturedDocumentation.node.startIndex && item.node.endIndex <= documentationStart)
+                    .map((item) => text(source, item.node).trim()).join("\n")
+                : text(source, capturedDocumentation.node).trim() : family === "typescript"
+                ? leadingDocumentation(source, documentationStart)
+                : undefined
+            : undefined;
+        const material = signatureMaterial(source, draft);
+        const scriptingExport = family !== "typescript" && !draft.qualifiedName.includes(".") &&
+            (family !== "java" || material.modifiers.includes("public"));
+        return Object.freeze({
+            kind: draft.kind,
+            name: draft.name,
+            qualifiedName: draft.qualifiedName,
+            span: frozenSpan(index, draft.node.startIndex, draft.node.endIndex),
+            ...(nameNode ? { selectionSpan: frozenSpan(index, nameNode.startIndex, nameNode.endIndex) } : {}),
+            exported: scriptingExport || draft.kind === "export" || Boolean(declarationExportWrapper(draft.node)) || text(source, draft.node).trimStart().startsWith("export "),
+            defaultExport: draft.name === "default" ||
+                text(source, declarationExportWrapper(draft.node) ?? draft.node).trimStart().startsWith("export default"),
+            ...(documentation ? { documentation } : {}),
+            signature: structuralSignature(source, draft),
+            signatureMaterial: material,
+        });
+    });
+    if (["erlang", "clojure", "haskell"].includes(family ?? "")) {
+        const module = symbols.find((symbol) => symbol.kind === "module");
+        if (module)
+            symbols = symbols.map((symbol) => symbol === module || symbol.qualifiedName.includes(".")
+                ? symbol
+                : Object.freeze({ ...symbol, qualifiedName: `${module.name}.${symbol.qualifiedName}` }));
+    }
+    if (family === "markdown") {
+        const stack = [];
+        symbols = symbols.map((symbol, position) => {
+            const draft = drafts[position];
+            const marker = draft.node.children?.find((child) => /^(?:atx_h[1-6]_marker|setext_h[12]_underline)$/u.test(child.type));
+            const match = marker?.type.match(/h([1-6])/u);
+            const level = Number(match?.[1] ?? (marker?.type.includes("h2") ? 2 : 1));
+            while (stack.length && stack.at(-1).level >= level)
+                stack.pop();
+            const qualifiedName = stack.length ? `${stack.at(-1).qualifiedName}.${symbol.name}` : symbol.name;
+            stack.push({ level, qualifiedName });
+            return Object.freeze({ ...symbol, qualifiedName });
+        });
+    }
+    const seen = new Set();
+    return Object.freeze(symbols.filter((symbol) => {
+        const key = family === "haskell"
+            ? `${symbol.kind}\0${symbol.qualifiedName}`
+            : `${symbol.kind}\0${symbol.qualifiedName}\0${symbol.span.startByte}\0${symbol.span.endByte}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    }));
+}
+export { symbolKind, leadingDocumentation, declarationExportWrapper, normalizedTypeToken, signatureOwner, structuralSignature, signatureMaterial, buildSymbols };
+//# sourceMappingURL=symbol-signature.js.map

package/dist/services/structural/symbol-signature.js.map

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

package/dist/services/structural/types.d.ts

@@ -0,0 +1,138 @@
+/** Canonical transport taxonomy. Additive changes require a version bump. */
+export { STRUCTURAL_SYMBOL_KINDS, type StructuralSymbolKind, } from "@massa-ai/shared";
+import type { StructuralSymbolKind } from "@massa-ai/shared";
+/** Canonical structural edge taxonomy. Additive changes require a version bump. */
+export declare const STRUCTURAL_EDGE_KINDS: readonly ["call", "data_flow", "type_ref", "extend", "implement", "import", "http_call", "emit", "listen"];
+export type StructuralEdgeKind = (typeof STRUCTURAL_EDGE_KINDS)[number];
+export declare const STRUCTURAL_TAXONOMY_VERSION = "1.0.0";
+export declare const SOURCE_SPAN_SCHEMA_VERSION = "1.0.0";
+export declare const STRUCTURAL_FQN_SCHEMA_VERSION = "1.0.0";
+/** Zero-based Tree-sitter coordinate. Columns and byte offsets are UTF-8 based. */
+export interface SourcePoint {
+    row: number;
+    column: number;
+}
+/** End-exclusive source range. Offsets address the original UTF-8 source bytes. */
+export interface SourceSpan {
+    startByte: number;
+    endByte: number;
+    start: SourcePoint;
+    end: SourcePoint;
+}
+export interface NormalizedStructuralSymbol {
+    kind: StructuralSymbolKind;
+    name: string;
+    qualifiedName: string;
+    span: SourceSpan;
+    selectionSpan?: SourceSpan;
+    exported: boolean;
+    /** True only for the declaration selected by an `export default` wrapper. */
+    defaultExport: boolean;
+    documentation?: string;
+    signature?: string;
+    /** Syntax-owned inputs consumed by the FQN codec after native trees are deleted. */
+    signatureMaterial: Readonly<{
+        readonly arity: number;
+        readonly typeTokens: readonly string[];
+        readonly modifiers: readonly string[];
+    }>;
+}
+export interface UnresolvedStructuralTarget {
+    status: "unresolved";
+    name: string;
+    qualifier?: string;
+}
+export interface ResolvedStructuralTarget {
+    status: "resolved";
+    fqn: string;
+}
+export type StructuralTarget = ResolvedStructuralTarget | UnresolvedStructuralTarget;
+export interface NormalizedStructuralEdge {
+    kind: StructuralEdgeKind;
+    span: SourceSpan;
+    sourceFqn?: string;
+    target: StructuralTarget;
+    paramIndex?: number;
+    metadata?: Readonly<Record<string, unknown>>;
+}
+export interface NormalizedStructuralImport {
+    form: "esm_import" | "esm_re_export" | "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" | "csharp_using" | "swift_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";
+    specifier: string;
+    span: SourceSpan;
+    bindings: readonly Readonly<{
+        readonly imported: string;
+        readonly local: string;
+        readonly typeOnly: boolean;
+        readonly arity?: number;
+    }>[];
+    /** Compatibility projection containing local binding names only. */
+    names: readonly string[];
+    typeOnly: boolean;
+}
+export interface NormalizedStructure {
+    symbols: readonly NormalizedStructuralSymbol[];
+    edges: readonly NormalizedStructuralEdge[];
+    imports: readonly NormalizedStructuralImport[];
+}
+export declare const STRUCTURAL_CAPABILITIES: readonly ["declarations", "documentation", "imports", "type_relations", "calls", "data_flow", "specialized_edges"];
+export type StructuralCapability = (typeof STRUCTURAL_CAPABILITIES)[number];
+export type StructuralCapabilityRequirement = "required" | "forbidden" | "unsupported";
+export type StructuralCapabilityTier = "structure" | "dependencies" | "flow";
+export type MixedLanguagePolicy = "none" | "vue" | "markdown";
+export interface GrammarArtifact {
+    packageName: string;
+    version: string;
+    /** Named export, or `default` when the package requires ESM default interop. */
+    exportName?: string;
+}
+export interface LanguageManifestEntry {
+    extension: string;
+    language: string;
+    dialect: string;
+    grammarArtifact: GrammarArtifact;
+    queryPackVersion: string;
+    resolverVersion: string;
+    capabilityTier: StructuralCapabilityTier;
+    capabilities: Readonly<Record<StructuralCapability, StructuralCapabilityRequirement>>;
+    mixedLanguagePolicy: MixedLanguagePolicy;
+    /** Alternate grammar used only when deterministic importer/build evidence selects it. */
+    alternateGrammarArtifact?: GrammarArtifact;
+}
+export type ParseDiagnosticSeverity = "recovered" | "error";
+export type StructuralFailureKind = "grammar" | "query" | "abi" | "infrastructure";
+export interface ParseDiagnostic {
+    code: string;
+    severity: ParseDiagnosticSeverity;
+    message: string;
+    span?: SourceSpan;
+}
+export type StructuralParseOutcome = {
+    status: "ok" | "recovered";
+    structure: NormalizedStructure;
+    diagnosticCount: number;
+    diagnostics: readonly ParseDiagnostic[];
+} | {
+    status: "unsupported";
+    diagnosticCount: number;
+    diagnostics: readonly ParseDiagnostic[];
+} | {
+    status: "failed";
+    failureKind: StructuralFailureKind;
+    diagnosticCount: number;
+    diagnostics: readonly ParseDiagnostic[];
+};
+export interface SemanticOnlyStructuralLanguage {
+    status: "semantic_only";
+    extension: string;
+    requiredForReadiness: false;
+    diagnostic: ParseDiagnostic & {
+        code: "unsupported_structural_language";
+    };
+}
+export interface SupportedStructuralLanguage {
+    status: "supported";
+    requiredForReadiness: true;
+    entry: LanguageManifestEntry;
+}
+export type StructuralLanguageResolution = SupportedStructuralLanguage | SemanticOnlyStructuralLanguage;
+//# sourceMappingURL=types.d.ts.map

package/dist/services/structural/types.d.ts.map

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

package/dist/services/structural/types.js

@@ -0,0 +1,27 @@
+/** Canonical transport taxonomy. Additive changes require a version bump. */
+export { STRUCTURAL_SYMBOL_KINDS, } from "@massa-ai/shared";
+/** Canonical structural edge taxonomy. Additive changes require a version bump. */
+export const STRUCTURAL_EDGE_KINDS = [
+    "call",
+    "data_flow",
+    "type_ref",
+    "extend",
+    "implement",
+    "import",
+    "http_call",
+    "emit",
+    "listen",
+];
+export const STRUCTURAL_TAXONOMY_VERSION = "1.0.0";
+export const SOURCE_SPAN_SCHEMA_VERSION = "1.0.0";
+export const STRUCTURAL_FQN_SCHEMA_VERSION = "1.0.0";
+export const STRUCTURAL_CAPABILITIES = [
+    "declarations",
+    "documentation",
+    "imports",
+    "type_relations",
+    "calls",
+    "data_flow",
+    "specialized_edges",
+];
+//# sourceMappingURL=types.js.map

package/dist/services/structural/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/structural/types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,EACL,uBAAuB,GAExB,MAAM,kBAAkB,CAAC;AAG1B,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,MAAM;IACN,WAAW;IACX,UAAU;IACV,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,WAAW;IACX,MAAM;IACN,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,2BAA2B,GAAG,OAAO,CAAC;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAClD,MAAM,CAAC,MAAM,6BAA6B,GAAG,OAAO,CAAC;AAqFrD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,cAAc;IACd,eAAe;IACf,SAAS;IACT,gBAAgB;IAChB,OAAO;IACP,WAAW;IACX,mBAAmB;CACX,CAAC"}

package/dist/services/symbol/active-generation.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Active-graph-generation lookup + stale-generation precondition (N1).
+ *
+ * Two helpers consumed by the graph-reader tool handlers in T11
+ * (`impact_analysis`, `trace_path`, `get_references`, `search_definitions`):
+ *
+ *   1. `getActiveGeneration(projectId)` — returns the workspace's current
+ *      `active_graph_generation_id` or `null` (never-indexed / vector-only
+ *      workspace). Surfaces the token clients cache and send back as
+ *      `ifNoneMatch`.
+ *   2. `assertGenerationNotStale(ifNoneMatch, current)` — opt-in precondition.
+ *      Throws a 412 `ToolError` when the client's cached generation is stale
+ *      or when no active generation exists at all. No-op when `ifNoneMatch`
+ *      is omitted/empty (opt-in).
+ *
+ * `search_code` is EXCLUDED from this contract: vector + keyword search is
+ *      graph-independent, so it neither calls these helpers nor accepts
+ *      `ifNoneMatch`.
+ *
+ * Precedent: `symbol-graph.service.ts:455` already surfaces
+ * `activatedGraphGenerationId` on `project_map`; this module is the reusable
+ * form for the other graph readers.
+ */
+/**
+ * Look up the current active graph generation id for a workspace.
+ *
+ * @returns The active `generationId`, or `null` when the workspace has no
+ *   active generation (never indexed, or vector-only workspace).
+ */
+export declare function getActiveGeneration(projectId: string): Promise<string | null>;
+/**
+ * Opt-in precondition: throw a 412 teaching error when the client's cached
+ * generation id (`ifNoneMatch`) does not match the workspace's current active
+ * generation. No-op when `ifNoneMatch` is omitted or empty (opt-in).
+ *
+ * @throws ToolError("No active generation: index the project before querying.", 412)
+ *   when `ifNoneMatch` is set and `current === null`.
+ * @throws ToolError("Stale generation: client held <ifNoneMatch>, current is <current>. Re-read the project map before retrying.", 412)
+ *   when `ifNoneMatch` is set, `current` is set, and they differ.
+ */
+export declare function assertGenerationNotStale(ifNoneMatch: string | undefined, current: string | null): void;
+//# sourceMappingURL=active-generation.d.ts.map

package/dist/services/symbol/active-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-generation.d.ts","sourceRoot":"","sources":["../../../src/services/symbol/active-generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,IAAI,CAcN"}

package/dist/services/symbol/active-generation.js

@@ -0,0 +1,56 @@
+/**
+ * Active-graph-generation lookup + stale-generation precondition (N1).
+ *
+ * Two helpers consumed by the graph-reader tool handlers in T11
+ * (`impact_analysis`, `trace_path`, `get_references`, `search_definitions`):
+ *
+ *   1. `getActiveGeneration(projectId)` — returns the workspace's current
+ *      `active_graph_generation_id` or `null` (never-indexed / vector-only
+ *      workspace). Surfaces the token clients cache and send back as
+ *      `ifNoneMatch`.
+ *   2. `assertGenerationNotStale(ifNoneMatch, current)` — opt-in precondition.
+ *      Throws a 412 `ToolError` when the client's cached generation is stale
+ *      or when no active generation exists at all. No-op when `ifNoneMatch`
+ *      is omitted/empty (opt-in).
+ *
+ * `search_code` is EXCLUDED from this contract: vector + keyword search is
+ *      graph-independent, so it neither calls these helpers nor accepts
+ *      `ifNoneMatch`.
+ *
+ * Precedent: `symbol-graph.service.ts:455` already surfaces
+ * `activatedGraphGenerationId` on `project_map`; this module is the reusable
+ * form for the other graph readers.
+ */
+import { ToolError } from "../../tools/enum-validation.js";
+import { getSymbolRepository } from "../../data/symbol/symbol-repository-factory.js";
+/**
+ * Look up the current active graph generation id for a workspace.
+ *
+ * @returns The active `generationId`, or `null` when the workspace has no
+ *   active generation (never indexed, or vector-only workspace).
+ */
+export async function getActiveGeneration(projectId) {
+    const scope = await getSymbolRepository().getActiveGenerationScope(projectId);
+    return scope?.generationId ?? null;
+}
+/**
+ * Opt-in precondition: throw a 412 teaching error when the client's cached
+ * generation id (`ifNoneMatch`) does not match the workspace's current active
+ * generation. No-op when `ifNoneMatch` is omitted or empty (opt-in).
+ *
+ * @throws ToolError("No active generation: index the project before querying.", 412)
+ *   when `ifNoneMatch` is set and `current === null`.
+ * @throws ToolError("Stale generation: client held <ifNoneMatch>, current is <current>. Re-read the project map before retrying.", 412)
+ *   when `ifNoneMatch` is set, `current` is set, and they differ.
+ */
+export function assertGenerationNotStale(ifNoneMatch, current) {
+    if (!ifNoneMatch)
+        return; // opt-in: omitted or empty string → no precondition
+    if (current === null) {
+        throw new ToolError("No active generation: index the project before querying.", 412);
+    }
+    if (ifNoneMatch !== current) {
+        throw new ToolError(`Stale generation: client held ${ifNoneMatch}, current is ${current}. Re-read the project map before retrying.`, 412);
+    }
+}
+//# sourceMappingURL=active-generation.js.map

package/dist/services/symbol/active-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-generation.js","sourceRoot":"","sources":["../../../src/services/symbol/active-generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAErF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAiB;IACzD,MAAM,KAAK,GAAG,MAAM,mBAAmB,EAAE,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAC9E,OAAO,KAAK,EAAE,YAAY,IAAI,IAAI,CAAC;AACrC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CACtC,WAA+B,EAC/B,OAAsB;IAEtB,IAAI,CAAC,WAAW;QAAE,OAAO,CAAC,oDAAoD;IAC9E,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,SAAS,CACjB,0DAA0D,EAC1D,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,SAAS,CACjB,iCAAiC,WAAW,gBAAgB,OAAO,4CAA4C,EAC/G,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC"}