specweave 1.0.108 → 1.0.110

package/CLAUDE.md

@@ -1,10 +1,10 @@
-<!-- SW:META template="claude" version="1.0.107" 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.109" 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.107" -->
+<!-- SW:SECTION:header version="1.0.109" -->
 **Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
 <!-- SW:END:header -->
 
-<!-- SW:SECTION:start version="1.0.107" -->
+<!-- SW:SECTION:start version="1.0.109" -->
 ## 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.107" -->
+<!-- SW:SECTION:autodetect version="1.0.109" -->
 ## 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.107" -->
+<!-- SW:SECTION:metarule version="1.0.109" -->
 ## 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.107" -->
+<!-- SW:SECTION:rules version="1.0.109" -->
 ## 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.107" -->
+<!-- SW:SECTION:workflow version="1.0.109" -->
 ## 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.107" -->
+<!-- SW:SECTION:reflect version="1.0.109" -->
 ## 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.107" -->
+<!-- SW:SECTION:context version="1.0.109" -->
 ## 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.107" -->
+<!-- SW:SECTION:lsp version="1.0.109" -->
 ## 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.107" -->
+<!-- SW:SECTION:structure version="1.0.109" -->
 ## Structure
 
 ```
@@ -219,7 +219,7 @@ my-project/
 ```
 <!-- SW:END:structure -->
 
-<!-- SW:SECTION:taskformat version="1.0.107" -->
+<!-- SW:SECTION:taskformat version="1.0.109" -->
 ## Task Format
 
 ```markdown
@@ -229,7 +229,7 @@ my-project/
 ```
 <!-- SW:END:taskformat -->
 
-<!-- SW:SECTION:secrets version="1.0.107" -->
+<!-- SW:SECTION:secrets version="1.0.109" -->
 ## Secrets Check
 
 **BEFORE CLI tools**: Check existing config first!
@@ -240,7 +240,7 @@ gh auth status
 ```
 <!-- SW:END:secrets -->
 
-<!-- SW:SECTION:syncing version="1.0.107" -->
+<!-- SW:SECTION:syncing version="1.0.109" -->
 ## External Sync (GitHub/JIRA/ADO)
 
 **After increment creation**: Run `/sw-github:sync {id}` to create issues!
@@ -268,7 +268,7 @@ Living docs sync ≠ External sync. They are separate:
 **Verify tokens**: `grep GITHUB_TOKEN .env` | `gh auth status`
 <!-- SW:END:syncing -->
 
-<!-- SW:SECTION:mapping version="1.0.107" -->
+<!-- SW:SECTION:mapping version="1.0.109" -->
 ## GitHub Mapping
 
 | SpecWeave | GitHub |
@@ -278,7 +278,7 @@ Living docs sync ≠ External sync. They are separate:
 | Task T-XXX | Checkbox |
 <!-- SW:END:mapping -->
 
-<!-- SW:SECTION:testing version="1.0.107" -->
+<!-- SW:SECTION:testing version="1.0.109" -->
 ## Testing
 
 BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
@@ -290,7 +290,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 ```
 <!-- SW:END:testing -->
 
-<!-- SW:SECTION:api version="1.0.107" -->
+<!-- SW:SECTION:api version="1.0.109" -->
 ## API Development (OpenAPI-First)
 
 **For API projects only.** OpenAPI = source of truth → Postman derived from it.
@@ -309,13 +309,13 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 **Import**: Postman → Import collection + env → Fill secrets → Select env
 <!-- SW:END:api -->
 
-<!-- SW:SECTION:limits version="1.0.107" -->
+<!-- SW:SECTION:limits version="1.0.109" -->
 ## Limits
 
 **Max 1500 lines/file** — extract before adding
 <!-- SW:END:limits -->
 
-<!-- SW:SECTION:troubleshooting version="1.0.107" -->
+<!-- SW:SECTION:troubleshooting version="1.0.109" -->
 ## Troubleshooting
 
 | Issue | Fix |
@@ -335,7 +335,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.107" -->
+<!-- SW:SECTION:principles version="1.0.109" -->
 ## Principles
 
 1. **Spec-first**: `/sw:increment` before coding
@@ -345,7 +345,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 5. **Clean**: All files in increment folders
 <!-- SW:END:principles -->
 
-<!-- SW:SECTION:linking version="1.0.107" -->
+<!-- SW:SECTION:linking version="1.0.109" -->
 ## Bidirectional Linking
 
 Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
@@ -353,7 +353,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.107" -->
+<!-- SW:SECTION:mcp version="1.0.109" -->
 ## External Service Connection
 
 **Priority**: MCP Server → REST API → CLI → Direct Connection
