maestro-flow 0.1.0

package/chains/_router.json

@@ -0,0 +1,201 @@
+{
+  "$schema": "./chain-graph.schema.json",
+  "id": "_router",
+  "name": "State Router",
+  "description": "Route to appropriate graph based on project state",
+  "version": "1.0.0",
+  "tags": ["internal", "router"],
+  "entry": "check_init",
+  "inputs": {
+    "phase": { "type": "string", "required": false },
+    "description": { "type": "string", "required": false }
+  },
+  "nodes": {
+    "check_init": {
+      "type": "decision",
+      "eval": "ctx.project.initialized",
+      "edges": [
+        { "value": false, "target": "to_init" },
+        { "default": true, "target": "check_has_roadmap" }
+      ]
+    },
+    "check_has_roadmap": {
+      "type": "decision",
+      "eval": "ctx.project.phases_total",
+      "edges": [
+        { "match": "phases_total == 0", "target": "check_accumulated_context" },
+        { "default": true, "target": "check_phase_status" }
+      ]
+    },
+    "check_accumulated_context": {
+      "type": "decision",
+      "eval": "ctx.project.accumulated_context",
+      "edges": [
+        { "match": "accumulated_context != null", "target": "to_next_milestone" },
+        { "default": true, "target": "to_brainstorm_driven" }
+      ]
+    },
+    "check_phase_status": {
+      "type": "decision",
+      "eval": "ctx.project.phase_status",
+      "edges": [
+        { "value": "pending", "target": "check_pending_artifacts" },
+        { "value": "exploring", "target": "check_has_plan" },
+        { "value": "planning", "target": "check_has_plan" },
+        { "value": "executing", "target": "check_tasks_done" },
+        { "value": "verifying", "target": "check_verification" },
+        { "value": "testing", "target": "check_uat" },
+        { "value": "completed", "target": "check_all_phases" },
+        { "value": "blocked", "target": "to_debug" }
+      ]
+    },
+    "check_pending_artifacts": {
+      "type": "decision",
+      "eval": "ctx.project.artifacts.context",
+      "edges": [
+        { "value": true, "target": "to_plan" },
+        { "default": true, "target": "to_analyze" }
+      ]
+    },
+    "check_has_plan": {
+      "type": "decision",
+      "eval": "ctx.project.artifacts.plan",
+      "edges": [
+        { "value": true, "target": "to_execute_verify" },
+        { "default": true, "target": "to_plan" }
+      ]
+    },
+    "check_tasks_done": {
+      "type": "decision",
+      "eval": "ctx.project.execution.tasks_completed",
+      "edges": [
+        {
+          "match": "tasks_completed >= tasks_total && tasks_total > 0",
+          "target": "to_verify"
+        },
+        { "default": true, "target": "to_execute" }
+      ]
+    },
+    "check_verification": {
+      "type": "decision",
+      "eval": "ctx.project.verification_status",
+      "edges": [
+        { "value": "passed", "target": "check_review_after_verify" },
+        { "default": true, "target": "to_quality_loop_partial" }
+      ]
+    },
+    "check_review_after_verify": {
+      "type": "decision",
+      "eval": "ctx.project.review_verdict",
+      "edges": [
+        { "value": null, "target": "to_review" },
+        { "default": true, "target": "check_uat_after_review" }
+      ]
+    },
+    "check_uat_after_review": {
+      "type": "decision",
+      "eval": "ctx.project.uat_status",
+      "edges": [
+        { "value": "pending", "target": "to_test" },
+        { "value": "passed", "target": "to_phase_transition" },
+        { "default": true, "target": "to_debug_from_uat" }
+      ]
+    },
+    "check_uat": {
+      "type": "decision",
+      "eval": "ctx.project.uat_status",
+      "edges": [
+        { "value": "passed", "target": "to_phase_transition" },
+        { "default": true, "target": "to_debug_from_uat" }
+      ]
+    },
+    "check_all_phases": {
+      "type": "decision",
+      "eval": "ctx.project.phases_completed",
+      "edges": [
+        {
+          "match": "phases_completed >= phases_total",
+          "target": "to_milestone_close"
+        },
+        { "default": true, "target": "to_phase_transition" }
+      ]
+    },
+    "to_init": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "singles/init"
+    },
+    "to_analyze": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "singles/analyze"
+    },
+    "to_plan": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "singles/plan"
+    },
+    "to_execute": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "singles/execute"
+    },
+    "to_verify": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "singles/verify"
+    },
+    "to_review": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "singles/review"
+    },
+    "to_test": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "singles/test"
+    },
+    "to_debug": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "singles/debug"
+    },
+    "to_debug_from_uat": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "singles/debug",
+      "delegate_inputs": { "args_prefix": "--from-uat" }
+    },
+    "to_execute_verify": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "execute-verify"
+    },
+    "to_phase_transition": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "singles/phase-transition"
+    },
+    "to_milestone_close": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "milestone-close"
+    },
+    "to_brainstorm_driven": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "brainstorm-driven"
+    },
+    "to_next_milestone": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "next-milestone"
+    },
+    "to_quality_loop_partial": {
+      "type": "terminal",
+      "status": "delegate",
+      "delegate_graph": "quality-loop",
+      "delegate_inputs": { "entry_override": "plan_gaps" }
+    }
+  }
+}

