agentweaver 0.1.11 → 0.1.13

package/dist/jira.js

@@ -91,6 +91,26 @@ async function fetchAuthorizedBuffer(url, accept) {
     }
     return Buffer.from(await response.arrayBuffer());
 }
+function isSubtask(issue) {
+    return issue.fields?.issuetype?.subtask === true;
+}
+function getParentKey(issue) {
+    if (!issue.fields?.parent?.key) {
+        return null;
+    }
+    return issue.fields.parent.key;
+}
+function normalizeIssue(jiraRaw) {
+    const issue = jiraRaw;
+    const key = issue.key ?? null;
+    const summary = typeof issue.fields?.summary === "string" ? issue.fields.summary : "";
+    const description = typeof issue.fields?.description === "string" ? issue.fields.description : "";
+    const type = typeof issue.fields?.issuetype?.name === "string" ? issue.fields.issuetype.name : "";
+    if (!key) {
+        return null;
+    }
+    return { key, type, summary, description };
+}
 function toTextAttachmentContent(fileName, body) {
     return [
         `=== Attachment: ${fileName} ===`,
@@ -132,6 +152,42 @@ export async function fetchJiraIssue(jiraApiUrl, jiraTaskFile, attachmentsManife
     const body = await fetchAuthorizedBuffer(jiraApiUrl, "application/json");
     mkdirSync(path.dirname(jiraTaskFile), { recursive: true });
     await writeFile(jiraTaskFile, body);
+    let enrichedFile;
+    try {
+        const rawIssue = JSON.parse(body.toString("utf8"));
+        const normalizedChild = normalizeIssue(rawIssue);
+        if (normalizedChild && isSubtask(rawIssue)) {
+            const parentKey = getParentKey(rawIssue);
+            let parentNormalized = null;
+            if (parentKey) {
+                try {
+                    const parentUrl = buildJiraApiUrl(parentKey);
+                    const parentBody = await fetchAuthorizedBuffer(parentUrl, "application/json");
+                    const parentRaw = JSON.parse(parentBody.toString("utf8"));
+                    parentNormalized = normalizeIssue(parentRaw);
+                }
+                catch {
+                    parentNormalized = null;
+                }
+            }
+            if (normalizedChild) {
+                const enrichedArtifact = {
+                    issue: normalizedChild,
+                    parent: parentNormalized,
+                    context: {
+                        scopeSource: normalizedChild.key,
+                        businessContextSource: parentNormalized?.key ?? normalizedChild.key,
+                    },
+                };
+                const parsedPath = path.parse(jiraTaskFile);
+                enrichedFile = path.join(parsedPath.dir, `${parsedPath.name}-enriched${parsedPath.ext}`);
+                await writeFile(enrichedFile, `${JSON.stringify(enrichedArtifact, null, 2)}\n`, "utf8");
+            }
+        }
+    }
+    catch {
+        // Non-JSON response or parse error - skip enrichment
+    }
     const attachments = parseJiraAttachments(body);
     const manifestItems = [];
     const planningContextChunks = [];
@@ -198,6 +254,7 @@ export async function fetchJiraIssue(jiraApiUrl, jiraTaskFile, attachmentsManife
         planningContextAttachments: manifest.summary.planningContextCount,
         ...(attachmentsManifestFile ? { attachmentsManifestFile } : {}),
         ...(attachmentsContextFile ? { attachmentsContextFile } : {}),
+        ...(enrichedFile ? { enrichedFile } : {}),
     };
 }
 export function requireJiraTaskFile(jiraTaskFile) {

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

@@ -100,34 +100,72 @@
           ]
         },
         {
-          "id": "materialize_review_artifacts",
-          "node": "gitlab-review-artifacts",
-          "params": {
-            "gitlabReviewJsonFile": {
-              "artifact": {
-                "kind": "gitlab-review-json-file",
-                "taskKey": { "ref": "params.taskKey" },
-                "iteration": { "ref": "params.gitlabReviewIteration" }
+          "id": "assess_gitlab_review",
+          "when": { "not": { "ref": "context.dryRun" } },
+          "node": "llm-prompt",
+          "prompt": {
+            "templateRef": "gitlab-review",
+            "vars": {
+              "gitlab_review_file": {
+                "artifact": {
+                  "kind": "gitlab-review-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.gitlabReviewIteration" }
+                }
+              },
+              "gitlab_review_json_file": {
+                "artifact": {
+                  "kind": "gitlab-review-json-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.gitlabReviewIteration" }
+                }
+              },
+              "review_file": {
+                "artifact": {
+                  "kind": "review-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              },
+              "review_json_file": {
+                "artifact": {
+                  "kind": "review-json-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              },
+              "review_assessment_file": {
+                "artifact": {
+                  "kind": "review-assessment-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
+              },
+              "review_assessment_json_file": {
+                "artifact": {
+                  "kind": "review-assessment-json-file",
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.iteration" }
+                }
               }
             },
-            "reviewFile": {
-              "artifact": {
-                "kind": "review-file",
-                "taskKey": { "ref": "params.taskKey" },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "format": "task-prompt"
+          },
+          "params": {
+            "labelText": {
+              "template": "Assessing GitLab findings and proposed fixes (iteration {iteration})",
+              "vars": {
                 "iteration": { "ref": "params.iteration" }
               }
             },
-            "reviewJsonFile": {
-              "artifact": {
-                "kind": "review-json-file",
-                "taskKey": { "ref": "params.taskKey" },
-                "iteration": { "ref": "params.iteration" }
-              }
-            }
+            "model": { "ref": "params.llmModel" },
+            "executor": { "ref": "params.llmExecutor" }
           },
           "expect": [
             {
               "kind": "require-artifacts",
+              "when": { "not": { "ref": "context.dryRun" } },
               "paths": {
                 "list": [
                   {
@@ -136,13 +174,21 @@
                       "taskKey": { "ref": "params.taskKey" },
                       "iteration": { "ref": "params.iteration" }
                     }
+                  },
+                  {
+                    "artifact": {
+                      "kind": "review-assessment-file",
+                      "taskKey": { "ref": "params.taskKey" },
+                      "iteration": { "ref": "params.iteration" }
+                    }
                   }
                 ]
               },
-              "message": "GitLab review materialization did not produce the required review artifact."
+              "message": "GitLab review assessment did not produce the required artifacts."
             },
             {
               "kind": "require-structured-artifacts",
+              "when": { "not": { "ref": "context.dryRun" } },
               "items": [
                 {
                   "path": {
@@ -153,11 +199,49 @@
                     }
                   },
                   "schemaId": "review-findings/v1"
+                },
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "review-assessment-json-file",
+                      "taskKey": { "ref": "params.taskKey" },
+                      "iteration": { "ref": "params.iteration" }
+                    }
+                  },
+                  "schemaId": "review-assessment/v1"
                 }
               ],
-              "message": "GitLab review materialization produced invalid structured review artifacts."
+              "message": "GitLab review assessment produced invalid structured artifacts."
             }
           ]
+        },
+        {
+          "id": "run_review_fix",
+          "when": { "not": { "ref": "context.dryRun" } },
+          "node": "flow-run",
+          "params": {
+            "fileName": { "const": "review-fix.json" },
+            "labelText": {
+              "template": "Running review-fix for GitLab review (iteration {iteration})",
+              "vars": {
+                "iteration": { "ref": "params.iteration" }
+              }
+            },
+            "taskKey": { "ref": "params.taskKey" },
+            "latestIteration": { "ref": "params.iteration" },
+            "reviewAssessmentJsonFile": {
+              "artifact": {
+                "kind": "review-assessment-json-file",
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": { "ref": "params.iteration" }
+              }
+            },
+            "reviewFixSelectionJsonFile": { "ref": "params.reviewFixSelectionJsonFile" },
+            "reviewFixPoints": { "ref": "params.reviewFixPoints" },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "llmModel": { "ref": "params.llmModel" },
+            "llmExecutor": { "ref": "params.llmExecutor" }
+          }
         }
       ]
     }

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

@@ -19,6 +19,7 @@
                 "iteration": { "ref": "params.latestIteration" }
               }
             },
