@mergesignal/shared 0.12.0 → 0.12.2

package/dist/presentation/decisionSurface.test.js

@@ -0,0 +1,290 @@
+import { extractAuthoredCommunication } from "@mergesignal/contracts";
+import { describe, expect, it } from "vitest";
+import { minimalReviewFocalPoint, reachScopeFor, verificationScopeFor, withAssessmentScope, } from "../fixtures/assessmentScopeFixtures.js";
+import { buildScanPresentationBundle } from "./orchestration/buildScanPresentationBundle.js";
+// ─── Vocabulary firewall ──────────────────────────────────────────────────────
+/** Engine vocabulary that must never appear in any developer-facing authored string. */
+const ENGINE_VOCABULARY = [
+    "constraint_satisfiability",
+    "lockfile_integrity",
+    "type_surface_compatibility",
+    "export_resolution",
+    "peer_dependency",
+    "engine_constraint",
+    "no_impact_proven",
+    "proof_pass",
+    "bounded_verify",
+    "representative_precision_only",
+    "architectural_precision_only",
+    "clearanceEnvelope",
+    "coverageClass",
+    "precisionLevel",
+    "proofArtifact",
+    "packageOutcome",
+    "qualityClass",
+    "qualityBasis",
+    "proofFingerprint",
+    "observationId",
+    "dimension_verification",
+];
+// ─── Fixture helpers ──────────────────────────────────────────────────────────
+function scanResultWith(assessment) {
+    return {
+        totalScore: 70,
+        layerScores: {
+            security: 70,
+            maintainability: 70,
+            ecosystem: 70,
+            upgradeImpact: 70,
+        },
+        findings: [],
+        generatedAt: "2026-01-01T00:00:00Z",
+        changedPackages: assessment.reviewFocalPoint.anchors,
+        methodologyVersion: "mergesignal-engine/test",
+        assessment,
+        decision: {
+            recommendation: "needs_review",
+            confidence: "medium",
+            reasoning: [],
+        },
+        insights: [],
+    };
+}
+function assessmentWithTrustLine() {
+    return withAssessmentScope({
+        posture: "safe",
+        confidence: "high",
+        primaryConcern: null,
+        concerns: [],
+        factors: [],
+        changeClasses: [],
+        presentation: {
+            narrativeIntensity: "standard",
+            reachVisibility: "contextual",
+            verificationIntensity: "none",
+            insightEmissionFloor: "full",
+            reportMode: "high_signal_pr",
+        },
+        reasoning: [
+            "All peer dependency constraints verified — no runtime breakage confirmed.",
+            "Export compatibility proven unused in this repository.",
+        ],
+        confidenceRationale: "Confidence is high: all assessed dimensions were verified by deterministic proof.",
+    }, {
+        reviewFocalPoint: minimalReviewFocalPoint(["express"]),
+        reachScope: reachScopeFor(["express"]),
+        verificationScope: verificationScopeFor(["express"]),
+    });
+}
+function assessmentWithElectionSummary() {
+    return withAssessmentScope({
+        posture: "needs_review",
+        confidence: "medium",
+        primaryConcern: "confirmed_runtime_usage",
+        concerns: [
+            {
+                kind: "confirmed_runtime_usage",
+                rank: 1,
+                packages: ["fastify"],
+                evidenceRefs: [],
+                context: "Runtime usage: `fastify` — used in HTTP request handling.",
+            },
+        ],
+        factors: ["confirmed_runtime_usage"],
+        changeClasses: ["runtime_upgrade"],
+        presentation: {
+            narrativeIntensity: "standard",
+            reachVisibility: "contextual",
+            verificationIntensity: "required",
+            insightEmissionFloor: "full",
+            reportMode: "high_signal_pr",
+        },
+        reasoning: [
+            "fastify is used in HTTP request handling in this repository.",
+        ],
+        confidenceRationale: "Confidence is medium: runtime usage was observed but proof coverage is representative.",
+        notAffectedLine: null,
+        resolutionLine: null,
+    }, {
+        reviewFocalPoint: {
+            episodeShape: "single_anchor",
+            anchors: ["fastify"],
+            electionSummary: "`fastify` was selected as the review anchor over `fastify-plugin` due to higher runtime reach.",
+            election: {
+                grounding: [
+                    {
+                        packageName: "fastify",
+                        reason: "highest_runtime_reach",
+                        decidedBy: "reach",
+                        evidenceRefs: [],
+                    },
+                ],
+                exclusions: [
+                    {
+                        packageName: "fastify-plugin",
+                        reason: "lower_runtime_reach",
+                        lostOn: "reach",
+                        evidenceRefs: [],
+                    },
+                ],
+            },
+        },
+        reachScope: reachScopeFor(["fastify"]),
+        verificationScope: verificationScopeFor(["fastify"]),
+    });
+}
+function assessmentUncontestedElection() {
+    return withAssessmentScope({
+        posture: "needs_review",
+        confidence: "medium",
+        primaryConcern: "confirmed_runtime_usage",
+        concerns: [],
+        factors: ["confirmed_runtime_usage"],
+        changeClasses: ["runtime_upgrade"],
+        presentation: {
+            narrativeIntensity: "standard",
+            reachVisibility: "contextual",
+            verificationIntensity: "required",
+            insightEmissionFloor: "full",
+            reportMode: "high_signal_pr",
+        },
+        reasoning: ["express is used in HTTP request handling."],
+        confidenceRationale: "Confidence is high: runtime usage was directly observed.",
+    }, {
+        reviewFocalPoint: minimalReviewFocalPoint(["express"]),
+        reachScope: reachScopeFor(["express"]),
+        verificationScope: verificationScopeFor(["express"]),
+    });
+}
+function assessmentWithQ8Q9() {
+    return withAssessmentScope({
+        posture: "needs_review",
+        confidence: "medium",
+        primaryConcern: "confirmed_runtime_usage",
+        concerns: [],
+        factors: ["confirmed_runtime_usage"],
+        changeClasses: ["runtime_upgrade"],
+        outcome: "bounded_verify",
+        presentation: {
+            narrativeIntensity: "standard",
+            reachVisibility: "contextual",
+            verificationIntensity: "required",
+            insightEmissionFloor: "full",
+            reportMode: "high_signal_pr",
+        },
+        reasoning: ["Automation stopped before all dimensions were verified."],
+        confidenceRationale: "Confidence is medium: bounded verification is required.",
+        notAffectedLine: "No repository code paths are affected by export compatibility — this dimension is outside the review scope.",
+        resolutionLine: "A passing automated verification for this dimension would make this deterministic.",
+    }, {
+        reviewFocalPoint: minimalReviewFocalPoint(["express"]),
+        reachScope: reachScopeFor(["express"]),
+        verificationScope: {
+            packages: ["express"],
+            focus: [],
+            guidance: ["Verify route handler at `src/server.ts:42`."],
+        },
+    });
+}
+// ─── V1 bundle transport ──────────────────────────────────────────────────────
+describe("decision surface contract (V1) — bundle transport", () => {
+    it("trustLine carries confidenceRationale verbatim from assessment", () => {
+        const assessment = assessmentWithTrustLine();
+        const bundle = buildScanPresentationBundle({
+            result: scanResultWith(assessment),
+            pipelineStatus: "done",
+        });
+        expect(bundle).not.toBeNull();
+        expect(bundle.trustLine).toBe(assessment.confidenceRationale);
+    });
+    it("whyThisPackageLine carries electionSummary verbatim when present", () => {
+        const assessment = assessmentWithElectionSummary();
+        const bundle = buildScanPresentationBundle({
+            result: scanResultWith(assessment),
+            pipelineStatus: "done",
+        });
+        expect(bundle.whyThisPackageLine).toBe(assessment.reviewFocalPoint.electionSummary);
+    });
+    it("whyThisPackageLine is null when electionSummary is absent", () => {
+        const assessment = assessmentUncontestedElection();
+        const bundle = buildScanPresentationBundle({
+            result: scanResultWith(assessment),
+            pipelineStatus: "done",
+        });
+        expect(bundle.whyThisPackageLine).toBeNull();
+    });
+    it("reasoningLines and guidanceLines carry assessment arrays verbatim", () => {
+        const assessment = assessmentWithQ8Q9();
+        const bundle = buildScanPresentationBundle({
+            result: scanResultWith(assessment),
+            pipelineStatus: "done",
+        });
+        expect(bundle.reasoningLines).toEqual(assessment.reasoning);
+        expect(bundle.guidanceLines).toEqual(assessment.verificationScope.guidance ?? []);
+    });
+    it("notAffectedLine and resolutionLine survive parse and transport (Q8/Q9)", () => {
+        const assessment = assessmentWithQ8Q9();
+        const bundle = buildScanPresentationBundle({
+            result: scanResultWith(assessment),
+            pipelineStatus: "done",
+        });
+        expect(bundle.notAffectedLine).toBe(assessment.notAffectedLine);
+        expect(bundle.resolutionLine).toBe(assessment.resolutionLine);
+    });
+    it("concernContextLines carries concerns[].context verbatim", () => {
+        const assessment = assessmentWithElectionSummary();
+        const bundle = buildScanPresentationBundle({
+            result: scanResultWith(assessment),
+            pipelineStatus: "done",
+        });
+        expect(bundle.concernContextLines).toEqual([
+            "Runtime usage: `fastify` — used in HTTP request handling.",
+        ]);
+    });
+    it("public bundle accessors match extractAuthoredCommunication", () => {
+        const assessment = assessmentWithQ8Q9();
+        const normalized = assessment;
+        const expected = extractAuthoredCommunication(normalized);
+        const bundle = buildScanPresentationBundle({
+            result: scanResultWith(assessment),
+            pipelineStatus: "done",
+        });
+        expect(bundle.trustLine).toBe(expected.trustLine);
+        expect(bundle.whyThisPackageLine).toBe(expected.whyThisPackageLine);
+        expect(bundle.notAffectedLine).toBe(expected.notAffectedLine);
+        expect(bundle.resolutionLine).toBe(expected.resolutionLine);
+        expect(bundle.reasoningLines).toEqual(expected.reasoningLines);
+        expect(bundle.guidanceLines).toEqual(expected.guidanceLines);
+        expect(bundle.concernContextLines).toEqual(expected.concernContextLines);
+    });
+});
+// ─── Vocabulary firewall ──────────────────────────────────────────────────────
+describe("decision surface contract (V1) — vocabulary firewall on accessors", () => {
+    function assertNoEngineVocabulary(strings, context) {
+        for (const token of ENGINE_VOCABULARY) {
+            for (const str of strings) {
+                if (!str)
+                    continue;
+                expect(str, `${context}: must not contain engine token "${token}"`).not.toContain(token);
+            }
+        }
+    }
+    it("bundle accessors carry no engine vocabulary", () => {
+        const assessment = assessmentWithQ8Q9();
+        const bundle = buildScanPresentationBundle({
+            result: scanResultWith(assessment),
+            pipelineStatus: "done",
+        });
+        assertNoEngineVocabulary([
+            bundle.trustLine,
+            bundle.whyThisPackageLine,
+            bundle.notAffectedLine,
+            bundle.resolutionLine,
+            ...bundle.reasoningLines,
+            ...bundle.guidanceLines,
+            ...bundle.concernContextLines,
+        ], "bundle accessors");
+    });
+});
+// V3 surface delivery (Dashboard, Scan Details) is intentionally excluded from V1 graduation.
+// See presentDashboardCard / presentScanDetails adoption in V3 Surface Adoption roadmap.

