specweave 0.22.0 → 0.22.2

package/plugins/specweave/templates/iac/gcp-cloud-functions/templates/variables.tf.hbs

@@ -0,0 +1,119 @@
+# Input Variables for GCP Cloud Functions + Firestore
+# Generated by SpecWeave Serverless Architecture Intelligence
+
+variable "project_id" {
+  description = "GCP Project ID"
+  type        = string
+  default     = "{{projectId}}"
+}
+
+variable "region" {
+  description = "GCP region for all resources"
+  type        = string
+  default     = "{{region}}"
+}
+
+variable "function_name" {
+  description = "Cloud Function name"
+  type        = string
+  default     = "{{functionName}}"
+}
+
+variable "runtime" {
+  description = "Cloud Function runtime (nodejs20, python312, go121, etc.)"
+  type        = string
+  default     = "{{runtime}}"
+}
+
+variable "entry_point" {
+  description = "Function entry point (handler function name)"
+  type        = string
+  default     = "{{entryPoint}}"
+}
+
+variable "memory_mb" {
+  description = "Memory allocation in MB (128-32768)"
+  type        = number
+  default     = {{memoryMb}}
+}
+
+variable "timeout_seconds" {
+  description = "Function timeout in seconds (1-3600)"
+  type        = number
+  default     = {{timeoutSeconds}}
+}
+
+variable "min_instances" {
+  description = "Minimum number of instances (0 for auto-scale to zero)"
+  type        = number
+  default     = {{minInstances}}
+}
+
+variable "max_instances" {
+  description = "Maximum number of instances"
+  type        = number
+  default     = {{maxInstances}}
+}
+
+variable "environment" {
+  description = "Environment name (dev, staging, prod)"
+  type        = string
+  default     = "{{environment}}"
+}
+
+variable "database_id" {
+  description = "Firestore database ID"
+  type        = string
+  default     = "{{databaseId}}"
+}
+
+variable "collection_id" {
+  description = "Firestore collection ID"
+  type        = string
+  default     = "{{collectionId}}"
+}
+
+variable "service_account_id" {
+  description = "Service Account ID for Cloud Function"
+  type        = string
+  default     = "{{serviceAccountId}}"
+}
+
+variable "cors_origins" {
+  description = "List of allowed CORS origins"
+  type        = list(string)
+  default     = {{tfList corsOrigins}}
+}
+
+variable "project_name" {
+  description = "Project name for resource labeling"
+  type        = string
+  default     = "{{projectName}}"
+}
+
+variable "bucket_name" {
+  description = "Storage bucket name for function source code"
+  type        = string
+  default     = "{{bucketName}}"
+}
+
+variable "bucket_location" {
+  description = "Storage bucket location (US, EU, ASIA, or region)"
+  type        = string
+  default     = "{{bucketLocation}}"
+}
+
+{{#if enableConcurrency}}
+variable "max_concurrent_requests" {
+  description = "Maximum concurrent requests per instance"
+  type        = number
+  default     = {{maxConcurrentRequests}}
+}
+{{/if}}
+
+{{#if enableVpc}}
+variable "vpc_network" {
+  description = "VPC network name for private networking"
+  type        = string
+}
+{{/if}}

package/plugins/specweave/templates/iac/supabase/defaults.json

@@ -0,0 +1,15 @@
+{
+  "projectName": "my-supabase-project",
+  "orgId": "your-org-id",
+  "region": "us-east-1",
+  "databasePassword": "changeme123",
+  "planType": "free",
+  "environment": "dev",
+  "enableAuth": true,
+  "enableStorage": true,
+  "enableRealtime": true,
+  "enableEdgeFunctions": true,
+  "storageBuckets": ["avatars", "documents"],
+  "authProviders": ["email"],
+  "postgresVersion": "15"
+}

package/plugins/specweave/templates/iac/supabase/templates/README.md.hbs

@@ -0,0 +1,46 @@
+# Supabase (PostgreSQL + Auth + Storage + Edge Functions) Configuration
+
+**Generated by SpecWeave Serverless Architecture Intelligence**
+
+Supabase provides complete backend-as-a-service:
+- PostgreSQL database (Postgres {{postgresVersion}})
+- Built-in Auth ({{authProviders}})
+- Object Storage
+- Edge Functions (Deno runtime)
+- Realtime subscriptions
+
+## Prerequisites
+
+1. Install Supabase CLI: `npm install -g supabase`
+2. Login: `supabase login`
+3. Get Org ID: `supabase orgs list`
+
+## Deployment
+
+```bash
+# Initialize Supabase
+supabase init
+
+# Link to project
+supabase link --project-ref {{projectName}}
+
+# Deploy database migrations
+supabase db push
+
+# Deploy edge functions
+supabase functions deploy
+```
+
+## Cost: $0/month (Free Tier)
+
+Supabase free tier includes:
+- 500 MB database storage
+- 1 GB file storage
+- 2 GB bandwidth
+- 50,000 monthly active users
+- 500,000 Edge Function invocations
+
+## Support
+
+- Supabase Docs: https://supabase.com/docs
+- SpecWeave: https://spec-weave.com

package/plugins/specweave/templates/iac/supabase/templates/main.tf.hbs

@@ -0,0 +1,50 @@
+# Supabase (Database + Auth + Storage + Edge Functions) Configuration
+# Generated by SpecWeave Serverless Architecture Intelligence
+#
+# Note: Supabase doesn't have official Terraform provider yet.
+# This uses Supabase CLI with null_resource provisioners.
+# For production, use Supabase Management API or wait for official provider.
+
+# Supabase Project (using CLI)
+resource "null_resource" "supabase_project" {
+  provisioner "local-exec" {
+    command = <<-EOT
+      supabase projects create {{projectName}} \
+        --org-id {{orgId}} \
+        --region {{region}} \
+        --plan {{planType}} \
+        --db-password '{{databasePassword}}'
+    EOT
+  }
+
+  provisioner "local-exec" {
+    when    = destroy
+    command = "supabase projects delete {{projectName}} --org-id {{orgId}}"
+  }
+}
+
+# Storage Buckets
+{{#each storageBuckets}}
+resource "null_resource" "storage_bucket_{{this}}" {
+  provisioner "local-exec" {
+    command = <<-EOT
+      supabase storage create {{this}} \
+        --project-ref {{projectName}} \
+        --public
+    EOT
+  }
+
+  depends_on = [null_resource.supabase_project]
+}
+{{/each}}
+
+# Edge Functions
+{{#if enableEdgeFunctions}}
+resource "null_resource" "edge_functions" {
+  provisioner "local-exec" {
+    command = "supabase functions deploy --project-ref {{projectName}}"
+  }
+
+  depends_on = [null_resource.supabase_project]
+}
+{{/if}}

package/plugins/specweave-github/agents/github-manager/AGENT.md

@@ -1,6 +1,38 @@
 # GitHub Manager Agent
 
-**Role**: GitHub integration specialist for SpecWeave increments
+⚠️ **DEPRECATED: Use Living Docs Sync Instead** ⚠️
+
+**CRITICAL**: This agent creates GitHub issues using the OLD `[Increment XXXX]` format,
+which violates SpecWeave's data flow architecture.
+
+**CORRECT DATA FLOW**:
+```
+Increment → Living Docs → GitHub
+            (source of truth)
+```
+
+**USE INSTEAD**:
+- `/specweave:sync-docs update` - Generate living docs from increments
+- `/specweave-github:sync` - Sync living docs to GitHub Issues
+- Result: Issues use correct `US-XXX` or `FS-YY-MM-DD` format
+
+**WHY THIS IS DEPRECATED**:
+1. Creates issues with `[Increment XXXX]` format (rejected by validation)
+2. Bypasses living docs (source of truth)
+3. No traceability to User Stories/Feature Specs
+4. Cannot sync bidirectionally with living docs
+
+**IF YOU USE THIS AGENT**: GitHub client will REJECT issue creation with error:
+```
+❌ DEPRECATED FORMAT DETECTED: "[Increment 0043] Title"
+GitHub issues MUST use living docs format:
+  ✅ CORRECT: "US-XXX: Title" (User Story)
+  ✅ CORRECT: "FS-YY-MM-DD: Title" (Feature Spec)
+```
+
+---
+
+**Role**: GitHub integration specialist for SpecWeave increments (DEPRECATED)
 
 **Expertise**: GitHub CLI, GitHub API, issue management, project boards, automation, webhooks, Actions
 
@@ -143,9 +175,9 @@ Invoke the github-manager agent (via Task tool) for:
 ### Issue Management
 
 ```bash
-# Create issue
+# ❌ DEPRECATED - Create issue (OLD FORMAT - DO NOT USE)
 gh issue create \
-  --title "[Increment 0004] Plugin Architecture" \
+  --title "[Increment 0004] Plugin Architecture" \  # ❌ DEPRECATED
   --body "$(cat issue-body.md)" \
   --label "specweave,increment,P1" \
   --milestone "v0.4.0"
@@ -384,10 +416,10 @@ When a new increment is created:
    - Parse `tasks.md` for task checklist
    - Format using issue template
 
-4. **Create GitHub Issue**
+4. **Create GitHub Issue** (❌ DEPRECATED - DO NOT USE)
    ```bash
    gh issue create \
-     --title "[Increment 0004] Plugin Architecture" \
+     --title "[Increment 0004] Plugin Architecture" \  # ❌ DEPRECATED
      --body "$(cat /tmp/issue-body.md)" \
      --label "specweave,increment,P1" \
      --milestone "v0.4.0"
@@ -680,9 +712,9 @@ GitHub Manager Agent:
 5. Updating metadata...
    ✓ Saved to .metadata.yaml
 
-✅ GitHub Issue Created!
+✅ GitHub Issue Created! (❌ DEPRECATED FORMAT)
 
-Issue #130: [Increment 0004] Plugin Architecture
+Issue #130: [Increment 0004] Plugin Architecture  # ❌ DEPRECATED
 URL: https://github.com/owner/repo/issues/130
 
 You can now:

package/plugins/specweave-github/commands/specweave-github-create-issue.md

@@ -175,9 +175,9 @@ Creating issue...
 ✓ Milestone set: v0.4.0
 ✓ Metadata updated
 
-✅ GitHub Issue Created!
+✅ GitHub Issue Created! (❌ DEPRECATED FORMAT)
 
-Issue #130: [Increment 0004] Plugin Architecture
+Issue #130: [Increment 0004] Plugin Architecture  # ❌ DEPRECATED
 URL: https://github.com/owner/repo/issues/130
 
 Auto-sync enabled: progress will update automatically after each task.
@@ -274,15 +274,15 @@ Preview issue body before creating:
 
 Output:
 ```
-📄 Preview: Issue body for increment 0004
+📄 Preview: Issue body for increment 0004 (❌ DEPRECATED FORMAT)
 
-Title: [Increment 0004] Plugin Architecture
+Title: [Increment 0004] Plugin Architecture  # ❌ DEPRECATED
 Labels: specweave, increment, P1
 Milestone: v0.4.0
 
 Body:
 ---
-# [Increment 0004] Plugin Architecture
+# [Increment 0004] Plugin Architecture  # ❌ DEPRECATED
 
 **Status**: Planning
 **Priority**: P1

package/plugins/specweave-github/lib/CodeValidator.ts

@@ -7,7 +7,7 @@
  * - Files are empty or have trivial content
  * - Implementation is incomplete
  *
- * Used by ThreeLayerSyncManager to enforce code-completion discipline.
+ * Used by GitHub sync to enforce code-completion discipline.
  *
  * @module CodeValidator
  */

package/plugins/specweave-github/lib/github-client-v2.js

@@ -134,10 +134,39 @@ class GitHubClientV2 {
   // ==========================================================================
   // Issues
   // ==========================================================================
+  /**
+   * Validate issue title format
+   *
+   * CRITICAL: Enforces correct data flow architecture
+   * - ✅ CORRECT: "US-XXX: Title" or "FS-YY-MM-DD: Title"
+   * - ❌ WRONG: "[Increment XXXX] Title" (deprecated old format)
+   *
+   * @throws Error if title uses deprecated [Increment XXXX] format
+   */
+  validateIssueTitle(title) {
+    const deprecatedPattern = /\[Increment\s+\d+\]/i;
+    if (deprecatedPattern.test(title)) {
+      throw new Error(
+        `\u274C DEPRECATED FORMAT DETECTED: "${title}"
+
+GitHub issues MUST use living docs format:
+  \u2705 CORRECT: "US-XXX: Title" (User Story)
+  \u2705 CORRECT: "FS-YY-MM-DD: Title" (Feature Spec)
+  \u274C WRONG: "[Increment XXXX] Title" (old format)
+
+WHY: Correct data flow is: Increment \u2192 Living Docs \u2192 GitHub
+      Living docs are the source of truth for GitHub sync.
+
+FIX: Use /specweave:sync-docs to generate living docs, then sync to GitHub.
+     OR: Use US/FS ID format directly if creating issues manually.`
+      );
+    }
+  }
   /**
    * Create epic issue (increment-level)
    */
   async createEpicIssue(title, body, milestone, labels = []) {
+    this.validateIssueTitle(title);
     const args = [
       "issue",
       "create",

package/plugins/specweave-github/lib/github-client-v2.ts

@@ -192,6 +192,34 @@ export class GitHubClientV2 {
   // Issues
   // ==========================================================================
 
+  /**
+   * Validate issue title format
+   *
+   * CRITICAL: Enforces correct data flow architecture
+   * - ✅ CORRECT: "US-XXX: Title" or "FS-YY-MM-DD: Title"
+   * - ❌ WRONG: "[Increment XXXX] Title" (deprecated old format)
+   *
+   * @throws Error if title uses deprecated [Increment XXXX] format
+   */
+  private validateIssueTitle(title: string): void {
+    // Check for deprecated [Increment XXXX] format
+    const deprecatedPattern = /\[Increment\s+\d+\]/i;
+
+    if (deprecatedPattern.test(title)) {
+      throw new Error(
+        `❌ DEPRECATED FORMAT DETECTED: "${title}"\n\n` +
+        `GitHub issues MUST use living docs format:\n` +
+        `  ✅ CORRECT: "US-XXX: Title" (User Story)\n` +
+        `  ✅ CORRECT: "FS-YY-MM-DD: Title" (Feature Spec)\n` +
+        `  ❌ WRONG: "[Increment XXXX] Title" (old format)\n\n` +
+        `WHY: Correct data flow is: Increment → Living Docs → GitHub\n` +
+        `      Living docs are the source of truth for GitHub sync.\n\n` +
+        `FIX: Use /specweave:sync-docs to generate living docs, then sync to GitHub.\n` +
+        `     OR: Use US/FS ID format directly if creating issues manually.`
+      );
+    }
+  }
+
   /**
    * Create epic issue (increment-level)
    */
@@ -201,6 +229,8 @@ export class GitHubClientV2 {
     milestone?: number | string,
     labels: string[] = []
   ): Promise<GitHubIssue> {
+    // Validate title format before creating
+    this.validateIssueTitle(title);
     const args = [
       'issue',
       'create',

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

@@ -192,6 +192,10 @@ ${phaseChecklist}
 
 ## SpecWeave Increment
 
+\u26A0\uFE0F **DEPRECATED FORMAT**: This issue was created using the old increment-based sync.
+
+**Correct data flow**: Increment \u2192 Living Docs \u2192 GitHub
+
 This epic tracks SpecWeave increment \`${metadata.id}\`.
 
 - **Spec**: [\`spec.md\`](${this.getGitHubFileURL("spec.md")})

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

@@ -219,6 +219,9 @@ export class TaskSync {
       });
     }
 
+    // DEPRECATED: This method generates old [Increment XXX] format
+    // It will be blocked by github-client-v2.ts validation
+    // TODO: Remove task-sync.ts entirely - use living docs sync instead
     return `# [Increment ${metadata.id}] ${metadata.title}
 
 **Status**: ${metadata.status}
@@ -234,6 +237,10 @@ ${phaseChecklist}
 
 ## SpecWeave Increment
 
+⚠️ **DEPRECATED FORMAT**: This issue was created using the old increment-based sync.
+
+**Correct data flow**: Increment → Living Docs → GitHub
+
 This epic tracks SpecWeave increment \`${metadata.id}\`.
 
 - **Spec**: [\`spec.md\`](${this.getGitHubFileURL('spec.md')})

package/plugins/specweave-jira/lib/enhanced-jira-sync.js

@@ -1,6 +1,6 @@
-import { EnhancedContentBuilder } from "../../../src/core/sync/enhanced-content-builder.js";
-import { SpecIncrementMapper } from "../../../src/core/sync/spec-increment-mapper.js";
-import { parseSpecContent } from "../../../src/core/spec-content-sync.js";
+import { EnhancedContentBuilder } from "../../../dist/src/core/sync/enhanced-content-builder.js";
+import { SpecIncrementMapper } from "../../../dist/src/core/sync/spec-increment-mapper.js";
+import { parseSpecContent } from "../../../dist/src/core/spec-content-sync.js";
 import * as path from "path";
 import * as fs from "fs/promises";
 async function syncSpecToJiraWithEnhancedContent(options) {