agentweaver 0.1.17 → 0.1.19

package/dist/pipeline/nodes/playbook-write-node.js

@@ -0,0 +1,243 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { buildLogicalKeyForPayload } from "../../artifact-manifest.js";
+import { TaskRunnerError } from "../../errors.js";
+import { loadProjectPlaybook } from "../../runtime/playbook.js";
+import { validateStructuredArtifact, validateStructuredArtifactValue } from "../../structured-artifacts.js";
+function readJson(filePath) {
+    try {
+        return JSON.parse(readFileSync(filePath, "utf8"));
+    }
+    catch (error) {
+        throw new TaskRunnerError(`Failed to read JSON from ${filePath}: ${error.message}`);
+    }
+}
+function finalPlaybookPaths(cwd) {
+    const dir = path.join(cwd, ".agentweaver", "playbook");
+    return {
+        dir,
+        manifestFile: path.join(dir, "manifest.yaml"),
+        projectFile: path.join(dir, "project.md"),
+        practiceFile: path.join(dir, "practices", "generated-rules.md"),
+        exampleFile: path.join(dir, "examples", "generated-example.md"),
+        templateFile: path.join(dir, "templates", "default.md"),
+    };
+}
+function detectExistingState(cwd, manifestFile) {
+    if (!existsSync(manifestFile)) {
+        return { status: "absent", blockedPaths: [], message: "No manifest-based playbook exists." };
+    }
+    try {
+        loadProjectPlaybook(cwd);
+        return { status: "accepted", blockedPaths: [manifestFile], message: "A valid manifest-based playbook already exists." };
+    }
+    catch (error) {
+        return {
+            status: "blocked",
+            blockedPaths: [manifestFile],
+            message: `Existing manifest-based playbook is invalid or partial: ${error.message}`,
+        };
+    }
+}
+function toFinalPlaybook(draft, draftJsonFile) {
+    const evidence = Array.from(new Set([
+        ...(Array.isArray(draft.evidence_paths) ? draft.evidence_paths : []),
+        ...draft.accepted_rules.flatMap((rule) => rule.evidence_paths),
+    ])).sort((left, right) => left.localeCompare(right));
+    return {
+        status: "accepted",
+        accepted_at: new Date().toISOString(),
+        source_draft_artifact: draftJsonFile,
+        summary: draft.summary,
+        rules: draft.accepted_rules,
+        evidence_paths: evidence,
+    };
+}
+function renderFinalMarkdown(finalPlaybook) {
+    const rules = Array.isArray(finalPlaybook.rules) ? finalPlaybook.rules : [];
+    return [
+        "# Project playbook",
+        "",
+        String(finalPlaybook.summary ?? ""),
+        "",
+        "## Required rules",
+        ...(rules.length === 0
+            ? ["- No accepted required rules."]
+            : rules.map((rule) => `- ${rule.title}: ${rule.rule}\n  Evidence: ${rule.evidence_paths.join(", ")}`)),
+        "",
+    ].join("\n");
+}
+function yamlStringArray(values) {
+    return Array.from(new Set(values.filter((value) => value.trim().length > 0))).sort();
+}
+function quotedYamlString(value) {
+    return JSON.stringify(value);
+}
+function yamlList(values, indent = "") {
+    return values.length > 0 ? values.map((value) => `${indent}- ${quotedYamlString(value)}`) : [`${indent}[]`];
+}
+function renderPracticeMarkdown(draft) {
+    const body = draft.accepted_rules.length === 0
+        ? "No accepted project rules were generated."
+        : draft.accepted_rules.map((rule) => `## ${rule.title}\n\n${rule.rule}\n\nEvidence: ${rule.evidence_paths.join(", ")}`).join("\n\n");
+    return [
+        "---",
+        'id: "practice.generated-rules"',
+        'title: "Generated project rules"',
+        "phases:",
+        ...yamlList(["plan", "design_review", "implement", "review", "repair"], "  "),
+        "priority: 10",
+        'severity: "must"',
+        "related_practices: []",
+        "related_examples: []",
+        "---",
+        "",
+        body,
+        "",
+    ].join("\n");
+}
+function renderExampleMarkdown() {
+    return [
+        "---",
+        'id: "example.generated-guidance"',
+        'title: "Generated guidance reference"',
+        "phases:",
+        ...yamlList(["plan", "design_review", "implement", "review", "repair"], "  "),
+        "priority: 0",
+        'severity: "info"',
+        "related_practices:",
+        ...yamlList(["practice.generated-rules"], "  "),
+        "related_examples: []",
+        "---",
+        "",
+        "Use this entry as a reference marker for generated playbook guidance.",
+        "",
+    ].join("\n");
+}
+function renderManifest(draft) {
+    const evidence = yamlStringArray([
+        ...(Array.isArray(draft.evidence_paths) ? draft.evidence_paths : []),
+        ...draft.accepted_rules.flatMap((rule) => rule.evidence_paths),
+    ]);
+    return [
+        "version: 1",
+        "project:",
+        '  name: "Generated Project Playbook"',
+        "context_budgets:",
+        "  plan: 1200",
+        "  design_review: 1000",
+        "  implement: 1400",
+        "  review: 1000",
+        "  repair: 1000",
+        "practices:",
+        "  paths:",
+        ...yamlList(["practices/generated-rules.md"], "    "),
+        "  globs: []",
+        "examples:",
+        "  paths:",
+        ...yamlList(["examples/generated-example.md"], "    "),
+        "  globs: []",
+        "templates:",
+        "  paths:",
+        ...yamlList(["templates/default.md"], "    "),
+        "  globs: []",
+        "always_include:",
+        ...yamlList(["project.md"], "  "),
+        "selection:",
+        "  include_examples: true",
+        "  max_examples: 1",
+        "evidence_paths:",
+        ...yamlList(evidence, "  "),
+        "",
+    ].join("\n");
+}
+function writeResult(filePath, result) {
+    validateStructuredArtifactValue(result, "playbook-write-result/v1", filePath);
+    mkdirSync(path.dirname(filePath), { recursive: true });
+    writeFileSync(filePath, `${JSON.stringify(result, null, 2)}\n`, "utf8");
+}
+function baseResult(status, message, intendedFiles) {
+    return {
+        status,
+        message,
+        written_files: [],
+        skipped_files: [],
+        existing_playbook_path: "",
+        intended_files: intendedFiles,
+        blocked_paths: [],
+    };
+}
+export const playbookWriteNode = {
+    kind: "playbook-write",
+    version: 1,
+    async run(context, params) {
+        const { dir, manifestFile, projectFile, practiceFile, exampleFile, templateFile } = finalPlaybookPaths(context.cwd);
+        const intendedFiles = [manifestFile, projectFile, practiceFile, exampleFile, templateFile];
+        const answers = existsSync(params.answersJsonFile) ? readJson(params.answersJsonFile) : {};
+        const accepted = answers.final_write_accepted === true;
+        let result;
+        if (!accepted) {
+            result = baseResult("not_accepted", "Final playbook write was not accepted in playbook-answers.json.", intendedFiles);
+            writeResult(params.writeResultJsonFile, result);
+            return { value: { ...result, finalJsonFile: manifestFile, finalMarkdownFile: projectFile, finalManifestFile: manifestFile }, outputs: outputSpecs(context.issueKey, params.writeResultJsonFile) };
+        }
+        if (context.dryRun) {
+            result = baseResult("dry_run_written", "Dry-run mode accepted the generated manifest layout but did not write final playbook files.", intendedFiles);
+            writeResult(params.writeResultJsonFile, result);
+            return { value: { ...result, finalJsonFile: manifestFile, finalMarkdownFile: projectFile, finalManifestFile: manifestFile }, outputs: outputSpecs(context.issueKey, params.writeResultJsonFile) };
+        }
+        const existing = detectExistingState(context.cwd, manifestFile);
+        if (existing.status === "accepted") {
+            result = {
+                ...baseResult("skipped_valid_existing", existing.message, intendedFiles),
+                skipped_files: intendedFiles,
+                existing_playbook_path: manifestFile,
+            };
+            writeResult(params.writeResultJsonFile, result);
+            return { value: { ...result, finalJsonFile: manifestFile, finalMarkdownFile: projectFile, finalManifestFile: manifestFile }, outputs: outputSpecs(context.issueKey, params.writeResultJsonFile) };
+        }
+        if (existing.status === "blocked") {
+            result = {
+                ...baseResult("blocked", existing.message, intendedFiles),
+                blocked_paths: existing.blockedPaths,
+            };
+            writeResult(params.writeResultJsonFile, result);
+            return { value: { ...result, finalJsonFile: manifestFile, finalMarkdownFile: projectFile, finalManifestFile: manifestFile }, outputs: outputSpecs(context.issueKey, params.writeResultJsonFile) };
+        }
+        validateStructuredArtifact(params.draftJsonFile, "playbook-draft/v1");
+        const draft = readJson(params.draftJsonFile);
+        const finalPlaybook = toFinalPlaybook(draft, params.draftJsonFile);
+        mkdirSync(dir, { recursive: true });
+        mkdirSync(path.dirname(practiceFile), { recursive: true });
+        mkdirSync(path.dirname(exampleFile), { recursive: true });
+        mkdirSync(path.dirname(templateFile), { recursive: true });
+        writeFileSync(manifestFile, renderManifest(draft), "utf8");
+        writeFileSync(projectFile, renderFinalMarkdown(finalPlaybook), "utf8");
+        writeFileSync(practiceFile, renderPracticeMarkdown(draft), "utf8");
+        writeFileSync(exampleFile, renderExampleMarkdown(), "utf8");
+        writeFileSync(templateFile, "# Default Template\n", "utf8");
+        loadProjectPlaybook(context.cwd);
+        result = {
+            ...baseResult("written", "Accepted playbook was written to the canonical manifest.yaml layout.", intendedFiles),
+            written_files: intendedFiles,
+        };
+        writeResult(params.writeResultJsonFile, result);
+        return { value: { ...result, finalJsonFile: manifestFile, finalMarkdownFile: projectFile, finalManifestFile: manifestFile }, outputs: outputSpecs(context.issueKey, params.writeResultJsonFile) };
+    },
+};
+function outputSpecs(scopeKey, writeResultJsonFile) {
+    return [
+        {
+            kind: "artifact",
+            path: writeResultJsonFile,
+            required: true,
+            manifest: {
+                publish: true,
+                logicalKey: buildLogicalKeyForPayload(scopeKey, writeResultJsonFile),
+                payloadFamily: "structured-json",
+                schemaId: "playbook-write-result/v1",
+                schemaVersion: 1,
+            },
+        },
+    ];
+}

