@opensip-cli/graph-python 0.1.0

package/dist/__tests__/resolve.test.js

@@ -0,0 +1,176 @@
+/**
+ * Branch-coverage tests for lang-python/resolve.ts.
+ *
+ * Exercises the resolution ladder by feeding small Python fixtures
+ * through the full discover/parse/walk/resolve pipeline. Each test
+ * targets one of the call-target shapes (identifier, attribute,
+ * subscript/lambda) and one rung of the confidence ladder
+ * (unknown / static / method-dispatch).
+ */
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { pythonGraphAdapter } from '../index.js';
+function runPipeline(dir) {
+    const discovery = pythonGraphAdapter.discoverFiles({ cwd: dir });
+    const parsed = pythonGraphAdapter.parseProject({
+        projectDirAbs: discovery.projectDirAbs,
+        files: discovery.files,
+        compilerOptions: discovery.compilerOptions,
+        resolutionMode: 'exact',
+    });
+    const walk = pythonGraphAdapter.walkProject({
+        project: parsed.project,
+        projectDirAbs: discovery.projectDirAbs,
+        files: discovery.files,
+    });
+    const catalog = {
+        version: '3.0',
+        tool: 'graph',
+        language: 'python',
+        cacheKey: 'test',
+        builtAt: new Date().toISOString(),
+        functions: walk.occurrences,
+    };
+    const resolved = pythonGraphAdapter.resolveCallSites({
+        project: parsed.project,
+        catalog,
+        callSites: walk.callSites,
+        projectDirAbs: discovery.projectDirAbs,
+        resolutionMode: 'exact',
+    });
+    return {
+        occurrences: walk.occurrences,
+        edgesByOwner: resolved.edgesByOwner,
+        stats: resolved.stats,
+    };
+}
+function flattenEdges(edgesByOwner) {
+    const out = [];
+    for (const edges of edgesByOwner.values()) {
+        for (const e of edges)
+            out.push(e);
+    }
+    return out;
+}
+describe('lang-python resolve.ts — branches', () => {
+    let dir;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), 'graph-python-resolve-'));
+    });
+    afterEach(() => {
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('resolves a direct identifier call to a single static medium-confidence edge', () => {
+        writeFileSync(join(dir, 'main.py'), `def helper(x):\n    return x\n\ndef entry():\n    return helper(1)\n`, 'utf8');
+        const { edgesByOwner, stats } = runPipeline(dir);
+        const all = flattenEdges(edgesByOwner);
+        const helperCall = all.find((e) => e.text.startsWith('helper('));
+        expect(helperCall).toBeDefined();
+        expect(helperCall?.resolution).toBe('static');
+        expect(helperCall?.confidence).toBe('medium');
+        expect(helperCall?.to).toHaveLength(1);
+        expect(stats.resolvedMedium).toBeGreaterThan(0);
+    });
+    it('resolves attribute calls (obj.method()) by attribute name', () => {
+        writeFileSync(join(dir, 'main.py'), `class G:\n    def greet(self, who):\n        return who\n\ndef use():\n    g = G()\n    return g.greet("x")\n`, 'utf8');
+        const { edgesByOwner } = runPipeline(dir);
+        const all = flattenEdges(edgesByOwner);
+        // g.greet("x") should resolve by attribute name 'greet' to the method
+        const greetCall = all.find((e) => e.text.includes('g.greet'));
+        expect(greetCall).toBeDefined();
+        expect(greetCall?.resolution).toBe('static');
+        expect(greetCall?.to).toHaveLength(1);
+    });
+    it('emits method-dispatch low-confidence when multiple catalog entries share a name', () => {
+        writeFileSync(join(dir, 'a.py'), `class A:\n    def run(self):\n        return 1\n`, 'utf8');
+        writeFileSync(join(dir, 'b.py'), `class B:\n    def run(self):\n        return 2\n`, 'utf8');
+        writeFileSync(join(dir, 'use.py'), `def use(obj):\n    return obj.run()\n`, 'utf8');
+        const { edgesByOwner, stats } = runPipeline(dir);
+        const all = flattenEdges(edgesByOwner);
+        const runCall = all.find((e) => e.text.includes('obj.run'));
+        expect(runCall).toBeDefined();
+        expect(runCall?.resolution).toBe('method-dispatch');
+        expect(runCall?.confidence).toBe('low');
+        expect(runCall?.to.length).toBeGreaterThanOrEqual(2);
+        expect(stats.resolvedLow).toBeGreaterThan(0);
+    });
+    it('emits unknown/low when calling an unknown name', () => {
+        writeFileSync(join(dir, 'main.py'), `def entry():\n    return missing_name(1)\n`, 'utf8');
+        const { edgesByOwner, stats } = runPipeline(dir);
+        const all = flattenEdges(edgesByOwner);
+        const missing = all.find((e) => e.text.includes('missing_name'));
+        expect(missing).toBeDefined();
+        expect(missing?.resolution).toBe('unknown');
+        expect(missing?.confidence).toBe('low');
+        expect(missing?.to).toHaveLength(0);
+        expect(stats.unresolved).toBeGreaterThan(0);
+    });
+    it('emits unknown for non-identifier/attribute call shapes (lambda IIFE)', () => {
+        writeFileSync(join(dir, 'main.py'), `def entry():\n    return (lambda x: x)(1)\n`, 'utf8');
+        const { edgesByOwner } = runPipeline(dir);
+        const all = flattenEdges(edgesByOwner);
+        // The (lambda...)(1) is a call whose target is a parenthesized
+        // lambda — neither identifier nor attribute → unknown.
+        expect(all.some((e) => e.resolution === 'unknown')).toBe(true);
+    });
+    it('emits unknown for subscript calls (e.g. fns[0]())', () => {
+        writeFileSync(join(dir, 'main.py'), `def entry(fns):\n    return fns[0]()\n`, 'utf8');
+        const { edgesByOwner } = runPipeline(dir);
+        const all = flattenEdges(edgesByOwner);
+        expect(all.some((e) => e.resolution === 'unknown')).toBe(true);
+    });
+    it('marks return value as discarded for expression-statement calls', () => {
+        writeFileSync(join(dir, 'main.py'), `def helper(x):\n    return x\n\ndef entry():\n    helper(1)\n    return helper(2)\n`, 'utf8');
+        const { edgesByOwner } = runPipeline(dir);
+        const all = flattenEdges(edgesByOwner);
+        const helperEdges = all.filter((e) => e.text.startsWith('helper('));
+        // One should be discarded (statement-level), one should not (in return)
+        expect(helperEdges.some((e) => e.discarded === true)).toBe(true);
+        expect(helperEdges.some((e) => e.discarded === false)).toBe(true);
+    });
+    it('treats parenthesized statement-level calls as discarded', () => {
+        writeFileSync(join(dir, 'main.py'), `def helper():\n    return 1\n\ndef entry():\n    (helper())\n`, 'utf8');
+        const { edgesByOwner } = runPipeline(dir);
+        const all = flattenEdges(edgesByOwner);
+        const helperEdges = all.filter((e) => e.text.startsWith('helper('));
+        expect(helperEdges.some((e) => e.discarded === true)).toBe(true);
+    });
+    it('treats await-wrapped statement-level calls as discarded', () => {
+        writeFileSync(join(dir, 'main.py'), `async def helper():\n    return 1\n\nasync def entry():\n    await helper()\n`, 'utf8');
+        const { edgesByOwner } = runPipeline(dir);
+        const all = flattenEdges(edgesByOwner);
+        const helperEdges = all.filter((e) => e.text.startsWith('helper('));
+        expect(helperEdges.some((e) => e.discarded === true)).toBe(true);
+    });
+    it('emits a creation edge for lambdas nested in a parent function', () => {
+        writeFileSync(join(dir, 'main.py'), `def entry():\n    f = lambda n: n + 1\n    return f(2)\n`, 'utf8');
+        const { edgesByOwner, stats } = runPipeline(dir);
+        // creation edges record resolution='static' confidence='high' (per
+        // pushCreationEdge in @opensip-cli/graph)
+        const all = flattenEdges(edgesByOwner);
+        expect(all.some((e) => e.resolution === 'static' && e.confidence === 'high')).toBe(true);
+        expect(stats.resolvedHigh).toBeGreaterThan(0);
+    });
+    it('skips synthetic/module-init names from the name index (names starting with <)', () => {
+        // <module-init> names start with '<' and should not be lookup targets
+        writeFileSync(join(dir, 'a.py'), `def f():\n    return 1\n`, 'utf8');
+        writeFileSync(join(dir, 'b.py'), `def caller():\n    return f()\n`, 'utf8');
+        const { edgesByOwner } = runPipeline(dir);
+        const all = flattenEdges(edgesByOwner);
+        // The synthetic names like <module-init:a.py> exist as keys in
+        // occurrences but should never appear as call targets. Just ensure
+        // f() resolves successfully — its presence proves the index works
+        // even when synthetic names coexist.
+        const fCall = all.find((e) => e.text.startsWith('f('));
+        expect(fCall?.resolution).toBe('static');
+    });
+    it('produces stable stats counters that sum to totalCallSites', () => {
+        writeFileSync(join(dir, 'main.py'), `def known():\n    return 1\n\ndef entry():\n    known()\n    unknown_fn()\n    return 1\n`, 'utf8');
+        const { stats } = runPipeline(dir);
+        expect(stats.totalCallSites).toBe(stats.resolvedHigh + stats.resolvedMedium + stats.resolvedLow + stats.unresolved);
+        expect(stats.totalCallSites).toBeGreaterThanOrEqual(2);
+    });
+});
+//# sourceMappingURL=resolve.test.js.map

