@intentweave/python-parser 0.4.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 - 2026 Benjamin Becker
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/extractor.d.ts

@@ -0,0 +1,29 @@
+import type { PythonFileResult, PythonExtractionOptions, PythonBatchResult } from "./types.js";
+export declare class PythonExtractor {
+    private parser;
+    private workspaceRoot;
+    private defaultOptions;
+    constructor(workspaceRoot: string, options?: Partial<PythonExtractionOptions>);
+    /**
+     * Extract symbols from a single Python file.
+     */
+    extractFile(filePath: string, options?: Partial<PythonExtractionOptions>): Promise<PythonFileResult>;
+    /**
+     * Extract symbols from a Python source string (for testing / in-memory).
+     */
+    extractFromString(content: string, filePath: string, options?: Partial<PythonExtractionOptions>): PythonFileResult;
+    /**
+     * Extract symbols from multiple Python files.
+     */
+    extractBatch(filePaths: string[], options?: Partial<PythonExtractionOptions>): Promise<PythonBatchResult>;
+    private walkNode;
+    private extractFunction;
+    private extractClass;
+    /** Handle `import X`, `import X as Y`, `import X, Y` */
+    private extractImportStatement;
+    /** Handle `from X import Y`, `from . import Z`, `from ..pkg import W` */
+    private extractImportFromStatement;
+    private extractAssignment;
+}
+export declare function createPythonExtractor(workspaceRoot: string, options?: Partial<PythonExtractionOptions>): PythonExtractor;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../src/extractor.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAGV,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAkMpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAoC;gBAGxD,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAe5C;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACzC,OAAO,CAAC,gBAAgB,CAAC;IAuB5B;;OAEG;IACH,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACzC,gBAAgB;IAoCnB;;OAEG;IACG,YAAY,CAChB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC;IA+B7B,OAAO,CAAC,QAAQ;IA6FhB,OAAO,CAAC,eAAe;IAsEvB,OAAO,CAAC,YAAY;IA2DpB,wDAAwD;IACxD,OAAO,CAAC,sBAAsB;IA2C9B,yEAAyE;IACzE,OAAO,CAAC,0BAA0B;IAqElC,OAAO,CAAC,iBAAiB;CAuD1B;AAID,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACzC,eAAe,CAEjB"}

package/dist/extractor.js

