Architecture Decision Records (ADRs) — Master Catalog¶
Authoritative registry of all 88 Architecture Decision Records governing Spector. Every record tracks architectural rationale, options evaluated, trade-offs accepted, and code verification against
main.
Note
The Active Inference Self-Model Engine verification report has graduated to the architecture audit section: Architecture Verification Report: Active Inference Self-Model Engine (AISME).
Master Registry (0001–0088)¶
Curated Categories¶
1. Storage, Layout & Panama FFM Substrate¶
Low-level memory alignment, zero-GC layouts, entity graphs, off-heap bundles, and storage engines:
- ADR-0001: Graph Compression Strategy for Entity Graph (
Accepted (Implemented)) - ADR-0002: Multi-Partition Recall Fan-Out & Frozen Retention (
Accepted (Implemented)) - ADR-0003: Completing Hypergraph Entity-Graph Graduation (
Accepted (Implemented)) - ADR-0004: Mmap Bundle Architecture & File Descriptor Scaling (
Accepted (Implemented)) - ADR-0005: spector-memory Technical Debt Hardening (
Accepted (Implemented)) - ADR-0042: Graph Recall Architecture and Cognitive Traversals (
Accepted (Implemented)) - ADR-0043: Single-VMA Bundle Layout Specification (
Superseded by ADR-0004) - ADR-0044: Memory Kernel Isolation, Composition, and Layout (
Accepted (Implemented)) - ADR-0045: Spector Memory Import & Export Pipeline (
Accepted (Implemented)) - ADR-0046: Single Engram, Four Stores Storage Architecture (
Accepted (Implemented)) - ADR-0047: Episodic Memory and Engram Model Hierarchy (
Accepted (Implemented)) - ADR-0057: Remediation of Hardcoded Memory Offsets and Alignment Constants (
Accepted (Implemented)) - ADR-0062: Spector Memory Organization — Three-Plane Architecture (
Accepted (Implemented)) - ADR-0082: Index Plane Lifecycle, Derived Views, and Reconciliation (
Proposed)
2. Cognitive Neuroscience, Active Inference & Dynamic Mind Simulation¶
Biological memory pathways, free-energy active inference, dynamic dreaming, associative manifolds, and speech prosody:
- ADR-0006: Episodic Conversation Architecture (
Accepted (Implemented)) - ADR-0007: ReflectPathway — Biological Sleep Consolidation (
Superseded by ADR-0074) - ADR-0008: Cognitive Substrate Evolution (TANGLE, GPM, MSCE) (
Accepted (Implemented)) - ADR-0009: AISME Phase 1 — Homeostatic Affective Core (
Accepted (Implemented)) - ADR-0010: AISME Phase 2 — Free-Energy Guided Recall (
Accepted (Implemented)) - ADR-0011: AISME Phase 3 — Modern Hopfield Associative Memory (
Accepted (Implemented)) - ADR-0012: AISME Phase 4 — Neural Manifold Distance (NMD) (
Accepted (Implemented)) - ADR-0013: AISME Phase 5 — Predictive Coding Narrative Self (
Accepted (Implemented)) - ADR-0014: AISME Phase 6 — Consciousness Continuity Metric (Phi_CC) (
Accepted (Implemented)) - ADR-0015: AISME Phase 7 — Synaptic Relay Wiring & Pathway Configuration (
Accepted (Implemented)) - ADR-0016: AISME Phase 8 — Closed-Loop Epistemic Learning (
Accepted (Implemented)) - ADR-0017: AISME Phase 9 — Generative Counterfactuals & Prior Plasticity (
Accepted (Implemented)) - ADR-0018: AISME Phase 10 — WanderPathway & Kernel Continuity Layout (
Accepted (Implemented)) - ADR-0019: AISME Phase 11 — Expected Free Energy Policy Engine (
Accepted (Implemented)) - ADR-0020: AISME Phase 12 — Continuous Self-Dynamics (
Accepted (Implemented)) - ADR-0023: AISME Complete Loop Closure & CognitiveVectorAccessor (
Accepted (Implemented)) - ADR-0024: Polymorphic SoulContext Hierarchy in AISME (
Accepted (Implemented)) - ADR-0027: Soul-Conditioned & Salience-Modulated Personalized Dreaming (
Accepted (Implemented)) - ADR-0048: Cross-Capture Graph & CoActivation Kernel (
Accepted (Implemented)) - ADR-0049: Identity Trajectory Lyapunov Stability (
Accepted (Implemented)) - ADR-0050: Event Density Gating and Dynamic Epistemic Compression (
Accepted (Implemented)) - ADR-0051: Bayesian Online Change-Point Episode Segmentation (
Accepted (Implemented)) - ADR-0052: Differential Privacy and Edge Anonymization (
Accepted (Implemented)) - ADR-0053: Multimodal Composite Importance Scoring (
Accepted (Implemented)) - ADR-0054: Lifespan-Adaptive Forgetting & Retention Kernel (
Accepted (Implemented)) - ADR-0055: LSR & RFF Dense Associative Memory Engineering Specification (
Accepted (Implemented)) - ADR-0056: Log-Sum-ReLU (LSR) & Random Fourier Features (RFF) Dense Associative Memory (
Accepted (Implemented)) - ADR-0058: Linguistic & Vocal Prosody Expression Engine (
Accepted (Implemented)) - ADR-0063: Spacetime Vector Search and Synaptic Relay Architecture (
Accepted (Implemented)) - ADR-0064: Spacetime Simulation on Wander, Dream, and Express Pathways (
Accepted (Implemented)) - ADR-0071: Remember Cognitive Pathway Architecture (
Accepted (Implemented)) - ADR-0072: Six-Phase Fused Cognitive Scoring Pipeline (
Accepted (Implemented)) - ADR-0073: Recall Cognitive Pathway and Multi-Phase Retrieval Architecture (
Accepted (Implemented)) - ADR-0074: Reflect Cognitive Pathway and Sleep Consolidation Architecture (
Accepted (Implemented)) - ADR-0078: Salience Network and Thalamic Cognitive Profiles Architecture (
Accepted (Implemented)) - ADR-0086: Procedural Skill Crystallization (
Accepted (Implemented))
3. Platform, Hardware Abstraction, Security & Synapse Services¶
Hardware Abstraction Layer (HAL), actor concurrency, clustering & cell HA, REST/gRPC gateways, MCP server integration, and client SDKs:
- ADR-0021: Nucleus Symmetric Hardware Abstraction Layer (HAL) (
Accepted (Implemented)) - ADR-0022: Embodied Kinesics & Phenomenological MCP Engine (
Accepted (Implemented)) - ADR-0025: Declarative MCP Tool Definitions via JSON Schemas (
Accepted (Implemented)) - ADR-0026: Dual-Plane Concurrency & Async Queue Backpressure (
Accepted (Implemented)) - ADR-0028: Dual-Plane Memory Audit Architecture (Separate Regions) (
Accepted (Implemented)) - ADR-0029: Episodic→Semantic Lineage Provenance Region (
Accepted (Implemented)) - ADR-0030: Unified Engram Encoding Header Architecture (
Accepted (Implemented)) - ADR-0031: Unified Configuration Architecture & Bypass Elimination (
Accepted (Implemented)) - ADR-0032: Persona Enactment — Soul as Policy over Memory (
Accepted (Implemented)) - ADR-0033: Decoupling Cognitive & Mathematical Kernels to Spector Core (
Accepted (Implemented)) - ADR-0034: Cell Topology, Namespace Ownership, and HA Clustering (
Accepted (Implemented)) - ADR-0035: Cognitive Pathway Framework Rearchitecture (
Accepted (Implemented)) - ADR-0036: Pathway Error Handling, Isolation, and Circuit Breakers (
Accepted (Implemented)) - ADR-0037: Ingestion Boundary and Sensory Relocation (
Accepted (Implemented)) - ADR-0038: SIMD-Accelerated BM25 Lexical Scoring Optimization (
Accepted (Implemented)) - ADR-0039: Robust Unified Rate Limiting Architecture (
Accepted (Implemented)) - ADR-0040: Universal Apache Camel Messaging Channels (
Accepted (Implemented)) - ADR-0041: Unified Connector Architecture for Ingestion (
Accepted (Implemented)) - ADR-0059: Java 27 Upgrade Strategy and Value Class Migration (
Proposed) - ADR-0060: Cognitive Continuity Layer and Decoded Mind Streams (
Withdrawn) - ADR-0061: In-Memory Multi-Tenant Quartz Scheduler (
Accepted (Implemented)) - ADR-0065: Client SDK Architecture, OpenAPI, and MCP Integration (
Accepted (Implemented)) - ADR-0066: Engine & CLI Stabilization — Issue #727 Hardening (
Accepted (Implemented)) - ADR-0067: Cell-Based High Availability and Namespace-Sticky Sharding (Initial Draft) (
Superseded by ADR-0034) - ADR-0068: Phileas PII Redaction Engine for Spector Synapse (
Accepted (Implemented)) - ADR-0069: Synapse-Owned Tool Access Policy (
Accepted (Implemented)) - ADR-0070: Unified Error Taxonomy and Exception Handling Architecture (
Accepted (Implemented)) - ADR-0075: Extensible LLM and Multimodal Embedding Provider SPI (
Accepted (Implemented)) - ADR-0076: Zero-Dependency Pluggable Cache Abstraction (
Accepted (Implemented)) - ADR-0077: Model B Asynchronous Task Queue and Context-Propagated Concurrency (
Accepted (Implemented)) - ADR-0079: Asynchronous Memory Event and Telemetry Notification Bus (
Accepted (Implemented)) - ADR-0080: Observed Memory and Pathway Metrics Telemetry Architecture (
Accepted (Implemented)) - ADR-0081: Dedicated Reactive Cell Ingress Router (
Accepted) - ADR-0083: Namespace-Isolated Memory Analytics and Stats Telemetry (
Proposed) - ADR-0084: Dual-Plane Conversation Persistence (
Proposed) - ADR-0085: Dynamic Synapse Configuration Overrides and SpectorMemory Runtime Propagation Architecture (
Proposed) - ADR-0087: Admin Role Model, Content-Free Admin API Contract & Break-Glass Policy (
Proposed) - ADR-0088: Bring Your Own Key (BYOK) & Per-Tenant Envelope Encryption of the Memory Store (
Proposed)