agentweaver 0.1.16 → 0.1.18

package/dist/pipeline/declarative-flows.js

@@ -1,27 +1,31 @@
 import path from "node:path";
-import { createNodeRegistry } from "./node-registry.js";
-import { createExecutorRegistry } from "./registry.js";
+import { createPipelineRegistryContext } from "./plugin-loader.js";
 import { compileFlowSpec } from "./spec-compiler.js";
-import { listBuiltInFlowSpecFiles, listProjectFlowSpecFiles, loadFlowSpecSync, projectFlowSpecsDir, resolveBuiltInFlowSpecPath } from "./spec-loader.js";
+import { globalFlowSpecsDir, listBuiltInFlowSpecFiles, listGlobalFlowSpecFiles, listProjectFlowSpecFiles, loadFlowSpecSync, projectFlowSpecsDir, resolveBuiltInFlowSpecPath, } from "./spec-loader.js";
 import { validateExpandedPhases, validateFlowSpec } from "./spec-validator.js";
 const cache = new Map();
 function toFlowSpecSource(ref) {
-    return ref.source === "built-in" ? { source: "built-in", fileName: ref.fileName } : { source: "project-local", filePath: ref.filePath };
+    return ref.source === "built-in"
+        ? { source: "built-in", fileName: ref.fileName }
+        : { source: ref.source, filePath: ref.filePath };
 }
