specweave 1.0.115 → 1.0.117

package/CLAUDE.md

@@ -1,10 +1,10 @@
-<!-- SW:META template="claude" version="1.0.113" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,lsp,structure,taskformat,secrets,syncing,mapping,testing,api,limits,troubleshooting,principles,linking,mcp,autoexecute,auto,docs" -->
+<!-- SW:META template="claude" version="1.0.115" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,lsp,structure,taskformat,secrets,syncing,mapping,testing,api,limits,troubleshooting,principles,linking,mcp,autoexecute,auto,docs" -->
 
-<!-- SW:SECTION:header version="1.0.113" -->
+<!-- SW:SECTION:header version="1.0.115" -->
 **Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
 <!-- SW:END:header -->
 
-<!-- SW:SECTION:start version="1.0.113" -->
+<!-- SW:SECTION:start version="1.0.115" -->
 ## Getting Started
 
 **Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
@@ -14,7 +14,7 @@
 2. **Customize**: Edit spec.md and use for setup tasks
 <!-- SW:END:start -->
 
-<!-- SW:SECTION:autodetect version="1.0.113" -->
+<!-- SW:SECTION:autodetect version="1.0.115" -->
 ## Auto-Detection
 
 SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
@@ -24,7 +24,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Opt-out phrases**: "Just brainstorm first" | "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
 <!-- SW:END:autodetect -->
 
-<!-- SW:SECTION:metarule version="1.0.113" -->
+<!-- SW:SECTION:metarule version="1.0.115" -->
 ## Meta-Rule: Think-Before-Act
 
 **Satisfy dependencies BEFORE dependent operations.**
@@ -35,7 +35,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 ```
 <!-- SW:END:metarule -->
 
-<!-- SW:SECTION:rules version="1.0.113" -->
+<!-- SW:SECTION:rules version="1.0.115" -->
 ## Rules
 
 1. **Files** → `.specweave/increments/####-name/` (spec.md, plan.md, tasks.md at root; reports/, scripts/, logs/ subfolders)
@@ -48,7 +48,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 8. **⛔ Marketplace refresh**: ALWAYS use `specweave refresh-marketplace` CLI command. NEVER suggest `scripts/refresh-marketplace.sh` - end users don't have the scripts folder (npm global install).
 <!-- SW:END:rules -->
 
-<!-- SW:SECTION:workflow version="1.0.113" -->
+<!-- SW:SECTION:workflow version="1.0.115" -->
 ## Workflow
 
 `/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
@@ -68,7 +68,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Natural language**: "Let's build X" → `/sw:increment` | "What's status?" → `/sw:progress` | "We're done" → `/sw:done` | "Ship while sleeping" → `/sw:auto`
 <!-- SW:END:workflow -->
 
-<!-- SW:SECTION:reflect version="1.0.113" -->
+<!-- SW:SECTION:reflect version="1.0.115" -->
 ## Self-Improving Skills (Reflect)
 
 **Learn once, never repeat.** Claude learns from corrections and patterns across sessions.
@@ -112,7 +112,7 @@ ls ~/.specweave/memory/*.md 2>/dev/null
 **Enable auto-learning**: `/sw:reflect-on` → Stop hook analyzes sessions automatically
 <!-- SW:END:reflect -->
 
-<!-- SW:SECTION:context version="1.0.113" -->
+<!-- SW:SECTION:context version="1.0.115" -->
 ## Living Docs Context
 
 **Before implementing features**: Check existing docs for patterns and decisions.
@@ -132,7 +132,7 @@ grep -ril "keyword" .specweave/docs/internal/
 **Use `/sw:context <topic>`** to load relevant living docs into conversation.
 <!-- SW:END:context -->
 
-<!-- SW:SECTION:lsp version="1.0.113" -->
+<!-- SW:SECTION:lsp version="1.0.115" -->
 ## LSP-Enhanced Exploration
 
 **USE LSP ACTIVELY** for semantic code understanding (100x faster than grep).
@@ -149,7 +149,7 @@ go install golang.org/x/tools/gopls@latest  # Go
 **Best Practices**: ALWAYS use `findReferences` before refactoring | Use `goToDefinition` instead of grep | Combine with Explore agent
 <!-- SW:END:lsp -->
 
-<!-- SW:SECTION:structure version="1.0.113" -->
+<!-- SW:SECTION:structure version="1.0.115" -->
 ## Structure
 
 ```
