bmad-studio 0.1.0 → 0.2.0

package/_bmad/tea/workflows/testarch/bmad-testarch-ci/gitlab-ci-template.yaml

@@ -1,158 +0,0 @@
-# GitLab CI/CD Pipeline for Test Execution
-# Generated by BMad TEA Agent - Test Architect Module
-# Optimized for: Parallel Sharding, Burn-In Loop
-# Stack: {test_stack_type} | Framework: {test_framework}
-#
-# Variables to customize per project:
-#   INSTALL_CMD       - dependency install command (e.g., npm ci, pnpm install --frozen-lockfile)
-#   TEST_CMD          - main test command (e.g., npm run test:e2e, npm test, npx vitest)
-#   LINT_CMD          - lint command (e.g., npm run lint)
-#   BROWSER_INSTALL   - browser install command (frontend/fullstack only; omit for backend)
-#   BROWSER_CACHE_PATH - browser cache path (frontend/fullstack only; omit for backend)
-
-stages:
-  - lint
-  - test
-  - burn-in
-  - report
-
-variables:
-  # Disable git depth for accurate change detection
-  GIT_DEPTH: 0
-  # Use npm ci for faster, deterministic installs
-  npm_config_cache: "$CI_PROJECT_DIR/.npm"
-  # Playwright browser cache
-  PLAYWRIGHT_BROWSERS_PATH: "$CI_PROJECT_DIR/.cache/ms-playwright"
-  # Default Node version when .nvmrc is missing
-  DEFAULT_NODE_VERSION: "24"
-
-# Caching configuration
-cache:
-  key:
-    files:
-      - package-lock.json
-  paths:
-    - .npm/
-    - .cache/ms-playwright/
-    - node_modules/
-
-# Lint stage - Code quality checks
-lint:
-  stage: lint
-  image: node:$DEFAULT_NODE_VERSION
-  before_script:
-    - |
-      NODE_VERSION=$(cat .nvmrc 2>/dev/null || echo "$DEFAULT_NODE_VERSION")
-      echo "Using Node $NODE_VERSION"
-      npm install -g n
-      n "$NODE_VERSION"
-      node -v
-    - npm ci # Replace with INSTALL_CMD
-  script:
-    - npm run lint # Replace with LINT_CMD
-  timeout: 5 minutes
-
-# Test stage - Parallel execution with sharding
-.test-template: &test-template
-  stage: test
-  image: node:$DEFAULT_NODE_VERSION
-  needs:
-    - lint
-  before_script:
-    - |
-      NODE_VERSION=$(cat .nvmrc 2>/dev/null || echo "$DEFAULT_NODE_VERSION")
-      echo "Using Node $NODE_VERSION"
-      npm install -g n
-      n "$NODE_VERSION"
-      node -v
-    - npm ci # Replace with INSTALL_CMD
-    - npx playwright install --with-deps chromium # Replace with BROWSER_INSTALL; remove for backend-only
-  artifacts:
-    when: on_failure
-    paths:
-      - test-results/
-      - playwright-report/
-    expire_in: 30 days
-  timeout: 30 minutes
-
-test:shard-1:
-  <<: *test-template
-  script:
-    - npm run test:e2e -- --shard=1/4 # Replace with TEST_CMD + shard args
-
-test:shard-2:
-  <<: *test-template
-  script:
-    - npm run test:e2e -- --shard=2/4 # Replace with TEST_CMD + shard args
-
-test:shard-3:
-  <<: *test-template
-  script:
-    - npm run test:e2e -- --shard=3/4 # Replace with TEST_CMD + shard args
-
-test:shard-4:
-  <<: *test-template
-  script:
-    - npm run test:e2e -- --shard=4/4 # Replace with TEST_CMD + shard args
-
-# Burn-in stage - Flaky test detection
-burn-in:
-  stage: burn-in
-  image: node:$DEFAULT_NODE_VERSION
-  needs:
-    - test:shard-1
-    - test:shard-2
-    - test:shard-3
-    - test:shard-4
-  # Only run burn-in on merge requests to main/develop or on schedule
-  rules:
-    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
-    - if: '$CI_PIPELINE_SOURCE == "schedule"'
-  before_script:
-    - |
-      NODE_VERSION=$(cat .nvmrc 2>/dev/null || echo "$DEFAULT_NODE_VERSION")
-      echo "Using Node $NODE_VERSION"
-      npm install -g n
-      n "$NODE_VERSION"
-      node -v
-    - npm ci # Replace with INSTALL_CMD
-    - npx playwright install --with-deps chromium # Replace with BROWSER_INSTALL; remove for backend-only
-  # Note: Burn-in targets UI flakiness. For backend-only stacks, remove this job entirely.
-  script:
-    - |
-      echo "🔥 Starting burn-in loop - detecting flaky tests"
-      for i in {1..10}; do
-        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-        echo "🔥 Burn-in iteration $i/10"
-        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-        npm run test:e2e || exit 1  # Replace with TEST_CMD
-      done
-      echo "✅ Burn-in complete - no flaky tests detected"
-  artifacts:
-    when: on_failure
-    paths:
-      - test-results/
-      - playwright-report/
-    expire_in: 30 days
-  timeout: 60 minutes
-
-# Report stage - Aggregate results
-report:
-  stage: report
-  image: alpine:latest
-  needs:
-    - test:shard-1
-    - test:shard-2
-    - test:shard-3
-    - test:shard-4
-    - burn-in
-  when: always
-  script:
-    - |
-      echo "## Test Execution Summary"
-      echo ""
-      echo "- Pipeline: $CI_PIPELINE_ID"
-      echo "- Shards: 4"
-      echo "- Branch: $CI_COMMIT_REF_NAME"
-      echo ""
-      echo "View detailed results in job artifacts"