@@ -0,0 +1,567 @@
+// Copyright 2025-2026 Benjamin Becker
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @file Python AST Extractor
+ *
+ * Tree-sitter based Python AST extractor.
+ * Extracts functions, classes, methods, decorators, imports,
+ * module-level variables, and type hints from .py files.
+ */
+import Parser from "tree-sitter";
+import Python from "tree-sitter-python";
+import * as fs from "fs";
+import * as path from "path";
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function toRange(node) {
+    return {
+        startLine: node.startPosition.row + 1,
+        startColumn: node.startPosition.column,
+        endLine: node.endPosition.row + 1,
+        endColumn: node.endPosition.column,
+    };
+}
+/**
+ * Python visibility is convention-based:
+ *   `__name` → private (name-mangled)
+ *   `_name`  → protected (convention)
+ *   `name`   → public
+ */
+function getVisibility(name) {
+    if (name.startsWith("__") && !name.endsWith("__"))
+        return "private";
+    if (name.startsWith("_"))
+        return "protected";
+    return "public";
+}
+/**
+ * Determine if a module-level symbol is "exported".
+ * - Names starting with `_` are internal by convention
+ * - If `__all__` is defined, only listed names are exported
+ */
+function isExportedName(name, allNames) {
+    if (allNames)
+        return allNames.has(name);
+    return !name.startsWith("_");
+}
+/** Extract decorator names from a decorated_definition wrapper. */
+function extractDecorators(node) {
+    const decorators = [];
+    for (let i = 0; i < node.childCount; i++) {
+        const child = node.child(i);
+        if (child.type === "decorator") {
+            // decorator → "@" expression
+            // The expression is typically an identifier or dotted name or call
+            const expr = child.childCount > 1 ? child.child(1) : null;
+            if (expr) {
+                // For `@staticmethod` → "staticmethod"
+                // For `@app.route("/")` → "app.route"
+                if (expr.type === "identifier") {
+                    decorators.push(expr.text);
+                }
+                else if (expr.type === "attribute") {
+                    decorators.push(expr.text);
+                }
+                else if (expr.type === "call") {
+                    // @decorator(args) → extract decorator name
+                    const fn = expr.childForFieldName("function");
+                    if (fn)
+                        decorators.push(fn.text);
+                }
+            }
+        }
+    }
+    return decorators;
+}
+/** Extract base classes from a class argument_list. */
+function extractBases(node) {
+    const bases = [];
+    const argList = node.childForFieldName("superclasses");
+    if (!argList)
+        return bases;
+    for (let i = 0; i < argList.childCount; i++) {
+        const child = argList.child(i);
+        if (child.type === "identifier" || child.type === "attribute") {
+            bases.push(child.text);
+        }
+        else if (child.type === "keyword_argument") {
+            // e.g., metaclass=ABCMeta — skip
+        }
+    }
+    return bases;
+}
+/** Extract parameter names from a `parameters` node. */
+function extractParameters(node) {
+    const params = [];
+    const paramList = node.childForFieldName("parameters");
+    if (!paramList)
+        return params;
+    for (let i = 0; i < paramList.childCount; i++) {
+        const child = paramList.child(i);
+        switch (child.type) {
+            case "identifier":
+                params.push(child.text);
+                break;
+            case "typed_parameter":
+            case "default_parameter":
+            case "typed_default_parameter": {
+                // Try field name first, then fall back to first identifier child
+                const nameNode = child.childForFieldName("name") ??
+                    (() => {
+                        for (let j = 0; j < child.childCount; j++) {
+                            if (child.child(j).type === "identifier")
+                                return child.child(j);
+                        }
+                        return null;
+                    })();
+                if (nameNode)
+                    params.push(nameNode.text);
+                break;
+            }
+            case "list_splat_pattern":
+            case "dictionary_splat_pattern": {
+                // *args, **kwargs
+                const inner = child.childCount > 0 ? child.child(child.childCount - 1) : null;
+                if (inner?.type === "identifier") {
+                    const prefix = child.type === "list_splat_pattern" ? "*" : "**";
+                    params.push(prefix + inner.text);
+                }
+                break;
+            }
+        }
+    }
+    return params;
+}
+/** Extract the first line of a docstring from the function/class body. */
+function extractDocstring(node) {
+    const body = node.childForFieldName("body");
+    if (!body || body.childCount === 0)
+        return undefined;
+    const first = body.child(0);
+    // expression_statement → string
+    if (first.type === "expression_statement") {
+        const expr = first.child(0);
+        if (expr &&
+            (expr.type === "string" || expr.type === "concatenated_string")) {
+            const text = expr.text;
+            // Strip triple quotes
+            const stripped = text
+                .replace(/^("""|''')\s*/, "")
+                .replace(/\s*("""|''')$/, "")
+                .trim();
+            // Return first line only
+            const firstLine = stripped.split("\n")[0].trim();
+            return firstLine || undefined;
+        }
+    }
+    return undefined;
+}
+/** Build a displayable signature. */
+function buildSignature(node, kind) {
+    const lines = node.text.split("\n");
+    const firstLine = lines[0].trim();
+    // Trim body (after colon)
+    const colonIdx = firstLine.indexOf(":");
+    if (colonIdx > 0)
+        return firstLine.substring(0, colonIdx).trim();
+    return firstLine.length > 120 ? firstLine.substring(0, 120) + "…" : firstLine;
+}
+/**
+ * Scan the module for `__all__ = [...]` and return the listed names.
+ * Returns null if no __all__ is defined.
+ */
+function extractAllNames(root) {
+    for (let i = 0; i < root.childCount; i++) {
+        const child = root.child(i);
+        if (child.type !== "expression_statement")
+            continue;
+        const assignment = child.child(0);
+        if (!assignment || assignment.type !== "assignment")
+            continue;
+        const left = assignment.childForFieldName("left");
+        const right = assignment.childForFieldName("right");
+        if (!left || left.text !== "__all__")
+            continue;
+        if (!right || right.type !== "list")
+            continue;
+        const names = new Set();
+        for (let j = 0; j < right.childCount; j++) {
+            const elem = right.child(j);
+            if (elem.type === "string") {
+                // Strip quotes
+                const stripped = elem.text.replace(/^["']|["']$/g, "");
+                if (stripped)
+                    names.add(stripped);
+            }
+        }
+        return names;
+    }
+    return null;
+}
+// ── Extractor ────────────────────────────────────────────────────────────────
+export class PythonExtractor {
+    parser;
+    workspaceRoot;
+    defaultOptions;
+    constructor(workspaceRoot, options) {
+        this.workspaceRoot = workspaceRoot;
+        this.parser = new Parser();
+        this.parser.setLanguage(Python);
+        this.defaultOptions = {
+            includePrivate: options?.includePrivate ?? false,
+            includeDocSummary: options?.includeDocSummary ?? true,
+            includeParameters: options?.includeParameters ?? true,
+            includeMembers: options?.includeMembers ?? true,
+            maxDepth: options?.maxDepth ?? 2,
+        };
+    }
+    /**
+     * Extract symbols from a single Python file.
+     */
+    async extractFile(filePath, options) {
+        const opts = { ...this.defaultOptions, ...options };
+        const absolutePath = path.isAbsolute(filePath)
+            ? filePath
+            : path.join(this.workspaceRoot, filePath);
+        const relativePath = path.relative(this.workspaceRoot, absolutePath);
+        try {
+            const content = await fs.promises.readFile(absolutePath, "utf-8");
+            return this.extractFromString(content, relativePath, opts);
+        }
+        catch (error) {
+            return {
+                filePath: relativePath,
+                language: "python",
+                symbols: [],
+                imports: [],
+                extractedAt: Date.now(),
+                errors: [error.message],
+            };
+        }
+    }
+    /**
+     * Extract symbols from a Python source string (for testing / in-memory).
+     */
+    extractFromString(content, filePath, options) {
+        const opts = { ...this.defaultOptions, ...options };
+        const tree = this.parser.parse(content);
+        const symbols = [];
+        const imports = [];
+        const errors = [];
+        // Pre-scan for __all__
+        const allNames = extractAllNames(tree.rootNode);
+        this.walkNode(tree.rootNode, filePath, symbols, imports, opts, undefined, 0, allNames);
+        if (tree.rootNode.hasError) {
+            errors.push("Parse errors detected in file");
+        }
+        return {
+            filePath,
+            language: "python",
+            symbols,
+            imports,
+            extractedAt: Date.now(),
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    /**
+     * Extract symbols from multiple Python files.
+     */
+    async extractBatch(filePaths, options) {
+        const startTime = Date.now();
+        const files = new Map();
+        const failures = [];
+        let totalSymbols = 0;
+        for (const filePath of filePaths) {
+            try {
+                const result = await this.extractFile(filePath, options);
+                files.set(result.filePath, result);
+                totalSymbols += result.symbols.length;
+                if (result.errors?.length) {
+                    failures.push({ filePath: result.filePath, error: result.errors[0] });
+                }
+            }
+            catch (error) {
+                failures.push({ filePath, error: error.message });
+            }
+        }
+        return {
+            files,
+            totalSymbols,
+            totalFiles: filePaths.length,
+            failures,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    // ── Tree walker ──────────────────────────────────────────────────────
+    walkNode(node, filePath, symbols, imports, options, parentName, depth, allNames) {
+        if (depth > options.maxDepth)
+            return;
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            switch (child.type) {
+                case "function_definition":
+                    this.extractFunction(child, filePath, symbols, options, parentName, depth, allNames, []);
+                    break;
+                case "class_definition":
+                    this.extractClass(child, filePath, symbols, imports, options, depth, allNames, []);
+                    break;
+                case "decorated_definition": {
+                    const decorators = extractDecorators(child);
+                    const definition = child.childForFieldName("definition");
+                    if (definition) {
+                        if (definition.type === "function_definition") {
+                            this.extractFunction(definition, filePath, symbols, options, parentName, depth, allNames, decorators);
+                        }
+                        else if (definition.type === "class_definition") {
+                            this.extractClass(definition, filePath, symbols, imports, options, depth, allNames, decorators);
+                        }
+                    }
+                    break;
+                }
+                case "import_statement":
+                    this.extractImportStatement(child, imports);
+                    break;
+                case "import_from_statement":
+                    this.extractImportFromStatement(child, imports);
+                    break;
+                case "expression_statement":
+                    // Module-level variable assignments
+                    if (depth === 0) {
+                        this.extractAssignment(child, filePath, symbols, allNames);
+                    }
+                    break;
+            }
+        }
+    }
+    // ── Function extraction ──────────────────────────────────────────────
+    extractFunction(node, filePath, symbols, options, parentName, depth, allNames, decorators) {
+        const nameNode = node.childForFieldName("name");
+        if (!nameNode)
+            return;
+        const name = nameNode.text;
+        const visibility = getVisibility(name);
+        // Skip private if not requested
+        if (!options.includePrivate && visibility !== "public" && !parentName)
+            return;
+        const isAsync = node.previousSibling?.type === "async" ||
+            node.parent?.type === "async_function_definition" ||
+            // Check for 'async' keyword within the node
+            (node.childCount > 0 && node.child(0)?.type === "async");
+        // Determine kind: function or method
+        const kind = parentName ? "method" : "function";
+        // Check for @property → treat as property
+        const isProperty = decorators.includes("property");
+        const actualKind = isProperty ? "property" : kind;
+        const isStatic = decorators.includes("staticmethod") || decorators.includes("classmethod");
+        const exported = parentName != null
+            ? visibility === "public" // class members: exported if public
+            : isExportedName(name, allNames);
+        const sym = {
+            name,
+            kind: actualKind,
+            filePath,
+            range: toRange(node),
+            isExported: exported,
+            visibility,
+            decorators: decorators.length > 0 ? decorators : undefined,
+        };
+        if (parentName)
+            sym.parent = parentName;
+        if (isAsync)
+            sym.isAsync = true;
+        if (isStatic)
+            sym.isStatic = true;
+        if (options.includeParameters) {
+            sym.parameters = extractParameters(node);
+        }
+        if (options.includeDocSummary) {
+            sym.docSummary = extractDocstring(node);
+        }
+        sym.signature = buildSignature(node, actualKind);
+        symbols.push(sym);
+    }
+    // ── Class extraction ─────────────────────────────────────────────────
+    extractClass(node, filePath, symbols, imports, options, depth, allNames, decorators) {
+        const nameNode = node.childForFieldName("name");
+        if (!nameNode)
+            return;
+        const name = nameNode.text;
+        const visibility = getVisibility(name);
+        if (!options.includePrivate && visibility !== "public")
+            return;
+        const bases = extractBases(node);
+        const sym = {
+            name,
+            kind: "class",
+            filePath,
+            range: toRange(node),
+            isExported: isExportedName(name, allNames),
+            visibility,
+            decorators: decorators.length > 0 ? decorators : undefined,
+            bases: bases.length > 0 ? bases : undefined,
+        };
+        if (options.includeDocSummary) {
+            sym.docSummary = extractDocstring(node);
+        }
+        sym.signature = buildSignature(node, "class");
+        symbols.push(sym);
+        // Extract class body members
+        if (options.includeMembers) {
+            const body = node.childForFieldName("body");
+            if (body) {
+                this.walkNode(body, filePath, symbols, imports, options, name, depth + 1, allNames);
+            }
+        }
+    }
+    // ── Import extraction ────────────────────────────────────────────────
+    /** Handle `import X`, `import X as Y`, `import X, Y` */
+    extractImportStatement(node, imports) {
+        // import_statement children: "import" dotted_name ("as" identifier)?
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child.type === "dotted_name") {
+                const moduleName = child.text;
+                let alias;
+                // Check for "as" alias
+                const next = node.child(i + 1);
+                const nextNext = node.child(i + 2);
+                if (next?.type === "as" && nextNext?.type === "identifier") {
+                    alias = nextNext.text;
+                }
+                imports.push({
+                    moduleName,
+                    isRelative: false,
+                    importedNames: [],
+                    isWholeModule: true,
+                    alias,
+                    range: toRange(node),
+                });
+            }
+            else if (child.type === "aliased_import") {
+                const nameNode = child.childForFieldName("name");
+                const aliasNode = child.childForFieldName("alias");
+                if (nameNode) {
+                    imports.push({
+                        moduleName: nameNode.text,
+                        isRelative: false,
+                        importedNames: [],
+                        isWholeModule: true,
+                        alias: aliasNode?.text,
+                        range: toRange(node),
+                    });
+                }
+            }
+        }
+    }
+    /** Handle `from X import Y`, `from . import Z`, `from ..pkg import W` */
+    extractImportFromStatement(node, imports) {
+        const moduleNode = node.childForFieldName("module_name");
+        let moduleName = "";
+        let isRelative = false;
+        // Check for relative import prefix (dots before module name)
+        let dotsPrefix = "";
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child.type === "relative_import") {
+                // relative_import contains dot(s) and optionally a dotted_name
+                for (let j = 0; j < child.childCount; j++) {
+                    const rc = child.child(j);
+                    if (rc.type === "import_prefix") {
+                        dotsPrefix = rc.text;
+                    }
+                    else if (rc.type === "dotted_name") {
+                        moduleName = rc.text;
+                    }
+                }
+                isRelative = true;
+                break;
+            }
+        }
+        if (!isRelative && moduleNode) {
+            moduleName = moduleNode.text;
+            isRelative = moduleName.startsWith(".");
+        }
+        if (isRelative && dotsPrefix) {
+            moduleName = dotsPrefix + moduleName;
+        }
+        // Extract imported names
+        const importedNames = [];
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child.type === "dotted_name" && child !== moduleNode) {
+                importedNames.push({ name: child.text });
+            }
+            else if (child.type === "aliased_import") {
+                const nameNode = child.childForFieldName("name");
+                const aliasNode = child.childForFieldName("alias");
+                if (nameNode) {
+                    importedNames.push({
+                        name: nameNode.text,
+                        alias: aliasNode?.text,
+                    });
+                }
+            }
+            else if (child.type === "wildcard_import") {
+                importedNames.push({ name: "*" });
+            }
+        }
+        imports.push({
+            moduleName: moduleName || ".",
+            isRelative,
+            importedNames,
+            isWholeModule: false,
+            range: toRange(node),
+        });
+    }
+    // ── Module-level assignment extraction ───────────────────────────────
+    extractAssignment(node, filePath, symbols, allNames) {
+        const child = node.child(0);
+        if (!child)
+            return;
+        // assignment: left = right
+        if (child.type === "assignment") {
+            const left = child.childForFieldName("left");
+            if (!left)
+                return;
+            // Skip __all__, __name__, etc. — these are metadata, not user-visible symbols
+            if (left.type === "identifier") {
+                const name = left.text;
+                if (name === "__all__" || name === "__name__" || name === "__file__")
+                    return;
+                const visibility = getVisibility(name);
+                const exported = isExportedName(name, allNames);
+                // Determine if it looks like a constant (UPPER_SNAKE_CASE)
+                const isConst = /^[A-Z][A-Z0-9_]*$/.test(name);
+                symbols.push({
+                    name,
+                    kind: "variable",
+                    filePath,
+                    range: toRange(node),
+                    isExported: exported,
+                    visibility,
+                    signature: isConst ? `${name} = ...` : undefined,
+                });
+            }
+        }
+        // Type-annotated assignment: x: int = 5
+        if (child.type === "type_alias_statement") {
+            // `type X = ...` (Python 3.12+)
+            const nameNode = child.childForFieldName("name");
+            if (nameNode) {
+                const name = nameNode.text;
+                symbols.push({
+                    name,
+                    kind: "variable",
+                    filePath,
+                    range: toRange(node),
+                    isExported: isExportedName(name, allNames),
+                    visibility: getVisibility(name),
+                });
+            }
+        }
+    }
+}
+// ── Factory ──────────────────────────────────────────────────────────────────
+export function createPythonExtractor(workspaceRoot, options) {
+    return new PythonExtractor(workspaceRoot, options);
+}
+//# sourceMappingURL=extractor.js.map

package/dist/extractor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file Python Parser - Public API
+ *
+ * Tree-sitter based AST extractor for Python source files.
+ * Extracts functions, classes, methods, decorators, imports,
+ * module-level variables, and type hints from .py files.
+ *
+ * @example
+ * ```typescript
+ * import { createPythonExtractor } from '@intentweave/python-parser';
+ *
+ * const extractor = createPythonExtractor('/path/to/python-project');
+ * const result = await extractor.extractFile('src/app.py');
+ *
+ * console.log(`Found ${result.symbols.length} symbols`);
+ * for (const sym of result.symbols) {
+ *   console.log(`  ${sym.kind} ${sym.name} (${sym.visibility ?? 'public'})`);
+ * }
+ * ```
+ */
+export type { PythonSymbolKind, SourceRange, PythonSymbol, PythonImport, PythonFileResult, PythonExtractionOptions, PythonBatchResult, } from "./types.js";
+export { PythonExtractor, createPythonExtractor } from "./extractor.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":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Copyright 2025-2026 Benjamin Becker
+// SPDX-License-Identifier: Apache-2.0
+// Re-export extractor
+export { PythonExtractor, createPythonExtractor } from "./extractor.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,sCAAsC;AACtC,sCAAsC;AAkCtC,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @file Python Parser Types
+ *
+ * Types for extracted Python code symbols.
+ * Compatible with the @intentweave/ast-extractor type shapes so AX stage
+ * can consume TypeScript, Swift, and Python extraction results uniformly.
+ */
+export type PythonSymbolKind = "function" | "class" | "method" | "property" | "variable" | "module";
+export interface SourceRange {
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}
+export interface PythonSymbol {
+    name: string;
+    kind: PythonSymbolKind;
+    filePath: string;
+    range: SourceRange;
+    /** Parent class name for methods/properties */
+    parent?: string;
+    /**
+     * In Python there's no `export` keyword. We treat module-level symbols
+     * (not prefixed with `_`) as "exported" and `_`-prefixed as "internal".
+     * Symbols listed in `__all__` are always exported.
+     */
+    isExported: boolean;
+    /** async def? */
+    isAsync?: boolean;
+    /** @staticmethod or @classmethod? */
+    isStatic?: boolean;
+    /** Name starts with `_` (convention-private) or `__` (name-mangled) */
+    visibility?: "public" | "private" | "protected";
+    /** First line of docstring (triple-quoted string after def/class) */
+    docSummary?: string;
+    /** Parameter names for functions/methods */
+    parameters?: string[];
+    /** Raw signature: `def foo(x: int, y: str) -> bool` */
+    signature?: string;
+    /** Decorator names (e.g., ["staticmethod", "property"]) */
+    decorators?: string[];
+    /** Base classes for class declarations */
+    bases?: string[];
+}
+export interface PythonImport {
+    /** Module path, e.g. "os.path" or ".utils" */
+    moduleName: string;
+    /** Is relative import? (starts with `.`) */
+    isRelative: boolean;
+    /** Individual names imported (`from X import a, b`) — empty for `import X` */
+    importedNames: Array<{
+        name: string;
+        alias?: string;
+    }>;
+    /** The whole module is imported (import X / import X as Y) */
+    isWholeModule: boolean;
+    /** Alias for module-level import (`import X as Y`) */
+    alias?: string;
+    range: SourceRange;
+}
+export interface PythonFileResult {
+    filePath: string;
+    language: "python";
+    symbols: PythonSymbol[];
+    imports: PythonImport[];
+    extractedAt: number;
+    errors?: string[];
+}
+export interface PythonExtractionOptions {
+    includePrivate?: boolean;
+    includeDocSummary?: boolean;
+    includeParameters?: boolean;
+    includeMembers?: boolean;
+    maxDepth?: number;
+}
+export interface PythonBatchResult {
+    files: Map<string, PythonFileResult>;
+    totalSymbols: number;
+    totalFiles: number;
+    failures: Array<{
+        filePath: string;
+        error: string;
+    }>;
+    durationMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,OAAO,GACP,QAAQ,GACR,UAAU,GACV,UAAU,GACV,QAAQ,CAAC;AAEb,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IAEnB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB,iBAAiB;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,uEAAuE;IACvE,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAEhD,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IAEnB,4CAA4C;IAC5C,UAAU,EAAE,OAAO,CAAC;IAEpB,8EAA8E;IAC9E,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IAEH,8DAA8D;IAC9D,aAAa,EAAE,OAAO,CAAC;IAEvB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,4 @@
+// Copyright 2025-2026 Benjamin Becker
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,sCAAsC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@intentweave/python-parser",
+  "version": "0.4.0",
+  "description": "Tree-sitter based AST extractor for Python source files",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "tree-sitter": "^0.21.1",
+    "tree-sitter-python": "^0.21.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "intentweave": {
+    "tier": "oss",
+    "description": "Python AST extraction engine — open-source, enables code linking for Python projects"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/intentweave/intentweave.git",
+    "directory": "packages/python-parser"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:unit": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo 'TODO: eslint'",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}