@opensip-cli/lang-python 0.1.0

package/dist/__tests__/strip.test.js

@@ -0,0 +1,77 @@
+import { describe, expect, it } from 'vitest';
+import { stripStrings, stripComments } from '../strip.js';
+describe('stripStrings', () => {
+    it('strips single-quoted string contents (replacing with whitespace)', () => {
+        const out = stripStrings(`x = 'hello'`);
+        expect(out).not.toContain('hello');
+        expect(out.startsWith(`x = '`)).toBe(true);
+        expect(out.endsWith(`'`)).toBe(true);
+    });
+    it('strips double-quoted strings', () => {
+        const out = stripStrings(`x = "hello"`);
+        expect(out).not.toContain('hello');
+    });
+    it('strips triple-single strings (multi-line)', () => {
+        const out = stripStrings("x = '''line1\nline2'''");
+        expect(out).not.toContain('line1');
+        expect(out).not.toContain('line2');
+    });
+    it('strips triple-double strings (multi-line)', () => {
+        const out = stripStrings('x = """line1\nline2"""');
+        expect(out).not.toContain('line1');
+        expect(out).not.toContain('line2');
+    });
+    it('handles escape sequences', () => {
+        const out = stripStrings(String.raw `x = 'a\'b'`);
+        expect(out).not.toContain('a');
+    });
+    it('handles raw strings (no escape processing)', () => {
+        const out = stripStrings(`x = r'abc'`);
+        expect(out).not.toContain('abc');
+    });
+    it('terminates non-triple string at newline (malformed input)', () => {
+        const out = stripStrings("x = 'unclosed\n");
+        expect(out).toContain('x = ');
+    });
+    it('passes through code with no strings unchanged', () => {
+        const code = 'def foo():\n    return 1';
+        expect(stripStrings(code)).toBe(code);
+    });
+    it('handles triple string with escaped quotes', () => {
+        const out = stripStrings(String.raw `x = '''line1\'still in string'''`);
+        expect(out).not.toContain('line1');
+    });
+    it('handles unterminated triple string', () => {
+        const out = stripStrings(`x = '''unterminated`);
+        expect(out).toContain('x = ');
+        expect(out).not.toContain('unterminated');
+    });
+    it('handles unterminated single-line string at EOF', () => {
+        const out = stripStrings(`x = "unterminated`);
+        expect(out).toContain('x = ');
+        expect(out).not.toContain('unterminated');
+    });
+});
+describe('stripComments', () => {
+    it('strips line comments', () => {
+        const out = stripComments('x = 1 # comment');
+        expect(out).not.toContain('comment');
+        expect(out).toContain('x = 1');
+    });
+    it('does not treat # inside a string as a comment marker', () => {
+        // The implementation may also blank string contents — what matters
+        // is that the structure ('x = "..."') survives without the # being
+        // misinterpreted as a comment delimiter that swallows the rest.
+        const out = stripComments('x = "# not a comment"\ny = 2');
+        expect(out).toContain('x = "');
+        expect(out).toContain('y = 2');
+    });
+    it('strips multiple comment lines', () => {
+        const src = '# top\nx = 1 # mid\ny = 2 # end';
+        const out = stripComments(src);
+        expect(out).not.toContain('top');
+        expect(out).not.toContain('mid');
+        expect(out).not.toContain('end');
+    });
+});
+//# sourceMappingURL=strip.test.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tree.test.d.ts.map

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

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

package/dist/__tests__/tree.test.js