package/chains/analyze-plan-execute.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "./chain-graph.schema.json",
+  "id": "analyze-plan-execute",
+  "name": "Analyze-Plan-Execute",
+  "description": "Quick analyze -> Plan (scratch) -> Execute (scratch) fast track",
+  "version": "1.0.0",
+  "tags": ["scratch", "fast-track"],
+  "entry": "analyze",
+  "inputs": {
+    "description": { "type": "string", "required": true }
+  },
+  "defaults": { "analyze": true },
+  "nodes": {
+    "analyze": {
+      "type": "command",
+      "cmd": "maestro-analyze",
+      "description": "Quick analysis with decision extraction (scratch mode)",
+      "args": "\"{description}\" -q",
+      "auto_flag": "-y",
+      "next": "plan",
+      "extract": {
+        "scratch_dir": {
+          "strategy": "line_match",
+          "pattern": "scratch_dir:",
+          "target": "var.scratch_dir"
+        }
+      }
+    },
+    "plan": {
+      "type": "command",
+      "cmd": "maestro-plan",
+      "description": "Create scratch execution plan from analysis context",
+      "args": "--dir {var.scratch_dir}",
+      "auto_flag": "--auto",
+      "next": "execute"
+    },
+    "execute": {
+      "type": "command",
+      "cmd": "maestro-execute",
+      "description": "Execute scratch tasks from plan",
+      "args": "--dir {var.scratch_dir}",
+      "next": "done"
+    },
+    "done": {
+      "type": "terminal",
+      "status": "success",
+      "summary": "Analyze-plan-execute fast track completed"
+    }
+  }
+}

