feat(flows): add YAML flow format, flow-runner, and /agent/v1/flow endpoint

- ops-agent/src/lib/flow-runner.ts: loads YAML flows, validates all steps
  against the command whitelist, executes sequentially; supports dry_run
  (emits WOULD RUN lines) and on_failure: abort|continue per step
- ops-agent/src/routes/flow.ts: POST /agent/v1/flow { flow_key, dry_run }
  streams step_start/stdout/stderr/step_done/done SSE events
- ops-agent/src/index.ts: register flow route, add FLOWS_PATH env var
- ops-agent/flows.example/: three flow definitions — update_scrum4me_web,
  update_mcp_worker, update_caddy_config; deploy to /etc/ops-agent/flows/
- ops-agent/commands.yml.example: add curl_smoke_scrum4me_web and
  docker_compose_ps_worker smoke-test commands
- app/api/flows/run/route.ts: Next.js proxy — creates FlowRun/FlowStep
  DB records per step, forwards SSE stream to browser
- hooks/useFlowRun.ts: add startFlow(flowKey, dryRun) method; handle
  step_start events to display step headers in the terminal
- components/StreamingTerminal.tsx: add 'info' line type (sky-400) for
  step headers

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Scrum4Me Agent 2026-05-13 19:22:34 +02:00
parent 3781fce1e2
commit bdc24b57ba
10 changed files with 552 additions and 14 deletions

View file

@ -0,0 +1,22 @@
# Reload Caddy after a config change.
# Copy to /etc/ops-agent/flows/update_caddy_config.yml on the host.
#
# Assumes the new Caddyfile is already written to /srv/scrum4me/caddy/Caddyfile
# (e.g. via the caddy_write_config command from the Ops Dashboard editor).
#
# Steps:
# 1. Validate the Caddyfile
# 2. Reload Caddy (zero-downtime config swap)
# 3. Smoke-test HTTPS connectivity
name: Update Caddy Config
description: Validate and reload the Caddy configuration
steps:
- command_key: caddy_validate
on_failure: abort
- command_key: caddy_reload
on_failure: abort
- command_key: curl_smoke_scrum4me_web
on_failure: continue