agentweaver 0.1.15 → 0.1.17

package/dist/pipeline/spec-validator.js

@@ -1,6 +1,7 @@
 import { TaskRunnerError } from "../errors.js";
 import { STRUCTURED_ARTIFACT_SCHEMA_IDS } from "../structured-artifacts.js";
 import { isPromptTemplateRef } from "./prompt-registry.js";
+import { EXECUTION_ROUTING_GROUPS } from "./execution-routing-config.js";
 import { ARTIFACT_LIST_REF_KINDS as artifactListRefKinds, ARTIFACT_REF_KINDS as artifactRefKinds, } from "./spec-types.js";
 function isArtifactRefKind(value) {
     return artifactRefKinds.includes(value);
@@ -18,6 +19,9 @@ function validateArtifactRefSpec(spec, path) {
 function validateArtifactListRefSpec(spec, path) {
     assert(isArtifactListRefKind(spec.kind), `Unknown artifact list kind '${spec.kind}' at ${path}.kind`);
     validateValueSpec(spec.taskKey, `${path}.taskKey`);
+    if (spec.iteration) {
+        validateValueSpec(spec.iteration, `${path}.iteration`);
+    }
 }
 function assert(condition, message) {
     if (!condition) {
@@ -102,6 +106,10 @@ function validateStep(step, nodeRegistry, executorRegistry, path, options) {
         assert(executorRegistry.has(executorId), `Unknown executor '${executorId}' required by node '${step.node}' at ${path}.node`);
     }
     validateCondition(step.when, `${path}.when`);
+    if (step.routingGroup) {
+        assert(step.node === "llm-prompt", `routingGroup is only supported for llm-prompt steps at ${path}.routingGroup`);
+        assert(EXECUTION_ROUTING_GROUPS.includes(step.routingGroup), `Unknown routingGroup '${step.routingGroup}' at ${path}.routingGroup`);
+    }
     if (step.prompt) {
         assert(nodeMeta.prompt !== "forbidden", `Node '${step.node}' does not accept prompt binding at ${path}.prompt`);
         assert(Boolean(step.prompt.templateRef || step.prompt.inlineTemplate), `Prompt binding at ${path}.prompt must define templateRef or inlineTemplate`);
@@ -110,6 +118,9 @@ function validateStep(step, nodeRegistry, executorRegistry, path, options) {
     for (const requiredParam of nodeMeta.requiredParams ?? []) {
         assert(step.params?.[requiredParam] !== undefined, `Node '${step.node}' requires param '${requiredParam}' at ${path}.params.${requiredParam}`);
     }
+    if (step.node === "llm-prompt") {
+        assert(step.routingGroup !== undefined || step.params?.executor !== undefined, `Node 'llm-prompt' requires routingGroup or param 'executor' at ${path}`);
+    }
     if (step.prompt?.templateRef) {
         assert(isPromptTemplateRef(step.prompt.templateRef), `Unknown prompt template '${step.prompt.templateRef}' at ${path}.prompt.templateRef`);
     }
@@ -147,6 +158,9 @@ function validateStep(step, nodeRegistry, executorRegistry, path, options) {
     if (step.stopFlowIf) {
         validateCondition(step.stopFlowIf, `${path}.stopFlowIf`);
     }
+    if (step.stopFlowOutcome) {
+        assert(step.stopFlowOutcome === "success" || step.stopFlowOutcome === "stopped", `Unsupported stopFlowOutcome '${step.stopFlowOutcome}' at ${path}.stopFlowOutcome`);
+    }
     if (step.after) {
         step.after.forEach((action, index) => validateAfterAction(action, `${path}.after[${index}]`));
     }
@@ -230,6 +244,9 @@ function validateExpandedValueSpec(value, phases, currentPhaseIndex, currentStep
     }
     if ("artifactList" in value) {
         validateExpandedValueSpec(value.artifactList.taskKey, phases, currentPhaseIndex, currentStepIndex, `${path}.artifactList.taskKey`, allowCurrentStepRef);
+        if (value.artifactList.iteration) {
+            validateExpandedValueSpec(value.artifactList.iteration, phases, currentPhaseIndex, currentStepIndex, `${path}.artifactList.iteration`, allowCurrentStepRef);
+        }
         return;
     }
     if ("template" in value) {
@@ -281,6 +298,9 @@ function validateExpandedCondition(condition, phases, currentPhaseIndex, current
     }
 }
 export function validateFlowSpec(spec, nodeRegistry, executorRegistry, options = {}) {
+    if (spec.catalogVisibility !== undefined) {
+        assert(spec.catalogVisibility === "visible" || spec.catalogVisibility === "hidden", `Unsupported catalogVisibility '${spec.catalogVisibility}' at flow.catalogVisibility`);
+    }
     assert(spec.kind.trim().length > 0, "Flow spec kind must be non-empty");
     assert(Number.isInteger(spec.version) && spec.version > 0, "Flow spec version must be a positive integer");
     spec.phases.forEach((item, index) => {

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, jiraTaskFile, mrDescriptionFile, mrDescriptionJsonFile, planningAnswersJsonFile, planningQuestionsJsonFile, planArtifacts, planFile, planJsonFile, qaFile, qaJsonFile, readyToMergeFile, reviewAssessmentFile, reviewAssessmentJsonFile, reviewFile, reviewFixFile, reviewFixJsonFile, reviewJsonFile, runGoLinterResultJsonFile, runGoTestsResultJsonFile, taskSummaryFile, taskDescribeInputJsonFile, taskSummaryJsonFile, 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, 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 { TaskRunnerError } from "../errors.js";
 import { formatTemplate } from "../prompts.js";
 function readStepRef(segments, context, originalPath) {
@@ -120,6 +120,8 @@ function resolveArtifact(spec, context) {
             return jiraDescriptionJsonFile(taskKey, iteration);
         case "jira-task-file":
             return jiraTaskFile(taskKey);
+        case "instant-task-input-json-file":
+            return instantTaskInputJsonFile(taskKey);
         case "mr-description-file":
             return mrDescriptionFile(taskKey, iteration);
         case "mr-description-json-file":
@@ -183,6 +185,10 @@ function resolveArtifact(spec, context) {
                 throw new TaskRunnerError("review-summary-file requires iteration");
             }
             return artifactFile("review-summary", taskKey, iteration);
+        case "task-context-file":
+            return taskContextFile(taskKey, iteration);
+        case "task-context-json-file":
+            return taskContextJsonFile(taskKey, iteration);
         case "task-summary-file":
             return taskSummaryFile(taskKey, iteration);
         case "task-summary-json-file":
@@ -205,11 +211,12 @@ function resolveArtifact(spec, context) {
 }
 function resolveArtifactList(spec, context) {
     const taskKey = String(resolveValue(spec.taskKey, context));
+    const iteration = spec.iteration === undefined ? undefined : Number(resolveValue(spec.iteration, context));
     switch (spec.kind) {
         case "bug-analyze-artifacts":
             return bugAnalyzeArtifacts(taskKey);
         case "plan-artifacts":
-            return planArtifacts(taskKey);
+            return planArtifacts(taskKey, iteration);
     }
 }
 export function resolveValue(value, context) {
@@ -263,6 +270,73 @@ export function resolveParams(params, context) {
     }
     return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, resolveValue(value, context)]));
 }
+export const ARTIFACT_LINEAGE_REF_PATHS_PARAM = "__artifactLineageRefPaths";
+function collectAnnotatedRefArtifactPathCandidates(refPath, context) {
+    const annotatedRefPaths = context.flowParams[ARTIFACT_LINEAGE_REF_PATHS_PARAM];
+    if (!annotatedRefPaths || typeof annotatedRefPaths !== "object" || Array.isArray(annotatedRefPaths)) {
+        return [];
+    }
+    const candidate = annotatedRefPaths[refPath];
+    const paths = typeof candidate === "string" ? [candidate] : Array.isArray(candidate) ? candidate : [];
+    return paths.filter((value) => typeof value === "string" && existsSync(value));
+}
+export function collectResolvedArtifactPathCandidates(value, context) {
+    const candidates = new Set();
+    const addCandidate = (candidatePath) => {
+        if (existsSync(candidatePath)) {
+            candidates.add(candidatePath);
+        }
+    };
+    const visit = (current) => {
+        if (!current || "const" in current) {
+            return;
+        }
+        if ("ref" in current) {
+            collectAnnotatedRefArtifactPathCandidates(current.ref, context).forEach((candidatePath) => addCandidate(candidatePath));
+            return;
+        }
+        if ("artifact" in current) {
+            addCandidate(resolveArtifact(current.artifact, context));
+            return;
+        }
+        if ("artifactList" in current) {
+            resolveArtifactList(current.artifactList, context).forEach((candidatePath) => addCandidate(candidatePath));
+            return;
+        }
+        if ("template" in current) {
+            Object.values(current.vars ?? {}).forEach((candidate) => visit(candidate));
+            return;
+        }
+        if ("appendPrompt" in current) {
+            visit(current.appendPrompt.base);
+            visit(current.appendPrompt.suffix);
+            return;
+        }
+        if ("add" in current) {
+            current.add.forEach((candidate) => visit(candidate));
+            return;
+        }
+        if ("concat" in current) {
+            current.concat.forEach((candidate) => visit(candidate));
+            return;
+        }
+        if ("list" in current) {
+            current.list.forEach((candidate) => visit(candidate));
+        }
+    };
+    visit(value);
+    return Array.from(candidates).sort();
+}
+export function collectResolvedPromptArtifactPathCandidates(binding, context) {
+    const candidates = new Set();
+    for (const value of Object.values(binding?.vars ?? {})) {
+        collectResolvedArtifactPathCandidates(value, context).forEach((candidate) => candidates.add(candidate));
+    }
+    if (binding?.extraPrompt) {
+        collectResolvedArtifactPathCandidates(binding.extraPrompt, context).forEach((candidate) => candidates.add(candidate));
+    }
+    return Array.from(candidates).sort();
+}
 function truthy(value) {
     return Boolean(value);
 }

package/dist/plugin-sdk.js

@@ -0,0 +1 @@
+export { AGENTWEAVER_PLUGIN_SDK_VERSION } from "./pipeline/plugin-types.js";

package/dist/prompts.js

@@ -10,12 +10,12 @@ function strictSchemaInstruction(outputFileVar, schemaId) {
         STRUCTURED_JSON_LANGUAGE_INSTRUCTION +
         `Canonical schema:\n${renderStructuredArtifactSchema(schemaId)}\n`);
 }
-export const PLAN_PROMPT_TEMPLATE = "Review and analyze the task in {jira_task_file}. " +
-    "Be sure to analyze additional materials from Jira attachments manifest {jira_attachments_manifest_file} and text context {jira_attachments_context_file}; if an attachment contains more detailed requirements, constraints, file lists, migration strategy, or invariants, treat the attachment as source of truth for planning alongside the Jira issue. " +
+export const PLAN_PROMPT_TEMPLATE = "Review and analyze the normalized task context in {task_context_json_file}. " +
+    "Use planning answers from {planning_answers_json_file} when they exist and treat them as structured user clarifications. " +
     "First create structured JSON artifacts - they are the source of truth for subsequent flows. " +
     "Create human-readable markdown files as detailed derivative representations of these JSON artifacts for the user, not as brief summaries. " +
     "Markdown should not influence JSON structure: first determine the correct JSON types, then build markdown as a derivative representation. " +
-    "Do not collapse specifics from the task and attachments: preserve explicit files, methods, APIs, invariants, migration steps, DB constraints, business rules, and acceptance criteria. " +
+    "Do not collapse specifics from the task context: preserve explicit files, methods, APIs, invariants, migration steps, DB constraints, business rules, acceptance criteria, and constraints. " +
     "Develop a system design for the solution and write JSON to {design_json_file}, then markdown to {design_file}. " +
     strictSchemaInstruction("{design_json_file}", "implementation-design/v1") +
     "Develop a detailed implementation plan and write JSON to {plan_json_file}, then markdown to {plan_file}. " +
@@ -24,14 +24,31 @@ export const PLAN_PROMPT_TEMPLATE = "Review and analyze the task in {jira_task_f
     strictSchemaInstruction("{qa_json_file}", "qa-plan/v1") +
     "Format markdown for design and plan comprehensively, with separate sections for Summary, Current State, Target State, Affected Code, Decisions, Migration/DB Changes, Risks, Implementation Steps, Tests, Rollout. " +
     "JSON files must be valid and contain only JSON without markdown wrapping. ";
-export const PLAN_QUESTIONS_PROMPT_TEMPLATE = "Review and analyze the task in {jira_task_file}. " +
-    "Be sure to analyze additional materials from Jira attachments manifest {jira_attachments_manifest_file} and text context {jira_attachments_context_file}; if an attachment contains more detailed requirements, constraints, file lists, migration strategy, or invariants, treat the attachment as source of truth for planning alongside the Jira issue. " +
+export const PLAN_QUESTIONS_PROMPT_TEMPLATE = "Review and analyze the normalized task context in {task_context_json_file}. " +
     "Before final planning, determine if any clarifications are needed from the user. " +
     strictSchemaInstruction("{planning_questions_json_file}", "planning-questions/v1") +
     "Ask only questions without which the design/plan could be incorrect or too speculative. " +
     "Do not ask obvious, decorative, or duplicate questions. " +
     "Usually 1-5 questions are sufficient. " +
     "The JSON file must be valid and contain only JSON without markdown wrapping. ";
+export const TASK_CONTEXT_FROM_JIRA_PROMPT_TEMPLATE = "Normalize the Jira task context into a connector-agnostic task context. " +
+    "Use Jira issue JSON {jira_task_file} as the primary source of truth. " +
+    "Also analyze Jira attachments manifest {jira_attachments_manifest_file} and attachments text context {jira_attachments_context_file}; if attachments contain more specific requirements, constraints, file lists, migration strategy, or invariants, preserve them in the normalized result. " +
+    "Write the source-of-truth JSON to {task_context_json_file}. " +
+    strictSchemaInstruction("{task_context_json_file}", "task-context/v1") +
+    "Set source_type to 'jira'. " +
+    "Write the derivative markdown version to {task_context_file}. " +
+    "Do not invent metadata that is not supported by Jira content or attachments. " +
+    "Keep JSON semantic fields in English. JSON files must contain only JSON without markdown wrapping.";
+export const TASK_CONTEXT_FROM_MANUAL_PROMPT_TEMPLATE = "Normalize the manual task input into a connector-agnostic task context. " +
+    "Use the structured user input in {task_input_file}. " +
+    "Use values.task_description as the primary source of truth and values.additional_instructions as additional context when present. " +
+    "Do not reshape the input into Jira-like fields or invent Jira metadata. " +
+    "Write the source-of-truth JSON to {task_context_json_file}. " +
+    strictSchemaInstruction("{task_context_json_file}", "task-context/v1") +
+    "Set source_type to 'manual'. " +
+    "Write the derivative markdown version to {task_context_file}. " +
+    "Keep JSON semantic fields in English. JSON files must contain only JSON without markdown wrapping.";
 export const BUG_ANALYZE_PROMPT_TEMPLATE = "Review and analyze the bug in {jira_task_file}. " +
     "First create structured JSON artifacts - they are the source of truth for subsequent flows. " +
     "Create human-readable markdown files as brief derivative representations of these JSON artifacts for the user. " +
@@ -58,15 +75,19 @@ export const IMPLEMENT_PROMPT_TEMPLATE = "Use only structured artifacts as sourc
     "If some QA scenarios cannot be automated in the current change, still implement the code so those scenarios are satisfied and keep them explicit in your reasoning while editing. " +
     "Markdown artifacts such as {design_file}, {plan_file}, and {qa_file} are intended only for human reading and should not define the implementation. ";
 export const REVIEW_PROMPT_TEMPLATE = "Conduct a code review of the current changes. " +
-    "Use only structured artifacts as source of truth: the task in {jira_task_file}, design in {design_json_file}, and plan in {plan_json_file}. " +
+    "Use only structured artifacts as source of truth. " +
+    "Required planning inputs: design markdown {design_file}, design JSON {design_json_file}, plan markdown {plan_file}, and plan JSON {plan_json_file}. " +
+    "Optional task context is provided through these variables and may contain the literal value 'not provided' when absent: normalized task context JSON {task_context_json_file}, Jira task JSON {jira_task_file}, instant-task input JSON {task_input_json_file}. " +
+    "When an optional variable is 'not provided', treat that source as unavailable and do not invent details from it. " +
+    "Evaluate the current code against the available task context and the structured planning artifacts. " +
+    "Use exactly one severity per finding from this list: blocker, critical, high, medium, low, info. " +
     `First write the structured result to {review_json_file}. ${strictSchemaInstruction("{review_json_file}", "review-findings/v1")}` +
-    "Then write the derivative markdown version to {review_file}. " +
-    "If ready_to_merge=true and there are no blockers preventing merge - create the ready-to-merge.md file.";
+    "Then write the derivative markdown version to {review_file}. ";
 export const DESIGN_REVIEW_PROMPT_TEMPLATE = "Conduct a structured planning critique as a specification critic, not as an implementer. " +
     "Use structured JSON artifacts as the source of truth for semantics. " +
     "Required planning inputs: design markdown {design_file}, design JSON {design_json_file}, implementation plan markdown {plan_file}, implementation plan JSON {plan_json_file}. " +
     "Review the markdown files as derivative human-readable renderings of the same planning run, but do not let markdown override the structured JSON. " +
-    "Optional supplemental context is provided through these variables and may contain the literal value 'not provided' when absent: QA markdown {qa_file}, QA JSON {qa_json_file}, Jira task JSON {jira_task_file}, Jira attachments manifest {jira_attachments_manifest_file}, Jira attachments context {jira_attachments_context_file}, planning answers JSON {planning_answers_json_file}. " +
+    "Optional supplemental context is provided through these variables and may contain the literal value 'not provided' when absent: normalized task context JSON {task_context_json_file}, QA markdown {qa_file}, QA JSON {qa_json_file}, Jira task JSON {jira_task_file}, Jira attachments manifest {jira_attachments_manifest_file}, Jira attachments context {jira_attachments_context_file}, planning answers JSON {planning_answers_json_file}, instant-task input JSON {task_input_json_file}. " +
     "When an optional variable is 'not provided', treat that source as unavailable and do not invent details from it. " +
     "Evaluate completeness, consistency, implementation readiness, risk coverage, QA coverage, and scope discipline across the available planning artifacts and optional context. " +
     "Identify blocking findings, major non-blocking findings, warnings, missing information, consistency check results, QA coverage gaps, and concise recommended actions. " +
@@ -80,19 +101,20 @@ export const DESIGN_REVIEW_PROMPT_TEMPLATE = "Conduct a structured planning crit
     "Do not create ready-to-merge.md when status is needs_revision.";
 export const REVIEW_PROJECT_PROMPT_TEMPLATE = "Conduct a code review of current changes in the project without Jira context. " +
     "Evaluate the quality of changes based on current code, tests, regression risks, and overall engineering quality. " +
+    "Use exactly one severity per finding from this list: blocker, critical, high, medium, low, info. " +
     `First write the structured result to {review_json_file}. ${strictSchemaInstruction("{review_json_file}", "review-findings/v1")}` +
-    "Then write the derivative markdown version to {review_file}. " +
-    "If ready_to_merge=true and there are no blockers, create the {ready_to_merge_file} file.";
+    "Then write the derivative markdown version to {review_file}. ";
 export const GITLAB_DIFF_REVIEW_PROMPT_TEMPLATE = "Conduct a code review of the GitLab merge request diff. " +
     "Use the structured diff artifact {gitlab_diff_json_file} as source of truth, and markdown {gitlab_diff_file} only as a convenient human-readable representation. " +
     "Evaluate only the changes from the diff: correctness, regression risks, missing tests, dangerous edge cases, contract violations, and maintainability. " +
+    "Use exactly one severity per finding from this list: blocker, critical, high, medium, low, info. " +
     `First write the structured result to {review_json_file}. ${strictSchemaInstruction("{review_json_file}", "review-findings/v1")}` +
-    "Then write the derivative markdown version to {review_file}. " +
-    "If ready_to_merge=true and there are no blockers, create the {ready_to_merge_file} file.";
+    "Then write the derivative markdown version to {review_file}. ";
 export const GITLAB_REVIEW_PROMPT_TEMPLATE = "Validate GitLab merge request review comments. " +
     "Use the structured GitLab review artifact {gitlab_review_json_file} as source of truth, and markdown {gitlab_review_file} only as a convenient human-readable representation. " +
     "Determine which comments are valid actionable findings that should be addressed in the current code. " +
     "Ignore comments that are obsolete, already resolved, duplicates, purely conversational, or not actionable. " +
+    "Use exactly one severity per finding from this list: blocker, critical, high, medium, low, info. " +
     "Normalize the remaining actionable findings into the review findings schema with accurate severities, concise titles, and concrete descriptions. " +
     "For each remaining finding, assess whether the complaint is fair in the current code and propose a concrete fix. " +
     `First write the structured result to {review_json_file}. ${strictSchemaInstruction("{review_json_file}", "review-findings/v1")}` +
@@ -144,7 +166,7 @@ export const PLAN_REVISE_PROMPT_TEMPLATE = "Revise the planning artifacts based
     "Required source planning inputs: design JSON {design_json_file}, design markdown {design_file}, plan JSON {plan_json_file}, plan markdown {plan_file}. " +
     "Optional source QA inputs (may be 'not provided'): QA JSON {qa_json_file}, QA markdown {qa_file}. " +
     "When QA inputs are 'not provided', synthesize a new QA plan from the revised design and plan. " +
-    "Optional supplemental context (may be 'not provided'): Jira task JSON {jira_task_file}, Jira attachments manifest {jira_attachments_manifest_file}, Jira attachments context {jira_attachments_context_file}, planning answers JSON {planning_answers_json_file}. " +
+    "Optional supplemental context (may be 'not provided'): normalized task context JSON {task_context_json_file}, Jira task JSON {jira_task_file}, Jira attachments manifest {jira_attachments_manifest_file}, Jira attachments context {jira_attachments_context_file}, planning answers JSON {planning_answers_json_file}, instant-task input JSON {task_input_json_file}. " +
     "When an optional variable is 'not provided', treat that source as unavailable and do not invent details from it. " +
     "For every blocking finding and major finding in the verdict, address it directly in the revised artifacts. " +
     "Preserve all content from the original artifacts that is not directly addressed by findings in the verdict — do not drop details, sections, or decisions that remain valid. " +

package/dist/review-severity.js

@@ -0,0 +1,45 @@
+import { TaskRunnerError } from "./errors.js";
+export const REVIEW_SEVERITIES = ["blocker", "critical", "high", "medium", "low", "info"];
+export const AGENTWEAVER_REVIEW_BLOCKING_SEVERITIES_ENV = "AGENTWEAVER_REVIEW_BLOCKING_SEVERITIES";
+export const DEFAULT_REVIEW_BLOCKING_SEVERITIES = ["blocker", "critical", "high"];
+const REVIEW_SEVERITY_SET = new Set(REVIEW_SEVERITIES);
+export function normalizeReviewSeverity(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase();
+    return REVIEW_SEVERITY_SET.has(normalized) ? normalized : null;
+}
+export function normalizeReviewSeverityList(values) {
+    const result = [];
+    for (const value of values) {
+        const normalized = normalizeReviewSeverity(value);
+        if (!normalized || result.includes(normalized)) {
+            continue;
+        }
+        result.push(normalized);
+    }
+    return result;
+}
+export function resolveBlockingReviewSeverities(values) {
+    const normalized = Array.isArray(values) ? normalizeReviewSeverityList(values) : [];
+    return normalized.length > 0 ? normalized : [...DEFAULT_REVIEW_BLOCKING_SEVERITIES];
+}
+export function parseReviewSeverityCsv(raw) {
+    const values = raw
+        .split(",")
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+    const normalized = normalizeReviewSeverityList(values);
+    if (values.length === 0 || normalized.length !== values.length) {
+        throw new TaskRunnerError(`Invalid review severity list '${raw}'. Allowed values: ${REVIEW_SEVERITIES.join(", ")}.`);
+    }
+    return normalized;
+}
+export function resolveReviewBlockingSeveritiesFromEnv(env = process.env) {
+    const raw = env[AGENTWEAVER_REVIEW_BLOCKING_SEVERITIES_ENV]?.trim();
+    if (!raw) {
+        return [...DEFAULT_REVIEW_BLOCKING_SEVERITIES];
+    }
+    return parseReviewSeverityCsv(raw);
+}