agentweaver 0.1.15 → 0.1.17

package/dist/pipeline/flow-specs/auto-common.json

@@ -1,393 +1,112 @@
 {
   "kind": "auto-flow",
   "version": 1,
-  "description": "End-to-end resumable pipeline without language-specific checks. Runs: plan (with Jira fetch and Q&A) → implement → review loop. Simplified alternative to auto-golang for projects that do not need Go linter/test loops.",
+  "description": "End-to-end resumable pipeline without language-specific checks. Runs: Jira fetch → task source normalization → plan → design-review loop → implement → review loop. Planning gate requires design-review approval, or an explicit user decision to continue after the maximum revision attempts, before implementation.",
   "phases": [
     {
-      "id": "plan",
+      "id": "source",
       "steps": [
         {
-          "id": "fetch_jira",
-          "node": "jira-fetch",
+          "id": "fetch_jira_source",
+          "node": "flow-run",
           "params": {
+            "fileName": { "const": "jira-fetch.json" },
+            "labelText": { "const": "Fetching Jira task source" },
             "jiraApiUrl": { "ref": "params.jiraApiUrl" },
-            "outputFile": {
-              "artifact": {
-                "kind": "jira-task-file",
-                "taskKey": { "ref": "params.taskKey" }
-              }
-            },
-            "attachmentsManifestFile": {
-              "artifact": {
-                "kind": "jira-attachments-manifest-file",
-                "taskKey": { "ref": "params.taskKey" }
-              }
-            },
-            "attachmentsContextFile": {
-              "artifact": {
-                "kind": "jira-attachments-context-file",
-                "taskKey": { "ref": "params.taskKey" }
-              }
-            }
-          },
-          "expect": [
-            {
-              "kind": "require-file",
-              "path": {
-                "artifact": {
-                  "kind": "jira-task-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "message": "Jira fetch node did not produce the Jira task file."
-            },
-            {
-              "kind": "require-file",
-              "path": {
-                "artifact": {
-                  "kind": "jira-attachments-manifest-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "message": "Jira fetch node did not produce the Jira attachments manifest file."
-            },
-            {
-              "kind": "require-file",
-              "path": {
-                "artifact": {
-                  "kind": "jira-attachments-context-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "message": "Jira fetch node did not produce the Jira attachments context file."
-            }
-          ]
-        },
-        {
-          "id": "generate_planning_questions",
-          "node": "llm-prompt",
-          "prompt": {
-            "templateRef": "plan-questions",
-            "vars": {
-              "jira_task_file": {
-                "artifact": {
-                  "kind": "jira-task-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "jira_attachments_manifest_file": {
-                "artifact": {
-                  "kind": "jira-attachments-manifest-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "jira_attachments_context_file": {
-                "artifact": {
-                  "kind": "jira-attachments-context-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "planning_questions_json_file": {
-                "artifact": {
-                  "kind": "planning-questions-json-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              }
-            },
-            "extraPrompt": { "ref": "params.extraPrompt" },
-            "format": "task-prompt"
-          },
-          "params": {
-            "labelText": { "const": "Generating planning questions" },
-            "model": { "ref": "params.llmModel" },
-            "executor": { "ref": "params.llmExecutor" },
-            "requiredArtifacts": {
-              "list": [
-                {
-                  "artifact": {
-                    "kind": "planning-questions-json-file",
-                    "taskKey": { "ref": "params.taskKey" }
-                  }
-                }
-              ]
-            }
-          },
-          "expect": [
-            {
-              "kind": "require-artifacts",
-              "when": { "not": { "ref": "context.dryRun" } },
-              "paths": {
-                "list": [
-                  {
-                    "artifact": {
-                      "kind": "planning-questions-json-file",
-                      "taskKey": { "ref": "params.taskKey" }
-                    }
-                  }
-                ]
-              },
-              "message": "Planning questions step did not produce the questions artifact."
-            },
-            {
-              "kind": "require-structured-artifacts",
-              "when": { "not": { "ref": "context.dryRun" } },
-              "items": [
-                {
-                  "path": {
-                    "artifact": {
-                      "kind": "planning-questions-json-file",
-                      "taskKey": { "ref": "params.taskKey" }
-                    }
-                  },
-                  "schemaId": "planning-questions/v1"
-                }
-              ],
-              "message": "Planning questions step produced invalid structured artifacts."
-            }
-          ]
-        },
+            "taskKey": { "ref": "params.taskKey" }
+          }
+        }
+      ]
+    },
+    {
+      "id": "normalize",
+      "steps": [
         {
-          "id": "build_planning_questions_form",
-          "node": "planning-questions-form",
+          "id": "run_normalize_source",
+          "node": "flow-run",
           "params": {
-            "planningQuestionsJsonFile": {
-              "artifact": {
-                "kind": "planning-questions-json-file",
-                "taskKey": { "ref": "params.taskKey" }
-              }
-            },
-            "formId": { "const": "planning-questions" },
-            "title": { "const": "Planning Questions" },
-            "description": {
-              "const": "Reply to model questions if they are needed for accurate design and plan. If there are no questions, the step will complete automatically."
-            }
+            "fileName": { "const": "normalize-task-source.json" },
+            "labelText": { "const": "Normalizing task source" },
+            "taskKey": { "ref": "params.taskKey" },
+            "iteration": { "ref": "params.taskContextIteration" },
+            "llmExecutor": { "ref": "params.llmExecutor" },
+            "llmModel": { "ref": "params.llmModel" },
+            "extraPrompt": { "ref": "params.extraPrompt" }
           }
-        },
+        }
+      ]
+    },
+    {
+      "id": "plan",
+      "steps": [
         {
-          "id": "notify_planning_questions",
-          "when": { "not": { "equals": [{ "ref": "steps.plan.build_planning_questions_form.value.questionCount" }, { "const": 0 }] } },
-          "node": "telegram-notify",
+          "id": "run_plan_flow",
+          "node": "flow-run",
           "params": {
-            "message": {
-              "template": "Planning questions generated for {taskKey}. Please review and answer if needed.",
-              "vars": {
-                "taskKey": { "ref": "params.taskKey" }
-              }
-            }
+            "fileName": { "const": "plan.json" },
+            "labelText": { "const": "Running planning flow" },
+            "taskKey": { "ref": "params.taskKey" },
+            "taskContextIteration": { "ref": "params.taskContextIteration" },
+            "designIteration": { "ref": "params.designIteration" },
+            "planIteration": { "ref": "params.planIteration" },
+            "qaIteration": { "ref": "params.qaIteration" },
+            "llmExecutor": { "ref": "params.llmExecutor" },
+            "llmModel": { "ref": "params.llmModel" },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "mdLang": { "ref": "params.mdLang" }
           }
-        },
+        }
+      ]
+    },
+    {
+      "id": "design_review_loop",
+      "steps": [
         {
-          "id": "collect_planning_answers",
-          "node": "user-input",
+          "id": "run_design_review_loop",
+          "node": "flow-run",
           "params": {
-            "formId": { "ref": "steps.plan.build_planning_questions_form.value.formId" },
-            "title": { "ref": "steps.plan.build_planning_questions_form.value.title" },
-            "description": { "ref": "steps.plan.build_planning_questions_form.value.description" },
-            "submitLabel": { "const": "Continue planning" },
-            "fields": { "ref": "steps.plan.build_planning_questions_form.value.fields" },
-            "outputFile": {
-              "artifact": {
-                "kind": "planning-answers-json-file",
-                "taskKey": { "ref": "params.taskKey" }
-              }
-            }
-          },
-          "expect": [
-            {
-              "kind": "require-structured-artifacts",
-              "items": [
-                {
-                  "path": {
-                    "artifact": {
-                      "kind": "planning-answers-json-file",
-                      "taskKey": { "ref": "params.taskKey" }
-                    }
-                  },
-                  "schemaId": "user-input/v1"
-                }
-              ],
-              "message": "Planning answers input is missing or invalid."
-            }
-          ]
-        },
-        {
-          "id": "run_plan",
-          "node": "llm-prompt",
-          "prompt": {
-            "templateRef": "plan",
-            "vars": {
-              "jira_task_file": {
-                "artifact": {
-                  "kind": "jira-task-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "jira_attachments_manifest_file": {
-                "artifact": {
-                  "kind": "jira-attachments-manifest-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "jira_attachments_context_file": {
-                "artifact": {
-                  "kind": "jira-attachments-context-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "design_file": {
-                "artifact": {
-                  "kind": "design-file",
-                  "taskKey": { "ref": "params.taskKey" },
-                  "iteration": { "ref": "params.designIteration" }
-                }
-              },
-              "design_json_file": {
-                "artifact": {
-                  "kind": "design-json-file",
-                  "taskKey": { "ref": "params.taskKey" },
-                  "iteration": { "ref": "params.designIteration" }
-                }
-              },
-              "plan_file": {
-                "artifact": {
-                  "kind": "plan-file",
-                  "taskKey": { "ref": "params.taskKey" },
-                  "iteration": { "ref": "params.planIteration" }
-                }
-              },
-              "plan_json_file": {
-                "artifact": {
-                  "kind": "plan-json-file",
-                  "taskKey": { "ref": "params.taskKey" },
-                  "iteration": { "ref": "params.planIteration" }
-                }
-              },
-              "qa_file": {
-                "artifact": {
-                  "kind": "qa-file",
-                  "taskKey": { "ref": "params.taskKey" },
-                  "iteration": { "ref": "params.qaIteration" }
-                }
-              },
-              "qa_json_file": {
-                "artifact": {
-                  "kind": "qa-json-file",
-                  "taskKey": { "ref": "params.taskKey" },
-                  "iteration": { "ref": "params.qaIteration" }
-                }
-              }
-            },
-            "extraPrompt": {
-              "appendPrompt": {
-                "base": { "ref": "params.extraPrompt" },
-                "suffix": { "ref": "steps.plan.collect_planning_answers.value.promptSuffix" }
-              }
-            },
-            "format": "task-prompt"
+            "fileName": { "const": "design-review-loop.json" },
+            "labelText": { "const": "Running design-review loop" },
+            "taskKey": { "ref": "params.taskKey" },
+            "baseIteration": { "ref": "params.designReviewBaseIteration" },
+            "workspaceDir": { "ref": "params.workspaceDir" },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "llmExecutor": { "ref": "params.llmExecutor" },
+            "llmModel": { "ref": "params.llmModel" }
           },
-          "params": {
-            "labelText": { "const": "Running planning mode" },
-            "model": { "ref": "params.llmModel" },
-            "executor": { "ref": "params.llmExecutor" }
+          "stopFlowIf": {
+            "equals": [
+              { "ref": "steps.design_review_loop.run_design_review_loop.value.executionState.terminationOutcome" },
+              { "const": "stopped" }
+            ]
           },
-          "expect": [
-            {
-              "kind": "require-artifacts",
-              "when": { "not": { "ref": "context.dryRun" } },
-              "paths": {
-                "artifactList": {
-                  "kind": "plan-artifacts",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "message": "Plan mode did not produce the required artifacts."
-            },
-            {
-              "kind": "require-structured-artifacts",
-              "when": { "not": { "ref": "context.dryRun" } },
-              "items": [
-                {
-                  "path": {
-                    "artifact": {
-                      "kind": "design-json-file",
-                      "taskKey": { "ref": "params.taskKey" },
-                      "iteration": { "ref": "params.designIteration" }
-                    }
-                  },
-                  "schemaId": "implementation-design/v1"
-                },
-                {
-                  "path": {
-                    "artifact": {
-                      "kind": "plan-json-file",
-                      "taskKey": { "ref": "params.taskKey" },
-                      "iteration": { "ref": "params.planIteration" }
-                    }
-                  },
-                  "schemaId": "implementation-plan/v1"
-                },
-                {
-                  "path": {
-                    "artifact": {
-                      "kind": "qa-json-file",
-                      "taskKey": { "ref": "params.taskKey" },
-                      "iteration": { "ref": "params.qaIteration" }
-                    }
-                  },
-                  "schemaId": "qa-plan/v1"
-                }
-              ],
-              "message": "Plan mode produced invalid structured artifacts."
-            }
-          ]
-        },
-        {
-          "id": "notify_plan_complete",
-          "node": "telegram-notify",
-          "params": {
-            "message": {
-              "template": "Plan phase for {taskKey} complete.",
-              "vars": {
-                "taskKey": { "ref": "params.taskKey" }
-              }
-            }
-          }
+          "stopFlowOutcome": "stopped"
         }
       ]
     },
     {
       "id": "implement",
       "steps": [
+        {
+          "id": "resolve_planning_bundle",
+          "node": "planning-bundle",
+          "params": {
+            "taskKey": { "ref": "params.taskKey" }
+          }
+        },
         {
           "id": "run_implement",
           "node": "llm-prompt",
+          "routingGroup": "implementation",
           "prompt": {
             "templateRef": "implement",
             "vars": {
-              "design_file": {
-                "artifact": {
-                  "kind": "design-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "design_json_file": {
-                "artifact": {
-                  "kind": "design-json-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "plan_file": {
-                "artifact": {
-                  "kind": "plan-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "plan_json_file": {
-                "artifact": {
-                  "kind": "plan-json-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              }
+              "design_file": { "ref": "steps.implement.resolve_planning_bundle.value.designFile" },
+              "design_json_file": { "ref": "steps.implement.resolve_planning_bundle.value.designJsonFile" },
+              "plan_file": { "ref": "steps.implement.resolve_planning_bundle.value.planFile" },
+              "plan_json_file": { "ref": "steps.implement.resolve_planning_bundle.value.planJsonFile" },
+              "qa_file": { "ref": "steps.implement.resolve_planning_bundle.value.qaFile" },
+              "qa_json_file": { "ref": "steps.implement.resolve_planning_bundle.value.qaJsonFile" }
             },
             "extraPrompt": { "ref": "params.extraPrompt" },
             "format": "task-prompt"
@@ -418,13 +137,24 @@
         {
           "id": "run_review_loop",
           "node": "flow-run",
+          "stopFlowIf": {
+            "not": {
+              "equals": [
+                { "ref": "steps.review-loop.run_review_loop.value.executionState.terminationOutcome" },
+                { "const": "success" }
+              ]
+            }
+          },
+          "stopFlowOutcome": "stopped",
           "params": {
             "fileName": { "const": "review-loop.json" },
             "labelText": { "const": "Running review-loop" },
             "taskKey": { "ref": "params.taskKey" },
+            "baseIteration": { "ref": "params.baseIteration" },
             "workspaceDir": { "ref": "params.workspaceDir" },
             "extraPrompt": { "ref": "params.extraPrompt" },
             "reviewFixPoints": { "ref": "params.reviewFixPoints" },
+            "reviewBlockingSeverities": { "ref": "params.reviewBlockingSeverities" },
             "llmExecutor": { "ref": "params.llmExecutor" },
             "llmModel": { "ref": "params.llmModel" }
           }
@@ -444,4 +174,4 @@
       ]
     }
   ]
-}
+}