bmalph 1.0.0 → 2.2.1

package/bmad/bmm/workflows/testarch/trace/workflow.yaml

@@ -1,57 +0,0 @@
-# Test Architect workflow: trace (enhanced with gate decision)
-name: testarch-trace
-description: "Generate requirements-to-tests traceability matrix, analyze coverage, and make quality gate decision (PASS/CONCERNS/FAIL/WAIVED)"
-author: "BMad"
-
-# Critical variables from config
-config_source: "{project-root}/_bmad/bmm/config.yaml"
-output_folder: "{config_source}:output_folder"
-user_name: "{config_source}:user_name"
-communication_language: "{config_source}:communication_language"
-document_output_language: "{config_source}:document_output_language"
-date: system-generated
-
-# Workflow components
-installed_path: "{project-root}/_bmad/bmm/workflows/testarch/trace"
-instructions: "{installed_path}/instructions.md"
-validation: "{installed_path}/checklist.md"
-template: "{installed_path}/trace-template.md"
-
-# Variables and inputs
-variables:
-  # Directory paths
-  test_dir: "{project-root}/tests" # Root test directory
-  source_dir: "{project-root}/src" # Source code directory
-
-  # Workflow behavior
-  coverage_levels: "e2e,api,component,unit" # Which test levels to trace
-  gate_type: "story" # story | epic | release | hotfix - determines gate scope
-  decision_mode: "deterministic" # deterministic (rule-based) | manual (team decision)
-
-# Output configuration
-default_output_file: "{output_folder}/traceability-matrix.md"
-
-# Required tools
-required_tools:
-  - read_file # Read story, test files, BMad artifacts
-  - write_file # Create traceability matrix, gate YAML
-  - list_files # Discover test files
-  - search_repo # Find tests by test ID, describe blocks
-  - glob # Find test files matching patterns
-
-tags:
-  - qa
-  - traceability
-  - test-architect
-  - coverage
-  - requirements
-  - gate
-  - decision
-  - release
-
-execution_hints:
-  interactive: false # Minimize prompts
-  autonomous: true # Proceed without user input unless blocked
-  iterative: true
-
-web_bundle: false

package/bmad/core/resources/excalidraw/README.md

