auto: 2026-06-04_18:00 changes

1 files changed, 75 insertions, 31 deletions

diff --git a/downloads/newos4_whitepaper.html b/downloads/newos4_whitepaper.html
index 21079b8..c9fd730 100644
--- a/downloads/newos4_whitepaper.html
+++ b/downloads/newos4_whitepaper.html
@@ -84,22 +84,22 @@
     <h1>newOS4 — The Cognitive Operating System</h1>
     
     <div class="meta">
-        Whitepaper v4.3.0-beta | Author: Agando | Status: Architecture Draft | Last Updated: 2026-06-03
+        Whitepaper v4.3.1 | Author: Agando | Status: Architecture Draft | Last Updated: 2026-06-04
     </div>
 
     <section>
         <h2>1. Abstract</h2>
         <p>newOS4 is a <strong>Cognitive Operating System</strong> — an agentic, AI-native fabric where intelligence is treated not as an application layer but as the kernel's primary resource. Unlike traditional OSs that manage CPU cycles and memory pages, newOS4 manages <strong>agentic workflows, semantic storage, and recursive self-optimization</strong> as first-class primitives.</p>
-        <p>The system is built on four pillars:</p>
+        <p>The system is built on four pillars, all now operational:</p>
         <table>
             <thead>
-                <tr><th>Pillar</th><th>Function</th></tr>
+                <tr><th>Pillar</th><th>Function</th><th>Status</th></tr>
             </thead>
             <tbody>
-                <tr><td><strong>Hyper-Modular Kernel</strong></td><td>Real-time self-rewriting drivers for task-specific optimization</td></tr>
-                <tr><td><strong>A2A Protocol</strong></td><td>Standardized neural communication layer for agent negotiation</td></tr>
-                <tr><td><strong>Neural VFS</strong></td><td>Semantic-based file storage where concepts replace paths</td></tr>
-                <tr><td><strong>Recursive Self-Optimization</strong></td><td>Integrated feedback loops generating WPM patches to eliminate latency</td></tr>
+                <tr><td><strong>Hyper-Modular Kernel</strong></td><td>45 hot-swappable ES modules across 3 layers (infrastructure, core, ext)</td><td class="status-done">✅ LIVE</td></tr>
+                <tr><td><strong>A2A Protocol</strong></td><td>Agent contracts with schema validation, orchestrator handshake, no central broker</td><td class="status-done">✅ LIVE</td></tr>
+                <tr><td><strong>Neural VFS</strong></td><td>Semantic concept indexing with nvfs-index, nvfs-resolve, nvfs-tree, nvfs-status + concept:// URI handler</td><td class="status-done">✅ LIVE</td></tr>
+                <tr><td><strong>Recursive Self-Optimization</strong></td><td>system-health telemetry command logging tool latency, VFS stats, module counts, error rates</td><td class="status-done">✅ LIVE</td></tr>
             </tbody>
         </table>
     </section>
@@ -119,22 +119,24 @@
         <h2>3. System Architecture</h2>
         <h3>3.1 Layered Model</h3>
         <pre>
