@gobing-ai/spur 0.4.14 → 0.4.16

package/plugins/sp/skills/spur-doctor/SKILL.md

@@ -58,6 +58,7 @@ record saves the returned table under `docs/reports/`; the doctor creates no art
 | rule | `spur rule trace --json`, `spur rule validate` |
 | workflow | `spur workflow validate --json` (findings by `level`), `spur workflow profile <workflow> --json` |
 | agent spec | `spur agent list --specs --json` |
+| decision | `spur decision status --json`, `spur decision status --reliability --json`, `spur decision show <id> --json` |
 | history | A `sp:history-anatomy` report ([../history-anatomy/SKILL.md](../history-anatomy/SKILL.md)), never raw history records |
 | plan/design Markdown | The file itself, the project constitution, the relevant spur-dev template, and inbound index/links; no new CLI needed |
 
@@ -135,6 +136,28 @@ optimization**, and the change comes from the §10 table:
 - A proposal that changes a shared workflow goes through §7 of the composition ladder
   ([spur-composer](../spur-composer/SKILL.md)), including its recorded operator consent.
 
+## Decision flags
+
+Decision evidence is `spur decision status --json` (catalog and per-maker readiness) and
+`spur decision status --reliability [--since <iso>] --json` (per decision × maker). Each flag is a
+predicate over those fields, so compute it with `jq` and never estimate from prose. Each flag becomes
+one row with action class **workflow optimization**. A catalog or config change routes through
+`sp:spur-composer` and the decision lifecycle
+([decision/lifecycle.md](../spur-cli/references/decision/lifecycle.md)).
+
+| Evidence | Flag | Proposed change |
+| --- | --- | --- |
+| `status`: `loadErrors[]` or `duplicateIds[]` non-empty | `catalog-error` | Fix the named catalog file; a layer collision is renamed, not suppressed |
+| `status` `makers[]`: `evidence.recorded > 0` and `evidence.accepted == 0` | `maker-never-accepted` | Re-point `decisions.makers.<id>` for the decisions in `serves`, after `--probe` confirms the maker answers |
+| `status` `makers[]`: `configuredBy` non-empty and `evidence.recorded == 0` | `maker-unrecorded` | Run `spur decision status --probe`; propose only when the probe fails |
+| `--reliability` `groups[]`: `samples >= 10` and `acceptedRate < 0.5` | `low-accept-rate` | Read the dominant `fallbacks` reason: `low-confidence` → tune criteria or `minConfidence`, or change the maker; `no-backend` / errors → maker config; invalid answers → the criteria vocabulary |
+| A workflow step's shell command (not a YAML comment) runs `spur decision run` — read it from `spur workflow show <workflow> --json` | `shell-decision-run` | Convert to a typed `decide` step plus a projection. The shell call ignores both workflow switches |
+
+- `samples < 10` is not evidence: the row says so instead of raising `low-accept-rate`.
+- A run's rows under `.spur/run/*.decision` explain one route; the reliability report is the only
+  rate evidence. Never compute a rate from row files.
+- A decision whose `source: default` rows are expected (switch off, `reason: disabled`) is a no-op.
+
 ## Reflection map over history findings
 
 For each history-anatomy finding (`key`, `category`, `trend`, `ownerSurface`), assign **exactly

package/plugins/sp/skills/wayfinder/SKILL.md

@@ -128,7 +128,7 @@ Invoked when the operator has a loose idea and the destination itself is foggy.
 
 ### Work Through the Map
 
-Invoked when a map already exists (operator provides the feature ID). A ticket is **optional** — without one, pick the next frontier ticket, not the operator's preference. Pipeline runs: `references/pipeline-resolution.md`.
+Invoked when a map already exists (operator provides the feature ID). A ticket is **optional** — without one, pick the next frontier ticket, not the operator's preference.
 
 0. **Worktree first.** Same rule as charting (`sp/wayfind-<wbs>-<short-id>`): steps 6 and 7 remove fog from the map, and the gate that checks the removal measures the branch, not the commit. The `wip` claim lands only in the worktree until the merge, so `/sp:dev-find-way` excludes tickets held by other active `dev-find-way` worktree markers when picking the frontier.
 1. **Load the map** — the feature description (the low-res view), not every task body. Read the destination and Decisions-so-far to orient.
@@ -146,6 +146,16 @@ Invoked when a map already exists (operator provides the feature ID). A ticket i
    conversation (`AskUserQuestion` where available) and recorded straight into **## Decisions so far**
    — no task is claimed, and it does not consume the session's one ticket.
 
+   **Boundary.** A resolution authors research/specification sections — it never implements, so
+   never invoke `/sp:dev-run` or `/sp:dev-runall` from one. Work from local reads and the `spur`
+   CLI; no network search, no MCP tools. Write Solution/Testing/Review with
+   `spur task update <wbs> --section <name> --from-file <path>`, keeping the existing Requirements
+   and AC.
+
+   **Evidence anchors.** Resolve every cited line for real — `grep -n "^## <wbs> " <evidence-file>`
+   — and never copy a line number from another ticket's example. Re-read each cited line before
+   finishing and confirm it names the requirement's subject.
+
 5. **Record the resolution.** Post the answer in the task body, then `spur task update <wbs> done`. Append one line to the map's **## Decisions so far**: `- [<WBS> <title>](path) — <one-line gist of the answer>`.
 6. **Graduate fog into new tickets.** Any fog the answer has made specifiable becomes fresh child tasks (create-then-wire). Clear each graduated patch from **### Not yet specified** so it lives only as its new ticket. Doing half of this — deleting the fog without creating the ticket — destroys the only record the work was ever identified; the `corpus.ungraduated-fog` sweep retired in 0775 — enforcement is review-time discipline.
 7. **Rule out mis-scoped tickets.** If the answer reveals a ticket sits beyond the destination, close it and add one line to **### Out of scope** (the gist + why it's out of scope, linking the closed ticket). A scope boundary is not a step on the route — it stays out of **## Decisions so far**.