@gobing-ai/spur 0.4.23 → 0.4.25

package/plugins/sp/skills/doc-evolve/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: doc-evolve
 description: "Evolve docs/00-05 + AGENTS.md per docs/99_PROJECT_CONSTITUTION.md: drift audits, same-commit sync checks, frontmatter-contract verification, lesson-append. Triggers: \"doc evolve\", \"doc drift\", \"sync docs\", \"drift audit\", \"are the docs stale\", \"append a lesson\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

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

@@ -1,6 +1,7 @@
 ---
 name: dogfood-testing
 description: "Drive a testee (skill/command/CLI) end-to-end as a real user, fix within a bounded retry budget, monitor with a live ledger, emit a structured report. Triggers: \"dogfood this\", \"drive this command end-to-end\", \"test this skill as a user\", \"dogfood report\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/doubt-driven-development/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: doubt-driven-development
 description: "In-flight adversarial review of a non-trivial decision before you commit it: extract the artifact + contract, hand them (not your reasoning) to a fresh-context skeptic, reconcile findings, stop at 3 cycles. Triggers: \"doubt this\", \"stress-test this decision\", \"adversarial check before I commit\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/fleet-join/SKILL.md

@@ -5,6 +5,7 @@ description: >-
   "join the fleet", "become a fleet guest", "pull fleet inbox work in this session", or when a
   session should receive fleet messages without being supervised. Runs `spur agent join`, then
   loops `spur agent wait --inbox`, and releases the lease with `spur agent leave`.
+requires: [cli:spur, local-fs]
 metadata:
   version: "1.0"
 ---

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

@@ -1,6 +1,7 @@
 ---
 name: functional-review
 description: "Requirements traceability assessment: verify implementation satisfies ALL task requirements. Phase 8b gate for the sp pipeline. Produces per-requirement verdicts with file:line evidence. Triggers: \"functional review\", \"traceability check\", \"verify requirements\", \"did we build what was asked\", \"requirements completeness\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/history-anatomy/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: history-anatomy
 description: "Independent owner of diagnostic interpretation over already-imported history — the daily/ad-hoc mode contract, a closed finding taxonomy, the twelve-section report contract, and the enrich/validate rubrics. Triggers: history-anatomy, run the daily report, ad-hoc diagnosis, find issues over history."
