agentweaver 0.1.12 → 0.1.14

package/dist/doctor/runner.js

@@ -0,0 +1,89 @@
+import { DoctorStatus, ReadinessStatus } from "./types.js";
+import { REGISTRY } from "./registry.js";
+import { DoctorOrchestrator } from "./orchestrator.js";
+import { CATEGORY } from "./checks/category.js";
+import "./checks/register.js";
+const STATUS_ICONS = {
+    [DoctorStatus.Ok]: "✓",
+    [DoctorStatus.Warn]: "⚠",
+    [DoctorStatus.Fail]: "✗",
+};
+const READINESS_LABELS = {
+    [ReadinessStatus.Ready]: "Ready",
+    [ReadinessStatus.ReadyWithWarnings]: "Ready with warnings",
+    [ReadinessStatus.NotReady]: "Not ready",
+};
+const CATEGORY_LABELS = {
+    [CATEGORY.SYSTEM]: "System",
+    [CATEGORY.EXECUTORS]: "Executors",
+    [CATEGORY.ENV_DIAGNOSTICS]: "Environment",
+    [CATEGORY.FLOW_READINESS]: "Flow Readiness",
+};
+async function runDoctorCommand(args) {
+    const jsonMode = args.includes("--json");
+    const filter = args.find((arg) => arg !== "--json");
+    const orchestrator = new DoctorOrchestrator();
+    const report = await orchestrator.run(undefined, filter);
+    if (jsonMode) {
+        process.stdout.write(JSON.stringify(report, null, 2));
+        return report.overall === ReadinessStatus.NotReady ? 1 : 0;
+    }
+    const grouped = new Map();
+    for (const result of report.checks) {
+        const check = REGISTRY.getById(result.id);
+        const cat = check?.category ?? "unknown";
+        if (!grouped.has(cat)) {
+            grouped.set(cat, []);
+        }
+        grouped.get(cat).push(result);
+    }
+    const categoryOrder = [
+        CATEGORY.SYSTEM,
+        CATEGORY.EXECUTORS,
+        CATEGORY.ENV_DIAGNOSTICS,
+        CATEGORY.FLOW_READINESS,
+    ];
+    for (const cat of categoryOrder) {
+        const items = grouped.get(cat);
+        if (!items || items.length === 0)
+            continue;
+        const label = CATEGORY_LABELS[cat] ?? cat;
+        console.log(`## ${label}`);
+        console.log();
+        for (const result of items) {
+            const icon = STATUS_ICONS[result.status];
+            const line = `[${icon}] ${result.title} - ${result.message}`;
+            console.log(line);
+            if (result.hint) {
+                console.log(`  Hint: ${result.hint}`);
+            }
+            if (result.details) {
+                console.log(`  Details: ${result.details}`);
+            }
+        }
+        console.log();
+    }
+    for (const [cat, items] of grouped) {
+        if (categoryOrder.includes(cat))
+            continue;
+        const label = CATEGORY_LABELS[cat] ?? cat;
+        console.log(`## ${label}`);
+        console.log();
+        for (const result of items) {
+            const icon = STATUS_ICONS[result.status];
+            const line = `[${icon}] ${result.title} - ${result.message}`;
+            console.log(line);
+            if (result.hint) {
+                console.log(`  Hint: ${result.hint}`);
+            }
+            if (result.details) {
+                console.log(`  Details: ${result.details}`);
+            }
+        }
+        console.log();
+    }
+    console.log(`Overall: ${READINESS_LABELS[report.overall]}`);
+    console.log(`Timestamp: ${report.timestamp}`);
+    return report.overall === ReadinessStatus.NotReady ? 1 : 0;
+}
+export { runDoctorCommand };

package/dist/doctor/types.js

@@ -0,0 +1,12 @@
+export var DoctorStatus;
+(function (DoctorStatus) {
+    DoctorStatus["Ok"] = "ok";
+    DoctorStatus["Warn"] = "warn";
+    DoctorStatus["Fail"] = "fail";
+})(DoctorStatus || (DoctorStatus = {}));
+export var ReadinessStatus;
+(function (ReadinessStatus) {
+    ReadinessStatus["Ready"] = "ready";
+    ReadinessStatus["ReadyWithWarnings"] = "ready_with_warnings";
+    ReadinessStatus["NotReady"] = "not_ready";
+})(ReadinessStatus || (ReadinessStatus = {}));

