@gobing-ai/spur 0.3.1 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/spur",
-    "version": "0.3.1",
+    "version": "0.3.3",
     "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/schemas/section-matrix.schema.json

@@ -2,7 +2,7 @@
     "$schema": "http://json-schema.org/draft-07/schema#",
     "$id": "https://gobing.ai/spur/schemas/section-matrix.schema.json",
     "title": "Section-Status-Matrix Schema",
-    "description": "Validates config/tasks/section-matrix.yaml — which sections are required/optional/forbidden per task status. Design §3.2. Authored for ts-runtime's loadStructuredConfig validator (supports properties/required/additionalProperties + $defs/$ref/enum; NOT patternProperties/uniqueItems).",
+    "description": "Validates the shipped section-matrix.yaml — which sections are required/optional/forbidden per task status. Design §3.2. Authored for ts-runtime's loadStructuredConfig validator (supports properties/required/additionalProperties + $defs/$ref/enum; NOT patternProperties/uniqueItems).",
     "type": "object",
     "required": ["variants"],
     "additionalProperties": false,

package/spur-cli/config/config.example.yaml

@@ -15,7 +15,7 @@ bootstrap:
     console: false
     json: false
     file: true
-    filePath: .spur/spur.log # relative to project root
+    filePath: .spur/logs/spur.log # relative to project root
   telemetry:
     enabled: false # OFF by default for CLI (per-invocation latency)
     serviceName: spur

package/spur-cli/config/rules/boundary/sp-runtime-path.yaml

@@ -0,0 +1,32 @@
+$schema: "@gobing-ai/spur/schemas/rule-file.schema.json"
+# Runtime-path boundary rule (task 0217, R6) — zero `config/(plugins|rules|tasks|templates|workflows)`
+# references in agent-facing instructions and runtime source code. `config/` is the build-time
+# bundled-asset source-of-truth (ADR-015); `.spur/` is the runtime configuration directory that
+# agents and runtime code MUST reference. A `config/...` literal in scope teaches the wrong
+# convention and propagates confusion into every project created via `/sp:spur-init`.
+#
+# Blanket scope (all file types across apps/packages/plugins/sp) chosen deliberately:
+# even build-time JSDoc and test-fixture `config/` literals are caught, forcing rephrase rather
+# than false-positive triage. See task 0217 Design "Standing enforcement (R6)" for rationale.
+#
+# This is a STANDING gate (not transitional like rg-migration.yaml) — it runs on every pre-check.
+include:
+  - "apps/**"
+  - "packages/**"
+  - "plugins/sp/**"
+exclude:
+  - "**/node_modules/**"
+  - "**/dist/**"
+rules:
+  - id: sp-runtime-path
+    description: >
+      Use `.spur/` paths for runtime configuration references, not `config/`. `config/` is the
+      build-time bundled-asset source-of-truth (ADR-015); `.spur/` is the runtime directory.
+      Agent-facing instructions (`plugins/sp/`) and runtime code (`apps/`, `packages/`) MUST NOT
+      contain literal `config/plugins`, `config/rules`, `config/tasks`, `config/templates`, or
+      `config/workflows` path references.
+    severity: error
+    evaluator:
+      type: rg
+      config:
+        pattern: "config/(plugins|rules|tasks|templates|workflows)"

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}'