package/dist/presentation/dto/assessmentPresentationFields.d.ts

@@ -10,5 +10,9 @@ export type AssessmentPresentationFields = {
     verificationChannel: VerificationChannel;
     reachVisibility: ReachVisibility;
     narrativeIntensity: NarrativeIntensity;
+    /** ABI 3 expression — optional confidence explanation. */
+    confidenceRationale?: string;
+    /** ABI 3 expression — optional focal-election narrative. */
+    electionSummary?: string;
 };
 //# sourceMappingURL=assessmentPresentationFields.d.ts.map

package/dist/presentation/dto/assessmentPresentationFields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assessmentPresentationFields.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/assessmentPresentationFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAEhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,uEAAuE;AACvE,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC;IAC3C,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,eAAe,EAAE,eAAe,CAAC;IACjC,kBAAkB,EAAE,kBAAkB,CAAC;CACxC,CAAC"}
+{"version":3,"file":"assessmentPresentationFields.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/assessmentPresentationFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAEhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,uEAAuE;AACvE,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC;IAC3C,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,eAAe,EAAE,eAAe,CAAC;IACjC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC"}

package/dist/presentation/index.d.ts

@@ -24,5 +24,5 @@ export { renderGitHubCheckRunMarkdown } from "./render/renderGitHubCheckRunMarkd
 export { buildGitHubCheckRunOutput, resolveWebAppOrigin, type GitHubCheckRunConclusion, type GitHubCheckRunOutput, type BuildGitHubCheckRunOutputOptions, } from "./buildGitHubCheckRunOutput.js";
 export { renderGitHubPrCommentMarkdown } from "./render/renderGitHubPrCommentMarkdown.js";
 export { renderCliScanSummaryText } from "./render/renderCliScanSummaryText.js";
