@opencodehub/ingestion 0.1.0

package/dist/providers/python.d.ts

@@ -0,0 +1,3 @@
+import type { LanguageProvider } from "./types.js";
+export declare const pythonProvider: LanguageProvider;
+//# sourceMappingURL=python.d.ts.map

package/dist/providers/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../src/providers/python.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAKV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AA8QpB,eAAO,MAAM,cAAc,EAAE,gBAgE5B,CAAC"}

package/dist/providers/python.js

@@ -0,0 +1,323 @@
+import { getLine, innermostEnclosingContainer, innermostEnclosingDef, isInside, pairDefinitionsWithNames, stripComments, } from "./extract-helpers.js";
+import { detectHttpCallsPython } from "./http-detect.js";
+import { extractPyPropertyAccesses } from "./python-accesses.js";
+/**
+ * Python provider. `function_definition` in the grammar covers both top-level
+ * functions and methods — we promote to `Method` when the definition is
+ * nested inside a `class_definition`.
+ *
+ * Exports follow Python's convention: any name not prefixed with `_` is
+ * visible to `from mod import *` (ignoring `__all__` at MVP).
+ */
+function extractPyDefinitions(input) {
+    const { filePath, captures, sourceText } = input;
+    const paired = pairDefinitionsWithNames(captures);
+    const defCaptures = captures.filter((c) => c.tag.startsWith("definition."));
+    const out = [];
+    // Class-body attributes may match TWO `definition.property` captures (the
+    // typed `x: int = 0` pattern and the untyped `x = 0` pattern both fire
+    // because the grammar sees the same assignment through both rules). Track
+    // emitted ranges so we only produce one Property per source line.
+    const propertyRanges = new Set();
+    for (const c of defCaptures) {
+        if (c.tag !== "definition.property")
+            continue;
+        propertyRanges.add(`${c.startLine}:${c.startCol}:${c.endLine}:${c.endCol}`);
+    }
+    const emittedPropertyRanges = new Set();
+    for (const { def, name } of paired) {
+        let kind;
+        let owner;
+        const ownerDef = innermostEnclosingDef(def, defCaptures);
+        if (ownerDef !== undefined) {
+            const ownerPaired = paired.find((p) => p.def === ownerDef);
+            if (ownerPaired !== undefined)
+                owner = ownerPaired.name.text;
+        }
+        if (def.tag === "definition.class") {
+            kind = "Class";
+        }
+        else if (def.tag === "definition.function") {
+            // Method when nested inside a class.
+            kind = ownerDef?.tag === "definition.class" ? "Method" : "Function";
+        }
+        else if (def.tag === "definition.property") {
+            const rangeKey = `${def.startLine}:${def.startCol}:${def.endLine}:${def.endCol}`;
+            if (emittedPropertyRanges.has(rangeKey))
+                continue;
+            emittedPropertyRanges.add(rangeKey);
+            kind = "Property";
+        }
+        else if (def.tag === "definition.variable") {
+            // Function-body locals. Safe to emit: the enclosing-scope CALLS filter
+            // excludes Variable tags so locals can't steal call-edge ownership
+            // from their enclosing Function/Method.
+            kind = "Variable";
+        }
+        else if (def.tag === "definition.constant") {
+            // Could be the module-level constant capture OR the untyped class-body
+            // property capture. Discriminate by enclosing scope.
+            const rangeKey = `${def.startLine}:${def.startCol}:${def.endLine}:${def.endCol}`;
+            if (propertyRanges.has(rangeKey))
+                continue; // typed variant wins
+            if (ownerDef?.tag === "definition.class") {
+                kind = "Property";
+            }
+            else {
+                kind = "Const";
+            }
+        }
+        else {
+            continue;
+        }
+        const qualifiedName = owner !== undefined ? `${owner}.${name.text}` : name.text;
+        const headerLine = getLine(sourceText, def.startLine);
+        const isExported = !name.text.startsWith("_");
+        const rec = {
+            kind,
+            name: name.text,
+            qualifiedName,
+            filePath,
+            startLine: def.startLine,
+            endLine: def.endLine,
+            isExported,
+            ...(owner !== undefined ? { owner } : {}),
+            ...(kind === "Const" ? { isConst: /^[A-Z_][A-Z0-9_]*\s*=/.test(headerLine.trim()) } : {}),
+        };
+        out.push(rec);
+    }
+    return out;
+}
+function extractPyCalls(input) {
+    const { filePath, captures, definitions } = input;
+    const defCaptures = captures.filter((c) => c.tag.startsWith("definition."));
+    const callRefs = captures.filter((c) => c.tag === "reference.call");
+    const out = [];
+    for (const ref of callRefs) {
+        const innerName = findNameInside(captures, ref);
+        const calleeName = innerName?.text ?? ref.text;
+        // Determine caller context: walk enclosing defs from innermost out.
+        const enclosingDef = innermostEnclosingDef(ref, defCaptures);
+        const callerQualifiedName = enclosingDef
+            ? qualifiedForCapture(enclosingDef, definitions)
+            : "<module>";
+        // Receiver inference from the call expression's source text. The
+        // `@reference.call` range covers the full call; when the grammar
+        // matched `attribute.attribute`, `ref.text` is like `self.foo(x)`.
+        const receiver = inferPyReceiver(ref, innerName);
+        out.push({
+            callerQualifiedName,
+            calleeName,
+            filePath,
+            startLine: ref.startLine,
+            ...(receiver !== undefined ? { calleeOwner: receiver } : {}),
+        });
+    }
+    return out;
+}
+function findNameInside(captures, outer) {
+    let best;
+    for (const c of captures) {
+        if (c.tag !== "name")
+            continue;
+        if (!isInside(c, outer))
+            continue;
+        if (best === undefined || c.startLine < best.startLine)
+            best = c;
+    }
+    return best;
+}
+function inferPyReceiver(ref, name) {
+    if (name === undefined)
+        return undefined;
+    const idx = ref.text.lastIndexOf(`.${name.text}`);
+    if (idx <= 0)
+        return undefined;
+    const prefix = ref.text.slice(0, idx).trim();
+    if (prefix === "")
+        return undefined;
+    if (/^[A-Za-z_][\w]*$/.test(prefix))
+        return prefix;
+    return prefix;
+}
+function qualifiedForCapture(def, definitions) {
+    for (const d of definitions) {
+        if (d.startLine === def.startLine)
+            return d.qualifiedName;
+    }
+    return "<module>";
+}
+/**
+ * Parse Python imports:
+ *   `import X`                → namespace
+ *   `import X as Y`           → namespace with alias
+ *   `import X.Y.Z`            → namespace (dotted)
+ *   `from X import a, b`      → named
+ *   `from X import a as b`    → named with alias
+ *   `from X import *`         → package-wildcard
+ *   `from . import x`         → relative import (source begins `.`)
+ */
+function extractPyImports(input) {
+    const { filePath, sourceText } = input;
+    const stripped = stripComments(sourceText);
+    const lines = stripped.split("\n");
+    const out = [];
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (line === "")
+            continue;
+        // `from X import ...`
+        const fromMatch = /^from\s+([^\s]+)\s+import\s+(.+)$/.exec(line);
+        if (fromMatch !== null) {
+            const source = fromMatch[1];
+            const rest = fromMatch[2].trim();
+            if (rest === "*") {
+                out.push({ filePath, source, kind: "package-wildcard", isWildcard: true });
+                continue;
+            }
+            // Strip trailing `(...)` in case of parenthesized lists.
+            const cleaned = rest.replace(/^\(|\)$/g, "").trim();
+            const parts = cleaned
+                .split(",")
+                .map((p) => p.trim())
+                .filter((p) => p.length > 0);
+            const names = [];
+            for (const p of parts) {
+                const m = /^([A-Za-z_][\w]*)(?:\s+as\s+([A-Za-z_][\w]*))?$/.exec(p);
+                if (m === null)
+                    continue;
+                names.push(m[2] ?? m[1]);
+            }
+            if (names.length > 0) {
+                out.push({ filePath, source, kind: "named", importedNames: names });
+            }
+            continue;
+        }
+        // `import X[, Y as Z]`
+        const importMatch = /^import\s+(.+)$/.exec(line);
+        if (importMatch !== null) {
+            const body = importMatch[1];
+            const parts = body
+                .split(",")
+                .map((p) => p.trim())
+                .filter((p) => p.length > 0);
+            for (const p of parts) {
+                const m = /^([A-Za-z_][\w.]*)(?:\s+as\s+([A-Za-z_][\w]*))?$/.exec(p);
+                if (m === null)
+                    continue;
+                const source = m[1];
+                const alias = m[2];
+                out.push({
+                    filePath,
+                    source,
+                    kind: "namespace",
+                    ...(alias !== undefined ? { localAlias: alias } : {}),
+                });
+            }
+        }
+    }
+    return out;
+}
+function extractPyHeritage(input) {
+    const { filePath, captures, definitions } = input;
+    // The Python query emits `(class_definition superclasses: (argument_list
+    // (identifier) @name @reference.class))`. Group references by enclosing
+    // class definition, then emit an EXTENDS edge per parent. The C3 walker
+    // handles MRO linearization downstream.
+    const classDefs = captures.filter((c) => c.tag === "definition.class");
+    const classRefs = captures.filter((c) => c.tag === "reference.class");
+    const out = [];
+    for (const ref of classRefs) {
+        // Use the tightest-enclosing-container walk so nested classes don't
+        // inherit their enclosing class's bases. See `LiteLLMModel` /
+        // `SageMakerAIModel` in strands-agents/sdk-python: a nested
+        // `Config(BaseModelConfig)` used to attribute the base to the outer
+        // class, producing spurious MRO conflicts.
+        const enclosing = innermostEnclosingContainer(ref, classDefs);
+        if (enclosing === undefined)
+            continue;
+        const child = definitions.find((d) => d.kind === "Class" && d.startLine === enclosing.startLine);
+        if (child === undefined)
+            continue;
+        out.push({
+            childQualifiedName: child.qualifiedName,
+            parentName: ref.text,
+            filePath,
+            relation: "EXTENDS",
+            startLine: ref.startLine,
+        });
+    }
+    return out;
+}
+function preprocessPyImportPath(raw) {
+    // Python source-level imports use dotted paths, e.g. `pkg.sub.mod`. The
+    // path-lookup phase maps these to files on disk; here we just strip any
+    // trailing `.py` or `/__init__.py` that might have leaked through (rare,
+    // but occurs when an import is reconstructed from a file path).
+    return raw.replace(/\.py$/, "").replace(/\/__init__$/, "");
+}
+export const pythonProvider = {
+    id: "python",
+    extensions: [".py"],
+    importSemantics: "namespace",
+    mroStrategy: "c3",
+    typeConfig: { structural: true, nominal: false, generics: true },
+    heritageEdge: "EXTENDS",
+    inferImplicitReceiver: () => "self",
+    preprocessImportPath: preprocessPyImportPath,
+    isExportedIdentifier: (name) => !name.startsWith("_"),
+    // Opt into the clean-room stack-graphs evaluator for Python reference
+    // resolution. The strategy falls back to the three-tier walker whenever
+    // stack-graphs can't produce an answer (missing graph cache, degraded
+    // rule load, depth-budget exhaustion, etc.).
+    resolverStrategyName: "stack-graphs",
+    complexityDefinitionKinds: ["function_definition", "lambda"],
+    halsteadOperatorKinds: [
+        "+",
+        "-",
+        "*",
+        "/",
+        "//",
+        "%",
+        "**",
+        "=",
+        "==",
+        "!=",
+        "<",
+        ">",
+        "<=",
+        ">=",
+        "and",
+        "or",
+        "not",
+        "is",
+        "in",
+        "&",
+        "|",
+        "^",
+        "~",
+        "<<",
+        ">>",
+        "+=",
+        "-=",
+        "*=",
+        "/=",
+        "%=",
+        "**=",
+        "//=",
+        "&=",
+        "|=",
+        "^=",
+        ":",
+        "@",
+        ":=",
+    ],
+    extractDefinitions: extractPyDefinitions,
+    extractCalls: extractPyCalls,
+    extractImports: extractPyImports,
+    isExported: (def) => def.isExported,
+    extractHeritage: extractPyHeritage,
+    detectOutboundHttp: ({ sourceText }) => detectHttpCallsPython(sourceText),
+    extractPropertyAccesses: extractPyPropertyAccesses,
+};
+//# sourceMappingURL=python.js.map

