agentvibes 2.17.1 → 2.17.2

package/.bmad/bmm/workflows/document-project/workflows/full-scan.yaml

@@ -1,31 +0,0 @@
-# Full Project Scan Workflow Configuration
-name: "document-project-full-scan"
-description: "Complete project documentation workflow (initial scan or full rescan)"
-author: "BMad"
-
-# This is a sub-workflow called by document-project/workflow.yaml
-parent_workflow: "{project-root}/.bmad/bmm/workflows/document-project/workflow.yaml"
-
-# Critical variables inherited from parent
-config_source: "{project-root}/.bmad/bmb/config.yaml"
-output_folder: "{config_source}:output_folder"
-user_name: "{config_source}:user_name"
-date: system-generated
-
-# Data files
-documentation_requirements_csv: "{project-root}/.bmad/bmm/workflows/document-project/documentation-requirements.csv"
-
-# Module path and component files
-installed_path: "{project-root}/.bmad/bmm/workflows/document-project/workflows"
-template: false # Action workflow
-instructions: "{installed_path}/full-scan-instructions.md"
-validation: "{project-root}/.bmad/bmm/workflows/document-project/checklist.md"
-
-# Runtime inputs (passed from parent workflow)
-workflow_mode: "" # "initial_scan" or "full_rescan"
-scan_level: "" # "quick", "deep", or "exhaustive"
-resume_mode: false
-project_root_path: ""
-
-# Configuration
-autonomous: false # Requires user input at key decision points

package/.bmad/bmm/workflows/frame-expert/_shared/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/bmm/workflows/frame-expert/_shared/excalidraw-library.json

@@ -1,90 +0,0 @@
-{
-  "type": "excalidrawlib",
-  "version": 2,
-  "library": [
-    {
-      "id": "start-end-circle",
-      "status": "published",
-      "elements": [
-        {
-          "type": "ellipse",
-          "width": 120,
-          "height": 60,
-          "strokeColor": "#1976d2",
-          "backgroundColor": "#e3f2fd",
-          "fillStyle": "solid",
-          "strokeWidth": 2,
-          "roughness": 0
-        }
-      ]
-    },
-    {
-      "id": "process-rectangle",
-      "status": "published",
-      "elements": [
-        {
-          "type": "rectangle",
-          "width": 160,
-          "height": 80,
-          "strokeColor": "#1976d2",
-          "backgroundColor": "#e3f2fd",
-          "fillStyle": "solid",
-          "strokeWidth": 2,
-          "roughness": 0,
-          "roundness": {
-            "type": 3,
-            "value": 8
-          }
-        }
-      ]
-    },
-    {
-      "id": "decision-diamond",
-      "status": "published",
-      "elements": [
-        {
-          "type": "diamond",
-          "width": 140,
-          "height": 100,
-          "strokeColor": "#f57c00",
-          "backgroundColor": "#fff3e0",
-          "fillStyle": "solid",
-          "strokeWidth": 2,
-          "roughness": 0
-        }
-      ]
-    },
-    {
-      "id": "data-store",
-      "status": "published",
-      "elements": [
-        {
-          "type": "rectangle",
-          "width": 140,
-          "height": 80,
-          "strokeColor": "#388e3c",
-          "backgroundColor": "#e8f5e9",
-          "fillStyle": "solid",
-          "strokeWidth": 2,
-          "roughness": 0
-        }
-      ]
-    },
-    {
-      "id": "external-entity",
-      "status": "published",
-      "elements": [
-        {
-          "type": "rectangle",
-          "width": 120,
-          "height": 80,
-          "strokeColor": "#7b1fa2",
-          "backgroundColor": "#f3e5f5",
-          "fillStyle": "solid",
-          "strokeWidth": 3,
-          "roughness": 0
-        }
-      ]
-    }
-  ]
-}

package/.bmad/bmm/workflows/frame-expert/_shared/excalidraw-templates.yaml

@@ -1,127 +0,0 @@
-flowchart:
-  viewport:
-    x: 0
-    y: 0
-    zoom: 1
-  grid:
-    size: 20
-  spacing:
-    vertical: 100
-    horizontal: 180
-  elements:
-    start:
-      type: ellipse
-      width: 120
-      height: 60
-      label: "Start"
-    process:
-      type: rectangle
-      width: 160
-      height: 80
-      roundness: 8
-    decision:
-      type: diamond
-      width: 140
-      height: 100
-    end:
-      type: ellipse
-      width: 120
-      height: 60
-      label: "End"
-
-diagram:
-  viewport:
-    x: 0
-    y: 0
-    zoom: 1
-  grid:
-    size: 20
-  spacing:
-    vertical: 120
-    horizontal: 200
-  elements:
-    component:
-      type: rectangle
-      width: 180
-      height: 100
-      roundness: 8
-    database:
-      type: rectangle
-      width: 140
-      height: 80
-    service:
-      type: rectangle
-      width: 160
-      height: 90
-      roundness: 12
-    external:
-      type: rectangle
-      width: 140
-      height: 80
-
-wireframe:
-  viewport:
-    x: 0
-    y: 0
-    zoom: 0.8
-  grid:
-    size: 20
-  spacing:
-    vertical: 40
-    horizontal: 40
-  elements:
-    container:
-      type: rectangle
-      width: 800
-      height: 600
-      strokeStyle: solid
-      strokeWidth: 2
-    header:
-      type: rectangle
-      width: 800
-      height: 80
-    button:
-      type: rectangle
-      width: 120
-      height: 40
-      roundness: 4
-    input:
-      type: rectangle
-      width: 300
-      height: 40
-      roundness: 4
-    text:
-      type: text
-      fontSize: 16
-
-dataflow:
-  viewport:
-    x: 0
-    y: 0
-    zoom: 1
-  grid:
-    size: 20
-  spacing:
-    vertical: 120
-    horizontal: 200
-  elements:
-    process:
-      type: ellipse
-      width: 140
-      height: 80
-      label: "Process"
-    datastore:
-      type: rectangle
-      width: 140
-      height: 80
-      label: "Data Store"
-    external:
-      type: rectangle
-      width: 120
-      height: 80
-      strokeWidth: 3
-      label: "External Entity"
-    dataflow:
-      type: arrow
-      strokeWidth: 2
-      label: "Data Flow"

