disinto-ops/prerequisites.md

Prerequisite Tree

Objective: Foundation — Core agent loop (dev → CI → review → merge)

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

Objective: Foundation — Supervisor health monitoring

• supervisor-run.sh exists and runs via cron
• preflight.sh collects health data Status: DONE

Objective: Foundation — Planner gap analysis against vision

• Planner formula exists (run-planner.toml v4)
• planner-run.sh cron wrapper exists
• 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

• Per-project TOML config (projects/*.toml)
• load-project.sh helper Status: DONE

Objective: Foundation — Knowledge graph for structural defect detection

• networkx package installed in agents container (#220 — closed)
• build-graph.py exists in lib/
• Graph report generating successfully (211 nodes, 302 edges as of 2026-04-15) Status: DONE

Objective: Foundation — Predictor-planner adversarial feedback loop

• Predictor formula exists (run-predictor.toml)
• Planner prediction triage step defined
• Prediction workflow labels created on Forgejo (#225 — closed)
• Predictor filing predictions (4 predictions triaged in run 2) Status: DONE

--- FOUNDATION MILESTONE: DONE ---

Objective: Adoption — One-command bootstrap (disinto init → disinto up)

• disinto init re-run stability (#158 — closed)
• disinto init repo creation API endpoint (#164 — closed)
• Prediction labels created during init (#225 — closed)
• Ops repo migration for existing deployments (#425 — closed, #688 — 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 — backlog+priority, engineering fix for #758) Status: BLOCKED — #758 ops repo branch protection; #765 filed as engineering fix

Objective: Adoption — Built-in Forgejo + Woodpecker CI

• Docker compose with Forgejo + Woodpecker
• Woodpecker OAuth2 redirect URI fix (#172 — closed)
• WOODPECKER_HOST override fix (#178 — closed)
• CI exhaustion root cause fixed (#742 — closed) Status: DONE

Objective: Adoption — Landing page communicating value proposition

• Website addressable exists (disinto.ai)
• Evidence/engagement directory setup (#747 — closed)
• Format-detection guard in collect-engagement.sh (#746 — closed)
• 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 now available

Objective: Adoption — Example project demonstrating full lifecycle

• 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)

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

Objective: Adoption — Architect agent reliability

• Architect FORGE_TOKEN override bug (#762 — in-progress, priority)
• Architect pitch prompt guardrail bypass (#764 — backlog+priority) Status: BLOCKED — #762 in-progress, #764 queued

--- ADOPTION MILESTONE: IN PROGRESS ---

Objective: Ship (Fold 2) — Deploy profiles per artifact type

• No deploy profiles defined
• CI pipeline working (Woodpecker OAuth fixed) Status: BLOCKED — not started, needs design (vision-level)

Objective: Ship (Fold 2) — Vault-gated fold transitions

• Vault redesign complete (#73-#77 — all closed)
• Vault PR workflow documented (docs/VAULT.md)
• 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) Status: BLOCKED — #758 prevents vault items from reaching remote

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

• run-rent-a-human formula exists
• 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