package/dist/providers/python.js.map

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

package/dist/providers/registry.d.ts

@@ -0,0 +1,4 @@
+import type { LanguageId, LanguageProvider } from "./types.js";
+export declare function getProvider(lang: LanguageId): LanguageProvider;
+export declare function listProviders(): readonly LanguageProvider[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA2B/D,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAE9D;AAED,wBAAgB,aAAa,IAAI,SAAS,gBAAgB,EAAE,CAE3D"}

package/dist/providers/registry.js

@@ -0,0 +1,46 @@
+import { cProvider } from "./c.js";
+import { cobolProvider } from "./cobol.js";
+import { cppProvider } from "./cpp.js";
+import { csharpProvider } from "./csharp.js";
+import { dartProvider } from "./dart.js";
+import { goProvider } from "./go.js";
+import { javaProvider } from "./java.js";
+import { javascriptProvider } from "./javascript.js";
+import { kotlinProvider } from "./kotlin.js";
+import { phpProvider } from "./php.js";
+import { pythonProvider } from "./python.js";
+import { rubyProvider } from "./ruby.js";
+import { rustProvider } from "./rust.js";
+import { swiftProvider } from "./swift.js";
+import { tsxProvider } from "./tsx.js";
+import { typescriptProvider } from "./typescript.js";
+/**
+ * Compile-time exhaustive provider table. `satisfies` forces every
+ * `LanguageId` to map to a `LanguageProvider` — adding a language to the
+ * union without registering it here becomes a type error.
+ */
+const providers = {
+    typescript: typescriptProvider,
+    tsx: tsxProvider,
+    javascript: javascriptProvider,
+    python: pythonProvider,
+    go: goProvider,
+    rust: rustProvider,
+    java: javaProvider,
+    csharp: csharpProvider,
+    c: cProvider,
+    cpp: cppProvider,
+    ruby: rubyProvider,
+    kotlin: kotlinProvider,
+    swift: swiftProvider,
+    php: phpProvider,
+    dart: dartProvider,
+    cobol: cobolProvider,
+};
+export function getProvider(lang) {
+    return providers[lang];
+}
+export function listProviders() {
+    return Object.values(providers);
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,MAAM,SAAS,GAAG;IAChB,UAAU,EAAE,kBAAkB;IAC9B,GAAG,EAAE,WAAW;IAChB,UAAU,EAAE,kBAAkB;IAC9B,MAAM,EAAE,cAAc;IACtB,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,cAAc;IACtB,CAAC,EAAE,SAAS;IACZ,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,aAAa;IACpB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,aAAa;CAC0B,CAAC;AAEjD,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC1C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/providers/resolution/c3.d.ts

@@ -0,0 +1,6 @@
+import type { MroStrategy } from "./mro.js";
+export declare class MroConflictError extends Error {
+    constructor(message: string);
+}
+export declare const c3Strategy: MroStrategy;
+//# sourceMappingURL=c3.d.ts.map

package/dist/providers/resolution/c3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"c3.d.ts","sourceRoot":"","sources":["../../../src/providers/resolution/c3.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAiED,eAAO,MAAM,UAAU,EAAE,WAGxB,CAAC"}

package/dist/providers/resolution/c3.js

@@ -0,0 +1,76 @@
+// C3 linearization for method resolution order.
+//
+// Ported from the public CPython specification:
+//   https://docs.python.org/3/howto/mro.html
+//   https://www.python.org/download/releases/2.3/mro/ (Michele Simionato, 2003)
+//
+// Algorithm (as stated in the spec):
+//   L[C(B1..Bn)] = C + merge(L[B1], ..., L[Bn], [B1..Bn])
+//
+// merge(lists): repeatedly pick a "good head" — the first element of some
+// list that does not appear in the tail (any position after the head) of any
+// other list. Append it and remove it from every list. If no good head
+// exists, the hierarchy is inconsistent and we raise `MroConflictError`.
+export class MroConflictError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MroConflictError";
+    }
+}
+/**
+ * Returns true if `candidate` appears in any list at position >= 1
+ * (i.e. in the tail of that list).
+ */
+function appearsInTail(candidate, lists) {
+    for (const list of lists) {
+        for (let i = 1; i < list.length; i++) {
+            if (list[i] === candidate)
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * The merge step. Mutates `lists` in place: removes picked heads and drops
+ * emptied lists. Returns the merged linearization.
+ */
+function merge(lists) {
+    const result = [];
+    // Trim any initial empties so iteration is clean.
+    let pending = lists.filter((l) => l.length > 0);
+    while (pending.length > 0) {
+        let picked;
+        for (const list of pending) {
+            const head = list[0];
+            if (head === undefined)
+                continue;
+            if (!appearsInTail(head, pending)) {
+                picked = head;
+                break;
+            }
+        }
+        if (picked === undefined) {
+            const remaining = pending.map((l) => `[${l.join(", ")}]`).join(" ");
+            throw new MroConflictError(`Cannot create a consistent method resolution order. Remaining lists: ${remaining}`);
+        }
+        result.push(picked);
+        for (const list of pending) {
+            if (list[0] === picked)
+                list.shift();
+        }
+        pending = pending.filter((l) => l.length > 0);
+    }
+    return result;
+}
+function linearize(classId, bases, baseLinearizations) {
+    // Each argument to merge() is a fresh copy so we never mutate the caller's
+    // data. `[...bases]` is the "direct bases" list required by the C3 spec.
+    const lists = [...bases.map((b) => [...baseLinearizations(b)]), [...bases]];
+    return [classId, ...merge(lists)];
+}
+const NAME = "c3";
+export const c3Strategy = {
+    name: NAME,
+    linearize,
+};
+//# sourceMappingURL=c3.js.map

package/dist/providers/resolution/c3.js.map

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

package/dist/providers/resolution/context.d.ts

@@ -0,0 +1,38 @@
+import type { LanguageProvider } from "../types.js";
+/**
+ * Three-tier name resolution. Ordered from most to least specific; each tier
+ * has a fixed confidence score so callers can rank candidates across tiers
+ * without re-deriving weights.
+ */
+export type ResolutionTier = "same-file" | "import-scoped" | "global";
+export declare const CONFIDENCE_BY_TIER: Readonly<Record<ResolutionTier, number>>;
+export interface ResolutionQuery {
+    readonly callerFile: string;
+    readonly calleeName: string;
+    readonly provider: LanguageProvider;
+}
+export interface ResolutionCandidate {
+    readonly targetId: string;
+    readonly tier: ResolutionTier;
+    readonly confidence: number;
+}
+/**
+ * Minimal symbol-lookup surface. Concrete implementations sit atop the
+ * DuckDB-backed `IGraphStore`, but every resolver strategy speaks to this
+ * interface so unit tests can drive it with in-memory fixtures.
+ */
+export interface SymbolIndex {
+    findInFile(filePath: string, name: string): string | undefined;
+    findInImports(importerFile: string, name: string): string | undefined;
+    findGlobal(name: string): readonly string[];
+}
+/**
+ * Walk the three tiers in specificity order and emit candidates.
+ *  1. Same-file hit: single high-confidence candidate, short-circuit.
+ *  2. Import-scoped: the declaration brought in by an `import` statement.
+ *  3. Global: any candidate with a matching name anywhere in the workspace.
+ *
+ * Results are sorted by descending confidence — callers may truncate.
+ */
+export declare function resolve(q: ResolutionQuery, index: SymbolIndex): ResolutionCandidate[];
+//# sourceMappingURL=context.d.ts.map

package/dist/providers/resolution/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/providers/resolution/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,eAAe,GAAG,QAAQ,CAAC;AAEtE,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAIvE,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/D,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACtE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,GAAG,mBAAmB,EAAE,CAiCrF"}

package/dist/providers/resolution/context.js

@@ -0,0 +1,45 @@
+export const CONFIDENCE_BY_TIER = {
+    "same-file": 0.95,
+    "import-scoped": 0.9,
+    global: 0.5,
+};
+/**
+ * Walk the three tiers in specificity order and emit candidates.
+ *  1. Same-file hit: single high-confidence candidate, short-circuit.
+ *  2. Import-scoped: the declaration brought in by an `import` statement.
+ *  3. Global: any candidate with a matching name anywhere in the workspace.
+ *
+ * Results are sorted by descending confidence — callers may truncate.
+ */
+export function resolve(q, index) {
+    const sameFile = index.findInFile(q.callerFile, q.calleeName);
+    if (sameFile !== undefined) {
+        return [
+            {
+                targetId: sameFile,
+                tier: "same-file",
+                confidence: CONFIDENCE_BY_TIER["same-file"],
+            },
+        ];
+    }
+    const imported = index.findInImports(q.callerFile, q.calleeName);
+    if (imported !== undefined) {
+        return [
+            {
+                targetId: imported,
+                tier: "import-scoped",
+                confidence: CONFIDENCE_BY_TIER["import-scoped"],
+            },
+        ];
+    }
+    const globals = index.findGlobal(q.calleeName);
+    const globalCandidates = globals.map((id) => ({
+        targetId: id,
+        tier: "global",
+        confidence: CONFIDENCE_BY_TIER.global,
+    }));
+    // Tiers are already in descending confidence; sort guards future tier
+    // reordering without changing callers.
+    return globalCandidates.slice().sort((a, b) => b.confidence - a.confidence);
+}
+//# sourceMappingURL=context.js.map

package/dist/providers/resolution/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/providers/resolution/context.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,kBAAkB,GAA6C;IAC1E,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,GAAG;IACpB,MAAM,EAAE,GAAG;CACZ,CAAC;AAyBF;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,CAAkB,EAAE,KAAkB;IAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC9D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;YACL;gBACE,QAAQ,EAAE,QAAQ;gBAClB,IAAI,EAAE,WAAW;gBACjB,UAAU,EAAE,kBAAkB,CAAC,WAAW,CAAC;aAC5C;SACF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IACjE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;YACL;gBACE,QAAQ,EAAE,QAAQ;gBAClB,IAAI,EAAE,eAAe;gBACrB,UAAU,EAAE,kBAAkB,CAAC,eAAe,CAAC;aAChD;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,gBAAgB,GAA0B,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACnE,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,kBAAkB,CAAC,MAAM;KACtC,CAAC,CAAC,CAAC;IAEJ,sEAAsE;IACtE,uCAAuC;IACvC,OAAO,gBAAgB,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AAC9E,CAAC"}

package/dist/providers/resolution/first-wins.d.ts

@@ -0,0 +1,3 @@
+import type { MroStrategy } from "./mro.js";
+export declare const firstWinsStrategy: MroStrategy;
+//# sourceMappingURL=first-wins.d.ts.map

package/dist/providers/resolution/first-wins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-wins.d.ts","sourceRoot":"","sources":["../../../src/providers/resolution/first-wins.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA4B5C,eAAO,MAAM,iBAAiB,EAAE,WAG/B,CAAC"}

package/dist/providers/resolution/first-wins.js

@@ -0,0 +1,27 @@
+// "First wins" linearization. Used for TypeScript / JavaScript mixin chains
+// and as a pragmatic default for trait walking. Walks bases left-to-right,
+// flattens each base's linearization in order, and deduplicates by first
+// occurrence. No monotonicity guarantee — the caller accepts that.
+function linearize(classId, bases, baseLinearizations) {
+    const seen = new Set();
+    const result = [];
+    const push = (id) => {
+        if (!seen.has(id)) {
+            seen.add(id);
+            result.push(id);
+        }
+    };
+    push(classId);
+    for (const base of bases) {
+        for (const id of baseLinearizations(base)) {
+            push(id);
+        }
+    }
+    return result;
+}
+const NAME = "first-wins";
+export const firstWinsStrategy = {
+    name: NAME,
+    linearize,
+};
+//# sourceMappingURL=first-wins.js.map

package/dist/providers/resolution/first-wins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-wins.js","sourceRoot":"","sources":["../../../src/providers/resolution/first-wins.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,2EAA2E;AAC3E,yEAAyE;AACzE,mEAAmE;AAKnE,SAAS,SAAS,CAChB,OAAe,EACf,KAAwB,EACxB,kBAAqD;IAErD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,IAAI,GAAG,CAAC,EAAU,EAAQ,EAAE;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,EAAE,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,EAAE,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,IAAI,GAAoB,YAAY,CAAC;AAE3C,MAAM,CAAC,MAAM,iBAAiB,GAAgB;IAC5C,IAAI,EAAE,IAAI;IACV,SAAS;CACV,CAAC"}