specweave 1.0.355 → 1.0.356

package/plugins/specweave/hooks/stop-auto-v5.sh

@@ -155,8 +155,9 @@ if [ -f "$DEDUP_PREV" ]; then
 fi
 echo "$NOW" > "$DEDUP_PREV" 2>/dev/null
 
-# 7. Read userGoal from session marker
+# 7. Read userGoal and simple mode from session marker
 USER_GOAL=$(jq -r '.userGoal // ""' "$SESSION" 2>/dev/null || echo "")
+SIMPLE=$(jq -r '.simple // false' "$SESSION" 2>/dev/null || echo "false")
 
 # 8. Scan active increments (enriched: next task, progress fraction)
 TP=0; TAC=0; IC=0; ILIST=""
@@ -212,7 +213,7 @@ if [ "$IC" -eq 0 ]; then
     fi
 fi
 
-# 10. Work remains → block with enriched context message
+# 10. Work remains → block with context message (simple or enriched)
 # Sort entries by score descending (highest-relevance first) when userGoal is set
 SORTED_ILIST="$ILIST"
 if [ -n "$USER_GOAL" ] && [ "$IC" -gt 1 ]; then
@@ -221,24 +222,32 @@ if [ -n "$USER_GOAL" ] && [ "$IC" -gt 1 ]; then
     SORTED_ILIST="${SORTED_ILIST%,}"  # trim trailing comma
 fi
 
-DETAILS=""
+# Extract best increment ID (first entry after sorting)
 _BEST_ID=""
 IFS=',' read -ra ENTRIES <<< "$SORTED_ILIST"
-for entry in "${ENTRIES[@]}"; do
-    IFS='|' read -r eid ep ea enext edone etotal escore <<< "$entry"
-    [ -z "$_BEST_ID" ] && _BEST_ID="$eid"
-    _progress="${edone:-0}/${etotal:-0} tasks"
-    _next_info=""
-    [ -n "$enext" ] && _next_info=" | Next: $enext"
-    DETAILS="${DETAILS}\n  ▸ ${eid}: ${_progress}${_next_info}"
-done
+IFS='|' read -r _BEST_ID _rest <<< "${ENTRIES[0]}"
 
-# Build enriched block message
-BMSG=""
-[ -n "$USER_GOAL" ] && BMSG="Goal: ${USER_GOAL}\n"
-BMSG="${BMSG}Auto Mode: ${IC} increment(s) need work${DETAILS}"
-BMSG="${BMSG}\nTurn $TURN/$MAX_TURNS | Continue: /sw:do ${_BEST_ID}"
-BMSG=$(echo -e "$BMSG")
+if [ "$SIMPLE" = "true" ]; then
+    # Simple mode: minimal message to reduce context tokens per turn
+    BMSG="Continue: /sw:do ${_BEST_ID} ($TP tasks left, turn $TURN/$MAX_TURNS)"
+    BMSG=$(echo -e "$BMSG")
+else
+    # Full mode: enriched context with per-increment progress and next task
+    DETAILS=""
+    for entry in "${ENTRIES[@]}"; do
+        IFS='|' read -r eid ep ea enext edone etotal escore <<< "$entry"
+        _progress="${edone:-0}/${etotal:-0} tasks"
+        _next_info=""
+        [ -n "$enext" ] && _next_info=" | Next: $enext"
+        DETAILS="${DETAILS}\n  ▸ ${eid}: ${_progress}${_next_info}"
+    done
+
+    BMSG=""
+    [ -n "$USER_GOAL" ] && BMSG="Goal: ${USER_GOAL}\n"
+    BMSG="${BMSG}Auto Mode: ${IC} increment(s) need work${DETAILS}"
+    BMSG="${BMSG}\nTurn $TURN/$MAX_TURNS | Continue: /sw:do ${_BEST_ID}"
+    BMSG=$(echo -e "$BMSG")
+fi
 
 block "Work remaining: $TP tasks, $TAC ACs" "work_remaining" \
     "$(jq -n --argjson p "$TP" --argjson a "$TAC" --argjson i "$IC" \

package/plugins/specweave/skills/auto/SKILL.md

@@ -44,6 +44,18 @@ argument-hint: "[INCREMENT_IDS...] [OPTIONS]"
 | `--cov <n>` | Code coverage threshold (%) | 80 |
 | `--cmd "<command>"` | Custom command must pass | None |
 
