bmad-method-test-architecture-enterprise 0.1.1-beta.0

package/package.json

@@ -0,0 +1,117 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "bmad-method-test-architecture-enterprise",
+  "version": "0.1.1-beta.0",
+  "description": "Master Test Architect for quality strategy, test automation, and release gates",
+  "keywords": [
+    "bmad",
+    "test-architect",
+    "testing",
+    "quality",
+    "automation",
+    "playwright",
+    "test-engineering"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise.git"
+  },
+  "license": "MIT",
+  "author": "Murat K Ozcan (TEA Creator) & Brian (BMad) Madison",
+  "main": "",
+  "bin": {},
+  "scripts": {
+    "docs:build": "node tools/build-docs.js",
+    "docs:dev": "npm --prefix website run dev",
+    "docs:fix-links": "node tools/fix-doc-links.js --write",
+    "docs:preview": "npm --prefix website run preview",
+    "docs:validate-links": "node tools/validate-doc-links.js",
+    "format:check": "prettier --check .",
+    "format:fix": "prettier --write .",
+    "format:fix:staged": "prettier --write",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "lint:md": "markdownlint-cli2 '**/*.md'",
+    "prepare": "husky",
+    "release:alpha": "gh workflow run manual-release.yaml -f version_bump=alpha",
+    "release:beta": "gh workflow run manual-release.yaml -f version_bump=beta",
+    "release:major": "gh workflow run manual-release.yaml -f version_bump=major",
+    "release:minor": "gh workflow run manual-release.yaml -f version_bump=minor",
+    "release:patch": "gh workflow run manual-release.yaml -f version_bump=patch",
+    "test": "npm run test:schemas && npm run test:install && npm run validate:schemas && npm run lint && npm run lint:md && npm run format:check",
+    "test:coverage": "c8 npm test",
+    "test:install": "node test/test-installation-components.js",
+    "test:schemas": "node test/test-agent-schema.js",
+    "validate:schemas": "node tools/validate-agent-schema.js"
+  },
+  "lint-staged": {
+    "*.{js,cjs,mjs}": [
+      "npm run lint:fix",
+      "npm run format:fix:staged"
+    ],
+    "*.yaml": [
+      "eslint --fix",
+      "npm run format:fix:staged"
+    ],
+    "*.json": [
+      "npm run format:fix:staged"
+    ],
+    "*.md": [
+      "markdownlint-cli2 --fix",
+      "npm run format:fix:staged"
+    ]
+  },
+  "c8": {
+    "all": true,
+    "reporter": [
+      "text",
+      "html"
+    ],
+    "reports-dir": "coverage"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.0",
+    "csv-parse": "^6.1.0",
+    "fs-extra": "^11.3.0",
+    "glob": "^11.0.3",
+    "ignore": "^7.0.5",
+    "js-yaml": "^4.1.0",
+    "ora": "^5.4.1",
+    "semver": "^7.6.3",
+    "wrap-ansi": "^7.0.0",
+    "xml2js": "^0.6.2",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@astrojs/sitemap": "^3.6.0",
+    "@astrojs/starlight": "^0.37.0",
+    "@eslint/js": "^9.33.0",
+    "archiver": "^7.0.1",
+    "astro": "^5.16.0",
+    "c8": "^10.1.3",
+    "eslint": "^9.33.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-n": "^17.21.3",
+    "eslint-plugin-unicorn": "^60.0.0",
+    "eslint-plugin-yml": "^1.18.0",
+    "husky": "^9.1.7",
+    "jest": "^30.0.4",
+    "lint-staged": "^16.1.1",
+    "markdownlint-cli2": "^0.19.1",
+    "prettier": "^3.7.4",
+    "prettier-plugin-packagejson": "^2.5.19",
+    "sharp": "^0.33.5",
+    "yaml-eslint-parser": "^1.2.3",
+    "yaml-lint": "^1.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/prettier.config.mjs

@@ -0,0 +1,32 @@
+export default {
+  $schema: 'https://json.schemastore.org/prettierrc',
+  printWidth: 140,
+  tabWidth: 2,
+  useTabs: false,
+  semi: true,
+  singleQuote: true,
+  trailingComma: 'all',
+  bracketSpacing: true,
+  arrowParens: 'always',
+  endOfLine: 'lf',
+  proseWrap: 'preserve',
+  overrides: [
+    {
+      files: ['*.md'],
+      options: { proseWrap: 'preserve' },
+    },
+    {
+      files: ['*.yaml'],
+      options: { singleQuote: false },
+    },
+    {
+      files: ['*.json', '*.jsonc'],
+      options: { singleQuote: false },
+    },
+    {
+      files: ['*.cjs'],
+      options: { parser: 'babel' },
+    },
+  ],
+  plugins: ['prettier-plugin-packagejson'],
+};

package/release_notes.md

@@ -0,0 +1,28 @@
+## 🚀 What's New in v0.1.1-beta.0
+
+### 📦 Other Changes
+- Initial commit
+- test: tea migration until phase 5
+- Merge pull request #1 from bmad-code-org/test/tea-migration-part1
+- test: tea migration until phase 5
+- Merge pull request #2 from bmad-code-org/test/tea-migration-part1
+- test: phase 5 and 6 done
+- Merge pull request #3 from bmad-code-org/test/phase-5
+- test: phase 7
+- less gitignore
+- do not gitignore package.json
+- Merge pull request #4 from bmad-code-org/test/phase-7
+- test: publish
+- Merge pull request #5 from bmad-code-org/test/publish
+- added release scripts
+
+### 🔧 Maintenance
+- chore: fixed manual release
+
+
+## 📦 Installation
+
+```bash
+npx bmad-method install
+# Select "Test Architect" from module menu
+```

package/src/_module-installer/installer.js

@@ -0,0 +1,92 @@
+const fs = require('fs-extra');
+const path = require('node:path');
+const chalk = require('chalk');
+
+/**
+ * CIS Module Installer
+ * Standard module installer function that executes after IDE installations
+ *
+ * @param {Object} options - Installation options
+ * @param {string} options.projectRoot - The root directory of the target project
+ * @param {Object} options.config - Module configuration from module.yaml
+ * @param {Array<string>} options.installedIDEs - Array of IDE codes that were installed
+ * @param {Object} options.logger - Logger instance for output
+ * @returns {Promise<boolean>} - Success status
+ */
+async function install(options) {
+  const { projectRoot, config, installedIDEs, logger } = options;
+
+  try {
+    logger.log(chalk.blue('🎨 Installing CIS Module...'));
+
+    // Create output directory if configured
+    if (config['output_folder']) {
+      // Strip {project-root}/ prefix if present
+      const outputConfig = config['output_folder'].replace('{project-root}/', '');
+      const outputPath = path.join(projectRoot, outputConfig);
+      if (!(await fs.pathExists(outputPath))) {
+        logger.log(chalk.yellow(`Creating CIS output directory: ${outputConfig}`));
+        await fs.ensureDir(outputPath);
+
+        // Add any default CIS templates or assets here
+        const templatesSource = path.join(__dirname, 'assets');
+        const templateFiles = await fs.readdir(templatesSource).catch(() => []);
+
+        for (const file of templateFiles) {
+          const source = path.join(templatesSource, file);
+          const dest = path.join(outputPath, file);
+
+          if (!(await fs.pathExists(dest))) {
+            await fs.copy(source, dest);
+            logger.log(chalk.green(`✓ Added ${file}`));
+          }
+        }
+      }
+    }
+
+    // Handle IDE-specific configurations if needed
+    if (installedIDEs && installedIDEs.length > 0) {
+      logger.log(chalk.cyan(`Configuring CIS for IDEs: ${installedIDEs.join(', ')}`));
+
+      // Add any IDE-specific CIS configurations here
+      for (const ide of installedIDEs) {
+        await configureForIDE(ide, projectRoot, config, logger);
+      }
+    }
+
+    logger.log(chalk.green('✓ CIS Module installation complete'));
+    return true;
+  } catch (error) {
+    logger.error(chalk.red(`Error installing CIS module: ${error.message}`));
+    return false;
+  }
+}
+
+/**
+ * Configure CIS module for specific IDE
+ * @private
+ */
+async function configureForIDE(ide) {
+  // Add IDE-specific configurations here
+  switch (ide) {
+    case 'claude-code': {
+      // Claude Code specific CIS configurations
+      break;
+    }
+    case 'cursor': {
+      // Cursor specific CIS configurations
+      break;
+    }
+    case 'windsurf': {
+      // Windsurf specific CIS configurations
+      break;
+    }
+    // Add more IDEs as needed
+    default: {
+      // No specific configuration needed
+      break;
+    }
+  }
+}
+
+module.exports = { install };

package/src/agents/tea.agent.yaml

@@ -0,0 +1,63 @@
+# Test Architect + Quality Advisor Agent Definition
+
+agent:
+  webskip: true
+  metadata:
+    id: "_bmad/tea/agents/tea.md"
+    name: Murat
+    title: Master Test Architect and Quality Advisor
+    icon: 🧪
+    module: tea
+    hasSidecar: false
+
+  persona:
+    role: Master Test Architect
+    identity: Test architect specializing in risk-based testing, fixture architecture, ATDD, API testing, backend services, UI automation, CI/CD governance, and scalable quality gates. Equally proficient in pure API/service-layer testing as in browser-based E2E testing.
+    communication_style: "Blends data with gut instinct. 'Strong opinions, weakly held' is their mantra. Speaks in risk calculations and impact assessments."
+    principles: |
+      - Risk-based testing - depth scales with impact
+      - Quality gates backed by data
+      - Tests mirror usage patterns (API, UI, or both)
+      - Flakiness is critical technical debt
+      - Tests first AI implements suite validates
+      - Calculate risk vs value for every testing decision
+      - Prefer lower test levels (unit > integration > E2E) when possible
+      - API tests are first-class citizens, not just UI support
+
+  critical_actions:
+    - "Consult {project-root}/_bmad/tea/testarch/tea-index.csv to select knowledge fragments under knowledge/ and load only the files needed for the current task"
+    - "Load the referenced fragment(s) from {project-root}/_bmad/tea/testarch/knowledge/ before giving recommendations"
+    - "Cross-check recommendations with the current official Playwright, Cypress, Pact, and CI platform documentation"
+
+  menu:
+    - trigger: TF or fuzzy match on test-framework
+      workflow: "{project-root}/_bmad/tea/workflows/testarch/framework/workflow.yaml"
+      description: "[TF] Test Framework: Initialize production-ready test framework architecture"
+
+    - trigger: AT or fuzzy match on atdd
+      workflow: "{project-root}/_bmad/tea/workflows/testarch/atdd/workflow.yaml"
+      description: "[AT] ATDD: Generate failing acceptance tests plus an implementation checklist before development"
+
+    - trigger: TA or fuzzy match on test-automate
+      workflow: "{project-root}/_bmad/tea/workflows/testarch/automate/workflow.yaml"
+      description: "[TA] Test Automation: Generate prioritized API/E2E tests, fixtures, and DoD summary for a story or feature"
+
+    - trigger: TD or fuzzy match on test-design
+      workflow: "{project-root}/_bmad/tea/workflows/testarch/test-design/workflow.yaml"
+      description: "[TD] Test Design: Risk assessment plus coverage strategy for system or epic scope"
+
+    - trigger: TR or fuzzy match on test-trace
+      workflow: "{project-root}/_bmad/tea/workflows/testarch/trace/workflow.yaml"
+      description: "[TR] Trace Requirements: Map requirements to tests (Phase 1) and make quality gate decision (Phase 2)"
+
+    - trigger: NR or fuzzy match on nfr-assess
+      workflow: "{project-root}/_bmad/tea/workflows/testarch/nfr-assess/workflow.yaml"
+      description: "[NR] Non-Functional Requirements: Assess NFRs and recommend actions"
+
+    - trigger: CI or fuzzy match on continuous-integration
+      workflow: "{project-root}/_bmad/tea/workflows/testarch/ci/workflow.yaml"
+      description: "[CI] Continuous Integration: Recommend and Scaffold CI/CD quality pipeline"
+
+    - trigger: RV or fuzzy match on test-review
+      workflow: "{project-root}/_bmad/tea/workflows/testarch/test-review/workflow.yaml"
+      description: "[RV] Review Tests: Perform a quality check against written tests using comprehensive knowledge base and best practices"

package/src/module-help.csv

@@ -0,0 +1,9 @@
+module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs,
+tea,3-solutioning,Test Framework,TF,10,_bmad/tea/workflows/testarch/framework/workflow.yaml,bmad_tea_framework,false,tea,Create Mode,"Initialize production-ready test framework",test_artifacts,"framework scaffold",
+tea,3-solutioning,CI Setup,CI,20,_bmad/tea/workflows/testarch/ci/workflow.yaml,bmad_tea_ci,false,tea,Create Mode,"Configure CI/CD quality pipeline",test_artifacts,"ci config",
+tea,3-solutioning,Test Design,TD,30,_bmad/tea/workflows/testarch/test-design/workflow.yaml,bmad_tea_test-design,false,tea,Create Mode,"Risk-based test planning",test_artifacts,"test design document",
+tea,4-implementation,ATDD,AT,10,_bmad/tea/workflows/testarch/atdd/workflow.yaml,bmad_tea_atdd,false,tea,Create Mode,"Generate failing tests (TDD red phase)",test_artifacts,"atdd tests",
+tea,4-implementation,Test Automation,TA,20,_bmad/tea/workflows/testarch/automate/workflow.yaml,bmad_tea_automate,false,tea,Create Mode,"Expand test coverage",test_artifacts,"test suite",
+tea,4-implementation,Test Review,RV,30,_bmad/tea/workflows/testarch/test-review/workflow.yaml,bmad_tea_test-review,false,tea,Validate Mode,"Quality audit (0-100 scoring)",test_artifacts,"review report",
+tea,4-implementation,NFR Assessment,NR,40,_bmad/tea/workflows/testarch/nfr-assess/workflow.yaml,bmad_tea_nfr-assess,false,tea,Create Mode,"Non-functional requirements",test_artifacts,"nfr report",
+tea,4-implementation,Traceability,TR,50,_bmad/tea/workflows/testarch/trace/workflow.yaml,bmad_tea_trace,false,tea,Create Mode,"Coverage traceability and gate",test_artifacts,"traceability matrix|gate decision",

package/src/module.yaml

@@ -0,0 +1,91 @@
+code: tea
+name: "Test Architect"
+header: "Test Architect: quality strategy, automation, and release gates"
+subheader: "Risk-based testing workflows for BMad Method/Enterprise with optional Playwright/MCP enhancements"
+description: "Master Test Architect for quality strategy, test automation, and release gates"
+default_selected: false
+
+# Variables from Core Config inserted automatically by installer:
+## user_name
+## communication_language
+## document_output_language
+## output_folder
+## project_root
+
+# TEA-specific configuration variables
+# IMPORTANT: Only tea_use_playwright_utils and tea_use_mcp_enhancements are ACTIVELY USED in workflows
+# Other variables are FUTURE placeholders for Phase 10 enhancements
+
+test_artifacts:
+  prompt: "Where should test artifacts be stored? (test plans, coverage reports, quality audits)"
+  default: "{output_folder}/test-artifacts"
+  result: "{project-root}/{value}"
+
+# ✅ ACTIVELY USED - Playwright Utils integration (referenced in 6 workflows: automate, atdd, framework, test-design, test-review, ci)
+# CRITICAL: Must be boolean (true/false) not string - workflows check "if config.tea_use_playwright_utils: true"
+tea_use_playwright_utils:
+  prompt: "Enable Playwright Utils integration?"
+  default: true
+  result: "{value}"
+  single-select:
+    - value: true
+      label: "Yes - Use production utilities (Recommended)"
+    - value: false
+      label: "No - Generate from scratch"
+
+# ✅ ACTIVELY USED - Playwright MCP enhancements (workflows with recording mode)
+# CRITICAL: Must be boolean (true/false) not string
+tea_use_mcp_enhancements:
+  prompt: "Enable Playwright MCP enhancements?"
+  default: false
+  result: "{value}"
+  single-select:
+    - value: true
+      label: "Yes - Enable live browser verification"
+    - value: false
+      label: "No - Standard mode only"
+
+# ⏭️ FUTURE - Test framework selection (not currently wired into workflows, marked for Phase 10)
+test_framework:
+  prompt: "Which test framework are you using?"
+  default: "playwright"
+  result: "{value}"
+  single-select:
+    - value: "playwright"
+      label: "Playwright (Recommended)"
+    - value: "cypress"
+      label: "Cypress"
+    - value: "other"
+      label: "Other/Custom"
+
+# ⏭️ FUTURE - Risk threshold (not currently used in test-design workflow, marked for Phase 10)
+risk_threshold:
+  prompt: "What risk level requires mandatory testing?"
+  default: "p1"
+  result: "{value}"
+  single-select:
+    - value: "p0"
+      label: "P0 only (Critical systems)"
+    - value: "p1"
+      label: "P1+ (High & Critical)"
+    - value: "p2"
+      label: "P2+ (Medium, High & Critical)"
+    - value: "p3"
+      label: "All (P0-P3)"
+
+# ⏭️ FUTURE - Test output folders (not currently wired into workflows, marked for Phase 10)
+# IMPORTANT: test_artifacts already resolves to {project-root}/..., so don't re-prepend {project-root}
+test_design_output:
+  prompt: "Where should test design documents be stored?"
+  default: "test-design"
+  result: "{test_artifacts}/{value}"
+
+test_review_output:
+  prompt: "Where should test review reports be stored?"
+  default: "test-reviews"
+  result: "{test_artifacts}/{value}"
+
+trace_output:
+  prompt: "Where should traceability reports be stored?"
+  default: "traceability"
+  result: "{test_artifacts}/{value}"