@gobing-ai/spur 0.3.96 → 0.3.98

package/.claude-plugin/marketplace.json

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

package/config/rules/strict/runtime-boundaries.yaml

@@ -68,6 +68,7 @@ rules:
             - "apps/cli/src/commands/workflow.ts" # FD byte-window tail of the mid-run run log for `workflow trace --follow` streaming (task 0428 / feature D2); readSync at offset over the observability sink's FDs
             - "apps/web/src/modules/discover.ts" # Vite/Astro module scanner fallback under bun test
             - "packages/app/src/services/quality-gate.ts" # gate artifacts (log/findings/receipt) written directly; merged-fd gate log and fsync-free atomic writes must stay byte-stable; bundled standalone for the bare-node plugin twin (task 1006 R1; mirrors history-anatomy.ts)
+            - "packages/app/src/services/run-storage.ts" # durable-evidence migration core (task 1025 R4): atomic tmp+rename byte copies with digest reread and atomic manifest publish must stay byte-stable (mirrors agent-usage-producer.ts / project-registry.ts exemptions)
 
             # Synchronous bootstrap & path resolution:
             - "packages/config/src/bundled-config.ts" # sync bundledConfigRoot() directory walk

package/config/templates/AGENTS.md

@@ -163,9 +163,9 @@ spur <noun> --help
 **Long-tail:** Additional `/sp:dev-*` commands (handover, gitmsg, fixall, findconflict, dogfood, reverse, arch,
 …) are indexed in the project plugin README (`plugins/sp/README.md` when present).
 
-**Outside spur-cli:** Nouns not fully documented in `sp:spur-cli` (`agent`, `history`, `message`,
-`team`, `status`, `migrate`, `serve`, `init`, …) — use only `spur <noun> --help` and
-`docs/04_DESIGN.md`. Never guess flags.
+**Outside spur-cli:** For nouns without a reference file, use only `spur <noun> --help` and
+`docs/04_DESIGN.md`; never guess flags. Agent/message/self/projects references live under
+`plugins/sp/skills/spur-cli/references/`.
 
 ---
 

package/config/workflows/wrapup-pipeline.yaml

