state-hub/dashboard/src/docs/wsjf-triage.md
tegwick b2264d1f06
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
feat(terminology): workplan-first dashboard and retirement backlog (STATE-WP-0069)
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.
2026-07-08 16:11:03 +02:00

2 KiB

title
WSJF Triage

WSJF Triage

The Daily WSJF Triage page reviews the append-only reports produced by the Custodian daily triage runner. The producer is tracked by CUST-WP-0044; the dashboard page is only a read surface for daily_triage progress events.

The page loads the latest reports from:

GET /progress/?event_type=daily_triage&limit=14

Each event carries the report under detail.report, with a summary and a list of recommendations. Candidate values are resolved through /workplans/index so file-backed workplans can link to their workplan detail pages.

How to read recommendations

Recommendations are advisory, not authoritative. They help decide where to look first, but they do not change workplan status, task status, ownership, or priority. Acting on a recommendation still belongs to the operator, the workplan owner, or a follow-up implementation workplan.

Confidence labels mean:

Confidence Meaning
high State Hub summary, workplan file, and recent progress agree
medium Summary data is supported by at least one corroborating source
low The signal is stale, incomplete, or mostly inferred

Action vocabulary

Action Meaning
work-next Best next executable task
close-out Finish closure review and mark done when appropriate
revisit Re-read and refresh before execution
split Break an oversized workplan into smaller plans
park Move out of active focus
needs-human Human decision or approval needed
needs-cross-agent Another repo or agent is the right owner
needs-consistency-sync File, DB, or index state should be reconciled

Pattern view

The pattern table aggregates recommendations in the loaded 14-day window. It is useful for spotting recurring human gates, stale revisit signals, or workplans that keep surfacing as the next best piece of work.

No write controls live on this page. It is intentionally a review page so the daily runner remains a focus surface, not an execution loop.