neo.mjs 11.6.1 → 11.8.0

package/.github/.sync-metadata.json

@@ -1,6 +1,6 @@
 {
-  "lastSync": "2025-11-19T17:12:23.427Z",
-  "releasesLastFetched": "2025-11-19T17:12:23.443Z",
+  "lastSync": "2025-11-21T14:56:58.356Z",
+  "releasesLastFetched": "2025-11-21T14:56:58.358Z",
   "pushFailures": [],
   "issues": {
     "3789": {
@@ -2947,8 +2947,8 @@
       "state": "OPEN",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7207.md",
       "closedAt": null,
-      "updatedAt": "2025-08-21T09:12:52Z",
-      "contentHash": "a8bcb47284f4bac7de24af5822c15293d786ee3d15aeb3cdbc7a860e258793cb"
+      "updatedAt": "2025-11-20T02:50:06Z",
+      "contentHash": "44197d9de81c04ca7273b1f7b8fd9d2c6307c01b84921332995b88f597d63497"
     },
     "7208": {
       "state": "CLOSED",
@@ -4443,7 +4443,7 @@
     },
     "7475": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7475.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.6.1/issue-7475.md",
       "closedAt": "2025-11-19T14:00:20Z",
       "updatedAt": "2025-11-19T14:00:20Z",
       "contentHash": "63f2b1ecad67dc177957fcdf1d49ba1bb333782182f5112e3d362212ca90717b"
@@ -6578,59 +6578,241 @@
     },
     "7808": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7808.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.6.1/issue-7808.md",
       "closedAt": "2025-11-19T13:42:11Z",
       "updatedAt": "2025-11-19T13:42:11Z",
       "contentHash": "80322765d7653cffa6f4618584533f6d57a2d26f7abea691ec49f48bf7098ffb"
     },
     "7809": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7809.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.6.1/issue-7809.md",
       "closedAt": "2025-11-19T13:50:23Z",
       "updatedAt": "2025-11-19T13:50:23Z",
       "contentHash": "a3db5211c3b45f58631057867a40752869ccb0ca34f482f0f90ad4253abb5a68"
     },
     "7810": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7810.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.6.1/issue-7810.md",
       "closedAt": "2025-11-19T13:59:16Z",
       "updatedAt": "2025-11-19T13:59:16Z",
       "contentHash": "38a2bccae1d13d569814d9310459d9e86c95cc24239edb25c95c4ec471a1aca9"
     },
     "7811": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7811.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.6.1/issue-7811.md",
       "closedAt": "2025-11-19T14:41:08Z",
       "updatedAt": "2025-11-19T14:41:08Z",
       "contentHash": "bb15dfc6cd8d044c656e28c7219594827627e5cbd47b6e67b6c2dcec6bc9aee1"
     },
     "7812": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7812.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.6.1/issue-7812.md",
       "closedAt": "2025-11-19T16:08:06Z",
       "updatedAt": "2025-11-19T16:08:06Z",
       "contentHash": "8f749255ff253ecbb0eef908fd2e5041796572fe1e62ccbdf153bd019efc691d"
     },
     "7813": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7813.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.6.1/issue-7813.md",
       "closedAt": "2025-11-19T16:35:06Z",
       "updatedAt": "2025-11-19T16:35:06Z",
       "contentHash": "b84dae30b5f29ddc37260888b83f28c469a7a436ed0d1d5326ec962ec300872a"
     },
     "7814": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7814.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.6.1/issue-7814.md",
       "closedAt": "2025-11-19T16:36:38Z",
       "updatedAt": "2025-11-19T16:36:38Z",
       "contentHash": "1acc0ebcfc01b35b16125a0d92168a745adebce428f298f889ec21db0dc48d9b"
     },
     "7815": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7815.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.6.1/issue-7815.md",
       "closedAt": "2025-11-19T17:11:44Z",
       "updatedAt": "2025-11-19T17:11:44Z",
       "contentHash": "3e8c5b38bdd1fc594c52b8ff5b6fec479df097bf7e2672fb9519706df01c241a"
