bmad-method-test-architecture-enterprise 1.0.0 → 1.0.1

package/docs/explanation/tea-overview.md

@@ -359,7 +359,7 @@ Production-ready fixtures and utilities that enhance TEA workflows.
 
 **Setup:**
 
-- CLI: `npm install -g @playwright/cli@latest` then `playwright-cli install --skills`
+- CLI: `npm install -g @playwright/cli@latest` (global, one-time) then `playwright-cli install --skills` (from project root)
 - MCP: Configure MCP servers in your IDE (see [Configure Browser Automation](/docs/how-to/customization/configure-browser-automation.md))
 
 **Which workflows benefit:**

package/docs/how-to/customization/configure-browser-automation.md

@@ -33,7 +33,7 @@ npm install -g @playwright/cli@latest    # Install globally (Node.js 18+)
 playwright-cli install --skills          # Register as an agent skill
 ```
 
-This is a one-time global setup. TEA documents it during installation but does not run it for you.
+The global npm install is one-time. The skills install (`playwright-cli install --skills`) should be run from your project root — it registers skills in your project's `.claude/skills/` directory (Claude Code, GitHub Copilot, and other coding agents that support the skills convention). Agents without skills support can still use the CLI directly via `playwright-cli --help`.
 
 ### For MCP (`mcp` or `auto` mode)
 

package/eslint.config.mjs

@@ -114,17 +114,6 @@ export default [
     },
   },
 
-  // Module installer scripts use CommonJS for compatibility
-  {
-    files: ['**/_module-installer/**/*.js'],
-    rules: {
-      // Allow CommonJS patterns for installer scripts
-      'unicorn/prefer-module': 'off',
-      'n/no-missing-require': 'off',
-      'n/no-unpublished-require': 'off',
-    },
-  },
-
   // ESLint config file should not be checked for publish-related Node rules
   {
     files: ['eslint.config.mjs'],

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method-test-architecture-enterprise",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Master Test Architect for quality strategy, test automation, and release gates",
   "keywords": [
     "bmad",
@@ -73,11 +73,9 @@
   "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",

package/release_notes.md

@@ -1,4 +1,13 @@
-## 🚀 What's New in v1.0.0
+## 🚀 What's New in v1.0.1
+
+### 🐛 Bug Fixes
+- fix: playwright cli docs alignment
+- fix: CI failures
+
+### 📦 Other Changes
+- Remove _module-installer pattern for declarative directory creation
+- re-run checks
+- Merge pull request #24 from bmad-code-org/fix/playwright-cli-docs-alignment
 
 
 ## 📦 Installation
@@ -8,4 +17,4 @@ npx bmad-method install
 # Select "Test Architect" from module menu
 ```
 
-**Full Changelog**: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/compare/v0.1.1-beta.5...v1.0.0
+**Full Changelog**: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/compare/v1.0.0...v1.0.1

package/src/module.yaml

@@ -94,3 +94,7 @@ trace_output:
   prompt: "Where should traceability reports be stored?"
   default: "traceability"
   result: "{test_artifacts}/{value}"
+
+# Directories to create during installation (declarative, no code execution)
+directories:
+  - "{test_artifacts}"

package/src/testarch/knowledge/playwright-cli.md

@@ -24,7 +24,7 @@ npm install -g @playwright/cli@latest    # Install globally (Node.js 18+)
 playwright-cli install --skills          # Register as an agent skill
 ```
 
-This is a one-time setup, like configuring MCP servers. TEA documents it during installation but does not run it for you.
+The global npm install is one-time. Run `playwright-cli install --skills` from your project root to register skills in `.claude/skills/` (works with Claude Code, GitHub Copilot, and other coding agents). Agents without skills support can use the CLI directly via `playwright-cli --help`. TEA documents this during installation but does not run it for you.
 
 ## How It Works
 

package/test/test-installation-components.js

@@ -11,9 +11,18 @@
  */
 
 const path = require('node:path');
-const fs = require('fs-extra');
+const fs = require('node:fs/promises');
 const yaml = require('js-yaml');
 
+async function pathExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // ANSI colors
 const colors = {
   reset: '\u001B[0m',
@@ -80,7 +89,7 @@ async function runTests() {
   try {
     const teaAgentPath = path.join(projectRoot, 'src/agents/tea.agent.yaml');
 
-    if (await fs.pathExists(teaAgentPath)) {
+    if (await pathExists(teaAgentPath)) {
       const teaAgent = yaml.load(await fs.readFile(teaAgentPath, 'utf8'));
 
       assert(teaAgent.agent !== undefined, 'tea.agent.yaml has agent root key');
@@ -113,7 +122,7 @@ async function runTests() {
   try {
     const teaIndexPath = path.join(projectRoot, 'src/testarch/tea-index.csv');
 
-    if (await fs.pathExists(teaIndexPath)) {
+    if (await pathExists(teaIndexPath)) {
       const csvContent = await fs.readFile(teaIndexPath, 'utf8');
       const lines = csvContent.trim().split('\n');
 
@@ -138,7 +147,7 @@ async function runTests() {
 
   const teachMeWorkflowPath = path.join(projectRoot, 'src/workflows/testarch/teach-me-testing/workflow.md');
   try {
-    if (await fs.pathExists(teachMeWorkflowPath)) {
+    if (await pathExists(teachMeWorkflowPath)) {
       const teachMeContent = await fs.readFile(teachMeWorkflowPath, 'utf8');
       assert(teachMeContent.length > 0, 'teach-me-testing/workflow.md exists');
       assert(!teachMeContent.includes('_bmad/bmm/'), 'teach-me-testing has no _bmad/bmm/ references');
@@ -154,7 +163,7 @@ async function runTests() {
   for (const workflowName of workflowNames) {
     const workflowYamlPath = path.join(projectRoot, `src/workflows/testarch/${workflowName}/workflow.yaml`);
 
-    if (await fs.pathExists(workflowYamlPath)) {
+    if (await pathExists(workflowYamlPath)) {
       try {
         const workflowYaml = yaml.load(await fs.readFile(workflowYamlPath, 'utf8'));
         assert(workflowYaml !== undefined, `${workflowName}/workflow.yaml is valid YAML`);

package/tools/build-docs.js

@@ -334,7 +334,7 @@ async function generatePromptsBundle(downloadsDir) {
   if (!fs.existsSync(srcDir)) return;
 
   const zipPath = path.join(downloadsDir, 'tea-prompts.zip');
-  await createZipArchive(srcDir, zipPath, ['docs', '.DS_Store', '__pycache__', 'node_modules', '_module-installer']);
+  await createZipArchive(srcDir, zipPath, ['docs', '.DS_Store', '__pycache__', 'node_modules']);
 
   const size = Math.floor(fs.statSync(zipPath).size / 1024);
   console.log(`    tea-prompts.zip (${size}K)`);

package/src/_module-installer/installer.js

@@ -1,92 +0,0 @@
-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 };