package/dist/pipeline/nodes/project-guidance-node.js

@@ -0,0 +1,69 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { buildLogicalKeyForPayload } from "../../artifact-manifest.js";
+import { TaskRunnerError } from "../../errors.js";
+import { buildProjectGuidance, renderProjectGuidanceMarkdown } from "../../runtime/project-guidance.js";
+import { validateStructuredArtifactValue } from "../../structured-artifacts.js";
+function readTaskContext(filePath) {
+    try {
+        return JSON.parse(readFileSync(filePath, "utf8"));
+    }
+    catch (error) {
+        throw new TaskRunnerError(`Failed to read task context JSON ${filePath}: ${error.message}`);
+    }
+}
+export const projectGuidanceNode = {
+    kind: "project-guidance",
+    version: 1,
+    async run(context, params) {
+        const taskContext = readTaskContext(params.taskContextJsonFile);
+        const guidance = buildProjectGuidance({
+            projectRoot: context.cwd,
+            taskContext,
+            phase: params.phase,
+            ...(params.budgetLimit !== undefined ? { budgetLimit: params.budgetLimit } : {}),
+            ...(params.inlineThreshold !== undefined ? { inlineThreshold: params.inlineThreshold } : {}),
+            invalidPlaybookPolicy: params.invalidPlaybookPolicy ?? "fail_before_prompt",
+        });
+        validateStructuredArtifactValue(guidance, "project-guidance/v1", params.outputJsonFile);
+        mkdirSync(path.dirname(params.outputJsonFile), { recursive: true });
+        writeFileSync(params.outputJsonFile, `${JSON.stringify(guidance, null, 2)}\n`, "utf8");
+        const markdown = renderProjectGuidanceMarkdown(guidance, params.markdownLanguage ?? context.mdLang ?? "en");
+        mkdirSync(path.dirname(params.outputFile), { recursive: true });
+        writeFileSync(params.outputFile, markdown, "utf8");
+        return {
+            value: {
+                status: guidance.status,
+                phase: guidance.phase,
+                outputJsonFile: params.outputJsonFile,
+                outputFile: params.outputFile,
+            },
+            outputs: [
+                {
+                    kind: "artifact",
+                    path: params.outputJsonFile,
+                    required: true,
+                    manifest: {
+                        publish: true,
+                        logicalKey: buildLogicalKeyForPayload(context.issueKey, params.outputJsonFile),
+                        payloadFamily: "structured-json",
+                        schemaId: "project-guidance/v1",
+                        schemaVersion: 1,
+                    },
+                },
+                {
+                    kind: "artifact",
+                    path: params.outputFile,
+                    required: true,
+                    manifest: {
+                        publish: true,
+                        logicalKey: buildLogicalKeyForPayload(context.issueKey, params.outputFile),
+                        payloadFamily: "markdown",
+                        schemaId: "markdown/v1",
+                        schemaVersion: 1,
+                    },
+                },
+            ],
+        };
+    },
+};

