agentweaver 0.1.13 → 0.1.15

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

@@ -0,0 +1,239 @@
+{
+  "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",
+          "prompt": {
+            "templateRef": "design-review",
+            "vars": {
+              "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" },
+              "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" }
+                  }
+                }
+              ]
+            }
+          },
+          "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/git-commit.json

@@ -1,6 +1,7 @@
 {
   "kind": "git-commit-flow",
   "version": 1,
+  "description": "Four-phase commit workflow: collects git status and diff, generates a commit message via LLM, presents a file selection form, then shows the editable message for confirmation and executes the commit.",
   "phases": [
     {
       "id": "collect_status",

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

@@ -1,6 +1,7 @@
 {
   "kind": "gitlab-diff-review-flow",
   "version": 1,
+  "description": "Prompts for a GitLab merge request URL, fetches the MR diff via GitLab API, and runs LLM-backed code review producing structured findings with severity levels and a ready-to-merge verdict.",
   "phases": [
     {
       "id": "gitlab_diff_review",
@@ -11,14 +12,14 @@
           "params": {
             "formId": { "const": "gitlab-diff-review-input" },
             "title": { "const": "GitLab Diff Review" },
-            "description": { "const": "Укажи ссылку на GitLab merge request, чтобы загрузить diff и запустить код-ревью." },
+            "description": { "const": "Provide a GitLab merge request URL to fetch the diff and run code review." },
             "fields": {
               "const": [
                 {
                   "id": "merge_request_url",
                   "type": "text",
                   "label": "GitLab MR URL",
-                  "help": "Например: https://gitlab.example.com/group/project/-/merge_requests/123",
+                  "help": "Example: https://gitlab.example.com/group/project/-/merge_requests/123",
                   "required": true,
                   "placeholder": "https://gitlab.example.com/group/project/-/merge_requests/123"
                 }

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

@@ -1,6 +1,7 @@
 {
   "kind": "gitlab-review-flow",
   "version": 1,
+  "description": "Prompts for a GitLab merge request URL, fetches existing code review comments via GitLab API, assesses which findings are fair and which can be dismissed, then runs review-fix to apply fixes for the accepted findings.",
   "phases": [
     {
       "id": "gitlab_review",
@@ -11,14 +12,14 @@
           "params": {
             "formId": { "const": "gitlab-review-input" },
             "title": { "const": "GitLab Review" },
-            "description": { "const": "Укажи ссылку на GitLab merge request, чтобы загрузить комментарии код-ревью." },
+            "description": { "const": "Provide a GitLab merge request URL to fetch code review comments." },
             "fields": {
               "const": [
                 {
                   "id": "merge_request_url",
                   "type": "text",
                   "label": "GitLab MR URL",
-                  "help": "Например: https://gitlab.example.com/group/project/-/merge_requests/123",
+                  "help": "Example: https://gitlab.example.com/group/project/-/merge_requests/123",
                   "required": true,
                   "placeholder": "https://gitlab.example.com/group/project/-/merge_requests/123"
                 }

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

@@ -1,6 +1,7 @@
 {
   "kind": "mr-description-flow",
   "version": 1,
+  "description": "Generates a concise merge request description based on the task context and current code changes. Produces both markdown and structured JSON artifacts.",
   "phases": [
     {
       "id": "mr_description",

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

@@ -1,6 +1,7 @@
 {
   "kind": "run-go-linter-loop-flow",
   "version": 1,
+  "description": "Runs run_go_linter.py and analyzes output. If the linter reports issues, sends them to LLM for a fix and retries. Repeats up to 5 attempts, stopping early on success. Asserts success after the final attempt.",
   "phases": [
     {
       "id": "run_go_linter_try_1",
@@ -70,7 +71,7 @@
               "appendPrompt": {
                 "base": { "ref": "params.extraPrompt" },
                 "suffix": {
-                  "template": "Последний результат run_go_linter.py сохранён в {result_file}. exitCode={exit_code}, summary={summary}.\nПолный raw-вывод последнего запуска:\n{raw_output}\nИсправь только то, что мешает успешному прохождению проверки.",
+                  "template": "Latest run_go_linter.py result saved in {result_file}. exitCode={exit_code}, summary={summary}.\nFull raw output of the last run:\n{raw_output}\nFix only what prevents the check from passing.",
                   "vars": {
                     "result_file": {
                       "artifact": {
@@ -197,7 +198,7 @@
                   "appendPrompt": {
                     "base": { "ref": "params.extraPrompt" },
                     "suffix": {
-                      "template": "Последний результат run_go_linter.py сохранён в {result_file}. exitCode={exit_code}, summary={summary}.\nПолный raw-вывод последнего запуска:\n{raw_output}\nИсправь только то, что мешает успешному прохождению проверки.",
+                      "template": "Latest run_go_linter.py result saved in {result_file}. exitCode={exit_code}, summary={summary}.\nFull raw output of the last run:\n{raw_output}\nFix only what prevents the check from passing.",
                       "vars": {
                         "result_file": {
                           "artifact": {

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

@@ -1,6 +1,7 @@
 {
   "kind": "run-go-tests-loop-flow",
   "version": 1,
+  "description": "Runs run_go_tests.py and analyzes failures. If tests fail, sends the error output to LLM for a fix and retries. Repeats up to 5 attempts, stopping early on success. Asserts success after the final attempt.",
   "phases": [
     {
       "id": "run_go_tests_try_1",
@@ -70,7 +71,7 @@
               "appendPrompt": {
                 "base": { "ref": "params.extraPrompt" },
                 "suffix": {
-                  "template": "Последний результат run_go_tests.py сохранён в {result_file}. exitCode={exit_code}, summary={summary}.\nПолный raw-вывод последнего запуска:\n{raw_output}\nИсправь только то, что мешает успешному прохождению проверки.",
+                  "template": "Latest run_go_tests.py result saved in {result_file}. exitCode={exit_code}, summary={summary}.\nFull raw output of the last run:\n{raw_output}\nFix only what prevents the check from passing.",
                   "vars": {
                     "result_file": {
                       "artifact": {
@@ -197,7 +198,7 @@
                   "appendPrompt": {
                     "base": { "ref": "params.extraPrompt" },
                     "suffix": {
-                      "template": "Последний результат run_go_tests.py сохранён в {result_file}. exitCode={exit_code}, summary={summary}.\nПолный raw-вывод последнего запуска:\n{raw_output}\nИсправь только то, что мешает успешному прохождению проверки.",
+                      "template": "Latest run_go_tests.py result saved in {result_file}. exitCode={exit_code}, summary={summary}.\nFull raw output of the last run:\n{raw_output}\nFix only what prevents the check from passing.",
                       "vars": {
                         "result_file": {
                           "artifact": {

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

@@ -1,6 +1,7 @@
 {
   "kind": "implement-flow",
   "version": 1,
+  "description": "Runs LLM-backed implementation based on previously approved design, plan, and QA artifacts. Executes code changes locally in the project working directory.",
   "phases": [
     {
       "id": "implement",
@@ -34,6 +35,18 @@
                   "kind": "plan-json-file",
                   "taskKey": { "ref": "params.taskKey" }
                 }
+              },
+              "qa_file": {
+                "artifact": {
+                  "kind": "qa-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              },
+              "qa_json_file": {
+                "artifact": {
+                  "kind": "qa-json-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
               }
             },
             "extraPrompt": { "ref": "params.extraPrompt" },

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

@@ -0,0 +1,261 @@
+{
+  "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",
+          "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" },
+              "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" },
+              "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.revisedPlanFile" },
+                { "ref": "params.revisedQaFile" }
+              ]
+            }
+          },
+          "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" }
+          }
+        }
+      ]
+    }
+  ]
+}