@nahisaho/musubix-codegraph 2.3.0 → 2.3.3

package/dist/parser/extractors/python.js

@@ -0,0 +1,184 @@
+/**
+ * @nahisaho/musubix-codegraph - Python Extractor
+ *
+ * AST extractor for Python source files
+ *
+ * @see REQ-CG-AST-001
+ * @see DES-CG-PYTHON
+ */
+import { BaseExtractor, } from './base-extractor.js';
+/**
+ * Python language extractor
+ */
+export class PythonExtractor extends BaseExtractor {
+    config = {
+        name: 'python',
+        extensions: ['.py', '.pyw'],
+        treeSitterName: 'python',
+        functionNodes: ['function_definition'],
+        classNodes: ['class_definition'],
+        importNodes: ['import_statement', 'import_from_statement'],
+        interfaceNodes: [],
+        moduleNodes: [],
+    };
+    extract(tree, filePath, sourceCode) {
+        const entities = [];
+        const relations = [];
+        const startTime = Date.now();
+        // Add file entity
+        entities.push(this.createFileEntity(filePath, sourceCode));
+        const fileEntityId = entities[0].id;
+        let currentClassId = null;
+        this.walkTree(tree.rootNode, (node) => {
+            switch (node.type) {
+                case 'function_definition': {
+                    const entity = this.extractFunction(node, filePath);
+                    if (entity) {
+                        entities.push(entity);
+                        relations.push(this.createRelation({
+                            type: currentClassId ? 'member_of' : 'contains',
+                            sourceId: entity.id,
+                            targetId: currentClassId || fileEntityId,
+                        }));
+                    }
+                    break;
+                }
+                case 'class_definition': {
+                    const entity = this.extractClass(node, filePath);
+                    if (entity) {
+                        entities.push(entity);
+                        currentClassId = entity.id;
+                        relations.push(this.createRelation({
+                            type: 'contains',
+                            sourceId: fileEntityId,
+                            targetId: entity.id,
+                        }));
+                        // Extract inheritance
+                        const heritage = this.extractInheritance(node, entity.id);
+                        relations.push(...heritage);
+                    }
+                    break;
+                }
+                case 'import_statement':
+                case 'import_from_statement': {
+                    const importRelations = this.extractImport(node, fileEntityId);
+                    relations.push(...importRelations);
+                    break;
+                }
+                case 'decorated_definition': {
+                    // Handle decorated functions/classes
+                    const definition = this.findChildByType(node, 'function_definition') ||
+                        this.findChildByType(node, 'class_definition');
+                    if (definition) {
+                        // Will be processed in next iteration
+                    }
+                    break;
+                }
+            }
+        });
+        return {
+            entities,
+            relations,
+            errors: [],
+            stats: {
+                linesOfCode: sourceCode.split('\n').length,
+                parseTimeMs: Date.now() - startTime,
+            },
+        };
+    }
+    extractFunction(node, filePath) {
+        const nameNode = this.getChildByField(node, 'name');
+        const name = nameNode?.text || '<anonymous>';
+        // Extract docstring (first string in body)
+        const body = this.getChildByField(node, 'body');
+        let docstring;
+        if (body?.namedChildren[0]?.type === 'expression_statement') {
+            const expr = body.namedChildren[0].namedChildren[0];
+            if (expr?.type === 'string') {
+                docstring = this.cleanDocstring(expr.text);
+            }
+        }
+        return this.createEntity({
+            type: 'function',
+            name,
+            filePath,
+            startLine: this.getLineNumber(node, 'start'),
+            endLine: this.getLineNumber(node, 'end'),
+            language: 'python',
+            docstring,
+        });
+    }
+    extractClass(node, filePath) {
+        const nameNode = this.getChildByField(node, 'name');
+        const name = nameNode?.text || '<anonymous>';
+        // Extract docstring
+        const body = this.getChildByField(node, 'body');
+        let docstring;
+        if (body?.namedChildren[0]?.type === 'expression_statement') {
+            const expr = body.namedChildren[0].namedChildren[0];
+            if (expr?.type === 'string') {
+                docstring = this.cleanDocstring(expr.text);
+            }
+        }
+        return this.createEntity({
+            type: 'class',
+            name,
+            filePath,
+            startLine: this.getLineNumber(node, 'start'),
+            endLine: this.getLineNumber(node, 'end'),
+            language: 'python',
+            docstring,
+        });
+    }
+    extractInheritance(node, classId) {
+        const relations = [];
+        const argumentList = this.getChildByField(node, 'superclasses');
+        if (argumentList) {
+            for (const arg of argumentList.namedChildren) {
+                const baseName = arg.type === 'identifier' ? arg.text : arg.text;
+                if (baseName) {
+                    relations.push(this.createRelation({
+                        type: 'extends',
+                        sourceId: classId,
+                        targetId: `external:${baseName}`,
+                    }));
+                }
+            }
+        }
+        return relations;
+    }
+    extractImport(node, fileEntityId) {
+        const relations = [];
+        if (node.type === 'import_statement') {
+            // import x, y, z
+            for (const child of node.namedChildren) {
+                if (child.type === 'dotted_name' || child.type === 'aliased_import') {
+                    const moduleName = child.type === 'aliased_import'
+                        ? this.findChildByType(child, 'dotted_name')?.text
+                        : child.text;
+                    if (moduleName) {
+                        relations.push(this.createRelation({
+                            type: 'imports',
+                            sourceId: fileEntityId,
+                            targetId: `module:${moduleName}`,
+                        }));
+                    }
+                }
+            }
+        }
+        else {
+            // from x import y
+            const moduleNode = this.getChildByField(node, 'module_name');
+            const moduleName = moduleNode?.text;
+            if (moduleName) {
+                relations.push(this.createRelation({
+                    type: 'imports',
+                    sourceId: fileEntityId,
+                    targetId: `module:${moduleName}`,
+                }));
+            }
+        }
+        return relations;
+    }
+}
+//# sourceMappingURL=python.js.map

