@gobing-ai/spur 0.3.9 → 0.3.11

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

@@ -17,6 +17,10 @@ include:
 exclude:
   - "**/node_modules/**"
   - "**/dist/**"
+  # `.pi-lens/cache/` holds autogenerated project snapshots (absolute paths that
+  # legitimately contain `config/...` substrings). Not source — exclude to avoid
+  # triaging snapshot noise every pre-check.
+  - "**/.pi-lens/**"
   # Package build artifacts: `build:bundle` copies repo-root config/ → apps/cli/config/
   # (and legacy spur-cli/config/). Those trees are the ADR-015 SSOT payload itself and
   # legitimately contain `config/...` documentation / self-references — not runtime paths.

package/config/rules/typescript/guarded-happy-dom-register.yaml

@@ -1,5 +1,5 @@
 $schema: "@gobing-ai/spur/schemas/rule-file.schema.json"
-# Require try/catch guard around GlobalRegistrator.register() in web tests.
+# Forbid raw GlobalRegistrator.register() in web tests — use the shared helper.
 #
 # WHY: GlobalRegistrator.register() sets up happy-dom globals (window, document,
 # etc.). In a full bun test suite, multiple test files call it. The first call
@@ -9,12 +9,10 @@ $schema: "@gobing-ai/spur/schemas/rule-file.schema.json"
 # `bun test ./apps/web/`), not when a single file runs in isolation.
 # Real incident: 52 CI-only failures across 4 test files, 2026-07-09.
 #
-# FIX: wrap in try/catch:
-#
-#   try { GlobalRegistrator.register(); } catch {} // already registered in suite
-#
-# The teardown helper (apps/web/tests/happy-dom.ts) is the sanctioned unregister
-# caller (see happy-dom-teardown.yaml). This rule guards the register side.
+# FIX: call `registerHappyDom()` from apps/web/tests/happy-dom.ts, which wraps
+# the register() in try/catch internally. It is the sanctioned caller and the
+# single exclude below. The teardown side is symmetric: `teardownHappyDom` is
+# the only sanctioned unregister() caller (see happy-dom-teardown.yaml).
 #
 # Severity warning: the file may pass in isolation but will fail in the full
 # suite; fix before merge.
@@ -24,41 +22,21 @@ include:
 exclude:
   - "**/node_modules/**"
   - "**/dist/**"
-  # Helper that manages happy-dom lifecycle — not a raw register call.
+  # The shared helper is the one legitimate caller of register().
   - "apps/web/tests/happy-dom.ts"
-  # These files already wrap register() in try/catch; they are compliant.
-  - "apps/web/tests/modules/task-kanban/board.test.tsx"
-  - "apps/web/tests/modules/task-kanban/components.test.tsx"
-  - "apps/web/tests/modules/task-kanban/task-detail.test.tsx"
-  - "apps/web/tests/modules/task-kanban/index.test.tsx"
-  - "apps/web/tests/modules/task-kanban/new-task-panel.test.tsx"
-  - "apps/web/tests/modules/task-kanban/markdown-body.test.tsx"
-  - "apps/web/tests/modules/task-kanban/useTaskParams.test.tsx"
-  - "apps/web/tests/modules/task-kanban/task-filters.test.tsx"
-  - "apps/web/tests/modules/task-kanban/useTasks.test.ts"
-  - "apps/web/tests/modules/features/components.test.tsx"
-  - "apps/web/tests/lib/theme.test.ts"
-  - "apps/web/tests/components/BoardLayout.test.tsx"
-  - "apps/web/tests/modules/observability/components.test.tsx"
-  - "apps/web/tests/components/ThemeToggle.test.tsx"
-  - "apps/web/tests/components/ResponsiveAndTheme.test.tsx"
 
 rules:
   - id: guarded-happy-dom-register
     description: >
