specweave 1.0.67 → 1.0.68

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.67",
+  "version": "1.0.68",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/commands/auto.md

@@ -13,6 +13,14 @@ description: Start autonomous execution session with stop hook integration. Work
 /sw:auto [INCREMENT_IDS...] [OPTIONS]
 ```
 
+:::tip 🚀 Claude Code's Game-Changing Features for Auto Mode
+**Compact Command (VSCode)** — Use `compact` mode to keep Claude Code inside your VSCode window. Work continuously for **hours** in the same session without context switching between terminal and editor. Perfect for long auto mode sessions!
+
+**STOP Hooks with Subagents** — Stop hooks now work with spawned subagents! This means `/sw:auto` can validate quality gates at EVERY level of execution. When auto mode spawns specialized agents (QA, Security, Performance), the stop hook validates their results before allowing the session to continue.
+
+**Real-world proof**: Boris Cherny (Claude Code creator) shipped 259 PRs, 497 commits, 40,000 lines in one month without opening an IDE — using autonomous execution with stop hooks. [See demo](https://x.com/bcherny/status/2004916410687050167)
+:::
+
 ## Arguments
 
 - `INCREMENT_IDS`: One or more increment IDs to process (e.g., `0001`, `0001-feature`)

package/plugins/specweave/lib/hooks/update-ac-status.js

@@ -1,5 +1,9 @@
 #!/usr/bin/env node
 import { ACStatusManager } from "../vendor/core/increment/ac-status-manager.js";
+import { SyncCoordinator } from "../../../../dist/src/sync/sync-coordinator.js";
+import { consoleLogger } from "../vendor/utils/logger.js";
+import { readFileSync, existsSync } from "fs";
+import * as path from "path";
 async function updateACStatus(incrementId) {
   try {
     const projectRoot = process.cwd();
@@ -25,6 +29,7 @@ async function updateACStatus(incrementId) {
         console.log("\n\u{1F4DD} Changes:");
         result.changes.forEach((change) => console.log(`   ${change}`));
       }
+      await syncACsToGitHub(projectRoot, incrementId);
     } else if (result.synced) {
       console.log("\u2705 All ACs already in sync (no changes needed)");
     } else {
@@ -34,6 +39,51 @@ async function updateACStatus(incrementId) {
     console.error("\u274C Error updating AC status:", error);
   }
 }
+async function syncACsToGitHub(projectRoot, incrementId) {
+  try {
+    const configPath = path.join(projectRoot, ".specweave/config.json");
+    if (!existsSync(configPath)) {
+      console.log("\u2139\uFE0F  No config.json found, skipping GitHub sync");
+      return;
+    }
+    const configContent = readFileSync(configPath, "utf-8");
+    const config = JSON.parse(configContent);
+    const isGitHubEnabled = config.sync?.github?.enabled || config.sync?.profiles && Object.values(config.sync.profiles).some(
+      (p) => p?.provider === "github"
+    ) || config.sync?.provider === "github";
+    if (!isGitHubEnabled) {
+      console.log("\u2139\uFE0F  GitHub sync not enabled, skipping");
+      return;
+    }
+    const canUpdateExternal = config.sync?.settings?.canUpdateExternalItems !== false;
+    if (!canUpdateExternal) {
+      console.log("\u2139\uFE0F  canUpdateExternalItems=false, skipping GitHub sync");
+      return;
+    }
+    console.log("\n\u{1F517} Syncing AC checkboxes to GitHub...");
+    const coordinator = new SyncCoordinator({
+      projectRoot,
+      incrementId,
+      logger: consoleLogger
+    });
+    const syncResult = await coordinator.syncACCheckboxesToGitHub(config, {
+      addComment: false
+      // Don't add comment on every AC update (prevent spam)
+    });
+    if (syncResult.success && syncResult.updated > 0) {
+      console.log(`   \u2705 Updated ${syncResult.updated} AC(s) in GitHub issues`);
+      if (syncResult.issues.length > 0) {
+        console.log(`   \u{1F4DD} Issues updated: ${syncResult.issues.join(", ")}`);
+      }
+    } else if (syncResult.success) {
+      console.log("   \u2139\uFE0F  No GitHub updates needed");
+    } else {
+      console.log("   \u26A0\uFE0F  GitHub sync had errors (non-blocking)");
+    }
+  } catch (error) {
+    console.log(`   \u26A0\uFE0F  GitHub sync failed: ${error.message}`);
+  }
+}
 const isMainModule = import.meta.url === `file://${process.argv[1]}`;
 if (isMainModule) {
   const incrementId = process.argv[2];

package/plugins/specweave/lib/hooks/update-ac-status.ts

@@ -9,6 +9,7 @@
  * - Warns about orphaned ACs (no implementing tasks)
  * - Provides detailed sync result with diff
  * - Atomic file writes to prevent corruption
+ * - **NEW v1.0.68**: Auto-syncs AC checkboxes to GitHub issues
  *
  * Flow:
  * 1. Parse tasks.md → Map AC-IDs to completion status
@@ -16,17 +17,23 @@
  * 3. Compare task completion vs spec checkboxes
  * 4. Update spec.md only for 100% complete ACs
  * 5. Log conflicts, warnings, and changes
+ * 6. **NEW**: Sync updated ACs to linked GitHub issues
  *
  * Called by: plugins/specweave/hooks/post-task-completion.sh
  *
  * Example:
  * - Tasks: T-001 [x], T-002 [x] (both have AC-US1-01) → AC-US1-01 100% complete
  * - spec.md: - [ ] AC-US1-01 → - [x] AC-US1-01 ✅
+ * - GitHub issue: - [ ] **AC-US1-01** → - [x] **AC-US1-01** 🔗
  * - Tasks: T-003 [x], T-004 [ ] (both have AC-US1-02) → AC-US1-02 50% complete
  * - spec.md: - [ ] AC-US1-02 → NO CHANGE (partial completion)
  */
 
 import { ACStatusManager } from '../vendor/core/increment/ac-status-manager.js';
+import { SyncCoordinator } from '../../../../dist/src/sync/sync-coordinator.js';
+import { consoleLogger } from '../vendor/utils/logger.js';
+import { readFileSync, existsSync } from 'fs';
+import * as path from 'path';
 
 /**
  * Main entry point - uses ACStatusManager for sophisticated sync
@@ -68,6 +75,9 @@ async function updateACStatus(incrementId: string): Promise<void> {
         console.log('\n📝 Changes:');
         result.changes.forEach((change: string) => console.log(`   ${change}`));
       }
+
+      // NEW v1.0.68: Auto-sync AC checkboxes to GitHub issues
+      await syncACsToGitHub(projectRoot, incrementId);
     } else if (result.synced) {
       console.log('✅ All ACs already in sync (no changes needed)');
     } else {
@@ -80,6 +90,79 @@ async function updateACStatus(incrementId: string): Promise<void> {
   }
 }
 
+/**
+ * Sync AC checkboxes to GitHub issues (v1.0.68)
+ *
+ * CRITICAL FIX: Previously, AC completion only updated spec.md locally.
+ * GitHub issues were NOT updated until manual /sw:sync-progress was run.
+ * This fixes issue #966 by auto-syncing to GitHub after AC updates.
+ *
+ * @param projectRoot - Project root directory
+ * @param incrementId - Increment ID
+ */
+async function syncACsToGitHub(projectRoot: string, incrementId: string): Promise<void> {
+  try {
+    // Check if GitHub sync is enabled in config
+    const configPath = path.join(projectRoot, '.specweave/config.json');
+    if (!existsSync(configPath)) {
+      console.log('ℹ️  No config.json found, skipping GitHub sync');
+      return;
+    }
+
+    const configContent = readFileSync(configPath, 'utf-8');
+    const config = JSON.parse(configContent);
+
+    // Check for GitHub sync enabled
+    const isGitHubEnabled =
+      config.sync?.github?.enabled ||
+      (config.sync?.profiles && Object.values(config.sync.profiles).some(
+        (p: any) => p?.provider === 'github'
+      )) ||
+      config.sync?.provider === 'github';
+
+    if (!isGitHubEnabled) {
+      console.log('ℹ️  GitHub sync not enabled, skipping');
+      return;
+    }
+
+    // Check if external sync is allowed
+    const canUpdateExternal = config.sync?.settings?.canUpdateExternalItems !== false;
+    if (!canUpdateExternal) {
+      console.log('ℹ️  canUpdateExternalItems=false, skipping GitHub sync');
+      return;
+    }
+
+    console.log('\n🔗 Syncing AC checkboxes to GitHub...');
+
+    // Use SyncCoordinator for GitHub sync
+    const coordinator = new SyncCoordinator({
+      projectRoot,
+      incrementId,
+      logger: consoleLogger
+    });
+
+    const syncResult = await coordinator.syncACCheckboxesToGitHub(config, {
+      addComment: false // Don't add comment on every AC update (prevent spam)
+    });
+
+    if (syncResult.success && syncResult.updated > 0) {
+      console.log(`   ✅ Updated ${syncResult.updated} AC(s) in GitHub issues`);
+      if (syncResult.issues.length > 0) {
+        console.log(`   📝 Issues updated: ${syncResult.issues.join(', ')}`);
+      }
+    } else if (syncResult.success) {
+      console.log('   ℹ️  No GitHub updates needed');
+    } else {
+      console.log('   ⚠️  GitHub sync had errors (non-blocking)');
+    }
+
+  } catch (error: any) {
+    // Non-blocking: Log but don't fail the hook
+    console.log(`   ⚠️  GitHub sync failed: ${error.message}`);
+    // Continue - local AC sync already succeeded
+  }
+}
+
 // CLI Entry Point (ES Module)
 const isMainModule = import.meta.url === `file://${process.argv[1]}`;