@uns-kit/assistant-workflow 2.0.77 → 2.0.79

package/README.md

@@ -30,6 +30,24 @@ The package deliberately does not contain provider credentials, database access,
 HTTP transport, UNS-specific tool implementations, or application-specific
 workflow definitions.
 
+## Tool-Selection Evaluation
+
+Tool-selection replay reports distinguish a workflow failure from an expected
+clarification boundary. A `workflow_blocked` decision with
+`workflowStatus: "needs-clarification"` is emitted as the informational
+`workflow_expected_clarification` signal. It remains visible in readiness and
+migration artifacts, but it neither increments warning counts nor asks to
+broaden runtime authority. Other blocked workflow states remain warnings and
+continue to block a migration proposal.
+
+When an application deliberately exposes its full legacy tool catalog
+(`pruningEnabled: false`), replay reports record
+`workflow_selection_not_exercised` rather than interpreting the larger catalog
+as a workflow mismatch. These rows remain visible as
+`selection_not_exercised_only` migration candidates and require a pruned shadow
+selection before authority can be broadened; they never hide a genuine mismatch
+observed while selection was exercised.
+
 ## Exact Tool Handoffs
 
 When a host has rebuilt a workflow plan and wants to delegate exactly one

package/dist/tool-selection-evaluation.d.ts

@@ -1,7 +1,7 @@
 import type { AssistantWorkflowJsonValue } from "./run-report-json.js";
 import type { AssistantWorkflowSerializedToolSelectionDecision } from "./tool-selection-json.js";
 export type AssistantWorkflowToolSelectionEvaluationSeverity = "info" | "warning";
