specweave 0.22.0 → 0.22.3

package/plugins/specweave/hooks/validate-increment-completion.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+#
+# Pre-commit hook: Validate Increment Completion
+#
+# Prevents commits where increment status="completed" but:
+# - Acceptance criteria are still open (- [ ] **AC-...)
+# - Tasks are still pending (**Status**: [ ] pending)
+#
+# This prevents false completion and data integrity violations.
+#
+# Exit code 0: All completed increments are valid (allow commit)
+# Exit code 1: Invalid completion detected (block commit)
+
+# ANSI colors
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+GREEN='\033[0;32m'
+NC='\033[0m' # No Color
+
+# Check if in SpecWeave project
+if [ ! -d ".specweave/increments" ]; then
+  # Not a SpecWeave project, skip validation
+  exit 0
+fi
+
+# Track if any validation failures found
+has_failures=false
+
+# Check all increments
+for increment_dir in .specweave/increments/*/; do
+  # Skip if not a directory
+  [ ! -d "$increment_dir" ] && continue
+
+  increment_id=$(basename "$increment_dir")
+  spec_file="$increment_dir/spec.md"
+  tasks_file="$increment_dir/tasks.md"
+  metadata_file="$increment_dir/metadata.json"
+
+  # Skip if required files don't exist
+  [ ! -f "$spec_file" ] && continue
+  [ ! -f "$tasks_file" ] && continue
+
+  # Get status from spec.md frontmatter
+  spec_status=$(grep -m1 "^status:" "$spec_file" 2>/dev/null | cut -d: -f2 | tr -d ' ')
+
+  # Get status from metadata.json (if exists)
+  metadata_status=""
+  if [ -f "$metadata_file" ]; then
+    metadata_status=$(grep -m1 '"status"' "$metadata_file" 2>/dev/null | cut -d'"' -f4)
+  fi
+
+  # Only validate if status is "completed"
+  if [ "$spec_status" = "completed" ] || [ "$metadata_status" = "completed" ]; then
+    # Count open acceptance criteria (- [ ] **AC-)
+    open_acs=$(grep -c "^- \[ \] \*\*AC-" "$spec_file" 2>/dev/null || echo 0)
+
+    # Count pending tasks (**Status**: [ ] pending)
+    pending_tasks=$(grep -ic "\*\*Status\*\*:\s*\[\s*\]\s*pending" "$tasks_file" 2>/dev/null || echo 0)
+
+    # Validate
+    if [ "$open_acs" -gt 0 ] || [ "$pending_tasks" -gt 0 ]; then
+      has_failures=true
+
+      echo -e "${RED}❌ COMMIT BLOCKED: Invalid completion detected${NC}"
+      echo -e "${YELLOW}Increment: $increment_id${NC}"
+      echo -e "Status: $spec_status (spec.md) / $metadata_status (metadata.json)"
+      echo ""
+
+      if [ "$open_acs" -gt 0 ]; then
+        echo -e "${RED}  • $open_acs acceptance criteria still open${NC}"
+      fi
+
+      if [ "$pending_tasks" -gt 0 ]; then
+        echo -e "${RED}  • $pending_tasks tasks still pending${NC}"
+      fi
+
+      echo ""
+      echo -e "${YELLOW}Fix options:${NC}"
+      echo "  1. Complete the open work before committing"
+      echo "  2. Change status to 'active' or 'paused' in both spec.md and metadata.json"
+      echo ""
+      echo -e "${YELLOW}To see details:${NC}"
+      echo "  cat $spec_file | grep '- \[ \] \*\*AC-'"
+      echo "  cat $tasks_file | grep -i 'Status.*pending'"
+      echo ""
+    fi
+  fi
+done
+
+# Exit with failure if any validation failures
+if [ "$has_failures" = true ]; then
+  echo -e "${RED}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo -e "${RED}COMMIT BLOCKED: Cannot commit increments with invalid completion${NC}"
+  echo -e "${RED}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo ""
+  echo -e "${YELLOW}Why this matters:${NC}"
+  echo "  • Prevents false completion (status='completed' with open work)"
+  echo "  • Ensures data integrity (metadata matches reality)"
+  echo "  • Stops misleading status line and GitHub sync"
+  echo ""
+  echo -e "${YELLOW}To fix:${NC}"
+  echo "  1. Complete all open ACs and pending tasks, OR"
+  echo "  2. Change status to 'active'/'paused' in spec.md and metadata.json"
+  echo ""
+  echo -e "${YELLOW}To bypass (NOT RECOMMENDED):${NC}"
+  echo "  git commit --no-verify"
+  echo ""
+  exit 1
+fi
+
+# All validations passed
+echo -e "${GREEN}✅ Completion validation passed${NC}"
+exit 0

package/plugins/specweave/lib/hooks/update-tasks-md.js

@@ -20,13 +20,22 @@ async function updateTasksMd(incrementId) {
     console.log(`\u{1F4D6} Read tasks.md (${lines.length} lines)`);
     const tasks = parseTaskStatus(lines);
     console.log(`\u{1F4CB} Found ${tasks.length} tasks`);
-    const completedTasks = detectCompletedTasks(lines);
-    if (completedTasks.length === 0) {
-      console.log("\u2705 No new task completions detected");
+    const { completedTasks, fixes } = detectCompletedTasks(lines);
+    let updatedContent = originalContent;
+    let autoFixedCount = 0;
+    if (fixes.length > 0) {
+      console.log(`\u{1F527} Auto-fixing ${fixes.length} task consistency issue(s)...`);
+      updatedContent = applyConsistencyFixes(originalContent, fixes);
+      autoFixedCount = fixes.length;
+      console.log("\u2705 Task consistency auto-fixed");
+    }
+    if (completedTasks.length === 0 && fixes.length === 0) {
+      console.log("\u2705 No new task completions or consistency fixes needed");
       return;
     }
-    console.log(`\u{1F3AF} Detected ${completedTasks.length} completed task(s):`, completedTasks);
-    let updatedContent = originalContent;
+    if (completedTasks.length > 0) {
+      console.log(`\u{1F3AF} Detected ${completedTasks.length} completed task(s):`, completedTasks);
+    }
     for (const taskId of completedTasks) {
       updatedContent = markTaskComplete(updatedContent, taskId);
     }
@@ -38,6 +47,9 @@ async function updateTasksMd(incrementId) {
     updatedContent = updateProgressHeader(updatedContent, completedCount, totalTasks, progress);
     await fs.writeFile(tasksPath, updatedContent, "utf-8");
     console.log(`\u2705 Updated ${tasksPath}`);
+    if (autoFixedCount > 0) {
+      console.log(`\u{1F527} Auto-fixed ${autoFixedCount} consistency issue(s)`);
+    }
     console.log(`   Completed: ${completedCount}/${totalTasks}`);
     console.log(`   Progress: ${progress}%
 `);
@@ -78,6 +90,7 @@ function parseTaskStatus(lines) {
 }
 function detectCompletedTasks(lines) {
   const completedTasks = [];
+  const fixes = [];
   const warnings = [];
   const taskPattern = /^###\s+(T-\d+[-A-Z]*):?\s+(.+)/;
   for (let i = 0; i < lines.length; i++) {
@@ -99,17 +112,33 @@ function detectCompletedTasks(lines) {
           completedTasks.push(taskId);
         }
       } else {
+        fixes.push({
+          taskId,
+          lineNumber: i,
+          action: "remove-complete-marker",
+          currentLine: line
+        });
         warnings.push(`${taskId}: Header has \u2705 COMPLETE but not all checkboxes checked`);
       }
       continue;
     }
     if (hasCompleteMarker && !implementationSection) {
-      if (!completedTasks.includes(taskId)) {
-        completedTasks.push(taskId);
-      }
+      fixes.push({
+        taskId,
+        lineNumber: i,
+        action: "remove-complete-marker",
+        currentLine: line
+      });
+      warnings.push(`${taskId}: Header has \u2705 COMPLETE but no implementation section to verify`);
       continue;
     }
     if (!hasCompleteMarker && implementationSection && allCheckboxesComplete) {
+      fixes.push({
+        taskId,
+        lineNumber: i,
+        action: "add-complete-marker",
+        currentLine: line
+      });
       warnings.push(`${taskId}: All checkboxes checked but header missing \u2705 COMPLETE`);
       if (!completedTasks.includes(taskId)) {
         completedTasks.push(taskId);
@@ -131,7 +160,21 @@ function detectCompletedTasks(lines) {
     warnings.forEach((w) => console.warn(`   ${w}`));
     console.warn("");
   }
-  return completedTasks;
+  return { completedTasks, fixes };
+}
+function applyConsistencyFixes(content, fixes) {
+  const lines = content.split("\n");
+  for (const fix of fixes.reverse()) {
+    const line = lines[fix.lineNumber];
+    if (fix.action === "remove-complete-marker") {
+      const fixed = line.replace(/\s*✅\s*COMPLETE\s*/g, "");
+      lines[fix.lineNumber] = fixed;
+    } else if (fix.action === "add-complete-marker") {
+      const fixed = line.trim() + " \u2705 COMPLETE";
+      lines[fix.lineNumber] = fixed;
+    }
+  }
+  return lines.join("\n");
 }
 function findNextTaskStart(lines, startIndex) {
   const taskPattern = /^###\s+T-\d+/;

package/plugins/specweave/lib/hooks/update-tasks-md.ts

@@ -32,6 +32,13 @@ interface TaskMatch {
   currentStatus: 'pending' | 'in_progress' | 'completed';
 }
 
+interface TaskConsistencyFix {
+  taskId: string;
+  lineNumber: number;
+  action: 'add-complete-marker' | 'remove-complete-marker';
+  currentLine: string;
+}
+
 /**
  * Main function - update tasks.md for given increment
  */
@@ -62,20 +69,30 @@ async function updateTasksMd(incrementId: string): Promise<void> {
     const tasks = parseTaskStatus(lines);
     console.log(`📋 Found ${tasks.length} tasks`);
 
-    // 4. Get recently completed tasks from environment (passed by hook)
-    // For now, we'll mark tasks as complete if they match a heuristic
-    // TODO: In future, hook will pass completed task IDs via env var
-    const completedTasks = detectCompletedTasks(lines);
+    // 4. Get recently completed tasks and consistency fixes
+    const { completedTasks, fixes } = detectCompletedTasks(lines);
 
-    if (completedTasks.length === 0) {
-      console.log('✅ No new task completions detected');
+    // 4a. Apply consistency fixes FIRST (if any)
+    let updatedContent = originalContent;
+    let autoFixedCount = 0;
+
+    if (fixes.length > 0) {
+      console.log(`🔧 Auto-fixing ${fixes.length} task consistency issue(s)...`);
+      updatedContent = applyConsistencyFixes(originalContent, fixes);
+      autoFixedCount = fixes.length;
+      console.log('✅ Task consistency auto-fixed');
+    }
+
+    if (completedTasks.length === 0 && fixes.length === 0) {
+      console.log('✅ No new task completions or consistency fixes needed');
       return;
     }
 
-    console.log(`🎯 Detected ${completedTasks.length} completed task(s):`, completedTasks);
+    if (completedTasks.length > 0) {
+      console.log(`🎯 Detected ${completedTasks.length} completed task(s):`, completedTasks);
+    }
 
     // 5. Update task status in content
-    let updatedContent = originalContent;
 
     for (const taskId of completedTasks) {
       updatedContent = markTaskComplete(updatedContent, taskId);
@@ -96,6 +113,9 @@ async function updateTasksMd(incrementId: string): Promise<void> {
     await fs.writeFile(tasksPath, updatedContent, 'utf-8');
 
     console.log(`✅ Updated ${tasksPath}`);
+    if (autoFixedCount > 0) {
+      console.log(`🔧 Auto-fixed ${autoFixedCount} consistency issue(s)`);
+    }
     console.log(`   Completed: ${completedCount}/${totalTasks}`);
     console.log(`   Progress: ${progress}%\n`);
 
@@ -158,8 +178,9 @@ function parseTaskStatus(lines: string[]): TaskMatch[] {
  *
  * @see .specweave/increments/0037/reports/ULTRATHINK-COMPLETE-MARKER-VS-CHECKBOXES.md
  */
-function detectCompletedTasks(lines: string[]): string[] {
+function detectCompletedTasks(lines: string[]): { completedTasks: string[]; fixes: TaskConsistencyFix[] } {
   const completedTasks: string[] = [];
+  const fixes: TaskConsistencyFix[] = [];
   const warnings: string[] = [];
   const taskPattern = /^###\s+(T-\d+[-A-Z]*):?\s+(.+)/;
 
@@ -190,22 +211,38 @@ function detectCompletedTasks(lines: string[]): string[] {
           completedTasks.push(taskId);
         }
       } else {
-        // ⚠️  INCONSISTENT: Header says COMPLETE but checkboxes incomplete
+        // ⚠️  INCONSISTENT: Header says COMPLETE but checkboxes incomplete - AUTO-FIX
+        fixes.push({
+          taskId,
+          lineNumber: i,
+          action: 'remove-complete-marker',
+          currentLine: line
+        });
         warnings.push(`${taskId}: Header has ✅ COMPLETE but not all checkboxes checked`);
       }
       continue;
     }
 
-    // If no implementation section, trust the header marker
+    // If no implementation section, remove COMPLETE marker (can't verify)
     if (hasCompleteMarker && !implementationSection) {
-      if (!completedTasks.includes(taskId)) {
-        completedTasks.push(taskId);
-      }
+      fixes.push({
+        taskId,
+        lineNumber: i,
+        action: 'remove-complete-marker',
+        currentLine: line
+      });
+      warnings.push(`${taskId}: Header has ✅ COMPLETE but no implementation section to verify`);
       continue;
     }
 
-    // Warn if checkboxes all complete but header missing marker
+    // Warn if checkboxes all complete but header missing marker - AUTO-FIX
     if (!hasCompleteMarker && implementationSection && allCheckboxesComplete) {
+      fixes.push({
+        taskId,
+        lineNumber: i,
+        action: 'add-complete-marker',
+        currentLine: line
+      });
       warnings.push(`${taskId}: All checkboxes checked but header missing ✅ COMPLETE`);
       // Still count as complete (checkboxes are source of truth for work done)
       if (!completedTasks.includes(taskId)) {
@@ -233,7 +270,31 @@ function detectCompletedTasks(lines: string[]): string[] {
     console.warn('');
   }
 
-  return completedTasks;
+  return { completedTasks, fixes };
+}
+
+/**
+ * Apply task consistency fixes to content
+ */
+function applyConsistencyFixes(content: string, fixes: TaskConsistencyFix[]): string {
+  const lines = content.split('\n');
+
+  // Apply fixes (process in reverse order to preserve line numbers)
+  for (const fix of fixes.reverse()) {
+    const line = lines[fix.lineNumber];
+
+    if (fix.action === 'remove-complete-marker') {
+      // Remove ✅ COMPLETE from header
+      const fixed = line.replace(/\s*✅\s*COMPLETE\s*/g, '');
+      lines[fix.lineNumber] = fixed;
+    } else if (fix.action === 'add-complete-marker') {
+      // Add ✅ COMPLETE to header (before any trailing spaces)
+      const fixed = line.trim() + ' ✅ COMPLETE';
+      lines[fix.lineNumber] = fixed;
+    }
+  }
+
+  return lines.join('\n');
 }
 
 /**

package/plugins/specweave/templates/iac/aws-lambda/defaults.json

@@ -0,0 +1,24 @@
+{
+  "region": "us-east-1",
+  "functionName": "my-lambda-function",
+  "runtime": "nodejs20.x",
+  "handler": "index.handler",
+  "memorySize": 128,
+  "timeout": 30,
+  "environment": "dev",
+  "databaseName": "my-dynamodb-table",
+  "primaryKey": "id",
+  "apiName": "my-api",
+  "apiStageName": "default",
+  "logRetentionDays": 90,
+  "corsOrigins": ["*"],
+  "projectName": "my-project",
+  "enableVpc": false,
+  "enableXray": false,
+  "enableSecretsManager": false,
+  "enableKms": false,
+  "enableEncryption": false,
+  "enablePointInTimeRecovery": false,
+  "enableStreams": false,
+  "enableRemoteState": false
+}

package/plugins/specweave/templates/iac/aws-lambda/templates/README.md.hbs

@@ -0,0 +1,260 @@
+# {{functionName}} - AWS Lambda Serverless Infrastructure
+
+**Generated by SpecWeave Serverless Architecture Intelligence**
+
+## Overview
+
+This Terraform configuration deploys a complete serverless application stack on AWS:
+
+- **Lambda Function**: `{{functionName}}` ({{runtime}}, {{memorySize}}MB memory, {{timeout}}s timeout)
+- **API Gateway**: HTTP API with CORS support
+- **DynamoDB**: NoSQL database table `{{databaseName}}`
+- **CloudWatch Logs**: Centralized logging with {{logRetentionDays}}-day retention
+{{#if enableVpc}}- **VPC Integration**: Secure network isolation{{/if}}
+{{#if enableXray}}- **X-Ray Tracing**: Distributed tracing enabled{{/if}}
+{{#if enableSecretsManager}}- **Secrets Manager**: Secure secret storage{{/if}}
+
+## Architecture
+
+```
+┌─────────────┐
+│   Client    │
+└──────┬──────┘
+       │ HTTPS
+       v
+┌─────────────────┐
+│  API Gateway    │
+│  (HTTP API)     │
+└──────┬──────────┘
+       │
+       v
+┌────────────────────┐      ┌──────────────┐
+│  Lambda Function   │─────>│  DynamoDB    │
+│  {{functionName}}  │      │  {{databaseName}} │
+└────────────────────┘      └──────────────┘
+       │
+       v
+┌────────────────────┐
+│ CloudWatch Logs    │
+└────────────────────┘
+```
+
+## Prerequisites
+
+1. **AWS CLI** configured with credentials:
+   ```bash
+   aws configure
+   ```
+
+2. **Terraform** v1.5.0 or higher:
+   ```bash
+   terraform version
+   ```
+
+3. **Lambda deployment package** ({{functionName}}.zip):
+   - Create your Lambda function code
+   - Package as {{functionName}}.zip
+   - Place in the same directory as this README
+
+## Deployment Instructions
+
+### Step 1: Initialize Terraform
+
+```bash
+terraform init
+```
+
+This downloads the AWS provider and initializes the backend.
+
+### Step 2: Review Configuration
+
+Edit `terraform.tfvars` (or create environment-specific files like `dev.tfvars`) to customize:
+
+```hcl
+aws_region     = "{{region}}"
+function_name  = "{{functionName}}"
+environment    = "{{environment}}"
+runtime        = "{{runtime}}"
+memory_size    = {{memorySize}}
+timeout        = {{timeout}}
+database_name  = "{{databaseName}}"
+primary_key    = "{{primaryKey}}"
+project_name   = "{{projectName}}"
+```
+
+### Step 3: Plan Deployment
+
+```bash
+terraform plan
+```
+
+Review the resources that will be created:
+- 1× Lambda Function
+- 1× API Gateway HTTP API
+- 1× DynamoDB Table
+- 2× CloudWatch Log Groups
+- 1× IAM Role + Policies
+{{#if enableVpc}}- 1× Security Group (VPC){{/if}}
+
+### Step 4: Deploy
+
+```bash
+terraform apply
+```
+
+Type `yes` when prompted to confirm deployment.
+
+### Step 5: Verify Deployment
+
+After successful deployment, Terraform will output:
+
+```
+api_endpoint = "https://xxxxxxxxxx.execute-api.{{region}}.amazonaws.com/{{apiStageName}}"
+function_name = "{{functionName}}"
+table_name = "{{databaseName}}"
+```
+
+Test your API:
+
+```bash
+curl https://xxxxxxxxxx.execute-api.{{region}}.amazonaws.com/{{apiStageName}}
+```
+
+## Environment-Specific Deployments
+
+Deploy to different environments using tfvars files:
+
+```bash
+# Development
+terraform apply -var-file="environments/dev.tfvars"
+
+# Staging
+terraform apply -var-file="environments/staging.tfvars"
+
+# Production
+terraform apply -var-file="environments/prod.tfvars"
+```
+
+## Cost Optimization
+
+### Free Tier Limits (First 12 Months)
+
+- **Lambda**: 1M requests/month + 400,000 GB-seconds compute
+- **API Gateway**: 1M API calls/month (first 12 months)
+- **DynamoDB**: 25GB storage + 25 WCU + 25 RCU (always free)
+- **CloudWatch Logs**: 5GB ingestion + 5GB storage
+
+### Estimated Monthly Cost (After Free Tier)
+
+**{{environment}} Environment**:
+{{#if eq environment "dev"}}
+- **Lambda**: ~$0.20/month (10K requests, 128MB, 1s avg duration)
+- **API Gateway**: ~$0.10/month (10K requests)
+- **DynamoDB**: $0.00/month (PAY_PER_REQUEST under free tier)
+- **CloudWatch Logs**: ~$0.50/month (1GB logs)
+- **Total**: ~$0.80/month
+{{else}}{{#if eq environment "staging"}}
+- **Lambda**: ~$2.00/month (100K requests, 256MB, 1s avg duration)
+- **API Gateway**: ~$1.00/month (100K requests)
+- **DynamoDB**: ~$1.25/month (PAY_PER_REQUEST, light usage)
+- **CloudWatch Logs**: ~$1.00/month (2GB logs)
+- **Total**: ~$5.25/month
+{{else}}
+- **Lambda**: ~$20.00/month (1M requests, 512MB, 1s avg duration)
+- **API Gateway**: ~$10.00/month (1M requests)
+- **DynamoDB**: ~$12.50/month (PROVISIONED, 5 RCU/WCU)
+- **CloudWatch Logs**: ~$5.00/month (10GB logs)
+- **Total**: ~$47.50/month
+{{/if}}{{/if}}
+
+### Cost Optimization Tips
+
+1. **Right-size memory**: Test with different memory settings (128MB, 256MB, 512MB)
+2. **Optimize timeout**: Reduce timeout to actual function duration
+3. **Use PAY_PER_REQUEST**: For low-traffic apps (<100K requests/month)
+4. **Enable CloudWatch Logs retention**: Delete old logs automatically
+5. **Monitor cold starts**: Use Provisioned Concurrency if needed ($$)
+
+## Security Best Practices
+
+✅ **Implemented**:
+- IAM least privilege roles
+- HTTPS-only API Gateway
+- CloudWatch Logs encryption
+- DynamoDB encryption at rest (if enabled)
+- Secrets Manager for sensitive data (if enabled)
+
+⚠️ **Additional Recommendations**:
+- Enable AWS WAF for API Gateway
+- Implement rate limiting
+- Use AWS Shield for DDoS protection
+- Enable VPC for database access
+- Rotate secrets regularly
+
+## Monitoring and Logging
+
+### CloudWatch Logs
+
+View Lambda logs:
+```bash
+aws logs tail /aws/lambda/{{functionName}} --follow
+```
+
+View API Gateway logs:
+```bash
+aws logs tail /aws/apigateway/{{apiName}}-{{environment}} --follow
+```
+
+### CloudWatch Metrics
+
+Monitor in AWS Console:
+- Lambda: Invocations, Duration, Errors, Throttles
+- API Gateway: Count, Latency, 4XX/5XX errors
+- DynamoDB: Read/Write capacity, Throttled requests
+
+## Cleanup
+
+To destroy all resources:
+
+```bash
+terraform destroy
+```
+
+Type `yes` to confirm deletion.
+
+**Warning**: This will permanently delete:
+- Lambda function
+- API Gateway
+- DynamoDB table (and all data)
+- CloudWatch Logs
+
+## Troubleshooting
+
+### Lambda Function Not Working
+
+1. Check CloudWatch Logs for errors
+2. Verify IAM role permissions
+3. Test function locally with AWS SAM
+
+### API Gateway 403 Errors
+
+1. Verify Lambda permission for API Gateway
+2. Check CORS configuration
+3. Review API Gateway execution logs
+
+### DynamoDB Access Denied
+
+1. Verify Lambda IAM role has DynamoDB permissions
+2. Check table name matches environment variable
+3. Verify primary key schema
+
+## Support
+
+For issues with this Terraform configuration, contact your SpecWeave administrator or file an issue at https://github.com/anton-abyzov/specweave/issues.
+
+## Additional Resources
+
+- [AWS Lambda Documentation](https://docs.aws.amazon.com/lambda/)
+- [API Gateway HTTP API Guide](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api.html)
+- [DynamoDB Developer Guide](https://docs.aws.amazon.com/dynamodb/)
+- [Terraform AWS Provider](https://registry.terraform.io/providers/hashicorp/aws/latest/docs)

package/plugins/specweave/templates/iac/aws-lambda/templates/environments/dev.tfvars.hbs

@@ -0,0 +1,34 @@
+# Development Environment Configuration
+# Optimized for free tier and minimal costs
+# Generated by SpecWeave Serverless Architecture Intelligence
+
+aws_region    = "{{region}}"
+environment   = "dev"
+function_name = "{{functionName}}-dev"
+runtime       = "{{runtime}}"
+
+# Free tier optimized settings
+memory_size = 128  # Smallest memory size (free tier eligible)
+timeout     = 30   # Conservative timeout
+
+# Database configuration
+database_name = "{{databaseName}}-dev"
+primary_key   = "{{primaryKey}}"
+{{#if sortKey}}
+sort_key      = "{{sortKey}}"
+{{/if}}
+
+# Logging (keep retention short in dev)
+log_retention_days = 7
+
+# CORS (allow localhost for development)
+cors_origins = ["http://localhost:3000", "http://localhost:8080"]
+
+# Project metadata
+project_name = "{{projectName}}"
+
+# Additional tags
+tags = {
+  CostCenter = "Development"
+  AutoDelete = "true"  # Mark for cleanup scripts
+}