agentweaver 0.1.17 → 0.1.19

package/dist/pipeline/flow-catalog.js

@@ -5,6 +5,7 @@ import { collectFlowRoutingGroups, loadDeclarativeFlow } from "./declarative-flo
 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",

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

@@ -106,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/design-review/design-review-loop.json

@@ -31,6 +31,8 @@
                 },
                 "workspaceDir": { "ref": "params.workspaceDir" },
                 "extraPrompt": { "ref": "params.extraPrompt" },
+                "projectGuidanceFile": { "ref": "params.projectGuidanceFile" },
+                "projectGuidanceJsonFile": { "ref": "params.projectGuidanceJsonFile" },
                 "llmExecutor": { "ref": "params.llmExecutor" },
                 "llmModel": { "ref": "params.llmModel" }
               }

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",

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

@@ -54,7 +54,9 @@
                   "taskKey": { "ref": "params.taskKey" },
                   "iteration": { "ref": "params.planningIteration" }
                 }
-              }
+              },
+              "project_guidance_file": { "ref": "params.projectGuidanceFile" },
+              "project_guidance_json_file": { "ref": "params.projectGuidanceJsonFile" }
             },
             "extraPrompt": { "ref": "params.extraPrompt" },
             "format": "task-prompt"

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

@@ -65,6 +65,8 @@
                   "iteration": { "ref": "params.taskContextIteration" }
                 }
               },
+              "project_guidance_file": { "ref": "params.projectGuidanceFile" },
+              "project_guidance_json_file": { "ref": "params.projectGuidanceJsonFile" },
               "planning_questions_json_file": {
                 "artifact": {
                   "kind": "planning-questions-json-file",
@@ -203,6 +205,8 @@
                   "taskKey": { "ref": "params.taskKey" }
                 }
               },
