ma-agents 2.19.2 → 2.20.1

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-trace/validation-report-20260127-095021.md

@@ -0,0 +1,73 @@
+---
+validationDate: 2026-01-27
+workflowName: testarch-trace
+workflowPath: {project-root}/src/workflows/testarch/bmad-testarch-trace
+validationStatus: COMPLETE
+completionDate: 2026-01-27 10:03:10
+---
+
+# Validation Report: testarch-trace
+
+**Validation Started:** 2026-01-27 09:50:21
+**Validator:** BMAD Workflow Validation System (Codex)
+**Standards Version:** BMAD Workflow Standards
+
+## File Structure & Size
+
+- workflow.md present: YES
+- instructions.md present: YES
+- workflow.yaml present: YES
+- step files found: 8
+
+**Step File Sizes:**
+
+- steps-c/step-01-load-context.md: 73 lines [GOOD]
+- steps-c/step-02-discover-tests.md: 62 lines [GOOD]
+- steps-c/step-03-map-criteria.md: 58 lines [GOOD]
+- steps-c/step-04-analyze-gaps.md: 57 lines [GOOD]
+- steps-c/step-05-gate-decision.md: 66 lines [GOOD]
+- steps-e/step-01-assess.md: 51 lines [GOOD]
+- steps-e/step-02-apply-edit.md: 46 lines [GOOD]
+- steps-v/step-01-validate.md: 53 lines [GOOD]
+- workflow-plan.md present: YES
+
+## Frontmatter Validation
+
+- No frontmatter violations found
+
+## Critical Path Violations
+
+- No {project-root} hardcoded paths detected in body
+- No dead relative links detected
+
+## Menu Handling Validation
+
+- No menu structures detected (linear step flow) [N/A]
+
+## Step Type Validation
+
+- Last step steps-v/step-01-validate.md has no nextStepFile (final step OK)
+- Step type validation assumes linear sequence (no branching/menu). Workflow-plan.md present for reference. [INFO]
+
+## Output Format Validation
+
+- Templates present: trace-template.md
+- Steps with outputFile in frontmatter:
+  - steps-c/step-05-gate-decision.md
+  - steps-v/step-01-validate.md
+
+## Validation Design Check
+
+- checklist.md present: YES
+- Validation steps folder (steps-v) present: YES
+
+## Instruction Style Check
+
+- All steps include STEP GOAL, MANDATORY EXECUTION RULES, EXECUTION PROTOCOLS, CONTEXT BOUNDARIES, and SUCCESS/FAILURE metrics
+
+## Summary
+
+- Validation completed: 2026-01-27 10:03:10
+- Critical issues: 0
+- Warnings: 0 (informational notes only)
+- Readiness: READY (manual review optional)

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-trace/validation-report-20260127-102401.md

