agentweaver 0.1.13 → 0.1.15

package/dist/index.js

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

package/dist/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-catalog.js

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

package/dist/pipeline/flow-specs/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",