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

feat(terminology): workplan-first dashboard and retirement backlog (STATE-WP-0069)
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 2s
Details

Browse source 
Add the ranked legacy-interface backlog (T01), rename dashboard navigation and
user-facing copy to workplan while preserving wire-compat API keys (T02), and
activate the retirement workplan with T01/T02 marked done.
This commit is contained in:
tegwick 2026-07-08 16:08:32 +02:00
parent 4dc69bb8f5
commit b2264d1f06
44 changed files with 382 additions and 253 deletions
Download patch file Download diff file Expand all files Collapse all files

34
dashboard/src/docs/workstream-health-index.md
View file

@ -1,10 +1,10 @@
---
title: Workstream Health Index — Reference
title: Workplan Health Index — Reference
---
# Workstream Health Index (WHI)
# Workplan Health Index (WHI)
The **Workstream Health Index** is a composite score in the range [0, 1] that measures how well the workstream network is structured for parallel execution and stable progress. It is displayed as a live KPI card in the right margin of the Workstreams page and recomputes on every poll (every 15 seconds).
The **Workplan Health Index** is a composite score in the range [0, 1] that measures how well the workplan network is structured for parallel execution and stable progress. It is displayed as a live KPI card in the right margin of the Workplans page and recomputes on every poll (every 15 seconds).
**1.0 = ideal independence · 0.0 = severe systemic dysfunction**
@ -25,14 +25,14 @@ The **Workstream Health Index** is a composite score in the range [0, 1] that me
### DD — Dependency Density
```
DD = total dependency edges / (active + blocked workstreams)
DD = total dependency edges / (active + blocked workplans)
```
Measures structural coupling. Low DD means independent, parallelizable work. Completed and archived workstreams are excluded — they no longer constrain progress.
Measures structural coupling. Low DD means independent, parallelizable work. Completed and archived workplans are excluded — they no longer constrain progress.
| DD | Warning |
|---|---|
| > 1.0 | 🔴 red — more than one dependency per workstream on average |
| > 1.0 | 🔴 red — more than one dependency per workplan on average |
| 0.5 – 1.0 | 🟠 orange |
| ≤ 0.5 | ok |
@ -41,7 +41,7 @@ Measures structural coupling. Low DD means independent, parallelizable work. Com
### BR — Blocked Ratio
```
BR = blocked workstreams / (active + blocked workstreams)
BR = blocked workplans / (active + blocked workplans)
```
Measures immediate operational impact. BR ≈ 0 means flow is unobstructed.
@ -57,7 +57,7 @@ Measures immediate operational impact. BR ≈ 0 means flow is unobstructed.
### SPR — Single-Point Risk
```
SPR = max dependents on one incomplete workstream / (active + blocked)
SPR = max dependents on one incomplete workplan / (active + blocked)
```
Detects concentration of blocking power. High SPR means one delay propagates widely — a structural SPOF.
@ -73,12 +73,12 @@ Detects concentration of blocking power. High SPR means one delay propagates wid
### PEP — Parallel Execution Potential
```
PEP = ready or active workstreams with all deps finished / (ready + active + blocked)
PEP = ready or active workplans with all deps finished / (ready + active + blocked)
```
Estimates how much work can proceed right now. A workstream is eligible if its
Estimates how much work can proceed right now. A workplan is eligible if its
stored workstation label is `ready` or `active` and the flow/dependency checks report no
unmet dependency assertion; practically, every workstream it depends on has
unmet dependency assertion; practically, every workplan it depends on has
reached `finished` or `archived`.
| PEP | Warning |
@ -134,11 +134,11 @@ Result is clamped to [0, 1].
## Domain breakdown
The card also shows a per-domain WHI computed using **intra-domain workstreams and intra-domain edges only**. This measures each domain's internal autonomy — how well its workstreams are decomposed relative to each other, independent of cross-domain dependencies.
The card also shows a per-domain WHI computed using **intra-domain workplans and intra-domain edges only**. This measures each domain's internal autonomy — how well its workplans are decomposed relative to each other, independent of cross-domain dependencies.
A domain with WHI = 100% is fully self-contained and parallelizable internally. Its global contribution to the program-level WHI may still be reduced by cross-domain dependencies (captured in CDDR).
The domain breakdown is shown when at least two domains have active workstreams.
The domain breakdown is shown when at least two domains have active workplans.
---
@ -146,10 +146,10 @@ The domain breakdown is shown when at least two domains have active workstreams.
| Symptom | Action |
|---|---|
| High DD | Decompose tightly coupled workstreams; remove unnecessary dependencies |
| High BR | Unblock workstreams — resolve the blocking condition, or mark dependency as finished if done |
| High SPR | Split the bottleneck workstream into independent deliverables |
| Low PEP | Complete prerequisite workstreams or re-sequence work |
| High DD | Decompose tightly coupled workplans; remove unnecessary dependencies |
| High BR | Unblock workplans — resolve the blocking condition, or mark dependency as finished if done |
| High SPR | Split the bottleneck workplan into independent deliverables |
| Low PEP | Complete prerequisite workplans or re-sequence work |
| High CDDR | Refactor cross-domain dependencies into shared contracts or invert the dependency |
| CPI = 1 | Find and break the cycle — identify which dependency edge is incorrect and remove it |