bmad-method-test-architecture-enterprise 1.3.1 → 1.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (24) hide show
  1. package/docs/explanation/tea-overview.md +1 -1
  2. package/docs/how-to/customization/configure-browser-automation.md +22 -18
  3. package/docs/reference/troubleshooting.md +2 -1
  4. package/package.json +1 -1
  5. package/release_notes.md +8 -9
  6. package/src/module.yaml +1 -1
  7. package/src/testarch/knowledge/pact-mcp.md +15 -13
  8. package/src/workflows/testarch/atdd/validation-report-20260127-095021.md +1 -1
  9. package/src/workflows/testarch/atdd/validation-report-20260127-102401.md +1 -1
  10. package/src/workflows/testarch/automate/validation-report-20260127-095021.md +1 -1
  11. package/src/workflows/testarch/automate/validation-report-20260127-102401.md +1 -1
  12. package/src/workflows/testarch/ci/validation-report-20260127-095021.md +1 -1
  13. package/src/workflows/testarch/ci/validation-report-20260127-102401.md +1 -1
  14. package/src/workflows/testarch/framework/validation-report-20260127-095021.md +1 -1
  15. package/src/workflows/testarch/framework/validation-report-20260127-102401.md +1 -1
  16. package/src/workflows/testarch/nfr-assess/validation-report-20260127-095021.md +1 -1
  17. package/src/workflows/testarch/nfr-assess/validation-report-20260127-102401.md +1 -1
  18. package/src/workflows/testarch/teach-me-testing/workflow-plan-teach-me-testing.md +6 -6
  19. package/src/workflows/testarch/test-design/validation-report-20260127-095021.md +1 -1
  20. package/src/workflows/testarch/test-design/validation-report-20260127-102401.md +1 -1
  21. package/src/workflows/testarch/test-review/validation-report-20260127-095021.md +1 -1
  22. package/src/workflows/testarch/test-review/validation-report-20260127-102401.md +1 -1
  23. package/src/workflows/testarch/trace/validation-report-20260127-095021.md +1 -1
  24. package/src/workflows/testarch/trace/validation-report-20260127-102401.md +1 -1
@@ -396,7 +396,7 @@ Optional MCP integration for design-time broker interaction in contract testing
396
396
  **Setup:**
397
397
 
398
398
  - Install: `npm install -g @smartbear/mcp` (or use `npx -y @smartbear/mcp@latest`)
399
- - Claude Code example: `claude mcp add --transport stdio smartbear -- npx -y @smartbear/mcp@latest`
399
+ - Claude Code (global): `claude mcp add-json -s user smartbear '{"type":"stdio","command":"npx","args":["-y","@smartbear/mcp@latest"],"env":{"PACT_BROKER_BASE_URL":"...","PACT_BROKER_TOKEN":"..."}}'`
400
400
  - Required broker env vars: `PACT_BROKER_BASE_URL` and token/basic-auth credentials
401
401
 
402
402
  **Which workflows benefit:**
