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

STATE-WP-0069 T04: meter workstream_id query-param aliases
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 3s
Details

Browse source 
Add legacy_compat helper and Deprecation headers when callers filter
/tasks, /decisions, /token-events, or /execution/launch-requests with
workstream_id. Preferred workplan_id filters are unchanged. Route removal
remains gated on legacy-meter zero-usage windows.
This commit is contained in:
tegwick 2026-07-08 21:32:14 +02:00
parent b2b72b7327
commit 793a39a1a4
8 changed files with 181 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

16
docs/workplan-terminology-legacy-retirement-backlog.md
View file

@ -63,16 +63,20 @@ Risk order: REST > MCP > events > dashboard prose > internal identifiers.
| 6 | `open_workstreams` summary cache key | `open_workplans` | Internal | T06 |
| 6 | `flows/workstream.yaml` entity id | `flows/workplan.yaml` (`custodian.workplan.v1`) | Internal | T06 (workplan flow shipped; workstream yaml retained) |
### Query-param aliases (not separately metered today)
### Query-param aliases (metered from 2026-07-09)
These accept `workstream_id` alongside `workplan_id` on preferred routes:
- `GET /tasks/` — `api/routers/tasks.py`
- `GET /decisions/` — `api/routers/decisions.py`
- `GET /token-events/` — `api/routers/token_events.py`
| Legacy-meter key | Route | Replacement |
| --- | --- | --- |
| `rest_api:GET /tasks/?workstream_id` | `GET /tasks/` | `GET /tasks/?workplan_id=` |
| `rest_api:GET /tasks/counts?workstream_id` | `GET /tasks/counts` | `GET /tasks/counts?workplan_id=` |
| `rest_api:GET /decisions/?workstream_id` | `GET /decisions/` | `GET /decisions/?workplan_id=` |
| `rest_api:GET /token-events/?workstream_id` | `GET /token-events/` | `GET /token-events/?workplan_id=` |
| `rest_api:GET /execution/launch-requests?workstream_id` | `GET /execution/launch-requests` | `GET /execution/launch-requests?workplan_id=` |
Retire param aliases in T04 after route retirement; document callers via
weekly review component headers (`X-StateHub-Component`).
Retire param aliases in T04 after zero-usage windows; callers surface via
`X-StateHub-Component` in weekly review.
## Grep budget by phase