# 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."