ma-agents 2.19.2 → 2.20.0

package/lib/bmad-cache/tea/CHANGELOG.md

@@ -0,0 +1,253 @@
+# Changelog
+
+All notable changes to the Test Architect (TEA) module will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.4] - 2026-02-22
+
+### Changed
+
+- **All workflow descriptions optimized** for skill selection and display
+  - Descriptions shortened and made more concise for better UI rendering
+  - Added explicit trigger phrases (e.g., "Use when user says 'lets write acceptance tests'") to improve skill detection
+  - Affected workflows: `atdd`, `automate`, `ci`, `framework`, `nfr-assess`, `teach-me-testing`, `test-design`, `test-review`, `trace`
+  - Removed redundant `web_bundle: false` from workflow.yaml files
+
+## [Unreleased]
+
+### Added
+
+- **Playwright CLI Integration**: New `playwright-cli.md` knowledge fragment (35 total)
+- **Browser Automation Config**: New `tea_browser_automation` config with 4 modes: `auto`, `cli`, `mcp`, `none`
+- **Auto Mode Heuristic**: Smart CLI/MCP selection per workflow action with fallback
+- **How-To Guide**: `docs/how-to/customization/configure-browser-automation.md`
+- **Knowledge Test Script**: `test:knowledge` npm script added to test chain
+
+### Changed
+
+- **Breaking**: `tea_use_mcp_enhancements` (boolean) replaced by `tea_browser_automation` (string)
+  - `true` -> `"auto"` (recommended), `false` -> `"none"`
+- All workflow preflight steps updated to read `tea_browser_automation`
+- All browser-touching workflow steps updated with CLI/MCP/auto branching
+- Subagent context passes `browser_automation` instead of `use_mcp_enhancements`
+- Module subheader updated to reference Playwright CLI
+- **Breaking**: Orchestration terminology standardized to `subagent` / `agent-team` (removed `subprocess` wording)
+  - Renamed worker step files from `*-subprocess-*` to `*-subagent-*` in `automate`, `atdd`, `nfr-assess`, and `test-review`
+  - Updated orchestration mode resolution examples to use `subagent` only
+  - Renamed architecture docs: `subprocess-architecture.md` -> `subagent-architecture.md`, `subprocess-implementation-status.md` -> `subagent-implementation-status.md`
+  - Updated docs navigation, troubleshooting references, and workflow/resource indexes to new names
+  - Updated workflow contract labels/examples from `subprocess` to `subagent` (for example `subagent_execution`, `subagentType`)
+
+### Deprecated
+
+- `tea_use_mcp_enhancements` flag — use `tea_browser_automation` instead
+- `enable-tea-mcp-enhancements.md` guide — redirects to `configure-browser-automation.md`
+
+---
+
+## [1.0.0] - 2026-01-XX (Upcoming)
+
+### 🎉 TEA Module Independence Release
+
+TEA (Test Engineering Architect) is now a standalone BMAD module, extracted from the core BMAD Method repository. This release marks TEA's independence as a dedicated test strategy and quality engineering module.
+
+### Added
+
+#### Core Infrastructure
+
+- **Standalone Module**: TEA now installable independently via `npx bmad-method install`
+- **Module Namespace**: All commands now use `/bmad:tea:*` namespace
+- **Agent Persona**: Murat (Master Test Architect and Quality Advisor)
+- **Configuration System**: 6 module variables with installation prompts
+  - `test_artifacts` - Base output folder for test artifacts
+  - `tea_use_playwright_utils` - Playwright Utils integration toggle
+  - `tea_use_mcp_enhancements` - Playwright MCP enhancements toggle
+  - `test_framework` - Default framework preference (future)
+  - `risk_threshold` - Risk cutoff for mandatory testing (future)
+  - Output folder configurations: `test_design_output`, `test_review_output`, `trace_output`
+
+#### Workflows (8 Total)
+
+All workflows implement the **trivariate step pattern** (Create/Edit/Validate):
+
+1. **Framework Setup (`TF` / `/bmad:tea:framework`)**
+   - Scaffold Playwright/Cypress test frameworks
+   - Configure project structure and dependencies
+   - Setup test configuration and helpers
+
+2. **CI/CD Integration (`CI` / `/bmad:tea:ci`)**
+   - Generate GitHub Actions and GitLab CI pipelines
+   - Configure quality gates and test execution
+   - Setup test reporting and artifact management
+
+3. **Test Design (`TD` / `/bmad:tea:test-design`)**
+   - System-level and epic-level test planning
+   - Risk-based test strategy with P0-P3 prioritization
+   - Test coverage planning and traceability mapping
+
+4. **ATDD (`AT` / `/bmad:tea:atdd`)**
+   - Generate failing acceptance tests (TDD red phase)
+   - **Subagent Architecture**: Parallel API + E2E test generation
+   - Acceptance criteria validation checklist
+
+5. **Test Automation (`TA` / `/bmad:tea:automate`)**
+   - Expand automation coverage systematically
+   - **Subagent Architecture**: Parallel API + E2E test generation
+   - Coverage gap analysis and prioritization
+
+6. **Test Review (`RV` / `/bmad:tea:test-review`)**
+   - Comprehensive test quality audit (0-100 scoring)
+   - **Subagent Architecture**: Parallel evaluation across 5 quality dimensions
+     - Determinism
+     - Isolation
+     - Maintainability
+     - Coverage
+     - Performance
+   - Actionable improvement recommendations
+
+7. **Requirements Tracing (`TR` / `/bmad:tea:trace`)**
+   - Map requirements to test coverage
+   - Gap analysis and missing test identification
+   - Go/No-Go release gate decision
+
+8. **NFR Assessment (`NR` / `/bmad:tea:nfr-assess`)**
+   - Non-functional requirements evaluation
+   - **Subagent Architecture**: Parallel assessment across 4 NFR domains
+     - Security
+     - Performance
+     - Reliability
+     - Scalability
+   - Evidence-based scoring with recommendations
+
+#### Subagent Architecture (Phase 5)
+
+- **19 Subagent Step Files** for parallel execution:
+  - `automate`: 3 subagent files (2 parallel + aggregate)
+  - `atdd`: 3 subagent files (2 parallel + aggregate)
+  - `test-review`: 6 subagent files (5 parallel + aggregate)
+  - `nfr-assess`: 5 subagent files (4 parallel + aggregate)
+  - `trace`: Two-phase separation (coverage → gate decision)
+- **Temp File Outputs**: Each subagent writes to `/tmp/bmad-tea-*` files
+- **Aggregation Step**: Consolidates subagent results into final output
+- **Documentation**: Complete subagent architecture documentation in `docs/explanation/`
+
+#### Knowledge Base System
+
+- **35 Knowledge Fragments** organized by category:
+  - Architecture & Fixtures (5 fragments)
+  - Data & Setup (3 fragments)
+  - Network & Reliability (5 fragments)
+  - Test Execution & CI (4 fragments)
+  - Quality & Standards (4 fragments)
+  - Risk & Gates (3 fragments)
+  - Selectors & Timing (2 fragments)
+  - Feature Flags & Testing Patterns (2 fragments)
+  - Playwright-Utils Integration (6 fragments)
+- **Context Engineering**: Dynamic fragment loading per workflow
+- **CSV-Based Index**: `src/testarch/tea-index.csv` for fragment management
+- **Consistency**: Ensures standardized outputs across workflows
+
+#### Documentation
+
+- **Diataxis-Compliant Structure**: 29 markdown files across 4 categories
+  - **Tutorials**: TEA Lite 30-minute quickstart
+  - **How-To Guides**: 9 workflow guides + 4 customization guides
+  - **Explanation**: 11 concept docs (engagement models, risk-based testing, knowledge base system, etc.)
+  - **Reference**: 3 reference docs (commands, configuration, knowledge base index)
+  - **Glossary**: Comprehensive terminology reference
+- **Documentation Site**: Ready for deployment to `test-architect.bmad-method.org`
+- **Build Tools**: Documentation build pipeline, link validation, and auto-fix tools
+- **LLM Discovery**: `llms.txt` and `llms-full.txt` for AI agent consumption
+
+#### Engagement Models
+
+- **No TEA**: Continue with existing testing approach
+- **TEA Solo**: Standalone use on non-BMAD projects
+- **TEA Lite**: Fast onboarding with `automate` workflow only
+- **Integrated**: Full TEA integration with BMAD Method (Phases 3-4 + release gates)
+- **Enterprise**: Complete quality governance with all 9 workflows
+
+#### Testing & Quality
+
+- **85 Automated Tests**: Complete test coverage
+  - 52 agent schema validation tests
+  - 33 installation component tests
+- **Pre-commit Hooks**: Automated quality checks
+  - ESLint + Prettier formatting
+  - Markdownlint validation (204 files)
+  - Documentation link validation
+  - Schema validation
+- **Lint-Staged**: Auto-fix on commit for JS, YAML, JSON, and Markdown
+
+### Changed
+
+#### Breaking Changes
+
+- **Command Namespace**: Changed from `/bmad:bmm:tea:*` to `/bmad:tea:*`
+  - Old: `/bmad:bmm:tea:test-design`
+  - New: `/bmad:tea:test-design`
+- **Module Installation**: Now requires separate installation step
+  - TEA no longer included by default with BMAD Method
+  - Install via: `npx bmad-method install` → Select "Test Architect (TEA)"
+- **File Paths**: Knowledge base moved from `src/bmm/testarch/` to `src/testarch/`
+- **Agent ID**: Changed from `_bmad/bmm/tea` to `_bmad/tea/`
+- **Configuration**: Module-specific variables now in `src/module.yaml` instead of BMM config
+
+#### Improvements
+
+- **Step File Architecture**: All workflows converted to trivariate pattern
+  - `steps-c/` (Create mode) - 5-7 steps per workflow
+  - `steps-e/` (Edit mode) - 2 steps per workflow
+  - `steps-v/` (Validate mode) - 1 step per workflow
+- **Validation Reports**: Comprehensive validation with checklist scoring
+- **Documentation Links**: All internal links validated and fixed (309 → 0 broken links)
+- **Subagent Optimization**: Parallel execution for faster workflow completion
+
+### Fixed
+
+- All documentation links updated from `/docs/tea/` to `/docs/`
+- Knowledge base path references updated from BMM structure to standalone
+- Agent schema validation for module independence
+- Pre-commit hook compatibility with documentation build process
+
+### Migration Guide
+
+For users migrating from BMM-embedded TEA, see [`docs/MIGRATION.md`](docs/MIGRATION.md) for:
+
+- Command namespace updates
+- Installation instructions
+- Configuration changes
+- Path reference updates
+- Troubleshooting common issues
+
+### Documentation
+
+- Website: [test-architect.bmad-method.org](https://test-architect.bmad-method.org) (upcoming)
+- Repository: [github.com/bmad-code-org/bmad-method-test-architecture-enterprise](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)
+- Full Documentation: Available in `llms-full.txt` (~445K chars, ~111K tokens)
+
+### Technical Details
+
+- **Lines of Code**: ~20K lines (workflows, knowledge base, documentation)
+- **Step Files**: 134 total step files across 9 workflows
+- **Knowledge Fragments**: 34 reusable testing patterns
+- **Documentation Files**: 204 markdown files
+- **Test Coverage**: 85 automated tests (100% passing)
+- **Supported Frameworks**: Playwright, Cypress
+- **Node Version**: >=20.0.0
+
+---
+
+## Version History
+
+- **1.0.0** (2026-01-XX) - TEA Module Independence Release
+  - Standalone module extraction from BMAD Method
+  - 9 workflows with subagent architecture
+  - 34 knowledge base fragments
+  - Complete documentation suite
+
+---
+
+_For detailed migration instructions, see [docs/MIGRATION.md](docs/MIGRATION.md)_

package/lib/bmad-cache/tea/CONTRIBUTING.md

@@ -0,0 +1,268 @@
+# Contributing to BMad
+
+Thank you for considering contributing to the BMad project! We believe in **Human Amplification, Not Replacement** - bringing out the best thinking in both humans and AI through guided collaboration.
+
+💬 **Discord Community**: Join our [Discord server](https://discord.gg/gk8jAdXWmj) for real-time discussions:
+
+- **#bmad-development** - Technical discussions and development questions
+- **#suggestions-feedback** - Feature ideas and suggestions
+- **#report-bugs-and-issues** - Bug reports and issue discussions
+
+## Our Philosophy
+
+### BMad Core™: Universal Foundation
+
+BMad Core empowers humans and AI agents working together in true partnership across any domain through our **C.O.R.E. Framework** (Collaboration Optimized Reflection Engine):
+
+- **Collaboration**: Human-AI partnership where both contribute unique strengths
+- **Optimized**: The collaborative process refined for maximum effectiveness
+- **Reflection**: Guided thinking that helps discover better solutions and insights
+- **Engine**: The powerful framework that orchestrates specialized agents and workflows
+
+### BMad Method™: Agile AI-Driven Development
+
+The BMad Method is the flagship bmad module for agile AI-driven software development. It emphasizes thorough planning and solid architectural foundations to provide detailed context for developer agents, mirroring real-world agile best practices.
+
+### Core Principles
+
+**Partnership Over Automation** - AI agents act as expert coaches, mentors, and collaborators who amplify human capability rather than replace it.
+
+**Bidirectional Guidance** - Agents guide users through structured workflows while users push agents with advanced prompting. Both sides actively work to extract better information from each other.
+
+**Systems of Workflows** - BMad Core builds comprehensive systems of guided workflows with specialized agent teams for any domain.
+
+**Tool-Agnostic Foundation** - BMad Core remains tool-agnostic, providing stable, extensible groundwork that adapts to any domain.
+
+## What Makes a Good Contribution?
+
+Every contribution should strengthen human-AI collaboration. Ask yourself: **"Does this make humans and AI better together?"**
+
+**✅ Contributions that align:**
+
+- Enhance universal collaboration patterns
+- Improve agent personas and workflows
+- Strengthen planning and context continuity
+- Increase cross-domain accessibility
+- Add domain-specific modules leveraging BMad Core
+
+**❌ What detracts from our mission:**
+
+- Purely automated solutions that sideline humans
+- Tools that don't improve the partnership
+- Complexity that creates barriers to adoption
+- Features that fragment BMad Core's foundation
+
+## Before You Contribute
+
+### Reporting Bugs
+
+1. **Check existing issues** first to avoid duplicates
+2. **Consider discussing in Discord** (#report-bugs-and-issues channel) for quick help
+3. **Use the bug report template** when creating a new issue - it guides you through providing:
+   - Clear bug description
+   - Steps to reproduce
+   - Expected vs actual behavior
+   - Model/IDE/BMad version details
+   - Screenshots or links if applicable
+4. **Indicate if you're working on a fix** to avoid duplicate efforts
+
+### Suggesting Features or New Modules
+
+1. **Discuss first in Discord** (#suggestions-feedback channel) - the feature request template asks if you've done this
+2. **Check existing issues and discussions** to avoid duplicates
+3. **Use the feature request template** when creating an issue
+4. **Be specific** about why this feature would benefit the BMad community and strengthen human-AI collaboration
+
+### Before Starting Work
+
+⚠️ **Required before submitting PRs:**
+
+1. **For bugs**: Check if an issue exists (create one using the bug template if not)
+2. **For features**: Discuss in Discord (#suggestions-feedback) AND create a feature request issue
+3. **For large changes**: Always open an issue first to discuss alignment
+
+Please propose small, granular changes! For large or significant changes, discuss in Discord and open an issue first. This prevents wasted effort on PRs that may not align with planned changes.
+
+## Pull Request Guidelines
+
+### Which Branch?
+
+**Submit PR's to `main` branch** (critical only):
+
+- 🚨 Critical bug fixes that break basic functionality
+- 🔒 Security patches
+- 📚 Fixing dangerously incorrect documentation
+- 🐛 Bugs preventing installation or basic usage
+
+### PR Size Guidelines
+
+- **Ideal PR size**: 200-400 lines of code changes
+- **Maximum PR size**: 800 lines (excluding generated files)
+- **One feature/fix per PR**: Each PR should address a single issue or add one feature
+- **If your change is larger**: Break it into multiple smaller PRs that can be reviewed independently
+- **Related changes**: Even related changes should be separate PRs if they deliver independent value
+
+### Breaking Down Large PRs
+
+If your change exceeds 800 lines, use this checklist to split it:
+
+- [ ] Can I separate the refactoring from the feature implementation?
+- [ ] Can I introduce the new API/interface in one PR and implementation in another?
+- [ ] Can I split by file or module?
+- [ ] Can I create a base PR with shared utilities first?
+- [ ] Can I separate test additions from implementation?
+- [ ] Even if changes are related, can they deliver value independently?
+- [ ] Can these changes be merged in any order without breaking things?
+
+Example breakdown:
+
+1. PR #1: Add utility functions and types (100 lines)
+2. PR #2: Refactor existing code to use utilities (200 lines)
+3. PR #3: Implement new feature using refactored code (300 lines)
+4. PR #4: Add comprehensive tests (200 lines)
+
+**Note**: PRs #1 and #4 could be submitted simultaneously since they deliver independent value.
+
+### Pull Request Process
+
+#### New to Pull Requests?
+
+If you're new to GitHub or pull requests, here's a quick guide:
+
+1. **Fork the repository** - Click the "Fork" button on GitHub to create your own copy
+2. **Clone your fork** - `git clone https://github.com/YOUR-USERNAME/bmad-module-creative-intelligence-suite.git`
+3. **Create a new branch** - Never work on `main` directly!
+   ```bash
+   git checkout -b fix/description
+   # or
+   git checkout -b feature/description
+   ```
+4. **Make your changes** - Edit files, keeping changes small and focused
+5. **Commit your changes** - Use clear, descriptive commit messages
+   ```bash
+   git add .
+   git commit -m "fix: correct typo in README"
+   ```
+6. **Push to your fork** - `git push origin fix/description`
+7. **Create the Pull Request** - Go to your fork on GitHub and click "Compare & pull request"
+
+### PR Description Template
+
+Keep your PR description concise and focused. Use this template:
+
+```markdown
+## What
+
+[1-2 sentences describing WHAT changed]
+
+## Why
+
+[1-2 sentences explaining WHY this change is needed]
+Fixes #[issue number] (if applicable)
+
+## How
+
+## [2-3 bullets listing HOW you implemented it]
+
+-
+-
+
+## Testing
+
+[1-2 sentences on how you tested this]
+```
+
+**Maximum PR description length: 200 words** (excluding code examples if needed)
+
+### Good vs Bad PR Descriptions
+
+❌ **Bad Example:**
+
+> This revolutionary PR introduces a paradigm-shifting enhancement to the system's architecture by implementing a state-of-the-art solution that leverages cutting-edge methodologies to optimize performance metrics...
+
+✅ **Good Example:**
+
+> **What:** Added validation for agent dependency resolution
+> **Why:** Build was failing silently when agents had circular dependencies
+> **How:**
+>
+> - Added cycle detection in dependency-resolver.js
+> - Throws clear error with dependency chain
+>   **Testing:** Tested with circular deps between 3 agents
+
+### Commit Message Convention
+
+Use conventional commits format:
+
+- `feat:` New feature
+- `fix:` Bug fix
+- `docs:` Documentation only
+- `refactor:` Code change that neither fixes a bug nor adds a feature
+- `test:` Adding missing tests
+- `chore:` Changes to build process or auxiliary tools
+
+Keep commit messages under 72 characters.
+
+### Atomic Commits
+
+Each commit should represent one logical change:
+
+- **Do:** One bug fix per commit
+- **Do:** One feature addition per commit
+- **Don't:** Mix refactoring with bug fixes
+- **Don't:** Combine unrelated changes
+
+## What Makes a Good Pull Request?
+
+✅ **Good PRs:**
+
+- Change one thing at a time
+- Have clear, descriptive titles
+- Explain what and why in the description
+- Include only the files that need to change
+- Reference related issue numbers
+
+❌ **Avoid:**
+
+- Changing formatting of entire files
+- Multiple unrelated changes in one PR
+- Copying your entire project/repo into the PR
+- Changes without explanation
+- Working directly on `main` branch
+
+## Common Mistakes to Avoid
+
+1. **Don't reformat entire files** - only change what's necessary
+2. **Don't include unrelated changes** - stick to one fix/feature per PR
+3. **Don't paste code in issues** - create a proper PR instead
+4. **Don't submit your whole project** - contribute specific improvements
+
+## Prompt & Agent Guidelines
+
+- Keep dev agents lean - they need context for coding, not documentation
+- Web/planning agents can be larger with more complex tasks
+- Everything is natural language (markdown) - no code in core framework
+- Use bmad modules for domain-specific features
+- Validate YAML schemas with `npm run validate:schemas` before committing
+
+## Code of Conduct
+
+By participating in this project, you agree to abide by our Code of Conduct. We foster a collaborative, respectful environment focused on building better human-AI partnerships.
+
+## Need Help?
+
+- 💬 Join our [Discord Community](https://discord.gg/gk8jAdXWmj):
+  - **#bmad-development** - Technical questions and discussions
+  - **#suggestions-feedback** - Feature ideas and suggestions
+  - **#report-bugs-and-issues** - Get help with bugs before filing issues
+- 🐛 Report bugs using the [bug report template](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite/issues/new?template=bug_report.md)
+- 💡 Suggest features using the [feature request template](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite/issues/new?template=feature_request.md)
+- 📖 Browse the [GitHub Discussions](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite/discussions)
+
+---
+
+**Remember**: We're here to help! Don't be afraid to ask questions. Every expert was once a beginner. Together, we're building a future where humans and AI work better together.
+
+## License
+
+By contributing to this project, you agree that your contributions will be licensed under the same license as the project.

package/lib/bmad-cache/tea/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2025 BMad Code, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+TRADEMARK NOTICE:
+BMad™ , BMAD-CORE™ and BMAD-METHOD™ are trademarks of BMad Code, LLC. The use of these 
+trademarks in this software does not grant any rights to use the trademarks 
+for any other purpose.