@@ -0,0 +1,36 @@
+import { RunScope, runWithScopeSync } from '@opensip-cli/core';
+import { initParseCache } from '@opensip-cli/core/languages/parse-cache.js';
+import { describe, expect, it } from 'vitest';
+import { parsePython } from '../parse.js';
+import { getSharedTree } from '../shared-tree.js';
+describe('parsePython', () => {
+    it('produces a real tree-sitter tree + source', () => {
+        const src = 'def f():\n    return 1\n';
+        const tree = parsePython(src, 'f.py');
+        expect(tree).not.toBeNull();
+        expect(tree?.source).toBe(src);
+        expect(tree?.tree.rootNode.type).toBe('module');
+    });
+    it('returns a partial (non-null) tree with hasError for malformed source', () => {
+        const tree = parsePython('def (:\n', 'bad.py');
+        expect(tree).not.toBeNull();
+        expect(tree?.tree.rootNode.hasError).toBe(true);
+    });
+});
+describe('getSharedTree', () => {
+    it('returns a tree without an active cache (direct parse)', () => {
+        const tree = getSharedTree('x.py', 'x = 1\n');
+        expect(tree?.tree.rootNode.type).toBe('module');
+    });
+    describe('with an active parse cache', () => {
+        it('returns the same cached tree identity on repeat calls', () => {
+            runWithScopeSync(new RunScope(), () => {
+                initParseCache();
+                const a = getSharedTree('x.py', 'x = 1\n');
+                const b = getSharedTree('x.py', 'x = 1\n');
+                expect(a).toBe(b);
+            });
+        });
+    });
+});
+//# sourceMappingURL=tree.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree.test.js","sourceRoot":"","sources":["../../src/__tests__/tree.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,GAAG,GAAG,0BAA0B,CAAC;QACvC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAC1C,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,gBAAgB,CAAC,IAAI,QAAQ,EAAE,EAAE,GAAG,EAAE;gBACpC,cAAc,EAAE,CAAC;gBACjB,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAC3C,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAC3C,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/adapter.d.ts

@@ -0,0 +1,6 @@
+import { type PythonTree } from './parse.js';
+import type { LanguageAdapter } from '@opensip-cli/core';
+export declare const pythonAdapter: LanguageAdapter<PythonTree>;
+/** Plugin contract — exported as the lang plugin's `adapters` array. */
+export declare const adapters: readonly [LanguageAdapter<import("@opensip-cli/tree-sitter").ParsedFile, unknown>];
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,eAAO,MAAM,aAAa,EAAE,eAAe,CAAC,UAAU,CAOrD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,QAAQ,oFAA2B,CAAC"}

package/dist/adapter.js

@@ -0,0 +1,13 @@
+import { parsePython } from './parse.js';
+import { stripComments, stripStrings } from './strip.js';
+export const pythonAdapter = {
+    id: 'python',
+    fileExtensions: ['.py', '.pyi'],
+    aliases: ['py'],
+    parse: parsePython,
+    stripStrings,
+    stripComments,
+};
+/** Plugin contract — exported as the lang plugin's `adapters` array. */
+export const adapters = [pythonAdapter];
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIzD,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,EAAE,EAAE,QAAQ;IACZ,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,KAAK,EAAE,WAAW;IAClB,YAAY;IACZ,aAAa;CACd,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,aAAa,CAAU,CAAC"}

package/dist/enclosing.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Composed enclosing-scope helpers for Python (ADR-0010) — the per-language
+ * layer over the generic `findEnclosing`/`nameOf` from
+ * `@opensip-cli/tree-sitter`. Mirrors `lang-typescript`'s
+ * `findEnclosingFunction` / `getEnclosingFunctionName`.
+ */
+import { type Node } from '@opensip-cli/tree-sitter';
+/** The nearest enclosing `def` of `node`, or `null` at module scope. */
+export declare function findEnclosingFunction(node: Node): Node | null;
+/** The name of the nearest enclosing `def`, or `null`. */
+export declare function getEnclosingFunctionName(node: Node): string | null;
+/**
+ * True when `node` is a method — a `function_definition` whose *nearest*
+ * enclosing function-or-class is a class. A function nested inside another
+ * function is therefore not a method (its nearest enclosing scope is a `def`).
+ */
+export declare function isMethod(node: Node): boolean;
+//# sourceMappingURL=enclosing.d.ts.map

package/dist/enclosing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enclosing.d.ts","sourceRoot":"","sources":["../src/enclosing.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,EAAyB,KAAK,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAI5E,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAE7D;AAED,0DAA0D;AAC1D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAI5C"}

package/dist/enclosing.js