-function cacheKey(ref) {
-    return ref.source === "built-in" ? `built-in:${ref.fileName}` : `project-local:${path.resolve(ref.filePath)}`;
+function cacheKey(ref, registryContext) {
+    const flowKey = ref.source === "built-in"
+        ? `built-in:${ref.fileName}`
+        : `${ref.source}:${path.resolve(ref.filePath)}`;
+    return `${registryContext.cacheKey}:${flowKey}`;
 }
-export function loadDeclarativeFlow(flow) {
+export async function loadDeclarativeFlow(flow, options = {}) {
     const ref = typeof flow === "string" ? { source: "built-in", fileName: flow } : flow;
-    const cached = cache.get(cacheKey(ref));
+    const cwd = path.resolve(options.cwd ?? options.registryContext?.cwd ?? process.cwd());
+    const registryContext = options.registryContext ?? await createPipelineRegistryContext(cwd);
+    const cached = cache.get(cacheKey(ref, registryContext));
     if (cached) {
         return cached;
     }
     const spec = loadFlowSpecSync(toFlowSpecSource(ref));
-    const nodeRegistry = createNodeRegistry();
-    const executorRegistry = createExecutorRegistry();
-    validateFlowSpec(spec, nodeRegistry, executorRegistry, {
-        resolveFlowByName: (fileName) => resolveNamedDeclarativeFlowRef(fileName, process.cwd()),
+    validateFlowSpec(spec, registryContext.nodes, registryContext.executors, {
+        resolveFlowByName: (fileName) => resolveNamedDeclarativeFlowRef(fileName, cwd),
     });
     const phases = compileFlowSpec(spec);
     validateExpandedPhases(phases);
@@ -36,33 +40,48 @@ export function loadDeclarativeFlow(flow) {
         fileName: ref.source === "built-in" ? ref.fileName : path.basename(ref.filePath),
         absolutePath: ref.source === "built-in" ? resolveBuiltInFlowSpecPath(ref.fileName) : path.resolve(ref.filePath),
     };
-    cache.set(cacheKey(ref), loaded);
+    cache.set(cacheKey(ref, registryContext), loaded);
     return loaded;
 }
 export function resolveNamedDeclarativeFlowRef(fileName, cwd) {
     const projectMatches = listProjectFlowSpecFiles(cwd).filter((candidate) => path.basename(candidate) === fileName);
+    const globalMatches = listGlobalFlowSpecFiles().filter((candidate) => path.basename(candidate) === fileName);
     const builtInMatches = listBuiltInFlowSpecFiles().filter((candidate) => path.basename(candidate) === fileName);
-    if (projectMatches.length > 0 && builtInMatches.length > 0) {
-        throw new Error(`Ambiguous nested flow '${fileName}': both built-in and project-local specs exist in ${projectFlowSpecsDir(cwd)}.`);
+    const matches = [
+        ...builtInMatches.map((candidate) => ({ source: "built-in", candidate })),
+        ...globalMatches.map((candidate) => ({ source: "global", candidate })),
+        ...projectMatches.map((candidate) => ({ source: "project-local", candidate })),
+    ];
+    if (matches.length > 1) {
+        throw new Error(`Ambiguous nested flow '${fileName}': matches exist in built-in flows, ${globalFlowSpecsDir()}, or ${projectFlowSpecsDir(cwd)}. Use unique nested flow file names.`);
     }
     if (projectMatches.length > 1) {
         throw new Error(`Ambiguous project-local flow '${fileName}' in ${projectFlowSpecsDir(cwd)}.`);
     }
+    if (globalMatches.length > 1) {
+        throw new Error(`Ambiguous global flow '${fileName}' in ${globalFlowSpecsDir()}.`);
+    }
     if (builtInMatches.length > 1) {
         throw new Error(`Ambiguous built-in flow '${fileName}'. Use unique nested flow file names.`);
     }
     if (projectMatches[0]) {
         return { source: "project-local", filePath: projectMatches[0] };
     }
+    if (globalMatches[0]) {
+        return { source: "global", filePath: globalMatches[0] };
+    }
     if (builtInMatches[0]) {
         return { source: "built-in", fileName: builtInMatches[0] };
     }
     throw new Error(`Nested flow '${fileName}' was not found.`);
 }
-export function loadNamedDeclarativeFlow(fileName, cwd) {
-    return loadDeclarativeFlow(resolveNamedDeclarativeFlowRef(fileName, cwd));
+export async function loadNamedDeclarativeFlow(fileName, cwd, options = {}) {
+    return loadDeclarativeFlow(resolveNamedDeclarativeFlowRef(fileName, cwd), {
+        cwd,
+        ...(options.registryContext ? { registryContext: options.registryContext } : {}),
+    });
 }
-export function collectFlowRoutingGroups(flow, cwd, visited = new Set()) {
+export async function collectFlowRoutingGroups(flow, cwd, visited = new Set(), options = {}) {
     if (visited.has(flow.absolutePath)) {
         return [];
     }
@@ -80,8 +99,8 @@ export function collectFlowRoutingGroups(flow, cwd, visited = new Set()) {
             if (!nestedFlowName || !("const" in nestedFlowName) || typeof nestedFlowName.const !== "string") {
                 continue;
             }
-            const nestedFlow = loadNamedDeclarativeFlow(nestedFlowName.const, cwd);
-            for (const nestedGroup of collectFlowRoutingGroups(nestedFlow, cwd, visited)) {
+            const nestedFlow = await loadNamedDeclarativeFlow(nestedFlowName.const, cwd, options);
+            for (const nestedGroup of await collectFlowRoutingGroups(nestedFlow, cwd, visited, options)) {
                 groups.add(nestedGroup);
             }
         }

package/dist/pipeline/flow-catalog.js

@@ -2,9 +2,10 @@ import path from "node:path";
 import { TaskRunnerError } from "../errors.js";
 import { loadAutoGolangFlow } from "./auto-flow.js";
 import { collectFlowRoutingGroups, loadDeclarativeFlow } from "./declarative-flows.js";
-import { listBuiltInFlowSpecFiles, listProjectFlowSpecFiles, projectFlowSpecsDir } from "./spec-loader.js";
+import { globalFlowSpecsDir, listBuiltInFlowSpecFiles, listGlobalFlowSpecFiles, listProjectFlowSpecFiles, projectFlowSpecsDir } from "./spec-loader.js";
 export const BUILT_IN_COMMAND_FLOW_IDS = [
     "auto-golang",
+    "auto-common-guided",
     "auto-common",
     "auto-simple",
     "bug-analyze",
@@ -17,6 +18,7 @@ export const BUILT_IN_COMMAND_FLOW_IDS = [
     "mr-description",
     "plan",
     "plan-revise",
+    "playbook-init",
     "task-describe",
     "implement",
     "review",
@@ -27,6 +29,7 @@ export const BUILT_IN_COMMAND_FLOW_IDS = [
 ];
 const BUILT_IN_COMMAND_FLOW_FILES = {
     "auto-golang": "auto-golang.json",
+    "auto-common-guided": "auto-common-guided.json",
     "auto-common": "auto-common.json",
     "auto-simple": "auto-simple.json",
     "bug-analyze": "bugz/bug-analyze.json",
@@ -39,6 +42,7 @@ const BUILT_IN_COMMAND_FLOW_FILES = {
     "mr-description": "gitlab/mr-description.json",
     plan: "plan.json",
     "plan-revise": "plan-revise.json",
+    "playbook-init": "playbook-init.json",
     "task-describe": "task-describe.json",
     implement: "implement.json",
     review: "review/review.json",
@@ -58,11 +62,13 @@ function builtInCommandIdForFile(fileName) {
     }
     return null;
 }
-function loadBuiltInCatalogEntry(fileName) {
+async function loadBuiltInCatalogEntry(fileName, options) {
     const commandId = builtInCommandIdForFile(fileName);
     const relativePath = fileName.replace(/\.json$/i, "").split(/[\\/]+/).filter((segment) => segment.length > 0);
     const id = commandId ?? relativePath.join("/");
-    const flow = id === "auto-golang" ? loadAutoGolangFlow() : loadDeclarativeFlow({ source: "built-in", fileName });
+    const flow = id === "auto-golang"
+        ? await loadAutoGolangFlow(options)
+        : await loadDeclarativeFlow({ source: "built-in", fileName }, options);
     return {
         id,
         source: "built-in",
@@ -72,8 +78,8 @@ function loadBuiltInCatalogEntry(fileName) {
         flow,
     };
 }
-function loadProjectCatalogEntry(cwd, filePath) {
-    const flow = loadDeclarativeFlow({ source: "project-local", filePath });
+async function loadProjectCatalogEntry(cwd, filePath, options) {
+    const flow = await loadDeclarativeFlow({ source: "project-local", filePath }, { ...options, cwd });
     const relativeFilePath = path.relative(projectFlowSpecsDir(cwd), path.resolve(filePath));
     const relativePathWithoutExt = relativeFilePath.replace(/\.json$/i, "");
     const relativeSegments = relativePathWithoutExt.split(path.sep).filter((segment) => segment.length > 0);
@@ -86,10 +92,30 @@ function loadProjectCatalogEntry(cwd, filePath) {
         flow,
     };
 }
-export function loadInteractiveFlowCatalog(cwd) {
-    const entries = listBuiltInFlowSpecFiles().map((fileName) => loadBuiltInCatalogEntry(fileName));
+async function loadGlobalCatalogEntry(filePath, options) {
+    const flow = await loadDeclarativeFlow({ source: "global", filePath }, options);
+    const relativeFilePath = path.relative(globalFlowSpecsDir(), path.resolve(filePath));
+    const relativePathWithoutExt = relativeFilePath.replace(/\.json$/i, "");
+    const relativeSegments = relativePathWithoutExt.split(path.sep).filter((segment) => segment.length > 0);
+    return {
+        id: relativeSegments.join("/"),
+        source: "global",
+        fileName: path.basename(filePath),
+        absolutePath: path.resolve(filePath),
+        treePath: ["global", ...relativeSegments],
+        flow,
+    };
+}
+export async function loadInteractiveFlowCatalog(cwd, options = {}) {
+    const entries = [];
+    for (const fileName of listBuiltInFlowSpecFiles()) {
+        entries.push(await loadBuiltInCatalogEntry(fileName, { ...options, cwd }));
+    }
+    for (const filePath of listGlobalFlowSpecFiles()) {
+        entries.push(await loadGlobalCatalogEntry(filePath, { ...options, cwd }));
+    }
     for (const filePath of listProjectFlowSpecFiles(cwd)) {
-        entries.push(loadProjectCatalogEntry(cwd, filePath));
+        entries.push(await loadProjectCatalogEntry(cwd, filePath, { ...options, cwd }));
     }
     const visibleEntries = entries.filter((entry) => entry.flow.catalogVisibility !== "hidden");
     const byId = new Map();
@@ -111,13 +137,13 @@ export function isBuiltInCommandFlowId(flowId) {
 export function toDeclarativeFlowRef(entry) {
     return entry.source === "built-in"
         ? { source: "built-in", fileName: entry.fileName }
-        : { source: "project-local", filePath: entry.absolutePath };
+        : { source: entry.source, filePath: entry.absolutePath };
 }
 export function flowRoutingKey(entry) {
-    return entry.source === "project-local"
-        ? `project-local:${entry.absolutePath}`
-        : `built-in:${entry.id}`;
+    return entry.source === "built-in"
+        ? `built-in:${entry.id}`
+        : `${entry.source}:${entry.absolutePath}`;
 }
-export function flowRoutingGroups(entry, cwd) {
-    return collectFlowRoutingGroups(entry.flow, cwd);
+export async function flowRoutingGroups(entry, cwd, options = {}) {
+    return collectFlowRoutingGroups(entry.flow, cwd, new Set(), options);
 }

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

@@ -0,0 +1,313 @@
+{
+  "kind": "auto-common-guided-flow",
+  "version": 1,
+  "description": "End-to-end auto-common pipeline with compact manifest.yaml project guidance generated before guided LLM phases.",
+  "phases": [
+    {
+      "id": "source",
+      "steps": [
+        {
+          "id": "fetch_jira_source",
+          "node": "flow-run",
+          "params": {
+            "fileName": { "const": "jira-fetch.json" },
+            "labelText": { "const": "Fetching Jira task source" },
+            "jiraApiUrl": { "ref": "params.jiraApiUrl" },
+            "taskKey": { "ref": "params.taskKey" }
+          }
+        }
+      ]
+    },
+    {
+      "id": "normalize",
+      "steps": [
+        {
+          "id": "run_normalize_source",
+          "node": "flow-run",
+          "params": {
+            "fileName": { "const": "normalize-task-source.json" },
+            "labelText": { "const": "Normalizing task source" },
+            "taskKey": { "ref": "params.taskKey" },
+            "iteration": { "ref": "params.taskContextIteration" },
+            "llmExecutor": { "ref": "params.llmExecutor" },
+            "llmModel": { "ref": "params.llmModel" },
+            "extraPrompt": { "ref": "params.extraPrompt" }
+          }
+        }
+      ]
+    },
+    {
+      "id": "playbook",
+      "steps": [
+        {
+          "id": "ensure_playbook",
+          "node": "playbook-ensure",
+          "params": {
+            "writeResultJsonFile": { "artifact": { "kind": "playbook-write-result-json-file", "taskKey": { "ref": "params.taskKey" } } },
+            "acceptPlaybookDraft": { "ref": "params.acceptPlaybookDraft" }
+          },
+          "stopFlowIf": {
+            "any": [
+              { "equals": [{ "ref": "steps.playbook.ensure_playbook.value.status" }, { "const": "blocked" }] },
+              { "equals": [{ "ref": "steps.playbook.ensure_playbook.value.status" }, { "const": "invalid_manifest" }] },
+              { "equals": [{ "ref": "steps.playbook.ensure_playbook.value.status" }, { "const": "partial_manifest" }] },
+              { "equals": [{ "ref": "steps.playbook.ensure_playbook.value.status" }, { "const": "not_accepted" }] },
+              { "equals": [{ "ref": "steps.playbook.ensure_playbook.value.status" }, { "const": "failed" }] }
+            ]
+          },
+          "stopFlowOutcome": "stopped"
+        },
+        {
+          "id": "run_playbook_init",
+          "node": "flow-run",
+          "when": { "ref": "steps.playbook.ensure_playbook.value.shouldRunPlaybookInit" },
+          "params": {
+            "fileName": { "const": "playbook-init.json" },
+            "labelText": { "const": "Initializing manifest-based project playbook" },
+            "taskKey": { "ref": "params.taskKey" },
+            "taskContextJsonFile": { "artifact": { "kind": "task-context-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.taskContextIteration" } } },
+            "markdownLanguage": { "ref": "params.mdLang" },
+            "iteration": { "ref": "params.planIteration" },
+            "launchMode": { "ref": "params.launchMode" },
+            "targetManifestPath": { "ref": "steps.playbook.ensure_playbook.value.manifestPath" },
+            "acceptPlaybookDraft": { "ref": "params.acceptPlaybookDraft" },
+            "llmExecutor": { "ref": "params.llmExecutor" },
+            "llmModel": { "ref": "params.llmModel" },
+            "extraPrompt": { "ref": "params.extraPrompt" }
+          }
+        },
+        {
+          "id": "verify_playbook",
+          "node": "playbook-ensure",
+          "when": { "ref": "steps.playbook.ensure_playbook.value.shouldRunPlaybookInit" },
+          "params": {
+            "writeResultJsonFile": { "artifact": { "kind": "playbook-write-result-json-file", "taskKey": { "ref": "params.taskKey" } } },
+            "acceptPlaybookDraft": { "ref": "params.acceptPlaybookDraft" },
+            "verifyAfterInit": { "const": true }
+          },
+          "stopFlowIf": {
+            "not": {
+              "any": [
+                { "equals": [{ "ref": "steps.playbook.verify_playbook.value.status" }, { "const": "written" }] },
+                { "equals": [{ "ref": "steps.playbook.verify_playbook.value.status" }, { "const": "skipped_valid_existing" }] },
+                { "equals": [{ "ref": "steps.playbook.verify_playbook.value.status" }, { "const": "dry_run_written" }] }
+              ]
+            }
+          },
+          "stopFlowOutcome": "stopped"
+        }
+      ]
+    },
+    {
+      "id": "plan_guidance",
+      "steps": [
+        {
+          "id": "write_plan_guidance",
+          "node": "project-guidance",
+          "params": {
+            "taskContextJsonFile": { "artifact": { "kind": "task-context-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.taskContextIteration" } } },
+            "phase": { "const": "plan" },
+            "outputJsonFile": { "artifact": { "kind": "project-guidance-plan-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.planIteration" } } },
+            "outputFile": { "artifact": { "kind": "project-guidance-plan-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.planIteration" } } },
+            "markdownLanguage": { "ref": "params.mdLang" }
+          }
+        }
+      ]
+    },
+    {
+      "id": "plan",
+      "steps": [
+        {
+          "id": "run_plan_flow",
+          "node": "flow-run",
+          "params": {
+            "fileName": { "const": "plan.json" },
+            "labelText": { "const": "Running planning flow" },
+            "taskKey": { "ref": "params.taskKey" },
+            "taskContextIteration": { "ref": "params.taskContextIteration" },
+            "designIteration": { "ref": "params.designIteration" },
+            "planIteration": { "ref": "params.planIteration" },
+            "qaIteration": { "ref": "params.qaIteration" },
+            "projectGuidanceFile": { "ref": "steps.plan_guidance.write_plan_guidance.value.outputFile" },
+            "projectGuidanceJsonFile": { "ref": "steps.plan_guidance.write_plan_guidance.value.outputJsonFile" },
+            "llmExecutor": { "ref": "params.llmExecutor" },
+            "llmModel": { "ref": "params.llmModel" },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "mdLang": { "ref": "params.mdLang" }
+          }
+        }
+      ]
+    },
+    {
+      "id": "design_review_guidance",
+      "steps": [
+        {
+          "id": "write_design_review_guidance",
+          "node": "project-guidance",
+          "params": {
+            "taskContextJsonFile": { "artifact": { "kind": "task-context-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.taskContextIteration" } } },
+            "phase": { "const": "design-review" },
+            "outputJsonFile": { "artifact": { "kind": "project-guidance-design-review-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.planIteration" } } },
+            "outputFile": { "artifact": { "kind": "project-guidance-design-review-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.planIteration" } } },
+            "markdownLanguage": { "ref": "params.mdLang" }
+          }
+        }
+      ]
+    },
+    {
+      "id": "design_review_loop",
+      "steps": [
+        {
+          "id": "run_design_review_loop",
+          "node": "flow-run",
+          "params": {
+            "fileName": { "const": "design-review-loop.json" },
+            "labelText": { "const": "Running design-review loop" },
+            "taskKey": { "ref": "params.taskKey" },
+            "baseIteration": { "ref": "params.designReviewBaseIteration" },
+            "workspaceDir": { "ref": "params.workspaceDir" },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "projectGuidanceFile": { "ref": "steps.design_review_guidance.write_design_review_guidance.value.outputFile" },
+            "projectGuidanceJsonFile": { "ref": "steps.design_review_guidance.write_design_review_guidance.value.outputJsonFile" },
+            "llmExecutor": { "ref": "params.llmExecutor" },
+            "llmModel": { "ref": "params.llmModel" }
+          },
+          "stopFlowIf": {
+            "equals": [
+              { "ref": "steps.design_review_loop.run_design_review_loop.value.executionState.terminationOutcome" },
+              { "const": "stopped" }
+            ]
+          },
+          "stopFlowOutcome": "stopped"
+        }
+      ]
+    },
+    {
+      "id": "implement_guidance",
+      "steps": [
+        {
+          "id": "write_implement_guidance",
+          "node": "project-guidance",
+          "params": {
+            "taskContextJsonFile": { "artifact": { "kind": "task-context-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.taskContextIteration" } } },
+            "phase": { "const": "implement" },
+            "outputJsonFile": { "artifact": { "kind": "project-guidance-implement-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.planIteration" } } },
+            "outputFile": { "artifact": { "kind": "project-guidance-implement-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.planIteration" } } },
+            "markdownLanguage": { "ref": "params.mdLang" }
+          }
+        }
+      ]
+    },
+    {
+      "id": "implement",
+      "steps": [
+        {
+          "id": "resolve_planning_bundle",
+          "node": "planning-bundle",
+          "params": { "taskKey": { "ref": "params.taskKey" } }
+        },
+        {
+          "id": "run_implement",
+          "node": "llm-prompt",
+          "routingGroup": "implementation",
+          "prompt": {
+            "templateRef": "implement",
+            "vars": {
+              "design_file": { "ref": "steps.implement.resolve_planning_bundle.value.designFile" },
+              "design_json_file": { "ref": "steps.implement.resolve_planning_bundle.value.designJsonFile" },
+              "plan_file": { "ref": "steps.implement.resolve_planning_bundle.value.planFile" },
+              "plan_json_file": { "ref": "steps.implement.resolve_planning_bundle.value.planJsonFile" },
+              "qa_file": { "ref": "steps.implement.resolve_planning_bundle.value.qaFile" },
+              "qa_json_file": { "ref": "steps.implement.resolve_planning_bundle.value.qaJsonFile" },
+              "project_guidance_file": { "ref": "steps.implement_guidance.write_implement_guidance.value.outputFile" },
+              "project_guidance_json_file": { "ref": "steps.implement_guidance.write_implement_guidance.value.outputJsonFile" }
+            },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "format": "task-prompt"
+          },
+          "params": {
+            "labelText": { "const": "Running implementation mode locally" },
+            "model": { "ref": "params.llmModel" },
+            "executor": { "ref": "params.llmExecutor" }
+          }
+        },
+        {
+          "id": "notify_implement_complete",
+          "node": "telegram-notify",
+          "params": { "message": { "template": "Implementation phase for {taskKey} complete.", "vars": { "taskKey": { "ref": "params.taskKey" } } } }
+        }
+      ]
+    },
+    {
+      "id": "review_guidance",
+      "steps": [
+        {
+          "id": "write_review_guidance",
+          "node": "project-guidance",
+          "params": {
+            "taskContextJsonFile": { "artifact": { "kind": "task-context-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.taskContextIteration" } } },
+            "phase": { "const": "review" },
+            "outputJsonFile": { "artifact": { "kind": "project-guidance-review-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.planIteration" } } },
+            "outputFile": { "artifact": { "kind": "project-guidance-review-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.planIteration" } } },
+            "markdownLanguage": { "ref": "params.mdLang" }
+          }
+        }
+      ]
+    },
+    {
+      "id": "repair_guidance",
+      "steps": [
+        {
+          "id": "write_repair_guidance",
+          "node": "project-guidance",
+          "params": {
+            "taskContextJsonFile": { "artifact": { "kind": "task-context-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.taskContextIteration" } } },
+            "phase": { "const": "repair/review-fix" },
+            "outputJsonFile": { "artifact": { "kind": "project-guidance-repair-review-fix-json-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.planIteration" } } },
+            "outputFile": { "artifact": { "kind": "project-guidance-repair-review-fix-file", "taskKey": { "ref": "params.taskKey" }, "iteration": { "ref": "params.planIteration" } } },
+            "markdownLanguage": { "ref": "params.mdLang" }
+          }
+        }
+      ]
+    },
+    {
+      "id": "review-loop",
+      "steps": [
+        {
+          "id": "run_review_loop",
+          "node": "flow-run",
+          "stopFlowIf": {
+            "not": {
+              "equals": [
+                { "ref": "steps.review-loop.run_review_loop.value.executionState.terminationOutcome" },
+                { "const": "success" }
+              ]
+            }
+          },
+          "stopFlowOutcome": "stopped",
+          "params": {
+            "fileName": { "const": "review-loop.json" },
+            "labelText": { "const": "Running review-loop" },
+            "taskKey": { "ref": "params.taskKey" },
+            "baseIteration": { "ref": "params.baseIteration" },
+            "workspaceDir": { "ref": "params.workspaceDir" },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "reviewFixPoints": { "ref": "params.reviewFixPoints" },
+            "reviewBlockingSeverities": { "ref": "params.reviewBlockingSeverities" },
+            "projectGuidanceFile": { "ref": "steps.review_guidance.write_review_guidance.value.outputFile" },
+            "projectGuidanceJsonFile": { "ref": "steps.review_guidance.write_review_guidance.value.outputJsonFile" },
+            "repairProjectGuidanceFile": { "ref": "steps.repair_guidance.write_repair_guidance.value.outputFile" },
+            "repairProjectGuidanceJsonFile": { "ref": "steps.repair_guidance.write_repair_guidance.value.outputJsonFile" },
+            "llmExecutor": { "ref": "params.llmExecutor" },
+            "llmModel": { "ref": "params.llmModel" }
+          }
+        },
+        {
+          "id": "notify_task_complete",
+          "node": "telegram-notify",
+          "params": { "message": { "template": "Task {taskKey} complete.", "vars": { "taskKey": { "ref": "params.taskKey" } } } }
+        }
+      ]
+    }
+  ]
+}

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

@@ -68,6 +68,7 @@
             "fileName": { "const": "design-review-loop.json" },
             "labelText": { "const": "Running design-review loop" },
             "taskKey": { "ref": "params.taskKey" },
+            "baseIteration": { "ref": "params.designReviewBaseIteration" },
             "workspaceDir": { "ref": "params.workspaceDir" },
             "extraPrompt": { "ref": "params.extraPrompt" },
             "llmExecutor": { "ref": "params.llmExecutor" },
@@ -105,7 +106,9 @@
               "plan_file": { "ref": "steps.implement.resolve_planning_bundle.value.planFile" },
               "plan_json_file": { "ref": "steps.implement.resolve_planning_bundle.value.planJsonFile" },
               "qa_file": { "ref": "steps.implement.resolve_planning_bundle.value.qaFile" },
-              "qa_json_file": { "ref": "steps.implement.resolve_planning_bundle.value.qaJsonFile" }
+              "qa_json_file": { "ref": "steps.implement.resolve_planning_bundle.value.qaJsonFile" },
+              "project_guidance_file": { "const": "not provided" },
+              "project_guidance_json_file": { "const": "not provided" }
             },
             "extraPrompt": { "ref": "params.extraPrompt" },
             "format": "task-prompt"

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

@@ -1,7 +1,7 @@
 {
   "kind": "auto-flow",
   "version": 1,
-  "description": "End-to-end resumable pipeline for Go projects. Runs the full sequence: Jira fetch → task source normalization → plan → 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.",
+  "description": "End-to-end resumable pipeline for Go projects. Runs the full sequence: Jira fetch → task source normalization → plan → design-review loop → 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": "Fix only blockers, criticals, and important findings"
   },
@@ -61,6 +61,32 @@
         }
       ]
     },
