@ivorycanvas/qamap 0.4.0 → 0.4.2

package/dist/index.d.ts

@@ -20,12 +20,12 @@ export { formatAgentQaDraft, formatMarkdownQaDraft, generateQaDraft } from "./qa
 export { formatMarkdownReviewReport, formatReviewReport, reviewProject } from "./review.js";
 export { scanProject } from "./scanner.js";
 export { collectTestSuiteInventory, evaluateFlowCoverageEvidence, summarizeTestSuiteInventory } from "./test-evidence.js";
-export { formatMarkdownTestPlan, generateTestPlan } from "./test-plan.js";
+export { addedDiffTextFromEvidence, collectAddedDiffEvidence, collectAddedDiffText, formatMarkdownTestPlan, generateTestPlan, } from "./test-plan.js";
 export { formatMarkdownVerifyReport, formatVerifyReport, verifyChange } from "./verify.js";
 export type { BehaviorAdapterConfidence, BehaviorAdapterDetection, BehaviorAdapterRun, BehaviorAnalysisContext, BehaviorAnalyzerAdapter, BehaviorAttributeValue, BehaviorChangedFile, BehaviorConfidence, BehaviorDiagnostic, BehaviorDiagnosticSeverity, BehaviorEdge, BehaviorEdgeKind, BehaviorEvidence, BehaviorEvidenceKind, BehaviorGraph, BehaviorGraphFragment, BehaviorGraphSummary, BehaviorImpact, BehaviorImpactKind, BehaviorNode, BehaviorNodeKind, BehaviorSurfaceKind, InferredBehaviorCoverage, InferredBehaviorEntrypoint, InferredBehaviorFlow, InferredBehaviorSelector, InferredFlowAdapterOptions, } from "./behavior.js";
 export type { ManifestBehaviorAdapterOptions } from "./behavior-manifest.js";
 export type { ChangeIntentBehaviorAdapterOptions } from "./behavior-intent.js";
-export type { BehaviorLifecycleStage, BehaviorLifecycleStageKind, ChangeIntent, ChangeIntentAnalysis, ChangeIntentAnalysisOptions, ChangeIntentCommit, ChangeIntentConfidence, ChangeIntentEvidence, ChangeIntentEvidenceKind, IntentQaScenario, IntentQaScenarioKind, IntentQaScenarioPriority, } from "./change-intent.js";
+export type { BehaviorLifecycleStage, BehaviorLifecycleStageKind, ChangeIntent, ChangeIntentAnalysis, ChangeIntentAnalysisOptions, ChangeIntentCommit, ChangeIntentConfidence, ChangeIntentEvidence, ChangeIntentEvidenceKind, ChangeIntentEvidenceRelation, IntentQaScenario, IntentQaScenarioKind, IntentQaScenarioPriority, } from "./change-intent.js";
 export type { CoverageEvidence, CoverageEvidenceConfidence, CoverageEvidenceStatus, FlowCoverageInput, TestSuiteEvidenceFile, TestSuiteInventory, TestSuiteSummary, } from "./test-evidence.js";
 export type { DoctorArea, DoctorPriority, DoctorResult } from "./doctor.js";
 export type { DomainLanguageConfidence, DomainLanguageSource, DomainLanguageSummary, DomainLanguageTerm, DomainScenarioSuggestion, } from "./domain-language.js";
