@winspan/claude-forge 8.54.4 → 9.2.0

package/dist/knowledge/adapters/python-adapter.js

@@ -0,0 +1,358 @@
+/**
+ * @file adapters/python-adapter.ts
+ * v10.2 — Python adapter (src-layout + flat-layout support).
+ *
+ * Uses tree-sitter-python for AST parsing. Native module dependency is declared
+ * as optionalDependencies in package.json; if installation fails, parseSymbols
+ * throws a friendly error.
+ *
+ * Supports:
+ * - src-layout: src/<package>/ (PEP 420 namespace packages)
+ * - flat-layout: <package>/ at project root
+ * - pyproject.toml / setup.py / requirements.txt detection
+ *
+ * Module discovery:
+ * - Treats each top-level package (directory with __init__.py or PEP 420 namespace)
+ *   as one module
+ * - For src-layout: discovers packages under src/
+ * - For flat-layout: discovers packages at project root
+ *
+ * Limitations (v10.2):
+ * - Does NOT parse pyproject.toml/setup.py for package metadata
+ * - Method signatures simplified (no parameter types extracted)
+ * - Decorators/async/complex AST nodes may be skipped
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Normalise a filesystem path to POSIX-style for storage inside the KB.
+ */
+function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+export class PythonAdapter {
+    name = 'python';
+    fileExtensions = ['.py'];
+    /**
+     * Project is Python iff it has pyproject.toml, setup.py, or requirements.txt.
+     */
+    detect(projectRoot) {
+        return (fs.existsSync(path.join(projectRoot, 'pyproject.toml')) ||
+            fs.existsSync(path.join(projectRoot, 'setup.py')) ||
+            fs.existsSync(path.join(projectRoot, 'requirements.txt')));
+    }
+    /**
+     * Discover source roots:
+     * 1. Check for src/ directory (src-layout)
+     * 2. Fall back to project root (flat-layout)
+     */
+    discoverSourceRoots(projectRoot) {
+        const srcDir = path.join(projectRoot, 'src');
+        if (fs.existsSync(srcDir)) {
+            return [srcDir];
+        }
+        return [projectRoot];
+    }
+    /**
+     * Discover Python packages (modules).
+     * A package is a directory containing:
+     * - __init__.py (traditional package), OR
+     * - At least one .py file (PEP 420 namespace package)
+     *
+     * For src-layout: discovers packages under src/
+     * For flat-layout: discovers packages at project root
+     *
+     * Excludes: hidden dirs, __pycache__, .venv, venv, tests, test, build, dist, .egg-info
+     */
+    discoverModules(projectRoot) {
+        const roots = this.discoverSourceRoots(projectRoot);
+        const modules = [];
+        for (const root of roots) {
+            const packages = this.findPackages(root);
+            for (const pkg of packages) {
+                const name = path.basename(pkg);
+                const refPrefix = root === projectRoot ? name : `src/${name}`;
+                modules.push({
+                    name,
+                    rootDir: pkg,
+                    refPrefix,
+                });
+            }
+        }
+        return modules.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * Find all top-level Python packages in a directory.
+     * Returns absolute paths to package directories.
+     */
+    findPackages(dir) {
+        const packages = [];
+        const excludeDirs = new Set([
+            '__pycache__',
+            '.venv',
+            'venv',
+            'env',
+            '.env',
+            'tests',
+            'test',
+            'build',
+            'dist',
+            '.pytest_cache',
+            '.tox',
+            '.mypy_cache',
+        ]);
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return packages;
+        }
+        for (const e of entries) {
+            if (!e.isDirectory())
+                continue;
+            if (e.name.startsWith('.'))
+                continue;
+            if (excludeDirs.has(e.name))
+                continue;
+            if (e.name.endsWith('.egg-info'))
+                continue;
+            const full = path.join(dir, e.name);
+            // Check if it's a package (has __init__.py or contains .py files)
+            if (this.isPackage(full)) {
+                packages.push(full);
+            }
+        }
+        return packages;
+    }
+    /**
+     * Check if a directory is a Python package.
+     * Returns true if:
+     * - Contains __init__.py (traditional package), OR
+     * - Contains at least one .py file (PEP 420 namespace package)
+     */
+    isPackage(dir) {
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            // Check for __init__.py
+            if (entries.some(e => e.isFile() && e.name === '__init__.py')) {
+                return true;
+            }
+            // Check for any .py files (PEP 420 namespace package)
+            return entries.some(e => e.isFile() && e.name.endsWith('.py'));
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Recursively walk module root, collecting .py files.
+     * Excludes: __pycache__, .venv, venv, tests, test, hidden dirs.
+     */
+    async walkModuleFiles(module) {
+        const files = [];
+        const excludeDirs = new Set([
+            '__pycache__',
+            '.venv',
+            'venv',
+            'env',
+            '.env',
+            'tests',
+            'test',
+            '.pytest_cache',
+            '.tox',
+            '.mypy_cache',
+        ]);
+        const walk = (dir) => {
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const e of entries) {
+                const full = path.join(dir, e.name);
+                if (e.isDirectory()) {
+                    // Skip excluded and hidden dirs
+                    if (excludeDirs.has(e.name) || e.name.startsWith('.')) {
+                        continue;
+                    }
+                    walk(full);
+                }
+                else if (e.isFile() && e.name.endsWith('.py')) {
+                    const relPath = toPosix(path.relative(module.rootDir, full));
+                    const projectRelPath = module.refPrefix ? toPosix(path.join(module.refPrefix, relPath)) : relPath;
+                    files.push({
+                        relPath,
+                        projectRelPath,
+                        content: fs.readFileSync(full, 'utf-8'),
+                    });
+                }
+            }
+        };
+        walk(module.rootDir);
+        return files;
+    }
+    /**
+     * Extract symbols from Python source using tree-sitter-python.
+     * Lazy-imports tree-sitter to avoid breaking the entire adapter when native
+     * module installation fails.
+     *
+     * Extracts:
+     * - class declarations
+     * - function definitions (top-level and class methods)
+     * - module-level constants (UPPER_CASE variables)
+     */
+    async parseSymbols(file) {
+        // Lazy import to isolate native module dependency
+        let Parser, Python;
+        try {
+            // @ts-ignore - optional native module, may not be installed
+            const treeSitter = await import('tree-sitter');
+            // @ts-ignore - optional native module, may not be installed
+            const treeSitterPython = await import('tree-sitter-python');
+            Parser = treeSitter.default;
+            Python = treeSitterPython.default;
+        }
+        catch (err) {
+            // Graceful degradation: return empty symbols when tree-sitter is not available
+            // This allows KB build to continue in degraded mode (no symbol references)
+            return [];
+        }
+        const parser = new Parser();
+        parser.setLanguage(Python);
+        const tree = parser.parse(file.content);
+        const symbols = [];
+        /**
+         * Recursively visit AST nodes.
+         * @param node Current AST node
+         * @param parentClass Parent class name (for methods)
+         */
+        const visit = (node, parentClass = null) => {
+            if (!node)
+                return;
+            // Class definition
+            if (node.type === 'class_definition') {
+                const nameNode = node.childForFieldName('name');
+                if (!nameNode)
+                    return;
+                const className = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                const line = nameNode.startPosition.row + 1;
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind: 'class',
+                    name: className,
+                    signature: `class ${className}`,
+                    exports: false,
+                });
+                // Visit class body for methods
+                const body = node.childForFieldName('body');
+                if (body) {
+                    for (let i = 0; i < body.childCount; i++) {
+                        visit(body.child(i), className);
+                    }
+                }
+                return;
+            }
+            // Function definition
+            if (node.type === 'function_definition') {
+                const nameNode = node.childForFieldName('name');
+                if (!nameNode)
+                    return;
+                const funcName = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                const line = nameNode.startPosition.row + 1;
+                // Skip private methods (starting with _) unless they're __init__ or __str__
+                if (funcName.startsWith('_') && !funcName.startsWith('__')) {
+                    return;
+                }
+                const fullName = parentClass ? `${parentClass}.${funcName}` : funcName;
+                const kind = parentClass ? 'function' : 'function';
+                // Extract parameters
+                const params = node.childForFieldName('parameters');
+                let signature = `def ${fullName}(`;
+                if (params) {
+                    const paramList = [];
+                    for (let i = 0; i < params.childCount; i++) {
+                        const child = params.child(i);
+                        if (child.type === 'identifier') {
+                            paramList.push(file.content.slice(child.startIndex, child.endIndex));
+                        }
+                        else if (child.type === 'typed_parameter' || child.type === 'default_parameter') {
+                            const paramName = child.childForFieldName('name');
+                            if (paramName) {
+                                paramList.push(file.content.slice(paramName.startIndex, paramName.endIndex));
+                            }
+                        }
+                    }
+                    signature += paramList.join(', ');
+                }
+                signature += ')';
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind,
+                    name: fullName,
+                    signature,
+                    exports: false,
+                });
+                return;
+            }
+            // Module-level constants (UPPER_CASE variables)
+            if (node.type === 'assignment' && !parentClass) {
+                const left = node.childForFieldName('left');
+                if (!left || left.type !== 'identifier')
+                    return;
+                const varName = file.content.slice(left.startIndex, left.endIndex);
+                // Only extract UPPER_CASE constants
+                if (varName !== varName.toUpperCase() || varName.startsWith('_')) {
+                    return;
+                }
+                const line = left.startPosition.row + 1;
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind: 'const',
+                    name: varName,
+                    signature: varName,
+                    exports: false,
+                });
+                return;
+            }
+            // Recurse into other nodes
+            for (let i = 0; i < node.childCount; i++) {
+                visit(node.child(i), parentClass);
+            }
+        };
+        visit(tree.rootNode);
+        return symbols;
+    }
+    /**
+     * Describe project metadata files.
+     * Returns the primary manifest (pyproject.toml or setup.py) and common config files.
+     */
+    describeProjectMeta(projectRoot) {
+        const pyproject = path.join(projectRoot, 'pyproject.toml');
+        const setupPy = path.join(projectRoot, 'setup.py');
+        const requirements = path.join(projectRoot, 'requirements.txt');
+        const manifestPath = fs.existsSync(pyproject)
+            ? pyproject
+            : fs.existsSync(setupPy)
+                ? setupPy
+                : fs.existsSync(requirements)
+                    ? requirements
+                    : null;
+        const candidates = [
+            path.join(projectRoot, 'pyproject.toml'),
+            path.join(projectRoot, 'setup.cfg'),
+            path.join(projectRoot, 'tox.ini'),
+            path.join(projectRoot, 'pytest.ini'),
+        ];
+        return {
+            manifestPath,
+            configPaths: candidates.filter((p) => fs.existsSync(p)),
+        };
+    }
+}
+//# sourceMappingURL=python-adapter.js.map

