agentweaver 0.1.10 → 0.1.11

package/dist/prompts.js

@@ -1,113 +1,107 @@
-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-артефактов для пользователя, а не как краткое summary. " +
-    "Markdown не должен влиять на структуру JSON: сначала определи корректные JSON-типы, затем строй markdown как производное представление. " +
-    "Не схлопывай конкретику из задачи и attachment: сохраняй явные файлы, методы, API, инварианты, migration steps, DB-ограничения, business rules и acceptance criteria. " +
-    "Разработай системный дизайн решения и запиши JSON в {design_json_file}, затем markdown в {design_file}. " +
-    'Для {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} используй строго 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} используй строго 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-артефактов для пользователя. " +
-    "Запиши структурированный анализ бага в {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} используй строго 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}. " +
-    "Используй план реализации из {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 = "Проведи код-ревью текущих изменений. " +
-    "Используй только структурированные артефакты как source of truth: задачу в {jira_task_file}, дизайн в {design_json_file} и план в {plan_json_file}. " +
-    'Сначала запиши структурированный результат в {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} в виде строго 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} в виде строго 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} в виде строго 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 пунктов. " +
-    "Запиши результат в {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 = "Используй только структурированные артефакты как source of truth. " +
-    "Проанализируй комментарии в {review_reply_json_file}. " +
-    "Исправь то, что содержится в дополнительных указаниях, а если таковых нет - исправь все пункты. " +
-    "По окончании обязательно прогони вне песочницы линтер, все тесты, сгенерируй make swagger. " +
-    "Исправь ошибки линтера и тестов, если будут. " +
-    'По завершении сначала запиши структурированный отчёт в {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 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 = "Исправлять только блокеры, критикалы и важные";
+import { renderStructuredArtifactSchema, } from "./structured-artifact-schema-registry.js";
+export const BASE_PROMPT_HEADER = "Primary task:";
+export const EXTRA_PROMPT_HEADER = "Additional instructions:";
+export const STRUCTURED_JSON_LANGUAGE_INSTRUCTION = "All structured JSON artifacts are machine-readable and must use English for all generated semantic string values. " +
+    "If a JSON artifact needs to preserve verbatim user-provided or external source text, keep that quoted source text unchanged, but write all generated summaries, titles, descriptions, decisions, and explanations in English. ";
+function strictSchemaInstruction(outputFileVar, schemaId) {
+    return (`The artifact format for ${outputFileVar} must fully conform to schema ${schemaId} from the registry. ` +
+        "Do not skip required fields, do not rename fields, do not change types, do not replace arrays with objects or strings, and do not leave required strings empty. " +
+        "The final JSON must pass validation against this schema without manual corrections. " +
+        STRUCTURED_JSON_LANGUAGE_INSTRUCTION +
+        `Canonical schema:\n${renderStructuredArtifactSchema(schemaId)}\n`);
+}
+export const PLAN_PROMPT_TEMPLATE = "Review and analyze the task in {jira_task_file}. " +
+    "Be sure to analyze additional materials from Jira attachments manifest {jira_attachments_manifest_file} and text context {jira_attachments_context_file}; if an attachment contains more detailed requirements, constraints, file lists, migration strategy, or invariants, treat the attachment as source of truth for planning alongside the Jira issue. " +
+    "First create structured JSON artifacts - they are the source of truth for subsequent flows. " +
+    "Create human-readable markdown files as detailed derivative representations of these JSON artifacts for the user, not as brief summaries. " +
+    "Markdown should not influence JSON structure: first determine the correct JSON types, then build markdown as a derivative representation. " +
+    "Do not collapse specifics from the task and attachments: preserve explicit files, methods, APIs, invariants, migration steps, DB constraints, business rules, and acceptance criteria. " +
+    "Develop a system design for the solution and write JSON to {design_json_file}, then markdown to {design_file}. " +
+    strictSchemaInstruction("{design_json_file}", "implementation-design/v1") +
+    "Develop a detailed implementation plan and write JSON to {plan_json_file}, then markdown to {plan_file}. " +
+    strictSchemaInstruction("{plan_json_file}", "implementation-plan/v1") +
+    "Develop a QA test plan and write JSON to {qa_json_file}, then markdown to {qa_file}. " +
+    strictSchemaInstruction("{qa_json_file}", "qa-plan/v1") +
+    "Format markdown for design and plan comprehensively, with separate sections for Summary, Current State, Target State, Affected Code, Decisions, Migration/DB Changes, Risks, Implementation Steps, Tests, Rollout. " +
+    "JSON files must be valid and contain only JSON without markdown wrapping. ";
+export const PLAN_QUESTIONS_PROMPT_TEMPLATE = "Review and analyze the task in {jira_task_file}. " +
+    "Be sure to analyze additional materials from Jira attachments manifest {jira_attachments_manifest_file} and text context {jira_attachments_context_file}; if an attachment contains more detailed requirements, constraints, file lists, migration strategy, or invariants, treat the attachment as source of truth for planning alongside the Jira issue. " +
+    "Before final planning, determine if any clarifications are needed from the user. " +
+    strictSchemaInstruction("{planning_questions_json_file}", "planning-questions/v1") +
+    "Ask only questions without which the design/plan could be incorrect or too speculative. " +
+    "Do not ask obvious, decorative, or duplicate questions. " +
+    "Usually 1-5 questions are sufficient. " +
+    "The JSON file must be valid and contain only JSON without markdown wrapping. ";
+export const BUG_ANALYZE_PROMPT_TEMPLATE = "Review and analyze the bug in {jira_task_file}. " +
+    "First create structured JSON artifacts - they are the source of truth for subsequent flows. " +
+    "Create human-readable markdown files as brief derivative representations of these JSON artifacts for the user. " +
+    "Write structured bug analysis to {bug_analyze_json_file}, then a brief markdown version to {bug_analyze_file}. " +
+    "Write structured fix design to {bug_fix_design_json_file}, then a brief markdown version to {bug_fix_design_file}. " +
+    "Write structured implementation plan to {bug_fix_plan_json_file}, then a brief markdown version to {bug_fix_plan_file}. " +
+    "JSON files must be valid and contain only JSON without markdown wrapping. " +
+    strictSchemaInstruction("{bug_analyze_json_file}", "bug-analysis/v1") +
+    strictSchemaInstruction("{bug_fix_design_json_file}", "bug-fix-design/v1") +
+    strictSchemaInstruction("{bug_fix_plan_json_file}", "bug-fix-plan/v1");
+export const BUG_FIX_PROMPT_TEMPLATE = "Use only structured artifacts as source of truth. " +
+    "Analyze the bug from {bug_analyze_json_file}. " +
+    "Use the fix design from {bug_fix_design_json_file}. " +
+    "Use the implementation plan from {bug_fix_plan_json_file}. " +
+    "Markdown artifacts are intended only for human reading and should not define the implementation. " +
+    "After that, proceed to implement the fix in code. ";
+export const MR_DESCRIPTION_PROMPT_TEMPLATE = "Review the task in {jira_task_file} and the current changes in the repository. " +
+    "Prepare a very brief intent description for the merge request without implementation details, file lists, or technical details. " +
+    `First write the source-of-truth JSON to {mr_description_json_file}. ${strictSchemaInstruction("{mr_description_json_file}", "mr-description/v1")}Then write the derivative markdown version to {mr_description_file}. `;
+export const IMPLEMENT_PROMPT_TEMPLATE = "Use only structured artifacts as source of truth. " +
+    "Analyze the system design {design_json_file}, implementation plan {plan_json_file}, and proceed with implementation according to the plan. " +
+    "Markdown artifacts are intended only for human reading and should not define the implementation. ";
+export const REVIEW_PROMPT_TEMPLATE = "Conduct a code review of the current changes. " +
+    "Use only structured artifacts as source of truth: the task in {jira_task_file}, design in {design_json_file}, and plan in {plan_json_file}. " +
+    `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 preventing merge - create the ready-to-merge.md file.";
+export const REVIEW_PROJECT_PROMPT_TEMPLATE = "Conduct a code review of current changes in the project without Jira context. " +
+    "Evaluate the quality of changes based on current code, tests, regression risks, and overall engineering quality. " +
+    `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_DIFF_REVIEW_PROMPT_TEMPLATE = "Conduct a code review of the GitLab merge request diff. " +
+    "Use the structured diff artifact {gitlab_diff_json_file} as source of truth, and markdown {gitlab_diff_file} only as a convenient human-readable representation. " +
+    "Evaluate only the changes from the diff: correctness, regression risks, missing tests, dangerous edge cases, contract violations, and maintainability. " +
+    `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 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}.";
+export const REVIEW_FIX_PROMPT_TEMPLATE = "Use only structured artifacts as source of truth. " +
+    "Analyze the findings in {review_json_file}. " +
+    "Fix what is contained in the additional instructions, and if there are none - fix all items. " +
+    "After completion, be sure to run the linter outside the sandbox, all tests, generate make swagger. " +
+    "Fix any linter and test errors if they occur. " +
+    `Upon completion, first write the structured report to {review_fix_json_file}. ${strictSchemaInstruction("{review_fix_json_file}", "review-fix-report/v1")}Then write the derivative markdown version to {review_fix_file}.`;
+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}. " +
+    "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. " +
+    `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.";
+export const RUN_GO_LINTER_LOOP_FIX_PROMPT_TEMPLATE = "Use the structured result of the last run of run_go_linter.py from {linter_result_json_file} as source of truth. " +
+    "Analyze the last linter or generation error, fix the code, and prepare changes so that the next run of run_go_linter.py succeeds.";
+export const COMMIT_MESSAGE_PROMPT_TEMPLATE = "Generate a commit message for the current changes. " +
+    "Task context (Jira): {jira_task_file}. " +
+    "Current changes (git diff): {git_diff_file}. " +
+    "List of changed files: {git_status_json_file}. " +
+    "Rules: " +
+    "1) Subject line ≤72 characters. " +
+    "2) Format: {taskKey}: {taskDescription} (e.g., DEMO-1234: Add user authentication). " +
+    "3) Include task key from Jira task. " +
+    "4) Commit message language: English. " +
+    "5) Write JSON to {commit_message_json_file}: {\"subject\": \"...\"}.";
+export const AUTO_REVIEW_FIX_EXTRA_PROMPT = "Fix only blockers, criticals, and important issues";
 export function formatTemplate(template, values) {
     let result = template;
     for (const [key, value] of Object.entries(values)) {

package/dist/runtime/agentweaver-home.js

@@ -0,0 +1,8 @@
+import path from "node:path";
+export function agentweaverHome(packageRoot) {
+    const configured = process.env.AGENTWEAVER_HOME?.trim();
+    if (configured) {
+        return path.resolve(configured);
+    }
+    return packageRoot;
+}

package/dist/runtime/command-resolution.js

@@ -1,6 +1,5 @@
 import { accessSync, constants } from "node:fs";
 import { spawnSync } from "node:child_process";
-import path from "node:path";
 import { TaskRunnerError } from "../errors.js";
 function splitArgs(input) {
     const result = [];
@@ -100,40 +99,3 @@ export function resolveCmd(commandName, envVarName) {
     }
     throw new TaskRunnerError(`Missing required command: ${commandName}`);
 }
-export function requireDockerCompose() {
-    if (!commandExists("docker")) {
-        throw new TaskRunnerError("Missing required command: docker");
-    }
-    const result = spawnSync("docker", ["compose", "version"], { stdio: "ignore" });
-    if (result.status !== 0) {
-        throw new TaskRunnerError("Missing required docker compose plugin");
-    }
-}
-export function resolveDockerComposeCmd() {
-    const configured = process.env.DOCKER_COMPOSE_BIN?.trim() ?? "";
-    if (configured) {
-        const parts = splitArgs(configured);
-        if (parts.length === 0) {
-            throw new TaskRunnerError("DOCKER_COMPOSE_BIN is set but empty.");
-        }
-        const executable = parts[0] ?? "";
-        try {
-            if (path.isAbsolute(executable)) {
-                accessSync(executable, constants.X_OK);
-                return parts;
-            }
-        }
-        catch {
-            throw new TaskRunnerError(`Configured docker compose command is not executable: ${configured}`);
-        }
-        if (commandExists(executable)) {
-            return parts;
-        }
-        throw new TaskRunnerError(`Configured docker compose command is not executable: ${configured}`);
-    }
-    if (commandExists("docker-compose")) {
-        return ["docker-compose"];
-    }
-    requireDockerCompose();
-    return ["docker", "compose"];
-}

package/dist/runtime/env-loader.js

@@ -0,0 +1,43 @@
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+function parseEnvFile(envFilePath, protectedKeys) {
+    if (!existsSync(envFilePath)) {
+        return;
+    }
+    const lines = readFileSync(envFilePath, "utf8").split(/\r?\n/);
+    for (const rawLine of lines) {
+        let line = rawLine.trim();
+        if (!line || line.startsWith("#")) {
+            continue;
+        }
+        if (line.startsWith("export ")) {
+            line = line.slice(7).trim();
+        }
+        const separatorIndex = line.indexOf("=");
+        if (separatorIndex < 0) {
+            continue;
+        }
+        const key = line.slice(0, separatorIndex).trim();
+        if (!key || protectedKeys.has(key)) {
+            continue;
+        }
+        let value = line.slice(separatorIndex + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        process.env[key] = value;
+    }
+}
+function globalConfigDir() {
+    return path.join(os.homedir(), ".agentweaver");
+}
+function ensureGlobalConfigDir() {
+    mkdirSync(globalConfigDir(), { recursive: true });
+}
+export function loadTieredEnv(projectDir) {
+    ensureGlobalConfigDir();
+    const shellEnvKeys = new Set(Object.keys(process.env));
+    parseEnvFile(path.join(globalConfigDir(), ".env"), shellEnvKeys);
+    parseEnvFile(path.join(projectDir, ".agentweaver", ".env"), shellEnvKeys);
+}

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

@@ -0,0 +1,53 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { TaskRunnerError } from "./errors.js";
+export const STRUCTURED_ARTIFACT_SCHEMA_IDS = [
+    "bug-analysis/v1",
+    "bug-fix-design/v1",
+    "bug-fix-plan/v1",
+    "gitlab-mr-diff/v1",
+    "gitlab-review/v1",
+    "implementation-design/v1",
+    "implementation-plan/v1",
+    "jira-description/v1",
+    "mr-description/v1",
+    "planning-questions/v1",
+    "qa-plan/v1",
+    "review-findings/v1",
+    "review-fix-report/v1",
+    "task-summary/v1",
+    "user-input/v1",
+];
+const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
+export const SCHEMA_REGISTRY_PATH = path.join(MODULE_DIR, "structured-artifact-schemas.json");
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function loadStructuredArtifactSchemaRegistry() {
+    if (!existsSync(SCHEMA_REGISTRY_PATH)) {
+        throw new TaskRunnerError(`Structured artifact schema registry not found: ${SCHEMA_REGISTRY_PATH}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(SCHEMA_REGISTRY_PATH, "utf8"));
+    }
+    catch (error) {
+        throw new TaskRunnerError(`Failed to parse structured artifact schema registry: ${error.message}`);
+    }
+    if (!isRecord(parsed)) {
+        throw new TaskRunnerError(`Structured artifact schema registry ${SCHEMA_REGISTRY_PATH} must be a JSON object.`);
+    }
+    return parsed;
+}
+const schemaRegistry = loadStructuredArtifactSchemaRegistry();
+export function getStructuredArtifactSchema(schemaId) {
+    const schema = schemaRegistry[schemaId];
+    if (!schema) {
+        throw new TaskRunnerError(`Structured artifact schema is not registered: ${schemaId}`);
+    }
+    return schema;
+}
+export function renderStructuredArtifactSchema(schemaId) {
+    return JSON.stringify(getStructuredArtifactSchema(schemaId), null, 2);
+}

package/dist/structured-artifact-schemas.json

@@ -521,26 +521,6 @@
     },
     "required": ["summary", "completed_actions", "validation_steps"]
   },
-  "review-reply/v1": {
-    "type": "object",
-    "properties": {
-      "summary": { "type": "string", "nonEmpty": true },
-      "responses": {
-        "type": "array",
-        "items": {
-          "type": "object",
-          "properties": {
-            "finding_title": { "type": "string", "nonEmpty": true },
-            "disposition": { "type": "string", "nonEmpty": true },
-            "action": { "type": "string", "nonEmpty": true }
-          },
-          "required": ["finding_title", "disposition", "action"]
-        }
-      },
-      "ready_to_merge": { "type": "boolean" }
-    },
-    "required": ["summary", "responses", "ready_to_merge"]
-  },
   "task-summary/v1": {
     "type": "object",
     "properties": {

package/dist/structured-artifacts.js

@@ -1,27 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
 import { TaskRunnerError } from "./errors.js";
-export const STRUCTURED_ARTIFACT_SCHEMA_IDS = [
-    "bug-analysis/v1",
-    "bug-fix-design/v1",
-    "bug-fix-plan/v1",
-    "gitlab-mr-diff/v1",
-    "gitlab-review/v1",
-    "implementation-design/v1",
-    "implementation-plan/v1",
-    "jira-description/v1",
-    "mr-description/v1",
-    "planning-questions/v1",
-    "qa-plan/v1",
-    "review-findings/v1",
-    "review-fix-report/v1",
-    "review-reply/v1",
-    "task-summary/v1",
-    "user-input/v1",
-];
-const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
-const SCHEMA_REGISTRY_PATH = path.join(MODULE_DIR, "structured-artifact-schemas.json");
+import { STRUCTURED_ARTIFACT_SCHEMA_IDS, getStructuredArtifactSchema, } from "./structured-artifact-schema-registry.js";
+export { STRUCTURED_ARTIFACT_SCHEMA_IDS };
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -99,23 +79,6 @@ function validateNode(value, schema, currentPath) {
         }
     }
 }
-function loadSchemaRegistry() {
-    if (!existsSync(SCHEMA_REGISTRY_PATH)) {
-        throw new TaskRunnerError(`Structured artifact schema registry not found: ${SCHEMA_REGISTRY_PATH}`);
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(readFileSync(SCHEMA_REGISTRY_PATH, "utf8"));
-    }
-    catch (error) {
-        throw new TaskRunnerError(`Failed to parse structured artifact schema registry: ${error.message}`);
-    }
-    if (!isRecord(parsed)) {
-        throw new TaskRunnerError(`Structured artifact schema registry ${SCHEMA_REGISTRY_PATH} must be a JSON object.`);
-    }
-    return parsed;
-}
-const schemas = loadSchemaRegistry();
 export function validateStructuredArtifact(path, schemaId) {
     if (!existsSync(path)) {
         throw new TaskRunnerError(`Structured artifact file not found: ${path}`);
@@ -127,10 +90,7 @@ export function validateStructuredArtifact(path, schemaId) {
     catch (error) {
         throw new TaskRunnerError(`Structured artifact ${path} is not valid JSON: ${error.message}`);
     }
-    const schema = schemas[schemaId];
-    if (!schema) {
-        throw new TaskRunnerError(`Structured artifact schema is not registered: ${schemaId}`);
-    }
+    const schema = getStructuredArtifactSchema(schemaId);
     const issues = validateNode(parsed, schema, path);
     if (issues.length > 0) {
         throw new TaskRunnerError(`Structured artifact ${path} failed schema ${schemaId} validation:\n${issues.join("\n")}`);

package/dist/user-input.js

@@ -71,6 +71,16 @@ export function validateUserInputValues(form, values) {
             throw new TaskRunnerError("Select at least one finding or enable 'apply all'.");
         }
     }
+    if (form.formId === "task-describe-source-input") {
+        const jiraRef = typeof values.jira_ref === "string" ? normalizeText(values.jira_ref) : "";
+        const taskDescription = typeof values.task_description === "string" ? normalizeText(values.task_description) : "";
+        if (!jiraRef && !taskDescription) {
+            throw new TaskRunnerError("Provide either Jira URL/key or a short task description.");
+        }
+        if (jiraRef && taskDescription) {
+            throw new TaskRunnerError("Provide either Jira URL/key or a short task description, not both.");
+        }
+    }
 }
 function parseBoolean(value) {
     const normalized = normalizeText(value).toLowerCase();
@@ -120,8 +130,26 @@ export async function requestUserInputInTerminal(form) {
             }
             if (field.type === "text") {
                 const current = String(values[field.id] ?? "");
-                const answer = await rl.question(`${field.label}${current ? ` (${current})` : ""}: `);
-                values[field.id] = answer.trim() ? answer : current;
+                if (field.multiline) {
+                    process.stdout.write(`${field.label}${current ? " (leave empty to keep current value)" : ""}:\n`);
+                    if (field.help?.trim()) {
+                        process.stdout.write(`${field.help.trim()}\n`);
+                    }
+                    process.stdout.write("Finish input with an empty line.\n");
+                    const lines = [];
+                    while (true) {
+                        const line = await rl.question(lines.length === 0 ? "> " : "... ");
+                        if (!line.trim()) {
+                            break;
+                        }
+                        lines.push(line);
+                    }
+                    values[field.id] = lines.length > 0 ? lines.join("\n") : current;
+                }
+                else {
+                    const answer = await rl.question(`${field.label}${current ? ` (${current})` : ""}: `);
+                    values[field.id] = answer.trim() ? answer : current;
+                }
                 continue;
             }
             const options = field.options.map((option, index) => `${index + 1}. ${option.label}`).join("\n");

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "agentweaver",
-  "version": "0.1.10",
-  "description": "CLI orchestrator for Jira/Codex/Claude engineering workflows",
+  "version": "0.1.11",
+  "description": "CLI orchestrator for Jira/Codex engineering workflows",
   "keywords": [
     "agent",
     "cli",
     "jira",
     "codex",
-    "claude",
     "tui",
     "developer-tools"
   ],
@@ -29,9 +28,6 @@
   "files": [
     "dist",
     "README.md",
-    "docker-compose.yml",
-    "Dockerfile.codex",
-    "verify_build.sh",
     "run_go_tests.py",
     "run_go_linter.py",
     "run_go_coverage.sh"