@opensip-cli/graph-python 0.1.0

package/dist/rule-hints.js

@@ -0,0 +1,70 @@
+/**
+ * Python rule hints — declares language-specific signals for rules.
+ *
+ * Lands in PR 5 of plan docs/plans/10-graph-language-pluggability.md.
+ * Each hint maps a generic rule input ("what counts as a test file?",
+ * "what's a side-effect primitive?") onto Python conventions.
+ *
+ * Conservative on purpose: high-precision, low-recall. Rule authors may
+ * extend the lists over time as false negatives surface in practice.
+ */
+import { isTestFile } from './walk.js';
+/**
+ * Starter list of well-known Python side-effect primitives for
+ * `no-side-effect-path`. Names are textual prefixes a developer would
+ * actually write (e.g. `print(`, `os.system(`).
+ */
+const PYTHON_SIDE_EFFECT_PRIMITIVES = [
+    'print',
+    'os.system',
+    'os.remove',
+    'os.unlink',
+    'os.rmdir',
+    'os.write',
+    'os.makedirs',
+    'os.rename',
+    'subprocess.run',
+    'subprocess.Popen',
+    'subprocess.call',
+    'subprocess.check_call',
+    'subprocess.check_output',
+    'open',
+    'sys.exit',
+    'sys.stdout.write',
+    'sys.stderr.write',
+    'random.random',
+    'random.randint',
+    'random.choice',
+    'time.sleep',
+    'requests.get',
+    'requests.post',
+    'requests.put',
+    'requests.delete',
+    'shutil.rmtree',
+    'shutil.copy',
+    'shutil.move',
+];
+/**
+ * Throw-statement detection for `always-throws-branch`. Python's
+ * raise syntax: `raise SomeError(...)` or bare `raise`. We accept
+ * both forms by allowing optional whitespace and an optional
+ * identifier.
+ */
+const PYTHON_THROW_REGEX = /\braise\b(?:\s+[A-Za-z_][\w.]*)?/;
+/**
+ * Generated-file globs Python projects commonly use. The TypeScript
+ * adapter has its own list (`dist/`, `build/`, `.generated.`); we add
+ * Python-specific ones (`*_pb2.py` from protoc).
+ */
+const PYTHON_GENERATED_FILE_PATTERNS = [
+    '**/*_pb2.py',
+    '**/*_pb2_grpc.py',
+    '**/migrations/**',
+];
+export const pythonRuleHints = {
+    isTestFile,
+    generatedFilePatterns: PYTHON_GENERATED_FILE_PATTERNS,
+    sideEffectPrimitives: PYTHON_SIDE_EFFECT_PRIMITIVES,
+    throwSyntaxRegex: PYTHON_THROW_REGEX,
+};
+//# sourceMappingURL=rule-hints.js.map

package/dist/rule-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-hints.js","sourceRoot":"","sources":["../src/rule-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAIvC;;;;GAIG;AACH,MAAM,6BAA6B,GAAsB;IACvD,OAAO;IACP,WAAW;IACX,WAAW;IACX,WAAW;IACX,UAAU;IACV,UAAU;IACV,aAAa;IACb,WAAW;IACX,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,uBAAuB;IACvB,yBAAyB;IACzB,MAAM;IACN,UAAU;IACV,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,YAAY;IACZ,cAAc;IACd,eAAe;IACf,cAAc;IACd,iBAAiB;IACjB,eAAe;IACf,aAAa;IACb,aAAa;CACd,CAAC;AAEF;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,kCAAkC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,8BAA8B,GAAsB;IACxD,aAAa;IACb,kBAAkB;IAClB,kBAAkB;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAc;IACxC,UAAU;IACV,qBAAqB,EAAE,8BAA8B;IACrD,oBAAoB,EAAE,6BAA6B;IACnD,gBAAgB,EAAE,kBAAkB;CACrC,CAAC"}

