agentweaver 0.1.14 → 0.1.16

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

@@ -9,39 +9,17 @@
         {
           "id": "run_review",
           "node": "llm-prompt",
+          "routingGroup": "review",
           "prompt": {
             "templateRef": "review",
             "vars": {
-              "jira_task_file": {
-                "artifact": {
-                  "kind": "jira-task-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "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" }
-                }
-              },
+              "task_context_json_file": { "ref": "params.taskContextJsonFile" },
+              "jira_task_file": { "ref": "params.jiraTaskFile" },
+              "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" },
               "review_file": {
                 "artifact": {
                   "kind": "review-file",
@@ -68,7 +46,25 @@
               }
             },
             "model": { "ref": "params.llmModel" },
-            "executor": { "ref": "params.llmExecutor" }
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "list": [
+                {
+                  "artifact": {
+                    "kind": "review-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.iteration" }
+                  }
+                },
+                {
+                  "artifact": {
+                    "kind": "review-json-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.iteration" }
+                  }
+                }
+              ]
+            }
           },
           "expect": [
             {
@@ -106,6 +102,16 @@
             }
           ]
         },
+        {
+          "id": "review_verdict",
+          "node": "review-verdict",
+          "when": { "not": { "ref": "context.dryRun" } },
+          "params": {
+            "taskKey": { "ref": "params.taskKey" },
+            "iteration": { "ref": "params.iteration" },
+            "blockingSeverities": { "ref": "params.reviewBlockingSeverities" }
+          }
+        },
         {
           "id": "check_ready_to_merge",
           "node": "file-check",

package/dist/pipeline/flow-specs/task-describe.json

@@ -153,6 +153,7 @@
         {
           "id": "run_task_describe_from_jira",
           "node": "llm-prompt",
+          "routingGroup": "planning",
           "when": {
             "ref": "steps.task_describe.collect_task_source.value.values.jira_ref"
           },
@@ -235,10 +236,37 @@
                 }
               },
               "message": "Task describe mode did not produce the Jira description artifact."