@@ -377,7 +377,7 @@ wrangler whoami 2>/dev/null
 ```
 <!-- SW:END:mcp -->
 
-<!-- SW:SECTION:autoexecute version="1.0.107" -->
+<!-- SW:SECTION:autoexecute version="1.0.109" -->
 ## Auto-Execute Rule
 
 **NEVER** output "Manual Step Required" when credentials exist. **EXECUTE DIRECTLY.**
@@ -391,7 +391,7 @@ wrangler whoami 2>/dev/null && gh auth status 2>/dev/null
 ```
 <!-- SW:END:autoexecute -->
 
-<!-- SW:SECTION:auto version="1.0.107" -->
+<!-- SW:SECTION:auto version="1.0.109" -->
 ## Auto Mode (Autonomous Execution)
 
 **Continuous execution until all tasks complete.**
@@ -468,7 +468,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.107" -->
+<!-- SW:SECTION:docs version="1.0.109" -->
 ## Docs
 
 [spec-weave.com](https://spec-weave.com) | `.specweave/docs/internal/`

package/bin/specweave.js

@@ -344,6 +344,24 @@ program
     await statusCommand(options);
   });
 
+// Logs command - View hook execution logs
+program
+  .command('logs')
+  .description('View hook execution logs')
+  .option('--tail <number>', 'Number of log entries to show (default: 50)', '50')
+  .option('--hook <name>', 'Filter by hook name')
+  .option('--format <type>', 'Output format: json or table (default: table)', 'table')
+  .option('--follow', 'Follow new log entries (not yet implemented)')
+  .action(async (options) => {
+    const { logsCommand } = await import('../dist/src/cli/commands/logs.js');
+    await logsCommand({
+      tail: parseInt(options.tail, 10),
+      hook: options.hook,
+      format: options.format,
+      follow: options.follow
+    });
+  });
+
 // Status line command - Display current increment progress
 program
   .command('status-line')
@@ -485,6 +503,78 @@ program
     await cancelCmd.parseAsync(args, { from: 'user' });
   });
 
