|
1 | | -# 🧠 Project Status & Brain Dump Staging |
| 1 | +# 🧠 QuanuX Project Spine & Status |
2 | 2 |
|
3 | 3 | **Project Board**: [Road to v0.0.1](https://github.com/orgs/quantDIY/projects/2) |
4 | 4 |
|
5 | | -> **Protocol**: |
| 5 | +> **Protocol**: The Spine serves as the absolute master map of the QuanuX Ecosystem history, architectural laws, and active deployment targets. |
6 | 6 | > 1. **Brain Dump**: User adds raw thoughts/requests here or via chat. |
7 | 7 | > 2. **Staging**: Agent processes thoughts into "Staged Issues" below. |
8 | 8 | > 3. **Sync**: Agent executes `gh issue create` and moves items to "Active Issues". |
9 | 9 |
|
| 10 | +## 🏗️ The Core Topology (Habitats & Nests) |
| 11 | +- **Habitat**: The physical or virtual OS boundary (e.g., Ubuntu VM, bare-metal server). The conditioned soil. |
| 12 | +- **Nest**: The sovereign logic process deployed into the Habitat. |
| 13 | + |
| 14 | +**The 5-Tier System Boundary:** |
| 15 | +1. **Tier 1: The Server (Command Center)**: Orchestrates Nests. Uses Python (`quanuxctl`, `nats-py`). |
| 16 | +2. **Tier 2: Polyglot Nests**: AI strategy labs. Uses C++, Python, Cython, Golang. Networking: CNATS or ZMQ (local). |
| 17 | +3. **Tier 3: Bare-Metal Nests (59ns)**: High-speed stats. Bare-metal Linux, isolated cores. Pure C++. Python strictly forbidden. Networking: CNATS telemetry, standard Linux networking execution. |
| 18 | +4. **Tier 4: The Fiber Nests**: Pure hardware warfare (Full HFT). Exchange colocation. Pure C++. Python strictly forbidden. Networking: Solarflare EF_VI (raw DMA)/onload. |
| 19 | +5. **Tier 5: The Global Swarm**: Interconnected arbitrage (Microwave/mm-wave). |
| 20 | + |
| 21 | +## 📜 The AI Governance Law |
| 22 | +- **Decentralized Context**: AI ecosystem memory has migrated from JSON to Markdown (`*skill.md`) across the repository. |
| 23 | +- **The Prime Directive**: [00_PRIME_DIRECTIVE.md](file:///Users/Duncan/Antigravity/QuanuX/QuanuX/00_PRIME_DIRECTIVE.md) enforces that AI agents must recursively ingest localized `.md` rules before code execution. Divergence from these codified physical laws is strictly forbidden. |
| 24 | + |
| 25 | +## 🧬 The True Sovereign Lifecycle & Patches |
| 26 | +The physical deployment pipeline engineered for Tier 2-4 Edge Nodes: |
| 27 | +- **The NATS Handshake**: IPC via port 4222 for dynamic Collision Matrix sync (dynamic NACK/ACK). |
| 28 | +- **Out-of-Band (OOB) Payload Transfer**: Background threads executing IPv4-bound `libcurl` bypassing asymmetric NAT routing traps. |
| 29 | +- **The Permission Reality**: POSIX `chmod()` integration dynamically writing execution capabilities to `.run_<payload>.sh`. |
| 30 | +- **The Conditioned SSH Execution Wrapper**: Executing payload over Secure Shell, not automated system calls. |
| 31 | +- **CMake FetchContent Isolation**: Complete purge of macOS/Homebrew assumptions, restoring bare-metal Linux purity and bypassing `protoc` cross-compilation errors. |
| 32 | +- **Linux Security Execution Blocks**: Bypassed Git `safe.directory` user-namespace drops and linked required `libssl-dev` dependencies natively. |
| 33 | + |
| 34 | +## 🛡️ The Hardware Quarantine (The Affinity Mandate) |
| 35 | +- All dynamically spawned C++ threads (e.g., asynchronous OOB `libcurl` downloads in the Native Envoy) must instantaneously execute `pthread_setaffinity_np` locking themselves to Management Core 0. This unconditionally preserves the kinetic trading cores from OS thread-schedule thrashing. |
| 36 | + |
| 37 | +## 🖥️ The OS Verification Mandate |
| 38 | +- Staging and deployment physics are strictly bound to the **Ubuntu 22.04 LTS (Jammy Jellyfish)** baseline. |
| 39 | +- Assorted NAT routing phenomena, VirtualBox UFW limitations, and Linux kernel execution behaviors have been comprehensively documented against this verified baseline ecosystem. |
| 40 | + |
10 | 41 | ## 📥 Staged Issues (Ready for GitHub) |
11 | 42 | *Items parsed from chat/docs, waiting for user approval to push.* |
12 | 43 |
|
|
37 | 68 | - [x] [Documentation: Deep Man Page Updates] `label:documentation` |
38 | 69 |
|
39 | 70 | ### Verified / Done |
| 71 | +- [x] [Security: Patched Vulnerabilities] Resolved High-Severity ReDoS and Path Traversal alerts in `rollup`, `minimatch`, and `hono` via root workspace `pnpm.overrides`. |
| 72 | +- [x] [Infrastructure: Decentralized Codex] Forged `00_PRIME_DIRECTIVE.md` and eradicated all legacy JSON artifacts for semantic Markdown architecture. |
40 | 73 | - [x] [Testing: Confirm functionality of Figma MCP server with QuanuX MCP](https://github.com/quantDIY/QuanuX/issues/2) `label:testing` |
41 | 74 | - [x] [Architecture: Polyglot Extensions] Established `extensions/{cpp,go,node,python}` structure. |
42 | 75 | - [x] [Architecture: Cython Migration] Converted `indicators`, `tws_api`, `databento`, `duckdb`, `rithmic`, `topstep` to Cython (7x perf boost). |
|
0 commit comments