neo.mjs 11.10.0 → 11.12.0

package/.github/.sync-metadata.json

@@ -1,6 +1,6 @@
 {
-  "lastSync": "2025-11-24T14:26:12.386Z",
-  "releasesLastFetched": "2025-11-24T14:26:12.404Z",
+  "lastSync": "2025-11-29T11:15:42.912Z",
+  "releasesLastFetched": "2025-11-29T11:15:42.924Z",
   "pushFailures": [],
   "issues": {
     "3789": {
@@ -11366,143 +11366,206 @@
     },
     "7880": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7880.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7880.md",
       "closedAt": "2025-11-23T16:15:30Z",
       "updatedAt": "2025-11-23T16:15:31Z",
       "contentHash": "8169acef7278d27b7d782fc874402b8e143cad2f2e0e9a38610674a360f492ee"
     },
     "7881": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7881.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7881.md",
       "closedAt": "2025-11-23T16:31:50Z",
       "updatedAt": "2025-11-23T16:31:50Z",
       "contentHash": "f4bfbf7a355b95e1f26042e94e5caae47869f6e526ee4670350b6df03c4bd2fd"
     },
     "7882": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7882.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7882.md",
       "closedAt": "2025-11-23T17:38:18Z",
       "updatedAt": "2025-11-23T17:38:18Z",
       "contentHash": "f6bfa5871edab1efc17f3f4ab7c1f8609b45114b48688215df9fd46d2f220102"
     },
     "7883": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7883.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7883.md",
       "closedAt": "2025-11-23T18:26:05Z",
       "updatedAt": "2025-11-23T18:26:05Z",
       "contentHash": "28b202a1c362a8ef24e73c2579084f7113ff087a566b151c19b68a2765ebf9a1"
     },
     "7884": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7884.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7884.md",
       "closedAt": "2025-11-23T18:49:25Z",
       "updatedAt": "2025-11-23T18:49:25Z",
       "contentHash": "358d6ef0a09fdb6745e79d1d5c259cab9479c2ebbcfed17edbce3312a145832c"
     },
     "7885": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7885.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7885.md",
       "closedAt": "2025-11-23T19:22:42Z",
       "updatedAt": "2025-11-23T19:22:42Z",
       "contentHash": "1e45ab7db9b529eb89375445b1433e9f703266e46f106f90b0ed5f04e22a7f0e"
     },
     "7886": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7886.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7886.md",
       "closedAt": "2025-11-23T19:30:41Z",
       "updatedAt": "2025-11-23T19:30:41Z",
       "contentHash": "1a543173da7fa19e74c931a87aa6df43232a8c0c5c6888fe2b3bed3a3b926bbf"
     },
     "7888": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7888.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7888.md",
       "closedAt": "2025-11-24T08:49:32Z",
       "updatedAt": "2025-11-24T08:49:32Z",
       "contentHash": "60df1b84159a9062a652c47489dca2eb91e646135e3f078b6b21b2cf7258ae71"
     },
     "7889": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7889.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7889.md",
       "closedAt": "2025-11-24T09:40:53Z",
       "updatedAt": "2025-11-24T09:40:53Z",
       "contentHash": "edf299eae98b2194199dc2bfe43f097ac540d6a630fb9ed1f70f120a8b850193"
     },
     "7890": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7890.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7890.md",
       "closedAt": "2025-11-24T10:06:09Z",
       "updatedAt": "2025-11-24T10:06:09Z",
       "contentHash": "7bc6db7b6c13691d68f74db0fe4b56b324e438ab02749cf7463d28a3385a2ae3"
     },
     "7891": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7891.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7891.md",
       "closedAt": "2025-11-24T10:56:33Z",
       "updatedAt": "2025-11-24T10:56:33Z",
       "contentHash": "a5ebc6a570291812d5e071ae18f9f3ac42b07be689aad3dad9d70a267e585dc5"
     },
     "7892": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7892.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7892.md",
       "closedAt": "2025-11-24T11:25:49Z",
       "updatedAt": "2025-11-24T11:25:49Z",
       "contentHash": "2692519931cea270f9b3759bb6a28fa53cf1859d75020efd825a519bca575352"
     },
     "7893": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7893.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7893.md",
       "closedAt": "2025-11-24T11:47:31Z",
       "updatedAt": "2025-11-24T11:47:31Z",
       "contentHash": "9bcfe45c5c5be4663db98966828bb98f49dd5a686df728a7730b57dd4cd74784"
     },
     "7894": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7894.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7894.md",
       "closedAt": "2025-11-24T11:04:55Z",
       "updatedAt": "2025-11-24T11:04:55Z",
       "contentHash": "abdcf2011ed90cd4b33b82a693def9715da8668f0efeb01df67876ec4d6f5725"
     },
     "7895": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7895.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7895.md",
       "closedAt": "2025-11-24T11:54:36Z",
       "updatedAt": "2025-11-24T11:54:36Z",
       "contentHash": "d41f3e086248d7fd849ecd16b05d43f4aeda89e853e7164b51bfb7a039e6250c"
     },
     "7896": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7896.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7896.md",
       "closedAt": "2025-11-24T13:02:52Z",
       "updatedAt": "2025-11-24T13:07:21Z",
       "contentHash": "91507a7af3eebccd639a50d9634e74baa28697487fd158474ee8f2e00c5bf608"
     },
     "7897": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7897.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7897.md",
       "closedAt": "2025-11-24T13:02:44Z",
       "updatedAt": "2025-11-24T13:07:24Z",
       "contentHash": "d7e76a355c2f2516cb0b22366349f3c0f6549f01acb888fd401706297311802b"
     },
     "7898": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7898.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7898.md",
       "closedAt": "2025-11-24T13:38:12Z",
       "updatedAt": "2025-11-24T13:54:56Z",
       "contentHash": "3e1adfccf0f12c2b90831dfbe9046d0adb53d7dfea3ee488f7d1263df66a19c7"
     },
     "7899": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7899.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7899.md",
       "closedAt": "2025-11-24T13:54:24Z",
       "updatedAt": "2025-11-24T13:54:24Z",
       "contentHash": "ac5a7624b45eefd8a7655eccc25ddc88ffb2fe2da728cd46b115e2ec4fccb166"
     },
     "7900": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7900.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.10.0/issue-7900.md",
       "closedAt": "2025-11-24T14:17:25Z",
       "updatedAt": "2025-11-24T14:17:25Z",
       "contentHash": "ac8db64fb3980f58b7026d555d3cfbbe299aff6cdb253f260941ec95d6dacb38"
