specweave 0.17.0 → 0.17.1

package/plugins/specweave-ado/lib/project-selector.js

@@ -1,183 +1,211 @@
-import inquirer from "inquirer";
-async function fetchAllAdoProjects(client) {
-  console.log("\u{1F50D} Fetching Azure DevOps projects...");
-  try {
-    const projects = await client.getProjects();
-    console.log(`\u2705 Found ${projects.length} Azure DevOps projects
-`);
-    return projects;
-  } catch (error) {
-    console.error("\u274C Failed to fetch ADO projects:", error.message);
-    throw error;
-  }
+/**
+ * ADO Project Selector with Pagination
+ *
+ * Features:
+ * - Fetches all ADO projects via API
+ * - Interactive multi-select with search
+ * - Manual project name entry (comma-separated)
+ * - Handles large project lists (50+ projects)
+ * - Validates project names
+ */
+import inquirer from 'inquirer';
+// ============================================================================
+// ADO Project Fetching
+// ============================================================================
+/**
+ * Fetch all ADO projects from API
+ */
+export async function fetchAllAdoProjects(client) {
+    console.log('🔍 Fetching Azure DevOps projects...');
+    try {
+        const projects = await client.getProjects();
+        console.log(`✅ Found ${projects.length} Azure DevOps projects\n`);
+        return projects;
+    }
+    catch (error) {
+        console.error('❌ Failed to fetch ADO projects:', error.message);
+        throw error;
+    }
 }
-async function selectAdoProjects(client, options = {}) {
-  const {
-    allowManualEntry = true,
-    allowSelectAll = true,
-    preSelected = [],
-    minSelection = 1,
-    maxSelection,
-    pageSize = 15
-  } = options;
-  const allProjects = await fetchAllAdoProjects(client);
-  if (allProjects.length === 0) {
-    console.log("\u26A0\uFE0F  No Azure DevOps projects found");
-    return {
-      selectedNames: [],
-      method: "interactive"
-    };
-  }
-  console.log("\u{1F4CB} Available Azure DevOps Projects:\n");
-  console.log(`   Total: ${allProjects.length} projects
-`);
-  const { selectionMethod } = await inquirer.prompt([
-    {
-      type: "list",
-      name: "selectionMethod",
-      message: "How would you like to select projects?",
-      choices: [
+// ============================================================================
+// Interactive Project Selection
+// ============================================================================
+/**
+ * Interactive project selector with search and pagination
+ */
+export async function selectAdoProjects(client, options = {}) {
+    const { allowManualEntry = true, allowSelectAll = true, preSelected = [], minSelection = 1, maxSelection, pageSize = 15, } = options;
+    // Fetch all projects
+    const allProjects = await fetchAllAdoProjects(client);
+    if (allProjects.length === 0) {
+        console.log('⚠️  No Azure DevOps projects found');
+        return {
+            selectedNames: [],
+            method: 'interactive',
+        };
+    }
+    // Show project overview
+    console.log('📋 Available Azure DevOps Projects:\n');
+    console.log(`   Total: ${allProjects.length} projects\n`);
+    // Decide selection method
+    const { selectionMethod } = await inquirer.prompt([
         {
-          name: `\u{1F4CB} Interactive (browse and select from ${allProjects.length} projects)`,
-          value: "interactive"
+            type: 'list',
+            name: 'selectionMethod',
+            message: 'How would you like to select projects?',
+            choices: [
+                {
+                    name: `📋 Interactive (browse and select from ${allProjects.length} projects)`,
+                    value: 'interactive',
+                },
+                {
+                    name: '✏️  Manual entry (type project names)',
+                    value: 'manual',
+                },
+                ...(allowSelectAll
+                    ? [
+                        {
+                            name: `✨ Select all (${allProjects.length} projects)`,
+                            value: 'all',
+                        },
+                    ]
+                    : []),
+            ],
         },
+    ]);
+    if (selectionMethod === 'all') {
+        return {
+            selectedNames: allProjects.map((p) => p.name),
+            method: 'all',
+        };
+    }
+    if (selectionMethod === 'manual') {
+        return await manualProjectEntry(allProjects, minSelection, maxSelection);
+    }
+    // Interactive selection
+    return await interactiveProjectSelection(allProjects, preSelected, minSelection, maxSelection, pageSize);
+}
+/**
+ * Interactive project selection with checkbox
+ */
+async function interactiveProjectSelection(allProjects, preSelected, minSelection, maxSelection, pageSize) {
+    console.log('💡 Use <space> to select, <a> to toggle all, <i> to invert\n');
+    const choices = allProjects.map((p) => ({
+        name: formatProjectChoice(p),
+        value: p.name,
+        checked: preSelected.includes(p.name),
+    }));
+    // Add manual entry option at the end
+    choices.push(new inquirer.Separator(), {
+        name: '✏️  Enter project names manually instead',
+        value: '__MANUAL__',
+        checked: false,
+    });
+    const { selectedNames } = await inquirer.prompt([
         {
-          name: "\u270F\uFE0F  Manual entry (type project names)",
-          value: "manual"
+            type: 'checkbox',
+            name: 'selectedNames',
+            message: `Select Azure DevOps projects (${minSelection}${maxSelection ? `-${maxSelection}` : '+'} required):`,
+            choices,
+            pageSize,
+            loop: false,
+            validate: (selected) => {
+                const actualSelected = selected.filter((k) => k !== '__MANUAL__');
+                if (actualSelected.length < minSelection) {
+                    return `Please select at least ${minSelection} project(s)`;
+                }
+                if (maxSelection && actualSelected.length > maxSelection) {
+                    return `Please select at most ${maxSelection} project(s)`;
+                }
+                return true;
+            },
         },
-        ...allowSelectAll ? [
-          {
-            name: `\u2728 Select all (${allProjects.length} projects)`,
-            value: "all"
-          }
-        ] : []
-      ]
+    ]);
+    // Check if user chose manual entry
+    if (selectedNames.includes('__MANUAL__')) {
+        return await manualProjectEntry(allProjects, minSelection, maxSelection);
     }
-  ]);
-  if (selectionMethod === "all") {
+    console.log(`\n✅ Selected ${selectedNames.length} projects: ${selectedNames.join(', ')}\n`);
     return {
-      selectedNames: allProjects.map((p) => p.name),
-      method: "all"
+        selectedNames,
+        method: 'interactive',
     };
-  }
-  if (selectionMethod === "manual") {
-    return await manualProjectEntry(allProjects, minSelection, maxSelection);
-  }
-  return await interactiveProjectSelection(
-    allProjects,
-    preSelected,
-    minSelection,
-    maxSelection,
-    pageSize
-  );
-}
-async function interactiveProjectSelection(allProjects, preSelected, minSelection, maxSelection, pageSize) {
-  console.log("\u{1F4A1} Use <space> to select, <a> to toggle all, <i> to invert\n");
-  const choices = allProjects.map((p) => ({
-    name: formatProjectChoice(p),
-    value: p.name,
-    checked: preSelected.includes(p.name)
-  }));
-  choices.push(
-    new inquirer.Separator(),
-    {
-      name: "\u270F\uFE0F  Enter project names manually instead",
-      value: "__MANUAL__",
-      checked: false
-    }
-  );
-  const { selectedNames } = await inquirer.prompt([
-    {
-      type: "checkbox",
-      name: "selectedNames",
-      message: `Select Azure DevOps projects (${minSelection}${maxSelection ? `-${maxSelection}` : "+"} required):`,
-      choices,
-      pageSize,
-      loop: false,
-      validate: (selected) => {
-        const actualSelected = selected.filter((k) => k !== "__MANUAL__");
-        if (actualSelected.length < minSelection) {
-          return `Please select at least ${minSelection} project(s)`;
-        }
-        if (maxSelection && actualSelected.length > maxSelection) {
-          return `Please select at most ${maxSelection} project(s)`;
-        }
-        return true;
-      }
-    }
-  ]);
-  if (selectedNames.includes("__MANUAL__")) {
-    return await manualProjectEntry(allProjects, minSelection, maxSelection);
-  }
-  console.log(`
-\u2705 Selected ${selectedNames.length} projects: ${selectedNames.join(", ")}
-`);
-  return {
-    selectedNames,
-    method: "interactive"
-  };
 }
+/**
+ * Manual project name entry (comma-separated)
+ */
 async function manualProjectEntry(allProjects, minSelection, maxSelection) {
-  console.log("\n\u{1F4DD} Enter project names manually\n");
-  console.log("\u{1F4A1} Format: Comma-separated project names (e.g., AI Meme Generator,Project 2,Project 3)\n");
-  if (allProjects.length > 0) {
-    console.log("Available project names:");
-    console.log(
-      allProjects.map((p) => p.name).join(", ").substring(0, 100) + (allProjects.length > 20 ? "..." : "")
-    );
-    console.log("");
-  }
-  const { manualNames } = await inquirer.prompt([
-    {
-      type: "input",
-      name: "manualNames",
-      message: "Project names:",
-      validate: (input) => {
-        if (!input.trim()) {
-          return "Please enter at least one project name";
-        }
-        const names = input.split(",").map((n) => n.trim()).filter((n) => n.length > 0);
-        if (names.length < minSelection) {
-          return `Please enter at least ${minSelection} project name(s)`;
-        }
-        if (maxSelection && names.length > maxSelection) {
-          return `Please enter at most ${maxSelection} project name(s)`;
-        }
-        return true;
-      }
+    console.log('\n📝 Enter project names manually\n');
+    console.log('💡 Format: Comma-separated project names (e.g., AI Meme Generator,Project 2,Project 3)\n');
+    if (allProjects.length > 0) {
+        console.log('Available project names:');
+        console.log(allProjects
+            .map((p) => p.name)
+            .join(', ')
+            .substring(0, 100) + (allProjects.length > 20 ? '...' : ''));
+        console.log('');
     }
-  ]);
-  const selectedNames = manualNames.split(",").map((n) => n.trim()).filter((n) => n.length > 0);
-  const knownNames = allProjects.map((p) => p.name);
-  const unknownNames = selectedNames.filter((n) => !knownNames.includes(n));
-  if (unknownNames.length > 0) {
-    console.log(`
-\u26A0\uFE0F  Unknown project names (will be used anyway): ${unknownNames.join(", ")}`);
-    console.log("   Make sure these projects exist in your Azure DevOps organization.\n");
-  }
-  console.log(`\u2705 Selected ${selectedNames.length} projects: ${selectedNames.join(", ")}
-`);
-  return {
-    selectedNames,
-    method: "manual"
-  };
+    const { manualNames } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'manualNames',
+            message: 'Project names:',
+            validate: (input) => {
+                if (!input.trim()) {
+                    return 'Please enter at least one project name';
+                }
+                const names = input
+                    .split(',')
+                    .map((n) => n.trim())
+                    .filter((n) => n.length > 0);
+                if (names.length < minSelection) {
+                    return `Please enter at least ${minSelection} project name(s)`;
+                }
+                if (maxSelection && names.length > maxSelection) {
+                    return `Please enter at most ${maxSelection} project name(s)`;
+                }
+                return true;
+            },
+        },
+    ]);
+    const selectedNames = manualNames
+        .split(',')
+        .map((n) => n.trim())
+        .filter((n) => n.length > 0);
+    // Warn about unknown projects
+    const knownNames = allProjects.map((p) => p.name);
+    const unknownNames = selectedNames.filter((n) => !knownNames.includes(n));
+    if (unknownNames.length > 0) {
+        console.log(`\n⚠️  Unknown project names (will be used anyway): ${unknownNames.join(', ')}`);
+        console.log('   Make sure these projects exist in your Azure DevOps organization.\n');
+    }
+    console.log(`✅ Selected ${selectedNames.length} projects: ${selectedNames.join(', ')}\n`);
+    return {
+        selectedNames,
+        method: 'manual',
+    };
 }
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Format project choice for display
+ */
 function formatProjectChoice(project) {
-  const visibility = project.visibility || "private";
-  const state = project.state || "wellFormed";
-  return `${project.name.padEnd(30)} - ${project.description || "No description"} (${visibility}, ${state})`;
+    const visibility = project.visibility || 'private';
+    const state = project.state || 'wellFormed';
+    return `${project.name.padEnd(30)} - ${project.description || 'No description'} (${visibility}, ${state})`;
 }
-async function selectSingleAdoProject(client, message = "Select Azure DevOps project:") {
-  const result = await selectAdoProjects(client, {
-    allowManualEntry: true,
-    allowSelectAll: false,
-    minSelection: 1,
-    maxSelection: 1
-  });
-  return result.selectedNames[0];
+/**
+ * Quick project selector - select single project
+ */
+export async function selectSingleAdoProject(client, message = 'Select Azure DevOps project:') {
+    const result = await selectAdoProjects(client, {
+        allowManualEntry: true,
+        allowSelectAll: false,
+        minSelection: 1,
+        maxSelection: 1,
+    });
+    return result.selectedNames[0];
 }
-export {
-  fetchAllAdoProjects,
-  selectAdoProjects,
-  selectSingleAdoProject
-};
+//# sourceMappingURL=project-selector.js.map

package/plugins/specweave-ado/skills/ado-resource-validator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ado-resource-validator
-description: Validates Azure DevOps projects and resources exist, creates missing resources automatically. Smart enough to prompt user to select existing or create new projects. Supports multiple projects for project-per-team strategy, area paths for area-path-based strategy, and teams for team-based strategy. Activates for ado setup, ado validation, ado configuration, missing ado project, azure devops .env setup.
+description: Validates Azure DevOps projects and resources exist, creates missing resources automatically. Smart enough to prompt user to select existing or create new projects. Supports multiple projects for project-per-team strategy, area paths for area-path-based strategy, and teams for team-based strategy. NEW - Per-project configuration support - AZURE_DEVOPS_AREA_PATHS_{ProjectName} and AZURE_DEVOPS_TEAMS_{ProjectName} for hierarchical organization. Activates for ado setup, ado validation, ado configuration, missing ado project, azure devops .env setup, per-project area paths, per-project teams.
 allowed-tools: Read, Bash, Write, Edit
 ---
 
@@ -66,6 +66,32 @@ AZURE_DEVOPS_TEAMS=Alpha Team,Beta Team,Gamma Team
 → Validates MainProduct project exists
 → Creates teams if missing: Alpha Team, Beta Team, Gamma Team
 
+**NEW: Per-Project Configuration** (Advanced - Multiple Projects × Resources)
+```bash
+# Multiple projects with their own area paths and teams
+AZURE_DEVOPS_STRATEGY=project-per-team
+AZURE_DEVOPS_PROJECTS=Backend,Frontend,Mobile
+
+# Per-project area paths (hierarchical naming)
+AZURE_DEVOPS_AREA_PATHS_Backend=API,Database,Cache
+AZURE_DEVOPS_AREA_PATHS_Frontend=Web,Admin,Public
+AZURE_DEVOPS_AREA_PATHS_Mobile=iOS,Android,Shared
+
+# Per-project teams (optional)
+AZURE_DEVOPS_TEAMS_Backend=Alpha,Beta
+AZURE_DEVOPS_TEAMS_Frontend=Gamma
+```
+→ Validates 3 projects exist: Backend, Frontend, Mobile
+→ Creates area paths per project:
+  - Backend\API, Backend\Database, Backend\Cache
+  - Frontend\Web, Frontend\Admin, Frontend\Public
+  - Mobile\iOS, Mobile\Android, Mobile\Shared
+→ Creates teams per project:
+  - Backend: Alpha, Beta
+  - Frontend: Gamma
+
+**Naming Convention**: `{PROVIDER}_{RESOURCE_TYPE}_{PROJECT_NAME}`
+
 ## Validation Flow
 
 ### Step 1: Strategy Detection
@@ -326,28 +352,155 @@ Work items will be organized by area:
   • Analytics features → EnterpriseApp\Analytics
 ```
 
+## Implementation Details
+
+**Location**: `src/utils/external-resource-validator.ts`
+
+**Core Classes**:
+```typescript
+// Main validator class
+export class AzureDevOpsResourceValidator {
+  private pat: string;
+  private organization: string;
+  private envPath: string;
+
+  constructor(envPath: string = '.env') {
+    this.envPath = envPath;
+    const env = this.loadEnv();
+    this.pat = env.AZURE_DEVOPS_PAT || '';
+    this.organization = env.AZURE_DEVOPS_ORG || '';
+  }
+
+  // Main validation entry point
+  async validate(): Promise<AzureDevOpsValidationResult> {
+    const env = this.loadEnv();
+    const strategy = env.AZURE_DEVOPS_STRATEGY || 'project-per-team';
+
+    // Validate based on strategy
+    if (strategy === 'project-per-team') {
+      return this.validateMultipleProjects(projectNames);
+    } else if (strategy === 'area-path-based') {
+      return this.validateAreaPaths(projectName, areaPaths);
+    } else if (strategy === 'team-based') {
+      return this.validateTeams(projectName, teams);
+    }
+  }
+}
+
+// Public API function
+export async function validateAzureDevOpsResources(
+  envPath: string = '.env'
+): Promise<AzureDevOpsValidationResult> {
+  const validator = new AzureDevOpsResourceValidator(envPath);
+  return validator.validate();
+}
+```
+
+**Key Implementation Features**:
+
+1. **Async Project Creation** (ADO-specific):
+   ```typescript
+   // ADO creates projects asynchronously - need to poll for completion
+   async createProject(name: string): Promise<AzureDevOpsProject> {
+     const result = await this.callAzureDevOpsApi('projects?api-version=7.0', 'POST', body);
+
+     // Wait for project to be fully created (ADO async behavior)
+     await this.waitForProjectCreation(result.id);
+
+     return { id: result.id, name, description };
+   }
+
+   // Poll until project is in 'wellFormed' state
+   private async waitForProjectCreation(projectId: string): Promise<void> {
+     const maxAttempts = 30; // 30 seconds max wait
+     for (let i = 0; i < maxAttempts; i++) {
+       const project = await this.getProject(projectId);
+       if (project.state === 'wellFormed') {
+         return; // Project is ready!
+       }
+       await new Promise(resolve => setTimeout(resolve, 1000)); // Wait 1 second
+     }
+     throw new Error('Project creation timeout');
+   }
+   ```
+
+2. **Interactive Prompts** (when resources missing):
+   ```typescript
+   const { action } = await inquirer.prompt([
+     {
+       type: 'list',
+       name: 'action',
+       message: `Project "${projectName}" not found. What would you like to do?`,
+       choices: [
+         { name: 'Create new project', value: 'create' },
+         { name: 'Select existing project', value: 'select' },
+         { name: 'Skip this project', value: 'skip' },
+         { name: 'Cancel', value: 'cancel' }
+       ]
+     }
+   ]);
+   ```
+
+3. **Automatic .env Updates**:
+   ```typescript
+   // After creating projects, update .env
+   updateEnv(key: string, value: string): void {
+     const envContent = fs.readFileSync(this.envPath, 'utf-8');
+     const updated = envContent.replace(
+       new RegExp(`^${key}=.*$`, 'm'),
+       `${key}=${value}`
+     );
+     fs.writeFileSync(this.envPath, updated);
+   }
+   ```
+
 ## CLI Command
 
-**Manual validation**:
+**Automatic validation** (during setup):
 ```bash
-# From TypeScript
-npx tsx src/utils/external-resource-validator.ts --provider=ado
+# Runs automatically during specweave init
+npx specweave init
 
-# Or via skill activation
+# Also runs automatically before sync
+/specweave-ado:sync 0014
+```
+
+**Manual validation**:
+```bash
+# Via skill activation
 "Can you validate my Azure DevOps configuration?"
+
+# Via TypeScript directly
+npx tsx -e "import { validateAzureDevOpsResources } from './dist/utils/external-resource-validator.js'; await validateAzureDevOpsResources();"
+
+# Via CLI (future command - planned)
+specweave validate-ado
 ```
 
 **Validation output**:
 ```typescript
+interface AzureDevOpsValidationResult {
+  valid: boolean;
+  strategy: 'project-per-team' | 'area-path-based' | 'team-based';
+  projects: Array<{
+    name: string;
+    id: string;
+    exists: boolean;
+  }>;
+  created: string[];      // Names of newly created resources
+  envUpdated: boolean;    // Whether .env was modified
+}
+
+// Example output:
 {
   valid: true,
   strategy: 'project-per-team',
   projects: [
     { name: 'WebApp', id: 'proj-001', exists: true },
-    { name: 'MobileApp', id: 'proj-002', exists: true },
-    { name: 'Platform', id: 'proj-003', exists: true }
+    { name: 'MobileApp', id: 'proj-002', exists: true, created: true },
+    { name: 'Platform', id: 'proj-003', exists: true, created: true }
   ],
-  created: [],
+  created: ['MobileApp', 'Platform'],
   envUpdated: false
 }
 ```
@@ -700,20 +853,54 @@ Based on strategy, the skill creates appropriate folder structure:
     └── spec-001-feature-c.md
 ```
 
+## Key Differences from JIRA
+
+**Azure DevOps vs JIRA Resource Creation**:
+
+| Aspect | Azure DevOps | JIRA |
+|--------|-------------|------|
+| **Project Creation** | Asynchronous (polling required) | Synchronous (immediate) |
+| **Creation Time** | 5-30 seconds | <1 second |
+| **Status Tracking** | Poll `state` field ('wellFormed') | No polling needed |
+| **API Complexity** | Higher (async handling) | Lower (sync operations) |
+| **Board Creation** | Auto-created with project | Requires separate API call |
+| **Process Templates** | Required (Agile, Scrum, CMMI) | Not applicable |
+
+**Why Async Matters**:
+
+When you create an ADO project, the API returns immediately with `state: 'new'`, but the project isn't usable yet. The validator polls every 1 second (max 30 attempts) until `state: 'wellFormed'`:
+
+```typescript
+// Create project (returns immediately)
+const project = await createProject('MobileApp'); // state: 'new'
+
+// Poll until ready
+await waitForProjectCreation(project.id); // Polls until state: 'wellFormed'
+
+// Now safe to use!
+console.log('✅ Project ready for work items');
+```
+
+**Impact on UX**:
+- JIRA: "✅ Project created" (instant)
+- ADO: "📦 Creating project... ⏳ Waiting for Azure DevOps to complete setup... ✅ Project ready!" (5-30s)
+
 ## Summary
 
 This skill ensures your Azure DevOps configuration is **always valid** by:
 
 1. ✅ **Validating projects** - Check if projects exist, prompt to select or create
 2. ✅ **Supporting multiple strategies** - Project-per-team, area-path-based, team-based
-3. ✅ **Auto-creating resources** - Projects, area paths, teams
+3. ✅ **Auto-creating resources** - Projects, area paths, teams (with async handling)
 4. ✅ **Organizing specs** - Create folder structure based on projects
 5. ✅ **Clear error messages** - Actionable guidance for all failures
+6. ✅ **Handles ADO async behavior** - Polls for project creation completion
 
-**Result**: Zero manual Azure DevOps setup - system handles everything!
+**Result**: Zero manual Azure DevOps setup - system handles everything, including ADO's async project creation!
 
 ---
 
-**Skill Version**: 1.0.0
+**Skill Version**: 1.1.0
 **Introduced**: SpecWeave v0.17.0
-**Last Updated**: 2025-11-11
+**Last Updated**: 2025-11-11
+**Key Changes v1.1.0**: Added implementation details, async project creation handling, JIRA comparison

package/plugins/specweave-github/.claude-plugin/plugin.json

@@ -15,5 +15,6 @@
     "integration",
     "sync",
     "specweave"
-  ]
+  ],
+  "hooks": "hooks/hooks.json"
 }