package/_bmad/tea/workflows/testarch/bmad-testarch-ci/harness-pipeline-template.yaml

@@ -1,159 +0,0 @@
-# Harness CI Pipeline for Test Execution
-# Generated by BMad TEA Agent - Test Architect Module
-# Optimized for: Parallel Sharding, Burn-In Loop
-# Stack: {test_stack_type} | Framework: {test_framework}
-#
-# Variables to customize per project:
-#   INSTALL_CMD       - dependency install command (e.g., npm ci, pnpm install --frozen-lockfile)
-#   TEST_CMD          - main test command (e.g., npm run test:e2e, npm test, npx vitest)
-#   LINT_CMD          - lint command (e.g., npm run lint)
-#   BROWSER_INSTALL   - browser install command (frontend/fullstack only; omit for backend)
-
-pipeline:
-  name: Test Pipeline
-  identifier: test_pipeline
-  projectIdentifier: default
-  orgIdentifier: default
-  stages:
-    # Lint stage - Code quality checks
-    - stage:
-        name: Lint
-        identifier: lint
-        type: CI
-        spec:
-          cloneCodebase: true
-          infrastructure:
-            type: KubernetesDirect
-            spec:
-              connectorRef: account.harnessImage
-              namespace: default
-          execution:
-            steps:
-              - step:
-                  type: Run
-                  name: Install dependencies
-                  identifier: install
-                  spec:
-                    connectorRef: account.harnessImage
-                    image: node:24
-                    shell: Sh
-                    command: npm ci # Replace with INSTALL_CMD
-
-              - step:
-                  type: Run
-                  name: Run linter
-                  identifier: lint
-                  spec:
-                    connectorRef: account.harnessImage
-                    image: node:24
-                    shell: Sh
-                    command: npm run lint # Replace with LINT_CMD
-
-    # Test stage - Parallel execution with sharding
-    - stage:
-        name: Test
-        identifier: test
-        type: CI
-        spec:
-          cloneCodebase: true
-          infrastructure:
-            type: KubernetesDirect
-            spec:
-              connectorRef: account.harnessImage
-              namespace: default
-          execution:
-            steps:
-              - step:
-                  type: Run
-                  name: Install dependencies
-                  identifier: install
-                  spec:
-                    connectorRef: account.harnessImage
-                    image: node:24
-                    shell: Sh
-                    command: npm ci # Replace with INSTALL_CMD
-
-              # Frontend/Fullstack only — remove this step for backend-only stacks
-              - step:
-                  type: Run
-                  name: Install browsers
-                  identifier: browsers
-                  spec:
-                    connectorRef: account.harnessImage
-                    image: mcr.microsoft.com/playwright:v1.50.0-noble
-                    shell: Sh
-                    command: npx playwright install --with-deps chromium # Replace with BROWSER_INSTALL
-
-              - parallel:
-                  - step:
-                      type: Run
-                      name: Test Shard 1
-                      identifier: shard_1
-                      spec:
-                        connectorRef: account.harnessImage
-                        image: mcr.microsoft.com/playwright:v1.50.0-noble
-                        shell: Sh
-                        command: npm run test:e2e -- --shard=1/4 # Replace with TEST_CMD + shard args
-                  - step:
-                      type: Run
-                      name: Test Shard 2
-                      identifier: shard_2
-                      spec:
-                        connectorRef: account.harnessImage
-                        image: mcr.microsoft.com/playwright:v1.50.0-noble
-                        shell: Sh
-                        command: npm run test:e2e -- --shard=2/4 # Replace with TEST_CMD + shard args
-                  - step:
-                      type: Run
-                      name: Test Shard 3
-                      identifier: shard_3
-                      spec:
-                        connectorRef: account.harnessImage
-                        image: mcr.microsoft.com/playwright:v1.50.0-noble
-                        shell: Sh
-                        command: npm run test:e2e -- --shard=3/4 # Replace with TEST_CMD + shard args
-                  - step:
-                      type: Run
-                      name: Test Shard 4
-                      identifier: shard_4
-                      spec:
-                        connectorRef: account.harnessImage
-                        image: mcr.microsoft.com/playwright:v1.50.0-noble
-                        shell: Sh
-                        command: npm run test:e2e -- --shard=4/4 # Replace with TEST_CMD + shard args
-
-    # Burn-in stage - Flaky test detection
-    # Note: Burn-in targets UI flakiness. For backend-only stacks, remove this stage entirely.
-    - stage:
-        name: Burn-In
-        identifier: burn_in
-        type: CI
-        when:
-          condition: <+pipeline.triggerType> == "WEBHOOK" || <+pipeline.triggerType> == "SCHEDULER"
-        spec:
-          cloneCodebase: true
-          infrastructure:
-            type: KubernetesDirect
-            spec:
-              connectorRef: account.harnessImage
-              namespace: default
-          execution:
-            steps:
-              - step:
-                  type: Run
-                  name: Install and burn-in
-                  identifier: burn_in_loop
-                  spec:
-                    connectorRef: account.harnessImage
-                    image: mcr.microsoft.com/playwright:v1.50.0-noble
-                    shell: Sh
-                    command: |
-                      npm ci
-                      npx playwright install --with-deps chromium
-                      echo "Starting burn-in loop - detecting flaky tests"
-                      for i in $(seq 1 10); do
-                        echo "Burn-in iteration $i/10"
-                        npm run test:e2e || exit 1
-                      done
-                      echo "Burn-in complete - no flaky tests detected"
-                    # Replace npm ci with INSTALL_CMD, npm run test:e2e with TEST_CMD