package/.bmad/bmm/workflows/frame-expert/_shared/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/bmm/workflows/frame-expert/create-dataflow/checklist.md

@@ -1,39 +0,0 @@
-# Create Data Flow Diagram - Validation Checklist
-
-## DFD Notation
-
-- [ ] Processes shown as circles/ellipses
-- [ ] Data stores shown as parallel lines or rectangles
-- [ ] External entities shown as rectangles
-- [ ] Data flows shown as labeled arrows
-- [ ] Follows standard DFD notation
-
-## Structure
-
-- [ ] All processes numbered correctly
-- [ ] All data flows labeled with data names
-- [ ] All data stores named appropriately
-- [ ] External entities clearly identified
-
-## Completeness
-
-- [ ] All inputs and outputs accounted for
-- [ ] No orphaned processes (unconnected)
-- [ ] Data conservation maintained
-- [ ] Level appropriate (context/level 0/level 1)
-
-## Layout
-
-- [ ] Logical flow direction (left to right, top to bottom)
-- [ ] No crossing data flows where avoidable
-- [ ] Balanced layout
-- [ ] Grid alignment maintained
-
-## Technical Quality
-
-- [ ] All elements properly grouped
-- [ ] Arrows have proper bindings
-- [ ] Text readable and properly sized
-- [ ] No elements with `isDeleted: true`
-- [ ] JSON is valid
-- [ ] File saved to correct location

package/.bmad/bmm/workflows/frame-expert/create-dataflow/instructions.md

