@gobing-ai/spur 0.3.27 → 0.3.28
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/config/templates/AGENTS.md +6 -6
- package/config/workflows/task-pipeline.yaml +9 -1
- package/package.json +9 -9
- package/spur.js +411 -206
|
@@ -33,10 +33,10 @@ All product development work goes through the harness by default.
|
|
|
33
33
|
### Harness tool routing
|
|
34
34
|
|
|
35
35
|
| Need | Route to | Avoid |
|
|
36
|
-
|
|
36
|
+
| ------ | ---------- | -------- |
|
|
37
37
|
| Plan a feature (intake → AC → tasks) | `/sp:dev-plan`, `/sp:dev-idea` | Freeform feature files without gates |
|
|
38
|
-
| Drive one task end-to-end | `/sp:dev-run <wbs>` or **`sp:super-
|
|
39
|
-
| Batch or parallel task runs | `/sp:dev-runall`, `/sp:dev-parallel` → **`sp:super-
|
|
38
|
+
| Drive one task end-to-end | `/sp:dev-run <wbs>` or **`sp:super-planner`** | Implement with no task / no pipeline |
|
|
39
|
+
| Batch or parallel task runs | `/sp:dev-runall`, `/sp:dev-parallel` → **`sp:super-planner`** | Unordered multi-task thrash |
|
|
40
40
|
| Batch-refine tasks under a feature | `/sp:dev-refineall --feature <id> --auto` | Hand-looping `/sp:dev-refine` per WBS |
|
|
41
41
|
| Multi-step corpus CLI (tasks/features/rules/workflows) | **`sp:expert-spur`** | Raw Write/Edit on corpus files |
|
|
42
42
|
| Look up `spur` verbs / flags / `--json` | Skill **`sp:spur-cli`** | Inventing flags from memory |
|
|
@@ -59,7 +59,7 @@ All product development work goes through the harness by default.
|
|
|
59
59
|
2. **Gates before done** — `spur task check` / `spur feature check` / `spur rule run`; pipeline done
|
|
60
60
|
needs a real verify **PASS**.
|
|
61
61
|
3. **`--json` for machines** — parse CLI with `--json`.
|
|
62
|
-
4. **Route, don’t invent** — verbs → `sp:spur-cli`; lifecycle → `/sp:dev-*` / `sp:super-
|
|
62
|
+
4. **Route, don’t invent** — verbs → `sp:spur-cli`; lifecycle → `/sp:dev-*` / `sp:super-planner`;
|
|
63
63
|
multi-noun corpus → `sp:expert-spur`; review → `sp:super-reviewer`; docs process → `sp:doc-evolve`.
|
|
64
64
|
5. **Keep tool ownership explicit** — project lifecycle/corpus/gates → Spur; plugin installation and
|
|
65
65
|
capability lifecycle → Superskill. Do not hand-maintain per-platform adapters Superskill generates.
|
|
@@ -84,7 +84,7 @@ authority first, then derived docs, then this file.
|
|
|
84
84
|
### Doc map
|
|
85
85
|
|
|
86
86
|
| Doc | Owns | Authority | When |
|
|
87
|
-
|
|
87
|
+
| ------ | ------ | ----------- | ------ |
|
|
88
88
|
| `docs/00_ADR.md` | **WHY** | Authoritative (content) | Structural change; dated entry before diverging |
|
|
89
89
|
| `docs/01_PRD.md` | **WHAT** | Authoritative on scope | New feature/command |
|
|
90
90
|
| `docs/02_ROADMAP.md` | **WHEN** | Derived | Phase placement |
|
|
@@ -134,7 +134,7 @@ _(Fill from package manifests / README — or during `sp:doc-evolve` customize.)
|
|
|
134
134
|
## Spur CLI surface
|
|
135
135
|
|
|
136
136
|
**Not the verb catalog.** For `task` / `feature` / `rule` / `workflow` flags, exit codes, and
|
|
137
|
-
`--json` shapes → skill **`sp:spur-cli`**. Lifecycle → `/sp:dev-*` / **`sp:super-
|
|
137
|
+
`--json` shapes → skill **`sp:spur-cli`**. Lifecycle → `/sp:dev-*` / **`sp:super-planner`**.
|
|
138
138
|
Multi-noun corpus campaigns → **`sp:expert-spur`**.
|
|
139
139
|
|
|
140
140
|
```bash
|
|
@@ -49,7 +49,15 @@ vars:
|
|
|
49
49
|
# Step-level timeout for agent.run steps in milliseconds. A timed-out agent
|
|
50
50
|
# subprocess is killed (not abandoned) and the step fails → pipeline routes to
|
|
51
51
|
# `failed`. Override per run with `--vars '{"stepTimeoutMs":120000}'`.
|
|
52
|
-
|
|
52
|
+
# Raised 600s → 1800s (task 0398 R4). The H6 dogfood batch lost 3 of its 4
|
|
53
|
+
# timeouts on `test` steps hitting exactly the 600s wall (0391, 0395 test;
|
|
54
|
+
# `.spur/run/*-test-partial.md`), the same failure signature that justified
|
|
55
|
+
# implementTimeoutMs below. Agentic test/review/verify steps read the diff,
|
|
56
|
+
# run the suite, and write a section — that does not fit in 10 min on this
|
|
57
|
+
# corpus. Same honesty rule as implementTimeoutMs: 30 min is headroom, not a
|
|
58
|
+
# licence to run unbounded. If a step still hits this wall, STOP and record it
|
|
59
|
+
# rather than raising again without operator sign-off.
|
|
60
|
+
stepTimeoutMs: "1800000"
|
|
53
61
|
# Timeout for the `implement` step specifically (R2a). Implementation is the
|
|
54
62
|
# heaviest agent.run step (full read/write/test-probe loop) and has timed out
|
|
55
63
|
# at the 600s default in five consecutive dogfood runs (bugs 742/744/746/748),
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gobing-ai/spur",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.28",
|
|
4
4
|
"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.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"spur",
|
|
@@ -50,14 +50,14 @@
|
|
|
50
50
|
},
|
|
51
51
|
"devDependencies": {
|
|
52
52
|
"@commander-js/extra-typings": "^14.0.0",
|
|
53
|
-
"@gobing-ai/ts-db": "^0.4.
|
|
54
|
-
"@gobing-ai/ts-ai-runner": "^0.4.
|
|
55
|
-
"@gobing-ai/ts-dual-workflow-engine": "^0.4.
|
|
56
|
-
"@gobing-ai/ts-infra": "^0.4.
|
|
57
|
-
"@gobing-ai/ts-llm-jsonl-importer": "^0.4.
|
|
58
|
-
"@gobing-ai/ts-rule-engine": "^0.4.
|
|
59
|
-
"@gobing-ai/ts-runtime": "^0.4.
|
|
60
|
-
"@gobing-ai/ts-utils": "^0.4.
|
|
53
|
+
"@gobing-ai/ts-db": "^0.4.15",
|
|
54
|
+
"@gobing-ai/ts-ai-runner": "^0.4.15",
|
|
55
|
+
"@gobing-ai/ts-dual-workflow-engine": "^0.4.15",
|
|
56
|
+
"@gobing-ai/ts-infra": "^0.4.15",
|
|
57
|
+
"@gobing-ai/ts-llm-jsonl-importer": "^0.4.15",
|
|
58
|
+
"@gobing-ai/ts-rule-engine": "^0.4.15",
|
|
59
|
+
"@gobing-ai/ts-runtime": "^0.4.15",
|
|
60
|
+
"@gobing-ai/ts-utils": "^0.4.15",
|
|
61
61
|
"@types/bun": "1.3.14",
|
|
62
62
|
"@types/figlet": "^1.7.0",
|
|
63
63
|
"@types/node-notifier": "8.0.5",
|