agentweaver 0.1.3 → 0.1.5

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

@@ -0,0 +1,89 @@
+{
+  "kind": "task-describe-flow",
+  "version": 1,
+  "phases": [
+    {
+      "id": "task_describe",
+      "steps": [
+        {
+          "id": "run_codex_task_describe",
+          "node": "codex-local-prompt",
+          "prompt": {
+            "inlineTemplate": "Посмотри задачу в {jira_task_file}. Проанализируй код и оформи краткое описание для Jira, без лишних подробностей. Сначала запиши source-of-truth JSON в {jira_description_json_file} в виде объекта { summary: string }, затем markdown-версию в {jira_description_file}.",
+            "vars": {
+              "jira_task_file": {
+                "artifact": {
+                  "kind": "jira-task-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              },
+              "jira_description_file": {
+                "artifact": {
+                  "kind": "jira-description-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              },
+              "jira_description_json_file": {
+                "artifact": {
+                  "kind": "jira-description-json-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              }
+            },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "format": "task-prompt"
+          },
+          "params": {
+            "labelText": { "const": "Running Codex task description mode" },
+            "model": { "const": "gpt-5.4" },
+            "requiredArtifacts": {
+              "list": [
+                {
+                  "artifact": {
+                    "kind": "jira-description-file",
+                    "taskKey": { "ref": "params.taskKey" }
+                  }
+                },
+                {
+                  "artifact": {
+                    "kind": "jira-description-json-file",
+                    "taskKey": { "ref": "params.taskKey" }
+                  }
+                }
+              ]
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "when": { "not": { "ref": "context.dryRun" } },
+              "path": {
+                "artifact": {
+                  "kind": "jira-description-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              },
+              "message": "Task describe mode did not produce the Jira description artifact."
+            },
+            {
+              "kind": "require-structured-artifacts",
+              "when": { "not": { "ref": "context.dryRun" } },
+              "items": [
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "jira-description-json-file",
+                      "taskKey": { "ref": "params.taskKey" }
+                    }
+                  },
+                  "schemaId": "jira-description/v1"
+                }
+              ],
+              "message": "Task describe mode produced invalid structured artifacts."
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/pipeline/node-registry.js

@@ -4,11 +4,14 @@ import { codexDockerPromptNode } from "./nodes/codex-docker-prompt-node.js";
 import { codexLocalPromptNode } from "./nodes/codex-local-prompt-node.js";
 import { commandCheckNode } from "./nodes/command-check-node.js";
 import { fileCheckNode } from "./nodes/file-check-node.js";
+import { flowRunNode } from "./nodes/flow-run-node.js";
 import { jiraFetchNode } from "./nodes/jira-fetch-node.js";
 import { planCodexNode } from "./nodes/plan-codex-node.js";
 import { reviewClaudeNode } from "./nodes/review-claude-node.js";
+import { reviewFindingsFormNode } from "./nodes/review-findings-form-node.js";
 import { reviewReplyCodexNode } from "./nodes/review-reply-codex-node.js";
 import { summaryFileLoadNode } from "./nodes/summary-file-load-node.js";
+import { userInputNode } from "./nodes/user-input-node.js";
 import { verifyBuildNode } from "./nodes/verify-build-node.js";
 const builtInNodes = {
     "build-failure-summary": buildFailureSummaryNode,
@@ -17,11 +20,14 @@ const builtInNodes = {
     "codex-local-prompt": codexLocalPromptNode,
     "command-check": commandCheckNode,
     "file-check": fileCheckNode,
+    "flow-run": flowRunNode,
     "jira-fetch": jiraFetchNode,
     "plan-codex": planCodexNode,
     "review-claude": reviewClaudeNode,
+    "review-findings-form": reviewFindingsFormNode,
     "review-reply-codex": reviewReplyCodexNode,
     "summary-file-load": summaryFileLoadNode,
+    "user-input": userInputNode,
     "verify-build": verifyBuildNode,
 };
 const builtInNodeMetadata = {
@@ -36,6 +42,7 @@ const builtInNodeMetadata = {
     "codex-local-prompt": { kind: "codex-local-prompt", version: 1, prompt: "required", requiredParams: ["labelText"] },
     "command-check": { kind: "command-check", version: 1, prompt: "forbidden", requiredParams: ["commands"] },
     "file-check": { kind: "file-check", version: 1, prompt: "forbidden", requiredParams: ["path"] },
+    "flow-run": { kind: "flow-run", version: 1, prompt: "forbidden", requiredParams: ["fileName"] },
     "jira-fetch": { kind: "jira-fetch", version: 1, prompt: "forbidden", requiredParams: ["jiraApiUrl", "outputFile"] },
     "plan-codex": { kind: "plan-codex", version: 1, prompt: "forbidden", requiredParams: ["prompt", "requiredArtifacts"] },
     "review-claude": {
@@ -44,6 +51,12 @@ const builtInNodeMetadata = {
         prompt: "forbidden",
         requiredParams: ["jiraTaskFile", "taskKey", "iteration", "claudeCmd"],
     },
+    "review-findings-form": {
+        kind: "review-findings-form",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["reviewJsonFile", "formId", "title"],
+    },
     "review-reply-codex": {
         kind: "review-reply-codex",
         version: 1,
@@ -51,6 +64,12 @@ const builtInNodeMetadata = {
         requiredParams: ["jiraTaskFile", "taskKey", "iteration", "codexCmd"],
     },
     "summary-file-load": { kind: "summary-file-load", version: 1, prompt: "forbidden", requiredParams: ["path"] },
+    "user-input": {
+        kind: "user-input",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["formId", "title", "fields", "outputFile"],
+    },
     "verify-build": { kind: "verify-build", version: 1, prompt: "forbidden", requiredParams: ["dockerComposeFile", "labelText"] },
 };
 export function createNodeRegistry() {

package/dist/pipeline/nodes/flow-run-node.js

@@ -0,0 +1,40 @@
+import { printInfo } from "../../tui.js";
+import { runExpandedPhase } from "../declarative-flow-runner.js";
+import { loadDeclarativeFlow } from "../declarative-flows.js";
+export const flowRunNode = {
+    kind: "flow-run",
+    version: 1,
+    async run(context, params) {
+        const { fileName, labelText, ...flowParams } = params;
+        if (typeof fileName !== "string" || fileName.trim().length === 0) {
+            throw new Error("flow-run node requires non-empty 'fileName' param");
+        }
+        if (labelText) {
+            printInfo(String(labelText));
+        }
+        const flow = loadDeclarativeFlow(fileName);
+        const executionState = {
+            flowKind: flow.kind,
+            flowVersion: flow.version,
+            terminated: false,
+            phases: [],
+        };
+        for (const phase of flow.phases) {
+            await runExpandedPhase(phase, context, flowParams, flow.constants, {
+                executionState,
+                flowKind: flow.kind,
+                flowVersion: flow.version,
+            });
+            if (executionState.terminated) {
+                break;
+            }
+        }
+        return {
+            value: {
+                flowKind: flow.kind,
+                flowVersion: flow.version,
+                executionState,
+            },
+        };
+    },
+};

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

@@ -0,0 +1,65 @@
+import { readFileSync } from "node:fs";
+import { TaskRunnerError } from "../../errors.js";
+export const reviewFindingsFormNode = {
+    kind: "review-findings-form",
+    version: 1,
+    async run(_context, params) {
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(params.reviewJsonFile, "utf8"));
+        }
+        catch (error) {
+            throw new TaskRunnerError(`Failed to read review findings from ${params.reviewJsonFile}: ${error.message}`);
+        }
+        const review = parsed;
+        const findings = Array.isArray(review.findings) ? review.findings : [];
+        const selectableFindings = findings
+            .map((finding) => ({
+            severity: typeof finding.severity === "string" ? finding.severity.trim() : "",
+            title: typeof finding.title === "string" ? finding.title.trim() : "",
+            description: typeof finding.description === "string" ? finding.description.trim() : "",
+        }))
+            .filter((finding) => finding.title.length > 0);
+        const fields = [
+            {
+                id: "apply_all",
+                type: "boolean",
+                label: "Исправить все findings в этой итерации",
+                help: "Если включено, выбор списка ниже не ограничивает scope исправлений.",
+                default: selectableFindings.length === 0,
+            },
+        ];
+        if (selectableFindings.length > 0) {
+            fields.push({
+                id: "selected_findings",
+                type: "multi-select",
+                label: "Какие findings исправить сейчас",
+                help: "Space переключает пункт. Если apply_all=false, выберите хотя бы один finding.",
+                options: selectableFindings.map((finding) => ({
+                    value: finding.title,
+                    label: `[${finding.severity || "info"}] ${finding.title}`,
+                    ...(finding.description ? { description: finding.description } : {}),
+                })),
+                default: [],
+            });
+        }
+        fields.push({
+            id: "extra_notes",
+            type: "text",
+            label: "Дополнительные указания",
+            help: "Короткий комментарий для этой итерации review-fix.",
+            default: "",
+            placeholder: "Например: исправить только блокеры",
+        });
+        return {
+            value: {
+                formId: params.formId,
+                title: params.title,
+                ...(params.description ? { description: params.description } : {}),
+                submitLabel: "Запустить review-fix",
+                fields,
+                findingCount: selectableFindings.length,
+            },
+        };
+    },
+};

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

@@ -0,0 +1,93 @@
+import { writeFileSync } from "node:fs";
+import { TaskRunnerError } from "../../errors.js";
+import { printSummary } from "../../tui.js";
+import { requestUserInputInTerminal, validateUserInputValues, } from "../../user-input.js";
+function labelForSingleValue(field, value) {
+    if (field.type !== "single-select" && field.type !== "multi-select") {
+        return value;
+    }
+    return field.options.find((option) => option.value === value)?.label ?? value;
+}
+function buildReviewFixPromptSuffix(params, values) {
+    const applyAll = values.apply_all === true;
+    const selectedFindings = Array.isArray(values.selected_findings)
+        ? values.selected_findings.filter((item) => typeof item === "string" && item.trim().length > 0)
+        : [];
+    const extraNotes = typeof values.extra_notes === "string" ? values.extra_notes.trim() : "";
+    if (!applyAll && selectedFindings.length === 0) {
+        throw new TaskRunnerError("Review-fix requires selecting at least one finding or enabling 'apply all'.");
+    }
+    const selectionSummary = applyAll
+        ? "Выбраны все findings."
+        : `Выбраны findings:\n- ${selectedFindings.join("\n- ")}`;
+    const promptSuffix = [
+        "Используй пользовательский выбор ниже как source of truth для scope текущего review-fix.",
+        `Файл выбора: ${params.outputFile}`,
+        `apply_all: ${applyAll ? "true" : "false"}`,
+        applyAll ? "Исправляй все findings текущей итерации." : `Исправляй только выбранные findings:\n- ${selectedFindings.join("\n- ")}`,
+        extraNotes ? `Дополнительные указания пользователя:\n${extraNotes}` : "",
+    ]
+        .filter((item) => item.trim().length > 0)
+        .join("\n\n");
+    const summaryText = extraNotes ? `${selectionSummary}\n\nЗаметка:\n${extraNotes}` : selectionSummary;
+    return { promptSuffix, summaryText };
+}
+function buildPromptSuffix(params, values) {
+    if (params.formId === "review-fix-selection") {
+        return buildReviewFixPromptSuffix(params, values);
+    }
+    const lines = params.fields.map((field) => {
+        const raw = values[field.id];
+        if (typeof raw === "boolean") {
+            return `${field.label}: ${raw ? "yes" : "no"}`;
+        }
+        if (typeof raw === "string") {
+            return `${field.label}: ${raw || "-"}`;
+        }
+        if (Array.isArray(raw)) {
+            const labels = raw.map((item) => labelForSingleValue(field, item));
+            return `${field.label}: ${labels.length > 0 ? labels.join(", ") : "-"}`;
+        }
+        return `${field.label}: -`;
+    });
+    const summaryText = lines.join("\n");
+    return {
+        promptSuffix: `Используй пользовательский ввод из файла ${params.outputFile}.\n\n${summaryText}`,
+        summaryText,
+    };
+}
+export const userInputNode = {
+    kind: "user-input",
+    version: 1,
+    async run(context, params) {
+        const form = {
+            formId: params.formId,
+            title: params.title,
+            ...(params.description ? { description: params.description } : {}),
+            ...(params.submitLabel ? { submitLabel: params.submitLabel } : {}),
+            fields: params.fields,
+        };
+        const requester = context.requestUserInput ?? requestUserInputInTerminal;
+        const result = await requester(form);
+        validateUserInputValues(form, result.values);
+        const rendered = buildPromptSuffix(params, result.values);
+        const artifact = {
+            form_id: result.formId,
+            submitted_at: result.submittedAt,
+            values: result.values,
+        };
+        writeFileSync(params.outputFile, `${JSON.stringify(artifact, null, 2)}\n`, "utf8");
+        printSummary(params.title, rendered.summaryText);
+        return {
+            value: {
+                formId: result.formId,
+                submittedAt: result.submittedAt,
+                values: result.values,
+                outputFile: params.outputFile,
+                promptSuffix: rendered.promptSuffix,
+                summaryText: rendered.summaryText,
+            },
+            outputs: [{ kind: "artifact", path: params.outputFile, required: true }],
+        };
+    },
+};

package/dist/pipeline/nodes/verify-build-node.js

@@ -8,6 +8,7 @@ export const verifyBuildNode = {
         const executor = context.executors.get("verify-build");
         const value = await executor.execute(toExecutorContext(context), {
             dockerComposeFile: params.dockerComposeFile,
+            ...(params.service ? { service: params.service } : {}),
         }, executor.defaultConfig);
         return { value };
     },

package/dist/pipeline/prompt-registry.js

@@ -1,12 +1,17 @@
-import { IMPLEMENT_PROMPT_TEMPLATE, PLAN_PROMPT_TEMPLATE, REVIEW_FIX_PROMPT_TEMPLATE, REVIEW_PROMPT_TEMPLATE, REVIEW_REPLY_PROMPT_TEMPLATE, REVIEW_REPLY_SUMMARY_PROMPT_TEMPLATE, REVIEW_SUMMARY_PROMPT_TEMPLATE, TASK_SUMMARY_PROMPT_TEMPLATE, TEST_FIX_PROMPT_TEMPLATE, TEST_LINTER_FIX_PROMPT_TEMPLATE, } from "../prompts.js";
+import { BUG_ANALYZE_PROMPT_TEMPLATE, BUG_FIX_PROMPT_TEMPLATE, IMPLEMENT_PROMPT_TEMPLATE, MR_DESCRIPTION_PROMPT_TEMPLATE, PLAN_PROMPT_TEMPLATE, REVIEW_FIX_PROMPT_TEMPLATE, REVIEW_PROMPT_TEMPLATE, REVIEW_REPLY_PROMPT_TEMPLATE, REVIEW_REPLY_SUMMARY_PROMPT_TEMPLATE, REVIEW_SUMMARY_PROMPT_TEMPLATE, RUN_LINTER_LOOP_FIX_PROMPT_TEMPLATE, RUN_TESTS_LOOP_FIX_PROMPT_TEMPLATE, TASK_SUMMARY_PROMPT_TEMPLATE, TEST_FIX_PROMPT_TEMPLATE, TEST_LINTER_FIX_PROMPT_TEMPLATE, } from "../prompts.js";
 const promptTemplates = {
+    "bug-analyze": BUG_ANALYZE_PROMPT_TEMPLATE,
+    "bug-fix": BUG_FIX_PROMPT_TEMPLATE,
     implement: IMPLEMENT_PROMPT_TEMPLATE,
+    "mr-description": MR_DESCRIPTION_PROMPT_TEMPLATE,
     plan: PLAN_PROMPT_TEMPLATE,
     review: REVIEW_PROMPT_TEMPLATE,
     "review-fix": REVIEW_FIX_PROMPT_TEMPLATE,
     "review-reply": REVIEW_REPLY_PROMPT_TEMPLATE,
     "review-reply-summary": REVIEW_REPLY_SUMMARY_PROMPT_TEMPLATE,
     "review-summary": REVIEW_SUMMARY_PROMPT_TEMPLATE,
+    "run-linter-loop-fix": RUN_LINTER_LOOP_FIX_PROMPT_TEMPLATE,
+    "run-tests-loop-fix": RUN_TESTS_LOOP_FIX_PROMPT_TEMPLATE,
     "task-summary": TASK_SUMMARY_PROMPT_TEMPLATE,
     "test-fix": TEST_FIX_PROMPT_TEMPLATE,
     "test-linter-fix": TEST_LINTER_FIX_PROMPT_TEMPLATE,

package/dist/pipeline/spec-compiler.js

@@ -123,6 +123,18 @@ function interpolateExpectation(expectation, repeatVars) {
             message: interpolateText(expectation.message, repeatVars),
         };
     }
+    if (expectation.kind === "require-structured-artifacts") {
+        const when = expectation.when ? interpolateCondition(expectation.when, repeatVars) : undefined;
+        return {
+            kind: expectation.kind,
+            ...(when ? { when } : {}),
+            items: expectation.items.map((item) => ({
+                path: interpolateValueSpec(item.path, repeatVars),
+                schemaId: item.schemaId,
+            })),
+            message: interpolateText(expectation.message, repeatVars),
+        };
+    }
     const when = expectation.when ? interpolateCondition(expectation.when, repeatVars) : undefined;
     if (expectation.kind === "require-file") {
         return {
@@ -180,6 +192,7 @@ function expandRepeat(block) {
     for (let index = block.repeat.from; index <= block.repeat.to; index += 1) {
         const repeatVars = {
             [block.repeat.var]: index,
+            [`${block.repeat.var}_minus_one`]: index - 1,
         };
         for (const phase of block.phases) {
             phases.push(expandPhase(phase, repeatVars));

package/dist/pipeline/spec-validator.js

@@ -108,6 +108,12 @@ function validateExpectation(expectation, path) {
         validateValueSpec(expectation.paths, `${path}.paths`);
         return;
     }
+    if (expectation.kind === "require-structured-artifacts") {
+        expectation.items.forEach((item, index) => {
+            validateValueSpec(item.path, `${path}.items[${index}].path`);
+        });
+        return;
+    }
     if (expectation.kind === "require-file") {
         validateValueSpec(expectation.path, `${path}.path`);
         return;
@@ -268,6 +274,12 @@ export function validateExpandedPhases(phases) {
                         validateExpandedValueSpec(expectation.paths, phases, phaseIndex, stepIndex, `phases.${phase.id}.steps.${step.id}.expect[${index}].paths`);
                         return;
                     }
+                    if (expectation.kind === "require-structured-artifacts") {
+                        expectation.items.forEach((item, itemIndex) => {
+                            validateExpandedValueSpec(item.path, phases, phaseIndex, stepIndex, `phases.${phase.id}.steps.${step.id}.expect[${index}].items[${itemIndex}].path`);
+                        });
+                        return;
+                    }
                     if (expectation.kind === "require-file") {
                         validateExpandedValueSpec(expectation.path, phases, phaseIndex, stepIndex, `phases.${phase.id}.steps.${step.id}.expect[${index}].path`);
                         return;

package/dist/pipeline/value-resolver.js

@@ -1,5 +1,5 @@
 import { existsSync } from "node:fs";
-import { artifactFile, designFile, jiraTaskFile, planArtifacts, planFile, qaFile, readyToMergeFile, taskSummaryFile, } from "../artifacts.js";
+import { artifactFile, bugAnalyzeArtifacts, bugAnalyzeFile, bugAnalyzeJsonFile, bugFixDesignFile, bugFixDesignJsonFile, bugFixPlanFile, bugFixPlanJsonFile, designFile, designJsonFile, jiraDescriptionFile, jiraDescriptionJsonFile, jiraTaskFile, mrDescriptionFile, mrDescriptionJsonFile, planArtifacts, planFile, planJsonFile, qaFile, qaJsonFile, readyToMergeFile, reviewFile, reviewFixFile, reviewFixJsonFile, reviewJsonFile, reviewReplyFile, reviewReplyJsonFile, taskSummaryFile, taskSummaryJsonFile, } from "../artifacts.js";
 import { TaskRunnerError } from "../errors.js";
 import { formatTemplate } from "../prompts.js";
 function readStepRef(segments, context, originalPath) {
@@ -72,31 +72,72 @@ function resolveArtifact(spec, context) {
     const taskKey = String(resolveValue(spec.taskKey, context));
     const iteration = spec.iteration === undefined ? undefined : Number(resolveValue(spec.iteration, context));
     switch (spec.kind) {
+        case "bug-analyze-file":
+            return bugAnalyzeFile(taskKey);
+        case "bug-analyze-json-file":
+            return bugAnalyzeJsonFile(taskKey);
+        case "bug-fix-design-file":
+            return bugFixDesignFile(taskKey);
+        case "bug-fix-design-json-file":
+            return bugFixDesignJsonFile(taskKey);
+        case "bug-fix-plan-file":
+            return bugFixPlanFile(taskKey);
+        case "bug-fix-plan-json-file":
+            return bugFixPlanJsonFile(taskKey);
         case "design-file":
             return designFile(taskKey);
+        case "design-json-file":
+            return designJsonFile(taskKey);
+        case "jira-description-file":
+            return jiraDescriptionFile(taskKey);
+        case "jira-description-json-file":
+            return jiraDescriptionJsonFile(taskKey);
         case "jira-task-file":
             return jiraTaskFile(taskKey);
+        case "mr-description-file":
+            return mrDescriptionFile(taskKey);
+        case "mr-description-json-file":
+            return mrDescriptionJsonFile(taskKey);
         case "plan-file":
             return planFile(taskKey);
+        case "plan-json-file":
+            return planJsonFile(taskKey);
         case "qa-file":
             return qaFile(taskKey);
+        case "qa-json-file":
+            return qaJsonFile(taskKey);
         case "ready-to-merge-file":
             return readyToMergeFile(taskKey);
         case "review-file":
             if (iteration === undefined) {
                 throw new TaskRunnerError("review-file requires iteration");
             }
-            return artifactFile("review", taskKey, iteration);
+            return reviewFile(taskKey, iteration);
+        case "review-json-file":
+            if (iteration === undefined) {
+                throw new TaskRunnerError("review-json-file requires iteration");
+            }
+            return reviewJsonFile(taskKey, iteration);
         case "review-fix-file":
             if (iteration === undefined) {
                 throw new TaskRunnerError("review-fix-file requires iteration");
             }
-            return artifactFile("review-fix", taskKey, iteration);
+            return reviewFixFile(taskKey, iteration);
+        case "review-fix-json-file":
+            if (iteration === undefined) {
+                throw new TaskRunnerError("review-fix-json-file requires iteration");
+            }
+            return reviewFixJsonFile(taskKey, iteration);
         case "review-reply-file":
             if (iteration === undefined) {
                 throw new TaskRunnerError("review-reply-file requires iteration");
             }
-            return artifactFile("review-reply", taskKey, iteration);
+            return reviewReplyFile(taskKey, iteration);
+        case "review-reply-json-file":
+            if (iteration === undefined) {
+                throw new TaskRunnerError("review-reply-json-file requires iteration");
+            }
+            return reviewReplyJsonFile(taskKey, iteration);
         case "review-reply-summary-file":
             if (iteration === undefined) {
                 throw new TaskRunnerError("review-reply-summary-file requires iteration");
@@ -109,11 +150,15 @@ function resolveArtifact(spec, context) {
             return artifactFile("review-summary", taskKey, iteration);
         case "task-summary-file":
             return taskSummaryFile(taskKey);
+        case "task-summary-json-file":
+            return taskSummaryJsonFile(taskKey);
     }
 }
 function resolveArtifactList(spec, context) {
     const taskKey = String(resolveValue(spec.taskKey, context));
     switch (spec.kind) {
+        case "bug-analyze-artifacts":
+            return bugAnalyzeArtifacts(taskKey);
         case "plan-artifacts":
             return planArtifacts(taskKey);
     }

package/dist/prompts.js

@@ -1,33 +1,65 @@
 export const BASE_PROMPT_HEADER = "Основная задача:";
 export const EXTRA_PROMPT_HEADER = "Дополнительные указания:";
 export const PLAN_PROMPT_TEMPLATE = "Посмотри и проанализируй задачу в {jira_task_file}. " +
-    "Разработай системный дизайн решения, запиши в {design_file}. " +
-    "Разработай подробный план реализации и запиши его в {plan_file}. " +
-    "Разработай план тестирования для QA и запиши в {qa_file}. ";
-export const IMPLEMENT_PROMPT_TEMPLATE = "Проанализируй системный дизайн {design_file}, план реализации {plan_file} и приступай к реализации по плану. ";
+    "Сначала создай структурированные JSON-артефакты, они являются source of truth для следующих flow. " +
+    "Человекочитаемые markdown-файлы сделай как краткое производное представление этих JSON-артефактов для пользователя. " +
+    "Разработай системный дизайн решения и запиши JSON в {design_json_file}, затем markdown в {design_file}. " +
+    "Для {design_json_file} используй объект: { summary: string, goals: string[], non_goals: string[], components: string[], decisions: [{ component: string, decision: string, rationale: string }], risks: string[], open_questions: string[] }. " +
+    "Разработай подробный план реализации и запиши JSON в {plan_json_file}, затем markdown в {plan_file}. " +
+    "Для {plan_json_file} используй объект: { summary: string, prerequisites: string[], implementation_steps: [{ id: string, title: string, details: string }], tests: string[], rollout_notes: string[] }. " +
+    "Разработай план тестирования для QA и запиши JSON в {qa_json_file}, затем markdown в {qa_file}. " +
+    "Для {qa_json_file} используй объект: { summary: string, test_scenarios: [{ id: string, title: string, expected_result: string }], non_functional_checks: string[] }. " +
+    "JSON-файлы должны быть валидными и содержать только JSON без markdown-обёртки. ";
+export const BUG_ANALYZE_PROMPT_TEMPLATE = "Посмотри и проанализируй баг в {jira_task_file}. " +
+    "Сначала создай структурированные JSON-артефакты, они являются source of truth для следующих flow. " +
+    "Человекочитаемые markdown-файлы сделай как краткое производное представление этих JSON-артефактов для пользователя. " +
+    "Запиши структурированный анализ бага в {bug_analyze_json_file}, затем краткую markdown-версию в {bug_analyze_file}. " +
+    "Запиши структурированный дизайн исправления в {bug_fix_design_json_file}, затем краткую markdown-версию в {bug_fix_design_file}. " +
+    "Запиши структурированный план реализации в {bug_fix_plan_json_file}, затем краткую markdown-версию в {bug_fix_plan_file}. " +
+    "JSON-файлы должны быть валидными и содержать только JSON без markdown-обёртки. " +
+    "Для {bug_analyze_json_file} используй объект: { summary: string, suspected_root_cause: { hypothesis: string, confidence: string }, reproduction_steps: string[], affected_components: string[], evidence: string[], risks: string[], open_questions: string[] }. " +
+    "Для {bug_fix_design_json_file} используй объект: { summary: string, goals: string[], non_goals: string[], target_components: string[], proposed_changes: [{ component: string, change: string, rationale: string }], alternatives_considered: [{ option: string, decision: string, rationale: string }], risks: string[], validation_strategy: string[] }. " +
+    "Для {bug_fix_plan_json_file} используй объект: { summary: string, prerequisites: string[], implementation_steps: [{ id: string, title: string, details: string }], tests: string[], rollout_notes: string[] }. ";
+export const BUG_FIX_PROMPT_TEMPLATE = "Используй только структурированные артефакты как source of truth. " +
+    "Проанализируй баг по {bug_analyze_json_file}. " +
+    "Используй дизайн исправления из {bug_fix_design_json_file}. " +
+    "Используй план реализации из {bug_fix_plan_json_file}. " +
+    "Markdown-артефакты предназначены только для чтения человеком и не должны определять реализацию. " +
+    "После этого приступай к реализации исправления в коде. ";
+export const MR_DESCRIPTION_PROMPT_TEMPLATE = "Посмотри задачу в {jira_task_file} и текущие изменения в репозитории. " +
+    "Подготовь очень краткое intent-описание для merge request без подробностей реализации, списков файлов и технических деталей. " +
+    "Сначала запиши source-of-truth JSON в {mr_description_json_file} в виде объекта { summary: string }, затем производную markdown-версию в {mr_description_file}. ";
+export const IMPLEMENT_PROMPT_TEMPLATE = "Используй только структурированные артефакты как source of truth. " +
+    "Проанализируй системный дизайн {design_json_file}, план реализации {plan_json_file} и приступай к реализации по плану. " +
+    "Markdown-артефакты предназначены только для чтения человеком и не должны определять реализацию. ";
 export const REVIEW_PROMPT_TEMPLATE = "Проведи код-ревью текущих изменений. " +
-    "Сверься с задачей в {jira_task_file}, дизайном {design_file} и планом {plan_file}. " +
-    "Замечания и комментарии запиши в {review_file}. " +
-    "Если больше нет блокеров, препятствующих merge - создай файл ready-to-merge.md.";
-export const REVIEW_REPLY_PROMPT_TEMPLATE = "Твой коллега провёл код-ревью и записал комментарии в {review_file}. " +
-    "Проанализируй комментарии к код-ревью, сверься с задачей в {jira_task_file}, " +
-    "дизайном {design_file}, планом {plan_file} и запиши свои комментарии в {review_reply_file}.";
+    "Используй только структурированные артефакты как source of truth: задачу в {jira_task_file}, дизайн в {design_json_file} и план в {plan_json_file}. " +
+    "Сначала запиши структурированный результат в {review_json_file} в виде объекта { summary: string, ready_to_merge: boolean, findings: [{ severity: string, title: string, description: string }] }. " +
+    "Затем запиши производную markdown-версию в {review_file}. " +
+    "Если ready_to_merge=true и нет блокеров, препятствующих merge - создай файл ready-to-merge.md.";
+export const REVIEW_REPLY_PROMPT_TEMPLATE = "Твой коллега провёл код-ревью и записал структурированный результат в {review_json_file}. " +
+    "Используй только структурированные артефакты как source of truth: задачу в {jira_task_file}, дизайн в {design_json_file}, план в {plan_json_file} и review в {review_json_file}. " +
+    "Сначала запиши структурированный ответ в {review_reply_json_file} в виде объекта { summary: string, ready_to_merge: boolean, responses: [{ finding_title: string, disposition: string, action: string }] }. " +
+    "Затем запиши производную markdown-версию в {review_reply_file}.";
 export const REVIEW_SUMMARY_PROMPT_TEMPLATE = "Посмотри в {review_file}. " +
     "Сделай краткий список комментариев без подробностей, 3-7 пунктов. " +
     "Запиши результат в {review_summary_file}.";
 export const REVIEW_REPLY_SUMMARY_PROMPT_TEMPLATE = "Посмотри в {review_reply_file}. " +
     "Сделай краткий список ответов и итоговых действий без подробностей, 3-7 пунктов. " +
     "Запиши результат в {review_reply_summary_file}.";
-export const REVIEW_FIX_PROMPT_TEMPLATE = "Проанализируй комментарии в {review_reply_file}. " +
+export const REVIEW_FIX_PROMPT_TEMPLATE = "Используй только структурированные артефакты как source of truth. " +
+    "Проанализируй комментарии в {review_reply_json_file}. " +
     "Исправь то, что содержится в дополнительных указаниях, а если таковых нет - исправь все пункты. " +
     "По окончании обязательно прогони вне песочницы линтер, все тесты, сгенерируй make swagger. " +
     "Исправь ошибки линтера и тестов, если будут. " +
-    "По завершении резюме запиши в {review_fix_file}.";
+    "По завершении сначала запиши структурированный отчёт в {review_fix_json_file} в виде объекта { summary: string, completed_actions: string[], validation_steps: string[] }, затем производную markdown-версию в {review_fix_file}.";
 export const TASK_SUMMARY_PROMPT_TEMPLATE = "Посмотри в {jira_task_file}. " +
-    "Сделай краткое резюме задачи, на 1-2 абзаца, " +
-    "запиши в {task_summary_file}.";
+    "Сделай краткое резюме задачи, на 1-2 абзаца. " +
+    "Сначала запиши source-of-truth JSON в {task_summary_json_file} в виде объекта { summary: string }, затем markdown-версию в {task_summary_file}.";
 export const TEST_FIX_PROMPT_TEMPLATE = "Прогони тесты, исправь ошибки.";
 export const TEST_LINTER_FIX_PROMPT_TEMPLATE = "Прогони линтер, исправь замечания.";
+export const RUN_TESTS_LOOP_FIX_PROMPT_TEMPLATE = "Запусти ./run_tests.sh, проанализируй последнюю ошибку проверки, исправь код и подготовь изменения так, чтобы следующий прогон run_tests.sh прошёл успешно.";
+export const RUN_LINTER_LOOP_FIX_PROMPT_TEMPLATE = "Запусти ./run_linter.sh, проанализируй последнюю ошибку линтера или генерации, исправь код и подготовь изменения так, чтобы следующий прогон run_linter.sh прошёл успешно.";
 export const AUTO_REVIEW_FIX_EXTRA_PROMPT = "Исправлять только блокеры, критикалы и важные";
 export function formatTemplate(template, values) {
     let result = template;