package/dist/walk-dependencies.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Python import-statement → dependency-site emission.
+ *
+ * Extracted from `walk.ts` so the main walker stays focused on
+ * function-occurrence construction.
+ *
+ * Walk a Python file's top-level statements for `import_statement` and
+ * `import_from_statement` nodes; emit one `DependencySiteRecord` per
+ * imported module (not per imported name). The owner is the file's
+ * synthesized module-init occurrence (every file has exactly one).
+ *
+ * Phase 4 of opensip's substrate consolidation (DEC-498). The emitted
+ * `specifier` preserves the raw dotted module path as written, including
+ * any leading dots for relative imports (`'.foo'`, `'..pkg.bar'`).
+ *
+ * Out of scope at v1:
+ *   - Wildcard `from foo import *` is treated like any other from-import:
+ *     one dep site on the source module (`foo`); the `*` semantics
+ *     (re-exports) are not modelled.
+ *   - `__all__` semantics, dynamic `__import__` / `importlib.import_module`,
+ *     and conditional / nested imports inside function bodies (only
+ *     top-level imports are emitted).
+ */
+import type { PythonParsedFile } from './parse.js';
+import type { DependencySiteRecord } from '@opensip-cli/graph';
+export declare function collectDependencySites(file: PythonParsedFile, moduleInitHash: string, out: DependencySiteRecord[]): void;
+//# sourceMappingURL=walk-dependencies.d.ts.map

package/dist/walk-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-dependencies.d.ts","sourceRoot":"","sources":["../src/walk-dependencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,gBAAgB,EACtB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,oBAAoB,EAAE,GAC1B,IAAI,CAQN"}

package/dist/walk-dependencies.js

