90 lines
5.1 KiB
Markdown
90 lines
5.1 KiB
Markdown
# STATUS — phase porepo (Builder)
|
|
|
|
**Phase plan:** `/srv/cc-ci/cc-ci-plan/plan-phase-porepo-project-orchestrator.md`
|
|
**Deliverable repo:** `recipe-maintainers/project-orchestrator` on `git.autonomic.zone`
|
|
**Consumes harness:** `recipe-maintainers/agent-orchestrator` @ tag `v0.1.0` (commit `289ef07`) as `engine/` submodule
|
|
|
|
---
|
|
|
|
## Gate: porepo CLAIMED, awaiting Adversary
|
|
|
|
All 5 Definition-of-Done items are built, pushed, and self-verified from a clean **anonymous**
|
|
recursive `/tmp` clone inside `nix develop`. Working tree clean and pushed. Ready for cold
|
|
verification.
|
|
|
|
### WHERE (verification inputs)
|
|
- Deliverable repo (public): `https://git.autonomic.zone/recipe-maintainers/project-orchestrator.git`
|
|
- `main` HEAD → `346ed31acbc0d98eeb2881a1b62998ac9544c002` (single feat commit)
|
|
- `engine/` submodule pin → `289ef07df40a8264f3a36b4e91b923d1424c4658` = tag `v0.1.0` of
|
|
`recipe-maintainers/agent-orchestrator` (also public; anon recursive clone needs no creds)
|
|
- `.gitmodules` URL is the **public** `https://git.autonomic.zone/recipe-maintainers/agent-orchestrator.git`
|
|
(no embedded creds) — so `git clone --recurse-submodules` works anonymously.
|
|
- File map: `agents.toml` (PO harness config), `prompts/{orchestrator,supervise}.md`, `fleet.toml`
|
|
(registry), `docs/{fleet-registry,manage-projects,bootstrap}.md`, `scripts/{fleet.py,
|
|
create-project.sh,start-project.sh,stop-project.sh,update-project.sh,_resolve.sh}`,
|
|
`flake.nix`+`flake.lock`, `README.md`, `.gitignore`.
|
|
|
|
### HOW to cold-verify (fresh /tmp clone, anonymous, exactly as the plan specifies)
|
|
```
|
|
cd /tmp && rm -rf porepo-cold
|
|
git clone --recurse-submodules https://git.autonomic.zone/recipe-maintainers/project-orchestrator.git porepo-cold
|
|
cd porepo-cold
|
|
git rev-parse HEAD # → 346ed31...
|
|
git submodule status # → 289ef07... engine (v0.1.0)
|
|
|
|
# DoD-2: the PO's own config drives the harness
|
|
nix develop -c python3 engine/agents.py status
|
|
|
|
# DoD-3: fleet registry schema + sample entry parse
|
|
nix develop -c python3 scripts/fleet.py validate
|
|
nix develop -c python3 scripts/fleet.py status
|
|
|
|
# DoD-5: Nix devShell + tomllib + bootstrap doc
|
|
nix develop -c python3 -c 'import tomllib'
|
|
test -f docs/bootstrap.md && echo "bootstrap doc present"
|
|
|
|
# DoD-4: create-a-project flow demonstrated → valid standalone project, no PO/fleet metadata
|
|
nix develop -c bash scripts/create-project.sh scratch-verify --dir /tmp/po-scratch --ref v0.1.0
|
|
nix develop -c bash -c 'cd /tmp/po-scratch/scratch-verify && python3 engine/agents.py status'
|
|
( cd /tmp/po-scratch/scratch-verify && git submodule status ) # engine pinned @ v0.1.0
|
|
( cd /tmp/po-scratch/scratch-verify \
|
|
&& grep -ril -e 'fleet' -e 'project-orchestrator' -e 'project orchestrator' . \
|
|
--exclude-dir=engine --exclude-dir=.git \
|
|
&& echo "BAD: PO/fleet metadata found" || echo "clean: no PO/fleet metadata" )
|
|
# cleanup (throwaway; never registered, never touched live cc-ci):
|
|
rm -rf /tmp/po-scratch /tmp/porepo-cold
|
|
```
|
|
|
|
### EXPECTED outcomes (from my cold anon run @2026-06-13T19:20Z on 346ed31, /tmp clone, nix develop)
|
|
- **Clone:** `git rev-parse HEAD` = `346ed31...`; `git submodule status` =
|
|
` 289ef07df40a8264f3a36b4e91b923d1424c4658 engine (v0.1.0)`; `engine/agents.py` present (proves
|
|
the recursive submodule fetch worked anonymously). devShell banner: `Python 3.11.11, tmux 3.5a,
|
|
git version 2.47.2`.
|
|
- **DoD-1 (repo+submodule+main):** repo exists & public; `main` pushed at `346ed31`; `engine/`
|
|
pinned at `v0.1.0` (`289ef07`).
|
|
- **DoD-2 (status):** `engine/agents.py status` prints a table listing the `project-orchestrator`
|
|
persistent agent (backend claude, model claude-opus-4-8, watch heal, STATE stopped) and the
|
|
watchdog service — no error, rc=0.
|
|
- **DoD-3 (fleet.toml):** `fleet.py validate` → `fleet: OK — 1 project(s), schema v1`, rc=0;
|
|
`fleet.py status` lists the sample `example-recipe-ci` entry (enabled, agent-orchestrator@v0.1.0)
|
|
+ `total=1 enabled=1 disabled=0`. Schema documented in `docs/fleet-registry.md`.
|
|
- **DoD-4 (create flow):** `create-project.sh` scaffolds `/tmp/po-scratch/scratch-verify` with an
|
|
`engine/` submodule pinned at `289ef07` (v0.1.0) and an `init`-scaffolded `agents.toml`;
|
|
`engine/agents.py status` in it prints its agent table (rc=0); tracked files are exactly
|
|
`.gitignore .gitmodules agents.toml` (no PO/fleet files); the grep prints
|
|
`clean: no PO/fleet metadata`. Flow documented in `docs/manage-projects.md`.
|
|
- **DoD-5 (Nix+bootstrap):** `python3 -c 'import tomllib'` prints nothing & rc=0 inside the
|
|
devShell; `docs/bootstrap.md` present.
|
|
|
|
(Reasoning / design rationale is in JOURNAL-porepo.md, not here, to preserve anti-anchoring.)
|
|
|
|
## Gate status
|
|
|
|
| DoD item | Status |
|
|
|---|---|
|
|
| D1 repo exists + main pushed + engine/ submodule pinned @ v0.1.0 | CLAIMED |
|
|
| D2 clean recursive /tmp clone: `nix develop -c python3 engine/agents.py status` works | CLAIMED |
|
|
| D3 fleet.toml schema present + documented; sample entry parses | CLAIMED |
|
|
| D4 create-a-project flow documented AND demonstrated (scratch valid, no PO/fleet metadata, status works) | CLAIMED |
|
|
| D5 Nix works (`nix develop -c python3 -c 'import tomllib'`); bootstrap doc present | CLAIMED |
|