@@ -38,7 +38,7 @@ export type { E2ePlanHistorySnapshot, LocalHistoryInitResult, LocalHistoryRefere
 export type { DomainManifestSuggestionResult, FlowManifestSuggestionResult, ManifestPromotionCandidate, ManifestPromotionPlan, ManifestPromotionStatus, ManifestSuggestionOptions, } from "./manifest-suggestions.js";
 export type { LoadedVerificationManifest, VerificationManifest, VerificationManifestAnchor, VerificationManifestAnchorKind, VerificationManifestCheck, VerificationManifestCheckType, VerificationManifestConfidence, VerificationManifestContext, VerificationManifestContextOptions, VerificationManifestContextResult, VerificationManifestContextRoleSummary, VerificationManifestCriticality, VerificationManifestDomain, VerificationManifestFlow, VerificationManifestInitOptions, VerificationManifestInitResult, VerificationManifestInstructionFile, VerificationManifestInstructionKind, VerificationManifestInstructionRole, VerificationManifestLoadOptions, VerificationManifestExplainOptions, VerificationManifestExplainResult, VerificationManifestMatch, VerificationManifestMatchKind, VerificationManifestRunner, VerificationManifestSource, VerificationManifestSourceKind, VerificationManifestValidationIssue, VerificationManifestValidationResult, VerificationManifestValidationSeverity, VerificationManifestValidationStatus, } from "./manifest.js";
 export type { ChangedFile, ChangedRiskyFinding, ReviewOptions, ReviewResult } from "./review.js";
-export type { TestPlanChangedFile, TestPlanItem, TestPlanOptions, TestPlanResult } from "./test-plan.js";
+export type { AddedDiffEvidence, AddedDiffHunk, AddedDiffLine, AddedDiffTextOptions, TestPlanChangedFile, TestPlanItem, TestPlanOptions, TestPlanResult, } from "./test-plan.js";
 export type { QAMapConfig, Finding, ScanCounts, ScanOptions, ScanResult, Severity } from "./types.js";
 export type { VerifyOptions, VerifyResult } from "./verify.js";
 export type { QaDraftFlow, QaDraftMissingEvidence, QaDraftOptions, QaDraftResult } from "./qa.js";

package/dist/index.js

@@ -20,6 +20,6 @@ export { formatAgentQaDraft, formatMarkdownQaDraft, generateQaDraft } from "./qa
 export { formatMarkdownReviewReport, formatReviewReport, reviewProject } from "./review.js";
 export { scanProject } from "./scanner.js";
 export { collectTestSuiteInventory, evaluateFlowCoverageEvidence, summarizeTestSuiteInventory } from "./test-evidence.js";
-export { formatMarkdownTestPlan, generateTestPlan } from "./test-plan.js";
+export { addedDiffTextFromEvidence, collectAddedDiffEvidence, collectAddedDiffText, formatMarkdownTestPlan, generateTestPlan, } from "./test-plan.js";
 export { formatMarkdownVerifyReport, formatVerifyReport, verifyChange } from "./verify.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,cAAc,EACd,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,EAC7B,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kCAAkC,EAClC,gCAAgC,EAChC,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kCAAkC,EAClC,kCAAkC,EAClC,+BAA+B,EAC/B,2BAA2B,EAC3B,uCAAuC,EACvC,uCAAuC,EACvC,oCAAoC,EACpC,0CAA0C,EAC1C,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAC1H,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,cAAc,EACd,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,EAC7B,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kCAAkC,EAClC,gCAAgC,EAChC,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kCAAkC,EAClC,kCAAkC,EAClC,+BAA+B,EAC/B,2BAA2B,EAC3B,uCAAuC,EACvC,uCAAuC,EACvC,oCAAoC,EACpC,0CAA0C,EAC1C,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAC1H,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/qa.js

@@ -7,8 +7,9 @@ export async function generateQaDraft(rootInput, options = {}) {
         ...options,
         dryRun: true,
     });