@@ -139,7 +139,8 @@ states:
   - id: task-resolve
     description: >
       Validate the task list ONCE and evaluate closed proportional routing (0758
-      R1-R4). Validation (0770 + 0783): vars.tasks must be a JSON array of
+      R1-R4). When vars.feature is set, resolve also runs the feature pre-flight
+      (1033 R2). Validation (0770 + 0783): vars.tasks must be a JSON array of
       canonical four-digit WBS strings — non-arrays, non-strings, whitespace or
       other shapes are rejected, not trimmed — deduplicated in first-seen
       order, with __runId present, and every member must resolve via `spur task

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/spur",
-    "version": "0.3.96",
+    "version": "0.3.98",
     "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,7 +49,7 @@
         "dev": "bun run src/index.ts",
         "build": "bun run ../../scripts/spur-dev.ts build-cli",
         "build:binaries": "bun run ../../scripts/spur-dev.ts build-binaries",
-        "build:bundle": "bun run ../../scripts/spur-dev.ts bundle-web && bun run ../../scripts/spur-dev.ts emit-board-types && bun build src/index.ts --target=bun --outfile spur.js && bun run ../../scripts/spur-dev.ts bundle-config config && bun run ../../scripts/spur-dev.ts bundle-plugins",
+        "build:bundle": "bun run ../../scripts/commands/bundle-plugin-lib.ts && bun run ../../scripts/spur-dev.ts bundle-web && bun run ../../scripts/spur-dev.ts emit-board-types && bun build src/index.ts --target=bun --outfile spur.js && bun run ../../scripts/spur-dev.ts bundle-config config && bun run ../../scripts/spur-dev.ts bundle-plugins",
         "test": "bun test tests --coverage --coverage-dir=../../.coverage --pass-with-no-tests",
         "typecheck": "tsc --noEmit",
         "prepack": "bun run build:bundle",

package/plugins/sp/README.md

@@ -10,8 +10,8 @@ lifecycle step a deterministic entry point.
 > orchestration, history analytics, and operational visibility. The `sp` plugin is the Claude Code
 > plugin surface for that toolkit.
 
-- **Marketplace entry:** `name: "sp"`, `version: "0.3.41"`, `source: "./plugins/sp"` (`plugin.json`,
-  kept in sync with `.claude-plugin/marketplace.json`).
+- **Marketplace entry:** `name: "sp"`, `source: "./plugins/sp"`; the release version lives in
+  [plugin.json](plugin.json), kept in sync with `.claude-plugin/marketplace.json`.
 - **Owner:** Robin Min.
 
 Read this file first for the map; read [skills/spur-dev/SKILL.md](skills/spur-dev/SKILL.md) for the
@@ -68,6 +68,10 @@ single-task wrap-up closes out a whole set of completed tasks in one pass.
 
 ### Crossing a session boundary
 
+For any unfinished job, use `/sp:dev-job-dump --file <path>` to save a Markdown snapshot and
+`/sp:dev-job-resume --file <path>` in the next session to reconcile state and continue the remaining
+work. Include the referenced checkout and evidence files when transferring to another machine.
+
 Two different problems, two different tools:
 
 - **The harness compacts your context mid-task.** That's normal. Keep the _planning_ half in one
@@ -125,6 +129,8 @@ list this README is checked against.
 | Command             | What it does                                                                                                                                                                                      |
 | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `dev-handover`      | Generate a structured handover document when blocked — captures goal, progress, blocker, rejected approaches, and next steps                                                                      |
+| `dev-job-dump`      | Save the current job, verified environment and ordered remaining work to a specified Markdown handoff file |
+| `dev-job-resume`    | Reconcile a Markdown handoff with current state and continue the remaining job through its existing owner |
 | `dev-debug`         | Systematic debugging protocol — reproduce, isolate, diagnose root cause, apply minimal fix, and verify with regression tests                                                                      |
 | `dev-daily`         | Generate a daily summary report from agent usage data, git history, and notes                                                                                                                     |
 | `dev-dogfood`       | Dogfood an agent skill/command/CLI — drive it end-to-end with bounded auto-fix, self-monitor, and emit a comprehensive report                                                                     |
@@ -187,7 +193,7 @@ pipeline step.
 
 ```
 plugins/sp/
-├── skills/                          # Domain knowledge + workflow docs (39 skills)
+├── skills/                          # Domain knowledge + workflow docs (see the skills table)
 │   ├── brainstorm/                  # Structured ideation workflow
 │   │   ├── agents/openai.yaml
 │   │   ├── examples/ideation-example.md
@@ -264,7 +270,7 @@ plugins/sp/
 │   ├── taste-refactoring-tests/     # Test-suite failure-sensitivity refactor
 │   ├── taste-refactoring-ui/        # UI hierarchy, layout, typography + interaction refactor
 │   └── wayfinder/                   # Multi-session investigation maps (SKILL.md only)
-├── commands/                        # 39 slash-command wrappers — the SSOT (hand-editable thin wrappers; see Commands below)
+├── commands/                        # Slash-command wrappers — the SSOT (hand-editable thin wrappers; see Commands below)
 ├── agents/                          # 4 specialist subagents (expert-spur, super-coder, super-planner, super-reviewer)
 ├── hooks/                           # hooks.json + task-write-guard.{ts,test.ts} + context-{session-start,post-tool,session-stop}.ts
 │                                    # + careful-guard.{ts,test.ts} + context-hooks.test.ts + token-estimate.test.ts
@@ -380,8 +386,8 @@ Skills contain zero validation logic — the CLI is the gate.
 #### 2. Commands (`commands/`)
 
 Thin slash-command wrappers that parse user arguments and delegate to the corresponding skill. Each
