specweave 1.0.239 → 1.0.241

package/plugins/specweave-github/hooks/github-auto-create-handler.sh

@@ -418,7 +418,29 @@ if [[ -f "$META_PATH" ]]; then
 
   if [[ -n "$UPDATED_META" ]]; then
     echo "$UPDATED_META" > "$META_PATH" 2>/dev/null
-    log "Updated metadata.json with GitHub issue links"
+    log "Updated metadata.json with GitHub issue links (externalLinks format)"
+
+    # v1.0.240 FIX: Also write OLD format (metadata.github.issues[]) for reconciler compatibility
+    # The reconciler and closure flows read metadata.github.issues[], not externalLinks
+    OLD_FORMAT_JSON=$(echo "$CREATED_JSON" | jq '[to_entries[] | select(.value.issueNumber != null) | {
+      userStory: .key,
+      number: .value.issueNumber,
+      url: .value.issueUrl,
+      createdAt: (now | strftime("%Y-%m-%dT%H:%M:%SZ"))
+    }]' 2>/dev/null)
+
+    if [[ -n "$OLD_FORMAT_JSON" ]] && [[ "$OLD_FORMAT_JSON" != "[]" ]]; then
+      UPDATED_META_V2=$(jq --argjson old_issues "$OLD_FORMAT_JSON" '
+        if .github == null then .github = {} else . end |
+        .github.issues = ((.github.issues // []) + $old_issues | unique_by(.userStory)) |
+        .github.lastSync = (now | strftime("%Y-%m-%dT%H:%M:%SZ"))
+      ' "$META_PATH" 2>/dev/null)
+
+      if [[ -n "$UPDATED_META_V2" ]]; then
+        echo "$UPDATED_META_V2" > "$META_PATH" 2>/dev/null
+        log "Also backfilled old-format github.issues[] for reconciler"
+      fi
+    fi
   fi
 fi
 

package/plugins/specweave-github/lib/github-feature-sync.js

@@ -137,6 +137,7 @@ const _GitHubFeatureSync = class _GitHubFeatureSync {
         console.log(`      \u{1F6E1}\uFE0F  Duplicates detected: ${result.duplicatesFound}, auto-closed: ${result.duplicatesClosed}`);
       }
       await this.updateUserStoryFrontmatter(userStory.filePath, issueNumber);
+      await this.backfillIncrementMetadata(featureId, userStory.id, issueNumber);
       await this.updateUserStoryIssue(issueNumber, issueContent, userStory.filePath);
       if (result.wasReused) {
         issuesUpdated++;
@@ -176,6 +177,46 @@ const _GitHubFeatureSync = class _GitHubFeatureSync {
     }
     return null;
   }
+  /**
+   * Backfill increment metadata.json with GitHub issue reference (v1.0.240)
+   *
+   * Writes in the old format (metadata.github.issues[]) that the reconciler
+   * and closure flows expect. Non-blocking — errors are logged but don't halt sync.
+   */
+  async backfillIncrementMetadata(featureId, userStoryId, issueNumber) {
+    try {
+      const featureNumMatch = featureId.match(/FS-0*(\d+)E?/i);
+      if (!featureNumMatch) return;
+      const num = parseInt(featureNumMatch[1], 10);
+      const paddedNum = String(num).padStart(4, "0");
+      const incrementsDir = path.join(this.projectRoot, ".specweave/increments");
+      if (!existsSync(incrementsDir)) return;
+      const entries = await readdir(incrementsDir);
+      const match = entries.find((e) => e.startsWith(paddedNum + "-"));
+      if (!match) return;
+      const metadataPath = path.join(incrementsDir, match, "metadata.json");
+      if (!existsSync(metadataPath)) return;
+      const metadata = JSON.parse(await readFile(metadataPath, "utf-8"));
+      if (!metadata.github) metadata.github = {};
+      if (!metadata.github.issues) metadata.github.issues = [];
+      const exists = metadata.github.issues.some(
+        (i) => i.userStory === userStoryId
+      );
+      if (!exists) {
+        metadata.github.issues.push({
+          userStory: userStoryId,
+          number: issueNumber,
+          url: `https://github.com/${this.client.getOwner()}/${this.client.getRepo()}/issues/${issueNumber}`,
+          createdAt: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        metadata.github.lastSync = (/* @__PURE__ */ new Date()).toISOString();
+        await writeFile(metadataPath, JSON.stringify(metadata, null, 2) + "\n", "utf-8");
+        console.log(`      \u{1F4DD} Backfilled metadata.json for ${userStoryId}`);
+      }
+    } catch (error) {
+      console.warn(`      \u26A0\uFE0F Metadata backfill failed: ${error.message}`);
+    }
+  }
   /**
    * Parse FEATURE.md frontmatter
    */

package/plugins/specweave-github/lib/github-feature-sync.ts

@@ -255,6 +255,11 @@ export class GitHubFeatureSync {
       // Update User Story frontmatter with issue link
       await this.updateUserStoryFrontmatter(userStory.filePath, issueNumber);
 
+      // v1.0.240 FIX: Backfill increment metadata.json for reconciler compatibility
+      // Previously only US frontmatter was updated, leaving metadata.json empty.
+      // This caused reconciler and closure flows to miss these issues.
+      await this.backfillIncrementMetadata(featureId, userStory.id, issueNumber);
+
       // ✅ CRITICAL FIX (2025-11-24): Check completion for ALL issues (new AND reused)
       // BUG: Previously only checked completion for reused issues, not new ones
       // RESULT: New issues stayed OPEN even if status:complete
@@ -313,6 +318,63 @@ export class GitHubFeatureSync {
     return null;
   }
 
+  /**
+   * Backfill increment metadata.json with GitHub issue reference (v1.0.240)
+   *
+   * Writes in the old format (metadata.github.issues[]) that the reconciler
+   * and closure flows expect. Non-blocking — errors are logged but don't halt sync.
+   */
+  private async backfillIncrementMetadata(
+    featureId: string,
+    userStoryId: string,
+    issueNumber: number
+  ): Promise<void> {
+    try {
+      // Derive increment ID from feature ID (reverse of deriveFeatureId)
+      const featureNumMatch = featureId.match(/FS-0*(\d+)E?/i);
+      if (!featureNumMatch) return;
+
+      const num = parseInt(featureNumMatch[1], 10);
+      const paddedNum = String(num).padStart(4, '0');
+
+      // Find the increment directory
+      const incrementsDir = path.join(this.projectRoot, '.specweave/increments');
+      if (!existsSync(incrementsDir)) return;
+
+      const entries = await readdir(incrementsDir);
+      const match = entries.find(e => e.startsWith(paddedNum + '-'));
+      if (!match) return;
+
+      const metadataPath = path.join(incrementsDir, match, 'metadata.json');
+      if (!existsSync(metadataPath)) return;
+
+      const metadata = JSON.parse(await readFile(metadataPath, 'utf-8'));
+
+      // Write in OLD format for reconciler compatibility
+      if (!metadata.github) metadata.github = {};
+      if (!metadata.github.issues) metadata.github.issues = [];
+
+      const exists = metadata.github.issues.some(
+        (i: { userStory: string }) => i.userStory === userStoryId
+      );
+
+      if (!exists) {
+        metadata.github.issues.push({
+          userStory: userStoryId,
+          number: issueNumber,
+          url: `https://github.com/${this.client.getOwner()}/${this.client.getRepo()}/issues/${issueNumber}`,
+          createdAt: new Date().toISOString(),
+        });
+        metadata.github.lastSync = new Date().toISOString();
+        await writeFile(metadataPath, JSON.stringify(metadata, null, 2) + '\n', 'utf-8');
+        console.log(`      📝 Backfilled metadata.json for ${userStoryId}`);
+      }
+    } catch (error) {
+      // Non-blocking
+      console.warn(`      ⚠️ Metadata backfill failed: ${(error as Error).message}`);
+    }
+  }
+
   /**
    * Parse FEATURE.md frontmatter
    */

package/plugins/specweave-infrastructure/PLUGIN.md

@@ -6,7 +6,7 @@
 
 ## Description
 
-Comprehensive infrastructure, DevOps, and cloud platform expertise. Covers Terraform/OpenTofu, OpenTelemetry, GitHub Actions, DevSecOps, secret management, Azure (Bicep/AKS), and AWS (CDK/EKS/Lambda).
+Comprehensive infrastructure, DevOps, and cloud platform expertise. Covers Terraform/OpenTofu, OpenTelemetry, GitHub Actions, DevSecOps, secret management, Azure (Bicep/AKS), AWS (CDK/EKS/Lambda), and GCP (GKE/Cloud Run/BigQuery).
 
 ## Skills
 
@@ -21,6 +21,7 @@ Comprehensive infrastructure, DevOps, and cloud platform expertise. Covers Terra
 | secret-management | Secret management with Vault, External Secrets Operator, SOPS, and cloud KMS |
 | azure-bicep-aks | Azure Bicep IaC and AKS cluster management with Managed Identity and Container Apps |
 | aws-deep-dive | AWS CDK, EKS, Lambda, VPC design, IAM least-privilege, and serverless patterns |
+| gcp-deep-dive | GCP GKE, Cloud Run, Cloud Functions, VPC design, IAM, BigQuery, and Cloud Build CI/CD |
 
 ## Installation