-    const flows = draft.files.map((file) => qaFlowFromDraftFile(file));
-    const missingEvidence = buildMissingEvidence(draft.files);
+    const qaFiles = draft.plan.changedFiles.length > 0 ? draft.files : [];
+    const flows = qaFiles.map((file) => qaFlowFromDraftFile(file));
+    const missingEvidence = buildMissingEvidence(qaFiles);
     return {
         tool: {
             name: TOOL_NAME,
@@ -36,6 +37,7 @@ export async function generateQaDraft(rootInput, options = {}) {
     };
 }
 const agentListLimit = 6;
+const agentPayloadByteLimit = 8 * 1024 - 1;
 function truncateForAgent(value, maxLength = 140) {
     return value.length > maxLength ? `${value.slice(0, maxLength - 1)}…` : value;
 }
@@ -45,7 +47,7 @@ export function formatAgentQaDraft(result) {
         .slice(0, 8)
         .map((item) => ({ flow: truncateForAgent(item.flowTitle, 80), kind: item.kind, title: truncateForAgent(item.title) }));
     const requiredBootstrap = result.bootstrap.steps
-        .filter((step) => step.status === "required")
+        .filter((step) => step.status === "required" && step.category !== "runner")
         .slice(0, 3)
         .map((step) => ({ title: truncateForAgent(step.title, 80), action: truncateForAgent(step.action) }));
     const summary = {
@@ -57,33 +59,49 @@ export function formatAgentQaDraft(result) {
         manifest: result.manifestPath ?? null,
         readiness: { score: result.readiness.score, level: result.readiness.level },
         testSuite: { present: result.testSuite.hasTestSuite, files: result.testSuite.testFileCount },
+        intentCount: result.changeAnalysis.intents.length,
+        omittedIntentCount: Math.max(0, result.changeAnalysis.intents.length - 3),
         intents: result.changeAnalysis.intents.slice(0, 3).map((intent) => ({
             title: truncateForAgent(intent.title, 100),
             confidence: intent.confidence,
             reviewRequired: intent.reviewRequired,
-            evidence: intent.evidence.slice(0, 4).map((item) => truncateForAgent(item.value, 100)),
-            lifecycle: intent.lifecycle.slice(0, 8).map((stage) => ({
+            evidence: intent.evidence.slice(0, 2).map((item) => truncateForAgent(item.value, 100)),
+            sources: strongestEvidence(intent.evidence, 1).map(formatAgentEvidenceSource),
+            lifecycle: intent.lifecycle.slice(0, 6).map((stage) => ({
                 phase: stage.kind,
                 label: truncateForAgent(stage.label, 120),
             })),
-            scenarios: intent.scenarios.slice(0, 4).map((scenario) => ({
+            scenarioCount: intent.scenarios.length,
+            omittedScenarioCount: Math.max(0, intent.scenarios.length - 2),
+            scenarios: intent.scenarios.slice(0, 2).map((scenario) => ({
                 priority: scenario.priority,
                 kind: scenario.kind,
                 title: truncateForAgent(scenario.title, 100),
-                assertions: scenario.assertions.slice(0, 3).map((assertion) => truncateForAgent(assertion, 120)),
+                confidence: scenario.confidence ?? "low",
+                reviewRequired: scenario.reviewRequired ?? true,
+                sources: strongestEvidence(scenario.evidence, 1).map(formatAgentEvidenceSource),
+                assertions: scenario.assertions.slice(0, 2).map((assertion) => truncateForAgent(assertion, 120)),
             })),
         })),
-        firstDraftCommand: !result.testSuite.hasTestSuite && needsGeneratedDraft(result)
-            ? firstDraftCreateCommand(result)
+        automation: needsGeneratedDraft(result)
+            ? {
+                optIn: true,
+                adapter: result.runner,
+                setupStatus: result.runnerSetup.status,
+                draftCommand: `qamap e2e draft . --base ${result.base} --head ${result.head}`,
+                setupCommand: result.runnerSetup.status === "proposed" ? result.runnerSetup.setupCommand : undefined,
+            }
             : undefined,
+        flowCount: result.flows.length,
+        omittedFlowCount: Math.max(0, result.flows.length - agentListLimit),
         flows: result.flows.slice(0, agentListLimit).map((flow) => ({
             title: truncateForAgent(flow.title, 80),
-            source: flow.source,
-            draft: flow.draftPath,
+            source: truncateForAgent(flow.source, 60),
+            draft: truncateForAgent(flow.draftPath, 140),
             runnable: flow.runnableStatus,
             verificationMode: flow.verificationMode,
-            entry: flow.entrypointHints[0],
-            changedFiles: flow.changedFiles.slice(0, 4),
+            entry: flow.entrypointHints[0] ? truncateForAgent(flow.entrypointHints[0], 140) : undefined,
+            changedFiles: flow.changedFiles.slice(0, 4).map((file) => truncateForAgent(file, 140)),
             reviewQuestion: flow.userJourney?.reviewQuestion
                 ? truncateForAgent(flow.userJourney.reviewQuestion, 180)
                 : undefined,
@@ -92,16 +110,147 @@ export function formatAgentQaDraft(result) {
                 : undefined,
             steps: flow.draftSteps.slice(0, agentListLimit).map((step) => truncateForAgent(step)),
             selectors: flow.selectorHints.slice(0, 5).map((selector) => truncateForAgent(selector, 100)),
-            existingEvidence: flow.existingEvidencePaths.length > 0 ? flow.existingEvidencePaths.slice(0, 4) : undefined,
+            existingEvidence: flow.existingEvidencePaths.length > 0
+                ? flow.existingEvidencePaths.slice(0, 4).map((file) => truncateForAgent(file, 140))
+                : undefined,
             evidence: flow.why.slice(0, 2).map((reason) => truncateForAgent(reason)),
         })),
         requiredEvidence,
         recommendedEvidenceCount: result.missingEvidence.filter((item) => item.priority === "recommended").length,
         requiredBootstrap,
         prChecklist: result.prChecklist.slice(0, agentListLimit).map((item) => truncateForAgent(item)),
-        commands: result.suggestedCommands.slice(0, 4),
+        commands: result.suggestedCommands.slice(0, 4).map((command) => truncateForAgent(command, 180)),
     };
-    return `${JSON.stringify(summary)}\n`;
+    return `${serializeAgentSummary(summary)}\n`;
+}
+function serializeAgentSummary(summary) {
+    const payload = JSON.stringify(summary);
+    if (Buffer.byteLength(payload) <= agentPayloadByteLimit) {
+        return payload;
+    }
+    const compact = {
+        ...summary,
+        intents: summary.intents.slice(0, 2).map((intent) => ({
+            ...intent,
+            lifecycle: intent.lifecycle.slice(0, 4),
+            scenarios: intent.scenarios.slice(0, 2).map((scenario) => ({
+                ...scenario,
+                assertions: scenario.assertions.slice(0, 1),
+            })),
+        })),
+        flows: summary.flows.slice(0, 3).map((flow) => ({
+            ...flow,
+            changedFiles: flow.changedFiles.slice(0, 2),
+            steps: flow.steps.slice(0, 3),
+            selectors: flow.selectors.slice(0, 2),
+            existingEvidence: flow.existingEvidence?.slice(0, 2),
+            evidence: flow.evidence.slice(0, 1),
+        })),
+        omittedIntentCount: Math.max(0, numericCount(summary.intentCount) - Math.min(2, summary.intents.length)),
+        omittedFlowCount: Math.max(0, numericCount(summary.flowCount) - Math.min(3, summary.flows.length)),
+        requiredEvidence: summary.requiredEvidence.slice(0, 5),
+        requiredBootstrap: summary.requiredBootstrap.slice(0, 2),
+        prChecklist: summary.prChecklist.slice(0, 4),
+        commands: summary.commands.slice(0, 3),
+        compaction: { maxBytes: agentPayloadByteLimit, originalBytes: Buffer.byteLength(payload) },
+    };
+    const compactPayload = JSON.stringify(compact);
+    if (Buffer.byteLength(compactPayload) <= agentPayloadByteLimit) {
+        return compactPayload;
+    }
+    const minimalIntents = compact.intents.slice(0, 1).map((intent) => ({
+        ...intent,
+        lifecycle: intent.lifecycle.slice(0, 3),
+        omittedScenarioCount: Math.max(0, (intent.scenarioCount ?? intent.scenarios.length) - 1),
+        scenarios: intent.scenarios.slice(0, 1),
+    }));
+    const minimalFlows = compact.flows.slice(0, 1).map((flow) => ({
+        ...flow,
+        steps: flow.steps.slice(0, 2),
+        selectors: flow.selectors.slice(0, 1),
+        existingEvidence: flow.existingEvidence?.slice(0, 1),
+    }));
+    const minimalPayload = JSON.stringify({
+        ...compact,
+        omittedIntentCount: Math.max(0, numericCount(summary.intentCount) - minimalIntents.length),
+        intents: minimalIntents,
+        omittedFlowCount: Math.max(0, numericCount(summary.flowCount) - minimalFlows.length),
+        flows: minimalFlows,
+        requiredEvidence: compact.requiredEvidence.slice(0, 3),
+        requiredBootstrap: compact.requiredBootstrap.slice(0, 1),
+        prChecklist: compact.prChecklist.slice(0, 2),
+        commands: compact.commands.slice(0, 2),
+    });
+    if (Buffer.byteLength(minimalPayload) <= agentPayloadByteLimit) {
+        return minimalPayload;
+    }
+    return JSON.stringify({
+        schema: summary.schema,
+        base: truncateForAgent(String(summary.base ?? ""), 180),
+        head: truncateForAgent(String(summary.head ?? ""), 180),
+        project: summary.project,
+        runner: summary.runner,
+        manifest: summary.manifest ? truncateForAgent(String(summary.manifest), 180) : null,
+        readiness: summary.readiness,
+        testSuite: summary.testSuite,
+        intentCount: summary.intentCount,
+        omittedIntentCount: summary.intentCount,
+        intents: [],
+        flowCount: summary.flowCount,
+        omittedFlowCount: summary.flowCount,
+        flows: [],
+        requiredEvidence: [],
+        recommendedEvidenceCount: summary.recommendedEvidenceCount,
+        requiredBootstrap: [],
+        prChecklist: [],
+        commands: [],
+        compaction: { maxBytes: agentPayloadByteLimit, originalBytes: Buffer.byteLength(payload), emergency: true },
+    });
+}
+function numericCount(value) {
+    return typeof value === "number" && Number.isFinite(value) ? Math.max(0, Math.floor(value)) : 0;
+}
+function formatAgentEvidenceSource(evidence) {
+    const source = {
+        kind: evidence.kind,
+        reason: truncateForAgent(evidence.value, 90),
+    };
+    if (evidence.commit)
+        source.commit = evidence.commit.slice(0, 12);
+    if (evidence.file)
+        source.file = evidence.file;
+    if (evidence.previousFile)
+        source.previousFile = evidence.previousFile;
+    if (evidence.symbol)
+        source.symbol = evidence.symbol;
+    if (evidence.relation)
+        source.relation = evidence.relation;
+    if (evidence.side)
+        source.side = evidence.side;
+    if (evidence.startLine !== undefined)
+        source.startLine = evidence.startLine;
+    if (evidence.endLine !== undefined)
+        source.endLine = evidence.endLine;
+    if (evidence.hunkHeader)
+        source.hunk = truncateForAgent(evidence.hunkHeader, 80);
+    return source;
+}
+function strongestEvidence(evidence, limit) {
+    return evidence
+        .map((item, index) => ({ item, index }))
+        .sort((left, right) => evidenceStrength(right.item) - evidenceStrength(left.item) || left.index - right.index)
+        .slice(0, limit)
+        .map(({ item }) => item);
+}
+function evidenceStrength(evidence) {
+    const relationScore = evidence.relation === "direct" ? 2 : evidence.relation === "supporting" ? 1 : 0;
+    if (evidence.kind === "diff" && evidence.file && evidence.startLine !== undefined)
+        return 4 + relationScore;
+    if (evidence.kind === "diff" && evidence.file)
+        return 2 + relationScore;
+    if (evidence.commit)
+        return 1;
+    return 0;
 }
 export function formatMarkdownQaDraft(result) {
     const lines = [];
@@ -147,17 +296,20 @@ export function formatMarkdownQaDraft(result) {
             lines.push(`- Verification mode: ${formatVerificationMode(primaryFlow.verificationMode)}; no new product-journey E2E draft is proposed.`);
         }
         else {
-            lines.push(`- Proposed draft: \`${escapeMarkdownInline(primaryFlow.draftPath)}\` (${formatRunnableStatus(primaryFlow.runnableStatus)})`);
+            lines.push(`- QA proposal: ${primaryFlow.draftSteps.length || fallbackDraftSteps(primaryFlow).length} review steps; executable automation remains optional.`);
         }
     }
-    lines.push(`- Next command: \`${escapeMarkdownInline(nextStepCommand(result))}\``);
+    const nextCommand = nextStepCommand(result);
+    if (nextCommand) {
+        lines.push(`- Repository validation: \`${escapeMarkdownInline(nextCommand)}\``);
+    }
     const blocking = result.missingEvidence.filter((item) => item.priority === "required").slice(0, 2);
     if (blocking.length === 0) {
-        lines.push("- Missing before trust: no required evidence gap detected; review the draft and run the validation command.");
+        lines.push("- QA proposal gaps: no required evidence gap detected; review the scenario sources and run repository validation.");
     }
     else {
         for (const [index, item] of blocking.entries()) {
-            lines.push(`- Missing before trust${blocking.length > 1 ? ` ${index + 1}` : ""}: ${escapeMarkdownInline(item.title)} — ${escapeMarkdownInline(item.detail)}`);
+            lines.push(`- QA proposal gap${blocking.length > 1 ? ` ${index + 1}` : ""}: ${escapeMarkdownInline(item.title)}: ${escapeMarkdownInline(item.detail)}`);
         }
     }
     lines.push("");
@@ -167,37 +319,11 @@ export function formatMarkdownQaDraft(result) {
     lines.push(`- Base: \`${escapeMarkdownInline(result.base)}\``);
     lines.push(`- Head: \`${escapeMarkdownInline(result.head)}\``);
     lines.push(`- Project: ${formatProjectType(result.project)}`);
-    lines.push(`- Automation adapter: ${formatRunnerName(result.runner)}`);
     lines.push(`- Manifest: ${result.manifestPath ? `\`${escapeMarkdownInline(result.manifestPath)}\`` : "not found; using repo signals and PR diff only"}`);
     lines.push(`- Stage: ${formatDraftReadinessStage(result.readiness)}`);
     lines.push(`- Draft flows: ${result.flows.length}`);
     lines.push("");
     appendQaChangeIntentMarkdown(lines, result);
-    if (!result.testSuite.hasTestSuite && needsGeneratedDraft(result)) {
-        lines.push("## First E2E Draft Bootstrap");
-        lines.push("");
-        lines.push(`QAMap did not find committed test files for this target. The next step is to create the first runnable starter draft, not to stop at a checklist.`);
-        lines.push("");
-        lines.push(`- Recommended first runner: ${formatRunnerName(result.runner)}`);
-        lines.push(`- Create command: \`${escapeMarkdownInline(firstDraftCreateCommand(result))}\``);
-        const installCommand = result.runnerSetup.installCommands[0];
-        if (installCommand) {
-            lines.push(`- Install command: \`${escapeMarkdownInline(installCommand)}\``);
-        }
-        const filesToCreate = uniqueStrings([...result.runnerSetup.filesToCreate, ...result.flows.map((flow) => flow.draftPath)]);
-        if (filesToCreate.length > 0) {
-            lines.push("- Draft files QAMap can create:");
-            for (const file of filesToCreate.slice(0, 6)) {
-                lines.push(`  - \`${escapeMarkdownInline(file)}\``);
-            }
-        }
-        const filesToUpdate = result.runnerSetup.filesToUpdate;
-        if (filesToUpdate.length > 0) {
-            lines.push(`- Files to update: ${filesToUpdate.map((file) => `\`${escapeMarkdownInline(file)}\``).join(", ")}`);
-        }
-        lines.push("- Generated drafts are starter E2E code; keep them review-only until the changed flow has real assertions, fixtures, and selectors.");
-        lines.push("");
-    }
     lines.push("## PR Comment Draft");
     lines.push("");
     lines.push("### Affected Flow");
@@ -222,7 +348,7 @@ export function formatMarkdownQaDraft(result) {
         }
     }
     lines.push("");
-    lines.push("### Suggested E2E / QA Draft");
+    lines.push("### Suggested QA Scenarios");
     lines.push("");
     for (const flow of result.flows) {
         if (flow.existingEvidencePaths.length > 0) {
@@ -232,7 +358,7 @@ export function formatMarkdownQaDraft(result) {
             lines.push(`- Run ${formatVerificationMode(flow.verificationMode)} with the suggested repository validation command; no new product-journey E2E draft is proposed.`);
         }
         else {
-            lines.push(`- \`${escapeMarkdownInline(flow.draftPath)}\`: ${formatRunnableStatus(flow.runnableStatus)}`);
+            lines.push(`- ${escapeMarkdownInline(flow.title)}`);
         }
         const routeHint = flow.entrypointHints.find((hint) => hint.startsWith("route:"));
         if (routeHint) {
@@ -250,7 +376,7 @@ export function formatMarkdownQaDraft(result) {
         }
     }
     lines.push("");
-    lines.push("### Missing Evidence Before Trusting This PR");
+    lines.push("### Evidence Gaps In This QA Proposal");
     lines.push("");
     if (result.missingEvidence.length === 0) {
         lines.push("- No required evidence gap was detected in the generated QA draft. Still run the project validation command before merge.");
@@ -276,6 +402,20 @@ export function formatMarkdownQaDraft(result) {
         lines.push(`- ${escapeMarkdownInline(item)}`);
     }
     lines.push("");
+    if (needsGeneratedDraft(result)) {
+        lines.push("## Optional Automation");
+        lines.push("");
+        lines.push("The QA judgment above does not require adopting this adapter. Use this section only when the team wants to turn an accepted scenario into executable coverage.");
+        lines.push("");
+        lines.push(`- Adapter candidate: ${formatRunnerName(result.runner)}`);
+        lines.push(`- Draft target: \`${escapeMarkdownInline(result.flows[0]?.draftPath ?? "generated E2E file")}\` (${formatRunnableStatus(result.flows[0]?.runnableStatus)})`);
+        lines.push(`- Preview or create a draft: \`qamap e2e draft . --base ${escapeMarkdownInline(result.base)} --head ${escapeMarkdownInline(result.head)}\``);
+        if (result.runnerSetup.status === "proposed" && result.runnerSetup.setupCommand) {
+            lines.push(`- If the team accepts this adapter, inspect its setup proposal: \`${escapeMarkdownInline(result.runnerSetup.setupCommand)}\``);
+        }
+        lines.push("- Treat generated code as review-only until its scenario sources, assertions, fixtures, and selectors are confirmed.");
+        lines.push("");
+    }
     return lines.join("\n");
 }
 function appendQaChangeIntentMarkdown(lines, result) {
@@ -295,11 +435,20 @@ function appendQaChangeIntentMarkdown(lines, result) {
         }
         lines.push("- Lifecycle:");
         for (const stage of intent.lifecycle.slice(0, 10)) {
-            lines.push(`  - ${stage.kind}: ${escapeMarkdownInline(stage.label)}`);
+            const source = stage.evidence.find((item) => item.file || item.commit);
+            const sourceSuffix = source ? ` (${formatEvidenceReference(source)})` : "";
+            lines.push(`  - ${stage.kind}: ${escapeMarkdownInline(stage.label)}${sourceSuffix}`);
         }
         lines.push("- QA scenarios:");
         for (const scenario of intent.scenarios.slice(0, 4)) {
-            lines.push(`  - [${scenario.priority}] ${escapeMarkdownInline(scenario.title)}`);
+            const confidence = scenario.confidence ?? "low";
+            const reviewRequired = scenario.reviewRequired ?? true;
+            lines.push(`  - [${scenario.priority}] ${escapeMarkdownInline(scenario.title)} ` +
+                `(confidence: ${confidence}${reviewRequired ? "; review required" : ""})`);
+            lines.push(`    - Why: ${escapeMarkdownInline(scenario.rationale)}`);
+            for (const source of strongestEvidence(scenario.evidence, 3)) {
+                lines.push(`    - Source: ${formatEvidenceReference(source)}: ${escapeMarkdownInline(source.value)}`);
+            }
             for (const assertion of scenario.assertions.slice(0, 2)) {
                 lines.push(`    - Assert: ${escapeMarkdownInline(assertion)}`);
             }
@@ -307,6 +456,20 @@ function appendQaChangeIntentMarkdown(lines, result) {
         lines.push("");
     }
 }
+function formatEvidenceReference(evidence) {
+    if (evidence.commit) {
+        return `commit \`${evidence.commit.slice(0, 12)}\``;
+    }
+    const lineRange = evidence.startLine === undefined
+        ? ""
+        : evidence.endLine !== undefined && evidence.endLine !== evidence.startLine
+            ? `:${evidence.startLine}-${evidence.endLine}`
+            : `:${evidence.startLine}`;
+    const location = evidence.file ? `\`${escapeMarkdownInline(evidence.file)}${lineRange}\`` : evidence.kind;
+    const symbol = evidence.symbol ? ` symbol \`${escapeMarkdownInline(evidence.symbol)}\`` : "";
+    const qualifiers = [evidence.relation, evidence.side].filter(Boolean).join(", ");
+    return `${location}${symbol}${qualifiers ? ` [${qualifiers}]` : ""}`;
+}
 function summarizeIntentLifecycle(lifecycle) {
     const preferredPhases = ["trigger", "condition", "state-change", "side-effect", "observable-outcome"];
     const selected = preferredPhases
@@ -316,15 +479,11 @@ function summarizeIntentLifecycle(lifecycle) {
     return fallback.map((stage) => `${stage.kind}: ${stage.label}`).join(" -> ");
 }
 function nextStepCommand(result) {
-    if (!result.testSuite.hasTestSuite && needsGeneratedDraft(result)) {
-        return firstDraftCreateCommand(result);
-    }
     const validationCommand = result.suggestedCommands[0];
     if (validationCommand) {
         return validationCommand;
     }
-    const draftPath = result.flows[0]?.draftPath;
-    return draftPath ? `review ${draftPath}` : "qamap e2e draft . --dry-run";
+    return undefined;
 }
 function atAGlanceEvidence(flow) {
     const stableSelector = flow.selectorHints.find((selector) => /^(?:web-test-id|test-id|input-web-test-id|input-test-id|accessibility-label|role-button):/i.test(selector)) ?? flow.selectorHints[0];
@@ -335,12 +494,6 @@ function atAGlanceEvidence(flow) {
     ].filter((value) => Boolean(value));
     return uniqueStrings(evidence).slice(0, 3);
 }
-function firstDraftCreateCommand(result) {
-    if (result.runnerSetup.setupCommand) {
-        return result.runnerSetup.setupCommand;
-    }
-    return `qamap e2e draft . --base ${result.base} --head ${result.head}`;
-}
 function qaFlowFromDraftFile(file) {
     const verificationMode = verificationModeForTitle(file.flowTitle);
     return {
@@ -387,20 +540,10 @@ function buildMissingEvidence(files) {
     const evidence = [];
     for (const file of files) {
         for (const item of file.actionItems ?? []) {
-            evidence.push(missingEvidenceFromAction(file, item));
-        }
-        const actionText = normalizeEvidenceText((file.actionItems ?? []).map((item) => `${item.title} ${item.detail}`).join(" "));
-        for (const blocker of file.executionBlockers ?? []) {
-            if (actionTextCoversBlocker(actionText, blocker)) {
+            if (item.kind === "runner" || item.kind === "validation") {
                 continue;
             }
-            evidence.push({
-                flowTitle: file.flowTitle,
-                priority: "required",
-                kind: "blocker",
-                title: "Resolve execution blocker",
-                detail: blocker,
-            });
+            evidence.push(missingEvidenceFromAction(file, item));
         }
     }
     const unique = uniqueMissingEvidence(evidence);
@@ -408,20 +551,6 @@ function buildMissingEvidence(files) {
     const recommended = unique.filter((item) => item.priority !== "required");
     return [...required, ...recommended].slice(0, 12);
 }
-function normalizeEvidenceText(value) {
-    return value.toLowerCase().replace(/[^a-z0-9\uAC00-\uD7A3 ]+/g, " ").replace(/\s+/g, " ").trim();
-}
-function actionTextCoversBlocker(actionText, blocker) {
-    if (!actionText) {
-        return false;
-    }
-    const blockerTokens = normalizeEvidenceText(blocker).split(" ").filter((token) => token.length > 3);
-    if (blockerTokens.length === 0) {
-        return false;
-    }
-    const covered = blockerTokens.filter((token) => actionText.includes(token)).length;
-    return covered / blockerTokens.length >= 0.7;
-}
 function missingEvidenceFromAction(file, item) {
     return {
         flowTitle: file.flowTitle,
@@ -448,9 +577,11 @@ function buildPrChecklist(draft, flows, missingEvidence) {
             ? `Run the changed test evidence: ${flows[0].existingEvidencePaths.slice(0, 4).join(", ")}.`
             : flows[0]?.verificationMode
                 ? `Run ${formatVerificationMode(flows[0].verificationMode)} with ${draft.plan.suggestedCommands[0] ?? "the nearest repository validation command"}.`
-                : flows.length > 0
-                    ? `Review the generated draft path: ${flows.map((flow) => flow.draftPath).slice(0, 3).join(", ")}.`
-                    : "Run QAMap again after adding branch or working tree changes.",
+                : draft.plan.changeAnalysis.intents[0]
+                    ? `Review the proposed QA scenarios and their sources for: ${draft.plan.changeAnalysis.intents[0].title}.`
+                    : flows.length > 0
+                        ? `Review the affected-flow evidence for: ${flows.map((flow) => flow.title).slice(0, 3).join(", ")}.`
+                        : "Run QAMap again after adding branch or working tree changes.",
         flows[0]?.userJourney?.reviewQuestion
             ? `Answer the reviewer question: ${flows[0].userJourney.reviewQuestion}`
             : "Name the user-visible behavior or contract this PR can break.",
@@ -477,9 +608,11 @@ function buildAgentHandoff(draft, flows, missingEvidence) {
             ? `Run the changed test evidence (${flows[0].existingEvidencePaths.slice(0, 3).join(", ")}) and record the result before handoff.`
             : flows[0]?.verificationMode
                 ? `Run ${formatVerificationMode(flows[0].verificationMode)} and record the command and result before handoff; do not invent a product-journey E2E for this diff alone.`
-                : flows.length > 0
-                    ? `Start from ${flows[0].draftPath} and close required evidence before treating it as regression coverage.`
-                    : undefined,
+                : draft.plan.changeAnalysis.intents[0]
+                    ? `Review each proposed scenario and its diff sources for ${draft.plan.changeAnalysis.intents[0].title} before using it as PR policy.`
+                    : flows.length > 0
+                        ? `Review the affected-flow evidence for ${flows[0].title} before using it as PR policy.`
+                        : undefined,
         missingEvidence.length > 0 ? "Close required evidence gaps before treating this QA draft as merge proof." : undefined,
         flows.some((flow) => !flow.verificationMode)
             ? "A wrong flow recommendation should become a manifest correction, so future PRs improve without another prompt."