+              "project_guidance_file": { "ref": "params.projectGuidanceFile" },
+              "project_guidance_json_file": { "ref": "params.projectGuidanceJsonFile" },
               "design_file": {
                 "artifact": {
                   "kind": "design-file",

package/dist/pipeline/flow-specs/playbook-init.json

@@ -0,0 +1,199 @@
+{
+  "kind": "playbook-init-flow",
+  "version": 1,
+  "description": "Initializes an evidence-backed project playbook from deterministic repository inventory, candidate practices, targeted questions, structured answers, a draft, and a guarded final write.",
+  "phases": [
+    {
+      "id": "playbook_init",
+      "steps": [
+        {
+          "id": "repo_inventory",
+          "node": "playbook-inventory",
+          "params": {
+            "outputJsonFile": { "artifact": { "kind": "repo-inventory-json-file", "taskKey": { "ref": "params.taskKey" } } },
+            "outputFile": { "artifact": { "kind": "repo-inventory-file", "taskKey": { "ref": "params.taskKey" } } }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                { "path": { "artifact": { "kind": "repo-inventory-json-file", "taskKey": { "ref": "params.taskKey" } } }, "schemaId": "repo-inventory/v1" }
+              ],
+              "message": "Playbook initialization requires a valid deterministic repository inventory."
+            }
+          ]
+        },
+        {
+          "id": "practice_candidates",
+          "node": "llm-prompt",
+          "routingGroup": "planning",
+          "prompt": {
+            "templateRef": "playbook-practice-candidates",
+            "vars": {
+              "repo_inventory_json_file": { "artifact": { "kind": "repo-inventory-json-file", "taskKey": { "ref": "params.taskKey" } } },
+              "practice_candidates_json_file": { "artifact": { "kind": "practice-candidates-json-file", "taskKey": { "ref": "params.taskKey" } } },
+              "practice_candidates_file": { "artifact": { "kind": "practice-candidates-file", "taskKey": { "ref": "params.taskKey" } } }
+            },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "format": "task-prompt"
+          },
+          "params": {
+            "labelText": { "const": "Generating evidence-backed practice candidates" },
+            "model": { "ref": "params.llmModel" },
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "list": [
+                { "artifact": { "kind": "practice-candidates-json-file", "taskKey": { "ref": "params.taskKey" } } },
+                { "artifact": { "kind": "practice-candidates-file", "taskKey": { "ref": "params.taskKey" } } }
+              ]
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "when": { "not": { "ref": "context.dryRun" } },
+              "items": [
+                { "path": { "artifact": { "kind": "practice-candidates-json-file", "taskKey": { "ref": "params.taskKey" } } }, "schemaId": "practice-candidates/v1" }
+              ],
+              "message": "Practice candidate generation produced invalid structured artifacts."
+            }
+          ]
+        },
+        {
+          "id": "clarification_questions",
+          "node": "llm-prompt",
+          "routingGroup": "planning",
+          "prompt": {
+            "templateRef": "playbook-questions",
+            "vars": {
+              "repo_inventory_json_file": { "artifact": { "kind": "repo-inventory-json-file", "taskKey": { "ref": "params.taskKey" } } },
+              "practice_candidates_json_file": { "artifact": { "kind": "practice-candidates-json-file", "taskKey": { "ref": "params.taskKey" } } },
+              "playbook_questions_json_file": { "artifact": { "kind": "playbook-questions-json-file", "taskKey": { "ref": "params.taskKey" } } }
+            },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "format": "task-prompt"
+          },
+          "params": {
+            "labelText": { "const": "Generating targeted playbook questions" },
+            "model": { "ref": "params.llmModel" },
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "list": [
+                { "artifact": { "kind": "playbook-questions-json-file", "taskKey": { "ref": "params.taskKey" } } }
+              ]
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "when": { "not": { "ref": "context.dryRun" } },
+              "items": [
+                { "path": { "artifact": { "kind": "playbook-questions-json-file", "taskKey": { "ref": "params.taskKey" } } }, "schemaId": "playbook-questions/v1" }
+              ],
+              "message": "Playbook question generation produced invalid structured artifacts."
+            }
+          ]
+        },
+        {
+          "id": "user_answers",
+          "node": "playbook-questions-form",
+          "params": {
+            "questionsJsonFile": { "artifact": { "kind": "playbook-questions-json-file", "taskKey": { "ref": "params.taskKey" } } },
+            "answersJsonFile": { "artifact": { "kind": "playbook-answers-json-file", "taskKey": { "ref": "params.taskKey" } } },
+            "formId": { "const": "playbook-clarifications" },
+            "title": { "const": "Playbook Clarifications" },
+            "mode": { "const": "clarifications" },
+            "acceptDraft": { "ref": "params.acceptPlaybookDraft" }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                { "path": { "artifact": { "kind": "playbook-answers-json-file", "taskKey": { "ref": "params.taskKey" } } }, "schemaId": "playbook-answers/v1" }
+              ],
+              "message": "Playbook answers are missing or invalid."
+            }
+          ]
+        },
+        {
+          "id": "playbook_draft",
+          "node": "llm-prompt",
+          "routingGroup": "planning",
+          "prompt": {
+            "templateRef": "playbook-draft",
+            "vars": {
+              "repo_inventory_json_file": { "artifact": { "kind": "repo-inventory-json-file", "taskKey": { "ref": "params.taskKey" } } },
+              "practice_candidates_json_file": { "artifact": { "kind": "practice-candidates-json-file", "taskKey": { "ref": "params.taskKey" } } },
+              "playbook_questions_json_file": { "artifact": { "kind": "playbook-questions-json-file", "taskKey": { "ref": "params.taskKey" } } },
+              "playbook_answers_json_file": { "artifact": { "kind": "playbook-answers-json-file", "taskKey": { "ref": "params.taskKey" } } },
+              "playbook_draft_json_file": { "artifact": { "kind": "playbook-draft-json-file", "taskKey": { "ref": "params.taskKey" } } },
+              "playbook_draft_file": { "artifact": { "kind": "playbook-draft-file", "taskKey": { "ref": "params.taskKey" } } }
+            },
+            "extraPrompt": { "ref": "params.extraPrompt" },
+            "format": "task-prompt"
+          },
+          "params": {
+            "labelText": { "const": "Generating playbook draft" },
+            "model": { "ref": "params.llmModel" },
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "list": [
+                { "artifact": { "kind": "playbook-draft-json-file", "taskKey": { "ref": "params.taskKey" } } },
+                { "artifact": { "kind": "playbook-draft-file", "taskKey": { "ref": "params.taskKey" } } }
+              ]
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "when": { "not": { "ref": "context.dryRun" } },
+              "items": [
+                { "path": { "artifact": { "kind": "playbook-draft-json-file", "taskKey": { "ref": "params.taskKey" } } }, "schemaId": "playbook-draft/v1" }
+              ],
+              "message": "Playbook draft generation produced invalid structured artifacts."
+            }
+          ]
+        },
+        {
+          "id": "acceptance_confirmation",
+          "node": "playbook-questions-form",
+          "params": {
+            "questionsJsonFile": { "artifact": { "kind": "playbook-questions-json-file", "taskKey": { "ref": "params.taskKey" } } },
+            "answersJsonFile": { "artifact": { "kind": "playbook-answers-json-file", "taskKey": { "ref": "params.taskKey" } } },
+            "formId": { "const": "playbook-final-acceptance" },
+            "title": { "const": "Playbook Final Acceptance" },
+            "mode": { "const": "acceptance" },
+            "acceptDraft": { "ref": "params.acceptPlaybookDraft" }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                { "path": { "artifact": { "kind": "playbook-answers-json-file", "taskKey": { "ref": "params.taskKey" } } }, "schemaId": "playbook-answers/v1" }
+              ],
+              "message": "Playbook final acceptance is missing or invalid."
+            }
+          ]
+        },
+        {
+          "id": "write_playbook",
+          "node": "playbook-write",
+          "params": {
+            "draftJsonFile": { "artifact": { "kind": "playbook-draft-json-file", "taskKey": { "ref": "params.taskKey" } } },
+            "answersJsonFile": { "artifact": { "kind": "playbook-answers-json-file", "taskKey": { "ref": "params.taskKey" } } },
+            "writeResultJsonFile": { "artifact": { "kind": "playbook-write-result-json-file", "taskKey": { "ref": "params.taskKey" } } }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                { "path": { "artifact": { "kind": "playbook-write-result-json-file", "taskKey": { "ref": "params.taskKey" } } }, "schemaId": "playbook-write-result/v1" }
+              ],
+              "message": "Playbook write result is missing or invalid."
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

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

@@ -147,7 +147,9 @@
                   "taskKey": { "ref": "params.taskKey" },
                   "iteration": { "ref": "params.latestIteration" }
                 }
