@opensip-cli/graph-python 0.1.0

package/dist/cache-key.js

@@ -0,0 +1,52 @@
+// @fitness-ignore-file unbounded-memory -- reads pyproject.toml manifest; bounded by standard Python project metadata
+/**
+ * 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 { existsSync, readFileSync } from 'node:fs';
+import { hashConfig } from '@opensip-cli/graph-adapter-common';
+// Anchored to start-of-line; horizontal whitespace ([\t ]) and the
+// inner `[^"'\n]` keep matching linear. Using `\s` would cross
+// newlines and let pathological inputs explore O(n^2) prefixes.
+const REQUIRES_PYTHON_RE = /^[\t ]*requires-python[\t ]*=[\t ]*["']([^"'\n]+)["']/m;
+export function cacheKey(input) {
+    const configHash = hashConfig(input.configPathAbs);
+    const pythonVersion = readPythonVersion(input.configPathAbs);
+    return `py-${pythonVersion}-${configHash}`;
+}
+function readPythonVersion(configPathAbs) {
+    if (configPathAbs === undefined || configPathAbs.length === 0)
+        return 'unknown';
+    if (!existsSync(configPathAbs))
+        return 'unknown';
+    let content;
+    try {
+        content = readFileSync(configPathAbs, 'utf8');
+    }
+    catch {
+        /* v8 ignore next */
+        return 'unknown';
+    }
+    const match = REQUIRES_PYTHON_RE.exec(content);
+    return match ? sanitize(match[1] ?? 'unknown') : 'unknown';
+}
+function sanitize(s) {
+    // Keep cache-key strings shell- and filename-safe.
+    return s.replaceAll(/[^A-Za-z0-9._+-]/g, '_').slice(0, 32);
+}
+//# sourceMappingURL=cache-key.js.map

package/dist/cache-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.js","sourceRoot":"","sources":["../src/cache-key.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAI/D,mEAAmE;AACnE,+DAA+D;AAC/D,gEAAgE;AAChE,MAAM,kBAAkB,GAAG,wDAAwD,CAAC;AAEpF,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC7D,OAAO,MAAM,aAAa,IAAI,UAAU,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,iBAAiB,CAAC,aAAiC;IAC1D,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAChF,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,mDAAmD;IACnD,OAAO,CAAC,CAAC,UAAU,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/discover.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Python file discovery — Stage 0 for the Python adapter.
+ *
+ * Strategy:
+ *   1. If `pyproject.toml` is present, use it as the language config
+ *      anchor for cacheKey. We do NOT parse `[tool.opensip-graph].include`;
+ *      that's a future enhancement. We just record the file path.
+ *   2. If `setup.py` is present (and no pyproject.toml), use it as the
+ *      anchor instead.
+ *   3. Walk the project tree collecting all `.py` files, excluding
+ *      common non-source directories (`.venv`, `venv`, `__pycache__`,
+ *      `.tox`, `node_modules`, `dist`, `build`, `.eggs`).
+ *
+ * The collect-loop / realpath-dedup / config-precedence scaffolding lives
+ * in `@opensip-cli/graph-adapter-common`; this module supplies only the
+ * Python-specific inputs.
+ */
+export declare const discoverFiles: (input: import("@opensip-cli/graph").DiscoverInput) => import("@opensip-cli/graph").DiscoverOutput;
+//# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAiBH,eAAO,MAAM,aAAa,oGAKxB,CAAC"}

package/dist/discover.js