@@ -0,0 +1,30 @@
+// @fitness-ignore-file duplicate-utility-functions -- ADR-0010: the per-language tree-sitter vocabulary intentionally shares helper names across lang-* with grammar-specific implementations; consolidating would defeat the substrate design.
+/**
+ * Composed enclosing-scope helpers for Python (ADR-0010) — the per-language
+ * layer over the generic `findEnclosing`/`nameOf` from
+ * `@opensip-cli/tree-sitter`. Mirrors `lang-typescript`'s
+ * `findEnclosingFunction` / `getEnclosingFunctionName`.
+ */
+import { findEnclosing, nameOf } from '@opensip-cli/tree-sitter';
+import { isClass, isFunction } from './predicates.js';
+/** The nearest enclosing `def` of `node`, or `null` at module scope. */
+export function findEnclosingFunction(node) {
+    return findEnclosing(node, isFunction);
+}
+/** The name of the nearest enclosing `def`, or `null`. */
+export function getEnclosingFunctionName(node) {
+    const fn = findEnclosingFunction(node);
+    return fn ? nameOf(fn) : null;
+}
+/**
+ * True when `node` is a method — a `function_definition` whose *nearest*
+ * enclosing function-or-class is a class. A function nested inside another
+ * function is therefore not a method (its nearest enclosing scope is a `def`).
+ */
+export function isMethod(node) {
+    if (!isFunction(node))
+        return false;
+    const enclosing = findEnclosing(node, (n) => isFunction(n) || isClass(n));
+    return enclosing !== null && isClass(enclosing);
+}
+//# sourceMappingURL=enclosing.js.map

package/dist/enclosing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enclosing.js","sourceRoot":"","sources":["../src/enclosing.ts"],"names":[],"mappings":"AAAA,gPAAgP;AAChP;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAa,MAAM,0BAA0B,CAAC;AAE5E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEtD,wEAAwE;AACxE,MAAM,UAAU,qBAAqB,CAAC,IAAU;IAC9C,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,wBAAwB,CAAC,IAAU;IACjD,MAAM,EAAE,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAU;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,OAAO,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { pythonAdapter, adapters } from './adapter.js';
+export { parsePython, type PythonTree } from './parse.js';
+export { getSharedTree } from './shared-tree.js';
+export { stripStrings, stripComments } from './strip.js';
+export { isFunction, isClass, isComment, isString, isExcept, isConditional, isLoop, } from './predicates.js';
+export { findEnclosingFunction, getEnclosingFunctionName, isMethod } from './enclosing.js';
+export { childrenOf, findEnclosing, getColumn, getLineNumber, nameOf, namedChildrenOf, nodeText, walkNodes, type Node, } from '@opensip-cli/tree-sitter';
+//# 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,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO3F,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,MAAM,EACN,eAAe,EACf,QAAQ,EACR,SAAS,EACT,KAAK,IAAI,GACV,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { pythonAdapter, adapters } from './adapter.js';
+export { parsePython } from './parse.js';
+export { getSharedTree } from './shared-tree.js';
+export { stripStrings, stripComments } from './strip.js';
+export { isFunction, isClass, isComment, isString, isExcept, isConditional, isLoop, } from './predicates.js';
+export { findEnclosingFunction, getEnclosingFunctionName, isMethod } from './enclosing.js';
+// Generic tree-sitter traversal/position vocabulary, re-exported so check
+// packs reach the parser substrate THROUGH the language adapter (ADR-0039):
+// the adapter owns the parser boundary; check packs depend on lang-python +
+// fitness only, never on @opensip-cli/tree-sitter directly (enforced by
+// dependency-cruiser).
+export { childrenOf, findEnclosing, getColumn, getLineNumber, nameOf, namedChildrenOf, nodeText, walkNodes, } from '@opensip-cli/tree-sitter';
+//# 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,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE3F,0EAA0E;AAC1E,4EAA4E;AAC5E,4EAA4E;AAC5E,wEAAwE;AACxE,uBAAuB;AACvB,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,MAAM,EACN,eAAe,EACf,QAAQ,EACR,SAAS,GAEV,MAAM,0BAA0B,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Python parse — web-tree-sitter + vendored tree-sitter-python.wasm.
+ *
+ * ADR-0010: `lang-python` is the canonical Python parse substrate for the whole
+ * platform — fitness checks parse via the adapter (`getSharedTree`) and the
+ * graph Python adapter consumes this too. The grammar is loaded once at module
+ * top level (the WASM runtime is initialized by `@opensip-cli/tree-sitter`'s
+ * own top-level `Parser.init()`, statically imported here); a single reused
+ * parser keeps `parse()` synchronous and allocation-free. Tree-sitter recovers
+ * from syntax errors with MISSING nodes, so a malformed file yields a partial
+ * tree (non-null) rather than throwing — callers can inspect `rootNode.hasError`.
+ */
+import { type ParsedFile } from '@opensip-cli/tree-sitter';
+/** Parsed Python source: tree-sitter parse tree plus the original source text. */
+export type PythonTree = ParsedFile;
+/** Parses Python source into a {@link PythonTree}, or null when no tree is produced. */
+export declare function parsePython(content: string, _filePath: string): PythonTree | null;
+//# 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;;;;;;;;;;;GAWG;AAIH,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAOnG,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AAEpC,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAGjF"}

