bmad-method-test-architecture-enterprise 2.0.4-next.3 → 3.0.0

package/.claude-plugin/marketplace.json

@@ -30,22 +30,22 @@
     {
       "name": "bmad-method-test-architecture-enterprise",
       "source": "./",
-      "description": "Master Test Architect module for quality strategy, test generation in red and expand modes with automatic run-and-heal, combined framework and CI setup, CI/CD quality gates, and structured testing education. The CI and ATDD commands remain available with existing customizations. Part of the BMad Method ecosystem.",
-      "version": "2.0.4-next.3",
+      "description": "Master Test Architect module for quality strategy, test generation in red and expand modes with automatic run-and-heal, combined framework and CI setup, CI/CD quality gates, and structured testing education. Existing CI and ATDD customizations can be migrated to the new skill names. Part of the BMad Method ecosystem.",
+      "version": "3.0.0",
       "author": {
         "name": "Murat K Ozcan (TEA Creator) & Brian (BMad) Madison"
       },
       "skills": [
         "./skills/bmod-tea",
         "./skills/bmad-tea",
-        "./skills/bmad-testarch-automate",
-        "./skills/bmad-testarch-evaluate",
-        "./skills/bmad-testarch-framework",
-        "./skills/bmad-testarch-nfr",
-        "./skills/bmad-testarch-test-design",
-        "./skills/bmad-testarch-test-review",
-        "./skills/bmad-testarch-trace",
-        "./skills/bmad-teach-me-testing"
+        "./skills/bmad-tea-automate",
+        "./skills/bmad-tea-evaluate",
+        "./skills/bmad-tea-framework",
+        "./skills/bmad-tea-nfr",
+        "./skills/bmad-tea-test-design",
+        "./skills/bmad-tea-test-review",
+        "./skills/bmad-tea-trace",
+        "./skills/bmad-tea-teach-me-testing"
       ]
     }
   ]

package/README.md

