specweave 0.21.2 → 0.21.3

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-github/lib/IssueStateManager.js

@@ -0,0 +1,117 @@
+class IssueStateManager {
+  /**
+   * Determine issue state based on progress
+   *
+   * @param progress - Progress information
+   * @param currentState - Current issue state
+   * @returns State change result
+   */
+  static determineState(progress, currentState) {
+    const result = {
+      previousState: currentState,
+      newState: currentState,
+      changed: false,
+      labelsAdded: [],
+      labelsRemoved: []
+    };
+    if (progress.isComplete) {
+      result.newState = "closed";
+      result.labelsRemoved.push("in-progress");
+    } else if (progress.overallPercentage > 0) {
+      result.newState = "open";
+      result.labelsAdded.push("in-progress");
+    } else {
+      result.newState = "open";
+      result.labelsRemoved.push("in-progress");
+    }
+    result.changed = result.newState !== result.previousState;
+    return result;
+  }
+  /**
+   * Calculate progress from acceptance criteria and tasks
+   *
+   * @param acs - Acceptance criteria
+   * @param tasks - Tasks
+   * @returns Progress information
+   */
+  static calculateProgress(acs, tasks) {
+    const totalAcs = acs.length;
+    const completedAcs = acs.filter((ac) => ac.completed).length;
+    const acPercentage = totalAcs > 0 ? Math.round(completedAcs / totalAcs * 100) : 0;
+    const totalTasks = tasks.length;
+    const completedTasks = tasks.filter((t) => t.completed).length;
+    const taskPercentage = totalTasks > 0 ? Math.round(completedTasks / totalTasks * 100) : 0;
+    const overallPercentage = totalTasks > 0 ? Math.round((acPercentage + taskPercentage) / 2) : acPercentage;
+    const isComplete = totalAcs > 0 && completedAcs === totalAcs && (totalTasks === 0 || completedTasks === totalTasks);
+    return {
+      totalAcs,
+      completedAcs,
+      acPercentage,
+      totalTasks,
+      completedTasks,
+      taskPercentage,
+      overallPercentage,
+      isComplete
+    };
+  }
+  /**
+   * Format progress as markdown
+   *
+   * @param progress - Progress information
+   * @returns Markdown string
+   */
+  static formatProgressMarkdown(progress) {
+    const sections = [];
+    sections.push("## Progress");
+    sections.push("");
+    sections.push(`**Acceptance Criteria**: ${progress.completedAcs}/${progress.totalAcs} (${progress.acPercentage}%)`);
+    if (progress.totalTasks > 0) {
+      sections.push(`**Tasks**: ${progress.completedTasks}/${progress.totalTasks} (${progress.taskPercentage}%)`);
+    }
+    sections.push(`**Overall**: ${progress.overallPercentage}%`);
+    const progressBar = this.generateProgressBar(progress.overallPercentage);
+    sections.push("");
+    sections.push(progressBar);
+    return sections.join("\n");
+  }
+  /**
+   * Generate ASCII progress bar
+   *
+   * @param percentage - Completion percentage (0-100)
+   * @returns Progress bar string
+   */
+  static generateProgressBar(percentage) {
+    const total = 20;
+    const filled = Math.round(percentage / 100 * total);
+    const empty = total - filled;
+    const bar = "\u2588".repeat(filled) + "\u2591".repeat(empty);
+    return `\`${bar}\` ${percentage}%`;
+  }
+  /**
+   * Build GitHub CLI command to update issue state
+   *
+   * @param issueNumber - GitHub issue number
+   * @param state - New state
+   * @param labelsToAdd - Labels to add
+   * @param labelsToRemove - Labels to remove
+   * @returns gh CLI command
+   */
+  static buildGitHubCommand(issueNumber, state, labelsToAdd, labelsToRemove) {
+    const commands = [];
+    if (state === "closed") {
+      commands.push(`gh issue close ${issueNumber}`);
+    } else {
+      commands.push(`gh issue reopen ${issueNumber}`);
+    }
+    if (labelsToAdd.length > 0) {
+      commands.push(`gh issue edit ${issueNumber} --add-label "${labelsToAdd.join(",")}"`);
+    }
+    if (labelsToRemove.length > 0) {
+      commands.push(`gh issue edit ${issueNumber} --remove-label "${labelsToRemove.join(",")}"`);
+    }
+    return commands.join(" && ");
+  }
+}
+export {
+  IssueStateManager
+};

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

