@zeyue0329/xiaoma-cli 1.0.49 → 6.0.0-alpha.13

package/src/modules/xmc/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml

@@ -0,0 +1,26 @@
+# Quick-Flow: Create Tech-Spec
+name: create-tech-spec
+description: "Conversational spec engineering - ask questions, investigate code, produce implementation-ready tech-spec."
+author: "XiaoMa"
+
+# Config
+config_source: "{project-root}/{xiaoma_folder}/xmc/config.yaml"
+output_folder: "{config_source}:output_folder"
+sprint_artifacts: "{config_source}:sprint_artifacts"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+user_skill_level: "{config_source}:user_skill_level"
+date: system-generated
+
+# Workflow components
+installed_path: "{project-root}/{xiaoma_folder}/xmc/workflows/xiaoma-quick-flow/create-tech-spec"
+instructions: "{installed_path}/instructions.md"
+
+# Related workflows
+quick_dev_workflow: "{project-root}/{xiaoma_folder}/xmc/workflows/xiaoma-quick-flow/quick-dev/workflow.yaml"
+party_mode_exec: "{project-root}/{xiaoma_folder}/core/workflows/party-mode/workflow.md"
+advanced_elicitation: "{project-root}/{xiaoma_folder}/core/tasks/advanced-elicitation.xml"
+
+standalone: true
+web_bundle: false

package/src/modules/xmc/workflows/bmad-quick-flow/quick-dev/checklist.md

@@ -0,0 +1,25 @@
+# Quick-Dev Checklist
+
+## Before Implementation
+
+- [ ] Context loaded (tech-spec or user guidance)
+- [ ] Files to modify identified
+- [ ] Patterns understood
+
+## Implementation
+
+- [ ] All tasks completed
+- [ ] Code follows existing patterns
+- [ ] Error handling appropriate
+
+## Testing
+
+- [ ] Tests written (where appropriate)
+- [ ] All tests passing
+- [ ] No regressions
+
+## Completion
+
+- [ ] Acceptance criteria satisfied
+- [ ] Tech-spec updated (if applicable)
+- [ ] Summary provided to user

package/src/modules/xmc/workflows/bmad-quick-flow/quick-dev/instructions.md

@@ -0,0 +1,105 @@
+# Quick-Dev - Flexible Development Workflow
+
+<workflow>
+
+<critical>Communicate in {communication_language}, tailored to {user_skill_level}</critical>
+<critical>Execute continuously until COMPLETE - do not stop for milestones</critical>
+<critical>Flexible - handles tech-specs OR direct instructions</critical>
+<critical>ALWAYS respect {project_context} if it exists - it defines project standards</critical>
+
+<checkpoint-handlers>
+  <on-select key="a">Load and execute {advanced_elicitation}, then return</on-select>
+  <on-select key="p">Load and execute {party_mode_workflow}, then return</on-select>
+  <on-select key="t">Load and execute {create_tech_spec_workflow}</on-select>
+</checkpoint-handlers>
+
+<step n="1" goal="Load project context and determine execution mode">
+
+<action>Check if {project_context} exists. If yes, load it - this is your foundational reference for ALL implementation decisions (patterns, conventions, architecture).</action>
+
+<action>Parse user input:
+
+**Mode A: Tech-Spec** - e.g., `quick-dev tech-spec-auth.md`
+→ Load spec, extract tasks/context/AC, goto step 3
+
+**Mode B: Direct Instructions** - e.g., `refactor src/foo.ts...`
+→ Offer planning choice
+</action>
+
+<check if="Mode A">
+  <action>Load tech-spec, extract tasks/context/AC</action>
+  <goto>step_3</goto>
+</check>
+
+<check if="Mode B">
+  <ask>**[t] Plan first** - Create tech-spec then implement
+**[e] Execute directly** - Start now</ask>
+
+  <check if="t">
+    <action>Load and execute {create_tech_spec_workflow}</action>
+    <action>Continue to implementation after spec complete</action>
+  </check>
+
+  <check if="e">
+    <ask>Any additional guidance before I begin? (patterns, files, constraints) Or "go" to start.</ask>
+    <goto>step_2</goto>
+  </check>
+</check>
+
+</step>
+
+<step n="2" goal="Quick context gathering (direct mode)">
+
+<action>Identify files to modify, find relevant patterns, note dependencies</action>
+
+<action>Create mental plan: tasks, acceptance criteria, files to touch</action>
+
+</step>
+
+<step n="3" goal="Execute implementation" id="step_3">
+
+<action>For each task:
+
+1. **Load Context** - read files from spec or relevant to change
+2. **Implement** - follow patterns, handle errors, follow conventions
+3. **Test** - write tests, run existing tests, verify AC
+4. **Mark Complete** - check off task [x], continue
+   </action>
+
+<action if="3 failures">HALT and request guidance</action>
+<action if="tests fail">Fix before continuing</action>
+
+<critical>Continue through ALL tasks without stopping</critical>
+
+</step>
+
+<step n="4" goal="Verify and complete">
+
+<action>Verify: all tasks [x], tests passing, AC satisfied, patterns followed</action>
+
+<check if="using tech-spec">
+  <action>Update tech-spec status to "Completed", mark all tasks [x]</action>
+</check>
+
+<output>**Implementation Complete!**
+
+**Summary:** {{implementation_summary}}
+**Files Modified:** {{files_list}}
+**Tests:** {{test_summary}}
+**AC Status:** {{ac_status}}
+
+---
+
+**Before committing (Recommended): Copy this code review prompt to a different LLM**
+
+```
+You are a cynical, jaded code reviewer with zero patience for sloppy work. These uncommitted changes were submitted by a clueless weasel and you expect to find problems. Find at least five issues to fix or improve in it. Number them. Be skeptical of everything.
+```
+
+</output>
+
+<action>You must explain what was implemented based on {user_skill_level}</action>
+
+</step>
+
+</workflow>

