agentweaver 0.1.7 → 0.1.9

package/dist/pipeline/spec-validator.js

@@ -1,12 +1,39 @@
 import { TaskRunnerError } from "../errors.js";
+import { STRUCTURED_ARTIFACT_SCHEMA_IDS } from "../structured-artifacts.js";
 import { isPromptTemplateRef } from "./prompt-registry.js";
+import { ARTIFACT_LIST_REF_KINDS as artifactListRefKinds, ARTIFACT_REF_KINDS as artifactRefKinds, } from "./spec-types.js";
+function isArtifactRefKind(value) {
+    return artifactRefKinds.includes(value);
+}
+function isArtifactListRefKind(value) {
+    return artifactListRefKinds.includes(value);
+}
+function validateArtifactRefSpec(spec, path) {
+    assert(isArtifactRefKind(spec.kind), `Unknown artifact kind '${spec.kind}' at ${path}.kind`);
+    validateValueSpec(spec.taskKey, `${path}.taskKey`);
+    if (spec.iteration) {
+        validateValueSpec(spec.iteration, `${path}.iteration`);
+    }
+}
+function validateArtifactListRefSpec(spec, path) {
+    assert(isArtifactListRefKind(spec.kind), `Unknown artifact list kind '${spec.kind}' at ${path}.kind`);
+    validateValueSpec(spec.taskKey, `${path}.taskKey`);
+}
 function assert(condition, message) {
     if (!condition) {
         throw new TaskRunnerError(message);
     }
 }
 function validateValueSpec(value, path) {
-    if ("const" in value || "ref" in value || "artifact" in value || "artifactList" in value) {
+    if ("const" in value || "ref" in value) {
+        return;
+    }
+    if ("artifact" in value) {
+        validateArtifactRefSpec(value.artifact, `${path}.artifact`);
+        return;
+    }
+    if ("artifactList" in value) {
+        validateArtifactListRefSpec(value.artifactList, `${path}.artifactList`);
         return;
     }
     if ("template" in value) {
@@ -64,9 +91,12 @@ function validateCondition(condition, path) {
     }
     throw new TaskRunnerError(`Unsupported condition at ${path}`);
 }
-function validateStep(step, nodeRegistry, path) {
+function validateStep(step, nodeRegistry, executorRegistry, path, options) {
     assert(nodeRegistry.has(step.node), `Unknown node kind '${step.node}' at ${path}.node`);
     const nodeMeta = nodeRegistry.getMeta(step.node);
+    for (const executorId of nodeMeta.executors ?? []) {
+        assert(executorRegistry.has(executorId), `Unknown executor '${executorId}' required by node '${step.node}' at ${path}.node`);
+    }
     validateCondition(step.when, `${path}.when`);
     if (step.prompt) {
         assert(nodeMeta.prompt !== "forbidden", `Node '${step.node}' does not accept prompt binding at ${path}.prompt`);
@@ -92,6 +122,21 @@ function validateStep(step, nodeRegistry, path) {
             validateValueSpec(value, `${path}.params.${key}`);
         }
     }
+    if (nodeMeta.nestedFlowParam) {
+        const nestedValue = step.params?.[nodeMeta.nestedFlowParam];
+        if (nestedValue && "const" in nestedValue && typeof nestedValue.const === "string" && nestedValue.const.trim().length > 0) {
+            const resolveFlowByName = options.resolveFlowByName;
+            if (typeof resolveFlowByName !== "function") {
+                throw new TaskRunnerError(`Flow validator cannot resolve nested flow '${nestedValue.const}' at ${path}.params.${nodeMeta.nestedFlowParam}`);
+            }
+            try {
+                resolveFlowByName(nestedValue.const);
+            }
+            catch (error) {
+                throw new TaskRunnerError(`Unknown nested flow '${nestedValue.const}' at ${path}.params.${nodeMeta.nestedFlowParam}: ${error.message}`);
+            }
+        }
+    }
     if (step.expect) {
         step.expect.forEach((expectation, index) => validateExpectation(expectation, `${path}.expect[${index}]`));
     }
@@ -111,6 +156,7 @@ function validateExpectation(expectation, path) {
     if (expectation.kind === "require-structured-artifacts") {
         expectation.items.forEach((item, index) => {
             validateValueSpec(item.path, `${path}.items[${index}].path`);
+            assert(STRUCTURED_ARTIFACT_SCHEMA_IDS.includes(item.schemaId), `Unknown structured artifact schema '${item.schemaId}' at ${path}.items[${index}].schemaId`);
         });
         return;
     }
@@ -135,10 +181,10 @@ function validateAfterAction(action, path) {
     }
     throw new TaskRunnerError(`Unsupported after action at ${path}`);
 }
-function validatePhase(phase, nodeRegistry, path) {
+function validatePhase(phase, nodeRegistry, executorRegistry, path, options) {
     assert(phase.id.trim().length > 0, `Phase id must be non-empty at ${path}.id`);
     validateCondition(phase.when, `${path}.when`);
-    phase.steps.forEach((step, index) => validateStep(step, nodeRegistry, `${path}.steps[${index}]`));
+    phase.steps.forEach((step, index) => validateStep(step, nodeRegistry, executorRegistry, `${path}.steps[${index}]`, options));
 }
 function validateRefPath(ref, phases, currentPhaseIndex, currentStepIndex, path, allowCurrentStepRef = false) {
     const [scope, ...rest] = ref.split(".");
@@ -230,17 +276,17 @@ function validateExpandedCondition(condition, phases, currentPhaseIndex, current
         validateExpandedValueSpec(condition.exists, phases, currentPhaseIndex, currentStepIndex, `${path}.exists`, allowCurrentStepRef);
     }
 }
-export function validateFlowSpec(spec, nodeRegistry) {
+export function validateFlowSpec(spec, nodeRegistry, executorRegistry, options = {}) {
     assert(spec.kind.trim().length > 0, "Flow spec kind must be non-empty");
     assert(Number.isInteger(spec.version) && spec.version > 0, "Flow spec version must be a positive integer");
     spec.phases.forEach((item, index) => {
         if ("repeat" in item) {
             assert(item.repeat.var.trim().length > 0, `Repeat var must be non-empty at phases[${index}].repeat.var`);
             assert(item.repeat.to >= item.repeat.from, `Repeat range is invalid at phases[${index}].repeat`);
-            item.phases.forEach((phase, phaseIndex) => validatePhase(phase, nodeRegistry, `phases[${index}].phases[${phaseIndex}]`));
+            item.phases.forEach((phase, phaseIndex) => validatePhase(phase, nodeRegistry, executorRegistry, `phases[${index}].phases[${phaseIndex}]`, options));
             return;
         }
-        validatePhase(item, nodeRegistry, `phases[${index}]`);
+        validatePhase(item, nodeRegistry, executorRegistry, `phases[${index}]`, options);
     });
 }
 export function validateExpandedPhases(phases) {

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, gitlabReviewFile, gitlabReviewInputJsonFile, gitlabReviewJsonFile, jiraDescriptionFile, jiraDescriptionJsonFile, jiraTaskFile, mrDescriptionFile, mrDescriptionJsonFile, planArtifacts, planFile, planJsonFile, qaFile, qaJsonFile, readyToMergeFile, reviewFile, reviewFixFile, reviewFixJsonFile, reviewJsonFile, reviewReplyFile, reviewReplyJsonFile, taskSummaryFile, taskSummaryJsonFile, } 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, reviewFile, reviewFixFile, reviewFixJsonFile, reviewJsonFile, reviewReplyFile, reviewReplyJsonFile, runGoLinterResultJsonFile, runGoTestsResultJsonFile, taskSummaryFile, taskSummaryJsonFile, } from "../artifacts.js";
 import { TaskRunnerError } from "../errors.js";
 import { formatTemplate } from "../prompts.js";
 function readStepRef(segments, context, originalPath) {
@@ -88,12 +88,22 @@ function resolveArtifact(spec, context) {
             return designFile(taskKey);
         case "design-json-file":
             return designJsonFile(taskKey);
+        case "gitlab-diff-file":
+            return gitlabDiffFile(taskKey);
+        case "gitlab-diff-json-file":
+            return gitlabDiffJsonFile(taskKey);
+        case "gitlab-diff-review-input-json-file":
+            return gitlabDiffReviewInputJsonFile(taskKey);
         case "gitlab-review-file":
             return gitlabReviewFile(taskKey);
         case "gitlab-review-input-json-file":
             return gitlabReviewInputJsonFile(taskKey);
         case "gitlab-review-json-file":
             return gitlabReviewJsonFile(taskKey);
+        case "jira-attachments-context-file":
+            return jiraAttachmentsContextFile(taskKey);
+        case "jira-attachments-manifest-file":
+            return jiraAttachmentsManifestFile(taskKey);
         case "jira-description-file":
             return jiraDescriptionFile(taskKey);
         case "jira-description-json-file":
@@ -104,6 +114,10 @@ function resolveArtifact(spec, context) {
             return mrDescriptionFile(taskKey);
         case "mr-description-json-file":
             return mrDescriptionJsonFile(taskKey);
+        case "planning-answers-json-file":
+            return planningAnswersJsonFile(taskKey);
+        case "planning-questions-json-file":
+            return planningQuestionsJsonFile(taskKey);
         case "plan-file":
             return planFile(taskKey);
         case "plan-json-file":
@@ -144,6 +158,16 @@ function resolveArtifact(spec, context) {
                 throw new TaskRunnerError("review-reply-json-file requires iteration");
             }
             return reviewReplyJsonFile(taskKey, iteration);
+        case "run-go-linter-result-json-file":
+            if (iteration === undefined) {
+                throw new TaskRunnerError("run-go-linter-result-json-file requires iteration");
+            }
+            return runGoLinterResultJsonFile(taskKey, iteration);
+        case "run-go-tests-result-json-file":
+            if (iteration === undefined) {
+                throw new TaskRunnerError("run-go-tests-result-json-file requires iteration");
+            }
+            return runGoTestsResultJsonFile(taskKey, iteration);
         case "review-reply-summary-file":
             if (iteration === undefined) {
                 throw new TaskRunnerError("review-reply-summary-file requires iteration");

package/dist/prompts.js

@@ -1,15 +1,35 @@
 export const BASE_PROMPT_HEADER = "Основная задача:";
 export const EXTRA_PROMPT_HEADER = "Дополнительные указания:";
 export const PLAN_PROMPT_TEMPLATE = "Посмотри и проанализируй задачу в {jira_task_file}. " +
+    "Обязательно проанализируй дополнительные материалы из Jira attachments manifest {jira_attachments_manifest_file} и текстовый контекст {jira_attachments_context_file}; если attachment содержит более детальную постановку, ограничения, список файлов, migration strategy или инварианты, считай attachment source of truth для planning наравне с Jira issue. " +
     "Сначала создай структурированные JSON-артефакты, они являются source of truth для следующих flow. " +
-    "Человекочитаемые markdown-файлы сделай как краткое производное представление этих JSON-артефактов для пользователя. " +
+    "Человекочитаемые markdown-файлы сделай как подробное производное представление этих JSON-артефактов для пользователя, а не как краткое summary. " +
+    "Markdown не должен влиять на структуру JSON: сначала определи корректные JSON-типы, затем строй markdown как производное представление. " +
+    "Не схлопывай конкретику из задачи и attachment: сохраняй явные файлы, методы, API, инварианты, migration steps, DB-ограничения, business rules и acceptance criteria. " +
     "Разработай системный дизайн решения и запиши 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[] }. " +
+    'Для {design_json_file} используй строго JSON-объект вида { "summary": "string", "goals": ["string"], "non_goals": ["string"], "components": ["string"], "current_state": ["string"], "target_state": ["string"], "affected_code": [{ "area": "string", "files": ["string"], "details": "string" }], "business_rules": ["string"], "decisions": [{ "component": "string", "decision": "string", "rationale": "string" }], "migration_strategy": ["string"], "database_changes": ["string"], "api_changes": ["string"], "risks": ["string"], "acceptance_criteria": ["string"], "open_questions": ["string"] }. ' +
+    'Строго соблюдай типы. В частности, current_state и target_state всегда должны быть массивами строк, даже если пункт только один: ["..."], а не "...". ' +
+    'Точно так же files, goals, non_goals, components, business_rules, migration_strategy, database_changes, api_changes, risks, acceptance_criteria и open_questions должны быть массивами, а не одиночными строками. ' +
     "Разработай подробный план реализации и запиши 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[] }. " +
+    'Для {plan_json_file} используй строго JSON-объект вида { "summary": "string", "prerequisites": ["string"], "workstreams": ["string"], "implementation_steps": [{ "id": "string", "title": "string", "details": "string", "affected_files": ["string"], "verification": ["string"], "dependencies": ["string"] }], "tests": ["string"], "rollout_notes": ["string"], "follow_up_items": ["string"] }. ' +
+    'Строго соблюдай типы. prerequisites, workstreams, tests, rollout_notes, follow_up_items, affected_files, verification и dependencies всегда должны быть массивами, даже если элемент только один. implementation_steps должен быть массивом объектов, а не одним объектом. ' +
+    'Каждый элемент implementation_steps должен иметь вид { "id": "step-1", "title": "string", "details": "string", "affected_files": ["string"], "verification": ["string"], "dependencies": ["string"] }. ' +
+    'Нельзя использовать "verification": "..." или "affected_files": "...". Нужно использовать массивы: ["..."]. ' +
     "Разработай план тестирования для 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[] }. " +
+    'Для {qa_json_file} используй строго JSON-объект вида { "summary": "string", "test_scenarios": [{ "id": "string", "title": "string", "expected_result": "string" }], "non_functional_checks": ["string"] }. ' +
+    'Строго соблюдай типы. test_scenarios должен быть массивом объектов, а non_functional_checks должен быть массивом строк, даже если пункт только один. ' +
+    "Markdown для design и plan оформи развёрнуто, с отдельными секциями Summary, Current State, Target State, Affected Code, Decisions, Migration/DB Changes, Risks, Implementation Steps, Tests, Rollout. " +
     "JSON-файлы должны быть валидными и содержать только JSON без markdown-обёртки. ";
+export const PLAN_QUESTIONS_PROMPT_TEMPLATE = "Посмотри и проанализируй задачу в {jira_task_file}. " +
+    "Обязательно проанализируй дополнительные материалы из Jira attachments manifest {jira_attachments_manifest_file} и текстовый контекст {jira_attachments_context_file}; если attachment содержит более детальную постановку, ограничения, список файлов, migration strategy или инварианты, считай attachment source of truth для planning наравне с Jira issue. " +
+    "Перед финальным planning определи, нужны ли уточнения от пользователя. " +
+    'Если уточнения не нужны, запиши в {planning_questions_json_file} строго JSON-объект { "summary": "string", "questions": [] }. ' +
+    'Если уточнения нужны, запиши в {planning_questions_json_file} строго JSON-объект { "summary": "string", "questions": [{ "id": "string", "question": "string", "details": "string", "required": true, "multiline": false, "placeholder": "string" }] }. ' +
+    'questions всегда должен быть массивом. required и multiline должны быть boolean, а не строками "true"/"false". ' +
+    "Задавай только вопросы, без ответа на которые design/plan могут оказаться неверными или слишком предположительными. " +
+    "Не задавай очевидные, декоративные или дублирующие вопросы. " +
+    "Обычно достаточно 1-5 вопросов. " +
+    "JSON-файл должен быть валидным и содержать только JSON без markdown-обёртки. ";
 export const BUG_ANALYZE_PROMPT_TEMPLATE = "Посмотри и проанализируй баг в {jira_task_file}. " +
     "Сначала создай структурированные JSON-артефакты, они являются source of truth для следующих flow. " +
     "Человекочитаемые markdown-файлы сделай как краткое производное представление этих JSON-артефактов для пользователя. " +
@@ -17,9 +37,12 @@ export const BUG_ANALYZE_PROMPT_TEMPLATE = "Посмотри и проанали
     "Запиши структурированный дизайн исправления в {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[] }. ";
+    'Для {bug_analyze_json_file} используй строго JSON-объект { "summary": "string", "suspected_root_cause": { "hypothesis": "string", "confidence": "string" }, "reproduction_steps": ["string"], "affected_components": ["string"], "evidence": ["string"], "risks": ["string"], "open_questions": ["string"] }. ' +
+    'reproduction_steps, affected_components, evidence, risks и open_questions всегда должны быть массивами строк. suspected_root_cause всегда должен быть объектом, а не строкой. ' +
+    'Для {bug_fix_design_json_file} используй строго JSON-объект { "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"] }. ' +
+    'goals, non_goals, target_components, risks и validation_strategy всегда должны быть массивами строк. proposed_changes и alternatives_considered всегда должны быть массивами объектов. ' +
+    'Для {bug_fix_plan_json_file} используй строго JSON-объект { "summary": "string", "prerequisites": ["string"], "implementation_steps": [{ "id": "string", "title": "string", "details": "string" }], "tests": ["string"], "rollout_notes": ["string"] }. ' +
+    'prerequisites, tests и rollout_notes всегда должны быть массивами строк. implementation_steps всегда должен быть массивом объектов. ';
 export const BUG_FIX_PROMPT_TEMPLATE = "Используй только структурированные артефакты как source of truth. " +
     "Проанализируй баг по {bug_analyze_json_file}. " +
     "Используй дизайн исправления из {bug_fix_design_json_file}. " +
@@ -34,21 +57,32 @@ export const IMPLEMENT_PROMPT_TEMPLATE = "Используй только стр
     "Markdown-артефакты предназначены только для чтения человеком и не должны определять реализацию. ";
 export const REVIEW_PROMPT_TEMPLATE = "Проведи код-ревью текущих изменений. " +
     "Используй только структурированные артефакты как 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 }] }. " +
+    'Сначала запиши структурированный результат в {review_json_file} в виде строго JSON-объекта { "summary": "string", "ready_to_merge": true, "findings": [{ "severity": "string", "title": "string", "description": "string" }] }. ' +
+    'ready_to_merge должен быть boolean, а не строкой. findings всегда должен быть массивом объектов, даже если замечание одно или их нет. ' +
     "Затем запиши производную markdown-версию в {review_file}. " +
     "Если ready_to_merge=true и нет блокеров, препятствующих merge - создай файл ready-to-merge.md.";
 export const REVIEW_PROJECT_PROMPT_TEMPLATE = "Проведи код-ревью текущих изменений в проекте без Jira-контекста. " +
     "Оцени качество изменений по текущему коду, тестам, рискам регрессий и общему инженерному качеству. " +
-    "Сначала запиши структурированный результат в {review_json_file} в виде объекта { summary: string, ready_to_merge: boolean, findings: [{ severity: string, title: string, description: string }] }. " +
+    'Сначала запиши структурированный результат в {review_json_file} в виде строго JSON-объекта { "summary": "string", "ready_to_merge": true, "findings": [{ "severity": "string", "title": "string", "description": "string" }] }. ' +
+    'ready_to_merge должен быть boolean, а findings всегда должен быть массивом объектов. ' +
+    "Затем запиши производную markdown-версию в {review_file}. " +
+    "Если ready_to_merge=true и нет блокеров, создай файл {ready_to_merge_file}.";
+export const GITLAB_DIFF_REVIEW_PROMPT_TEMPLATE = "Проведи код-ревью diff merge request из GitLab. " +
+    "Используй structured diff artifact {gitlab_diff_json_file} как source of truth, а markdown {gitlab_diff_file} только как удобное представление для чтения человеком. " +
+    "Оцени только изменения из diff: корректность, риски регрессий, отсутствие тестов, опасные edge cases, нарушения контрактов и поддерживаемость. " +
+    'Сначала запиши структурированный результат в {review_json_file} в виде строго JSON-объекта { "summary": "string", "ready_to_merge": true, "findings": [{ "severity": "string", "title": "string", "description": "string" }] }. ' +
+    'ready_to_merge должен быть boolean, а findings всегда должен быть массивом объектов. ' +
     "Затем запиши производную markdown-версию в {review_file}. " +
     "Если ready_to_merge=true и нет блокеров, создай файл {ready_to_merge_file}.";
 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 }] }. " +
+    'Сначала запиши структурированный ответ в {review_reply_json_file} в виде строго JSON-объекта { "summary": "string", "ready_to_merge": true, "responses": [{ "finding_title": "string", "disposition": "string", "action": "string" }] }. ' +
+    'ready_to_merge должен быть boolean, а responses всегда должен быть массивом объектов. ' +
     "Затем запиши производную markdown-версию в {review_reply_file}.";
 export const REVIEW_REPLY_PROJECT_PROMPT_TEMPLATE = "Твой коллега провёл код-ревью и записал структурированный результат в {review_json_file}. " +
     "Используй review в {review_json_file} как source of truth, разберись в замечаниях и подготовь структурированный ответ. " +
-    "Сначала запиши структурированный ответ в {review_reply_json_file} в виде объекта { summary: string, ready_to_merge: boolean, responses: [{ finding_title: string, disposition: string, action: string }] }. " +
+    'Сначала запиши структурированный ответ в {review_reply_json_file} в виде строго JSON-объекта { "summary": "string", "ready_to_merge": true, "responses": [{ "finding_title": "string", "disposition": "string", "action": "string" }] }. ' +
+    'ready_to_merge должен быть boolean, а responses всегда должен быть массивом объектов. ' +
     "Затем запиши производную markdown-версию в {review_reply_file}.";
 export const REVIEW_SUMMARY_PROMPT_TEMPLATE = "Посмотри в {review_file}. " +
     "Сделай краткий список комментариев без подробностей, 3-7 пунктов. " +
@@ -61,12 +95,18 @@ export const REVIEW_FIX_PROMPT_TEMPLATE = "Используй только ст
     "Исправь то, что содержится в дополнительных указаниях, а если таковых нет - исправь все пункты. " +
     "По окончании обязательно прогони вне песочницы линтер, все тесты, сгенерируй make swagger. " +
     "Исправь ошибки линтера и тестов, если будут. " +
-    "По завершении сначала запиши структурированный отчёт в {review_fix_json_file} в виде объекта { summary: string, completed_actions: string[], validation_steps: string[] }, затем производную markdown-версию в {review_fix_file}.";
+    'По завершении сначала запиши структурированный отчёт в {review_fix_json_file} в виде строго JSON-объекта { "summary": "string", "completed_actions": ["string"], "validation_steps": ["string"] }, затем производную markdown-версию в {review_fix_file}. ' +
+    'completed_actions и validation_steps всегда должны быть массивами строк, даже если пункт только один.';
 export const TASK_SUMMARY_PROMPT_TEMPLATE = "Посмотри в {jira_task_file}. " +
     "Сделай краткое резюме задачи, на 1-2 абзаца. " +
     "Сначала запиши source-of-truth JSON в {task_summary_json_file} в виде объекта { summary: string }, затем markdown-версию в {task_summary_file}.";
-export const RUN_GO_TESTS_LOOP_FIX_PROMPT_TEMPLATE = "Запусти ./run_go_tests.sh, проанализируй последнюю ошибку проверки, исправь код и подготовь изменения так, чтобы следующий прогон run_go_tests.sh прошёл успешно.";
-export const RUN_GO_LINTER_LOOP_FIX_PROMPT_TEMPLATE = "Запусти ./run_go_linter.sh, проанализируй последнюю ошибку линтера или генерации, исправь код и подготовь изменения так, чтобы следующий прогон run_go_linter.sh прошёл успешно.";
+export const JIRA_DESCRIPTION_PROMPT_TEMPLATE = "Посмотри задачу в {jira_task_file}. " +
+    "Проанализируй код и оформи краткое описание для Jira, упомяни ключевые точки, модели данных, сервисы, REST-методы. " +
+    "Сначала запиши source-of-truth JSON в {jira_description_json_file} в виде объекта { summary: string }, затем markdown-версию в {jira_description_file}.";
+export const RUN_GO_TESTS_LOOP_FIX_PROMPT_TEMPLATE = "Используй структурированный результат последнего запуска run_go_tests.py из {tests_result_json_file} как source of truth. " +
+    "Проанализируй последнюю ошибку проверки, исправь код и подготовь изменения так, чтобы следующий прогон run_go_tests.py прошёл успешно.";
+export const RUN_GO_LINTER_LOOP_FIX_PROMPT_TEMPLATE = "Используй структурированный результат последнего запуска run_go_linter.py из {linter_result_json_file} как source of truth. " +
+    "Проанализируй последнюю ошибку линтера или генерации, исправь код и подготовь изменения так, чтобы следующий прогон run_go_linter.py прошёл успешно.";
 export const AUTO_REVIEW_FIX_EXTRA_PROMPT = "Исправлять только блокеры, критикалы и важные";
 export function formatTemplate(template, values) {
     let result = template;

package/dist/scope.js

@@ -35,10 +35,7 @@ export function sanitizeScopeName(value) {
 }
 export function detectGitBranchName() {
     const branchName = gitOutput(["rev-parse", "--abbrev-ref", "HEAD"]);
-    if (!branchName) {
-        return null;
-    }
-    if (branchName === "HEAD") {
+    if (!branchName || branchName === "HEAD") {
         return null;
     }
     return branchName;
@@ -66,30 +63,42 @@ export function buildProjectScopeKey(explicitScope) {
         projectRoot,
     };
 }
-export function resolveTaskScope(jiraRef, explicitScope) {
-    const jiraIssueKey = extractIssueKey(jiraRef);
-    const scopeKey = explicitScope?.trim() ? sanitizeScopeName(explicitScope) : jiraIssueKey;
-    ensureScopeWorkspaceDir(scopeKey);
+export function parseJiraContext(jiraRef) {
     return {
-        scopeType: "task",
-        scopeKey,
         jiraRef,
-        jiraIssueKey,
+        jiraIssueKey: extractIssueKey(jiraRef),
         jiraBrowseUrl: buildJiraBrowseUrl(jiraRef),
         jiraApiUrl: buildJiraApiUrl(jiraRef),
-        jiraTaskFile: jiraTaskFile(scopeKey),
     };
 }
-export function resolveProjectScope(explicitScope) {
+export function resolveProjectScope(explicitScope, jiraRef) {
     const { scopeKey, gitBranchName, worktreeHash, projectRoot } = buildProjectScopeKey(explicitScope);
     ensureScopeWorkspaceDir(scopeKey);
-    return {
+    const baseScope = {
         scopeType: "project",
         scopeKey,
         gitBranchName,
         worktreeHash,
         projectRoot,
     };
+    if (!jiraRef?.trim()) {
+        return baseScope;
+    }
+    const jiraContext = parseJiraContext(jiraRef);
+    return {
+        ...baseScope,
+        ...jiraContext,
+        jiraTaskFile: jiraTaskFile(scopeKey),
+    };
+}
+export function attachJiraContext(scope, jiraRef) {
+    const jiraContext = parseJiraContext(jiraRef);
+    ensureScopeWorkspaceDir(scope.scopeKey);
+    return {
+        ...scope,
+        ...jiraContext,
+        jiraTaskFile: jiraTaskFile(scope.scopeKey),
+    };
 }
 export function buildJiraTaskInputForm() {
     return {
@@ -108,11 +117,11 @@ export function buildJiraTaskInputForm() {
         ],
     };
 }
-export async function requestTaskScope(requestUserInput) {
+export async function requestJiraContext(requestUserInput) {
     const result = await requestUserInput(buildJiraTaskInputForm());
     const jiraRef = String(result.values.jira_ref ?? "").trim();
     if (!jiraRef) {
         throw new TaskRunnerError("Jira issue key or browse URL is required.");
     }
-    return resolveTaskScope(jiraRef);
+    return parseJiraContext(jiraRef);
 }