@mergesignal/shared 0.4.2 → 0.4.3

package/dist/engineWireRegression.test.js

@@ -37,8 +37,8 @@ describe("engine wire regression (canonical fixtures)", () => {
         expect(facts.availability.repoIntelligenceParse).toBe("ok");
         expect(facts.packageUsage[0]?.packageName).toBe("fastify");
         const card = deriveScanCardSummary(result, "done");
-        expect(card.keyPoints.length).toBeGreaterThan(0);
-        expect(card.verificationActions.length).toBeGreaterThan(0);
+        expect(card.insights.length).toBeGreaterThan(0);
+        expect(card.verification.length).toBeGreaterThan(0);
     });
     it("multi-package fixture: both packages in packageUsage", () => {
         validateRepoIntelligenceWire(fixtureRepoIntelligenceMultiPackage);

package/dist/narrativeParity.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 import { buildScanPresentationBundle } from "./presentation/orchestration/buildScanPresentationBundle.js";
-import { presentScanCard } from "./presentation/presenters/presentScanCard.js";
+import { presentDashboardCard } from "./presentation/presenters/presentDashboardCard.js";
 import { presentScanDetails } from "./presentation/presenters/presentScanDetails.js";
 import { presentGitHubPrComment } from "./presentation/presenters/presentGitHubPrComment.js";
 import { renderGitHubCheckRunMarkdown } from "./presentation/render/renderGitHubCheckRunMarkdown.js";
@@ -45,7 +45,7 @@ describe("narrative parity across consumers", () => {
             result,
             pipelineStatus: "done",
         });
-        const card = presentScanCard(bundle);
+        const card = presentDashboardCard(bundle);
         const detail = presentScanDetails(bundle, {
             scanId: SCAN_ID,
         });
@@ -55,9 +55,8 @@ describe("narrative parity across consumers", () => {
             baseline: false,
         }));
         const prComment = presentGitHubPrComment(bundle);
-        expect(card.primaryPackage).toBe("fastify");
         expect(detail.narrative.primaryPackage).toBe("fastify");
-        expect(card.evidence.some((e) => e.label === "Reachability")).toBe(true);
+        expect(card.evidenceChips?.some((e) => e.label === "Reachability")).toBe(true);
         const asciiOnly = /^[\x00-\x7F]*$/;
         expect(asciiOnly.test(checkRun)).toBe(true);
         expect(checkRun.toLowerCase()).toContain("fastify");

package/dist/presentation/compose/narrativeChannels.d.ts

@@ -0,0 +1,17 @@
+import type { PresentationEvidenceRow } from "../dto/types.js";
+import type { ScanPresentationBundle } from "../orchestration/scanPresentationBundle.js";
+type NarrativeChannels = {
+    headline: string;
+    limitedContextMessage?: string;
+    reachLabel?: string;
+    insights: string[];
+    scopeAreas: string[];
+    evidence: PresentationEvidenceRow[];
+    verification: string[];
+};
+/** Canonical non-redundant narrative channels — single dedupe point for all surfaces. */
+export declare function buildNarrativeChannels(bundle: ScanPresentationBundle): NarrativeChannels;
+/** Merge distinct channels into one bullet list for single-column surfaces (GitHub check, CLI). */
+export declare function projectCompactKeyPoints(channels: NarrativeChannels, max: number): string[];
+export {};
+//# sourceMappingURL=narrativeChannels.d.ts.map

package/dist/presentation/compose/narrativeChannels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrativeChannels.d.ts","sourceRoot":"","sources":["../../../src/presentation/compose/narrativeChannels.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAM/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAOzF,KAAK,iBAAiB,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAgDF,yFAAyF;AACzF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,iBAAiB,CA8BnB;AAED,mGAAmG;AACnG,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAC3B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAyBV"}

package/dist/presentation/compose/narrativeChannels.js

@@ -0,0 +1,75 @@
+import { deriveDetailReachChip } from "../../formatCardExposureDisplay.js";
+import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
+import { formatPresentationHeadline, formatPresentationInsightLines, formatPresentationVerification, } from "../intent/formatPresentationCopy.js";
+import { formatCardAreaLabels } from "../../formatCardAreaLabels.js";
+import { labelBlastRadiusLevel, labelReachabilityKind, } from "../../narrativePresentation.js";
+function composeScopeAreaLabels(bundle, max) {
+    const labels = [];
+    for (const area of bundle.facts.affectedAreas) {
+        const formatted = formatCardAreaLabels([area.label], 1);
+        if (formatted[0])
+            labels.push(formatted[0]);
+        if (labels.length >= max)
+            break;
+    }
+    return labels;
+}
+function isTautologicalEvidenceRow(row) {
+    const label = row.label.trim().toLowerCase();
+    const value = row.value.trim().toLowerCase();
+    if (label === "runtime" && value === "runtime")
+        return true;
+    return false;
+}
+function composeChannelEvidence(bundle, max) {
+    const { facts, profile } = bundle;
+    const rows = [];
+    if (!profile.interpretation.suppressRuntimeNarrative) {
+        const reach = labelReachabilityKind(facts);
+        if (reach)
+            rows.push({ label: "Reachability", value: reach });
+    }
+    const blast = labelBlastRadiusLevel(facts);
+    if (blast)
+        rows.push({ label: "Blast radius", value: blast });
+    return rows.filter((row) => !isTautologicalEvidenceRow(row)).slice(0, max);
+}
+function shouldShowReachLabel(bundle) {
+    const { profile } = bundle;
+    if (profile.status === "safe" && profile.density === "minimal") {
+        return false;
+    }
+    return profile.status !== "safe" || profile.density !== "minimal";
+}
+/** Canonical non-redundant narrative channels — single dedupe point for all surfaces. */
+export function buildNarrativeChannels(bundle) {
+    const { facts, profile, result } = bundle;
+    const riskIndex = facts.riskIndex ?? result.totalScore ?? null;
+    const reachLabel = shouldShowReachLabel(bundle) && riskIndex != null
+        ? (deriveDetailReachChip(riskIndex) ?? undefined)
+        : undefined;
+    return {
+        headline: formatPresentationHeadline(profile.interpretation, facts, profile.status),
+        limitedContextMessage: profile.degradedMessage ?? undefined,
+        reachLabel,
+        insights: formatPresentationInsightLines(profile.interpretation, facts, profile.status),
+        scopeAreas: composeScopeAreaLabels(bundle, 4),
+        evidence: composeChannelEvidence(bundle, 4),
+        verification: formatPresentationVerification(profile.interpretation, profile.status, 6),
+    };
+}
+/** Merge distinct channels into one bullet list for single-column surfaces (GitHub check, CLI). */
+export function projectCompactKeyPoints(channels, max) {
+    const bullets = [...channels.insights];
+    if (channels.scopeAreas.length > 0) {
+        bullets.push(scanSurfaceCopy.presentation.affectedAreasKeyPoint.replace("{areas}", channels.scopeAreas.slice(0, 2).join(", ")));
+    }
+    const blastRow = channels.evidence.find((r) => r.label === "Blast radius");
+    if (blastRow?.value === "Wide") {
+        bullets.push(scanSurfaceCopy.presentation.blastRadiusWideKeyPoint);
+    }
+    else if (blastRow?.value === "Moderate") {
+        bullets.push(scanSurfaceCopy.presentation.blastRadiusLevelKeyPoint.replace("{level}", "Moderate"));
+    }
+    return bullets.slice(0, max);
+}

package/dist/presentation/compose/narrativeChannels.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=narrativeChannels.test.d.ts.map

package/dist/presentation/compose/narrativeChannels.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrativeChannels.test.d.ts","sourceRoot":"","sources":["../../../src/presentation/compose/narrativeChannels.test.ts"],"names":[],"mappings":""}

package/dist/presentation/compose/narrativeChannels.test.js

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import { buildScanPresentationBundle } from "../orchestration/buildScanPresentationBundle.js";
+import { scanResultFastifyRuntime } from "../fixtures/scanResultFixtures.js";
+import { buildNarrativeChannels, projectCompactKeyPoints, } from "./narrativeChannels.js";
+import { presentDashboardCard } from "../presenters/presentDashboardCard.js";
+describe("buildNarrativeChannels", () => {
+    it("fastify: areas in scopeAreas only, blast in evidence only, not in insights", () => {
+        const bundle = buildScanPresentationBundle({
+            result: scanResultFastifyRuntime,
+            pipelineStatus: "done",
+        });
+        const channels = buildNarrativeChannels(bundle);
+        const insightText = channels.insights.join(" ");
+        expect(insightText).not.toMatch(/Affected areas:/i);
+        expect(insightText).not.toMatch(/Blast radius is/i);
+        expect(channels.scopeAreas.length).toBeGreaterThan(0);
+        expect(channels.evidence.some((r) => r.label === "Blast radius")).toBe(true);
+        expect(channels.evidence.some((r) => r.label === "Runtime")).toBe(false);
+    });
+    it("projectCompactKeyPoints merges channels for single-column surfaces", () => {
+        const bundle = buildScanPresentationBundle({
+            result: scanResultFastifyRuntime,
+            pipelineStatus: "done",
+        });
+        const channels = buildNarrativeChannels(bundle);
+        const compact = projectCompactKeyPoints(channels, 5);
+        expect(compact.some((p) => /Affected areas:/i.test(p))).toBe(true);
+        expect(compact.some((p) => /Blast radius is/i.test(p))).toBe(true);
+    });
+    it("presentDashboardCard does not duplicate areas across insights and scopeAreas", () => {
+        const bundle = buildScanPresentationBundle({
+            result: scanResultFastifyRuntime,
+            pipelineStatus: "done",
+        });
+        const card = presentDashboardCard(bundle);
+        const insightText = card.insights.join(" ");
+        expect(insightText).not.toMatch(/Affected areas:/i);
+        expect(card.scopeAreas?.length).toBeGreaterThan(0);
+        expect(card.verdict?.scopeLabel).toBeTruthy();
+        expect(card.verification.every((v) => v.startsWith("Verify"))).toBe(true);
+    });
+});

package/dist/presentation/compose/narrativeCompose.d.ts

@@ -1,4 +1,5 @@
 import type { ScanPresentationBundle } from "../orchestration/scanPresentationBundle.js";
+export { buildNarrativeChannels, projectCompactKeyPoints, } from "./narrativeChannels.js";
 export declare function composeHeadline(bundle: ScanPresentationBundle): string;
 export declare function composeSubheadline(bundle: ScanPresentationBundle): string | undefined;
 export declare function composeKeyPoints(bundle: ScanPresentationBundle, max: number): string[];

package/dist/presentation/compose/narrativeCompose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"narrativeCompose.d.ts","sourceRoot":"","sources":["../../../src/presentation/compose/narrativeCompose.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AASzF,wBAAgB,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAOtE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAQV;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAOV;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAQV;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBzC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,EAAE,GAAG,SAAS,CAwBtB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,GAAG;IAC1E,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAKA"}
+{"version":3,"file":"narrativeCompose.d.ts","sourceRoot":"","sources":["../../../src/presentation/compose/narrativeCompose.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAMzF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAShC,wBAAgB,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAOtE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAEV;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAOV;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAQV;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBzC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,EAAE,GAAG,SAAS,CAwBtB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,GAAG;IAC1E,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAKA"}

package/dist/presentation/compose/narrativeCompose.js

@@ -1,7 +1,9 @@
 import { formatCardAreaLabels } from "../../formatCardAreaLabels.js";
 import { formatChangedPackagesShort, labelBlastRadiusLevel, labelReachabilityKind, labelRuntimeSurface, } from "../../narrativePresentation.js";
 import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
-import { formatPresentationHeadline, formatPresentationKeyPoints, formatPresentationVerification, } from "../intent/formatPresentationCopy.js";
+import { formatPresentationHeadline, formatPresentationVerification, } from "../intent/formatPresentationCopy.js";
+import { buildNarrativeChannels, projectCompactKeyPoints, } from "./narrativeChannels.js";
+export { buildNarrativeChannels, projectCompactKeyPoints, } from "./narrativeChannels.js";
 function topAreaLabel(bundle) {
     const area = bundle.facts.affectedAreas[0];
     if (!area)
@@ -20,8 +22,7 @@ export function composeSubheadline(bundle) {
     return undefined;
 }
 export function composeKeyPoints(bundle, max) {
-    const { facts, profile } = bundle;
-    return formatPresentationKeyPoints(profile.interpretation, facts, profile.status, max);
+    return projectCompactKeyPoints(buildNarrativeChannels(bundle), max);
 }
 export function composeVerificationActions(bundle, max) {
     const { profile } = bundle;

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

@@ -0,0 +1,29 @@
+import type { PresentationEvidenceRow, PresentationStatus } from "./types.js";
+export type DashboardCardLayout = "quiet" | "standard" | "expanded";
+export type DashboardCardPresentation = {
+    verdict?: {
+        posture: PresentationStatus;
+        postureLabel: string;
+        scopeLabel?: string;
+    };
+    headline: string;
+    pipeline?: {
+        status: "queued" | "running" | "failed";
+        headline: string;
+        subheadline?: string;
+    };
+    limitedContext?: {
+        message: string;
+    };
+    insights: string[];
+    scopeAreas?: string[];
+    verification: string[];
+    evidenceChips?: PresentationEvidenceRow[];
+    layout: DashboardCardLayout;
+    detailActionLabel: string;
+    sortKey: {
+        postureRank: number;
+        riskIndex: number;
+    };
+};
+//# sourceMappingURL=dashboardCardPresentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardCardPresentation.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/dashboardCardPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAEpE,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,kBAAkB,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,QAAQ,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;QACxC,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,cAAc,CAAC,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAE1C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC"}

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

@@ -12,13 +12,4 @@ export type PresentationEvidenceContext = {
     priority: PresentationPriority;
     degradedMessage?: string;
 };
-export type FindingCountSummary = {
-    critical: number;
-    high: number;
-    medium: number;
-    low: number;
-};
-export declare function aggregateFindingCounts(findings: Array<{
-    severity: string;
-}> | null | undefined): FindingCountSummary;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC;AAEnE,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAElE,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAEjE,MAAM,MAAM,uBAAuB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,8DAA8D;AAC9D,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GACvD,mBAAmB,CAgBrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC;AAEnE,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAElE,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAEjE,MAAM,MAAM,uBAAuB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,8DAA8D;AAC9D,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC"}

package/dist/presentation/dto/types.js

@@ -1,22 +1 @@
-export function aggregateFindingCounts(findings) {
-    const counts = {
-        critical: 0,
-        high: 0,
-        medium: 0,
-        low: 0,
-    };
-    if (!Array.isArray(findings))
-        return counts;
-    for (const f of findings) {
-        const s = f.severity;
-        if (s === "critical")
-            counts.critical += 1;
-        else if (s === "high")
-            counts.high += 1;
-        else if (s === "medium")
-            counts.medium += 1;
-        else if (s === "low")
-            counts.low += 1;
-    }
-    return counts;
-}
+export {};

package/dist/presentation/fixtures/dashboardCardGolden.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dashboardCardGolden.test.d.ts.map

package/dist/presentation/fixtures/dashboardCardGolden.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardCardGolden.test.d.ts","sourceRoot":"","sources":["../../../src/presentation/fixtures/dashboardCardGolden.test.ts"],"names":[],"mappings":""}

package/dist/presentation/fixtures/dashboardCardGolden.test.js

@@ -0,0 +1,31 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import { buildScanCardPresentation } from "../orchestration/buildScanCardPresentation.js";
+import { scanResultFastifyRuntime, scanResultTypescriptPatch, } from "./presentationPersonaFixtures.js";
+const goldenPath = join(dirname(fileURLToPath(import.meta.url)), "dashboardCardGolden.json");
+const golden = JSON.parse(readFileSync(goldenPath, "utf8"));
+describe("dashboardCardGolden fixtures", () => {
+    it("matches live typescript patch card", () => {
+        const live = buildScanCardPresentation({
+            result: scanResultTypescriptPatch,
+            pipelineStatus: "done",
+        });
+        expect(live).toEqual(golden.typescriptPatch);
+    });
+    it("matches live fastify runtime card", () => {
+        const live = buildScanCardPresentation({
+            result: scanResultFastifyRuntime,
+            pipelineStatus: "done",
+        });
+        expect(live).toEqual(golden.fastifyRuntime);
+    });
+    it("fastify golden has deduplicated channels", () => {
+        const card = golden.fastifyRuntime;
+        const insightText = card.insights.join(" ");
+        expect(insightText).not.toMatch(/Affected areas:/i);
+        expect(card.scopeAreas?.length).toBeGreaterThan(0);
+        expect(card.evidenceChips?.some((e) => e.label === "Blast radius")).toBe(true);
+    });
+});

package/dist/presentation/index.d.ts

@@ -9,12 +9,13 @@ export type { PresentationProfile } from "./profile/presentationProfile.js";
 export type { PresentationIntent, PresentationInterpretation, } from "./intent/presentationIntent.js";
 export { derivePresentationInterpretation } from "./intent/derivePresentationInterpretation.js";
 export type { PipelineStatus, PresentationStatus, PresentationDensity, PresentationConfidence, PresentationPriority, PresentationEvidenceContext, PresentationEvidenceRow, } from "./dto/types.js";
-export type { ScanCardPresentation } from "./dto/scanCardPresentation.js";
+export type { DashboardCardPresentation } from "./dto/dashboardCardPresentation.js";
+export type { DashboardCardLayout } from "./dto/dashboardCardPresentation.js";
+/** @deprecated Use DashboardCardPresentation */
+export type { DashboardCardPresentation as ScanCardPresentation } from "./dto/dashboardCardPresentation.js";
 export type { ScanDetailsPresentation } from "./dto/scanDetailsPresentation.js";
 export type { GitHubCheckRunPresentation, GitHubPrCommentPresentation, CliScanPresentation, } from "./dto/githubAndCliPresentation.js";
-export { presentScanCard } from "./presenters/presentScanCard.js";
-export type { PresentScanCardContext } from "./presenters/presentScanCard.js";
-export { presentPipelineScanCard } from "./presenters/presentPipelineScanCard.js";
+export { presentDashboardCard, presentPipelineDashboardCard, } from "./presenters/presentDashboardCard.js";
 export { presentScanDetails } from "./presenters/presentScanDetails.js";
 export type { PresentScanDetailsContext } from "./presenters/presentScanDetails.js";
 export { presentGitHubCheckRun } from "./presenters/presentGitHubCheckRun.js";
@@ -23,5 +24,5 @@ export { presentCliScanSummary } from "./presenters/presentCliScanSummary.js";
 export { renderGitHubCheckRunMarkdown } from "./render/renderGitHubCheckRunMarkdown.js";
 export { renderGitHubPrCommentMarkdown } from "./render/renderGitHubPrCommentMarkdown.js";
 export { renderCliScanSummaryText } from "./render/renderCliScanSummaryText.js";
-export { composeHeadline, composeSubheadline, composeKeyPoints, composeVerificationActions, composeAffectedAreaLabels, composeEvidenceRows, composeSupportingContext, evidenceContextFromProfile, } from "./compose/narrativeCompose.js";
+export { buildNarrativeChannels, projectCompactKeyPoints, composeHeadline, composeSubheadline, composeKeyPoints, composeVerificationActions, composeAffectedAreaLabels, composeEvidenceRows, 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,OAAO,EAAE,gCAAgC,EAAE,MAAM,8CAA8C,CAAC;AAChG,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,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,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EACL,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,OAAO,EAAE,gCAAgC,EAAE,MAAM,8CAA8C,CAAC;AAChG,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,GAC7B,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,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"}

package/dist/presentation/index.js

@@ -2,8 +2,7 @@ export { buildScanPresentationBundle } from "./orchestration/buildScanPresentati
 export { buildScanCardPresentation } from "./orchestration/buildScanCardPresentation.js";
 export { buildScanDetailsPresentation } from "./orchestration/buildScanDetailsPresentation.js";
 export { derivePresentationInterpretation } from "./intent/derivePresentationInterpretation.js";
-export { presentScanCard } from "./presenters/presentScanCard.js";
-export { presentPipelineScanCard } from "./presenters/presentPipelineScanCard.js";
+export { presentDashboardCard, presentPipelineDashboardCard, } from "./presenters/presentDashboardCard.js";
 export { presentScanDetails } from "./presenters/presentScanDetails.js";
 export { presentGitHubCheckRun } from "./presenters/presentGitHubCheckRun.js";
 export { presentGitHubPrComment } from "./presenters/presentGitHubPrComment.js";
@@ -11,4 +10,4 @@ export { presentCliScanSummary } from "./presenters/presentCliScanSummary.js";
 export { renderGitHubCheckRunMarkdown } from "./render/renderGitHubCheckRunMarkdown.js";
 export { renderGitHubPrCommentMarkdown } from "./render/renderGitHubPrCommentMarkdown.js";
 export { renderCliScanSummaryText } from "./render/renderCliScanSummaryText.js";
-export { composeHeadline, composeSubheadline, composeKeyPoints, composeVerificationActions, composeAffectedAreaLabels, composeEvidenceRows, composeSupportingContext, evidenceContextFromProfile, } from "./compose/narrativeCompose.js";
+export { buildNarrativeChannels, projectCompactKeyPoints, composeHeadline, composeSubheadline, composeKeyPoints, composeVerificationActions, composeAffectedAreaLabels, composeEvidenceRows, composeSupportingContext, evidenceContextFromProfile, } from "./compose/narrativeCompose.js";

package/dist/presentation/intent/formatPresentationCopy.d.ts

@@ -2,6 +2,7 @@ import type { ScanNarrativeFacts } from "../../scanNarrativeFacts.js";
 import type { PresentationStatus } from "../dto/types.js";
 import type { PresentationInterpretation } from "./presentationIntent.js";
 export declare function formatPresentationHeadline(interpretation: PresentationInterpretation, facts: ScanNarrativeFacts, status: PresentationStatus | undefined): string;
-export declare function formatPresentationKeyPoints(interpretation: PresentationInterpretation, facts: ScanNarrativeFacts, status: PresentationStatus | undefined, max: number): string[];
+/** Atomic insight lines — no embedded areas or blast radius (those live in separate channels). */
+export declare function formatPresentationInsightLines(interpretation: PresentationInterpretation, facts: ScanNarrativeFacts, status: PresentationStatus | undefined): string[];
 export declare function formatPresentationVerification(interpretation: PresentationInterpretation, status: PresentationStatus | undefined, max: number): string[];
 //# sourceMappingURL=formatPresentationCopy.d.ts.map

package/dist/presentation/intent/formatPresentationCopy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatPresentationCopy.d.ts","sourceRoot":"","sources":["../../../src/presentation/intent/formatPresentationCopy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAM1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAa1E,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,0BAA0B,EAC1C,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,MAAM,CAmDR;AA0BD,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,0BAA0B,EAC1C,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAmEV;AAuBD,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,0BAA0B,EAC1C,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAmBV"}
+{"version":3,"file":"formatPresentationCopy.d.ts","sourceRoot":"","sources":["../../../src/presentation/intent/formatPresentationCopy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAM1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAa1E,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,0BAA0B,EAC1C,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,MAAM,CAmDR;AA0BD,kGAAkG;AAClG,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,0BAA0B,EAC1C,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,MAAM,EAAE,CA0CV;AAuBD,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,0BAA0B,EAC1C,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAmBV"}

package/dist/presentation/intent/formatPresentationCopy.js

@@ -69,14 +69,15 @@ function formatExpectedImpactKeyPoint(interpretation) {
 function formatLimitedEvidenceKeyPoint() {
     return scanSurfaceCopy.presentation.limitedEvidenceKeyPoint;
 }
-export function formatPresentationKeyPoints(interpretation, facts, status, max) {
+/** Atomic insight lines — no embedded areas or blast radius (those live in separate channels). */
+export function formatPresentationInsightLines(interpretation, facts, status) {
     const points = [];
     if (interpretation.intent === "limited_context") {
         points.push(scanSurfaceCopy.presentation.limitedContextKeyPoint);
         if (facts.changedPackages.primary) {
             points.push(scanSurfaceCopy.presentation.changedPackageKeyPoint.replace("{package}", facts.changedPackages.primary));
         }
-        return applyPostureVocabularyGuardLines(points, status).slice(0, max);
+        return applyPostureVocabularyGuardLines(points, status);
     }
     if (interpretation.showLimitedEvidence) {
         points.push(formatLimitedEvidenceKeyPoint());
@@ -96,22 +97,8 @@ export function formatPresentationKeyPoints(interpretation, facts, status, max)
         else {
             points.push(scanSurfaceCopy.presentation.runtimeUsageKeyPoint);
         }
-        if (facts.affectedAreas.length > 0) {
-            const labels = facts.affectedAreas
-                .slice(0, 2)
-                .map((a) => a.label)
-                .join(", ");
-            points.push(scanSurfaceCopy.presentation.affectedAreasKeyPoint.replace("{areas}", labels));
-        }
-        const blast = facts.blastRadius;
-        if (blast?.level === "wide") {
-            points.push(scanSurfaceCopy.presentation.blastRadiusWideKeyPoint);
-        }
-        else if (blast?.level === "moderate") {
-            points.push(scanSurfaceCopy.presentation.blastRadiusLevelKeyPoint.replace("{level}", "Moderate"));
-        }
     }
-    return applyPostureVocabularyGuardLines(points, status).slice(0, max);
+    return applyPostureVocabularyGuardLines(points, status);
 }
 const AUTH_VERIFICATION = [
     "routes",

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

@@ -1,11 +1,11 @@
 import type { PipelineStatus } from "../dto/types.js";
 import type { ScanResult } from "../../types.js";
-import type { ScanCardPresentation } from "../dto/scanCardPresentation.js";
+import type { DashboardCardPresentation } from "../dto/dashboardCardPresentation.js";
 export type BuildScanCardPresentationInput = {
     pipelineStatus: PipelineStatus;
     result: ScanResult | null;
     decision?: string | null;
     totalScore?: number | null;
 };
-export declare function buildScanCardPresentation(input: BuildScanCardPresentationInput): ScanCardPresentation;
+export declare function buildScanCardPresentation(input: BuildScanCardPresentationInput): DashboardCardPresentation;
 //# sourceMappingURL=buildScanCardPresentation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildScanCardPresentation.d.ts","sourceRoot":"","sources":["../../../src/presentation/orchestration/buildScanCardPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,MAAM,8BAA8B,GAAG;IAC3C,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AA2BF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,oBAAoB,CA2BtB"}
+{"version":3,"file":"buildScanCardPresentation.d.ts","sourceRoot":"","sources":["../../../src/presentation/orchestration/buildScanCardPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAOjD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAErF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AA2BF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,yBAAyB,CA2B3B"}

package/dist/presentation/orchestration/buildScanCardPresentation.js

@@ -1,7 +1,6 @@
 import { mergePostureFromDecision } from "../../riskVocabulary.js";
 import { buildScanPresentationBundle } from "./buildScanPresentationBundle.js";
-import { presentScanCard } from "../presenters/presentScanCard.js";
-import { presentPipelineScanCard } from "../presenters/presentPipelineScanCard.js";
+import { presentDashboardCard, presentPipelineDashboardCard, } from "../presenters/presentDashboardCard.js";
 function minimalResultFromDenormalized(decision, totalScore) {
     const posture = mergePostureFromDecision(decision ?? undefined);
     if (!posture && (totalScore == null || !Number.isFinite(totalScore))) {
@@ -24,12 +23,12 @@ function minimalResultFromDenormalized(decision, totalScore) {
 }
 export function buildScanCardPresentation(input) {
     if (input.pipelineStatus !== "done") {
-        return presentPipelineScanCard(input.pipelineStatus === "failed" ? "failed" : input.pipelineStatus);
+        return presentPipelineDashboardCard(input.pipelineStatus === "failed" ? "failed" : input.pipelineStatus);
     }
     const result = input.result ??
         minimalResultFromDenormalized(input.decision, input.totalScore);
     if (!result) {
-        return presentPipelineScanCard("failed");
+        return presentPipelineDashboardCard("failed");
     }
     const bundle = buildScanPresentationBundle({
         result,
@@ -38,7 +37,7 @@ export function buildScanCardPresentation(input) {
         totalScore: input.totalScore,
     });
     if (!bundle) {
-        return presentPipelineScanCard("failed");
+        return presentPipelineDashboardCard("failed");
     }
-    return presentScanCard(bundle, { includeFindingCounts: true });
+    return presentDashboardCard(bundle);
 }

package/dist/presentation/presentation.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 import { buildScanPresentationBundle } from "./orchestration/buildScanPresentationBundle.js";
-import { presentScanCard } from "./presenters/presentScanCard.js";
+import { presentDashboardCard } from "./presenters/presentDashboardCard.js";
 import { presentScanDetails } from "./presenters/presentScanDetails.js";
 import { presentGitHubCheckRun } from "./presenters/presentGitHubCheckRun.js";
 import { presentGitHubPrComment } from "./presenters/presentGitHubPrComment.js";
@@ -43,32 +43,30 @@ describe("buildScanPresentationBundle", () => {
         expect(bundle.profile.degradedMessage).toBeTruthy();
     });
 });
-describe("presentScanCard personas", () => {
-    it("fastify card is rich with affected areas and verification", () => {
+describe("presentDashboardCard personas", () => {
+    it("fastify card has scope areas and verification", () => {
         const bundle = buildScanPresentationBundle({
             result: scanResultFastifyRuntime,
             pipelineStatus: "done",
         });
-        const card = presentScanCard(bundle);
-        expect(card.density).toBe("rich");
-        expect(card.affectedAreas.length).toBeGreaterThan(0);
-        expect(card.verificationActions.length).toBeGreaterThan(0);
+        const card = presentDashboardCard(bundle);
+        expect(card.layout).toBe("expanded");
+        expect(card.scopeAreas.length).toBeGreaterThan(0);
+        expect(card.verification.length).toBeGreaterThan(0);
         expect(card.headline.toLowerCase()).toContain("fastify");
-        expect(card.supportingContext).toBeUndefined();
+        expect(card.verdict?.posture).toBe("needs_review");
     });
-    it("typescript card is minimal safe without graph-first story", () => {
+    it("typescript card is quiet safe", () => {
         const bundle = buildScanPresentationBundle({
             result: scanResultTypescriptPatch,
             pipelineStatus: "done",
         });
-        const card = presentScanCard(bundle);
-        expect(card.density).toBe("minimal");
-        expect(card.status).toBe("safe");
-        expect(card.presentationIntent).toBe("tooling_patch");
+        const card = presentDashboardCard(bundle);
+        expect(["quiet", "standard"]).toContain(card.layout);
+        expect(card.verdict?.posture).toBe("safe");
         expect(card.headline).toMatch(/patch upgrade/i);
         expect(card.headline).not.toMatch(/needs review/i);
-        expect(card.changedPackages).toContain("typescript");
-        expect(card.verificationActions.length).toBeGreaterThan(0);
+        expect(card.verification.length).toBeGreaterThan(0);
     });
 });
 describe("presentation parity across surfaces", () => {
@@ -77,7 +75,7 @@ describe("presentation parity across surfaces", () => {
             result: scanResultFastifyRuntime,
             pipelineStatus: "done",
         });
-        const card = presentScanCard(bundle);
+        const card = presentDashboardCard(bundle);
         const details = presentScanDetails(bundle, { scanId: SCAN_ID });
         const check = presentGitHubCheckRun(bundle, {
             scanId: SCAN_ID,
@@ -85,13 +83,13 @@ describe("presentation parity across surfaces", () => {
         });
         const comment = presentGitHubPrComment(bundle);
         const cli = presentCliScanSummary(bundle, { repoLabel: "acme/api" });
-        for (const dto of [card, details, check, comment, cli]) {
+        for (const dto of [details, check, comment, cli]) {
             expect(dto.status).toBe(bundle.profile.status);
             expect(dto.density).toBe(bundle.profile.density);
             expect(dto.confidence).toBe(bundle.profile.confidence);
             expect(dto.evidenceContext?.priority).toBe(bundle.profile.priority);
         }
-        expect(card.primaryPackage).toBe("fastify");
+        expect(card.verdict?.posture).toBe(bundle.profile.status);
         expect(details.narrative.primaryPackage).toBe("fastify");
         expect(check.title.toLowerCase()).toContain("fastify");
     });

package/dist/presentation/presentationPersonas.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 import { buildScanPresentationBundle } from "./orchestration/buildScanPresentationBundle.js";
-import { presentScanCard } from "./presenters/presentScanCard.js";
+import { presentDashboardCard } from "./presenters/presentDashboardCard.js";
 import { presentScanDetails } from "./presenters/presentScanDetails.js";
 import { presentCliScanSummary } from "./presenters/presentCliScanSummary.js";
 import { scanResultBullmq, scanResultEslint, scanResultFastifyRuntime, scanResultLimitedContext, scanResultMixedTypescriptFastify, scanResultNextAuth, scanResultPrettier, scanResultTypescriptPatch, scanResultUnknownSafe, scanResultVitest, } from "./fixtures/presentationPersonaFixtures.js";
@@ -99,15 +99,16 @@ function cardFor(result) {
         result,
         pipelineStatus: "done",
     });
-    return presentScanCard(bundle);
+    return presentDashboardCard(bundle);
 }
 describe("presentation personas", () => {
     for (const persona of personas) {
         it(`${persona.name}: intent, posture alignment, headline`, () => {
             const card = cardFor(persona.result);
-            expect(card.presentationIntent).toBe(persona.intent);
-            expect(card.status).toBe(persona.status);
-            expect(card.density).toBe(persona.density);
+            expect(card.verdict?.posture).toBe(persona.status);
+            if (persona.density === "rich") {
+                expect(card.layout).toBe("expanded");
+            }
             expect(card.headline).toMatch(persona.headlineMatch);
             if (persona.headlineMustNot) {
                 expect(card.headline).not.toMatch(persona.headlineMustNot);
@@ -115,28 +116,28 @@ describe("presentation personas", () => {
             if (persona.status === "safe") {
                 const combined = [
                     card.headline,
-                    ...card.keyPoints,
-                    ...card.verificationActions,
+                    ...card.insights,
+                    ...card.verification,
                 ].join(" ");
                 expect(combined).not.toMatch(SAFE_FORBIDDEN);
             }
             if (persona.status === "needs_review") {
-                const combined = card.verificationActions.join(" ");
+                const combined = card.verification.join(" ");
                 expect(combined).not.toMatch(REVIEW_FORBIDDEN);
             }
             if (persona.verificationIncludes) {
                 for (const v of persona.verificationIncludes) {
-                    expect(card.verificationActions.some((a) => a.toLowerCase().includes(v.toLowerCase()))).toBe(true);
+                    expect(card.verification.some((a) => a.toLowerCase().includes(v.toLowerCase()))).toBe(true);
                 }
             }
             if (persona.verificationMustNot) {
-                expect(card.verificationActions.join(" ")).not.toMatch(persona.verificationMustNot);
+                expect(card.verification.join(" ")).not.toMatch(persona.verificationMustNot);
             }
         });
     }
     it("mixed typescript+fastify: runtime intent, fastify in headline", () => {
         const card = cardFor(scanResultMixedTypescriptFastify);
-        expect(card.presentationIntent).toBe("runtime_upgrade");
+        expect(card.verdict?.posture).toBe("needs_review");
         expect(card.headline.toLowerCase()).toContain("fastify");
         expect(card.headline).not.toMatch(/patch upgrade/i);
     });
@@ -145,7 +146,7 @@ describe("presentation personas", () => {
             result: scanResultFastifyRuntime,
             pipelineStatus: "done",
         });
-        const card = presentScanCard(bundle);
+        const card = presentDashboardCard(bundle);
         const details = presentScanDetails(bundle, { scanId: SCAN_ID });
         const cli = presentCliScanSummary(bundle, { repoLabel: "acme/api" });
         expect(details.hero.headline).toBe(card.headline);
@@ -156,7 +157,7 @@ describe("presentation personas", () => {
             result: scanResultTypescriptPatch,
             pipelineStatus: "done",
         });
-        const card = presentScanCard(bundle);
+        const card = presentDashboardCard(bundle);
         const details = presentScanDetails(bundle, { scanId: SCAN_ID });
         const cli = presentCliScanSummary(bundle, { repoLabel: "acme/api" });
         expect(details.hero.headline).toBe(card.headline);

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":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEzF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,mBAAmB,CA6BrB"}
+{"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;AAEzF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,mBAAmB,CA6BrB"}

package/dist/presentation/presenters/presentCliScanSummary.js

@@ -1,4 +1,4 @@
-import { composeHeadline, composeKeyPoints, composeSubheadline, composeSupportingContext, composeVerificationActions, evidenceContextFromProfile, } from "../compose/narrativeCompose.js";
+import { buildNarrativeChannels, composeHeadline, composeSubheadline, composeSupportingContext, composeVerificationActions, evidenceContextFromProfile, projectCompactKeyPoints, } from "../compose/narrativeCompose.js";
 export function presentCliScanSummary(bundle, ctx = {}) {
     const { facts, profile, result } = bundle;
     const layers = result.layerScores;
@@ -17,7 +17,7 @@ export function presentCliScanSummary(bundle, ctx = {}) {
         evidenceContext: evidenceContextFromProfile(bundle),
         headline: composeHeadline(bundle),
         subheadline: composeSubheadline(bundle),
-        keyPoints: composeKeyPoints(bundle, 6),
+        keyPoints: projectCompactKeyPoints(buildNarrativeChannels(bundle), 6),
         verificationActions: composeVerificationActions(bundle, 5),
         metrics: {
             riskIndex: facts.riskIndex ?? result.totalScore ?? 0,

package/dist/presentation/presenters/presentDashboardCard.d.ts

@@ -0,0 +1,5 @@
+import type { DashboardCardPresentation } from "../dto/dashboardCardPresentation.js";
+import type { ScanPresentationBundle } from "../orchestration/scanPresentationBundle.js";
+export declare function presentDashboardCard(bundle: ScanPresentationBundle): DashboardCardPresentation;
+export declare function presentPipelineDashboardCard(pipelineStatus: "queued" | "running" | "failed"): DashboardCardPresentation;
+//# sourceMappingURL=presentDashboardCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentDashboardCard.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentDashboardCard.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAErF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAmEzF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,sBAAsB,GAC7B,yBAAyB,CA6C3B;AAED,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAC9C,yBAAyB,CAqB3B"}

package/dist/presentation/presenters/presentDashboardCard.js

@@ -0,0 +1,117 @@
+import { MERGE_POSTURE_LABEL, MERGE_POSTURE_SORT_ORDER, } from "../../riskVocabulary.js";
+import { normalizeGeneratedText, normalizeGeneratedTextNullable, } from "../../normalizeGeneratedText.js";
+import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
+import { buildNarrativeChannels } from "../compose/narrativeChannels.js";
+const INSIGHTS_CAP = 3;
+const SCOPE_AREAS_CAP = 2;
+const EVIDENCE_CAP = 2;
+const VERIFICATION_CAP = 2;
+function formatVerificationLine(action) {
+    const trimmed = action.trim();
+    if (/^verify\b/i.test(trimmed))
+        return trimmed;
+    return `Verify ${trimmed}`;
+}
+function deriveLayout(channels, profile) {
+    const bodyCount = channels.insights.length +
+        channels.scopeAreas.length +
+        channels.evidence.length +
+        channels.verification.length;
+    if (profile.status === "safe" &&
+        profile.density === "minimal" &&
+        bodyCount === 0 &&
+        !channels.limitedContextMessage) {
+        return "quiet";
+    }
+    if (profile.density === "rich") {
+        return "expanded";
+    }
+    return "standard";
+}
+function normalizeDashboardCard(card) {
+    return {
+        ...card,
+        headline: normalizeGeneratedText(card.headline),
+        limitedContext: card.limitedContext
+            ? {
+                message: normalizeGeneratedText(card.limitedContext.message),
+            }
+            : undefined,
+        insights: card.insights.map((i) => normalizeGeneratedText(i)),
+        scopeAreas: card.scopeAreas?.map((a) => normalizeGeneratedText(a)),
+        verification: card.verification.map((v) => normalizeGeneratedText(v)),
+        evidenceChips: card.evidenceChips?.map((e) => ({
+            label: normalizeGeneratedText(e.label),
+            value: normalizeGeneratedText(e.value),
+        })),
+        pipeline: card.pipeline
+            ? {
+                ...card.pipeline,
+                headline: normalizeGeneratedText(card.pipeline.headline),
+                subheadline: normalizeGeneratedTextNullable(card.pipeline.subheadline) ??
+                    undefined,
+            }
+            : undefined,
+    };
+}
+export function presentDashboardCard(bundle) {
+    const { facts, profile } = bundle;
+    const channels = buildNarrativeChannels(bundle);
+    const posture = profile.status;
+    const riskIndex = facts.riskIndex != null && Number.isFinite(facts.riskIndex)
+        ? facts.riskIndex
+        : -1;
+    const insights = channels.insights.slice(0, INSIGHTS_CAP);
+    const scopeAreas = channels.scopeAreas.length > 0
+        ? channels.scopeAreas.slice(0, SCOPE_AREAS_CAP)
+        : undefined;
+    const evidenceChips = channels.evidence.length > 0
+        ? channels.evidence.slice(0, EVIDENCE_CAP)
+        : undefined;
+    const verification = channels.verification
+        .slice(0, VERIFICATION_CAP)
+        .map(formatVerificationLine);
+    const card = {
+        verdict: {
+            posture,
+            postureLabel: MERGE_POSTURE_LABEL[posture],
+            scopeLabel: channels.reachLabel,
+        },
+        headline: channels.headline,
+        limitedContext: channels.limitedContextMessage
+            ? { message: channels.limitedContextMessage }
+            : undefined,
+        insights,
+        scopeAreas,
+        verification,
+        evidenceChips,
+        layout: deriveLayout(channels, profile),
+        detailActionLabel: scanSurfaceCopy.presentation.actionLabelReview,
+        sortKey: {
+            postureRank: MERGE_POSTURE_SORT_ORDER[posture],
+            riskIndex,
+        },
+    };
+    return normalizeDashboardCard(card);
+}
+export function presentPipelineDashboardCard(pipelineStatus) {
+    const isRunning = pipelineStatus === "queued" || pipelineStatus === "running";
+    const headline = isRunning
+        ? scanSurfaceCopy.pipeline.scanRunning
+        : scanSurfaceCopy.pipeline.analysisIncomplete;
+    return normalizeDashboardCard({
+        pipeline: {
+            status: pipelineStatus,
+            headline,
+            subheadline: isRunning
+                ? scanSurfaceCopy.pipeline.scanIncomplete
+                : undefined,
+        },
+        headline,
+        insights: [],
+        verification: [],
+        layout: "standard",
+        detailActionLabel: scanSurfaceCopy.presentation.actionLabelReview,
+        sortKey: { postureRank: -1, riskIndex: -1 },
+    });
+}

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":"AAOA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEzF,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,CAkC5B"}
+{"version":3,"file":"presentGitHubCheckRun.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentGitHubCheckRun.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEzF,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,CAkC5B"}

package/dist/presentation/presenters/presentGitHubCheckRun.js

@@ -1,8 +1,8 @@
-import { composeHeadline, composeKeyPoints, composeSubheadline, composeVerificationActions, evidenceContextFromProfile, } from "../compose/narrativeCompose.js";
+import { buildNarrativeChannels, composeHeadline, composeSubheadline, composeVerificationActions, evidenceContextFromProfile, projectCompactKeyPoints, } from "../compose/narrativeCompose.js";
 export function presentGitHubCheckRun(bundle, ctx) {
     const { profile } = bundle;
     const headline = composeHeadline(bundle);
-    const keyPoints = composeKeyPoints(bundle, 3);
+    const keyPoints = projectCompactKeyPoints(buildNarrativeChannels(bundle), 3);
     const actions = composeVerificationActions(bundle, 3);
     const detailsUrl = `${ctx.webAppOrigin.replace(/\/$/, "")}/scan/${ctx.scanId}`;
     const conclusion = profile.status === "safe"

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":"AAoBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEzF,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;AAoHF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,yBAAyB,GAC7B,uBAAuB,CAyFzB"}
+{"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;AAEzF,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;AAoHF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,yBAAyB,GAC7B,uBAAuB,CA6FzB"}

package/dist/presentation/presenters/presentScanDetails.js

@@ -1,7 +1,7 @@
 import { deriveDetailReachChip } from "../../formatCardExposureDisplay.js";
 import { MERGE_POSTURE_LABEL } from "../../riskVocabulary.js";
 import { deriveVerdictLineFromFacts, presentScanDetailViewModel, } from "../../scanDetailViewModel.js";
-import { composeHeadline, composeKeyPoints, composeSubheadline, composeSupportingContext, composeVerificationActions, evidenceContextFromProfile, } from "../compose/narrativeCompose.js";
+import { buildNarrativeChannels, composeHeadline, composeSubheadline, composeSupportingContext, composeVerificationActions, evidenceContextFromProfile, projectCompactKeyPoints, } from "../compose/narrativeCompose.js";
 import { normalizeGeneratedText, normalizeGeneratedTextNullable, } from "../../normalizeGeneratedText.js";
 import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
 function mapOperationalImpact(vm) {
@@ -112,7 +112,8 @@ export function presentScanDetails(bundle, ctx) {
     });
     const headline = composeHeadline(bundle);
     const subheadline = composeSubheadline(bundle);
-    const keyPoints = composeKeyPoints(bundle, 6);
+    const channels = buildNarrativeChannels(bundle);
+    const keyPoints = projectCompactKeyPoints(channels, 6);
     const verificationTitles = composeVerificationActions(bundle, 6);
     const supportingLines = composeSupportingContext(bundle);
     const supportingContext = supportingLines
@@ -138,7 +139,9 @@ export function presentScanDetails(bundle, ctx) {
             headline: normalizeGeneratedText(headline),
             subheadline: normalizeGeneratedTextNullable(subheadline) ?? undefined,
             verdictLine: normalizeGeneratedText(verdictLine),
-            scopeChip: deriveDetailReachChip(result.totalScore) ?? undefined,
+            scopeChip: channels.reachLabel ??
+                deriveDetailReachChip(result.totalScore) ??
+                undefined,
             postureLabel,
             riskIndex: facts.riskIndex,
         },

package/dist/scanCardSummary.d.ts

@@ -1,4 +1,4 @@
-import type { ScanCardPresentation } from "./presentation/dto/scanCardPresentation.js";
+import type { DashboardCardPresentation } from "./presentation/dto/dashboardCardPresentation.js";
 import type { Finding, ScanResult } from "./types.js";
 export type ScanPipelineStatus = "queued" | "running" | "done" | "failed";
 export type ScanCardPresentationState = "not_scanned" | "scanning" | "analysis_failed" | "ready" | "stale";
@@ -9,9 +9,8 @@ export type FindingCountSummary = {
     medium: number;
     low: number;
 };
-/** @deprecated Use ScanCardPresentation */
-export type ScanCardSummary = ScanCardPresentation;
-export { ScanCardPresentation };
+/** @deprecated Use DashboardCardPresentation */
+export type ScanCardSummary = DashboardCardPresentation;
 export declare const SCAN_CARD_SCANNING_SUMMARY = "Waiting for results...";
 export type PipelineCompletionEvidence = {
     scannedAt?: string | null;

package/dist/scanCardSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanCardSummary.d.ts","sourceRoot":"","sources":["../src/scanCardSummary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAMvF,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1E,MAAM,MAAM,yBAAyB,GACjC,aAAa,GACb,UAAU,GACV,iBAAiB,GACjB,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAGhC,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AAEnE,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAsBF,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,0BAA0B,GACnC,OAAO,CAQT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,0BAA0B,GACnC,kBAAkB,CAKpB;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,OAAO,CAST;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAEvE;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,aAAa,GAAG,IAAI,CAKtB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GACrC,mBAAmB,CAgBrB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACrC,cAAc,EAAE,kBAAkB,GACjC,eAAe,CAOjB;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,2FAA2F;AAC3F,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,cAAc,EAAE,kBAAkB,GACjC,eAAe,CAuBjB;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,sBAAsB,GAC5B,eAAe,CAcjB"}
+{"version":3,"file":"scanCardSummary.d.ts","sourceRoot":"","sources":["../src/scanCardSummary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAMjG,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1E,MAAM,MAAM,yBAAyB,GACjC,aAAa,GACb,UAAU,GACV,iBAAiB,GACjB,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAGxD,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AAEnE,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAsBF,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,0BAA0B,GACnC,OAAO,CAQT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,0BAA0B,GACnC,kBAAkB,CAKpB;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,OAAO,CAST;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAEvE;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,aAAa,GAAG,IAAI,CAKtB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GACrC,mBAAmB,CAgBrB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACrC,cAAc,EAAE,kBAAkB,GACjC,eAAe,CAOjB;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,2FAA2F;AAC3F,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,cAAc,EAAE,kBAAkB,GACjC,eAAe,CAuBjB;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,sBAAsB,GAC5B,eAAe,CAcjB"}

package/dist/scanCardSummary.test.js

@@ -20,11 +20,11 @@ function pipelineCard(overrides = {}) {
             subheadline: scanSurfaceCopy.pipeline.scanIncomplete,
         },
         headline: scanSurfaceCopy.pipeline.scanRunning,
-        changedPackages: [],
-        keyPoints: [],
-        affectedAreas: [],
-        verificationActions: [],
-        evidence: [],
+        insights: [],
+        verification: [],
+        layout: "standard",
+        detailActionLabel: scanSurfaceCopy.presentation.actionLabelReview,
+        sortKey: { postureRank: -1, riskIndex: -1 },
         ...overrides,
     };
 }
@@ -70,7 +70,7 @@ describe("deriveScanCardSummary", () => {
         const queued = deriveScanCardSummary(null, "queued");
         expect(queued.headline).toBe(scanSurfaceCopy.pipeline.scanRunning);
         expect(queued.pipeline?.status).toBe("queued");
-        expect(queued.status).toBeUndefined();
+        expect(queued.verdict).toBeUndefined();
         const running = deriveScanCardSummary(null, "running");
         expect(running.headline).toBe(scanSurfaceCopy.pipeline.scanRunning);
         expect(running.pipeline?.status).toBe("running");
@@ -101,9 +101,9 @@ describe("deriveScanCardSummary", () => {
             },
         };
         const summary = deriveScanCardSummary(r, "done");
-        expect(summary.status).toBe("risky");
+        expect(summary.verdict?.posture).toBe("risky");
         expect(summary.headline).toBe(scanSurfaceCopy.presentation.limitedContextHeadline);
-        expect(summary.riskIndex).toBe(72);
+        expect(summary.sortKey.riskIndex).toBe(72);
     });
     it("keeps quiet safe cards minimal without extra key points beyond defaults", () => {
         const r = {
@@ -116,8 +116,8 @@ describe("deriveScanCardSummary", () => {
             },
         };
         const summary = deriveScanCardSummary(r, "done");
-        expect(summary.status).toBe("safe");
-        expect(summary.keyPoints.length).toBeGreaterThan(0);
+        expect(summary.verdict?.posture).toBe("safe");
+        expect(summary.insights.length).toBeGreaterThan(0);
     });
     it("surfaces catalog key points from explain signals", () => {
         const r = {
@@ -146,7 +146,7 @@ describe("deriveScanCardSummary", () => {
             },
         };
         const summary = deriveScanCardSummary(r, "done");
-        expect(summary.keyPoints.length).toBeGreaterThan(0);
+        expect(summary.insights.length).toBeGreaterThan(0);
     });
     it("exports stale subline constant", () => {
         expect(staleScanSubline()).toBe("Based on earlier commit");
@@ -204,18 +204,18 @@ describe("isPipelinePlaceholderCopy", () => {
 describe("deriveScanCardSummaryFromDenormalized", () => {
     it("builds risky summary from denormalized columns", () => {
         const summary = deriveScanCardSummaryFromDenormalized("risky", 72, "Auth boundary change", "done");
-        expect(summary.status).toBe("risky");
-        expect(summary.riskIndex).toBe(72);
+        expect(summary.verdict?.posture).toBe("risky");
+        expect(summary.sortKey.riskIndex).toBe(72);
         expect(summary.pipeline).toBeUndefined();
     });
     it("does not inject pipeline placeholder summaryText", () => {
         const summary = deriveScanCardSummaryFromDenormalized("risky", 72, "Waiting for results...", "done");
-        expect(summary.status).toBe("risky");
+        expect(summary.verdict?.posture).toBe("risky");
         expect(summary.pipeline).toBeUndefined();
     });
     it("does not inject raw generic summaryText on quiet safe cards", () => {
         const summary = deriveScanCardSummaryFromDenormalized("safe", 12, "No high-confidence merge risks from this PR dependency change", "done");
-        expect(summary.status).toBe("safe");
+        expect(summary.verdict?.posture).toBe("safe");
         expect(summary.pipeline).toBeUndefined();
     });
 });
@@ -228,7 +228,7 @@ describe("resolvePrScanCardSummary", () => {
             summaryText: "Waiting for results...",
             result: null,
         });
-        expect(summary.status).toBe("risky");
+        expect(summary.verdict?.posture).toBe("risky");
         expect(summary.pipeline).toBeUndefined();
     });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mergesignal/shared",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "MergeSignal shared scan contract, presentation policy, and trusted validation",
   "type": "module",
   "main": "./dist/index.js",

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

@@ -1,27 +0,0 @@
-import type { FindingCountSummary, PresentationConfidence, PresentationDensity, PresentationEvidenceContext, PresentationEvidenceRow, PresentationStatus } from "./types.js";
-import type { PresentationIntent } from "../intent/presentationIntent.js";
-export type ScanCardPresentation = {
-    pipeline?: {
-        status: "queued" | "running" | "failed";
-        headline: string;
-        subheadline?: string;
-    };
-    status?: PresentationStatus;
-    density?: PresentationDensity;
-    confidence?: PresentationConfidence;
-    evidenceContext?: PresentationEvidenceContext;
-    headline: string;
-    subheadline?: string;
-    changedPackages: string[];
-    primaryPackage?: string;
-    keyPoints: string[];
-    affectedAreas: string[];
-    verificationActions: string[];
-    evidence: PresentationEvidenceRow[];
-    supportingContext?: string[];
-    riskIndex?: number | null;
-    findingCounts?: FindingCountSummary | null;
-    actionLabel?: string;
-    presentationIntent?: PresentationIntent;
-};
-//# sourceMappingURL=scanCardPresentation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"scanCardPresentation.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/scanCardPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;QACxC,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IAEpC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC,CAAC"}

package/dist/presentation/presenters/presentPipelineScanCard.d.ts

@@ -1,3 +0,0 @@
-import type { ScanCardPresentation } from "../dto/scanCardPresentation.js";
-export declare function presentPipelineScanCard(pipelineStatus: "queued" | "running" | "failed"): ScanCardPresentation;
-//# sourceMappingURL=presentPipelineScanCard.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"presentPipelineScanCard.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentPipelineScanCard.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAC9C,oBAAoB,CAqBtB"}

package/dist/presentation/presenters/presentPipelineScanCard.js

@@ -1,23 +0,0 @@
-import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
-import { normalizeGeneratedText, } from "../../normalizeGeneratedText.js";
-export function presentPipelineScanCard(pipelineStatus) {
-    const isRunning = pipelineStatus === "queued" || pipelineStatus === "running";
-    const headline = isRunning
-        ? scanSurfaceCopy.pipeline.scanRunning
-        : scanSurfaceCopy.pipeline.analysisIncomplete;
-    return {
-        pipeline: {
-            status: pipelineStatus,
-            headline: normalizeGeneratedText(headline),
-            subheadline: isRunning
-                ? scanSurfaceCopy.pipeline.scanIncomplete
-                : undefined,
-        },
-        headline: normalizeGeneratedText(headline),
-        changedPackages: [],
-        keyPoints: [],
-        affectedAreas: [],
-        verificationActions: [],
-        evidence: [],
-    };
-}

package/dist/presentation/presenters/presentScanCard.d.ts

@@ -1,7 +0,0 @@
-import type { ScanCardPresentation } from "../dto/scanCardPresentation.js";
-import type { ScanPresentationBundle } from "../orchestration/scanPresentationBundle.js";
-export type PresentScanCardContext = {
-    includeFindingCounts?: boolean;
-};
-export declare function presentScanCard(bundle: ScanPresentationBundle, ctx?: PresentScanCardContext): ScanCardPresentation;
-//# sourceMappingURL=presentScanCard.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"presentScanCard.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentScanCard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAgB3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEzF,MAAM,MAAM,sBAAsB,GAAG;IACnC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAsBF,wBAAgB,eAAe,CAC7B,MAAM,EAAE,sBAAsB,EAC9B,GAAG,GAAE,sBAA2B,GAC/B,oBAAoB,CA0BtB"}

package/dist/presentation/presenters/presentScanCard.js

@@ -1,44 +0,0 @@
-import { aggregateFindingCounts } from "../dto/types.js";
-import { composeAffectedAreaLabels, composeEvidenceRows, composeHeadline, composeKeyPoints, composeSubheadline, composeSupportingContext, composeVerificationActions, evidenceContextFromProfile, } from "../compose/narrativeCompose.js";
-import { normalizeGeneratedText, normalizeGeneratedTextNullable, } from "../../normalizeGeneratedText.js";
-import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
-function normalizeCard(p) {
-    return {
-        ...p,
-        headline: normalizeGeneratedText(p.headline),
-        subheadline: normalizeGeneratedTextNullable(p.subheadline) ?? undefined,
-        keyPoints: p.keyPoints.map((k) => normalizeGeneratedText(k)),
-        affectedAreas: p.affectedAreas.map((a) => normalizeGeneratedText(a)),
-        verificationActions: p.verificationActions.map((v) => normalizeGeneratedText(v)),
-        evidence: p.evidence.map((e) => ({
-            label: normalizeGeneratedText(e.label),
-            value: normalizeGeneratedText(e.value),
-        })),
-        supportingContext: p.supportingContext?.map((s) => normalizeGeneratedText(s)),
-    };
-}
-export function presentScanCard(bundle, ctx = {}) {
-    const { facts, profile, result } = bundle;
-    const presentation = {
-        status: profile.status,
-        density: profile.density,
-        confidence: profile.confidence,
-        evidenceContext: evidenceContextFromProfile(bundle),
-        headline: composeHeadline(bundle),
-        subheadline: composeSubheadline(bundle) ?? undefined,
-        changedPackages: facts.changedPackages.all,
-        primaryPackage: facts.changedPackages.primary ?? undefined,
-        keyPoints: composeKeyPoints(bundle, 3),
-        affectedAreas: composeAffectedAreaLabels(bundle, 2),
-        verificationActions: composeVerificationActions(bundle, 2),
-        evidence: composeEvidenceRows(bundle, 3),
-        supportingContext: composeSupportingContext(bundle),
-        riskIndex: facts.riskIndex,
-        findingCounts: ctx.includeFindingCounts
-            ? aggregateFindingCounts(result.findings)
-            : null,
-        actionLabel: scanSurfaceCopy.presentation.actionLabelReview,
-        presentationIntent: profile.interpretation.intent,
-    };
-    return normalizeCard(presentation);
-}