BMAD-METHOD

Commit Graph

Author	SHA1	Message	Date
Michael Pursifull	961a892578	feat: add line numbers, fix utility/ path mapping, improve verbose output - Add utility/ to direct path mapping (was incorrectly falling through to src/modules/utility/) - Show line numbers for broken references in markdown files - Show YAML key path for broken references in YAML files - Print file headers in verbose mode for all files with refs	2026-01-31 15:03:06 -06:00
Michael Pursifull	1b863ee9c7	feat: strip JSON example blocks to reduce false-positive broken refs Add stripJsonExampleBlocks() to the markdown reference extractor so bare JSON example/template blocks (braces on their own lines) are removed before pattern matching. This prevents paths inside example data from being flagged as broken references.	2026-01-31 15:02:52 -06:00
Michael Pursifull	8a91b32315	feat: add cross-file reference validator for CI Add tools/validate-file-refs.js that validates cross-file references in BMAD source files (agents, workflows, tasks, steps). Catches broken file paths, missing referenced files, wrong extensions, and absolute path leaks before they reach users. Addresses broken-file-ref and path-handling bug classes which account for 25% of all historical bugs (59 closed issues, 129+ comments). - Scans src/ for YAML, markdown, and XML files - Validates {project-root}/_bmad/ references against source tree - Checks relative path references, exec attributes, invoke-task tags - Detects absolute path leaks (/Users/, /home/, C:\) - Adds validate:refs npm script and CI step in quality.yaml	2026-01-31 15:02:42 -06:00

Author

SHA1

Message

Date

Michael Pursifull

961a892578

feat: add line numbers, fix utility/ path mapping, improve verbose output

- Add utility/ to direct path mapping (was incorrectly falling through
  to src/modules/utility/)
- Show line numbers for broken references in markdown files
- Show YAML key path for broken references in YAML files
- Print file headers in verbose mode for all files with refs

2026-01-31 15:03:06 -06:00

Michael Pursifull

1b863ee9c7

feat: strip JSON example blocks to reduce false-positive broken refs

Add stripJsonExampleBlocks() to the markdown reference extractor so
bare JSON example/template blocks (braces on their own lines) are
removed before pattern matching. This prevents paths inside example
data from being flagged as broken references.

2026-01-31 15:02:52 -06:00

Michael Pursifull

8a91b32315

feat: add cross-file reference validator for CI

Add tools/validate-file-refs.js that validates cross-file references
in BMAD source files (agents, workflows, tasks, steps). Catches broken
file paths, missing referenced files, wrong extensions, and absolute
path leaks before they reach users.

Addresses broken-file-ref and path-handling bug classes which account
for 25% of all historical bugs (59 closed issues, 129+ comments).

- Scans src/ for YAML, markdown, and XML files
- Validates {project-root}/_bmad/ references against source tree
- Checks relative path references, exec attributes, invoke-task tags
- Detects absolute path leaks (/Users/, /home/, C:\)
- Adds validate:refs npm script and CI step in quality.yaml

2026-01-31 15:02:42 -06:00

3 Commits