@gobing-ai/spur 0.3.72 → 0.3.74

package/plugins/sp/skills/spur-dev/references/inline-pipeline-driver.md

@@ -1,6 +1,8 @@
 ---
 name: inline-pipeline-driver
 description: "Interactive host-session interpreter for Spur state-machine pipelines: execute the existing FSM without a workflow agent subprocess while preserving actions, guards, artifacts, and provenance."
+owner: spur-dev-maintainers
+retirement-criterion: "The per-task interpreter retires once the engine covers per-task execution for /sp:dev-runall with real terminal runs and the parity check (plugins/sp/scripts/inline-pipeline-parity-check.ts) is green (D8 decision D7). Batch orchestration wrapper may remain."
 see_also:
   - spur-dev
   - execution-workflow
@@ -9,6 +11,24 @@ see_also:
 
 # Inline Pipeline Driver
 
+**Owner:** `spur-dev-maintainers` (per task 0755 R1). Reach the named owner via the frontmatter; no need to read the originating task.
+
+**Retirement criterion (0755 R5, D8 decision D7):** the per-task interpreter retires once the engine covers per-task execution for `/sp:dev-runall` with real terminal runs **and** the parity check (this doc's documented action/guard set ≡ the resolved action/guard set of every `.spur/workflows/*.yaml`) is green. Recording the criterion is part of this task; acting on it is not — that is a separate A3-gate decision.
+
+## Supported action and guard set (0755 R2 parity contract)
+
+The action and guard kinds this driver implements. The parity check
+(`plugins/sp/scripts/inline-pipeline-parity-check.ts`) compares this set against
+the resolved actions and guards of every `.spur/workflows/*.yaml`; any element present
+in one and absent in the other fails the check. Add a new kind here when the driver
+implements it; remove the entry when the corresponding kind is dropped from the YAML.
+
+**Actions:** `shell` · `note` · `doctor.probe` · `file.read.into-var` · `hitl.confirm` · `agent.run` · `proof.fingerprint` · `run.artifact` · `command.gate`
+
+**Guards (transitions):** `always` · `shell`
+
+## What this driver is
+
 This driver is the interactive control-inversion path granted by ADR-047. It applies when an
 interactive `/sp:dev-run --mode full`, sequential `/sp:dev-runall`, `/sp:dev-idea`, or
 `/sp:dev-plan` invocation omits `--agent` or passes `--agent inline`. A named executor,

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

@@ -147,7 +147,7 @@ Invoked when a map already exists (operator provides the feature ID). A ticket i
    — no task is claimed, and it does not consume the session's one ticket.
 
 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, so `corpus-check` fails the branch (`corpus.ungraduated-fog`) unless the removal is matched by a new/re-parented ticket or a line in **### Out of scope**.
+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**.
 8. **Stop after ONE ticket.** Never resolve more than one per session.
 

package/schemas/state-machine-workflow.schema.json

@@ -17,7 +17,9 @@
             "minLength": 1
         },
         "version": {
-            "type": "string"
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional behavior-neutral identity tag (0756). Absent = unversioned; present = a non-empty opaque literal surfaced as explicit(<literal>). Not parsed, ordered, or compatibility-checked; no registry."
         },
         "description": {
             "type": "string"

package/schemas/transition-flow-workflow.schema.json

@@ -17,7 +17,9 @@
             "minLength": 1
         },
         "version": {
-            "type": "string"
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional behavior-neutral identity tag (0756). Absent = unversioned; present = a non-empty opaque literal surfaced as explicit(<literal>). Not parsed, ordered, or compatibility-checked; no registry."
         },
         "description": {
             "type": "string"