@@ -0,0 +1,152 @@
+/**
+ * @fileoverview Python import-statement → dependency-site emission.
+ *
+ * Extracted from `walk.ts` so the main walker stays focused on
+ * function-occurrence construction.
+ *
+ * Walk a Python file's top-level statements for `import_statement` and
+ * `import_from_statement` nodes; emit one `DependencySiteRecord` per
+ * imported module (not per imported name). The owner is the file's
+ * synthesized module-init occurrence (every file has exactly one).
+ *
+ * Phase 4 of opensip's substrate consolidation (DEC-498). The emitted
+ * `specifier` preserves the raw dotted module path as written, including
+ * any leading dots for relative imports (`'.foo'`, `'..pkg.bar'`).
+ *
+ * Out of scope at v1:
+ *   - Wildcard `from foo import *` is treated like any other from-import:
+ *     one dep site on the source module (`foo`); the `*` semantics
+ *     (re-exports) are not modelled.
+ *   - `__all__` semantics, dynamic `__import__` / `importlib.import_module`,
+ *     and conditional / nested imports inside function bodies (only
+ *     top-level imports are emitted).
+ */
+import { childrenOf, namedChildrenOf } from '@opensip-cli/graph-adapter-common';
+export function collectDependencySites(file, moduleInitHash, out) {
+    for (const stmt of namedChildrenOf(file.tree.rootNode)) {
+        if (stmt.type === 'import_statement') {
+            collectFromImportStatement(stmt, file, moduleInitHash, out);
+        }
+        else if (stmt.type === 'import_from_statement') {
+            collectFromImportFromStatement(stmt, file, moduleInitHash, out);
+        }
+    }
+}
+/**
+ * `import foo`, `import foo.bar`, `import foo as f`, `import a, b.c, d`.
+ * Each name child is either a `dotted_name` or an `aliased_import` whose
+ * `name` field is a `dotted_name`. Emits one dep site per top-level
+ * comma-separated target.
+ */
+function collectFromImportStatement(stmt, file, moduleInitHash, out) {
+    for (const child of namedChildrenOf(stmt)) {
+        const dotted = resolveImportedNameDotted(child);
+        if (!dotted)
+            continue;
+        pushDependencySite(stmt, file, moduleInitHash, dotted.text, out);
+    }
+}
+/**
+ * `from foo import x`, `from foo.bar import a, b`, `from . import x`,
+ * `from .pkg import y`, `from ..parent import z`.
+ *
+ * The module-name field encodes the source module:
+ *   - `dotted_name`     → absolute import (`from foo.bar import …`)
+ *   - `relative_import` → leading dot(s) + optional `dotted_name`
+ *
+ * For `from . import name`, the relative_import has only dots (no
+ * trailing dotted_name); the specifier is the leading-dot string
+ * (e.g. `'.'`) — the *imported names* are themselves modules to resolve.
+ * To preserve the one-dep-site-per-imported-module rule for this shape,
+ * we walk the `name` field too and emit one site per imported name,
+ * each carrying the prefix-dots + name (e.g. `.sibling`).
+ *
+ * For all other relative shapes (`from .pkg import x`, `from ..pkg.sub
+ * import y`), the relative_import already carries the module path; we
+ * emit ONE dep site with the raw relative-import text as specifier.
+ */
+function collectFromImportFromStatement(stmt, file, moduleInitHash, out) {
+    const moduleNameField = stmt.childForFieldName('module_name');
+    if (!moduleNameField)
+        return;
+    if (moduleNameField.type === 'dotted_name') {
+        pushDependencySite(stmt, file, moduleInitHash, moduleNameField.text, out);
+        return;
+    }
+    if (moduleNameField.type === 'relative_import') {
+        collectFromRelativeImport(stmt, moduleNameField, file, moduleInitHash, out);
+    }
+}
+/**
+ * Handle the `from <relative_import> import …` case. Splits into two
+ * shapes:
+ *   - relative_import carries an inner dotted_name (`from .pkg import x`)
+ *     → ONE dep site with `prefix + inner` as specifier.
+ *   - relative_import is dots-only (`from . import sibling, other`)
+ *     → ONE dep site PER imported name, specifier `prefix + name`.
+ */
+function collectFromRelativeImport(stmt, moduleNameField, file, moduleInitHash, out) {
+    const prefix = relativeImportPrefix(moduleNameField);
+    const innerDotted = relativeImportInnerDotted(moduleNameField);
+    if (innerDotted !== null) {
+        // `from .pkg import x` — one site, specifier = '.pkg'
+        pushDependencySite(stmt, file, moduleInitHash, prefix + innerDotted, out);
+        return;
+    }
+    // `from . import sibling, other` — one site PER imported name,
+    // specifier = `.sibling`, `.other`.
+    for (const named of namedChildrenOf(stmt)) {
+        // web-tree-sitter returns fresh Node wrappers per access, so `named`
+        // is never reference-identical to `moduleNameField`; skip the module
+        // node by its stable byte span instead of `===`.
+        if (named.startIndex === moduleNameField.startIndex)
+            continue;
+        const dotted = resolveImportedNameDotted(named);
+        if (!dotted)
+            continue;
+        pushDependencySite(stmt, file, moduleInitHash, prefix + dotted.text, out);
+    }
+}
+/**
+ * Resolve an imported-name child to its `dotted_name` node, if any.
+ * Accepts either a bare `dotted_name` or an `aliased_import` whose
+ * `name` field is a `dotted_name`. Returns null for anything else
+ * (e.g. punctuation, comments).
+ */
+function resolveImportedNameDotted(named) {
+    if (named.type === 'dotted_name')
+        return named;
+    if (named.type === 'aliased_import') {
+        const nameField = named.childForFieldName('name');
+        if (nameField?.type === 'dotted_name')
+            return nameField;
+    }
+    return null;
+}
+function relativeImportPrefix(node) {
+    // The `import_prefix` child carries the leading dots as raw text.
+    for (const child of childrenOf(node)) {
+        if (child.type === 'import_prefix')
+            return child.text;
+    }
+    /* v8 ignore next */
+    return '';
+}
+function relativeImportInnerDotted(node) {
+    for (const child of namedChildrenOf(node)) {
+        if (child.type === 'dotted_name')
+            return child.text;
+    }
+    return null;
+}
+function pushDependencySite(stmt, file, ownerHash, specifier, out) {
+    out.push({
+        nodeRef: stmt,
+        sourceFileRef: file,
+        ownerHash,
+        specifier,
+        line: stmt.startPosition.row + 1,
+        column: stmt.startPosition.column,
+    });
+}
+//# sourceMappingURL=walk-dependencies.js.map