@@ -0,0 +1,231 @@
+/**
+ * Issue State Manager - Auto-update GitHub issue state based on progress
+ *
+ * Rules:
+ * - 0% complete → State = open
+ * - 1-99% complete → State = open, label = in-progress
+ * - 100% complete → State = closed
+ */
+
+/**
+ * Issue state
+ */
+export type IssueState = 'open' | 'closed';
+
+/**
+ * State change result
+ */
+export interface StateChangeResult {
+  /** Previous state */
+  previousState: IssueState;
+
+  /** New state */
+  newState: IssueState;
+
+  /** State changed */
+  changed: boolean;
+
+  /** Labels added */
+  labelsAdded: string[];
+
+  /** Labels removed */
+  labelsRemoved: string[];
+}
+
+/**
+ * Progress info
+ */
+export interface ProgressInfo {
+  /** Total ACs */
+  totalAcs: number;
+
+  /** Completed ACs */
+  completedAcs: number;
+
+  /** AC completion percentage */
+  acPercentage: number;
+
+  /** Total tasks */
+  totalTasks: number;
+
+  /** Completed tasks */
+  completedTasks: number;
+
+  /** Task completion percentage */
+  taskPercentage: number;
+
+  /** Overall completion percentage */
+  overallPercentage: number;
+
+  /** Is 100% complete */
+  isComplete: boolean;
+}
+
+/**
+ * IssueStateManager - Manages GitHub issue state
+ */
+export class IssueStateManager {
+  /**
+   * Determine issue state based on progress
+   *
+   * @param progress - Progress information
+   * @param currentState - Current issue state
+   * @returns State change result
+   */
+  static determineState(
+    progress: ProgressInfo,
+    currentState: IssueState
+  ): StateChangeResult {
+    const result: StateChangeResult = {
+      previousState: currentState,
+      newState: currentState,
+      changed: false,
+      labelsAdded: [],
+      labelsRemoved: []
+    };
+
+    // Determine new state based on progress
+    if (progress.isComplete) {
+      // 100% complete → Close issue
+      result.newState = 'closed';
+      result.labelsRemoved.push('in-progress');
+    } else if (progress.overallPercentage > 0) {
+      // 1-99% complete → Open with in-progress label
+      result.newState = 'open';
+      result.labelsAdded.push('in-progress');
+    } else {
+      // 0% complete → Open without in-progress label
+      result.newState = 'open';
+      result.labelsRemoved.push('in-progress');
+    }
+
+    // Check if state changed
+    result.changed = result.newState !== result.previousState;
+
+    return result;
+  }
+
+  /**
+   * Calculate progress from acceptance criteria and tasks
+   *
+   * @param acs - Acceptance criteria
+   * @param tasks - Tasks
+   * @returns Progress information
+   */
+  static calculateProgress(
+    acs: Array<{ completed: boolean }>,
+    tasks: Array<{ completed: boolean }>
+  ): ProgressInfo {
+    const totalAcs = acs.length;
+    const completedAcs = acs.filter(ac => ac.completed).length;
+    const acPercentage = totalAcs > 0 ? Math.round((completedAcs / totalAcs) * 100) : 0;
+
+    const totalTasks = tasks.length;
+    const completedTasks = tasks.filter(t => t.completed).length;
+    const taskPercentage = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+
+    // Overall percentage: average of AC and Task percentages
+    // If no tasks, use AC percentage only
+    const overallPercentage = totalTasks > 0
+      ? Math.round((acPercentage + taskPercentage) / 2)
+      : acPercentage;
+
+    const isComplete = totalAcs > 0 && completedAcs === totalAcs &&
+      (totalTasks === 0 || completedTasks === totalTasks);
+
+    return {
+      totalAcs,
+      completedAcs,
+      acPercentage,
+      totalTasks,
+      completedTasks,
+      taskPercentage,
+      overallPercentage,
+      isComplete
+    };
+  }
+
+  /**
+   * Format progress as markdown
+   *
+   * @param progress - Progress information
+   * @returns Markdown string
+   */
+  static formatProgressMarkdown(progress: ProgressInfo): string {
+    const sections: string[] = [];
+
+    sections.push('## Progress');
+    sections.push('');
+
+    // AC progress
+    sections.push(`**Acceptance Criteria**: ${progress.completedAcs}/${progress.totalAcs} (${progress.acPercentage}%)`);
+
+    // Task progress
+    if (progress.totalTasks > 0) {
+      sections.push(`**Tasks**: ${progress.completedTasks}/${progress.totalTasks} (${progress.taskPercentage}%)`);
+    }
+
+    // Overall progress
+    sections.push(`**Overall**: ${progress.overallPercentage}%`);
+
+    // Progress bar
+    const progressBar = this.generateProgressBar(progress.overallPercentage);
+    sections.push('');
+    sections.push(progressBar);
+
+    return sections.join('\n');
+  }
+
+  /**
+   * Generate ASCII progress bar
+   *
+   * @param percentage - Completion percentage (0-100)
+   * @returns Progress bar string
+   */
+  private static generateProgressBar(percentage: number): string {
+    const total = 20;
+    const filled = Math.round((percentage / 100) * total);
+    const empty = total - filled;
+
+    const bar = '█'.repeat(filled) + '░'.repeat(empty);
+
+    return `\`${bar}\` ${percentage}%`;
+  }
+
+  /**
+   * Build GitHub CLI command to update issue state
+   *
+   * @param issueNumber - GitHub issue number
+   * @param state - New state
+   * @param labelsToAdd - Labels to add
+   * @param labelsToRemove - Labels to remove
+   * @returns gh CLI command
+   */
+  static buildGitHubCommand(
+    issueNumber: number,
+    state: IssueState,
+    labelsToAdd: string[],
+    labelsToRemove: string[]
+  ): string {
+    const commands: string[] = [];
+
+    // Update state
+    if (state === 'closed') {
+      commands.push(`gh issue close ${issueNumber}`);
+    } else {
+      commands.push(`gh issue reopen ${issueNumber}`);
+    }
+
+    // Add labels
+    if (labelsToAdd.length > 0) {
+      commands.push(`gh issue edit ${issueNumber} --add-label "${labelsToAdd.join(',')}"`);
+    }
+
+    // Remove labels
+    if (labelsToRemove.length > 0) {
+      commands.push(`gh issue edit ${issueNumber} --remove-label "${labelsToRemove.join(',')}"`);
+    }
+
+    return commands.join(' && ');
+  }
+}