+    },
+    "7901": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.11.0/issue-7901.md",
+      "closedAt": "2025-11-25T14:42:12Z",
+      "updatedAt": "2025-11-25T14:42:12Z",
+      "contentHash": "df95d24ff0394a9df62f9e77df76da28e2e940c48c5e33dce4db074258f2ee63"
+    },
+    "7902": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.11.0/issue-7902.md",
+      "closedAt": "2025-11-25T15:33:44Z",
+      "updatedAt": "2025-11-25T15:33:44Z",
+      "contentHash": "e426d92a1d399f16a99e31e738480d93f3b8a0aeb087b700d54e679d54360819"
+    },
+    "7903": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.11.0/issue-7903.md",
+      "closedAt": "2025-11-25T16:16:35Z",
+      "updatedAt": "2025-11-25T16:16:35Z",
+      "contentHash": "d9b1081d45e5d217dca97175eb83bfea2931b2db0dd2273742eab9ce7b79dc41"
+    },
+    "7904": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.11.0/issue-7904.md",
+      "closedAt": "2025-11-25T17:29:44Z",
+      "updatedAt": "2025-11-25T17:29:44Z",
+      "contentHash": "b1cbc69a5455aa9cc284c8fca4eb777321bd3f7b1fa53737369940be50d4618f"
+    },
+    "7905": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.11.0/issue-7905.md",
+      "closedAt": "2025-11-25T16:58:34Z",
+      "updatedAt": "2025-11-25T16:58:34Z",
+      "contentHash": "19b77ac389380f988cffa09a9fe8275d941b945f1d0108be7910323e85dbccc2"
+    },
+    "7906": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.11.0/issue-7906.md",
+      "closedAt": "2025-11-25T17:12:28Z",
+      "updatedAt": "2025-11-25T17:12:28Z",
+      "contentHash": "3bc74d1d726307ce576f8fccdbacb955c37e7397c3e9455b6557c858f1403a2a"
+    },
+    "7907": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.11.0/issue-7907.md",
+      "closedAt": "2025-11-26T12:06:44Z",
+      "updatedAt": "2025-11-26T12:06:44Z",
+      "contentHash": "d90268f900a41a41cc260e28bc0706c4ebb58df375fda02078e96feb415642d3"
+    },
+    "7908": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.11.0/issue-7908.md",
+      "closedAt": "2025-11-26T12:16:41Z",
+      "updatedAt": "2025-11-26T12:16:41Z",
+      "contentHash": "e1743278c16039256ce4b5b1bf426954360b3932f0cd9c2b04d41ad8dd73c3e5"
+    },
+    "7910": {
+      "state": "OPEN",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7910.md",
+      "closedAt": null,
+      "updatedAt": "2025-11-29T11:06:44Z",
+      "contentHash": "7032459b4722cefc837924239ca8e5fe980aca20e14f651694839954d1cf21f5"
     }
   },
   "releases": {
@@ -12089,6 +12152,14 @@
     "11.9.0": {
       "publishedAt": "2025-11-23T12:55:07Z",
       "contentHash": "bad71976e8158741c3c1348ac78f473688e69ad758583802075e1556745823a7"
+    },
+    "11.10.0": {
+      "publishedAt": "2025-11-24T14:55:45Z",
+      "contentHash": "a8a57e77420ccf5b3c33c67f8378ebc4ee7e169d1bac62c051bf7900c9cef7ec"
+    },
+    "11.11.0": {
+      "publishedAt": "2025-11-26T12:47:01Z",
+      "contentHash": "a36a4eb6939c0210968c3e7bddb8225c14567b3e2941c7f2c6b70f656c9128b4"
     }
   }
 }