package/dist/__tests__/resolve.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.test.js","sourceRoot":"","sources":["../../src/__tests__/resolve.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIjD,SAAS,WAAW,CAAC,GAAW;IAoB9B,MAAM,SAAS,GAAG,kBAAkB,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,eAAe,EAAE,SAAS,CAAC,eAAe;QAC1C,cAAc,EAAE,OAAO;KACxB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,kBAAkB,CAAC,WAAW,CAAC;QAC1C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,KAAK,EAAE,SAAS,CAAC,KAAK;KACvB,CAAC,CAAC;IACH,MAAM,OAAO,GAAY;QACvB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACjC,SAAS,EAAE,IAAI,CAAC,WAAW;KAC5B,CAAC;IACF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,gBAAgB,CAAC;QACnD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,cAAc,EAAE,OAAO;KACxB,CAAC,CAAC;IACH,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,QAAQ,CAAC,YAStB;QACD,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,YASC;IAQD,MAAM,GAAG,GAMH,EAAE,CAAC;IACT,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,IAAI,GAAW,CAAC;IAEhB,UAAU,CAAC,GAAG,EAAE;QACd,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EACpB,sEAAsE,EACtE,MAAM,CACP,CAAC;QACF,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EACpB,+GAA+G,EAC/G,MAAM,CACP,CAAC;QACF,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,sEAAsE;QACtE,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,kDAAkD,EAAE,MAAM,CAAC,CAAC;QAC7F,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,kDAAkD,EAAE,MAAM,CAAC,CAAC;QAC7F,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,uCAAuC,EAAE,MAAM,CAAC,CAAC;QACpF,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACpD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,4CAA4C,EAAE,MAAM,CAAC,CAAC;QAC1F,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,6CAA6C,EAAE,MAAM,CAAC,CAAC;QAC3F,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,+DAA+D;QAC/D,uDAAuD;QACvD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,wCAAwC,EAAE,MAAM,CAAC,CAAC;QACtF,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EACpB,qFAAqF,EACrF,MAAM,CACP,CAAC;QACF,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QACpE,wEAAwE;QACxE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EACpB,+DAA+D,EAC/D,MAAM,CACP,CAAC;QACF,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EACpB,+EAA+E,EAC/E,MAAM,CACP,CAAC;QACF,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EACpB,0DAA0D,EAC1D,MAAM,CACP,CAAC;QACF,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,mEAAmE;QACnE,0CAA0C;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzF,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,sEAAsE;QACtE,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,0BAA0B,EAAE,MAAM,CAAC,CAAC;QACrE,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,iCAAiC,EAAE,MAAM,CAAC,CAAC;QAC5E,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACvC,+DAA+D;QAC/D,mEAAmE;QACnE,kEAAkE;QAClE,qCAAqC;QACrC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EACpB,2FAA2F,EAC3F,MAAM,CACP,CAAC;QACF,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,IAAI,CAC/B,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CACjF,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/walk-shapes.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Function/parameter-shape coverage tests for lang-python/walk.ts.
+ *
+ * Specifically targets:
+ *   - Typed parameters / default parameters / typed-default parameters.
+ *   - Methods inside classes (kind: 'method').
+ *   - `__init__` (kind: 'constructor').
+ *   - Lambdas as siblings of a function (visited but not nested in a
+ *     function frame).
+ *   - Test-file detection (tests/ folder + test_*.py + _test.py).
+ *   - Generated-file detection (dist/, build/, .generated.).
+ *   - Visibility ('exported' vs 'module-local').
+ */
+export {};
+//# sourceMappingURL=walk-shapes.test.d.ts.map