-      GlobalRegistrator.register() must be wrapped in try/catch — without
-      it, the second test file that calls it throws "already been globally
-      registered" and all tests in that file are lost (a CI-only failure
-      that never reproduces when a single file runs in isolation). Wrap:
-      `try { GlobalRegistrator.register(); } catch {}`. 52-real CI incidents,
-      2026-07-09.
+      Do not call `GlobalRegistrator.register()` directly in a web test — a
+      second caller in the same suite throws "already been globally registered"
+      and loses every test in that file (a CI-only failure that never reproduces
+      in isolation). Use `registerHappyDom()` from apps/web/tests/happy-dom.ts,
+      which guards the call; it is the single sanctioned register() caller.
+      52-real CI incidents, 2026-07-09.
     severity: warning
     evaluator:
       type: rg
       config:
-        # Match bare GlobalRegistrator.register() — NOT inside try/catch
-        # Negative lookbehind: line does NOT start with "try" before the call
-        pattern: "GlobalRegistrator\\.register\\(\\)"
-        # Only flag lines where the call is NOT preceded by try{ on the same line
-        # (the fixed version is `try { GlobalRegistrator.register(); } catch {}`)
-        # We match the call itself and let the description guide the fix
+        # Match the raw call anywhere; the helper is excluded by path.
+        pattern: "GlobalRegistrator\\.register\\(\\)"

package/config/workflows/feature-dev.yaml

@@ -60,10 +60,10 @@ states:
 
   - id: execute-tasks
     description: >
-      Drive EVERY pending task under the feature to done. The agent enumerates the work with
-      `spur task list --feature ${featureId} --status todo --json`, then runs each task through
-      task-pipeline.yaml (precheck → implement → test → review → approve → verify → record → done). It
-      stops and reports on the first non-PASS verdict — a failing task fails the feature.
+      Drive EVERY pending task under the feature to done (e.g. `/sp:dev-runall --feature ${featureId} --auto`).
+      The agent enumerates the work with `spur task list --feature ${featureId} --status todo --json`,
+      then runs each task through task-pipeline.yaml (precheck → implement → test → review → approve → verify → record → done).
+      It stops and reports on the first non-PASS verdict — a failing task fails the feature.
     onEnter:
       - kind: agent.run
         options:
@@ -72,7 +72,7 @@ states:
             Run every pending task under feature ${vars.featureId} to done. Enumerate with
             `${vars.spurBin} task list --feature ${vars.featureId} --status todo --json`; then
             for each WBS run the standard single-task pipeline VERBATIM:
