ma-agents 3.9.0 → 3.11.0

package/lib/bmad.js

@@ -752,6 +752,7 @@ async function installBmad(modules = ['bmm', 'bmb'], tools = [], projectRoot = p
         const profile = require('./profile').getProfile(projectRoot);
         await applyOnPremPhasePrefixToDeployedSkills(projectRoot, profile);
         await deployMethodology(projectRoot, force);
+        await deployClineWorkflows(projectRoot, tools);
         postStepsSucceeded = true;
         return true;
     } catch (error) {
@@ -868,6 +869,7 @@ async function runMigration(modules, tools, projectRoot, force, { userName, comm
     await applyOnPremPhasePrefixToDeployedSkills(projectRoot, profile);
 
     await deployMethodology(projectRoot, force);
+    await deployClineWorkflows(projectRoot, tools);
 
     // All migration steps succeeded — safe to clean up the stage now.
     // Cleaning up earlier would remove diagnostics if any of steps 3-4 or
@@ -948,6 +950,7 @@ async function updateBmad(modules = ['bmm', 'bmb'], tools = [], projectRoot = pr
         const profile = require('./profile').getProfile(projectRoot);
         await applyOnPremPhasePrefixToDeployedSkills(projectRoot, profile);
         await deployMethodology(projectRoot, force);
+        await deployClineWorkflows(projectRoot, tools);
         postStepsSucceeded = true;
         return true;
     } catch (error) {
@@ -1369,6 +1372,74 @@ async function deployMethodology(projectRoot = process.cwd(), force = false) {
     console.log(chalk.gray('  Tip: Use /open-presentation to open the slides (install via npx ma-agents install open-presentation)'));
 }
 
+/**
+ * Generate Cline workflow wrappers for all BMAD skills installed to .cline/skills/.
+ * Creates .clinerules/workflows/<skill-name>.md for each installed skill so they
+ * can be invoked via / commands in Cline chat.
+ * No-op when 'cline' is not in the selected tools list.
+ */
+async function deployClineWorkflows(projectRoot, tools = []) {
+    if (!tools.includes('cline')) return;
+
+    const clineSkillsDir = path.join(projectRoot, '.cline', 'skills');
+    if (!(await fs.pathExists(clineSkillsDir))) return;
+
+    const workflowsDir = path.join(projectRoot, '.clinerules', 'workflows');
+    await fs.ensureDir(workflowsDir);
+
+    const entries = await fs.readdir(clineSkillsDir, { withFileTypes: true });
+    const skillDirs = entries.filter(e => e.isDirectory());
+
+    let generated = 0;
+    for (const entry of skillDirs) {
+        const skillName = entry.name;
+        const skillDir = path.join(clineSkillsDir, skillName);
+        const skillMdPath = path.join(skillDir, 'SKILL.md');
+        const workflowMdPath = path.join(skillDir, 'workflow.md');
+
+        if (!(await fs.pathExists(skillMdPath))) continue;
+
+        const skillMdContent = await fs.readFile(skillMdPath, 'utf8');
+        let displayName = skillName.replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+        let description = '';
+
+        const fmMatch = skillMdContent.match(/^---\n([\s\S]*?)\n---/);
+        if (fmMatch) {
+            const fm = fmMatch[1];
+            const nameMatch = fm.match(/^name:\s*(.+)$/m);
+            const descMatch = fm.match(/^description:\s*(.+)$/m);
+            if (nameMatch) displayName = nameMatch[1].trim();
+            if (descMatch) description = descMatch[1].trim().replace(/^['"]|['"]$/g, '');
+        }
+
+        const hasWorkflow = await fs.pathExists(workflowMdPath);
+        const lines = [`# ${displayName}`, ''];
+        if (description) lines.push(description, '');
+
+        if (hasWorkflow) {
+            lines.push(
+                '## Step 1: Read and follow the BMAD skill workflow',
+                `Read the file \`.cline/skills/${skillName}/workflow.md\` and follow all instructions within it exactly.`,
+                ''
+            );
+        } else {
+            lines.push(
+                '## Step 1: Read and follow the BMAD skill instructions',
+                `Read the file \`.cline/skills/${skillName}/SKILL.md\`. Ignore the YAML frontmatter block (the \`---\` delimited section at the top of the file). Follow all instructions in the body of that file exactly.`,
+                ''
+            );
+        }
+
+        await fs.writeFile(path.join(workflowsDir, `${skillName}.md`), lines.join('\n'), 'utf8');
+        generated++;
+    }
+
+    if (generated > 0) {
+        console.log(chalk.green(`  ✓ Generated ${generated} Cline workflow wrappers in .clinerules/workflows/`));
+        console.log(chalk.gray('  Tip: In Cline, type / to browse and invoke BMAD skills'));
+    }
+}
+
 async function prePopulateBmadCache(force = false) {
     const cacheSource = path.join(__dirname, 'bmad-cache');
     if (!(await fs.pathExists(cacheSource))) {
@@ -1527,7 +1598,7 @@ function ensureCanonicalConfigLocation(projectRoot) {
 
 // ── Migration constants ─────────────────────────────────────────────────────
 
-const BMAD_TARGET_VERSION = '6.5.0';
+const BMAD_TARGET_VERSION = '6.6.0';
 const BMAD_MIGRATION_THRESHOLD = '6.2.0'; // versions below this need migration
 const BACKUP_DIR_NAME = '.backup-pre-migration';
 
@@ -2487,6 +2558,7 @@ module.exports = {
     updateBmad,
     prePopulateBmadCache,
     deployMethodology,
+    deployClineWorkflows,
     // Story 22.7 — canonical config (_bmad/bmm/config.yaml) helpers
     readCanonicalBmadConfig,
     ensureCanonicalConfigLocation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ma-agents",
-  "version": "3.9.0",
+  "version": "3.11.0",
   "description": "NPX tool to install skills for AI coding agents (Claude Code, Gemini, Copilot, Kilocode, Cline, Cursor, Roo Code)",
   "main": "index.js",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "scripts": {
     "start": "node bin/cli.js",
-    "test": "node test/yes-flag.test.js && node test/skill-authoring.test.js && node test/skill-validation.test.js && node test/skill-mandatory.test.js && node test/skill-customize-agent.test.js && node test/create-agent.test.js && node test/generate-project-context.test.js && node test/build-bmad-args.test.js && node test/bmad-version-bump.test.js && node test/extension-module-restructure.test.js && node test/convert-agents-to-skills.test.js && node test/migration.test.js && node test/migration-validation.test.js && node test/story-15-5-workflow-skills.test.js && node test/repo-layout.test.js && node test/config-storage.test.js && node test/cross-repo-validation.test.js && node test/config-lost-on-update.test.js && node test/portable-paths.test.js && node test/cicd-remote-mode.test.js && node test/config-layout.test.js && node test/roo-code-agent.test.js && node test/roo-code-injection.test.js && node test/profile.test.js && node test/instruction-block.test.js && node test/instruction-injection.test.js && node test/agents-md.test.js && node test/onprem-injection.test.js && node test/onprem-layer.test.js && node test/roomodes.test.js && node test/clinerules.test.js && node test/reconfigure.test.js && node test/experimental-warning.test.js && node test/bmad-persona-phase-prefix.test.js && node test/f1a-on-prem-prefix-post-install.test.js && node test/retired-skills-migration.test.js && node test/rename-migration.test.js && node test/uninstall.test.js && node test/offline-recompile.test.js && node test/plugin-manifests.test.js && node test/build-plugin.test.js && node test/config-path-migration.test.js && node test/gitignore-plugin-stage.test.js && node test/customizations-translation.test.js && node test/routing-parity.test.js && node test/bmad-extension.test.js && node test/integration-verification.test.js && node test/agent-scope.test.js && node test/obsolete-tool-dirs.test.js",
+    "test": "node test/yes-flag.test.js && node test/skill-authoring.test.js && node test/skill-validation.test.js && node test/skill-mandatory.test.js && node test/skill-customize-agent.test.js && node test/create-agent.test.js && node test/generate-project-context.test.js && node test/build-bmad-args.test.js && node test/bmad-version-bump.test.js && node test/extension-module-restructure.test.js && node test/convert-agents-to-skills.test.js && node test/migration.test.js && node test/migration-validation.test.js && node test/story-15-5-workflow-skills.test.js && node test/repo-layout.test.js && node test/config-storage.test.js && node test/cross-repo-validation.test.js && node test/config-lost-on-update.test.js && node test/portable-paths.test.js && node test/cicd-remote-mode.test.js && node test/config-layout.test.js && node test/roo-code-agent.test.js && node test/roo-code-injection.test.js && node test/profile.test.js && node test/instruction-block.test.js && node test/instruction-injection.test.js && node test/agents-md.test.js && node test/onprem-injection.test.js && node test/onprem-layer.test.js && node test/roomodes.test.js && node test/clinerules.test.js && node test/reconfigure.test.js && node test/experimental-warning.test.js && node test/bmad-persona-phase-prefix.test.js && node test/f1a-on-prem-prefix-post-install.test.js && node test/retired-skills-migration.test.js && node test/rename-migration.test.js && node test/uninstall.test.js && node test/offline-recompile.test.js && node test/plugin-manifests.test.js && node test/build-plugin.test.js && node test/config-path-migration.test.js && node test/gitignore-plugin-stage.test.js && node test/customizations-translation.test.js && node test/routing-parity.test.js && node test/bmad-extension.test.js && node test/integration-verification.test.js && node test/agent-scope.test.js && node test/obsolete-tool-dirs.test.js && node test/bmad-empty-tools-guard.test.js",
     "build:bmad-cache": "node scripts/build-bmad-cache.js",
     "build:plugin": "node scripts/build-plugin.js",
     "prepare": "node scripts/build-plugin.js"
@@ -29,11 +29,11 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "bmad-method": "6.5.0",
-    "prompts": "^2.4.2",
+    "bmad-method": "6.6.0",
     "chalk": "^4.1.2",
     "fs-extra": "^11.1.1",
     "js-yaml": "^4.1.1",
+    "prompts": "^2.4.2",
     "yaml": "^2.8.2"
   },
   "files": [

package/lib/bmad-cache/tea/.github/workflows/manual-release.yaml

@@ -1,216 +0,0 @@
-name: Manual Release
-
-on:
-  workflow_dispatch:
-    inputs:
-      version_bump:
-        description: Version bump type
-        required: true
-        default: beta
-        type: choice
-        options:
-          - beta
-          - alpha
-          - patch
-          - minor
-          - major
-
-permissions:
-  contents: write
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: ".nvmrc"
-          cache: npm
-          registry-url: "https://registry.npmjs.org"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Verify npm credentials
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: |
-          if [ -z "$NODE_AUTH_TOKEN" ]; then
-            echo "NPM_TOKEN secret is not configured." >&2
-            exit 1
-          fi
-
-      - name: Run tests and validation
-        run: npm test
-
-      - name: Configure Git
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-      - name: Bump version
-        run: |
-          case "${{ github.event.inputs.version_bump }}" in
-            alpha|beta) npm version prerelease --no-git-tag-version --preid=${{ github.event.inputs.version_bump }} ;;
-            *)          npm version ${{ github.event.inputs.version_bump }} --no-git-tag-version ;;
-          esac
-
-      - name: Sync marketplace version
-        run: |
-          node <<'NODE'
-          const fs = require('node:fs');
-
-          const packageJson = JSON.parse(fs.readFileSync('package.json', 'utf8'));
-          const marketplacePath = '.claude-plugin/marketplace.json';
-          const marketplace = JSON.parse(fs.readFileSync(marketplacePath, 'utf8'));
-          const plugin = (marketplace.plugins || []).find((entry) => entry && entry.name === packageJson.name);
-
-          if (!plugin) {
-            throw new Error(`Marketplace entry not found for ${packageJson.name}`);
-          }
-
-          plugin.version = packageJson.version;
-          fs.writeFileSync(marketplacePath, `${JSON.stringify(marketplace, null, 2)}\n`);
-          NODE
-
-      - name: Validate release metadata
-        run: npm run test:release-metadata
-
-      - name: Get new version and release metadata
-        id: version
-        run: |
-          NEW_VERSION=$(node -p "require('./package.json').version")
-          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
-          echo "previous_tag=$(git describe --tags --abbrev=0 2>/dev/null || echo 'v0.0.0')" >> $GITHUB_OUTPUT
-          case "$NEW_VERSION" in
-            *-alpha.*) echo "npm_tag=alpha" >> $GITHUB_OUTPUT ;;
-            *-beta.*) echo "npm_tag=beta" >> $GITHUB_OUTPUT ;;
-            *) echo "npm_tag=latest" >> $GITHUB_OUTPUT ;;
-          esac
-
-      - name: Commit version bump
-        run: |
-          git add package.json package-lock.json .claude-plugin/marketplace.json
-          git commit -m "release: bump to v${{ steps.version.outputs.new_version }}"
-
-      - name: Create and push tag
-        run: |
-          # Check if tag already exists
-          if git rev-parse "v${{ steps.version.outputs.new_version }}" >/dev/null 2>&1; then
-            echo "Tag v${{ steps.version.outputs.new_version }} already exists, skipping tag creation"
-          else
-            git tag -a "v${{ steps.version.outputs.new_version }}" -m "Release v${{ steps.version.outputs.new_version }}"
-            git push origin "v${{ steps.version.outputs.new_version }}"
-          fi
-
-      - name: Publish to npm
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: |
-          if [ "${{ steps.version.outputs.npm_tag }}" = "latest" ]; then
-            npm publish
-          else
-            npm publish --tag "${{ steps.version.outputs.npm_tag }}"
-          fi
-
-      - name: Generate release notes
-        id: release_notes
-        run: |
-          # Get commits since last tag (or all commits if no tags exist)
-          if [ "${{ steps.version.outputs.previous_tag }}" = "v0.0.0" ]; then
-            COMMITS=$(git log --pretty=format:"- %s" --reverse)
-          else
-            COMMITS=$(git log ${{ steps.version.outputs.previous_tag }}..HEAD --pretty=format:"- %s" --reverse)
-          fi
-
-          # Categorize commits
-          FEATURES=$(echo "$COMMITS" | grep -E "^- (feat|Feature)" || true)
-          FIXES=$(echo "$COMMITS" | grep -E "^- (fix|Fix)" || true)
-          CHORES=$(echo "$COMMITS" | grep -E "^- (chore|Chore)" || true)
-          OTHERS=$(echo "$COMMITS" | grep -v -E "^- (feat|Feature|fix|Fix|chore|Chore|release:|Release:)" || true)
-
-          # Build release notes
-          cat > release_notes.md << 'EOF'
-          ## 🚀 What's New in v${{ steps.version.outputs.new_version }}
-
-          EOF
-
-          if [ ! -z "$FEATURES" ]; then
-            echo "### ✨ New Features" >> release_notes.md
-            echo "$FEATURES" >> release_notes.md
-            echo "" >> release_notes.md
-          fi
-
-          if [ ! -z "$FIXES" ]; then
-            echo "### 🐛 Bug Fixes" >> release_notes.md
-            echo "$FIXES" >> release_notes.md
-            echo "" >> release_notes.md
-          fi
-
-          if [ ! -z "$OTHERS" ]; then
-            echo "### 📦 Other Changes" >> release_notes.md
-            echo "$OTHERS" >> release_notes.md
-            echo "" >> release_notes.md
-          fi
-
-          if [ ! -z "$CHORES" ]; then
-            echo "### 🔧 Maintenance" >> release_notes.md
-            echo "$CHORES" >> release_notes.md
-            echo "" >> release_notes.md
-          fi
-
-          cat >> release_notes.md << 'EOF'
-
-          ## 📦 Installation
-
-          ```bash
-          npx bmad-method install
-          # Select "Test Architect" from module menu
-          ```
-          EOF
-
-          # Add changelog link only if there was a previous tag
-          if [ "${{ steps.version.outputs.previous_tag }}" != "v0.0.0" ]; then
-            echo "" >> release_notes.md
-            echo "**Full Changelog**: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/compare/${{ steps.version.outputs.previous_tag }}...v${{ steps.version.outputs.new_version }}" >> release_notes.md
-          fi
-
-          # Output for GitHub Actions
-          echo "RELEASE_NOTES<<EOF" >> $GITHUB_OUTPUT
-          cat release_notes.md >> $GITHUB_OUTPUT
-          echo "EOF" >> $GITHUB_OUTPUT
-
-      - name: Push changes to release branch
-        run: |
-          if git push origin HEAD:${GITHUB_REF_NAME} 2>/dev/null; then
-            echo "✅ Successfully pushed to ${GITHUB_REF_NAME} branch"
-          else
-            echo "⚠️ Could not push to ${GITHUB_REF_NAME} (protected branch). This is expected."
-            echo "📝 Version bump and tag were created successfully."
-          fi
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: v${{ steps.version.outputs.new_version }}
-          name: "Test Architect v${{ steps.version.outputs.new_version }}"
-          body: |
-            ${{ steps.release_notes.outputs.RELEASE_NOTES }}
-          draft: false
-          prerelease: ${{ contains(steps.version.outputs.new_version, 'alpha') || contains(steps.version.outputs.new_version, 'beta') }}
-
-      - name: Summary
-        run: |
-          echo "## 🎉 Successfully released v${{ steps.version.outputs.new_version }}!" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "### 📦 Distribution" >> $GITHUB_STEP_SUMMARY
-          echo "- **NPM Package**: https://www.npmjs.com/package/bmad-method-test-architecture-enterprise" >> $GITHUB_STEP_SUMMARY
-          echo "- **NPM Dist-tag**: \`${{ steps.version.outputs.npm_tag }}\`" >> $GITHUB_STEP_SUMMARY
-          echo "- **GitHub Release**: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/releases/tag/v${{ steps.version.outputs.new_version }}" >> $GITHUB_STEP_SUMMARY