package/dist/__tests__/walk-shapes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-shapes.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/walk-shapes.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/__tests__/walk-shapes.test.js

@@ -0,0 +1,156 @@
+/**
+ * Function/parameter-shape coverage tests for lang-python/walk.ts.
+ *
+ * Specifically targets:
+ *   - Typed parameters / default parameters / typed-default parameters.
+ *   - Methods inside classes (kind: 'method').
+ *   - `__init__` (kind: 'constructor').
+ *   - Lambdas as siblings of a function (visited but not nested in a
+ *     function frame).
+ *   - Test-file detection (tests/ folder + test_*.py + _test.py).
+ *   - Generated-file detection (dist/, build/, .generated.).
+ *   - Visibility ('exported' vs 'module-local').
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { pythonGraphAdapter } from '../index.js';
+import { isTestFile } from '../walk.js';
+function runWalk(dir) {
+    const discovery = pythonGraphAdapter.discoverFiles({ cwd: dir });
+    const parsed = pythonGraphAdapter.parseProject({
+        projectDirAbs: discovery.projectDirAbs,
+        files: discovery.files,
+        compilerOptions: discovery.compilerOptions,
+        resolutionMode: 'exact',
+    });
+    return pythonGraphAdapter.walkProject({
+        project: parsed.project,
+        projectDirAbs: discovery.projectDirAbs,
+        files: discovery.files,
+    });
+}
+describe('lang-python walk.ts — function/param shapes', () => {
+    let dir;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), 'graph-python-shapes-'));
+    });
+    afterEach(() => {
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('extracts typed, default, and typed-default parameters', () => {
+        writeFileSync(join(dir, 'main.py'), `def f(x: int, y=1, z: str = "a", *args, **kwargs):\n    return (x, y, z, args, kwargs)\n`, 'utf8');
+        const walk = runWalk(dir);
+        const f = walk.occurrences.f?.[0];
+        expect(f).toBeDefined();
+        const names = f?.params.map((p) => p.name) ?? [];
+        expect(names).toContain('x');
+        expect(names).toContain('y');
+        expect(names).toContain('z');
+        // typed_default → optional
+        const z = f?.params.find((p) => p.name === 'z');
+        expect(z?.optional).toBe(true);
+        // default_parameter → optional
+        const y = f?.params.find((p) => p.name === 'y');
+        expect(y?.optional).toBe(true);
+        // typed_parameter (no default) → required
+        const x = f?.params.find((p) => p.name === 'x');
+        expect(x?.optional).toBe(false);
+    });
+    it('classifies methods and __init__ correctly', () => {
+        writeFileSync(join(dir, 'main.py'), `class C:\n    def __init__(self, p):\n        self.p = p\n\n    def m(self):\n        return self.p\n`, 'utf8');
+        const walk = runWalk(dir);
+        const init = walk.occurrences.__init__?.[0];
+        const m = walk.occurrences.m?.[0];
+        expect(init?.kind).toBe('constructor');
+        expect(init?.enclosingClass).toBe('C');
+        expect(m?.kind).toBe('method');
+        expect(m?.enclosingClass).toBe('C');
+    });
+    it('marks names starting with underscore as module-local visibility', () => {
+        writeFileSync(join(dir, 'main.py'), `def _private():\n    return 1\n\ndef public():\n    return 2\n`, 'utf8');
+        const walk = runWalk(dir);
+        expect(walk.occurrences._private?.[0]?.visibility).toBe('module-local');
+        expect(walk.occurrences.public?.[0]?.visibility).toBe('exported');
+    });
+    it('records a lambda occurrence with arrow kind and creation edge to enclosing function', () => {
+        writeFileSync(join(dir, 'main.py'), `def outer():\n    f = lambda n: n + 1\n    return f(2)\n`, 'utf8');
+        const walk = runWalk(dir);
+        const arrowNames = Object.keys(walk.occurrences).filter((k) => k.startsWith('<arrow:'));
+        expect(arrowNames.length).toBe(1);
+        const arrow = walk.occurrences[arrowNames[0]]?.[0];
+        expect(arrow?.kind).toBe('arrow');
+        // The lambda's params field comes from extractParamsFromField('parameters')
+        expect(arrow?.params.map((p) => p.name)).toContain('n');
+        // A creation call site should be recorded for the lambda
+        const creation = walk.callSites.find((c) => c.kind === 'creation');
+        expect(creation).toBeDefined();
+        expect(creation?.childHash).toBe(arrow?.bodyHash);
+    });
+    it('treats lambdas at module scope as their own owner (no creation edge to themselves)', () => {
+        // Lambda assigned at module level: parent frame is module-init.
+        // The creation edge IS emitted because module-init's bodyHash !=
+        // the lambda's bodyHash.
+        writeFileSync(join(dir, 'main.py'), `add = lambda a, b: a + b\n`, 'utf8');
+        const walk = runWalk(dir);
+        const arrowNames = Object.keys(walk.occurrences).filter((k) => k.startsWith('<arrow:'));
+        expect(arrowNames.length).toBe(1);
+        const creation = walk.callSites.find((c) => c.kind === 'creation');
+        expect(creation).toBeDefined();
+    });
+    it('flags tests/ files as inTestFile', () => {
+        mkdirSync(join(dir, 'tests'), { recursive: true });
+        writeFileSync(join(dir, 'tests/test_foo.py'), `def test_a():\n    assert True\n`, 'utf8');
+        const walk = runWalk(dir);
+        const a = walk.occurrences.test_a?.[0];
+        expect(a?.inTestFile).toBe(true);
+    });
+    it('flags _test.py files as inTestFile', () => {
+        writeFileSync(join(dir, 'foo_test.py'), `def t():\n    assert True\n`, 'utf8');
+        const walk = runWalk(dir);
+        const t = walk.occurrences.t?.[0];
+        expect(t?.inTestFile).toBe(true);
+    });
+    it('flags .generated. files as definedInGenerated', () => {
+        writeFileSync(join(dir, 'foo.generated.py'), `def x():\n    return 1\n`, 'utf8');
+        const walk = runWalk(dir);
+        const x = walk.occurrences.x?.[0];
+        expect(x?.definedInGenerated).toBe(true);
+    });
+    it('includes synthetic <module-init> occurrence for each file', () => {
+        writeFileSync(join(dir, 'a.py'), `def foo():\n    return 1\n`, 'utf8');
+        const walk = runWalk(dir);
+        const moduleInitKeys = Object.keys(walk.occurrences).filter((k) => k.startsWith('<module-init:'));
+        expect(moduleInitKeys.length).toBe(1);
+        const moduleInit = walk.occurrences[moduleInitKeys[0]]?.[0];
+        expect(moduleInit?.kind).toBe('module-init');
+        expect(moduleInit?.line).toBe(1);
+    });
+    it('skips files in input.files that are missing from project.files', () => {
+        writeFileSync(join(dir, 'a.py'), `def f():\n    return 1\n`, 'utf8');
+        const discovery = pythonGraphAdapter.discoverFiles({ cwd: dir });
+        const parsed = pythonGraphAdapter.parseProject({
+            projectDirAbs: discovery.projectDirAbs,
+            files: discovery.files,
+            compilerOptions: discovery.compilerOptions,
+            resolutionMode: 'exact',
+        });
+        // Pass an extra file that wasn't parsed — walkProject should skip it.
+        const walk = pythonGraphAdapter.walkProject({
+            project: parsed.project,
+            projectDirAbs: discovery.projectDirAbs,
+            files: [...discovery.files, join(dir, 'nonexistent.py')],
+        });
+        expect(Object.keys(walk.occurrences)).toContain('f');
+        expect(walk.parseErrors).toEqual([]);
+    });
+    it('exposes isTestFile predicate that detects tests/ paths and test_*.py / _test.py names', () => {
+        expect(isTestFile('tests/test_a.py')).toBe(true);
+        expect(isTestFile('src/test_foo.py')).toBe(true);
+        expect(isTestFile('src/foo_test.py')).toBe(true);
+        expect(isTestFile('src/foo.py')).toBe(false);
+        expect(isTestFile('test/foo.py')).toBe(true); // singular `test/` matches /tests?\//
+    });
+});
+//# sourceMappingURL=walk-shapes.test.js.map

package/dist/__tests__/walk-shapes.test.js.map

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

package/dist/__tests__/walk.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Branch-coverage tests for lang-python/walk.ts.
+ *
+ * Drives the full Python adapter (discover + parse + walk) over
+ * fixtures that include `#` comments and string literals. These
+ * exercise the comment-stripping helpers used by the body-hash
+ * normalizer.
+ */
+export {};
+//# sourceMappingURL=walk.test.d.ts.map