-command is a user-facing entry point that bridges natural language to skill invocation. There are
-**39 commands** (see the Command index above for the full list), organized by the surface they wrap:
+command is a user-facing entry point that bridges natural language to skill invocation. The Command
+index above lists the live inventory, organized by the surface they wrap:
 
 | Prefix       | Count | Delegates to                                                                                                                                                                                                                                                                                                        | Purpose                                                                                |
 | ------------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
@@ -395,7 +401,7 @@ Each command file contains:
 - YAML frontmatter (`description`, `argument-hint`, `allowed-tools`).
 - A delegation block: `Skill(skill="sp:<skill-name>", args="<operation> $ARGUMENTS")`.
 
-**Commands as SSOT (ADR-032).** The 39 `.md` files in `commands/` are the authoritative,
+**Commands as SSOT (ADR-032).** The `.md` files in `commands/` are the authoritative,
 hand-editable source for the operator command surface. Per-platform adapters are **install-time
 output** owned by `superskill` (`superskill install sp`) and never committed here. Plugin `sp` ships
 no per-platform artifacts — only the platform-independent thin wrappers.
@@ -403,7 +409,7 @@ no per-platform artifacts — only the platform-independent thin wrappers.
 **Thin-wrapper contract** is enforced by `scripts/commands/validate-commands.ts`:
 
 ```bash
-bun run validate-commands            # validate all 39 commands
+bun run validate-commands            # validate all command wrappers
 bun run validate-commands --json     # machine-readable output
 ```
 
@@ -524,7 +530,7 @@ the hard gate that the soft skill cannot enforce on its own.
 ```mermaid
 graph TB
     subgraph "User entry points"
-        CMD["Commands<br/>39 slash commands<br/>/sp:dev-plan, /sp:dev-runall, /sp:dev-review-session, /sp:rule-add, ..."]
+        CMD["Commands<br/>Slash-command wrappers<br/>/sp:dev-plan, /sp:dev-runall, /sp:dev-review-session, /sp:rule-add, ..."]
         AGENT["Agents<br/>4 subagents<br/>expert-spur, super-coder, super-planner, super-reviewer"]
         HOOK["PreToolUse hook<br/>Write|Edit matcher"]
     end

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

@@ -0,0 +1,29 @@
+---
+description: Dump remaining work to a Markdown handoff file
+role: scribe
+argument-hint: "--file <path>"
+allowed-tools: ["Bash", "Read", "Write", "Skill"]
+---
+
+# Dev Job Dump
+
+Wraps the **sp:spur-dev** skill.
+
+## Argument Flags
+
+| Flag | Description | Default |
+| --- | --- | --- |
+| `--file <path>` | Markdown file to write or refresh with the current job handoff. | required |
+
+For shared semantics, see the [flag glossary](../skills/spur-dev/references/flag-glossary.md).
+
+## Usage
+
+/sp:dev-job-dump --file <path>
+
+## Implementation
+
+Follow [job-dump](../skills/spur-dev/references/dev-operations.md#11a-job-dump), using the shared
+handoff template to capture the current job and its remaining work.
+
+Skill(skill="sp:spur-dev", args="job-dump $ARGUMENTS")

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

@@ -0,0 +1,29 @@
+---
+description: Resume remaining work from a Markdown handoff file
+role: planner
+argument-hint: "--file <path>"
+allowed-tools: ["Bash", "Read", "Write", "Edit", "Skill"]
+---
+
+# Dev Job Resume
+
+Wraps the **sp:spur-dev** skill.
+
+## Argument Flags
+
+| Flag | Description | Default |
+| --- | --- | --- |
+| `--file <path>` | Markdown handoff file to read before continuing the remaining work. | required |
+
+For shared semantics, see the [flag glossary](../skills/spur-dev/references/flag-glossary.md).
+
+## Usage
+
+/sp:dev-job-resume --file <path>
+
+## Implementation
+
+Follow [job-resume](../skills/spur-dev/references/dev-operations.md#11b-job-resume): validate the
+handoff against current state, then continue through the existing owner of the recorded operation.
+
+Skill(skill="sp:spur-dev", args="job-resume $ARGUMENTS")