@gobing-ai/spur 0.3.1 → 0.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/spur",
-    "version": "0.3.1",
+    "version": "0.3.2",
     "description": "Spur CLI — local-first harness for mainstream coding agents: constraint checking, workflow orchestration, agent health, and history analytics. Bun-native; exposes the `spur` command.",
     "keywords": [
         "spur",
@@ -49,13 +49,13 @@
     },
     "devDependencies": {
         "@commander-js/extra-typings": "^14.0.0",
-        "@gobing-ai/ts-ai-runner": "^0.4.2",
-        "@gobing-ai/ts-dual-workflow-engine": "^0.4.2",
-        "@gobing-ai/ts-infra": "^0.4.2",
-        "@gobing-ai/ts-llm-jsonl-importer": "^0.4.2",
-        "@gobing-ai/ts-rule-engine": "^0.4.2",
-        "@gobing-ai/ts-runtime": "^0.4.2",
-        "@gobing-ai/ts-utils": "^0.4.2",
+        "@gobing-ai/ts-ai-runner": "^0.4.3",
+        "@gobing-ai/ts-dual-workflow-engine": "^0.4.3",
+        "@gobing-ai/ts-infra": "^0.4.3",
+        "@gobing-ai/ts-llm-jsonl-importer": "^0.4.3",
+        "@gobing-ai/ts-rule-engine": "^0.4.3",
+        "@gobing-ai/ts-runtime": "^0.4.3",
+        "@gobing-ai/ts-utils": "^0.4.3",
         "@types/bun": "1.3.14",
         "@types/figlet": "^1.7.0",
         "@types/node-notifier": "8.0.5",

package/spur-cli/config/rules/typescript/no-leaky-module-mocks.yaml

@@ -46,7 +46,9 @@ exclude:
   - "apps/web/tests/modules/task-kanban/board.test.tsx"
   - "apps/web/tests/modules/task-kanban/components.test.tsx"
   - "apps/web/tests/modules/task-kanban/new-task-panel.test.tsx"
+  - "apps/web/tests/modules/features/components.test.tsx"
   - "apps/web/tests/modules/task-kanban/task-detail.test.tsx"
+  - "apps/web/tests/modules/task-kanban/index.test.tsx"
 
 rules:
   - id: no-leaky-mock-module

package/spur-cli/config/workflows/docs-pipeline.yaml

@@ -0,0 +1,130 @@
+# Docs-only task pipeline — one run per documentation/design-doc deliverable.
+#
+# This sibling of task-pipeline.yaml handles tasks whose output is a document, not a
+# code change. It keeps docs deliverables out of the implement/test/verify code gate
+# and routes them through an explicit docs-review HITL gate.
+
+"$schema": "@gobing-ai/spur/schemas/state-machine-workflow.schema.json"
+kind: state-machine
+name: docs-pipeline
+description: "Docs-only execution pipeline (draft -> docs-review -> record -> done)"
+iterationBound: 12
+initialState: draft
+terminalStates:
+  - done
+  - failed
+  - cancelled
+vars:
+  wbs: "0000"
+  profile: "standard"
+  spurBin: "spur"
+  agent: "omp"
+  stepTimeoutMs: "600000"
+  __hitlAnswer: ""
+
+states:
+  - id: draft
+    description: >
+      Author or update the documentation deliverable for task ${vars.wbs}. This is a
+      docs-only path: do not run implementation, unit-test generation, or code review
+      steps from task-pipeline.yaml.
+    onEnter:
+      - kind: agent.run
+        options:
+          agent: ${vars.agent}
+          input: >-
+            /sp:dev-run --mode implement ${vars.wbs} --auto.
+            Treat this as a docs-only/design-doc deliverable: update the requested
+            documentation and do not add product code or tests unless the task
+            explicitly requires them.
+          timeoutMs: ${vars.stepTimeoutMs}
+      - kind: shell
+        options:
+          command: "${vars.spurBin} task update ${vars.wbs} wip --no-lifecycle"
+
+  - id: docs-review
+    description: >
+      Human documentation review gate. Under profile=auto this state is skipped; in
+      interactive mode it pauses for explicit approval before recording completion.
+    pause: true
+    onEnter:
+      - kind: hitl.confirm
+        options:
+          prompt: "Approve docs-only deliverable for task ${vars.wbs}?"
+
+  - id: record
+    description: >
+      Record the docs-only outcome into the task file. The task record verb backfills
+      Solution from the diff and moves the task to testing; the done gate still runs
+      the normal task matrix check before completion.
+    onEnter:
+      - kind: shell
+        options:
+          command: "${vars.spurBin} task record ${vars.wbs} --solution-from-diff --transition testing"
+
+  - id: done
+    description: Terminal — docs deliverable reviewed and recorded.
+    onEnter:
+      - kind: shell
+        options:
+          command: "${vars.spurBin} task update ${vars.wbs} done --no-lifecycle"
+      - kind: note
+        options:
+          message: "Docs pipeline complete for task ${vars.wbs}."
+
+  - id: failed
+    description: Terminal — docs pipeline failed or was rejected.
+
+  - id: cancelled
+    description: Terminal — docs pipeline cancelled by operator.
+
+transitions:
+  - from: draft
+    to: record
+    description: profile=auto — skip the docs-review HITL gate.
+    guard:
+      kind: shell
+      options:
+        command: 'test "${vars.profile}" = auto'
+  - from: draft
+    to: docs-review
+    description: Interactive — enter docs-review.
+    guard:
+      kind: always
+
+  - from: docs-review
+    to: record
+    description: Docs approved — record results.
+    guard:
+      kind: shell
+      options:
+        command: 'test "${vars.__hitlAnswer}" = yes'
+  - from: docs-review
+    to: failed
+    description: Docs rejected — stop for revision.
+    guard:
+      kind: shell
+      options:
+        command: 'test "${vars.__hitlAnswer}" = no'
+  - from: docs-review
+    to: cancelled
+    description: Operator cancelled docs review.
+    guard:
+      kind: shell
+      options:
+        command: 'test "${vars.__hitlAnswer}" = cancel'
+
+  - from: record
+    to: done
+    description: Task check passed — certify done.
+    guard:
+      kind: shell
+      options:
+        command: "${vars.spurBin} task check ${vars.wbs}"
+  - from: record
+    to: failed
+    description: Task check failed — block before done.
+    guard:
+      kind: shell
+      options:
+        command: '! ${vars.spurBin} task check ${vars.wbs}'