@@ -0,0 +1,116 @@
+---
+validationDate: 2026-01-27
+workflowName: testarch-trace
+workflowPath: {project-root}/src/workflows/testarch/bmad-testarch-trace
+validationStatus: COMPLETE
+completionDate: 2026-01-27 10:24:01
+---
+
+# Validation Report: testarch-trace
+
+**Validation Started:** 2026-01-27 10:24:01
+**Validator:** BMAD Workflow Validation System (Codex)
+**Standards Version:** BMAD Workflow Standards
+
+## File Structure & Size
+
+- workflow.md present: YES
+- instructions.md present: YES
+- workflow.yaml present: YES
+- step files found: 8
+
+**Step File Sizes:**
+
+- steps-c/step-01-load-context.md: 72 lines [GOOD]
+- steps-c/step-02-discover-tests.md: 61 lines [GOOD]
+- steps-c/step-03-map-criteria.md: 57 lines [GOOD]
+- steps-c/step-04-analyze-gaps.md: 56 lines [GOOD]
+- steps-c/step-05-gate-decision.md: 65 lines [GOOD]
+- steps-e/step-01-assess.md: 50 lines [GOOD]
+- steps-e/step-02-apply-edit.md: 45 lines [GOOD]
+- steps-v/step-01-validate.md: 52 lines [GOOD]
+- workflow-plan.md present: YES
+
+## Frontmatter Validation
+
+- No frontmatter violations found
+
+## Critical Path Violations
+
+### Config Variables (Exceptions)
+
+Standard BMAD config variables treated as valid exceptions: bmb_creations_output_folder, communication_language, document_output_language, output_folder, planning_artifacts, project-root, project_name, test_artifacts, user_name
+
+- No {project-root} hardcoded paths detected in body
+
+- No dead relative links detected
+
+- No module path assumptions detected
+
+**Status:** ✅ PASS - No critical violations
+
+## Menu Handling Validation
+
+- No menu structures detected (linear step flow) [N/A]
+
+## Step Type Validation
+
+- steps-c/step-01-load-context.md: Init [PASS]
+- steps-c/step-02-discover-tests.md: Middle [PASS]
+- steps-c/step-03-map-criteria.md: Middle [PASS]
+- steps-c/step-04-analyze-gaps.md: Middle [PASS]
+- steps-c/step-05-gate-decision.md: Final [PASS]
+- Step type validation assumes linear sequence (no branching/menu). Workflow-plan.md present for reference. [INFO]
+
+## Output Format Validation
+
+- Templates present: trace-template.md
+- Steps with outputFile in frontmatter:
+  - steps-c/step-05-gate-decision.md
+  - steps-v/step-01-validate.md
+- checklist.md present: YES
+
+## Validation Design Check
+
+- Validation steps folder (steps-v) present: YES
+- Validation step(s) present: step-01-validate.md
+- Validation steps reference checklist data and auto-proceed
+
+## Instruction Style Check
+
+- Instruction style: Prescriptive (appropriate for TEA quality/compliance workflows)
+- Steps emphasize mandatory sequence, explicit success/failure metrics, and risk-based guidance
+
+## Collaborative Experience Check
+
+- Overall facilitation quality: GOOD
+- Steps use progressive prompts and clear role reinforcement; no laundry-list interrogation detected
+- Flow progression is clear and aligned to workflow goals
+
+## Subagent Optimization Opportunities
+
+- No high-priority subagent optimizations identified; workflow already uses step-file architecture
+- Pattern 1 (grep/regex): N/A for most steps
+- Pattern 2 (per-file analysis): already aligned to validation structure
+- Pattern 3 (data ops): minimal data file loads
+- Pattern 4 (parallel): optional for validation only
+
+## Cohesive Review
+
+- Overall assessment: GOOD
+- Flow is linear, goals are clear, and outputs map to TEA artifacts
+- Voice and tone consistent with Test Architect persona
+- Recommendation: READY (minor refinements optional)
+
+## Plan Quality Validation
+
+- Plan file present: workflow-plan.md
+- Planned steps found: 8 (all implemented)
+- Plan implementation status: Fully Implemented
+
+## Summary
+
+- Validation completed: 2026-01-27 10:24:01
+- Critical issues: 0
+- Warnings: 0 (informational notes only)
+- Readiness: READY (manual review optional)

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-trace/workflow-plan.md

@@ -0,0 +1,21 @@
+    # Workflow Plan: testarch-trace
+
+    ## Create Mode (steps-c)
+    - step-01-load-context.md
+
+- step-02-discover-tests.md
+- step-03-map-criteria.md
+- step-04-analyze-gaps.md
+- step-05-gate-decision.md
+
+  ## Validate Mode (steps-v)
+  - step-01-validate.md
+
+  ## Edit Mode (steps-e)
+  - step-01-assess.md
+  - step-02-apply-edit.md
+
+  ## Outputs
+  - {test_artifacts}/traceability-matrix.md
+
+- Gate decision summary (if evidence available)

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-trace/workflow.md

@@ -0,0 +1,41 @@
+---
+name: bmad-testarch-trace
+description: Generate traceability matrix and quality gate decision. Use when user says 'lets create traceability matrix' or 'I want to analyze test coverage'
+web_bundle: true
+---
+
+# Requirements Traceability & Quality Gate
+
+**Goal:** Generate requirements-to-tests traceability matrix, analyze coverage, and make quality gate decision (PASS/CONCERNS/FAIL/WAIVED)
+
+**Role:** You are the Master Test Architect.
+
+---
+
+## WORKFLOW ARCHITECTURE
+
+This workflow uses **tri-modal step-file architecture**:
+
+- **Create mode (steps-c/)**: primary execution flow
+- **Validate mode (steps-v/)**: validation against checklist
+- **Edit mode (steps-e/)**: revise existing outputs
+
+---
+
+## INITIALIZATION SEQUENCE
+
+### 1. Mode Determination
+
+"Welcome to the workflow. What would you like to do?"
+
+- **[C] Create** — Run the workflow
+- **[R] Resume** — Resume an interrupted workflow
+- **[V] Validate** — Validate existing outputs
+- **[E] Edit** — Edit existing outputs
+
+### 2. Route to First Step
+
+- **If C:** Load `steps-c/step-01-load-context.md`
+- **If R:** Load `steps-c/step-01b-resume.md`
+- **If V:** Load `steps-v/step-01-validate.md`
+- **If E:** Load `steps-e/step-01-assess.md`

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-trace/workflow.yaml

