agentweaver 0.1.14 → 0.1.16

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

@@ -0,0 +1,267 @@
+{
+  "kind": "plan-revise-flow",
+  "version": 1,
+  "description": "Consumes a design-review verdict artifact and the latest planning artifacts, then produces revised design, implementation plan, and QA artifacts at the next iteration number without modifying originals.",
+  "phases": [
+    {
+      "id": "phase_1_load_contract",
+      "steps": [
+        {
+          "id": "validate_review_markdown",
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.reviewFile" },
+            "panelTitle": { "const": "Design Review Verdict Markdown" },
+            "foundMessage": { "const": "Design review verdict markdown found." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.reviewFile" },
+              "message": "Plan-revise contract is missing the required design-review verdict markdown."
+            }
+          ]
+        },
+        {
+          "id": "validate_review_json",
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.reviewJsonFile" },
+            "panelTitle": { "const": "Design Review Verdict JSON" },
+            "foundMessage": { "const": "Design review verdict JSON found." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.reviewJsonFile" },
+              "message": "Plan-revise contract is missing the required design-review verdict JSON."
+            }
+          ]
+        },
+        {
+          "id": "validate_source_design_markdown",
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.designFile" },
+            "panelTitle": { "const": "Source Design Markdown" },
+            "foundMessage": { "const": "Source design markdown artifact found." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.designFile" },
+              "message": "Plan-revise contract is missing the required source design markdown."
+            }
+          ]
+        },
+        {
+          "id": "validate_source_design_json",
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.designJsonFile" },
+            "panelTitle": { "const": "Source Design JSON" },
+            "foundMessage": { "const": "Source design structured artifact found." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.designJsonFile" },
+              "message": "Plan-revise contract is missing the required source design JSON."
+            }
+          ]
+        },
+        {
+          "id": "validate_source_plan_markdown",
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.planFile" },
+            "panelTitle": { "const": "Source Plan Markdown" },
+            "foundMessage": { "const": "Source implementation plan markdown found." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.planFile" },
+              "message": "Plan-revise contract is missing the required source plan markdown."
+            }
+          ]
+        },
+        {
+          "id": "validate_source_plan_json",
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.planJsonFile" },
+            "panelTitle": { "const": "Source Plan JSON" },
+            "foundMessage": { "const": "Source implementation plan structured artifact found." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.planJsonFile" },
+              "message": "Plan-revise contract is missing the required source plan JSON."
+            }
+          ]
+        },
+        {
+          "id": "validate_source_qa_markdown",
+          "when": { "ref": "params.hasQaArtifacts" },
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.qaFilePath" },
+            "panelTitle": { "const": "Source QA Markdown" },
+            "foundMessage": { "const": "Source QA markdown artifact found." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.qaFilePath" },
+              "message": "Plan-revise contract expected a source QA markdown artifact, but the file is missing."
+            }
+          ]
+        },
+        {
+          "id": "validate_source_qa_json",
+          "when": { "ref": "params.hasQaArtifacts" },
+          "node": "file-check",
+          "params": {
+            "path": { "ref": "params.qaJsonFilePath" },
+            "panelTitle": { "const": "Source QA JSON" },
+            "foundMessage": { "const": "Source QA structured artifact found." },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": { "ref": "params.qaJsonFilePath" },
+              "message": "Plan-revise contract expected a source QA JSON artifact, but the file is missing."
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "phase_2_revise",
+      "steps": [
+        {
+          "id": "run_plan_revise",
+          "node": "llm-prompt",
+          "routingGroup": "planning",
+          "prompt": {
+            "templateRef": "plan-revise",
+            "vars": {
+              "review_file": { "ref": "params.reviewFile" },
+              "review_json_file": { "ref": "params.reviewJsonFile" },
+              "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" },
+              "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" },
+              "revised_plan_json_file": { "ref": "params.revisedPlanJsonFile" },
+              "revised_qa_file": { "ref": "params.revisedQaFile" },
+              "revised_qa_json_file": { "ref": "params.revisedQaJsonFile" }
+            },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "format": "task-prompt"
+          },
+          "params": {
+            "labelText": {
+              "template": "Revising planning artifacts (iteration {outputIteration})",
+              "vars": {
+                "outputIteration": { "ref": "params.outputIteration" }
+              }
+            },
+            "model": { "ref": "params.llmModel" },
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "list": [
+                { "ref": "params.revisedDesignFile" },
+                { "ref": "params.revisedDesignJsonFile" },
+                { "ref": "params.revisedPlanFile" },
+                { "ref": "params.revisedPlanJsonFile" },
+                { "ref": "params.revisedQaFile" },
+                { "ref": "params.revisedQaJsonFile" }
+              ]
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-artifacts",
+              "when": { "not": { "ref": "context.dryRun" } },
+              "paths": {
+                "list": [
+                  { "ref": "params.revisedDesignFile" },
+                  { "ref": "params.revisedPlanFile" },
+                  { "ref": "params.revisedQaFile" }
+                ]
+              },
+              "message": "Plan-revise did not produce the required revised markdown artifacts."
+            },
+            {
+              "kind": "require-structured-artifacts",
+              "when": { "not": { "ref": "context.dryRun" } },
+              "items": [
+                {
+                  "path": { "ref": "params.revisedDesignJsonFile" },
+                  "schemaId": "implementation-design/v1"
+                },
+                {
+                  "path": { "ref": "params.revisedPlanJsonFile" },
+                  "schemaId": "implementation-plan/v1"
+                },
+                {
+                  "path": { "ref": "params.revisedQaJsonFile" },
+                  "schemaId": "qa-plan/v1"
+                }
+              ],
+              "message": "Plan-revise 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": "Plan-revise completed and all blocking findings addressed. File ready-to-merge.md has been created." },
+            "tone": { "const": "green" }
+          }
+        },
+        {
+          "id": "notify_revise_complete",
+          "node": "telegram-notify",
+          "params": {
+            "message": { "const": "Plan-revise phase complete" }
+          }
+        }
+      ]
+    }
+  ]
+}

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": {
+            "path": {
               "artifact": {
-                "kind": "jira-task-file",
-                "taskKey": { "ref": "params.taskKey" }
+                "kind": "task-context-json-file",
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": { "ref": "params.taskContextIteration" }
               }
             },
-            "attachmentsManifestFile": {
-              "artifact": {
-                "kind": "jira-attachments-manifest-file",
-                "taskKey": { "ref": "params.taskKey" }
-              }
-            },
-            "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": {
-                "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": {
+              "task_context_json_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,20 @@
               }
             },
             "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" }
+              }
+            }
           },
           "expect": [
             {

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": [
             {