+    },
+    "7816": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.6.1/issue-7816.md",
+      "closedAt": "2025-11-19T17:27:04Z",
+      "updatedAt": "2025-11-19T17:27:04Z",
+      "contentHash": "7ac191448c99b6b6430583b7757c1c6fe4240ef0f11522330083a8aa8462b37f"
+    },
+    "7817": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.7.0/issue-7817.md",
+      "closedAt": "2025-11-19T18:17:37Z",
+      "updatedAt": "2025-11-19T18:17:37Z",
+      "contentHash": "71c9a696998f95cd1e356cb0c0ea76ff6d0d92f2f8a704b08d0484fe10ae8e48"
+    },
+    "7818": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.7.0/issue-7818.md",
+      "closedAt": "2025-11-20T01:03:35Z",
+      "updatedAt": "2025-11-20T01:03:35Z",
+      "contentHash": "c01fa0275da61ba7fc12e4cf6e0d46596f85fdbc98a4d790657489c806a76a38"
+    },
+    "7819": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.7.0/issue-7819.md",
+      "closedAt": "2025-11-20T09:38:58Z",
+      "updatedAt": "2025-11-20T09:38:58Z",
+      "contentHash": "67ad93d3a2aa24e7cd570075290aaf081a921648852ef1664a38edf5365a4b71"
+    },
+    "7820": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.7.0/issue-7820.md",
+      "closedAt": "2025-11-20T11:38:36Z",
+      "updatedAt": "2025-11-20T11:38:36Z",
+      "contentHash": "e4486d796a3dfe09e8dab2b3fb2181f688f3d9d36c35f6abbeb0ada7b5d57fad"
+    },
+    "7821": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7821.md",
+      "closedAt": "2025-11-20T15:19:02Z",
+      "updatedAt": "2025-11-20T15:19:02Z",
+      "contentHash": "3b72224d49c12aed46c913133ecea3d82e2edc65747d3876bad8723920fcdce7"
+    },
+    "7822": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.7.0/issue-7822.md",
+      "closedAt": "2025-11-20T13:09:13Z",
+      "updatedAt": "2025-11-20T13:09:13Z",
+      "contentHash": "068d57a5d1d1b0994fab8e3c56203bd3af841a1e6f4ddd4750a674779eafd52f"
+    },
+    "7823": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7823.md",
+      "closedAt": "2025-11-20T14:15:33Z",
+      "updatedAt": "2025-11-20T14:15:33Z",
+      "contentHash": "a699450f3a1dbf68836875bed7db7327b4ce080ebcc6d9da63f3c44f60e23d99"
+    },
+    "7824": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7824.md",
+      "closedAt": "2025-11-20T15:41:37Z",
+      "updatedAt": "2025-11-20T15:41:37Z",
+      "contentHash": "a9c350a3a9de6c12479a82f9e82d911cb7c6b41692a593efa9bff18a16da2d0a"
+    },
+    "7825": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7825.md",
+      "closedAt": "2025-11-20T19:49:56Z",
+      "updatedAt": "2025-11-20T19:49:56Z",
+      "contentHash": "63568805b3d7d58de4eab355c29fd23fcf9183378b7471182e362eb327064f09"
+    },
+    "7826": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7826.md",
+      "closedAt": "2025-11-20T19:59:40Z",
+      "updatedAt": "2025-11-20T19:59:40Z",
+      "contentHash": "efd0332c072ed87ced4d001228d0dbfd21e32b407b4800973a324f875a5ae451"
+    },
+    "7827": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7827.md",
+      "closedAt": "2025-11-20T20:36:45Z",
+      "updatedAt": "2025-11-20T20:36:45Z",
+      "contentHash": "924d0b9dcac96c47b018ca48da2bd646e89ab90430e8ea0a882a9c41b4327d4c"
+    },
+    "7828": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7828.md",
+      "closedAt": "2025-11-20T20:54:28Z",
+      "updatedAt": "2025-11-20T20:54:28Z",
+      "contentHash": "34e415adfa5f3377d33acdb2bda07dead40e21d36b2ee56b2a73511cfcc08eb3"
+    },
+    "7829": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7829.md",
+      "closedAt": "2025-11-20T21:06:42Z",
+      "updatedAt": "2025-11-20T21:06:42Z",
+      "contentHash": "1034e606c1ff95cddcc2d9bf52c9b634f67385937f03b1cbb4d8a931e63f9929"
+    },
+    "7831": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7831.md",
+      "closedAt": "2025-11-21T00:45:39Z",
+      "updatedAt": "2025-11-21T00:45:39Z",
+      "contentHash": "a3718a3a45aee9f50a10887fe778e372eedcfb73026aceed25de34fae47ced50"
+    },
+    "7832": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7832.md",
+      "closedAt": "2025-11-21T00:56:40Z",
+      "updatedAt": "2025-11-21T00:56:40Z",
+      "contentHash": "fbd4a3edb300d1f42f5a65293a3786e3d6b8b265041037bb52ccf4a2cc47df57"
+    },
+    "7833": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7833.md",
+      "closedAt": "2025-11-21T01:16:31Z",
+      "updatedAt": "2025-11-21T01:16:31Z",
+      "contentHash": "993c0db0bc1202a7a5aa28d693cecb2b295194e31d6fcf608f9ba925815920a0"
+    },
+    "7834": {
+      "state": "OPEN",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7834.md",
+      "closedAt": null,
+      "updatedAt": "2025-11-21T10:03:49Z",
+      "contentHash": "4202150b84e4d9d6dbfe1e524f246814ed085f4a1c710d81a5fbd1b7ec8dc1b9"
+    },
+    "7836": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7836.md",
+      "closedAt": "2025-11-21T02:14:24Z",
+      "updatedAt": "2025-11-21T02:14:24Z",
+      "contentHash": "aadc19fb6dd47f77f6c038ac8bb3a5cacd6b196b9cbc7066b3f1ace960790796"
+    },
+    "7837": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7837.md",
+      "closedAt": "2025-11-21T09:16:22Z",
+      "updatedAt": "2025-11-21T09:16:22Z",
+      "contentHash": "06fff55200a19805fc1fa90eb3bc0bee904f50473e47344abca8cbafa0ab2374"
+    },
+    "7838": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7838.md",
+      "closedAt": "2025-11-21T10:19:00Z",
+      "updatedAt": "2025-11-21T10:19:00Z",
+      "contentHash": "b2d5e8fe955395548cf29bbafb0f201abf882d911a7f908d311ddd2e332a8170"
+    },
+    "7839": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7839.md",
+      "closedAt": "2025-11-21T10:18:15Z",
+      "updatedAt": "2025-11-21T10:18:15Z",
+      "contentHash": "dfe129dcdea080a6a80636853f906a7a30ca83e1ee17a420b473b5ad8d938d8e"
+    },
+    "7840": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7840.md",
+      "closedAt": "2025-11-21T13:00:34Z",
+      "updatedAt": "2025-11-21T13:00:34Z",
+      "contentHash": "4213e43b1e848f61fdba176407fc6cac0f81846e3981413579953386e2fed0bb"
+    },
+    "7841": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7841.md",
+      "closedAt": "2025-11-21T13:35:47Z",
+      "updatedAt": "2025-11-21T13:35:47Z",
+      "contentHash": "afcbd5acd09c5617458c92fa48116ec00dbe4d6ad0b3bf15c972d7e19c429313"
+    },
+    "7842": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7842.md",
+      "closedAt": "2025-11-21T14:56:31Z",
+      "updatedAt": "2025-11-21T14:56:31Z",
+      "contentHash": "251fdd872486632ff3e0c85e8d27d51ba2e7dbe35a991db4047aa22f7d1f4d71"
+    },
+    "7843": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7843.md",
+      "closedAt": "2025-11-21T14:31:51Z",
+      "updatedAt": "2025-11-21T14:31:52Z",
+      "contentHash": "0100c9fbb6d34f79940ecf1482797eaece3a66c4477c3072cbbb94d6845ab655"
     }
   },
   "releases": {
@@ -6805,6 +6987,14 @@
     "11.6.0": {
       "publishedAt": "2025-11-19T13:05:08Z",
       "contentHash": "6b6aea3a75a479cee1638485cccccb22439737da4381d7926c2e9b7690f22c2f"
+    },
+    "11.6.1": {
+      "publishedAt": "2025-11-19T17:38:22Z",
+      "contentHash": "e55586ac67982eaae3cf90ff87d019e1df737cb7ee9494c4887637da854fac54"
+    },
+    "11.7.0": {
+      "publishedAt": "2025-11-20T13:32:40Z",
+      "contentHash": "4b57f29e22e6b77a204e2f00493d82117088c3beda7bf6614ae08b4fa59c0764"
     }
   }
 }

