@delorenj/pjangler 1.2.17 → 1.2.19

package/templates/hermes-agent/docs/fleet-control-plane/n8n-service-hub.md

@@ -1,60 +0,0 @@
-# n8n Service Hub
-
-n8n should become the visible service hub for fleet operations while systemd
-remains the local survival layer.
-
-## Shape
-
-- systemd owns process supervision on each host.
-- n8n owns visibility, operator controls, scheduling, and multi-service flows.
-- pjangler owns deterministic generation and reconciliation of both sides.
-
-## Service Model
-
-Each installed Hermes agent service is represented as an n8n node/workflow item:
-
-- gateway service
-- Bloodbank gateway or transitional consumer
-- heartbeat timer/service
-- runtime checkpoint status
-- ticket-provider health check
-
-The node does not replace systemd. It calls stable commands such as:
-
-```
-systemctl --user status hermes-<agent>-heartbeat.timer
-systemctl --user restart hermes-<agent>-gateway.service
-pj fleet status --agent <agent_id> --json
-pj fleet reconcile --agent <agent_id> --apply
-```
-
-## Heartbeat v2
-
-Checkpoint era means the only recurring task was an hourly runtime
-commit/push. It preserved state but did not manage work.
-
-Heartbeat v2 is a frequent, cheap tick:
-
-- always performs a gated runtime checkpoint
-- optionally performs autonomous board reconciliation when
-  `.project.json automation.reconcile.enabled` is true
-- records status in runtime state files for fleet status readers
-- can be triggered by systemd locally or by n8n centrally
-
-## First Implementation Pass
-
-1. Extend `pj fleet status --json` to include service unit state, last heartbeat,
-   last checkpoint, and ticket-provider resolution.
-2. Generate an n8n workflow from `~/.hermes/agents-registry.yaml`.
-3. Add n8n actions for status, restart, reconcile dry-run, reconcile apply, and
-   log tail.
-4. Keep systemd timers installed and enabled as fallback.
-5. Add drift detection when n8n and systemd disagree about an agent.
-
-## Open Questions
-
-- Whether n8n should invoke local commands through SSH, an agent-side webhook,
-  or a small host-local control API.
-- How much service history should live in n8n versus Hermes runtime state.
-- Whether Bloodbank gateway events should also drive n8n workflows for visible
-  operator traces.