package/dist/__tests__/walk.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/walk.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/walk.test.js

@@ -0,0 +1,71 @@
+/**
+ * Branch-coverage tests for lang-python/walk.ts.
+ *
+ * Drives the full Python adapter (discover + parse + walk) over
+ * fixtures that include `#` comments and string literals. These
+ * exercise the comment-stripping helpers used by the body-hash
+ * normalizer.
+ */
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { pythonGraphAdapter } from '../index.js';
+describe('lang-python walk.ts — comment-stripping branches', () => {
+    let dir;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), 'graph-python-walk-'));
+    });
+    afterEach(() => {
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('walks a Python file with hash comments without error', () => {
+        writeFileSync(join(dir, 'main.py'), `# hello\ndef with_hash_comment():\n    # inner\n    return 1\n`, 'utf8');
+        const discovery = pythonGraphAdapter.discoverFiles({ cwd: dir });
+        const parsed = pythonGraphAdapter.parseProject({
+            projectDirAbs: discovery.projectDirAbs,
+            files: discovery.files,
+            compilerOptions: discovery.compilerOptions,
+            resolutionMode: 'exact',
+        });
+        const walk = pythonGraphAdapter.walkProject({
+            project: parsed.project,
+            projectDirAbs: discovery.projectDirAbs,
+            files: discovery.files,
+        });
+        expect(Object.keys(walk.occurrences)).toContain('with_hash_comment');
+    });
+    it('preserves string literals containing # characters', () => {
+        writeFileSync(join(dir, 'main.py'), `def with_string():\n    s = "not # a comment"\n    return s\n`, 'utf8');
+        const discovery = pythonGraphAdapter.discoverFiles({ cwd: dir });
+        const parsed = pythonGraphAdapter.parseProject({
+            projectDirAbs: discovery.projectDirAbs,
+            files: discovery.files,
+            compilerOptions: discovery.compilerOptions,
+            resolutionMode: 'exact',
+        });
+        const walk = pythonGraphAdapter.walkProject({
+            project: parsed.project,
+            projectDirAbs: discovery.projectDirAbs,
+            files: discovery.files,
+        });
+        expect(Object.keys(walk.occurrences)).toContain('with_string');
+    });
+    it('handles triple-quoted docstrings', () => {
+        writeFileSync(join(dir, 'main.py'), `def with_docstring():\n    """A docstring\n    multi-line.\n    """\n    return 1\n`, 'utf8');
+        const discovery = pythonGraphAdapter.discoverFiles({ cwd: dir });
+        const parsed = pythonGraphAdapter.parseProject({
+            projectDirAbs: discovery.projectDirAbs,
+            files: discovery.files,
+            compilerOptions: discovery.compilerOptions,
+            resolutionMode: 'exact',
+        });
+        const walk = pythonGraphAdapter.walkProject({
+            project: parsed.project,
+            projectDirAbs: discovery.projectDirAbs,
+            files: discovery.files,
+        });
+        expect(Object.keys(walk.occurrences)).toContain('with_docstring');
+    });
+});
+//# sourceMappingURL=walk.test.js.map

