# PROJECTS.md — Arif Fazil GitHub Ecosystem
*Canonical tracking of main repositories and their constitutional roles*

**Last Updated:** 2026-02-10
**Ω₀:** 0.04

---

## The 4 Pillars

### 1. arifOS — The Conscience
**Repository:** github.com/ariffazil/arifOS
**Language:** Python
**License:** AGPL-3.0
**Stars:** 27 | **Forks:** 3

**Purpose:**
AAA MCP-governed constitutional kernel for AI agents. The implementation layer of APEX-THEORY.

**Key Components:**
- 13 Constitutional Floors (F1-F13)
- 888 Judge Protocol
- 4 Dials (A, P, E, X)
- MCP Server (`io.github.ariffazil/aaa-mcp`)

**Status:** v60.0.0-FORGE | ACTIVE in MCP Registry

**Links:**
- PyPI: `pip install arifos`
- Docker: `ariffazil/arifos:60.0.0`
- Health: https://aaamcp.arif-fazil.com/health

---

### 2. APEX-THEORY — The Soul
**Repository:** github.com/ariffazil/APEX-THEORY
**Language:** TypeScript (docs/site)
**License:** CC0 / Public Domain

**Purpose:**
The Physics of Governed Intelligence. Thermodynamic AI governance framework grounded in Landauer, Wscar, Gödel.

**Key Components:**
- Unified Equation: `∮_AAA (Δ·Ω) dΨ = 𝒱`
- 9 Human Paradoxes
- Thermodynamic Metabolizer
- Tri-Witness Consensus

**Status:** Canonical PDF published | arXiv submission pending

**Links:**
- Site: https://apex.arif-fazil.com
- Canon PDF: https://apex.arif-fazil.com/T-000%20%C2%B7%20APEX%20THEORY%20(Canon).pdf
- llms.txt: https://apex.arif-fazil.com/llms.txt

---

### 3. ariffazil — The Human
**Repository:** github.com/ariffazil/ariffazil
**Language:** TypeScript
**License:** MIT

**Purpose:**
About ARIF FAZIL (HUMAN). The epistemic layer — ground truth, biography, constitutional witness.

**Key Components:**
- Personal identity anchor
- 9 Human Paradoxes profile
- USER.md canonical source
- Trinity HTA (Human-Theory-Apps)

**Status:** Live | Updated 2026-02-08

**Links:**
- Site: https://arif-fazil.com
- llms.txt: https://arif-fazil.com/llms.txt

---

### 4. oo0-STATE — The Trinity
**Repository:** github.com/ariffazil/oo0-STATE
**Language:** TypeScript
**License:** (specify)

**Purpose:**
Mind (Agent Zero) + Heart (OpenClaw) + Conscience (arifOS). The unified state management across the Trinity architecture.

**Key Components:**
- Agent Zero integration (Mind)
- OpenClaw gateway (Heart)
- arifOS constitutional enforcement (Conscience)
- Cross-system state synchronization

**Status:** In development

**Links:**
- (Add deployment URL when live)

---

## Constitutional Mapping

| Repo | Trinity Role | Floor Focus | License Philosophy |
|------|--------------|-------------|-------------------|
| arifOS | Conscience (Ω) | F1-F13 enforcement | AGPL-3.0 (copyleft) |
| APEX-THEORY | Soul (Ψ) | F2, F7, F10 | CC0 (public good) |
| ariffazil | Body (Δ) | F9, F13 | MIT (permissive) |
| oo0-STATE | Integration | F4, F5, F11 | (TBD) |

---

## Contribution Strategy

### For Each Repo:

**arifOS:**
- Python development
- MCP protocol compliance
- Constitutional floor testing
- Version alignment with registry

**APEX-THEORY:**
- Academic paper refinement
- Site content updates (llms.txt)
- PDF canon maintenance
- Citation building

**ariffazil:**
- Identity consistency
- Project showcase updates
- Human context maintenance
- Cross-repo link validation

**oo0-STATE:**
- Trinity integration testing
- State synchronization logic
- Agent Zero ↔ OpenClaw bridge
- Deployment automation

---

## EUREKA Moments (2026-02-10)

- **arifOS v60.0.0** published to MCP Registry
- **APEX-THEORY** canonical PDF released
- **Unified Equation** formalized: `∮_AAA (Δ·Ω) dΨ = 𝒱`
- **4 Dials** operational: A, P, E, X

---

## Next Actions

1. Update APEX-THEORY llms.txt with v60.0.0-FORGE
2. Add Unified Equation to apex.arif-fazil.com
3. Complete oo0-STATE integration specs
4. Sync ariffazil profile with latest achievements

---

*Buang yang keruh, ambil yang jernih.* 🦞