@@ -43,14 +43,17 @@ Add these MCP server entries to your tool's configuration file:
43
43
  {
44
44
  "mcpServers": {
45
45
  "playwright": {
46
+ "type": "stdio",
46
47
  "command": "npx",
47
- "args": ["@playwright/mcp@latest"]
48
+ "args": ["-y", "@playwright/mcp@latest"]
48
49
  },
49
50
  "playwright-test": {
51
+ "type": "stdio",
50
52
  "command": "npx",
51
53
  "args": ["playwright", "run-test-mcp-server"]
52
54
  },
53
55
  "smartbear": {
56
+ "type": "stdio",
54
57
  "command": "npx",
55
58
  "args": ["-y", "@smartbear/mcp@latest"],
56
59
  "env": {
@@ -66,31 +69,32 @@ The `smartbear` server is optional — only needed if you use the [Pact MCP inte
66
69
 
67
70
  #### Where to put the config
68
71
 
69
- | Tool | Config File | Format |
70
- | ----------- | ------------------------------------- | ---------------------- |
71
- | Claude Code | `~/.claude.json` | JSON (`mcpServers`) |
72
- | Codex | `~/.codex/config.toml` | TOML (`[mcp_servers]`) |
73
- | Gemini CLI | `~/.gemini/settings.json` | JSON (`mcpServers`) |
74
- | Cursor | `~/.cursor/mcp.json` | JSON (`mcpServers`) |
75
- | Windsurf | `~/.codeium/windsurf/mcp_config.json` | JSON (`mcpServers`) |
72
+ | Tool | Config File | Format |
73
+ | ----------------- | ------------------------------------- | ---------------------- |
74
+ | Claude Code | `~/.claude.json` | JSON (`mcpServers`) |
75
+ | Codex | `~/.codex/config.toml` | TOML (`[mcp_servers]`) |
76
+ | Gemini CLI | `~/.gemini/settings.json` | JSON (`mcpServers`) |
77
+ | Cursor | `~/.cursor/mcp.json` | JSON (`mcpServers`) |
78
+ | Windsurf | `~/.codeium/windsurf/mcp_config.json` | JSON (`mcpServers`) |
79
+ | VS Code (Copilot) | `.vscode/mcp.json` | JSON (`servers`) |
80
+
81
+ > **Claude Code tip**: Prefer the `claude mcp add` CLI over manual JSON editing — it sets the correct `type` field and validates the config. Use `-s user` for global (all projects) or omit for per-project (default).
76
82
 
77
83
  #### CLI shortcuts
78
84
 
79
85
  Claude Code and Codex support adding MCP servers from the command line:
80
86
 
81
87
  ```bash
82
- # Claude Code — Playwright
83
- claude mcp add playwright -- npx @playwright/mcp@latest
84
- claude mcp add playwright-test -- npx playwright run-test-mcp-server
88
+ # Claude Code — Playwright (use -s user for global, omit for per-project)
89
+ claude mcp add -s user --transport stdio playwright -- npx -y @playwright/mcp@latest
90
+ claude mcp add -s user --transport stdio playwright-test -- npx playwright run-test-mcp-server
85
91
 
86
- # Claude Code — SmartBear (Pact)
87
- claude mcp add smartbear --scope user \
88
- -e PACT_BROKER_BASE_URL=https://{tenant}.pactflow.io \
89
- -e PACT_BROKER_TOKEN=<your-token> \
90
- -- npx -y @smartbear/mcp@latest
92
+ # Claude Code — SmartBear (Pact) — use add-json for servers with env vars
93
+ claude mcp add-json -s user smartbear \
94
+ '{"type":"stdio","command":"npx","args":["-y","@smartbear/mcp@latest"],"env":{"PACT_BROKER_BASE_URL":"https://{tenant}.pactflow.io","PACT_BROKER_TOKEN":"<your-token>"}}'
91
95
 
92
96
  # Codex — Playwright
93
- codex mcp add playwright -- npx @playwright/mcp@latest
97
+ codex mcp add playwright -- npx -y @playwright/mcp@latest
94
98
  codex mcp add playwright-test -- npx playwright run-test-mcp-server
95
99
 
96
100
  # Codex — SmartBear (Pact)
@@ -104,7 +108,7 @@ Codex uses TOML instead of JSON. If editing the config file manually:
104
108
  ```toml
105
109
  [mcp_servers.playwright]
106
110
  command = "npx"
107
- args = ["@playwright/mcp@latest"]
111
+ args = ["-y", "@playwright/mcp@latest"]
108
112
 
109
113
  [mcp_servers.playwright-test]
110
114
  command = "npx"
@@ -536,8 +536,9 @@ If the BMAD installer can run but cannot fetch the Test Architect module from Gi
536
536
  {
537
537
  "mcpServers": {
538
538
  "playwright": {
539
+ "type": "stdio",
539
540
  "command": "npx",
540
- "args": ["@playwright/mcp@latest"]
541
+ "args": ["-y", "@playwright/mcp@latest"]
541
542
  }
542
543
  }
543
544
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "bmad-method-test-architecture-enterprise",
4
- "version": "1.3.1",
4
+ "version": "1.3.2",
5
5
  "description": "Master Test Architect for quality strategy, test automation, and release gates",
6
6
  "keywords": [
7
7
  "bmad",
package/release_notes.md CHANGED
@@ -1,13 +1,12 @@
1
- ## 🚀 What's New in v1.3.1
1
+ ## 🚀 What's New in v1.3.2
2
2
 
3
- ### 📦 Other Changes
4
- - docs: update pactjs utils
5
- - addressed review commments
6
- - Merge pull request #42 from bmad-code-org/docs/update-pactjs-utils
7
- - Merge pull request #43 from bmad-code-org/chore/refresh-lock
3
+ ### 🐛 Bug Fixes
4
+ - fix: issue 45
8
5
 
9
- ### 🔧 Maintenance
10
- - chore: refresh lock
6
+ ### 📦 Other Changes
7
+ - docs:update mcp settings
8
+ - Merge pull request #44 from bmad-code-org/docs/update-mcp-settings
9
+ - Merge pull request #46 from bmad-code-org/fix/issue-45
11
10
 
12
11
 
13
12
  ## 📦 Installation
@@ -17,4 +16,4 @@ npx bmad-method install
17
16
  # Select "Test Architect" from module menu
18
17
  ```
19
18
 
20
- **Full Changelog**: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/compare/v1.3.0...v1.3.1
19
+ **Full Changelog**: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/compare/v1.3.1...v1.3.2
package/src/module.yaml CHANGED
@@ -234,7 +234,7 @@ post-install-notes:
234
234
  mcp: |
235
235
  SmartBear MCP Setup (PactFlow integration):
236
236
  Install: npm install -g @smartbear/mcp
237
- Claude Code: claude mcp add --transport stdio smartbear -- npx -y @smartbear/mcp@latest
237
+ Claude Code (global): claude mcp add-json -s user smartbear '{"type":"stdio","command":"npx","args":["-y","@smartbear/mcp@latest"],"env":{"PACT_BROKER_BASE_URL":"https://{tenant}.pactflow.io","PACT_BROKER_TOKEN":"<your-api-token>"}}'
238
238
  Required env vars:
239
239
  PACT_BROKER_BASE_URL=https://{tenant}.pactflow.io
240
240
  PACT_BROKER_TOKEN=<your-api-token>
@@ -37,22 +37,23 @@ Use the SmartBear MCP server to enable AI agent interaction with PactFlow/Pact B
37
37
 
38
38
  ### Config file locations
39
39
 
40
- | Tool | Global Config File | Format |
41
- | ----------- | ------------------------------------- | ---------------------- |
42
- | Claude Code | `~/.claude.json` | JSON (`mcpServers`) |
43
- | Codex | `~/.codex/config.toml` | TOML (`[mcp_servers]`) |
44
- | Gemini CLI | `~/.gemini/settings.json` | JSON (`mcpServers`) |
45
- | Cursor | `~/.cursor/mcp.json` | JSON (`mcpServers`) |
46
- | Windsurf | `~/.codeium/windsurf/mcp_config.json` | JSON (`mcpServers`) |
40
+ | Tool | Global Config File | Format |
41
+ | ----------------- | ------------------------------------- | ---------------------- |
42
+ | Claude Code | `~/.claude.json` | JSON (`mcpServers`) |
43
+ | Codex | `~/.codex/config.toml` | TOML (`[mcp_servers]`) |
44
+ | Gemini CLI | `~/.gemini/settings.json` | JSON (`mcpServers`) |
45
+ | Cursor | `~/.cursor/mcp.json` | JSON (`mcpServers`) |
46
+ | Windsurf | `~/.codeium/windsurf/mcp_config.json` | JSON (`mcpServers`) |
47
+ | VS Code (Copilot) | `.vscode/mcp.json` | JSON (`servers`) |
48
+
49
+ > **Claude Code tip**: Prefer the `claude mcp add` CLI over manual JSON editing. Use `-s user` for global (all projects) or omit for per-project (default).
47
50
 
48
51
  ### CLI shortcuts (Claude Code and Codex)
49
52
 
50
53
  ```bash
51
- # Claude Code
52
- claude mcp add smartbear --scope user \
53
- -e PACT_BROKER_BASE_URL=https://{tenant}.pactflow.io \
54
- -e PACT_BROKER_TOKEN=<your-token> \
55
- -- npx -y @smartbear/mcp@latest
54
+ # Claude Code — use add-json for servers with env vars (-s user = global)
55
+ claude mcp add-json -s user smartbear \
56
+ '{"type":"stdio","command":"npx","args":["-y","@smartbear/mcp@latest"],"env":{"PACT_BROKER_BASE_URL":"https://{tenant}.pactflow.io","PACT_BROKER_TOKEN":"<your-token>"}}'
56
57
 
57
58
  # Codex
58
59
  codex mcp add smartbear -- npx -y @smartbear/mcp@latest
@@ -66,6 +67,7 @@ Add a `"smartbear"` entry to the `mcpServers` object in the config file for your
66
67
  {
67
68
  "mcpServers": {
68
69
  "smartbear": {
70
+ "type": "stdio",
69
71
  "command": "npx",
70
72
  "args": ["-y", "@smartbear/mcp@latest"],
71
73
  "env": {
@@ -95,7 +97,7 @@ Note the key is `mcp_servers` (underscored), not `mcpServers`.
95
97
 
96
98
  ### VS Code (GitHub Copilot)
97
99
 
98
- Add to `.vscode/mcp.json`:
100
+ Add to `.vscode/mcp.json` (note: uses `servers` key, not `mcpServers`):
99
101
 
100
102
  ```json
101
103
  {
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-atdd
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/atdd
4
+ workflowPath: {project-root}/src/workflows/testarch/atdd
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:03:10
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-atdd
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/atdd
4
+ workflowPath: {project-root}/src/workflows/testarch/atdd
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:24:01
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-automate
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/automate
4
+ workflowPath: {project-root}/src/workflows/testarch/automate
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:03:10
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-automate
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/automate
4
+ workflowPath: {project-root}/src/workflows/testarch/automate
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:24:01
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-ci
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/ci
4
+ workflowPath: {project-root}/src/workflows/testarch/ci
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:03:10
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-ci
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/ci
4
+ workflowPath: {project-root}/src/workflows/testarch/ci
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:24:01
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-framework
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/framework
4
+ workflowPath: {project-root}/src/workflows/testarch/framework
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:03:10
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-framework
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/framework
4
+ workflowPath: {project-root}/src/workflows/testarch/framework
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:24:01
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-nfr
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/nfr-assess
4
+ workflowPath: {project-root}/src/workflows/testarch/nfr-assess
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:03:10
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-nfr
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/nfr-assess
4
+ workflowPath: {project-root}/src/workflows/testarch/nfr-assess
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:24:01
7
7
  ---
@@ -60,7 +60,7 @@ Create an ongoing learning companion that teaches testing progressively through
60
60
  ## Classification Decisions
61
61
 
62
62
  **Workflow Name:** teach-me-testing
63
- **Target Path:** /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/teach-me-testing/
63
+ **Target Path:** {project-root}/src/workflows/testarch/teach-me-testing/
64
64
 
65
65
  **4 Key Decisions:**
66
66
 
@@ -501,7 +501,7 @@ teach-me-testing/
501
501
  └── checklist.md ✓ Created
502
502
  ```
503
503
 
504
- **Location:** /Users/murat.ozcan/opensource/bmad-playground/\_bmad-output/bmb-creations/workflows/teach-me-testing/
504
+ **Location:** {external-project-root}/\_bmad-output/bmb-creations/workflows/teach-me-testing/
505
505
 
506
506
  **Configuration:**
507
507
 
@@ -924,16 +924,16 @@ teach-me-testing/
924
924
  **DEPLOYMENT:** Move workflow from staging to TEA module
925
925
 
926
926
  **Source (Staging):**
927
- `/Users/murat.ozcan/opensource/bmad-playground/_bmad-output/bmb-creations/workflows/teach-me-testing/`
927
+ `{external-project-root}/_bmad-output/bmb-creations/workflows/teach-me-testing/`
928
928
 
929
929
  **Target (Production):**
930
- `/Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/teach-me-testing/`
930
+ `{project-root}/src/workflows/testarch/teach-me-testing/`
931
931
 
932
932
  **Command:**
933
933
 
934
934
  ```bash
935
- cp -r /Users/murat.ozcan/opensource/bmad-playground/_bmad-output/bmb-creations/workflows/teach-me-testing \
936
- /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/
935
+ cp -r {external-project-root}/_bmad-output/bmb-creations/workflows/teach-me-testing \
936
+ {project-root}/src/workflows/testarch/
937
937
  ```
938
938
 
939
939
  **After deployment:**
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-test-design
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/test-design
4
+ workflowPath: {project-root}/src/workflows/testarch/test-design
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:03:10
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-test-design
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/test-design
4
+ workflowPath: {project-root}/src/workflows/testarch/test-design
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:24:01
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-test-review
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/test-review
4
+ workflowPath: {project-root}/src/workflows/testarch/test-review
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:03:10
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-test-review
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/test-review
4
+ workflowPath: {project-root}/src/workflows/testarch/test-review
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:24:01
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-trace
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/trace
4
+ workflowPath: {project-root}/src/workflows/testarch/trace
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:03:10
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  validationDate: 2026-01-27
3
3
  workflowName: testarch-trace
4
- workflowPath: /Users/murat.ozcan/opensource/bmad-method-test-architecture-enterprise/src/workflows/testarch/trace
4
+ workflowPath: {project-root}/src/workflows/testarch/trace
5
5
  validationStatus: COMPLETE
6
6
  completionDate: 2026-01-27 10:24:01
7
7
  ---