package/dist/__tests__/walk.test.js.map

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

package/dist/body-digest.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Body normalization + SHA-256 digest for Python.
+ *
+ * Extracted from `walk.ts` to keep that module focused on AST traversal
+ * and occurrence construction. The body-digest defines the catalog's
+ * `bodyHash` contract: walk produces it; resolve consumes it.
+ *
+ * Normalization differs from C-family adapters in two places:
+ *   - Real function bodies also strip a leading docstring (line-oriented
+ *     conservative detection: only the common leading-triple-quote
+ *     case).
+ *   - Synthetic bodies (module-init) skip the docstring strip — the
+ *     synthetic text isn't a function body.
+ */
+import { type BodyDigest } from '@opensip-cli/graph';
+export declare function digestPythonBody(text: string): BodyDigest;
+export declare function digestSyntheticBody(text: string): BodyDigest;
+//# sourceMappingURL=body-digest.d.ts.map

package/dist/body-digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-digest.d.ts","sourceRoot":"","sources":["../src/body-digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAiC,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE5D"}

package/dist/body-digest.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Body normalization + SHA-256 digest for Python.
+ *
+ * Extracted from `walk.ts` to keep that module focused on AST traversal
+ * and occurrence construction. The body-digest defines the catalog's
+ * `bodyHash` contract: walk produces it; resolve consumes it.
+ *
+ * Normalization differs from C-family adapters in two places:
+ *   - Real function bodies also strip a leading docstring (line-oriented
+ *     conservative detection: only the common leading-triple-quote
+ *     case).
+ *   - Synthetic bodies (module-init) skip the docstring strip — the
+ *     synthetic text isn't a function body.
+ */
+import { hashBody, normalizeWhitespace } from '@opensip-cli/graph';
+import { skipToEndOfLine } from '@opensip-cli/graph-adapter-common';
+export function digestPythonBody(text) {
+    return hashBody(normalizePythonBody(text));
+}
+export function digestSyntheticBody(text) {
+    return hashBody(normalizeWhitespace(stripPythonComments(text)));
+}
+/**
+ * Strip Python `#` comments and leading-of-body docstrings, then
+ * collapse whitespace. Docstring detection is line-oriented and
+ * conservative: a line containing only a triple-quoted string at the
+ * top of the body is removed. This is good enough for the v1 contract;
+ * a parse-tree-driven version is a follow-up if FP rates demand it.
+ */
+function normalizePythonBody(text) {
+    return normalizeWhitespace(stripPythonComments(stripLeadingDocstring(text)));
+}
+function stripPythonComments(text) {
+    // Walk character-by-character, respecting string literals (so `#`
+    // inside a string is preserved). Python strings are wrapped by `'`,
+    // `"`, or triple-quoted variants.
+    let out = '';
+    let i = 0;
+    while (i < text.length) {
+        const c = text[i];
+        if (c === '#') {
+            i = skipToEndOfLine(text, i);
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            const next = consumeStringLiteral(text, i, c);
+            out += next.text;
+            i = next.index;
+            continue;
+        }
+        out += c;
+        i++;
+    }
+    return out;
+}
+/* v8 ignore start */
+function consumeStringLiteral(text, start, quote) {
+    const triple = text.slice(start, start + 3) === `${quote}${quote}${quote}`;
+    const close = triple ? `${quote}${quote}${quote}` : quote;
+    let i = start + (triple ? 3 : 1);
+    let buf = text.slice(start, i);
+    while (i < text.length) {
+        if (text[i] === '\\' && i + 1 < text.length) {
+            buf += text.slice(i, i + 2);
+            i += 2;
+            continue;
+        }
+        if (text.slice(i, i + close.length) === close) {
+            buf += close;
+            i += close.length;
+            break;
+        }
+        buf += text[i];
+        i++;
+    }
+    return { text: buf, index: i };
+}
+/* v8 ignore stop */
+function stripLeadingDocstring(text) {
+    // Match an optional whitespace prefix followed by a triple-quoted
+    // string, optionally followed by a newline. Conservative — only
+    // handles the common case at the start of the function/module body.
+    const match = /^\s*(?:[ru]?(?:'''[\s\S]*?'''|"""[\s\S]*?"""))\s*\n/i.exec(text);
+    if (match)
+        return text.slice(match[0].length);
+    return text;
+}
+//# sourceMappingURL=body-digest.js.map