package/ServiceWorker.mjs

@@ -20,9 +20,9 @@ class ServiceWorker extends ServiceBase {
          */
         singleton: true,
         /**
-         * @member {String} version='11.10.0'
+         * @member {String} version='11.12.0'
          */
-        version: '11.10.0'
+        version: '11.12.0'
     }
 
     /**

package/ai/mcp/server/knowledge-base/parser/ApiParser.mjs

@@ -0,0 +1,87 @@
+import Base from '../../../../../src/core/Base.mjs';
+import path from 'path';
+
+/**
+ * @summary Extracts knowledge chunks from JSDoc API data.
+ *
+ * This parser transforms the structured JSON output from JSDoc (`docs/output/all.json`)
+ * into flattened knowledge chunks. It handles the three primary API entities:
+ * 1.  **Classes:** Extracts descriptions and inheritance relationships.
+ * 2.  **Configs:** Extracts member descriptions, types, and default values.
+ * 3.  **Methods:** Extracts signatures, parameters, return types, and descriptions.
+ *
+ * It also classifies content as 'example' or 'src' based on the file path, helping
+ * to distinguish between library code and demo usage.
+ *
+ * @class Neo.ai.mcp.server.knowledge-base.parser.ApiParser
+ * @extends Neo.core.Base
+ * @singleton
+ */
+class ApiParser extends Base {
+    static config = {
+        /**
+         * @member {String} className='Neo.ai.mcp.server.knowledge-base.parser.ApiParser'
+         * @protected
+         */
+        className: 'Neo.ai.mcp.server.knowledge-base.parser.ApiParser',
+        /**
+         * @member {Boolean} singleton=true
+         * @protected
+         */
+        singleton: true
+    }
+
+    /**
+     * Parses the JSDoc API data array into granular chunks.
+     * @param {Array<Object>} apiData The JSDoc output array.
+     * @returns {Array<Object>} An array of chunks.
+     */
+    parse(apiData) {
+        const chunks = [];
+
+        apiData.forEach(item => {
+            const sourceFile = item.meta ? path.join(item.meta.path, item.meta.filename) : 'unknown';
+            let chunk, type  = sourceFile.includes('/examples/') ? 'example' : 'src';
+
+            if (item.kind === 'class') {
+                chunk = {
+                    type,
+                    kind       : 'class',
+                    name       : item.longname,
+                    description: item.comment,
+                    extends    : item.augments?.[0],
+                    source     : sourceFile
+                };
+            } else if (item.kind === 'member' && item.memberof) {
+                chunk = {
+                    type,
+                    kind       : 'config',
+                    className  : item.memberof,
+                    name       : item.name,
+                    description: item.description,
+                    configType : item.type?.names.join('|') || 'unknown',
+                    source     : sourceFile
+                };
+            } else if (item.kind === 'function' && item.memberof) {
+                chunk = {
+                    type,
+                    kind       : 'method',
+                    className  : item.memberof,
+                    name       : item.name,
+                    description: item.description,
+                    params     : item.params?.map(p => ({name: p.name, type: p.type?.names.join('|')})),
+                    returns    : item.returns?.map(r => r.type?.names.join('|')).join('|'),
+                    source     : sourceFile
+                };
+            }
+
+            if (chunk) {
+                chunks.push(chunk);
+            }
+        });
+
+        return chunks;
+    }
+}
+
+export default Neo.setupClass(ApiParser);

