# Research Stack Knowledge Graph

## Overview
This is the central knowledge management system for the Sovereign Research Stack, a formalized system where Lean 4 is the single source of truth and all computation is Q16.16 fixed-point arithmetic.

## Quick Navigation

### 🗺️ **Map & Orientation**
- [[00-MAP/Core Concepts]] - Fundamental concepts and terminology
- [[00-MAP/System Architecture]] - High-level system architecture
- [[00-MAP/Getting Started]] - How to use this knowledge base

### 📚 **Layered Knowledge**
- [[01-LAYERS/00-Overview]] - The 7-layer USTSM model
- [[01-LAYERS/L0-Primordial]] - Pure math, fixed-point arithmetic
- [[01-LAYERS/L1-Geometric]] - Shape-aware topology
- [[01-LAYERS/L2-Biological]] - Genetic codes, spiking neurons
- [[01-LAYERS/L3-Thermodynamic]] - Energy-aware quality
- [[01-LAYERS/L4-Security]] - Attack-aware gating
- [[01-LAYERS/L5-Semantic]] - Meaning-aware filtering
- [[01-LAYERS/L6-Meta]] - Self-aware adaptation

### 🎯 **Active Research**
- [[07-RESEARCH/00-Milestones]] - Current milestones and progress
- [[07-RESEARCH/01-Attack-Plans]] - Active attack plans
- [[07-RESEARCH/02-Conjectures]] - Research conjectures
- [[07-RESEARCH/03-Experiments]] - Experimental validation

### 🔧 **Tools & Templates**
- [[08-TOOLS/01-Templates]] - Document templates
- [[08-TOOLS/02-Workflows]] - Research workflows
- [[08-TOOLS/00-Scripts]] - Automation scripts

## Current Status

### 🟢 **Active Milestone**
**Burgers 4-Theorem Attack Plan** - Implementing core theorems for Burgers equation
- [[Burgers 4-Theorem Attack Plan]] - Main attack plan document
- [[Burgers Equation Energy Dissipation Theorem]] - Theorem 1
- [[Burgers Equation CFL Stability Theorem]] - Theorem 2
- [[Burgers Equation Mass Conservation Theorem]] - Theorem 3
- [[Burgers Equation Complexity Regularization Theorem]] - Theorem 4

### 📊 **System Health**
- **Lean Build Status:** ✅ 746 modules, 3529 build jobs, 0 errors
- **Formal Proofs:** 🟡 173 TODO(lean-port) items remaining
- **Receipt Generation:** 🟢 Core receipts operational
- **Hardware Extraction:** 🟡 FPGA verification in progress

## Knowledge Graph Structure

### 🏗️ **Core Relationships**
```
Layer L0 (Primordial) ──┐
                        ├─→ Formal Proofs ──→ Receipts ──→ Hardware
Layer L1 (Geometric) ───┤
                        ├─→ Attack Plans ──→ Milestones ──→ Validation
Layer L2 (Biological) ──┤
                        └─→ Conjectures ──→ Experiments ──→ Results
...
```

### 🏷️ **Tag System**
- `#layer-L0` through `#layer-L6` - Layer classification
- `#formal-proof` - Lean formal proofs
- `#receipt` - Receipt documents
- `#attack-plan` - Research attack plans
- `#milestone` - Project milestones
- `#conjecture` - Research conjectures
- `#experiment` - Experimental validation
- `#hardware` - Hardware extraction

### 🔍 **Search Strategies**
- **By Layer:** Use `tag:#layer-LX` to find layer-specific content
- **By Type:** Use `tag:#formal-proof` for proofs, `tag:#receipt` for receipts
- **By Status:** Use `tag:#status-completed` for finished work
- **By Priority:** Use `tag:#priority-critical` for urgent items

## Recent Activity

### 📝 **Latest Updates**
- `2024-05-19` - Completed Burgers 4-Theorem Attack Plan implementation
- `2024-05-19` - Added Energy Dissipation theorem with receipt generation
- `2024-05-19` - Updated Obsidian vault structure

### 🔄 **Currently In Progress**
- Lean formal proof completion (173 TODO items)
- Hardware extraction path verification
- Receipt system integration testing

## Community & Collaboration

### 👥 **Contributors**
- [[Research Lead]] - Overall research direction
- [[Formal Methods Team]] - Lean proof development
- [[Hardware Team]] - FPGA implementation
- [[Validation Team]] - Receipt generation and testing

### 📋 **Review Process**
1. **Self-Review** - Author review
2. **Peer Review** - Team member review
3. **Expert Review** - Domain expert review
4. **Formal Verification** - Lean compilation and proof checking

## External Links

### 📚 **Reference Materials**
- [Lean 4 Documentation](https://lean-lang.org/)
- [Q16.16 Fixed-Point Arithmetic](https://en.wikipedia.org/wiki/Q_(number_format))
- [Formal Methods Wiki](https://en.wikipedia.org/wiki/Formal_methods)

### 🔗 **Related Projects**
- [[Mathlib4]] - Lean mathematical library
- [[FAMM]] - Frustration-avoiding memory management
- [[USTSM]] - Universal Substrate Topological State Machine

---

*This knowledge base is continuously evolving. Last updated: <% tp.date.now('YYYY-MM-DD') %>*

#research-stack #knowledge-graph #overview