-export { buildNarrativeChannels, projectCompactKeyPoints, composeHeadline, composeSubheadline, composeKeyPoints, composeVerificationActions, composeAffectedAreaLabels, composeEvidenceRows, composeSupportingContext, evidenceContextFromProfile, } from "./compose/narrativeCompose.js";
+export { buildNarrativeChannels, projectCompactKeyPoints, composeHeadline, composeSubheadline, composeKeyPoints, composeVerificationActions, composeAffectedAreaLabels, composeSupportingContext, evidenceContextFromProfile, } from "./compose/narrativeCompose.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/presentation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,gCAAgC,EAAE,MAAM,gDAAgD,CAAC;AACvG,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,YAAY,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AACnG,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,YAAY,EAAE,iCAAiC,EAAE,MAAM,iDAAiD,CAAC;AAEzG,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EACV,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,gDAAgD;AAChD,YAAY,EAAE,yBAAyB,IAAI,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC5G,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,gCAAgC,GACtC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,gCAAgC,EAAE,MAAM,gDAAgD,CAAC;AACvG,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,YAAY,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AACnG,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,YAAY,EAAE,iCAAiC,EAAE,MAAM,iDAAiD,CAAC;AAEzG,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EACV,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,gDAAgD;AAChD,YAAY,EAAE,yBAAyB,IAAI,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC5G,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,gCAAgC,GACtC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC"}

