@mergesignal/shared 0.4.2 → 0.5.0

package/dist/presentation/fixtures/presentationPersonaFixtures.js

@@ -1,3 +1,4 @@
+import { assessmentBullmq, assessmentEslint, assessmentMixedTypescriptFastify, assessmentNextAuth, assessmentPrettier, assessmentUnknownSafe, assessmentVitest, } from "../../fixtures/assessmentFixtures.js";
 import { fixtureRepoIntelligenceFastify, fixtureRepoIntelligenceTypescript, } from "../../fixtures/repoIntelligenceFixtures.js";
 import { analysisPreparationWithValidRepoIntel } from "../../fixtures/repoIntelligenceTestHelpers.js";
 import { scanResultFastifyRuntime, scanResultLimitedContext, scanResultTypescriptPatch, } from "./scanResultFixtures.js";
@@ -128,7 +129,22 @@ const fixtureRepoIntelligenceMixedToolingRuntime = {
     blastRadius: fixtureRepoIntelligenceFastify.blastRadius,
     applicationAreas: fixtureRepoIntelligenceFastify.applicationAreas,
 };
-function scanBase(over = {}) {
+function decisionForAssessment(assessment) {
+    return {
+        recommendation: assessment.posture,
+        confidence: assessment.confidence,
+        reasoning: assessment.posture === "safe"
+            ? [
+                "No dedicated dependency review required beyond normal engineering process.",
+            ]
+            : assessment.primaryConcern === "confirmed_runtime_usage"
+                ? [
+                    "Changed package has confirmed usage on runtime application paths in this repository.",
+                ]
+                : ["Explicit human review warranted before merge."],
+    };
+}
+function scanBase(assessment, over = {}) {
     return {
         totalScore: 18,
         layerScores: {
@@ -139,59 +155,50 @@ function scanBase(over = {}) {
         },
         findings: [],
         generatedAt: "2026-01-01T00:00:00.000Z",
-        decision: {
-            recommendation: "safe",
-            confidence: "high",
-            reasoning: [],
-        },
+        assessment,
+        decision: decisionForAssessment(assessment),
         analysisPreparation: basePrep,
         ...over,
     };
 }
-export const scanResultEslint = scanBase({
+export const scanResultEslint = scanBase(assessmentEslint, {
     changedPackages: ["eslint"],
     repoIntelligence: fixtureRepoIntelligenceEslint,
 });
-export const scanResultPrettier = scanBase({
+export const scanResultPrettier = scanBase(assessmentPrettier, {
     changedPackages: ["prettier"],
     repoIntelligence: fixtureRepoIntelligencePrettier,
 });
-export const scanResultVitest = scanBase({
+export const scanResultVitest = scanBase(assessmentVitest, {
     changedPackages: ["vitest"],
     repoIntelligence: fixtureRepoIntelligenceVitest,
 });
-export const scanResultNextAuth = scanBase({
+export const scanResultNextAuth = scanBase(assessmentNextAuth, {
     totalScore: 52,
     changedPackages: ["next-auth"],
     repoIntelligence: fixtureRepoIntelligenceNextAuth,
-    decision: {
-        recommendation: "needs_review",
-        confidence: "medium",
-        reasoning: [],
-    },
 });
-export const scanResultBullmq = scanBase({
+export const scanResultBullmq = scanBase(assessmentBullmq, {
     totalScore: 48,
     changedPackages: ["bullmq"],
     repoIntelligence: fixtureRepoIntelligenceBullmq,
     decision: {
         recommendation: "needs_review",
         confidence: "medium",
-        reasoning: [],
+        reasoning: [
+            "Changed package has confirmed usage on runtime application paths in this repository.",
+            "Queue infrastructure",
+            "Verification focus required",
+        ],
     },
 });
-export const scanResultUnknownSafe = scanBase({
+export const scanResultUnknownSafe = scanBase(assessmentUnknownSafe, {
     changedPackages: ["opaque-pkg"],
     repoIntelligence: fixtureRepoIntelligenceUnknown,
 });
-export const scanResultMixedTypescriptFastify = scanBase({
+export const scanResultMixedTypescriptFastify = scanBase(assessmentMixedTypescriptFastify, {
     totalScore: 55,
     changedPackages: ["typescript", "fastify"],
     repoIntelligence: fixtureRepoIntelligenceMixedToolingRuntime,
-    decision: {
-        recommendation: "needs_review",
-        confidence: "medium",
-        reasoning: [],
-    },
 });
 export { scanResultFastifyRuntime, scanResultLimitedContext, scanResultTypescriptPatch, };

package/dist/presentation/fixtures/scanResultFixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanResultFixtures.d.ts","sourceRoot":"","sources":["../../../src/presentation/fixtures/scanResultFixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAOjD,eAAO,MAAM,wBAAwB,EAAE,UA6BtC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,UAwBvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,UAyBtC,CAAC"}
+{"version":3,"file":"scanResultFixtures.d.ts","sourceRoot":"","sources":["../../../src/presentation/fixtures/scanResultFixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAYjD,eAAO,MAAM,wBAAwB,EAAE,UAiCtC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,UA2BvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,UA4BtC,CAAC"}

package/dist/presentation/fixtures/scanResultFixtures.js

@@ -1,3 +1,4 @@
+import { assessmentFastifyRuntime, assessmentLimitedContext, assessmentTypescriptPatch, } from "../../fixtures/assessmentFixtures.js";
 import { fixtureRepoIntelligenceFastify, fixtureRepoIntelligenceTypescript, } from "../../fixtures/repoIntelligenceFixtures.js";
 import { analysisPreparationWithValidRepoIntel } from "../../fixtures/repoIntelligenceTestHelpers.js";
 export const scanResultFastifyRuntime = {
@@ -13,10 +14,14 @@ export const scanResultFastifyRuntime = {
     changedPackages: ["fastify"],
     analysisPreparation: analysisPreparationWithValidRepoIntel(),
     repoIntelligence: fixtureRepoIntelligenceFastify,
+    assessment: assessmentFastifyRuntime,
     decision: {
         recommendation: "needs_review",
         confidence: "medium",
-        reasoning: [],
+        reasoning: [
+            "Changed package has confirmed usage on runtime application paths in this repository.",
+            "HTTP framework infrastructure",
+        ],
     },
     insights: [
         {
@@ -43,10 +48,13 @@ export const scanResultTypescriptPatch = {
     changedPackages: ["typescript"],
     analysisPreparation: analysisPreparationWithValidRepoIntel(),
     repoIntelligence: fixtureRepoIntelligenceTypescript,
+    assessment: assessmentTypescriptPatch,
     decision: {
         recommendation: "safe",
         confidence: "high",
-        reasoning: [],
+        reasoning: [
+            "No dedicated dependency review required beyond normal engineering process.",
+        ],
     },
     graphInsights: {
         maxDepth: 4,
@@ -67,6 +75,7 @@ export const scanResultLimitedContext = {
     generatedAt: "2026-01-01T00:00:00.000Z",
     changedPackages: ["lodash"],
     repoIntelligence: { invalid: true },
+    assessment: assessmentLimitedContext,
     graphInsights: {
         maxDepth: 5,
         nodes: 200,
@@ -78,6 +87,8 @@ export const scanResultLimitedContext = {
     decision: {
         recommendation: "needs_review",
         confidence: "low",
-        reasoning: [],
+        reasoning: [
+            "Collection evidence is partial; confidence is reduced but review posture is preserved when runtime signals exist.",
+        ],
     },
 };

package/dist/presentation/index.d.ts

@@ -7,14 +7,14 @@ export { buildScanDetailsPresentation } from "./orchestration/buildScanDetailsPr
 export type { BuildScanDetailsPresentationInput } from "./orchestration/buildScanDetailsPresentation.js";
 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 +23,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,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

@@ -1,9 +1,7 @@
 export { buildScanPresentationBundle } from "./orchestration/buildScanPresentationBundle.js";
 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 +9,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/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":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAUjD,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;AA+BF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,yBAAyB,CA2B3B"}

package/dist/presentation/orchestration/buildScanCardPresentation.js

@@ -1,12 +1,13 @@
-import { mergePostureFromDecision } from "../../riskVocabulary.js";
+import { assessmentLimitedContext } from "../../fixtures/assessmentFixtures.js";
+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))) {
         return null;
     }
+    const resolvedPosture = posture;
     return {
         totalScore: totalScore ?? 0,
         layerScores: {
@@ -17,19 +18,22 @@ function minimalResultFromDenormalized(decision, totalScore) {
         },
         findings: [],
         generatedAt: new Date().toISOString(),
-        decision: posture
-            ? { recommendation: posture, confidence: "medium", reasoning: [] }
+        decision: resolvedPosture
+            ? { recommendation: resolvedPosture, confidence: "medium", reasoning: [] }
+            : undefined,
+        assessment: resolvedPosture
+            ? { ...assessmentLimitedContext, posture: resolvedPosture }
             : undefined,
     };
 }
 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 +42,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/orchestration/buildScanPresentationBundle.d.ts

@@ -9,7 +9,7 @@ export type BuildScanPresentationBundleInput = {
 };
 /**
  * Mandatory orchestration entrypoint for completed-scan presentation.
- * Only place that calls deriveScanNarrative and derivePresentationProfile.
+ * Assessment is the sole authority; profile is a thin projection.
  */
 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":"AACA,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;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,sBAAsB,GAAG,IAAI,CAiB/B"}
+{"version":3,"file":"buildScanPresentationBundle.d.ts","sourceRoot":"","sources":["../../../src/presentation/orchestration/buildScanPresentationBundle.ts"],"names":[],"mappings":"AAKA,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;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,sBAAsB,GAAG,IAAI,CAsB/B"}

package/dist/presentation/orchestration/buildScanPresentationBundle.js

@@ -1,23 +1,25 @@
+import { parseAssessmentOrThrow, toPublicPresentation, } from "../../assessmentSchema.js";
 import { deriveScanNarrative } from "../../deriveScanNarrative.js";
-import { derivePresentationProfile } from "../profile/derivePresentationProfile.js";
+import { buildProfileFromAssessment } from "../profile/buildProfileFromAssessment.js";
 /**
  * Mandatory orchestration entrypoint for completed-scan presentation.
- * Only place that calls deriveScanNarrative and derivePresentationProfile.
+ * Assessment is the sole authority; profile is a thin projection.
  */
 export function buildScanPresentationBundle(input) {
     if (input.pipelineStatus !== "done" || !input.result)
         return null;
-    const facts = deriveScanNarrative(input.result);
-    const profile = derivePresentationProfile(facts, {
-        pipelineStatus: input.pipelineStatus,
-        decision: input.decision,
-        totalScore: input.totalScore ?? input.result.totalScore,
-    });
-    if (!profile)
+    const assessment = input.result.assessment;
+    if (!assessment)
         return null;
+    parseAssessmentOrThrow(assessment);
+    const presentation = toPublicPresentation(assessment.presentation);
+    const profile = buildProfileFromAssessment(assessment, presentation, input.result);
+    const facts = deriveScanNarrative(input.result);
     return {
-        facts,
+        assessment,
+        presentation,
         profile,
+        facts,
         result: input.result,
     };
 }

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

@@ -1,15 +1,20 @@
+import type { Assessment, AssessmentPresentationPublic } from "../../assessmentSchema.js";
 import type { ScanNarrativeFacts } from "../../scanNarrativeFacts.js";
 import type { ScanResult } from "../../types.js";
 import type { PresentationProfile } from "../profile/presentationProfile.js";
 export type ScanPresentationBundle = {
-    facts: ScanNarrativeFacts;
+    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.
+     */
+    facts: ScanNarrativeFacts;
     /**
      * Projection-only reference to the raw scan payload.
      * Presenters may read fields for formatting but must NOT re-derive interpretation.
      */
     result: ScanResult;
-    /** Extension point for future shared derived artifacts */
-    shared?: Record<string, unknown>;
 };
 //# sourceMappingURL=scanPresentationBundle.d.ts.map

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,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,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;;OAGG;IACH,MAAM,EAAE,UAAU,CAAC;IACnB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC"}
+{"version":3,"file":"scanPresentationBundle.d.ts","sourceRoot":"","sources":["../../../src/presentation/orchestration/scanPresentationBundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,4BAA4B,EAC7B,MAAM,2BAA2B,CAAC;AACnC,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"}

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";
@@ -25,9 +25,9 @@ const personas = [
         intent: "tooling_upgrade",
         status: "safe",
         density: "minimal",
-        headlineMatch: /tooling upgrade/i,
+        headlineMatch: /patch upgrade/i,
         headlineMustNot: /needs review/i,
-        verificationIncludes: ["CI", "lint"],
+        verificationIncludes: ["ci", "lint"],
     },
     {
         name: "prettier",
@@ -35,7 +35,7 @@ const personas = [
         intent: "tooling_upgrade",
         status: "safe",
         density: "minimal",
-        headlineMatch: /tooling upgrade/i,
+        headlineMatch: /patch upgrade/i,
         headlineMustNot: /needs review/i,
         verificationIncludes: ["format"],
     },
@@ -45,9 +45,9 @@ const personas = [
         intent: "tooling_upgrade",
         status: "safe",
         density: "minimal",
-        headlineMatch: /tooling upgrade/i,
+        headlineMatch: /patch upgrade|dependency upgrade/i,
         headlineMustNot: /needs review/i,
-        verificationIncludes: ["test suite"],
+        verificationIncludes: ["test"],
     },
     {
         name: "fastify runtime",
@@ -65,7 +65,7 @@ const personas = [
         status: "needs_review",
         density: "rich",
         headlineMatch: /runtime upgrade affects/i,
-        verificationIncludes: ["auth flow"],
+        verificationIncludes: ["auth_flow"],
     },
     {
         name: "bullmq runtime",
@@ -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;AAGzF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,mBAAmB,CA8BrB"}

package/dist/presentation/presenters/presentCliScanSummary.js

@@ -1,4 +1,5 @@
-import { composeHeadline, composeKeyPoints, composeSubheadline, composeSupportingContext, composeVerificationActions, evidenceContextFromProfile, } from "../compose/narrativeCompose.js";
+import { buildNarrativeChannels, composeHeadline, composeSubheadline, composeSupportingContext, composeVerificationActions, evidenceContextFromProfile, projectCompactKeyPoints, } from "../compose/narrativeCompose.js";
+import { projectAssessmentFields } from "../projectAssessmentFields.js";
 export function presentCliScanSummary(bundle, ctx = {}) {
     const { facts, profile, result } = bundle;
     const layers = result.layerScores;
@@ -6,6 +7,7 @@ export function presentCliScanSummary(bundle, ctx = {}) {
         ? `security=${layers.security} maintainability=${layers.maintainability} ecosystem=${layers.ecosystem} upgradeImpact=${layers.upgradeImpact}`
         : "";
     return {
+        ...projectAssessmentFields(bundle),
         header: {
             repoLabel: ctx.repoLabel ?? "scan",
             methodology: result.methodologyVersion ?? undefined,
@@ -17,7 +19,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;AAoEzF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,sBAAsB,GAC7B,yBAAyB,CA8C3B;AAED,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAC9C,yBAAyB,CAqB3B"}