package/dist/index.js

@@ -23,6 +23,7 @@ import { runCommand } from "./runtime/process-runner.js";
 import { InteractiveUi } from "./interactive-ui.js";
 import { bye, printError, printInfo, printPanel, printSummary, setFlowExecutionState, stripAnsi, } from "./tui.js";
 import { requestUserInputInTerminal } from "./user-input.js";
+import { runDoctorCommand } from "./doctor/index.js";
 import { attachJiraContext, detectGitBranchName, requestJiraContext, resolveProjectScope, } from "./scope.js";
 const COMMANDS = [
     "auto-golang",
@@ -31,6 +32,7 @@ const COMMANDS = [
     "auto-reset",
     "bug-analyze",
     "bug-fix",
+    "doctor",
     "git-commit",
     "gitlab-diff-review",
     "gitlab-review",
@@ -82,7 +84,7 @@ function formatProcessFailure(error) {
     if (!preview) {
         return baseMessage;
     }
-    return `${baseMessage}\nПричина:\n${preview}`;
+    return `${baseMessage}\nReason:\n${preview}`;
 }
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -97,6 +99,7 @@ function usage() {
   agentweaver gitlab-review [--dry] [--verbose] [--prompt <text>] [--scope <name>]
   agentweaver bug-analyze [--dry] [--verbose] [--prompt <text>] <jira-browse-url|jira-issue-key>
   agentweaver bug-fix [--dry] [--verbose] [--prompt <text>] <jira-browse-url|jira-issue-key>
+  agentweaver doctor [<category>|<check-id>] [--json]
   agentweaver mr-description [--dry] [--verbose] [--prompt <text>] <jira-browse-url|jira-issue-key>
   agentweaver plan [--dry] [--verbose] [--prompt <text>] [--md-lang <en|ru>] [<jira-browse-url|jira-issue-key>]
   agentweaver task-describe [--dry] [--verbose] [--prompt <text>] [<jira-browse-url|jira-issue-key>]
@@ -185,8 +188,8 @@ function launchProfileSelectionForm() {
     const defaultExecutor = DEFAULT_LAUNCH_PROFILE.executor;
     return {
         formId: "flow-launch-profile",
-        title: "Настройки запуска LLM",
-        description: `Выберите executor для запуска flow. Текущий default: ${defaultExecutor}.`,
+        title: "LLM Launch Settings",
+        description: `Select an executor for the flow. Current default: ${defaultExecutor}.`,
         submitLabel: "Continue",
         fields: [
             {
@@ -212,8 +215,8 @@ function launchModelSelectionForm(executor) {
     }));
     return {
         formId: "flow-launch-model",
-        title: "Настройки запуска LLM",
-        description: `Выберите модель для запуска flow. Текущий default для ${resolvedExecutor}: ${defaultModel}.`,
+        title: "LLM Launch Settings",
+        description: `Select a model for the flow. Current default for ${resolvedExecutor}: ${defaultModel}.`,
         submitLabel: "Start",
         fields: [
             {
@@ -434,6 +437,7 @@ function buildBaseConfig(command, options = {}) {
         mdLang: options.mdLang ?? null,
         dryRun: options.dryRun ?? false,
         verbose: options.verbose ?? false,
+        ...(options.doctorArgs !== undefined ? { doctorArgs: options.doctorArgs } : {}),
     };
 }
 function commandRequiresTask(command) {
@@ -521,32 +525,12 @@ function autoFlowParams(config, forceRefreshSummary = false) {
         runGoLinterIteration: nextArtifactIteration(config.taskKey, "run-go-linter-result", "json"),
     };
 }
-const FLOW_DESCRIPTIONS = {
-    "auto-golang": "Full task pipeline: planning, implementation, checks, review, review replies, and repeated iterations until ready to merge.",
-    "bug-analyze": "Analyzes bug from Jira and creates structured artifacts: root cause hypothesis, fix design, and implementation plan.",
-    "git-commit": "Collects git status/diff, generates commit message via LLM, allows file selection and commit confirmation.",
-    "gitlab-diff-review": "Requests GitLab MR URL via user-input, downloads merge request diff via API, and runs code review with markdown and structured JSON artifacts.",
-    "gitlab-review": "Requests GitLab MR URL via user-input, downloads code review comments via API, assesses which findings are fair and proposes fixes, then runs review-fix for the selected findings.",
-    "bug-fix": "Takes bug-analyze results as source of truth and implements the bug fix in code.",
-    "mr-description": "Prepares a brief intent description for a merge request based on the task and current changes.",
-    plan: "Loads task from Jira and creates design, implementation plan, and QA plan in structured JSON and markdown.",
-    "task-describe": "Builds a brief task description either from Jira or from quick user-input without Jira.",
-    implement: "Implements the task from approved design/plan artifacts and runs post-verify builds if needed.",
-    review: "Runs code review of current changes and writes structured findings artifacts.",
-    "review-fix": "Fixes issues after review-reply, updates code, and runs mandatory checks after modifications.",
-    "review-loop": "Iteratively runs review and review-fix cycles up to 5 times until ready-to-merge is achieved.",
-    "run-go-tests-loop": "Cycles through `./run_go_tests.py` locally, analyzes the last error, and fixes code until successful or attempts exhausted.",
-    "run-go-linter-loop": "Cycles through `./run_go_linter.py` locally, fixes linter or generation issues, and retries until success.",
-};
-function flowDescription(id) {
-    return FLOW_DESCRIPTIONS[id] ?? "Описание для этого flow пока не задано.";
-}
 function interactiveFlowDefinition(entry) {
     const flow = entry.flow;
     return {
         id: entry.id,
         label: entry.id,
-        description: flowDescription(entry.id),
+        description: flow.description ?? "No description available for this flow.",
         source: entry.source,
         treePath: [...entry.treePath],
         ...(entry.source === "project-local" ? { sourcePath: entry.absolutePath } : {}),
@@ -755,6 +739,10 @@ function requireJiraConfig(config) {
     }
 }
 async function executeCommand(baseConfig, runFollowupVerify = true, requestUserInput = requestUserInputInTerminal, resolvedScope, setSummary, forceRefreshSummary = false, launchMode = "restart", launchProfile, runtime = runtimeServices) {
+    if (baseConfig.command === "doctor") {
+        const exitCode = await runDoctorCommand(baseConfig.doctorArgs ?? []);
+        return exitCode === 0;
+    }
     const config = buildRuntimeConfig(baseConfig, resolvedScope ?? (await resolveScopeForCommand(baseConfig, requestUserInput)));
     if (config.command === "auto-golang") {
         requireJiraConfig(config);
@@ -1058,6 +1046,7 @@ function parseCliArgs(argv) {
     let helpPhases = false;
     let jiraRef;
     let mdLang;
+    const doctorArgs = [];
     for (let index = 1; index < argv.length; index += 1) {
         const token = argv[index] ?? "";
         if (token === "--dry") {
@@ -1110,7 +1099,12 @@ function parseCliArgs(argv) {
             }
             continue;
         }
-        jiraRef = token;
+        if (command === "doctor") {
+            doctorArgs.push(token);
+        }
+        else {
+            jiraRef = token;
+        }
     }
     if (command === "auto-golang" && helpPhases) {
         printAutoPhasesHelp();
@@ -1130,6 +1124,7 @@ function parseCliArgs(argv) {
         ...(prompt !== undefined ? { prompt } : {}),
         ...(autoFromPhase !== undefined ? { autoFromPhase } : {}),
         ...(mdLang !== undefined ? { mdLang } : {}),
+        ...(doctorArgs.length > 0 ? { doctorArgs } : {}),
     };
 }
 function buildConfigFromArgs(args) {
@@ -1141,6 +1136,7 @@ function buildConfigFromArgs(args) {
         ...(args.mdLang !== undefined ? { mdLang: args.mdLang } : {}),
         dryRun: args.dry,
         verbose: args.verbose,
+        ...(args.doctorArgs !== undefined ? { doctorArgs: args.doctorArgs } : {}),
     });
 }
 async function runInteractive(jiraRef, forceRefresh = false, scopeName) {

package/dist/interactive-ui.js

@@ -213,7 +213,7 @@ export class InteractiveUi {
             top: 3,
             left: 0,
             width: "34%",
-            height: "50%-1",
+            height: "50%-4",
             tags: true,
             label: " Current Flow ",
             padding: {
@@ -232,10 +232,10 @@ export class InteractiveUi {
         });
         this.flowList = blessed.list({
             parent: this.screen,
-            top: "50%+2",
+            top: "50%-1",
             left: 0,
             width: "34%",
-            bottom: 11,
+            bottom: 14,
             keys: true,
             vi: true,
             mouse: true,
@@ -395,7 +395,7 @@ export class InteractiveUi {
             bottom: 6,
             left: 0,
             width: "34%",
-            height: 5,
+            height: 8,
             tags: true,
             label: " Flow Description ",
             padding: {
@@ -806,19 +806,19 @@ export class InteractiveUi {
         this.help.setContent(renderMarkdownToTerminal([
             "AgentWeaver interactive mode",
             "",
-            "Клавиши:",
-            "Up / Down    выбрать папку или flow",
-            "Right        раскрыть папку",
-            "Left         свернуть папку или перейти к родителю",
-            "Enter        раскрыть папку или открыть запуск flow",
-            "Enter        подтвердить запуск в модалке",
-            "Esc          закрыть help/модалку или прервать running flow",
-            "F1           открыть или закрыть help",
-            "Tab          переключить pane",
-            "Ctrl+L       очистить лог",
-            "q / Ctrl+C   выйти",
+            "Keys:",
+            "Up / Down    select folder or flow",
+            "Right        expand folder",
+            "Left         collapse folder or go to parent",
+            "Enter        expand folder or launch flow",
+            "Enter        confirm launch in modal",
+            "Esc          close help/modal or interrupt running flow",
+            "F1           open or close help",
+            "Tab          switch pane",
+            "Ctrl+L       clear log",
+            "q / Ctrl+C   exit",
             "",
-            "Доступные flow:",
+            "Available flows:",
             ...this.options.flows.map((flow) => flow.treePath.join("/")),
         ].join("\n")));
         this.footer.setContent(" Up/Down: select | Left/Right: fold | Enter: toggle/run | Esc: close/interrupt | h: help | Tab: switch pane | q: exit ");
@@ -1522,20 +1522,20 @@ export class InteractiveUi {
         if (selectedItem.kind === "folder") {
             const kindLabel = selectedItem.pathSegments[0] === "custom" ? "project-local" : "built-in";
             const folderDescription = [
-                `Папка flow \`${selectedItem.pathSegments.join("/")}\`.`,
+                `Flow folder \`${selectedItem.pathSegments.join("/")}\`.`,
                 "",
-                `Источник: ${kindLabel}`,
-                `Статус: ${this.expandedFlowFolders.has(selectedItem.key) ? "развёрнута" : "свёрнута"}`,
+                `Source: ${kindLabel}`,
+                `State: ${this.expandedFlowFolders.has(selectedItem.key) ? "expanded" : "collapsed"}`,
             ].join("\n");
             this.description.setContent(renderMarkdownToTerminal(stripAnsi(folderDescription)));
             return;
         }
         const { flow } = selectedItem;
-        const description = flow.description?.trim() || "Описание для этого flow пока не задано.";
+        const description = flow.description?.trim() || "No description available for this flow.";
         const details = [
-            `Путь: ${flow.treePath.join("/")}`,
-            `Источник: ${flow.source === "project-local" ? "project-local" : "built-in"}`,
-            flow.source === "project-local" && flow.sourcePath ? `Файл: ${flow.sourcePath}` : "",
+            `Path: ${flow.treePath.join("/")}`,
+            `Source: ${flow.source === "project-local" ? "project-local" : "built-in"}`,
+            flow.source === "project-local" && flow.sourcePath ? `File: ${flow.sourcePath}` : "",
         ]
             .filter((line) => line.length > 0)
             .join("\n");
@@ -1579,7 +1579,7 @@ export class InteractiveUi {
     renderProgress() {
         const flow = this.progressFlowDefinition();
         if (!flow) {
-            this.progress.setContent("Выберите конкретный flow в дереве, чтобы увидеть его прогресс.");
+            this.progress.setContent("Select a flow in the tree to see its progress.");
             return;
         }
         const flowState = this.flowState.flowId === flow.id
@@ -1932,7 +1932,7 @@ export class InteractiveUi {
             flowId,
             resumeAvailable: true,
             hasExistingState: true,
-            details: "Текущий flow будет остановлен. Состояние сохранится, и его можно будет продолжить через Resume.",
+            details: "The current flow will be stopped. State will be saved and can be continued via Resume.",
             selectedAction: "stop",
         };
         this.renderConfirm();

package/dist/pipeline/declarative-flows.js

@@ -28,6 +28,7 @@ export function loadDeclarativeFlow(flow) {
     const loaded = {
         kind: spec.kind,
         version: spec.version,
+        ...(spec.description !== undefined ? { description: spec.description } : {}),
         constants: spec.constants ?? {},
         phases,
         source: ref.source,

package/dist/pipeline/flow-specs/auto-common.json

@@ -1,6 +1,7 @@
 {
   "kind": "auto-flow",
   "version": 1,
+  "description": "End-to-end resumable pipeline without language-specific checks. Runs: plan (with Jira fetch and Q&A) → implement → review loop. Simplified alternative to auto-golang for projects that do not need Go linter/test loops.",
   "phases": [
     {
       "id": "plan",

package/dist/pipeline/flow-specs/auto-golang.json

@@ -1,8 +1,9 @@
 {
   "kind": "auto-flow",
   "version": 1,
+  "description": "End-to-end resumable pipeline for Go projects. Runs the full sequence: plan (with Jira fetch and Q&A) → implement → linter loop → test loop → review loop → final linter loop → final test loop. Supports --from to restart from a specific phase and auto-status/auto-reset for state management.",
   "constants": {
-    "autoReviewFixExtraPrompt": "Исправлять только блокеры, критикалы и важные"
+    "autoReviewFixExtraPrompt": "Fix only blockers, criticals, and important findings"
   },
   "phases": [
     {

package/dist/pipeline/flow-specs/bugz/bug-analyze.json

@@ -1,6 +1,7 @@
 {
   "kind": "bug-analyze-flow",
   "version": 1,
+  "description": "Fetches a Bug-type Jira issue, validates the issue type, generates or reuses a cached task summary, and produces structured bug analysis: root cause hypothesis, fix design, and step-by-step fix plan.",
   "phases": [
     {
       "id": "bug_analyze",

package/dist/pipeline/flow-specs/bugz/bug-fix.json

@@ -1,6 +1,7 @@
 {
   "kind": "bug-fix-flow",
   "version": 1,
+  "description": "Applies the fix designed in bug-analyze. Uses the root cause hypothesis, fix design, and fix plan artifacts as the source of truth to implement code changes locally.",
   "phases": [
     {
       "id": "bug_fix",

package/dist/pipeline/flow-specs/git-commit.json

@@ -1,6 +1,7 @@
 {
   "kind": "git-commit-flow",
   "version": 1,
+  "description": "Four-phase commit workflow: collects git status and diff, generates a commit message via LLM, presents a file selection form, then shows the editable message for confirmation and executes the commit.",
   "phases": [
     {
       "id": "collect_status",

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

@@ -1,6 +1,7 @@
 {
   "kind": "gitlab-diff-review-flow",
   "version": 1,
+  "description": "Prompts for a GitLab merge request URL, fetches the MR diff via GitLab API, and runs LLM-backed code review producing structured findings with severity levels and a ready-to-merge verdict.",
   "phases": [
     {
       "id": "gitlab_diff_review",
@@ -11,14 +12,14 @@
           "params": {
             "formId": { "const": "gitlab-diff-review-input" },
             "title": { "const": "GitLab Diff Review" },
-            "description": { "const": "Укажи ссылку на GitLab merge request, чтобы загрузить diff и запустить код-ревью." },
+            "description": { "const": "Provide a GitLab merge request URL to fetch the diff and run code review." },
             "fields": {
               "const": [
                 {
                   "id": "merge_request_url",
                   "type": "text",
                   "label": "GitLab MR URL",
-                  "help": "Например: https://gitlab.example.com/group/project/-/merge_requests/123",
+                  "help": "Example: https://gitlab.example.com/group/project/-/merge_requests/123",
                   "required": true,
                   "placeholder": "https://gitlab.example.com/group/project/-/merge_requests/123"
                 }

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

@@ -1,6 +1,7 @@
 {
   "kind": "gitlab-review-flow",
   "version": 1,
+  "description": "Prompts for a GitLab merge request URL, fetches existing code review comments via GitLab API, assesses which findings are fair and which can be dismissed, then runs review-fix to apply fixes for the accepted findings.",
   "phases": [
     {
       "id": "gitlab_review",
@@ -11,14 +12,14 @@
           "params": {
             "formId": { "const": "gitlab-review-input" },
             "title": { "const": "GitLab Review" },
-            "description": { "const": "Укажи ссылку на GitLab merge request, чтобы загрузить комментарии код-ревью." },
+            "description": { "const": "Provide a GitLab merge request URL to fetch code review comments." },
             "fields": {
               "const": [
                 {
                   "id": "merge_request_url",
                   "type": "text",
                   "label": "GitLab MR URL",
-                  "help": "Например: https://gitlab.example.com/group/project/-/merge_requests/123",
+                  "help": "Example: https://gitlab.example.com/group/project/-/merge_requests/123",
                   "required": true,
                   "placeholder": "https://gitlab.example.com/group/project/-/merge_requests/123"
                 }

package/dist/pipeline/flow-specs/gitlab/mr-description.json

@@ -1,6 +1,7 @@
 {
   "kind": "mr-description-flow",
   "version": 1,
+  "description": "Generates a concise merge request description based on the task context and current code changes. Produces both markdown and structured JSON artifacts.",
   "phases": [
     {
       "id": "mr_description",

package/dist/pipeline/flow-specs/go/run-go-linter-loop.json

@@ -1,6 +1,7 @@
 {
   "kind": "run-go-linter-loop-flow",
   "version": 1,
+  "description": "Runs run_go_linter.py and analyzes output. If the linter reports issues, sends them to LLM for a fix and retries. Repeats up to 5 attempts, stopping early on success. Asserts success after the final attempt.",
   "phases": [
     {
       "id": "run_go_linter_try_1",
@@ -70,7 +71,7 @@
               "appendPrompt": {
                 "base": { "ref": "params.extraPrompt" },
                 "suffix": {
-                  "template": "Последний результат run_go_linter.py сохранён в {result_file}. exitCode={exit_code}, summary={summary}.\nПолный raw-вывод последнего запуска:\n{raw_output}\nИсправь только то, что мешает успешному прохождению проверки.",
+                  "template": "Latest run_go_linter.py result saved in {result_file}. exitCode={exit_code}, summary={summary}.\nFull raw output of the last run:\n{raw_output}\nFix only what prevents the check from passing.",
                   "vars": {
                     "result_file": {
                       "artifact": {
@@ -197,7 +198,7 @@
                   "appendPrompt": {
                     "base": { "ref": "params.extraPrompt" },
                     "suffix": {
-                      "template": "Последний результат run_go_linter.py сохранён в {result_file}. exitCode={exit_code}, summary={summary}.\nПолный raw-вывод последнего запуска:\n{raw_output}\nИсправь только то, что мешает успешному прохождению проверки.",
+                      "template": "Latest run_go_linter.py result saved in {result_file}. exitCode={exit_code}, summary={summary}.\nFull raw output of the last run:\n{raw_output}\nFix only what prevents the check from passing.",
                       "vars": {
                         "result_file": {
                           "artifact": {

package/dist/pipeline/flow-specs/go/run-go-tests-loop.json

@@ -1,6 +1,7 @@
 {
   "kind": "run-go-tests-loop-flow",
   "version": 1,
+  "description": "Runs run_go_tests.py and analyzes failures. If tests fail, sends the error output to LLM for a fix and retries. Repeats up to 5 attempts, stopping early on success. Asserts success after the final attempt.",
   "phases": [
     {
       "id": "run_go_tests_try_1",
@@ -70,7 +71,7 @@
               "appendPrompt": {
                 "base": { "ref": "params.extraPrompt" },
                 "suffix": {
-                  "template": "Последний результат run_go_tests.py сохранён в {result_file}. exitCode={exit_code}, summary={summary}.\nПолный raw-вывод последнего запуска:\n{raw_output}\nИсправь только то, что мешает успешному прохождению проверки.",
+                  "template": "Latest run_go_tests.py result saved in {result_file}. exitCode={exit_code}, summary={summary}.\nFull raw output of the last run:\n{raw_output}\nFix only what prevents the check from passing.",
                   "vars": {
                     "result_file": {
                       "artifact": {
@@ -197,7 +198,7 @@
                   "appendPrompt": {
                     "base": { "ref": "params.extraPrompt" },
                     "suffix": {
-                      "template": "Последний результат run_go_tests.py сохранён в {result_file}. exitCode={exit_code}, summary={summary}.\nПолный raw-вывод последнего запуска:\n{raw_output}\nИсправь только то, что мешает успешному прохождению проверки.",
+                      "template": "Latest run_go_tests.py result saved in {result_file}. exitCode={exit_code}, summary={summary}.\nFull raw output of the last run:\n{raw_output}\nFix only what prevents the check from passing.",
                       "vars": {
                         "result_file": {
                           "artifact": {

package/dist/pipeline/flow-specs/implement.json

@@ -1,6 +1,7 @@
 {
   "kind": "implement-flow",
   "version": 1,
+  "description": "Runs LLM-backed implementation based on previously approved design and plan artifacts. Executes code changes locally in the project working directory.",
   "phases": [
     {
       "id": "implement",

package/dist/pipeline/flow-specs/plan.json

@@ -1,6 +1,7 @@
 {
   "kind": "plan-flow",
   "version": 1,
+  "description": "Fetches Jira task with attachments, generates clarifying questions for the developer, collects answers, and produces design, implementation plan, and QA plan as structured JSON and markdown artifacts.",
   "phases": [
     {
       "id": "plan",
@@ -158,7 +159,7 @@
             "formId": { "const": "planning-questions" },
             "title": { "const": "Planning Questions" },
             "description": {
-              "const": "Ответьте на вопросы модели, если они нужны для точного design/plan. Если вопросов нет, шаг завершится автоматически."
+              "const": "Answer the model's questions if they are needed for an accurate design/plan. If there are no questions, this step will complete automatically."
             }
           }
         },

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

@@ -1,6 +1,7 @@
 {
   "kind": "review-fix-flow",
   "version": 1,
+  "description": "Takes review findings, auto-selects blockers and criticals (or lets the developer pick manually), builds a targeted fix prompt, and applies fixes locally. Runs mandatory checks after modifications.",
   "constants": {
     "autoReviewFixExtraPrompt": "Fix only blockers and criticals"
   },

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

@@ -1,6 +1,7 @@
 {
   "kind": "review-loop-flow",
   "version": 1,
+  "description": "Iteratively runs review → review-fix cycles up to 5 times. Stops early when ready-to-merge is achieved. Each iteration auto-selects blockers and critical findings for fixing.",
   "constants": {
     "autoReviewFixExtraPrompt": "Fix only blockers and criticals. Skip minor and warning severity."
   },

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

@@ -1,6 +1,7 @@
 {
   "kind": "review-project-flow",
   "version": 1,
+  "description": "Project-level code review. Runs a single LLM review step using the review-project prompt template. Used internally by the review command when no prior design/plan artifacts are present.",
   "phases": [
     {
       "id": "review",

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

@@ -1,6 +1,7 @@
 {
   "kind": "review-flow",
   "version": 1,
+  "description": "Performs code review of current changes against the task design and plan. Produces structured review findings with severity levels and a ready-to-merge verdict.",
   "phases": [
     {
       "id": "review",
@@ -116,7 +117,7 @@
               }
             },
             "panelTitle": { "const": "Ready To Merge" },
-            "foundMessage": { "const": "Изменения готовы к merge\nФайл ready-to-merge.md создан." },
+            "foundMessage": { "const": "Changes are ready to merge.\nFile ready-to-merge.md has been created." },
             "tone": { "const": "green" }
           }
         }