package/_bmad/tea/workflows/testarch/bmad-testarch-ci/instructions.md

@@ -1,45 +0,0 @@
-<!-- Powered by BMAD-CORE™ -->
-
-# CI/CD Pipeline Setup
-
-**Workflow ID**: `_bmad/tea/testarch/bmad-testarch-ci`
-**Version**: 5.0 (Step-File Architecture)
-
----
-
-## Overview
-
-Scaffold a production-ready CI/CD quality pipeline with test execution, burn-in loops for flaky detection, parallel sharding, artifact collection, and notifications.
-
----
-
-## WORKFLOW ARCHITECTURE
-
-This workflow uses **step-file architecture**:
-
-- **Micro-file Design**: Each step is self-contained
-- **JIT Loading**: Only the current step file is in memory
-- **Sequential Enforcement**: Execute steps in order
-
----
-
-## INITIALIZATION SEQUENCE
-
-### 1. Configuration Loading
-
-From `workflow.yaml`, resolve:
-
-- `config_source`, `test_artifacts`, `user_name`, `communication_language`, `document_output_language`, `date`
-- `ci_platform`, `test_dir`
-
-### 2. First Step
-
-Load, read completely, and execute:
-`./steps-c/step-01-preflight.md`
-
-### 3. Resume Support
-
-If the user selects **Resume** mode, load, read completely, and execute:
-`./steps-c/step-01b-resume.md`
-
-This checks the output document for progress tracking frontmatter and routes to the next incomplete step.

