agentweaver 0.1.14 → 0.1.15

package/dist/index.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
-import { REVIEW_FILE_RE, bugAnalyzeArtifacts, bugAnalyzeJsonFile, bugFixDesignJsonFile, bugFixPlanJsonFile, designJsonFile, gitlabDiffFile, gitlabDiffJsonFile, ensureScopeWorkspaceDir, gitlabReviewFile, gitlabReviewJsonFile, latestArtifactIteration, nextArtifactIteration, planJsonFile, planArtifacts, qaJsonFile, readyToMergeFile, requireArtifacts, reviewAssessmentFile, reviewAssessmentJsonFile, reviewFile, reviewFixSelectionJsonFile, reviewJsonFile, scopeWorkspaceDir, flowStateFile, taskSummaryFile, } from "./artifacts.js";
+import { bugAnalyzeArtifacts, bugAnalyzeJsonFile, bugFixDesignJsonFile, bugFixPlanJsonFile, designReviewFile, designReviewJsonFile, designJsonFile, gitlabDiffFile, gitlabDiffJsonFile, ensureScopeWorkspaceDir, gitlabReviewFile, gitlabReviewJsonFile, latestArtifactIteration, nextArtifactIteration, planJsonFile, planArtifacts, qaJsonFile, readyToMergeFile, requireArtifacts, reviewAssessmentFile, reviewAssessmentJsonFile, reviewFile, reviewFixSelectionJsonFile, reviewJsonFile, scopeWorkspaceDir, flowStateFile, taskSummaryFile, } from "./artifacts.js";
 import { FlowInterruptedError, TaskRunnerError } from "./errors.js";
 import { createFlowRunState, hasResumableFlowState, loadFlowRunState, prepareFlowStateForResume, resetFlowRunState, rewindFlowRunStateToPhase, saveFlowRunState, stripExecutionStatePayload, } from "./flow-state.js";
 import { requireJiraTaskFile } from "./jira.js";
@@ -20,11 +20,14 @@ import { resolveCmd } from "./runtime/command-resolution.js";
 import { loadTieredEnv } from "./runtime/env-loader.js";
 import { agentweaverHome } from "./runtime/agentweaver-home.js";
 import { runCommand } from "./runtime/process-runner.js";
+import { resolveDesignReviewInputContract } from "./runtime/design-review-input-contract.js";
+import { resolvePlanReviseInputContract } from "./runtime/plan-revise-input-contract.js";
+import { clearReadyToMergeFile } from "./runtime/ready-to-merge.js";
 import { InteractiveUi } from "./interactive-ui.js";
 import { bye, printError, printInfo, printPanel, printSummary, setFlowExecutionState, stripAnsi, } from "./tui.js";
 import { requestUserInputInTerminal } from "./user-input.js";
 import { runDoctorCommand } from "./doctor/index.js";