package/plugins/specweave-github/lib/user-story-issue-builder.js

@@ -2,6 +2,7 @@ import { readFile } from "fs/promises";
 import { existsSync } from "fs";
 import * as path from "path";
 import * as yaml from "yaml";
+import { IssueStateManager } from "./IssueStateManager.js";
 class UserStoryIssueBuilder {
   constructor(userStoryPath, projectRoot, featureId, repoInfo) {
     this.userStoryPath = userStoryPath;
@@ -206,6 +207,10 @@ class UserStoryIssueBuilder {
    */
   buildBody(data) {
     const sections = [];
+    const progress = IssueStateManager.calculateProgress(
+      data.acceptanceCriteria,
+      data.tasks
+    );
     sections.push(`**Feature**: ${this.featureId}`);
     sections.push(`**Status**: ${this.capitalize(data.frontmatter.status)}`);
     sections.push(`**Priority**: ${data.frontmatter.priority || "P2"}`);
@@ -213,6 +218,8 @@ class UserStoryIssueBuilder {
       sections.push(`**Project**: ${data.frontmatter.project}`);
     }
     sections.push("");
+    sections.push(IssueStateManager.formatProgressMarkdown(progress));
+    sections.push("");
     if (data.userStoryStatement) {
       sections.push("## User Story");
       sections.push("");

package/plugins/specweave-github/lib/user-story-issue-builder.ts

@@ -17,6 +17,7 @@ import { readFile } from 'fs/promises';
 import { existsSync } from 'fs';
 import * as path from 'path';
 import * as yaml from 'yaml';
+import { IssueStateManager, ProgressInfo } from './IssueStateManager.js';
 
 interface UserStoryFrontmatter {
   id: string;
@@ -356,6 +357,12 @@ export class UserStoryIssueBuilder {
   }): string {
     const sections: string[] = [];
 
+    // Calculate progress
+    const progress = IssueStateManager.calculateProgress(
+      data.acceptanceCriteria,
+      data.tasks
+    );
+
     // Header with metadata
     sections.push(`**Feature**: ${this.featureId}`);
     sections.push(`**Status**: ${this.capitalize(data.frontmatter.status)}`);
@@ -366,6 +373,10 @@ export class UserStoryIssueBuilder {
     }
     sections.push('');
 
+    // Progress section (NEW)
+    sections.push(IssueStateManager.formatProgressMarkdown(progress));
+    sections.push('');
+
     // User Story statement
     if (data.userStoryStatement) {
       sections.push('## User Story');

package/plugins/specweave-ui/.mcp.json

@@ -5,16 +5,6 @@
       "args": ["-y", "@playwright/mcp@latest"],
       "description": "Local Playwright browser automation - PRIMARY choice for E2E testing and web interaction",
       "optional": false
-    },
-    "browserbase": {
-      "command": "npx",
-      "args": ["-y", "@browserbasehq/mcp-server-browserbase"],
-      "env": {
-        "BROWSERBASE_API_KEY": "${BROWSERBASE_API_KEY}",
-        "BROWSERBASE_PROJECT_ID": "${BROWSERBASE_PROJECT_ID}"
-      },
-      "description": "Cloud browser automation for running Playwright tests in scalable infrastructure - FALLBACK option",
-      "optional": true
     }
   }
 }