package/dist/parse.js

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Python parse — web-tree-sitter + vendored tree-sitter-python.wasm.
+ *
+ * ADR-0010: `lang-python` is the canonical Python parse substrate for the whole
+ * platform — fitness checks parse via the adapter (`getSharedTree`) and the
+ * graph Python adapter consumes this too. The grammar is loaded once at module
+ * top level (the WASM runtime is initialized by `@opensip-cli/tree-sitter`'s
+ * own top-level `Parser.init()`, statically imported here); a single reused
+ * parser keeps `parse()` synchronous and allocation-free. Tree-sitter recovers
+ * from syntax errors with MISSING nodes, so a malformed file yields a partial
+ * tree (non-null) rather than throwing — callers can inspect `rootNode.hasError`.
+ */
+import { fileURLToPath } from 'node:url';
+import { loadGrammar, createParser, parseToTree } from '@opensip-cli/tree-sitter';
+const grammar = await loadGrammar(fileURLToPath(new URL('../wasm/tree-sitter-python.wasm', import.meta.url)));
+const parser = createParser(grammar);
+/** Parses Python source into a {@link PythonTree}, or null when no tree is produced. */
+export function parsePython(content, _filePath) {
+    const tree = parseToTree(parser, content);
+    return tree ? { tree, source: content } : null;
+}
+//# 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;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAmB,MAAM,0BAA0B,CAAC;AAEnG,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,aAAa,CAAC,IAAI,GAAG,CAAC,iCAAiC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAC3E,CAAC;AACF,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AAKrC,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,SAAiB;IAC5D,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC"}

package/dist/predicates.d.ts

@@ -0,0 +1,22 @@
+/**
+ * v1 per-language node-kind predicates for Python (ADR-0010). The generic
+ * traversal/position helpers live in `@opensip-cli/tree-sitter`; only the
+ * grammar-specific node `type` strings differ per language, and they live here.
+ * Node types are from the tree-sitter-python grammar.
+ */
+import type { Node } from '@opensip-cli/tree-sitter';
+/** A `def` — both top-level functions and methods are `function_definition`. */
+export declare const isFunction: (node: Node) => boolean;
+/** A `class` declaration. */
+export declare const isClass: (node: Node) => boolean;
+/** A `#` comment. */
+export declare const isComment: (node: Node) => boolean;
+/** A string literal (also covers f-strings / docstrings at the node level). */
+export declare const isString: (node: Node) => boolean;
+/** An `except[ … ]:` clause — Python's error-handling node. */
+export declare const isExcept: (node: Node) => boolean;
+/** An `if` statement. */
+export declare const isConditional: (node: Node) => boolean;
+/** A `for` or `while` loop. */
+export declare const isLoop: (node: Node) => boolean;
+//# sourceMappingURL=predicates.d.ts.map

package/dist/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../src/predicates.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,gFAAgF;AAChF,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,OAA8C,CAAC;AAEvF,6BAA6B;AAC7B,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,KAAG,OAA2C,CAAC;AAEjF,qBAAqB;AACrB,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,KAAG,OAAkC,CAAC;AAE1E,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAAiC,CAAC;AAExE,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAAwC,CAAC;AAE/E,yBAAyB;AACzB,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,KAAG,OAAuC,CAAC;AAEnF,+BAA+B;AAC/B,eAAO,MAAM,MAAM,GAAI,MAAM,IAAI,KAAG,OAC8B,CAAC"}

package/dist/predicates.js

