agentweaver 0.1.4 → 0.1.5

package/README.md

@@ -12,7 +12,7 @@ The package is designed to run as an npm CLI and includes an interactive termina
 
 - Fetches a Jira issue by key or browse URL
 - Generates workflow artifacts such as design, implementation plan, QA plan, bug analysis, reviews, and summaries
-- For bug-analysis flows, structured JSON artifacts are the machine-readable source of truth, while Markdown artifacts are for human inspection
+- Machine-readable JSON artifacts are stored under `.agentweaver-<TASK>/.artifacts/` and act as the source of truth between workflow steps; Markdown artifacts remain for human inspection
 - Runs workflow stages like `bug-analyze`, `bug-fix`, `mr-description`, `plan`, `task-describe`, `implement`, `review`, `review-fix`, `test`, and `auto`
 - Persists compact `auto` pipeline state on disk so runs can resume without storing large agent outputs
 - Uses Docker runtime services for isolated Codex execution and build verification

package/dist/artifacts.js

@@ -11,61 +11,89 @@ export function taskWorkspaceDir(taskKey) {
 export function ensureTaskWorkspaceDir(taskKey) {
     const workspaceDir = taskWorkspaceDir(taskKey);
     mkdirSync(workspaceDir, { recursive: true });
+    mkdirSync(taskArtifactsDir(taskKey), { recursive: true });
     return workspaceDir;
 }
 export function taskWorkspaceFile(taskKey, fileName) {
     return path.join(taskWorkspaceDir(taskKey), fileName);
 }
+export function taskArtifactsDir(taskKey) {
+    return path.join(taskWorkspaceDir(taskKey), ".artifacts");
+}
+export function taskArtifactsFile(taskKey, fileName) {
+    return path.join(taskArtifactsDir(taskKey), fileName);
+}
 export function artifactFile(prefix, taskKey, iteration) {
     return taskWorkspaceFile(taskKey, `${prefix}-${taskKey}-${iteration}.md`);
 }
+export function artifactJsonFile(prefix, taskKey, iteration) {
+    return taskArtifactsFile(taskKey, `${prefix}-${taskKey}-${iteration}.json`);
+}
 export function designFile(taskKey) {
     return artifactFile("design", taskKey, 1);
 }
+export function designJsonFile(taskKey) {
+    return artifactJsonFile("design", taskKey, 1);
+}
 export function planFile(taskKey) {
     return artifactFile("plan", taskKey, 1);
 }
+export function planJsonFile(taskKey) {
+    return artifactJsonFile("plan", taskKey, 1);
+}
 export function bugAnalyzeFile(taskKey) {
     return taskWorkspaceFile(taskKey, `bug-analyze-${taskKey}.md`);
 }
 export function bugAnalyzeJsonFile(taskKey) {
-    return taskWorkspaceFile(taskKey, `bug-analyze-${taskKey}.json`);
+    return taskArtifactsFile(taskKey, `bug-analyze-${taskKey}.json`);
 }
 export function bugFixDesignFile(taskKey) {
     return taskWorkspaceFile(taskKey, `bug-fix-design-${taskKey}.md`);
 }
 export function bugFixDesignJsonFile(taskKey) {
-    return taskWorkspaceFile(taskKey, `bug-fix-design-${taskKey}.json`);
+    return taskArtifactsFile(taskKey, `bug-fix-design-${taskKey}.json`);
 }
 export function bugFixPlanFile(taskKey) {
     return taskWorkspaceFile(taskKey, `bug-fix-plan-${taskKey}.md`);
 }
 export function bugFixPlanJsonFile(taskKey) {
-    return taskWorkspaceFile(taskKey, `bug-fix-plan-${taskKey}.json`);
+    return taskArtifactsFile(taskKey, `bug-fix-plan-${taskKey}.json`);
 }
 export function qaFile(taskKey) {
     return artifactFile("qa", taskKey, 1);
 }
+export function qaJsonFile(taskKey) {
+    return artifactJsonFile("qa", taskKey, 1);
+}
 export function taskSummaryFile(taskKey) {
     return artifactFile("task", taskKey, 1);
 }
+export function taskSummaryJsonFile(taskKey) {
+    return artifactJsonFile("task", taskKey, 1);
+}
 export function readyToMergeFile(taskKey) {
     return taskWorkspaceFile(taskKey, READY_TO_MERGE_FILE);
 }
 export function jiraTaskFile(taskKey) {
-    return taskWorkspaceFile(taskKey, `${taskKey}.json`);
+    return taskArtifactsFile(taskKey, `${taskKey}.json`);
 }
 export function jiraDescriptionFile(taskKey) {
     return taskWorkspaceFile(taskKey, `jira-${taskKey}-description.md`);
 }
+export function jiraDescriptionJsonFile(taskKey) {
+    return taskArtifactsFile(taskKey, `jira-${taskKey}-description.json`);
+}
 export function mrDescriptionFile(taskKey) {
     return taskWorkspaceFile(taskKey, `mr-description-${taskKey}.md`);
 }
+export function mrDescriptionJsonFile(taskKey) {
+    return taskArtifactsFile(taskKey, `mr-description-${taskKey}.json`);
+}
 export function autoStateFile(taskKey) {
-    return taskWorkspaceFile(taskKey, `.agentweaver-state-${taskKey}.json`);
+    return taskArtifactsFile(taskKey, `.agentweaver-state-${taskKey}.json`);
 }
 export function planArtifacts(taskKey) {
-    return [designFile(taskKey), planFile(taskKey), qaFile(taskKey)];
+    return [designFile(taskKey), designJsonFile(taskKey), planFile(taskKey), planJsonFile(taskKey), qaFile(taskKey), qaJsonFile(taskKey)];
 }
 export function bugAnalyzeArtifacts(taskKey) {
     return [
@@ -77,6 +105,27 @@ export function bugAnalyzeArtifacts(taskKey) {
         bugFixPlanJsonFile(taskKey),
     ];
 }
+export function reviewFile(taskKey, iteration) {
+    return artifactFile("review", taskKey, iteration);
+}
+export function reviewJsonFile(taskKey, iteration) {
+    return artifactJsonFile("review", taskKey, iteration);
+}
+export function reviewReplyFile(taskKey, iteration) {
+    return artifactFile("review-reply", taskKey, iteration);
+}
+export function reviewReplyJsonFile(taskKey, iteration) {
+    return artifactJsonFile("review-reply", taskKey, iteration);
+}
+export function reviewFixFile(taskKey, iteration) {
+    return artifactFile("review-fix", taskKey, iteration);
+}
+export function reviewFixJsonFile(taskKey, iteration) {
+    return artifactJsonFile("review-fix", taskKey, iteration);
+}
+export function reviewFixSelectionJsonFile(taskKey, iteration) {
+    return artifactJsonFile("review-fix-selection", taskKey, iteration);
+}
 export function requireArtifacts(paths, message) {
     const missing = paths.filter((filePath) => !existsSync(filePath));
     if (missing.length > 0) {

package/dist/index.js

@@ -3,7 +3,7 @@ import { existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from "no
 import path from "node:path";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
-import { REVIEW_FILE_RE, REVIEW_REPLY_FILE_RE, autoStateFile, bugAnalyzeArtifacts, bugAnalyzeJsonFile, bugFixDesignJsonFile, bugFixPlanJsonFile, ensureTaskWorkspaceDir, jiraTaskFile, planArtifacts, readyToMergeFile, requireArtifacts, taskWorkspaceDir, taskSummaryFile, } from "./artifacts.js";
+import { REVIEW_FILE_RE, REVIEW_REPLY_FILE_RE, autoStateFile, bugAnalyzeArtifacts, bugAnalyzeJsonFile, bugFixDesignJsonFile, bugFixPlanJsonFile, designJsonFile, ensureTaskWorkspaceDir, jiraTaskFile, planJsonFile, planArtifacts, qaJsonFile, readyToMergeFile, requireArtifacts, reviewReplyJsonFile, reviewFixSelectionJsonFile, reviewJsonFile, taskWorkspaceDir, taskSummaryFile, } from "./artifacts.js";
 import { TaskRunnerError } from "./errors.js";
 import { buildJiraApiUrl, buildJiraBrowseUrl, extractIssueKey, requireJiraTaskFile } from "./jira.js";
 import { validateStructuredArtifacts } from "./structured-artifacts.js";
@@ -17,7 +17,8 @@ import { resolveCmd, resolveDockerComposeCmd } from "./runtime/command-resolutio
 import { defaultDockerComposeFile, dockerRuntimeEnv } from "./runtime/docker-runtime.js";
 import { runCommand } from "./runtime/process-runner.js";
 import { InteractiveUi } from "./interactive-ui.js";
-import { bye, printError, printInfo, printPanel, printSummary, setFlowExecutionState } from "./tui.js";
+import { bye, printError, printInfo, printPanel, printSummary, setFlowExecutionState, stripAnsi, } from "./tui.js";
+import { requestUserInputInTerminal } from "./user-input.js";
 const COMMANDS = [
     "bug-analyze",
     "bug-fix",
@@ -45,6 +46,37 @@ const runtimeServices = {
     dockerRuntimeEnv: () => dockerRuntimeEnv(PACKAGE_ROOT),
     runCommand,
 };
+function buildFailureOutputPreview(output) {
+    const normalized = stripAnsi(output).replace(/\r\n/g, "\n").trim();
+    if (!normalized) {
+        return "";
+    }
+    const lines = normalized
+        .split("\n")
+        .map((line) => line.trimEnd())
+        .filter((line) => line.trim().length > 0);
+    if (lines.length === 0) {
+        return "";
+    }
+    const previewLines = lines.slice(-8);
+    let preview = previewLines.join("\n");
+    const maxLength = 1200;
+    if (preview.length > maxLength) {
+        preview = `...${preview.slice(-(maxLength - 3))}`;
+    }
+    return preview;
+}
+function formatProcessFailure(error) {
+    const returnCode = Number(error.returnCode);
+    const baseMessage = !Number.isNaN(returnCode)
+        ? `Command failed with exit code ${returnCode}`
+        : error.message?.trim() || "Command failed";
+    const preview = buildFailureOutputPreview(String(error.output ?? ""));
+    if (!preview) {
+        return baseMessage;
+    }
+    return `${baseMessage}\nПричина:\n${preview}`;
+}
 function usage() {
     return `Usage:
   agentweaver <jira-browse-url|jira-issue-key>
@@ -420,11 +452,31 @@ function autoFlowParams(config) {
         reviewFixPoints: config.reviewFixPoints,
     };
 }
+const FLOW_DESCRIPTIONS = {
+    auto: "Полный пайплайн задачи: планирование, реализация, проверки, ревью, ответы на ревью и повторные итерации до готовности к merge.",
+    "bug-analyze": "Анализирует баг по Jira и создаёт структурированные артефакты: гипотезу причины, дизайн исправления и план работ.",
+    "bug-fix": "Берёт результаты bug-analyze как source of truth и реализует исправление бага в коде.",
+    "mr-description": "Готовит краткое intent-описание для merge request на основе задачи и текущих изменений.",
+    plan: "Загружает задачу из Jira и создаёт дизайн, план реализации и QA-план в structured JSON и markdown.",
+    "task-describe": "Строит короткое резюме задачи на основе Jira-артефакта для быстрого ознакомления.",
+    implement: "Реализует задачу по утверждённым design/plan артефактам и при необходимости запускает post-verify сборки.",
+    review: "Запускает Claude-код-ревью текущих изменений, валидирует structured findings, затем готовит ответ на замечания через Codex.",
+    "review-fix": "Исправляет замечания после review-reply, обновляет код и прогоняет обязательные проверки после правок.",
+    test: "Запускает verify/build-проверку в контейнере и показывает результат с краткой сводкой при падении.",
+    "test-fix": "Прогоняет тесты, исправляет найденные проблемы и готовит код к следующей успешной проверке.",
+    "test-linter-fix": "Прогоняет линтер и генерацию, затем исправляет замечания для чистого прогона.",
+    "run-tests-loop": "Циклически запускает `./run_tests.sh`, анализирует последнюю ошибку и правит код до успешного прохождения или исчерпания попыток.",
+    "run-linter-loop": "Циклически запускает `./run_linter.sh`, исправляет проблемы линтера или генерации и повторяет попытки до успеха.",
+};
+function flowDescription(id) {
+    return FLOW_DESCRIPTIONS[id] ?? "Описание для этого flow пока не задано.";
+}
 function declarativeFlowDefinition(id, label, fileName) {
     const flow = loadDeclarativeFlow(fileName);
     return {
         id,
         label,
+        description: flowDescription(id),
         phases: flow.phases.map((phase) => ({
             id: phase.id,
             repeatVars: Object.fromEntries(Object.entries(phase.repeatVars).map(([key, value]) => [key, value])),
@@ -439,6 +491,7 @@ function autoFlowDefinition() {
     return {
         id: "auto",
         label: "auto",
+        description: flowDescription("auto"),
         phases: flow.phases.map((phase) => ({
             id: phase.id,
             repeatVars: Object.fromEntries(Object.entries(phase.repeatVars).map(([key, value]) => [key, value])),
@@ -469,13 +522,14 @@ function interactiveFlowDefinitions() {
 function publishFlowState(flowId, executionState) {
     setFlowExecutionState(flowId, stripExecutionStatePayload(executionState));
 }
-async function runDeclarativeFlowBySpecFile(fileName, config, flowParams) {
+async function runDeclarativeFlowBySpecFile(fileName, config, flowParams, requestUserInput = requestUserInputInTerminal) {
     const context = createPipelineContext({
         issueKey: config.taskKey,
         jiraRef: config.jiraRef,
         dryRun: config.dryRun,
         verbose: config.verbose,
         runtime: runtimeServices,
+        requestUserInput,
     });
     const flow = loadDeclarativeFlow(fileName);
     const executionState = {
@@ -503,6 +557,7 @@ async function runAutoPhaseViaSpec(config, phaseId, executionState, state) {
         dryRun: config.dryRun,
         verbose: config.verbose,
         runtime: runtimeServices,
+        requestUserInput: requestUserInputInTerminal,
     });
     const autoFlow = loadAutoFlow();
     const phase = findPhaseById(autoFlow.phases, phaseId);
@@ -577,9 +632,10 @@ async function summarizeBuildFailure(output) {
         dryRun: false,
         verbose: false,
         runtime: runtimeServices,
+        requestUserInput: requestUserInputInTerminal,
     }), output);
 }
-async function executeCommand(config, runFollowupVerify = true) {
+async function executeCommand(config, runFollowupVerify = true, requestUserInput = requestUserInputInTerminal) {
     if (config.command === "auto") {
         await runAutoPipeline(config);
         return false;
@@ -612,7 +668,7 @@ async function executeCommand(config, runFollowupVerify = true) {
             jiraApiUrl: config.jiraApiUrl,
             taskKey: config.taskKey,
             extraPrompt: config.extraPrompt,
-        });
+        }, requestUserInput);
         return false;
     }
     if (config.command === "bug-analyze") {
@@ -625,7 +681,7 @@ async function executeCommand(config, runFollowupVerify = true) {
             jiraApiUrl: config.jiraApiUrl,
             taskKey: config.taskKey,
             extraPrompt: config.extraPrompt,
-        });
+        }, requestUserInput);
         return false;
     }
     if (config.command === "bug-fix") {
@@ -639,7 +695,7 @@ async function executeCommand(config, runFollowupVerify = true) {
         await runDeclarativeFlowBySpecFile("bug-fix.json", config, {
             taskKey: config.taskKey,
             extraPrompt: config.extraPrompt,
-        });
+        }, requestUserInput);
         return false;
     }
     if (config.command === "mr-description") {
@@ -647,7 +703,7 @@ async function executeCommand(config, runFollowupVerify = true) {
         await runDeclarativeFlowBySpecFile("mr-description.json", config, {
             taskKey: config.taskKey,
             extraPrompt: config.extraPrompt,
-        });
+        }, requestUserInput);
         return false;
     }
     if (config.command === "task-describe") {
@@ -655,19 +711,24 @@ async function executeCommand(config, runFollowupVerify = true) {
         await runDeclarativeFlowBySpecFile("task-describe.json", config, {
             taskKey: config.taskKey,
             extraPrompt: config.extraPrompt,
-        });
+        }, requestUserInput);
         return false;
     }
     if (config.command === "implement") {
         requireJiraTaskFile(config.jiraTaskFile);
         requireArtifacts(planArtifacts(config.taskKey), "Implement mode requires plan artifacts from the planning phase.");
+        validateStructuredArtifacts([
+            { path: designJsonFile(config.taskKey), schemaId: "implementation-design/v1" },
+            { path: planJsonFile(config.taskKey), schemaId: "implementation-plan/v1" },
+            { path: qaJsonFile(config.taskKey), schemaId: "qa-plan/v1" },
+        ], "Implement mode requires valid structured plan artifacts from the planning phase.");
         try {
             await runDeclarativeFlowBySpecFile("implement.json", config, {
                 taskKey: config.taskKey,
                 dockerComposeFile: config.dockerComposeFile,
                 extraPrompt: config.extraPrompt,
                 runFollowupVerify,
-            });
+            }, requestUserInput);
         }
         catch (error) {
             if (!config.dryRun) {
@@ -683,25 +744,38 @@ async function executeCommand(config, runFollowupVerify = true) {
     }
     if (config.command === "review") {
         requireJiraTaskFile(config.jiraTaskFile);
+        validateStructuredArtifacts([
+            { path: designJsonFile(config.taskKey), schemaId: "implementation-design/v1" },
+            { path: planJsonFile(config.taskKey), schemaId: "implementation-plan/v1" },
+        ], "Review mode requires valid structured plan artifacts from the planning phase.");
         const iteration = nextReviewIterationForTask(config.taskKey);
         await runDeclarativeFlowBySpecFile("review.json", config, {
             taskKey: config.taskKey,
             iteration,
             extraPrompt: config.extraPrompt,
-        });
+        }, requestUserInput);
         return !config.dryRun && existsSync(readyToMergeFile(config.taskKey));
     }
     if (config.command === "review-fix") {
         requireJiraTaskFile(config.jiraTaskFile);
+        const latestIteration = latestReviewReplyIteration(config.taskKey);
+        if (latestIteration === null) {
+            throw new TaskRunnerError("Review-fix mode requires at least one review-reply artifact.");
+        }
+        validateStructuredArtifacts([
+            { path: reviewJsonFile(config.taskKey, latestIteration), schemaId: "review-findings/v1" },
+            { path: reviewReplyJsonFile(config.taskKey, latestIteration), schemaId: "review-reply/v1" },
+        ], "Review-fix mode requires valid structured review artifacts.");
         try {
             await runDeclarativeFlowBySpecFile("review-fix.json", config, {
                 taskKey: config.taskKey,
                 dockerComposeFile: config.dockerComposeFile,
-                latestIteration: latestReviewReplyIteration(config.taskKey),
+                latestIteration,
+                reviewFixSelectionJsonFile: reviewFixSelectionJsonFile(config.taskKey, latestIteration),
                 runFollowupVerify,
                 extraPrompt: config.extraPrompt,
                 reviewFixPoints: config.reviewFixPoints,
-            });
+            }, requestUserInput);
         }
         catch (error) {
             if (!config.dryRun) {
@@ -721,7 +795,7 @@ async function executeCommand(config, runFollowupVerify = true) {
             await runDeclarativeFlowBySpecFile("test.json", config, {
                 taskKey: config.taskKey,
                 dockerComposeFile: config.dockerComposeFile,
-            });
+            }, requestUserInput);
         }
         catch (error) {
             if (!config.dryRun) {
@@ -740,7 +814,7 @@ async function executeCommand(config, runFollowupVerify = true) {
         await runDeclarativeFlowBySpecFile(config.command === "test-fix" ? "test-fix.json" : "test-linter-fix.json", config, {
             taskKey: config.taskKey,
             extraPrompt: config.extraPrompt,
-        });
+        }, requestUserInput);
         return false;
     }
     if (config.command === "run-tests-loop" || config.command === "run-linter-loop") {
@@ -748,7 +822,7 @@ async function executeCommand(config, runFollowupVerify = true) {
             taskKey: config.taskKey,
             dockerComposeFile: config.dockerComposeFile,
             extraPrompt: config.extraPrompt,
-        });
+        }, requestUserInput);
         return false;
     }
     throw new TaskRunnerError(`Unsupported command: ${config.command}`);
@@ -933,7 +1007,7 @@ async function runInteractive(jiraRef, forceRefresh = false) {
         onRun: async (flowId) => {
             try {
                 const command = buildConfig(flowId, jiraRef);
-                await executeCommand(command);
+                await executeCommand(command, true, (form) => ui.requestUserInput(form));
             }
             catch (error) {
                 if (error instanceof TaskRunnerError) {
@@ -944,7 +1018,7 @@ async function runInteractive(jiraRef, forceRefresh = false) {
                 const returnCode = Number(error.returnCode);
                 if (!Number.isNaN(returnCode)) {
                     ui.setFlowFailed(flowId);
-                    printError(`Command failed with exit code ${returnCode}`);
+                    printError(formatProcessFailure(error));
                     return;
                 }
                 throw error;
@@ -968,6 +1042,7 @@ async function runInteractive(jiraRef, forceRefresh = false) {
             setSummary: (markdown) => {
                 ui.setSummary(markdown);
             },
+            requestUserInput: (form) => ui.requestUserInput(form),
         }), {
             jiraApiUrl: config.jiraApiUrl,
             jiraTaskFile: config.jiraTaskFile,
@@ -1041,7 +1116,7 @@ export async function main(argv = process.argv.slice(2)) {
         }
         const returnCode = Number(error.returnCode);
         if (!Number.isNaN(returnCode)) {
-            printError(`Command failed with exit code ${returnCode}`);
+            printError(formatProcessFailure(error));
             return returnCode || 1;
         }
         throw error;