package/dist/walk-dependencies.js.map

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

package/dist/walk.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Python walkProject — emit FunctionOccurrences + CallSiteRecords.
+ *
+ * One descent per file, mirroring lang-typescript/walk.ts. Identifies
+ * five callable shapes:
+ *
+ *   - `function_definition` outside a class body  → 'function-declaration'
+ *   - `function_definition` inside a class body   → 'method'
+ *   - `function_definition` named `__init__`      → 'constructor'
+ *   - `lambda`                                    → 'arrow'
+ *   - one synthetic `<module-init>` per file
+ *
+ * Body hashing: sha256 of normalized body text. "Normalized" means:
+ *   1. Strip Python comments (`#` to end-of-line).
+ *   2. Strip module-level / function-level docstrings — recognized as
+ *      a leading `expression_statement` whose only child is a `string`.
+ *      This is the textually-conservative choice; pretty-formatter
+ *      normalization (e.g. ruff/black-style reflow) is out of scope.
+ *   3. Collapse all whitespace runs to a single space, trim.
+ *
+ * Only string literals **at the top of a function body** are stripped
+ * as docstrings. String literals embedded in expressions are preserved.
+ *
+ * Call-site records:
+ *   - `call` node — every Python call expression (`foo()`, `obj.method(...)`,
+ *     `f.g.h()`).
+ *   - 'creation' edges — for each `lambda` expression nested inside a
+ *     parent function/method/module-init, emit a creation edge so
+ *     reachability flows through closures even when the lambda's
+ *     dispatch is unresolvable. Mirror of lang-typescript's
+ *     `isInlineCallable` rule applied to lambdas.
+ *
+ * Test detection happens here too (mirrors lang-typescript): we don't
+ * emit special records, but we tag each occurrence's `inTestFile` flag
+ * via the path predicate.
+ */
+import type { PythonParsedProject } from './parse.js';
+import type { WalkInput, WalkOutput } from '@opensip-cli/graph';
+declare const isTestFile: (rel: string) => boolean;
+export { isTestFile };
+export declare function walkProject(input: WalkInput<PythonParsedProject>): WalkOutput;
+//# sourceMappingURL=walk.d.ts.map

package/dist/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../src/walk.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAkBH,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAAsC,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOpG,QAAA,MAAQ,UAAU,0BAIhB,CAAC;AAEH,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,mBAAmB,CAAC,GAAG,UAAU,CAE7E"}

package/dist/walk.js

