maestro-flow 0.3.7 → 0.3.9

package/chains/_router.json

@@ -2,8 +2,8 @@
   "$schema": "./chain-graph.schema.json",
   "id": "_router",
   "name": "State Router",
-  "description": "Route to appropriate graph based on project state",
-  "version": "1.0.0",
+  "description": "Route to appropriate graph based on project state and artifact registry",
+  "version": "2.0.0",
   "tags": ["internal", "router"],
   "entry": "check_init",
   "inputs": {
@@ -21,10 +21,10 @@
     },
     "check_has_roadmap": {
       "type": "decision",
-      "eval": "ctx.project.phases_total",
+      "eval": "ctx.project.milestones_total",
       "edges": [
-        { "match": "ctx.project.phases_total == 0", "target": "check_accumulated_context" },
-        { "default": true, "target": "check_phase_status" }
+        { "match": "ctx.project.milestones_total == 0", "target": "check_accumulated_context" },
+        { "default": true, "target": "check_artifact_state" }
       ]
     },
     "check_accumulated_context": {
@@ -35,98 +35,61 @@
         { "default": true, "target": "to_brainstorm_driven" }
       ]
     },
-    "check_phase_status": {
+    "check_artifact_state": {
       "type": "decision",
-      "eval": "ctx.project.phase_status",
+      "description": "Determine next step from artifact registry — what's the latest completed artifact type for current milestone?",
+      "eval": "ctx.project.latest_artifact_type",
       "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" },
+        { "value": null, "target": "to_analyze" },
+        { "value": "analyze", "target": "check_has_plan" },
+        { "value": "brainstorm", "target": "to_analyze" },
+        { "value": "plan", "target": "to_execute" },
+        { "value": "execute", "target": "to_verify" },
+        { "value": "verify", "target": "check_verify_result" },
         { "default": true, "target": "to_analyze" }
       ]
     },
     "check_has_plan": {
       "type": "decision",
-      "eval": "ctx.project.artifacts.plan",
+      "eval": "ctx.project.has_pending_plans",
       "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": "ctx.project.execution.tasks_completed >= ctx.project.execution.tasks_total && ctx.project.execution.tasks_total > 0",
-          "target": "to_verify"
-        },
-        { "default": true, "target": "to_execute" }
-      ]
-    },
-    "check_verification": {
+    "check_verify_result": {
       "type": "decision",
       "eval": "ctx.project.verification_status",
       "edges": [
-        { "value": "passed", "target": "check_business_test" },
+        { "value": "passed", "target": "check_review" },
         { "default": true, "target": "to_quality_loop_partial" }
       ]
     },
-    "check_business_test": {
-      "type": "decision",
-      "eval": "ctx.project.business_test_status",
-      "edges": [
-        { "value": null, "target": "to_business_test" },
-        { "value": "passed", "target": "check_review_after_verify" },
-        { "default": true, "target": "to_quality_loop_partial" }
-      ]
-    },
-    "check_review_after_verify": {
+    "check_review": {
       "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" }
+        { "value": "BLOCK", "target": "to_quality_loop_partial" },
+        { "default": true, "target": "check_uat" }
       ]
     },
     "check_uat": {
       "type": "decision",
       "eval": "ctx.project.uat_status",
       "edges": [
-        { "value": "passed", "target": "to_phase_transition" },
+        { "value": null, "target": "to_test" },
+        { "value": "passed", "target": "check_all_phases" },
         { "default": true, "target": "to_debug_from_uat" }
       ]
     },
     "check_all_phases": {
       "type": "decision",
-      "eval": "ctx.project.phases_completed",
+      "description": "Check if all phases in milestone have completed execute artifacts",
+      "eval": "ctx.project.all_phases_executed",
       "edges": [
-        {
-          "match": "ctx.project.phases_completed >= ctx.project.phases_total",
-          "target": "to_milestone_close"
-        },
-        { "default": true, "target": "to_phase_transition" }
+        { "value": true, "target": "to_milestone_close" },
+        { "default": true, "target": "to_analyze" }
       ]
     },
     "to_init": {
@@ -154,25 +117,20 @@
       "status": "delegate",
       "delegate_graph": "singles/verify"
     },
-    "to_business_test": {
-      "type": "terminal",
-      "status": "delegate",
-      "delegate_graph": "singles/business-test"
-    },
     "to_review": {
       "type": "terminal",
       "status": "delegate",
       "delegate_graph": "singles/review"
     },