package/chains/brainstorm-driven.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "./chain-graph.schema.json",
+  "id": "brainstorm-driven",
+  "name": "Brainstorm-Driven",
+  "description": "Brainstorm -> Init -> Analyze -> Plan -> Execute -> Verify pipeline",
+  "version": "1.0.0",
+  "tags": ["lifecycle", "brainstorm"],
+  "entry": "brainstorm",
+  "inputs": {
+    "phase": { "type": "string" },
+    "description": { "type": "string", "required": true }
+  },
+  "defaults": { "analyze": true },
+  "nodes": {
+    "brainstorm": {
+      "type": "command",
+      "cmd": "maestro-brainstorm",
+      "description": "Multi-role brainstorming with auto pipeline or single-role analysis",
+      "args": "\"{description}\"",
+      "auto_flag": "-y",
+      "next": "init"
+    },
+    "init": {
+      "type": "command",
+      "cmd": "maestro-init",
+      "description": "Initialize project structure and state files",
+      "next": "analyze"
+    },
+    "analyze": {
+      "type": "command",
+      "cmd": "maestro-analyze",
+      "description": "Multi-dimensional analysis with CLI exploration and decision extraction",
+      "args": "\"{description}\"",
+      "auto_flag": "-y",
+      "next": "plan"
+    },
+    "plan": {
+      "type": "command",
+      "cmd": "maestro-plan",
+      "description": "Create execution plan with task decomposition",
+      "args": "{phase}",
+      "auto_flag": "--auto",
+      "next": "execute"
+    },
+    "execute": {
+      "type": "command",
+      "cmd": "maestro-execute",
+      "description": "Run wave-based parallel task execution",
+      "args": "{phase}",
+      "next": "verify"
+    },
+    "verify": {
+      "type": "command",
+      "cmd": "maestro-verify",
+      "description": "Goal-backward 3-layer verification",
+      "args": "{phase}",
+      "next": "check_verify",
+      "max_visits": 2
+    },
+    "check_verify": {
+      "type": "decision",
+      "eval": "ctx.result.verification_status",
+      "edges": [
+        { "value": "passed", "target": "done" },
+        { "default": true, "target": "done_with_issues" }
+      ]
+    },
+    "done": {
+      "type": "terminal",
+      "status": "success",
+      "summary": "Brainstorm-driven pipeline completed successfully"
+    },
+    "done_with_issues": {
+      "type": "terminal",
+      "status": "paused",
+      "summary": "Brainstorm-driven pipeline completed with verification issues"
+    }
+  }
+}

package/chains/execute-verify.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "./chain-graph.schema.json",
+  "id": "execute-verify",
+  "name": "Execute-Verify",
+  "description": "Execute -> Verify with fix loop on failure",
+  "version": "1.0.0",
+  "tags": ["execution"],
+  "entry": "execute",
+  "inputs": {
+    "phase": { "type": "string", "required": true }
+  },
+  "defaults": { "analyze": true },
+  "nodes": {
+    "execute": {
+      "type": "command",
+      "cmd": "maestro-execute",
+      "description": "Run wave-based parallel task execution with atomic commits",
+      "args": "{phase}",
+      "next": "verify"
+    },
+    "verify": {
+      "type": "command",
+      "cmd": "maestro-verify",
+      "description": "Goal-backward 3-layer verification with anti-pattern scan",
+      "args": "{phase}",
+      "next": "check_verify",
+      "max_visits": 3
+    },
+    "check_verify": {
+      "type": "decision",
+      "eval": "ctx.result.verification_status",
+      "edges": [
+        { "value": "passed", "target": "done", "description": "Verification passed" },
+        { "default": true, "target": "fix_plan", "description": "Verification failed" }
+      ]
+    },
+    "fix_plan": {
+      "type": "command",
+      "cmd": "maestro-plan",
+      "description": "Re-plan to address verification gaps and failures",
+      "args": "{phase} --gaps",
+      "auto_flag": "--auto",
+      "next": "fix_execute"
+    },
+    "fix_execute": {
+      "type": "command",
+      "cmd": "maestro-execute",
+      "description": "Re-execute tasks from updated gap-fix plan",
+      "args": "{phase}",
+      "next": "verify",
+      "max_visits": 3
+    },
+    "done": {
+      "type": "terminal",
+      "status": "success",
+      "summary": "Execute-verify completed for phase {phase}"
+    }
+  }
+}