package/dist/knowledge/adapters/python-adapter.js.map

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

package/dist/knowledge/adapters/rust-adapter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @file adapters/rust-adapter.ts
+ * v10.4 — Rust adapter (workspace + single-crate support).
+ *
+ * Uses tree-sitter-rust for AST parsing. Native module dependency is declared
+ * as optionalDependencies in package.json; if installation fails, parseSymbols
+ * throws a friendly error.
+ *
+ * Supports:
+ * - Single-crate projects (src/lib.rs or src/main.rs)
+ * - Workspace projects (Cargo.toml [workspace])
+ * - Cargo.toml detection
+ *
+ * Module discovery:
+ * - Single-crate: one 'root' module
+ * - Workspace: each member crate becomes a module
+ *
+ * Limitations (v10.4):
+ * - Does NOT parse Cargo.toml for workspace members (uses filesystem heuristic)
+ * - Method signatures simplified (no parameter types extracted)
+ * - Macros/complex AST nodes may be skipped
+ */
+import type { LanguageAdapter, ModuleInfo, SourceFile } from './types.js';
+import type { RepoMapSymbol } from '../types.js';
+export declare class RustAdapter implements LanguageAdapter {
+    readonly name = "rust";
+    readonly fileExtensions: readonly [".rs"];
+    /**
+     * Project is Rust iff it has Cargo.toml.
+     */
+    detect(projectRoot: string): boolean;
+    /**
+     * Discover source roots.
+     * For single-crate: src/
+     * For workspace: each member's src/
+     */
+    discoverSourceRoots(projectRoot: string): string[];
+    /**
+     * Check if this is a workspace project.
+     * Heuristic: if there are subdirectories with Cargo.toml, it's likely a workspace.
+     */
+    private _isWorkspace;
+    /**
+     * Discover Rust crates (modules).
+     * For single-crate: one 'root' module
+     * For workspace: each member crate is a module
+     */
+    discoverModules(projectRoot: string): ModuleInfo[];
+    /**
+     * Recursively walk module root, collecting .rs files.
+     * Excludes: target/, tests/, hidden dirs, test modules
+     */
+    walkModuleFiles(module: ModuleInfo): Promise<SourceFile[]>;
+    /**
+     * Extract symbols from Rust source using tree-sitter-rust.
+     * Lazy-imports tree-sitter to avoid breaking the entire adapter when native
+     * module installation fails.
+     */
+    parseSymbols(file: SourceFile): Promise<RepoMapSymbol[]>;
+    /**
+     * Check if a node has 'pub' visibility modifier.
+     */
+    private _hasVisibilityModifier;
+    /**
+     * Describe project metadata files.
+     * Returns Cargo.toml as manifestPath and no config paths.
+     */
+    describeProjectMeta(projectRoot: string): {
+        manifestPath: string | null;
+        configPaths: string[];
+    };
+}
+//# sourceMappingURL=rust-adapter.d.ts.map

package/dist/knowledge/adapters/rust-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rust-adapter.d.ts","sourceRoot":"","sources":["../../../src/knowledge/adapters/rust-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,cAAc,mBAAoB;IAE3C;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAiClD;;;OAGG;IACH,OAAO,CAAC,YAAY;IAkBpB;;;;OAIG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE;IAuClD;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmChE;;;;OAIG;IACG,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA8I9D;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE;CAMjG"}