Method parse

ai/services/knowledge-base/parser/SourceParser.mjs:46–208

* Parses a Neo.mjs source file into granular chunks. * @param {String} content The raw file content. * @param {String} filePath The relative file path. * @param {String} [defaultType='src'] The type to assign to chunks (e.g., 'src', 'app', 'example'). * @param {Object} [hierarchy

(content, filePath, defaultType='src', hierarchy={})

     * @returns {Array<Object>} An array of chunks.
     */
    parse(content, filePath, defaultType='src', hierarchy={}) {
        const chunks = [];
        let ast;

        // Strip shebang if present (acorn doesn't handle it)
        if (content.startsWith('#!')) {
            content = content.replace(/^#!.*\n/, '');
        }

        try {
            // `ecmaVersion: 'latest'` lets acorn auto-track its highest-supported syntax
            // rather than pinning a literal year that future TC39 features (e.g. import
            // attributes `with {type: 'json'}`, decorators) would silently fail to parse.
            ast = acorn.parse(content, { sourceType: 'module', locations: true, ecmaVersion: 'latest' });
        } catch (e) {
            logger.warn(`Failed to parse source file ${filePath}: ${e.message}`);
            return [];
        }

        const contextNodes    = [];
        const propertyNodes   = [];
        let   configNode      = null;
        const methodNodes     = [];
        let   classStart      = 0;
        let   classDefinition = '';
        let   className       = '';
        let   superClass      = '';

        // 1. Traverse AST to categorize nodes
        ast.body.forEach(node => {
            if (node.type === 'ImportDeclaration' || node.type === 'VariableDeclaration') {
                // Top-level imports and vars belong to Module Context
                contextNodes.push(node);
            } else if (node.type === 'ClassDeclaration' || node.type === 'ExportDefaultDeclaration') {
                // Handle Class Definition
                const classDecl = node.type === 'ExportDefaultDeclaration' ? node.declaration : node;

                if (classDecl.type === 'ClassDeclaration') {
                    classStart = classDecl.start;
                    // Capture JSDoc comments preceding the class
                    const classHeadEnd = classDecl.body.start + 1; // Include opening brace
                    classDefinition    = content.substring(classDecl.start, classHeadEnd);

                    if (classDecl.id) {
                        className = classDecl.id.name;
                    }

                    // Iterate Class Body
                    classDecl.body.body.forEach(member => {
                        if (member.type === 'MethodDefinition') {
                            if (member.kind === 'constructor') {
                                methodNodes.push(member);
                            } else {
                                methodNodes.push(member);
                            }
                        } else if (member.type === 'PropertyDefinition') {
                            if (member.key.name === 'config' && member.static) {
                                configNode = member;