agentweaver 0.1.2 → 0.1.3

package/README.md

@@ -18,19 +18,22 @@ The package is designed to run as an npm CLI and includes an interactive termina
 
 ## Architecture
 
-The CLI now uses an executor-based architecture.
+The CLI now uses an executor + node + declarative flow architecture.
 
-- `src/index.ts` remains the orchestration layer for CLI commands and `auto` state transitions
-- `src/executors/` contains first-class executors for external actions such as Jira fetch, local Codex, Docker Codex, Claude, Claude summaries, process execution, and build verification
-- `src/executors/configs/` contains data-only default configs for executors with JSON-compatible structure
+- `src/index.ts` remains the CLI entrypoint and high-level orchestration layer
+- `src/executors/` contains first-class executors for external actions such as Jira fetch, local Codex, Docker-based build verification, Claude, Claude summaries, and process execution
+- `src/pipeline/nodes/` contains reusable runtime nodes built on top of executors
+- `src/pipeline/flow-specs/` contains declarative JSON flow specs for `preflight`, `plan`, `implement`, `review`, `review-fix`, `test`, `test-fix`, `test-linter-fix`, and `auto`
 - `src/runtime/` contains shared runtime services such as command resolution, Docker runtime environment setup, and subprocess execution
 
-This keeps command handlers focused on workflow composition instead of inline subprocess wiring.
+This keeps command handlers focused on choosing a flow and providing parameters instead of assembling prompts and subprocess wiring inline.
 
 ## Repository Layout
 
 - `src/` — main TypeScript sources
 - `src/index.ts` — CLI entrypoint and workflow orchestration
+- `src/pipeline/flow-specs/` — declarative JSON specs for workflow stages
+- `src/pipeline/nodes/` — reusable pipeline nodes executed by the declarative runner
 - `src/interactive-ui.ts` — interactive TUI built with `neo-blessed`
 - `src/markdown.ts` — markdown-to-terminal renderer for the TUI
 - `src/executors/` — executor modules for concrete execution families
@@ -84,9 +87,8 @@ Common optional variables:
 - `DOCKER_COMPOSE_BIN` — override compose command, for example `docker compose`
 - `CODEX_BIN` — override `codex` executable path
 - `CLAUDE_BIN` — override `claude` executable path
-- `CODEX_MODEL` — defaults to `gpt-5.4`
-- `CLAUDE_REVIEW_MODEL` — defaults to `opus`
-- `CLAUDE_SUMMARY_MODEL` — defaults to `haiku`
+- `CODEX_MODEL` — fallback model for Codex executors when the flow spec does not set `params.model`
+- `CLAUDE_MODEL` — fallback Claude model when the flow spec does not set `params.model`
 
 Example `.env`:
 
@@ -97,8 +99,7 @@ AGENTWEAVER_HOME=/absolute/path/to/AgentWeaver
 CODEX_BIN=codex
 CLAUDE_BIN=claude
 CODEX_MODEL=gpt-5.4