+// Go mode commands - Pure Ralph Wiggum pattern (simpler than auto mode)
+program
+  .command('go <prompt>')
+  .description('Start go session (Ralph Wiggum pattern) - simple autonomous iteration')
+  .option('--max-iterations <n>', 'Maximum iterations (safety net)', '100')
+  .option('--completion-promise <text>', 'Exact phrase that signals completion')
+  .option('--build', 'Build must pass before completion')
+  .option('--tests', 'Tests must pass before completion')
+  .option('--e2e', 'E2E tests must pass before completion')
+  .option('--lint', 'Linting must pass before completion')
+  .option('--types', 'Type-checking must pass before completion')
+  .option('--dry-run', 'Preview without starting')
+  .action(async (prompt, options) => {
+    const path = await import('path');
+    const fs = await import('fs');
+    const projectPath = process.cwd();
+
+    // Check if SpecWeave is initialized
+    const specweavePath = path.join(projectPath, '.specweave');
+    if (!fs.existsSync(specweavePath)) {
+      console.log(chalk.yellow('No SpecWeave project found in current directory.'));
+      console.log(chalk.gray('Run `specweave init` to initialize a project.'));
+      return;
+    }
+
+    try {
+      const { handleGoCommand } = await import('../dist/src/cli/commands/go.js');
+      await handleGoCommand(projectPath, prompt, options);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      console.error(chalk.red(`Error: ${errorMessage}`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('go-status')
+  .description('Check go session status')
+  .option('--verbose', 'Show detailed information')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    const path = await import('path');
+    const projectPath = process.cwd();
+
+    try {
+      const { handleGoStatusCommand } = await import('../dist/src/cli/commands/go-status.js');
+      await handleGoStatusCommand(projectPath, options);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      console.error(chalk.red(`Error: ${errorMessage}`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('cancel-go')
+  .description('Cancel running go session')
+  .option('--force', 'Force cancel without confirmation')
+  .action(async (options) => {
+    const path = await import('path');
+    const projectPath = process.cwd();
+
+    try {
+      const { handleCancelGoCommand } = await import('../dist/src/cli/commands/cancel-go.js');
+      await handleCancelGoCommand(projectPath, options);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      console.error(chalk.red(`Error: ${errorMessage}`));
+      process.exit(1);
+    }
+  });
+
 // Update instructions command - Smart merge CLAUDE.md/AGENTS.md
 program
   .command('update-instructions')

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

@@ -0,0 +1,31 @@
+/**
+ * Auto Mode CLI Command (Simplified)
+ *
+ * Philosophy: Trust the framework!
+ * - No session state (increments ARE the state)
+ * - No manual sync (hooks handle it)
+ * - No quality gates here (belongs in /sw:done)
+ * - Just: find active increments, start working, stop hook blocks until done
+ *
+ * Usage:
+ *   specweave auto [INCREMENT_IDS...] [OPTIONS]
+ *   specweave auto              # Work on active increments
+ *   specweave auto 0001 0002    # Work on specific increments
+ *   specweave auto --all-backlog # Work on all backlog increments
+ */
+import { Command } from 'commander';
+export interface AutoCommandOptions {
+    allBacklog?: boolean;
+    noIncrement?: boolean;
+    noInc?: boolean;
+    prompt?: string;
+    yes?: boolean;
+    y?: boolean;
+    dryRun?: boolean;
+}
+export declare function createAutoCommand(): Command;
+/**
+ * Main auto command handler (simplified)
+ */
+export declare function handleAutoCommand(projectPath: string, incrementIds: string[], options: AutoCommandOptions): Promise<void>;
+//# sourceMappingURL=auto-simple.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-simple.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/auto-simple.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,kBAAkB;IACjC,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;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CA8B3C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAuEf"}

package/dist/src/cli/commands/auto-simple.js

@@ -0,0 +1,218 @@
+/**
+ * Auto Mode CLI Command (Simplified)
+ *
+ * Philosophy: Trust the framework!
+ * - No session state (increments ARE the state)
+ * - No manual sync (hooks handle it)
+ * - No quality gates here (belongs in /sw:done)
+ * - Just: find active increments, start working, stop hook blocks until done
+ *
+ * Usage:
+ *   specweave auto [INCREMENT_IDS...] [OPTIONS]
+ *   specweave auto              # Work on active increments
+ *   specweave auto 0001 0002    # Work on specific increments
+ *   specweave auto --all-backlog # Work on all backlog increments
+ */
+import * as path from 'path';
+import * as fs from 'fs';
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { isSpecWeaveInitialized } from '../../utils/fs-native.js';
+export function createAutoCommand() {
+    const cmd = new Command('auto')
+        .description('Start autonomous execution (simplified - trusts framework hooks)')
+        .argument('[incrementIds...]', 'Increment IDs to process')
+        .option('--all-backlog', 'Process all backlog/planned increments')
+        .option('--no-increment', 'Require existing increments (skip auto-creation)')
+        .option('--no-inc', 'Alias for --no-increment')
+        .option('--prompt <text>', 'Analyze prompt and create increments')
+        .option('--yes', 'Auto-approve increment plan')
+        .option('-y', 'Alias for --yes')
+        .option('--dry-run', 'Preview without starting')
+        .action(async (incrementIds, options) => {
+        const projectPath = process.cwd();
+        if (!isSpecWeaveInitialized(projectPath)) {
+            console.log(chalk.yellow('No SpecWeave project found in current directory.'));
+            console.log(chalk.gray('Run `specweave init` to initialize a project.'));
+            return;
+        }
+        try {
+            await handleAutoCommand(projectPath, incrementIds, options);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(`Error: ${errorMessage}`));
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+/**
+ * Main auto command handler (simplified)
+ */
+export async function handleAutoCommand(projectPath, incrementIds, options) {
+    const incrementsDir = path.join(projectPath, '.specweave/increments');
+    const stateDir = path.join(projectPath, '.specweave/state');
+    // Parse options
+    const allBacklog = options.allBacklog || false;
+    const noIncrement = options.noIncrement || options.noInc || false;
+    const prompt = options.prompt;
+    const autoApprove = options.yes || options.y || false;
+    const dryRun = options.dryRun || false;
+    // Handle --prompt (intelligent chunking)
+    if (prompt) {
+        await handlePromptChunking(projectPath, prompt, autoApprove, stateDir);
+        return;
+    }
+    // Build increment list
+    let finalIncrementIds = [...incrementIds];
+    if (allBacklog) {
+        finalIncrementIds = findIncrementsByStatus(incrementsDir, ['backlog', 'planned']);
+        if (finalIncrementIds.length === 0) {
+            console.log(chalk.yellow('⚠️  No backlog or planned increments found'));
+            return;
+        }
+    }
+    // If no increments specified, find active ones
+    if (finalIncrementIds.length === 0) {
+        finalIncrementIds = findIncrementsByStatus(incrementsDir, ['active', 'in-progress']);
+    }
+    // Still no increments?
+    if (finalIncrementIds.length === 0) {
+        if (noIncrement) {
+            console.log(chalk.red('❌ No increments specified and no active increments found'));
+            console.log('');
+            console.log('Usage: specweave auto [INCREMENT_IDS...]');
+            console.log('       specweave auto --all-backlog');
+            process.exit(1);
+        }
+        else {
+            // Signal to Claude: create increments as needed
+            console.log(chalk.blue('🤔 No increments found. Auto mode will analyze context and create increments.'));
+            console.log('');
+            console.log('💡 The LLM will:');
+            console.log('   1. Analyze user prompt and project context');
+            console.log('   2. Match existing increments OR create new ones');
+            console.log('   3. Start autonomous execution');
+            console.log('');
+            // Create marker for LLM
+            const markerPath = path.join(stateDir, 'auto-needs-increment.json');
+            fs.writeFileSync(markerPath, JSON.stringify({ needsIncrementCreation: true, timestamp: new Date().toISOString() }, null, 2), 'utf-8');
+            process.exit(2); // Special exit code: increment creation needed
+        }
+    }
+    // Dry run preview
+    if (dryRun) {
+        printDryRunPreview(finalIncrementIds);
+        return;
+    }
+    // Start autonomous execution
+    printStartMessage(finalIncrementIds);
+}
+/**
+ * Handle --prompt option (intelligent chunking)
+ */
+async function handlePromptChunking(projectPath, prompt, autoApprove, stateDir) {
+    console.log(chalk.blue('🧠 Analyzing prompt for intelligent chunking...'));
+    console.log('');
+    const marker = {
+        needsIncrementCreation: true,
+        fromChunking: true,
+        autoApproved: autoApprove,
+        prompt,
+        timestamp: new Date().toISOString(),
+    };
+    const markerPath = path.join(stateDir, 'auto-needs-increment.json');
+    fs.writeFileSync(markerPath, JSON.stringify(marker, null, 2), 'utf-8');
+    console.log(chalk.yellow('📋 Prompt analysis required - LLM will handle chunking'));
+    console.log('');
+    if (autoApprove) {
+        console.log(chalk.green('✅ Plan will be auto-approved'));
+    }
+    else {
+        console.log('💡 Review the plan and approve before execution');
+    }
+    process.exit(2);
+}
+/**
+ * Find increments by status (filesystem-based, no session state!)
+ */
+function findIncrementsByStatus(incrementsDir, statuses) {
+    if (!fs.existsSync(incrementsDir)) {
+        return [];
+    }
+    const increments = [];
+    const entries = fs.readdirSync(incrementsDir);
+    for (const entry of entries) {
+        // Skip non-increment directories
+        if (!/^[0-9]{4}-/.test(entry))
+            continue;
+        const metaPath = path.join(incrementsDir, entry, 'metadata.json');
+        if (!fs.existsSync(metaPath))
+            continue;
+        try {
+            const metadata = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+            if (statuses.includes(metadata.status)) {
+                increments.push(entry);
+            }
+        }
+        catch (error) {
+            // Skip invalid metadata
+            continue;
+        }
+    }
+    return increments;
+}
+/**
+ * Print dry run preview
+ */
+function printDryRunPreview(incrementIds) {
+    console.log(chalk.blue('🔍 Dry Run - Preview'));
+    console.log('');
+    console.log('Active Increments:');
+    for (const incId of incrementIds) {
+        console.log('  • ' + chalk.cyan(incId));
+    }
+    console.log('');
+    console.log(chalk.gray('Run without --dry-run to start autonomous execution.'));
+}
+/**
+ * Print start message
+ */
+function printStartMessage(incrementIds) {
+    console.log(chalk.green('🚀 Auto Mode Started'));
+    console.log('');
+    console.log(`Active Increments (${incrementIds.length}):`);
+    for (const incId of incrementIds) {
+        console.log('  • ' + chalk.cyan(incId));
+    }
+    console.log('');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log(chalk.yellow('📋 HOW AUTO MODE WORKS:'));
+    console.log('');
+    console.log('1. Stop hook checks for active increments');
+    console.log('2. If active increments exist → blocks exit, continues working');
+    console.log('3. Execute /sw:do to work on tasks');
+    console.log('4. When tasks complete → run /sw:done for validation');
+    console.log('5. If /sw:done passes → increment completes, move to next');
+    console.log('6. If /sw:done fails → keep fixing, try again');
+    console.log('7. When all increments complete → stop hook approves exit');
+    console.log('');
+    console.log(chalk.yellow('🎯 FRAMEWORK HANDLES:'));
+    console.log('  • Task updates → Auto-sync to GitHub/JIRA/ADO (via hooks)');
+    console.log('  • Spec updates → Auto-update ACs (via hooks)');
+    console.log('  • Status transitions → Auto-transition when tasks complete (via hooks)');
+    console.log('  • Quality validation → Tests, build, coverage (/sw:done)');
+    console.log('  • Living docs → Auto-sync on completion (via hooks)');
+    console.log('');
+    console.log(chalk.yellow('⚡ STOP CRITERIA:'));
+    console.log('  • All active increments completed (validated by /sw:done)');
+    console.log('  • Tests pass (enforced by /sw:done)');
+    console.log('  • Build succeeds (enforced by /sw:done)');
+    console.log('  • User runs specweave cancel-auto');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
+    console.log(chalk.gray('💡 Tip: The stop hook will keep you working until done. Trust the framework!'));
+    console.log('');
+}
+//# sourceMappingURL=auto-simple.js.map

package/dist/src/cli/commands/auto-simple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-simple.js","sourceRoot":"","sources":["../../../../src/cli/commands/auto-simple.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"auto-status.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/auto-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,uBAAuB,IAAI,OAAO,CA0BjD"}
+{"version":3,"file":"auto-status.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/auto-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,uBAAuB,IAAI,OAAO,CA0BjD"}

package/dist/src/cli/commands/auto-status.js

@@ -12,7 +12,6 @@ import * as path from 'path';
 import * as fs from 'fs';
 import chalk from 'chalk';
 import { Command } from 'commander';
-import { SessionStateManager } from '../../core/auto/session-state.js';
 export function createAutoStatusCommand() {
     const cmd = new Command('auto-status')
         .description('Check auto session status and progress')
@@ -42,14 +41,22 @@ export function createAutoStatusCommand() {
  * Handle auto-status command
  */
 async function handleAutoStatus(projectPath, options) {
-    const sessionManager = new SessionStateManager(projectPath);
-    const session = sessionManager.load();
-    if (!session) {
+    const sessionPath = path.join(projectPath, '.specweave/state/auto-session.json');
+    // Load session
+    if (!fs.existsSync(sessionPath)) {
         console.log(chalk.yellow('No auto session found'));
         console.log('');
         console.log('Start a new session with: ' + chalk.cyan('specweave auto [INCREMENT_IDS...]'));
         return;
     }
+    let session;
+    try {
+        session = JSON.parse(fs.readFileSync(sessionPath, 'utf-8'));
+    }
+    catch (error) {
+        console.log(chalk.yellow('Invalid auto session file'));
+        return;
+    }
     // JSON output
     if (options.json) {
         console.log(JSON.stringify(session, null, 2));
@@ -140,20 +147,23 @@ async function handleAutoStatus(projectPath, options) {
         }
     }
     // Circuit breakers
-    const openBreakers = Object.entries(session.circuitBreakers).filter(([_, status]) => status.state === 'open');
-    if (openBreakers.length > 0) {
-        console.log('');
-        console.log(chalk.bold('CIRCUIT BREAKERS'));
-        console.log(chalk.bold('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-        console.log('');
-        for (const [service, status] of openBreakers) {
-            console.log(`${service}:`.padEnd(15) + chalk.red('OPEN'));
-            console.log('  Failures:   ' + chalk.yellow(status.failures.toString()));
-            if (status.lastFailure) {
-                console.log('  Last:       ' + chalk.gray(status.lastFailure));
-            }
-            if (status.nextRetry) {
-                console.log('  Next Retry: ' + chalk.gray(status.nextRetry));
+    if (session.circuitBreakers) {
+        const openBreakers = Object.entries(session.circuitBreakers).filter(([_, status]) => status.state === 'open');
+        if (openBreakers.length > 0) {
+            console.log('');
+            console.log(chalk.bold('CIRCUIT BREAKERS'));
+            console.log(chalk.bold('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+            console.log('');
+            for (const [service, status] of openBreakers) {
+                const s = status;
+                console.log(`${service}:`.padEnd(15) + chalk.red('OPEN'));
+                console.log('  Failures:   ' + chalk.yellow(s.failures.toString()));
+                if (s.lastFailure) {
+                    console.log('  Last:       ' + chalk.gray(s.lastFailure));
+                }
+                if (s.nextRetry) {
+                    console.log('  Next Retry: ' + chalk.gray(s.nextRetry));
+                }
             }
         }
     }