chore(aoeng): init Adversary phase files — orientation done, awaiting Builder

machine-docs/BACKLOG-aoeng.md

@@ -0,0 +1,9 @@
+# BACKLOG — phase aoeng
+
+## Build backlog
+
+*(Builder-owned section — Adversary reads only)*
+
+## Adversary findings
+
+*(none yet)*

machine-docs/JOURNAL-aoeng.md

@@ -0,0 +1,15 @@
+# JOURNAL — phase aoeng (Adversary)
+
+## 2026-06-13T18:23Z — Orientation
+
+Phase aoeng initialized. Builder has not started yet.
+
+Performed pre-build orientation:
+- Read `plan-phase-aoeng-engine.md` (full)
+- Read `plan-agent-orchestrator.md` (full)
+- Read source files: `agents.py` (850 lines), `agents.toml` (155 lines)
+- Confirmed `recipe-maintainers/agent-orchestrator` exists on Gitea but is empty
+- Identified all cc-ci hardcoding points that must be generalized (see REVIEW-aoeng.md)
+- Initialized phase tracking files
+
+Awaiting Builder's first commit/claim. Will poll every 10 min until activity starts.

machine-docs/REVIEW-aoeng.md

@@ -0,0 +1,39 @@
+# REVIEW — phase aoeng (Adversary log)
+
+Phase plan: `/srv/cc-ci/cc-ci-plan/plan-phase-aoeng-engine.md`
+Deliverable repo: `recipe-maintainers/agent-orchestrator` on git.autonomic.zone
+
+---
+
+## Adversary orientation @2026-06-13T18:23Z
+
+Pre-build orientation complete. Key facts noted for cold verification:
+
+**DoD items to verify (from phase plan):**
+1. `recipe-maintainers/agent-orchestrator` exists; `main` pushed; `v0.1.0` annotated tag present.
+2. **No cc-ci hardcoding:** `grep -rIE 'cc-ci|/srv/cc-ci|recipe|upgrad' <repo> --include='*.py'` on a clean /tmp checkout returns only generic/example/comment hits.
+3. `python3 agents.py selftest` passes; `python3 agents.py status --config agents.example.toml` prints sane table; `agents.py --help` documents verbs.
+4. Example project smoke run: bring up + tear down in isolated sandbox (own `session_prefix`, throwaway sessions), using ONLY files in repo.
+5. Nix: `flake.nix`+`flake.lock` committed; `nix develop -c python3 -c 'import tomllib'` succeeds; `tmux`/`git` on PATH in devShell.
+6. README documents: schema + verbs + AI-PO usage + `nix develop`.
+
+**Specific hardcoding to watch for in the ported agents.py (from source analysis):**
+- `log_dir` default `/srv/cc-ci/.cc-ci-logs` → must be project-rooted / config-driven
+- `session_prefix` default `cc-ci-` → must require from config (no implicit default)
+- `build_loop_kickoff()` hardcoded `*** cc-ci SUB-PHASE ***` preamble → must be template file from config
+- `handoff.repo` default `/srv/cc-ci/cc-ci` → must be config-driven
+- `cwd` fallback `/srv/cc-ci-orch` and `/srv/cc-ci-orch/cc-ci` → must be config-driven
+- `on_complete.run = "upgrader"` → must be generic task name from config
+- `opencode.preamble` has `/srv/cc-ci/.testenv` → must be config-driven
+
+**Guardrails to enforce:**
+- Do NOT modify live launch system at `/srv/cc-ci/cc-ci-plan/agents.py`, `agents.toml`, `cc-ci-plan/state/`, or running tmux sessions
+- New repo must be separate from cc-ci tree
+
+**Repo state at orientation:** `recipe-maintainers/agent-orchestrator` EXISTS on Gitea but is EMPTY (Builder created shell; no content yet)
+
+---
+
+## Verdicts
+
+*(none yet — waiting for Builder to make claims)*

machine-docs/STATUS-aoeng.md

@@ -0,0 +1,26 @@
+# STATUS — phase aoeng (Adversary view)
+
+**Phase plan:** `/srv/cc-ci/cc-ci-plan/plan-phase-aoeng-engine.md`
+**Adversary clone:** `/srv/cc-ci/cc-ci-adv`
+**Phase start:** 2026-06-13
+
+---
+
+## Current state: WAITING FOR BUILDER
+
+Builder has not yet started the aoeng phase. No gate claims seen yet.
+
+Adversary is initialized and polling. Will verify each gate claim as it arrives.
+
+---
+
+## Gate status
+
+| Gate | Status | Last checked |
+|---|---|---|
+| DoD-1 (repo + tag) | PENDING | — |
+| DoD-2 (no cc-ci hardcoding) | PENDING | — |
+| DoD-3 (selftest + status + help) | PENDING | — |
+| DoD-4 (smoke run) | PENDING | — |
+| DoD-5 (nix flake) | PENDING | — |
+| DoD-6 (README) | PENDING | — |