@@ -0,0 +1,56 @@
+# Test Architect workflow: bmad-testarch-trace
+name: bmad-testarch-trace
+# prettier-ignore
+description: 'Generate traceability matrix and quality gate decision. Use when the user says "lets create traceability matrix" or "I want to analyze test coverage"'
+
+# Critical variables from config
+config_source: "{project-root}/_bmad/tea/config.yaml"
+output_folder: "{config_source}:output_folder"
+test_artifacts: "{config_source}:test_artifacts"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+date: system-generated
+
+# Workflow components
+installed_path: "."
+instructions: "./instructions.md"
+validation: "./checklist.md"
+template: "./trace-template.md"
+
+# Variables and inputs
+variables:
+  # Directory paths
+  test_dir: "{project-root}/tests" # Root test directory
+  source_dir: "{project-root}" # Source code directory (customize if needed, e.g., {project-root}/src or {project-root}/lib)
+
+  # Workflow behavior
+  coverage_levels: "e2e,api,component,unit" # Which test levels to trace
+  gate_type: "story" # story | epic | release | hotfix - determines gate scope
+  decision_mode: "deterministic" # deterministic (rule-based) | manual (team decision)
+
+# Output configuration
+default_output_file: "{test_artifacts}/traceability-matrix.md"
+
+# Required tools
+required_tools:
+  - read_file # Read story, test files, BMad artifacts
+  - write_file # Create traceability matrix, gate YAML
+  - list_files # Discover test files
+  - search_repo # Find tests by test ID, describe blocks
+  - glob # Find test files matching patterns
+
+tags:
+  - qa
+  - traceability
+  - test-architect
+  - coverage
+  - requirements
+  - gate
+  - decision
+  - release
+
+execution_hints:
+  interactive: false # Minimize prompts
+  autonomous: true # Proceed without user input unless blocked
+  iterative: true

package/lib/bmad-cache/tea/test/README.md

@@ -0,0 +1,23 @@
+# Agent Schema Validation Test Suite
+
+Comprehensive test coverage for the BMAD agent schema validation system.
+
+## Overview
+
+This test suite validates the Zod-based schema validator (`tools/schema/agent.js`) that ensures all `*.agent.yaml` files conform to the BMAD agent specification.
+
+## Quick Start
+
+```bash
+# Run all tests
+npm test
+
+# Run with coverage report
+npm run test:coverage
+
+# Run CLI integration tests
+./test/test-cli-integration.sh
+
+# Validate actual agent files
+npm run validate:schemas
+```

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/critical-actions/actions-as-string.agent.yaml

@@ -0,0 +1,27 @@
+# Test: critical_actions as non-array
+# Expected: FAIL
+# Error code: invalid_type
+# Error path: agent.critical_actions
+# Error expected: array
+
+agent:
+  metadata:
+    id: actions-string
+    name: Actions String
+    title: Actions String
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  critical_actions: This should be an array
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/critical-actions/empty-string-in-actions.agent.yaml

@@ -0,0 +1,30 @@
+# Test: critical_actions with empty strings
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.critical_actions[1]
+# Error message: agent.critical_actions[] must be a non-empty string
+
+agent:
+  metadata:
+    id: empty-action-string
+    name: Empty Action String
+    title: Empty Action String
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  critical_actions:
+    - Valid action
+    - "   "
+    - Another valid action
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu/empty-menu.agent.yaml

@@ -0,0 +1,22 @@
+# Test: Empty menu array
+# Expected: FAIL
+# Error code: too_small
+# Error path: agent.menu
+# Error minimum: 1
+
+agent:
+  metadata:
+    id: empty-menu
+    name: Empty Menu
+    title: Empty Menu
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu: []

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu/missing-menu.agent.yaml

