@runfusion/fusion 0.75.1-beta.0 → 0.75.1-beta.2

package/dist/pi-claude-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion/pi-claude-cli",
-  "version": "0.75.1-beta.0",
+  "version": "0.75.1-beta.2",
   "type": "module",
   "private": true,
   "main": "index.ts",

package/dist/plugin-sdk/index.d.ts

@@ -209,7 +209,160 @@ declare class Database {
     getPath(): string;
 }
 
+declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh"];
+type ThinkingLevel = (typeof THINKING_LEVELS)[number];
+declare const COLUMNS: readonly ["triage", "todo", "in-progress", "in-review", "done", "archived"];
+type Column = (typeof COLUMNS)[number];
+type ColumnId = Column | (string & {});
+declare const TASK_PRIORITIES: readonly ["low", "normal", "high", "urgent"];
+type TaskPriority = (typeof TASK_PRIORITIES)[number];
+
+interface ModelPreset {
+    id: string;
+    name: string;
+    executorProvider?: string;
+    executorModelId?: string;
+    executorCredentialInstanceId?: string;
+    validatorProvider?: string;
+    validatorModelId?: string;
+    validatorCredentialInstanceId?: string;
+}
+type WorkflowStepMode = "prompt" | "script";
+type WorkflowStepToolMode = "readonly" | "coding";
+type WorkflowStepGateMode = "gate" | "advisory";
+type WorkflowReviewFindingSeverity = "low" | "medium" | "high" | "critical";
+interface WorkflowReviewFinding {
+    id: string;
+    title: string;
+    body: string;
+    filePath?: string;
+    line?: number;
+    severity?: WorkflowReviewFindingSeverity;
+}
+type WorkflowStepPhase = "pre-merge" | "post-merge";
+type WorkflowReviewKind = "plan" | "code";
+interface WorkflowStep {
+    id: string;
+    templateId?: string;
+    name: string;
+    description: string;
+    mode: WorkflowStepMode;
+    phase?: WorkflowStepPhase;
+    gateMode: WorkflowStepGateMode;
+    prompt: string;
+    toolMode?: WorkflowStepToolMode;
+    skillName?: string;
+    requiresBrowser?: boolean;
+    scriptName?: string;
+    enabled: boolean;
+    defaultOn?: boolean;
+    modelProvider?: string;
+    modelId?: string;
+    thinkingLevel?: ThinkingLevel;
+    migratedFragmentId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+type NtfyNotificationEvent = "in-review" | "merged" | "failed" | "task-wedged" | "awaiting-approval" | "awaiting-user-review" | "planning-awaiting-input" | "cli-agent-awaiting-input" | "gridlock" | "board-stall-unrecovered" | "db-corruption-detected" | "fallback-used" | "memory-dreams-processed" | "token-budget" | "message:agent-to-user" | "message:agent-to-agent" | "message:room" | "oauth-token-expired" | "task-created" | "workflow-notify";
+interface NotificationProviderConfig {
+    id: string;
+    name: string;
+    enabled: boolean;
+    config: Record<string, unknown>;
+}
+interface CustomProvider {
+    id: string;
+    name: string;
+    apiType: "openai-compatible" | "anthropic-compatible" | "google-generative-ai" | "openai-responses";
+    baseUrl: string;
+    apiKey?: string;
+    supportsDeveloperRole?: boolean;
+    anthropicPromptCaching?: boolean;
+    models?: {
+        id: string;
+        name: string;
+    }[];
+}
+interface WorkflowStepInput {
+    templateId?: string;
+    name: string;
+    description: string;
+    mode?: WorkflowStepMode;
+    phase?: WorkflowStepPhase;
+    gateMode?: WorkflowStepGateMode;
+    prompt?: string;
+    toolMode?: WorkflowStepToolMode;
+    skillName?: string;
+    scriptName?: string;
+    enabled?: boolean;
+    defaultOn?: boolean;
+    modelProvider?: string;
+    modelId?: string;
+    thinkingLevel?: ThinkingLevel;
+    migratedFragmentId?: string;
+}
+interface WorkflowStepResult {
+    workflowStepId: string;
+    workflowStepName: string;
+    phase?: WorkflowStepPhase;
+    source?: "optional-group" | "node";
+    status: "passed" | "failed" | "advisory_failure" | "skipped" | "pending";
+    reviewKind?: WorkflowReviewKind;
+    output?: string;
+    findings?: WorkflowReviewFinding[];
+    verdict?: "APPROVE" | "APPROVE_WITH_NOTES" | "REVISE";
+    notes?: string;
+    startedAt?: string;
+    completedAt?: string;
+    leaseOwner?: string;
+    leaseNodeId?: string;
+    bypassedBy?: string;
+    bypassedAt?: string;
+    bypassReason?: string;
+    bypassedFromStatus?: WorkflowStepResult["status"];
+    bypassedFromVerdict?: WorkflowStepResult["verdict"];
+    supersededAt?: string;
+    supersededReason?: "dependency-change";
+    planReviewAttemptCount?: number;
+    priorAttempts?: WorkflowStepResult[];
+}
+type WorkflowRunStepInstanceStatus = "pending" | "in-progress" | "awaiting-integration" | "completed" | "failed";
+interface WorkflowRunStepInstance {
+    taskId: string;
+    runId: string;
+    foreachNodeId: string;
+    stepIndex: number;
+    pinnedStepCount: number;
+    currentNodeId?: string | null;
+    status: WorkflowRunStepInstanceStatus;
+    baselineSha?: string | null;
+    checkpointId?: string | null;
+    reworkCount: number;
+    branchName?: string | null;
+    integratedAt?: string | null;
+    updatedAt: string;
+}
+interface WorkflowStepTemplate {
+    id: string;
+    name: string;
+    description: string;
+    prompt: string;
+    mode?: WorkflowStepMode;
+    phase?: "pre-merge" | "post-merge";
+    scriptName?: string;
+    toolMode?: WorkflowStepToolMode;
+    gateMode?: WorkflowStepGateMode;
+    defaultOn?: boolean;
+    modelProvider?: string;
+    modelId?: string;
+    thinkingLevel?: ThinkingLevel;
+    category: string;
+    icon?: string;
+    enabled?: boolean;
+}
+
 type WorkflowIrNodeKind = "start" | "prompt" | "script" | "gate" | "end" | "hold" | "split" | "join" | "foreach" | "loop" | "optional-group" | "step-review" | "parse-steps" | "code" | "notify" | "merge-gate" | "merge-attempt" | "manual-merge-hold" | "retry-backoff" | "recovery-router" | "branch-group-member-integration" | "branch-group-promotion" | "pr-create" | "pr-respond" | "pr-merge" | "ask-user" | "exit-gate";
+
 interface WorkflowIrNode {
     id: string;
     kind: WorkflowIrNodeKind;
@@ -521,14 +674,6 @@ type ToolFailureRetryClaim = {
     outcome: "exhausted";
 };
 
-declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh"];
-type ThinkingLevel = (typeof THINKING_LEVELS)[number];
-declare const COLUMNS: readonly ["triage", "todo", "in-progress", "in-review", "done", "archived"];
-type Column = (typeof COLUMNS)[number];
-type ColumnId = Column | (string & {});
-declare const TASK_PRIORITIES: readonly ["low", "normal", "high", "urgent"];
-type TaskPriority = (typeof TASK_PRIORITIES)[number];
-
 declare const MERGE_REQUEST_STATES: readonly ["queued", "running", "retrying", "succeeded", "exhausted", "cancelled", "manual-required"];
 type MergeRequestState = (typeof MERGE_REQUEST_STATES)[number];
 declare const WORKFLOW_WORK_ITEM_KINDS: readonly ["task", "merge", "retry", "manual-hold", "recovery"];
@@ -5670,138 +5815,6 @@ interface AutoRecoverySettings {
 type UnavailableNodePolicy = "block" | "fallback-local";
 type OwningNodeHandoffPolicy = "block" | "reassign-to-local" | "reassign-any-healthy";
 
-interface ModelPreset {
-    id: string;
-    name: string;
-    executorProvider?: string;
-    executorModelId?: string;
-    executorCredentialInstanceId?: string;
-    validatorProvider?: string;
-    validatorModelId?: string;
-    validatorCredentialInstanceId?: string;
-}
-type WorkflowStepMode = "prompt" | "script";
-type WorkflowStepToolMode = "readonly" | "coding";
-type WorkflowStepGateMode = "gate" | "advisory";
-type WorkflowStepPhase = "pre-merge" | "post-merge";
-interface WorkflowStep {
-    id: string;
-    templateId?: string;
-    name: string;
-    description: string;
-    mode: WorkflowStepMode;
-    phase?: WorkflowStepPhase;
-    gateMode: WorkflowStepGateMode;
-    prompt: string;
-    toolMode?: WorkflowStepToolMode;
-    skillName?: string;
-    requiresBrowser?: boolean;
-    scriptName?: string;
-    enabled: boolean;
-    defaultOn?: boolean;
-    modelProvider?: string;
-    modelId?: string;
-    thinkingLevel?: ThinkingLevel;
-    migratedFragmentId?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-type NtfyNotificationEvent = "in-review" | "merged" | "failed" | "task-wedged" | "awaiting-approval" | "awaiting-user-review" | "planning-awaiting-input" | "cli-agent-awaiting-input" | "gridlock" | "board-stall-unrecovered" | "db-corruption-detected" | "fallback-used" | "memory-dreams-processed" | "token-budget" | "message:agent-to-user" | "message:agent-to-agent" | "message:room" | "oauth-token-expired" | "task-created" | "workflow-notify";
-interface NotificationProviderConfig {
-    id: string;
-    name: string;
-    enabled: boolean;
-    config: Record<string, unknown>;
-}
-interface CustomProvider {
-    id: string;
-    name: string;
-    apiType: "openai-compatible" | "anthropic-compatible" | "google-generative-ai" | "openai-responses";
-    baseUrl: string;
-    apiKey?: string;
-    supportsDeveloperRole?: boolean;
-    anthropicPromptCaching?: boolean;
-    models?: {
-        id: string;
-        name: string;
-    }[];
-}
-interface WorkflowStepInput {
-    templateId?: string;
-    name: string;
-    description: string;
-    mode?: WorkflowStepMode;
-    phase?: WorkflowStepPhase;
-    gateMode?: WorkflowStepGateMode;
-    prompt?: string;
-    toolMode?: WorkflowStepToolMode;
-    skillName?: string;
-    scriptName?: string;
-    enabled?: boolean;
-    defaultOn?: boolean;
-    modelProvider?: string;
-    modelId?: string;
-    thinkingLevel?: ThinkingLevel;
-    migratedFragmentId?: string;
-}
-interface WorkflowStepResult {
-    workflowStepId: string;
-    workflowStepName: string;
-    phase?: WorkflowStepPhase;
-    source?: "optional-group" | "node";
-    status: "passed" | "failed" | "advisory_failure" | "skipped" | "pending";
-    output?: string;
-    verdict?: "APPROVE" | "APPROVE_WITH_NOTES" | "REVISE";
-    notes?: string;
-    startedAt?: string;
-    completedAt?: string;
-    leaseOwner?: string;
-    leaseNodeId?: string;
-    bypassedBy?: string;
-    bypassedAt?: string;
-    bypassReason?: string;
-    bypassedFromStatus?: WorkflowStepResult["status"];
-    bypassedFromVerdict?: WorkflowStepResult["verdict"];
-    supersededAt?: string;
-    supersededReason?: "dependency-change";
-    planReviewAttemptCount?: number;
-    priorAttempts?: WorkflowStepResult[];
-}
-type WorkflowRunStepInstanceStatus = "pending" | "in-progress" | "awaiting-integration" | "completed" | "failed";
-interface WorkflowRunStepInstance {
-    taskId: string;
-    runId: string;
-    foreachNodeId: string;
-    stepIndex: number;
-    pinnedStepCount: number;
-    currentNodeId?: string | null;
-    status: WorkflowRunStepInstanceStatus;
-    baselineSha?: string | null;
-    checkpointId?: string | null;
-    reworkCount: number;
-    branchName?: string | null;
-    integratedAt?: string | null;
-    updatedAt: string;
-}
-interface WorkflowStepTemplate {
-    id: string;
-    name: string;
-    description: string;
-    prompt: string;
-    mode?: WorkflowStepMode;
-    phase?: "pre-merge" | "post-merge";
-    scriptName?: string;
-    toolMode?: WorkflowStepToolMode;
-    gateMode?: WorkflowStepGateMode;
-    defaultOn?: boolean;
-    modelProvider?: string;
-    modelId?: string;
-    thinkingLevel?: ThinkingLevel;
-    category: string;
-    icon?: string;
-    enabled?: boolean;
-}
-
 type PrConflictState = "clean" | "conflicting" | "behind" | "blocked" | "unknown";
 interface PrConflictDiagnostics {
     conflictingFiles: string[];
@@ -5968,6 +5981,7 @@ type TaskReviewDecision = "approved" | "changes-requested" | "commented" | "pend
 type TaskReviewVerdict = "APPROVE" | "APPROVE_WITH_NOTES" | "REVISE" | "RETHINK" | "UNAVAILABLE";
 type TaskReviewerType = "plan" | "code";
 type TaskReviewItemStatus = "queued" | "in-progress" | "addressed" | "failed";
+type TaskReviewFindingSeverity = "low" | "medium" | "high" | "critical";
 interface LegacyTaskReviewItem {
     id: string;
     source: TaskReviewSource;
@@ -6020,6 +6034,7 @@ interface TaskReviewStateItem {
     threadId?: string;
     githubCommentId?: number;
     path?: string;
+    line?: number;
     diffSide?: string;
     body: string;
     author: TaskReviewAuthor;
@@ -6033,6 +6048,7 @@ interface TaskReviewStateItem {
     verdict?: TaskReviewVerdict;
     step?: number;
     summary?: string;
+    severity?: TaskReviewFindingSeverity;
 }
 type ReviewAddressingStatus = "queued" | "in-progress" | "addressed" | "failed";
 interface ReviewAddressingSnapshot {
@@ -6044,6 +6060,7 @@ interface ReviewAddressingSnapshot {
     authorLogin?: string;
     filePath?: string;
     lineNumber?: number;
+    severity?: TaskReviewFindingSeverity;
     threadId?: string;
     url?: string;
 }
@@ -6518,7 +6535,7 @@ interface Task {
     pausedByAgentId?: string;
     baseBranch?: string;
     autoMerge?: boolean;
-    autoMergeProvenance?: "user" | "legacy-stamp";
+    autoMergeProvenance?: "user" | "mission" | "legacy-stamp";
     branch?: string;
     branchContext?: TaskBranchContext;
     executionStartBranch?: string;
@@ -6708,6 +6725,7 @@ interface TaskCreateInput {
     branchContext?: TaskBranchContext;
     taskPrefix?: string;
     autoMerge?: boolean;
+    autoMergeProvenance?: "mission";
     sourceIssue?: TaskSourceIssue;
     gitlabTracking?: TaskGitLabTracking;
     tokenUsage?: TaskTokenUsage;

package/dist/plugin-sdk/index.js

@@ -10540,6 +10540,7 @@ function validateForeach(node, topLevelNodeIds, columnIds) {
     );
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "foreach" || inner.kind === "loop") {
       throw new WorkflowIrError(
         `foreach node '${node.id}' template may not contain nested loop/foreach ('${inner.id}')`
@@ -10658,6 +10659,7 @@ function validateLoop(node, topLevelNodeIds, columnIds) {
     );
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "loop" || inner.kind === "foreach") {
       throw new WorkflowIrError(
         `loop node '${node.id}' template may not contain nested loop/foreach ('${inner.id}')`
@@ -10751,6 +10753,7 @@ function validateOptionalGroup(node, topLevelNodeIds, columnIds) {
     throw new WorkflowIrError(`optional-group node '${node.id}' template has duplicate node ids`);
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "loop" || inner.kind === "foreach" || inner.kind === "optional-group") {
       throw new WorkflowIrError(
         `optional-group node '${node.id}' template may not contain nested loop/foreach/optional-group ('${inner.id}')`
@@ -11422,6 +11425,19 @@ function validateColumnRecovery(column) {
     );
   }
 }
+function validateReviewKind(node, placement) {
+  const value = node.config?.reviewKind;
+  if (value === void 0) return;
+  if (value !== "plan" && value !== "code") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has invalid reviewKind '${String(value)}'; expected 'plan' or 'code'`);
+  }
+  if (placement === "nested") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has reviewKind in an unsupported nested template placement`);
+  }
+  if (node.kind !== "prompt" && node.kind !== "gate" && node.kind !== "script" && node.kind !== "optional-group") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has reviewKind on unsupported node kind '${node.kind}'`);
+  }
+}
 function validateV2(ir) {
   validateColumns(ir);
   for (const [index2, column] of ir.columns.entries()) {
@@ -11444,6 +11460,7 @@ function validateV2(ir) {
   }
   const nodesById = new Map(ir.nodes.map((n) => [n.id, n]));
   for (const node of ir.nodes) {
+    validateReviewKind(node, "top-level");
     validateExtensionMetadata(`Workflow node '${node.id}'`, node.extensions);
     if (node.column !== void 0 && !columnIds.has(node.column)) {
       throw new WorkflowIrError(
@@ -13614,6 +13631,7 @@ function codeReviewOptionalGroupNode(column, options = {}) {
     column,
     config: {
       name: CODE_REVIEW_NAME,
+      reviewKind: "code",
       // Default-ON: runs for every coding task by default, but operators can toggle it
       // off per task (remove `code-review` from enabledWorkflowSteps).
       defaultOn: options.defaultOn ?? true,
@@ -13744,6 +13762,7 @@ function planReviewOptionalGroupNode(column, options = {}) {
     ...column ? { column } : {},
     config: {
       name: PLAN_REVIEW_NAME,
+      reviewKind: "plan",
       defaultOn: options.defaultOn ?? true,
       /*
        * FNXC:WorkflowRemediation 2026-06-29-12:14:

package/dist/plugins/fusion-plugin-acp-runtime/bundled.js

@@ -10539,6 +10539,7 @@ function validateForeach(node, topLevelNodeIds, columnIds) {
     );
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "foreach" || inner.kind === "loop") {
       throw new WorkflowIrError(
         `foreach node '${node.id}' template may not contain nested loop/foreach ('${inner.id}')`
@@ -10657,6 +10658,7 @@ function validateLoop(node, topLevelNodeIds, columnIds) {
     );
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "loop" || inner.kind === "foreach") {
       throw new WorkflowIrError(
         `loop node '${node.id}' template may not contain nested loop/foreach ('${inner.id}')`
@@ -10750,6 +10752,7 @@ function validateOptionalGroup(node, topLevelNodeIds, columnIds) {
     throw new WorkflowIrError(`optional-group node '${node.id}' template has duplicate node ids`);
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "loop" || inner.kind === "foreach" || inner.kind === "optional-group") {
       throw new WorkflowIrError(
         `optional-group node '${node.id}' template may not contain nested loop/foreach/optional-group ('${inner.id}')`
@@ -11421,6 +11424,19 @@ function validateColumnRecovery(column) {
     );
   }
 }
+function validateReviewKind(node, placement) {
+  const value = node.config?.reviewKind;
+  if (value === void 0) return;
+  if (value !== "plan" && value !== "code") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has invalid reviewKind '${String(value)}'; expected 'plan' or 'code'`);
+  }
+  if (placement === "nested") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has reviewKind in an unsupported nested template placement`);
+  }
+  if (node.kind !== "prompt" && node.kind !== "gate" && node.kind !== "script" && node.kind !== "optional-group") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has reviewKind on unsupported node kind '${node.kind}'`);
+  }
+}
 function validateV2(ir) {
   validateColumns(ir);
   for (const [index2, column] of ir.columns.entries()) {
@@ -11443,6 +11459,7 @@ function validateV2(ir) {
   }
   const nodesById = new Map(ir.nodes.map((n) => [n.id, n]));
   for (const node of ir.nodes) {
+    validateReviewKind(node, "top-level");
     validateExtensionMetadata(`Workflow node '${node.id}'`, node.extensions);
     if (node.column !== void 0 && !columnIds.has(node.column)) {
       throw new WorkflowIrError(
@@ -13613,6 +13630,7 @@ function codeReviewOptionalGroupNode(column, options = {}) {
     column,
     config: {
       name: CODE_REVIEW_NAME,
+      reviewKind: "code",
       // Default-ON: runs for every coding task by default, but operators can toggle it
       // off per task (remove `code-review` from enabledWorkflowSteps).
       defaultOn: options.defaultOn ?? true,
@@ -13743,6 +13761,7 @@ function planReviewOptionalGroupNode(column, options = {}) {
     ...column ? { column } : {},
     config: {
       name: PLAN_REVIEW_NAME,
+      reviewKind: "plan",
       defaultOn: options.defaultOn ?? true,
       /*
        * FNXC:WorkflowRemediation 2026-06-29-12:14:

package/dist/plugins/fusion-plugin-acp-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/acp-runtime",
-  "version": "0.1.34-beta.0",
+  "version": "0.1.34-beta.2",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-claude-runtime/bundled.js

@@ -10539,6 +10539,7 @@ function validateForeach(node, topLevelNodeIds, columnIds) {
     );
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "foreach" || inner.kind === "loop") {
       throw new WorkflowIrError(
         `foreach node '${node.id}' template may not contain nested loop/foreach ('${inner.id}')`
@@ -10657,6 +10658,7 @@ function validateLoop(node, topLevelNodeIds, columnIds) {
     );
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "loop" || inner.kind === "foreach") {
       throw new WorkflowIrError(
         `loop node '${node.id}' template may not contain nested loop/foreach ('${inner.id}')`
@@ -10750,6 +10752,7 @@ function validateOptionalGroup(node, topLevelNodeIds, columnIds) {
     throw new WorkflowIrError(`optional-group node '${node.id}' template has duplicate node ids`);
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "loop" || inner.kind === "foreach" || inner.kind === "optional-group") {
       throw new WorkflowIrError(
         `optional-group node '${node.id}' template may not contain nested loop/foreach/optional-group ('${inner.id}')`
@@ -11421,6 +11424,19 @@ function validateColumnRecovery(column) {
     );
   }
 }
+function validateReviewKind(node, placement) {
+  const value = node.config?.reviewKind;
+  if (value === void 0) return;
+  if (value !== "plan" && value !== "code") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has invalid reviewKind '${String(value)}'; expected 'plan' or 'code'`);
+  }
+  if (placement === "nested") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has reviewKind in an unsupported nested template placement`);
+  }
+  if (node.kind !== "prompt" && node.kind !== "gate" && node.kind !== "script" && node.kind !== "optional-group") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has reviewKind on unsupported node kind '${node.kind}'`);
+  }
+}
 function validateV2(ir) {
   validateColumns(ir);
   for (const [index2, column] of ir.columns.entries()) {
@@ -11443,6 +11459,7 @@ function validateV2(ir) {
   }
   const nodesById = new Map(ir.nodes.map((n) => [n.id, n]));
   for (const node of ir.nodes) {
+    validateReviewKind(node, "top-level");
     validateExtensionMetadata(`Workflow node '${node.id}'`, node.extensions);
     if (node.column !== void 0 && !columnIds.has(node.column)) {
       throw new WorkflowIrError(
@@ -13613,6 +13630,7 @@ function codeReviewOptionalGroupNode(column, options = {}) {
     column,
     config: {
       name: CODE_REVIEW_NAME,
+      reviewKind: "code",
       // Default-ON: runs for every coding task by default, but operators can toggle it
       // off per task (remove `code-review` from enabledWorkflowSteps).
       defaultOn: options.defaultOn ?? true,
@@ -13743,6 +13761,7 @@ function planReviewOptionalGroupNode(column, options = {}) {
     ...column ? { column } : {},
     config: {
       name: PLAN_REVIEW_NAME,
+      reviewKind: "plan",
       defaultOn: options.defaultOn ?? true,
       /*
        * FNXC:WorkflowRemediation 2026-06-29-12:14:

package/dist/plugins/fusion-plugin-claude-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/claude-runtime",
-  "version": "0.1.9-beta.0",
+  "version": "0.1.9-beta.2",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-cli-printing-press/bundled.js

@@ -10659,6 +10659,7 @@ function validateForeach(node, topLevelNodeIds, columnIds) {
     );
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "foreach" || inner.kind === "loop") {
       throw new WorkflowIrError(
         `foreach node '${node.id}' template may not contain nested loop/foreach ('${inner.id}')`
@@ -10777,6 +10778,7 @@ function validateLoop(node, topLevelNodeIds, columnIds) {
     );
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "loop" || inner.kind === "foreach") {
       throw new WorkflowIrError(
         `loop node '${node.id}' template may not contain nested loop/foreach ('${inner.id}')`
@@ -10870,6 +10872,7 @@ function validateOptionalGroup(node, topLevelNodeIds, columnIds) {
     throw new WorkflowIrError(`optional-group node '${node.id}' template has duplicate node ids`);
   }
   for (const inner of templateNodes) {
+    validateReviewKind(inner, "nested");
     if (inner.kind === "loop" || inner.kind === "foreach" || inner.kind === "optional-group") {
       throw new WorkflowIrError(
         `optional-group node '${node.id}' template may not contain nested loop/foreach/optional-group ('${inner.id}')`
@@ -11541,6 +11544,19 @@ function validateColumnRecovery(column) {
     );
   }
 }
+function validateReviewKind(node, placement) {
+  const value = node.config?.reviewKind;
+  if (value === void 0) return;
+  if (value !== "plan" && value !== "code") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has invalid reviewKind '${String(value)}'; expected 'plan' or 'code'`);
+  }
+  if (placement === "nested") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has reviewKind in an unsupported nested template placement`);
+  }
+  if (node.kind !== "prompt" && node.kind !== "gate" && node.kind !== "script" && node.kind !== "optional-group") {
+    throw new WorkflowIrError(`Workflow node '${node.id}' has reviewKind on unsupported node kind '${node.kind}'`);
+  }
+}
 function validateV2(ir) {
   validateColumns(ir);
   for (const [index2, column] of ir.columns.entries()) {
@@ -11563,6 +11579,7 @@ function validateV2(ir) {
   }
   const nodesById = new Map(ir.nodes.map((n) => [n.id, n]));
   for (const node of ir.nodes) {
+    validateReviewKind(node, "top-level");
     validateExtensionMetadata(`Workflow node '${node.id}'`, node.extensions);
     if (node.column !== void 0 && !columnIds.has(node.column)) {
       throw new WorkflowIrError(
@@ -13733,6 +13750,7 @@ function codeReviewOptionalGroupNode(column, options = {}) {
     column,
     config: {
       name: CODE_REVIEW_NAME,
+      reviewKind: "code",
       // Default-ON: runs for every coding task by default, but operators can toggle it
       // off per task (remove `code-review` from enabledWorkflowSteps).
       defaultOn: options.defaultOn ?? true,
@@ -13863,6 +13881,7 @@ function planReviewOptionalGroupNode(column, options = {}) {
     ...column ? { column } : {},
     config: {
       name: PLAN_REVIEW_NAME,
+      reviewKind: "plan",
       defaultOn: options.defaultOn ?? true,
       /*
        * FNXC:WorkflowRemediation 2026-06-29-12:14:

package/dist/plugins/fusion-plugin-cli-printing-press/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/cli-printing-press",
-  "version": "0.1.51-beta.0",
+  "version": "0.1.51-beta.2",
   "type": "module",
   "exports": {
     ".": {