package/dist/presentation/index.js

@@ -10,4 +10,4 @@ export { renderGitHubCheckRunMarkdown } from "./render/renderGitHubCheckRunMarkd
 export { buildGitHubCheckRunOutput, resolveWebAppOrigin, } from "./buildGitHubCheckRunOutput.js";
 export { renderGitHubPrCommentMarkdown } from "./render/renderGitHubPrCommentMarkdown.js";
 export { renderCliScanSummaryText } from "./render/renderCliScanSummaryText.js";
-export { buildNarrativeChannels, projectCompactKeyPoints, composeHeadline, composeSubheadline, composeKeyPoints, composeVerificationActions, composeAffectedAreaLabels, composeEvidenceRows, composeSupportingContext, evidenceContextFromProfile, } from "./compose/narrativeCompose.js";
+export { buildNarrativeChannels, projectCompactKeyPoints, composeHeadline, composeSubheadline, composeKeyPoints, composeVerificationActions, composeAffectedAreaLabels, composeSupportingContext, evidenceContextFromProfile, } from "./compose/narrativeCompose.js";

package/dist/presentation/orchestration/buildScanPresentationBundle.d.ts

@@ -9,6 +9,7 @@ export type BuildScanPresentationBundleInput = {
 /**
  * Mandatory orchestration entrypoint for completed-scan presentation.
  * Assessment is the sole authority; profile is a thin projection.
+ * Consumes only the public ScanResult contract — see docs/engineering/presentation-ownership.md.
  */
 export declare function buildScanPresentationBundle(input: BuildScanPresentationBundleInput): ScanPresentationBundle | null;
 //# sourceMappingURL=buildScanPresentationBundle.d.ts.map

package/dist/presentation/orchestration/buildScanPresentationBundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildScanPresentationBundle.d.ts","sourceRoot":"","sources":["../../../src/presentation/orchestration/buildScanPresentationBundle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,sBAAsB,GAAG,IAAI,CA4B/B"}
+{"version":3,"file":"buildScanPresentationBundle.d.ts","sourceRoot":"","sources":["../../../src/presentation/orchestration/buildScanPresentationBundle.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,sBAAsB,GAAG,IAAI,CA8B/B"}

package/dist/presentation/orchestration/buildScanPresentationBundle.js

@@ -1,10 +1,11 @@
-import { parseAssessmentOrThrow } from "@mergesignal/contracts";
+import { extractAuthoredCommunication, parseAssessmentOrThrow, } from "@mergesignal/contracts";
 import { toPublicPresentation } from "../../assessmentPresentationUtils.js";
 import { deriveScanNarrative } from "../../deriveScanNarrative.js";
 import { buildProfileFromAssessment } from "../profile/buildProfileFromAssessment.js";
 /**
  * Mandatory orchestration entrypoint for completed-scan presentation.
  * Assessment is the sole authority; profile is a thin projection.
+ * Consumes only the public ScanResult contract — see docs/engineering/presentation-ownership.md.
  */
 export function buildScanPresentationBundle(input) {
     if (input.pipelineStatus !== "done" || !input.result)
@@ -22,11 +23,13 @@ export function buildScanPresentationBundle(input) {
     const presentation = toPublicPresentation(normalized.presentation);
     const profile = buildProfileFromAssessment(normalized, presentation, input.result);
     const facts = deriveScanNarrative(input.result);
+    const authored = extractAuthoredCommunication(normalized);
     return {
         assessment: normalized,
         presentation,
         profile,
         facts,
         result: input.result,
+        ...authored,
     };
 }

package/dist/presentation/orchestration/scanPresentationBundle.d.ts

@@ -1,19 +1,19 @@
-import type { Assessment, AssessmentPresentationPublic } from "@mergesignal/contracts";
+import type { Assessment, AssessmentPresentationPublic, AuthoredCommunicationAccessors } from "@mergesignal/contracts";
 import type { ScanNarrativeFacts } from "../../scanNarrativeFacts.js";
 import type { ScanResult } from "../../types.js";
 import type { PresentationProfile } from "../profile/presentationProfile.js";
-export type ScanPresentationBundle = {
+export type ScanPresentationBundle = AuthoredCommunicationAccessors & {
     assessment: Assessment;
     presentation: AssessmentPresentationPublic;
     profile: PresentationProfile;
     /**
      * Evidence layout only — not an authority for posture, concern, or intensity.
-     * @deprecated Prefer assessment + repoIntelligence on result for new code.
+     * @deprecated Prefer bundle accessors for authored communication; V3 migration only.
      */
     facts: ScanNarrativeFacts;
     /**
      * Projection-only reference to the raw scan payload.
-     * Presenters may read fields for formatting but must NOT re-derive interpretation.
+     * @deprecated V3 migration only — surfaces must use accessors for decision meaning.
      */
     result: ScanResult;
 };

package/dist/presentation/orchestration/scanPresentationBundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanPresentationBundle.d.ts","sourceRoot":"","sources":["../../../src/presentation/orchestration/scanPresentationBundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,4BAA4B,EAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,4BAA4B,CAAC;IAC3C,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;;OAGG;IACH,KAAK,EAAE,kBAAkB,CAAC;IAC1B;;;OAGG;IACH,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC"}
+{"version":3,"file":"scanPresentationBundle.d.ts","sourceRoot":"","sources":["../../../src/presentation/orchestration/scanPresentationBundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,4BAA4B,EAC5B,8BAA8B,EAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,MAAM,MAAM,sBAAsB,GAAG,8BAA8B,GAAG;IACpE,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,4BAA4B,CAAC;IAC3C,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;;OAGG;IACH,KAAK,EAAE,kBAAkB,CAAC;IAC1B;;;OAGG;IACH,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC"}

package/dist/presentation/presenters/presentCliScanSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presentCliScanSummary.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentCliScanSummary.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAGzF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,mBAAmB,CAiCrB"}
+{"version":3,"file":"presentCliScanSummary.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentCliScanSummary.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAGzF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,mBAAmB,CAmCrB"}

package/dist/presentation/presenters/presentCliScanSummary.js

@@ -1,14 +1,16 @@
-import { scoreToBandLabel } from "../../prRiskBand.js";
+import { formatPrRiskSummary } from "../../prRiskBand.js";
 import { resolvePrRiskLayerScores } from "../../prRiskWire.js";
-import { buildNarrativeChannels, composeHeadline, composeSubheadline, composeSupportingContext, composeVerificationActions, evidenceContextFromProfile, projectCompactKeyPoints, } from "../compose/narrativeCompose.js";
+import { buildNarrativeChannels, composeSubheadline, composeSupportingContext, evidenceContextFromProfile, projectCompactKeyPoints, } from "../compose/narrativeCompose.js";
 import { projectAssessmentFields } from "../projectAssessmentFields.js";
 export function presentCliScanSummary(bundle, ctx = {}) {
     const { facts, profile, result } = bundle;
+    const channels = buildNarrativeChannels(bundle);
     const layerScores = resolvePrRiskLayerScores(result);
     const layerLine = layerScores
         ? `security=${layerScores.security} maintainability=${layerScores.maintainability} ecosystem=${layerScores.ecosystem} upgradeImpact=${layerScores.upgradeImpact}`
         : "";
-    const prRiskScore = facts.riskSignals?.riskIndex ?? facts.riskIndex ?? 0;
+    const prRisk = formatPrRiskSummary(facts);
+    const prRiskScore = prRisk?.prRiskScore ?? facts.riskIndex ?? 0;
     return {
         ...projectAssessmentFields(bundle),
         header: {
@@ -20,13 +22,13 @@ export function presentCliScanSummary(bundle, ctx = {}) {
         density: profile.density,
         confidence: profile.confidence,
         evidenceContext: evidenceContextFromProfile(bundle),
-        headline: composeHeadline(bundle),
+        headline: channels.headline,
         subheadline: composeSubheadline(bundle),
-        keyPoints: projectCompactKeyPoints(buildNarrativeChannels(bundle), 6),
-        verificationActions: composeVerificationActions(bundle, 5),
+        keyPoints: projectCompactKeyPoints(channels, 6),
+        verificationActions: channels.verification.slice(0, 5),
         metrics: {
             prRiskScore,
-            prRiskBandLabel: scoreToBandLabel(prRiskScore) ?? undefined,
+            prRiskBandLabel: prRisk?.prRiskBandLabel ?? undefined,
             riskIndex: prRiskScore,
             layerLine,
             findingCount: result.findings?.length ?? 0,

package/dist/presentation/presenters/presentGitHubCheckRun.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presentGitHubCheckRun.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentGitHubCheckRun.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAGzF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,0BAA0B,CAmD5B"}
+{"version":3,"file":"presentGitHubCheckRun.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentGitHubCheckRun.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAGzF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,0BAA0B,CAkD5B"}

package/dist/presentation/presenters/presentGitHubCheckRun.js

@@ -1,11 +1,11 @@
-import { scoreToBandLabel } from "../../prRiskBand.js";
-import { buildNarrativeChannels, composeHeadline, composeSubheadline, composeVerificationActions, evidenceContextFromProfile, projectCompactKeyPoints, } from "../compose/narrativeCompose.js";
+import { formatPrRiskSummary } from "../../prRiskBand.js";
+import { buildNarrativeChannels, composeSubheadline, evidenceContextFromProfile, projectCompactKeyPoints, } from "../compose/narrativeCompose.js";
 import { projectAssessmentFields } from "../projectAssessmentFields.js";
 export function presentGitHubCheckRun(bundle, ctx) {
-    const { profile } = bundle;
-    const headline = composeHeadline(bundle);
+    const { facts, profile } = bundle;
+    const channels = buildNarrativeChannels(bundle);
     const assessmentFields = projectAssessmentFields(bundle);
-    const actions = composeVerificationActions(bundle, 3);
+    const actions = channels.verification.slice(0, 3);
     const detailsUrl = `${ctx.webAppOrigin.replace(/\/$/, "")}/scan/${ctx.scanId}`;
     const conclusion = profile.status === "safe"
         ? "success"
@@ -13,13 +13,12 @@ export function presentGitHubCheckRun(bundle, ctx) {
             ? "failure"
             : "neutral";
     const sections = [];
-    const prRiskScore = bundle.facts.riskSignals?.riskIndex;
-    const prRiskBandLabelText = scoreToBandLabel(prRiskScore);
-    if (prRiskScore != null && prRiskBandLabelText) {
+    const prRisk = formatPrRiskSummary(facts);
+    if (prRisk) {
         sections.push({
             id: "why",
             title: "PR Risk",
-            bullets: [`${prRiskScore} (${prRiskBandLabelText})`],
+            bullets: [`${prRisk.prRiskScore} (${prRisk.prRiskBandLabel})`],
         });
     }
     // Use assessment.reasoning directly for the Why section (ABI 3).
@@ -27,7 +26,7 @@ export function presentGitHubCheckRun(bundle, ctx) {
     const reasoningLines = assessmentFields.reasoning.slice(0, 3);
     const whyBullets = reasoningLines.length > 0
         ? reasoningLines
-        : projectCompactKeyPoints(buildNarrativeChannels(bundle), 3);
+        : projectCompactKeyPoints(channels, 3);
     if (whyBullets.length > 0) {
         sections.push({ id: "why", title: "Why", bullets: whyBullets });
     }
@@ -41,9 +40,9 @@ export function presentGitHubCheckRun(bundle, ctx) {
         density: profile.density,
         confidence: profile.confidence,
         evidenceContext: evidenceContextFromProfile(bundle),
-        title: headline,
+        title: channels.headline,
         conclusion,
-        summaryLead: composeSubheadline(bundle) ?? headline,
+        summaryLead: composeSubheadline(bundle) ?? channels.headline,
         sections,
         detailsUrl,
     };

package/dist/presentation/presenters/presentGitHubPrComment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presentGitHubPrComment.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentGitHubPrComment.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAGzF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,2BAA2B,CAqC7B"}
+{"version":3,"file":"presentGitHubPrComment.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentGitHubPrComment.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAGzF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,2BAA2B,CAyC7B"}

package/dist/presentation/presenters/presentGitHubPrComment.js

@@ -1,5 +1,5 @@
 import { MERGE_POSTURE_LABEL } from "../../riskVocabulary.js";
-import { scoreToBandLabel } from "../../prRiskBand.js";
+import { formatPrRiskSummary } from "../../prRiskBand.js";
 import { buildNarrativeChannels, evidenceContextFromProfile, } from "../compose/narrativeCompose.js";
 import { formatChangedPackagesShort } from "../../narrativePresentation.js";
 import { projectAssessmentFields } from "../projectAssessmentFields.js";
@@ -11,22 +11,23 @@ export function presentGitHubPrComment(bundle) {
     const changed = formatChangedPackagesShort(facts, 3);
     if (changed)
         introLines.push(`Changed: ${changed}`);
-    const prRiskScore = bundle.facts.riskSignals?.riskIndex;
-    const prRiskBandLabelText = scoreToBandLabel(prRiskScore);
-    if (prRiskScore != null && prRiskBandLabelText) {
-        introLines.push(`PR Risk: ${prRiskScore} (${prRiskBandLabelText})`);
+    const prRisk = formatPrRiskSummary(facts);
+    if (prRisk) {
+        introLines.push(`PR Risk: ${prRisk.prRiskScore} (${prRisk.prRiskBandLabel})`);
+    }
+    if (assessmentFields.electionSummary) {
+        introLines.push(assessmentFields.electionSummary);
     }
-    const electionSummary = bundle.assessment.reviewFocalPoint.electionSummary;
-    if (electionSummary)
-        introLines.push(electionSummary);
     for (const line of assessmentFields.reasoning.slice(0, 2)) {
         introLines.push(line);
     }
     const verify = channels.verification[0];
     if (verify)
         introLines.push(`Verify: ${verify}`);
-    const guidanceBlocks = channels.verification.slice(0, 3).map((action) => ({
-        message: assessmentFields.reasoning[0] ?? action,
+    const guidanceBlocks = channels.verification
+        .slice(0, 3)
+        .map((action, index) => ({
+        message: assessmentFields.reasoning[index] ?? action,
         where: changed ?? "See scan detail for affected paths.",
         action,
     }));

package/dist/presentation/presenters/presentScanDetails.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presentScanDetails.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentScanDetails.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAGzF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AA6FF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,yBAAyB,GAC7B,uBAAuB,CAiFzB"}
+{"version":3,"file":"presentScanDetails.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentScanDetails.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAGzF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AA6FF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,yBAAyB,GAC7B,uBAAuB,CA6EzB"}

package/dist/presentation/presenters/presentScanDetails.js

@@ -1,6 +1,6 @@
 import { MERGE_CONCERN_LABELS } from "../../assessmentLabels.js";
 import { normalizedPackageUsagePaths } from "../../narrativePresentation.js";
-import { prRiskBandLabel, prRiskBandToGaugeBand, scoreToBandLabel, } from "../../prRiskBand.js";
+import { formatPrRiskSummary, prRiskBandToGaugeBand, } from "../../prRiskBand.js";
 import { MERGE_POSTURE_LABEL } from "../../riskVocabulary.js";
 import { buildNarrativeChannels, composeSubheadline, composeSupportingContext, evidenceContextFromProfile, projectCompactKeyPoints, } from "../compose/narrativeCompose.js";
 import { normalizeGeneratedText, normalizeGeneratedTextNullable, } from "../../normalizeGeneratedText.js";
@@ -79,7 +79,7 @@ function mapEvidence(bundle) {
     };
 }
 export function presentScanDetails(bundle, ctx) {
-    const { assessment, facts, profile } = bundle;
+    const { facts, profile } = bundle;
     const assessmentFields = projectAssessmentFields(bundle);
     const channels = buildNarrativeChannels(bundle);
     const keyPoints = projectCompactKeyPoints(channels, 6);
@@ -93,8 +93,8 @@ export function presentScanDetails(bundle, ctx) {
         : undefined;
     const postureLabel = MERGE_POSTURE_LABEL[profile.status];
     const verdictLine = assessmentFields.reasoning[0] ??
-        (assessment.primaryConcern
-            ? MERGE_CONCERN_LABELS[assessment.primaryConcern]
+        (assessmentFields.primaryConcern
+            ? MERGE_CONCERN_LABELS[assessmentFields.primaryConcern]
             : postureLabel);
     const verificationActions = channels.verification.map((title, index) => ({
         title: normalizeGeneratedText(title),
@@ -110,10 +110,7 @@ export function presentScanDetails(bundle, ctx) {
                 : "low",
         rationale: action.detail,
     }));
-    const prRiskScore = facts.riskSignals?.riskIndex ?? null;
-    const prRiskBandLabelText = facts.riskSignals?.band != null
-        ? prRiskBandLabel(facts.riskSignals.band)
-        : scoreToBandLabel(prRiskScore);
+    const prRisk = formatPrRiskSummary(facts);
     return {
         ...assessmentFields,
         evidenceContext: evidenceContextFromProfile(bundle),
@@ -127,9 +124,9 @@ export function presentScanDetails(bundle, ctx) {
             verdictLine: normalizeGeneratedText(verdictLine),
             scopeChip: channels.reachLabel,
             postureLabel,
-            prRiskScore,
-            prRiskBandLabel: prRiskBandLabelText ?? undefined,
-            riskIndex: prRiskScore,
+            prRiskScore: prRisk?.prRiskScore ?? null,
+            prRiskBandLabel: prRisk?.prRiskBandLabel,
+            riskIndex: prRisk?.prRiskScore ?? null,
         },
         signalSummary: mapSignalSummary(bundle),
         narrative: {

package/dist/presentation/projectAssessmentFields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projectAssessmentFields.d.ts","sourceRoot":"","sources":["../../src/presentation/projectAssessmentFields.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAExF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,sBAAsB,GAC7B,4BAA4B,CAgB9B"}
+{"version":3,"file":"projectAssessmentFields.d.ts","sourceRoot":"","sources":["../../src/presentation/projectAssessmentFields.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAOxF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,sBAAsB,GAC7B,4BAA4B,CAoB9B"}

package/dist/presentation/projectAssessmentFields.js

@@ -1,4 +1,8 @@
 import { collectVerificationFocusForPresentation, projectReasoningLines, } from "../assessmentProjection.js";
+function trimOptionalExpression(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
 export function projectAssessmentFields(bundle) {
     const { assessment, presentation, result } = bundle;
     const { channel, focus } = collectVerificationFocusForPresentation(presentation, result);
@@ -11,5 +15,7 @@ export function projectAssessmentFields(bundle) {
         verificationChannel: channel,
         reachVisibility: presentation.reachVisibility,
         narrativeIntensity: presentation.narrativeIntensity,
+        confidenceRationale: trimOptionalExpression(assessment.confidenceRationale),
+        electionSummary: trimOptionalExpression(assessment.reviewFocalPoint.electionSummary),
     };
 }