package/dist/pipeline/prompt-registry.js

@@ -1,4 +1,4 @@
-import { BUG_ANALYZE_PROMPT_TEMPLATE, COMMIT_MESSAGE_PROMPT_TEMPLATE, DESIGN_REVIEW_PROMPT_TEMPLATE, GITLAB_DIFF_REVIEW_PROMPT_TEMPLATE, GITLAB_REVIEW_PROMPT_TEMPLATE, BUG_FIX_PROMPT_TEMPLATE, IMPLEMENT_PROMPT_TEMPLATE, JIRA_DESCRIPTION_PROMPT_TEMPLATE, MR_DESCRIPTION_PROMPT_TEMPLATE, PLAN_PROMPT_TEMPLATE, PLAN_QUESTIONS_PROMPT_TEMPLATE, PLAN_REVISE_PROMPT_TEMPLATE, REVIEW_FIX_PROMPT_TEMPLATE, REVIEW_PROJECT_PROMPT_TEMPLATE, REVIEW_PROMPT_TEMPLATE, REVIEW_SUMMARY_PROMPT_TEMPLATE, RUN_GO_LINTER_LOOP_FIX_PROMPT_TEMPLATE, RUN_GO_TESTS_LOOP_FIX_PROMPT_TEMPLATE, TASK_CONTEXT_FROM_JIRA_PROMPT_TEMPLATE, TASK_CONTEXT_FROM_MANUAL_PROMPT_TEMPLATE, TASK_SUMMARY_PROMPT_TEMPLATE, } from "../prompts.js";
+import { BUG_ANALYZE_PROMPT_TEMPLATE, COMMIT_MESSAGE_PROMPT_TEMPLATE, DESIGN_REVIEW_PROMPT_TEMPLATE, GITLAB_DIFF_REVIEW_PROMPT_TEMPLATE, GITLAB_REVIEW_PROMPT_TEMPLATE, BUG_FIX_PROMPT_TEMPLATE, IMPLEMENT_PROMPT_TEMPLATE, JIRA_DESCRIPTION_PROMPT_TEMPLATE, MR_DESCRIPTION_PROMPT_TEMPLATE, PLAN_PROMPT_TEMPLATE, PLAN_QUESTIONS_PROMPT_TEMPLATE, PLAYBOOK_DRAFT_PROMPT_TEMPLATE, PLAYBOOK_PRACTICE_CANDIDATES_PROMPT_TEMPLATE, PLAYBOOK_QUESTIONS_PROMPT_TEMPLATE, PLAN_REVISE_PROMPT_TEMPLATE, REVIEW_FIX_PROMPT_TEMPLATE, REVIEW_PROJECT_PROMPT_TEMPLATE, REVIEW_PROMPT_TEMPLATE, REVIEW_SUMMARY_PROMPT_TEMPLATE, RUN_GO_LINTER_LOOP_FIX_PROMPT_TEMPLATE, RUN_GO_TESTS_LOOP_FIX_PROMPT_TEMPLATE, TASK_CONTEXT_FROM_JIRA_PROMPT_TEMPLATE, TASK_CONTEXT_FROM_MANUAL_PROMPT_TEMPLATE, TASK_SUMMARY_PROMPT_TEMPLATE, } from "../prompts.js";
 const promptTemplates = {
     "bug-analyze": BUG_ANALYZE_PROMPT_TEMPLATE,
     "bug-fix": BUG_FIX_PROMPT_TEMPLATE,
@@ -10,6 +10,9 @@ const promptTemplates = {
     "task-describe": JIRA_DESCRIPTION_PROMPT_TEMPLATE,
     "mr-description": MR_DESCRIPTION_PROMPT_TEMPLATE,
     "plan-questions": PLAN_QUESTIONS_PROMPT_TEMPLATE,
+    "playbook-draft": PLAYBOOK_DRAFT_PROMPT_TEMPLATE,
+    "playbook-practice-candidates": PLAYBOOK_PRACTICE_CANDIDATES_PROMPT_TEMPLATE,
+    "playbook-questions": PLAYBOOK_QUESTIONS_PROMPT_TEMPLATE,
     plan: PLAN_PROMPT_TEMPLATE,
     "plan-revise": PLAN_REVISE_PROMPT_TEMPLATE,
     review: REVIEW_PROMPT_TEMPLATE,

package/dist/pipeline/prompt-runtime.js

@@ -18,10 +18,14 @@ export function renderPrompt(binding, context) {
     const jsonInstruction = STRUCTURED_JSON_LANGUAGE_INSTRUCTION.trim();
     let langInstruction = null;
     if (mdLang === "en") {
-        langInstruction = "Generate all markdown output files in English language.";
+        langInstruction =
+            "Generate workflow markdown artifact files in English language. " +
+                "This language setting applies only to generated AgentWeaver artifacts, not to repository source files, code comments, committed documentation, or project-local playbook rules.";
     }
     else if (mdLang === "ru" || mdLang === null || mdLang === undefined) {
-        langInstruction = "Generate all markdown output files in Russian language.";
+        langInstruction =
+            "Generate workflow markdown artifact files in Russian language. " +
+                "This language setting applies only to generated AgentWeaver artifacts, not to repository source files, code comments, committed documentation, or project-local playbook rules.";
     }
     const finalExtraPrompt = [extraPrompt, jsonInstruction, langInstruction].filter(Boolean).join("\n");
     if ((binding.format ?? "task-prompt") === "plain") {

package/dist/pipeline/spec-types.js

@@ -25,11 +25,30 @@ export const ARTIFACT_REF_KINDS = [
     "mr-description-json-file",
     "planning-answers-json-file",
     "planning-questions-json-file",
+    "playbook-answers-json-file",
+    "playbook-draft-file",
+    "playbook-draft-json-file",
+    "playbook-questions-json-file",
+    "playbook-write-result-json-file",
     "plan-file",
     "plan-json-file",
     "qa-file",
     "qa-json-file",
+    "practice-candidates-file",
+    "practice-candidates-json-file",
+    "project-guidance-plan-file",
+    "project-guidance-plan-json-file",
+    "project-guidance-design-review-file",
+    "project-guidance-design-review-json-file",
+    "project-guidance-implement-file",
+    "project-guidance-implement-json-file",
+    "project-guidance-review-file",
+    "project-guidance-review-json-file",
+    "project-guidance-repair-review-fix-file",
+    "project-guidance-repair-review-fix-json-file",
     "ready-to-merge-file",
+    "repo-inventory-file",
+    "repo-inventory-json-file",
     "review-file",
     "review-json-file",
     "review-assessment-file",

package/dist/pipeline/value-resolver.js

@@ -1,5 +1,5 @@
 import { existsSync } from "node:fs";
-import { artifactFile, bugAnalyzeArtifacts, bugAnalyzeFile, bugAnalyzeJsonFile, bugFixDesignFile, bugFixDesignJsonFile, bugFixPlanFile, bugFixPlanJsonFile, designFile, designJsonFile, designReviewFile, designReviewJsonFile, gitlabDiffFile, gitlabDiffJsonFile, gitlabDiffReviewInputJsonFile, gitlabReviewFile, gitlabReviewInputJsonFile, gitlabReviewJsonFile, jiraAttachmentsContextFile, jiraAttachmentsManifestFile, jiraDescriptionFile, jiraDescriptionJsonFile, instantTaskInputJsonFile, jiraTaskFile, mrDescriptionFile, mrDescriptionJsonFile, planningAnswersJsonFile, planningQuestionsJsonFile, planArtifacts, planFile, planJsonFile, qaFile, qaJsonFile, readyToMergeFile, reviewAssessmentFile, reviewAssessmentJsonFile, reviewFile, reviewFixFile, reviewFixJsonFile, reviewJsonFile, runGoLinterResultJsonFile, runGoTestsResultJsonFile, taskSummaryFile, taskDescribeInputJsonFile, taskSummaryJsonFile, taskContextFile, taskContextJsonFile, gitStatusJsonFile, gitCommitMessageJsonFile, gitCommitInputJsonFile, selectFilesOutputJsonFile, commitMessageOutputJsonFile, gitDiffFile as gitDiffFileHelper, } from "../artifacts.js";
+import { artifactFile, bugAnalyzeArtifacts, bugAnalyzeFile, bugAnalyzeJsonFile, bugFixDesignFile, bugFixDesignJsonFile, bugFixPlanFile, bugFixPlanJsonFile, designFile, designJsonFile, designReviewFile, designReviewJsonFile, gitlabDiffFile, gitlabDiffJsonFile, gitlabDiffReviewInputJsonFile, gitlabReviewFile, gitlabReviewInputJsonFile, gitlabReviewJsonFile, jiraAttachmentsContextFile, jiraAttachmentsManifestFile, jiraDescriptionFile, jiraDescriptionJsonFile, instantTaskInputJsonFile, jiraTaskFile, mrDescriptionFile, mrDescriptionJsonFile, playbookAnswersJsonFile, playbookDraftFile, playbookDraftJsonFile, playbookQuestionsJsonFile, playbookWriteResultJsonFile, planningAnswersJsonFile, planningQuestionsJsonFile, planArtifacts, planFile, planJsonFile, practiceCandidatesFile, practiceCandidatesJsonFile, projectGuidanceFile, projectGuidanceJsonFile, qaFile, qaJsonFile, readyToMergeFile, repoInventoryFile, repoInventoryJsonFile, reviewAssessmentFile, reviewAssessmentJsonFile, reviewFile, reviewFixFile, reviewFixJsonFile, reviewJsonFile, runGoLinterResultJsonFile, runGoTestsResultJsonFile, taskSummaryFile, taskDescribeInputJsonFile, taskSummaryJsonFile, taskContextFile, taskContextJsonFile, gitStatusJsonFile, gitCommitMessageJsonFile, gitCommitInputJsonFile, selectFilesOutputJsonFile, commitMessageOutputJsonFile, gitDiffFile as gitDiffFileHelper, } from "../artifacts.js";
 import { TaskRunnerError } from "../errors.js";
 import { formatTemplate } from "../prompts.js";
 function readStepRef(segments, context, originalPath) {
@@ -130,16 +130,54 @@ function resolveArtifact(spec, context) {
             return planningAnswersJsonFile(taskKey);
         case "planning-questions-json-file":
             return planningQuestionsJsonFile(taskKey);
+        case "playbook-answers-json-file":
+            return playbookAnswersJsonFile(taskKey);
+        case "playbook-draft-file":
+            return playbookDraftFile(taskKey);
+        case "playbook-draft-json-file":
+            return playbookDraftJsonFile(taskKey);
+        case "playbook-questions-json-file":
+            return playbookQuestionsJsonFile(taskKey);
+        case "playbook-write-result-json-file":
+            return playbookWriteResultJsonFile(taskKey);
         case "plan-file":
             return planFile(taskKey, iteration);
         case "plan-json-file":
             return planJsonFile(taskKey, iteration);
+        case "practice-candidates-file":
+            return practiceCandidatesFile(taskKey);
+        case "practice-candidates-json-file":
+            return practiceCandidatesJsonFile(taskKey);
+        case "project-guidance-plan-file":
+            return projectGuidanceFile(taskKey, "plan", iteration);
+        case "project-guidance-plan-json-file":
+            return projectGuidanceJsonFile(taskKey, "plan", iteration);
+        case "project-guidance-design-review-file":
+            return projectGuidanceFile(taskKey, "design-review", iteration);
+        case "project-guidance-design-review-json-file":
+            return projectGuidanceJsonFile(taskKey, "design-review", iteration);
+        case "project-guidance-implement-file":
+            return projectGuidanceFile(taskKey, "implement", iteration);
+        case "project-guidance-implement-json-file":
+            return projectGuidanceJsonFile(taskKey, "implement", iteration);
+        case "project-guidance-review-file":
+            return projectGuidanceFile(taskKey, "review", iteration);
+        case "project-guidance-review-json-file":
+            return projectGuidanceJsonFile(taskKey, "review", iteration);
+        case "project-guidance-repair-review-fix-file":
+            return projectGuidanceFile(taskKey, "repair/review-fix", iteration);
+        case "project-guidance-repair-review-fix-json-file":
+            return projectGuidanceJsonFile(taskKey, "repair/review-fix", iteration);
         case "qa-file":
             return qaFile(taskKey, iteration);
         case "qa-json-file":
             return qaJsonFile(taskKey, iteration);
         case "ready-to-merge-file":
             return readyToMergeFile(taskKey);
+        case "repo-inventory-file":
+            return repoInventoryFile(taskKey);
+        case "repo-inventory-json-file":
+            return repoInventoryJsonFile(taskKey);
         case "review-file":
             if (iteration === undefined) {
                 throw new TaskRunnerError("review-file requires iteration");

package/dist/playbook/practice-candidates.js

@@ -0,0 +1,12 @@
+import { TaskRunnerError } from "../errors.js";
+const CONFIDENCE_VALUES = new Set(["low", "medium", "high"]);
+export function validatePracticeCandidatesArtifact(artifact) {
+    for (const candidate of artifact.candidates) {
+        if (!CONFIDENCE_VALUES.has(candidate.confidence)) {
+            throw new TaskRunnerError(`Practice candidate '${candidate.id}' has unsupported confidence '${candidate.confidence}'.`);
+        }
+        if (!Array.isArray(candidate.evidence_paths) || candidate.evidence_paths.length === 0) {
+            throw new TaskRunnerError(`Practice candidate '${candidate.id}' must cite at least one evidence path.`);
+        }
+    }
+}