@@ -1,131 +0,0 @@
-# Create Data Flow Diagram - Workflow Instructions
-
-```xml
-<critical>The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml</critical>
-<critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
-<critical>This workflow creates data flow diagrams (DFD) in Excalidraw format.</critical>
-
-<workflow>
-
-  <step n="0" goal="Contextual Analysis">
-    <action>Review user's request and extract: DFD level, processes, data stores, external entities, save location</action>
-    <check if="ALL requirements clear"><action>Skip to Step 4</action></check>
-  </step>
-
-  <step n="1" goal="Identify DFD Level" elicit="true">
-    <action>Ask: "What level of DFD do you need?"</action>
-    <action>Present options:
-      1. Context Diagram (Level 0) - Single process showing system boundaries
-      2. Level 1 DFD - Major processes and data flows
-      3. Level 2 DFD - Detailed sub-processes
-      4. Custom - Specify your requirements
-    </action>
-    <action>WAIT for selection, store in {{dfd_level}}</action>
-  </step>
-
-  <step n="2" goal="Gather Requirements" elicit="true">
-    <action>Ask process count</action>
-    <action>Ask data store count</action>
-    <action>Ask external entity count</action>
-    <action>Ask save location</action>
-  </step>
-
-  <step n="3" goal="Theme Setup" elicit="true">
-    <action>Check for existing theme.json, ask to use if exists</action>
-    <check if="no existing theme">
-      <action>Ask: "Choose a DFD color scheme:"</action>
-      <action>Present numbered options:
-        1. Standard DFD
-           - Process: #e3f2fd (light blue)
-           - Data Store: #e8f5e9 (light green)
-           - External Entity: #f3e5f5 (light purple)
-           - Border: #1976d2 (blue)
-
-        2. Colorful DFD
-           - Process: #fff9c4 (light yellow)
-           - Data Store: #c5e1a5 (light lime)
-           - External Entity: #ffccbc (light coral)
-           - Border: #f57c00 (orange)
-
-        3. Minimal DFD
-           - Process: #f5f5f5 (light gray)
-           - Data Store: #eeeeee (gray)
-           - External Entity: #e0e0e0 (medium gray)
-           - Border: #616161 (dark gray)
-
-        4. Custom - Define your own colors
-      </action>
-      <action>WAIT for selection</action>
-      <action>Create theme.json based on selection</action>
-    </check>
-  </step>
-
-  <step n="4" goal="Plan DFD Structure">
-    <action>List all processes with numbers (1.0, 2.0, etc.)</action>
-    <action>List all data stores (D1, D2, etc.)</action>
-    <action>List all external entities</action>
-    <action>Map all data flows with labels</action>
-    <action>Show planned structure, confirm with user</action>
-  </step>
-
-  <step n="5" goal="Load Resources">
-    <action>Load {{templates}} and extract `dataflow` section</action>
-    <action>Load {{library}}</action>
-    <action>Load theme.json</action>
-    <action>Load {{helpers}}</action>
-  </step>
-
-  <step n="6" goal="Build DFD Elements">
-    <critical>Follow standard DFD notation from {{helpers}}</critical>
-
-    <substep>Build Order:
-      1. External entities (rectangles, bold border)
-      2. Processes (circles/ellipses with numbers)
-      3. Data stores (parallel lines or rectangles)
-      4. Data flows (labeled arrows)
-    </substep>
-
-    <substep>DFD Rules:
-      - Processes: Numbered (1.0, 2.0), verb phrases
-      - Data stores: Named (D1, D2), noun phrases
-      - External entities: Named, noun phrases
-      - Data flows: Labeled with data names, arrows show direction
-      - No direct flow between external entities
-      - No direct flow between data stores
-    </substep>
-
-    <substep>Layout:
-      - External entities at edges
-      - Processes in center
-      - Data stores between processes
-      - Minimize crossing flows
-      - Left-to-right or top-to-bottom flow
-    </substep>
-  </step>
-
-  <step n="7" goal="Optimize and Save">
-    <action>Verify DFD rules compliance</action>
-    <action>Strip unused elements and elements with isDeleted: true</action>
-    <action>Save to {{save_location}}</action>
-  </step>
-
-  <step n="8" goal="Validate JSON Syntax">
-    <critical>NEVER delete the file if validation fails - always fix syntax errors</critical>
-    <action>Run: node -e "JSON.parse(require('fs').readFileSync('{{save_location}}', 'utf8')); console.log('✓ Valid JSON')"</action>
-    <check if="validation fails (exit code 1)">
-      <action>Read the error message carefully - it shows the syntax error and position</action>
-      <action>Open the file and navigate to the error location</action>
-      <action>Fix the syntax error (add missing comma, bracket, or quote as indicated)</action>
-      <action>Save the file</action>
-      <action>Re-run validation with the same command</action>
-      <action>Repeat until validation passes</action>
-    </check>
-    <action>Once validation passes, confirm with user</action>
-  </step>
-
-  <step n="9" goal="Validate Content">
-    <invoke-task>Validate against {{validation}}</invoke-task>
-  </step>
-
-</workflow>
-```

package/.bmad/bmm/workflows/frame-expert/create-dataflow/workflow.yaml

@@ -1,23 +0,0 @@
-name: create-dataflow
-description: "Create data flow diagrams (DFD) in Excalidraw format"
-author: "BMad"
-
-installed_path: "{project-root}/.bmad/bmm/workflows/frame-expert/create-dataflow"
-shared_path: "{project-root}/.bmad/bmm/workflows/frame-expert/_shared"
-instructions: "{installed_path}/instructions.md"
-validation: "{installed_path}/checklist.md"
-
-helpers: "{shared_path}/excalidraw-helpers.md"
-templates: "{shared_path}/excalidraw-templates.yaml"
-library: "{shared_path}/excalidraw-library.json"
-
-variables:
-  dfd_level: ""
-  process_count: ""
-  datastore_count: ""
-  external_entities: ""
-  save_location: ""
-
-default_output_file: "{project-root}/docs/dataflow/dfd-{timestamp}.excalidraw"
-
-standalone: true

package/.bmad/bmm/workflows/frame-expert/create-diagram/checklist.md

@@ -1,43 +0,0 @@
-# Create Diagram - Validation Checklist
-
-## Element Structure
-
-- [ ] All components with labels have matching `groupIds`
-- [ ] All text elements have `containerId` pointing to parent component
-- [ ] Text width calculated properly (no cutoff)
-- [ ] Text alignment appropriate for diagram type
-
-## Layout and Alignment
-
-- [ ] All elements snapped to 20px grid
-- [ ] Component spacing consistent (40px/60px)
-- [ ] Hierarchical alignment maintained
-- [ ] No overlapping elements
-
-## Connections
-
-- [ ] All arrows have `startBinding` and `endBinding`
-- [ ] `boundElements` array updated on connected components
-- [ ] Arrow routing avoids overlaps
-- [ ] Relationship types clearly indicated
-
-## Notation and Standards
-
-- [ ] Follows specified notation standard (UML/ERD/etc)
-- [ ] Symbols used correctly
-- [ ] Cardinality/multiplicity shown where needed
-- [ ] Labels and annotations clear
-
-## Theme and Styling
-
-- [ ] Theme colors applied consistently
-- [ ] Component types visually distinguishable
-- [ ] Text is readable
-- [ ] Professional appearance
-
-## Output Quality
-
-- [ ] Element count under 80
-- [ ] No elements with `isDeleted: true`
-- [ ] JSON is valid
-- [ ] File saved to correct location