neo.mjs 11.4.0 → 11.6.0

package/.github/.sync-metadata.json

@@ -1,6 +1,6 @@
 {
-  "lastSync": "2025-11-15T13:00:05.810Z",
-  "releasesLastFetched": "2025-11-15T13:00:05.820Z",
+  "lastSync": "2025-11-19T12:40:24.603Z",
+  "releasesLastFetched": "2025-11-19T12:40:24.607Z",
   "pushFailures": [],
   "issues": {
     "3789": {
@@ -2905,22 +2905,22 @@
       "state": "OPEN",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7201.md",
       "closedAt": null,
-      "updatedAt": "2025-08-20T22:03:47Z",
-      "contentHash": "4ed31377c174df448e0d3c759c725c128a643ce365d0505d1d33e7c65df65d68"
+      "updatedAt": "2025-11-19T02:51:55Z",
+      "contentHash": "84055c05b54b8a110659db99e65891a4b297b65deea3a1e3116ed9040e8cbf68"
     },
     "7202": {
       "state": "OPEN",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7202.md",
       "closedAt": null,
-      "updatedAt": "2025-08-20T22:04:45Z",
-      "contentHash": "d96fb624b486c0e8d464d18d24cd32dca160348879f6d39cc04455aaf65af6fe"
+      "updatedAt": "2025-11-19T02:51:53Z",
+      "contentHash": "9b5f31e856dce32044aa9a4677bb5d08278ef0bb9d3761d9de36706c5e134c73"
     },
     "7203": {
       "state": "OPEN",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7203.md",
       "closedAt": null,
-      "updatedAt": "2025-08-20T22:05:23Z",
-      "contentHash": "4c86d6b3e5537a64761e3814561da243ddfc4fb67ef2aefd79d96c7e6056f01b"
+      "updatedAt": "2025-11-19T02:51:52Z",
+      "contentHash": "33ccf238fd6d2b8036942aff6fa53da3f5cec7972746fefe14c869f033863565"
     },
     "7204": {
       "state": "CLOSED",
@@ -2933,15 +2933,15 @@
       "state": "OPEN",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7205.md",
       "closedAt": null,
-      "updatedAt": "2025-08-20T22:06:37Z",
-      "contentHash": "fa4824f43e6ddf946ca9f7158395bb57d43c2b98952b8d5c046b613945ecc201"
+      "updatedAt": "2025-11-19T02:51:51Z",
+      "contentHash": "db6e3283cd8bf5b81c06c3840b3de1e873695cb0601d8f8b290b3d708472a4c1"
     },
     "7206": {
       "state": "OPEN",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7206.md",
       "closedAt": null,
-      "updatedAt": "2025-08-20T22:34:24Z",
-      "contentHash": "a0a6a099dcc8e36c735c3d33e4206a51ca2fe6b7ecb58ab1db8ebe9532c579aa"
+      "updatedAt": "2025-11-19T02:51:49Z",
+      "contentHash": "aec7dffe23f3362bb0e0d473cbf0e45053e19b94c7a90288b8d8a5e5a05627f4"
     },
     "7207": {
       "state": "OPEN",
@@ -3239,7 +3239,7 @@
     },
     "7249": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7249.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.4.0/issue-7249.md",
       "closedAt": "2025-11-15T09:45:18Z",
       "updatedAt": "2025-11-15T09:45:18Z",
       "contentHash": "4036e122ae18e253a64675831ea5c0ec2c585f7ac826a4e6373781763bebcfd3"
@@ -4541,7 +4541,7 @@
     },
     "7489": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7489.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.4.0/issue-7489.md",
       "closedAt": "2025-11-15T09:44:33Z",
       "updatedAt": "2025-11-15T09:44:33Z",
       "contentHash": "423007a56532f4d57142bb685125f9f5e7bf1a3749370d1c7267cc945e48d37c"
@@ -6361,24 +6361,213 @@
     },
     "7775": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7775.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.4.0/issue-7775.md",
       "closedAt": "2025-11-15T09:41:42Z",
       "updatedAt": "2025-11-15T09:41:42Z",
       "contentHash": "4657193d7084aa82709796c45c1b3a0f5d06d14ef9fa6f1d7d4941a8d744325f"
     },
     "7776": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7776.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.4.0/issue-7776.md",
       "closedAt": "2025-11-15T12:30:46Z",
       "updatedAt": "2025-11-15T12:30:46Z",
       "contentHash": "09aa6166ff62f457cdad47c69025b57d0843e0f6f17840ddc1138293cdeb1ad3"
     },
     "7777": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7777.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.4.0/issue-7777.md",
       "closedAt": "2025-11-15T12:51:55Z",
       "updatedAt": "2025-11-15T12:51:55Z",
       "contentHash": "0946c291adc1caa5adf38c109ab8f0be915fc7d6a438fac4c39df4009122d73a"