@@ -1,160 +0,0 @@
-# Core Excalidraw Resources
-
-Universal knowledge for creating Excalidraw diagrams. All agents that create Excalidraw files should reference these resources.
-
-## Purpose
-
-Provides the **HOW** (universal knowledge) while agents provide the **WHAT** (domain-specific application).
-
-**Core = "How to create Excalidraw elements"**
-
-- How to group shapes with text labels
-- How to calculate text width
-- How to create arrows with proper bindings
-- How to validate JSON syntax
-- Base structure and primitives
-
-**Agents = "What diagrams to create"**
-
-- Frame Expert (BMM): Technical flowcharts, architecture diagrams, wireframes
-- Presentation Master (CIS): Pitch decks, creative visuals, Rube Goldberg machines
-- Tech Writer (BMM): Documentation diagrams, concept explanations
-
-## Files in This Directory
-
-### excalidraw-helpers.md
-
-**Universal element creation patterns**
-
-- Text width calculation
-- Element grouping rules (shapes + labels)
-- Grid alignment
-- Arrow creation (straight, elbow)
-- Theme application
-- Validation checklist
-- Optimization rules
-
-**Agents reference this to:**
-
-- Create properly grouped shapes
-- Calculate text dimensions
-- Connect elements with arrows
-- Ensure valid structure
-
-### validate-json-instructions.md
-
-**Universal JSON validation process**
-
-- How to validate Excalidraw JSON
-- Common errors and fixes
-- Workflow integration
-- Error recovery
-
-**Agents reference this to:**
-
-- Validate files after creation
-- Fix syntax errors
-- Ensure files can be opened in Excalidraw
-
-### library-loader.md (Future)
-
-**How to load external .excalidrawlib files**
-
-- Programmatic library loading
-- Community library integration
-- Custom library management
-
-**Status:** To be developed when implementing external library support.
-
-## How Agents Use These Resources
-
-### Example: Frame Expert (Technical Diagrams)
-
-```yaml
-# workflows/excalidraw-diagrams/create-flowchart/workflow.yaml
-helpers: '{project-root}/_bmad/core/resources/excalidraw/excalidraw-helpers.md'
-json_validation: '{project-root}/_bmad/core/resources/excalidraw/validate-json-instructions.md'
-```
-
-**Domain-specific additions:**
-
-```yaml
-# workflows/excalidraw-diagrams/_shared/flowchart-templates.yaml
-flowchart:
-  start_node:
-    type: ellipse
-    width: 120
-    height: 60
-  process_box:
-    type: rectangle
-    width: 160
-    height: 80
-  decision_diamond:
-    type: diamond
-    width: 140
-    height: 100
-```
-
-### Example: Presentation Master (Creative Visuals)
-
-```yaml
-# workflows/create-visual-metaphor/workflow.yaml
-helpers: '{project-root}/_bmad/core/resources/excalidraw/excalidraw-helpers.md'
-json_validation: '{project-root}/_bmad/core/resources/excalidraw/validate-json-instructions.md'
-```
-
-**Domain-specific additions:**
-
-```yaml
-# workflows/_shared/creative-templates.yaml
-rube_goldberg:
-  whimsical_connector:
-    type: arrow
-    strokeStyle: dashed
-    roughness: 2
-  playful_box:
-    type: rectangle
-    roundness: 12
-```
-
-## What Doesn't Belong in Core
-
-**Domain-Specific Elements:**
-
-- Flowchart-specific templates (belongs in Frame Expert)
-- Pitch deck layouts (belongs in Presentation Master)
-- Documentation-specific styles (belongs in Tech Writer)
-
-**Agent Workflows:**
-
-- How to create a flowchart (Frame Expert workflow)
-- How to create a pitch deck (Presentation Master workflow)
-- Step-by-step diagram creation (agent-specific)
-
-**Theming:**
-
-- Currently in agent workflows
-- **Future:** Will be refactored to core as user-configurable themes
-
-## Architecture Principle
-
-**Single Source of Truth:**
-
-- Core holds universal knowledge
-- Agents reference core, don't duplicate
-- Updates to core benefit all agents
-- Agents specialize with domain knowledge
-
-**DRY (Don't Repeat Yourself):**
-
-- Element creation logic: ONCE in core
-- Text width calculation: ONCE in core
-- Validation process: ONCE in core
-- Arrow binding patterns: ONCE in core
-
-## Future Enhancements
-
-1. **External Library Loader** - Load .excalidrawlib files from libraries.excalidraw.com
-2. **Theme Management** - User-configurable color themes saved in core
-3. **Component Library** - Shared reusable components across agents
-4. **Layout Algorithms** - Auto-layout helpers for positioning elements

package/bmad/core/resources/excalidraw/excalidraw-helpers.md

@@ -1,127 +0,0 @@
-# Excalidraw Element Creation Guidelines
-
-## Text Width Calculation
-
-For text elements inside shapes (labels):
-
-```
-text_width = (text.length × fontSize × 0.6) + 20
-```
-
-Round to nearest 10 for grid alignment.
-
-## Element Grouping Rules
-
-**CRITICAL:** When creating shapes with labels:
-
-1. Generate unique IDs:
-   - `shape-id` for the shape
-   - `text-id` for the text
-   - `group-id` for the group
-
-2. Shape element must have:
-   - `groupIds: [group-id]`
-   - `boundElements: [{type: "text", id: text-id}]`
-
-3. Text element must have:
-   - `containerId: shape-id`
-   - `groupIds: [group-id]` (SAME as shape)
-   - `textAlign: "center"`
-   - `verticalAlign: "middle"`
-   - `width: calculated_width`
-
-## Grid Alignment
-
-- Snap all `x`, `y` coordinates to 20px grid
-- Formula: `Math.round(value / 20) * 20`
-- Spacing between elements: 60px minimum
-
-## Arrow Creation
-
-### Straight Arrows
-
-Use for forward flow (left-to-right, top-to-bottom):
-
-```json
-{
-  "type": "arrow",
-  "startBinding": {
-    "elementId": "source-shape-id",
-    "focus": 0,
-    "gap": 10
-  },
-  "endBinding": {
-    "elementId": "target-shape-id",
-    "focus": 0,
-    "gap": 10
-  },
-  "points": [[0, 0], [distance_x, distance_y]]
-}
-```
-
-### Elbow Arrows
-
-Use for upward flow, backward flow, or complex routing:
-
-```json
-{
-  "type": "arrow",
-  "startBinding": {...},
-  "endBinding": {...},
-  "points": [
-    [0, 0],
-    [intermediate_x, 0],
-    [intermediate_x, intermediate_y],
-    [final_x, final_y]
-  ],
-  "elbowed": true
-}
-```
-
-### Update Connected Shapes
-
-After creating arrow, update `boundElements` on both connected shapes:
-
-```json
-{
-  "id": "shape-id",
-  "boundElements": [
-    { "type": "text", "id": "text-id" },
-    { "type": "arrow", "id": "arrow-id" }
-  ]
-}
-```
-
-## Theme Application
-
-Theme colors should be applied consistently:
-
-- **Shapes**: `backgroundColor` from theme primary fill
-- **Borders**: `strokeColor` from theme accent
-- **Text**: `strokeColor` = "#1e1e1e" (dark text)
-- **Arrows**: `strokeColor` from theme accent
-
-## Validation Checklist
-
-Before saving, verify:
-
-- [ ] All shapes with labels have matching `groupIds`
-- [ ] All text elements have `containerId` pointing to parent shape
-- [ ] Text width calculated properly (no cutoff)
-- [ ] Text alignment set (`textAlign` + `verticalAlign`)
-- [ ] All elements snapped to 20px grid
-- [ ] All arrows have `startBinding` and `endBinding`
-- [ ] `boundElements` array updated on connected shapes
-- [ ] Theme colors applied consistently
-- [ ] No metadata or history in final output
-- [ ] All IDs are unique
-
-## Optimization
-
-Remove from final output:
-
-- `appState` object
-- `files` object (unless images used)
-- All elements with `isDeleted: true`
-- Unused library items
-- Version history

package/bmad/core/resources/excalidraw/library-loader.md

@@ -1,50 +0,0 @@
-# External Library Loader
-
-**Status:** Placeholder for future implementation
-
-## Purpose
-
-Load external .excalidrawlib files from <https://libraries.excalidraw.com> or custom sources.
-
-## Planned Capabilities
-
-- Load libraries by URL
-- Load libraries from local files
-- Merge multiple libraries
-- Filter library components
-- Cache loaded libraries
-
-## API Reference
-
-Will document how to use:
-
-- `importLibrary(url)` - Load library from URL
-- `loadSceneOrLibraryFromBlob()` - Load from file
-- `mergeLibraryItems()` - Combine libraries
-
-## Usage Example
-
-```yaml
-# Future workflow.yaml structure
-libraries:
-  - url: 'https://libraries.excalidraw.com/libraries/...'
-    filter: ['aws', 'cloud']
-  - path: '{project-root}/_data/custom-library.excalidrawlib'
-```
-
-## Implementation Notes
-
-This will be developed when agents need to leverage the extensive library ecosystem available at <https://libraries.excalidraw.com>.
-
-Hundreds of pre-built component libraries exist for:
-
-- AWS/Cloud icons
-- UI/UX components
-- Business diagrams
-- Mind map shapes
-- Floor plans
-- And much more...
-
-## User Configuration
-
-Future: Users will be able to configure favorite libraries in their BMAD config for automatic loading.

package/bmad/core/resources/excalidraw/validate-json-instructions.md

@@ -1,79 +0,0 @@
-# JSON Validation Instructions
-
-## Purpose
-
-Validate Excalidraw JSON files after saving to catch syntax errors (missing commas, brackets, quotes).
-
-## How to Validate
-
-Use Node.js built-in JSON parsing to validate the file:
-
-```bash
-node -e "JSON.parse(require('fs').readFileSync('FILE_PATH', 'utf8')); console.log('✓ Valid JSON')"
-```
-
-Replace `FILE_PATH` with the actual file path.
-
-## Exit Codes
-
-- Exit code 0 = Valid JSON
-- Exit code 1 = Invalid JSON (syntax error)
-
-## Error Output
-
-If invalid, Node.js will output:
-
-- Error message with description
-- Position in file where error occurred
-- Line and column information (if available)
-
-## Common Errors and Fixes
-
-### Missing Comma
-
-```
-SyntaxError: Expected ',' or '}' after property value
-```
-
-**Fix:** Add comma after the property value
-
-### Missing Bracket/Brace
-
-```
-SyntaxError: Unexpected end of JSON input
-```
-
-**Fix:** Add missing closing bracket `]` or brace `}`
-
-### Extra Comma (Trailing)
-
-```
-SyntaxError: Unexpected token ,
-```
-
-**Fix:** Remove the trailing comma before `]` or `}`
-
-### Missing Quote
-
-```
-SyntaxError: Unexpected token
-```
-
-**Fix:** Add missing quote around string value
-
-## Workflow Integration
-
-After saving an Excalidraw file, run validation:
-
-1. Save the file
-2. Run: `node -e "JSON.parse(require('fs').readFileSync('{{save_location}}', 'utf8')); console.log('✓ Valid JSON')"`
-3. If validation fails:
-   - Read the error message for line/position
-   - Open the file at that location
-   - Fix the syntax error
-   - Save and re-validate
-4. Repeat until validation passes
-
-## Critical Rule
-
-**NEVER delete the file due to validation errors - always fix the syntax error at the reported location.**

package/bmad/core/tasks/bmad-help.md

@@ -1,62 +0,0 @@
----
-name: bmad-help
-description: Get unstuck by showing what workflow steps come next or answering questions about what to do
-standalone: true
----
-
-# Task: BMAD Help
-
-## KEY RULES
-
-- **Empty `phase` = anytime** — Universal tools work regardless of workflow state
-- **Numbered phases indicate sequence** — Phases like `1-discover` → `2-define` → `3-build` → `4-ship` flow in order (naming varies by module)
-- **Stay in module** — Guide through the active module's workflow based on phase+sequence ordering
-- **Descriptions contain routing** — Read for alternate paths (e.g., "back to previous if fixes needed")
-- **`required=true` blocks progress** — Required workflows must complete before proceeding to later phases
-- **Artifacts reveal completion** — Search resolved output paths for `outputs` patterns, fuzzy-match found files to workflow rows
-
-## MODULE DETECTION
-
-- **Empty `module` column** → universal tools (work across all modules)
-- **Named `module`** → module-specific workflows
-
-Detect the active module from conversation context, recent workflows, or user query keywords. If ambiguous, ask the user.
-
-## INPUT ANALYSIS
-
-Determine what was just completed:
-- Did someone state they completed something? Proceed as if that was the input.
-- Was a workflow just completed in this conversation? Proceed as if that was the input.
-- Search resolved artifact locations for files; fuzzy-match to workflow `outputs` patterns.
-- If an `index.md` exists, read it for additional context.
-- If still unclear, ask: "What workflow did you most recently complete?"
-
-## EXECUTION
-
-1. **Load catalog** — Load `{project-root}/_bmad/_config/bmad-help.csv`
-
-2. **Resolve output locations** — Scan each folder under `_bmad/` (except `_config`) for `config.yaml`. For each workflow row, resolve its `output-location` variables against that module's config so artifact paths can be searched.
-
-3. **Analyze input** — Task may provide a workflow name/code, conversational phrase, or nothing. Infer what was just completed using INPUT ANALYSIS above.
-
-4. **Detect active module** — Use MODULE DETECTION above to determine which module the user is working in.
-
-5. **Present recommendations** — Show next steps based on completed workflows, phase/sequence ordering (KEY RULES), and artifact detection. Format per the following
-
-## RECOMMENDED OUTPUT FORMAT
-
-   **Optional items first** — List optional workflows until a required step is reached
-   **Required items next** — List the next required workflow
-   For each item show:
-   - Workflow **name**
-   - **Command** (prefixed with `/`, e.g., `/bmad:example:build-prototype`)
-   - **Agent** title and display name from the CSV (e.g., "🎨 Alex (Designer)")
-   - Brief **description**
-
-   ### Additional response output guidance to convey:
-   - Run each workflow in a **fresh context window**
-   - Load the agent using (`/` + `agent-command`), or run the workflow command directly
-   - For **validation workflows**: recommend using a different high-quality LLM if available
-   - For conversational requests: match the user's tone while presenting clearly
-
-6. Return to the calling process after presenting recommendations.

package/dist/commands/guide.d.ts

@@ -1 +0,0 @@
-export declare function guideCommand(): void;

package/dist/commands/guide.js

@@ -1,19 +0,0 @@
-import chalk from "chalk";
-export function guideCommand() {
-    console.log(chalk.bold("\nBMALPH Workflow\n"));
-    console.log(chalk.blue("  BMAD — Structured Planning"));
-    console.log(chalk.dim("  ─────────────────────────────────────────"));
-    console.log(`  Phase 1  Analysis        Requirements, research, risks`);
-    console.log(`  Phase 2  Planning        PRD, stories, MVP scope`);
-    console.log(`  Phase 3  Design          Architecture, data model, API\n`);
-    console.log(chalk.blue("  Ralph — Autonomous Implementation"));
-    console.log(chalk.dim("  ─────────────────────────────────────────"));
-    console.log(`  Phase 4  Implementation  TDD build, code review, validation\n`);
-    console.log(chalk.dim("  Each phase runs iteratively with human checkpoints."));
-    console.log(chalk.dim("  The loop detects completion and advances automatically.\n"));
-    console.log("Commands:");
-    console.log(`  ${chalk.cyan("bmalph start")}       Begin from Phase 1`);
-    console.log(`  ${chalk.cyan("bmalph status")}      Check current progress`);
-    console.log(`  ${chalk.cyan("bmalph resume")}      Continue from last checkpoint`);
-    console.log(`  ${chalk.cyan("/bmalph")}            Interactive mode in Claude Code`);
-}

package/dist/commands/implement.d.ts

@@ -1 +0,0 @@
-export declare function implementCommand(): Promise<void>;

package/dist/commands/implement.js

@@ -1,83 +0,0 @@
-import chalk from "chalk";
-import { spawn } from "child_process";
-import { access } from "fs/promises";
-import { join } from "path";
-import { readState, writeState } from "../utils/state.js";
-import { isInitialized } from "../installer.js";
-import { runTransition } from "../transition.js";
-export async function implementCommand() {
-    try {
-        await runImplement();
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        console.error(chalk.red(`Error: ${message}`));
-        process.exit(1);
-    }
-}
-async function runImplement() {
-    const projectDir = process.cwd();
-    if (!(await isInitialized(projectDir))) {
-        console.log(chalk.red("bmalph is not initialized. Run 'bmalph init' first."));
-        return;
-    }
-    // Check if Ralph loop script exists
-    const loopScript = join(projectDir, ".ralph/ralph_loop.sh");
-    try {
-        await access(loopScript);
-    }
-    catch {
-        console.log(chalk.red("Ralph loop script not found at .ralph/ralph_loop.sh"));
-        console.log("Run 'bmalph init' to install Ralph.");
-        return;
-    }
-    // Run transition: BMAD artifacts → Ralph inputs
-    console.log(chalk.blue("Transitioning BMAD artifacts to Ralph format..."));
-    try {
-        const result = await runTransition(projectDir);
-        if (result.fixPlanPreserved) {
-            console.log(chalk.green("Preserved existing @fix_plan.md (has progress)"));
-        }
-        else {
-            console.log(chalk.green(`Generated fix_plan.md with ${result.storiesCount} stories`));
-        }
-        for (const warning of result.warnings) {
-            console.log(chalk.yellow(`Warning: ${warning}`));
-        }
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        console.log(chalk.red(`Transition failed: ${message}`));
-        return;
-    }
-    // Update state
-    const now = new Date().toISOString();
-    const state = await readState(projectDir);
-    const newState = {
-        currentPhase: 4,
-        status: "implementing",
-        startedAt: state?.startedAt ?? now,
-        lastUpdated: now,
-    };
-    await writeState(projectDir, newState);
-    // Start Ralph loop
-    console.log(chalk.blue("\nStarting Ralph autonomous loop..."));
-    console.log(chalk.dim("Press Ctrl+C to stop the loop.\n"));
-    const child = spawn("bash", [loopScript], {
-        cwd: projectDir,
-        stdio: "inherit",
-        env: { ...process.env, RALPH_DIR: join(projectDir, ".ralph") },
-    });
-    child.on("close", (code) => {
-        if (code === 0) {
-            console.log(chalk.green("\nRalph loop completed successfully."));
-        }
-        else {
-            console.log(chalk.yellow(`\nRalph loop exited with code ${code}`));
-        }
-    });
-    child.on("error", (err) => {
-        console.log(chalk.red(`Failed to start Ralph loop: ${err.message}`));
-        console.log(chalk.dim("Ensure bash is available and ralph_loop.sh is executable."));
-    });
-}

package/dist/commands/plan.d.ts

@@ -1,5 +0,0 @@
-interface PlanOptions {
-    phase?: string;
-}
-export declare function planCommand(options: PlanOptions): Promise<void>;
-export {};