package/_bmad/tea/workflows/testarch/bmad-testarch-ci/jenkins-pipeline-template.groovy

@@ -1,129 +0,0 @@
-// Jenkinsfile CI/CD Pipeline for Test Execution
-// Generated by BMad TEA Agent - Test Architect Module
-// Optimized for: Parallel Sharding, Burn-In Loop
-// Stack: {test_stack_type} | Framework: {test_framework}
-//
-// Variables to customize per project:
-//   INSTALL_CMD       - dependency install command (e.g., npm ci, pnpm install --frozen-lockfile)
-//   TEST_CMD          - main test command (e.g., npm run test:e2e, npm test, npx vitest)
-//   LINT_CMD          - lint command (e.g., npm run lint)
-//   BROWSER_INSTALL   - browser install command (frontend/fullstack only; omit for backend)
-//
-// Node.js version management — choose one:
-//   Option A (recommended): Configure NodeJS Plugin in Jenkins Global Tool Configuration,
-//     then add to pipeline:  tools { nodejs 'NodeJS-24' }
-//   Option B: Use nvm (pre-installed on agent) — this template uses nvm as the default
-//   Option C: Use a Docker agent — agent { docker { image 'node:24' } }
-
-pipeline {
-    agent any
-
-    environment {
-        CI = 'true'
-    }
-
-    options {
-        timeout(time: 45, unit: 'MINUTES')
-        disableConcurrentBuilds()
-    }
-
-    stages {
-        stage('Checkout') {
-            steps {
-                checkout scm
-            }
-        }
-
-        stage('Install') {
-            steps {
-                // Detect and apply Node.js version from .nvmrc (falls back to v24)
-                // If using NodeJS Plugin instead, remove this block and add: tools { nodejs 'NodeJS-24' }
-                sh '''
-                    export NVM_DIR="$HOME/.nvm"
-                    [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
-                    NODE_VERSION=$(cat .nvmrc 2>/dev/null || echo "24")
-                    nvm install "$NODE_VERSION" 2>/dev/null || true
-                    nvm use "$NODE_VERSION" 2>/dev/null || true
-                    node --version
-                    npm ci
-                ''' // Replace npm ci with INSTALL_CMD
-                // Stash installed dependencies so parallel shards can restore them
-                stash includes: 'node_modules/**', name: 'deps'
-            }
-        }
-
-        stage('Lint') {
-            steps {
-                sh 'npm run lint' // Replace with LINT_CMD
-            }
-        }
-
-        // Test stage - Parallel execution with sharding
-        // Each shard restores dependencies via unstash for workspace safety
-        stage('Test') {
-            parallel {
-                stage('Shard 1') {
-                    steps {
-                        unstash 'deps'
-                        // Frontend/Fullstack only — remove browser install for backend-only stacks
-                        sh 'npx playwright install --with-deps chromium' // Replace with BROWSER_INSTALL
-                        sh 'npm run test:e2e -- --shard=1/4' // Replace with TEST_CMD + shard args
-                    }
-                }
-                stage('Shard 2') {
-                    steps {
-                        unstash 'deps'
-                        sh 'npx playwright install --with-deps chromium' // Replace with BROWSER_INSTALL
-                        sh 'npm run test:e2e -- --shard=2/4' // Replace with TEST_CMD + shard args
-                    }
-                }
-                stage('Shard 3') {
-                    steps {
-                        unstash 'deps'
-                        sh 'npx playwright install --with-deps chromium' // Replace with BROWSER_INSTALL
-                        sh 'npm run test:e2e -- --shard=3/4' // Replace with TEST_CMD + shard args
-                    }
-                }
-                stage('Shard 4') {
-                    steps {
-                        unstash 'deps'
-                        sh 'npx playwright install --with-deps chromium' // Replace with BROWSER_INSTALL
-                        sh 'npm run test:e2e -- --shard=4/4' // Replace with TEST_CMD + shard args
-                    }
-                }
-            }
-        }
-
-        // Burn-in stage - Flaky test detection
-        // Note: Burn-in targets UI flakiness. For backend-only stacks, remove this stage entirely.
-        stage('Burn-In') {
-            when {
-                anyOf {
-                    changeRequest()
-                    triggeredBy 'TimerTrigger'
-                }
-            }
-            steps {
-                sh '''
-                    echo "Starting burn-in loop - detecting flaky tests"
-                    for i in $(seq 1 10); do
-                        echo "Burn-in iteration $i/10"
-                        npm run test:e2e || exit 1
-                    done
-                    echo "Burn-in complete - no flaky tests detected"
-                ''' // Replace npm run test:e2e with TEST_CMD
-            }
-        }
-    }
-
-    post {
-        always {
-            // Archive test results and reports
-            archiveArtifacts artifacts: 'test-results/**,playwright-report/**', allowEmptyArchive: true
-            junit testResults: 'test-results/**/*.xml', allowEmptyResults: true
-        }
-        failure {
-            echo 'Pipeline failed - check test results and artifacts'
-        }
-    }
-}

