agentweaver 0.1.15 → 0.1.17

package/dist/pipeline/flow-specs/normalize-task-source.json

@@ -0,0 +1,311 @@
+{
+  "kind": "normalize-task-source-flow",
+  "version": 1,
+  "description": "Normalizes the available task source into a connector-agnostic task-context artifact for planning and review flows.",
+  "catalogVisibility": "hidden",
+  "phases": [
+    {
+      "id": "normalize",
+      "steps": [
+        {
+          "id": "validate_jira_source",
+          "when": {
+            "exists": {
+              "artifact": {
+                "kind": "jira-task-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            }
+          },
+          "node": "file-check",
+          "params": {
+            "path": {
+              "artifact": {
+                "kind": "jira-task-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            },
+            "panelTitle": { "const": "Jira Task Source" },
+            "foundMessage": { "const": "Raw Jira task context found and will be normalized." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": {
+                "artifact": {
+                  "kind": "jira-task-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              },
+              "message": "Jira task source is missing."
+            }
+          ]
+        },
+        {
+          "id": "run_normalize_from_jira",
+          "when": {
+            "exists": {
+              "artifact": {
+                "kind": "jira-task-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            }
+          },
+          "node": "llm-prompt",
+          "routingGroup": "planning",
+          "prompt": {
+            "templateRef": "task-context-from-jira",
+            "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" }
+                }
+              },
+              "task_context_file": {
+                "artifact": {
+                  "kind": "task-context-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              },
+              "task_context_json_file": {
+                "artifact": {
+                  "kind": "task-context-json-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              }
+            },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "format": "task-prompt"
+          },
+          "params": {
+            "labelText": { "const": "Normalizing Jira task context" },
+            "model": { "ref": "params.llmModel" },
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "list": [
+                {
+                  "artifact": {
+                    "kind": "task-context-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.iteration" }
+                  }
+                },
+                {
+                  "artifact": {
+                    "kind": "task-context-json-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.iteration" }
+                  }
+                }
+              ]
+            }
+          }
+        },
+        {
+          "id": "validate_manual_source",
+          "when": {
+            "all": [
+              {
+                "not": {
+                  "exists": {
+                    "artifact": {
+                      "kind": "jira-task-file",
+                      "taskKey": { "ref": "params.taskKey" }
+                    }
+                  }
+                }
+              },
+              {
+                "exists": {
+                  "artifact": {
+                    "kind": "instant-task-input-json-file",
+                    "taskKey": { "ref": "params.taskKey" }
+                  }
+                }
+              }
+            ]
+          },
+          "node": "file-check",
+          "params": {
+            "path": {
+              "artifact": {
+                "kind": "instant-task-input-json-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            },
+            "panelTitle": { "const": "Manual Task Source" },
+            "foundMessage": { "const": "Manual task input found and will be normalized." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "instant-task-input-json-file",
+                      "taskKey": { "ref": "params.taskKey" }
+                    }
+                  },
+                  "schemaId": "user-input/v1"
+                }
+              ],
+              "message": "Manual task source input is missing or invalid."
+            }
+          ]
+        },
+        {
+          "id": "run_normalize_from_manual",
+          "when": {
+            "all": [
+              {
+                "not": {
+                  "exists": {
+                    "artifact": {
+                      "kind": "jira-task-file",
+                      "taskKey": { "ref": "params.taskKey" }
+                    }
+                  }
+                }
+              },
+              {
+                "exists": {
+                  "artifact": {
+                    "kind": "instant-task-input-json-file",
+                    "taskKey": { "ref": "params.taskKey" }
+                  }
+                }
+              }
+            ]
+          },
+          "node": "llm-prompt",
+          "routingGroup": "planning",
+          "prompt": {
+            "templateRef": "task-context-from-manual",
+            "vars": {
+              "task_input_file": {
+                "artifact": {
+                  "kind": "instant-task-input-json-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              },
+              "task_context_file": {
+                "artifact": {
+                  "kind": "task-context-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              },
+              "task_context_json_file": {
+                "artifact": {
+                  "kind": "task-context-json-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              }
+            },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "format": "task-prompt"
+          },
+          "params": {
+            "labelText": { "const": "Normalizing manual task context" },
+            "model": { "ref": "params.llmModel" },
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "list": [
+                {
+                  "artifact": {
+                    "kind": "task-context-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.iteration" }
+                  }
+                },
+                {
+                  "artifact": {
+                    "kind": "task-context-json-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.iteration" }
+                  }
+                }
+              ]
+            }
+          }
+        },
+        {
+          "id": "validate_task_context_json",
+          "node": "file-check",
+          "params": {
+            "path": {
+              "artifact": {
+                "kind": "task-context-json-file",
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": { "ref": "params.iteration" }
+              }
+            },
+            "panelTitle": { "const": "Normalized Task Context" },
+            "foundMessage": { "const": "Normalized task context artifact found." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": {
+                "artifact": {
+                  "kind": "task-context-json-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              },
+              "message": "Task source normalization did not produce the task-context artifact."
+            },
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "task-context-json-file",
+                      "taskKey": { "ref": "params.taskKey" },
+                      "iteration": { "ref": "params.iteration" }
+                    }
+                  },
+                  "schemaId": "task-context/v1"
+                }
+              ],
+              "message": "Task source normalization produced an invalid task-context artifact."
+            }
+          ],
+          "after": [
+            {
+              "kind": "set-summary-from-file",
+              "path": {
+                "artifact": {
+                  "kind": "task-context-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/pipeline/flow-specs/plan-revise.json

@@ -152,6 +152,7 @@
         {
           "id": "run_plan_revise",
           "node": "llm-prompt",
+          "routingGroup": "planning",
           "prompt": {
             "templateRef": "plan-revise",
             "vars": {
@@ -163,10 +164,12 @@
               "plan_json_file": { "ref": "params.planJsonFile" },
               "qa_file": { "ref": "params.qaFile" },
               "qa_json_file": { "ref": "params.qaJsonFile" },
+              "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" },
               "revised_design_file": { "ref": "params.revisedDesignFile" },
               "revised_design_json_file": { "ref": "params.revisedDesignJsonFile" },
               "revised_plan_file": { "ref": "params.revisedPlanFile" },
@@ -189,8 +192,11 @@
             "requiredArtifacts": {
               "list": [
                 { "ref": "params.revisedDesignFile" },
+                { "ref": "params.revisedDesignJsonFile" },
                 { "ref": "params.revisedPlanFile" },
-                { "ref": "params.revisedQaFile" }
+                { "ref": "params.revisedPlanJsonFile" },
+                { "ref": "params.revisedQaFile" },
+                { "ref": "params.revisedQaJsonFile" }
               ]
             }
           },

package/dist/pipeline/flow-specs/plan.json

@@ -1,90 +1,68 @@
 {
   "kind": "plan-flow",
   "version": 1,
-  "description": "Fetches Jira task with attachments, generates clarifying questions for the developer, collects answers, and produces design, implementation plan, and QA plan as structured JSON and markdown artifacts.",
+  "description": "Consumes the normalized task-context artifact, generates clarifying questions for the developer, collects answers, and produces design, implementation plan, and QA plan as structured JSON and markdown artifacts.",
   "phases": [
     {
       "id": "plan",
       "steps": [
         {
-          "id": "fetch_jira",
-          "node": "jira-fetch",
+          "id": "validate_task_context",
+          "node": "file-check",
           "params": {
-            "jiraApiUrl": { "ref": "params.jiraApiUrl" },
-            "outputFile": {
-              "artifact": {
-                "kind": "jira-task-file",
-                "taskKey": { "ref": "params.taskKey" }
-              }
-            },
-            "attachmentsManifestFile": {
+            "path": {
               "artifact": {
-                "kind": "jira-attachments-manifest-file",
-                "taskKey": { "ref": "params.taskKey" }
+                "kind": "task-context-json-file",
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": { "ref": "params.taskContextIteration" }
               }
             },
-            "attachmentsContextFile": {
-              "artifact": {
-                "kind": "jira-attachments-context-file",
-                "taskKey": { "ref": "params.taskKey" }
-              }
-            }
+            "panelTitle": { "const": "Task Context" },
+            "foundMessage": { "const": "Normalized task context artifact found for planning." },
+            "tone": { "const": "cyan" }
           },
           "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" }
+                  "kind": "task-context-json-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.taskContextIteration" }
                 }
               },
-              "message": "Jira fetch node did not produce the Jira attachments manifest file."
+              "message": "Plan mode requires a normalized task-context artifact."
             },
             {
-              "kind": "require-file",
-              "path": {
-                "artifact": {
-                  "kind": "jira-attachments-context-file",
-                  "taskKey": { "ref": "params.taskKey" }
+              "kind": "require-structured-artifacts",
+              "items": [
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "task-context-json-file",
+                      "taskKey": { "ref": "params.taskKey" },
+                      "iteration": { "ref": "params.taskContextIteration" }
+                    }
+                  },
+                  "schemaId": "task-context/v1"
                 }
-              },
-              "message": "Jira fetch node did not produce the Jira attachments context file."
+              ],
+              "message": "Plan mode requires a valid task-context artifact."
             }
           ]
         },
         {
           "id": "generate_planning_questions",
           "node": "llm-prompt",
+          "routingGroup": "planning",
           "prompt": {
             "templateRef": "plan-questions",
             "vars": {
-              "jira_task_file": {
+              "task_context_json_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" }
+                  "kind": "task-context-json-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.taskContextIteration" }
                 }
               },
               "planning_questions_json_file": {
@@ -165,6 +143,7 @@
         },
         {
           "id": "notify_questions_need_answering",
+          "when": { "not": { "equals": [{ "ref": "steps.plan.build_planning_questions_form.value.questionCount" }, { "const": 0 }] } },
           "node": "telegram-notify",
           "params": {
             "message": { "const": "Questions need answering" }
@@ -207,24 +186,20 @@
         {
           "id": "run_plan",
           "node": "llm-prompt",
+          "routingGroup": "planning",
           "prompt": {
             "templateRef": "plan",
             "vars": {
-              "jira_task_file": {
+              "task_context_json_file": {
                 "artifact": {
-                  "kind": "jira-task-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "jira_attachments_manifest_file": {
-                "artifact": {
-                  "kind": "jira-attachments-manifest-file",
-                  "taskKey": { "ref": "params.taskKey" }
+                  "kind": "task-context-json-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.taskContextIteration" }
                 }
               },
-              "jira_attachments_context_file": {
+              "planning_answers_json_file": {
                 "artifact": {
-                  "kind": "jira-attachments-context-file",
+                  "kind": "planning-answers-json-file",
                   "taskKey": { "ref": "params.taskKey" }
                 }
               },
@@ -272,17 +247,21 @@
               }
             },
             "extraPrompt": {
-              "appendPrompt": {
-                "base": { "ref": "params.extraPrompt" },
-                "suffix": { "ref": "steps.plan.collect_planning_answers.value.promptSuffix" }
-              }
+              "ref": "params.extraPrompt"
             },
             "format": "task-prompt"
           },
           "params": {
             "labelText": { "const": "Running planning mode" },
             "model": { "ref": "params.llmModel" },
-            "executor": { "ref": "params.llmExecutor" }
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "artifactList": {
+                "kind": "plan-artifacts",
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": { "ref": "params.planIteration" }
+              }
+            }
           },
           "expect": [
             {
@@ -291,7 +270,8 @@
               "paths": {
                 "artifactList": {
                   "kind": "plan-artifacts",
-                  "taskKey": { "ref": "params.taskKey" }
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.planIteration" }
                 }
               },
               "message": "Plan mode did not produce the required artifacts."

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

@@ -1,9 +1,9 @@
 {
   "kind": "review-fix-flow",
   "version": 1,
-  "description": "Takes review findings, auto-selects blockers and criticals (or lets the developer pick manually), builds a targeted fix prompt, and applies fixes locally. Runs mandatory checks after modifications.",
+  "description": "Takes review findings, auto-selects the configured blocking severities (or lets the developer pick manually), builds a targeted fix prompt, and applies fixes locally. Runs mandatory checks after modifications.",
   "constants": {
-    "autoReviewFixExtraPrompt": "Fix only blockers and criticals"
+    "autoReviewFixExtraPrompt": "Fix only blocking severities"
   },
   "phases": [
     {
@@ -56,7 +56,8 @@
                 "iteration": { "ref": "params.latestIteration" }
               }
             },
-            "selectionMode": { "const": "auto-blockers-criticals" }
+            "selectionMode": { "const": "auto-blocking-severities" },
+            "blockingSeverities": { "ref": "params.reviewBlockingSeverities" }
           }
         },
         {
@@ -114,6 +115,7 @@
         {
           "id": "run_review_fix",
           "node": "llm-prompt",
+          "routingGroup": "repair-loop",
           "prompt": {
             "templateRef": "review-fix",
             "vars": {
@@ -163,7 +165,25 @@
               }
             },
             "model": { "ref": "params.llmModel" },
-            "executor": { "ref": "params.llmExecutor" }
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "list": [
+                {
+                  "artifact": {
+                    "kind": "review-fix-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.latestIteration" }
+                  }
+                },
+                {
+                  "artifact": {
+                    "kind": "review-fix-json-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.latestIteration" }
+                  }
+                }
+              ]
+            }
           },
           "expect": [
             {