@@ -219,7 +219,7 @@ my-project/
 ```
 <!-- SW:END:structure -->
 
-<!-- SW:SECTION:taskformat version="1.0.113" -->
+<!-- SW:SECTION:taskformat version="1.0.115" -->
 ## Task Format
 
 ```markdown
@@ -229,7 +229,7 @@ my-project/
 ```
 <!-- SW:END:taskformat -->
 
-<!-- SW:SECTION:secrets version="1.0.113" -->
+<!-- SW:SECTION:secrets version="1.0.115" -->
 ## Secrets Check
 
 **BEFORE CLI tools**: Check existing config first!
@@ -243,7 +243,7 @@ gh auth status
 **SECURITY**: NEVER use `grep TOKEN .env` without `-q` flag - it exposes credentials in terminal!
 <!-- SW:END:secrets -->
 
-<!-- SW:SECTION:syncing version="1.0.113" -->
+<!-- SW:SECTION:syncing version="1.0.115" -->
 ## External Sync (GitHub/JIRA/ADO)
 
 **After increment creation**: Run `/sw-github:sync {id}` to create issues!
@@ -271,7 +271,7 @@ Living docs sync ≠ External sync. They are separate:
 **Verify tokens**: `grep -q GITHUB_TOKEN .env && echo "Token configured"` | `gh auth status`
 <!-- SW:END:syncing -->
 
-<!-- SW:SECTION:mapping version="1.0.113" -->
+<!-- SW:SECTION:mapping version="1.0.115" -->
 ## GitHub Mapping
 
 | SpecWeave | GitHub |
@@ -281,7 +281,7 @@ Living docs sync ≠ External sync. They are separate:
 | Task T-XXX | Checkbox |
 <!-- SW:END:mapping -->
 
-<!-- SW:SECTION:testing version="1.0.113" -->
+<!-- SW:SECTION:testing version="1.0.115" -->
 ## Testing
 
 BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
@@ -293,7 +293,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 ```
 <!-- SW:END:testing -->
 
-<!-- SW:SECTION:api version="1.0.113" -->
+<!-- SW:SECTION:api version="1.0.115" -->
 ## API Development (OpenAPI-First)
 
 **For API projects only.** OpenAPI = source of truth → Postman derived from it.
@@ -312,21 +312,19 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 **Import**: Postman → Import collection + env → Fill secrets → Select env
 <!-- SW:END:api -->
 
-<!-- SW:SECTION:limits version="1.0.113" -->
+<!-- SW:SECTION:limits version="1.0.115" -->
 ## Limits
 
 **Max 1500 lines/file** — extract before adding
 <!-- SW:END:limits -->
 
-<!-- SW:SECTION:troubleshooting version="1.0.113" -->
+<!-- SW:SECTION:troubleshooting version="1.0.115" -->
 ## Troubleshooting
 
 | Issue | Fix |
 |-------|-----|