@@ -0,0 +1,22 @@
+// @fitness-ignore-file duplicate-utility-functions -- ADR-0010: the per-language tree-sitter vocabulary intentionally shares helper names across lang-* with grammar-specific implementations; consolidating would defeat the substrate design.
+/**
+ * v1 per-language node-kind predicates for Python (ADR-0010). The generic
+ * traversal/position helpers live in `@opensip-cli/tree-sitter`; only the
+ * grammar-specific node `type` strings differ per language, and they live here.
+ * Node types are from the tree-sitter-python grammar.
+ */
+/** A `def` — both top-level functions and methods are `function_definition`. */
+export const isFunction = (node) => node.type === 'function_definition';
+/** A `class` declaration. */
+export const isClass = (node) => node.type === 'class_definition';
+/** A `#` comment. */
+export const isComment = (node) => node.type === 'comment';
+/** A string literal (also covers f-strings / docstrings at the node level). */
+export const isString = (node) => node.type === 'string';
+/** An `except[ … ]:` clause — Python's error-handling node. */
+export const isExcept = (node) => node.type === 'except_clause';
+/** An `if` statement. */
+export const isConditional = (node) => node.type === 'if_statement';
+/** A `for` or `while` loop. */
+export const isLoop = (node) => node.type === 'for_statement' || node.type === 'while_statement';
+//# sourceMappingURL=predicates.js.map

package/dist/predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../src/predicates.ts"],"names":[],"mappings":"AAAA,gPAAgP;AAChP;;;;;GAKG;AAIH,gFAAgF;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,qBAAqB,CAAC;AAEvF,6BAA6B;AAC7B,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,kBAAkB,CAAC;AAEjF,qBAAqB;AACrB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;AAE1E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AAExE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC;AAE/E,yBAAyB;AACzB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC;AAEnF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAU,EAAW,EAAE,CAC5C,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC"}

package/dist/shared-tree.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cached Python parse entry point — the analog of `lang-typescript`'s
+ * `getSharedSourceFile`. Routes through `core`'s active `LanguageParseCache`
+ * (key `python:filePath:fingerprint`) so a file parsed by a fitness check and
+ * by the graph adapter in the same run is parsed once. Falls back to a direct
+ * `adapter.parse` when no cache is active (single-check mode).
+ */
+import type { PythonTree } from './parse.js';
+/** Returns the shared (cached) Python parse tree for `filePath`, or null when unparseable. */
+export declare function getSharedTree(filePath: string, content: string): PythonTree | null;
+//# sourceMappingURL=shared-tree.d.ts.map

package/dist/shared-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-tree.d.ts","sourceRoot":"","sources":["../src/shared-tree.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAElF"}

package/dist/shared-tree.js

@@ -0,0 +1,15 @@
+// @fitness-ignore-file duplicate-utility-functions -- ADR-0010: the per-language tree-sitter vocabulary intentionally shares helper names across lang-* with grammar-specific implementations; consolidating would defeat the substrate design.
+/**
+ * Cached Python parse entry point — the analog of `lang-typescript`'s
+ * `getSharedSourceFile`. Routes through `core`'s active `LanguageParseCache`
+ * (key `python:filePath:fingerprint`) so a file parsed by a fitness check and
+ * by the graph adapter in the same run is parsed once. Falls back to a direct
+ * `adapter.parse` when no cache is active (single-check mode).
+ */
+import { getParseTree } from '@opensip-cli/core/languages/parse-cache.js';
+import { pythonAdapter } from './adapter.js';
+/** Returns the shared (cached) Python parse tree for `filePath`, or null when unparseable. */
+export function getSharedTree(filePath, content) {
+    return getParseTree(pythonAdapter, filePath, content);
+}
+//# sourceMappingURL=shared-tree.js.map

package/dist/shared-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-tree.js","sourceRoot":"","sources":["../src/shared-tree.ts"],"names":[],"mappings":"AAAA,gPAAgP;AAChP;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C,8FAA8F;AAC9F,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,OAAO,YAAY,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/dist/strip.d.ts

@@ -0,0 +1,5 @@
+/** Replace string literal content with whitespace; preserves length. */
+export declare const stripStrings: (content: string) => string;
+/** Replace string literals AND comments with whitespace; preserves length. */
+export declare const stripComments: (content: string) => string;
+//# sourceMappingURL=strip.d.ts.map

