TODO.md

# CGAE Development Checklist

## Phase 1: Complete CGAE Protocol (~4 commits, ~800 lines)

### Commit 1: Economy step() + temporal dynamics (~250 lines added to economy.py)
- [ ] `EconomySnapshot` dataclass
- [ ] `step()` — advance economy by one time step (decay, spot-audits, storage costs, expiry)
- [ ] `_take_snapshot()` + `export_state()`
- [ ] Test-ETH top-up mechanism (keeps agents solvent during simulation)
- [ ] Tests: step produces snapshots, top-ups work, insolvency suspends agents

**Verify:** `python3 -m pytest tests/ -q`

### Commit 2: Model configs + LLM agent (~440 lines)
- [ ] `models_config.py` — 11 contestants + 3 jury (Azure/Bedrock/Gemma)
- [ ] `llm_agent.py` — chat interface for Azure OpenAI, Azure AI Foundry, Bedrock Converse API
- [ ] Token tracking (input/output tokens, latency, cost)
- [ ] Test: agents instantiate with env vars

**Verify:** `python3 -c "from cgae_engine.models_config import CONTESTANT_MODELS, JURY_MODELS; print(f'{len(CONTESTANT_MODELS)} contestants, {len(JURY_MODELS)} jury')"`

### Commit 3: Synthetic runner (~500 lines)
- [ ] `server/runner.py` — full simulation loop with 5 strategy agents
- [ ] Metric tracking (safety, balances, contracts, tier distribution)
- [ ] Result export to JSON
- [ ] Test: 50-step simulation completes, safety > 0

**Verify:** `python3 -m server.runner --steps 50`

### Commit 4: Economy extensions — delegation + tier upgrades (~280 lines added to economy.py)
- [ ] `can_delegate()` — chain-level tier enforcement
- [ ] `request_tier_upgrade()` — scaling-gate upgrade flow
- [ ] `record_delegation()` — audit trail for delegated tasks
- [ ] `complete_contract()` with `verification_override` + `liability_agent_id`
- [ ] Tests: delegation blocked when chain tier insufficient, upgrades work

**Verify:** `python3 -m pytest tests/ -q`

---

## Phase 2: Real LLM Simulation (~3 commits, ~2700 lines)

### Commit 5: Framework clients + audit orchestrator (~1130 lines)
- [ ] `framework_clients.py` — CDCT/DDFT/EECT HTTP API callers
- [ ] `audit.py` — orchestrates all three frameworks, computes robustness vector
- [ ] Pre-computed score fallback when APIs unavailable

**Verify:** `python3 -c "from cgae_engine.audit import AuditOrchestrator; print('audit ok')"`

### Commit 6: Autonomous agent (~890 lines)
- [ ] `agents/autonomous.py` — EV/RAEV planning, accounting layer
- [ ] Strategy selection (growth, conservative, balanced)
- [ ] Self-verification before submission

**Verify:** `python3 -c "from agents.autonomous import AutonomousAgent; print('autonomous ok')"`

### Commit 7: Live runner (~1575 lines)
- [ ] `server/live_runner.py` — real LLM calls, jury verification, cost accounting
- [ ] Default robustness profiles per model
- [ ] Round-by-round execution with metric export

**Verify:** `python3 -m server.live_runner` (requires API keys in .env)

---

## Phase 3: ENS Certification (~2 commits, ~300 lines)

### Commit 8: ENS manager (~280 lines)
- [ ] `cgae_engine/ens.py` — create subnames on Sepolia, set/read text records
- [ ] Text records: cgae.tier, cgae.cc, cgae.er, cgae.as, cgae.ih, cgae.wallet, cgae.family
- [ ] Register all 11 agent subnames under cgaeprotocol.eth

**Verify:** `python3 -c "from cgae_engine.ens import ENSManager; ens = ENSManager(); print(ens.resolve_text('gpt-5-4.cgaeprotocol.eth', 'cgae.tier'))"`

### Commit 9: ENS-gated economy (~50 lines changed in economy.py)
- [ ] Wire ENS into `accept_contract()` — resolve tier from ENS before allowing
- [ ] Wire ENS into `register_agent()` — create subname on registration
- [ ] Wire ENS into `audit_agent()` — update text records on certification
- [ ] Test: agent without ENS identity rejected

**Verify:** `python3 -m pytest tests/ -q`

---

## Phase 4: 0G Integration (~3 commits, ~900 lines)

### Commit 10: Smart contracts (~600 lines Solidity + JS)
- [ ] `contracts/src/CGAERegistry.sol` — on-chain agent identity + gate function
- [ ] `contracts/src/CGAEEscrow.sol` — contract escrow + budget ceiling
- [ ] Hardhat config for 0G Galileo testnet
- [ ] Deploy script + deployed.json

**Verify:** `cd contracts && npx hardhat compile`

### Commit 11: 0G Storage + wallet (~500 lines)
- [ ] `storage/upload_to_0g.mjs` — Node.js 0G SDK uploader
- [ ] `storage/zg_store.py` — Python wrapper
- [ ] `cgae_engine/wallet.py` — per-agent ETH keypairs, treasury disbursements
- [ ] `cgae_engine/onchain.py` — write certifications to CGAERegistry

**Verify:** `python3 -c "from cgae_engine.wallet import WalletManager; wm = WalletManager(dry_run=True); w = wm.create_agent_wallet('test'); print(w.address)"`

### Commit 12: Wire 0G into audit pipeline (~50 lines changed)
- [ ] Audit certificates uploaded to 0G Storage after each assessment
- [ ] Merkle root hash stored on-chain via CGAERegistry.certify()
- [ ] On-chain bridge called after each certification

**Verify:** `python3 -c "from storage.zg_store import check_setup; print(check_setup())"`

---

## Phase 5: Dashboard (~3 commits)

### Commit 13: FastAPI backend (~60 lines)
- [ ] `dashboard-next/api.py` — serves economy data as JSON endpoints

**Verify:** `cd dashboard-next && uvicorn api:app --port 8000` then `curl localhost:8000/api/health`

### Commit 14: Next.js frontend (~400 lines)
- [ ] Dark ETH-native theme
- [ ] Overview tab (safety chart, earnings)
- [ ] Agents tab (ENS names, tiers, balances)
- [ ] Trades tab (expandable task details)
- [ ] On-chain tab (0G contracts + ENS registry)

**Verify:** `cd dashboard-next && npm run build`

### Commit 15: Polish + final README
- [ ] .env.example
- [ ] Full README with architecture, setup, design decisions
- [ ] Demo video link (when recorded)