+            }
+          ]
+        },
+        {
+          "id": "ensure_task_describe_json_from_jira_markdown",
+          "node": "ensure-summary-json",
+          "when": {
+            "all": [
+              { "ref": "steps.task_describe.collect_task_source.value.values.jira_ref" },
+              { "not": { "ref": "context.dryRun" } }
+            ]
+          },
+          "params": {
+            "markdownFile": {
+              "artifact": {
+                "kind": "jira-description-file",
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": { "ref": "params.iteration" }
+              }
             },
+            "outputFile": {
+              "artifact": {
+                "kind": "jira-description-json-file",
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": { "ref": "params.iteration" }
+              }
+            }
+          },
+          "expect": [
             {
               "kind": "require-structured-artifacts",
-              "when": { "not": { "ref": "context.dryRun" } },
               "items": [
                 {
                   "path": {
@@ -258,6 +286,7 @@
         {
           "id": "run_task_describe_from_input",
           "node": "llm-prompt",
+          "routingGroup": "planning",
           "when": {
             "not": {
               "ref": "steps.task_describe.collect_task_source.value.values.jira_ref"
@@ -330,10 +359,41 @@
                 }
               },
               "message": "Task describe mode did not produce the Jira description artifact."
+            }
+          ]
+        },
+        {
+          "id": "ensure_task_describe_json_from_input_markdown",
+          "node": "ensure-summary-json",
+          "when": {
+            "all": [
+              {
+                "not": {
+                  "ref": "steps.task_describe.collect_task_source.value.values.jira_ref"
+                }
+              },
+              { "not": { "ref": "context.dryRun" } }
+            ]
+          },
+          "params": {
+            "markdownFile": {
+              "artifact": {
+                "kind": "jira-description-file",
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": { "ref": "params.iteration" }
+              }
             },
+            "outputFile": {
+              "artifact": {
+                "kind": "jira-description-json-file",
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": { "ref": "params.iteration" }
+              }
+            }
+          },
+          "expect": [
             {
               "kind": "require-structured-artifacts",
-              "when": { "not": { "ref": "context.dryRun" } },
               "items": [
                 {
                   "path": {

package/dist/pipeline/flow-specs/task-source/jira-fetch.json

@@ -0,0 +1,70 @@
+{
+  "kind": "task-source-jira-flow",
+  "version": 1,
+  "description": "Fetches raw Jira task context and attachments into scope artifacts for subsequent normalization.",
+  "catalogVisibility": "hidden",
+  "phases": [
+    {
+      "id": "source",
+      "steps": [
+        {
+          "id": "fetch_jira",
+          "node": "jira-fetch",
+          "params": {
+            "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."
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/pipeline/flow-specs/task-source/manual-input.json

@@ -0,0 +1,216 @@
+{
+  "kind": "task-source-manual-flow",
+  "version": 1,
+  "description": "Collects manual task input in the current project scope for subsequent normalization and planning. Stored input is reused on reruns and can be edited on interactive restart.",
+  "catalogVisibility": "hidden",
+  "phases": [
+    {
+      "id": "source",
+      "steps": [
+        {
+          "id": "edit_task_source",
+          "when": {
+            "all": [
+              {
+                "ref": "params.repromptInstantTaskInput"
+              },
+              {
+                "exists": {
+                  "artifact": {
+                    "kind": "instant-task-input-json-file",
+                    "taskKey": { "ref": "params.taskKey" }
+                  }
+                }
+              }
+            ]
+          },
+          "node": "user-input",
+          "params": {
+            "formId": { "const": "instant-task-input" },
+            "title": { "const": "Instant Task Input" },
+            "description": {
+              "const": "Review and edit the saved instant-task request for this branch-derived lineage before restarting planning."
+            },
+            "submitLabel": { "const": "Restart planning" },
+            "fields": {
+              "list": [
+                {
+                  "const": {
+                    "id": "task_description",
+                    "type": "text",
+                    "label": "Task description",
+                    "help": "Update the requested work for this restart. Leave the field empty to keep the current value.",
+                    "required": true,
+                    "multiline": true,
+                    "rows": 5,
+                    "placeholder": "e.g. add an instant-task command that runs planning, implementation, and review without Jira"
+                  }
+                },
+                {
+                  "const": {
+                    "id": "additional_instructions",
+                    "type": "text",
+                    "label": "Additional instructions",
+                    "help": "Update optional constraints, references, or implementation notes for this restart.",
+                    "required": false,
+                    "multiline": true,
+                    "rows": 4,
+                    "placeholder": "e.g. keep the existing Jira-backed flows unchanged, add tests for review routing"
+                  }
+                }
+              ]
+            },
+            "initialValues": { "ref": "params.prefilledInstantTaskInputValues" },
+            "outputFile": {
+              "artifact": {
+                "kind": "instant-task-input-json-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "instant-task-input-json-file",
+                      "taskKey": { "ref": "params.taskKey" }
+                    }
+                  },
+                  "schemaId": "user-input/v1"
+                }
+              ],
+              "message": "Instant-task source input is missing or invalid."
+            }
+          ]
+        },
+        {
+          "id": "collect_task_source",
+          "when": {
+            "not": {
+              "exists": {
+                "artifact": {
+                  "kind": "instant-task-input-json-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              }
+            }
+          },
+          "node": "user-input",
+          "params": {
+            "formId": { "const": "instant-task-input" },
+            "title": { "const": "Instant Task Input" },
+            "description": {
+              "const": "Describe the task for this branch-derived lineage. The saved task input will be reused on reruns unless you choose interactive restart and edit it."
+            },
+            "submitLabel": { "const": "Start planning" },
+            "fields": {
+              "list": [
+                {
+                  "const": {
+                    "id": "task_description",
+                    "type": "text",
+                    "label": "Task description",
+                    "help": "Describe the requested work. This text becomes the source-of-truth input for the instant-task lineage.",
+                    "required": true,
+                    "multiline": true,
+                    "rows": 5,
+                    "placeholder": "e.g. add an instant-task command that runs planning, implementation, and review without Jira"
+                  }
+                },
+                {
+                  "const": {
+                    "id": "additional_instructions",
+                    "type": "text",
+                    "label": "Additional instructions",
+                    "help": "Optional extra constraints, references, or implementation notes for the same task lineage.",
+                    "required": false,
+                    "multiline": true,
+                    "rows": 4,
+                    "placeholder": "e.g. keep the existing Jira-backed flows unchanged, add tests for review routing"
+                  }
+                }
+              ]
+            },
+            "outputFile": {
+              "artifact": {
+                "kind": "instant-task-input-json-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "instant-task-input-json-file",
+                      "taskKey": { "ref": "params.taskKey" }
+                    }
+                  },
+                  "schemaId": "user-input/v1"
+                }
+              ],
+              "message": "Instant-task source input is missing or invalid."
+            }
+          ]
+        },
+        {
+          "id": "validate_task_source_artifact",
+          "when": {
+            "all": [
+              {
+                "not": {
+                  "ref": "params.repromptInstantTaskInput"
+                }
+              },
+              {
+                "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": "Instant Task Source Artifact" },
+            "foundMessage": {
+              "const": "Validated the saved instant-task source artifact before continuing planning."
+            },
+            "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": "Instant-task source input is missing or invalid."
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/pipeline/node-registry.js

@@ -1,8 +1,11 @@
 import { buildFailureSummaryNode } from "./nodes/build-failure-summary-node.js";
 import { buildReviewFixPromptNode } from "./nodes/build-review-fix-prompt-node.js";
+import { clearReadyToMergeNode } from "./nodes/clear-ready-to-merge-node.js";
 import { codexPromptNode } from "./nodes/codex-prompt-node.js";
 import { commandCheckNode } from "./nodes/command-check-node.js";
 import { commitMessageFormNode } from "./nodes/commit-message-form-node.js";
+import { designReviewVerdictNode } from "./nodes/design-review-verdict-node.js";
+import { ensureSummaryJsonNode } from "./nodes/ensure-summary-json-node.js";
 import { fetchGitLabDiffNode } from "./nodes/fetch-gitlab-diff-node.js";
 import { fetchGitLabReviewNode } from "./nodes/fetch-gitlab-review-node.js";
 import { fileCheckNode } from "./nodes/file-check-node.js";
@@ -18,10 +21,13 @@ import { localScriptCheckNode } from "./nodes/local-script-check-node.js";
 import { llmPromptNode } from "./nodes/llm-prompt-node.js";
 import { opencodePromptNode } from "./nodes/opencode-prompt-node.js";
 import { planCodexNode } from "./nodes/plan-codex-node.js";
+import { planningBundleNode } from "./nodes/planning-bundle-node.js";
 import { planningQuestionsFormNode } from "./nodes/planning-questions-form-node.js";
 import { readFileNode } from "./nodes/read-file-node.js";
 import { reviewFindingsFormNode } from "./nodes/review-findings-form-node.js";
+import { reviewVerdictNode } from "./nodes/review-verdict-node.js";
 import { selectFilesFormNode } from "./nodes/select-files-form-node.js";
+import { structuredSummaryNode } from "./nodes/structured-summary-node.js";
 import { summaryFileLoadNode } from "./nodes/summary-file-load-node.js";
 import { telegramNotifierNode } from "./nodes/telegram-notifier-node.js";
 import { userInputNode } from "./nodes/user-input-node.js";
@@ -29,9 +35,12 @@ import { writeSelectionFileNode } from "./nodes/write-selection-file-node.js";
 const builtInNodes = {
     "build-failure-summary": buildFailureSummaryNode,
     "build-review-fix-prompt": buildReviewFixPromptNode,
+    "clear-ready-to-merge": clearReadyToMergeNode,
     "codex-prompt": codexPromptNode,
     "command-check": commandCheckNode,
     "commit-message-form": commitMessageFormNode,
+    "design-review-verdict": designReviewVerdictNode,
+    "ensure-summary-json": ensureSummaryJsonNode,
     "fetch-gitlab-diff": fetchGitLabDiffNode,
     "fetch-gitlab-review": fetchGitLabReviewNode,
     "file-check": fileCheckNode,
@@ -47,10 +56,13 @@ const builtInNodes = {
     "llm-prompt": llmPromptNode,
     "opencode-prompt": opencodePromptNode,
     "plan-codex": planCodexNode,
+    "planning-bundle": planningBundleNode,
     "planning-questions-form": planningQuestionsFormNode,
     "read-file": readFileNode,
     "review-findings-form": reviewFindingsFormNode,
+    "review-verdict": reviewVerdictNode,
     "select-files-form": selectFilesFormNode,
+    "structured-summary": structuredSummaryNode,
     "summary-file-load": summaryFileLoadNode,
     "telegram-notify": telegramNotifierNode,
     "user-input": userInputNode,
@@ -70,6 +82,12 @@ const builtInNodeMetadata = {
         prompt: "forbidden",
         requiredParams: ["selectionFile", "autoMode"],
     },
+    "clear-ready-to-merge": {
+        kind: "clear-ready-to-merge",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["taskKey"],
+    },
     "codex-prompt": {
         kind: "codex-prompt",
         version: 1,
@@ -90,6 +108,18 @@ const builtInNodeMetadata = {
         prompt: "forbidden",
         requiredParams: ["commitMessageFile", "formId", "title", "outputFile"],
     },
+    "design-review-verdict": {
+        kind: "design-review-verdict",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["taskKey"],
+    },
+    "ensure-summary-json": {
+        kind: "ensure-summary-json",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["markdownFile", "outputFile"],
+    },
     "fetch-gitlab-diff": {
         kind: "fetch-gitlab-diff",
         version: 1,
@@ -150,7 +180,7 @@ const builtInNodeMetadata = {
         kind: "llm-prompt",
         version: 1,
         prompt: "required",
-        requiredParams: ["labelText", "executor"],
+        requiredParams: ["labelText"],
         executors: ["codex", "opencode"],
     },
     "opencode-prompt": { kind: "opencode-prompt", version: 1, prompt: "required", requiredParams: ["labelText"] },
@@ -161,6 +191,12 @@ const builtInNodeMetadata = {
         requiredParams: ["prompt", "requiredArtifacts"],
         executors: ["codex"],
     },
+    "planning-bundle": {
+        kind: "planning-bundle",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["taskKey"],
+    },
     "planning-questions-form": {
         kind: "planning-questions-form",
         version: 1,
@@ -174,12 +210,24 @@ const builtInNodeMetadata = {
         prompt: "forbidden",
         requiredParams: ["reviewFindingsJsonFile", "formId", "title"],
     },
+    "review-verdict": {
+        kind: "review-verdict",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["taskKey"],
+    },
     "select-files-form": {
         kind: "select-files-form",
         version: 1,
         prompt: "forbidden",
         requiredParams: ["gitStatusJsonFile", "formId", "title", "outputFile"],
     },
+    "structured-summary": {
+        kind: "structured-summary",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["path"],
+    },
     "summary-file-load": { kind: "summary-file-load", version: 1, prompt: "forbidden", requiredParams: ["path"] },
     "telegram-notify": {
         kind: "telegram-notify",

package/dist/pipeline/node-runner.js

@@ -1,11 +1,12 @@
 import { setCurrentNode } from "../tui.js";
 import { runNodeChecks } from "./checks.js";
 export async function runNode(node, context, params, options = {}) {
+    const effectiveContext = options.contextOverrides ? { ...context, ...options.contextOverrides } : context;
     setCurrentNode(node.kind);
     try {
-        const result = await node.run(context, params);
+        const result = await node.run(effectiveContext, params);
         if (!options.skipChecks) {
-            const checks = node.checks?.(context, params, result) ?? [];
+            const checks = node.checks?.(effectiveContext, params, result) ?? [];
             runNodeChecks(checks);
         }
         return result;

package/dist/pipeline/nodes/build-review-fix-prompt-node.js

@@ -22,7 +22,11 @@ export const buildReviewFixPromptNode = {
             "Use the user selection below as source of truth for the current review-fix scope.",
             `Selection file: ${params.selectionFile}`,
             `apply_all: ${applyAll ? "true" : "false"}`,
-            applyAll ? "Fix all findings in the current iteration." : `Fix only selected findings:\n- ${selectedFindings.join("\n- ")}`,
+            applyAll
+                ? "Fix all findings in the current iteration."
+                : selectedFindings.length > 0
+                    ? `Fix only selected findings:\n- ${selectedFindings.join("\n- ")}`
+                    : "No findings were selected for this review-fix iteration. Do not modify code; report the no-op outcome after validation.",
         ].join("\n\n");
         return {
             value: {

package/dist/pipeline/nodes/clear-ready-to-merge-node.js

@@ -0,0 +1,11 @@
+import { clearReadyToMergeFile } from "../../runtime/ready-to-merge.js";
+export const clearReadyToMergeNode = {
+    kind: "clear-ready-to-merge",
+    version: 1,
+    async run(_context, params) {
+        const cleared = clearReadyToMergeFile(params.taskKey);
+        return {
+            value: { cleared },
+        };
+    },
+};

package/dist/pipeline/nodes/commit-message-form-node.js

@@ -1,5 +1,6 @@
 import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import path from "node:path";
+import { buildLogicalKeyForPayload } from "../../artifact-manifest.js";
 import { TaskRunnerError } from "../../errors.js";
 import { validateUserInputValues } from "../../user-input.js";
 function parseCommitMessage(content) {
@@ -72,6 +73,13 @@ export const commitMessageFormNode = {
                     kind: "artifact",
                     path: params.outputFile,
                     required: true,
+                    manifest: {
+                        publish: true,
+                        logicalKey: buildLogicalKeyForPayload(context.issueKey, params.outputFile),
+                        payloadFamily: "structured-json",
+                        schemaId: "user-input/v1",
+                        schemaVersion: 1,
+                    },
                 },
             ],
         };