bmad-method 6.0.5-next.9 → 6.1.0

package/.github/ISSUE_TEMPLATE/issue.md

@@ -1,32 +0,0 @@
----
-name: Issue
-about: Report a problem or something that's not working
-title: ''
-labels: ''
-assignees: ''
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**Steps to reproduce**
-1. What were you doing when the bug occurred?
-2. What steps can recreate the issue?
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Environment (if relevant)**
-- Model(s) used:
-- Agentic IDE used:
-- BMad version:
-- Project language:
-
-**Screenshots or links**
-If applicable, add screenshots or links to help explain the problem.
-
-**PR**
-If you'd like to contribute a fix, please indicate you're working on it or link to your PR. See [CONTRIBUTING.md](../../CONTRIBUTING.md) — contributions are always welcome!
-
-**Additional context**
-Add any other context about the problem here. The more information you provide, the easier it is to help.

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,13 +0,0 @@
-## What
-<!-- 1-2 sentences describing WHAT changed -->
-
-## Why
-<!-- 1-2 sentences explaining WHY this change is needed -->
-<!-- Fixes `#issue_number` (if applicable) -->
-
-## How
-<!-- 2-3 bullets listing HOW you implemented it -->
--
-
-## Testing
-<!-- 1-2 sentences on how you tested this -->

package/.github/scripts/discord-helpers.sh

@@ -1,34 +0,0 @@
-#!/bin/bash
-# Discord notification helper functions
-
-# Escape markdown special chars and @mentions for safe Discord display
-# Skips content inside <URL> wrappers to preserve URLs intact
-esc() {
-  awk '{
-    result = ""; in_url = 0; n = length($0)
-    for (i = 1; i <= n; i++) {
-      c = substr($0, i, 1)
-      if (c == "<" && substr($0, i, 8) ~ /^<https?:/) in_url = 1
-      if (in_url) { result = result c; if (c == ">") in_url = 0 }
-      else if (c == "@") result = result "@ "
-      else if (index("[]\\*_()~`", c) > 0) result = result "\\" c
-      else result = result c
-    }
-    print result
-  }'
-}
-
-# Truncate to $1 chars (or 80 if wall-of-text with <3 spaces)
-trunc() {
-  local max=$1
-  local txt=$(tr '\n\r' '  ' | cut -c1-"$max")
-  local spaces=$(printf '%s' "$txt" | tr -cd ' ' | wc -c)
-  [ "$spaces" -lt 3 ] && [ ${#txt} -gt 80 ] && txt=$(printf '%s' "$txt" | cut -c1-80)
-  printf '%s' "$txt"
-}
-
-# Remove incomplete URL at end of truncated text (incomplete URLs are useless)
-strip_trailing_url() { sed -E 's~<?https?://[^[:space:]]*$~~'; }
-
-# Wrap URLs in <> to suppress Discord embeds (keeps links clickable)
-wrap_urls() { sed -E 's~https?://[^[:space:]<>]+~<&>~g'; }

package/.github/workflows/coderabbit-review.yaml

@@ -1,22 +0,0 @@
-name: Trigger CodeRabbit on Ready for Review
-
-on:
-  pull_request_target:
-    types: [ready_for_review]
-
-jobs:
-  trigger-review:
-    runs-on: ubuntu-latest
-    permissions:
-      pull-requests: write
-    steps:
-      - name: Request CodeRabbit review
-        uses: actions/github-script@v7
-        with:
-          script: |
-            await github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.payload.pull_request.number,
-              body: '@coderabbitai review'
-            });

package/.github/workflows/discord.yaml

