@gobing-ai/spur 0.4.23 → 0.4.25

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
     "plugins": [
         {
             "name": "sp",
-            "version": "0.4.23",
+            "version": "0.4.25",
             "source": "./plugins/sp"
         }
     ]

package/config/rules/surface/check-cli-surface.yaml

@@ -62,6 +62,11 @@ rules:
       - "apps/cli/src/commands/task/wrapup.ts"
       - "apps/cli/src/commands/feature/handoff.ts"
       - "apps/cli/src/commands/feature/verify.ts"
+      # Per-noun shared.ts files that hold service factories only and declare no options
+      # (feature/history split, 03 §3 layout); `builder publish` declares no --json.
+      - "apps/cli/src/commands/feature/shared.ts"
+      - "apps/cli/src/commands/history/shared.ts"
+      - "apps/cli/src/commands/builder/publish.ts"
       # commit-guard-* declare no --json: its {staged, foreign} / {foreign} lines are rendered by
       # @gobing-ai/spur-app/commit-guard (byte-identical to the retired script, PR-4 golden).
       - "apps/cli/src/commands/workflow/commit-guard.ts"

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/spur",
-    "version": "0.4.23",
+    "version": "0.4.25",
     "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",

package/plugins/sp/README.md

@@ -333,6 +333,7 @@ surface or run one workflow. All skills target the same five core platforms: `cl
 | `functional-review`         | 1.0   | Requirements-traceability assessment — per-requirement verdicts with file:line evidence that the implementation satisfies ALL task requirements; pipeline Phase 8b gate                                                                    |
 | `doubt-driven-development`  | 1.0   | In-flight adversarial review of a non-trivial decision before committing it — hand artifact + contract to a fresh-context skeptic, reconcile, stop at 3 cycles                                                                             |
 | `source-driven-development` | 1.0   | Source-first verification — verify framework/API/library facts against primary sources before generating code; separates "the API exists" from "used correctly under its contract"                                                         |
+| `sp-bot-bootstrap`          | 1.0   | Grok Bot toolchain bootstrap — POSIX `sh` check/setup pair installing `bun` plus the three sp CLIs; idempotent after a computer recreate; Team Setup Script variant (1292, feature I14 R4) |
 | `dogfood-testing`           | 1.2   | Dogfood backbone — drives a testee end-to-end with bounded auto-fix, a live monitor ledger, and a structured report; @1.2 adds footer-mandatory reports, 7-check finalize-or-abort, and the `validate-report` CLI; backs `/sp:dev-dogfood` |
 | `next-router`               | 1.0   | Status→command router — resolve a task WBS or feature frontier, TABLE A/B/C lookup with light-gate short-circuit, single dispatch or HITL stop; backs `/sp:dev-next`                                                                       |
 | `parallel-execution`        | 1.0   | Fan-out decision framework — when to parallelize, four proven fan-out patterns, and result synthesis; backs `/sp:dev-runall --mode parallel\|auto`                                                                                                           |
@@ -709,6 +710,57 @@ pipeline owns one lifecycle phase:
 > (zero runs, example-only — `docs/design/workflow-catalogue-refactor.md` §10); the pattern lives on
 > as a test fixture (`packages/app/tests/services/fixtures/decision-routing-example.yaml`).
 
+#### Runtime `requires` metadata (task 1291, superskill 0162)
+
+Every sp entity (`skills/*/SKILL.md`, `commands/*.md`, `agents/*.md`) declares a `requires:`
+frontmatter list in the superskill 0162 grammar — a sorted YAML flow list of tokens:
+
+- `local-fs` — the entity acts on local project files. All 88 entities require it.
+- `cli:<tool>` — a tracked CLI the entity's body invokes directly (`spur`, `superskill`, `kk`,
+  `gh`) or inherits through a dispatched `Skill(skill="sp:<id>…")` skill.
+- `hooks` / `subagents` — reserved tokens; no sp entity currently declares either.
+
+The declared set intentionally equals the union of direct invocations and the transitive `requires`
+of every dispatch target, so the set stays self-maintaining:
+`plugins/sp/tests/runtime-requires.test.ts` derives the expected set from each entity body,
+compares it to the annotation (missing tokens fail on undeclared use, direct or inherited; extra
+stale tokens fail too), and pins the group snapshot from the 2026-11-04 scan: 70 entities
+`[cli:spur, local-fs]`, 2 `[cli:gh, local-fs]`, 2 `[cli:gh, cli:spur, local-fs]`, 14 `[local-fs]`.
+Consumers (e.g. `superskill skill validate`) read the same line, declaring what a skill needs
+before it runs instead of discovering it at invocation time.
+
+#### Grok Bot (task 1291, feature I14 R4)
+
+The `requires` annotations let a Grok Bot (superskill 0162) decide what it can run before it runs it.
+The four tokens mean, in Bot context:
+
+- `local-fs` — the entity needs the local project files (corpus, docs, git checkout). A Bot only has
+  these after a repo is cloned; the operator opts in with `--bot-provides local-fs`.
+- `cli:spur` / `cli:superskill` / `cli:kk` — the tracked, non-baseline CLIs the entity may invoke.
+  Until 1292's `sp-bot-bootstrap` skill installs them on the Bot, these are unmet.
+- `cli:gh` — `gh` CLI use; provide it only when `gh` is authenticated on the Bot.
+- `hooks` / `subagents` — reserved tokens; no sp entity declares either today.
+
+**sp hooks do not run on a Bot.** The hook tools that ship in `hooks/` (task-write guard, careful
+guard, context token ledger, fleet Stop delivery) are harness extensions; a Grok Bot session has no
+hook runtime, so those protections are not claimed on a Bot. Follow the skills' explicit gate
+instructions and the CLI validation instead.
+
+**With defaults every sp entity is excluded.** A Bot that meets none of the declared requirements
+installs nothing; an operator opts an entity set in explicitly with `--bot-provides`.
+
+**Bootstrap first (1292).** For a fresh Bot computer, follow the `sp-bot-bootstrap` skill —
+check, then setup only on a nonzero exit, then check again — before installing the plugin.
+
+**Recommended install after 1292's bootstrap** (follow the `sp-bot-bootstrap` skill first, which
+installs bun plus `spur`, `superskill` and `kk`), then:
+
+```
+superskill install sp --targets grok-bot --bot-provides cli:spur --bot-provides local-fs
+```
+
+plus `--bot-provides cli:gh` when `gh` is available on the Bot.
+
 ### Lifecycle operations
 
 All planning entities (tasks and features) share a common lifecycle, managed by the `spur` CLI:

package/plugins/sp/agents/expert-spur.md

@@ -9,6 +9,7 @@ description: |-
   assistant: "Delegating to sp:expert-spur — loads the task reference, resolves the set, then applies and checks each transition."
   <commentary>A multi-task sweep needs isolated sequencing and between-operation judgment.</commentary>
   </example>
+requires: [cli:spur, local-fs]
 tools: [Read, Grep, Glob, Bash, Skill]
 model: inherit
 color: green

package/plugins/sp/agents/super-coder.md

@@ -9,6 +9,7 @@ description: |
   assistant: "Delegating to sp:super-coder — dispatches sp:code-implementation to write the code against the task's requirements and AC."
   <commentary>A single task's implementation is the build agent's core unit of work.</commentary>
   </example>
+requires: [cli:spur, local-fs]
 tools: [Read, Grep, Glob, Bash, Skill]
 model: inherit
 color: blue

package/plugins/sp/agents/super-planner.md

@@ -9,6 +9,7 @@ description: |
   assistant: "Delegating to sp:super-planner — resolves feature:A1, topo-sorts by dependencies, runs each through task-pipeline.yaml, emits a report."
   <commentary>A batch needs between-runs judgment: set resolution, dependency ordering, failure policy.</commentary>
   </example>
+requires: [cli:spur, local-fs]
 tools: [Read, Grep, Glob, Bash, Skill]
 model: inherit
 color: green

package/plugins/sp/agents/super-reviewer.md

@@ -16,6 +16,7 @@ description: |
   assistant: "Delegating to sp:super-reviewer — pipeline Phase 7 review of task 0042's diff."
   <commentary>Pipeline review step.</commentary>
   </example>
+requires: [cli:spur, local-fs]
 tools: [Read, Grep, Glob, Bash, Skill]
 model: inherit
 color: crimson

package/plugins/sp/commands/dev-arch.md

@@ -1,5 +1,6 @@
 ---
 description: Survey a codebase (or module tree) for shallow modules and deepening opportunities — emit a ranked MARKDOWN candidate report that feeds the planning half; never auto-refactors
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "[<module-path>] [--scope <all|path>] [--agent <inline|auto|name>] [--json]"
 allowed-tools: ["Bash", "Read", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/dev-brainstorm.md

@@ -1,5 +1,6 @@
 ---
 description: Interactive solution design — heuristic discovery interview followed by structured ideation with trade-offs and confidence scoring
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "<topic> [--depth <basic|detailed|comprehensive>] [--options <n>] [--agent <inline|auto|name>] [--skip-discovery] [--task [<feature-id>]] [--feature [<parent-id>]] [--next]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-changelog.md

@@ -1,5 +1,6 @@
 ---
 description: Generate changelog from git commits
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "[<file>] [--since <tag|commit>] [--until <tag|commit>] [--version <version>]"
 allowed-tools: ["Bash", "Read", "Edit"]

package/plugins/sp/commands/dev-daily.md

@@ -1,5 +1,6 @@
 ---
 description: "Generate a daily summary report from agent usage data, git history, and notes"
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "[--date <YYYY-MM-DD>] [--dry-run] [--output <path>] [--no-git] [--no-ccusage]"
 allowed-tools: ["Bash", "Read"]

package/plugins/sp/commands/dev-debug.md

@@ -1,5 +1,6 @@
 ---
 description: "Systematic debugging protocol — reproduce, isolate, diagnose root cause, apply minimal fix, and verify with regression tests"
+requires: [cli:spur, local-fs]
 role: coder
 argument-hint: "\"<symptom | failing command>\" [--scope <path>] [--task [<wbs>]] [--agent <inline|auto|name>]"
 allowed-tools: ["Bash", "Read", "Write", "Skill"]

package/plugins/sp/commands/dev-dogfood.md

@@ -1,5 +1,6 @@
 ---
 description: Dogfood an agent skill/command/CLI — drive it end-to-end with bounded auto-fix, self-monitor, and emit a comprehensive report
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "<testee> [--agent <inline|auto|name>] [--max-retry <n>] [--save] [--task] [--chain-follow] [--full]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/dev-feature-change.md

@@ -1,5 +1,6 @@
 ---
 description: "Restructure the feature tree from a mapping file — dry-run then apply via spur feature move / task feature_id edges / root docs/*.md reference rewrites (CLI-gated; no raw Write on docs/features or docs/tasks). Triggers: feature restructure, feature tree move, reparent features, apply mapping file"
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "[--map <path>] [--dry-run] [--apply] [--limit <old-id>] [--wave <1|2|3|all>] [--yes]"
 allowed-tools: ["Bash", "Read", "AskUserQuestion", "Skill"]

package/plugins/sp/commands/dev-find-conflict.md

@@ -1,5 +1,6 @@
 ---
 description: "Authority-aware semantic audit across source, task files, feature files, and project authority files — discover conflicts, resolve claim-specific authority, collect reproducible evidence, and route confirmed repairs through owner surfaces. Triggers: find conflict, conflict audit, semantic conflict, authority mismatch, stale projection."
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "[--tasks <selector> | --feature <id>[,<id>] | --scope <path>[,<path>]] [--pillar <source|tasks|features|authority|all>] [--mode <adaptive|full>] [--resolve] [--auto] [--agent <inline|auto|name>] [--json]"
 allowed-tools: ["Bash", "Read", "Write", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/dev-find-issue.md

@@ -1,5 +1,6 @@
 ---
 description: "Generate the daily or ad-hoc history-anatomy diagnostic report over already-imported history: the twelve-section report contract, closed finding taxonomy, cache branch, bounded correction, and atomic publication. Triggers: find historical issues, post-mortem, performance analysis, history-anatomy, run the daily report, ad-hoc diagnosis"
+requires: [local-fs]
 role: reviewer
 argument-hint: "[<focus>] [--mode <daily|ad-hoc>] [--date <YYYY-MM-DD>] [--since <RFC3339>] [--until <RFC3339>] [--recompute] [--agent <auto|name>] [--output <path>]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-find-next.md

@@ -1,5 +1,6 @@
 ---
 description: "Prompt-first feature frontier prioritizer — answers 'which feature should we work on now?' with a ranked, evidence-carrying frontier, and emits rank-distorting tree defects as proposals /sp:dev-feature-change consumes. Triggers: find next, which feature, feature ranking, frontier priority, what should I work on."
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "[--task [<feature-id>]] [--agent <inline|auto|name>] [--auto] [--json]"
 allowed-tools: ["Bash", "Read", "Write", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/dev-find-way.md

@@ -1,5 +1,6 @@
 ---
 description: Wayfinder — chart a multi-session investigation map for a foggy destination, or resolve one map ticket, always inside an isolated git worktree + branch
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "<idea> | <feature-id> [<wbs>] [--agent <inline|auto|name>] [--auto] [--worktree [<name>]] [--wrap]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-fixall.md

@@ -1,5 +1,6 @@
 ---
 description: Fix all lint, type, and test errors systematically across the working tree
+requires: [local-fs]
 role: coder
 argument-hint: "[<validation-command>] [--max-retry <n>] [--scope <path>] [--gate-log <path>] [--findings <anchors>]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob"]

package/plugins/sp/commands/dev-fixgha.md

@@ -1,5 +1,6 @@
 ---
 description: Find and fix failing GitHub Actions runs — gh fetch → diagnose → root-cause fix → commit → push → re-verify until green
+requires: [cli:gh, local-fs]
 role: coder
 argument-hint: "[<context>] [--max-retry <n>] [--no-push]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob"]

package/plugins/sp/commands/dev-gitmsg.md

@@ -1,5 +1,6 @@
 ---
 description: Generate conventional commit message(s) from the current change set via one bounded gather call, optionally commit
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "[--commit] [--squash] [--all] [--scope <path>] [--check <cmd>]"
 allowed-tools: ["Bash", "Read"]

package/plugins/sp/commands/dev-gtd.md

@@ -1,5 +1,6 @@
 ---
 description: Get things done — quality gate → fix → commit → push → gh verify in one flow (optional act CI simulation via --act)
+requires: [cli:gh, local-fs]
 role: coder
 argument-hint: "[<quality-gate-command>] [--dry-run] [--act] [--no-push] [--no-verify] [--scope <path>] [--max-retry <n>]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob"]

package/plugins/sp/commands/dev-handover.md

@@ -1,5 +1,6 @@
 ---
 description: Generate a structured handover document when blocked — captures goal, progress, blocker, rejected approaches, and next steps
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "\"<blocker description>\""
 allowed-tools: ["Bash", "Read", "Write"]

package/plugins/sp/commands/dev-idea.md

@@ -1,5 +1,6 @@
 ---
 description: Turn a vague idea into a feature with AC and a decomposed task batch — discovery, idea-eval, feature-create, AC, system-design, decompose, batch-create (Design by default), handoff
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "\"<idea>\" | --from-file <path> [--skip-design] [--agent <inline|auto|name>] [--auto]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-job-dump.md

@@ -1,5 +1,6 @@
 ---
 description: Dump remaining work to a Markdown handoff file
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "--file <path>"
 allowed-tools: ["Bash", "Read", "Write", "Skill"]

package/plugins/sp/commands/dev-job-resume.md

@@ -1,5 +1,6 @@
 ---
 description: Resume remaining work from a Markdown handoff file
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "--file <path>"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Skill"]

package/plugins/sp/commands/dev-next.md

@@ -1,5 +1,6 @@
 ---
 description: Status-aware router — pick and run the next best /sp:dev-* step for a task or feature frontier
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "[<wbs|feature-id>] [--dry-run] [--once] [--auto] [--agent <inline|auto|name>] [--full]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-plan.md

@@ -1,5 +1,6 @@
 ---
 description: Plan a feature from a description — intake → feature create → AC generation → decomposition → batch-create (Design by default)
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "\"<description>\" [--feature <id>] [--parent <feature-id>] [--skip-design] [--agent <inline|auto|name>] [--auto]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-pr-review.md

@@ -1,5 +1,6 @@
 ---
 description: "Local-first PR review — status, a local branch-diff review, and validated fixes; --codex opts into the GitHub Codex review spine."
+requires: [cli:gh, cli:spur, local-fs]
 role: reviewer
 argument-hint: "[status|review|fix] [--codex] [--force] [--no-wait] [--base <branch>] [--agent <inline|auto|name>] [<focus>]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-refactor.md

@@ -1,5 +1,6 @@
 ---
 description: Lens-routed refactoring with a preservation contract — taste lenses classify findings against the shared schema; cutting/breaking changes pause for operator approval
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "[<description>] [--scope <path>] [--focus <api|architect|tests|ui|auto>] [--fix <none|blockers-first|all>] [--check <cmd>] [--agent <inline|auto|name>] [--auto]"
 allowed-tools: ["Bash", "Read", "Edit", "Skill"]

package/plugins/sp/commands/dev-refine.md

@@ -1,5 +1,6 @@
 ---
 description: Refine or re-audit a task — fill missing sections via Q&A, or with --depth ready verify existing claims and fixes against the tree, correct them, and promote to todo
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "<wbs> [--focus <mode>] [--description <text>] [--depth <standard|ready>] [--agent <inline|auto|name>] [--auto] [--next]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-refineall.md

@@ -1,5 +1,6 @@
 ---
 description: Refine a batch of tasks via structured Q&A — resolve a set (feature or selector), refine each in dependency-correct order, emit a batch report; --depth ready audits, corrects and promotes each task
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "--feature <id> | --tasks <selector> [--focus <mode>] [--description <text>] [--depth <standard|ready>] [--agent <inline|auto|name>] [--auto] [--keep-going] [--status <s>] [--json] [--worktree [<name>]]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-refresh.md

@@ -1,5 +1,6 @@
 ---
 description: Refresh feature status by feature ID, task WBS, or batch sweep via spur feature sync
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "[<feature-id|wbs>] [--all] [--auto] [--agent <inline|auto|name>]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-reverse.md

@@ -1,5 +1,6 @@
 ---
 description: Reverse engineer a codebase with selectable depth, focus, and output format
+requires: [cli:spur, local-fs]
 role: coder
 argument-hint: "[<path>] [--mode <briefing|structure|architecture|design|full>] [--focus <all|stack|dependencies|data|flows|api|security|quality|performance>] [--format <markdown|json|both>] [--output <file>] [--agent <inline|auto|name>]"
 allowed-tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash", "Skill"]

package/plugins/sp/commands/dev-review-session.md

@@ -1,5 +1,6 @@
 ---
 description: "Review the active coding-agent session immediately: summarize outcomes, distinguish resolved and open issues with evidence, and propose bounded improvements. With --fix auto (alias --triage): apply pure-doc / one-to-two-line fixes inline, then file remaining findings as one or more implement-ready tasks. With --fix all: fix every actionable finding inline and file no task. Triggers: review this session, session wrap-up, immediate retrospective, what happened, what was resolved, triage findings"
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "[<focus>] [--fix <none|auto|all>] [--triage]"
 allowed-tools: ["Bash", "Read", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/dev-review.md

@@ -1,5 +1,6 @@
 ---
 description: "Review code for a task set or paths — multi-dimensional review across functional traceability, SECUA quality, and architectural depth. With --triage: fix small findings directly, then file the rest as implement-ready tasks. Triggers: \"review this\", \"check the code\", \"SECUA review\", \"dev review\", \"audit this\", \"triage review findings\"."
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "[--tasks <selector> | --feature <id>[,<id>] | --scope <path>[,<path>]] [--agent <inline|auto|name>] [--focus <dims>] [--triage] [--worktree [<name>]] [--auto]"
 allowed-tools: ["Bash", "Read", "Skill", "Edit", "Write"]

package/plugins/sp/commands/dev-run.md

@@ -1,5 +1,6 @@
 ---
 description: Run a task — full pipeline (precheck→implement→test→review→approve→verify→record→done) or single-step (implement)
+requires: [cli:spur, local-fs]
 role: coder
 argument-hint: "<wbs> [--mode <full|implement>] [--agent <inline|auto|name>] [--auto] [--next] [--wrap] [--continue] [--worktree [<name>]] [--no-summary]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Skill"]

package/plugins/sp/commands/dev-runall.md

@@ -1,5 +1,6 @@
 ---
 description: Run a batch of tasks through their pipelines in dependency-correct order — resolve a set, topo-sort, run each via task-pipeline.yaml, emit a batch report
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "--tasks <selector> [--feature <id>] [--mode <sequential|parallel|auto>] [--concurrency <n>] [--keep-going] [--auto] [--agent <inline|auto|name>] [--json] [--wrap] [--next] [--continue] [--worktree [<name>]] [--no-summary] [--defer-gate]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-simplify.md

@@ -1,5 +1,6 @@
 ---
 description: Simplify code for clarity without changing behavior — reduce complexity in recent changes (or a given scope), preserving behavior exactly
+requires: [local-fs]
 role: coder
 argument-hint: "[<path-or-scope>] [--scope <recent|all|path>] [--check <cmd>] [--agent <inline|auto|name>] [--auto]"
 allowed-tools: ["Bash", "Read", "Edit", "Skill"]

package/plugins/sp/commands/dev-unit.md

@@ -1,5 +1,6 @@
 ---
 description: Generate or extend tests until the unit target is met
+requires: [local-fs]
 role: coder
 argument-hint: "<target> [--coverage <n>] [--agent <inline|auto|name>] [--auto]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Skill"]

package/plugins/sp/commands/dev-verify.md

@@ -1,5 +1,6 @@
 ---
 description: Verify a task against its requirements and Acceptance Criteria — traceability check producing a PASS/PARTIAL/FAIL verdict with evidence
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "<wbs> [--agent <inline|auto|name>] [--fix <none|blockers-first|all>] [--focus <lens>] [--bdd] [--auto] [--force] [--next] [--skip-shippable]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-verifyall.md

@@ -1,5 +1,6 @@
 ---
 description: Verify a batch of tasks against their requirements and Acceptance Criteria — batch traceability check producing per-task verdicts and a summary report
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "--tasks <selector> [--feature <id>] [--agent <inline|auto|name>] [--fix <none|blockers-first|all>] [--focus <lens>] [--bdd] [--auto] [--force] [--next] [--json] [--skip-shippable] [--worktree [<name>]]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-wrap.md

@@ -1,5 +1,6 @@
 ---
 description: Wrap up a single completed task — learnings, metrics, doc-sync, optional branch cleanup
+requires: [cli:spur, local-fs]
 role: coder
 argument-hint: "<wbs> [--agent <inline|auto|name>] [--auto] [--merge] [--dry-run]"
 allowed-tools: ["Bash", "Read", "AskUserQuestion"]

package/plugins/sp/commands/dev-wrapall.md

@@ -1,5 +1,6 @@
 ---
 description: Wrap up a batch of completed tasks — learnings, metrics, doc-sync, optional branch cleanup
+requires: [cli:spur, local-fs]
 role: coder
 argument-hint: "[--since <iso-date>] [--feature <id>] [--status <s>] [--agent <inline|auto|name>] [--auto] [--merge] [--dry-run]"
 allowed-tools: ["Bash", "Read", "AskUserQuestion"]

package/plugins/sp/commands/rule-add.md

@@ -1,5 +1,6 @@
 ---
 description: Author a validated, smoke-tested constraint rule
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "\"<description>\" [--file <path>] [--preset <target>]"
 allowed-tools: ["Bash", "Read", "Write", "Skill"]

package/plugins/sp/commands/rule-refine.md

@@ -1,5 +1,6 @@
 ---
 description: Refine a constraint rule or preset, then re-verify it
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "<rule-file-or-preset> [--intent \"<goal>\"] [--severity <sev>] [--scope <glob>] [--exempt <path>] [--disable <id>] [--override <id>] [--dry-run]"
 allowed-tools: ["Bash", "Read", "Edit", "Skill"]

package/plugins/sp/commands/rule-scan.md

@@ -1,5 +1,6 @@
 ---
 description: Discover recurring anti-patterns worth codifying as rules
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "[<path-or-glob>]"
 allowed-tools: ["Bash", "Read", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/spur-init.md

@@ -1,5 +1,6 @@
 ---
 description: Initialize a new Spur project — scaffold config + docs, then customize for this project's stack and scope
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "[--name <name>] [--minimal] [--force]"
 allowed-tools: ["Bash", "Read", "Write", "Skill"]

package/plugins/sp/commands/workflow-add.md

@@ -1,5 +1,6 @@
 ---
 description: Author a validated, dry-run-verified workflow in the right execution mode
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "\"<description>\" [--kind <state-machine|transition-flow>] [--file <path>]"
 allowed-tools: ["Bash", "Read", "Write", "Skill"]

package/plugins/sp/commands/workflow-refine.md

@@ -1,5 +1,6 @@
 ---
 description: Refine an existing workflow, then re-validate and re-dry-run it
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "<workflow-file> [--intent \"<goal>\"] [--dry-run]"
 allowed-tools: ["Bash", "Read", "Edit", "Skill"]

package/plugins/sp/plugin.json

@@ -1,5 +1,5 @@
 {
     "name": "sp",
-    "version": "0.4.23",
+    "version": "0.4.25",
     "description": "Spur — a local-first harness engineering toolkit that wraps mainstream coding agents with constraint checking, workflow orchestration, and history analytics."
 }

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

@@ -1,6 +1,7 @@
 ---
 name: brainstorm
 description: "Structured ideation: generate solution options with trade-offs and source citations, then delegate to research/task-creation skills. Triggers: \"brainstorm ideas\", \"explore solutions\", \"consider options\", \"research approaches\", \"what are my options\", \"how should I approach X\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 created_at: 2026-03-25

package/plugins/sp/skills/branch-workflow/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: branch-workflow
 description: "Branch lifecycle discipline: create, worktree, commit, self-review, merge, cleanup."
+requires: [cli:spur, local-fs]
 disable-model-invocation: true
 license: Apache-2.0
 metadata:

package/plugins/sp/skills/code-implementation/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-implementation
 description: "The implementation competency — turn a task's requirements, AC, and design into production code: task-driven scope, stack-pattern selection, root-cause debugging, a Solution change-map. Triggers: \"implement\", \"write code\", \"add feature\", \"fix the bug\", \"refactor\", \"code this task\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-improvement/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-improvement
 description: "Surface architectural friction and propose deepening opportunities — refactors that turn shallow, tightly-coupled modules into deep, testable, AI-navigable ones. Triggers: \"improve architecture\", \"find refactoring opportunities\", \"shallow module\", \"hard to test\", \"reduce coupling\", \"deepen modules\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-refactoring/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-refactoring
 description: "Refactoring coordinator with a preservation contract: routes the four taste lenses (api, architect, tests, ui), normalizes findings to a shared schema and P1–P4 severities, gates applies, runs a fix ladder with revert-on-regression. Use for 'dev-refactor', 'safe refactor', 'refactor while keeping every feature'."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-review/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-review
 description: "Pre-commit self-review checklist, structured review requests, and processing review findings into tasks. Triggers: \"review this\", \"self-review\", \"pre-commit check\", \"code review\", \"review my changes\", \"check before commit\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-simplification/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-simplification
 description: "Simplify code for clarity without changing behavior. Use when refactoring for readability or reducing complexity."
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-testing/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-testing
 description: "The testing competency — run tests, measure coverage, categorize gaps, extend the suite with targeted tests across Bun/TS, Python, Go. Triggers: \"write tests\", \"measure coverage\", \"what's untested\", \"coverage gap\", \"extend the test suite\", \"run the tests\"."
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-verification/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-verification
 description: "Verify a task's implementation against requirements and AC; SECUA code review. Produces a PASS/PARTIAL/FAIL verdict with per-requirement evidence. Triggers: \"verify task\", \"verify this\", \"check the requirements\", \"code review\", \"SECUA review\", \"requirements traceability\", \"review the diff\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/conflict-finding/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: conflict-finding
 description: "Authority-aware semantic audit across source, task files, feature files, and project authority files — detect conflicts, resolve claim-specific authority, collect reproducible evidence, and route confirmed repairs through owner surfaces. Triggers: find conflict, conflict audit, semantic conflict, authority mismatch, stale projection."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/daily-summary/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: daily-summary
 description: "Generate a daily summary report from agent usage, git history, and your notes."
+requires: [cli:spur, local-fs]
 disable-model-invocation: true
 license: Apache-2.0
 version: 1.0.0