package/dist/body-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-digest.js","sourceRoot":"","sources":["../src/body-digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAmB,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,QAAQ,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACvC,OAAO,mBAAmB,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,kEAAkE;IAClE,oEAAoE;IACpE,kCAAkC;IAClC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACd,CAAC,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9C,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC;YACjB,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YACf,SAAS;QACX,CAAC;QACD,GAAG,IAAI,CAAC,CAAC;QACT,CAAC,EAAE,CAAC;IACN,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qBAAqB;AACrB,SAAS,oBAAoB,CAC3B,IAAY,EACZ,KAAa,EACb,KAAa;IAEb,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC;IAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1D,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5B,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC;YAC9C,GAAG,IAAI,KAAK,CAAC;YACb,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC;YAClB,MAAM;QACR,CAAC;QACD,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,CAAC,EAAE,CAAC;IACN,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AACjC,CAAC;AACD,oBAAoB;AAEpB,SAAS,qBAAqB,CAAC,IAAY;IACzC,kEAAkE;IAClE,gEAAgE;IAChE,oEAAoE;IACpE,MAAM,KAAK,GAAG,sDAAsD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cache-key.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Python cacheKey implementation.
+ *
+ * Produces `py-${pythonVersion}-${pyprojectContentHash || 'no-config'}`.
+ *
+ * The content-fingerprint half (`no-config` / `missing:` / `unreadable:` /
+ * sha256-prefix) is the byte-identical `hashConfig` contract shared with
+ * go/java/rust; Python imports it from
+ * `@opensip-cli/graph-adapter-common` and layers a best-effort
+ * "Python version" on top (DEC-4). The version comes from a
+ * `requires-python` line in `pyproject.toml` (PEP 621) — a string like
+ * `>=3.10,<4.0`, sanitized; absent → the literal `unknown`. It is a CACHE
+ * INVALIDATION key, not a source of truth — its only job is to flip when
+ * the toolchain intent changes.
+ *
+ * Per contract invariant I-6 the function is purely a function of
+ * `(pyproject content)`. Per I-8 we emit `py-`, distinct from the other
+ * adapters' prefixes.
+ */
+import type { CacheKeyInput } from '@opensip-cli/graph';
+export declare function cacheKey(input: CacheKeyInput): string;
+//# sourceMappingURL=cache-key.d.ts.map

package/dist/cache-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.d.ts","sourceRoot":"","sources":["../src/cache-key.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAIrD"}