package/ROADMAP.md

@@ -2,51 +2,52 @@
 
 This document outlines the high-level strategic direction and priorities for the Neo.mjs framework.
 
-## Vision: The AI-Native Development Environment
+## Vision: The "Thick Client" for AI Agents
 
-Our core vision is to create a truly **AI-native development environment**. We are evolving the framework and its surrounding tooling to empower both human developers and AI agents to collaborate seamlessly on building complex, high-performance web applications.
+Our core vision is to position Neo.mjs not just as a frontend framework, but as the **Operating System for AI Agents**. By leveraging our Node.js compatibility, robust class system, and "batteries included" architecture, we provide the structured "brain" (Context Engineering) that powers Anthropic's "Code Execution" pattern.
 
-## Current Focus: Mastering Context Engineering
+## Current Focus: The Agent OS (v11.x)
 
-As framed in our blog post, "[AI-Native, Not AI-Assisted](learn/blog/ai-native-platform-answers-questions.md)", our current development focus is not on the UI framework itself, but on the **tooling and infrastructure** that powers our AI-native workflows.
+We are currently evolving our AI infrastructure to move beyond simple "tool use" and into full **Code Execution**. This means transforming our internal tools into a robust SDK that agents can import and script against directly.
 
-We are focused on **Context Engineering**: the practice of building systems that provide AI agents with the most relevant, accurate, and comprehensive context to perform their tasks. This is the key to unlocking meaningful AI contributions and creating a smooth onboarding experience where agents can teach newcomers.
+### 1. Architectural Enhancements (Code Execution Readiness)
 