package/dist/strip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.d.ts","sourceRoot":"","sources":["../src/strip.ts"],"names":[],"mappings":"AAiNA,wEAAwE;AACxE,eAAO,MAAM,YAAY,6BAAwB,CAAC;AAClD,8EAA8E;AAC9E,eAAO,MAAM,aAAa,6BAAyB,CAAC"}

package/dist/strip.js

@@ -0,0 +1,196 @@
+// Python string and comment stripping.
+//
+// Hand-written lexer that recognizes:
+// - Line comments (# ... end-of-line)
+// - Single-quoted strings ('...') and double-quoted strings ("...")
+// - Triple-quoted strings ('''...''' and """...""") — multi-line
+// - String prefixes (case-insensitive): r, b, u, f, rb, br, rf, fr
+//   e.g. r'raw', b"bytes", f"hello {x}", rb'raw-bytes'
+// - Raw strings (prefix r/rb/br/rf/fr): backslash is an ordinary
+//   character EXCEPT before a quote (`\"` / `\'`), where it does NOT
+//   terminate the literal — matches CPython's tokenizer rule
+// - F-string expression interpolation is intentionally NOT preserved —
+//   the entire body is treated as string content. This is a documented
+//   MVP limitation; checks that need to see f-string expressions should
+//   wait for tree-sitter integration.
+//
+// Both strip functions preserve byte length: replacement is whitespace
+// (newlines preserved) so line/column positions remain stable.
+//
+// NOTE: this pack deliberately does NOT consume the C-family scanners
+// from `@opensip-cli/core/languages/strip-utils.ts`
+// (`scanRegularString`, `scanLineComment`, `scanBlockCommentNonNesting`,
+// `scanCharLiteral`). Python's quote rules are the family outlier —
+// strings open with either `'` or `"`, support eight ASCII prefix
+// forms, and use `#` line comments — and the C-family helpers'
+// signatures don't fit. If a second adopter (Ruby, Bash, Swift)
+// appears, the right move is to lift a parameterized
+// `scanQuotedString(quoteChar)` into core; with one consumer it stays
+// here.
+import { isIdentChar, makeStripper } from '@opensip-cli/core';
+// Allowed Python string prefixes (lowercase). Case-insensitivity is
+// handled at match time by lowercasing the candidate. Two-letter
+// combinations come first so a longer prefix wins over a shorter one.
+const TWO_CHAR_PREFIXES = new Set(['rb', 'br', 'rf', 'fr']);
+const ONE_CHAR_PREFIXES = new Set(['r', 'b', 'u', 'f']);
+function isAsciiLetter(ch) {
+    if (!ch)
+        return false;
+    const code = ch.codePointAt(0) ?? 0;
+    return (code >= 0x41 && code <= 0x5a) || (code >= 0x61 && code <= 0x7a);
+}
+/**
+ * If position `i` looks like the start of a Python string literal
+ * (optionally with prefix), return the index of the opening quote.
+ * Otherwise return null.
+ *
+ * The check is conservative: a prefix only counts if the character
+ * BEFORE it isn't an identifier character, so identifiers like
+ * `myvar = foo` or `bar` aren't mistaken for prefixes.
+ *
+ * Note: we deliberately do NOT distinguish raw from non-raw here.
+ * For *tokenization-bound* (which is all the strip pass needs), the
+ * two cases are identical: backslash always pairs with the next char.
+ * The raw/non-raw distinction only matters for value extraction —
+ * something the strip pass never does. See the scanner functions
+ * for the CPython-spec citation.
+ */
+function matchStringStart(src, i) {
+    const c = src[i];
+    if (c === '"' || c === "'") {
+        return { quoteIndex: i };
+    }
+    if (!isAsciiLetter(c))
+        return null;
+    // Reject if the previous character is part of an identifier — then
+    // this is the middle/end of an identifier, not a string prefix.
+    if (i > 0 && isIdentChar(src[i - 1]))
+        return null;
+    // Try two-character prefix first.
+    const c1 = src[i];
+    const c2 = src[i + 1];
+    if (c1 && c2) {
+        const two = (c1 + c2).toLowerCase();
+        if (TWO_CHAR_PREFIXES.has(two)) {
+            const after = src[i + 2];
+            if (after === '"' || after === "'") {
+                return { quoteIndex: i + 2 };
+            }
+        }
+    }
+    // Single-character prefix.
+    const one = c1?.toLowerCase();
+    if (one && ONE_CHAR_PREFIXES.has(one)) {
+        const after = src[i + 1];
+        if (after === '"' || after === "'") {
+            return { quoteIndex: i + 1 };
+        }
+    }
+    return null;
+}
+function scanTripleString(src, contentStart, quote) {
+    const len = src.length;
+    let i = contentStart;
+    while (i < len) {
+        const ch = src[i];
+        if (ch === '\\') {
+            // Backslash always pairs with the following character for
+            // tokenization purposes, in BOTH non-raw and raw strings. In
+            // non-raw, this is escape-sequence handling. In raw, escape
+            // sequences are not interpreted, but per CPython:
+            //   "Even in a raw literal, quotes can be escaped with a
+            //    backslash, but the backslash remains in the result."
+            // So `r"\""` is the 2-char string `\"`, terminated by the
+            // third `"`. We must therefore skip past `\<anything>` in raw
+            // mode too, otherwise the next quote is mis-read as terminator.
+            // Newlines are preserved because we never replace them.
+            i += 2;
+            continue;
+        }
+        if (ch === quote && src[i + 1] === quote && src[i + 2] === quote) {
+            return { contentStart, contentEnd: i, next: i + 3 };
+        }
+        i++;
+    }
+    // Unterminated — record what we have.
+    return { contentStart, contentEnd: len, next: len };
+}
+function scanSingleString(src, contentStart, quote) {
+    const len = src.length;
+    let i = contentStart;
+    while (i < len) {
+        const ch = src[i];
+        // Newline terminates a non-triple string in Python (it's a syntax
+        // error to span lines without explicit continuation, but for
+        // strip purposes treat newline as a terminator to avoid eating
+        // the rest of the file on malformed input).
+        if (ch === '\n') {
+            return { contentStart, contentEnd: i, next: i };
+        }
+        if (ch === '\\') {
+            // Backslash always pairs with the following character for
+            // tokenization purposes, in BOTH non-raw and raw strings. In
+            // non-raw, this is escape-sequence handling (and `\\\n` is line
+            // continuation). In raw, escape sequences are not interpreted,
+            // but per CPython:
+            //   "Even in a raw literal, quotes can be escaped with a
+            //    backslash, but the backslash remains in the result."
+            // So `r"\""` is the 2-char string `\"`, terminated by the
+            // third `"`. We must therefore skip past `\<anything>` in raw
+            // mode too, otherwise the next quote is mis-read as terminator.
+            i += 2;
+            continue;
+        }
+        if (ch === quote) {
+            return { contentStart, contentEnd: i, next: i + 1 };
+        }
+        i++;
+    }
+    return { contentStart, contentEnd: len, next: len };
+}
+function scan(src) {
+    const stringRegions = [];
+    const commentRegions = [];
+    const len = src.length;
+    let i = 0;
+    while (i < len) {
+        const c = src[i];
+        // Line comment: # ... \n
+        if (c === '#') {
+            const start = i;
+            i++;
+            while (i < len && src[i] !== '\n')
+                i++;
+            commentRegions.push({ start, end: i });
+            continue;
+        }
+        // String literal (with optional prefix).
+        const stringStart = matchStringStart(src, i);
+        if (stringStart) {
+            const { quoteIndex } = stringStart;
+            const quote = src[quoteIndex];
+            // Triple-quoted?
+            if (src[quoteIndex + 1] === quote && src[quoteIndex + 2] === quote) {
+                const contentStart = quoteIndex + 3;
+                const result = scanTripleString(src, contentStart, quote);
+                stringRegions.push({ start: result.contentStart, end: result.contentEnd });
+                i = result.next;
+            }
+            else {
+                const contentStart = quoteIndex + 1;
+                const result = scanSingleString(src, contentStart, quote);
+                stringRegions.push({ start: result.contentStart, end: result.contentEnd });
+                i = result.next;
+            }
+            continue;
+        }
+        i++;
+    }
+    return { stringRegions, commentRegions };
+}
+const stripper = makeStripper(scan);
+/** Replace string literal content with whitespace; preserves length. */
+export const stripStrings = stripper.stripStrings;
+/** Replace string literals AND comments with whitespace; preserves length. */
+export const stripComments = stripper.stripComments;
+//# sourceMappingURL=strip.js.map

package/dist/strip.js.map

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