@gobing-ai/spur 0.3.87 → 0.3.89

package/plugins/sp/skills/spur-dev/references/flag-glossary.md

@@ -174,7 +174,8 @@ establishes a baseline with it before the first change and re-runs it after each
 Constrain the operation to a named subset of dimensions — review dimensions on `dev-review`/
 `dev-verify`/`dev-verifyall` (`all|stack|dependencies|data|flows|api|security|quality|performance`),
 a refactor lens set on `dev-refactor` (`api|architect|tests|ui|auto`), a refine focus mode on
-`dev-refine`/`dev-refineall`, or a reconstruction lens on `dev-reverse`.
+`dev-refine`/`dev-refineall` (`all|requirements|background|constraints|acceptance|quick` —
+[dev-operations.md](dev-operations.md) § refine), or a reconstruction lens on `dev-reverse`.
 Narrowing reduces token cost; omitting runs
 all dimensions.
 
@@ -372,10 +373,12 @@ Orthogonal to `--focus` (which _narrows_ domains) and to `--mode` on other comma
 | Value (refine family)             | Bar                                                                                                                                                                                | `--auto` SKIP behavior                                                                             |
 | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
 | `standard` (default when omitted) | L3 structural completeness (not empty/placeholder; check-clean for target sections)                                                                                                | **SKIP** when no L3 findings on target sections                                                    |
-| `ready`                           | **Implement-ready** freeze: another agent can implement without inventing design (frozen names/APIs or explicit "no new API", anti-patterns, file targets, handoffs, out-of-scope) | **Do not SKIP** on L3-clean alone — run the ready checklist; rewrite sections until the bar is met |
+| `ready`                           | **Implement-ready** freeze: another agent can implement without inventing design (frozen names/APIs or explicit "no new API", anti-patterns, file targets, handoffs, out-of-scope) | **Do not SKIP** on L3-clean alone — audit existing claims, run the ready checklist, rewrite sections until the bar is met, then promote `backlog → todo` |
 
 Default for refine stays `standard` so ordinary `refineall --auto` remains cheap. Use `ready` for
-multi-package / multi-agent handoffs and flaky-pipeline features where a wrong implement is costly.
+multi-package / multi-agent handoffs, flaky-pipeline features where a wrong implement is costly, and
+evaluating/correcting an existing task (review-triage filing, stale backlog) whose claims may no
+longer hold.
 Full checklist: [dev-operations.md](dev-operations.md) § refine (depth ready).
 
 ### `--bdd` — use BDD scenarios as the verification lens

package/plugins/sp/skills/spur-dev/references/planning-workflow.md

@@ -301,10 +301,12 @@ the handoff degrades to refineall.
 (and preferably Plan/AC) so tasks land **content-ready**. **`--skip-design`:** leave `design`
 empty — headings only.
 
-**Refine is the fallback**, not the primary Design author:
+**Refine is the fallback** Design author, not the primary one. It is also the audit path for
+tasks that already have content:
 
 ```text
 /sp:dev-refine <wbs>          # single task — fills blank Design/AC/Plan if L3 gaps
+/sp:dev-refine <wbs> --depth ready    # evaluate + correct an existing/filed task, then promote to todo
 /sp:dev-refineall --feature X --auto
 /sp:dev-refineall --feature X --auto --depth ready   # implement-ready freeze (no L3-only SKIP)
 ```
@@ -314,7 +316,9 @@ Under `--auto` + **`--depth standard`** (default), refine **SKIP**s when target
 placeholder, synthesis runs (standard tier by default; escalates only on gate-fail). Under
 **`--depth ready`**, do not SKIP on L3-clean alone — run the implement-ready checklist in
 [dev-operations.md](dev-operations.md) § refine (frozen APIs, anti-patterns, file targets, handoffs)
-so another agent can implement without inventing design.
+so another agent can implement without inventing design. Ready depth also audits every existing
+claim against the current tree, records corrections in Background, and promotes a passing task
+`backlog → todo`.
 
 **Check the variant before you write.** Which sections a task carries is decided by its `template:`
 frontmatter against `.spur/tasks/section-matrix.yaml` — NOT a fixed list. Before authoring any
