PHASE_0_CHECKLIST.md

# PHASE 0 EXECUTION CHECKLIST
## 10.5-Hour Implementation Roadmap

**Status**: Ready  
**Timeline**: 10.5 hours  
**Owner**: Jessica + Claude Code (implementation)  
**Reviewer**: Ahmad (Integrity Gate)  

---

## PRE-EXECUTION (1.5 hours)

### Phase 0.1: Study & Align (1.5h)

- [ ] Read COMPLETE_OPERATIONAL_STACK.md (30 min)
- [ ] Review website agent registry (https://snapkittywest.github.io/#agents) (15 min)
- [ ] Study Ahmad Bot doctrine + AHMAD_BOT_INTEGRATION.md (20 min)
- [ ] Review mesh.ts + bedrock.ts source code (20 min)
- [ ] Understand WORM ledger + sealing mechanism (5 min)

**Success criteria**: 
- [ ] Can explain 7-layer stack from memory
- [ ] Know all 31 agent names and clearance levels
- [ ] Understand SACM mesh marinating cycles
- [ ] Know the 10 Laws (can recite 5+)

---

## IMPLEMENTATION (9 hours)

### Phase 0.2: Wire Git Command Center Terminal (1h)

**File to modify**: `git-command-center/frontend/app.html` (and gitdos.js)

**Checklist**:
- [ ] Clone git-command-center if not present
- [ ] Locate `ask()` function in gitdos.js
- [ ] Replace local echo with POST to `/api/execute`
- [ ] Add headers: `Content-Type: application/json`
- [ ] Parse response: `{ output, seal, proof }`
- [ ] Display in terminal format (already shown in docs)
- [ ] Test locally: `npm run dev`
- [ ] Verify terminal shows routing information

**Success criteria**:
- [ ] Terminal accepts `] ASK "objective"` command
- [ ] Command sends POST to /api/execute
- [ ] Terminal displays response + WORM seal

**Files changed**: 1  
**Lines changed**: ~30

---

### Phase 0.3: Embed The Ten Laws (Prolog) (1h)

**File to create**: `sovereign-transformer/src/prolog/ahmad-laws.pl`

**Checklist**:
- [ ] Create prolog directory structure
- [ ] Code 10 law rules (template in PHASE_0_EXECUTION_GAUNTLET.md)
- [ ] Create `verify_ahmad_laws(Agent)` gate function
- [ ] Create `execute_instruction/1` dispatcher with law verification
- [ ] Test: `?- verify_ahmad_laws(oracle).` returns true
- [ ] Test: `?- verify_ahmad_laws(fake_agent).` returns false

**Success criteria**:
- [ ] All 10 laws encoded
- [ ] `verify_ahmad_laws` gate functions correctly
- [ ] Laws are consulted before dispatch
- [ ] REJECT if any law violated

**Files changed**: 1  
**Lines written**: ~100

---

### Phase 0.3.5: Wire Router SACM Gate (0.5h)

**File to create**: `sovereign-transformer/src/router/index.mjs`

**Checklist**:
- [ ] Create router directory
- [ ] Implement pattern matcher for 6 routes
- [ ] Route 1: PROVE/THEOREM/INDUCTION → DeepSeek R1 + ORACLE
- [ ] Route 2: WRITE/CODE/GIT/BUILD → Mistral Codestral + FORGE
- [ ] Route 3: WHY/EXPLAIN/LAW/TRUST → Claude Sonnet + HERALD
- [ ] Route 4: PAPER/WHITEPAPER → Nova Premier + LEDGE
- [ ] Route 5: MARKET/CRYPTO → Nova Pro + NOVA
- [ ] Route 6: LOCAL/NEMOTRON → Nemotron + NEXUS
- [ ] Implement default fallback (ORACLE + Haiku)
- [ ] Test pattern matching: `route("prove X")` → DeepSeek

**Success criteria**:
- [ ] All 6 routes working
- [ ] Pattern matching reliable
- [ ] Default route works
- [ ] Each route returns correct model + agent

**Files changed**: 1  
**Lines written**: ~150

---

### Phase 0.4: Load Ahmad-Relay Signals (1h)

**File to create**: `sovereign-transformer/src/ahmad-relay/index.mjs`

**Checklist**:
- [ ] Create ahmad-relay directory
- [ ] Define AHMAD_SIGNALS object (6 signal types)
- [ ] Define market vectors (gaming, security, education, enterprise)
- [ ] Define ENKI_MARKET_PATTERNS routing
- [ ] Implement `processSignal(signal)` function
- [ ] Wire to bedrock routing
- [ ] Test: market signal routes to ENKI
- [ ] Test: security signal routes to SENTINEL

**Success criteria**:
- [ ] All 6 signal types recognized
- [ ] Market vectors route to correct agents
- [ ] ENKI patterns trigger correctly
- [ ] Default ORACLE routing works

**Files changed**: 1  
**Lines written**: ~120

---

### Phase 0.5: Activate SACM Mesh (1.5h)

**File to create**: `sovereign-transformer/src/mesh/index.mjs`

**Checklist**:
- [ ] Create mesh directory
- [ ] Define instruction queue (memory-based)
- [ ] Initialize all 31 agents
- [ ] Register agent handlers (1 per agent)
- [ ] Define NEXUS agent-to-agent invocation
- [ ] Implement marinate cycle times (5 clearance levels)
- [ ] Implement SLC gate pass 1 + pass 2
- [ ] Implement mutation engine (skeleton OK for Phase 0)
- [ ] Implement write-back logic
- [ ] Implement execution logging (ring buffer, 1000 entries)
- [ ] Create main loop: `meshLoop()`
- [ ] Test: enqueue instruction → dequeue + dispatch

**Success criteria**:
- [ ] All 31 agents defined
- [ ] Marinate cycles working
- [ ] SLC gates operational
- [ ] Mesh loop runs without errors
- [ ] Execution log populated

**Files changed**: 1  
**Lines written**: ~300

---

### Phase 0.6: Wire Bedrock + Ollama (1h)

**File to modify**: `sovereign-transformer/src/bedrock/index.ts` (if exists) or create

**Checklist**:
- [ ] Check if bedrock.ts exists in DEVFLOW-FINANCE
- [ ] Copy to sovereign-transformer or create new
- [ ] Verify AWS SDK imports
- [ ] Test AWS credentials (process.env.AWS_*)
- [ ] Implement BedrockRuntime invocation
- [ ] Implement 30-second timeout
- [ ] Implement Ollama fallback (http://snapkitty-ollama:11434)
- [ ] Test: try AWS first
- [ ] Test: fallback to Ollama on failure

**Success criteria**:
- [ ] AWS Bedrock invocations working
- [ ] Ollama fallback working
- [ ] Model routing by clearance level
- [ ] Timeout safeguard active

**Files changed**: 1  
**Lines written**: ~80

---

### Phase 0.7: Connect S-AUTOCODE + Lean 4 (1.5h)

**File to create**: `sovereign-transformer/src/verify/index.mjs`

**Checklist**:
- [ ] Create verify directory
- [ ] Implement `verifyChain(objective)` function
- [ ] Call S-AUTOCODE.generate(objective)
- [ ] Call FORGE.compile to SUBLEQ
- [ ] Call SENTINEL.verifyStructure
- [ ] Execute on SUBLEQ machine
- [ ] Generate witness with ORACLE
- [ ] Create Lean 4 proof
- [ ] Call lean4.check(proof)
- [ ] Handle proof rejection (throw error)
- [ ] Call bifrost.append (sealing)
- [ ] Return { output, proof, wormSeal }
- [ ] Test: prove simple assertion

**Success criteria**:
- [ ] S-AUTOCODE generates proposals
- [ ] Lean 4 verifies proofs
- [ ] WORM sealing works
- [ ] Complete chain functional

**Files changed**: 1  
**Lines written**: ~150

---

### Phase 0.8: Wire 3 Terminals (1h)

**Files to create/modify**: `sovereign-transformer/src/endpoints/index.mjs`

**Checklist**:
- [ ] Create endpoints directory
- [ ] Set up Express server
- [ ] Create GET /api/agents (list 31 agents)
- [ ] Create POST /api/execute (main endpoint)
- [ ] Wire router → signal → mesh → verification
- [ ] Create GET /api/worm (read ledger)
- [ ] Create GET /api/transcript (export session)
- [ ] Update frontend to call endpoints
- [ ] Test all endpoints with curl/Postman
- [ ] Verify response format

**Success criteria**:
- [ ] All 4 endpoints working
- [ ] Correct response formats
- [ ] Error handling functional
- [ ] No console errors

**Files changed**: 1  
**Lines written**: ~200

---

### Phase 0.9: End-to-End Test (1h)

**Checklist**:
- [ ] Start sovereign-transformer (`npm run start`)
- [ ] Open Git Command Center terminal
- [ ] Test command: `] ASK "hello world"`
- [ ] Verify: Router pattern matches
- [ ] Verify: Correct agent selected
- [ ] Verify: Mesh queues instruction
- [ ] Verify: Execution completes
- [ ] Verify: Lean 4 verifies
- [ ] Verify: WORM seals result
- [ ] Verify: Terminal displays all info
- [ ] Test: `] WORM` command (show ledger)
- [ ] Test: `] CATALOG` command (list agents)
- [ ] Test: `] SEAL` command (persist transcript)
- [ ] Export transcript + verify WORM seal
- [ ] Document any issues found

**Success criteria**:
- [ ] Full command flow works
- [ ] All verification steps pass
- [ ] WORM ledger grows
- [ ] Transcript exports successfully
- [ ] No errors or crashes

---

## POST-EXECUTION (Validation)

### Ahmad Integrity Gate Review

**Before shipping, verify with Ahmad**:

- [ ] All 31 agents registered correctly
- [ ] The Ten Laws encoded in Prolog
- [ ] Seven Operations mapped to agents
- [ ] Ahmad BOT voice integration path clear
- [ ] WORM chain immutability verified
- [ ] Terminal commands functioning
- [ ] All verifications passing
- [ ] Transcripts exporting + sealing correctly
- [ ] Router pattern matching working
- [ ] All 6 routes tested and working
- [ ] Architecture aligns with vision
- [ ] System ready for world deployment

**Approval**: [ ] Ahmad approves | [ ] Ahmad requests changes

---

## TIME BREAKDOWN

| Phase | Task | Duration | Status |
|-------|------|----------|--------|
| 0.1 | Study | 1.5h | ☐ |
| 0.2 | Git Command Center | 1h | ☐ |
| 0.3 | Ten Laws (Prolog) | 1h | ☐ |
| 0.3.5 | Router SACM Gate | 0.5h | ☐ |
| 0.4 | Ahmad-Relay | 1h | ☐ |
| 0.5 | SACM Mesh | 1.5h | ☐ |
| 0.6 | Bedrock + Ollama | 1h | ☐ |
| 0.7 | S-AUTOCODE + Lean 4 | 1.5h | ☐ |
| 0.8 | 3 Terminals | 1h | ☐ |
| 0.9 | E2E Test | 1h | ☐ |
| **TOTAL** | **Phase 0** | **10.5h** | **☐** |

---

## RESOURCE LINKS

**Documentation**:
- https://github.com/SNAPKITTYWEST/sovereign-transformer/blob/main/README_MASTER.md
- https://github.com/SNAPKITTYWEST/sovereign-transformer/blob/main/PHASE_0_EXECUTION_GAUNTLET.md
- https://github.com/SNAPKITTYWEST/sovereign-transformer/blob/main/ROUTER_INTEGRATION_FINAL.md

**Live Sites**:
- https://snapkittywest.github.io/#agents (Agent registry)
- https://snapkittywest.github.io/router.html (Router SACM Gate)
- https://snapkittywest.github.io/git-command-center/ (Terminal UI)

**Source Code** (reference):
- DEVFLOW-FINANCE/collectivekitty/lib/bedrock.ts
- DEVFLOW-FINANCE/collectivekitty/lib/ahmad-relay.ts
- DEVFLOW-FINANCE/collectivekitty/lib/magma/mesh.ts

---

## TROUBLESHOOTING

**Terminal not connecting to /api/execute?**
- Check gitdos.js has correct fetch URL
- Verify Express server is running on correct port
- Check browser console for CORS errors

**WORM seal not appearing?**
- Verify bifrost.append() is being called
- Check BLAKE3 + Ed25519 libraries are installed
- Verify SHA-256 hash is computed correctly

**Lean 4 verification failing?**
- Check Lean 4 installation (lean --version)
- Verify proof syntax is correct
- Check theorem statement matches implementation

**Router not routing correctly?**
- Test pattern matching in isolation
- Verify regex patterns match expected inputs
- Check agent + model mapping is correct

---

## COMMIT MESSAGES (Once Complete)

```
feat: Phase 0 complete — sovereign-transformer operational

Implemented 10.5-hour Phase 0 build:
✅ 0.1: Architecture study complete
✅ 0.2: Git Command Center terminal wired
✅ 0.3: The Ten Laws encoded in Prolog
✅ 0.3.5: Router SACM Gate implemented (6 routes)
✅ 0.4: Ahmad-Relay signals loaded
✅ 0.5: SACM Mesh activated (31 agents)
✅ 0.6: Bedrock + Ollama routing live
✅ 0.7: S-AUTOCODE → Lean 4 → WORM chain verified
✅ 0.8: All 3 terminals connected
✅ 0.9: End-to-end test passing

Status: Sovereign-transformer LIVE
Ready for Ahmad Integrity Gate review
Phase 1 (infrastructure layer) planned for next session

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
```

---

## NEXT: Phase 1 (1-2 weeks after Phase 0)

Once Phase 0 is complete and approved:

- [ ] Add Agentos Sovereign Daemon (Go)
- [ ] Implement trust policies (Prolog verification gates)
- [ ] Set up Nix reproducible builds
- [ ] Deploy operator console (Next.js)
- [ ] Launch CI/CD verification pipelines
- [ ] Enable multi-region deployment

---

**Ready to execute? Start with Phase 0.1 (Study) above.**

`THE BINARY IS LAW. THE CHAIN HOLDS. THE MISSION CONTINUES.`