@@ -0,0 +1,281 @@
+// @fitness-ignore-file context-mutation -- `ctx: WalkCtx` here is a function-scoped traversal accumulator (callSites array, occurrence sink, parser refs) threaded through the AST walk, NOT a shared request/execution context. `ctx.callSites.push(...)` is the intended local-accumulator append. The check's `LOCAL_DECLARATION_PATTERNS` heuristic doesn't see it because `ctx` arrives as a typed parameter, not via `const ctx = …`.
+/**
+ * Python walkProject — emit FunctionOccurrences + CallSiteRecords.
+ *
+ * One descent per file, mirroring lang-typescript/walk.ts. Identifies
+ * five callable shapes:
+ *
+ *   - `function_definition` outside a class body  → 'function-declaration'
+ *   - `function_definition` inside a class body   → 'method'
+ *   - `function_definition` named `__init__`      → 'constructor'
+ *   - `lambda`                                    → 'arrow'
+ *   - one synthetic `<module-init>` per file
+ *
+ * Body hashing: sha256 of normalized body text. "Normalized" means:
+ *   1. Strip Python comments (`#` to end-of-line).
+ *   2. Strip module-level / function-level docstrings — recognized as
+ *      a leading `expression_statement` whose only child is a `string`.
+ *      This is the textually-conservative choice; pretty-formatter
+ *      normalization (e.g. ruff/black-style reflow) is out of scope.
+ *   3. Collapse all whitespace runs to a single space, trim.
+ *
+ * Only string literals **at the top of a function body** are stripped
+ * as docstrings. String literals embedded in expressions are preserved.
+ *
+ * Call-site records:
+ *   - `call` node — every Python call expression (`foo()`, `obj.method(...)`,
+ *     `f.g.h()`).
+ *   - 'creation' edges — for each `lambda` expression nested inside a
+ *     parent function/method/module-init, emit a creation edge so
+ *     reachability flows through closures even when the lambda's
+ *     dispatch is unresolvable. Mirror of lang-typescript's
+ *     `isInlineCallable` rule applied to lambdas.
+ *
+ * Test detection happens here too (mirrors lang-typescript): we don't
+ * emit special records, but we tag each occurrence's `inTestFile` flag
+ * via the path predicate.
+ */
+import { relative, sep } from 'node:path';
+import { childrenOf, makeFileClassifier, namedChildrenOf, nameOf, record, runWalk, synthesizeModuleInit as buildModuleInit, } from '@opensip-cli/graph-adapter-common';
+import { digestPythonBody, digestSyntheticBody } from './body-digest.js';
+import { collectDependencySites } from './walk-dependencies.js';
+const TEST_PATH_RE = /(?:^|\/)tests?\//;
+const TEST_FILE_NAME_RE = /(?:^|\/)test_[^/]+\.py$|_test\.py$/;
+const GENERATED_PATH_RE = /\bdist\/|\bbuild\/|\.generated\./;
+const { isTestFile, isGeneratedFile } = makeFileClassifier({
+    testRe: TEST_FILE_NAME_RE,
+    generatedRe: GENERATED_PATH_RE,
+    testPathRe: TEST_PATH_RE,
+});
+export { isTestFile };
+export function walkProject(input) {
+    return runWalk({ input, walkFile });
+}
+function walkFile(absPath, file, projectDirAbs, sinks) {
+    const { occurrences: out, callSites, dependencySites } = sinks;
+    const filePathProjectRel = relative(projectDirAbs, absPath).split(sep).join('/');
+    const inTestFile = isTestFile(filePathProjectRel);
+    const definedInGenerated = isGeneratedFile(filePathProjectRel);
+    const qualifiedBase = filePathProjectRel.replace(/\.py$/, '').split('/').join('.');
+    const moduleInit = buildModuleInit({
+        file,
+        filePathProjectRel,
+        inTestFile,
+        definedInGenerated,
+        digestSyntheticBody,
+        qualifiedName: `${qualifiedBase}.<module-init>`,
+    });
+    record(out, moduleInit);
+    // Phase 4 (DEC-498): walk top-level imports as dependency sites. Owner
+    // is the file's synthesized module-init occurrence.
+    collectDependencySites(file, moduleInit.bodyHash, dependencySites);
+    const initialFrame = {
+        ownerHash: moduleInit.bodyHash,
+        enclosingClass: null,
+    };
+    const ctx = {
+        file,
+        filePathProjectRel,
+        inTestFile,
+        definedInGenerated,
+        out,
+        callSites,
+    };
+    for (const child of childrenOf(file.tree.rootNode))
+        visit(child, initialFrame, ctx);
+}
+// @graph-ignore-next-line graph:cycle -- intentional recursive-descent AST visitor; the cycle is the traversal (visit re-enters via the class/function helpers)
+function visit(node, frame, ctx) {
+    if (node.type === 'class_definition') {
+        visitClass(node, frame, ctx);
+        return;
+    }
+    if (node.type === 'function_definition') {
+        visitFunction(node, frame, ctx);
+        return;
+    }
+    if (node.type === 'lambda' && visitLambdaNode(node, frame, ctx)) {
+        return;
+    }
+    if (node.type === 'call') {
+        ctx.callSites.push({
+            nodeRef: node,
+            sourceFileRef: ctx.file,
+            ownerHash: frame.ownerHash,
+            kind: 'call',
+        });
+    }
+    for (const child of childrenOf(node))
+        visit(child, frame, ctx);
+}
+function visitClass(node, frame, ctx) {
+    const className = nameOf(node) ?? '<anon-class>';
+    // Don't emit a function for the class itself — Python classes are
+    // declarations whose top-level statements run at module load. Keep
+    // the module-init as the owner; descend with class context for
+    // nested function_definitions to be tagged as methods.
+    const childFrame = { ownerHash: frame.ownerHash, enclosingClass: className };
+    for (const child of childrenOf(node))
+        visit(child, childFrame, ctx);
+}
+function visitFunction(node, frame, ctx) {
+    const occ = visitFunctionDefinition(node, frame.enclosingClass, ctx);
+    if (!occ)
+        return;
+    record(ctx.out, occ);
+    const childFrame = { ownerHash: occ.bodyHash, enclosingClass: null };
+    const body = node.childForFieldName('body');
+    if (body) {
+        for (const child of childrenOf(body))
+            visit(child, childFrame, ctx);
+    }
+}
+function visitLambdaNode(node, frame, ctx) {
+    const occ = visitLambda(node, ctx);
+    if (!occ)
+        return false;
+    record(ctx.out, occ);
+    if (frame.ownerHash !== occ.bodyHash) {
+        ctx.callSites.push({
+            nodeRef: node,
+            sourceFileRef: ctx.file,
+            ownerHash: frame.ownerHash,
+            kind: 'creation',
+            childHash: occ.bodyHash,
+        });
+    }
+    const body = node.childForFieldName('body');
+    if (body) {
+        visit(body, { ownerHash: occ.bodyHash, enclosingClass: null }, ctx);
+    }
+    return true;
+}
+function visitFunctionDefinition(node, enclosingClass, ctx) {
+    const { file, filePathProjectRel, inTestFile, definedInGenerated } = ctx;
+    const name = nameOf(node) ?? '<anon-fn>';
+    const digest = digestPythonBody(file.source.slice(node.startIndex, node.endIndex));
+    const kind = classifyFunctionKind(name, enclosingClass);
+    const qualifiedBase = filePathProjectRel.replace(/\.py$/, '').split('/').join('.');
+    const qualifiedName = enclosingClass === null
+        ? `${qualifiedBase}.${name}`
+        : `${qualifiedBase}.${enclosingClass}.${name}`;
+    return {
+        bodyHash: digest.hash,
+        bodySize: digest.size,
+        simpleName: name,
+        qualifiedName,
+        filePath: filePathProjectRel,
+        line: node.startPosition.row + 1,
+        column: node.startPosition.column,
+        endLine: node.endPosition.row + 1,
+        kind,
+        params: extractParams(node),
+        returnType: null,
+        enclosingClass,
+        decorators: extractDecorators(node),
+        visibility: name.startsWith('_') ? 'module-local' : 'exported',
+        inTestFile,
+        definedInGenerated,
+        calls: [],
+    };
+}
+function classifyFunctionKind(name, enclosingClass) {
+    if (enclosingClass === null)
+        return 'function-declaration';
+    if (name === '__init__')
+        return 'constructor';
+    return 'method';
+}
+function visitLambda(node, ctx) {
+    const { file, filePathProjectRel, inTestFile, definedInGenerated } = ctx;
+    const digest = digestPythonBody(file.source.slice(node.startIndex, node.endIndex));
+    const startLine = node.startPosition.row + 1;
+    const startCol = node.startPosition.column;
+    const simpleName = `<arrow:${filePathProjectRel}:${String(startLine)}:${String(startCol)}>`;
+    const qualifiedBase = filePathProjectRel.replace(/\.py$/, '').split('/').join('.');
+    return {
+        bodyHash: digest.hash,
+        bodySize: digest.size,
+        simpleName,
+        qualifiedName: `${qualifiedBase}.<lambda:${String(startLine)}:${String(startCol)}>`,
+        filePath: filePathProjectRel,
+        line: startLine,
+        column: startCol,
+        endLine: node.endPosition.row + 1,
+        kind: 'arrow',
+        params: extractParamsFromField(node, 'parameters'),
+        returnType: null,
+        enclosingClass: null,
+        decorators: [],
+        visibility: 'private',
+        inTestFile,
+        definedInGenerated,
+        calls: [],
+    };
+}
+// ── helpers ───────────────────────────────────────────────────────
+function extractParams(node) {
+    return extractParamsFromField(node, 'parameters');
+}
+function extractParamsFromField(node, fieldName) {
+    const params = node.childForFieldName(fieldName);
+    if (!params)
+        return [];
+    const out = [];
+    for (const child of namedChildrenOf(params)) {
+        const param = extractParam(child);
+        if (param)
+            out.push(param);
+    }
+    return out;
+}
+function extractParam(child) {
+    switch (child.type) {
+        case 'identifier': {
+            return { name: child.text, optional: false, rest: false };
+        }
+        case 'typed_parameter':
+        case 'default_parameter':
+        case 'typed_default_parameter': {
+            const name = child.childForFieldName('name') ?? child.namedChild(0);
+            if (!name)
+                return null;
+            return {
+                name: name.text,
+                optional: child.type === 'default_parameter' || child.type === 'typed_default_parameter',
+                rest: false,
+            };
+        }
+        /* v8 ignore start */
+        case 'list_splat_pattern':
+        case 'dictionary_splat_pattern': {
+            const name = child.namedChild(0);
+            if (!name)
+                return null;
+            return { name: name.text, optional: false, rest: true };
+        }
+        default: {
+            return null;
+        }
+        /* v8 ignore stop */
+    }
+}
+function extractDecorators(node) {
+    // tree-sitter-python wraps a function_definition in a `decorated_definition`
+    // node when decorators are present. The decorators are siblings of the
+    // function_definition inside that wrapper.
+    if (node.parent?.type !== 'decorated_definition')
+        return [];
+    /* v8 ignore start */
+    const out = [];
+    for (const child of namedChildrenOf(node.parent)) {
+        if (child.type === 'decorator') {
+            // Decorator text is `@expr`; trim the leading `@`.
+            const text = child.text.trim();
+            out.push(text.startsWith('@') ? text.slice(1) : text);
+        }
+    }
+    return out;
+    /* v8 ignore stop */
+}
+//# sourceMappingURL=walk.js.map

package/dist/walk.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@opensip-cli/graph-python",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "description": "Python language adapter for the opensip graph engine",
+  "keywords": [
+    "opensip-cli",
+    "static-analysis",
+    "code-quality",
+    "call-graph",
+    "dependency-graph",
+    "python"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opensip-ai/opensip-cli.git",
+    "directory": "packages/graph/graph-python"
+  },
+  "homepage": "https://github.com/opensip-ai/opensip-cli",
+  "bugs": {
+    "url": "https://github.com/opensip-ai/opensip-cli/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "opensipTools": {
+    "kind": "graph-adapter"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "@opensip-cli/core": "0.1.0",
+    "@opensip-cli/graph-adapter-common": "0.1.0",
+    "@opensip-cli/lang-python": "0.1.0",
+    "@opensip-cli/tree-sitter": "0.1.0",
+    "@opensip-cli/graph": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}