+    {
+      "id": "design_review_loop",
+      "steps": [
+        {
+          "id": "run_design_review_loop",
+          "node": "flow-run",
+          "params": {
+            "fileName": { "const": "design-review-loop.json" },
+            "labelText": { "const": "Running design-review loop" },
+            "taskKey": { "ref": "params.taskKey" },
+            "baseIteration": { "ref": "params.designReviewBaseIteration" },
+            "workspaceDir": { "ref": "params.workspaceDir" },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "llmExecutor": { "ref": "params.llmExecutor" },
+            "llmModel": { "ref": "params.llmModel" }
+          },
+          "stopFlowIf": {
+            "equals": [
+              { "ref": "steps.design_review_loop.run_design_review_loop.value.executionState.terminationOutcome" },
+              { "const": "stopped" }
+            ]
+          },
+          "stopFlowOutcome": "stopped"
+        }
+      ]
+    },
     {
       "id": "implement",
       "steps": [

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

@@ -23,8 +23,16 @@
                   "template": "Running design review (iteration ${iteration})"
                 },
                 "taskKey": { "ref": "params.taskKey" },
+                "iteration": {
+                  "add": [
+                    { "ref": "params.baseIteration" },
+                    { "add": [{ "ref": "repeat.iteration" }, { "const": -1 }] }
+                  ]
+                },
                 "workspaceDir": { "ref": "params.workspaceDir" },
                 "extraPrompt": { "ref": "params.extraPrompt" },
+                "projectGuidanceFile": { "ref": "params.projectGuidanceFile" },
+                "projectGuidanceJsonFile": { "ref": "params.projectGuidanceJsonFile" },
                 "llmExecutor": { "ref": "params.llmExecutor" },
                 "llmModel": { "ref": "params.llmModel" }
               }
@@ -33,7 +41,13 @@
               "id": "check_design_review_verdict",
               "node": "design-review-verdict",
               "params": {
-                "taskKey": { "ref": "params.taskKey" }
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": {
+                  "add": [
+                    { "ref": "params.baseIteration" },
+                    { "add": [{ "ref": "repeat.iteration" }, { "const": -1 }] }
+                  ]
+                }
               }
             },
             {

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

@@ -134,6 +134,8 @@
               "plan_json_file": { "ref": "params.planJsonFile" },
               "qa_file": { "ref": "params.qaFile" },
               "qa_json_file": { "ref": "params.qaJsonFile" },
+              "project_guidance_file": { "ref": "params.projectGuidanceFile" },
+              "project_guidance_json_file": { "ref": "params.projectGuidanceJsonFile" },
               "review_file": {
                 "artifact": {
                   "kind": "design-review-file",