+            "reviewAssessmentJsonFile": { "ref": "params.reviewAssessmentJsonFile" },
             "formId": { "const": "review-fix-selection" },
             "title": { "const": "Review-Fix Selection" },
             "description": {

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

@@ -98,6 +98,7 @@
             },
             "taskKey": { "ref": "params.taskKey" },
             "latestIteration": { "const": 1 },
+            "reviewAssessmentJsonFile": { "const": null },
             "reviewFixSelectionJsonFile": {
               "template": "{workspace}/review-fix-selection-{taskKey}-iter-{iteration}.json",
               "vars": {
@@ -234,6 +235,7 @@
                 },
                 "taskKey": { "ref": "params.taskKey" },
                 "latestIteration": { "ref": "repeat.iteration" },
+                "reviewAssessmentJsonFile": { "const": null },
                 "reviewFixSelectionJsonFile": {
                   "template": "{workspace}/review-fix-selection-{taskKey}-iter-{iteration}.json",
                   "vars": {

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

@@ -26,6 +26,18 @@
                     "required": false
                   }
                 },
+                {
+                  "const": {
+                    "id": "additional_instructions",
+                    "type": "text",
+                    "label": "Additional instructions",
+                    "help": "Необязательные указания для генерации описания. Например: ссылка на другой локальный репозиторий, связанный проект, ограничения или полезный контекст.",
+                    "required": false,
+                    "multiline": true,
+                    "rows": 4,
+                    "placeholder": "Например: смотри также ../billing-service, описание API есть в docs/task-templates.md"
+                  }
+                },
                 {
                   "const": {
                     "id": "task_description",
@@ -90,6 +102,18 @@
                 "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": [
@@ -102,6 +126,26 @@
                 }
               },
               "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."
             }
           ]
         },