-              }
+              },
+              "project_guidance_file": { "ref": "params.projectGuidanceFile" },
+              "project_guidance_json_file": { "ref": "params.projectGuidanceJsonFile" }
             },
             "extraPrompt": {
               "appendPrompt": {

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

@@ -38,6 +38,8 @@
             "taskKey": { "ref": "params.taskKey" },
             "iteration": { "ref": "params.baseIteration" },
             "extraPrompt": { "ref": "params.extraPrompt" },
+            "projectGuidanceFile": { "ref": "params.projectGuidanceFile" },
+            "projectGuidanceJsonFile": { "ref": "params.projectGuidanceJsonFile" },
             "reviewBlockingSeverities": { "ref": "params.reviewBlockingSeverities" },
             "llmModel": { "ref": "params.llmModel" },
             "llmExecutor": { "ref": "params.llmExecutor" }
@@ -164,6 +166,8 @@
             },
             "reviewFixPoints": { "ref": "params.reviewFixPoints" },
             "reviewBlockingSeverities": { "ref": "params.reviewBlockingSeverities" },
+            "projectGuidanceFile": { "ref": "params.repairProjectGuidanceFile" },
+            "projectGuidanceJsonFile": { "ref": "params.repairProjectGuidanceJsonFile" },
             "extraPrompt": {
               "appendPrompt": {
                 "base": { "ref": "params.extraPrompt" },