1  # TECHNICAL MANUAL: DISTRIBUTED MEMORY SUBSYSTEM
   2  **COMMAND AUTHORITY:** CHIEF ARCHITECT (SHUBHAM)  
   3  **EFFECTIVE DATE:** 2026-11-08  
   4  
   5  ---
   6  
   7  ### 1.0 ARCHITECTURAL FRAMEWORK & SPECIFICATIONS
   8  The NeuralOS Memory Subsystem utilizes a bi-zonal architecture ensuring cognitive immortality independent of model deprecation, host reboots, or hardware maintenance.
   9  
  10  ```
  11  ┌────────────────────────────────────────────────────────────────────────┐
  12  │                      COGNITIVE MEMORY HIERARCHY                        │
  13  ├────────────────────────────────────────────────────────────────────────┤
  14  │  TIER 0: VOLATILE REGISTER (In-Flight Context Buffer)                  │
  15  │    • Host: Active Master Node (Apple Silicon Unified Memory)           │
  16  │    • Scope: Active 8K-32K Token Conversation Context & Working Cache   │
  17  ├────────────────────────────────────────────────────────────────────────┤
  18  │  TIER 1: EPISODIC & SEMANTIC NON-VOLATILE CORE (Internal Solid-State)  │
  19  │    • Host: Tactical Body (Anchor: /var/neural_memory/ on /dev/sda3)    │
  20  │    • Database Engine: SQLite3 (data/memory.db) with WAL Journaling     │
  21  │    • Schema Domains: identity, facts, episodes, skills                 │
  22  ├────────────────────────────────────────────────────────────────────────┤
  23  │  TIER 2: MASS STORAGE & CORPUS RETENTION (High-Capacity Auxiliary)     │
  24  │    • Host: Tactical Body (Mount: /mnt/hdd1 on /dev/sdb1)               │
  25  │    • Content: Vector Embeddings (ChromaDB), Model Weights, Datasets    │
  26  │    • Mount Directive: Automount via /etc/fstab (nofail)                │
  27  └────────────────────────────────────────────────────────────────────────┘
  28  ```
  29  *(For physical hardware specifications and drive metrics, see [dell-ss_spec.md](dell-ss_spec.md).)*
  30  
  31  ---
  32  
  33  ### 2.0 RELATIONAL SCHEMAS (`/var/neural_memory/data/memory.db`)
  34  
  35  ```sql
  36  -- Core Identity Registry
  37  CREATE TABLE identity (
  38      key TEXT PRIMARY KEY,
  39      value TEXT
  40  );
  41  
  42  -- Factual State Knowledgebase
  43  CREATE TABLE facts (
  44      id INTEGER PRIMARY KEY AUTOINCREMENT,
  45      category TEXT NOT NULL,
  46      subject TEXT NOT NULL,
  47      content TEXT NOT NULL,
  48      timestamp TEXT NOT NULL
  49  );
  50  
  51  -- Operational History & Incident Debriefs
  52  CREATE TABLE episodes (
  53      id INTEGER PRIMARY KEY AUTOINCREMENT,
  54      title TEXT NOT NULL,
  55      context TEXT,
  56      actions TEXT,
  57      outcome TEXT,
  58      timestamp TEXT NOT NULL
  59  );
  60  
  61  -- Reusable Procedural Tooling
  62  CREATE TABLE skills (
  63      name TEXT PRIMARY KEY,
  64      trigger TEXT NOT NULL,
  65      command_template TEXT NOT NULL,
  66      description TEXT
  67  );
  68  ```
  69  
  70  ---
  71  
  72  ### 3.0 INVENTORY OF CORE RETENTION ARTIFACTS
  73  Initial Operational Capability (IOC) seeded baseline records into `/var/neural_memory/data/memory.db`:
  74  
  75  | Entity Index | Category | Subject / Identifier | Status |
  76  | :--- | :--- | :--- | :--- |
  77  | **FACT-001** | `hardware` | `CPU` | Baseline Verified (See [dell-ss_spec.md](dell-ss_spec.md)) |
  78  | **FACT-002** | `hardware` | `RAM` | Baseline Verified (See [dell-ss_spec.md](dell-ss_spec.md)) |
  79  | **FACT-003** | `hardware` | `GPU_Discrete` | Baseline Verified (See [dell-ss_spec.md](dell-ss_spec.md)) |
  80  | **FACT-004** | `hardware` | `GPU_Integrated` | Baseline Verified (See [dell-ss_spec.md](dell-ss_spec.md)) |
  81  | **FACT-005** | `storage` | `SSD_Internal` | Baseline Verified (See [dell-ss_spec.md](dell-ss_spec.md)) |
  82  | **FACT-006** | `storage` | `Partition_Root` | Active (`/dev/sda3` @ `/`) |
  83  | **FACT-007** | `storage` | `Partition_Safe_D`| Preserved (`/dev/sda5`, ROE-01 Enforced) |
  84  | **FACT-008** | `storage` | `External_HDD` | Active (`/mnt/hdd1` via `nofail`) |
  85  | **FACT-009** | `network` | `WLAN` | Connected (`wlp8s0` to SSID `Contemplate`) |
  86  | **FACT-010** | `network` | `SSH` | Authorized (`agent` NOPASSWD root via ED25519) |
  87  | **FACT-011** | `policy` | `Power` | Configured (`HandleLidSwitch=ignore`) |
  88  | **EPISODE-001**| `genesis` | `System Genesis` | Complete Initial Deployment |
  89  
  90  ---
  91  
  92  ### 4.0 QUERY AND WRITE TELEMETRY PROTOCOL
  93  Execution interfaces are symlinked to `/usr/local/bin/` on the Tactical Body (dispatched per [SYSTEM_PROMPT.md](SYSTEM_PROMPT.md)):
  94  
  95  | Function | Binary Path | Operation | Output |
  96  | :--- | :--- | :--- | :--- |
  97  | **Recall** | `/usr/local/bin/recall` | Regex/LIKE search across facts, episodes, and skills | Matched telemetry records |
  98  | **Remember** | `/usr/local/bin/remember` | Appends validated entry with ISO 8601 UTC timestamp | Commit confirmation |
  99  | **Status** | `/usr/local/bin/node-status` | Audits memory counts, RAM utilization, and system uptime | Telemetry audit block |
 100  
 101  ---
 102  
 103  ### 5.0 FAILURE MODES & DATA SURVIVABILITY
 104  
 105  | Failure Mode | Impact | Mitigation / Recovery |
 106  | :--- | :--- | :--- |
 107  | **Model Migration / Eviction** | Zero impact on memory | Tier 1 storage is model-agnostic SQLite. New model executes `recall` to load state. |
 108  | **Auxiliary Drive Disconnection** | Non-critical | System boots cleanly without `/dev/sdb1` due to `nofail` in `/etc/fstab`. Tier 1 core memory remains functional. |
 109  | **Sudden Power Interruption** | Zero data corruption | SQLite Write-Ahead Logging (WAL) mode guarantees atomic commits against ungraceful shutdown. |
 110  | **Node Network Partition** | Temporary loss of remote C2 | Master caches context in Tier 0; reconnects and syncs upon link restoration. |
 111