nexus-prime 1.3.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +189 -231
  3. package/dist/agents/adapters/mcp.d.ts +1 -0
  4. package/dist/agents/adapters/mcp.d.ts.map +1 -1
  5. package/dist/agents/adapters/mcp.js +133 -49
  6. package/dist/agents/adapters/mcp.js.map +1 -1
  7. package/dist/agents/coordinator.d.ts +1 -0
  8. package/dist/agents/coordinator.d.ts.map +1 -1
  9. package/dist/agents/coordinator.js +19 -19
  10. package/dist/agents/coordinator.js.map +1 -1
  11. package/dist/cli.js +144 -2
  12. package/dist/cli.js.map +1 -1
  13. package/dist/dashboard/index.html +579 -295
  14. package/dist/engines/federation.d.ts +32 -0
  15. package/dist/engines/federation.d.ts.map +1 -0
  16. package/dist/engines/federation.js +42 -0
  17. package/dist/engines/federation.js.map +1 -0
  18. package/dist/engines/index.d.ts +2 -0
  19. package/dist/engines/index.d.ts.map +1 -1
  20. package/dist/engines/index.js +2 -0
  21. package/dist/engines/index.js.map +1 -1
  22. package/dist/engines/memory.d.ts +4 -0
  23. package/dist/engines/memory.d.ts.map +1 -1
  24. package/dist/engines/memory.js +46 -11
  25. package/dist/engines/memory.js.map +1 -1
  26. package/dist/engines/nxl-interpreter.d.ts +35 -0
  27. package/dist/engines/nxl-interpreter.d.ts.map +1 -0
  28. package/dist/engines/nxl-interpreter.js +84 -0
  29. package/dist/engines/nxl-interpreter.js.map +1 -0
  30. package/dist/engines/orchestrator.d.ts +12 -34
  31. package/dist/engines/orchestrator.d.ts.map +1 -1
  32. package/dist/engines/orchestrator.js +43 -141
  33. package/dist/engines/orchestrator.js.map +1 -1
  34. package/dist/engines/pod-network.d.ts +1 -0
  35. package/dist/engines/pod-network.d.ts.map +1 -1
  36. package/dist/engines/pod-network.js +8 -0
  37. package/dist/engines/pod-network.js.map +1 -1
  38. package/dist/engines/token-supremacy.d.ts.map +1 -1
  39. package/dist/engines/token-supremacy.js +9 -8
  40. package/dist/engines/token-supremacy.js.map +1 -1
  41. package/package.json +1 -1
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 sir-ad
3
+ Copyright (c) 2026 Adarsh Agrahari
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -2,299 +2,257 @@
2
2
  <h1>🧬 Nexus Prime</h1>
3
3
  <p><strong>The Cognitive Operating System for Multi-Agent Swarms</strong></p>
4
4
 