@@ -112,7 +156,7 @@
             "ref": "steps.task_describe.collect_task_source.value.values.jira_ref"
           },
           "prompt": {
-            "inlineTemplate": "Review the task in {jira_task_file}. Formulate a typical Jira task description in simple product language, without overloading with technical details. Description structure: Problem, Context, What needs to be done, Acceptance criteria. Write only what helps understand the essence of the task and expected result; technical details, internal service names, data models, file names, REST methods, and implementation steps should only be mentioned if without them the task's meaning is lost. The source-of-truth JSON must be in English for all generated semantic string values. First write the source-of-truth JSON to {jira_description_json_file} as object { summary: string }, then the markdown version to {jira_description_file}.",
+            "templateRef": "task-describe",
             "vars": {
               "jira_task_file": {
                 "artifact": {
@@ -120,6 +164,18 @@
                   "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" }
+                }
+              },
               "jira_description_file": {
                 "artifact": {
                   "kind": "jira-description-file",
@@ -135,7 +191,12 @@
                 }
               }
             },
-            "extraPrompt": { "ref": "params.extraPrompt" },
+            "extraPrompt": {
+              "appendPrompt": {
+                "base": { "ref": "params.extraPrompt" },
+                "suffix": { "ref": "steps.task_describe.collect_task_source.value.promptSuffix" }
+              }
+            },
             "format": "task-prompt"
           },
           "params": {
@@ -202,7 +263,7 @@
             }
           },
           "prompt": {
-            "inlineTemplate": "Review the user-provided task description in {task_input_file}. Use the values.task_description field as source of truth. Formulate a typical Jira task description in simple product language, without overloading with technical details. Description structure: Problem, Context, What needs to be done, Acceptance criteria. If the user description lacks details, do not invent them and keep formulations general enough. The source-of-truth JSON must be in English for all generated semantic string values, while verbatim user-provided source text may be preserved as needed. First write the source-of-truth JSON to {jira_description_json_file} as object { summary: string }, then the markdown version to {jira_description_file}.",
+            "inlineTemplate": "Review the user-provided task description in {task_input_file}. Use the values.task_description field as source of truth. Study the repository code relevant to the task before writing the description, and use that analysis to add concise context about the current behavior, existing routes/modules, contracts, DTOs, or missing pieces directly related to the request. The result must be richer than a paraphrase of the input, but do not invent requirements that are not supported by the user text or the code. Formulate a typical Jira task description in simple product language, without overloading with technical details. Description structure: Problem, Context, What needs to be done, Acceptance criteria. Add concrete implementation context when it is supported by the code: mention where changes are likely needed, including specific routes, handlers, services, DTOs, API contracts, validation rules, repository methods, events, or UI screens. If the user description lacks details, do not invent them and keep formulations general enough. The source-of-truth JSON must be in English for all generated semantic string values, while verbatim user-provided source text may be preserved as needed. First write the source-of-truth JSON to {jira_description_json_file} as object { summary: string }, then the markdown version to {jira_description_file}.",
             "vars": {
               "task_input_file": {
                 "artifact": {

package/dist/pipeline/nodes/jira-fetch-node.js

@@ -17,6 +17,9 @@ export const jiraFetchNode = {
         if (params.attachmentsContextFile) {
             outputs.push({ kind: "artifact", path: params.attachmentsContextFile, required: true });
         }
+        if (value.enrichedFile) {
+            outputs.push({ kind: "artifact", path: value.enrichedFile, required: false });
+        }
         return {
             value,
             outputs,

package/dist/pipeline/nodes/review-findings-form-node.js

@@ -1,6 +1,5 @@
 import { readFileSync } from "node:fs";
 import { TaskRunnerError } from "../../errors.js";
-const SEVERITY_FIX_THRESHOLD = ["blocker", "critical", "major"];
 export const reviewFindingsFormNode = {
     kind: "review-findings-form",
     version: 1,
@@ -13,6 +12,27 @@ export const reviewFindingsFormNode = {
             throw new TaskRunnerError(`Failed to read review findings from ${params.reviewFindingsJsonFile}: ${error.message}`);
         }
         const reviewFindings = parsed;
+        let reviewAssessment = null;
+        if (typeof params.reviewAssessmentJsonFile === "string" && params.reviewAssessmentJsonFile.trim().length > 0) {
+            try {
+                reviewAssessment = JSON.parse(readFileSync(params.reviewAssessmentJsonFile, "utf8"));
+            }
+            catch (error) {
+                throw new TaskRunnerError(`Failed to read review assessment from ${params.reviewAssessmentJsonFile}: ${error.message}`);
+            }
+        }
+        const assessmentByTitle = new Map();
+        for (const record of reviewAssessment?.assessments ?? []) {
+            const findingTitle = typeof record.finding_title === "string" ? record.finding_title.trim() : "";
+            const verdict = typeof record.verdict === "string" ? record.verdict.trim() : "";
+            const rationale = typeof record.rationale === "string" ? record.rationale.trim() : "";
+            const proposedFix = typeof record.proposed_fix === "string" ? record.proposed_fix.trim() : "";
+            const fixRequired = typeof record.fix_required === "boolean" ? record.fix_required : null;
+            if (findingTitle.length === 0 || assessmentByTitle.has(findingTitle)) {
+                continue;
+            }
+            assessmentByTitle.set(findingTitle, { verdict, rationale, proposedFix, fixRequired });
+        }
         const findings = Array.isArray(reviewFindings.findings) ? reviewFindings.findings : [];
         const selectableFindings = findings
             .map((finding) => ({
@@ -20,9 +40,9 @@ export const reviewFindingsFormNode = {
             title: typeof finding.title === "string" ? finding.title.trim() : "",
             description: typeof finding.description === "string" ? finding.description.trim() : "",
             disposition: typeof finding.disposition === "string" ? finding.disposition.trim().toLowerCase() : null,
+            assessment: assessmentByTitle.get(typeof finding.title === "string" ? finding.title.trim() : "") ?? null,
         }))
             .filter((finding) => finding.title.length > 0 &&
-            SEVERITY_FIX_THRESHOLD.includes(finding.severity) &&
             finding.disposition !== "resolved");
         const fields = [
             {
@@ -42,7 +62,17 @@ export const reviewFindingsFormNode = {
                 options: selectableFindings.map((finding) => ({
                     value: finding.title,
                     label: `${finding.title} | ${finding.severity || "-"}`,
-                    ...(finding.description ? { description: finding.description } : {}),
+                    description: [
+                        finding.description,
+                        finding.assessment?.verdict ? `Verdict: ${finding.assessment.verdict}` : "",
+                        finding.assessment?.rationale ? `Rationale: ${finding.assessment.rationale}` : "",
+                        finding.assessment?.proposedFix ? `Proposed fix: ${finding.assessment.proposedFix}` : "",
+                        typeof finding.assessment?.fixRequired === "boolean"
+                            ? `Fix required: ${finding.assessment.fixRequired ? "yes" : "no"}`
+                            : "",
+                    ]
+                        .filter((item) => item.trim().length > 0)
+                        .join("\n\n"),
                 })),
                 default: [],
             });

package/dist/pipeline/nodes/user-input-node.js

@@ -35,10 +35,19 @@ function buildReviewFixPromptSuffix(params, values) {
 function buildTaskDescribePromptSuffix(params, values) {
     const jiraRef = typeof values.jira_ref === "string" ? values.jira_ref.trim() : "";
     const taskDescription = typeof values.task_description === "string" ? values.task_description.trim() : "";
+    const additionalInstructions = typeof values.additional_instructions === "string" ? values.additional_instructions.trim() : "";
     if (jiraRef) {
         return {
-            promptSuffix: "",
-            summaryText: `Источник задачи: Jira\nJira: ${jiraRef}`,
+            promptSuffix: additionalInstructions
+                ? [
+                    "Use the user-provided additional instructions together with the Jira task.",
+                    `User input file: ${params.outputFile}`,
+                    `Additional instructions:\n${additionalInstructions}`,
+                ].join("\n\n")
+                : "",
+            summaryText: additionalInstructions
+                ? `Источник задачи: Jira\nJira: ${jiraRef}\n\nДополнительные указания:\n${additionalInstructions}`
+                : `Источник задачи: Jira\nJira: ${jiraRef}`,
         };
     }
     return {
@@ -46,8 +55,13 @@ function buildTaskDescribePromptSuffix(params, values) {
             "Use the user task description as source of truth.",
             `User input file: ${params.outputFile}`,
             `Task description:\n${taskDescription}`,
-        ].join("\n\n"),
-        summaryText: `Task source: user-input\n\n${taskDescription}`,
+            additionalInstructions ? `Additional instructions:\n${additionalInstructions}` : "",
+        ]
+            .filter((item) => item.trim().length > 0)
+            .join("\n\n"),
+        summaryText: additionalInstructions
+            ? `Task source: user-input\n\n${taskDescription}\n\nAdditional instructions:\n${additionalInstructions}`
+            : `Task source: user-input\n\n${taskDescription}`,
     };
 }
 function buildPromptSuffix(params, values) {

package/dist/pipeline/prompt-registry.js

@@ -1,9 +1,10 @@
-import { BUG_ANALYZE_PROMPT_TEMPLATE, COMMIT_MESSAGE_PROMPT_TEMPLATE, GITLAB_DIFF_REVIEW_PROMPT_TEMPLATE, BUG_FIX_PROMPT_TEMPLATE, IMPLEMENT_PROMPT_TEMPLATE, JIRA_DESCRIPTION_PROMPT_TEMPLATE, MR_DESCRIPTION_PROMPT_TEMPLATE, PLAN_QUESTIONS_PROMPT_TEMPLATE, PLAN_PROMPT_TEMPLATE, REVIEW_FIX_PROMPT_TEMPLATE, REVIEW_PROJECT_PROMPT_TEMPLATE, REVIEW_PROMPT_TEMPLATE, REVIEW_SUMMARY_PROMPT_TEMPLATE, RUN_GO_LINTER_LOOP_FIX_PROMPT_TEMPLATE, RUN_GO_TESTS_LOOP_FIX_PROMPT_TEMPLATE, TASK_SUMMARY_PROMPT_TEMPLATE, } from "../prompts.js";
+import { BUG_ANALYZE_PROMPT_TEMPLATE, COMMIT_MESSAGE_PROMPT_TEMPLATE, GITLAB_DIFF_REVIEW_PROMPT_TEMPLATE, GITLAB_REVIEW_PROMPT_TEMPLATE, BUG_FIX_PROMPT_TEMPLATE, IMPLEMENT_PROMPT_TEMPLATE, JIRA_DESCRIPTION_PROMPT_TEMPLATE, MR_DESCRIPTION_PROMPT_TEMPLATE, PLAN_QUESTIONS_PROMPT_TEMPLATE, PLAN_PROMPT_TEMPLATE, REVIEW_FIX_PROMPT_TEMPLATE, REVIEW_PROJECT_PROMPT_TEMPLATE, REVIEW_PROMPT_TEMPLATE, REVIEW_SUMMARY_PROMPT_TEMPLATE, RUN_GO_LINTER_LOOP_FIX_PROMPT_TEMPLATE, RUN_GO_TESTS_LOOP_FIX_PROMPT_TEMPLATE, TASK_SUMMARY_PROMPT_TEMPLATE, } from "../prompts.js";
 const promptTemplates = {
     "bug-analyze": BUG_ANALYZE_PROMPT_TEMPLATE,
     "bug-fix": BUG_FIX_PROMPT_TEMPLATE,
     "commit-message": COMMIT_MESSAGE_PROMPT_TEMPLATE,
     "gitlab-diff-review": GITLAB_DIFF_REVIEW_PROMPT_TEMPLATE,
+    "gitlab-review": GITLAB_REVIEW_PROMPT_TEMPLATE,
     implement: IMPLEMENT_PROMPT_TEMPLATE,
     "task-describe": JIRA_DESCRIPTION_PROMPT_TEMPLATE,
     "mr-description": MR_DESCRIPTION_PROMPT_TEMPLATE,

package/dist/pipeline/spec-types.js

@@ -29,6 +29,8 @@ export const ARTIFACT_REF_KINDS = [
     "ready-to-merge-file",
     "review-file",
     "review-json-file",
+    "review-assessment-file",
+    "review-assessment-json-file",
     "review-fix-file",
     "review-fix-json-file",
     "run-go-linter-result-json-file",

package/dist/pipeline/value-resolver.js

@@ -1,5 +1,5 @@
 import { existsSync } from "node:fs";
-import { artifactFile, bugAnalyzeArtifacts, bugAnalyzeFile, bugAnalyzeJsonFile, bugFixDesignFile, bugFixDesignJsonFile, bugFixPlanFile, bugFixPlanJsonFile, designFile, designJsonFile, gitlabDiffFile, gitlabDiffJsonFile, gitlabDiffReviewInputJsonFile, gitlabReviewFile, gitlabReviewInputJsonFile, gitlabReviewJsonFile, jiraAttachmentsContextFile, jiraAttachmentsManifestFile, jiraDescriptionFile, jiraDescriptionJsonFile, jiraTaskFile, mrDescriptionFile, mrDescriptionJsonFile, planningAnswersJsonFile, planningQuestionsJsonFile, planArtifacts, planFile, planJsonFile, qaFile, qaJsonFile, readyToMergeFile, reviewFile, reviewFixFile, reviewFixJsonFile, reviewJsonFile, runGoLinterResultJsonFile, runGoTestsResultJsonFile, taskSummaryFile, taskDescribeInputJsonFile, taskSummaryJsonFile, gitStatusJsonFile, gitCommitMessageJsonFile, gitCommitInputJsonFile, selectFilesOutputJsonFile, commitMessageOutputJsonFile, gitDiffFile as gitDiffFileHelper, } from "../artifacts.js";
+import { artifactFile, bugAnalyzeArtifacts, bugAnalyzeFile, bugAnalyzeJsonFile, bugFixDesignFile, bugFixDesignJsonFile, bugFixPlanFile, bugFixPlanJsonFile, designFile, designJsonFile, gitlabDiffFile, gitlabDiffJsonFile, gitlabDiffReviewInputJsonFile, gitlabReviewFile, gitlabReviewInputJsonFile, gitlabReviewJsonFile, jiraAttachmentsContextFile, jiraAttachmentsManifestFile, jiraDescriptionFile, jiraDescriptionJsonFile, jiraTaskFile, mrDescriptionFile, mrDescriptionJsonFile, planningAnswersJsonFile, planningQuestionsJsonFile, planArtifacts, planFile, planJsonFile, qaFile, qaJsonFile, readyToMergeFile, reviewAssessmentFile, reviewAssessmentJsonFile, reviewFile, reviewFixFile, reviewFixJsonFile, reviewJsonFile, runGoLinterResultJsonFile, runGoTestsResultJsonFile, taskSummaryFile, taskDescribeInputJsonFile, taskSummaryJsonFile, gitStatusJsonFile, gitCommitMessageJsonFile, gitCommitInputJsonFile, selectFilesOutputJsonFile, commitMessageOutputJsonFile, gitDiffFile as gitDiffFileHelper, } from "../artifacts.js";
 import { TaskRunnerError } from "../errors.js";
 import { formatTemplate } from "../prompts.js";
 function readStepRef(segments, context, originalPath) {
@@ -138,6 +138,16 @@ function resolveArtifact(spec, context) {
                 throw new TaskRunnerError("review-json-file requires iteration");
             }
             return reviewJsonFile(taskKey, iteration);
+        case "review-assessment-file":
+            if (iteration === undefined) {
+                throw new TaskRunnerError("review-assessment-file requires iteration");
+            }
+            return reviewAssessmentFile(taskKey, iteration);
+        case "review-assessment-json-file":
+            if (iteration === undefined) {
+                throw new TaskRunnerError("review-assessment-json-file requires iteration");
+            }
+            return reviewAssessmentJsonFile(taskKey, iteration);
         case "review-fix-file":
             if (iteration === undefined) {
                 throw new TaskRunnerError("review-fix-file requires iteration");

package/dist/prompts.js

@@ -70,6 +70,15 @@ export const GITLAB_DIFF_REVIEW_PROMPT_TEMPLATE = "Conduct a code review of the
     `First write the structured result to {review_json_file}. ${strictSchemaInstruction("{review_json_file}", "review-findings/v1")}` +
     "Then write the derivative markdown version to {review_file}. " +
     "If ready_to_merge=true and there are no blockers, create the {ready_to_merge_file} file.";
+export const GITLAB_REVIEW_PROMPT_TEMPLATE = "Validate GitLab merge request review comments. " +
+    "Use the structured GitLab review artifact {gitlab_review_json_file} as source of truth, and markdown {gitlab_review_file} only as a convenient human-readable representation. " +
+    "Determine which comments are valid actionable findings that should be addressed in the current code. " +
+    "Ignore comments that are obsolete, already resolved, duplicates, purely conversational, or not actionable. " +
+    "Normalize the remaining actionable findings into the review findings schema with accurate severities, concise titles, and concrete descriptions. " +
+    "For each remaining finding, assess whether the complaint is fair in the current code and propose a concrete fix. " +
+    `First write the structured result to {review_json_file}. ${strictSchemaInstruction("{review_json_file}", "review-findings/v1")}` +
+    `Then write the structured assessment result to {review_assessment_json_file}. ${strictSchemaInstruction("{review_assessment_json_file}", "review-assessment/v1")}` +
+    "Then write the derivative markdown version to {review_file} and the derivative markdown assessment to {review_assessment_file}.";
 export const REVIEW_SUMMARY_PROMPT_TEMPLATE = "Look at {review_file}. " +
     "Create a brief list of comments without details, 3-7 items. " +
     "Write the result to {review_summary_file}.";
@@ -82,10 +91,16 @@ export const REVIEW_FIX_PROMPT_TEMPLATE = "Use only structured artifacts as sour
 export const TASK_SUMMARY_PROMPT_TEMPLATE = "Look at {jira_task_file}. " +
     "Create a brief summary of the task, 1-2 paragraphs. " +
     `First write the source-of-truth JSON to {task_summary_json_file}. ${strictSchemaInstruction("{task_summary_json_file}", "task-summary/v1")}Then write the markdown version to {task_summary_file}.`;
-export const JIRA_DESCRIPTION_PROMPT_TEMPLATE = "Look at the task in {jira_task_file}. " +
+export const JIRA_DESCRIPTION_PROMPT_TEMPLATE = "Review the task in {jira_task_file}. " +
+    "Be sure to use the original issue description and all useful issue comments from the Jira payload as source material; if comments clarify scope, expected behavior, edge cases, or acceptance criteria, reflect that context in the result. " +
+    "Analyze additional materials from Jira attachments manifest {jira_attachments_manifest_file} and text context {jira_attachments_context_file}; if attachments contain more detailed requirements or constraints, treat them as source of truth alongside the Jira issue. " +
+    "Study the repository code relevant to the task before writing the description. Verify whether the mentioned APIs, routes, handlers, modules, entities, or screens already exist and how they currently behave. For example, if the task mentions a route such as GET v1/task-templates, inspect the code that implements or should implement that route and use that understanding to add concise but useful context. " +
+    "The result must be richer than a paraphrase of the title: include context from the task description, comments, attachments, and relevant code, but do not invent requirements that are not supported by those sources. " +
     "Formulate a typical Jira task description in simple product language, without overloading with technical details. " +
     "Description structure: Problem, Context, What needs to be done, Acceptance criteria. " +
-    "Write only what helps understand the essence of the task and expected result; technical details, internal service names, data models, file names, REST methods, and implementation steps should only be mentioned if without them the task's meaning is lost. " +
+    "Add concrete implementation context when it is supported by the task and the code: mention where changes are likely needed, including specific routes, handlers, services, DTOs, API contracts, validation rules, repository methods, events, or UI screens. " +
+    "If the code already defines a relevant request/response contract or DTO, reflect that in the description at a high level so the task is actionable. " +
+    "Write only what helps understand the essence of the task and expected result; technical details, internal service names, data models, file names, REST methods, DTO names, contracts, and implementation steps should be mentioned when they add necessary context or make the task materially clearer. " +
     `First write the source-of-truth JSON to {jira_description_json_file}. ${strictSchemaInstruction("{jira_description_json_file}", "jira-description/v1")}Then write the markdown version to {jira_description_file}.`;
 export const RUN_GO_TESTS_LOOP_FIX_PROMPT_TEMPLATE = "Use the structured result of the last run of run_go_tests.py from {tests_result_json_file} as source of truth. " +
     "Analyze the last test error, fix the code, and prepare changes so that the next run of run_go_tests.py succeeds.";

package/dist/runtime/process-runner.js

@@ -35,7 +35,7 @@ function formatLaunchDetails(statusLabel) {
     return lines.join("\n");
 }
 export async function runCommand(argv, options = {}) {
-    const { env, dryRun = false, verbose = false, label, printFailureOutput = true, signal } = options;
+    const { env, dryRun = false, verbose = false, label, printFailureOutput = true, stdin, signal } = options;
     const outputAdapter = getOutputAdapter();
     if (signal?.aborted) {
         throw new FlowInterruptedError();
@@ -49,9 +49,12 @@ export async function runCommand(argv, options = {}) {
     if (verbose && outputAdapter.supportsPassthrough) {
         await new Promise((resolve, reject) => {
             const child = spawn(argv[0] ?? "", argv.slice(1), {
-                stdio: "inherit",
+                stdio: [stdin !== undefined ? "pipe" : "inherit", "inherit", "inherit"],
                 env,
             });
+            if (stdin !== undefined) {
+                child.stdin?.end(stdin);
+            }
             let abortTimer = null;
             const abortHandler = () => {
                 child.kill("SIGTERM");
@@ -88,9 +91,12 @@ export async function runCommand(argv, options = {}) {
     let output = "";
     const child = spawn(argv[0] ?? "", argv.slice(1), {
         env,
-        stdio: ["ignore", "pipe", "pipe"],
+        stdio: [stdin !== undefined ? "pipe" : "ignore", "pipe", "pipe"],
     });
     setCurrentExecutor(statusLabel);
+    if (stdin !== undefined) {
+        child.stdin?.end(stdin);
+    }
     child.stdout?.on("data", (chunk) => {
         const text = String(chunk);
         output += text;

package/dist/structured-artifact-schema-registry.js

@@ -14,6 +14,7 @@ export const STRUCTURED_ARTIFACT_SCHEMA_IDS = [
     "mr-description/v1",
     "planning-questions/v1",
     "qa-plan/v1",
+    "review-assessment/v1",
     "review-findings/v1",
     "review-fix-report/v1",
     "task-summary/v1",