@@ -46,37 +46,52 @@ To install a tagged release, replace `<version>` with the release number:
 npx skills add https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/v<version>/skills
 ```
 
+### Upgrading to 3.0
+
+The eight direct workflow commands now share the `bmad-tea-*` prefix. Replace `bmad-testarch-automate`, `-evaluate`, `-framework`, `-nfr`, `-test-design`, `-test-review`, and `-trace` with the same suffix under `bmad-tea-`. Replace `bmad-teach-me-testing` with `bmad-tea-teach-me-testing`. The 3.0 package does not publish the old slash commands. The `bmad-tea` agent, `bmod-tea` module, menu codes, and `tea-*` CLI executables keep their names.
+
+After installing 3.0, move project customizations to the new names:
+
+```bash
+npx --package=bmad-method-test-architecture-enterprise@3 tea-migrate-customizations --project-root . --check
+npx --package=bmad-method-test-architecture-enterprise@3 tea-migrate-customizations --project-root .
+```
+
+This includes old CI and ATDD customization files and old skill references in custom `bmad-tea` agent menus. The command moves old-only files with their comments and permissions intact. When both old and new filenames exist, it reports both paths and asks for a manual merge so no comments or values are lost. Resolve the reported files, then rerun the command. See the [configuration reference](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/configuration/) for details.
+
+An existing host may retain the old skill folders after installing 3.0. Check the host's project and global skills folders, back up any edits in the old folders, and move those eight folders out of skill discovery. The [troubleshooting guide](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/troubleshooting/#old-slash-commands-still-appear-after-30) lists the exact folders and a safe cleanup sequence. Restart the host so its command list refreshes.
+
 <a id="start-with-one-workflow"></a>
 
 ## Start with one skill
 
 Eight commands start the eight workflows: Framework includes CI setup; Automate includes red and expand modes.
 
-In Claude Code, Cursor, and Windsurf, type `/bmad-testarch-test-design` in chat.
-In Codex, type `$bmad-testarch-test-design`.
+In Claude Code, Cursor, and Windsurf, type `/bmad-tea-test-design` in chat.
+In Codex, type `$bmad-tea-test-design`.
 You can also load `/bmad-tea` or `$bmad-tea` and choose a menu code.
 Each skill can run directly in a fresh session.
 
 | Skill                                                                                                                           | Command                      | Menu | Use it to                                            |
 | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ---- | ---------------------------------------------------- |
-| [Automate](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-automate/)             | `/bmad-testarch-automate`    | TA   | Generate red acceptance scaffolds or expand coverage |
-| [Test Review](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-review/)       | `/bmad-testarch-test-review` | RV   | Audit test quality and score findings                |
-| [Test Design](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-design/)       | `/bmad-testarch-test-design` | TD   | Plan risks, coverage, and NFR evidence               |
-| [Framework](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/setup-test-framework/)    | `/bmad-testarch-framework`   | TF   | Set up a test framework, CI, or both                 |
-| [NFR](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-nfr-assess/)                | `/bmad-testarch-nfr`         | NR   | Audit implemented NFR evidence                       |
-| [Trace](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-trace/)                   | `/bmad-testarch-trace`       | TR   | Map requirements to tests and decide a release gate  |
-| [Teach Me Testing](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/teach-me-testing/) | `/bmad-teach-me-testing`     | TMT  | Learn testing through seven sessions                 |
+| [Automate](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-automate/)             | `/bmad-tea-automate`         | TA   | Generate red acceptance scaffolds or expand coverage |
+| [Test Review](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-review/)       | `/bmad-tea-test-review`      | RV   | Audit test quality and score findings                |
+| [Test Design](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-design/)       | `/bmad-tea-test-design`      | TD   | Plan risks, coverage, and NFR evidence               |
+| [Framework](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/setup-test-framework/)    | `/bmad-tea-framework`        | TF   | Set up a test framework, CI, or both                 |
+| [NFR](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-nfr-assess/)                | `/bmad-tea-nfr`              | NR   | Audit implemented NFR evidence                       |
+| [Trace](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-trace/)                   | `/bmad-tea-trace`            | TR   | Map requirements to tests and decide a release gate  |
+| [Teach Me Testing](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/teach-me-testing/) | `/bmad-tea-teach-me-testing` | TMT  | Learn testing through seven sessions                 |
 
 Evaluate:
 
-- [Evaluate](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/tutorials/evaluate-your-first-skill/): `/bmad-testarch-evaluate`, menu `EV`. Build and run a behavioral evaluation.
+- [Evaluate](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/tutorials/evaluate-your-first-skill/): `/bmad-tea-evaluate`, menu `EV`. Build and run a behavioral evaluation.
 
-Framework and CI setup share one skill, `bmad-testarch-framework`.
+Framework and CI setup share one skill, `bmad-tea-framework`.
 Ask for framework only, CI only, or both; TEA infers the scope from your prompt and asks "Do you want CI too?" once when CI scope is unclear in an interactive session. An unattended request with unclear scope runs framework setup only and states that CI was excluded.
-Request CI setup through `/bmad-testarch-framework` or the agent's `CI` menu code. Existing CI customizations remain usable.
+Request CI setup through `/bmad-tea-framework` or the agent's `CI` menu code. Migrated CI customizations remain usable.
 Create, Resume, Validate, and Edit remain available for the selected setup scope.
 
-Automation uses `red` mode before implementation and `expand` mode for existing code. Request red mode through `/bmad-testarch-automate` or the agent's `AT` menu code; the direct command defaults to expand. Existing customization files and saved progress remain usable. Create runs execute the generated tests and repair test issues for up to three rounds. Red confirms the intended missing behavior; expand aims for passing coverage and reports product defects.
+Automation uses `red` mode before implementation and `expand` mode for existing code. Request red mode through `/bmad-tea-automate` or the agent's `AT` menu code; the direct command defaults to expand. Migrated customization files and saved progress remain usable. Create runs execute the generated tests and repair test issues for up to three rounds. Red confirms the intended missing behavior; expand aims for passing coverage and reports product defects.
 
 For Codex, replace the leading `/` in the table with `$`.
 The agent menu also accepts `GATE` to route you through test review, NFR evidence audit, and trace Phase 2.
@@ -113,6 +128,7 @@ It requires Node.js 22.20.0 or later:
 npm install --save-dev bmad-method-test-architecture-enterprise
 ```
 