package/src/modules/xmc/workflows/bmad-quick-flow/quick-dev/workflow.yaml

@@ -0,0 +1,29 @@
+# Quick-Flow: Quick-Dev
+name: quick-dev
+description: "Flexible development - execute tech-specs OR direct instructions with optional planning."
+author: "XiaoMa"
+
+# Config
+config_source: "{project-root}/{xiaoma_folder}/xmc/config.yaml"
+output_folder: "{config_source}:output_folder"
+sprint_artifacts: "{config_source}:sprint_artifacts"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+user_skill_level: "{config_source}:user_skill_level"
+date: system-generated
+
+# Project context
+project_context: "**/project-context.md"
+
+# Workflow components
+installed_path: "{project-root}/{xiaoma_folder}/xmc/workflows/xiaoma-quick-flow/quick-dev"
+instructions: "{installed_path}/instructions.md"
+checklist: "{installed_path}/checklist.md"
+
+# Related workflows
+create_tech_spec_workflow: "{project-root}/{xiaoma_folder}/xmc/workflows/xiaoma-quick-flow/create-tech-spec/workflow.yaml"
+party_mode_exec: "{project-root}/{xiaoma_folder}/core/workflows/party-mode/workflow.md"
+advanced_elicitation: "{project-root}/{xiaoma_folder}/core/tasks/advanced-elicitation.xml"
+
+standalone: true
+web_bundle: false

package/src/modules/xmc/workflows/diagrams/_shared/excalidraw-library.json

@@ -0,0 +1,90 @@
+{
+  "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/src/modules/xmc/workflows/diagrams/_shared/excalidraw-templates.yaml

@@ -0,0 +1,127 @@
+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/src/modules/xmc/workflows/diagrams/create-dataflow/checklist.md

@@ -0,0 +1,39 @@
+# 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/src/modules/xmc/workflows/diagrams/create-dataflow/instructions.md

@@ -0,0 +1,130 @@
+# Create Data Flow Diagram - Workflow Instructions
+
+```xml
+<critical>The workflow execution engine is governed by: {project_root}/{xiaoma_folder}/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</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</action>
+  </step>
+
+  <step n="2" goal="Gather Requirements" elicit="true">
+    <action>Ask: "Describe the processes, data stores, and external entities in your system"</action>
+    <action>WAIT for user description</action>
+    <action>Summarize what will be included and confirm with user</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 {{default_output_file}}</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('{{default_output_file}}', '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/src/modules/xmc/workflows/diagrams/create-dataflow/workflow.yaml

@@ -0,0 +1,27 @@
+name: create-excalidraw-dataflow
+description: "Create data flow diagrams (DFD) in Excalidraw format"
+author: "XiaoMa"
+
+# Config values
+config_source: "{project-root}/{xiaoma_folder}/xmc/config.yaml"
+output_folder: "{config_source}:output_folder"
+
+# Workflow components
+installed_path: "{project-root}/{xiaoma_folder}/xmc/workflows/diagrams/create-dataflow"
+shared_path: "{project-root}/{xiaoma_folder}/xmc/workflows/diagrams/_shared"
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+
+# Core Excalidraw resources (universal knowledge)
+helpers: "{project-root}/{xiaoma_folder}/core/resources/excalidraw/excalidraw-helpers.md"
+json_validation: "{project-root}/{xiaoma_folder}/core/resources/excalidraw/validate-json-instructions.md"
+
+# Domain-specific resources (technical diagrams)
+templates: "{shared_path}/excalidraw-templates.yaml"
+library: "{shared_path}/excalidraw-library.json"
+
+# Output file (respects user's configured output_folder)
+default_output_file: "{output_folder}/diagrams/dataflow-{timestamp}.excalidraw"
+
+standalone: true
+web_bundle: false

package/src/modules/xmc/workflows/diagrams/create-diagram/checklist.md

@@ -0,0 +1,43 @@
+# 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