+    },
+    "7778": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7778.md",
+      "closedAt": "2025-11-15T13:58:30Z",
+      "updatedAt": "2025-11-15T13:58:30Z",
+      "contentHash": "d1b22b9ce581d36f1e55d5829cadb6c1a02be1c7f4b1b94042f8169eeede2ffd"
+    },
+    "7780": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7780.md",
+      "closedAt": "2025-11-15T21:34:26Z",
+      "updatedAt": "2025-11-18T08:55:06Z",
+      "contentHash": "412e8c50b57f5f1fa5baf5375c7262bdd6bc2c814f6636258c5fb3d561959b0c"
+    },
+    "7781": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7781.md",
+      "closedAt": "2025-11-16T23:11:26Z",
+      "updatedAt": "2025-11-16T23:11:26Z",
+      "contentHash": "d386628f811df073e8633b11cf230bbbc6b05ec0ddee3f38f525f4549c3f5e8f"
+    },
+    "7782": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7782.md",
+      "closedAt": "2025-11-16T23:53:42Z",
+      "updatedAt": "2025-11-16T23:53:42Z",
+      "contentHash": "e89fc8842e0c7ff8b6c283cd241cd1da5910e3c182731806bcb19f9af8a7d089"
+    },
+    "7783": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7783.md",
+      "closedAt": "2025-11-17T18:57:49Z",
+      "updatedAt": "2025-11-17T18:57:49Z",
+      "contentHash": "f0d42030d5dc70178fc216a6c1d101a7f81a04e4451fe7c6beaa4182e3b9ba7a"
+    },
+    "7784": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7784.md",
+      "closedAt": "2025-11-17T20:21:21Z",
+      "updatedAt": "2025-11-17T20:21:21Z",
+      "contentHash": "ae86add823a749168646731a25f5c8fc984b731ddffa8096051c8252cd086801"
+    },
+    "7785": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7785.md",
+      "closedAt": "2025-11-17T20:26:06Z",
+      "updatedAt": "2025-11-17T20:26:06Z",
+      "contentHash": "5c828123f597d55567657e9cc2a5b5157b739d99d6119a05eccba1831b064f05"
+    },
+    "7786": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7786.md",
+      "closedAt": "2025-11-17T22:49:08Z",
+      "updatedAt": "2025-11-17T22:49:08Z",
+      "contentHash": "bcf1099b42f52268b76f5141c7fd8b6e934877666f5b597af5e6f00e51850ef2"
+    },
+    "7787": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7787.md",
+      "closedAt": "2025-11-17T23:34:42Z",
+      "updatedAt": "2025-11-17T23:34:42Z",
+      "contentHash": "37615a9e8021d0ad8129b7c1e559c8da590b9413315ebae2cb4538ee78875f50"
+    },
+    "7788": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7788.md",
+      "closedAt": "2025-11-18T20:07:27Z",
+      "updatedAt": "2025-11-18T20:07:27Z",
+      "contentHash": "a45ca7464c136a21c52cdf762822be8aaafd8e55e2815c8cfa3a77afccbfb813"
+    },
+    "7789": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7789.md",
+      "closedAt": "2025-11-18T14:15:59Z",
+      "updatedAt": "2025-11-18T14:15:59Z",
+      "contentHash": "ff283feabb89101e40a8e5f34038a9a4d8a58dd17151434d6a105b5bd4c9d4a2"
+    },
+    "7790": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7790.md",
+      "closedAt": "2025-11-18T12:12:48Z",
+      "updatedAt": "2025-11-18T12:12:48Z",
+      "contentHash": "67c62e4bc1eb83ef7743e14c18c6f203159ff73d3cde6f7d207412d9ee3d2735"
+    },
+    "7791": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7791.md",
+      "closedAt": "2025-11-18T19:27:35Z",
+      "updatedAt": "2025-11-18T19:27:35Z",
+      "contentHash": "e6904afb6e01c0a80f50e67e7716cd819f6f5dfb8d64eaa94c544148d9f5b50f"
+    },
+    "7793": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7793.md",
+      "closedAt": "2025-11-19T12:40:12Z",
+      "updatedAt": "2025-11-19T12:40:12Z",
+      "contentHash": "b79258b967d08e9ee3e10f30e79464c6d4ffcc5d308a601af2a321f28cf5389e"
+    },
+    "7794": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7794.md",
+      "closedAt": "2025-11-18T17:26:27Z",
+      "updatedAt": "2025-11-18T17:26:27Z",
+      "contentHash": "480c851b6513603987373430f75b3261f698fc399f6159f07f3b6e9d612cc11b"
+    },
+    "7795": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7795.md",
+      "closedAt": "2025-11-18T19:47:12Z",
+      "updatedAt": "2025-11-18T19:47:13Z",
+      "contentHash": "c2145fbd2c0b87f55dfbb035ff4f3cff0dbc1f719838c93098294e9996b4cb77"
+    },
+    "7796": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.5.0/issue-7796.md",
+      "closedAt": "2025-11-18T20:00:39Z",
+      "updatedAt": "2025-11-18T20:00:39Z",
+      "contentHash": "c0c068430f627292b356545c7f791f0b9256d8fec92a5e75a932d72984465813"
+    },
+    "7797": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7797.md",
+      "closedAt": "2025-11-19T09:54:38Z",
+      "updatedAt": "2025-11-19T09:54:38Z",
+      "contentHash": "7a6730c1ac4f027b62a63bedc58055ffeb0d00fbf0310fa16f1828db7b8ea085"
+    },
+    "7798": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7798.md",
+      "closedAt": "2025-11-19T01:56:15Z",
+      "updatedAt": "2025-11-19T01:56:15Z",
+      "contentHash": "b16c800b714244c0f5d33098e6bb13a2ef034ff7245675692d3deca454ab6973"
+    },
+    "7799": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7799.md",
+      "closedAt": "2025-11-19T01:58:16Z",
+      "updatedAt": "2025-11-19T01:58:16Z",
+      "contentHash": "1c206d2e26365960b9a9ca6e8cb188b23b1cd8027b2339ef3211faa82828b3df"
+    },
+    "7800": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7800.md",
+      "closedAt": "2025-11-19T02:04:02Z",
+      "updatedAt": "2025-11-19T02:04:02Z",
+      "contentHash": "e166fe317017b61f08d1ffb0e0f554c35dbf615ea28877a6ba4522ea2d374148"
+    },
+    "7801": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7801.md",
+      "closedAt": "2025-11-19T10:09:35Z",
+      "updatedAt": "2025-11-19T10:09:35Z",
+      "contentHash": "84eec3a5182f07ef575857227e50b0d799a28a354e9ff34798f64263a30532b8"
+    },
+    "7802": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7802.md",
+      "closedAt": "2025-11-19T10:59:33Z",
+      "updatedAt": "2025-11-19T10:59:33Z",
+      "contentHash": "356e92ddd1e6b1a8041263e7d001daed837eaa4d4b1883e4b8769e128f8bc176"
+    },
+    "7803": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7803.md",
+      "closedAt": "2025-11-19T11:08:40Z",
+      "updatedAt": "2025-11-19T11:08:40Z",
+      "contentHash": "5e272ed54318561523081c173d02c04775496f48d0587d1f760780efcc92ee46"
+    },
+    "7804": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7804.md",
+      "closedAt": "2025-11-19T11:18:52Z",
+      "updatedAt": "2025-11-19T11:18:52Z",
+      "contentHash": "9792b3df9bcaddd79ce2d286fccd4afc76f49c38af1716e92ba195c184d2f077"
+    },
+    "7805": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7805.md",
+      "closedAt": "2025-11-19T11:25:48Z",
+      "updatedAt": "2025-11-19T11:25:48Z",
+      "contentHash": "f57c7cba1ca5a122a8e0b885f2637fc596e393f9b0c8d2a2260ce25fa0b3cc26"
+    },
+    "7806": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7806.md",
+      "closedAt": "2025-11-19T12:33:43Z",
+      "updatedAt": "2025-11-19T12:33:43Z",
+      "contentHash": "816d05ae4087deba931e4a82d42619748cfc04cd9dd199e069ac9df3e901209b"
     }
   },
   "releases": {
@@ -6541,6 +6730,14 @@
     "11.3.0": {
       "publishedAt": "2025-11-14T15:35:01Z",
       "contentHash": "1ef00564052ebc80568c4677df4414fa38e922d02e251f43da9fd876562b11fb"
+    },
+    "11.4.0": {
+      "publishedAt": "2025-11-15T13:10:59Z",
+      "contentHash": "abcecbb0e46696a81dab5817adcabbf9a731dc7b0c839a6bdd5992908b88c2b1"
+    },
+    "11.5.0": {
+      "publishedAt": "2025-11-18T20:28:02Z",
+      "contentHash": "899bdb696e5a4f1e825e337e189e768fd6c4e5f68453e376b1e3d554644dea8b"
     }
   }
 }

