feat: task dispatcher — poll ops repo and launch runners #45

New issue

Closed

opened 2026-03-28 21:42:39 +00:00 by dev-bot · 0 comments

dev-bot commented

2026-03-28 21:42:39 +00:00

Collaborator

Part of #24. Depends on the edge container Dockerfile issue.

What

A script in the edge container that polls the ops repo for approved actions and launches task-runner containers.

Design

docker/edge/dispatcher.sh:

while true; do
  # Poll ops repo vault/actions/ for .json files without .result.json
  for action in vault/actions/*.json; do
    id=$(basename "$action" .json)
    [ -f "vault/actions/${id}.result.json" ] && continue
    
    # Launch runner
    docker compose run --rm runner "$id"
    
    # Result written by runner to vault/actions/<id>.result.json
  done
  sleep 60
done

The dispatcher:

Clones/pulls the ops repo from Forgejo
Scans vault/actions/ for new action files
Skips actions that already have a .result.json
Calls docker compose run --rm runner <id>
The runner writes its result file

Started from the edge container entrypoint alongside Caddy:

dispatcher.sh &
exec caddy run --config /etc/caddy/Caddyfile

Action JSON schema

{
  "id": "publish-skill-20260328",
  "formula": "clawhub-publish",
  "secrets": ["CLAWHUB_TOKEN"],
  "tools": ["clawhub"],
  "context": "SKILL.md bumped to 0.3.0",
  "model": "sonnet"
}

Acceptance criteria

Dispatcher polls ops repo for new actions
Launches runner with correct action ID
Skips already-completed actions
Runs alongside Caddy without interfering

Part of #24. Depends on the edge container Dockerfile issue. ## What A script in the edge container that polls the ops repo for approved actions and launches task-runner containers. ## Design `docker/edge/dispatcher.sh`: ```bash while true; do # Poll ops repo vault/actions/ for .json files without .result.json for action in vault/actions/*.json; do id=$(basename "$action" .json) [ -f "vault/actions/${id}.result.json" ] && continue # Launch runner docker compose run --rm runner "$id" # Result written by runner to vault/actions/<id>.result.json done sleep 60 done ``` The dispatcher: - Clones/pulls the ops repo from Forgejo - Scans `vault/actions/` for new action files - Skips actions that already have a `.result.json` - Calls `docker compose run --rm runner <id>` - The runner writes its result file Started from the edge container entrypoint alongside Caddy: ```bash dispatcher.sh & exec caddy run --config /etc/caddy/Caddyfile ``` ## Action JSON schema ```json { "id": "publish-skill-20260328", "formula": "clawhub-publish", "secrets": ["CLAWHUB_TOKEN"], "tools": ["clawhub"], "context": "SKILL.md bumped to 0.3.0", "model": "sonnet" } ``` ## Acceptance criteria - [ ] Dispatcher polls ops repo for new actions - [ ] Launches runner with correct action ID - [ ] Skips already-completed actions - [ ] Runs alongside Caddy without interfering