# fleet.toml — the project-orchestrator's fleet registry.
#
# THE authoritative, PO-only record of every project the fleet manages. This is the ONLY place where
# project ↔ harness ↔ ref ↔ location lives. Projects themselves carry none of this (one-directional
# knowledge: PO → projects, never the reverse). Full schema + field reference: docs/fleet-registry.md
#
# Validate / inspect this file with:  python3 scripts/fleet.py list   (or `status`).

# ─────────────────────────── registry metadata (optional) ───────────────────────────
[fleet]
version = 1                       # registry schema version (integer; bump on breaking changes)

# ─────────────────────────── one [[project]] block per project ───────────────────────────
# Required fields: name, location, harness, ref, enabled, secrets.
# See docs/fleet-registry.md for the meaning and allowed values of each.

# Sample entry (a representative project; not started by the PO unless an operator asks).
[[project]]
name      = "example-recipe-ci"                                   # unique fleet id (kebab-case)
location  = "https://git.autonomic.zone/recipe-maintainers/example-recipe-ci.git"  # git url or local path
harness   = "agent-orchestrator"                                 # which harness runs it
ref       = "v0.1.0"                                             # pinned harness ref (submodule pin)
enabled   = true                                                 # is this project part of the active fleet?
secrets   = ".env"                                               # where the project's creds live (path/ref; never in git)
config    = "agents.toml"                                        # the project's harness config file (relative to the project root)
notes     = "Sample fleet entry — replace with a real project, or remove."

# cc-ci modeled as a project (poe2e staging). enabled=false: the PO must NOT start it — the live
# cc-ci still runs under /srv/cc-ci/cc-ci-plan/agents.py in the cc-ci- tmux namespace. Taking it
# live on the new system is an operator-supervised cutover (see the project's docs/cutover-runbook.md).
[[project]]
name      = "cc-ci"
location  = "/home/loops/poe2e/cc-ci"                            # local staging repo (git, engine submodule pinned)
harness   = "agent-orchestrator"
ref       = "v0.1.0"
enabled   = false                                                # STAGING — never started by the PO (would collide with live)
secrets   = "/srv/cc-ci/.testenv"                                # live cc-ci creds (Gitea bot, etc.); never in git
config    = "agents.toml"
notes     = "cc-ci as project #1 (staging). Migrated from live cc-ci-plan/agents.toml. Parity verified in poe2e. Cutover is operator-supervised."