agentweaver 0.1.14 → 0.1.16

package/dist/pipeline/flow-specs/design-review/design-review-loop.json

@@ -0,0 +1,304 @@
+{
+  "kind": "design-review-loop-flow",
+  "version": 1,
+  "description": "Runs design-review and plan-revise for up to 3 iterations. Stops early on approval. If the final design review still requires revision, notifies the user and asks whether to continue with the latest planning artifacts or stop the parent flow.",
+  "catalogVisibility": "hidden",
+  "phases": [
+    {
+      "repeat": {
+        "var": "iteration",
+        "from": 1,
+        "to": 3
+      },
+      "phases": [
+        {
+          "id": "design_review_iteration_${iteration}",
+          "steps": [
+            {
+              "id": "run_design_review",
+              "node": "flow-run",
+              "params": {
+                "fileName": { "const": "design-review.json" },
+                "labelText": {
+                  "template": "Running design review (iteration ${iteration})"
+                },
+                "taskKey": { "ref": "params.taskKey" },
+                "workspaceDir": { "ref": "params.workspaceDir" },
+                "extraPrompt": { "ref": "params.extraPrompt" },
+                "llmExecutor": { "ref": "params.llmExecutor" },
+                "llmModel": { "ref": "params.llmModel" }
+              }
+            },
+            {
+              "id": "check_design_review_verdict",
+              "node": "design-review-verdict",
+              "params": {
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            },
+            {
+              "id": "notify_review_complete",
+              "node": "telegram-notify",
+              "params": {
+                "message": {
+                  "template": "Design review iteration ${iteration} verdict: {verdict}",
+                  "vars": {
+                    "iteration": { "ref": "repeat.iteration" },
+                    "verdict": { "ref": "steps.design_review_iteration_${iteration}.check_design_review_verdict.value.verdict" }
+                  }
+                }
+              }
+            },
+            {
+              "id": "stop_on_approved",
+              "when": {
+                "equals": [
+                  { "ref": "steps.design_review_iteration_${iteration}.check_design_review_verdict.value.needsRevision" },
+                  { "const": false }
+                ]
+              },
+              "node": "telegram-notify",
+              "params": {
+                "message": {
+                  "template": "Design review approved on iteration ${iteration}. Proceeding with implementation.",
+                  "vars": {
+                    "iteration": { "ref": "repeat.iteration" }
+                  }
+                }
+              },
+              "stopFlowIf": {
+                "equals": [
+                  { "ref": "steps.design_review_iteration_${iteration}.check_design_review_verdict.value.needsRevision" },
+                  { "const": false }
+                ]
+              },
+              "stopFlowOutcome": "success"
+            },
+            {
+              "id": "run_plan_revise",
+              "when": {
+                "all": [
+                  {
+                    "equals": [
+                      { "ref": "steps.design_review_iteration_${iteration}.check_design_review_verdict.value.needsRevision" },
+                      { "const": true }
+                    ]
+                  },
+                  {
+                    "not": {
+                      "equals": [{ "ref": "repeat.iteration" }, { "const": 3 }]
+                    }
+                  }
+                ]
+              },
+              "node": "flow-run",
+              "params": {
+                "fileName": { "const": "plan-revise.json" },
+                "labelText": {
+                  "template": "Running plan revision (iteration ${iteration})"
+                },
+                "taskKey": { "ref": "params.taskKey" },
+                "workspaceDir": { "ref": "params.workspaceDir" },
+                "extraPrompt": { "ref": "params.extraPrompt" },
+                "llmExecutor": { "ref": "params.llmExecutor" },
+                "llmModel": { "ref": "params.llmModel" }
+              }
+            },
+            {
+              "id": "notify_revise_complete",
+              "when": {
+                "all": [
+                  {
+                    "equals": [
+                      { "ref": "steps.design_review_iteration_${iteration}.check_design_review_verdict.value.needsRevision" },
+                      { "const": true }
+                    ]
+                  },
+                  {
+                    "not": {
+                      "equals": [{ "ref": "repeat.iteration" }, { "const": 3 }]
+                    }
+                  }
+                ]
+              },
+              "node": "telegram-notify",
+              "params": {
+                "message": {
+                  "template": "Plan revision after design review iteration ${iteration} is complete.",
+                  "vars": {
+                    "iteration": { "ref": "repeat.iteration" }
+                  }
+                }
+              }
+            },
+            {
+              "id": "notify_max_iterations_reached",
+              "when": {
+                "all": [
+                  {
+                    "equals": [
+                      { "ref": "steps.design_review_iteration_${iteration}.check_design_review_verdict.value.needsRevision" },
+                      { "const": true }
+                    ]
+                  },
+                  {
+                    "equals": [{ "ref": "repeat.iteration" }, { "const": 3 }]
+                  }
+                ]
+              },
+              "node": "telegram-notify",
+              "params": {
+                "message": { "const": "Design review still requires revision after 3 iterations. User confirmation is required to continue with the latest planning artifacts." }
+              }
+            },
+            {
+              "id": "collect_continue_decision",
+              "when": {
+                "all": [
+                  {
+                    "equals": [
+                      { "ref": "steps.design_review_iteration_${iteration}.check_design_review_verdict.value.needsRevision" },
+                      { "const": true }
+                    ]
+                  },
+                  {
+                    "equals": [{ "ref": "repeat.iteration" }, { "const": 3 }]
+                  }
+                ]
+              },
+              "node": "user-input",
+              "params": {
+                "formId": { "const": "design-review-loop-final-decision" },
+                "title": { "const": "Design Review Requires Revision" },
+                "description": { "const": "The latest design review still requires revision after 3 iterations. Decide whether to continue with the latest design and plan artifacts or stop the flow." },
+                "submitLabel": { "const": "Confirm decision" },
+                "fields": {
+                  "list": [
+                    {
+                      "const": {
+                        "id": "decision",
+                        "type": "single-select",
+                        "label": "How to proceed",
+                        "required": true,
+                        "default": "continue",
+                        "options": [
+                          {
+                            "value": "continue",
+                            "label": "Continue with latest artifacts",
+                            "description": "Proceed to implementation using the most recently revised design and plan."
+                          },
+                          {
+                            "value": "stop",
+                            "label": "Stop the flow",
+                            "description": "Do not continue automatically. Review and revise the planning artifacts manually."
+                          }
+                        ]
+                      }
+                    }
+                  ]
+                },
+                "outputFile": {
+                  "template": "{workspace}/design-review-loop-decision-{taskKey}.json",
+                  "vars": {
+                    "workspace": { "ref": "params.workspaceDir" },
+                    "taskKey": { "ref": "params.taskKey" }
+                  }
+                }
+              },
+              "expect": [
+                {
+                  "kind": "require-structured-artifacts",
+                  "items": [
+                    {
+                      "path": {
+                        "template": "{workspace}/design-review-loop-decision-{taskKey}.json",
+                        "vars": {
+                          "workspace": { "ref": "params.workspaceDir" },
+                          "taskKey": { "ref": "params.taskKey" }
+                        }
+                      },
+                      "schemaId": "user-input/v1"
+                    }
+                  ],
+                  "message": "Design-review loop final decision input is missing or invalid."
+                }
+              ]
+            },
+            {
+              "id": "notify_continue_with_latest_artifacts",
+              "when": {
+                "all": [
+                  {
+                    "equals": [
+                      { "ref": "steps.design_review_iteration_${iteration}.check_design_review_verdict.value.needsRevision" },
+                      { "const": true }
+                    ]
+                  },
+                  {
+                    "equals": [{ "ref": "repeat.iteration" }, { "const": 3 }]
+                  },
+                  {
+                    "equals": [
+                      { "ref": "steps.design_review_iteration_${iteration}.collect_continue_decision.value.values.decision" },
+                      { "const": "continue" }
+                    ]
+                  }
+                ]
+              },
+              "node": "telegram-notify",
+              "params": {
+                "message": { "const": "User chose to continue with the latest planning artifacts despite the final design-review verdict." }
+              }
+            },
+            {
+              "id": "stop_after_user_declined",
+              "when": {
+                "all": [
+                  {
+                    "equals": [
+                      { "ref": "steps.design_review_iteration_${iteration}.check_design_review_verdict.value.needsRevision" },
+                      { "const": true }
+                    ]
+                  },
+                  {
+                    "equals": [{ "ref": "repeat.iteration" }, { "const": 3 }]
+                  },
+                  {
+                    "equals": [
+                      { "ref": "steps.design_review_iteration_${iteration}.collect_continue_decision.value.values.decision" },
+                      { "const": "stop" }
+                    ]
+                  }
+                ]
+              },
+              "node": "telegram-notify",
+              "params": {
+                "message": { "const": "User chose to stop after the final design-review verdict still required revision." }
+              },
+              "stopFlowIf": {
+                "all": [
+                  {
+                    "equals": [
+                      { "ref": "steps.design_review_iteration_${iteration}.check_design_review_verdict.value.needsRevision" },
+                      { "const": true }
+                    ]
+                  },
+                  {
+                    "equals": [{ "ref": "repeat.iteration" }, { "const": 3 }]
+                  },
+                  {
+                    "equals": [
+                      { "ref": "steps.design_review_iteration_${iteration}.collect_continue_decision.value.values.decision" },
+                      { "const": "stop" }
+                    ]
+                  }
+                ]
+              },
+              "stopFlowOutcome": "stopped"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/pipeline/flow-specs/design-review.json

@@ -0,0 +1,249 @@
+{
+  "kind": "design-review-flow",
+  "version": 1,
+  "description": "Performs a structured planning critique of the latest completed planning artifacts against the task context available in the scope. Produces a verdict-oriented design review artifact and treats approved_with_warnings as ready to proceed.",
+  "phases": [
+    {
+      "id": "phase_1_load_contract",
+      "steps": [
+        {
+          "id": "validate_design_markdown_artifact",
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.designFile" },
+            "panelTitle": { "const": "Design Markdown Artifact" },
+            "foundMessage": { "const": "Design markdown artifact found for the resolved planning iteration." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.designFile" },
+              "message": "Design-review contract is missing the required design markdown artifact."
+            }
+          ]
+        },
+        {
+          "id": "validate_design_json_artifact",
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.designJsonFile" },
+            "panelTitle": { "const": "Design Structured Artifact" },
+            "foundMessage": { "const": "Design structured artifact found for the resolved planning iteration." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.designJsonFile" },
+              "message": "Design-review contract is missing the required design structured artifact."
+            }
+          ]
+        },
+        {
+          "id": "validate_plan_markdown_artifact",
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.planFile" },
+            "panelTitle": { "const": "Plan Markdown Artifact" },
+            "foundMessage": { "const": "Implementation plan markdown artifact found for the resolved planning iteration." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.planFile" },
+              "message": "Design-review contract is missing the required implementation plan markdown artifact."
+            }
+          ]
+        },
+        {
+          "id": "validate_plan_json_artifact",
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.planJsonFile" },
+            "panelTitle": { "const": "Plan Structured Artifact" },
+            "foundMessage": { "const": "Implementation plan structured artifact found for the resolved planning iteration." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.planJsonFile" },
+              "message": "Design-review contract is missing the required implementation plan structured artifact."
+            }
+          ]
+        },
+        {
+          "id": "validate_qa_markdown_artifact",
+          "when": { "ref": "params.hasQaArtifacts" },
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.qaFilePath" },
+            "panelTitle": { "const": "QA Markdown Artifact" },
+            "foundMessage": { "const": "QA markdown artifact found and will be included in the critique." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.qaFilePath" },
+              "message": "Design-review contract expected a QA markdown artifact, but the file is missing."
+            }
+          ]
+        },
+        {
+          "id": "validate_qa_json_artifact",
+          "when": { "ref": "params.hasQaArtifacts" },
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.qaJsonFilePath" },
+            "panelTitle": { "const": "QA Structured Artifact" },
+            "foundMessage": { "const": "QA structured artifact found and will be included in the critique." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.qaJsonFilePath" },
+              "message": "Design-review contract expected a QA structured artifact, but the file is missing."
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "phase_2_review",
+      "steps": [
+        {
+          "id": "run_design_review",
+          "node": "llm-prompt",
+          "routingGroup": "design-review",
+          "prompt": {
+            "templateRef": "design-review",
+            "vars": {
+              "task_context_json_file": { "ref": "params.taskContextJsonFile" },
+              "jira_task_file": { "ref": "params.jiraTaskFile" },
+              "jira_attachments_manifest_file": { "ref": "params.jiraAttachmentsManifestFile" },
+              "jira_attachments_context_file": { "ref": "params.jiraAttachmentsContextFile" },
+              "planning_answers_json_file": { "ref": "params.planningAnswersJsonFile" },
+              "task_input_json_file": { "ref": "params.taskInputJsonFile" },
+              "design_file": { "ref": "params.designFile" },
+              "design_json_file": { "ref": "params.designJsonFile" },
+              "plan_file": { "ref": "params.planFile" },
+              "plan_json_file": { "ref": "params.planJsonFile" },
+              "qa_file": { "ref": "params.qaFile" },
+              "qa_json_file": { "ref": "params.qaJsonFile" },
+              "review_file": {
+                "artifact": {
+                  "kind": "design-review-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              },
+              "review_json_file": {
+                "artifact": {
+                  "kind": "design-review-json-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              }
+            },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "format": "task-prompt"
+          },
+          "params": {
+            "labelText": {
+              "template": "Running design review (iteration {iteration})",
+              "vars": {
+                "iteration": { "ref": "params.iteration" }
+              }
+            },
+            "model": { "ref": "params.llmModel" },
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "list": [
+                {
+                  "artifact": {
+                    "kind": "design-review-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.iteration" }
+                  }
+                },
+                {
+                  "artifact": {
+                    "kind": "design-review-json-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.iteration" }
+                  }
+                }
+              ]
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-artifacts",
+              "when": { "not": { "ref": "context.dryRun" } },
+              "paths": {
+                "list": [
+                  {
+                    "artifact": {
+                      "kind": "design-review-file",
+                      "taskKey": { "ref": "params.taskKey" },
+                      "iteration": { "ref": "params.iteration" }
+                    }
+                  }
+                ]
+              },
+              "message": "Design review did not produce the required review artifact."
+            },
+            {
+              "kind": "require-structured-artifacts",
+              "when": { "not": { "ref": "context.dryRun" } },
+              "items": [
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "design-review-json-file",
+                      "taskKey": { "ref": "params.taskKey" },
+                      "iteration": { "ref": "params.iteration" }
+                    }
+                  },
+                  "schemaId": "design-review/v1"
+                }
+              ],
+              "message": "Design review produced invalid structured artifacts."
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "phase_3_finalize",
+      "steps": [
+        {
+          "id": "check_ready_to_merge",
+          "node": "file-check",
+          "params": {
+            "path": {
+              "artifact": {
+                "kind": "ready-to-merge-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            },
+            "panelTitle": { "const": "Ready To Merge" },
+            "foundMessage": { "const": "Design review is ready to proceed. File ready-to-merge.md has been created." },
+            "tone": { "const": "green" }
+          }
+        },
+        {
+          "id": "notify_review_complete",
+          "node": "telegram-notify",
+          "params": {
+            "message": { "const": "Design review phase complete" }
+          }
+        }
+      ]
+    }
+  ]
+}

package/dist/pipeline/flow-specs/gitlab/gitlab-diff-review.json

@@ -104,6 +104,7 @@
           "id": "run_diff_review",
           "when": { "not": { "ref": "context.dryRun" } },
           "node": "llm-prompt",
+          "routingGroup": "review",
           "prompt": {
             "templateRef": "gitlab-diff-review",
             "vars": {
@@ -190,6 +191,16 @@
               "message": "Diff review produced invalid structured artifacts."
             }
           ]
+        },
+        {
+          "id": "review_verdict",
+          "node": "review-verdict",
+          "when": { "not": { "ref": "context.dryRun" } },
+          "params": {
+            "taskKey": { "ref": "params.taskKey" },
+            "iteration": { "ref": "params.iteration" },
+            "blockingSeverities": { "ref": "params.reviewBlockingSeverities" }
+          }
         }
       ]
     }

package/dist/pipeline/flow-specs/gitlab/gitlab-review.json

@@ -104,6 +104,7 @@
           "id": "assess_gitlab_review",
           "when": { "not": { "ref": "context.dryRun" } },
           "node": "llm-prompt",
+          "routingGroup": "review",
           "prompt": {
             "templateRef": "gitlab-review",
             "vars": {
@@ -239,6 +240,7 @@
             },
             "reviewFixSelectionJsonFile": { "ref": "params.reviewFixSelectionJsonFile" },
             "reviewFixPoints": { "ref": "params.reviewFixPoints" },
+            "reviewBlockingSeverities": { "ref": "params.reviewBlockingSeverities" },
             "extraPrompt": { "ref": "params.extraPrompt" },
             "llmModel": { "ref": "params.llmModel" },
             "llmExecutor": { "ref": "params.llmExecutor" }

package/dist/pipeline/flow-specs/gitlab/mr-description.json

@@ -9,6 +9,7 @@
         {
           "id": "run_mr_description",
           "node": "llm-prompt",
+          "routingGroup": "review",
           "prompt": {
             "templateRef": "mr-description",
             "vars": {

package/dist/pipeline/flow-specs/go/run-go-linter-loop.json

@@ -56,6 +56,7 @@
             ]
           },
           "node": "llm-prompt",
+          "routingGroup": "local-fix-loop",
           "prompt": {
             "templateRef": "run-go-linter-loop-fix",
             "vars": {
@@ -177,6 +178,7 @@
                 ]
               },
               "node": "llm-prompt",
+              "routingGroup": "local-fix-loop",
               "prompt": {
                 "templateRef": "run-go-linter-loop-fix",
                 "vars": {

package/dist/pipeline/flow-specs/go/run-go-tests-loop.json

@@ -56,6 +56,7 @@
             ]
           },
           "node": "llm-prompt",
+          "routingGroup": "local-fix-loop",
           "prompt": {
             "templateRef": "run-go-tests-loop-fix",
             "vars": {
@@ -177,6 +178,7 @@
                 ]
               },
               "node": "llm-prompt",
+              "routingGroup": "local-fix-loop",
               "prompt": {
                 "templateRef": "run-go-tests-loop-fix",
                 "vars": {