@gobing-ai/spur 0.4.31 → 0.4.33

package/.claude-plugin/marketplace.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/spur",
-    "version": "0.4.31",
+    "version": "0.4.33",
     "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/plugin.json

@@ -1,5 +1,5 @@
 {
     "name": "sp",
-    "version": "0.4.31",
+    "version": "0.4.33",
     "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/spur-cli/references/tasks.md

@@ -72,11 +72,16 @@ mode; `batch-create` surfaces per-child `warnings` rows (`[{"wbs", "warnings"}]`
 when non-empty) in `--json` and prints `<wbs>: <warning>` lines to stderr in human mode;
 `update --section` section writes carried this advisory already.
 
+When an advisory fires, split the task instead of growing it: decompose into smaller tasks before
+pipeline execution (execution-workflow.md, "Split oversized tasks before pipeline execution").
+`create --requirements/--plan` and `batch-create` body fields exist to author the split tasks'
+content up front — not to accumulate more into one oversized task.
+
 ## Verb map
 
 | Verb | Purpose | Key flags |
 | ---- | ------- | --------- |
-| `create <title>` | Allocate a new task (race-safe WBS) | `--feature <id>` `--no-reopen` `--parent <wbs>` `--template <variant>` `--dedupe-within <s>` `--allow-duplicate-name` `--skip-ready` `--agent <selector>` `--folder` `--json` |
+| `create <title>` | Allocate a new task (race-safe WBS) | `--feature <id>` `--no-reopen` `--parent <wbs>` `--template <variant>` `--requirements <text>` `--plan <text>` `--dedupe-within <s>` `--allow-duplicate-name` `--skip-ready` `--agent <selector>` `--folder` `--json` |
 | `show <wbs>` | Print one task's frontmatter + body; section-filtered or summary mode (1325) | `--section <name>` `--sections <csv>` `--summary` `--folder` `--json` |
 | `update <wbs> [status]` | Lifecycle transition, section replace, **or** frontmatter set | `--section <name> --from-file <path>` `--assignee <spec-id>` (exclusive with `--section`) `--feature <id>` `--no-reopen` `--priority <p>` `--ac-numbering task-local` `--ac-altitude <a>` `--estimate-hours <n>` `--no-lifecycle` `--force-done` `--reason <text>` `--provenance-bypass` `--verdict-dir <path>` `--folder` `--json` |
 | `deps <wbs> <op> [values...]` | Mutate `dependencies[]` frontmatter array (ops: `set`, `add`, `remove`, `clear`) | `--folder` `--json` |

package/spur.js

@@ -44082,6 +44082,7 @@ async function messageRollup(db, sel, opts) {
   return db.queryAll(`WITH filtered AS (
              SELECT m.source, m.session_id, m.model, m.ts, m.input_tokens, m.output_tokens,
                     m.cache_read_tokens, m.cache_write_tokens, m.cost_usd, m.role, m.duration_ms,
+                    m.disposition,
                     ROW_NUMBER() OVER (PARTITION BY m.request_id ORDER BY m.rowid DESC) AS rn,
                     m.request_id
              FROM history_message m
@@ -44097,7 +44098,7 @@ async function messageRollup(db, sel, opts) {
                         'unknown'
                     ) AS model,
                     ts, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens,
-                    cost_usd, role, duration_ms
+                    cost_usd, role, duration_ms, disposition
              FROM filtered WHERE request_id IS NULL OR rn = 1
          )
          SELECT source, model, DATE(ts) AS day,
@@ -44108,9 +44109,12 @@ async function messageRollup(db, sel, opts) {
                 SUM(cache_write_tokens) AS cacheWriteTokens,
                 SUM(cost_usd) AS costUsd,
                 SUM(CASE WHEN input_tokens IS NOT NULL OR output_tokens IS NOT NULL THEN 1 ELSE 0 END) AS recordsWithUsage,
-                SUM(CASE WHEN role = 'assistant' THEN duration_ms END) AS assistantDurationMs,
-                SUM(CASE WHEN role = 'assistant' THEN duration_ms IS NULL END) AS assistantDurationUnmeasured,
-                SUM(CASE WHEN role = 'assistant' AND duration_ms > 0 THEN 1 ELSE 0 END) AS assistantDurationSamples
+                -- 1328: latency aggregates exclude collapsed poll rows \u2014 the duration
+                -- backfill hands poll duplicates derived durations, so executor-latency
+                -- means/samples stay unpolluted (1324 R3's rollup-chain residue).
+                SUM(CASE WHEN role = 'assistant' AND disposition <> 'poll-duplicate' THEN duration_ms END) AS assistantDurationMs,
+                SUM(CASE WHEN role = 'assistant' AND duration_ms IS NULL AND disposition <> 'poll-duplicate' THEN 1 ELSE 0 END) AS assistantDurationUnmeasured,
+                SUM(CASE WHEN role = 'assistant' AND duration_ms > 0 AND disposition <> 'poll-duplicate' THEN 1 ELSE 0 END) AS assistantDurationSamples
          FROM selected
          GROUP BY source, model, DATE(ts)`, ...params, ...wm.params);
 }
@@ -109457,6 +109461,7 @@ class AgentRunExecutor {
     let result;
     let invocation;
     let dispatchStartedAt = Date.now();
+    let lifecycleStarted = false;
     const getDb = this.ctx.getDb;
     let sessionObserver;
     if (getDb !== undefined) {
@@ -109634,7 +109639,8 @@ class AgentRunExecutor {
           ...sessionId !== undefined ? { sessionId } : {},
           ...translated !== undefined && prompt !== undefined ? { translatedFrom: traceSafePrompt(prompt) } : {}
         };
-        if (attempt === 0) {
+        if (!lifecycleStarted) {
+          lifecycleStarted = true;
           lifecycle.start({
             agent,
             ...model !== undefined ? { model } : {},
@@ -128869,7 +128875,9 @@ ${templateBackground}`;
       featureId: params.featureId,
       parentWbs: params.parentWbs,
       template: params.template,
-      explicitStatus: params.status
+      explicitStatus: params.status,
+      requirements: params.requirements,
+      plan: params.plan
     });
     this.validateCandidateOrThrow(params.title, shape);
     let featureReopened;
@@ -146695,6 +146703,14 @@ function readWorkspaceGraph(cwd) {
   } catch {
     return { byName: new Map, dependents: new Map };
   }
+  const unsupported = globs.find((glob) => glob.includes("*") && (!glob.endsWith("/*") || glob === "/*"));
+  if (unsupported !== undefined) {
+    return {
+      byName: new Map,
+      dependents: new Map,
+      unsupported: `workspaces glob ${JSON.stringify(unsupported)} is not a supported shape (only \`dir/*\` globs and literal dirs expand)`
+    };
+  }
   const dirs = new Set;
   for (const glob of globs) {
     if (glob.endsWith("/*")) {
@@ -146779,7 +146795,10 @@ function lightScope(changedFiles, exists = existsSync23, graph) {
     }
   }
   let fallback;
-  if (graph !== undefined) {
+  if (graph?.unsupported !== undefined) {
+    fallback = `${graph.unsupported} \u2014 full suite required`;
+  }
+  if (fallback === undefined && graph !== undefined) {
     for (const file of changedFiles) {
       if (file.startsWith("plugins/sp/"))
         continue;
@@ -159910,7 +159929,7 @@ ${result.wbs} (${result.status}): ${result.pass ? "PASS" : "FAIL"}`);
 init_src4();
 init_src2();
 function registerTaskCreateCommand(task, context) {
-  task.command("create").summary("Create a new task with race-safe WBS allocation.").argument("<title>", "Task title").option(...SHARED_OPTIONS.featureTrace).option("--parent <wbs>", "Parent WBS for sub-task grouping").option("--template <variant>", `Template variant (${TASK_VARIANTS.join("|")})`).option("--no-reopen", "Do not reopen a 'verifying' parent feature to 'active'").option(...SHARED_OPTIONS.folderTasks).option("--dedupe-within <seconds>", "Override the default dedup window (seconds). Guard is on (300s) by default when --feature is set.", Number).option("--allow-duplicate-name", "Disable the dedup guard entirely (creates anyway)").option("--skip-ready", "Skip ready preparation (backlog capture only, no model dispatch)").option("--agent <selector>", "Agent used for ready preparation (defaults to the configured agent)").option(...SHARED_OPTIONS.json).option(...SHARED_OPTIONS.jsonEnvelope).action(async (title, options) => {
+  task.command("create").summary("Create a new task with race-safe WBS allocation.").argument("<title>", "Task title").option(...SHARED_OPTIONS.featureTrace).option("--parent <wbs>", "Parent WBS for sub-task grouping").option("--template <variant>", `Template variant (${TASK_VARIANTS.join("|")})`).option("--requirements <text>", "Pre-filled Requirements body (normalized like batch items)").option("--plan <text>", "Pre-filled Plan body (ordered checklist)").option("--no-reopen", "Do not reopen a 'verifying' parent feature to 'active'").option(...SHARED_OPTIONS.folderTasks).option("--dedupe-within <seconds>", "Override the default dedup window (seconds). Guard is on (300s) by default when --feature is set.", Number).option("--allow-duplicate-name", "Disable the dedup guard entirely (creates anyway)").option("--skip-ready", "Skip ready preparation (backlog capture only, no model dispatch)").option("--agent <selector>", "Agent used for ready preparation (defaults to the configured agent)").option(...SHARED_OPTIONS.json).option(...SHARED_OPTIONS.jsonEnvelope).action(async (title, options) => {
     if (options.template !== undefined && !TASK_VARIANTS.includes(options.template)) {
       writeCreateJsonError(context, options, "invalid-usage", `Unknown template variant "${options.template}". Valid: ${TASK_VARIANTS.join(", ")}`);
       context.setExitCode(2);
@@ -159933,6 +159952,8 @@ function registerTaskCreateCommand(task, context) {
         featureId: options.feature,
         parentWbs: options.parent,
         template: options.template,
+        requirements: options.requirements,
+        plan: options.plan,
         noReopen: options.reopen === false,
         dedupeWithinSec: options.allowDuplicateName ? null : options.dedupeWithin
       });
@@ -160766,6 +160787,11 @@ function parseCsvSections(csv) {
 function registerTaskShowCommand(task, context) {
   task.command("show").alias("get").summary("Show a task by WBS.").argument("<wbs>", "Task WBS number").option(...SHARED_OPTIONS.folderTasks).option(...SHARED_OPTIONS.sectionShowFilter, collectSection, []).option("--sections <csv>", 'Comma-separated section names to show (e.g. "Background,Plan"); combined with --section').option("--summary", "Print frontmatter metadata plus a section index (name, heading, byte count) and total file size \u2014 no section bodies", false).option(...SHARED_OPTIONS.json).option(...SHARED_OPTIONS.jsonEnvelope).action(async (wbs, options) => {
     const requested = [...options.section ?? [], ...parseCsvSections(options.sections)];
+    if (options.sections !== undefined && parseCsvSections(options.sections).length === 0) {
+      writeJsonError(context.output, options, `--sections "${options.sections}" carries no usable section names`, "VALIDATION_FAILED");
+      context.setExitCode(2);
+      return;
+    }
     if (options.summary === true && requested.length > 0) {
       writeJsonError(context.output, options, "--summary cannot be combined with --section/--sections", "VALIDATION_FAILED");
       context.setExitCode(2);
@@ -166039,7 +166065,7 @@ init_src2();
 var CLI_CONFIG = {
   binaryName: "spur",
   binaryLabel: "spur",
-  binaryVersion: "0.4.31",
+  binaryVersion: "0.4.33",
   configDir: ".spur",
   configFile: ".spur/config.yaml",
   databaseFile: ".spur/spur.db"
@@ -173778,7 +173804,7 @@ init_dist5();
 import { homedir as homedir17 } from "os";
 import { basename as basename23, join as join95, relative as relative19, resolve as resolve37 } from "path";
 // ../server/package.json
-var version4 = "0.4.31";
+var version4 = "0.4.33";
 
 // ../server/src/modules/health/index.ts
 var startedAt = Date.now();