package/README.md

@@ -11,17 +11,16 @@
   <a href="./CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-green.svg?logo=GitHub&logoColor=white" alt="PRs Welcome"></a>
 </p>
 
-# Build Ultra-Fast, Desktop-Like Web Apps
-🚀 **Break Free from UI Freezes — Experience True Multithreading & Uncompromised Responsiveness.**
+# The AI-Native Platform for Ultra-Fast Web Apps
+🚀 **True Multithreading Meets Context Engineering — Build Desktop-Class UIs with an AI Co-Developer.**
 
-💻 ***Neo.mjs isn't just an upgrade — it's a new operating system for the web. Where others optimize at the margins, we reinvented the engine.***
+💻 ***Neo.mjs is more than a framework; it's a new operating system for the web, architected for unparalleled performance and pioneering human-AI collaboration.***
 
-Imagine web applications that never jank, no matter how complex the logic, how many real-time updates they handle, or how
-many browser windows they span. Neo.mjs is engineered from the ground up to deliver **desktop-like fluidity and scalability**.
-**While it excels for Single Page Apps (SPAs), Neo.mjs is simply the best option for browser-based multi-window applications**,
-operating fundamentally different from traditional frameworks.
+Imagine web applications that never jank, no matter how complex the logic, how many real-time updates they handle, or how many browser windows they span. Neo.mjs is engineered from the ground up to deliver **desktop-like fluidity and scalability**. **While it excels for Single Page Apps (SPAs), Neo.mjs is simply the best option for browser-based multi-window applications**, operating fundamentally different from traditional frameworks.
 