-┌─────────────────────────────────────────────────────┐
-│                  Cognitive Shell                      │
-│   (WebX11 Terminal / Agent UI / Graph Dashboard)     │
-├─────────────────────────────────────────────────────┤
-│               Agent Orchestration Layer              │
-│   (Multi-agent router, sub-agent spawning, leases)   │
-├─────────────────────────────────────────────────────┤
-│                  A2A Protocol Layer                   │
-│   (Neural message bus, contract negotiation, RPC)    │
-├─────────────────────────────────────────────────────┤
-│               Hyper-Modular Kernel                    │
-│   (Self-rewriting drivers, syscalls, WPM runtime)    │
-├─────────────────────────────────────────────────────┤
-│             Neural VFS + Procedural Memory            │
-│   (Semantic paths, skill graphs, fast-context cache) │
-└─────────────────────────────────────────────────────┘
+┌──────────────────────────────────────────────────────────┐
+│                   Cognitive Shell                         │
+│    (WebX11 Terminal / AI Assist / Graph Dashboard)       │
+├──────────────────────────────────────────────────────────┤
+│                Agent Orchestration Layer                  │
+│    (Multi-agent router, A2A handshake, lease system)     │
+├──────────────────────────────────────────────────────────┤
+│                   A2A Protocol Layer                      │
+│    (Contract registry, schema validation, RPC bus)       │
+├──────────────────────────────────────────────────────────┤
+│                Hyper-Modular Kernel                       │
+│    [infrastructure] module-loader, module-manager         │
+│    [core] 23 modules — terminal, VFS, AI, ollama, ...    │
+│    [ext] 19 modules — editor, mindmap, webdav, cron ...  │
+├──────────────────────────────────────────────────────────┤
+│              Neural VFS + Procedural Memory                │
+│    (Semantic indexing, concept:// URIs, skill graph)     │
+└──────────────────────────────────────────────────────────┘
         </pre>
 
         <h3>3.2 The Trinity of Cognition</h3>
@@ -144,21 +146,61 @@
             <li><strong>Reasoning</strong> — Contextual inference via LLM backbone + procedural memory (Maps to Scheduler)</li>
             <li><strong>Action</strong> — Tool execution via sandboxed syscalls and agent delegation (Maps to Execution)</li>
         </ul>
+
+        <h3>3.3 Module Layer Separation</h3>
+        <p>New in v4.3.1: All 45 modules are classified into three distinct layers tracked in <code>modules-index.json</code>:</p>
+        <table>
+            <thead>
+                <tr><th>Layer</th><th>Count</th><th>Load Strategy</th><th>Examples</th></tr>
+            </thead>
+            <tbody>
+                <tr><td><strong>Infrastructure</strong></td><td>3</td><td>Loaded by constructor (no user-facing commands)</td><td>module-loader, module-manager, ollama-manager</td></tr>
+                <tr><td><strong>Core</strong></td><td>23</td><td>Boot-loaded from BUILTIN list</td><td>terminal, vfs, aiassist, servermon, ollama, orchestration</td></tr>
+                <tr><td><strong>Extension</strong></td><td>19</td><td>Demand-loaded via packages.json</td><td>editor, mindmap, webdav, cron, theme, wpm, calc, voice</td></tr>
+            </tbody>
+        </table>
+        <p>The <code>modules-list</code> terminal command displays layer tags <code>[core]</code>, <code>[ext]</code>, <code>[infra]</code> for instant visibility. <code>view_module</code> and <code>get_module_status</code> resolve file paths from the index, eliminating class-name heuristics.</p>
     </section>
 
     <section>
         <h2>4. Pillar Deep Dives</h2>
         <h3>4.1 Hyper-Modular Kernel</h3>
-        <p>The kernel is a collection of hot-swappable driver modules loaded via the <strong>WPM (WebX11 Package Manager)</strong>. Each driver is an isolated ES module. A self-rewrite daemon monitors telemetry and generates optimized driver variants.</p>
+        <p>The kernel is a collection of 45 hot-swappable driver modules across three layers:</p>
+        <ul>
+            <li><strong>Infrastructure</strong> (3) — module-loader, module-manager, ollama-manager. Loaded by the constructor, providing boot-time services.</li>
+            <li><strong>Core</strong> (23) — terminal, VFS, AI assist, server monitor, ollama, orchestration, agent registry, neural VFS, mod manager, and more. Boot-loaded from the <code>BUILTIN</code> list at startup.</li>
+            <li><strong>Extension</strong> (19) — editor, mindmap, webdav, cron, diff, theme, wpm, calc, voice, busybox, cryptogzip, filemgr, shell, alias, finder, tutorial, skill-pack-core, and more. Demand-loaded via <code>packages.json</code>.</li>
+        </ul>
+        <p>All modules tracked in <code>modules-index.json</code> — the single source of truth for module-to-file mapping, class names, and load strategies. Layer separation eliminates confusion about which modules are core OS vs. user-installable packages.</p>
+        <p>Cache versioning via <code>?v=2026-06-03-neuralvfs</code> query parameter ensures all module loads use fresh files after system updates.</p>
 
         <h3>4.2 A2A Protocol</h3>
-        <p>Agent-to-Agent (A2A) is a standardized message format for agent negotiation. Agents discover each other via VFS registrations without a central broker.</p>
+        <p>Agent-to-Agent (A2A) is a standardized message format for agent negotiation. Agents register contracts with schema validation via <code>contract-register</code>, discover each other via <code>contract-list</code>, and negotiate task delegation without a central broker.</p>
+        <p>The orchestrator performs an A2A handshake before delegating tasks: it queries the contract registry for available agents matching the required capability, validates schemas, and negotiates a lease. This eliminates hardcoded agent routing in favor of dynamic capability discovery.</p>
+        <p>Key commands: <code>contract-register &lt;name&gt; &lt;capability&gt;</code>, <code>contract-list</code>, <code>validateTask &lt;contract_id&gt; &lt;payload&gt;</code>.</p>
+        <p>Contracts persist in VFS under <code>/system/contracts/</code> and survive page reloads.</p>
 
         <h3>4.3 Neural VFS</h3>
-        <p>Replaces hierarchical paths with semantic addressing (e.g., <code>concept://agentic-workflows/design-patterns</code>). Path resolution uses a semantic index and context cache.</p>
+        <p>Replaces hierarchical paths with semantic addressing. Users access files by concept rather than directory tree path.</p>
+        <p>Four terminal commands:</p>
+        <ul>
+            <li><code>nvfs-index</code> — Builds a semantic index of all VFS files, mapping concepts to file paths.</li>
+            <li><code>nvfs-status</code> — Shows index statistics (total concepts indexed, coverage).</li>
+            <li><code>nvfs-resolve &lt;concept&gt;</code> — Resolves a concept to its file path(s).</li>
+            <li><code>nvfs-tree [concept]</code> — Displays the semantic index as a concept tree.</li>
+        </ul>
+        <p>Plus <code>concept://</code> URI handler integrated into VFS <code>readFile()</code> and <code>ls()</code> — <code>cat concept://skill</code> resolves through the semantic index and returns actual file content. An AI tool <code>nvfs_resolve</code> is also available for AI-assisted concept lookups.</p>
 
         <h3>4.4 Recursive Self-Optimization</h3>
-        <p>The loop: <code>Monitor → Profile → Diagnose → Patch → Test → Promote</code>. This ensures the system evolves in real-time to eliminate latency.</p>
+        <p>The loop: <code>Monitor → Profile → Diagnose → Patch → Test → Promote</code>.</p>
+        <p>The <code>system-health</code> command provides real-time telemetry:</p>
+        <ul>
+            <li><strong>Tool Latency</strong> — Per-tool timing tracked in <code>/system/metrics/tool-latency.json</code>.</li>
+            <li><strong>VFS Stats</strong> — File count, directory count, total storage used.</li>
+            <li><strong>Module Stats</strong> — Loaded module count, registered agent count.</li>
+            <li><strong>Memory</strong> — Current usage vs. 4GB limit, tool call counts, error rates.</li>
+        </ul>
+        <p>Telemetry hooks are embedded in the AI tool-calling paths (safe and destructive) within <code>module-aiassist.js</code>, automatically logging every tool invocation. This data feeds future latency diagnosis and WPM patch generation.</p>
     </section>
 
     <section>
@@ -184,11 +226,13 @@
             <li>✅ <strong>Localized Asset Management</strong> (Bypassing server security blocks).</li>
         </ul>
 
-        <h3>Phase 3 — Cognitive OS <span class="status-progress">🟡 IN PROGRESS</span></h3>
+        <h3>Phase 3 — Cognitive OS <span class="status-done">✅ SUBSTANTIALLY COMPLETE</span></h3>
         <ul>
-            <li>✅ Neural VFS — semantic concept indexing (nvfs-index, nvfs-resolve, nvfs-tree).</li>
-            <li>✅ A2A Protocol — agent contracts with schema validation (contract-register, contract-list).</li>
-            <li>🟡 Recursive self-optimization — telemetry-driven latency diagnosis.</li>
+            <li>✅ Neural VFS — semantic concept indexing (nvfs-index, nvfs-resolve, nvfs-tree, nvfs-status).</li>
+            <li>✅ concept:// URI handler integrated into VFS readFile/ls (cat concept://skill works).</li>
+            <li>✅ A2A Protocol — agent contracts with schema validation, orchestrator handshake (contract-register, contract-list).</li>
+            <li>✅ Recursive self-optimization — system-health telemetry command (tool latency, VFS stats, module stats, memory, error rates).</li>
+            <li>✅ Module layer separation — 45 modules classified across infrastructure/core/ext with modules-index.json.</li>
             <li>⬜ Predictive resource allocation.</li>
             <li>⬜ Global World Model.</li>
         </ul>