-    "to_test": {
+    "to_debug": {
       "type": "terminal",
       "status": "delegate",
-      "delegate_graph": "singles/test"
+      "delegate_graph": "singles/debug"
     },
-    "to_debug": {
+    "to_test": {
       "type": "terminal",
       "status": "delegate",
-      "delegate_graph": "singles/debug"
+      "delegate_graph": "singles/test"
     },
     "to_debug_from_uat": {
       "type": "terminal",
@@ -185,11 +143,6 @@
       "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",

package/chains/brainstorm-driven.json

@@ -62,18 +62,29 @@
       "eval": "ctx.result.verification_status",
       "edges": [
         { "value": "passed", "target": "done" },
-        { "default": true, "target": "done_with_issues" }
+        { "default": true, "target": "fix_plan" }
       ]
     },
+    "fix_plan": {
+      "type": "command",
+      "cmd": "maestro-plan",
+      "description": "Re-plan to address verification gaps",
+      "args": "{phase} --gaps",
+      "auto_flag": "--auto",
+      "next": "fix_execute"
+    },
+    "fix_execute": {
+      "type": "command",
+      "cmd": "maestro-execute",
+      "description": "Re-execute from gap-fix plan",
+      "args": "{phase}",
+      "next": "verify",
+      "max_visits": 2
+    },
     "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/full-lifecycle.json

@@ -2,12 +2,12 @@
   "$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"],
+  "description": "Plan -> Execute -> Verify -> Review -> Test -> Milestone Audit/Complete with decision points",
+  "version": "2.0.0",
+  "tags": ["lifecycle", "milestone"],
   "entry": "plan",
   "inputs": {
-    "phase": { "type": "string", "required": true },
+    "phase": { "type": "string", "required": false },
     "description": { "type": "string" }
   },
   "defaults": { "analyze": true },
@@ -38,21 +38,6 @@
     "check_verify": {
       "type": "decision",
       "eval": "ctx.result.verification_status",
-      "edges": [
-        { "value": "passed", "target": "business_test" },
-        { "default": true, "target": "fix_plan" }
-      ]
-    },
-    "business_test": {
-      "type": "command",
-      "cmd": "quality-business-test",
-      "description": "PRD-forward business testing with requirement traceability",
-      "args": "{phase} --auto",
-      "next": "check_business_test"
-    },
-    "check_business_test": {
-      "type": "decision",
-      "eval": "ctx.result.business_test_status",
       "edges": [
         { "value": "passed", "target": "review" },
         { "default": true, "target": "fix_plan" }
@@ -101,7 +86,7 @@
       "type": "decision",
       "eval": "ctx.result.uat_status",
       "edges": [
-        { "value": "passed", "target": "transition" },
+        { "value": "passed", "target": "milestone_audit" },
         { "default": true, "target": "debug" }
       ]
     },
@@ -113,10 +98,24 @@
       "next": "fix_execute",
       "max_visits": 2
     },
-    "transition": {
+    "milestone_audit": {
+      "type": "command",
+      "cmd": "maestro-milestone-audit",
+      "description": "Audit milestone for cross-phase integration gaps using artifact registry",
+      "next": "check_audit"
+    },
+    "check_audit": {
+      "type": "decision",
+      "eval": "ctx.result.audit_verdict",
+      "edges": [
+        { "value": "PASS", "target": "milestone_complete" },
+        { "default": true, "target": "fix_plan" }
+      ]
+    },
+    "milestone_complete": {
       "type": "command",
-      "cmd": "maestro-phase-transition",
-      "description": "Complete phase, extract learnings, advance to next",
+      "cmd": "maestro-milestone-complete",
+      "description": "Archive scratch artifacts, move to milestone_history, advance to next milestone",
       "next": "done"
     },
     "done": {

package/chains/milestone-close.json

@@ -2,8 +2,8 @@
   "$schema": "./chain-graph.schema.json",
   "id": "milestone-close",
   "name": "Milestone Close",
-  "description": "Milestone Audit -> Phase Transition -> Done",
-  "version": "1.0.0",
+  "description": "Milestone Audit -> Milestone Complete",
+  "version": "2.0.0",
   "tags": ["milestone"],
   "entry": "audit",
   "inputs": {},
@@ -11,19 +11,32 @@
     "audit": {
       "type": "command",
       "cmd": "maestro-milestone-audit",
-      "description": "Audit current milestone for cross-phase integration gaps",
-      "next": "transition"
+      "description": "Audit current milestone using artifact registry for cross-phase integration gaps",
+      "next": "check_audit"
     },
-    "transition": {
+    "check_audit": {
+      "type": "decision",
+      "eval": "ctx.result.audit_verdict",
+      "edges": [
+        { "value": "PASS", "target": "complete" },
+        { "default": true, "target": "failed" }
+      ]
+    },
+    "complete": {
       "type": "command",
-      "cmd": "maestro-phase-transition",
-      "description": "Complete phase, extract learnings, advance to next",
+      "cmd": "maestro-milestone-complete",
+      "description": "Archive scratch artifacts to milestones/, move artifact entries to history, advance state",
       "next": "done"
     },
     "done": {
       "type": "terminal",
       "status": "success",
       "summary": "Milestone closed successfully"
+    },
+    "failed": {
+      "type": "terminal",
+      "status": "failed",
+      "summary": "Audit failed — fix integration gaps before completing milestone"
     }
   }
 }

package/chains/milestone-fork-merge.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "./chain-graph.schema.json",
+  "id": "milestone-fork-merge",
+  "name": "Milestone Fork & Merge",
+  "description": "Fork a milestone into a worktree, run full lifecycle, then merge back",
+  "version": "1.0.0",
+  "tags": ["worktree", "milestone", "parallel"],
+  "entry": "fork",
+  "inputs": {
+    "milestone_num": { "type": "number", "required": true }
+  },
+  "nodes": {
+    "fork": {
+      "type": "command",
+      "cmd": "maestro-fork",
+      "description": "Create worktree for milestone with all phases",
+      "args": "-m {milestone_num}",
+      "next": "lifecycle_in_worktree"
+    },
+    "lifecycle_in_worktree": {
+      "type": "command",
+      "cmd": "maestro",
+      "description": "Run sequential lifecycle for all phases in worktree (analyze, plan, execute, verify, transition per phase)",
+      "args": "continue",
+      "cwd": ".worktrees/m{milestone_num}-{milestone_slug}",
+      "next": "merge_decision"
+    },
+    "merge_decision": {
+      "type": "decision",
+      "description": "Check if all milestone phases are completed",
+      "condition": "all_phases_completed",
+      "branches": {
+        "true": "merge",
+        "false": "lifecycle_in_worktree"
+      }
+    },
+    "merge": {
+      "type": "command",
+      "cmd": "maestro-merge",
+      "description": "Merge milestone worktree back into main",
+      "args": "-m {milestone_num}",
+      "next": "done"
+    },
+    "done": {
+      "type": "terminal",
+      "status": "success",
+      "summary": "Milestone {milestone_num} forked, developed, and merged successfully"
+    }
+  }
+}

package/chains/roadmap-driven.json

@@ -53,18 +53,29 @@
       "eval": "ctx.result.verification_status",
       "edges": [
         { "value": "passed", "target": "done" },
-        { "default": true, "target": "done_with_issues" }
+        { "default": true, "target": "fix_plan" }
       ]
     },
