coulomb/fluid-telegram
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: use canonical State Hub reads with caller attribution

Browse source 
Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a06ed7-828d-7ca0-a8d4-0c3e5a0c4102
This commit is contained in:
tegwick 2026-09-05 10:24:18 +02:00
parent 854e807899
commit f7af151f37
1 changed files with 13 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

13
AGENTS.md
View file

@ -133,6 +133,19 @@ curl -s -X PATCH "http://127.0.0.1:8000/tasks/<task_id>" \
## Workplan Convention (ADR-001)
### State Hub reads and caller identity
Use `GET /workplans/{id}` and `GET /tasks/?workplan_id=<id>` for reads.
Do not send the legacy `workstream_id` query parameter or call `/workstreams/`
routes (410 Gone). Keep `state_hub_workstream_id` in file frontmatter unchanged.
Send `X-StateHub-Component: fluid-telegram` on direct HTTP requests so operational
reviews can attribute callers. Example:
```bash
curl -fsS -H 'X-StateHub-Component: fluid-telegram' \
'http://127.0.0.1:8000/tasks/?workplan_id=<workplan-uuid>'
```
Work items originate as files in this repo — not in the hub. The hub is a
read/cache/index layer that rebuilds from files.