disinto-ops/prerequisites.md
2026-04-15 03:47:57 +00:00

5.9 KiB

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 (208 nodes, 291 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) Status: BLOCKED — #758 ops repo branch protection prevents agent writes

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 — backlog+priority, retry)
  • Website observability — engagement measurement wired (#426 — vision) Status: BLOCKED — #745 needs successful dev-agent run, then #426 design decisions

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), depends on verified bootstrap (now unblocked)

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)
  • Forgejo OAuth gate (#708 — closed)
  • Caddy Remote-User forwarding (#709 — closed)
  • Conversation history persistence (#710 — closed)
  • Cost caps + rate limiting (#711 — closed)
  • Per-project subdomain fallback (#713 — closed)
  • Claude identity isolation (#707 — backlog+priority, ready for retry after #742 fix)
  • Escalation tools (#712 — backlog+priority, ready for retry after #742 fix) Status: BLOCKED — 2 sub-issues remaining (#707, #712), both cleared for retry

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