When scope is set, planning_artifacts and implementation_artifacts resolve
to {output_folder}/{scope}/planning-artifacts/ and
{output_folder}/{scope}/implementation-artifacts/. The output_folder root
stays shared for project-context and brainstorming. Unscoped root folders
remain as the default bucket for quick-dev and unscoped work.
Empty or missing scope preserves current behavior (backward compatible).
Design validated by @alexeyv via Discord.
Fixes#2148
* refactor(installer): restructure installer with clean separation of concerns
Move tools/cli/ to tools/installer/ with major structural cleanup:
- InstallPaths async factory for path resolution and directory creation
- Config value object (frozen) replaces mutable config bag
- ExistingInstall value object replaces stateful Detector class
- OfficialModules + CustomModules + ExternalModuleManager replace monolithic ModuleManager
- install() is prompt-free; all user interaction in ui.js
- Update state returned explicitly instead of mutating customConfig
- Delete dead code: dependency-resolver, _base-ide, IdeConfigManager,
platform-codes helpers, npx wrapper, xml-utils
- Flatten directory structure: custom/handler → custom-handler,
tools/cli/ → tools/installer/, lib/ directories removed
- Update all path references in package.json, tests, CI, and docs
* fix(installer): guard ExistingInstall.version and surface module.yaml errors
Guard ExistingInstall.version access with .installed check in
uninstall.js, ui.js, and installer.js to prevent throwing on
empty/partial _bmad dirs. Surface invalid module.yaml parse errors
as warnings instead of silently returning empty results.
Gani Mohamed Parakadhullah
Alex Verkhovsky