+- [`tea-teach`](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/tea-teach-cli/) teaches one learner turn and keeps conversation and session progress.
 - [`tea-test-review`](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/tea-test-review-cli/) runs the review skill against changed tests and returns a gate verdict.
 - [`tea-framework`](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/tea-framework-cli/) creates, resumes, validates, and edits test framework and CI setup with retained run evidence.
 - [`tea-trace`](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/tea-trace-cli/) maps requirements to existing evidence and returns a coverage gate.

package/cli/atdd-red-check.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * tea-atdd-red-check — activates and executes the scaffolds
- * `bmad-testarch-atdd` wrote, and reports what actually happened.
+ * `bmad-tea-atdd` wrote, and reports what actually happened.
  *
  * This is the deterministic half of the ATDD suite, and it carries no vendor
  * knowledge at all: it never calls a model, never resolves a credential, and

package/cli/atdd-runner.js

@@ -3,7 +3,7 @@
  * tea-atdd-runner — the command the ATDD behavioral contract names for
  * generation.
  *
- * `bmad-testarch-atdd` reads a story's acceptance criteria and writes red-phase
+ * `bmad-tea-atdd` reads a story's acceptance criteria and writes red-phase
  * test scaffolds under the project's `tests/` directory, one deliverable this
  * eval measures by executing rather than reading. Generation and execution are
  * two separate commands: this one drives the workflow and leaves the scaffolds

package/cli/automate.js