-By leveraging a **pioneering Off-Main-Thread (OMT) architecture**, Neo.mjs ensures your UI remains butter-smooth, even during computationally intensive tasks like complex data processing or advanced graphics rendering. The main thread is kept free for one purpose: **flawless user interactions and seamless DOM updates.**
+By leveraging a **pioneering Off-Main-Thread (OMT) architecture**, Neo.mjs ensures your UI remains butter-smooth. The main thread is kept free for one purpose: **flawless user interactions and seamless DOM updates.**
+
+But performance is only half the story. With v11, Neo.mjs becomes the world's first **AI-native** frontend platform, designed to be developed *with* AI agents as first-class partners in your workflow.
 
 <p align="center">
   <a href="https://youtu.be/pYfM28Pz6_0"><img height="316px" width="400px" src="https://raw.githubusercontent.com/neomjs/pages/master/resources_pub/images/neo33s.png" alt="Neo.mjs Performance Demo 1 (YouTube Video)"></a>
@@ -37,45 +36,51 @@ Have a question or want to connect with the community? We have two channels to h
 *   **[⚡️ Slack (For Real-Time Chat)](https://join.slack.com/t/neomjs/shared_invite/zt-6c50ueeu-3E1~M4T9xkNnb~M_prEEOA):** Perfect for quick, real-time conversations. Please note that the free version's history is temporary (messages are deleted after 90 days).
 
 </br></br>
-## 🚀 Why Choose Neo.mjs? Solving the Toughest UI Challenges
-Traditional single-threaded frontend frameworks often struggle with performance bottlenecks and UI freezes, especially for
-large-scale, data-intensive, or real-time applications. Neo.mjs offers a fundamentally different solution, designed for
-**uncompromising performance, enhanced security, and superior developer experience.**
-
-1. **Eliminate UI Freezes with True Multithreading**:
-   > *"The browser's main thread should be treated like a neurosurgeon: only perform precise, scheduled operations with zero distractions."*</br></br>
-   — Neo.mjs Core Philosophy
-    
-   Neo.mjs's OMT architecture inherently prevents UI freezes. With v10's optimized rendering pipeline, your UI will remain even *more*
-   consistently responsive, even during intense data processing or complex graphics rendering. It achieves an astonishing
-   rate of **over 40,000 delta updates per second** in optimized environments. This translates to an engine with vast untapped
-   potential, limited only by user interaction, not the framework.
- 
-2. **Unmatched Developer Experience: Transpilation-Free ESM**:
-   Say goodbye to complex build steps for development. Neo.mjs apps run **natively as ES Modules directly in the browser**.
-   This means **zero builds or transpilations** in dev mode, offering instant reloads and an **unmatched debugging experience**.
-   You modify code, and your app updates in real-time.
- 
-3. **Inherent Security by Design**:
-   By prioritizing direct DOM API manipulation over string-based methods (like `innerHTML`), Neo.mjs fundamentally reduces
-   the attack surface for vulnerabilities like Cross-Site Scripting (XSS), building a more robust and secure application from the ground up.
- 
-4. **Declarative, Consistent, & Reusable Architecture**:
-   Neo.mjs's unique **unified class config system** allows you to define components, layouts, and logic in a clean, declarative,
-   and highly consistent way. This significantly reduces boilerplate, improves maintainability, and makes complex UI composition surprisingly straightforward.
-
-5. **Scalability for Enterprise & Beyond**:
-   Whether building sophisticated enterprise dashboards, data-intensive Gen AI interfaces, or desktop-like multi-window applications,
-   Neo.mjs's modular, worker-driven architecture effortlessly scales. Components are persistent, stateful instances that can be unmounted,
-   moved, and even remounted across browser windows without losing their logic or state. This is key to preventing the "re-rendering madness"
-   common in other frameworks.
+## 🚀 The AI-Native Development Platform
+
+Neo.mjs v11 introduces a revolutionary approach to software development: **Context Engineering**. We've moved beyond simple "AI-assisted" coding to create a truly **AI-native** platform where AI agents are deeply integrated partners in the development process. This is made possible by three dedicated **Model Context Protocol (MCP) servers** that give agents the context they need to understand, build, and reason about your code.
+
+This isn't just about generating code; it's about creating a self-aware development environment that accelerates velocity, improves quality, and enables a new level of human-AI collaboration.
+
+<p align="center">
+  <img width="800px" src="https://raw.githubusercontent.com/neomjs/pages/master/resources_pub/website/blog/ContextEngineering.png" alt="Context Engineering Done Right" class="blog-image">
+</p>
+
+1.  **🧠 The Knowledge Base Server**: Gives agents a deep, semantic understanding of your project. Powered by ChromaDB and Gemini embeddings, it allows agents to perform semantic searches across your entire codebase, documentation, and historical tickets. An agent can ask, "How does VDOM diffing work?" and get the exact source files and architectural guides relevant to the *currently checked-out version*.
+
+2.  **💾 The Memory Core Server**: Provides agents with persistent, long-term memory. Every interaction—prompt, thought process, and response—is stored, allowing the agent to learn from experience, recall past decisions, and maintain context across multiple sessions. This transforms the agent from a stateless tool into a true collaborator that grows with your project.
+
+3.  **🤖 The GitHub Workflow Server**: Closes the loop by enabling agents to participate directly in your project's lifecycle. It provides tools for autonomous PR reviews, issue management, and bi-directional synchronization of GitHub issues into a local, queryable set of markdown files. This removes the human bottleneck in code review and project management.
+
+This powerful tooling, co-created with AI agents, resulted in **resolving 388 tickets in just 6 weeks**. To learn more about this paradigm shift, read our blog post: **[388 Tickets in 6 Weeks: Context Engineering Done Right](./learn/blog/context-engineering-done-right.md)**.
 
 </br></br>
-## 🚀 A New Era of Frontend Architecture
+## 💡 Why Choose Neo.mjs?
+
+Traditional single-threaded frameworks struggle with performance bottlenecks, especially in large-scale, data-intensive applications. Neo.mjs offers a fundamentally different solution, designed for **uncompromising performance, AI-native productivity, and superior developer experience.**
+
+1.  **Eliminate UI Freezes with True Multithreading**:
+    > *"The browser's main thread should be treated like a neurosurgeon: only perform precise, scheduled operations with zero distractions."*</br></br>
+    — Neo.mjs Core Philosophy
+
+    Neo.mjs's OMT architecture inherently prevents UI freezes. With our optimized rendering pipeline, your UI will remain consistently responsive, even during intense data processing. It achieves an astonishing rate of **over 40,000 delta updates per second** in optimized environments, potential, limited only by user interaction, not the platform.
 
-The v10 release marks a significant evolution of the Neo.mjs core, introducing a new functional component model and a revolutionary two-tier reactivity system. We've rebuilt the engine to provide an even more powerful and intuitive developer experience, making it simpler than ever to build complex, performant applications.
+2.  **Unprecedented Velocity with an AI-Native Workflow**:
+    The integrated MCP servers provide a "context-rich" environment where AI agents can work alongside human developers. This enables autonomous code reviews, deep codebase analysis, and a shared understanding of project history, dramatically accelerating development and solving the "bus factor" problem for complex projects.
 
-To understand the depth of these changes and the philosophy behind them, we've published a five-part blog series that dives deep into the architecture of v10:
+3.  **Build Desktop-Class, Multi-Window Applications**:
+    Neo.mjs is the premier solution for building complex, multi-window web applications like **trading platforms, browser-based IDEs, Outlook-style email clients, and multi-screen LLM interfaces**. Its shared worker architecture allows a single application instance to run across multiple browser windows, with real-time state synchronization and the ability to move components between windows seamlessly.
+
+4.  **Unmatched Developer Experience: Transpilation-Free ESM**:
+    Say goodbye to complex build steps. Neo.mjs apps run **natively as ES Modules directly in the browser**. This means **zero builds or transpilation** in dev mode, offering instant reloads and an unparalleled debugging experience where what you write is what you debug.
+
+5.  **Inherent Security by Design**:
+    By prioritizing direct DOM API manipulation over string-based methods (like `innerHTML`), Neo.mjs fundamentally reduces the attack surface for vulnerabilities like Cross-Site Scripting (XSS), building a more robust and secure application from the ground up.
+
+</br></br>
+## 📚 Foundational Architecture: The Core Principles
+
+The v10 release marked a significant evolution of the Neo.mjs core, introducing a new functional component model and a revolutionary two-tier reactivity system. These principles form the bedrock of the framework today. We've published a five-part blog series that dives deep into this architecture:
 
 1.  **[A Frontend Love Story: Why the Strategies of Today Won't Build the Apps of Tomorrow](./learn/blog/v10-post1-love-story.md)**
     *   *An introduction to the core problems in modern frontend development and the architectural vision of Neo.mjs.*
@@ -97,6 +102,22 @@ like a full calendar, carousels, and chart wrappers. All components are pre-buil
 multi-threaded architecture, significantly accelerating development and eliminating the complexity of integrating disparate
 external component libraries.
 </br></br>
+## A Platform at Scale: More Than Just a Library
+
+To appreciate the scope of Neo.mjs, it's important to understand its scale. This is not a micro-library; it's a comprehensive, enterprise-ready platform representing over a decade of architectural investment. **Neo.mjs is an innovation factory.**
+
+The stats below, from **October 2025**, provide a snapshot of the ecosystem. For a deeper dive, you can explore the full **[Codebase Overview](./learn/guides/fundamentals/CodebaseOverview.md)**.
+
+-   **~41,000 lines** of core platform source code
+-   **~33,000 lines** across hundreds of working examples and flagship applications
+-   **~11,000 lines** of production-grade theming
+-   **~6,000 lines** of dedicated AI-native infrastructure
+-   **~30,000 lines** of detailed JSDoc documentation
+
+**Total: Over 130,000 lines of curated code and documentation.**
+
+This is not a small library—it's a complete ecosystem with more source code than many established frameworks, designed for the most demanding use cases.
+</br></br>
 ## 📊  Real-World Win: Crushing UI Lag in Action
 
 Imagine a developer building a stock trading app with live feeds updating every millisecond. Traditional frameworks often choke,
@@ -110,7 +131,7 @@ That’s Neo.mjs in action — solving problems others can’t touch.
 * **Persistent Component Instances**: Components maintain their state and logic even when their DOM is removed or moved.
   No more wasteful re-creations – just surgical, efficient updates.
 
-* **Functional Components & A Modern Hook System**: Embrace a modern, hook-based development style with `defineComponent`, `useConfig`, and `useEvent`. This new paradigm, built on top of our robust class system, offers a familiar and intuitive way to build components while benefiting from the unparalleled performance of our multi-threaded architecture. Best of all, it's free from the "memoization tax" (`useMemo`, `useCallback`) that plagues other frameworks.
+* **Functional & Class-Based Components**: Neo.mjs offers two powerful component models. **Functional Components**, introduced more recently, provide an easier onboarding experience and a modern, hook-based development style (`defineComponent`, `useConfig`, `useEvent`), similar to other popular frameworks. They are ideal for simpler, more declarative UIs. For advanced use cases requiring granular control over VDOM changes and deeper integration with the framework's lifecycle, **Class-Based Components** offer superior power and flexibility, albeit with slightly more code overhead. Both models seamlessly interoperate, allowing you to choose the right tool for each part of your application while benefiting from the unparalleled performance of our multi-threaded architecture. Best of all, our functional components are free from the "memoization tax" (`useMemo`, `useCallback`) that plagues other frameworks.
 
 * **Reactive State Management**: Leveraging `Neo.state.Provider`, Neo.mjs offers natively integrated, hierarchical state management.
   Components declare their data needs via a concise `bind` config. These `bind` functions act as powerful inline formulas, allowing
@@ -130,17 +151,11 @@ That’s Neo.mjs in action — solving problems others can’t touch.
   from UI components for easier maintenance, testing, and team collaboration.
 
 * **Multi-Window & Single-Page Applications (SPAs)***: Beyond traditional SPAs, Neo.mjs excels at complex multi-window applications.
-  Its unique architecture, powered by seamless cross-worker communication (enabled by `Neo.worker.mixin.RemoteMethodAccess`) and
-  extensible Main Thread addons (`Neo.main.addon.*`), enables truly native-like, persistent experiences across browser windows,
-  all without a native shell. This is made possible by the same efficient delta-based DOM update engine, which can surgically
-  move and update components across window boundaries with unparalleled performance.
+  Its unique architecture, powered by seamless cross-worker communication and extensible Main Thread addons, enables truly native-like, persistent experiences across browser windows.
 
 * **No npm Dependency Hell**: Neo.mjs apps run with **zero runtime dependencies**, just a few dev dependencies for tooling.
   This means smaller bundles, fewer conflicts, and a simpler dependency graph.
 
-* **Cutting-Edge Use Cases**: Ideal for **data-intensive applications, real-time dashboards, web-based IDEs, banking
-  applications, and complex multi-window Gen AI interfaces** where performance and responsiveness are non-negotiable.
-
 * **Unparalleled Debugging Experience**: Benefit from Neo.mjs's built-in debugging capabilities. Easily inspect the full component
   tree across workers, live-modify component configurations directly in the browser console, and observe real-time UI updates,
   all without complex tooling setup.
@@ -149,8 +164,6 @@ That’s Neo.mjs in action — solving problems others can’t touch.
 
 * **Async-Aware Component Lifecycle**: With the `initAsync()` lifecycle method, components can handle asynchronous setup (like fetching data or lazy-loading modules) *before* they are considered "ready." This eliminates entire classes of race conditions and UI flicker, allowing you to build complex, data-dependent components with confidence.
 
-* **AI-Native through Context Engineering**: We are pioneering **Context Engineering** to build the first framework architected to be developed *with* AI agents. Instead of just prompting, we are building a dynamic system to provide our AI partner with the right knowledge and tools at the right time. This includes a rich, queryable knowledge base and clear guidelines for both the [AI](./.github/AGENTS.md) and the [human developer](./.github/WORKING_WITH_AGENTS.md). This architectural discipline not only enables AI partnership but also results in a cleaner, more predictable, and more maintainable codebase. Get started with the **[AI Knowledge Base Quick Start Guide](./.github/AI_QUICK_START.md)**.
-
 <p align="center">
   <img src="./resources/images/workers-focus.svg" alt="Neo.mjs Worker Architecture Diagram - Shows Main Thread, App Worker, VDom Worker, Canvas Worker, Data Worker, Service Worker, Backend connections.">
 </p>
@@ -168,9 +181,10 @@ The true power of Neo.mjs lies in its foundational architectural choices, which
 | **Component Lifecycle** | **Stable & Persistent**: Instances are created once and persist through UI changes. Features a rich lifecycle with `construct`, `initAsync`, and `afterSetMounted`. | **React**: Ephemeral (functional components are re-executed on every render). **Vue/Angular**: More stable, but lack pre-ready async hooks for complex setup. | **Robust & Predictable**. `initAsync` solves async setup (data fetching, module loading) *before* the first render, preventing UI flicker. Persistence enables complex stateful apps and multi-window operations. |
 | **State Management** | **Surgical Subscriptions**: The integrated `StateProvider` allows components to subscribe *only* to the precise state slices they need, completely bypassing intermediate components. | **React**: Context API re-renders all consumers by default, requiring manual optimization. **Vue/Angular**: Optimized state managers (Pinia, NgRx) are still bound by the main thread. | **Scalable & Decoupled**. More performant for global state changes by default. Architecturally cleaner, avoiding props drilling and the performance traps of React's Context. |
 | **DOM Updates** | **Asymmetric & Off-Thread**: Simple, serializable JSON objects (blueprints) are sent to the VDOM worker for diffing. The Main Thread only receives and applies minimal, pre-calculated patches. | VDOM diffing and DOM manipulation are computationally expensive tasks that occur on the main thread, directly competing with user interactions. | **Faster, More Secure, and AI-Friendly**. Off-thread diffing is faster. Using direct DOM APIs instead of `innerHTML` is more secure. Simple JSON blueprints are trivial for AI to generate and manipulate. |
+| **AI & Dev Tooling** | **Integrated AI-Native Platform**: Three dedicated MCP servers provide context engineering, semantic search, agent memory, and autonomous workflow automation. | **Disconnected Tooling**: Relies on external, disconnected tools (linters, IDE extensions, CI scripts). No built-in context awareness for AI agents. | **Unprecedented Developer Velocity**. Enables true human-AI collaboration, autonomous code review, and a self-aware development environment that solves the "bus factor" problem. |
 | **Dev Experience** | **Zero-Builds Development**: Native ES Modules run directly in the browser. No transpilation or bundling is needed for development. | **Build-Heavy**: Relies on tools like Vite, Webpack, or the Angular CLI, which add complexity, require source maps, and introduce delays. | **Unparalleled Simplicity & Debugging Clarity**. What you write is what you debug. Instant feedback and the absence of complex build toolchains lead to a faster, more intuitive workflow. |
 
-**The Bottom Line**: Where other frameworks optimize operations on the main thread, Neo.mjs moves them off the main thread entirely. This fundamental difference results in a framework that is not just faster, but architecturally more scalable, robust, and resilient to complexity.
+**The Bottom Line**: Where other frameworks optimize operations on the main thread, Neo.mjs moves them off the main thread entirely. This fundamental difference results in a platform that is not just faster, but architecturally more scalable, robust, and resilient to complexity.
 
 </br></br>
 ## ⚙️ Declarative Class Configuration: Build Faster, Maintain Easier
@@ -246,6 +260,7 @@ Next steps:
 * Many more are included inside the repos [apps](https://github.com/neomjs/neo/tree/dev/apps)
   & [examples](https://github.com/neomjs/neo/tree/dev/examples) folders.
 * :blue_book: All Blog Posts are listed here: [Neo.mjs Blog](https://neomjs.com/dist/production/apps/portal/#/blog)
+* :robot: Get started with the **[AI Knowledge Base Quick Start Guide](./.github/AI_QUICK_START.md)**.
 
 </br></br>
 ## 🧭 Vision & Roadmap

package/ServiceWorker.mjs

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

package/ai/mcp/server/github-workflow/config.mjs

@@ -1,6 +1,12 @@
+import fs   from 'fs/promises';
 import path from 'path';
+import Base from '../../../../src/core/Base.mjs';
 
-const config = {
+/**
+ * Default configuration object.
+ * Defines the structure and default values for the server configuration.
+ */
+const defaultConfig = {
     /**
      * Global debug flag for all MCP servers.
      * @type {boolean}
@@ -171,4 +177,85 @@ const config = {
     }
 };
 
-export default config;
+/**
+ * Configuration manager for the GitHub Workflow MCP server.
+ * Supports loading configuration from a custom file and merging with defaults.
+ * @class Neo.ai.mcp.server.github-workflow.Config
+ * @extends Neo.core.Base
+ * @singleton
+ */
+class Config extends Base {
+    static config = {
+        /**
+         * @member {String} className='Neo.ai.mcp.server.github-workflow.Config'
+         * @protected
+         */
+        className: 'Neo.ai.mcp.server.github-workflow.Config',
+        /**
+         * @member {Boolean} singleton=true
+         * @protected
+         */
+        singleton: true
+    }
+
+    /**
+     * The current configuration object.
+     * Starts with defaults and can be updated via load().
+     * @member {Object} data
+     */
+    data = null;
+
+    /**
+     * Initializes the configuration object by deep cloning the defaults.
+     * @param {Object} config
+     */
+    construct(config) {
+        super.construct(config);
+        this.data = Neo.clone(defaultConfig, true);
+    }
+
+    /**
+     * Loads configuration from a JSON file and merges it with defaults.
+     * @param {string} filePath - The path to the configuration file.
+     * @returns {Promise<void>}
+     */
+    async load(filePath) {
+        if (!filePath) return;
+
+        try {
+            const absolutePath = path.resolve(filePath);
+            const ext          = path.extname(absolutePath);
+            let   customConfig;
+
+            if (ext === '.mjs' || ext === '.js') {
+                const module = await import(absolutePath);
+                customConfig = module.default;
+            } else {
+                const content = await fs.readFile(absolutePath, 'utf-8');
+                customConfig  = JSON.parse(content);
+            }
+
+            // Deep merge custom config into the data object
+            Neo.merge(this.data, customConfig);
+
+            console.log(`[Config] Loaded custom configuration from ${absolutePath}`);
+
+        } catch (error) {
+            console.error(`[Config] Failed to load configuration from ${filePath}:`, error.message);
+            throw error;
+        }
+    }
+}
+
+const instance = Neo.setupClass(Config);
+
+export default new Proxy(instance, {
+    get(target, prop, receiver) {
+        // 1. Prefer properties/methods on the instance itself (e.g. load, className)
+        if (Reflect.has(target, prop)) {
+            return Reflect.get(target, prop, receiver);
+        }
+        // 2. Fallback to the data object (e.g. owner, repo)
+        return target.data[prop];
+    }
+});

package/ai/mcp/server/github-workflow/logger.mjs

@@ -6,12 +6,9 @@ import aiConfig from './config.mjs';
  */
 const logger = {};
 
-// Check for --debug flag in command line arguments
-const isDebugFlagSet = process.argv.includes('--debug');
-
 const createLogMethod = (level) => {
     return (...args) => {
-        if (aiConfig.debug || isDebugFlagSet) {
+        if (aiConfig.debug) {
             console.error(`[${level.toUpperCase()}]`, ...args);
         }
     };