+## Simple Mode (`--simple`)
+
+When `simple: true` is set in the session marker, reduce context consumption per iteration:
+
+1. **Skip spec re-reads** — Do NOT re-read `spec.md` on each task iteration. Read it once at session start, then rely on `tasks.md` alone for task-by-task execution.
+2. **Minimal task context** — Read only the current task's section from `tasks.md`, not the entire file. Use line offsets if the file is long.
+3. **No sub-skill loading** — Do NOT invoke domain skills (frontend:architect, testing:qa, etc.) during auto execution. Execute tasks directly using code tools.
+4. **Shorter status output** — Skip banners and progress tables between tasks. Just implement, test, mark complete, move on.
+5. **No complexity re-check** — Skip Step 1.5a (team-lead routing check) since the caller already decided the execution mode.
+
+**When to use**: Primarily for sub-agents in team-lead mode where the team-lead has already loaded specs, assigned tasks, and the agent just needs to execute. Also useful for simple increments with <10 tasks.
+
 ## Core Loop
 
 ```
@@ -73,6 +85,7 @@ Use Read/Write/Edit/Glob tools directly (no CLI needed):
   "active": true,
   "timestamp": "<ISO>",
   "incrementIds": ["0001-feature"],
+  "simple": false,
   "tddMode": false,
   "requireTests": false,
   "userGoal": null,
@@ -84,7 +97,8 @@ Use Read/Write/Edit/Glob tools directly (no CLI needed):
 }
 ```
 
-Map flags to extra `successCriteria` entries:
+Map flags to session marker fields:
+- `--simple` -> set `"simple": true`
 - `--tests` -> `{ "type": "tests_pass", "required": true }`
 - `--build` -> `{ "type": "build_succeeds", "required": true }`
 - `--e2e` -> `{ "type": "tests_pass", "description": "E2E tests", "required": true }`

package/plugins/specweave/skills/do/SKILL.md

@@ -6,11 +6,11 @@ hooks:
     - matcher: Edit
       hooks:
         - type: command
-          command: bash plugins/specweave/hooks/v2/guards/task-ac-sync-guard.sh
+          command: bash -c 'W="${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh"; S="${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/task-ac-sync-guard.sh"; [[ -x "$W" ]] && exec "$W" "$S" || (cat >/dev/null && printf "{\"decision\":\"allow\"}")'
     - matcher: Write
       hooks:
         - type: command
-          command: bash plugins/specweave/hooks/v2/guards/task-ac-sync-guard.sh
+          command: bash -c 'W="${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh"; S="${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/task-ac-sync-guard.sh"; [[ -x "$W" ]] && exec "$W" "$S" || (cat >/dev/null && printf "{\"decision\":\"allow\"}")'
 ---
 
 # Do Increment
@@ -69,7 +69,7 @@ This ensures the execution loop stays focused on the contextually correct increm
 5. **Task count validation**: If >25 tasks, warn and offer to split, phase, or use `/sw:auto`/`/sw:team-lead`
 6. **Validate AC presence** (MANDATORY):
    ```bash
-   bash plugins/specweave/hooks/pre-increment-start.sh <increment-path>
+   bash "${CLAUDE_PLUGIN_ROOT}/hooks/pre-increment-start.sh" <increment-path>
    ```
    If fails: manually add ACs to spec.md, then retry. Do NOT proceed without ACs in spec.md.
 

package/plugins/specweave/skills/increment/SKILL.md

@@ -7,14 +7,14 @@ hooks:
     - matcher: Write
       hooks:
         - type: command
-          command: bash plugins/specweave/hooks/v2/guards/interview-enforcement-guard.sh
+          command: bash -c 'W="${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh"; S="${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/interview-enforcement-guard.sh"; [[ -x "$W" ]] && exec "$W" "$S" || (cat >/dev/null && printf "{\"decision\":\"allow\"}")'
         - type: command
-          command: bash plugins/specweave/hooks/v2/guards/spec-template-enforcement-guard.sh
+          command: bash -c 'W="${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh"; S="${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/spec-template-enforcement-guard.sh"; [[ -x "$W" ]] && exec "$W" "$S" || (cat >/dev/null && printf "{\"decision\":\"allow\"}")'
   PostToolUse:
     - matcher: Write
       hooks:
         - type: command
-          command: bash plugins/specweave/hooks/v2/guards/increment-duplicate-guard.sh
+          command: bash -c 'W="${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh"; S="${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/increment-duplicate-guard.sh"; [[ -x "$W" ]] && exec "$W" "$S" || (cat >/dev/null && printf "{\"decision\":\"allow\"}")'
 ---
 
 # Plan Product Increment

