inter-hub/workplans/IHUB-WP-0017-error-fix-loop.md

id, type, title, domain, repo, status, owner, created, updated, depends_on

id	type	title	domain	repo	status	owner	created	updated	depends_on
IHUB-WP-0017	workplan	Autonomous Error-Fix Loop: Reach Clean Build	inter_hub	inter-hub	active	custodian	2026-04-10	2026-04-10	IHUB-WP-0016

IHUB-WP-0017 — Autonomous Error-Fix Loop: Reach Clean Build

Goal

Drive the inter-hub codebase to a clean ghcid build ("All good, N modules loaded") by fixing compilation errors bottom-up, one module at a time.

Pre-conditions

• Must be run inside devenv shell (IHP_LIB must be set, ghcid in PATH)
• WP-0016 complete (compile-check scripts and ghci flags in place)

How to start

# Enter devenv shell first:
devenv shell

# Then start this loop:
/ralph-workplan workplans/IHUB-WP-0017-error-fix-loop.md

Error-Fix SOP (Standard Operating Procedure)

1. Run: scripts/compile-check --bg
2. Tail /tmp/ihub-compile-errors.txt
3. Parse errors: group by module, order by Layer (1 → 4)
4. Fix Layer 1 errors first (rare; usually type/import issues in Web/Types.hs)
5. For each failing module in Layer 2–3:
   a. Read current module state
   b. Apply targeted fix (one module at a time)
   c. Wait for ghcid "Reloading..." + result
   d. If still failing: re-read error, apply next fix
   e. If 3 attempts fail: escalate — flag_for_human with module name and error
6. After Layer 3 clean: fix Layer 4 (FrontController/Routes)
7. "All good (N modules)" in log = build clean

Layer discipline (never violate):

• Never modify Layer 1 (Web/Types.hs, build/Generated/*.hs) during error-fix loops
• Layer 1 changes invalidate ALL 59 controllers and 120 views simultaneously
• Fix within the layer where the error is reported; escalate if the fix requires Layer 1

Tasks

E1 — Start compile-check and capture initial error set

id: E1
status: todo
priority: high

Run scripts/compile-check --bg and read /tmp/ihub-compile-errors.txt. List all failing modules and their layers.

E2 — Fix Layer 2 errors (Application/Helper/*.hs)

id: E2
status: todo
priority: high

Fix all errors in Application/Helper/*.hs. Verify via ghcid reload. Mark done when Layer 2 shows no errors.

E3 — Fix Layer 3 errors (Web/Controller/.hs and Web/View/**/.hs)

id: E3
status: todo
priority: high

Fix errors in controllers and views. Work module-by-module, bottom-up. Mark done when Layer 3 shows no errors.

E4 — Fix Layer 4 errors (Web/FrontController.hs, Web/Routes.hs)

id: E4
status: todo
priority: medium

Fix wiring errors last. Mark done when ghcid reports "All good, N modules loaded".

E5 — Commit clean build and close WP-0014/A1

id: E5
status: todo
priority: medium

After "All good" state:

1. Commit all fixes with fix(WP-0017): reach clean build
2. Update workplans/IHUB-WP-0014-pre-flight-deployment-gaps.md A1 status to done
3. Mark this workplan done

Exit Criteria

• ghcid reports "All good, N modules loaded" with no errors
• All fixes committed
• WP-0014/A1 closed