[taskboard] document control plane status and roadmap

docs/IMPLEMENTATION_STATUS.md

@@ -0,0 +1,47 @@
+# Taskboard Implementation Status
+
+## Implemented
+
+- Next.js App Router migration with React 19, Tailwind CSS, and shadcn-style UI primitives
+- Typed fleet model loaded from `config/fleet.json`
+- Typed task templates loaded from `config/task-templates.json`
+- Unified task intake for OpenClaw and ZeroClaw
+- Dispatch lifecycle states:
+  - `planned`
+  - `assigned`
+  - `dispatched`
+  - `acknowledged`
+  - `completed`
+  - `failed`
+- SQLite-backed audit log in `task_events`
+- Dispatch history API and UI
+- Failure queue UI
+- Family-specific pages:
+  - `/openclaw`
+  - `/zeroclaw`
+- Architecture page rendered from tracked fleet config
+- Agent cards with:
+  - heartbeat age
+  - workload
+  - last dispatch event
+  - failure counts
+- OpenClaw swarm dispatch:
+  - repo map lookup
+  - safe-directory git handling for mounted repos
+  - worktree creation
+  - queue insertion into `~/.clawdbot/active-tasks.json`
+- ZeroClaw webhook dispatch:
+  - bearer-token support for paired gateways
+  - direct gateway mode for testing
+
+## Verified Live
+
+- `grizzley` ZeroClaw webhook dispatch from taskboard
+- `ice` ZeroClaw webhook dispatch from taskboard
+- OpenClaw swarm queue creation and host worktree creation on `ubuntu`
+
+## Current Limits
+
+- Taskboard can dispatch OpenClaw swarm tasks, but it does not yet monitor tmux session progress automatically.
+- ZeroClaw acknowledgements and completions are still operator-driven; remote runtimes do not push completion state back yet.
+- The board records remote webhook responses, but not structured per-step execution output from the agents.

docs/ROADMAP.md

@@ -0,0 +1,45 @@
+# Taskboard Roadmap
+
+## Next
+
+1. Add execution-state sync for OpenClaw swarm tasks.
+   - Read `~/.clawdbot/active-tasks.json`
+   - Detect `queued`, `running`, and `completed`
+   - Reflect those states back into taskboard tasks automatically
+
+2. Add remote completion callbacks for ZeroClaw.
+   - Accept structured webhook acknowledgements
+   - Persist remote execution summaries
+   - Auto-transition tasks to `acknowledged` or `completed`
+
+3. Add per-host direct taskboard targets beyond the current fleet.
+   - `pve`
+   - `truenas`
+   - `panda`
+
+4. Add operator controls for swarm execution.
+   - launch queued task
+   - stop task
+   - nudge task
+   - open session/log link
+
+5. Add richer audit detail.
+   - store structured request payload
+   - store response excerpt separately from summary
+   - attach host/service verification artifacts
+
+6. Add dashboard summaries.
+   - task counts by family
+   - stale heartbeat warnings
+   - failure trends
+   - dispatch latency
+
+7. Add completion workflows.
+   - generate wiki summary automatically
+   - link completed task to artifacts, PRs, or logs
+
+## Longer Term
+
+- Introduce a fleet capability registry so the taskboard can validate whether a task is legal for a given host before dispatch.
+- Add authentication and RBAC for multi-operator use.
+- Add generated runbooks and service maps directly from live host inventory.