-            `${vars.spurBin} workflow run config/workflows/task-pipeline.yaml --vars
+            `${vars.spurBin} workflow run .spur/workflows/task-pipeline.yaml --vars
             '{"wbs":"<wbs>","profile":"${vars.profile}","agent":"${vars.agent}"}' --async --json`,
             polling `${vars.spurBin} workflow trace <run-id>` until terminal and inspecting
             `.spur/run/<wbs>-verdict.json`. Stop and report on the first non-PASS verdict

package/config/workflows/idea-pipeline.yaml

@@ -202,12 +202,12 @@ states:
   - id: handoff
     description: >
       Terminal — idea pipeline complete. Output: feature id, task WBS list, and
-      the next command to run (/sp:dev-run <first-wbs> or /sp:dev-runall --tasks feature:<id>).
+      the next command to run (/sp:dev-run <first-wbs> or /sp:dev-runall --feature <id> or --tasks feature:<id>).
       No task execution — the pipeline stops here.
     onEnter:
       - kind: note
         options:
-          message: "Idea pipeline handoff. Feature: ${vars.featureId}. Tasks created. Next: /sp:dev-runall --tasks feature:${vars.featureId}"
+          message: "Idea pipeline handoff. Feature: ${vars.featureId}. Tasks created. Next: /sp:dev-runall --feature ${vars.featureId}"
       # Checkpoint write: record session state for resume (Phase 4, task 0171 R3)
       - kind: shell
         options:

package/config/workflows/task-pipeline.yaml

@@ -243,7 +243,7 @@ transitions:
   # ── approve: HITL gate (reached only when profile != auto). Routed by the
   # operator's captured answer (R1, bug-750) — three ordered guards, declaration
   # order matters (yes first, then no, then cancel), mirroring idea-pipeline's
-  # design-approval gate (config/workflows/idea-pipeline.yaml:352-366). No
+  # design-approval gate (.spur/workflows/idea-pipeline.yaml:352-366). No
   # `always` edge remains out of `approve`. ──
   - from: approve
     to: verify

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/spur",
-    "version": "0.3.9",
+    "version": "0.3.11",
     "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",
@@ -50,14 +50,14 @@
     },
     "devDependencies": {
         "@commander-js/extra-typings": "^14.0.0",
-        "@gobing-ai/ts-db": "^0.4.8",
-        "@gobing-ai/ts-ai-runner": "^0.4.8",
-        "@gobing-ai/ts-dual-workflow-engine": "^0.4.8",
-        "@gobing-ai/ts-infra": "^0.4.8",
-        "@gobing-ai/ts-llm-jsonl-importer": "^0.4.8",
-        "@gobing-ai/ts-rule-engine": "^0.4.8",
-        "@gobing-ai/ts-runtime": "^0.4.8",
-        "@gobing-ai/ts-utils": "^0.4.8",
+        "@gobing-ai/ts-db": "^0.4.10",
+        "@gobing-ai/ts-ai-runner": "^0.4.10",
+        "@gobing-ai/ts-dual-workflow-engine": "^0.4.10",
+        "@gobing-ai/ts-infra": "^0.4.10",
+        "@gobing-ai/ts-llm-jsonl-importer": "^0.4.10",
+        "@gobing-ai/ts-rule-engine": "^0.4.10",
+        "@gobing-ai/ts-runtime": "^0.4.10",
+        "@gobing-ai/ts-utils": "^0.4.10",
         "@types/bun": "1.3.14",
         "@types/figlet": "^1.7.0",
         "@types/node-notifier": "8.0.5",

package/schemas/spur-config.schema.json

@@ -136,6 +136,70 @@
                     "additionalProperties": {
                         "type": "string"
                     }
+                },
+                "team": {
+                    "type": "object",
+                    "description": "Declarative agent teams keyed by team id (the map key is the teamId). Each team materializes a roster of agent specs (feature M). Mirrors @gobing-ai/spur-config TeamConfigSchema (Zod is SSOT).",
+                    "additionalProperties": {
+                        "type": "object",
+                        "required": ["name", "work_dir", "members"],
+                        "properties": {
+                            "name": {
+                                "type": "string",
+                                "minLength": 1,
+                                "description": "Human-readable team label."
+                            },
+                            "work_dir": {
+                                "type": "string",
+                                "minLength": 1,
+                                "description": "Default member workspace. A leading `~` is tilde-expanded at load."
+                            },
+                            "autostart": {
+                                "type": "boolean",
+                                "description": "Team-wide autostart default; per-member autostart overrides (effective = member.autostart ?? team.autostart ?? false)."
+                            },
+                            "members": {
+                                "type": "array",
+                                "minItems": 1,
+                                "description": "Roster of member references (>= 1). A bare string is shorthand for { executor: <string> }; the composed agent id is <teamId>-<id ?? executor>.",
+                                "items": {
+                                    "oneOf": [
+                                        { "type": "string", "minLength": 1 },
+                                        {
+                                            "type": "object",
+                                            "required": ["executor"],
+                                            "properties": {
+                                                "executor": {
+                                                    "type": "string",
+                                                    "minLength": 1,
+                                                    "description": "Executor name — resolved against agent.executors first, else a raw canonical agent type."
+                                                },
+                                                "id": {
+                                                    "type": "string",
+                                                    "minLength": 1,
+                                                    "description": "Local member id; composed id is <teamId>-<id ?? executor> (must match ^[a-z][a-z0-9_-]{1,63}$)."
+                                                },
+                                                "purpose": { "type": "string" },
+                                                "workspace": {
+                                                    "type": "string",
+                                                    "minLength": 1,
+                                                    "description": "Per-member workspace override. A leading `~` is tilde-expanded at load."
+                                                },
+                                                "model": { "type": "string", "minLength": 1 },
+                                                "autonomy": { "type": "string" },
+                                                "systemPrompt": { "type": "string" },
+                                                "command": {
+                                                    "type": "array",
+                                                    "items": { "type": "string", "minLength": 1 }
+                                                },
+                                                "autostart": { "type": "boolean" }
+                                            }
+                                        }
+                                    ]
+                                }
+                            }
+                        }
+                    }
                 }
             }
         },