specweave 0.21.3 → 0.22.2

package/plugins/specweave/templates/iac/azure-functions/templates/main.tf.hbs

@@ -0,0 +1,225 @@
+# Azure Functions + Cosmos DB Terraform Configuration
+# Generated by SpecWeave Serverless Architecture Intelligence
+
+# Resource Group
+resource "azurerm_resource_group" "{{snakeCase resourceGroupName}}" {
+  name     = "{{resourceGroupName}}"
+  location = "{{location}}"
+
+  tags = {
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+    Project     = "{{projectName}}"
+  }
+}
+
+# Storage Account (required for Function App)
+resource "azurerm_storage_account" "{{snakeCase functionName}}" {
+  name                     = "{{snakeCase functionName}}storage"
+  resource_group_name      = azurerm_resource_group.{{snakeCase resourceGroupName}}.name
+  location                 = azurerm_resource_group.{{snakeCase resourceGroupName}}.location
+  account_tier             = "{{storageAccountTier}}"
+  account_replication_type = "{{storageAccountReplication}}"
+
+  tags = {
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+    Project     = "{{projectName}}"
+  }
+}
+
+# App Service Plan (Consumption Plan)
+resource "azurerm_service_plan" "{{snakeCase functionName}}" {
+  name                = "{{appName}}-plan"
+  resource_group_name = azurerm_resource_group.{{snakeCase resourceGroupName}}.name
+  location            = azurerm_resource_group.{{snakeCase resourceGroupName}}.location
+  os_type             = "{{osType}}"
+  sku_name            = "{{skuName}}"
+
+  tags = {
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+    Project     = "{{projectName}}"
+  }
+}
+
+{{#if enableApplicationInsights}}
+# Application Insights
+resource "azurerm_application_insights" "{{snakeCase functionName}}" {
+  name                = "{{appName}}-insights"
+  resource_group_name = azurerm_resource_group.{{snakeCase resourceGroupName}}.name
+  location            = azurerm_resource_group.{{snakeCase resourceGroupName}}.location
+  application_type    = "web"
+
+  tags = {
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+    Project     = "{{projectName}}"
+  }
+}
+{{/if}}
+
+# Linux Function App
+resource "azurerm_linux_function_app" "{{snakeCase functionName}}" {
+  name                = "{{appName}}"
+  resource_group_name = azurerm_resource_group.{{snakeCase resourceGroupName}}.name
+  location            = azurerm_resource_group.{{snakeCase resourceGroupName}}.location
+
+  storage_account_name       = azurerm_storage_account.{{snakeCase functionName}}.name
+  storage_account_access_key = azurerm_storage_account.{{snakeCase functionName}}.primary_access_key
+  service_plan_id            = azurerm_service_plan.{{snakeCase functionName}}.id
+
+  site_config {
+    application_stack {
+      {{#if (eq runtime "node")}}
+      node_version = "{{runtimeVersion}}"
+      {{else if (eq runtime "python")}}
+      python_version = "{{runtimeVersion}}"
+      {{else if (eq runtime "dotnet")}}
+      dotnet_version = "{{runtimeVersion}}"
+      {{/if}}
+    }
+
+    cors {
+      allowed_origins = {{tfList corsOrigins}}
+    }
+
+    {{#if enableApplicationInsights}}
+    application_insights_key             = azurerm_application_insights.{{snakeCase functionName}}.instrumentation_key
+    application_insights_connection_string = azurerm_application_insights.{{snakeCase functionName}}.connection_string
+    {{/if}}
+  }
+
+  app_settings = {
+    "ENVIRONMENT"                  = "{{environment}}"
+    "COSMOS_DB_ENDPOINT"           = azurerm_cosmosdb_account.{{snakeCase databaseAccountName}}.endpoint
+    "COSMOS_DB_KEY"                = azurerm_cosmosdb_account.{{snakeCase databaseAccountName}}.primary_key
+    "COSMOS_DB_DATABASE"           = azurerm_cosmosdb_sql_database.{{snakeCase databaseName}}.name
+    "COSMOS_DB_CONTAINER"          = azurerm_cosmosdb_sql_container.{{snakeCase containerName}}.name
+    "FUNCTIONS_WORKER_RUNTIME"     = "{{runtime}}"
+    {{#if customAppSettings}}
+    {{#each customAppSettings}}
+    "{{@key}}" = "{{this}}"
+    {{/each}}
+    {{/if}}
+  }
+
+  identity {
+    type = "SystemAssigned"
+  }
+
+  tags = {
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+    Project     = "{{projectName}}"
+  }
+}
+
+# Cosmos DB Account
+resource "azurerm_cosmosdb_account" "{{snakeCase databaseAccountName}}" {
+  name                = "{{databaseAccountName}}"
+  resource_group_name = azurerm_resource_group.{{snakeCase resourceGroupName}}.name
+  location            = azurerm_resource_group.{{snakeCase resourceGroupName}}.location
+  offer_type          = "Standard"
+  kind                = "GlobalDocumentDB"
+
+  consistency_policy {
+    consistency_level       = "Session"
+    max_interval_in_seconds = 5
+    max_staleness_prefix    = 100
+  }
+
+  geo_location {
+    location          = azurerm_resource_group.{{snakeCase resourceGroupName}}.location
+    failover_priority = 0
+  }
+
+  {{#if enableMultiRegion}}
+  {{#each secondaryRegions}}
+  geo_location {
+    location          = "{{this}}"
+    failover_priority = {{@index}}
+  }
+  {{/each}}
+  {{/if}}
+
+  {{#if enableAutomaticFailover}}
+  enable_automatic_failover = true
+  {{/if}}
+
+  {{#if enableBackup}}
+  backup {
+    type                = "Continuous"
+    interval_in_minutes = 240
+    retention_in_hours  = 8
+  }
+  {{/if}}
+
+  tags = {
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+    Project     = "{{projectName}}"
+  }
+}
+
+# Cosmos DB SQL Database
+resource "azurerm_cosmosdb_sql_database" "{{snakeCase databaseName}}" {
+  name                = "{{databaseName}}"
+  resource_group_name = azurerm_resource_group.{{snakeCase resourceGroupName}}.name
+  account_name        = azurerm_cosmosdb_account.{{snakeCase databaseAccountName}}.name
+}
+
+# Cosmos DB SQL Container
+resource "azurerm_cosmosdb_sql_container" "{{snakeCase containerName}}" {
+  name                  = "{{containerName}}"
+  resource_group_name   = azurerm_resource_group.{{snakeCase resourceGroupName}}.name
+  account_name          = azurerm_cosmosdb_account.{{snakeCase databaseAccountName}}.name
+  database_name         = azurerm_cosmosdb_sql_database.{{snakeCase databaseName}}.name
+  partition_key_path    = "{{partitionKey}}"
+  partition_key_version = 1
+  throughput            = {{throughput}}
+
+  indexing_policy {
+    indexing_mode = "consistent"
+
+    included_path {
+      path = "/*"
+    }
+
+    excluded_path {
+      path = "/\"_etag\"/?"
+    }
+  }
+}
+
+{{#if enableKeyVault}}
+# Key Vault
+resource "azurerm_key_vault" "{{snakeCase functionName}}" {
+  name                       = "{{appName}}-kv"
+  resource_group_name        = azurerm_resource_group.{{snakeCase resourceGroupName}}.name
+  location                   = azurerm_resource_group.{{snakeCase resourceGroupName}}.location
+  tenant_id                  = data.azurerm_client_config.current.tenant_id
+  sku_name                   = "standard"
+  soft_delete_retention_days = 7
+  purge_protection_enabled   = false
+
+  access_policy {
+    tenant_id = data.azurerm_client_config.current.tenant_id
+    object_id = azurerm_linux_function_app.{{snakeCase functionName}}.identity[0].principal_id
+
+    secret_permissions = [
+      "Get",
+      "List"
+    ]
+  }
+
+  tags = {
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+    Project     = "{{projectName}}"
+  }
+}
+
+# Data source for current Azure client config
+data "azurerm_client_config" "current" {}
+{{/if}}

package/plugins/specweave/templates/iac/azure-functions/templates/outputs.tf.hbs

@@ -0,0 +1,89 @@
+# Output Values for Azure Functions + Cosmos DB
+# Generated by SpecWeave Serverless Architecture Intelligence
+
+output "resource_group_name" {
+  description = "Resource group name"
+  value       = azurerm_resource_group.{{snakeCase resourceGroupName}}.name
+}
+
+output "resource_group_location" {
+  description = "Resource group location"
+  value       = azurerm_resource_group.{{snakeCase resourceGroupName}}.location
+}
+
+output "function_app_name" {
+  description = "Function App name"
+  value       = azurerm_linux_function_app.{{snakeCase functionName}}.name
+}
+
+output "function_app_id" {
+  description = "Function App ID"
+  value       = azurerm_linux_function_app.{{snakeCase functionName}}.id
+}
+
+output "function_app_default_hostname" {
+  description = "Function App default hostname (URL)"
+  value       = azurerm_linux_function_app.{{snakeCase functionName}}.default_hostname
+}
+
+output "function_app_url" {
+  description = "Function App HTTPS URL"
+  value       = "https://${azurerm_linux_function_app.{{snakeCase functionName}}.default_hostname}"
+}
+
+output "function_app_principal_id" {
+  description = "Function App managed identity principal ID"
+  value       = azurerm_linux_function_app.{{snakeCase functionName}}.identity[0].principal_id
+}
+
+output "cosmos_db_endpoint" {
+  description = "Cosmos DB endpoint URL"
+  value       = azurerm_cosmosdb_account.{{snakeCase databaseAccountName}}.endpoint
+}
+
+output "cosmos_db_id" {
+  description = "Cosmos DB account ID"
+  value       = azurerm_cosmosdb_account.{{snakeCase databaseAccountName}}.id
+}
+
+output "cosmos_db_database_name" {
+  description = "Cosmos DB database name"
+  value       = azurerm_cosmosdb_sql_database.{{snakeCase databaseName}}.name
+}
+
+output "cosmos_db_container_name" {
+  description = "Cosmos DB container name"
+  value       = azurerm_cosmosdb_sql_container.{{snakeCase containerName}}.name
+}
+
+output "storage_account_name" {
+  description = "Storage account name"
+  value       = azurerm_storage_account.{{snakeCase functionName}}.name
+}
+
+output "storage_account_primary_connection_string" {
+  description = "Storage account primary connection string"
+  value       = azurerm_storage_account.{{snakeCase functionName}}.primary_connection_string
+  sensitive   = true
+}
+
+{{#if enableApplicationInsights}}
+output "application_insights_instrumentation_key" {
+  description = "Application Insights instrumentation key"
+  value       = azurerm_application_insights.{{snakeCase functionName}}.instrumentation_key
+  sensitive   = true
+}
+
+output "application_insights_connection_string" {
+  description = "Application Insights connection string"
+  value       = azurerm_application_insights.{{snakeCase functionName}}.connection_string
+  sensitive   = true
+}
+{{/if}}
+
+{{#if enableKeyVault}}
+output "key_vault_uri" {
+  description = "Key Vault URI"
+  value       = azurerm_key_vault.{{snakeCase functionName}}.vault_uri
+}
+{{/if}}

package/plugins/specweave/templates/iac/azure-functions/templates/provider.tf.hbs

@@ -0,0 +1,27 @@
+# Terraform and Azure Provider Configuration
+# Generated by SpecWeave Serverless Architecture Intelligence
+
+terraform {
+  required_version = ">= 1.5.0"
+
+  required_providers {
+    azurerm = {
+      source  = "hashicorp/azurerm"
+      version = "~> 3.0"
+    }
+  }
+}
+
+provider "azurerm" {
+  features {
+    resource_group {
+      prevent_deletion_if_contains_resources = false
+    }
+
+    key_vault {
+      purge_soft_delete_on_destroy = true
+    }
+  }
+
+  skip_provider_registration = false
+}

package/plugins/specweave/templates/iac/azure-functions/templates/providers.tf.hbs

@@ -0,0 +1,35 @@
+# Terraform Provider Configuration for Azure
+# Generated by SpecWeave Serverless Architecture Intelligence
+
+terraform {
+  required_version = ">= 1.5.0"
+
+  required_providers {
+    azurerm = {
+      source  = "hashicorp/azurerm"
+      version = "~> 3.0"
+    }
+  }
+
+  {{#if enableRemoteState}}
+  backend "azurerm" {
+    resource_group_name  = "{{tfStateResourceGroup}}"
+    storage_account_name = "{{tfStateStorageAccount}}"
+    container_name       = "tfstate"
+    key                  = "{{projectName}}-{{environment}}.tfstate"
+  }
+  {{/if}}
+}
+
+provider "azurerm" {
+  features {
+    key_vault {
+      purge_soft_delete_on_destroy    = true
+      recover_soft_deleted_key_vaults = true
+    }
+
+    resource_group {
+      prevent_deletion_if_contains_resources = false
+    }
+  }
+}

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

@@ -0,0 +1,124 @@
+# Input Variables for Azure Functions + Cosmos DB
+# Generated by SpecWeave Serverless Architecture Intelligence
+
+variable "location" {
+  description = "Azure region for all resources"
+  type        = string
+  default     = "{{location}}"
+}
+
+variable "resource_group_name" {
+  description = "Resource group name"
+  type        = string
+  default     = "{{resourceGroupName}}"
+}
+
+variable "app_name" {
+  description = "Function App name"
+  type        = string
+  default     = "{{appName}}"
+}
+
+variable "runtime" {
+  description = "Function runtime (node, python, dotnet)"
+  type        = string
+  default     = "{{runtime}}"
+}
+
+variable "runtime_version" {
+  description = "Runtime version (20 for Node.js 20, 3.11 for Python 3.11, etc.)"
+  type        = string
+  default     = "{{runtimeVersion}}"
+}
+
+variable "os_type" {
+  description = "OS type (Linux or Windows)"
+  type        = string
+  default     = "{{osType}}"
+}
+
+variable "sku_name" {
+  description = "App Service Plan SKU (Y1 for Consumption, EP1/EP2/EP3 for Premium)"
+  type        = string
+  default     = "{{skuName}}"
+}
+
+variable "environment" {
+  description = "Environment name (dev, staging, prod)"
+  type        = string
+  default     = "{{environment}}"
+}
+
+variable "database_account_name" {
+  description = "Cosmos DB account name"
+  type        = string
+  default     = "{{databaseAccountName}}"
+}
+
+variable "database_name" {
+  description = "Cosmos DB database name"
+  type        = string
+  default     = "{{databaseName}}"
+}
+
+variable "container_name" {
+  description = "Cosmos DB container name"
+  type        = string
+  default     = "{{containerName}}"
+}
+
+variable "partition_key" {
+  description = "Cosmos DB partition key"
+  type        = string
+  default     = "{{partitionKey}}"
+}
+
+variable "throughput" {
+  description = "Cosmos DB throughput (RU/s, minimum 400)"
+  type        = number
+  default     = {{throughput}}
+}
+
+variable "cors_origins" {
+  description = "List of allowed CORS origins for Function App"
+  type        = list(string)
+  default     = {{tfList corsOrigins}}
+}
+
+variable "project_name" {
+  description = "Project name for resource tagging"
+  type        = string
+  default     = "{{projectName}}"
+}
+
+variable "storage_account_tier" {
+  description = "Storage account tier (Standard or Premium)"
+  type        = string
+  default     = "{{storageAccountTier}}"
+}
+
+variable "storage_account_replication" {
+  description = "Storage account replication type (LRS, GRS, RAGRS, ZRS)"
+  type        = string
+  default     = "{{storageAccountReplication}}"
+}
+
+{{#if enableMultiRegion}}
+variable "secondary_regions" {
+  description = "List of secondary regions for multi-region deployment"
+  type        = list(string)
+  default     = {{tfList secondaryRegions}}
+}
+{{/if}}
+
+{{#if enableVnet}}
+variable "vnet_id" {
+  description = "Virtual Network ID for Function App integration"
+  type        = string
+}
+
+variable "subnet_id" {
+  description = "Subnet ID for Function App integration"
+  type        = string
+}
+{{/if}}

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

@@ -0,0 +1,29 @@
+{
+  "projectId": "my-firebase-project",
+  "region": "us-central1",
+  "appDisplayName": "My Firebase App",
+  "siteId": "my-firebase-site",
+  "functionName": "myFirebaseFunction",
+  "runtime": "nodejs20",
+  "entryPoint": "handler",
+  "memoryMb": 256,
+  "timeoutSeconds": 60,
+  "environment": "dev",
+  "databaseId": "(default)",
+  "collectionId": "my-collection",
+  "storageBucket": "my-firebase-storage",
+  "projectName": "my-project",
+  "enableAuth": false,
+  "enableStorage": false,
+  "enableAnalytics": false,
+  "enableCrashlytics": false,
+  "hostingIndexPage": "index.html",
+  "hosting404Page": "404.html",
+  "hostingHeaders": [],
+  "hostingRewrites": [
+    {
+      "source": "**",
+      "function": "myFirebaseFunction"
+    }
+  ]
+}

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

@@ -0,0 +1,35 @@
+# Firebase (Hosting + Functions + Firestore) Terraform Configuration
+
+**Generated by SpecWeave Serverless Architecture Intelligence**
+
+Deploys complete Firebase backend:
+- Firebase Web App
+- Firebase Hosting (static site)
+- Cloud Functions for Firebase
+- Firestore database
+
+## Prerequisites
+
+1. Install Firebase CLI: `npm install -g firebase-tools`
+2. Authenticate: `firebase login`
+3. Create Firebase project: `firebase projects:create {{projectId}}`
+
+## Deployment
+
+```bash
+terraform init
+terraform apply -var-file="environments/dev.tfvars"
+```
+
+## Cost: $0/month (Free Spark Plan)
+
+Firebase free tier includes:
+- 10 GB hosting storage
+- 360 MB/day hosting transfer
+- Cloud Functions: 2M invocations/month
+- Firestore: 1 GB storage, 50K reads/day
+
+## Support
+
+- Firebase Docs: https://firebase.google.com/docs
+- SpecWeave: https://spec-weave.com

package/plugins/specweave/templates/iac/firebase/templates/environments/dev.tfvars.hbs

@@ -0,0 +1,7 @@
+project_id       = "{{projectId}}"
+region           = "us-central1"
+app_display_name = "{{projectName}} Dev"
+site_id          = "{{projectName}}-dev"
+function_name    = "{{projectName}}-dev-function"
+runtime          = "nodejs20"
+environment      = "dev"

package/plugins/specweave/templates/iac/firebase/templates/environments/prod.tfvars.hbs

@@ -0,0 +1,7 @@
+project_id       = "{{projectId}}"
+region           = "us-central1"
+app_display_name = "{{projectName}}"
+site_id          = "{{projectName}}"
+function_name    = "{{projectName}}-function"
+runtime          = "nodejs20"
+environment      = "prod"

package/plugins/specweave/templates/iac/firebase/templates/environments/staging.tfvars.hbs

@@ -0,0 +1,7 @@
+project_id       = "{{projectId}}"
+region           = "us-central1"
+app_display_name = "{{projectName}} Staging"
+site_id          = "{{projectName}}-staging"
+function_name    = "{{projectName}}-staging-function"
+runtime          = "nodejs20"
+environment      = "staging"

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

@@ -0,0 +1,90 @@
+# Firebase (Hosting + Functions + Firestore) Terraform Configuration
+# Generated by SpecWeave Serverless Architecture Intelligence
+
+# Enable Firebase for existing GCP project
+resource "google_firebase_project" "default" {
+  provider = google-beta
+  project  = "{{projectId}}"
+}
+
+# Enable required APIs
+resource "google_project_service" "firebasehosting" {
+  project = "{{projectId}}"
+  service = "firebasehosting.googleapis.com"
+  disable_on_destroy = false
+}
+
+resource "google_project_service" "firebase" {
+  project = "{{projectId}}"
+  service = "firebase.googleapis.com"
+  disable_on_destroy = false
+}
+
+# Firebase Web App
+resource "google_firebase_web_app" "{{snakeCase appDisplayName}}" {
+  provider     = google-beta
+  project      = "{{projectId}}"
+  display_name = "{{appDisplayName}}"
+
+  depends_on = [google_firebase_project.default]
+}
+
+# Firebase Hosting Site
+resource "google_firebase_hosting_site" "{{snakeCase siteId}}" {
+  provider = google-beta
+  project  = "{{projectId}}"
+  site_id  = "{{siteId}}"
+
+  depends_on = [google_firebase_project.default]
+}
+
+# Firestore Database (same as GCP)
+resource "google_firestore_database" "{{snakeCase databaseId}}" {
+  project     = "{{projectId}}"
+  name        = "{{databaseId}}"
+  location_id = "{{region}}"
+  type        = "FIRESTORE_NATIVE"
+
+  depends_on = [google_firebase_project.default]
+}
+
+# Cloud Functions for Firebase (similar to GCP Cloud Functions)
+resource "google_cloudfunctions2_function" "{{snakeCase functionName}}" {
+  name     = "{{functionName}}"
+  location = "{{region}}"
+  project  = "{{projectId}}"
+
+  build_config {
+    runtime     = "{{runtime}}"
+    entry_point = "{{entryPoint}}"
+    source {
+      storage_source {
+        bucket = "{{projectId}}.appspot.com"
+        object = "function-source.zip"
+      }
+    }
+  }
+
+  service_config {
+    max_instance_count = 10
+    available_memory   = "{{memoryMb}}M"
+    timeout_seconds    = {{timeoutSeconds}}
+    environment_variables = {
+      FIREBASE_CONFIG = google_firebase_web_app.{{snakeCase appDisplayName}}.app_id
+      ENVIRONMENT     = "{{environment}}"
+    }
+  }
+
+  depends_on = [google_firebase_project.default]
+}
+
+{{#if enableStorage}}
+# Firebase Storage Bucket
+resource "google_firebase_storage_bucket" "{{snakeCase storageBucket}}" {
+  provider  = google-beta
+  project   = "{{projectId}}"
+  bucket_id = "{{storageBucket}}"
+
+  depends_on = [google_firebase_project.default]
+}
+{{/if}}