disinto-ops/prerequisites.md

# Prerequisite Tree
<!-- Last updated: 2026-04-15 -->

## Objective: Foundation — Core agent loop (dev → CI → review → merge)
- [x] dev-agent picks up backlog issues (dev/dev-agent.sh exists)
- [x] review-agent reviews PRs (review/review-pr.sh exists)
- [x] CI integration with Woodpecker (lib/ci-helpers.sh exists)
- [x] Stale in-progress recovery (#224 — closed)
- [x] Agent race condition fix (#160 — closed)
- [x] Dispatcher grep Alpine fix (#150 — closed)
- [x] Dev-poll post-crash deadlock (#749 — closed)
- [x] Entrypoint wait deadlock (#753 — closed)
- [x] Credential helper race on cold boot (#741 — closed)
Status: DONE

## Objective: Foundation — Supervisor health monitoring
- [x] supervisor-run.sh exists and runs via cron
- [x] preflight.sh collects health data
Status: DONE

## Objective: Foundation — Planner gap analysis against vision
- [x] Planner formula exists (run-planner.toml v4)
- [x] planner-run.sh cron wrapper exists
- [x] Planning runs established (run 1: 2026-04-05, run 2: 2026-04-08, run 3: 2026-04-15)
Status: DONE

## Objective: Foundation — Multi-project support
- [x] Per-project TOML config (projects/*.toml)
- [x] load-project.sh helper
Status: DONE

## Objective: Foundation — Knowledge graph for structural defect detection
- [x] networkx package installed in agents container (#220 — closed)
- [x] build-graph.py exists in lib/
- [x] Graph report generating successfully (217 nodes, 317 edges as of 2026-04-15)
Status: DONE

## Objective: Foundation — Predictor-planner adversarial feedback loop
- [x] Predictor formula exists (run-predictor.toml)
- [x] Planner prediction triage step defined
- [x] Prediction workflow labels created on Forgejo (#225 — closed)
- [x] Predictor filing predictions (4 predictions triaged in run 2)
Status: DONE

## --- FOUNDATION MILESTONE: DONE ---

## Objective: Adoption — One-command bootstrap (disinto init → disinto up)
- [x] disinto init re-run stability (#158 — closed)
- [x] disinto init repo creation API endpoint (#164 — closed)
- [x] Prediction labels created during init (#225 — closed)
- [x] Ops repo migration for existing deployments (#425 — closed, #688 — closed)
- [x] Edge service restart policy (#768 — closed)
- [ ] Ops repo branch protection blocks agent writes (#758 — blocked, bug-report) blocked-on-vault (vault/pending/disinto-ops-branch-protection.md)
- [ ] Planner PR-based ops flow (#765 — blocked, engineering fix for #758)
- [ ] agents-llama as first-class generator service (#769 — backlog)
- [ ] disinto up should regenerate compose/Caddyfile from generators.sh (#770 — backlog, depends on #769)
- [ ] Deprecate tracked docker/Caddyfile (#771 — backlog)
- [ ] disinto down && disinto up reproducibility (#772 — blocked, depends on #769+#770+#771)
Status: BLOCKED — #758 ops repo branch protection (human action needed); #769-#771 in backlog for bootstrap reproducibility

## Objective: Adoption — Built-in Forgejo + Woodpecker CI
- [x] Docker compose with Forgejo + Woodpecker
- [x] Woodpecker OAuth2 redirect URI fix (#172 — closed)
- [x] WOODPECKER_HOST override fix (#178 — closed)
- [x] CI exhaustion root cause fixed (#742 — closed)
Status: DONE

## Objective: Adoption — Landing page communicating value proposition
- [x] Website addressable exists (disinto.ai)
- [x] Evidence/engagement directory setup (#747 — closed)
- [x] Format-detection guard in collect-engagement.sh (#746 — closed)
- [x] Collect-engagement formula + container script (#745 — closed, PR #761)
- [ ] Website observability — engagement measurement wired (#426 — vision)
Status: BLOCKED — #426 needs design decisions (vision-level), engagement collection infrastructure ready

## Objective: Adoption — Example project demonstrating full lifecycle
- [x] Bootstrap path verified (#425, #688 — closed)
- [ ] Example project design and implementation (#697 — vision+priority)
Status: BLOCKED — #697 needs design (vision-level), bootstrap path verified

## Objective: Adoption — Subpath routing + Forgejo-OAuth-gated Claude chat (#623)
- [x] Caddy subpath routing skeleton (#704 — closed)
- [x] Chat container scaffold (#705 — closed)
- [x] Chat sandbox hardening (#706 — closed)
- [x] Claude identity isolation (#707 — closed)
- [x] Forgejo OAuth gate (#708 — closed)
- [x] Caddy Remote-User forwarding (#709 — closed)
- [x] Conversation history persistence (#710 — closed)
- [x] Cost caps + rate limiting (#711 — closed)
- [x] Escalation tools (#712 — closed)
- [x] Per-project subdomain fallback (#713 — closed)
Status: DONE — all 10 sub-issues closed, parent #623 awaiting architect close

## Objective: Adoption — Architect agent reliability
- [x] Architect FORGE_TOKEN override bug (#762 — closed 2026-04-15)
- [x] Architect pitch prompt guardrail bypass (#764 — closed 2026-04-15)
Status: DONE

## Objective: Adoption — Versioned agent images (#429)
- [ ] Publish versioned agent images — compose should use image: not build: (#429 — in-progress, vision)
Status: IN PROGRESS — #429 being worked on

## --- ADOPTION MILESTONE: IN PROGRESS ---

## Objective: Ship (Fold 2) — Deploy profiles per artifact type
- [ ] No deploy profiles defined
- [x] CI pipeline working (Woodpecker OAuth fixed)
Status: BLOCKED — not started, needs design (vision-level)

## Objective: Ship (Fold 2) — Vault-gated fold transitions
- [x] Vault redesign complete (#73-#77 — all closed)
- [x] Vault PR workflow documented (docs/VAULT.md)
- [x] Vault directories seeded in ops repo (#425, #688 — closed)
- [ ] Ops repo branch protection blocks vault item visibility (#758) blocked-on-vault (vault/pending/disinto-ops-branch-protection.md)
- [ ] vault_request RETURN trap fires prematurely (#773 — backlog, bug-report)
Status: BLOCKED — #758 prevents vault items from reaching remote; #773 vault bug in backlog

## Objective: Ship (Fold 2) — Engagement measurement baked into deploy pipelines
- [ ] No engagement measurement exists
- [ ] No observables yet (AGENTS.md confirms)
Status: BLOCKED — depends on deploy profiles + website observability (#426)

## Objective: Ship (Fold 2) — Rent-a-human for gated channels
- [x] run-rent-a-human formula exists
- [x] Caddy SSH key setup documented (#748 — closed)
- [ ] Not yet exercised in production
Status: READY

## Objective: Ship (Fold 2) — Assumptions register
- [ ] No assumptions register exists
Status: BLOCKED — not started

## Objective: Learn (Fold 3) — Observable-driven planning
- [ ] No observables exist yet
Status: BLOCKED — depends on Ship milestone (engagement measurement)

## Objective: Learn (Fold 3) — Predictor challenges assumptions against signals
- [ ] Requires observables + assumptions register
Status: BLOCKED — depends on Ship milestone

## Objective: Learn (Fold 3) — Audience variation + signal detection
- [ ] Requires observables
Status: BLOCKED — depends on Ship milestone