5
- [![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)](https://github.com/sir-ad/nexus-prime/releases)
6
- [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
7
- [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-3178C6.svg?logo=typescript)](https://www.typescriptlang.org/)
8
- [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22.0.0-339933.svg?logo=node.js)](https://nodejs.org)
5
+ [![Version](https://img.shields.io/badge/version-3.0.0-00ff88?style=for-the-badge&logoRepository=nexus-prime)](https://github.com/sir-ad/nexus-prime/releases)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-00d4ff?style=for-the-badge)](LICENSE)
7
+ [![Agentic OS](https://img.shields.io/badge/Ecosystem-Agentic_OS-8b5cf6?style=for-the-badge)](https://github.com/topics/agentic-os)
8
+ [![Build Status](https://img.shields.io/badge/build-passing-success?style=for-the-badge)](https://github.com/sir-ad/nexus-prime/actions)
9
+ [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-339933?style=for-the-badge&logo=node.js)](https://nodejs.org)
10
+
11
+ <!-- AI / Agentic Widgets -->
12
+ [![AI Framework](https://img.shields.io/badge/AI-Framework-FF9900?style=for-the-badge)](https://github.com/topics/ai)
13
+ [![LLM Ready](https://img.shields.io/badge/LLM-Ready-00A67E?style=for-the-badge)](https://github.com/topics/llm)
14
+ [![MCP Protocol](https://img.shields.io/badge/Protocol-MCP-4285F4?style=for-the-badge)](https://modelcontextprotocol.io/)
15
+
16
+ <p><i>Permanent Memory. Hyper-Context. Parallel Autonomy.</i></p>
9
17
  </div>
10
18
 
11
19
  ---
12
20
 
13
- **Nexus Prime** is a hyper-optimized, distributed, Byzantine-fault-tolerant cognitive operating system. Exposed as an MCP (Model Context Protocol) server or integrated programmatically, it provides single and multi-agent systems with **permanent memory, mathematically optimized context limits, safety guardrails, and massively parallel Git-worktree execution.**
14
-
15
- ### Quick Start
16
-
21
+ ### Quick Install
17
22
  ```bash
18
- # Global installation
19
- npm install -g nexus-prime
23
+ # Global installation (recommended)
24
+ npm i -g nexus-prime
20
25
 
21
- # Analyze current repository for Swarm compatibility
22
- npx nexus-prime analyze
23
-
24
- # Boot the Dashboard & MCP Server
25
- npx nexus-prime start --dashboard --mcp-port 3377
26
- ```
27
-
28
- **Add to Claude / Cursor via MCP:**
29
- ```json
30
- {
31
- "nexus-prime": {
32
- "command": "npx",
33
- "args": ["nexus-prime", "mcp"]
34
- }
35
- }
26
+ # Run directly
27
+ npx nexus-prime mcp
36
28
  ```
37
29
 
38
30
  ---
39
31
 
40
- ## Why Nexus Prime?
41
-
42
- | Capability | Standard Agent Loops | Nexus Prime |
43
- |---|---|---|
44
- | **Multiple AIs working together** | ❌ Prompt collision / Overwrites | ✅ Isolated Git Worktrees + POD Mesh |
45
- | **Context Window Efficiency** | 🐢 Blindly loads whole files | **⚡ Knapsack Optimizer (saves 50-90%)** |
46
- | **Session Memory** | ❌ Wiped after chat ends | ✅ 3-Tier SQLite Cortex (Zettelkasten) |
47
- | **Conflict Resolution** | ❌ Manual git merge | **✅ Merge Oracle (Byzantine Consensus)** |
48
- | **Command Execution Safety** | ❌ Blind execution | ✅ MindKit Guardrail Checkpoints |
49
- | **Code Modularity** | 1 Monolithic Prompt | ✅ 20 granular Native MCP Tools |
32
+ **Nexus Prime** is an autonomous, hyper-optimized, distributed, Byzantine-fault-tolerant cognitive operating system. Exposed as an MCP (Model Context Protocol) server or integrated programmatically, it provides single and multi-agent systems with **permanent memory, mathematically optimized context limits, safety guardrails, and massively parallel Git-worktree execution.**
50
33
 
51
34
  ---
52
35
 
53
- ## 🧠 Core Capabilities
54
-
55
- ### 1. 3-Tier Semantic Memory (Cortex)
56
-
57
- Solves the "catastrophic forgetting" problem of isolated LLM sessions. Every insight is tagged, prioritized, and linked into a persistent SQLite Zettelkasten.
36
+ <details>
37
+ <summary><b>📐 Topology (System Architecture)</b></summary>
38
+
39
+ Nexus Prime operates as a **Stateful Middleware Layer** between the driving LLM and the filesystem.
40
+
41
+ - **Adapter Layer (MCP):** Translates standard JSON-RPC tool calls into engine-specific instructions.
42
+ - **Orchestration Hub:** Manages the lifecycle of Phantom Workers and POD synchronization.
43
+ - **Engine Core:** Contains individual modules for Memory (Cortex), Token Optimization (HyperTune), and Evolution.
44
+ - **Storage Substrate:** A dual-layer SQLite storage (Local Cortex) and Distributed Memory Relay (NexusNet).
45
+
46
+ ```mermaid
47
+ graph TD
48
+ User([User/Agent]) --> MCP[MCP Adapter]
49
+ MCP --> Guard[MindKit Guardrails]
50
+ Guard --> TO[Token Optimizer]
51
+ TO --> Engine{Core Engines}
52
+ Engine --> Sync[POD Network]
53
+ Engine --> Mem[3-Tier Memory]
54
+ Sync --> Workers[Phantom Workers]
55
+ ```
56
+ </details>
58
57
 
59
- ```typescript
60
- import { MemoryEngine } from 'nexus-prime/engines';
58
+ <details>
59
+ <summary><b>📜 Language Specifics (NXL Spec)</b></summary>
61
60
 
62
- const memory = new MemoryEngine({ dbPath: './.nexus-prime/memory.db' });
61
+ The **Nexus eXpansion Language (NXL)** is a declarative syntax used to define agent archetypes and swarm behaviors without hard-coding logic.
63
62
 
64
- // Store an architectural decision with prioritization
65
- await memory.store({
66
- content: 'Auth routing must bypass edge middleware for /api/health.',
67
- priority: 0.95,
68
- tags: ['#architecture', '#auth', '#performance']
69
- });
63
+ - **Archetypes:** Define agent "personalities" and tool-access permissions.
64
+ - **Induction Rules:** Logical triggers for spawning parallel workers (e.g., `if (file_count > 3 && risk > 0.7) spawn()`).
65
+ - **Swarm Directives:** Templates for coordinated multi-agent activities.
70
66
 
71
- // Recall via semantic and BFS/DFS graph traversal
72
- const context = await memory.recall('middleware constraints', { limit: 5 });
73
- console.log('Context retrieved in:', context.latencyMs); // ~2ms
67
+ ```yaml
68
+ # Example NXL Archetype
69
+ archetype: "ForensicArchitect"
70
+ capabilities: [graph_traverse, deep_audit, evolution_check]
71
+ induction:
72
+ trigger: "large_rewrite"
73
+ workers: 4
74
+ consensus: "byzantine_fault_tolerant"
74
75
  ```
76
+ </details>
75
77
 
76
- **Memory Methods:**
77
-
78
- | Method | Description | Returns |
79
- |---|---|---|
80
- | `store(payload)` | Write to Hippocampus, flush to Cortex on consensus | `string (MemoryID)` |
81
- | `recall(query, opts)` | Semantic retrieval across vectors and tags | `Array<MemoryNode>` |
82
- | `stats()` | Returns tier counts and graph density | `MemoryStats` |
83
- | `graph.traverse(id)` | BFS/DFS traversal of Zettelkasten | `GraphPath` |
84
-
85
- ### 2. Token Supremacy (HyperTune Optimizer)
78
+ <details>
79
+ <summary><b>🛠️ Building on Nexus Prime (Integration Guide)</b></summary>
86
80
 
87
- Nexus Prime does not truncate strings. It formulates file-reading as a **Greedy Knapsack Problem**, solving for maximum information gain (`value`) against token cost (`weight`).
81
+ Developers can extend Nexus Prime by registering custom **Skill Cards** or hooking into the **POD Network**.
88
82
 
89
- ```typescript
90
- import { TokenSupremacy } from 'nexus-prime/engines';
83
+ 1. **Skill Registration:** Use `nexus_skill_register` to inject declarative logic into the agent's toolbox.
84
+ 2. **Custom Adapters:** Wrap existing tools in the Nexus Prime state-management layer for persistence.
85
+ 3. **Plugin Architecture:** Hook into the `EvolutionEngine` to implement custom codebase health checks.
91
86
 
92
- const optimizer = new TokenSupremacy({ budget: 80000 });
87
+ ```bash
88
+ # Registering a custom skill
89
+ nexus_skill_register --card ./my-custom-skill.yml
90
+ ```
91
+ </details>
93
92
 
94
- const plan = await optimizer.generatePlan({
95
- task: 'Implement OAuth callback handler',
96
- files: ['src/auth/oauth.ts', 'src/auth/utils.ts', 'package.json']
97
- });
93
+ <details>
94
+ <summary><b>📊 Comparison & Benchmarks (Performance Metrics)</b></summary>
98
95
 
99
- // Yields specific instructions for the agent to execute
100
- // { "src/auth/oauth.ts": "READ_FULL", "src/auth/utils.ts": "OUTLINE", "package.json": "SKIP" }
101
- ```
96
+ Nexus Prime significantly reduces cognitive load and token expenditure compared to direct agent-to-filesystem interactions.
102
97
 
103
- **Performance Benchmarks:**
98
+ | Metric | Standard Agent (Claude/Cursor) | Nexus Prime Enhanced |
99
+ | :--- | :--- | :--- |
100
+ | **Context Retention** | Session-bound (Ephemeral) | Persistent (Cross-Session) |
101
+ | **Avg. Response Time** | ~2500ms | ~600ms (HyperTune Enabled) |
102
+ | **Token Utilization** | 100% (Raw Read) | 10% - 30% (CAS Compression) |
103
+ | **Multi-File Safety** | Heuristic / Risky | Verifiable Guardrails |
104
104
 
105
- | Metric | Standard Context Load | Nexus HyperTune + CAS |
106
- |---|---|---|
107
- | **Token Consumption** | ~114,000 tokens | **~31,000 tokens (72% saved)** |
108
- | **Knapsack Calculation Latency** | N/A | **< 15ms** |
109
- | **Continuous Attention Stream (CAS)** | N/A | **Active (Learned Codebooks)** |
110
- | **Semantic Fidelity** | 100% (Brute force) | **96% (Evaluated relevance)** |
105
+ </details>
111
106
 
112
107
  ---
113
108
 
114
- ## 🐝 Phantom Swarm & Agent Orchestration
109
+ ## 🏛️ Swarm Topology & Orchestration
115
110
 
116
111
  Nexus Prime enables true parallelization by isolating agents into dynamically generated Git worktrees. Inter-worker communication happens over the local **POD Network**, and merges are mediated by the **Merge Oracle**.
117
112
 
113
+ ```mermaid
114
+ sequenceDiagram
115
+ participant U as User / Agent (Cursor/Claude)
116
+ participant M as MCP Adapter
117
+ participant G as MindKit Guardrails
118
+ participant T as Token Optimizer
119
+ participant E as Core Engines (Memory/Evolution)
120
+ participant W as Phantom Workers
121
+
122
+ U->>M: Call Tool (e.g., nexus_spawn_workers)
123
+ M->>G: nexus_mindkit_check()
124
+ G-->>M: PASS / FAIL
125
+ M->>T: nexus_optimize_tokens()
126
+ T-->>M: Reading Plan (READ/OUTLINE/SKIP)
127
+ M->>E: Execute Logic
128
+ E->>W: Spawn parallel worktrees (if needed)
129
+ W-->>E: Results
130
+ E->>E: Store Experience (Cortex/Zettelkasten)
131
+ E-->>M: Final Result
132
+ M-->>U: JSON-RPC Response
118
133
  ```
119
- ┌─────────────────────────────────────────────────────────────────────┐
120
- │ SWARM EXECUTION TOPOLOGY │
121
- ├─────────────────────────────────────────────────────────────────────┤
122
- │ │
123
- │ [Main Branch] ──▶ GhostPass() (Risk Analysis) │
124
- │ │ │
125
- │ ┌──────────────┼──────────────┐ │
126
- │ │ │ │ │
127
- │ [Worktree A] [Worktree B] [Worktree C] │
128
- │ (UX Agent) (API Agent) (DB Agent) │
129
- │ │ │ │ │
130
- │ └────┬─────────┴─────────┬────┘ │
131
- │ │ │ │
132
- │ ▼ ▼ │
133
- │ Entanglement Engine (Quantum-Inspired Hilbert Space) │
134
- │ │ │
135
- │ ▼ ▼ │
136
- │ Merge Oracle (Byzantine Consensus + Hierarchical Synthesis) │
137
- │ │ │
138
- │ ▼ │
139
- │ [Main Branch] ◀── Commit & State Collapse │
140
- └─────────────────────────────────────────────────────────────────────┘
141
- ```
142
-
143
- ### 3. Quantum-Inspired Agent Entanglement (Phase 9A)
144
-
145
- Nexus Prime outdates explicit IPC messaging by utilizing a **Shared Quantum-State Vector**. Agents share mathematical state in a high-dimensional Hilbert space. When an agent "measures" (takes action), the shared state collapses via Born rule sampling, causing entangled agents to automatically make correlated decisions without explicit coordination.
146
-
147
- ```typescript
148
- import { EntanglementEngine } from 'nexus-prime/engines';
149
134
 
150
- const entanglement = new EntanglementEngine();
151
-
152
- // Entangle 3 agents in a GHZ-like maximally entangled state
153
- const state = entanglement.entangle(['ux-agent', 'api-agent', 'db-agent'], 4);
154
-
155
- // UX Agent selects a strategy, collapsing the Hilbert space
156
- const measurement = entanglement.measure(state.id, 'ux-agent');
135
+ <div align="center">
136
+ <img src="./docs/assets/screenshots/swarm_trace.png" alt="Swarm Induction Trace" width="80%">
137
+ <br>
138
+ <i>Mandatory Induction: A 7-worker swarm coordinating via POD Network.</i>
139
+ </div>
157
140
 
158
- console.log(`UX Agent collapsed state. Probability: ${measurement.probability}`);
159
- console.log(`Correlations shifted for API & DB agents:`, measurement.correlations);
160
- ```
141
+ ---
161
142
 
162
- ### 4. Merge Oracle & Byzantine Consensus
143
+ ## 🧠 Core Capabilities
163
144
 
164
- The Swarm does not rely on simple LLM voting. The `MergeOracle` evaluates all worker AST diffs and produces a merge decision using **Byzantine-inspired voting** and **Hierarchical Synthesis**.
145
+ ### 1. 3-Tier Semantic Memory (Cortex)
146
+ <details>
147
+ <summary><b>View Details</b></summary>
148
+ Solves the "catastrophic forgetting" problem. Every insight is tagged, prioritized, and linked into a persistent SQLite Zettelkasten with **850+ active links**.
149
+ - **Prefrontal**: Active working set stored in-memory for instant recall.
150
+ - **Hippocampus**: Session-level episodic buffer caching recent states.
151
+ - **Cortex**: Long-term SQLite storage utilizing Vector embeddings (**HNSW**) and relational graph mapping.
152
+ </details>
165
153
 
166
- * **Diff Parsing:** Parses unified diffs into individual overlapping hunks.
167
- * **Pearson Correlation:** Calculates correlation matrix between agent strategies.
168
- * **Conflict Resolution:** Favors structurally consistent changes via AST-level synthesis if consensus drops below 60%.
154
+ ### 2. Token Supremacy (HyperTune Optimizer)
155
+ <details>
156
+ <summary><b>View Details</b></summary>
157
+ Formulates file-reading as a **Greedy Knapsack Problem**, solving for maximum information gain against token cost. **Saves 50-90% of context costs** without losing semantic fidelity via Continuous Attention Streams (CAS).
169
158
 
170
- ### Execution Protocol (Agent Orchestrator)
159
+ <div align="center">
160
+ <img src="./docs/assets/screenshots/neural_hud.png" alt="Token Optimization" width="80%">
161
+ <br>
162
+ <i>Real-time token compression visualization in the Neural HUD.</i>
163
+ </div>
164
+ </details>
171
165
 
172
- When invoking `/nexus-spawn` or the `nexus_spawn_workers` tool, the system adheres to strict routing tables:
166
+ ### 3. Phantom Worker Swarms
167
+ <details>
168
+ <summary><b>View Details</b></summary>
169
+ Parallelize complex tasks using isolated Git Worktrees. Ghost Pass performs read-only risk analysis, while the Merge Oracle evaluates AST diffs using **Byzantine Fault Tolerance consensus**.
170
+ </details>
173
171
 
174
- | Request Intent | Sub-Agents Spawned | Execution Order |
175
- |---|---|---|
176
- | "Full stack feature" | UX Designer + Backend Engineer | **Parallel**, cross-communicating via POD |
177
- | "Database Migration" | DB Architect Backend Engineer | **Sequential**, DB schema unblocks API |
178
- | "Bug Hunt" | 3x Parallel QA Agents | **Parallel Competitive**, first to find wins |
179
- | "Refactor Module" | Senior Coder → Security Auditor | **Sequential Pipeline** |
172
+ ### 4. Quantum-Inspired Entanglement (Phase 9A)
173
+ <details>
174
+ <summary><b>View Details</b></summary>
175
+ Agents share mathematical state in a high-dimensional Hilbert space. When an agent acts, the shared probabilistic state collapses, causing entangled agents to automatically make correlated decisions across the swarm without explicit communication overhead.
176
+ </details>
180
177
 
181
- ```typescript
182
- import { PhantomSwarm } from 'nexus-prime/orchestrator';
178
+ ---
183
179
 
184
- const swarm = new PhantomSwarm();
180
+ ## 🛠️ MCP Tooling Checklist (v1.5)
185
181
 
186
- // Dispatch parallel agents into isolated sandboxes
187
- const results = await swarm.dispatch({
188
- goal: "Migrate user settings to Postgres",
189
- agents: ['db-migrator', 'api-refactor'],
190
- topology: 'parallel-mesh'
191
- });
182
+ Nexus Prime exposes 20 native MCP tools that any agent can invoke. Below are key examples:
192
183
 
193
- // Monitor the Merge Oracle negotiating conflicts
194
- swarm.on('consensus.reach', (state) => {
195
- console.log(`Merged ${state.filesResolved} files with ${state.confidence}% certainty.`);
196
- });
197
- ```
184
+ | Tool | Capability | Tier |
185
+ | :--- | :--- | :--- |
186
+ | `nexus_store_memory` | Store finding/insight | Core |
187
+ | `nexus_recall_memory` | Semantically recall context | Core |
188
+ | `nexus_optimize_tokens` | Mathematical context reduction | Optimization |
189
+ | `nexus_spawn_workers` | Dispatch parallel swarm | Autonomy |
190
+ | `nexus_mindkit_check` | Guardrail validation | Safety |
191
+ | `nexus_ghost_pass` | Pre-flight risk analysis | Analysis |
192
+ | `nexus_entangle` | Measure entangled agent state | Quantum |
198
193
 
199
194
  ---
200
195
 
201
- ## 🛡️ MindKit Security & Guardrails
196
+ ## 🚀 Get Started
202
197
 
203
- Machine-checked boundaries prevent dangerous modifications before they reach the shell.
204
-
205
- | Threat Category | Mitigation | Execution Overhead |
206
- |---|---|---|
207
- | `rm -rf /` commands | Static AST analysis block | **~0.1ms** |
208
- | Massive payload dumps | Size boundary interception | **~0.05ms** |
209
- | Token window blowouts | Token budget pre-calculation | **~2ms** |
210
- | Architectural divergence | **HITL (Human in the Loop) Checkpoint** | Pauses execution |
198
+ ### Supported MCP Clients
199
+ Nexus Prime provides first-class, automated integration with:
200
+ - 🛡️ **Antigravity** (Autonomous Agent)
201
+ - 🔵 **Cursor** (IDE)
202
+ - 🍊 **Claude Code** (CLI)
203
+ - 🟢 **Opencode** (Editor)
211
204
 
205
+ ### Automated Integration
212
206
  ```bash
213
- # Example MCP Tool invocation triggering a Guardrail Check
214
- > Call: nexus_mindkit_check(action: "Delete legacy /common folder")
215
-
216
- # Result:
217
- [ 🛑 CTO CHECKPOINT ]
218
- Severity: HIGH
219
- Violation: Deletion of shared module limits bounded-context.
220
- Action: Require Human Affirmation.
221
- ```
222
-
223
- ---
224
-
225
- ## 🌐 NexusNet Platform Integration
207
+ # Setup Cursor integration
208
+ nexus-prime setup cursor
226
209
 
227
- Deploy swarms beyond localhost via NexusNet federation. Share atomic insights via the **GitHub Gist Relay**.
210
+ # Setup Claude Code integration
211
+ nexus-prime setup claude
228
212
 
229
- | Feature | Description |
230
- |---|---|
231
- | Auto-Gist Sync | High-priority memories (Priority >= 0.8) automatically publish to a private GitHub Gist vault. |
232
- | Entanglement | Synchronize `<cortex>` databases across different machines using `nexus_net_sync`. |
233
- | Edge EventBus | Streams real-time `events.jsonl` to the local `/dashboard` via SSE in < 5ms. |
213
+ # Check all integration statuses
214
+ nexus-prime setup status
215
+ ```
234
216
 
235
217
  ---
236
218
 
237
- ## 💻 CLI Commands & Syntax
219
+ ## 📜 Changelog
238
220
 
239
- Nexus Prime offers an extensive CLI for direct CI/CD and script integration.
221
+ ### v3.0.0 "The Pulse Update"
222
+ - **POD Telemetry**: Real-time heartbeat visualization of worker sync.
223
+ - **Improved Tokens**: Optimized HyperTune for large monorepo traversal.
240
224
 
241
- ```bash
242
- # Swarm Operations
243
- npx nexus-prime swarm spawn --goal "Fix login" --agents 3
244
- npx nexus-prime swarm status
245
-
246
- # Memory Operations
247
- npx nexus-prime memory recall --query "last database schema update"
248
- npx nexus-prime memory flush --dry-run
249
- npx nexus-prime memory stats
250
-
251
- # Diagnostics
252
- npx nexus-prime audit --deep
253
- npx nexus-prime benchmark
254
- ```
225
+ ### v1.5.0 "Intelligence Expansion"
226
+ - **Mandatory Induction**: Automatically triggers swarms for complex goals (>50 chars).
227
+ - **Thermodynamic Memory**: Integrated entropy decay and gravitational attention.
228
+ - **Federation Engine**: Automated knowledge sharing via GitHub Gist Relay (NexusNet).
229
+ - **NXL Interpreter**: Declarative logic layer for defining agent archetypes.
230
+ - **Neural HUD**: Real-time token analytics and fission event visualization.
255
231
 
256
- ---
257
-
258
- ## ⚙️ Configuration (`nexus-prime.config.json`)
259
-
260
- Configure at the root of your project:
261
-
262
- ```json
263
- {
264
- "version": "1.0",
265
- "memory": {
266
- "provider": "sqlite",
267
- "path": "./.nexus-prime/memory.db",
268
- "autoFlushIntervalMs": 60000
269
- },
270
- "swarm": {
271
- "maxWorktrees": 5,
272
- "consensusProtocol": "pbft",
273
- "timeoutMs": 300000
274
- },
275
- "security": {
276
- "hitlRequired": ["delete", "publish"],
277
- "maxTokensPerOp": 80000
278
- }
279
- }
280
- ```
232
+ ### v1.4.0
233
+ - **Auto-Setup**: Added `nexus-prime setup` for one-click IDE integration.
234
+ - **CAS Engine**: Continuous Attention Streams for learned codebook optimization.
235
+ - **Git Worktree 2.0**: Improved performance for massive parallelization (>10 workers).
281
236
 
282
237
  ---
238
+ <details>
239
+ <summary><b>📈 Star History</b></summary>
283
240
 
284
- ## 🚀 Testing & Contribution
285
-
286
- We utilize **London School TDD** with behavioral verification.
287
-
288
- ```bash
289
- # Run unit boundaries
290
- npm run test:unit
241
+ <div align="center">
242
+ <a href="https://star-history.com/#sir-ad/nexus-prime&Timeline">
243
+ <picture>
244
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=sir-ad/nexus-prime&type=Timeline&theme=dark" />
245
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=sir-ad/nexus-prime&type=Timeline" />
246
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=sir-ad/nexus-prime&type=Timeline" />
247
+ </picture>
248
+ </a>
249
+ </div>
291
250
 
292
- # Test Swarm Byzantine Consensus simulation
293
- npm run test:consensus
251
+ </details>
294
252
 
295
- # Start the interactive UI testbed
296
- npm run test:ux
297
- ```
253
+ <br>
298
254
 
299
- **License:** MIT
300
- **Maintainers:** The Nexus Prime Protocol Consortium
255
+ <div align="center">
256
+ <strong>License:</strong> MIT <br>
257
+ <strong>Maintainers:</strong> The Nexus Prime Protocol Consortium
258
+ </div>
@@ -9,6 +9,7 @@ export declare class MCPAdapter implements Adapter {
9
9
  private nexusRef?;
10
10
  private telemetry;
11
11
  private sessionDNA;
12
+ private box;
12
13
  constructor();
13
14
  setNexusRef(nexus: NexusPrime): void;
14
15
  private setupToolHandlers;
@@ -1 +1 @@
1
- {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/mcp.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgK5C,qBAAa,UAAW,YAAW,OAAO;IACtC,IAAI,SAAS;IACb,IAAI,EAAG,KAAK,CAAU;IACtB,SAAS,UAAS;IAClB,MAAM,EAAE,MAAM,EAAE,CAAM;IAEtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,UAAU,CAAoB;;IAWtC,WAAW,CAAC,KAAK,EAAE,UAAU;IAI7B,OAAO,CAAC,iBAAiB;YAoUX,cAAc;IA6wB5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC,OAAO,CAAC,IAAI;IAmBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IACnD,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;CAC1C"}
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/mcp.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAsK5C,qBAAa,UAAW,YAAW,OAAO;IACtC,IAAI,SAAS;IACb,IAAI,EAAG,KAAK,CAAU;IACtB,SAAS,UAAS;IAClB,MAAM,EAAE,MAAM,EAAE,CAAM;IAEtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,UAAU,CAAoB;IAEtC,OAAO,CAAC,GAAG;;IAkBX,WAAW,CAAC,KAAK,EAAE,UAAU;IAI7B,OAAO,CAAC,iBAAiB;YAgWX,cAAc;IAo0B5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC,OAAO,CAAC,IAAI;IAmBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IACnD,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;CAC1C"}