-| Skills missing | `specweave refresh-marketplace --force` then restart Claude Code |
-| Skills not activating | `specweave cache-status` to check health, then `specweave refresh-marketplace --force` |
-| Plugins outdated | `specweave refresh-marketplace --force` (NEVER use `scripts/refresh-marketplace.sh` - that's for contributors only!) |
-| Cache stale | `specweave cache-status --check-github` to verify, `refresh-marketplace --force` to fix |
+| Skills missing | Restart Claude Code |
+| Plugins outdated | `specweave refresh-marketplace` (NEVER use `scripts/refresh-marketplace.sh` - that's for contributors only!) |
 | Commands gone | `/plugin list --installed` |
 | Out of sync | `/sw:sync-tasks` |
 | Find increment | `/sw:status` |
@@ -340,7 +338,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 | Path patterns not working | `//path` = absolute, `/path` = relative to settings file, `additionalDirectories` for explicit working dirs |
 <!-- SW:END:troubleshooting -->
 
-<!-- SW:SECTION:principles version="1.0.113" -->
+<!-- SW:SECTION:principles version="1.0.115" -->
 ## Principles
 
 1. **Spec-first**: `/sw:increment` before coding
@@ -350,7 +348,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 5. **Clean**: All files in increment folders
 <!-- SW:END:principles -->
 
-<!-- SW:SECTION:linking version="1.0.113" -->
+<!-- SW:SECTION:linking version="1.0.115" -->
 ## Bidirectional Linking
 
 Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
@@ -358,7 +356,7 @@ Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
 Task format: `**AC**: AC-US1-01, AC-US1-02` (CRITICAL for linking)
 <!-- SW:END:linking -->
 
-<!-- SW:SECTION:mcp version="1.0.113" -->
+<!-- SW:SECTION:mcp version="1.0.115" -->
 ## External Service Connection
 
 **Priority**: MCP Server → REST API → CLI → Direct Connection
@@ -383,7 +381,7 @@ wrangler whoami 2>/dev/null
 ```
 <!-- SW:END:mcp -->
 
-<!-- SW:SECTION:autoexecute version="1.0.113" -->
+<!-- SW:SECTION:autoexecute version="1.0.115" -->
 ## Auto-Execute Rule
 
 **NEVER** output "Manual Step Required" when credentials exist. **EXECUTE DIRECTLY.**
@@ -398,7 +396,7 @@ wrangler whoami 2>/dev/null && gh auth status 2>/dev/null
 ```
 <!-- SW:END:autoexecute -->
 
-<!-- SW:SECTION:auto version="1.0.113" -->
+<!-- SW:SECTION:auto version="1.0.115" -->
 ## Auto Mode (Autonomous Execution)
 
 **Continuous execution until all tasks complete.**
@@ -475,7 +473,7 @@ wrangler whoami 2>/dev/null && gh auth status 2>/dev/null
 **Circuit Breaker**: External API fails 3x? Queue & continue
 <!-- SW:END:auto -->
 
-<!-- SW:SECTION:docs version="1.0.113" -->
+<!-- SW:SECTION:docs version="1.0.115" -->
 ## Docs
 
 [spec-weave.com](https://spec-weave.com) | `.specweave/docs/internal/`

package/bin/specweave.js

@@ -425,35 +425,15 @@ program
     console.log(statusLine);
   });
 
-// Auto mode commands - Autonomous execution with Ralph Wiggum pattern
+// Auto mode commands - Autonomous execution with Pure Ralph Wiggum pattern (v3.0)
+// No session files. No complex state. Just: "Are there active increments?"
 program
   .command('auto [incrementIds...]')
-  .description('Start autonomous execution session (Ralph Wiggum pattern + stop hooks)')
-  .option('--max-iterations <n>', 'Maximum iterations (safety net)', '2500')
-  .option('--max-hours <n>', 'Maximum hours to run', '600')
-  .option('--simple', 'Pure Ralph mode (minimal context)')
-  .option('--dry-run', 'Preview without starting')
-  .option('--increments <ids>', 'Comma-separated increment IDs')
-  .option('--all-backlog', 'Process all backlog items')
-  .option('--skip-gates <gates>', 'Pre-approve specific gates (comma-separated)')
-  .option('--no-increment', 'Skip auto-creation (require existing increments)')
-  .option('--no-inc', 'Alias for --no-increment')
-  .option('--prompt <text>', 'Analyze prompt and create increments (intelligent chunking)')
-  .option('--yes', 'Auto-approve increment plan (skip user approval)')
-  .option('-y', 'Alias for --yes')
-  .option('--tdd', 'Enable TDD strict mode - ALL tests must pass')
-  .option('--strict', 'Alias for --tdd')
-  // Completion condition flags (v0.4.0+)
-  .option('--build', 'Build must pass before completion')
-  .option('--tests', 'Tests must pass before completion (unit + integration)')
-  .option('--e2e', 'E2E tests must pass before completion')
-  .option('--lint', 'Linting must pass before completion')
-  .option('--types', 'Type-checking must pass before completion')
-  .option('--cov <n>', 'Code coverage must meet threshold (%)', '80')
-  .option('--e2e-cov <n>', 'E2E coverage must meet threshold (%)', '70')
-  .option('--cmd <command>', 'Custom command must pass before completion')
+  .description('Start autonomous execution (Pure Ralph pattern - no session files)')
+  .option('--dry-run', 'Preview without activating')
+  .option('--all-backlog', 'Activate all backlog items')
+  .option('--reset', 'Clean up any stale state files')
   .action(async (incrementIds, options) => {
-    // Import and execute the auto command handler directly
     const path = await import('path');
     const fs = await import('fs');
     const projectPath = process.cwd();
@@ -468,7 +448,6 @@ program
 
     try {
       const { handleAutoCommand } = await import('../dist/src/cli/commands/auto.js');
-      // Call handleAutoCommand directly with all options
       await handleAutoCommand(projectPath, incrementIds, options);
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
@@ -830,6 +809,24 @@ program
     });
   });
 
