agent-fleet-operations

name

agent-fleet-operations

description

Operate and maintain the Hermes fleet: shared config/registry/install, PM template and deploy contract, real named profiles with generated base-plus-delta config, ignored local runtime, systemd units, fleet self-checks/backfills, credential migration, transactional config recovery, and TTS defaults. Use for Hermes fleet updates, `~/.hermes/*`, `hermes-agent-template`, PM deployment verification, generated profiles, gateway/heartbeat state, fleet audits, MCP drift, template propagation, or voice changes. Do NOT use for project bootstrap/identity requests (→ 33god-projects), Plane ticket operations (→ project-lifecycle), Bloodbank event schemas (→ bloodbank-integration), or generic config fan-out (→ agent-config-fanout).

Hermes Fleet Operations

Route here for anything that touches the shared Hermes fleet, the agent template, or the runtime provisioning contract — not the project that happens to host an agent.

The Canonical PM Deploy Standard (2026-08, enforced)

One PM per repo, and exactly TWO per-agent systemd user units:

1. hermes-<agent>-gateway.service — chat-platform ingress (Telegram/Slack).
2. hermes-<agent>-heartbeat.timer → .service — the fused sentinel/checkpoint tick (.scripts/heartbeat.sh).

Bloodbank command ingress is fleet-shared: hermes-fleet-bloodbank-gateway.service (profile fleet-bloodbank-gateway, adapter bloodbank/services/hermes-gateway) subscribes once to bloodbank.cmd.agent.invocation.start and routes data.target_agent_id → Hermes profile via the registry's profile_name. There is no per-agent consumer unit, no checkpoint timer, no filesystem inbox — any of those is drift, not an alternative deployment style. Every registry entry advertises bloodbank: {gateway_scope: fleet, target_agent_id: <id>}. Canonical command envelopes need an object and or the gateway terminally rejects them. Enforcement: pjangler / detects and converges violations. Canon: § "Bloodbank wiring". The retired scrum-master role's duties folded into the PM heartbeat (see Krebs lifecycle: ).