package/_bmad/tea/workflows/testarch/bmad-testarch-ci/steps-c/step-01-preflight.md

@@ -1,158 +0,0 @@
----
-name: 'step-01-preflight'
-description: 'Verify prerequisites and detect CI platform'
-nextStepFile: './step-02-generate-pipeline.md'
-outputFile: '{test_artifacts}/ci-pipeline-progress.md'
----
-
-# Step 1: Preflight Checks
-
-## STEP GOAL
-
-Verify CI prerequisites and determine target CI platform.
-
-## MANDATORY EXECUTION RULES
-
-- 📖 Read the entire step file before acting
-- ✅ Speak in `{communication_language}`
-- 🚫 Halt if requirements fail
-
----
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Follow the MANDATORY SEQUENCE exactly
-- 💾 Record outputs before proceeding
-- 📖 Load the next step only when instructed
-
-## CONTEXT BOUNDARIES:
-
-- Available context: config, loaded artifacts, and knowledge fragments
-- Focus: this step's goal only
-- Limits: do not execute future steps
-- Dependencies: prior steps' outputs (if any)
-
-## MANDATORY SEQUENCE
-
-**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise.
-
-## 1. Verify Git Repository
-
-- `.git/` exists
-- Remote configured (if available)
-
-If missing: **HALT** with "Git repository required for CI/CD setup."
-
----
-
-## 2. Detect Test Stack Type
-
-Determine the project's test stack type (`test_stack_type`) using the following algorithm:
-
-1. If `test_stack_type` is explicitly set in config (not `"auto"`), use that value.
-2. Otherwise, auto-detect by scanning project manifests:
-   - **Frontend indicators**: `playwright.config.*`, `cypress.config.*`, `vite.config.*`, `next.config.*`, `src/components/`, `src/pages/`, `src/app/`
-   - **Backend indicators**: `pyproject.toml`, `pom.xml`/`build.gradle`, `go.mod`, `*.csproj`/`*.sln`, `Gemfile`, `Cargo.toml`, `jest.config.*`, `vitest.config.*`, `src/routes/`, `src/controllers/`, `src/api/`, `Dockerfile`, `serverless.yml`
-   - **Both present** → `fullstack`
-   - **Only frontend** → `frontend`
-   - **Only backend** → `backend`
-   - **Cannot determine** → default to `fullstack` and note assumption
-
-Record detected `test_stack_type` in step output.
-
----
-
-## 3. Verify Test Framework
-
-- Check for framework configuration based on detected stack:
-  - **Frontend/Fullstack**: `playwright.config.*` or `cypress.config.*` exists
-  - **Backend (Node.js)**: `jest.config.*` or `vitest.config.*` or test scripts in `package.json`
-  - **Backend (Python)**: `pyproject.toml` with `[tool.pytest]` or `pytest.ini` or `setup.cfg` with pytest config
-  - **Backend (Java/Kotlin)**: `pom.xml` with surefire/failsafe plugins or `build.gradle` with test task
-  - **Backend (Go)**: `*_test.go` files present (Go convention — no config file needed)
-  - **Backend (C#/.NET)**: `*.csproj` with xUnit/NUnit/MSTest references
-  - **Backend (Ruby)**: `Gemfile` with rspec or `.rspec` config file
-- If `test_framework` is `"auto"`, detect from config files and project manifests found
-- Verify test dependencies are installed (language-appropriate package manager)
-
-If missing: **HALT** with "Run `framework` workflow first."
-
----
-
-## 4. Ensure Tests Pass Locally
-
-- Run the main test command based on detected stack and framework:
-  - **Node.js**: `npm test` or `npm run test:e2e`
-  - **Python**: `pytest` or `python -m pytest`
-  - **Java**: `mvn test` or `gradle test`
-  - **Go**: `go test ./...`
-  - **C#/.NET**: `dotnet test`
-  - **Ruby**: `bundle exec rspec`
-- If failing: **HALT** and request fixes before CI setup
-
----
-
-## 5. Detect CI Platform
-
-- If `ci_platform` is explicitly set in config (not `"auto"`), use that value.
-- Otherwise, scan for existing CI configuration files:
-  - `.github/workflows/*.yml` → `github-actions`
-  - `.gitlab-ci.yml` → `gitlab-ci`
-  - `Jenkinsfile` → `jenkins`
-  - `azure-pipelines.yml` → `azure-devops`
-  - `.harness/*.yaml` → `harness`
-  - `.circleci/config.yml` → `circle-ci`
-- If found, ask whether to update or replace
-- If not found, infer from git remote (github.com → `github-actions`, gitlab.com → `gitlab-ci`)
-- If still unresolved, default to `github-actions`
-
-Record detected `ci_platform` in step output.
-
----
-
-## 6. Read Environment Context
-
-- Read environment context based on detected stack:
-  - **Node.js**: Read `.nvmrc` if present (default to Node 24+ LTS if missing); read `package.json` for dependency caching strategy
-  - **Python**: Read `.python-version` or `pyproject.toml` for Python version; note `pip`/`poetry`/`pipenv` for caching
-  - **Java**: Read `pom.xml`/`build.gradle` for Java version; note Maven/Gradle for caching
-  - **Go**: Read `go.mod` for Go version; note Go module cache path
-  - **C#/.NET**: Read `*.csproj`/`global.json` for .NET SDK version; note NuGet cache
-  - **Ruby**: Read `.ruby-version` or `Gemfile` for Ruby version; note Bundler cache
-
----
-
-### 7. Save Progress
-
-**Save this step's accumulated work to `{outputFile}`.**
-
-- **If `{outputFile}` does not exist** (first save), create it with YAML frontmatter:
-
-  ```yaml
-  ---
-  stepsCompleted: ['step-01-preflight']
-  lastStep: 'step-01-preflight'
-  lastSaved: '{date}'
-  ---
-  ```
-
-  Then write this step's output below the frontmatter.
-
-- **If `{outputFile}` already exists**, update:
-  - Add `'step-01-preflight'` to `stepsCompleted` array (only if not already present)
-  - Set `lastStep: 'step-01-preflight'`
-  - Set `lastSaved: '{date}'`
-  - Append this step's output to the appropriate section of the document.
-
-Load next step: `{nextStepFile}`
-
-## 🚨 SYSTEM SUCCESS/FAILURE METRICS:
-
-### ✅ SUCCESS:
-
-- Step completed in full with required outputs
-
-### ❌ SYSTEM FAILURE:
-
-- Skipped sequence steps or missing outputs
-  **Master Rule:** Skipping steps is FORBIDDEN.