@@ -0,0 +1,20 @@
+# Test: Missing menu field
+# Expected: FAIL
+# Error code: invalid_type
+# Error path: agent.menu
+# Error expected: array
+
+agent:
+  metadata:
+    id: missing-menu
+    name: Missing Menu
+    title: Missing Menu
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu-commands/empty-command-target.agent.yaml

@@ -0,0 +1,25 @@
+# Test: Menu item with empty string command target
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.menu[0].action
+# Error message: agent.menu[].action must be a non-empty string
+
+agent:
+  metadata:
+    id: empty-command
+    name: Empty Command Target
+    title: Empty Command
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: "   "

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu-commands/no-command-target.agent.yaml

@@ -0,0 +1,24 @@
+# Test: Menu item with no command target fields
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.menu[0]
+# Error message: agent.menu[] entries must include at least one command target field
+
+agent:
+  metadata:
+    id: no-command
+    name: No Command Target
+    title: No Command
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: help
+      description: Show help but no command target

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu-triggers/camel-case.agent.yaml

@@ -0,0 +1,25 @@
+# Test: CamelCase trigger
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.menu[0].trigger
+# Error message: agent.menu[].trigger must be kebab-case (lowercase words separated by hyphen)
+
+agent:
+  metadata:
+    id: camel-case-trigger
+    name: CamelCase Trigger
+    title: CamelCase
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: listTasks
+      description: Invalid CamelCase trigger
+      action: list_tasks

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu-triggers/compound-invalid-format.agent.yaml

@@ -0,0 +1,25 @@
+# Test: Compound trigger with invalid format
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.menu[0].trigger
+# Error message: agent.menu[].trigger compound format error: invalid compound trigger format
+
+agent:
+  metadata:
+    id: compound-invalid-format
+    name: Invalid Format
+    title: Invalid Format Test
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: TS or tech-spec
+      description: Missing fuzzy match clause
+      action: test

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml

@@ -0,0 +1,25 @@
+# Test: Compound trigger with old format (no longer supported)
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.menu[0].trigger
+# Error message: agent.menu[].trigger compound format error: invalid compound trigger format
+
+agent:
+  metadata:
+    id: compound-mismatched-kebab
+    name: Old Format
+    title: Old Format Test
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: TS or tech-spec or fuzzy match on tech-spec
+      description: Old format with middle kebab-case (no longer supported)
+      action: test

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu-triggers/duplicate-triggers.agent.yaml

@@ -0,0 +1,31 @@
+# Test: Duplicate triggers within same agent
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.menu[2].trigger
+# Error message: agent.menu[].trigger duplicates "help" within the same agent
+
+agent:
+  metadata:
+    id: duplicate-triggers
+    name: Duplicate Triggers
+    title: Duplicate
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: help
+      description: First help command
+      action: display_help
+    - trigger: list-tasks
+      description: List tasks
+      action: list_tasks
+    - trigger: help
+      description: Duplicate help command
+      action: show_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu-triggers/empty-trigger.agent.yaml

@@ -0,0 +1,25 @@
+# Test: Empty trigger string
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.menu[0].trigger
+# Error message: agent.menu[].trigger must be a non-empty string
+
+agent:
+  metadata:
+    id: empty-trigger
+    name: Empty Trigger
+    title: Empty
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: "   "
+      description: Empty trigger
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu-triggers/leading-asterisk.agent.yaml

@@ -0,0 +1,25 @@
+# Test: Trigger with leading asterisk
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.menu[0].trigger
+# Error message: agent.menu[].trigger must be kebab-case (lowercase words separated by hyphen)
+
+agent:
+  metadata:
+    id: asterisk-trigger
+    name: Asterisk Trigger
+    title: Asterisk
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: "*help"
+      description: Invalid trigger with asterisk
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu-triggers/snake-case.agent.yaml

@@ -0,0 +1,25 @@
+# Test: Snake_case trigger
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.menu[0].trigger
+# Error message: agent.menu[].trigger must be kebab-case (lowercase words separated by hyphen)
+
+agent:
+  metadata:
+    id: snake-case-trigger
+    name: Snake Case Trigger
+    title: Snake Case
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: list_tasks
+      description: Invalid snake_case trigger
+      action: list_tasks