package/ai/mcp/server/knowledge-base/parser/DocumentationParser.mjs

@@ -0,0 +1,76 @@
+import Base from '../../../../../src/core/Base.mjs';
+
+const sectionsRegex = /(?=^#+\s)/m;
+
+/**
+ * @summary Extracts knowledge chunks from Markdown documentation files.
+ *
+ * This parser processes Markdown files (Guides, Blogs) found in the `learn/` directory.
+ * Its primary goal is to split long documents into smaller, semantically distinct
+ * chunks based on header sections (e.g., `#`, `##`).
+ *
+ * This granular chunking improves vector search relevance by allowing queries to match
+ * specific sections of a guide rather than the entire document. It assigns the correct
+ * `type` ('guide' or 'blog') based on the file's location in the learning tree.
+ *
+ * @class Neo.ai.mcp.server.knowledge-base.parser.DocumentationParser
+ * @extends Neo.core.Base
+ * @singleton
+ */
+class DocumentationParser extends Base {
+    static config = {
+        /**
+         * @member {String} className='Neo.ai.mcp.server.knowledge-base.parser.DocumentationParser'
+         * @protected
+         */
+        className: 'Neo.ai.mcp.server.knowledge-base.parser.DocumentationParser',
+        /**
+         * @member {Boolean} singleton=true
+         * @protected
+         */
+        singleton: true
+    }
+
+    /**
+     * Parses a Markdown file into granular chunks based on headers.
+     * @param {Object} item The item metadata from tree.json.
+     * @param {String} content The raw file content.
+     * @param {String} filePath The absolute file path.
+     * @returns {Array<Object>} An array of chunks.
+     */
+    parse(item, content, filePath) {
+        const chunks   = [];
+        const sections = content.split(sectionsRegex);
+        const type     = item.parentId === 'Blog' ? 'blog' : 'guide';
+
+        if (sections.length > 1) {
+            sections.forEach(section => {
+                if (section.trim() === '') return;
+                const headingMatch = section.match(/^#+\s(.*)/);
+                const chunk = {
+                    type,
+                    kind   : 'guide',
+                    name   : `${item.name} - ${headingMatch ? headingMatch[1] : item.name}`,
+                    id     : item.id,
+                    content: section,
+                    source : filePath
+                };
+                chunks.push(chunk);
+            });
+        } else {
+            const chunk = {
+                type,
+                kind  : 'guide',
+                name  : item.name,
+                id    : item.id,
+                content,
+                source: filePath
+            };
+            chunks.push(chunk);
+        }
+
+        return chunks;
+    }
+}
+
+export default Neo.setupClass(DocumentationParser);

package/ai/mcp/server/knowledge-base/parser/TestParser.mjs

@@ -0,0 +1,138 @@
+import * as acorn from 'acorn';
+import Base       from '../../../../../src/core/Base.mjs';
+import logger     from '../logger.mjs';
+
+/**
+ * @summary Extracts knowledge chunks from Playwright test files.
+ *
+ * This parser is responsible for decomposing Playwright test files (`.spec.mjs`) into
+ * granular knowledge chunks. It identifies:
+ * 1.  **File Context:** Imports, setup calls, and top-level descriptions.
+ * 2.  **Test Cases:** Individual `test()` blocks, extracting their description and body.
+ *
+ * It uses AST parsing (via `acorn`) to robustly handle test file structure, ensuring
+ * that code comments and nested blocks are correctly processed. The generated chunks
+ * include line number metadata to support precise navigation.
+ *
+ * @class Neo.ai.mcp.server.knowledge-base.parser.TestParser
+ * @extends Neo.core.Base
+ * @singleton
+ */
+class TestParser extends Base {
+    static config = {
+        /**
+         * @member {String} className='Neo.ai.mcp.server.knowledge-base.parser.TestParser'
+         * @protected
+         */
+        className: 'Neo.ai.mcp.server.knowledge-base.parser.TestParser',
+        /**
+         * @member {Boolean} singleton=true
+         * @protected
+         */
+        singleton: true
+    }
+
+    /**
+     * Parses a Playwright test file into granular chunks.
+     * @param {String} content The raw file content.
+     * @param {String} filePath The relative file path.
+     * @returns {Array<Object>} An array of chunks (header + test cases).
+     */
+    parse(content, filePath) {
+        const chunks = [];
+        let ast;
+        try {
+            ast = acorn.parse(content, { sourceType: 'module', locations: true, ecmaVersion: 2022 });
+        } catch (e) {
+            logger.warn(`Failed to parse test file ${filePath}: ${e.message}`);
+            return [];
+        }
+
+        const testNodes = [];
+
+        const visit = (node) => {
+            if (!node) return;
+
+            // Handle ExpressionStatement (wraps calls at top level)
+            if (node.type === 'ExpressionStatement') {
+                visit(node.expression);
+                return;
+            }
+
+            // Handle CallExpression
+            if (node.type === 'CallExpression') {
+                const callee = node.callee;
+                // Check for test() or test.only(), test.skip(), test.fixme()
+                const isTest =
+                    (callee.name === 'test' && (!callee.property || ['only', 'skip', 'fixme'].includes(callee.property?.name))) ||
+                    (callee.object?.name === 'test' && ['only', 'skip', 'fixme'].includes(callee.property?.name));
+
+                if (isTest) {
+                    testNodes.push(node);
+                    return; // Do not recurse into test body
+                }
+
+                // Recurse into arguments to find nested tests (e.g. inside describe blocks)
+                if (node.arguments) {
+                    node.arguments.forEach(arg => {
+                        if (arg.type === 'ArrowFunctionExpression' || arg.type === 'FunctionExpression') {
+                            visit(arg.body);
+                        }
+                    });
+                }
+                return;
+            }
+
+            // Recurse standard block structures
+            if (node.body) {
+                if (Array.isArray(node.body)) node.body.forEach(visit);
+                else visit(node.body);
+            }
+        };
+
+        visit(ast);
+
+        if (testNodes.length === 0) return [];
+
+        // Sort by position to find the "header" cut-off
+        testNodes.sort((a, b) => a.start - b.start);
+
+        // 1. Header Chunk
+        // Content up to the start of the first test.
+        // This includes imports, setup, and the opening lines of any wrapping describe blocks.
+        const headerEnd     = testNodes[0].start;
+        const headerContent = content.substring(0, headerEnd).trim();
+
+        if (headerContent.length > 0) {
+            chunks.push({
+                type   : 'test',
+                kind   : 'test-header',
+                name   : `${filePath} - [Context]`,
+                content: headerContent,
+                source : filePath
+            });
+        }
+
+        // 2. Test Chunks
+        testNodes.forEach(node => {
+            let description = 'Unknown Test';
+            if (node.arguments && node.arguments[0] && node.arguments[0].type === 'Literal') {
+                description = node.arguments[0].value;
+            }
+
+            chunks.push({
+                type      : 'test',
+                kind      : 'test-case',
+                name      : `${filePath} - ${description}`,
+                content   : content.substring(node.start, node.end),
+                source    : filePath,
+                line_start: node.loc.start.line,
+                line_end  : node.loc.end.line
+            });
+        });
+
+        return chunks;
+    }
+}
+
+export default Neo.setupClass(TestParser);