-export type AssistantWorkflowToolSelectionEvaluationSignalName = "legacy_authority" | "workflow_unavailable" | "workflow_authority_not_enabled" | "workflow_blocked" | "workflow_differs" | "workflow_candidate_not_selected" | "selected_outside_workflow_candidate" | "selected_outside_workflow_suggestions" | "selected_policy_excluded_optional_tool";
+export type AssistantWorkflowToolSelectionEvaluationSignalName = "legacy_authority" | "workflow_unavailable" | "workflow_authority_not_enabled" | "workflow_blocked" | "workflow_expected_clarification" | "workflow_selection_not_exercised" | "workflow_differs" | "workflow_candidate_not_selected" | "selected_outside_workflow_candidate" | "selected_outside_workflow_suggestions" | "selected_policy_excluded_optional_tool";
 export type AssistantWorkflowToolSelectionEvaluationSignal = {
     name: AssistantWorkflowToolSelectionEvaluationSignalName;
     severity: AssistantWorkflowToolSelectionEvaluationSeverity;
@@ -25,6 +25,8 @@ export type AssistantWorkflowToolSelectionEvaluation = {
     workflowSelectionActiveProfileIds: string[];
     workflowSelectionProfileToolNames: string[];
     workflowSelectionProfileToolCount: number;
+    expectedClarificationBlock: boolean;
+    selectionNotExercised: boolean;
     signalCount: number;
     warningCount: number;
     signals: AssistantWorkflowToolSelectionEvaluationSignal[];
@@ -48,6 +50,8 @@ export type AssistantWorkflowToolSelectionEvaluationIntentReadiness = {
     shadowEquivalentCount: number;
     workflowDiffersCount: number;
     workflowBlockedCount: number;
+    expectedClarificationBlockCount: number;
+    selectionNotExercisedCount: number;
     workflowUnavailableCount: number;
     warningCount: number;
     workflowAuthorityConfirmed: boolean;
@@ -67,8 +71,8 @@ export type AssistantWorkflowToolSelectionEvaluationReadinessSummary = {
     warningSegmentCount: number;
 };
 export type AssistantWorkflowToolSelectionMigrationCandidateKind = "intent" | "segment";
-export type AssistantWorkflowToolSelectionMigrationCandidateStatus = "ready_for_workflow_authority" | "workflow_authority_confirmed" | "needs_review";
-export type AssistantWorkflowToolSelectionMigrationRecommendedAction = "add_intent_to_authority_allow_list" | "keep_runtime_authority" | "review_segment_before_authority_change" | "review_blockers_before_migration";
+export type AssistantWorkflowToolSelectionMigrationCandidateStatus = "ready_for_workflow_authority" | "workflow_authority_confirmed" | "expected_clarification_only" | "selection_not_exercised_only" | "needs_review";
+export type AssistantWorkflowToolSelectionMigrationRecommendedAction = "add_intent_to_authority_allow_list" | "keep_runtime_authority" | "keep_controller_clarification" | "exercise_pruned_selection" | "review_segment_before_authority_change" | "review_blockers_before_migration";
 export type AssistantWorkflowToolSelectionMigrationCandidate = {
     kind: AssistantWorkflowToolSelectionMigrationCandidateKind;
     key: string;
@@ -81,6 +85,8 @@ export type AssistantWorkflowToolSelectionMigrationCandidate = {
     shadowEquivalentCount: number;
     workflowDiffersCount: number;
     workflowBlockedCount: number;
+    expectedClarificationBlockCount: number;
+    selectionNotExercisedCount: number;
     workflowUnavailableCount: number;
     warningCount: number;
     status: AssistantWorkflowToolSelectionMigrationCandidateStatus;
@@ -103,6 +109,8 @@ export type AssistantWorkflowToolSelectionMigrationReport = {
     readySegmentCandidates: AssistantWorkflowToolSelectionMigrationCandidate[];
     confirmedIntentCandidates: AssistantWorkflowToolSelectionMigrationCandidate[];
     confirmedSegmentCandidates: AssistantWorkflowToolSelectionMigrationCandidate[];
+    expectedClarificationCandidates: AssistantWorkflowToolSelectionMigrationCandidate[];
+    selectionNotExercisedCandidates: AssistantWorkflowToolSelectionMigrationCandidate[];
     reviewCandidates: AssistantWorkflowToolSelectionMigrationCandidate[];
 };
 export type AssistantWorkflowToolSelectionAuthorityAllowListProposalOptions = {
@@ -167,6 +175,8 @@ export type AssistantWorkflowToolSelectionMigrationReviewArtifact = {
         readySegmentCandidateKeys: string[];
         confirmedIntentCandidateKeys: string[];
         confirmedSegmentCandidateKeys: string[];
+        expectedClarificationCandidateKeys: string[];
+        selectionNotExercisedCandidateKeys: string[];
     };
     review: {
         reviewIntentIds: string[];

package/dist/tool-selection-evaluation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-selection-evaluation.d.ts","sourceRoot":"","sources":["../src/tool-selection-evaluation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-selection-evaluation.d.ts","sourceRoot":"","sources":["../src/tool-selection-evaluation.ts"],"names":[],"mappings":"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"}

package/dist/tool-selection-evaluation.js

@@ -14,12 +14,14 @@ export function evaluateAssistantWorkflowToolSelectionDecision(decision) {
             hop: readNumber(decision.comparisonPayload?.["hop"]),
             selectedReason: readString(decision.comparisonPayload?.["selectedReason"]),
         });
+    const expectedClarificationBlock = isExpectedClarificationBlock(decision);
+    const selectionNotExercised = isWorkflowSelectionNotExercised(decision);
     return {
         intentId,
         hop: readNumber(decision.comparisonPayload?.["hop"]),
         selectedReason: readString(decision.comparisonPayload?.["selectedReason"]),
         authoritySource: decision.authority.source,
-        authorityReason: decision.authority.reason,
+        authorityReason: getEvaluationAuthorityReason(decision),
         workflowStatus: decision.authority.workflowStatus,
         workflowAuthorityEnabled: intentId && workflowAuthorityIntentIds.length > 0
             ? workflowAuthorityIntentIds.includes(intentId)
@@ -36,6 +38,8 @@ export function evaluateAssistantWorkflowToolSelectionDecision(decision) {
         workflowSelectionActiveProfileIds,
         workflowSelectionProfileToolNames: workflowSelectionProfileToolNames,
         workflowSelectionProfileToolCount: workflowSelectionProfileToolNames.length,
+        expectedClarificationBlock,
+        selectionNotExercised,
         signalCount: signals.length,
         warningCount: signals.filter((signal) => signal.severity === "warning").length,
         signals,
@@ -43,6 +47,9 @@ export function evaluateAssistantWorkflowToolSelectionDecision(decision) {
 }
 export function collectAssistantWorkflowToolSelectionEvaluationSignals(decision) {
     const signals = [];
+    const expectedClarificationBlock = isExpectedClarificationBlock(decision);
+    const selectionNotExercised = isWorkflowSelectionNotExercised(decision);
+    const authorityReason = getEvaluationAuthorityReason(decision);
     const missingCandidateTools = readStringArray(decision.comparisonPayload?.["missingWorkflowSelectionCandidateTools"]);
     const selectedOutsideCandidate = readStringArray(decision.comparisonPayload?.["selectedOutsideWorkflowSelectionCandidate"]);
     const selectedOutsideSuggestions = readStringArray(decision.comparisonPayload?.["selectedOutsideWorkflowSuggestions"]);
@@ -52,59 +59,68 @@ export function collectAssistantWorkflowToolSelectionEvaluationSignals(decision)
         signals.push({
             name: "legacy_authority",
             severity: "info",
-            detail: decision.authority.reason,
+            detail: authorityReason,
         });
     }
-    if (decision.authority.reason === "workflow_unavailable") {
+    if (authorityReason === "workflow_unavailable") {
         signals.push({
             name: "workflow_unavailable",
             severity: "warning",
             detail: "tool selection ran without a workflow comparison payload",
         });
     }
-    if (decision.authority.reason === "workflow_authority_not_enabled") {
+    if (authorityReason === "workflow_authority_not_enabled") {
         signals.push({
             name: "workflow_authority_not_enabled",
             severity: "info",
             detail: readString(decision.comparisonPayload?.["intent"]),
         });
     }
-    if (decision.authority.reason === "workflow_blocked") {
+    if (authorityReason === "workflow_blocked") {
         signals.push({
-            name: "workflow_blocked",
-            severity: "warning",
+            name: expectedClarificationBlock
+                ? "workflow_expected_clarification"
+                : "workflow_blocked",
+            severity: expectedClarificationBlock ? "info" : "warning",
             detail: decision.authority.workflowStatus,
         });
     }
-    if (decision.authority.reason === "workflow_differs") {
+    if (authorityReason === "workflow_selection_not_exercised") {
+        signals.push({
+            name: "workflow_selection_not_exercised",
+            severity: "info",
+            detail: "pruning_disabled",
+        });
+    }
+    if (authorityReason === "workflow_differs") {
         signals.push({
             name: "workflow_differs",
             severity: "info",
             detail: summarizeDifference(missingCandidateTools, selectedOutsideCandidate),
         });
     }
-    if (missingCandidateTools.length > 0) {
+    if (missingCandidateTools.length > 0 && !expectedClarificationBlock && !selectionNotExercised) {
         signals.push({
             name: "workflow_candidate_not_selected",
             severity: "warning",
             detail: missingCandidateTools.join(", "),
         });
     }
-    if (selectedOutsideCandidate.length > 0) {
+    if (selectedOutsideCandidate.length > 0 && !selectionNotExercised) {
         signals.push({
             name: "selected_outside_workflow_candidate",
             severity: "info",
             detail: selectedOutsideCandidate.join(", "),
         });
     }
-    if (selectedOutsideSuggestions.length > 0) {
+    if (selectedOutsideSuggestions.length > 0 && !selectionNotExercised) {
         signals.push({
             name: "selected_outside_workflow_suggestions",
             severity: "info",
             detail: selectedOutsideSuggestions.join(", "),
         });
     }
-    if (selectedPolicyExcludedOptionalTools.length > 0) {
+    if (selectedPolicyExcludedOptionalTools.length > 0 && !selectionNotExercised) {
         signals.push({
             name: "selected_policy_excluded_optional_tool",
             severity: "info",
@@ -157,6 +173,8 @@ export function buildAssistantWorkflowToolSelectionEvaluationTracePayload(evalua
         workflowSelectionActiveProfileIds: evaluation.workflowSelectionActiveProfileIds,
         workflowSelectionProfileToolNames: evaluation.workflowSelectionProfileToolNames,
         workflowSelectionProfileToolCount: evaluation.workflowSelectionProfileToolCount,
+        expectedClarificationBlock: evaluation.expectedClarificationBlock,
+        selectionNotExercised: evaluation.selectionNotExercised,
         signalCount: evaluation.signalCount,
         warningCount: evaluation.warningCount,
         signals: evaluation.signals.map((signal) => ({
@@ -189,6 +207,8 @@ export function buildAssistantWorkflowToolSelectionEvaluationBatchTracePayload(b
             shadowEquivalentCount: intent.shadowEquivalentCount,
             workflowDiffersCount: intent.workflowDiffersCount,
             workflowBlockedCount: intent.workflowBlockedCount,
+            expectedClarificationBlockCount: intent.expectedClarificationBlockCount,
+            selectionNotExercisedCount: intent.selectionNotExercisedCount,
             workflowUnavailableCount: intent.workflowUnavailableCount,
             warningCount: intent.warningCount,
             workflowAuthorityConfirmed: intent.workflowAuthorityConfirmed,
@@ -204,6 +224,8 @@ export function buildAssistantWorkflowToolSelectionEvaluationBatchTracePayload(b
             shadowEquivalentCount: segment.shadowEquivalentCount,
             workflowDiffersCount: segment.workflowDiffersCount,
             workflowBlockedCount: segment.workflowBlockedCount,
+            expectedClarificationBlockCount: segment.expectedClarificationBlockCount,
+            selectionNotExercisedCount: segment.selectionNotExercisedCount,
             workflowUnavailableCount: segment.workflowUnavailableCount,
             warningCount: segment.warningCount,
             workflowAuthorityConfirmed: segment.workflowAuthorityConfirmed,
@@ -226,6 +248,8 @@ export function buildAssistantWorkflowToolSelectionMigrationReport(batch, option
     const readySegmentCandidates = segmentCandidates.filter((candidate) => candidate.status === "ready_for_workflow_authority");
     const confirmedIntentCandidates = intentCandidates.filter((candidate) => candidate.status === "workflow_authority_confirmed");
     const confirmedSegmentCandidates = segmentCandidates.filter((candidate) => candidate.status === "workflow_authority_confirmed");
+    const expectedClarificationCandidates = [...intentCandidates, ...segmentCandidates].filter((candidate) => candidate.status === "expected_clarification_only");
+    const selectionNotExercisedCandidates = [...intentCandidates, ...segmentCandidates].filter((candidate) => candidate.status === "selection_not_exercised_only");
     const reviewCandidates = [...intentCandidates, ...segmentCandidates].filter((candidate) => candidate.status === "needs_review");
     return {
         generatedAt: batch.generatedAt,
@@ -239,6 +263,8 @@ export function buildAssistantWorkflowToolSelectionMigrationReport(batch, option
         readySegmentCandidates,
         confirmedIntentCandidates,
         confirmedSegmentCandidates,
+        expectedClarificationCandidates,
+        selectionNotExercisedCandidates,
         reviewCandidates,
     };
 }
@@ -255,6 +281,8 @@ export function buildAssistantWorkflowToolSelectionMigrationReportTracePayload(r
         readySegmentCandidates: report.readySegmentCandidates.map(toMigrationCandidateTracePayload),
         confirmedIntentCandidates: report.confirmedIntentCandidates.map(toMigrationCandidateTracePayload),
         confirmedSegmentCandidates: report.confirmedSegmentCandidates.map(toMigrationCandidateTracePayload),
+        expectedClarificationCandidates: report.expectedClarificationCandidates.map(toMigrationCandidateTracePayload),
+        selectionNotExercisedCandidates: report.selectionNotExercisedCandidates.map(toMigrationCandidateTracePayload),
         reviewCandidates: report.reviewCandidates.map(toMigrationCandidateTracePayload),
     };
 }
@@ -377,6 +405,8 @@ export function buildAssistantWorkflowToolSelectionMigrationReviewArtifact(input
             readySegmentCandidateKeys: input.report.readySegmentCandidates.map((candidate) => candidate.key),
             confirmedIntentCandidateKeys: input.report.confirmedIntentCandidates.map((candidate) => candidate.key),
             confirmedSegmentCandidateKeys: input.report.confirmedSegmentCandidates.map((candidate) => candidate.key),
+            expectedClarificationCandidateKeys: input.report.expectedClarificationCandidates.map((candidate) => candidate.key),
+            selectionNotExercisedCandidateKeys: input.report.selectionNotExercisedCandidates.map((candidate) => candidate.key),
         },
         review: {
             reviewIntentIds: input.proposal.reviewIntentIds,
@@ -413,6 +443,8 @@ export function buildAssistantWorkflowToolSelectionMigrationReviewArtifactTraceP
             readySegmentCandidateKeys: artifact.evidence.readySegmentCandidateKeys,
             confirmedIntentCandidateKeys: artifact.evidence.confirmedIntentCandidateKeys,
             confirmedSegmentCandidateKeys: artifact.evidence.confirmedSegmentCandidateKeys,
+            expectedClarificationCandidateKeys: artifact.evidence.expectedClarificationCandidateKeys,
+            selectionNotExercisedCandidateKeys: artifact.evidence.selectionNotExercisedCandidateKeys,
         },
         review: {
             reviewIntentIds: artifact.review.reviewIntentIds,
@@ -438,14 +470,22 @@ function buildReadinessSummary(intentReadiness, segmentReadiness) {
 function buildMigrationCandidate(kind, readiness, minDecisionCount) {
     const isSegment = isSegmentReadiness(readiness);
     const key = isSegment ? readiness.segmentKey : readiness.intentId;
-    const blockingReasons = collectMigrationBlockingReasons(readiness, minDecisionCount);
-    const status = blockingReasons.length > 0
-        ? "needs_review"
-        : readiness.workflowAuthorityConfirmed
-            ? "workflow_authority_confirmed"
-            : readiness.readyForWorkflowAuthority
-                ? "ready_for_workflow_authority"
-                : "needs_review";
+    const expectedClarificationOnly = isExpectedClarificationOnly(readiness);
+    const selectionNotExercisedOnly = isSelectionNotExercisedOnly(readiness);
+    const blockingReasons = expectedClarificationOnly || selectionNotExercisedOnly
+        ? []
+        : collectMigrationBlockingReasons(readiness, minDecisionCount);
+    const status = expectedClarificationOnly
+        ? "expected_clarification_only"
+        : selectionNotExercisedOnly
+            ? "selection_not_exercised_only"
+            : blockingReasons.length > 0
+                ? "needs_review"
+                : readiness.workflowAuthorityConfirmed
+                    ? "workflow_authority_confirmed"
+                    : readiness.readyForWorkflowAuthority
+                        ? "ready_for_workflow_authority"
+                        : "needs_review";
     const recommendedAction = buildMigrationRecommendedAction(kind, status);
     return {
         kind,
@@ -459,6 +499,8 @@ function buildMigrationCandidate(kind, readiness, minDecisionCount) {
         shadowEquivalentCount: readiness.shadowEquivalentCount,
         workflowDiffersCount: readiness.workflowDiffersCount,
         workflowBlockedCount: readiness.workflowBlockedCount,
+        expectedClarificationBlockCount: readiness.expectedClarificationBlockCount,
+        selectionNotExercisedCount: readiness.selectionNotExercisedCount,
         workflowUnavailableCount: readiness.workflowUnavailableCount,
         warningCount: readiness.warningCount,
         status,
@@ -467,6 +509,27 @@ function buildMigrationCandidate(kind, readiness, minDecisionCount) {
         rationale: buildMigrationRationale(kind, status, readiness, blockingReasons, minDecisionCount),
     };
 }
+function isExpectedClarificationOnly(readiness) {
+    return readiness.expectedClarificationBlockCount > 0 &&
+        readiness.workflowAuthorityCount === 0 &&
+        readiness.shadowEquivalentCount === 0 &&
+        readiness.workflowDiffersCount === 0 &&
+        unexpectedWorkflowBlockedCount(readiness) === 0 &&
+        readiness.workflowUnavailableCount === 0 &&
+        readiness.warningCount === 0;
+}
+function isSelectionNotExercisedOnly(readiness) {
+    return readiness.selectionNotExercisedCount > 0 &&
+        readiness.workflowAuthorityCount === 0 &&
+        readiness.shadowEquivalentCount === 0 &&
+        readiness.workflowDiffersCount === 0 &&
+        unexpectedWorkflowBlockedCount(readiness) === 0 &&
+        readiness.workflowUnavailableCount === 0 &&
+        readiness.warningCount === 0;
+}
+function unexpectedWorkflowBlockedCount(readiness) {
+    return Math.max(0, readiness.workflowBlockedCount - readiness.expectedClarificationBlockCount);
+}
 function collectMigrationBlockingReasons(readiness, minDecisionCount) {
     const reasons = [];
     if (readiness.intentId === "unknown")
@@ -477,21 +540,21 @@ function collectMigrationBlockingReasons(readiness, minDecisionCount) {
         reasons.push("warnings_present");
     if (readiness.workflowDiffersCount > 0)
         reasons.push("workflow_differs");
-    if (readiness.workflowBlockedCount > 0)
+    if (unexpectedWorkflowBlockedCount(readiness) > 0)
         reasons.push("workflow_blocked");
     if (readiness.workflowUnavailableCount > 0)
         reasons.push("workflow_unavailable");
     if (readiness.workflowAuthorityCount > 0 &&
         readiness.shadowEquivalentCount > 0 &&
         readiness.workflowDiffersCount === 0 &&
-        readiness.workflowBlockedCount === 0 &&
+        unexpectedWorkflowBlockedCount(readiness) === 0 &&
         readiness.workflowUnavailableCount === 0) {
         reasons.push("mixed_authority_evidence");
     }
     if (readiness.workflowAuthorityCount === 0 &&
         readiness.shadowEquivalentCount === 0 &&
         readiness.workflowDiffersCount === 0 &&
-        readiness.workflowBlockedCount === 0 &&
+        unexpectedWorkflowBlockedCount(readiness) === 0 &&
         readiness.workflowUnavailableCount === 0) {
         reasons.push("no_workflow_equivalence_evidence");
     }
@@ -500,6 +563,10 @@ function collectMigrationBlockingReasons(readiness, minDecisionCount) {
 function buildMigrationRecommendedAction(kind, status) {
     if (status === "workflow_authority_confirmed")
         return "keep_runtime_authority";
+    if (status === "expected_clarification_only")
+        return "keep_controller_clarification";
+    if (status === "selection_not_exercised_only")
+        return "exercise_pruned_selection";
     if (status === "ready_for_workflow_authority") {
         return kind === "intent"
             ? "add_intent_to_authority_allow_list"
@@ -509,11 +576,23 @@ function buildMigrationRecommendedAction(kind, status) {
 }
 function buildMigrationRationale(kind, status, readiness, blockingReasons, minDecisionCount) {
     const scope = kind === "intent" ? `intent ${readiness.intentId}` : `segment ${getReadinessKey(readiness)}`;
+    const clarificationSuffix = readiness.expectedClarificationBlockCount > 0
+        ? ` with ${readiness.expectedClarificationBlockCount} expected clarification block(s)`
+        : "";
+    const selectionNotExercisedSuffix = readiness.selectionNotExercisedCount > 0
+        ? ` with ${readiness.selectionNotExercisedCount} selection-not-exercised decision(s)`
+        : "";
     if (status === "workflow_authority_confirmed") {
-        return `${scope} is already workflow-owned across ${readiness.decisionCount} decision(s) without warnings.`;
+        return `${scope} is already workflow-owned across ${readiness.workflowAuthorityCount} decision(s)${clarificationSuffix} and without warnings.`;
+    }
+    if (status === "expected_clarification_only") {
+        return `${scope} has ${readiness.expectedClarificationBlockCount} expected clarification block(s) and does not require an authority change.`;
+    }
+    if (status === "selection_not_exercised_only") {
+        return `${scope} was observed with pruning disabled and needs a pruned shadow selection before an authority change.`;
     }
     if (status === "ready_for_workflow_authority") {
-        return `${scope} has ${readiness.shadowEquivalentCount} shadow-equivalent decision(s), no warnings, and meets minDecisionCount=${minDecisionCount}.`;
+        return `${scope} has ${readiness.shadowEquivalentCount} shadow-equivalent decision(s)${clarificationSuffix}${selectionNotExercisedSuffix}, no warnings, and meets minDecisionCount=${minDecisionCount}.`;
     }
     return `${scope} is not ready for runtime migration: ${blockingReasons.join(", ") || "unknown_reason"}.`;
 }
@@ -536,6 +615,8 @@ function toMigrationCandidateTracePayload(candidate) {
         shadowEquivalentCount: candidate.shadowEquivalentCount,
         workflowDiffersCount: candidate.workflowDiffersCount,
         workflowBlockedCount: candidate.workflowBlockedCount,
+        expectedClarificationBlockCount: candidate.expectedClarificationBlockCount,
+        selectionNotExercisedCount: candidate.selectionNotExercisedCount,
         workflowUnavailableCount: candidate.workflowUnavailableCount,
         warningCount: candidate.warningCount,
         status: candidate.status,
@@ -596,6 +677,20 @@ function normalizeMinDecisionCount(value) {
 function isInterestingRow(row) {
     return row.authoritySource !== "workflow";
 }
+function isExpectedClarificationBlock(decision) {
+    return decision.authority.reason === "workflow_blocked" &&
+        decision.authority.workflowStatus === "needs-clarification";
+}
+function isWorkflowSelectionNotExercised(decision) {
+    return decision.authority.source === "legacy-pruner" && (decision.authority.reason === "workflow_selection_not_exercised" ||
+        (decision.authority.reason === "workflow_differs" &&
+            decision.comparisonPayload?.["pruningEnabled"] === false));
+}
+function getEvaluationAuthorityReason(decision) {
+    return isWorkflowSelectionNotExercised(decision)
+        ? "workflow_selection_not_exercised"
+        : decision.authority.reason;
+}
 function summarizeDifference(missingCandidateTools, selectedOutsideCandidate) {
     const parts = [
         missingCandidateTools.length > 0 ? `missing=${missingCandidateTools.join(",")}` : "",
@@ -617,6 +712,8 @@ function buildIntentReadiness(rows) {
         const shadowEquivalentCount = intentRows.filter((row) => row.authorityReason === "workflow_authority_not_enabled").length;
         const workflowDiffersCount = intentRows.filter((row) => row.authorityReason === "workflow_differs").length;
         const workflowBlockedCount = intentRows.filter((row) => row.authorityReason === "workflow_blocked").length;
+        const expectedClarificationBlockCount = intentRows.filter((row) => row.expectedClarificationBlock).length;
+        const selectionNotExercisedCount = intentRows.filter((row) => row.selectionNotExercised).length;
         const workflowUnavailableCount = intentRows.filter((row) => row.authorityReason === "workflow_unavailable").length;
         const warningCount = intentRows.reduce((total, row) => total + row.warningCount, 0);
         return {
@@ -626,20 +723,22 @@ function buildIntentReadiness(rows) {
             shadowEquivalentCount,
             workflowDiffersCount,
             workflowBlockedCount,
+            expectedClarificationBlockCount,
+            selectionNotExercisedCount,
             workflowUnavailableCount,
             warningCount,
             workflowAuthorityConfirmed: (intentId !== "unknown" &&
                 workflowAuthorityCount > 0 &&
                 shadowEquivalentCount === 0 &&
                 workflowDiffersCount === 0 &&
-                workflowBlockedCount === 0 &&
+                unexpectedWorkflowBlockedCount({ workflowBlockedCount, expectedClarificationBlockCount }) === 0 &&
                 workflowUnavailableCount === 0 &&
                 warningCount === 0),
             readyForWorkflowAuthority: (intentId !== "unknown" &&
                 workflowAuthorityCount === 0 &&
                 shadowEquivalentCount > 0 &&
                 workflowDiffersCount === 0 &&
-                workflowBlockedCount === 0 &&
+                unexpectedWorkflowBlockedCount({ workflowBlockedCount, expectedClarificationBlockCount }) === 0 &&
                 workflowUnavailableCount === 0 &&
                 warningCount === 0),
         };
@@ -677,6 +776,8 @@ function buildSegmentReadiness(rows) {
             shadowEquivalentCount: 0,
             workflowDiffersCount: 0,
             workflowBlockedCount: 0,
+            expectedClarificationBlockCount: 0,
+            selectionNotExercisedCount: 0,
             workflowUnavailableCount: 0,
             warningCount: 0,
             workflowAuthorityConfirmed: false,