PROGRESS.md

# PROGRESS — Hackathon Task State

Live task tracking. Updated at the end of every work block. Source of truth = this file.

**Started:** 2026-04-23
**Target submission:** 2026-04-25 EOD (2-day sprint)

---

## Pre-flight

- [x] Repo created (`GeoForce-CCHackathon`) + pushed
- [x] `initial/` seeded from ForceX-AI v2-real-transform planning docs
- [x] Hackathon research complete (rules, prizes, Discord, prior winners)
- [x] HACKATHON-PLAN.md v2 (dual-tool pivot) committed
- [x] CLAUDE.md, AGENTS.md, PROGRESS.md scaffolded
- [x] `.claude/` subagents defined (8)
- [x] `.claude/` skills defined (6)
- [x] `.claude/` commands defined (4)
- [x] `.claude/settings.json` — model pinned to `claude-opus-4-7`
- [x] Fresh `.venv` + `pyproject.toml`
- [x] `ANTHROPIC_API_KEY` in `.env` (gitignored) + round-trip tested
- [x] `.gitignore` protects secrets
- [~] Registration + Discord acceptance email — deferred per user (2026-04-23)

## Day 1 — Build both engines

### Morning (3h) — COMPLETE 2026-04-23
- [x] Copy `geoforce_cnn_v1.1.pt` to `surrogate/weights/` (248,595 bytes, from ForceX-AI/products/model_registry)
- [x] Port `ReservoirCNN` class + encoding to `surrogate/` (model.py, encoding.py, predict.py)
- [x] `tests/test_surrogate_smoke.py` green — 5/5 pass, 1.7s total
- [x] Claude scaffolding discoverable (subagents + skills load; `surrogate-operator.md` corrected to match real v1.1 encoding)

### Afternoon (4h) — Agent team builds GeoForce-Solver — COMPLETE 2026-04-23
- [x] `solver/properties.py` — IAPWS-IF97 wrappers
- [x] `solver/grid.py` — 2D vertical section structured grid
- [x] `solver/darcy.py` — pressure solver
- [x] `solver/energy.py` — heat solver
- [x] `solver/wells.py` — source terms
- [x] `solver/coupled.py` — implicit backward-Euler
- [x] `solver/benchmarks/theis.py` — analytical pressure
- [x] `solver/benchmarks/conduction_1d.py` — analytical temperature
- [x] `tests/test_solver_theis.py` passes (<5% error)
- [x] `tests/test_solver_conduction.py` passes (<5% error)

### Evening (2h) — CHECKPOINT + wiring — COMPLETE 2026-04-23
- [x] **GO/NO-GO checkpoint:** both analytical tests green → GO
- [x] `tools/predict_solver.py` + `tools/predict_surrogate.py`
- [x] `agent/runtime.py` — claude-agent-sdk boot
- [x] CLI answers Q1 end-to-end
- [x] Commit + push — **milestone: both engines live**

## Day 2 — Polish + demo + ship

### Morning (3h) — Backend + Streamlit fallback — COMPLETE 2026-04-23
- [x] `agent/api.py` — FastAPI + SSE (+ `/predict`, + SPA static mount)
- [x] `app/app.py` — Streamlit fallback
- [x] `demo/scenarios.yaml` — Q1, Q2, Q3
- [x] `tools/monte_carlo.py` + `tools/sensitivity.py`

### Afternoon (4h) — React dashboard — COMPLETE 2026-04-23
- [x] `dashboard/` scaffold (Vite+TS+zustand)
- [x] `tokens.css` from claude-design-system skill
- [x] Components: Header, QueryInput, ScenarioPicker, AgentTrace, AnswerPanel, FieldPlot, FieldPanel
- [x] `api/client.ts` SSE consumer + `predictFields` helper
- [x] Canvas-based magma heatmap (no plotly — bundle stays <160 kB)
- [x] Dry-run 3 scenarios through `/predict` + SSE smoke of `/query`
- [x] `Dockerfile` multi-stage (node build → python runtime, CPU-only torch)

### Evening (3h) — Ship
- [ ] Deploy to HF Spaces (Dockerfile space)
- [x] Root `README.md` + ASCII architecture diagram
- [ ] 90s demo video (recorded against React dashboard)
- [ ] `demo/brady_validation.ipynb` (compressed)
- [ ] Tag `v0.1-hackathon` + submit via Cerebral Valley portal

### Stretch (only if all above shipped)
- [ ] `.mcp.json` exposing GeoForce-Solver via MCP
- [ ] Two-phase stub (saturation variable plumbing, no flash)

---

## Fallback Plan (if Day 1 Evening checkpoint fails)

If either analytical-benchmark test fails:
- [ ] Drop `solver/` from critical path
- [ ] Reframe as "Claude Opus 4.7 agent orchestration over deployed surrogate"
- [ ] Keep all Day 2 deliverables intact
- [ ] Still viable for "Best use of Claude Managed Agents" $5K

---

## Decisions Log

| Date | Decision | Source |
|---|---|---|
| 2026-04-23 | 1st-place target, Managed Agents as safety net | user |
| 2026-04-23 | Solver + Surrogate dual-tool | user |
| 2026-04-23 | Solver name = GeoForce-Solver (provisional) | claude |
| 2026-04-23 | Single-phase water (not two-phase) | user approval of pitch |
| 2026-04-23 | NREL Brady for validation cameo | claude proposal |
| 2026-04-23 | Day 1 evening GO/NO-GO trigger | claude proposal |
| 2026-04-23 | Solver renamed TinyTOUGH → GeoForce-Solver | user |
| 2026-04-23 | Two-phase: single-phase for Day 1; optional stub Day 2 evening only if solver green + submitted | user |
| 2026-04-23 | Demo framing: Ulubelu-inspired synthetic (liquid-dominated, on-brand) | user approved claude recommendation |
| 2026-04-23 | Demo UI: React dashboard (primary) + Streamlit (fallback), Claude design language, HF Spaces Dockerfile deploy | user |
| 2026-04-23 | Added 8th subagent: ui-engineer | claude (per user request) |
| 2026-04-23 | Added 5th skill: claude-design-system | claude (per user request) |
| 2026-04-23 | Added 6th skill: tough-reference (deep TOUGH family knowledge from LBNL manuals) | claude (per user request) |

---

## Blocker Log

- **2026-04-23** — Solver pressure output for `q1_drill_temperature` and
  `q3_well_placement` reports values ~10² MPa after the unit conversion,
  which is physically implausible (reservoir should stay around 15 MPa
  with the small doublet stress). The `/predict` endpoint itself works;
  the issue is either a unit in the solver output dict or boundary
  treatment in `solver.coupled`. Flagged for the reviewer agent before
  the demo video is recorded.