@@ -0,0 +1,36 @@
+/**
+ * Python file discovery — Stage 0 for the Python adapter.
+ *
+ * Strategy:
+ *   1. If `pyproject.toml` is present, use it as the language config
+ *      anchor for cacheKey. We do NOT parse `[tool.opensip-graph].include`;
+ *      that's a future enhancement. We just record the file path.
+ *   2. If `setup.py` is present (and no pyproject.toml), use it as the
+ *      anchor instead.
+ *   3. Walk the project tree collecting all `.py` files, excluding
+ *      common non-source directories (`.venv`, `venv`, `__pycache__`,
+ *      `.tox`, `node_modules`, `dist`, `build`, `.eggs`).
+ *
+ * The collect-loop / realpath-dedup / config-precedence scaffolding lives
+ * in `@opensip-cli/graph-adapter-common`; this module supplies only the
+ * Python-specific inputs.
+ */
+import { createDiscover } from '@opensip-cli/graph-adapter-common';
+const EXCLUDED_DIR_GLOBS = [
+    '**/.venv/**',
+    '**/venv/**',
+    '**/__pycache__/**',
+    '**/.tox/**',
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/.eggs/**',
+];
+const CONFIG_CANDIDATES = ['pyproject.toml', 'setup.py'];
+export const discoverFiles = createDiscover({
+    extension: 'py',
+    excludedDirGlobs: EXCLUDED_DIR_GLOBS,
+    configCandidates: CONFIG_CANDIDATES,
+    languageId: 'python',
+});
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,MAAM,kBAAkB,GAAsB;IAC5C,aAAa;IACb,YAAY;IACZ,mBAAmB;IACnB,YAAY;IACZ,oBAAoB;IACpB,YAAY;IACZ,aAAa;IACb,aAAa;CACd,CAAC;AAEF,MAAM,iBAAiB,GAAsB,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;IAC1C,SAAS,EAAE,IAAI;IACf,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,iBAAiB;IACnC,UAAU,EAAE,QAAQ;CACrB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @opensip-cli/graph — Python language adapter.
+ *
+ * Lands in PR 5 of plan docs/plans/10-graph-language-pluggability.md.
+ * Exposes `pythonGraphAdapter`, a `GraphLanguageAdapter` backed by
+ * tree-sitter-python.
+ *
+ * Per-rule fidelity (plan §6 row "Tree-sitter adapter"): mostly
+ * `'medium'` confidence on calls; `'low'` when multiple catalog
+ * entries share a simple name. The adapter has no symbol table.
+ *
+ * File layout mirrors `lang-typescript/`:
+ *   discoverFiles    → ./discover.ts
+ *   parseProject     → ./parse.ts
+ *   walkProject      → ./walk.ts
+ *   resolveCallSites → ./resolve.ts
+ *   cacheKey         → ./cache-key.ts
+ *   ruleHints        → ./rule-hints.ts
+ *
+ * Production graph adapters are forbidden from importing `web-tree-sitter`
+ * directly; the ADR-0010 restricted-import rule in the shared ESLint config
+ * enforces it.
+ */
+import { cacheKey as pythonCacheKey } from './cache-key.js';
+import { resolveCallSites as pythonResolveCallSites } from './resolve.js';
+import { walkProject as pythonWalkProject } from './walk.js';
+export declare const pythonGraphAdapter: {
+    id: string;
+    fileExtensions: string[];
+    displayName: string;
+    discoverFiles: (input: import("@opensip-cli/graph").DiscoverInput) => import("@opensip-cli/graph").DiscoverOutput;
+    parseProject: (input: import("@opensip-cli/graph").ParseInput) => import("@opensip-cli/graph").ParseOutput<import("@opensip-cli/graph-adapter-common").TreeSitterParsedProject>;
+    walkProject: typeof pythonWalkProject;
+    resolveCallSites: typeof pythonResolveCallSites;
+    cacheKey: typeof pythonCacheKey;
+    ruleHints: import("@opensip-cli/graph").RuleHints;
+};
+/**
+ * Discovery contract: external adapter packs export `adapter` (the
+ * GraphLanguageAdapter) and `metadata`. The CLI bootstrap registers
+ * `adapter` into the adapter registry after a successful `import()`.
+ */
+export { pythonGraphAdapter as adapter };
+export declare const metadata: {
+    readonly id: string;
+    readonly displayName: string;
+    readonly fileExtensions: string[];
+};
+export type { PythonParsedProject } from './parse.js';
+export { pythonRuleHints } from './rule-hints.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG5D,OAAO,EAAE,gBAAgB,IAAI,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAK7D,eAAO,MAAM,kBAAkB;;;;;;;;;;CAUsB,CAAC;AAEtD;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,IAAI,OAAO,EAAE,CAAC;AACzC,eAAO,MAAM,QAAQ;;;;CAIX,CAAC;AAMX,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,53 @@
+/**
+ * @opensip-cli/graph — Python language adapter.
+ *
+ * Lands in PR 5 of plan docs/plans/10-graph-language-pluggability.md.
+ * Exposes `pythonGraphAdapter`, a `GraphLanguageAdapter` backed by
+ * tree-sitter-python.
+ *
+ * Per-rule fidelity (plan §6 row "Tree-sitter adapter"): mostly
+ * `'medium'` confidence on calls; `'low'` when multiple catalog
+ * entries share a simple name. The adapter has no symbol table.
+ *
+ * File layout mirrors `lang-typescript/`:
+ *   discoverFiles    → ./discover.ts
+ *   parseProject     → ./parse.ts
+ *   walkProject      → ./walk.ts
+ *   resolveCallSites → ./resolve.ts
+ *   cacheKey         → ./cache-key.ts
+ *   ruleHints        → ./rule-hints.ts
+ *
+ * Production graph adapters are forbidden from importing `web-tree-sitter`
+ * directly; the ADR-0010 restricted-import rule in the shared ESLint config
+ * enforces it.
+ */
+import { cacheKey as pythonCacheKey } from './cache-key.js';
+import { discoverFiles as pythonDiscoverFiles } from './discover.js';
+import { parseProject as pythonParseProject } from './parse.js';
+import { resolveCallSites as pythonResolveCallSites } from './resolve.js';
+import { pythonRuleHints } from './rule-hints.js';
+import { walkProject as pythonWalkProject } from './walk.js';
+export const pythonGraphAdapter = {
+    id: 'python',
+    fileExtensions: ['.py'],
+    displayName: 'Python',
+    discoverFiles: pythonDiscoverFiles,
+    parseProject: pythonParseProject,
+    walkProject: pythonWalkProject,
+    resolveCallSites: pythonResolveCallSites,
+    cacheKey: pythonCacheKey,
+    ruleHints: pythonRuleHints,
+};
+/**
+ * Discovery contract: external adapter packs export `adapter` (the
+ * GraphLanguageAdapter) and `metadata`. The CLI bootstrap registers
+ * `adapter` into the adapter registry after a successful `import()`.
+ */
+export { pythonGraphAdapter as adapter };
+export const metadata = {
+    id: pythonGraphAdapter.id,
+    displayName: pythonGraphAdapter.displayName,
+    fileExtensions: pythonGraphAdapter.fileExtensions,
+};
+export { pythonRuleHints } from './rule-hints.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,gBAAgB,IAAI,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAK7D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,QAAQ;IACZ,cAAc,EAAE,CAAC,KAAK,CAAC;IACvB,WAAW,EAAE,QAAQ;IACrB,aAAa,EAAE,mBAAmB;IAClC,YAAY,EAAE,kBAAkB;IAChC,WAAW,EAAE,iBAAiB;IAC9B,gBAAgB,EAAE,sBAAsB;IACxC,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;CACyB,CAAC;AAEtD;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,IAAI,OAAO,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,EAAE,EAAE,kBAAkB,CAAC,EAAE;IACzB,WAAW,EAAE,kBAAkB,CAAC,WAAW;IAC3C,cAAc,EAAE,kBAAkB,CAAC,cAAc;CACzC,CAAC;AAOX,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Python parseProject — consumes `@opensip-cli/lang-python` (ADR-0010).
+ *
+ * `lang-python` is the canonical Python parse substrate: it owns the vendored
+ * tree-sitter-python grammar and produces the `{ tree, source }` parsed-file
+ * shape. The graph adapter no longer loads a grammar of its own; it binds the
+ * shared `createParseProjectFromAdapter` driver to `pythonAdapter`. This
+ * mirrors `graph-typescript`'s dependency on `lang-typescript`, generalizing
+ * the `graph-* → lang-*` edge to Python. The parsed-project shape and the
+ * downstream walk/resolve are unchanged.
+ */
+import { type TreeSitterParsedFile, type TreeSitterParsedProject } from '@opensip-cli/graph-adapter-common';
+/** Parsed Python source file: tree-sitter parse tree plus original source text. */
+export type PythonParsedFile = TreeSitterParsedFile;
+/**
+ * Parsed Python project: map of normalized file path → {@link PythonParsedFile}.
+ * Keyed by the absolute, realpath-normalized file path from discover.
+ */
+export type PythonParsedProject = TreeSitterParsedProject<PythonParsedFile>;
+/** Parses every Python source file in the input set into a {@link PythonParsedProject}. */
+export declare const parseProject: (input: import("@opensip-cli/graph").ParseInput) => import("@opensip-cli/graph").ParseOutput<TreeSitterParsedProject>;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,mCAAmC,CAAC;AAG3C,mFAAmF;AACnF,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;AAE5E,2FAA2F;AAC3F,eAAO,MAAM,YAAY,uHAA+C,CAAC"}

package/dist/parse.js

@@ -0,0 +1,16 @@
+/**
+ * Python parseProject — consumes `@opensip-cli/lang-python` (ADR-0010).
+ *
+ * `lang-python` is the canonical Python parse substrate: it owns the vendored
+ * tree-sitter-python grammar and produces the `{ tree, source }` parsed-file
+ * shape. The graph adapter no longer loads a grammar of its own; it binds the
+ * shared `createParseProjectFromAdapter` driver to `pythonAdapter`. This
+ * mirrors `graph-typescript`'s dependency on `lang-typescript`, generalizing
+ * the `graph-* → lang-*` edge to Python. The parsed-project shape and the
+ * downstream walk/resolve are unchanged.
+ */
+import { createParseProjectFromAdapter, } from '@opensip-cli/graph-adapter-common';
+import { pythonAdapter } from '@opensip-cli/lang-python';
+/** Parses every Python source file in the input set into a {@link PythonParsedProject}. */
+export const parseProject = createParseProjectFromAdapter(pythonAdapter);
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,6BAA6B,GAG9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAWzD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,YAAY,GAAG,6BAA6B,CAAC,aAAa,CAAC,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Python resolveCallSites — name-based catalog lookup.
+ *
+ * Tree-sitter has no symbol table, so we resolve by simple name. For
+ * each call site:
+ *
+ *   1. Decode the called expression. Three shapes matter:
+ *      - `foo(args)`               → call target is identifier `foo`
+ *      - `obj.method(args)`        → call target is attribute `method`
+ *      - `mod.submod.fn(args)`     → call target is attribute `fn`
+ *      Other shapes (`(lambda)()`, subscript calls) are treated as
+ *      unresolved.
+ *
+ *   2. Look up matching catalog entries by simple name. Confidence
+ *      ladder:
+ *      - 0 matches  → `to: []`, resolution `'unknown'`,    confidence `'low'`
+ *      - 1 match    → `to: [hash]`, resolution `'static'`, confidence `'medium'`
+ *      - N matches  → `to: [allHashes]`, resolution `'method-dispatch'`,
+ *                     confidence `'low'` (multiple candidates means we
+ *                     can't disambiguate without a symbol table)
+ *
+ * Confidence is mostly `'medium'`, never `'high'` — that's the
+ * intrinsic price of name-based resolution. The plan §6 fidelity table
+ * documents this (`orphan-subtree`: medium for tree-sitter adapters).
+ *
+ * Creation edges (lambda) emit a static high-confidence edge directly,
+ * mirroring lang-typescript's semantics.
+ *
+ * Per I-4: this function does NOT mutate the input catalog. It builds
+ * a `bodyHash → CallEdge[]` map and returns it.
+ */
+import type { PythonParsedProject } from './parse.js';
+import type { ResolveInput, ResolveOutput } from '@opensip-cli/graph';
+export declare function resolveCallSites(input: ResolveInput<PythonParsedProject>): ResolveOutput;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAaH,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAOV,YAAY,EACZ,aAAa,EACd,MAAM,oBAAoB,CAAC;AAkB5B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,CAAC,mBAAmB,CAAC,GAAG,aAAa,CA2CxF"}

package/dist/resolve.js

@@ -0,0 +1,294 @@
+/**
+ * Python resolveCallSites — name-based catalog lookup.
+ *
+ * Tree-sitter has no symbol table, so we resolve by simple name. For
+ * each call site:
+ *
+ *   1. Decode the called expression. Three shapes matter:
+ *      - `foo(args)`               → call target is identifier `foo`
+ *      - `obj.method(args)`        → call target is attribute `method`
+ *      - `mod.submod.fn(args)`     → call target is attribute `fn`
+ *      Other shapes (`(lambda)()`, subscript calls) are treated as
+ *      unresolved.
+ *
+ *   2. Look up matching catalog entries by simple name. Confidence
+ *      ladder:
+ *      - 0 matches  → `to: []`, resolution `'unknown'`,    confidence `'low'`
+ *      - 1 match    → `to: [hash]`, resolution `'static'`, confidence `'medium'`
+ *      - N matches  → `to: [allHashes]`, resolution `'method-dispatch'`,
+ *                     confidence `'low'` (multiple candidates means we
+ *                     can't disambiguate without a symbol table)
+ *
+ * Confidence is mostly `'medium'`, never `'high'` — that's the
+ * intrinsic price of name-based resolution. The plan §6 fidelity table
+ * documents this (`orphan-subtree`: medium for tree-sitter adapters).
+ *
+ * Creation edges (lambda) emit a static high-confidence edge directly,
+ * mirroring lang-typescript's semantics.
+ *
+ * Per I-4: this function does NOT mutate the input catalog. It builds
+ * a `bodyHash → CallEdge[]` map and returns it.
+ */
+import { dirname, posix } from 'node:path';
+import { logger } from '@opensip-cli/core';
+import { appendEdge, createMutableStats, pushCreationEdge, truncateForCallEdge, } from '@opensip-cli/graph';
+import { buildNameIndex } from '@opensip-cli/graph-adapter-common';
+function pythonPosition(node, file) {
+    return {
+        line: node.startPosition.row + 1,
+        column: node.startPosition.column,
+        text: file.source.slice(node.startIndex, node.endIndex),
+    };
+}
+export function resolveCallSites(input) {
+    logger.info({ evt: 'graph.edges.start', module: 'graph:edges:python' });
+    const byName = buildNameIndex(input.catalog.functions);
+    const edgesByOwner = new Map();
+    const stats = createMutableStats();
+    const sink = { edgesByOwner, stats };
+    for (const r of input.callSites) {
+        const node = r.nodeRef;
+        const file = r.sourceFileRef;
+        if (r.kind === 'creation') {
+            if (r.childHash === undefined)
+                continue;
+            pushCreationEdge(pythonPosition(node, file), r.ownerHash, r.childHash, sink);
+            continue;
+        }
+        pushCallEdge(node, file, r.ownerHash, byName, sink);
+    }
+    const finalStats = {
+        totalCallSites: stats.totalCallSites,
+        resolvedHigh: stats.resolvedHigh,
+        resolvedMedium: stats.resolvedMedium,
+        resolvedLow: stats.resolvedLow,
+        unresolved: stats.unresolved,
+    };
+    logger.info({
+        evt: 'graph.edges.complete',
+        module: 'graph:edges:python',
+        ...finalStats,
+    });
+    // Phase 4 (DEC-498): resolve dependency sites if any. Mirrors the TS
+    // adapter's resolveDependencies pattern adapted to Python's path-based
+    // module discovery (no symbol table, no tsconfig resolution).
+    const dependenciesByOwner = input.dependencySites && input.dependencySites.length > 0
+        ? resolveDependencies(input.dependencySites, input.catalog)
+        : undefined;
+    return dependenciesByOwner === undefined
+        ? { edgesByOwner, stats: finalStats }
+        : { edgesByOwner, dependenciesByOwner, stats: finalStats };
+}
+/**
+ * Resolve Python import sites to target module-init bodyHashes. Imports
+ * resolving to an in-catalog `.py` (or `__init__.py`) source file map to
+ * that file's module-init occurrence; imports resolving to standard-
+ * library or third-party packages (outside the catalog) produce
+ * unresolved `DependencyEdge` entries with `to: []` and the raw specifier
+ * carried in `specifier` for downstream attribution.
+ *
+ * Python lacks a tsconfig-equivalent resolver, so this implements the
+ * standard CPython search-path rules constrained to the project:
+ *
+ *   - Absolute dotted (`foo.bar`) → `foo/bar.py` or `foo/bar/__init__.py`
+ *     relative to the project root.
+ *   - Relative (`.foo`, `..pkg.sub`) → resolve relative to the importing
+ *     file's directory, walking up one level per leading dot beyond the
+ *     first (which means the current package).
+ *
+ * Phase 4 of opensip's substrate consolidation (DEC-498).
+ */
+function resolveDependencies(sites, catalog) {
+    // Build filePath → module-init bodyHash map. Catalog occurrences carry
+    // project-relative POSIX filePath; module-init kind is filtered.
+    const moduleInitByFilePath = new Map();
+    for (const occs of Object.values(catalog.functions)) {
+        if (!occs)
+            continue;
+        for (const o of occs) {
+            if (o.kind === 'module-init')
+                moduleInitByFilePath.set(o.filePath, o.bodyHash);
+        }
+    }
+    const out = new Map();
+    for (const site of sites) {
+        const file = site.sourceFileRef;
+        const importerFilePath = pythonFilePathOf(file, catalog, site.ownerHash);
+        const to = resolvePythonModuleSpecifier(site.specifier, importerFilePath, moduleInitByFilePath);
+        const edge = {
+            to,
+            line: site.line,
+            column: site.column,
+            specifier: site.specifier,
+        };
+        const existing = out.get(site.ownerHash);
+        if (existing === undefined) {
+            out.set(site.ownerHash, [edge]);
+        }
+        else {
+            existing.push(edge);
+        }
+    }
+    return out;
+}
+/**
+ * Recover the project-relative filePath of the importer from the catalog
+ * (looking it up via the owner's module-init bodyHash). This avoids
+ * threading the projectDirAbs / absolute path through dependency
+ * resolution — the catalog already knows.
+ */
+function pythonFilePathOf(_file, catalog, ownerHash) {
+    for (const occs of Object.values(catalog.functions)) {
+        if (!occs)
+            continue;
+        for (const o of occs) {
+            if (o.bodyHash === ownerHash)
+                return o.filePath;
+        }
+    }
+    /* v8 ignore next */
+    return null;
+}
+/**
+ * Resolve one Python import specifier to its target module-init
+ * bodyHash(es). Returns `[]` when no project file matches (external
+ * package, stdlib, or an unresolvable relative import that walks above
+ * the project root).
+ *
+ * Handled shapes:
+ *   - `foo`             → `foo.py` or `foo/__init__.py`
+ *   - `foo.bar`         → `foo/bar.py` or `foo/bar/__init__.py`
+ *   - `.sibling`        → same package → `sibling.py` / `sibling/__init__.py`
+ *   - `..pkg.sub`       → up one package → `pkg/sub.py` / `pkg/sub/__init__.py`
+ *
+ * NOT handled:
+ *   - PEP 420 namespace packages (we don't enumerate directories without
+ *     an `__init__.py`).
+ *   - `sys.path` extensions configured in `pyproject.toml` (`[tool.…]`
+ *     `src` layouts where the package root isn't the project root).
+ *     Files outside the project tree always resolve to external (`[]`).
+ *   - `importlib.import_module(...)`, `__import__(...)`, conditional /
+ *     nested imports inside function bodies (walker only emits top-level
+ *     imports).
+ */
+function resolvePythonModuleSpecifier(specifier, importerFilePath, moduleInitByFilePath) {
+    const leadingDots = countLeadingDots(specifier);
+    if (leadingDots === 0) {
+        return resolveAbsoluteModule(specifier, moduleInitByFilePath);
+    }
+    if (importerFilePath === null) {
+        /* v8 ignore next */
+        return [];
+    }
+    return resolveRelativeModule(specifier, leadingDots, importerFilePath, moduleInitByFilePath);
+}
+function countLeadingDots(specifier) {
+    let n = 0;
+    while (n < specifier.length && specifier[n] === '.')
+        n++;
+    return n;
+}
+function resolveAbsoluteModule(specifier, moduleInitByFilePath) {
+    return lookupModuleCandidates(specifier.split('.'), moduleInitByFilePath);
+}
+function resolveRelativeModule(specifier, leadingDots, importerFilePath, moduleInitByFilePath) {
+    // `from .x import y` — one dot → same package directory.
+    // `from ..x import y` — two dots → parent package directory.
+    // CPython: N dots = walk up (N - 1) directories from the importer's package.
+    const importerDir = dirname(importerFilePath); // POSIX, project-relative
+    let baseDir = importerDir;
+    for (let i = 1; i < leadingDots; i++) {
+        const parent = posix.dirname(baseDir);
+        if (parent === baseDir) {
+            // Walked above the project root → unresolvable.
+            return [];
+        }
+        baseDir = parent;
+    }
+    const remainder = specifier.slice(leadingDots); // may be '' for `from . import x`
+    const segments = remainder.length > 0 ? remainder.split('.') : [];
+    // baseDir of '.' means project root; treat as empty prefix.
+    const prefix = baseDir === '.' || baseDir === '' ? [] : baseDir.split('/');
+    return lookupModuleCandidates([...prefix, ...segments], moduleInitByFilePath);
+}
+/**
+ * Given dotted module segments (e.g. `['foo', 'bar']`), try the two
+ * canonical file forms: `foo/bar.py` and `foo/bar/__init__.py`. Returns
+ * the matching module-init bodyHash in a single-element array, or `[]`.
+ */
+function lookupModuleCandidates(segments, moduleInitByFilePath) {
+    if (segments.length === 0)
+        return [];
+    const joined = segments.join('/');
+    const candidates = [`${joined}.py`, `${joined}/__init__.py`];
+    for (const candidate of candidates) {
+        const hash = moduleInitByFilePath.get(candidate);
+        if (hash !== undefined)
+            return [hash];
+    }
+    return [];
+}
+function pushCallEdge(node, file, ownerHash, byName, sink) {
+    const { edgesByOwner, stats } = sink;
+    stats.totalCallSites++;
+    const target = extractCallTargetName(node);
+    const pos = pythonPosition(node, file);
+    const truncated = truncateForCallEdge(pos.text);
+    const discarded = isReturnValueDiscarded(node);
+    const edge = buildPythonCallEdge(target, byName, {
+        line: pos.line,
+        column: pos.column,
+        text: truncated,
+        discarded,
+    });
+    appendEdge(edgesByOwner, ownerHash, edge);
+    stats.apply(edge);
+}
+function buildPythonCallEdge(target, byName, loc) {
+    if (target === null) {
+        return { to: [], ...loc, resolution: 'unknown', confidence: 'low' };
+    }
+    const matches = byName.get(target);
+    if (!matches || matches.length === 0) {
+        return { to: [], ...loc, resolution: 'unknown', confidence: 'low' };
+    }
+    if (matches.length === 1) {
+        return { to: [...matches], ...loc, resolution: 'static', confidence: 'medium' };
+    }
+    return { to: [...matches], ...loc, resolution: 'method-dispatch', confidence: 'low' };
+}
+/**
+ * Decode a `call` node's target into a simple name. Returns null when
+ * we don't recognize the shape (subscript call, lambda call, etc.) —
+ * those become unresolved edges.
+ */
+function extractCallTargetName(node) {
+    // tree-sitter-python `call` has a `function` field for the callee.
+    const fn = node.childForFieldName('function');
+    if (!fn)
+        return null;
+    if (fn.type === 'identifier')
+        return fn.text;
+    if (fn.type === 'attribute') {
+        const attr = fn.childForFieldName('attribute');
+        return attr ? attr.text : null;
+    }
+    return null;
+}
+/**
+ * The call's return value is discarded when the call expression is
+ * the entire expression of an expression_statement. Mirrors
+ * lang-typescript's logic for the `no-side-effect-path` rule.
+ */
+function isReturnValueDiscarded(node) {
+    let parent = node.parent;
+    while (parent) {
+        if (parent.type === 'parenthesized_expression' || parent.type === 'await') {
+            parent = parent.parent;
+            continue;
+        }
+        return parent.type === 'expression_statement';
+    }
+    return false;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/rule-hints.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 type { RuleHints } from '@opensip-cli/graph';
+export declare const pythonRuleHints: RuleHints;
+//# sourceMappingURL=rule-hints.d.ts.map

package/dist/rule-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-hints.d.ts","sourceRoot":"","sources":["../src/rule-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAyDpD,eAAO,MAAM,eAAe,EAAE,SAK7B,CAAC"}