package/chains/full-lifecycle.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "./chain-graph.schema.json",
+  "id": "full-lifecycle",
+  "name": "Full Lifecycle",
+  "description": "Plan -> Execute -> Verify -> Review -> Test -> Transition with decision points",
+  "version": "1.0.0",
+  "tags": ["lifecycle", "phase"],
+  "entry": "plan",
+  "inputs": {
+    "phase": { "type": "string", "required": true },
+    "description": { "type": "string" }
+  },
+  "defaults": { "analyze": true },
+  "nodes": {
+    "plan": {
+      "type": "command",
+      "cmd": "maestro-plan",
+      "description": "Create execution plan by exploring codebase, clarifying requirements, and generating task decomposition",
+      "args": "{phase}",
+      "auto_flag": "--auto",
+      "next": "execute"
+    },
+    "execute": {
+      "type": "command",
+      "cmd": "maestro-execute",
+      "description": "Run wave-based parallel task execution with atomic commits",
+      "args": "{phase}",
+      "next": "verify"
+    },
+    "verify": {
+      "type": "command",
+      "cmd": "maestro-verify",
+      "description": "Goal-backward 3-layer verification with anti-pattern scan",
+      "args": "{phase}",
+      "next": "check_verify",
+      "max_visits": 3
+    },
+    "check_verify": {
+      "type": "decision",
+      "eval": "ctx.result.verification_status",
+      "edges": [
+        { "value": "passed", "target": "review" },
+        { "default": true, "target": "fix_plan" }
+      ]
+    },
+    "fix_plan": {
+      "type": "command",
+      "cmd": "maestro-plan",
+      "description": "Re-plan to address verification gaps and failures",
+      "args": "{phase} --gaps",
+      "auto_flag": "--auto",
+      "next": "fix_execute"
+    },
+    "fix_execute": {
+      "type": "command",
+      "cmd": "maestro-execute",
+      "description": "Re-execute tasks from updated gap-fix plan",
+      "args": "{phase}",
+      "next": "verify",
+      "max_visits": 3
+    },
+    "review": {
+      "type": "command",
+      "cmd": "quality-review",
+      "description": "Multi-dimensional code review with severity classification",
+      "args": "{phase}",
+      "next": "check_review"
+    },
+    "check_review": {
+      "type": "decision",
+      "eval": "ctx.result.review_verdict",
+      "edges": [
+        { "value": "BLOCK", "target": "fix_plan" },
+        { "default": true, "target": "test" }
+      ]
+    },
+    "test": {
+      "type": "command",
+      "cmd": "quality-test",
+      "description": "User acceptance testing with auto-diagnosis",
+      "args": "{phase}",
+      "auto_flag": "--auto-fix",
+      "next": "check_test"
+    },
+    "check_test": {
+      "type": "decision",
+      "eval": "ctx.result.uat_status",
+      "edges": [
+        { "value": "passed", "target": "transition" },
+        { "default": true, "target": "debug" }
+      ]
+    },
+    "debug": {
+      "type": "command",
+      "cmd": "quality-debug",
+      "description": "Hypothesis-driven debugging from UAT failures",
+      "args": "--from-uat {phase}",
+      "next": "fix_execute",
+      "max_visits": 2
+    },
+    "transition": {
+      "type": "command",
+      "cmd": "maestro-phase-transition",
+      "description": "Complete phase, extract learnings, advance to next",
+      "next": "done"
+    },
+    "done": {
+      "type": "terminal",
+      "status": "success"
+    }
+  }
+}