@@ -344,16 +348,16 @@ feature filled before a runall, use `/sp:dev-refineall --feature <id> --auto` (b
 of `/sp:dev-refine`). It reuses the same per-task refine operation, freezes the set, topo-sorts by
 `dependencies[]`, and emits a batch report — see [dev-operations.md](dev-operations.md) § refineall.
 This does **not** replace just-in-time refine before each implement; it is a bulk pre-pass when the
-feature's tasks are still `backlog`/`todo` placeholders. Prefer `--auto` for batch scale; avoid
-`--next` on large features (that chains each task into run).
+feature's tasks are still `backlog`/`todo` placeholders. Prefer `--auto` for batch scale.
+`/sp:dev-refineall` takes no `--next`; chain with `/sp:dev-runall --feature <id>` afterwards.
 
 **Refine arguments** (defined on the `/sp:dev-refine` entry point, passed through verbatim; also
 shared flags on `/sp:dev-refineall`):
 
 | Argument | Effect |
 |----------|--------|
-| `--focus <mode>` | Narrows the gap analysis to a subset of domain hints. See the `sp:dev-refine` skill for the full value table (`all`, `requirements`, `background`, `constraints`, `acceptance`, `quick`). Default `all`. |
-| `--depth <standard\|ready>` | Spec depth bar. `standard` (default) = L3 structural completeness + L3 SKIP under `--auto`. `ready` = implement-ready freeze (never L3-only SKIP). See [flag-glossary.md](flag-glossary.md#flag-depth). |
+| `--focus <mode>` | Narrows the gap analysis to a subset of domain hints. Values `all`, `requirements`, `background`, `constraints`, `acceptance`, `quick` — hint table in [dev-operations.md](dev-operations.md) § refine. Default `all`. Under `--depth ready` it only orders the work. |
+| `--depth <standard\|ready>` | Spec depth bar. `standard` (default) = L3 structural completeness + L3 SKIP under `--auto`. `ready` = audit + implement-ready freeze + promote to `todo` (never L3-only SKIP). See [flag-glossary.md](flag-glossary.md#flag-depth). |
 | `--auto` | Skip interactive Q&A — synthesize improvements from the task content alone. Use for well-scoped tasks where the agent can fill gaps without operator input. **Required for practical batch use** via `dev-refineall`. |
 
 **Pre-synthesis skip gate (under `--auto` + `--depth standard`).** Before synthesizing, run `spur task check <wbs> --json`. When the **refine target sections** show no L3 findings, emit a structured SKIP instead of calling the synthesis agent. **Not applied when `--depth ready`.**

package/schemas/spur-config.schema.json

@@ -167,8 +167,20 @@
                                 "description": "Capability tier for stage-registry adaptive model routing (ADR-033, 0343). Live values: cheap | standard | capable-1 | capable-2 | capable-3 (1=low output quality, 3=high within the capable band). A stage starts on the cheapest eligible executor meeting its model_policy min_tier. Bare legacy `capable` is accepted at runtime (zod preprocess \u2192 capable-1) during the deprecation window but is not part of this editor enum."
                             },
                             "disabled": {
-                                "type": "boolean",
-                                "description": "Routing kill-switch (111): a disabled profile never serves a role, team, stage, or explicit selection, and doctor inventories it without probing. Omitted = enabled; only true/false accepted (no string/number/null coercion)."
+                                "description": "Routing kill-switch (111; ownership widened 0890): a disabled profile never serves a role, team, stage, or explicit selection, and doctor inventories it without probing. Omitted = enabled. Bare `true` is operator-owned (only humans write booleans); automatic writers emit the object form carrying owner (operator|quota|probe), since (RFC 3339) and reason.",
+                                "anyOf": [
+                                    { "type": "boolean" },
+                                    {
+                                        "type": "object",
+                                        "additionalProperties": false,
+                                        "required": ["owner", "since", "reason"],
+                                        "properties": {
+                                            "owner": { "enum": ["operator", "quota", "probe"] },
+                                            "since": { "type": "string", "format": "date-time", "minLength": 1 },
+                                            "reason": { "type": "string", "minLength": 1 }
+                                        }
+                                    }
+                                ]
                             }
                         }
                     }