@@ -135,11 +135,11 @@ async function main(argv) {
     if (options.projectSkill) {
       const candidates = ['.claude/skills', '.agents/skills', 'skills', '_bmad/tea/workflows/testarch'];
       options.skillRoot = candidates
-        .map((directory) => path.join(root, directory, 'bmad-testarch-automate'))
+        .map((directory) => path.join(root, directory, 'bmad-tea-automate'))
         .find((candidate) => fs.existsSync(path.join(candidate, 'SKILL.md')));
-      if (!options.skillRoot) throw new Error('project-installed bmad-testarch-automate skill is missing');
+      if (!options.skillRoot) throw new Error('project-installed bmad-tea-automate skill is missing');
     }
-    skillRoot = resolveWorkflowSkill({ projectRoot: root, skillName: 'bmad-testarch-automate', skillRoot: options.skillRoot });
+    skillRoot = resolveWorkflowSkill({ projectRoot: root, skillName: 'bmad-tea-automate', skillRoot: options.skillRoot });
     if (!fs.existsSync(path.join(skillRoot, '..', 'bmod-tea', 'knowledge', 'tea-index.csv')))
       throw new Error('the selected skill has no sibling bmod-tea knowledge base');
     if (options.story) story = artifactPath(root, options.story, '--story');

package/cli/ci-runner.js

@@ -2,7 +2,7 @@
 /**
  * tea-ci-runner: the command the CI behavioral contract names.
  *
- * `bmad-testarch-ci` scaffolds a pipeline for the project it is run in and
+ * `bmad-tea-ci` scaffolds a pipeline for the project it is run in and
  * writes one deliverable a linter can hold to account, the platform's own
  * workflow file, which for GitHub Actions is `.github/workflows/test.yml`.
  * Measuring that needs a command to point at, and this file is that command.

package/cli/lib/automate-prompt.js

@@ -27,7 +27,7 @@ function resolveGenerationConfig(projectRoot, checkpointPath, operation, skillRo
   };
   if (!['none', 'auto', 'cli', 'mcp'].includes(tea.tea_browser_automation))
     throw new Error('tea_browser_automation must be none, auto, cli or mcp');
-  const namespace = mode === 'red' ? 'bmad-testarch-atdd' : 'bmad-testarch-automate';
+  const namespace = mode === 'red' ? 'bmad-tea-atdd' : 'bmad-tea-automate';
   const sibling = path.join(skillRoot, '..', namespace, 'customize.toml');
   const defaultsPath =
     mode === 'red' && !fs.existsSync(sibling)

package/cli/lib/framework-setup.js

@@ -12,7 +12,7 @@ const { spawnSync } = require('node:child_process');
 const { runAgent } = require('./run-agent');
 const { resolveTeaConfig } = require('./resolve-tea-config');
 
-const SKILL_NAME = 'bmad-testarch-framework';
+const SKILL_NAME = 'bmad-tea-framework';
 const SCOPES = ['framework', 'ci', 'both'];
 const OPERATIONS = ['create', 'resume', 'validate', 'edit'];
 
@@ -607,7 +607,7 @@ function prepareSetup({ projectRoot, skillRoot, config, options }) {
     throw problem('Resume has an uncertain started hook. Record explicit operator recovery in the journal before headless execution.');
   const scope = options.operation === 'resume' ? before.data.setup_scope : options.scope;
   const ciConfig = ['ci', 'both'].includes(scope)
-    ? resolveTeaConfig({ projectRoot, skillRoot: path.join(skillRoot, '..', 'bmad-testarch-ci'), skillName: 'bmad-testarch-ci' })
+    ? resolveTeaConfig({ projectRoot, skillRoot: path.join(skillRoot, 'ci'), skillName: 'bmad-tea-ci' })
     : null;
   const requiredHooks = {};
   for (const [phase, settings] of [

package/cli/lib/resolve-skill.js

@@ -1,5 +1,5 @@
 /**
- * Resolve the installed bmad-testarch-test-review skill root inside a consuming project.
+ * Resolve the installed bmad-tea-test-review skill root inside a consuming project.
  *
  * Probe order mirrors BMAD installer outputs: BMAD core layout, Claude Code, Codex.
  * The skill remains the source of truth for review logic; the CLI only locates it.
@@ -8,7 +8,7 @@
 const fs = require('node:fs');
 const path = require('node:path');
 
-const SKILL_NAME = 'bmad-testarch-test-review';
+const SKILL_NAME = 'bmad-tea-test-review';
 
 // The classic installer's location comes last: a project upgraded from v6 can still hold that copy, and it must not shadow the skill the v7 install added.
 const SKILL_CANDIDATES = [

package/cli/lib/resolve-tea-config.js

@@ -78,18 +78,22 @@ function configError(message) {
 }
 
 /** Read configuration from one pinned base commit, or from the working tree. */
-function configSource(projectRoot, baseRef) {
+function configSource(projectRoot, baseRef, inputPaths, inputPatterns) {
   if (baseRef === undefined || baseRef === null) {
     return {
+      recordInput: (file) => inputPaths?.add(file),
       label: (relativePath) => path.join(projectRoot, relativePath),
       list(pattern) {
         try {
-          return globSync(pattern, { cwd: projectRoot, dot: true, nodir: true, follow: false });
+          const matches = globSync(pattern, { cwd: projectRoot, dot: true, nodir: true, follow: false });
+          inputPatterns?.set(pattern, [...matches].sort());
+          return matches;
         } catch (error) {
           throw configError(`Failed to list policy files in ${projectRoot}: ${error.message}`);
         }
       },
       read(relativePath) {
+        inputPaths?.add(path.join(projectRoot, relativePath));
         try {
           return fs.readFileSync(path.join(projectRoot, relativePath), 'utf8');
         } catch (error) {
@@ -281,9 +285,10 @@ function parseToml(content, label) {
 }
 
 /** Resolve trusted skill defaults and project workflow overrides from the same configuration source. */
-function readWorkflowCustomization(source, skillRoot, projectRoot, skillName = 'bmad-testarch-test-review') {
+function readWorkflowCustomization(source, skillRoot, projectRoot, skillName = 'bmad-tea-test-review') {
   if (!skillRoot) return {};
   const defaultsPath = path.join(skillRoot, 'customize.toml');
+  source.recordInput?.(defaultsPath);
   let merged = {};
   try {
     merged = parseToml(fs.readFileSync(defaultsPath, 'utf8'), defaultsPath);
@@ -291,10 +296,24 @@ function readWorkflowCustomization(source, skillRoot, projectRoot, skillName = '
     if (error.code !== 'ENOENT') throw configError(`Failed to load ${defaultsPath}: ${error.message}`);
   }
   if (!/^[a-z0-9][a-z0-9-]*$/.test(skillName)) throw configError('Workflow skill name must be a lowercase kebab-case name');
-  const workflowPaths = ['.toml', '.user.toml'].map((suffix) => path.join('_bmad', 'custom', skillName + suffix));
-  for (const relativePath of workflowPaths) {
-    const content = source.read(relativePath);
-    if (content !== null) merged = mergeTables(merged, parseToml(content, source.label(relativePath)));
+  const oldName =
+    skillName === 'bmad-tea-teach-me-testing'
+      ? 'bmad-teach-me-testing'
+      : skillName.startsWith('bmad-tea-')
+        ? skillName.replace('bmad-tea-', 'bmad-testarch-')
+        : null;
+  for (const suffix of ['.toml', '.user.toml']) {
+    const legacyPath = oldName && path.join('_bmad', 'custom', oldName + suffix);
+    const currentPath = path.join('_bmad', 'custom', skillName + suffix);
+    const legacyContent = legacyPath && source.read(legacyPath);
+    const currentContent = source.read(currentPath);
+    const legacy = legacyContent === null ? {} : parseToml(legacyContent, source.label(legacyPath));
+    const current = currentContent === null ? {} : parseToml(currentContent, source.label(currentPath));
+    const conflict = conflictingValue(legacy, current);
+    if (conflict) {
+      throw configError(`Conflicting workflow customization ${conflict} in ${source.label(legacyPath)} and ${source.label(currentPath)}`);
+    }
+    merged = mergeTables(merged, unionEqualCustomizationValues(legacy, current));
   }
   if (merged.workflow !== undefined && !isPlainObject(merged.workflow)) {
     throw configError('Workflow customization must contain a [workflow] table');
@@ -322,6 +341,29 @@ function readWorkflowCustomization(source, skillRoot, projectRoot, skillName = '
   return workflow;
 }
 
+/** Find the first setting whose legacy and current values disagree. */
+function conflictingValue(legacy, current, prefix = '') {
+  for (const [key, oldValue] of Object.entries(legacy)) {
+    if (!Object.hasOwn(current, key)) continue;
+    const next = prefix ? `${prefix}.${key}` : key;
+    const newValue = current[key];
+    if (isPlainObject(oldValue) && isPlainObject(newValue)) {
+      const nested = conflictingValue(oldValue, newValue, next);
+      if (nested) return nested;
+    } else if (JSON.stringify(oldValue) !== JSON.stringify(newValue)) return next;
+  }
+  return null;
+}
+
+/** Combine old and new names for one layer without appending an identical array twice. */
+function unionEqualCustomizationValues(legacy, current) {
+  const result = { ...legacy };
+  for (const [key, value] of Object.entries(current)) {
+    result[key] = isPlainObject(result[key]) && isPlainObject(value) ? unionEqualCustomizationValues(result[key], value) : value;
+  }
+  return result;
+}
+
 /** Coerce the keys this CLI cares about out of a raw TEA config table. */
 function pickTeaValues(table, source) {
   const values = {};
@@ -490,13 +532,16 @@ const KEY_TO_INSTALLED_FIELD = {
  * @param {string} [options.skillRoot] - Trusted skill defaults for workflow customization.
  * @param {object} [options.flags] - Parsed CLI options; only the keys in
  *   FLAG_TO_KEY are read, and only when not undefined.
+ * @param {Set<string>} [options.inputPaths] - Receives working-tree inputs, including missing optional layers.
+ * @param {Map<string, string[]>} [options.inputPatterns] - Receives policy glob membership used during resolution.
  * @returns {{values: object, sources: object, installed: object, configSnapshot: object, workflowCustomization: object, configCommit: string|null, configPath: string, configPresent: boolean, configFormat: string|null}}
  *   `installed` carries one boolean per library gate, read from the project
  *   manifest rather than left to the agent.
  * @throws {Error} With code TEA_CONFIG_INVALID on unusable config content.
  */
-function resolveTeaConfig({ projectRoot, flags = {}, baseRef, skillRoot, skillName }) {
-  const source = configSource(projectRoot, baseRef);
+function resolveTeaConfig({ projectRoot, flags = {}, baseRef, skillRoot, skillName, inputPaths, inputPatterns }) {
+  const source = configSource(projectRoot, baseRef, inputPaths, inputPatterns);
+  inputPaths?.add(path.join(projectRoot, 'package.json'));
   const file = readTeaConfigFile(projectRoot, baseRef, source);
   const workflowCustomization = readWorkflowCustomization(source, skillRoot, projectRoot, skillName);