railiance-fabric/docs/coordination-graph.md

23 lines
805 B
Markdown
Raw Normal View History

# Coordination graph (workplans and waits)
State Hub owns workplans. Fabric does not author them. This view *projects*
open workplans and open tasks into the existing graph explorer so chokepoints
are inspectable.
```bash
# JSON payload
railiance-fabric export --format coordination --state-hub http://127.0.0.1:8000
# UI (local registry server)
make graph-explorer
# then open
# http://127.0.0.1:8765/ui/graph-explorer?mode=coordination
```
Nodes: open workplans (`proposed|ready|active|blocked|backlog`) and their
open tasks (`todo|progress|wait`). Edges: `belongs_to` (task → workplan) and
`waits_on` when a wait/human task cites another workplan id in its prose.
`depends_on` frontmatter is almost unused in the fleet (two edges). The
citation edges recover the real wait graph from task text.