-Our work in this area is organized around several key initiatives:
+**Goal:** Enable agents to import and use our intelligent services directly as libraries, without the MCP protocol overhead.
 
-### 1. The AI Knowledge & Memory Foundation
-- **Goal:** To provide agents with comprehensive technical and historical context.
-- **Initiatives:**
-    - **Knowledge Base:** Following the v10.9 release, our RAG system has been enhanced to include all tickets and release notes, providing even deeper project insight.
-    - **Memory Core:** The initial implementation of the agent's long-term memory is complete, allowing it to learn from past interactions. ([Epic: AI Knowledge Evolution](https://github.com/neomjs/neo/issues/7316))
+-   **Decouple Services (Completed):** Refactored `ai/mcp/server/*/services/*.mjs` to be importable as a standalone "AI SDK" (`ai/services.mjs`).
+-   **Standardize Lifecycle (Completed):** Enforced the `initAsync()` and `ready()` pattern across AI services, ensuring robust handling of hybrid database states (managed vs. external) and eliminating race conditions.
+-   **The "Neo Sandbox":** Create a lightweight boilerplate/config that sets up the Neo.mjs core in a Node.js script (handling `globalThis`, `Worker` mocks if needed) so agents can instantly start scripting.
 
-### 2. Professionalizing AI Tooling (The 3 MCP Servers)
-- **Goal:** To migrate our script-based tools into a robust, professional-grade server architecture.
-- **Initiatives:**
-    - We are building **three distinct Model Context Protocol (MCP) servers**:
-        1. A **Knowledge Base Server** for querying project-specific source code and documentation.
-        2. A **Memory Core Server** for providing agents with long-term conversational memory.
-        3. A **GitHub Sync Server** to manage the 2-way synchronization of issues and PRs.
-    - This involves moving the logic from the original scripts into a formal server architecture, making our tools more reliable and accessible to any AI agent. ([Epic: Architect AI Tooling as MCP](https://github.com/neomjs/neo/issues/7399))
+### 2. New "Code Execution" Capabilities
 
-### 3. Expanding Agent Capabilities
-- **Goal:** To give agents powerful new ways to interact with the development environment.
-- **Initiatives:**
-    - **Sighted Agent:** A major initiative to empower agents with the ability to "see" and interact with web pages via Chrome DevTools, enabling automated UI/UX testing and validation. ([Epic: Sighted Agent & DevTools Integration](https://github.com/neomjs/neo/issues/7385))
-    - **GitHub CLI Integration:** Deeply integrating the GitHub CLI to allow agents to automate PR reviews, issue creation, and other crucial repository interactions. ([Epic: Integrate GitHub CLI Workflow](https://github.com/neomjs/neo/issues/7364))
+**Goal:** Empower agents to write "smart" scripts that perform logic on the client side, reducing token usage and increasing accuracy.
 
-### 4. Ensuring Code Quality & Stability
-- **Goal:** To maintain a stable and reliable codebase by enabling automated, scriptable testing for all contributors.
-- **Initiatives:**
-    - **Mandatory Unit Testing:** We are migrating our entire test suite from a browser-based harness (Siesta) to a Node.js-based runner (Playwright). The primary benefit is that tests can be run with a simple `npm test` command. This empowers AI agents to verify their own changes, and it unlocks future CI/CD integration (e.g., pre-commit hooks) to automatically prevent regressions. ([Epic: Enhance Workflow with Mandatory Unit Testing](https://github.com/neomjs/neo/issues/7262))
+-   **"Smart" Search Scripts (Completed):** Verified with `ai/examples/smart-search.mjs`.
+-   **Automated Refactoring Agents:** Expose the `Neo.mjs` core (Component system, Config system) to the agent sandbox. Agents can instantiate components in Node.js to verify config validity using `Neo.create()` before committing code.
+-   **AI SDK Testing:** Implement a dedicated test suite for `ai/services.mjs` to ensure the stability of the Agent OS infrastructure, treating it as a first-class framework component.
 
-### 5. Decoupling the AI Tooling Ecosystem
-- **Goal:** To evolve our general-purpose AI tools into standalone, reusable packages.
-- **Initiatives:**
-    - **Publish MCP Servers to npm (v11.1):** Following the initial implementation for v11, the **Memory Core** and **GitHub Sync** MCP servers will be published as independent packages to npm. This will be achieved by adding dedicated `package.json` files to their sub-folders within the `neo` repository. The Knowledge Base server will remain internal as it is tightly coupled with this project's source code. This strategy allows the general-purpose servers to be consumed via `npx` by the broader AI development community.
+### 3. Visibility & Marketing ("Get Visibility")
 
----
+**Goal:** Establish Neo.mjs as the premier framework for AI-Native development.
 
-## The Path to v11.0.0
+-   **"Context Engineering" Case Study:** Publish technical content comparing raw file dumping (Context Tax) vs. our semantic inheritance chain injection.
+-   **"The Agent OS" Branding:** Update documentation to explicitly highlight "AI-Native" capabilities and "Architecture designed for Agent Code Execution."
+-   **"Self-Healing" Repository (Completed):** Developed `ai/examples/self-healing.mjs` where an agent uses `GitHubWorkflow` + `KnowledgeBase` to autonomously read a bug report, query context, plan, and propose a fix.
+
+## 4. Future: Decoupling the AI Tooling Ecosystem
+
+**Goal:** Evolve our general-purpose AI tools into standalone, reusable packages.
+
+-   **Publish MCP Servers to npm:** The **Memory Core** and **GitHub Sync** MCP servers will be published as independent packages to npm. This will allow the general-purpose servers to be consumed via `npx` by the broader AI development community. The Knowledge Base server will remain internal as it is tightly coupled with this project's source code.
+-   **Sighted Agent Service:** Evolve the "Sighted Agent" concept into a `VisualService` within the AI SDK, allowing agents to programmatically capture screenshots, inspect the A11y tree, and run visual regression tests via Chrome DevTools.
+-   **Multi-Agent Coordination:** Explore patterns for multiple agents to collaborate on complex tasks using the Memory Core as a shared blackboard state.
+
+## 5. Architectural Evolution: Hybrid Distribution Model
+
+**Goal:** Solve the tension between "Agent OS" (Direct SDK access) and "Standalone Tooling" (npx execution).
+
+-   **Strategy:** Split future AI capabilities into "Core" vs. "Server" packages.
+    -   **Core (`@neomjs/ai-*-core`):** Pure logic libraries (Services) that can be imported directly by the Agent SDK for high-performance "Code Execution".
+    -   **Server (`@neomjs/ai-*-server`):** MCP wrappers around the Core libraries for external consumption via `npx`.
+-   **Execution:** We will maintain the current monorepo structure to iterate quickly on the "Agent OS" SDK. Extraction into separate packages will occur only once the service APIs are stable. This ensures we don't lose the "Thick Client" performance advantage while eventually enabling broader ecosystem adoption.
 
-The completion of these foundational infrastructure projects will culminate in the `v11.0.0` release. The timing of this release is dependent on the progress made during Hacktoberfest and subsequent community contributions. After the event, we will assess the state of these epics to define a more concrete release schedule.

package/ServiceWorker.mjs

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

package/ai/examples/db-backup.mjs

@@ -0,0 +1,33 @@
+import { 
+    Memory_DatabaseService, 
+    Memory_LifecycleService, 
+    Memory_ChromaManager 
+} from '../services.mjs';
+
+async function main() {
+    console.log('💾 Starting Memory Core Backup...');
+
+    // 1. Initialize Services
+    console.log('   - Initializing Memory Core...');
+    await Memory_ChromaManager.ready();
+
+    // 2. Perform Export
+    console.log('   - Exporting memories and summaries...');
+    try {
+        const result = await Memory_DatabaseService.exportDatabase({
+            include: ['memories', 'summaries']
+        });
+        console.log(`   ✅ ${result.message}`);
+    } catch (error) {
+        console.error(`   ❌ Export failed: ${error.message}`);
+        process.exit(1);
+    }
+    
+    console.log('✅ Backup complete.');
+    process.exit(0);
+}
+
+main().catch(err => {
+    console.error('Fatal Error:', err);
+    process.exit(1);
+});

package/ai/examples/db-restore.mjs

@@ -0,0 +1,81 @@
+import { 
+    Memory_DatabaseService, 
+    Memory_LifecycleService, 
+    Memory_ChromaManager 
+} from '../services.mjs';
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname  = path.dirname(__filename);
+
+async function main() {
+    console.log('🔄 Starting Memory Core Restore...');
+
+    // 1. Initialize Services
+    console.log('   - Initializing Memory Core...');
+    await Memory_ChromaManager.ready();
+
+    // 2. Locate Backup Files
+    // We assume the backup script created them in dist/memory-backups and dist/session-backups
+    const memoryBackupDir  = path.resolve(__dirname, '../../dist/memory-backups');
+    const sessionBackupDir = path.resolve(__dirname, '../../dist/session-backups');
+
+    async function findLatestBackup(dir, prefix) {
+        try {
+            const files = await fs.readdir(dir);
+            const backups = files
+                .filter(f => f.startsWith(prefix) && f.endsWith('.jsonl'))
+                .sort()
+                .reverse(); // Newest first
+            return backups.length > 0 ? path.join(dir, backups[0]) : null;
+        } catch (e) {
+            return null;
+        }
+    }
+
+    const memoryBackupFile  = await findLatestBackup(memoryBackupDir, 'memory-backup');
+    const sessionBackupFile = await findLatestBackup(sessionBackupDir, 'summaries-backup');
+
+    if (!memoryBackupFile && !sessionBackupFile) {
+        console.error('   ❌ No backup files found.');
+        process.exit(1);
+    }
+
+    // 3. Restore Memories (Replace Mode)
+    if (memoryBackupFile) {
+        console.log(`   - Restoring Memories from: ${path.basename(memoryBackupFile)}`);
+        try {
+            const result = await Memory_DatabaseService.importDatabase({
+                file: memoryBackupFile,
+                mode: 'replace'
+            });
+            console.log(`     ✅ Imported ${result.imported} memories.`);
+        } catch (error) {
+            console.error(`     ❌ Restore failed: ${error.message}`);
+        }
+    }
+
+    // 4. Restore Summaries (Replace Mode)
+    if (sessionBackupFile) {
+        console.log(`   - Restoring Summaries from: ${path.basename(sessionBackupFile)}`);
+        try {
+            const result = await Memory_DatabaseService.importDatabase({
+                file: sessionBackupFile,
+                mode: 'replace'
+            });
+            console.log(`     ✅ Imported ${result.imported} summaries.`);
+        } catch (error) {
+            console.error(`     ❌ Restore failed: ${error.message}`);
+        }
+    }
+
+    console.log('✅ Restore complete.');
+    process.exit(0);
+}
+
+main().catch(err => {
+    console.error('Fatal Error:', err);
+    process.exit(1);
+});

package/ai/examples/self-healing.mjs

@@ -0,0 +1,123 @@
+import {
+    KB_LifecycleService, KB_HealthService, KB_QueryService, KB_DatabaseService, KB_ChromaManager,
+    GH_IssueService, 
+    Memory_Service, Memory_LifecycleService, Memory_ChromaManager
+} from '../services.mjs';
+
+/**
+ * Agent OS Demo: Self-Healing Repository
+ * 
+ * This script demonstrates a fully autonomous agent workflow ("The Thick Client"):
+ * 1. Monitor: Scans GitHub for open bugs.
+ * 2. Understand: Uses the local Knowledge Base to analyze the codebase context.
+ * 3. Plan: Uses the Memory Core to persist its reasoning.
+ * 4. Act: Proposes a fix directly on the GitHub issue.
+ */
+
+const TARGET_ISSUE_TITLE = '[Test] Button click event not firing on mobile';
+
+async function main() {
+    console.log('🤖 Agent OS: Starting Self-Healing Routine...');
+
+    // --- Phase 1: Boot Sequence ---
+    console.log('\n[1] Boot Sequence: Initializing Services...');
+    
+    // Start Knowledge Base
+    await KB_ChromaManager.ready(); // Ensure connection is active
+    console.log('   - Knowledge Base Service: Ready');
+    
+    // Start Memory Core
+    await Memory_ChromaManager.ready(); // Ensure connection is active
+    console.log('   - Memory Core Service: Ready');
+    
+    // Ensure KB content is loaded (embed if needed)
+    try { await KB_DatabaseService.embedKnowledgeBase(); } catch(e) {}
+
+    console.log('✅ System Fully Operational.');
+
+
+    // --- Phase 2: Monitor (GitHub) ---
+    console.log('\n[2] Monitor: Scanning for Issues...');
+    
+    const issues = await GH_IssueService.listIssues({
+        state: 'open',
+        labels: 'bug',
+        limit: 100
+    });
+
+    const targetIssue = issues.issues.find(i => i.title === TARGET_ISSUE_TITLE);
+
+    if (!targetIssue) {
+        console.log('   - No matching test issue found. Exiting.');
+        process.exit(0);
+    }
+
+    console.log(`   - Found Target: #${targetIssue.number} "${targetIssue.title}"`);
+    console.log(`   - Body: "${targetIssue.body.replace(/\n/g, ' ').substring(0, 60)}"...`);
+
+
+    // --- Phase 3: Understand (Knowledge Base) ---
+    console.log('\n[3] Understand: Querying Knowledge Base...');
+    
+    const query = `mobile button click event handler conflict ${targetIssue.body}`;
+    const docs = await KB_QueryService.queryDocuments({ query, type: 'all' });
+    
+    const topResults = docs.results.slice(0, 3);
+    console.log(`   - Analyzed ${docs.results.length} documents.`);
+    console.log(`   - Top Context: ${topResults[0].source} (Score: ${topResults[0].score})`);
+
+
+    // --- Phase 4: Plan (Memory Core) ---
+    console.log('\n[4] Plan: Persisting Strategy to Memory...');
+    
+    const plan = `
+    Issue #${targetIssue.number} reports mobile click failures.
+    KB suggests checking: ${topResults.map(r => r.source).join(', ')}.
+    Hypothesis: DomEvent manager might be double-firing or consuming touch events.
+    Action: Propose investigating DomEvent.mjs and Button/Base.mjs.
+    `;
+
+    await Memory_Service.addMemory({
+        prompt: `Fix bug #${targetIssue.number}: ${targetIssue.title}`,
+        thought: "Analyzed issue and retrieved context. Formulating fix proposal.",
+        response: plan,
+        sessionId: 'self-healing-demo-v1'
+    });
+    console.log('   - Strategy saved to long-term memory.');
+
+
+    // --- Phase 5: Report (GitHub) ---
+    console.log('\n[5] Report: Posting Solution...');
+
+    const commentBody = `
+### 🤖 Agent OS Analysis
+
+I have analyzed this issue using the local Knowledge Base.
+
+**Context Identified:**
+${topResults.map(r => `- \
+${r.source}\
+`).join('\n')}
+
+**Proposed Investigation:**
+Based on the symptoms and the retrieved context, I recommend inspecting the event delegation logic in 
+DomEvent.mjs
+. The search results indicate potential overlaps between touch and click handling in the mobile viewports.
+
+*This comment was generated autonomously by the Neo.mjs Agent OS.*
+    `;
+
+    await GH_IssueService.createComment({
+        issue_number: targetIssue.number,
+        body: commentBody,
+        agent: 'Neo Agent OS'
+    });
+
+    console.log(`✅ Fix proposed on issue #${targetIssue.number}.`);
+    process.exit(0);
+}
+
+main().catch(err => {
+    console.error('Fatal Error:', err);
+    process.exit(1);
+});