+requires: [local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/indexed-context/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: indexed-context
 description: "Cross-agent project intelligence: file index (anatomy), learnings, pitfalls, bug log, token ledger, and session memory under .spur/context/. Triggers: \"load project context\", \"new session\", \"unfamiliar codebase\", \"index this codebase\", \"codebase memory\", \"indexed context\", \"project intelligence\"."
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

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

@@ -1,6 +1,7 @@
 ---
 name: issue-finding
 description: "Render the session forensics report, analyze agent session logs, find performance bottlenecks, propose fixes, and optionally create a structured task. Triggers: find issues, post-mortem, session review, topic focus."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 2.0.0
 metadata:

package/plugins/sp/skills/next-feature/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: next-feature
 description: "Prompt-first feature frontier prioritizer — answers 'which feature should we work on now?' by deriving importance/urgency from corpus, git, and authority-doc evidence, 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]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/next-router/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: next-router
 description: "Status→command router backing /sp:dev-next — resolve a task WBS or feature frontier, load corpus signals, look up TABLE A/B/C, dispatch exactly one existing /sp:dev-* command or stop with an exact dev-next: message. Never a second pipeline FSM. Triggers: \"what's next\", \"advance this task\", \"which dev command\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/parallel-execution/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: parallel-execution
 description: "Decide when to fan out independent work across subagents, choose the fan-out pattern, synthesize parallel results. Triggers: \"fan out\", \"run in parallel\", \"parallelize\", \"concurrent execution\", \"multi-agent run\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/pr-reviewing/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: pr-reviewing
 description: "Local-first PR review — status, a local /sp:dev-review of the branch diff, and validated fixes; `--codex` opts into the GitHub Codex review spine. Backs /sp:dev-pr-review. Triggers: PR review, codex review, @codex review, review my PR, dev-pr-review."
+requires: [cli:gh, cli:spur, local-fs]
 license: Apache-2.0
 version: 2.0.0
 metadata:

package/plugins/sp/skills/redesign-web-ui/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: redesign-web-ui
 description: "Upgrade an existing website or app UI past generic AI defaults without rewriting the stack. Triggers: \"redesign this UI\", \"make it look premium\", \"generic AI design\", \"polish this page\", \"restyle the web app\"."
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/reverse-engineering/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: reverse-engineering
 description: "Depth-driven codebase reverse engineering with orthogonal mode, focus, and output format controls. Use for unfamiliar codebases, architecture/design reconstruction, onboarding docs, technical debt assessment, and evidence-backed audit reports."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.1.0
 created_at: 2026-03-28

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

@@ -1,6 +1,7 @@
 ---
 name: session-review
 description: "Review the active coding-agent session: separate resolved from open issues with evidence, propose bounded improvements. With --fix auto (alias --triage), apply pure-doc / 1–2-line fixes inline and file the rest as tasks; with --fix all, fix every actionable finding inline and file none. Triggers: review this session, wrap-up, triage findings."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.3.0
 metadata:

package/plugins/sp/skills/source-driven-development/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: source-driven-development
 description: "Verify framework / API / library facts against primary sources before generating code, and separate \"the API exists\" from \"I used it correctly under its contract.\" The single sp owner of source-first verification. Triggers: \"check the docs first\", \"verify this API\", \"source-first\", \"is this the real signature\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/sp-bot-bootstrap/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: sp-bot-bootstrap
+description: "Bootstrap the sp toolchain (bun, spur, superskill, kk) on a Grok Bot computer or any fresh host: idempotent install skill that checks the PATH first, installs only what is missing, and is safe to re-run after a computer recreate. Triggers: \"bootstrap spur on Grok Bot\", \"install spur toolchain\", \"after computer recreate\"."
+requires: [local-fs]
+license: Apache-2.0
+metadata:
+  author: spur
+  version: "1.0"
+  platforms: "claude-code,codex,openclaw,opencode,antigravity"
+  interactions:
+    - environment-bootstrap
+  operations:
+    - check-toolchain
+    - install-toolchain
+---
+
+# sp-bot-bootstrap
+
+Bring a fresh host (typically a Grok Bot's cloud computer) to the minimum toolchain the sp
+plugin needs: the `bun` runtime plus the three CLIs `spur`, `superskill` and `kk`. The skill
+declares only `local-fs`: the fenced blocks resolve the tools on `PATH` and touch the official
+bun installer, so the 0162 scanner derives no registry-driven CLI requirement from this body.
+
+**Running it:**
+
+1. Run the **check** block.
+2. If check exits nonzero, run the **setup** block.
+3. Run the **check** block again — it must exit 0. If it does not, stop and report the check
+   output instead of retrying setup in a loop.
+
+Each block is standalone POSIX `sh`; run them exactly as they appear here. They only prepend
+`${BUN_INSTALL:-$HOME/.bun}/bin` to `PATH` inside the block, print one `missing: <tool>` line
+per absent tool, install with the official bun installer and `bun add -g`, and echo the
+`export PATH=…` line to append to the host environment. They never edit shell rc files, never
+read or write secrets or tokens, and write nothing outside `~/.bun` (the package manager's own
+cache aside).
+
+```sh sp-bot-bootstrap:check
+PATH="${BUN_INSTALL:-$HOME/.bun}/bin:$PATH"; export PATH; rc=0
+for pair in bun:bun spur:@gobing-ai/spur superskill:@gobing-ai/superskill kk:@gobing-ai/knowledge-kit; do
+  t=${pair%%:*}
+  if command -v "$t" >/dev/null 2>&1 && "$t" --version >/dev/null 2>&1; then
+    continue
+  fi
+  echo "missing: $t"
+  rc=1
+done
+exit $rc
+```
+
+```sh sp-bot-bootstrap:setup
+set -eu
+PATH="${BUN_INSTALL:-$HOME/.bun}/bin:$PATH"; export PATH
+if ! command -v bun >/dev/null 2>&1; then
+  curl -fsSL https://bun.sh/install | bash
+fi
+pkgs=""
+for pair in spur:@gobing-ai/spur superskill:@gobing-ai/superskill kk:@gobing-ai/knowledge-kit; do
+  t=${pair%%:*}
+  if ! command -v "$t" >/dev/null 2>&1; then
+    pkgs="$pkgs ${pair#*:}"
+  fi
+done
+if [ -n "$pkgs" ]; then
+  bun add -g $pkgs
+fi
+echo 'export PATH="${BUN_INSTALL:-$HOME/.bun}/bin:$PATH"'
+```
+
+**Team Setup Script variant:** to keep the toolchain present across computer recreates, an admin
+can register the **setup** block above as a Grok Team Setup Script (configured through the
+console; see https://docs.x.ai/grok-bot/private-networks — *unverified location*: confirm the
+exact console path with a probe receipt before relying on this pointer). The variant is the same
+block, unchanged, with the same idempotency: after a successful setup a rerun performs zero
+installs.

package/plugins/sp/skills/spec-decomposition/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spec-decomposition
 description: "The decomposition competency — turn a validated feature into a well-formed task batch passing task-batch.schema.json: scenario-to-task mapping, template variants, sizing. Triggers: \"decompose this\", \"break into tasks\", \"task batch\", \"create tasks from this feature\", \"split this work\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/spur-check/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spur-check
 description: 'Two-tier check primitive for the sp pipeline: light (changed-scope biome, per-workspace typecheck, related tests) during development; full (`spur self exec check`) once at the quality boundary. Reads/writes fingerprint-bound check receipts (.spur/run/<wbs>-check-receipt.json) and reuses a PASS full receipt only at the same proof digest.'
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/spur-cli/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spur-cli
 description: "Reference and operate the complete `spur` CLI surface: task, feature, rule, workflow, builder, agent, message, decision, self, history, and projects. Use for verb or flag lookup, machine-readable output and exit contracts, or CLI-gated corpus writes. Triggers: \"spur task\", \"spur history\", \"spur projects\", \"spur decision\", \"spur agent join\", \"create a task\", \"task check\", and any Spur CLI convention. Not for planning or execution lifecycle orchestration (`sp:spur-dev`)."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/spur-cli/references/history.md

@@ -9,7 +9,7 @@ see_also:
 
 `spur history` is the local history data plane: import transcripts into SQLite, aggregate a
 versioned artifact, render that artifact, or run the daily composition. Command registration and
-CLI guards live in `apps/cli/src/commands/history.ts` (`registerHistoryCommand`); payload contracts
+CLI guards live in `apps/cli/src/commands/history/` (`registerHistoryCommand` in `index.ts`, one file per verb); payload contracts
 live in `packages/app/src/services/history-service.ts` (`FanOutResult`, `DailyResult`,
 `HistoryService`, `runHistoryReport`) and `packages/domain/src/analytics/artifact.ts`
 (`HistoryArtifact`).

package/plugins/sp/skills/spur-composer/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spur-composer
 description: "Select, compose and tune spur artifacts — tasks, features, rules, workflows, decisions, agent specs and project Board modules. Owns workflow catalog selection, the ephemeral→project→shared ladder, ADR-115 budgets, trace-driven rule tuning and applying accepted sp:spur-doctor proposals. Triggers: compose a workflow, tune a rule, add a Board module."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/spur-dev/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spur-dev
 description: 'The thin orchestration spine for the planning→execution lifecycle: intake, feature-check/batch-create gates, the execution pipeline (precheck→implement→gate⇄remediate→review→done), catalog decision points, HITL gating. Dispatches competency skills; never inlines them. Triggers: "run the pipeline", "drive this task", "plan a feature end to end", "continue the pipeline run", or operating the full lifecycle.'
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/spur-doctor/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spur-doctor
 description: "Evaluate spur artifacts and plan/design Markdown from read-only evidence, reflect over sp:history-anatomy findings, and return a proposal table. Diagnoses artifacts, not runtime environments (that is spur agent doctor). Triggers: check artifact health, propose evolution, review legacy documents."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/sys-architecture/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: sys-architecture
 description: "The architecture competency — decide and record system design before code: module boundaries, data flow, build-vs-extend, transport/storage/auth tradeoffs, ADR routing. Triggers: \"what's the right approach\", \"design this\", \"architecture\", \"should this be an ADR\", \"module boundary\", \"build vs extend\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/sys-debugging/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: sys-debugging
 description: "The systematic debugging protocol: reproduce → isolate → root cause → fix → regression test. Triggers: \"debug this\", \"why is this failing\", \"fix this error\", \"what caused this\", \"trace this bug\", \"root cause\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/taste-refactoring-api/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: taste-refactoring-api
 description: Design, review, and refactor REST/HTTP, RPC/gRPC, GraphQL, and event API contracts safely.
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/taste-refactoring-architect/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: taste-refactoring-architect
 description: Review, simplify, and refactor system architecture toward minimum sufficient architecture while preserving required capabilities, quality attributes, delivery safety, and data invariants. Backs architectural refactoring and boundary reviews.
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/taste-refactoring-tests/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: taste-refactoring-tests
 description: Refactor unit tests for failure sensitivity, deterministic confidence, and regression protection without mock-heavy brittle tests or vanity coverage. Backs test suite quality audits.
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/taste-refactoring-ui/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: taste-refactoring-ui
 description: Design, review, and refactor UI hierarchy, layout, typography, spacing, color, and interactions.
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/test-driven-development/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: test-driven-development
 description: "Test-driven development discipline: red-green-refactor, behavior-first test design, AAA structure, naming, data builders, mock-at-boundary anti-patterns. Triggers: \"write tests first\", \"TDD\", \"red-green-refactor\", \"characterization test\", \"contract test\", \"how to structure/name a test\"."
+requires: [local-fs]
 license: Apache-2.0
 version: 1.0.0
 created_at: 2026-06-25

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

@@ -1,6 +1,7 @@
 ---
 name: wayfinder
 description: "Chart a multi-session investigation map when the destination is too foggy to spec in one session. Creates a spur feature as the map, decomposes specifiable questions into spur tasks, and resolves them one at a time until the route becomes visible. Triggers: wayfind, chart a course, multi-session investigation, /sp:dev-find-way."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 created_at: 2026-07-06