package/chains/issue-lifecycle.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "./chain-graph.schema.json",
+  "id": "issue-lifecycle",
+  "name": "Issue Lifecycle",
+  "description": "Full issue resolution: analyze → plan → execute → verify with decision routing",
+  "version": "1.0.0",
+  "tags": ["issue", "lifecycle"],
+  "entry": "check_mode",
+  "inputs": {
+    "issue_id": { "type": "string", "required": true },
+    "description": { "type": "string" },
+    "mode": { "type": "string", "default": "full" }
+  },
+  "nodes": {
+    "check_mode": {
+      "type": "decision",
+      "eval": "ctx.inputs.mode",
+      "edges": [
+        { "value": "direct", "target": "execute" },
+        { "value": "plan-execute", "target": "plan" },
+        { "default": true, "target": "analyze" }
+      ]
+    },
+    "analyze": {
+      "type": "command",
+      "cmd": "manage-issue-analyze",
+      "description": "Root cause analysis for the issue using CLI exploration",
+      "args": "{issue_id}",
+      "next": "plan"
+    },
+    "plan": {
+      "type": "command",
+      "cmd": "manage-issue-plan",
+      "description": "Generate codebase-aware solution plan with step decomposition",
+      "args": "{issue_id}",
+      "next": "execute"
+    },
+    "execute": {
+      "type": "command",
+      "cmd": "manage-issue-execute",
+      "description": "Execute planned solution via dual-mode agent dispatch",
+      "args": "{issue_id}",
+      "next": "check_result"
+    },
+    "check_result": {
+      "type": "decision",
+      "eval": "ctx.result.status",
+      "edges": [
+        { "value": "SUCCESS", "target": "done" },
+        { "default": true, "target": "retry_plan" }
+      ]
+    },
+    "retry_plan": {
+      "type": "command",
+      "cmd": "manage-issue-plan",
+      "description": "Re-plan after execution failure with updated context",
+      "args": "{issue_id} --retry",
+      "next": "retry_execute",
+      "max_visits": 2
+    },
+    "retry_execute": {
+      "type": "command",
+      "cmd": "manage-issue-execute",
+      "description": "Re-execute with revised plan",
+      "args": "{issue_id}",
+      "next": "done",
+      "max_visits": 2
+    },
+    "done": {
+      "type": "terminal",
+      "status": "success"
+    }
+  }
+}

package/chains/milestone-close.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "./chain-graph.schema.json",
+  "id": "milestone-close",
+  "name": "Milestone Close",
+  "description": "Milestone Audit -> Phase Transition -> Done",
+  "version": "1.0.0",
+  "tags": ["milestone"],
+  "entry": "audit",
+  "inputs": {},
+  "nodes": {
+    "audit": {
+      "type": "command",
+      "cmd": "maestro-milestone-audit",
+      "description": "Audit current milestone for cross-phase integration gaps",
+      "next": "transition"
+    },
+    "transition": {
+      "type": "command",
+      "cmd": "maestro-phase-transition",
+      "description": "Complete phase, extract learnings, advance to next",
+      "next": "done"
+    },
+    "done": {
+      "type": "terminal",
+      "status": "success",
+      "summary": "Milestone closed successfully"
+    }
+  }
+}

package/chains/next-milestone.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "./chain-graph.schema.json",
+  "id": "next-milestone",
+  "name": "Next Milestone",
+  "description": "Create roadmap for next milestone and execute first phase",
+  "version": "1.0.0",
+  "tags": ["lifecycle", "milestone"],
+  "entry": "roadmap",
+  "inputs": {
+    "description": { "type": "string" },
+    "phase": { "type": "string" }
+  },
+  "nodes": {
+    "roadmap": {
+      "type": "command",
+      "cmd": "maestro-roadmap",
+      "description": "Create or refine project roadmap for new milestone",
+      "args": "\"{description}\"",
+      "auto_flag": "-y",
+      "next": "plan"
+    },
+    "plan": {
+      "type": "command",
+      "cmd": "maestro-plan",
+      "description": "Create execution plan for first phase of new milestone",
+      "args": "{phase}",
+      "auto_flag": "--auto",
+      "next": "execute"
+    },
+    "execute": {
+      "type": "command",
+      "cmd": "maestro-execute",
+      "description": "Execute planned tasks with wave-based parallel execution",
+      "args": "{phase}",
+      "next": "verify"
+    },
+    "verify": {
+      "type": "command",
+      "cmd": "maestro-verify",
+      "description": "Goal-backward verification of execution results",
+      "args": "{phase}",
+      "next": "done"
+    },
+    "done": {
+      "type": "terminal",
+      "status": "success"
+    }
+  }
+}