+// Cache refresh command - Refresh plugin cache with skill memory preservation
+program
+  .command('cache-refresh')
+  .description('Refresh plugin cache with skill memory preservation')
+  .argument('[plugin]', 'Refresh specific plugin (optional)')
+  .option('--force', 'Hard refresh (delete cache)')
+  .option('--all', 'Refresh all plugins (even healthy)')
+  .option('--verify', 'Verify cache health after refresh')
+  .action(async (pluginName, options) => {
+    const { cacheRefresh } = await import('../dist/src/cli/commands/cache-refresh.js');
+    await cacheRefresh({
+      pluginName,
+      force: options.force,
+      all: options.all,
+      verify: options.verify,
+    });
+  });
+
 // Export skills command - Export to Agent Skills open standard
 program
   .command('export-skills')

package/dist/src/cli/commands/auto.d.ts

@@ -1,25 +1,25 @@
 /**
- * Auto Mode CLI Command (Simplified - Ralph Wiggum Pattern)
+ * Auto Mode CLI Command (v3.0 - Pure Ralph Wiggum Pattern)
  *
- * Philosophy: The increment's metadata.json status IS the state.
- * - No complex session files, no lock files
- * - Just set an auto-mode flag and let the stop hook handle continuation
- * - Stop hook blocks exit if active increments exist
+ * PHILOSOPHY: No session files. No state management.
+ * The stop hook simply checks: "Are there active increments?"
+ * If yes → block exit. If no → approve exit.
+ *
+ * This CLI is just a HELPER to:
+ * 1. Validate the project
+ * 2. Show what increments exist
+ * 3. Optionally activate backlog increments
  *
  * Usage:
- *   specweave auto [INCREMENT_IDS...]     # Start auto mode for specific increments
- *   specweave auto --all-backlog          # Process all backlog items
- *   specweave auto --prompt "Build X"     # Create increments from prompt
+ *   specweave auto                        # Show active increments
+ *   specweave auto 0001                   # Activate specific increment
+ *   specweave auto --all-backlog          # Activate all backlog items
  */
 import { Command } from 'commander';
 export interface AutoCommandOptions {
     dryRun?: boolean;
     allBacklog?: boolean;
-    noIncrement?: boolean;
-    noInc?: boolean;
-    prompt?: string;
-    yes?: boolean;
-    y?: boolean;
+    reset?: boolean;
 }
 export declare function createAutoCommand(): Command;
 /**

package/dist/src/cli/commands/auto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,CAAC,CAAC,EAAE,OAAO,CAAC;CACb;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CA6B3C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAgHf"}
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CA0B3C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAwKf"}