+    "fix_plan": {
+      "type": "command",
+      "cmd": "maestro-plan",
+      "description": "Re-plan to address verification gaps",
+      "args": "{phase} --gaps",
+      "auto_flag": "--auto",
+      "next": "fix_execute"
+    },
+    "fix_execute": {
+      "type": "command",
+      "cmd": "maestro-execute",
+      "description": "Re-execute from gap-fix plan",
+      "args": "{phase}",
+      "next": "verify",
+      "max_visits": 2
+    },
     "done": {
       "type": "terminal",
       "status": "success",
       "summary": "Roadmap-driven pipeline completed successfully"
-    },
-    "done_with_issues": {
-      "type": "terminal",
-      "status": "paused",
-      "summary": "Roadmap-driven pipeline completed with verification issues"
     }
   }
 }

package/chains/spec-driven.json

@@ -54,18 +54,29 @@
       "eval": "ctx.result.verification_status",
       "edges": [
         { "value": "passed", "target": "done", "description": "Verification passed" },
-        { "default": true, "target": "done_with_issues", "description": "Verification failed" }
+        { "default": true, "target": "fix_plan", "description": "Verification failed" }
       ]
     },
+    "fix_plan": {
+      "type": "command",
+      "cmd": "maestro-plan",
+      "description": "Re-plan to address verification gaps",
+      "args": "{phase} --gaps",
+      "auto_flag": "--auto",
+      "next": "fix_execute"
+    },
+    "fix_execute": {
+      "type": "command",
+      "cmd": "maestro-execute",
+      "description": "Re-execute from gap-fix plan",
+      "args": "{phase}",
+      "next": "verify",
+      "max_visits": 2
+    },
     "done": {
       "type": "terminal",
       "status": "success",
       "summary": "Spec-driven pipeline completed successfully"
-    },
-    "done_with_issues": {
-      "type": "terminal",
-      "status": "paused",
-      "summary": "Spec-driven pipeline completed with verification issues"
     }
   }
 }