Skip to content

Commit 4f2a455

Browse files
committed
Update DESIGN.md to remove versioning details and streamline section headings
1 parent cb87e52 commit 4f2a455

1 file changed

Lines changed: 8 additions & 11 deletions

File tree

DESIGN.md

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,5 @@
11
# CORTEX Design Specification
22

3-
**Version:** 1.3
4-
**Last Updated:** 2026-03-14
5-
63
## Executive Summary
74

85
CORTEX (**C**lustered **O**ntic **R**outing **T**hrough **E**ntangled e**X**changes) is a neurobiologically inspired, fully on-device episodic memory engine for autonomous agents. It runs 100% in the browser with no servers, no cloud, and no telemetry. All memory stays local and private.
@@ -699,7 +696,7 @@ Ingest must remain fast and lightweight. At ingest time only two classes of edge
699696
Full cross-edge reconnection is intentionally deferred: Daydreamer walks the graph during idle passes to build additional edges — connections we never noticed at ingest time — and strengthens or prunes them via LTP/LTD. This keeps ingest cost sublinear while converging to a well-connected graph over time.
700697

701698
**IndexedDB Schema Upgrade Strategy:**
702-
During early development (pre-v1.0) the schema upgrade path intentionally drops and recreates object stores rather than migrating data. This keeps upgrade code minimal and avoids cruft until the data model stabilises. The neighbor graph is rebuilt from scratch after any ingest replay.
699+
The schema upgrade path intentionally drops and recreates object stores rather than migrating data. This keeps upgrade code minimal and avoids cruft until the data model stabilises. The neighbor graph is rebuilt from scratch after any ingest replay.
703700

704701
## Consolidation Design
705702

@@ -778,7 +775,7 @@ Keep cryptographic service separate from routing/storage concerns. All hashing/s
778775
- Benchmark race (small batch inference)
779776
- Telemetry-informed hint (cached winner from previous session)
780777

781-
### Performance Budgets (v1 Targets)
778+
### Performance Budgets
782779

783780
| Operation | Target | Hardware Assumption |
784781
|-----------|--------|---------------------|
@@ -802,22 +799,22 @@ All operations must complete on WASM fallback, albeit slower. The resident hotpa
802799

803800
## System Boundaries
804801

805-
### In Scope for v1
802+
### In Scope
806803
- On-device ingest, query, consolidation, persistence
807804
- Multi-backend vector compute (`webgpu`, `webgl`, `webnn`, `wasm`)
808805
- Signed graph entities with hash verification
809806
- Sparse semantic neighbor graph for coherence routing
810807
- Smart interest sharing: opt-in signed subgraph exchange over P2P with pre-share eligibility filtering
811808

812-
### Out of Scope for v1
809+
### Out of Scope
813810
- Full production-grade distributed consensus
814811
- Cross-device key escrow or account systems
815812
- Large-scale multi-tenant synchronization services
816813
- Raw, unfiltered whole-graph export
817814

818-
### Smart Sharing Guardrails (v1 Required)
815+
### Smart Sharing Guardrails
819816

820-
Smart sharing is a core capability, not a post-v1 extra. The v1 exchange path must:
817+
Smart sharing is a core capability. The exchange path must:
821818

822819
- Share only user-opted, public-interest graph sections (topic slices), not identity-bearing personal traces
823820
- Run an eligibility classifier pass before export to block PII/person-specific leakage
@@ -884,7 +881,7 @@ relative to frozen c. Planned module: `cortex/MetroidBuilder.ts`.
884881
| `onnx-community/embeddinggemma-300m-ONNX` | 128 | Smallest supported Matryoshka sub-dimension |
885882
| `nomic-ai/nomic-embed-text-v1.5` | 64 | To be added when nomic provider is wired |
886883

887-
**Enforcement:** `npm run guard:model-derived` scans for violations before CI merge. The guard now checks for `matryoshkaProtectedDim` in addition to the standard embedding dimension and context length fields.
884+
**Enforcement:** `npm run guard:model-derived` scans for violations before CI merge. The guard checks for `matryoshkaProtectedDim` in addition to the standard embedding dimension and context length fields.
888885

889886
## Policy-Derived Constants
890887

@@ -905,7 +902,7 @@ A parallel class of constants governs the Williams Bound hotpath architecture. T
905902

906903
**Enforcement:** Policy constants must not be hardcoded outside `core/HotpathPolicy.ts`. A companion guard or ESLint rule prevents silent duplication.
907904

908-
## Future Directions (Post-v1)
905+
## Future Directions
909906

910907
- **Federated Sharing Optimization** — Better peer-ranking, deduplication, and prioritization for high-signal interest updates
911908
- **Advanced Consolidation** — More sophisticated LTP/LTD policies

0 commit comments

Comments
 (0)