package/plugins/specweave/skills/team-build/SKILL.md

@@ -5,7 +5,7 @@ hooks:
     - matcher: TeamCreate
       hooks:
         - type: command
-          command: bash plugins/specweave/hooks/v2/guards/increment-existence-guard.sh
+          command: bash -c 'W="${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh"; S="${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/increment-existence-guard.sh"; [[ -x "$W" ]] && exec "$W" "$S" || (cat >/dev/null && printf "{\"decision\":\"allow\"}")'
 ---
 
 # Team Build

package/plugins/specweave/skills/team-lead/SKILL.md

@@ -5,7 +5,7 @@ hooks:
     - matcher: TeamCreate
       hooks:
         - type: command
-          command: bash plugins/specweave/hooks/v2/guards/increment-existence-guard.sh
+          command: bash -c 'W="${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh"; S="${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/increment-existence-guard.sh"; [[ -x "$W" ]] && exec "$W" "$S" || (cat >/dev/null && printf "{\"decision\":\"allow\"}")'
 ---
 
 # Team Lead
@@ -439,7 +439,7 @@ SendMessage({
 SendMessage({
   type: "message",
   recipient: "team-lead",
-  content: "COMPLETION: All 8 tasks done. Tests passing (24/24). /sw:grill passed. Frontend increment ready for merge.",
+  content: "COMPLETION: All 8 tasks done. Tests passing (24/24). Ready for team-lead closure.",
   summary: "Frontend agent completed all tasks"
 });
 ```
@@ -563,12 +563,14 @@ Orchestrator Final Check:
 
 Agents can get stuck in extended thinking if their context overflows. The team-lead MUST monitor for stuck agents.
 
-### Timeout Rules
+### Stuck Detection Rules
+
+**Note**: Claude Code has no built-in timers. These are best-effort heuristics applied when the team-lead regains control (e.g., after processing other agent messages).
 
 | Condition | Action |
 |-----------|--------|
-| Agent idle >20 min after last message | Send `STATUS_CHECK` message to agent |
-| No response to STATUS_CHECK within 5 min | Declare agent stuck |
+| Agent has not messaged since team-lead's last turn | Send `STATUS_CHECK` message to agent |
+| Agent does not respond to STATUS_CHECK on next team-lead turn | Declare agent stuck |
 | Agent stuck | Log warning, proceed with other agents, handle stuck agent's increment manually in team-merge |
 | All agents stuck | STOP team, report to user |
 

package/plugins/specweave/skills/validate/SKILL.md

@@ -5,7 +5,7 @@ hooks:
   Stop:
     - hooks:
         - type: command
-          command: bash plugins/specweave/hooks/v2/guards/spec-validation-guard.sh
+          command: bash -c 'W="${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh"; S="${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/spec-validation-guard.sh"; [[ -x "$W" ]] && exec "$W" "$S" || (cat >/dev/null && printf "{\"decision\":\"approve\"}")'
 ---
 
 # Validate Increment

package/dist/src/utils/claude-plugin-cli.d.ts

@@ -1,32 +0,0 @@
-/**
- * Claude Code Plugin CLI Integration
- *
- * Registers SpecWeave plugins with Claude Code's plugin system via the
- * `claude` CLI binary. This makes plugins appear in the `/plugin Installed`
- * UI alongside marketplace metadata.
- *
- * All operations are non-fatal — failures are logged (in DEBUG mode) but
- * never block the primary plugin installation to ~/.claude/commands/.
- *
- * @since 1.0.290
- */
-export interface CliRegistrationResult {
-    /** True if marketplace was registered successfully */
-    marketplaceRegistered: boolean;
-    /** Plugin names that were successfully installed via CLI */
-    installedPlugins: string[];
-    /** Plugin names that failed CLI installation */
-    failedPlugins: string[];
-}
-/**
- * Register SpecWeave marketplace and install plugins via Claude CLI.
- *
- * Steps:
- * 1. Validates specweaveRoot contains .claude-plugin/marketplace.json
- * 2. Runs `claude plugin marketplace add <specweaveRoot>`
- * 3. Runs `claude plugin install <name>@specweave` for each plugin
- *
- * Entirely non-fatal. Returns a result with success/failure per plugin.
- */
-export declare function registerPluginsWithClaudeCli(specweaveRoot: string, pluginNames: string[]): CliRegistrationResult;
-//# sourceMappingURL=claude-plugin-cli.d.ts.map

package/dist/src/utils/claude-plugin-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"claude-plugin-cli.d.ts","sourceRoot":"","sources":["../../../src/utils/claude-plugin-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gDAAgD;IAChD,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAAE,GACpB,qBAAqB,CA6CvB"}

package/dist/src/utils/claude-plugin-cli.js

@@ -1,74 +0,0 @@
-/**
- * Claude Code Plugin CLI Integration
- *
- * Registers SpecWeave plugins with Claude Code's plugin system via the
- * `claude` CLI binary. This makes plugins appear in the `/plugin Installed`
- * UI alongside marketplace metadata.
- *
- * All operations are non-fatal — failures are logged (in DEBUG mode) but
- * never block the primary plugin installation to ~/.claude/commands/.
- *
- * @since 1.0.290
- */
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { execFileNoThrowSync } from './execFileNoThrow.js';
-import { getPluginScope, getScopeArgs } from '../core/types/plugin-scope.js';
-// ---------------------------------------------------------------------------
-// Core
-// ---------------------------------------------------------------------------
-/**
- * Register SpecWeave marketplace and install plugins via Claude CLI.
- *
- * Steps:
- * 1. Validates specweaveRoot contains .claude-plugin/marketplace.json
- * 2. Runs `claude plugin marketplace add <specweaveRoot>`
- * 3. Runs `claude plugin install <name>@specweave` for each plugin
- *
- * Entirely non-fatal. Returns a result with success/failure per plugin.
- */
-export function registerPluginsWithClaudeCli(specweaveRoot, pluginNames) {
-    const result = {
-        marketplaceRegistered: false,
-        installedPlugins: [],
-        failedPlugins: [],
-    };
-    if (pluginNames.length === 0)
-        return result;
-    // Validate marketplace exists at path
-    const marketplacePath = join(specweaveRoot, '.claude-plugin', 'marketplace.json');
-    if (!existsSync(marketplacePath)) {
-        if (process.env.DEBUG) {
-            console.warn(`[DEBUG] Skipping Claude CLI registration: no marketplace.json at ${marketplacePath}`);
-        }
-        return result;
-    }
-    // Register marketplace
-    const addResult = execFileNoThrowSync('claude', ['plugin', 'marketplace', 'add', specweaveRoot]);
-    if (addResult.success || addResult.exitCode === 0) {
-        result.marketplaceRegistered = true;
-    }
-    else {
-        if (process.env.DEBUG) {
-            console.warn(`[DEBUG] claude plugin marketplace add failed (exit ${addResult.exitCode}): ${addResult.stderr}`);
-        }
-        // Don't bail — install may still work if marketplace was already registered
-    }
-    // Install each plugin with correct scope
-    for (const name of pluginNames) {
-        const scope = getPluginScope(name, 'specweave');
-        const scopeArgs = getScopeArgs(scope);
-        const installResult = execFileNoThrowSync('claude', ['plugin', 'install', `${name}@specweave`, ...scopeArgs]);
-        if (installResult.success || installResult.exitCode === 0) {
-            result.installedPlugins.push(name);
-        }
-        else {
-            result.failedPlugins.push(name);
-            if (process.env.DEBUG) {
-                console.warn(`[DEBUG] claude plugin install ${name}@specweave failed (exit ${installResult.exitCode}): ${installResult.stderr}`);
-            }
-        }
-    }
-    return result;
-}
-//# sourceMappingURL=claude-plugin-cli.js.map

package/dist/src/utils/claude-plugin-cli.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"claude-plugin-cli.js","sourceRoot":"","sources":["../../../src/utils/claude-plugin-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAe7E,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC1C,aAAqB,EACrB,WAAqB;IAErB,MAAM,MAAM,GAA0B;QACpC,qBAAqB,EAAE,KAAK;QAC5B,gBAAgB,EAAE,EAAE;QACpB,aAAa,EAAE,EAAE;KAClB,CAAC;IAEF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAE5C,sCAAsC;IACtC,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IAClF,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,oEAAoE,eAAe,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uBAAuB;IACvB,MAAM,SAAS,GAAG,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC;IACjG,IAAI,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,qBAAqB,GAAG,IAAI,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,sDAAsD,SAAS,CAAC,QAAQ,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACjH,CAAC;QACD,4EAA4E;IAC9E,CAAC;IAED,yCAAyC;IACzC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,aAAa,GAAG,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,YAAY,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;QAC9G,IAAI,aAAa,CAAC,OAAO,IAAI,aAAa,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC,iCAAiC,IAAI,2BAA2B,aAAa,CAAC,QAAQ,MAAM,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;YACnI,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}