-import { attachJiraContext, detectGitBranchName, requestJiraContext, resolveProjectScope, } from "./scope.js";
+import { detectGitBranchName, requestJiraContext, resolveProjectScope, } from "./scope.js";
 const COMMANDS = [
     "auto-golang",
     "auto-common",
@@ -32,12 +35,14 @@ const COMMANDS = [
     "auto-reset",
     "bug-analyze",
     "bug-fix",
+    "design-review",
     "doctor",
     "git-commit",
     "gitlab-diff-review",
     "gitlab-review",
     "mr-description",
     "plan",
+    "plan-revise",
     "task-describe",
     "implement",
     "review",
@@ -99,9 +104,11 @@ function usage() {
   agentweaver gitlab-review [--dry] [--verbose] [--prompt <text>] [--scope <name>]
   agentweaver bug-analyze [--dry] [--verbose] [--prompt <text>] <jira-browse-url|jira-issue-key>
   agentweaver bug-fix [--dry] [--verbose] [--prompt <text>] <jira-browse-url|jira-issue-key>
+  agentweaver design-review [--dry] [--verbose] [--prompt <text>] <jira-browse-url|jira-issue-key>
   agentweaver doctor [<category>|<check-id>] [--json]
   agentweaver mr-description [--dry] [--verbose] [--prompt <text>] <jira-browse-url|jira-issue-key>
   agentweaver plan [--dry] [--verbose] [--prompt <text>] [--md-lang <en|ru>] [<jira-browse-url|jira-issue-key>]
+  agentweaver plan-revise [--dry] [--verbose] [--prompt <text>] <jira-browse-url|jira-issue-key>
   agentweaver task-describe [--dry] [--verbose] [--prompt <text>] [<jira-browse-url|jira-issue-key>]
   agentweaver implement [--dry] [--verbose] [--prompt <text>] [--scope <name>] [<jira-browse-url|jira-issue-key>]
   agentweaver review [--dry] [--verbose] [--prompt <text>] [--scope <name>] [<jira-browse-url|jira-issue-key>]
@@ -364,17 +371,19 @@ function scopeWithRestoredJiraContext(scope, state) {
     if (scope.jiraRef || !state?.jiraRef?.trim()) {
         return scope;
     }
-    return attachJiraContext(scope, state.jiraRef);
+    return resolveProjectScope(null, state.jiraRef);
+}
+function buildInteractiveBaseConfig(flowId, scope) {
+    return buildBaseConfig(flowId, {
+        ...(scope.jiraRef ? { jiraRef: scope.jiraRef } : {}),
+    });
 }
 function lookupInteractiveFlowResume(flowEntry, currentScope) {
     const directState = loadFlowRunState(currentScope.scopeKey, flowEntry.id);
     if (directState && hasResumableFlowState(directState)) {
         try {
             const effectiveScope = scopeWithRestoredJiraContext(currentScope, directState);
-            const baseConfig = buildBaseConfig(flowEntry.id, {
-                ...(effectiveScope.jiraRef ? { jiraRef: effectiveScope.jiraRef } : {}),
-                scopeName: effectiveScope.scopeKey,
-            });
+            const baseConfig = buildInteractiveBaseConfig(flowEntry.id, effectiveScope);
             const config = buildRuntimeConfig(baseConfig, effectiveScope);
             validateDeclarativeFlowResumeState(flowEntry, config, directState, directState.launchProfile);
             return {
@@ -410,21 +419,10 @@ function printAutoCommonPhasesHelp() {
     printPanel("Auto-Common Phases", phaseLines.join("\n"), "magenta");
 }
 function nextReviewIterationForTask(taskKey) {
-    let maxIndex = 0;
-    const workspaceDir = scopeWorkspaceDir(taskKey);
-    if (!existsSync(workspaceDir)) {
-        return 1;
-    }
-    for (const entry of readdirSync(workspaceDir, { withFileTypes: true })) {
-        if (!entry.isFile()) {
-            continue;
-        }
-        const match = REVIEW_FILE_RE.exec(entry.name);
-        if (match && match[1] === taskKey) {
-            maxIndex = Math.max(maxIndex, Number.parseInt(match[2] ?? "0", 10));
-        }
-    }
-    return maxIndex + 1;
+    return nextArtifactIteration(taskKey, "review");
+}
+function nextDesignReviewIterationForTask(taskKey) {
+    return nextArtifactIteration(taskKey, "design-review");
 }
 function buildBaseConfig(command, options = {}) {
     return {
@@ -442,8 +440,10 @@ function buildBaseConfig(command, options = {}) {
 }
 function commandRequiresTask(command) {
     return (command === "plan" ||
+        command === "plan-revise" ||
         command === "bug-analyze" ||
         command === "bug-fix" ||
+        command === "design-review" ||
         command === "mr-description" ||
         command === "auto-golang" ||
         command === "auto-common" ||
@@ -865,6 +865,90 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
         }, launchProfile ? { launchProfile } : {}, requestUserInput, setSummary, launchMode, runtime);
         return false;
     }
+    if (config.command === "design-review") {
+        const iteration = nextDesignReviewIterationForTask(config.taskKey);
+        const inputContract = resolveDesignReviewInputContract(config.taskKey);
+        if (!config.dryRun) {
+            clearReadyToMergeFile(config.taskKey);
+        }
+        await runDeclarativeFlowBySpecFile("design-review.json", config, {
+            taskKey: config.taskKey,
+            iteration,
+            planningIteration: inputContract.planningIteration,
+            designFile: inputContract.designFile,
+            designJsonFile: inputContract.designJsonFile,
+            planFile: inputContract.planFile,
+            planJsonFile: inputContract.planJsonFile,
+            hasQaArtifacts: inputContract.hasQaArtifacts,
+            qaFilePath: inputContract.qaFilePath,
+            qaJsonFilePath: inputContract.qaJsonFilePath,
+            qaFile: inputContract.qaFile,
+            qaJsonFile: inputContract.qaJsonFile,
+            hasJiraTaskFile: inputContract.hasJiraTaskFile,
+            jiraTaskFilePath: inputContract.jiraTaskFilePath,
+            jiraTaskFile: inputContract.jiraTaskFile,
+            hasJiraAttachmentsManifestFile: inputContract.hasJiraAttachmentsManifestFile,
+            jiraAttachmentsManifestFilePath: inputContract.jiraAttachmentsManifestFilePath,
+            jiraAttachmentsManifestFile: inputContract.jiraAttachmentsManifestFile,
+            hasJiraAttachmentsContextFile: inputContract.hasJiraAttachmentsContextFile,
+            jiraAttachmentsContextFilePath: inputContract.jiraAttachmentsContextFilePath,
+            jiraAttachmentsContextFile: inputContract.jiraAttachmentsContextFile,
+            hasPlanningAnswersJsonFile: inputContract.hasPlanningAnswersJsonFile,
+            planningAnswersJsonFilePath: inputContract.planningAnswersJsonFilePath,
+            planningAnswersJsonFile: inputContract.planningAnswersJsonFile,
+            extraPrompt: config.extraPrompt,
+        }, launchProfile ? { launchProfile } : {}, requestUserInput, undefined, launchMode, runtime);
+        if (!config.dryRun) {
+            printSummary("Design Review", `Artifacts:\n${designReviewFile(config.taskKey, iteration)}\n${designReviewJsonFile(config.taskKey, iteration)}`);
+        }
+        return false;
+    }
+    if (config.command === "plan-revise") {
+        const inputContract = resolvePlanReviseInputContract(config.taskKey);
+        if (!config.dryRun) {
+            clearReadyToMergeFile(config.taskKey);
+        }
+        await runDeclarativeFlowBySpecFile("plan-revise.json", config, {
+            taskKey: config.taskKey,
+            reviewIteration: inputContract.reviewIteration,
+            reviewFile: inputContract.reviewFile,
+            reviewJsonFile: inputContract.reviewJsonFile,
+            sourcePlanningIteration: inputContract.sourcePlanningIteration,
+            outputIteration: inputContract.outputIteration,
+            designFile: inputContract.designFile,
+            designJsonFile: inputContract.designJsonFile,
+            planFile: inputContract.planFile,
+            planJsonFile: inputContract.planJsonFile,
+            hasQaArtifacts: inputContract.hasQaArtifacts,
+            qaFilePath: inputContract.qaFilePath,
+            qaJsonFilePath: inputContract.qaJsonFilePath,
+            qaFile: inputContract.qaFile,
+            qaJsonFile: inputContract.qaJsonFile,
+            revisedDesignFile: inputContract.revisedDesignFile,
+            revisedDesignJsonFile: inputContract.revisedDesignJsonFile,
+            revisedPlanFile: inputContract.revisedPlanFile,
+            revisedPlanJsonFile: inputContract.revisedPlanJsonFile,
+            revisedQaFile: inputContract.revisedQaFile,
+            revisedQaJsonFile: inputContract.revisedQaJsonFile,
+            hasJiraTaskFile: inputContract.hasJiraTaskFile,
+            jiraTaskFilePath: inputContract.jiraTaskFilePath,
+            jiraTaskFile: inputContract.jiraTaskFile,
+            hasJiraAttachmentsManifestFile: inputContract.hasJiraAttachmentsManifestFile,
+            jiraAttachmentsManifestFilePath: inputContract.jiraAttachmentsManifestFilePath,
+            jiraAttachmentsManifestFile: inputContract.jiraAttachmentsManifestFile,
+            hasJiraAttachmentsContextFile: inputContract.hasJiraAttachmentsContextFile,
+            jiraAttachmentsContextFilePath: inputContract.jiraAttachmentsContextFilePath,
+            jiraAttachmentsContextFile: inputContract.jiraAttachmentsContextFile,
+            hasPlanningAnswersJsonFile: inputContract.hasPlanningAnswersJsonFile,
+            planningAnswersJsonFilePath: inputContract.planningAnswersJsonFilePath,
+            planningAnswersJsonFile: inputContract.planningAnswersJsonFile,
+            extraPrompt: config.extraPrompt,
+        }, launchProfile ? { launchProfile } : {}, requestUserInput, undefined, launchMode, runtime);
+        if (!config.dryRun) {
+            printSummary("Plan Revise", `Artifacts:\n${inputContract.revisedDesignFile}\n${inputContract.revisedDesignJsonFile}\n${inputContract.revisedPlanFile}\n${inputContract.revisedPlanJsonFile}\n${inputContract.revisedQaFile}\n${inputContract.revisedQaJsonFile}`);
+        }
+        return false;
+    }
     if (config.command === "gitlab-review") {
         const iteration = nextReviewIterationForTask(config.taskKey);
         const gitlabReviewIteration = nextArtifactIteration(config.taskKey, "gitlab-review");
@@ -1182,17 +1266,14 @@ async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
                     throw new TaskRunnerError("Resume is impossible because launch profile was not saved. Use restart.");
                 }
                 const previousScopeKey = currentScope.scopeKey;
-                const baseConfig = buildBaseConfig(flowId, {
-                    ...(currentScope.jiraRef ? { jiraRef: currentScope.jiraRef } : {}),
-                    scopeName: currentScope.scopeKey,
-                });
+                const baseConfig = buildInteractiveBaseConfig(flowId, currentScope);
                 if (flowEntry.source === "built-in" && isBuiltInCommandFlowId(flowId)) {
                     const nextScope = await resolveScopeForCommand(baseConfig, (form) => ui.requestUserInput(form));
                     currentScope = nextScope;
                 }
                 else if (flowRequiresTaskScope(flowEntry) && !currentScope.jiraRef) {
                     const jiraContext = await requestJiraContext((form) => ui.requestUserInput(form));
-                    currentScope = attachJiraContext(currentScope, jiraContext.jiraRef);
+                    currentScope = resolveProjectScope(null, jiraContext.jiraRef);
                 }
                 ui.setScope(currentScope.scopeKey, currentScope.jiraIssueKey ?? null);
                 if (previousScopeKey !== currentScope.scopeKey || currentScope.jiraIssueKey) {
@@ -1283,7 +1364,10 @@ export async function main(argv = process.argv.slice(2)) {
             return await runInteractive(args[0] ?? "", forceRefresh);
         }
         const parsedArgs = parseCliArgs(args);
-        await executeCommand(buildConfigFromArgs(parsedArgs));
+        const commandCompleted = await executeCommand(buildConfigFromArgs(parsedArgs));
+        if (parsedArgs.command === "doctor") {
+            return commandCompleted ? 0 : 1;
+        }
         return 0;
     }
     catch (error) {

package/dist/pipeline/flow-catalog.js

@@ -8,11 +8,13 @@ export const BUILT_IN_COMMAND_FLOW_IDS = [
     "auto-common",
     "bug-analyze",
     "bug-fix",
+    "design-review",
     "git-commit",
     "gitlab-diff-review",
     "gitlab-review",
     "mr-description",
     "plan",
+    "plan-revise",
     "task-describe",
     "implement",
     "review",
@@ -26,11 +28,13 @@ const BUILT_IN_COMMAND_FLOW_FILES = {
     "auto-common": "auto-common.json",
     "bug-analyze": "bugz/bug-analyze.json",
     "bug-fix": "bugz/bug-fix.json",
+    "design-review": "design-review.json",
     "git-commit": "git-commit.json",
     "gitlab-diff-review": "gitlab/gitlab-diff-review.json",
     "gitlab-review": "gitlab/gitlab-review.json",
     "mr-description": "gitlab/mr-description.json",
     plan: "plan.json",
+    "plan-revise": "plan-revise.json",
     "task-describe": "task-describe.json",
     implement: "implement.json",
     review: "review/review.json",

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/implement.json

@@ -1,7 +1,7 @@
 {
   "kind": "implement-flow",
   "version": 1,
-  "description": "Runs LLM-backed implementation based on previously approved design and plan artifacts. Executes code changes locally in the project working directory.",
+  "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",
@@ -35,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" },