specweave 0.21.2 → 0.22.0

package/plugins/specweave/templates/iac/aws-lambda/templates/main.tf.hbs

@@ -0,0 +1,216 @@
+# AWS Lambda + API Gateway + DynamoDB Terraform Configuration
+# Generated by SpecWeave Serverless Architecture Intelligence
+
+# Lambda Function
+resource "aws_lambda_function" "{{snakeCase functionName}}" {
+  filename      = "{{functionName}}.zip"
+  function_name = "{{functionName}}"
+  role          = aws_iam_role.lambda_exec.arn
+  handler       = "{{handler}}"
+  runtime       = "{{runtime}}"
+
+  memory_size = {{memorySize}}
+  timeout     = {{timeout}}
+
+  environment {
+    variables = {
+      ENVIRONMENT   = "{{environment}}"
+      TABLE_NAME    = aws_dynamodb_table.{{snakeCase databaseName}}.name
+      {{#if customEnvVars}}
+      {{#each customEnvVars}}
+      {{@key}} = "{{this}}"
+      {{/each}}
+      {{/if}}
+    }
+  }
+
+  {{#if enableVpc}}
+  vpc_config {
+    subnet_ids         = var.subnet_ids
+    security_group_ids = [aws_security_group.lambda_sg.id]
+  }
+  {{/if}}
+
+  {{#if enableXray}}
+  tracing_config {
+    mode = "Active"
+  }
+  {{/if}}
+
+  tags = {
+    Name        = "{{functionName}}"
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+    Project     = "{{projectName}}"
+  }
+}
+
+# API Gateway HTTP API
+resource "aws_apigatewayv2_api" "{{snakeCase apiName}}" {
+  name          = "{{apiName}}"
+  protocol_type = "HTTP"
+
+  cors_configuration {
+    allow_origins = {{tfList corsOrigins}}
+    allow_methods = ["GET", "POST", "PUT", "DELETE", "OPTIONS"]
+    allow_headers = ["content-type", "authorization"]
+    max_age       = 300
+  }
+
+  tags = {
+    Name        = "{{apiName}}"
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+  }
+}
+
+# API Gateway Stage
+resource "aws_apigatewayv2_stage" "{{snakeCase apiStageName}}" {
+  api_id      = aws_apigatewayv2_api.{{snakeCase apiName}}.id
+  name        = "{{apiStageName}}"
+  auto_deploy = true
+
+  access_log_settings {
+    destination_arn = aws_cloudwatch_log_group.api_logs.arn
+    format = jsonencode({
+      requestId      = "$context.requestId"
+      ip             = "$context.identity.sourceIp"
+      requestTime    = "$context.requestTime"
+      httpMethod     = "$context.httpMethod"
+      routeKey       = "$context.routeKey"
+      status         = "$context.status"
+      protocol       = "$context.protocol"
+      responseLength = "$context.responseLength"
+    })
+  }
+
+  tags = {
+    Name        = "{{apiStageName}}"
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+  }
+}
+
+# API Gateway Integration
+resource "aws_apigatewayv2_integration" "lambda" {
+  api_id = aws_apigatewayv2_api.{{snakeCase apiName}}.id
+
+  integration_uri    = aws_lambda_function.{{snakeCase functionName}}.invoke_arn
+  integration_type   = "AWS_PROXY"
+  integration_method = "POST"
+}
+
+# API Gateway Route - Catch all
+resource "aws_apigatewayv2_route" "proxy" {
+  api_id    = aws_apigatewayv2_api.{{snakeCase apiName}}.id
+  route_key = "$default"
+
+  target = "integrations/${aws_apigatewayv2_integration.lambda.id}"
+}
+
+# Lambda permission for API Gateway
+resource "aws_lambda_permission" "api_gw" {
+  statement_id  = "AllowExecutionFromAPIGateway"
+  action        = "lambda:InvokeFunction"
+  function_name = aws_lambda_function.{{snakeCase functionName}}.function_name
+  principal     = "apigateway.amazonaws.com"
+
+  source_arn = "${aws_apigatewayv2_api.{{snakeCase apiName}}.execution_arn}/*/*"
+}
+
+# DynamoDB Table
+resource "aws_dynamodb_table" "{{snakeCase databaseName}}" {
+  name           = "{{databaseName}}"
+  billing_mode   = "{{#if eq environment "prod"}}PROVISIONED{{else}}PAY_PER_REQUEST{{/if}}"
+  hash_key       = "{{primaryKey}}"
+  {{#if sortKey}}
+  range_key      = "{{sortKey}}"
+  {{/if}}
+
+  {{#if eq environment "prod"}}
+  read_capacity  = 5
+  write_capacity = 5
+  {{/if}}
+
+  attribute {
+    name = "{{primaryKey}}"
+    type = "S"
+  }
+
+  {{#if sortKey}}
+  attribute {
+    name = "{{sortKey}}"
+    type = "S"
+  }
+  {{/if}}
+
+  {{#if enableEncryption}}
+  server_side_encryption {
+    enabled     = true
+    kms_key_arn = var.kms_key_arn
+  }
+  {{/if}}
+
+  {{#if enablePointInTimeRecovery}}
+  point_in_time_recovery {
+    enabled = true
+  }
+  {{/if}}
+
+  {{#if enableStreams}}
+  stream_enabled   = true
+  stream_view_type = "NEW_AND_OLD_IMAGES"
+  {{/if}}
+
+  tags = {
+    Name        = "{{databaseName}}"
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+  }
+}
+
+# CloudWatch Log Group for API Gateway
+resource "aws_cloudwatch_log_group" "api_logs" {
+  name              = "/aws/apigateway/{{apiName}}-{{environment}}"
+  retention_in_days = {{logRetentionDays}}
+
+  tags = {
+    Name        = "{{apiName}}-logs"
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+  }
+}
+
+# CloudWatch Log Group for Lambda
+resource "aws_cloudwatch_log_group" "lambda_logs" {
+  name              = "/aws/lambda/{{functionName}}"
+  retention_in_days = {{logRetentionDays}}
+
+  tags = {
+    Name        = "{{functionName}}-logs"
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+  }
+}
+
+{{#if enableVpc}}
+# Security Group for Lambda (if VPC enabled)
+resource "aws_security_group" "lambda_sg" {
+  name        = "{{functionName}}-sg"
+  description = "Security group for Lambda function {{functionName}}"
+  vpc_id      = var.vpc_id
+
+  egress {
+    from_port   = 0
+    to_port     = 0
+    protocol    = "-1"
+    cidr_blocks = ["0.0.0.0/0"]
+  }
+
+  tags = {
+    Name        = "{{functionName}}-sg"
+    Environment = "{{environment}}"
+    ManagedBy   = "Terraform"
+  }
+}
+{{/if}}

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

@@ -0,0 +1,170 @@
+import { AdoClientV2 } from "./ado-client-v2.js";
+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 path from "path";
+import fs from "fs/promises";
+async function syncSpecToAdoWithEnhancedContent(options) {
+  const { specPath, organization, project, dryRun = false, verbose = false } = options;
+  try {
+    const baseSpec = await parseSpecContent(specPath);
+    if (!baseSpec) {
+      return {
+        success: false,
+        action: "error",
+        error: "Failed to parse spec content"
+      };
+    }
+    if (verbose) {
+      console.log(`\u{1F4C4} Parsed spec: ${baseSpec.identifier.compact}`);
+    }
+    const specId = baseSpec.identifier.full || baseSpec.identifier.compact;
+    const rootDir = await findSpecWeaveRoot(specPath);
+    const mapper = new SpecIncrementMapper(rootDir);
+    const mapping = await mapper.mapSpecToIncrements(specId);
+    if (verbose) {
+      console.log(`\u{1F517} Found ${mapping.increments.length} related increments`);
+    }
+    const taskMapping = buildTaskMapping(mapping.increments, organization, project);
+    const architectureDocs = await findArchitectureDocs(rootDir, specId);
+    const enhancedSpec = {
+      ...baseSpec,
+      summary: baseSpec.description,
+      taskMapping,
+      architectureDocs
+    };
+    const builder = new EnhancedContentBuilder();
+    const description = builder.buildExternalDescription(enhancedSpec);
+    if (verbose) {
+      console.log(`\u{1F4DD} Generated description: ${description.length} characters`);
+    }
+    if (dryRun) {
+      console.log("\u{1F50D} DRY RUN - Would create/update feature with:");
+      console.log(`   Title: ${baseSpec.title}`);
+      console.log(`   Description length: ${description.length}`);
+      return {
+        success: true,
+        action: "no-change",
+        tasksLinked: taskMapping?.tasks.length || 0
+      };
+    }
+    if (!organization || !project) {
+      return {
+        success: false,
+        action: "error",
+        error: "Azure DevOps organization/project not specified"
+      };
+    }
+    const profile = {
+      provider: "ado",
+      displayName: `${organization}/${project}`,
+      config: {
+        organization,
+        project
+      },
+      timeRange: { default: "1M", max: "6M" }
+    };
+    const pat = process.env.AZURE_DEVOPS_PAT || "";
+    const client = new AdoClientV2(profile, pat);
+    const existingFeature = await findExistingFeature(client, baseSpec.identifier.compact);
+    let result;
+    if (existingFeature) {
+      await client.updateWorkItem(existingFeature.id, {
+        title: `[${baseSpec.identifier.compact}] ${baseSpec.title}`,
+        description
+      });
+      result = {
+        success: true,
+        action: "updated",
+        featureId: existingFeature.id,
+        featureUrl: `https://dev.azure.com/${organization}/${project}/_workitems/edit/${existingFeature.id}`,
+        tasksLinked: taskMapping?.tasks.length || 0
+      };
+    } else {
+      const feature = await client.createEpic({
+        title: `[${baseSpec.identifier.compact}] ${baseSpec.title}`,
+        description,
+        tags: ["spec", "external-tool-sync"]
+      });
+      result = {
+        success: true,
+        action: "created",
+        featureId: feature.id,
+        featureUrl: `https://dev.azure.com/${organization}/${project}/_workitems/edit/${feature.id}`,
+        tasksLinked: taskMapping?.tasks.length || 0
+      };
+    }
+    if (verbose) {
+      console.log(`\u2705 ${result.action === "created" ? "Created" : "Updated"} feature #${result.featureId}`);
+    }
+    return result;
+  } catch (error) {
+    return {
+      success: false,
+      action: "error",
+      error: error.message
+    };
+  }
+}
+async function findSpecWeaveRoot(specPath) {
+  let currentDir = path.dirname(specPath);
+  while (true) {
+    const specweaveDir = path.join(currentDir, ".specweave");
+    try {
+      await fs.access(specweaveDir);
+      return currentDir;
+    } catch {
+      const parentDir = path.dirname(currentDir);
+      if (parentDir === currentDir) {
+        throw new Error(".specweave directory not found");
+      }
+      currentDir = parentDir;
+    }
+  }
+}
+function buildTaskMapping(increments, organization, project) {
+  if (increments.length === 0) return void 0;
+  const firstIncrement = increments[0];
+  const tasks = firstIncrement.tasks.map((task) => ({
+    id: task.id,
+    title: task.title,
+    userStories: task.userStories
+  }));
+  return {
+    incrementId: firstIncrement.id,
+    tasks,
+    tasksUrl: `https://dev.azure.com/${organization}/${project}/_git/repo?path=/.specweave/increments/${firstIncrement.id}/tasks.md`
+  };
+}
+async function findArchitectureDocs(rootDir, specId) {
+  const docs = [];
+  const archDir = path.join(rootDir, ".specweave/docs/internal/architecture");
+  try {
+    const adrDir = path.join(archDir, "adr");
+    try {
+      const adrs = await fs.readdir(adrDir);
+      const relatedAdrs = adrs.filter((file) => file.includes(specId.replace("spec-", "")));
+      for (const adr of relatedAdrs) {
+        docs.push({
+          type: "adr",
+          path: path.join(adrDir, adr),
+          title: adr.replace(".md", "").replace(/-/g, " ")
+        });
+      }
+    } catch {
+    }
+  } catch {
+  }
+  return docs;
+}
+async function findExistingFeature(client, specId) {
+  try {
+    const features = await client.queryWorkItems(`[System.Title] Contains '[${specId}]' AND [System.WorkItemType] = 'Feature'`);
+    return features[0] || null;
+  } catch {
+    return null;
+  }
+}
+export {
+  syncSpecToAdoWithEnhancedContent
+};

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

@@ -0,0 +1,195 @@
+import fs from "fs-extra";
+import path from "path";
+class CodeValidator {
+  constructor(options = {}) {
+    this.options = {
+      minLines: options.minLines ?? 3,
+      minChars: options.minChars ?? 50,
+      projectRoot: options.projectRoot ?? process.cwd()
+    };
+  }
+  /**
+   * Validate that code exists for a task
+   *
+   * Extracts file paths from task description and verifies:
+   * 1. Files exist
+   * 2. Files have meaningful content
+   * 3. Files are not just stubs
+   *
+   * @param taskDescription - Task description with file paths
+   * @param taskId - Task ID for error messages
+   * @returns Validation result
+   */
+  async validateTask(taskDescription, taskId) {
+    const filePaths = this.extractFilePaths(taskDescription);
+    if (filePaths.length === 0) {
+      return {
+        taskId,
+        valid: true,
+        files: [],
+        reason: "No file paths specified in task description"
+      };
+    }
+    const fileResults = [];
+    let allValid = true;
+    const reasons = [];
+    for (const filePath of filePaths) {
+      const result = await this.validateFile(filePath);
+      fileResults.push(result);
+      if (!result.exists) {
+        allValid = false;
+        reasons.push(`File not found: ${filePath}`);
+      } else if (!result.hasContent) {
+        allValid = false;
+        reasons.push(`File has no meaningful content: ${filePath} (${result.reason})`);
+      }
+    }
+    return {
+      taskId,
+      valid: allValid,
+      files: fileResults,
+      reason: reasons.length > 0 ? reasons.join("; ") : void 0
+    };
+  }
+  /**
+   * Validate a single file
+   *
+   * @param filePath - Path to file (relative or absolute)
+   * @returns File validation result
+   */
+  async validateFile(filePath) {
+    const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(this.options.projectRoot, filePath);
+    const exists = await fs.pathExists(absolutePath);
+    if (!exists) {
+      return {
+        path: filePath,
+        exists: false,
+        hasContent: false,
+        lineCount: 0,
+        reason: "File does not exist"
+      };
+    }
+    const content = await fs.readFile(absolutePath, "utf-8");
+    const lines = content.split("\n");
+    const nonEmptyLines = lines.filter((line) => line.trim().length > 0);
+    if (nonEmptyLines.length < this.options.minLines) {
+      return {
+        path: filePath,
+        exists: true,
+        hasContent: false,
+        lineCount: nonEmptyLines.length,
+        reason: `Only ${nonEmptyLines.length} non-empty lines (minimum: ${this.options.minLines})`
+      };
+    }
+    const trimmedContent = content.trim();
+    if (trimmedContent.length < this.options.minChars) {
+      return {
+        path: filePath,
+        exists: true,
+        hasContent: false,
+        lineCount: nonEmptyLines.length,
+        reason: `Only ${trimmedContent.length} characters (minimum: ${this.options.minChars})`
+      };
+    }
+    const stubPatterns = [
+      /^\/\/\s*TODO:/i,
+      /^#\s*TODO:/i,
+      /^\s*throw new Error\(['"]Not implemented['"]\)/i,
+      /^\s*return null;?\s*$/m,
+      /^\s*pass\s*$/m,
+      // Python
+      /^\s*\.\.\.$/m
+      // TypeScript
+    ];
+    const isStub = stubPatterns.some((pattern) => pattern.test(trimmedContent));
+    if (isStub) {
+      return {
+        path: filePath,
+        exists: true,
+        hasContent: false,
+        lineCount: nonEmptyLines.length,
+        reason: "File contains stub/placeholder code"
+      };
+    }
+    return {
+      path: filePath,
+      exists: true,
+      hasContent: true,
+      lineCount: nonEmptyLines.length
+    };
+  }
+  /**
+   * Extract file paths from task description
+   *
+   * Supports multiple formats:
+   * - **Files**: src/foo.ts, src/bar.ts
+   * - **Files to create**: src/foo.ts
+   * - **Files to modify**: src/bar.ts
+   * - Inline code blocks with file paths
+   *
+   * @param description - Task description text
+   * @returns Array of file paths
+   */
+  extractFilePaths(description) {
+    const paths = /* @__PURE__ */ new Set();
+    const filesMatch = description.match(/\*\*Files\*\*:\s*([^\n]+)/i);
+    if (filesMatch) {
+      const filePaths = filesMatch[1].split(",").map((p) => p.trim());
+      filePaths.forEach((p) => paths.add(p));
+    }
+    const createMatch = description.match(/\*\*Files to create\*\*:\s*([^\n]+)/i);
+    if (createMatch) {
+      const filePaths = createMatch[1].split(",").map((p) => p.trim());
+      filePaths.forEach((p) => paths.add(p));
+    }
+    const modifyMatch = description.match(/\*\*Files to modify\*\*:\s*([^\n]+)/i);
+    if (modifyMatch) {
+      const filePaths = modifyMatch[1].split(",").map((p) => p.trim());
+      filePaths.forEach((p) => paths.add(p));
+    }
+    const inlineMatches = description.matchAll(/`([a-zA-Z0-9_\-./]+\.(ts|js|tsx|jsx|py|java|go|rs|cpp|c|h))`/g);
+    for (const match of inlineMatches) {
+      paths.add(match[1]);
+    }
+    const listMatches = description.matchAll(/^[-*]\s+([a-zA-Z0-9_\-./]+\.(ts|js|tsx|jsx|py|java|go|rs|cpp|c|h))/gm);
+    for (const match of listMatches) {
+      paths.add(match[1]);
+    }
+    return Array.from(paths);
+  }
+  /**
+   * Batch validate multiple tasks
+   *
+   * @param tasks - Array of {taskId, description}
+   * @returns Array of validation results
+   */
+  async validateTasks(tasks) {
+    const validationPromises = tasks.map(
+      (task) => this.validateTask(task.description, task.taskId)
+    );
+    return Promise.all(validationPromises);
+  }
+  /**
+   * Get summary of validation results
+   *
+   * @param results - Array of task validation results
+   * @returns Summary statistics
+   */
+  summarizeResults(results) {
+    const total = results.length;
+    const valid = results.filter((r) => r.valid).length;
+    const invalid = results.filter((r) => !r.valid).length;
+    const noFiles = results.filter((r) => r.files.length === 0).length;
+    const invalidTasks = results.filter((r) => !r.valid).map((r) => r.taskId);
+    return {
+      total,
+      valid,
+      invalid,
+      noFiles,
+      invalidTasks
+    };
+  }
+}
+export {
+  CodeValidator
+};