@@ -1,90 +0,0 @@
-name: Discord Notification
-
-on:
-  pull_request:
-    types: [opened, closed]
-  issues:
-    types: [opened]
-
-env:
-  MAX_TITLE: 100
-  MAX_BODY: 250
-
-jobs:
-  pull_request:
-    if: github.event_name == 'pull_request'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.repository.default_branch }}
-          sparse-checkout: .github/scripts
-          sparse-checkout-cone-mode: false
-      - name: Notify Discord
-        env:
-          WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
-          ACTION: ${{ github.event.action }}
-          MERGED: ${{ github.event.pull_request.merged }}
-          PR_NUM: ${{ github.event.pull_request.number }}
-          PR_URL: ${{ github.event.pull_request.html_url }}
-          PR_TITLE: ${{ github.event.pull_request.title }}
-          PR_USER: ${{ github.event.pull_request.user.login }}
-          PR_BODY: ${{ github.event.pull_request.body }}
-        run: |
-          set -o pipefail
-          source .github/scripts/discord-helpers.sh
-          [ -z "$WEBHOOK" ] && exit 0
-
-          if [ "$ACTION" = "opened" ]; then ICON="🔀"; LABEL="New PR"
-          elif [ "$ACTION" = "closed" ] && [ "$MERGED" = "true" ]; then ICON="🎉"; LABEL="Merged"
-          elif [ "$ACTION" = "closed" ]; then ICON="❌"; LABEL="Closed"; fi
-
-          TITLE=$(printf '%s' "$PR_TITLE" | trunc $MAX_TITLE | esc)
-          [ ${#PR_TITLE} -gt $MAX_TITLE ] && TITLE="${TITLE}..."
-          BODY=$(printf '%s' "$PR_BODY" | trunc $MAX_BODY)
-          if [ -n "$PR_BODY" ] && [ ${#PR_BODY} -gt $MAX_BODY ]; then
-            BODY=$(printf '%s' "$BODY" | strip_trailing_url)
-          fi
-          BODY=$(printf '%s' "$BODY" | wrap_urls | esc)
-          [ -n "$PR_BODY" ] && [ ${#PR_BODY} -gt $MAX_BODY ] && BODY="${BODY}..."
-          [ -n "$BODY" ] && BODY=" · $BODY"
-          USER=$(printf '%s' "$PR_USER" | esc)
-
-          MSG="$ICON **[$LABEL #$PR_NUM: $TITLE](<$PR_URL>)**"$'\n'"by @$USER$BODY"
-          jq -n --arg content "$MSG" '{content: $content}' | curl -sf --retry 2 -X POST "$WEBHOOK" -H "Content-Type: application/json" -d @-
-
-  issues:
-    if: github.event_name == 'issues'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.repository.default_branch }}
-          sparse-checkout: .github/scripts
-          sparse-checkout-cone-mode: false
-      - name: Notify Discord
-        env:
-          WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
-          ISSUE_NUM: ${{ github.event.issue.number }}
-          ISSUE_URL: ${{ github.event.issue.html_url }}
-          ISSUE_TITLE: ${{ github.event.issue.title }}
-          ISSUE_USER: ${{ github.event.issue.user.login }}
-          ISSUE_BODY: ${{ github.event.issue.body }}
-        run: |
-          set -o pipefail
-          source .github/scripts/discord-helpers.sh
-          [ -z "$WEBHOOK" ] && exit 0
-
-          TITLE=$(printf '%s' "$ISSUE_TITLE" | trunc $MAX_TITLE | esc)
-          [ ${#ISSUE_TITLE} -gt $MAX_TITLE ] && TITLE="${TITLE}..."
-          BODY=$(printf '%s' "$ISSUE_BODY" | trunc $MAX_BODY)
-          if [ -n "$ISSUE_BODY" ] && [ ${#ISSUE_BODY} -gt $MAX_BODY ]; then
-            BODY=$(printf '%s' "$BODY" | strip_trailing_url)
-          fi
-          BODY=$(printf '%s' "$BODY" | wrap_urls | esc)
-          [ -n "$ISSUE_BODY" ] && [ ${#ISSUE_BODY} -gt $MAX_BODY ] && BODY="${BODY}..."
-          [ -n "$BODY" ] && BODY=" · $BODY"
-          USER=$(printf '%s' "$ISSUE_USER" | esc)
-
-          MSG="🐛 **[Issue #$ISSUE_NUM: $TITLE](<$ISSUE_URL>)**"$'\n'"by @$USER$BODY"
-          jq -n --arg content "$MSG" '{content: $content}' | curl -sf --retry 2 -X POST "$WEBHOOK" -H "Content-Type: application/json" -d @-

package/.github/workflows/docs.yaml

@@ -1,64 +0,0 @@
-name: Deploy Documentation
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - "docs/**"
-      - "website/**"
-      - "tools/build-docs.mjs"
-      - ".github/workflows/docs.yaml"
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: "pages"
-  # No big win in setting this to true — risk of cancelling a deploy mid-flight.
-  cancel-in-progress: false
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          # Full history needed for Starlight's lastUpdated timestamps (git log)
-          fetch-depth: 0
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: ".nvmrc"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build documentation
-        env:
-          # Override site URL from GitHub repo variable if set
-          # Otherwise, astro.config.mjs will compute from GITHUB_REPOSITORY
-          SITE_URL: ${{ vars.SITE_URL }}
-        run: npm run docs:build
-
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: build/site
-
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

package/.github/workflows/publish.yaml

@@ -1,133 +0,0 @@
-name: Publish
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - "src/**"
-      - "tools/cli/**"
-      - "package.json"
-  workflow_dispatch:
-    inputs:
-      channel:
-        description: "Publish channel"
-        required: true
-        default: "latest"
-        type: choice
-        options:
-          - latest
-          - next
-      bump:
-        description: "Version bump type (latest channel only)"
-        required: false
-        default: "patch"
-        type: choice
-        options:
-          - patch
-          - minor
-          - major
-
-concurrency:
-  group: publish
-  cancel-in-progress: ${{ github.event_name == 'push' }}
-
-permissions:
-  id-token: write
-  contents: write
-
-jobs:
-  publish:
-    if: github.event_name != 'workflow_dispatch' || github.ref == 'refs/heads/main'
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: ".nvmrc"
-          cache: "npm"
-
-      - name: Ensure trusted publishing toolchain
-        run: |
-          # npm trusted publishing requires Node >= 22.14.0 and npm >= 11.5.1.
-          npm install --global npm@11.6.2
-
-      - name: Configure git user
-        if: github.event_name == 'workflow_dispatch' && inputs.channel == 'latest'
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run tests
-        run: npm test
-
-      - name: Derive next prerelease version
-        if: github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && inputs.channel == 'next')
-        run: |
-          NEXT_VER=$(npm view bmad-method@next version 2>/dev/null || echo "")
-          LATEST_VER=$(npm view bmad-method@latest version 2>/dev/null || echo "")
-
-          # Determine the best base version for the next prerelease.
-          BASE=$(node -e "
-            const semver = require('semver');
-            const next = process.argv[1] || null;
-            const latest = process.argv[2] || null;
-            if (!next && !latest) process.exit(0);
-            if (!next) { console.log(latest); process.exit(0); }
-            if (!latest) { console.log(next); process.exit(0); }
-            const nextBase = next.replace(/-next\.\d+$/, '');
-            console.log(semver.gt(latest, nextBase) ? latest : next);
-          " "$NEXT_VER" "$LATEST_VER")
-
-          if [ -n "$BASE" ]; then
-            npm version "$BASE" --no-git-tag-version --allow-same-version
-          fi
-          npm version prerelease --preid=next --no-git-tag-version
-
-      - name: Bump stable version
-        if: github.event_name == 'workflow_dispatch' && inputs.channel == 'latest'
-        run: 'npm version ${{ inputs.bump }} -m "chore(release): v%s [skip ci]"'
-
-      - name: Publish prerelease to npm
-        if: github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && inputs.channel == 'next')
-        run: npm publish --tag next --provenance
-
-      - name: Publish stable release to npm
-        if: github.event_name == 'workflow_dispatch' && inputs.channel == 'latest'
-        run: npm publish --tag latest --provenance
-
-      - name: Push version commit and tag
-        if: github.event_name == 'workflow_dispatch' && inputs.channel == 'latest'
-        run: git push origin main --follow-tags
-
-      - name: Create GitHub Release
-        if: github.event_name == 'workflow_dispatch' && inputs.channel == 'latest'
-        run: |
-          TAG="v$(node -p 'require("./package.json").version')"
-          gh release create "$TAG" --generate-notes
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Notify Discord
-        if: github.event_name == 'workflow_dispatch' && inputs.channel == 'latest'
-        continue-on-error: true
-        run: |
-          set -o pipefail
-          source .github/scripts/discord-helpers.sh
-          [ -z "$WEBHOOK" ] && exit 0
-
-          VERSION=$(node -p 'require("./package.json").version')
-          RELEASE_URL="${{ github.server_url }}/${{ github.repository }}/releases/tag/v${VERSION}"
-          MSG=$(printf '📦 **[bmad-method v%s released](<%s>)**' "$VERSION" "$RELEASE_URL" | esc)
-
-          jq -n --arg content "$MSG" '{content: $content}' | curl -sf --retry 2 -X POST "$WEBHOOK" -H "Content-Type: application/json" -d @-
-        env:
-          WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}

package/.github/workflows/quality.yaml

@@ -1,116 +0,0 @@
-name: Quality & Validation
-
-# Runs comprehensive quality checks on all PRs:
-# - Prettier (formatting)
-# - ESLint (linting)
-# - markdownlint (markdown quality)
-# - Schema validation (YAML structure)
-# - Agent schema tests (fixture-based validation)
-# - Installation component tests (compilation)
-# - Bundle validation (web bundle integrity)
-
-"on":
-  pull_request:
-    branches: ["**"]
-  workflow_dispatch:
-
-jobs:
-  prettier:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: ".nvmrc"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Prettier format check
-        run: npm run format:check
-
-  eslint:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: ".nvmrc"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: ESLint
-        run: npm run lint
-
-  markdownlint:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: ".nvmrc"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: markdownlint
-        run: npm run lint:md
-
-  docs:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: ".nvmrc"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build documentation
-        # Note: build-docs.mjs runs link validation internally before building
-        run: npm run docs:build
-
-  validate:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: ".nvmrc"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Validate YAML schemas
-        run: npm run validate:schemas
-
-      - name: Run agent schema validation tests
-        run: npm run test:schemas
-
-      - name: Test agent compilation components
-        run: npm run test:install
-
-      - name: Validate file references
-        run: npm run validate:refs

package/.husky/pre-commit

@@ -1,20 +0,0 @@
-#!/usr/bin/env sh
-
-# Auto-fix changed files and stage them
-npx --no-install lint-staged
-
-# Validate everything
-npm test
-
-# Validate docs links only when docs change
-if command -v rg >/dev/null 2>&1; then
-  if git diff --cached --name-only | rg -q '^docs/'; then
-    npm run docs:validate-links
-		npm run docs:build
-  fi
-else
-  if git diff --cached --name-only | grep -Eq '^docs/'; then
-    npm run docs:validate-links
-		npm run docs:build
-  fi
-fi

package/.markdownlint-cli2.yaml

@@ -1,41 +0,0 @@
-# markdownlint-cli2 configuration
-# https://github.com/DavidAnson/markdownlint-cli2
-
-ignores:
-  - "**/node_modules/**"
-  - test/fixtures/**
-  - CODE_OF_CONDUCT.md
-  - _bmad/**
-  - _bmad*/**
-  - .agent/**
-  - .claude/**
-  - .roo/**
-  - .codex/**
-  - .kiro/**
-  - sample-project/**
-  - test-project-install/**
-  - z*/**
-
-# Rule configuration
-config:
-  # Disable all rules by default
-  default: false
-
-  # Heading levels should increment by one (h1 -> h2 -> h3, not h1 -> h3)
-  MD001: true
-
-  # Duplicate sibling headings (same heading text at same level under same parent)
-  MD024:
-    siblings_only: true
-
-  # Trailing commas in headings (likely typos)
-  MD026:
-    punctuation: ","
-
-  # Bare URLs - may not render as links in all parsers
-  # Should use <url> or [text](url) format
-  MD034: true
-
-  # Spaces inside emphasis markers - breaks rendering
-  # e.g., "* text *" won't render as emphasis
-  MD037: true

package/.nvmrc

@@ -1 +0,0 @@
-22

package/.prettierignore

@@ -1,12 +0,0 @@
-# Test fixtures with intentionally broken/malformed files
-test/fixtures/**
-
-# Contributor Covenant (external standard)
-CODE_OF_CONDUCT.md
-
-# BMAD runtime folders (user-specific, not in repo)
-_bmad/
-_bmad*/
-
-# IDE integration folders (user-specific, not in repo)
-.junie/

package/.vscode/settings.json

@@ -1,96 +0,0 @@
-{
-  "chat.agent.enabled": true,
-  "chat.agent.maxRequests": 15,
-  "github.copilot.chat.agent.runTasks": true,
-  "chat.mcp.discovery.enabled": {
-    "claude-desktop": true,
-    "windsurf": true,
-    "cursor-global": true,
-    "cursor-workspace": true
-  },
-  "github.copilot.chat.agent.autoFix": true,
-  "chat.tools.autoApprove": false,
-  "cSpell.words": [
-    "Agentic",
-    "atlasing",
-    "Biostatistician",
-    "bmad",
-    "Cordova",
-    "customresourcedefinitions",
-    "dashboarded",
-    "Decisioning",
-    "eksctl",
-    "elicitations",
-    "Excalidraw",
-    "filecomplete",
-    "fintech",
-    "fluxcd",
-    "frontmatter",
-    "gamedev",
-    "gitops",
-    "implementability",
-    "Improv",
-    "inclusivity",
-    "ingressgateway",
-    "istioctl",
-    "metroidvania",
-    "NACLs",
-    "nodegroup",
-    "platformconfigs",
-    "Playfocus",
-    "playtesting",
-    "pointerdown",
-    "pointerup",
-    "Polyrepo",
-    "replayability",
-    "roguelike",
-    "roomodes",
-    "Runbook",
-    "runbooks",
-    "Shardable",
-    "Softlock",
-    "solutioning",
-    "speedrunner",
-    "substep",
-    "tekton",
-    "tilemap",
-    "tileset",
-    "tmpl",
-    "Trae",
-    "Unsharded",
-    "VNET"
-  ],
-  "json.schemas": [
-    {
-      "fileMatch": ["package.json"],
-      "url": "https://json.schemastore.org/package.json"
-    },
-    {
-      "fileMatch": [".vscode/settings.json"],
-      "url": "vscode://schemas/settings/folder"
-    }
-  ],
-  "editor.formatOnSave": true,
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-  "[javascript]": {
-    "editor.defaultFormatter": "vscode.typescript-language-features"
-  },
-  "[json]": {
-    "editor.defaultFormatter": "vscode.json-language-features"
-  },
-  "[yaml]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[markdown]": {
-    "editor.defaultFormatter": "yzhang.markdown-all-in-one"
-  },
-  "yaml.format.enable": false,
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": "explicit"
-  },
-  "editor.rulers": [140],
-  "[xml]": {
-    "editor.defaultFormatter": "redhat.vscode-xml"
-  },
-  "xml.format.maxLineWidth": 140
-}