-CLAUDE_REVIEW_MODEL=opus
-CLAUDE_SUMMARY_MODEL=haiku
+CLAUDE_MODEL=opus
 GOPRIVATE=gitlab.example.org/*
 GONOSUMDB=gitlab.example.org/*
 GONOPROXY=gitlab.example.org/*

package/dist/artifacts.js

@@ -1,10 +1,23 @@
-import { existsSync } from "node:fs";
+import { existsSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import process from "node:process";
 import { TaskRunnerError } from "./errors.js";
 export const REVIEW_FILE_RE = /^review-(.+)-(\d+)\.md$/;
 export const REVIEW_REPLY_FILE_RE = /^review-reply-(.+)-(\d+)\.md$/;
 export const READY_TO_MERGE_FILE = "ready-to-merge.md";
+export function taskWorkspaceDir(taskKey) {
+    return path.join(process.cwd(), `.agentweaver-${taskKey}`);
+}
+export function ensureTaskWorkspaceDir(taskKey) {
+    const workspaceDir = taskWorkspaceDir(taskKey);
+    mkdirSync(workspaceDir, { recursive: true });
+    return workspaceDir;
+}
+export function taskWorkspaceFile(taskKey, fileName) {
+    return path.join(taskWorkspaceDir(taskKey), fileName);
+}
 export function artifactFile(prefix, taskKey, iteration) {
-    return `${prefix}-${taskKey}-${iteration}.md`;
+    return taskWorkspaceFile(taskKey, `${prefix}-${taskKey}-${iteration}.md`);
 }
 export function designFile(taskKey) {
     return artifactFile("design", taskKey, 1);
@@ -18,6 +31,15 @@ export function qaFile(taskKey) {
 export function taskSummaryFile(taskKey) {
     return artifactFile("task", taskKey, 1);
 }
+export function readyToMergeFile(taskKey) {
+    return taskWorkspaceFile(taskKey, READY_TO_MERGE_FILE);
+}
+export function jiraTaskFile(taskKey) {
+    return taskWorkspaceFile(taskKey, `${taskKey}.json`);
+}
+export function autoStateFile(taskKey) {
+    return taskWorkspaceFile(taskKey, `.agentweaver-state-${taskKey}.json`);
+}
 export function planArtifacts(taskKey) {
     return [designFile(taskKey), planFile(taskKey), qaFile(taskKey)];
 }

package/dist/executors/claude-executor.js

@@ -1,7 +1,17 @@
 import { claudeExecutorDefaultConfig } from "./configs/claude-config.js";
 import { processExecutor } from "./process-executor.js";
 function resolveModel(config, env) {
-    return env[config.modelEnvVar]?.trim() || config.defaultModel;
+    const primaryModel = env[config.modelEnvVar]?.trim();
+    if (primaryModel) {
+        return primaryModel;
+    }
+    for (const envVarName of config.legacyModelEnvVars ?? []) {
+        const legacyModel = env[envVarName]?.trim();
+        if (legacyModel) {
+            return legacyModel;
+        }
+    }
+    return config.defaultModel;
 }
 export const claudeExecutor = {
     kind: "claude",
@@ -10,7 +20,7 @@ export const claudeExecutor = {
     async execute(context, input, config) {
         const env = input.env ?? context.env;
         const command = input.command ?? context.runtime.resolveCmd(config.defaultCommand, config.commandEnvVar);
-        const model = resolveModel(config, env);
+        const model = input.model?.trim() || resolveModel(config, env);
         const argv = [command, "--model", model, config.promptFlag, `--allowedTools=${config.allowedTools}`];
         if (config.outputFormat) {
             argv.push("--output-format", config.outputFormat);

package/dist/executors/claude-summary-executor.js

@@ -12,7 +12,7 @@ export const claudeSummaryExecutor = {
     async execute(context, input, config) {
         const env = input.env ?? context.env;
         const command = input.command ?? context.runtime.resolveCmd(config.defaultCommand, config.commandEnvVar);
-        const model = resolveModel(config, env);
+        const model = input.model?.trim() || resolveModel(config, env);
         const argv = [command, "--model", model, config.promptFlag, `--allowedTools=${config.allowedTools}`, input.prompt];
         const processInput = {
             argv,

package/dist/executors/codex-docker-executor.js

@@ -10,7 +10,7 @@ export const codexDockerExecutor = {
     async execute(context, input, config) {
         const composeCommand = context.runtime.resolveDockerComposeCmd();
         const env = context.runtime.dockerRuntimeEnv();
-        const model = resolveModel(config, env);
+        const model = input.model?.trim() || resolveModel(config, env);
         env[config.promptEnvVar] = input.prompt;
         env[config.flagsEnvVar] = config.execFlagsTemplate.replace("{model}", model);
         const result = await processExecutor.execute(context, {

package/dist/executors/codex-local-executor.js

@@ -10,7 +10,7 @@ export const codexLocalExecutor = {
     async execute(context, input, config) {
         const env = input.env ?? context.env;
         const command = input.command ?? context.runtime.resolveCmd(config.defaultCommand, config.commandEnvVar);
-        const model = resolveModel(config, env);
+        const model = input.model?.trim() || resolveModel(config, env);
         const result = await processExecutor.execute(context, {
             argv: [command, config.subcommand, "--model", model, config.fullAutoFlag, input.prompt],
             env,

package/dist/executors/configs/claude-config.js

@@ -1,7 +1,8 @@
 export const claudeExecutorDefaultConfig = {
     commandEnvVar: "CLAUDE_BIN",
     defaultCommand: "claude",
-    modelEnvVar: "CLAUDE_REVIEW_MODEL",
+    modelEnvVar: "CLAUDE_MODEL",
+    legacyModelEnvVars: ["CLAUDE_REVIEW_MODEL"],
     defaultModel: "opus",
     promptFlag: "-p",
     allowedTools: "Read,Write,Edit",