package/dist/parser/extractors/python.js.map

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

package/dist/parser/extractors/ruby.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @nahisaho/musubix-codegraph - Ruby Extractor
+ *
+ * AST extractor for Ruby source files
+ *
+ * @see REQ-CG-MULTILANG-008
+ * @see DES-CG-RUBY
+ * @see TSK-CG-024
+ */
+import type { ParseResult } from '../../types.js';
+import { BaseExtractor, type LanguageConfig, type SyntaxTree } from './base-extractor.js';
+/**
+ * Ruby language extractor
+ */
+export declare class RubyExtractor extends BaseExtractor {
+    readonly config: LanguageConfig;
+    extract(tree: SyntaxTree, filePath: string, sourceCode: string): ParseResult;
+    private extractModule;
+    private extractClass;
+    private extractMethod;
+    private extractHeritage;
+    private extractRequire;
+    private extractRubyDocComment;
+}
+//# sourceMappingURL=ruby.d.ts.map

package/dist/parser/extractors/ruby.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruby.d.ts","sourceRoot":"","sources":["../../../src/parser/extractors/ruby.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACL,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAS7B;IAEF,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW;IA2F5E,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,qBAAqB;CAmB9B"}

package/dist/parser/extractors/ruby.js

@@ -0,0 +1,193 @@
+/**
+ * @nahisaho/musubix-codegraph - Ruby Extractor
+ *
+ * AST extractor for Ruby source files
+ *
+ * @see REQ-CG-MULTILANG-008
+ * @see DES-CG-RUBY
+ * @see TSK-CG-024
+ */
+import { BaseExtractor, } from './base-extractor.js';
+/**
+ * Ruby language extractor
+ */
+export class RubyExtractor extends BaseExtractor {
+    config = {
+        name: 'ruby',
+        extensions: ['.rb', '.rake', '.gemspec'],
+        treeSitterName: 'ruby',
+        functionNodes: ['method', 'singleton_method'],
+        classNodes: ['class'],
+        importNodes: ['call'],
+        interfaceNodes: [],
+        moduleNodes: ['module'],
+    };
+    extract(tree, filePath, sourceCode) {
+        const entities = [];
+        const relations = [];
+        const startTime = Date.now();
+        entities.push(this.createFileEntity(filePath, sourceCode));
+        const fileEntityId = entities[0].id;
+        let currentClassId = null;
+        let currentModuleId = null;
+        this.walkTree(tree.rootNode, (node) => {
+            switch (node.type) {
+                case 'module': {
+                    const entity = this.extractModule(node, filePath);
+                    if (entity) {
+                        entities.push(entity);
+                        currentModuleId = entity.id;
+                        relations.push(this.createRelation({
+                            type: 'contains',
+                            sourceId: fileEntityId,
+                            targetId: entity.id,
+                        }));
+                    }
+                    break;
+                }
+                case 'class': {
+                    const entity = this.extractClass(node, filePath);
+                    if (entity) {
+                        entities.push(entity);
+                        currentClassId = entity.id;
+                        const parentId = currentModuleId || fileEntityId;
+                        relations.push(this.createRelation({
+                            type: 'contains',
+                            sourceId: parentId,
+                            targetId: entity.id,
+                        }));
+                        const heritage = this.extractHeritage(node, entity.id);
+                        relations.push(...heritage);
+                    }
+                    break;
+                }
+                case 'method':
+                case 'singleton_method': {
+                    const entity = this.extractMethod(node, filePath);
+                    if (entity) {
+                        entities.push(entity);
+                        const parentId = currentClassId || currentModuleId || fileEntityId;
+                        relations.push(this.createRelation({
+                            type: currentClassId ? 'member_of' : 'contains',
+                            sourceId: entity.id,
+                            targetId: parentId,
+                        }));
+                    }
+                    break;
+                }
+                case 'call': {
+                    // Check for require/require_relative
+                    const methodNode = this.getChildByField(node, 'method');
+                    if (methodNode) {
+                        const methodName = methodNode.text;
+                        if (methodName === 'require' || methodName === 'require_relative') {
+                            const importRelations = this.extractRequire(node, fileEntityId);
+                            relations.push(...importRelations);
+                        }
+                    }
+                    break;
+                }
+            }
+        });
+        return {
+            entities,
+            relations,
+            errors: [],
+            stats: {
+                linesOfCode: sourceCode.split('\n').length,
+                parseTimeMs: Date.now() - startTime,
+            },
+        };
+    }
+    extractModule(node, filePath) {
+        const nameNode = this.getChildByField(node, 'name');
+        const name = nameNode?.text || '<anonymous>';
+        return this.createEntity({
+            type: 'module',
+            name,
+            filePath,
+            startLine: this.getLineNumber(node, 'start'),
+            endLine: this.getLineNumber(node, 'end'),
+            language: 'ruby',
+            docstring: this.extractRubyDocComment(node),
+        });
+    }
+    extractClass(node, filePath) {
+        const nameNode = this.getChildByField(node, 'name');
+        const name = nameNode?.text || '<anonymous>';
+        return this.createEntity({
+            type: 'class',
+            name,
+            filePath,
+            startLine: this.getLineNumber(node, 'start'),
+            endLine: this.getLineNumber(node, 'end'),
+            language: 'ruby',
+            docstring: this.extractRubyDocComment(node),
+        });
+    }
+    extractMethod(node, filePath) {
+        const nameNode = this.getChildByField(node, 'name');
+        const name = nameNode?.text || '<anonymous>';
+        const isSingleton = node.type === 'singleton_method';
+        return this.createEntity({
+            type: 'method',
+            name: isSingleton ? `self.${name}` : name,
+            filePath,
+            startLine: this.getLineNumber(node, 'start'),
+            endLine: this.getLineNumber(node, 'end'),
+            language: 'ruby',
+            docstring: this.extractRubyDocComment(node),
+            metadata: {
+                singleton: isSingleton,
+            },
+        });
+    }
+    extractHeritage(node, classId) {
+        const relations = [];
+        const superclassNode = this.getChildByField(node, 'superclass');
+        if (superclassNode) {
+            const name = superclassNode.text;
+            relations.push(this.createRelation({
+                type: 'extends',
+                sourceId: classId,
+                targetId: `external:${name}`,
+            }));
+        }
+        return relations;
+    }
+    extractRequire(node, fileEntityId) {
+        const relations = [];
+        const argsNode = this.getChildByField(node, 'arguments');
+        if (argsNode) {
+            const stringNode = this.findChildByType(argsNode, 'string');
+            if (stringNode) {
+                const path = stringNode.text.replace(/['"]/g, '');
+                relations.push(this.createRelation({
+                    type: 'imports',
+                    sourceId: fileEntityId,
+                    targetId: `module:${path}`,
+                }));
+            }
+        }
+        return relations;
+    }
+    extractRubyDocComment(node) {
+        const parent = node.parent;
+        if (!parent)
+            return undefined;
+        const siblings = parent.children;
+        const nodeIndex = siblings.indexOf(node);
+        const docLines = [];
+        for (let i = nodeIndex - 1; i >= 0; i--) {
+            const sibling = siblings[i];
+            if (sibling.type === 'comment') {
+                docLines.unshift(sibling.text.replace(/^#\s?/, ''));
+            }
+            else {
+                break;
+            }
+        }
+        return docLines.length > 0 ? docLines.join('\n') : undefined;
+    }
+}
+//# sourceMappingURL=ruby.js.map

package/dist/parser/extractors/ruby.js.map

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

package/dist/parser/extractors/rust.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @nahisaho/musubix-codegraph - Rust Extractor
+ *
+ * AST extractor for Rust source files
+ *
+ * @see REQ-CG-MULTILANG-001
+ * @see DES-CG-RUST
+ * @see TSK-CG-010
+ */
+import type { ParseResult } from '../../types.js';
+import { BaseExtractor, type LanguageConfig, type SyntaxTree } from './base-extractor.js';
+/**
+ * Rust language extractor
+ */
+export declare class RustExtractor extends BaseExtractor {
+    readonly config: LanguageConfig;
+    extract(tree: SyntaxTree, filePath: string, sourceCode: string): ParseResult;
+    private extractFunction;
+    private extractStruct;
+    private extractEnum;
+    private extractTrait;
+    private extractImpl;
+    private extractModule;
+    private extractUse;
+    private extractRustDocComment;
+}
+//# sourceMappingURL=rust.d.ts.map

package/dist/parser/extractors/rust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rust.d.ts","sourceRoot":"","sources":["../../../src/parser/extractors/rust.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACL,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAS7B;IAEF,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW;IA4H5E,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,WAAW;IAyCnB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,qBAAqB;CAwB9B"}