agentweaver 0.1.16 → 0.1.18

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",
@@ -258,7 +262,8 @@
             "requiredArtifacts": {
               "artifactList": {
                 "kind": "plan-artifacts",
-                "taskKey": { "ref": "params.taskKey" }
+                "taskKey": { "ref": "params.taskKey" },
+                "iteration": { "ref": "params.planIteration" }
               }
             }
           },
@@ -269,7 +274,8 @@
               "paths": {
                 "artifactList": {
                   "kind": "plan-artifacts",
-                  "taskKey": { "ref": "params.taskKey" }
+                  "taskKey": { "ref": "params.taskKey" },
+                  "iteration": { "ref": "params.planIteration" }
                 }
               },
               "message": "Plan mode did not produce the required artifacts."

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

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

@@ -20,6 +20,8 @@
               "design_json_file": { "ref": "params.designJsonFile" },
               "plan_file": { "ref": "params.planFile" },
               "plan_json_file": { "ref": "params.planJsonFile" },
+              "project_guidance_file": { "ref": "params.projectGuidanceFile" },
+              "project_guidance_json_file": { "ref": "params.projectGuidanceJsonFile" },
               "review_file": {
                 "artifact": {
                   "kind": "review-file",

package/dist/pipeline/launch-profile-config.js

@@ -1,32 +1,44 @@
-export const LLM_EXECUTOR_IDS = ["codex", "opencode"];
-export const ALLOWED_MODELS_BY_EXECUTOR = {
-    codex: ["gpt-5.4", "gpt-5.4-mini", "gpt-5.3-codex"],
-    opencode: ["opencode/minimax-m2.5-free", "minimax-coding-plan/MiniMax-M2.7", "zhipuai-coding-plan/glm-5.1", "zhipuai-coding-plan/glm-4.7"],
-};
+import { createExecutorRegistry } from "./registry.js";
+const BUILT_IN_EXECUTOR_REGISTRY = createExecutorRegistry();
 export const DEFAULT_EXECUTOR = "opencode";
-export const DEFAULT_MODEL_BY_EXECUTOR = {
-    codex: "gpt-5.4",
-    opencode: "minimax-coding-plan/MiniMax-M2.7",
-};
 export const DEFAULT_LAUNCH_PROFILE = {
     executor: DEFAULT_EXECUTOR,
-    model: DEFAULT_MODEL_BY_EXECUTOR[DEFAULT_EXECUTOR],
+    model: "minimax-coding-plan/MiniMax-M2.7",
 };
-export function defaultModelForExecutor(executor) {
-    return DEFAULT_MODEL_BY_EXECUTOR[executor];
+function registryOrBuiltIn(executors) {
+    return executors ?? BUILT_IN_EXECUTOR_REGISTRY;
+}
+export function llmExecutorIds(executors) {
+    return registryOrBuiltIn(executors).llmExecutors().map((entry) => entry.id);
+}
+export function defaultModelForExecutor(executor, executors) {
+    const routing = registryOrBuiltIn(executors).getRouting(executor);
+    if (!routing || routing.kind !== "llm") {
+        throw new Error(`Unsupported llm executor '${executor}'.`);
+    }
+    return routing.defaultModel;
+}
+export function isLlmExecutorId(value, executors) {
+    const routing = registryOrBuiltIn(executors).getRouting(value);
+    return routing?.kind === "llm";
 }
-export function isLlmExecutorId(value) {
-    return LLM_EXECUTOR_IDS.includes(value);
+export function isAllowedModelForExecutor(executor, model, executors) {
+    const routing = registryOrBuiltIn(executors).getRouting(executor);
+    return routing?.kind === "llm" ? routing.models.includes(model) : false;
 }
-export function isAllowedModelForExecutor(executor, model) {
-    return ALLOWED_MODELS_BY_EXECUTOR[executor].includes(model);
+export function allowedModelsForExecutor(executor, executors) {
+    const routing = registryOrBuiltIn(executors).getRouting(executor);
+    if (!routing || routing.kind !== "llm") {
+        throw new Error(`Unsupported llm executor '${executor}'.`);
+    }
+    return [...routing.models];
 }
-export function resolveLaunchProfile(selection, fallback = DEFAULT_LAUNCH_PROFILE) {
+export function resolveLaunchProfile(selection, fallback = DEFAULT_LAUNCH_PROFILE, executors) {
     const executor = selection.executor === "default" ? fallback.executor : selection.executor;
     const model = selection.model === "default"
         ? selection.executor === "default"
             ? fallback.model
-            : defaultModelForExecutor(executor)
+            : defaultModelForExecutor(executor, executors)
         : selection.model;
     return {
         executor,

package/dist/pipeline/node-contract.js

@@ -0,0 +1 @@
+export {};

package/dist/pipeline/node-registry.js

@@ -21,8 +21,13 @@ import { localScriptCheckNode } from "./nodes/local-script-check-node.js";
 import { llmPromptNode } from "./nodes/llm-prompt-node.js";
 import { opencodePromptNode } from "./nodes/opencode-prompt-node.js";
 import { planCodexNode } from "./nodes/plan-codex-node.js";
+import { playbookInventoryNode } from "./nodes/playbook-inventory-node.js";
+import { playbookEnsureNode } from "./nodes/playbook-ensure-node.js";
+import { playbookQuestionsFormNode } from "./nodes/playbook-questions-form-node.js";
+import { playbookWriteNode } from "./nodes/playbook-write-node.js";
 import { planningBundleNode } from "./nodes/planning-bundle-node.js";
 import { planningQuestionsFormNode } from "./nodes/planning-questions-form-node.js";
+import { projectGuidanceNode } from "./nodes/project-guidance-node.js";
 import { readFileNode } from "./nodes/read-file-node.js";
 import { reviewFindingsFormNode } from "./nodes/review-findings-form-node.js";
 import { reviewVerdictNode } from "./nodes/review-verdict-node.js";
@@ -32,6 +37,48 @@ import { summaryFileLoadNode } from "./nodes/summary-file-load-node.js";
 import { telegramNotifierNode } from "./nodes/telegram-notifier-node.js";
 import { userInputNode } from "./nodes/user-input-node.js";
 import { writeSelectionFileNode } from "./nodes/write-selection-file-node.js";
+import { TaskRunnerError } from "../errors.js";
+export const BUILT_IN_NODE_KINDS = [
+    "build-failure-summary",
+    "build-review-fix-prompt",
+    "clear-ready-to-merge",
+    "codex-prompt",
+    "command-check",
+    "commit-message-form",
+    "design-review-verdict",
+    "ensure-summary-json",
+    "fetch-gitlab-diff",
+    "fetch-gitlab-review",
+    "file-check",
+    "flow-run",
+    "git-commit",
+    "git-commit-form",
+    "git-status",
+    "gitlab-review-artifacts",
+    "jira-context",
+    "jira-fetch",
+    "jira-issue-check",
+    "local-script-check",
+    "llm-prompt",
+    "opencode-prompt",
+    "plan-codex",
+    "playbook-inventory",
+    "playbook-ensure",
+    "playbook-questions-form",
+    "playbook-write",
+    "planning-bundle",
+    "planning-questions-form",
+    "project-guidance",
+    "read-file",
+    "review-findings-form",
+    "review-verdict",
+    "select-files-form",
+    "structured-summary",
+    "summary-file-load",
+    "telegram-notify",
+    "user-input",
+    "write-selection-file",
+];
 const builtInNodes = {
     "build-failure-summary": buildFailureSummaryNode,
     "build-review-fix-prompt": buildReviewFixPromptNode,
@@ -56,8 +103,13 @@ const builtInNodes = {
     "llm-prompt": llmPromptNode,
     "opencode-prompt": opencodePromptNode,
     "plan-codex": planCodexNode,
+    "playbook-inventory": playbookInventoryNode,
+    "playbook-ensure": playbookEnsureNode,
+    "playbook-questions-form": playbookQuestionsFormNode,
+    "playbook-write": playbookWriteNode,
     "planning-bundle": planningBundleNode,
     "planning-questions-form": planningQuestionsFormNode,
+    "project-guidance": projectGuidanceNode,
     "read-file": readFileNode,
     "review-findings-form": reviewFindingsFormNode,
     "review-verdict": reviewVerdictNode,
@@ -191,6 +243,30 @@ const builtInNodeMetadata = {
         requiredParams: ["prompt", "requiredArtifacts"],
         executors: ["codex"],
     },
+    "playbook-inventory": {
+        kind: "playbook-inventory",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["outputJsonFile", "outputFile"],
+    },
+    "playbook-ensure": {
+        kind: "playbook-ensure",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["writeResultJsonFile"],
+    },
+    "playbook-questions-form": {
+        kind: "playbook-questions-form",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["questionsJsonFile", "answersJsonFile", "formId", "title"],
+    },
+    "playbook-write": {
+        kind: "playbook-write",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["draftJsonFile", "answersJsonFile", "writeResultJsonFile"],
+    },
     "planning-bundle": {
         kind: "planning-bundle",
         version: 1,
@@ -203,6 +279,12 @@ const builtInNodeMetadata = {
         prompt: "forbidden",
         requiredParams: ["planningQuestionsJsonFile", "formId", "title"],
     },
+    "project-guidance": {
+        kind: "project-guidance",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["taskContextJsonFile", "phase", "outputJsonFile", "outputFile"],
+    },
     "read-file": { kind: "read-file", version: 1, prompt: "forbidden", requiredParams: ["path"] },
     "review-findings-form": {
         kind: "review-findings-form",
@@ -249,19 +331,51 @@ const builtInNodeMetadata = {
         requiredParams: ["outputFile", "reviewFindingsJsonFile", "selectionMode"],
     },
 };
-export function createNodeRegistry() {
+function coreOwner(id) {
+    return {
+        kind: "core",
+        id: `core:${id}`,
+        manifestPath: "built-in node registry",
+    };
+}
+export function createNodeRegistry(pluginNodes = []) {
+    const definitions = new Map(Object.entries(builtInNodes));
+    const metadata = new Map(Object.entries(builtInNodeMetadata));
+    const owners = new Map(Object.keys(builtInNodes).map((id) => [id, coreOwner(id)]));
+    for (const registration of pluginNodes) {
+        const existingOwner = owners.get(registration.id);
+        if (existingOwner) {
+            throw new TaskRunnerError(`Duplicate node id '${registration.id}' conflicts between ${existingOwner.id} (${existingOwner.manifestPath}) and plugin '${registration.pluginId}' (${registration.manifestPath}).`);
+        }
+        definitions.set(registration.id, registration.definition);
+        metadata.set(registration.id, registration.metadata);
+        owners.set(registration.id, {
+            kind: "plugin",
+            id: registration.pluginId,
+            manifestPath: registration.manifestPath,
+            entrypointPath: registration.entrypointPath,
+        });
+    }
     return {
         get(kind) {
-            return builtInNodes[kind];
+            const definition = definitions.get(kind);
+            if (!definition) {
+                throw new TaskRunnerError(`Unknown node kind '${kind}'.`);
+            }
+            return definition;
         },
         getMeta(kind) {
-            return builtInNodeMetadata[kind];
+            const definition = metadata.get(kind);
+            if (!definition) {
+                throw new TaskRunnerError(`Unknown node metadata '${kind}'.`);
+            }
+            return definition;
         },
         has(kind) {
-            return kind in builtInNodes;
+            return definitions.has(kind);
         },
         kinds() {
-            return Object.keys(builtInNodes);
+            return [...definitions.keys()];
         },
     };
 }