package/plugins/specweave-github/hooks/post-task-completion.sh

@@ -230,6 +230,28 @@ fi
 
 echo "[$(date)] [GitHub] ✅ GitHub sync complete" >> "$DEBUG_LOG" 2>/dev/null || true
 
+# ============================================================================
+# SPEC COMMIT SYNC (NEW!)
+# ============================================================================
+
+echo "[$(date)] [GitHub] 🔗 Checking for spec commit sync..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Call TypeScript CLI to sync commits
+if command -v node &> /dev/null && [ -f "$PROJECT_ROOT/dist/cli/commands/sync-spec-commits.js" ]; then
+  echo "[$(date)] [GitHub] 🚀 Running spec commit sync..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+  node "$PROJECT_ROOT/dist/cli/commands/sync-spec-commits.js" \
+    --increment "$PROJECT_ROOT/.specweave/increments/$CURRENT_INCREMENT" \
+    --provider github \
+    2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+      echo "[$(date)] [GitHub] ⚠️  Spec commit sync failed (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+    }
+
+  echo "[$(date)] [GitHub] ✅ Spec commit sync complete" >> "$DEBUG_LOG" 2>/dev/null || true
+else
+  echo "[$(date)] [GitHub] ℹ️  Spec commit sync not available (node or script not found)" >> "$DEBUG_LOG" 2>/dev/null || true
+fi
+
 # ============================================================================
 # OUTPUT TO CLAUDE
 # ============================================================================