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) 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 (runs 1–5) 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 (215 nodes, 306 edges as of 2026-04-12) 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 (7 predictions triaged across runs 2-3) Status: DONE

--- FOUNDATION MILESTONE: DONE ---

Objective: Foundation+ — Infrastructure maturity

• CLAUDE_CONFIG_DIR rollout (#641-#646 — all closed)
• Credential handling cleanup (#669, #671 — closed)
• Agent profile/journal fixes (#651, #652, #663 — closed)
• Cron intervals configured (#682 — closed)
• Remove external flock (#647 — closed) 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 code merged (#425 — closed)
• Ops repo migration auto-triggers on agent startup (#688 — closed)
• End-to-end bootstrap verification with example project (#697 — vision) Status: READY — migration works, needs end-to-end verification

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) Status: DONE

Objective: Adoption — Landing page communicating value proposition

• Website addressable exists (disinto.ai)
• Website observability — no engagement measurement (#426 — vision) Status: BLOCKED — no evidence process connected to website

Objective: Adoption — Example project demonstrating full lifecycle

• Bootstrap path unblocked (#688 — closed)
• Example project design and implementation (#697 — vision) Status: BLOCKED — #697 needs architect decomposition

Objective: Adoption — Architect lifecycle completeness

• Architect closes parent vision issues when sprint sub-issues complete (#689 — closed)
• Architect-run.sh signature bug fixed (#690 — closed)
• Architect-run.sh malformed URL fixed (#717 — closed)
• Architect-run.sh empty pitch fixed (#716 — closed)
• Architect review detection: ignores formal APPROVED reviews (#718 — in-progress) Status: READY — #718 being fixed by dev-bot, architect functional but has edge case

Objective: Adoption — Dev agent pipeline reliability

• Dev-poll deadlock in same-container case (#693 — closed)
• WOODPECKER_REPO_ID agent container fix (#599 — closed)
• Profile journal digestion hang (#702 — closed) Status: DONE

Objective: Adoption — Claude chat interface (#623 sprint)

• Caddy subpath routing skeleton + Forgejo/Woodpecker host reconfig (#704 — closed)
• disinto-chat container scaffold, no auth (#705 — in-progress by dev-qwen)
• disinto-chat sandbox hardening (#706 — backlog)
• Claude identity isolation for disinto-chat (#707 — backlog)
• Forgejo OAuth gate for disinto-chat (#708 — backlog)
• Caddy Remote-User forwarding + chat-side validation (#709 — backlog)
• disinto-chat conversation history persistence (#710 — backlog)
• disinto-chat cost caps + rate limiting (#711 — backlog)
• disinto-chat escalation tools (#712 — backlog)
• Per-project subdomain fallback path, contingency (#713 — backlog) Status: IN PROGRESS — 1/10 done, #705 active. Architect-decomposed sprint from #623.

--- ADOPTION MILESTONE: IN PROGRESS ---

5 objectives DONE, 1 READY, 2 BLOCKED, 2 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 complete in ops repo (#688 — closed)
• Fold transition logic not implemented Status: BLOCKED — needs design for fold gate mechanics

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