@mergesignal/shared 0.3.0 → 0.4.1

package/dist/scanCardSummary.test.js

@@ -1,21 +1,6 @@
 import { describe, it, expect } from "vitest";
-import { isCatalogPhrase } from "./cardObservationCatalog.js";
+import { scanSurfaceCopy } from "./scanSurfaceCopy.js";
 import { aggregateFindingCounts, deriveRiskIndexBand, deriveScanCardSummary, deriveScanCardSummaryFromDenormalized, isPipelineCardSummary, isPipelinePlaceholderCopy, resolvePipelineStatus, resolvePrScanCardSummary, staleScanSubline, } from "./scanCardSummary.js";
-const pipelinePresentationDefaults = {
-    narrativeMode: "denormalized",
-    codeIntelligenceAvailable: false,
-    changedPackagesDisplay: null,
-    runtimeSurfaceLabel: null,
-    reachabilityLabel: null,
-    blastRadiusLabel: null,
-    affectedAreas: [],
-    primaryInsight: null,
-    structuralOnlyDisclaimer: null,
-    usageSummary: null,
-    verificationLine: null,
-    blastRadiusDetail: null,
-    frameworksSummary: null,
-};
 const baseResult = {
     totalScore: 10,
     layerScores: {
@@ -27,6 +12,22 @@ const baseResult = {
     findings: [],
     generatedAt: "2026-01-01T00:00:00.000Z",
 };
+function pipelineCard(overrides = {}) {
+    return {
+        pipeline: {
+            status: "queued",
+            headline: scanSurfaceCopy.pipeline.scanRunning,
+            subheadline: scanSurfaceCopy.pipeline.scanIncomplete,
+        },
+        headline: scanSurfaceCopy.pipeline.scanRunning,
+        changedPackages: [],
+        keyPoints: [],
+        affectedAreas: [],
+        verificationActions: [],
+        evidence: [],
+        ...overrides,
+    };
+}
 describe("deriveRiskIndexBand", () => {
     it("maps score thresholds", () => {
         expect(deriveRiskIndexBand(0)).toBe("low");
@@ -67,18 +68,19 @@ describe("aggregateFindingCounts", () => {
 describe("deriveScanCardSummary", () => {
     it("returns scanning copy for queued/running", () => {
         const queued = deriveScanCardSummary(null, "queued");
-        expect(queued.headline).toBe("Scan in progress");
-        expect(queued.summaryLine).toBe("Waiting for results...");
-        expect(queued.mergePosture).toBeNull();
+        expect(queued.headline).toBe(scanSurfaceCopy.pipeline.scanRunning);
+        expect(queued.pipeline?.status).toBe("queued");
+        expect(queued.status).toBeUndefined();
         const running = deriveScanCardSummary(null, "running");
-        expect(running.headline).toBe("Scan in progress");
+        expect(running.headline).toBe(scanSurfaceCopy.pipeline.scanRunning);
+        expect(running.pipeline?.status).toBe("running");
     });
     it("returns failed copy", () => {
         const failed = deriveScanCardSummary(null, "failed");
-        expect(failed.headline).toBe("Analysis could not be completed");
-        expect(failed.mergePosture).toBeNull();
+        expect(failed.headline).toBe(scanSurfaceCopy.pipeline.analysisIncomplete);
+        expect(failed.pipeline?.status).toBe("failed");
     });
-    it("derives posture headline and risk index for done scans", () => {
+    it("derives posture and risk index for done scans", () => {
         const r = {
             ...baseResult,
             totalScore: 72,
@@ -99,14 +101,11 @@ describe("deriveScanCardSummary", () => {
             },
         };
         const summary = deriveScanCardSummary(r, "done");
-        expect(summary.mergePosture).toBe("risky");
-        expect(summary.headline).toBe("Risky");
+        expect(summary.status).toBe("risky");
+        expect(summary.headline).toBe(scanSurfaceCopy.presentation.limitedContextHeadline);
         expect(summary.riskIndex).toBe(72);
-        expect(summary.riskIndexBand).toBe("high");
-        expect(summary.summaryLine).toBeNull();
-        expect(summary.operationalObservations).toContain("Large upgrade blast radius");
     });
-    it("keeps quiet safe cards posture-only without observations", () => {
+    it("keeps quiet safe cards minimal without extra key points beyond defaults", () => {
         const r = {
             ...baseResult,
             totalScore: 12,
@@ -117,10 +116,10 @@ describe("deriveScanCardSummary", () => {
             },
         };
         const summary = deriveScanCardSummary(r, "done");
-        expect(summary.summaryLine).toBeNull();
-        expect(summary.operationalObservations).toEqual([]);
+        expect(summary.status).toBe("safe");
+        expect(summary.keyPoints.length).toBeGreaterThan(0);
     });
-    it("surfaces catalog observations from explain signals", () => {
+    it("surfaces catalog key points from explain signals", () => {
         const r = {
             ...baseResult,
             decision: {
@@ -147,11 +146,7 @@ describe("deriveScanCardSummary", () => {
             },
         };
         const summary = deriveScanCardSummary(r, "done");
-        expect(summary.topAffectedAreas).toHaveLength(2);
-        expect(summary.operationalObservations.length).toBeGreaterThan(0);
-        for (const phrase of summary.operationalObservations) {
-            expect(isCatalogPhrase(phrase)).toBe(true);
-        }
+        expect(summary.keyPoints.length).toBeGreaterThan(0);
     });
     it("exports stale subline constant", () => {
         expect(staleScanSubline()).toBe("Based on earlier commit");
@@ -183,32 +178,21 @@ describe("resolvePipelineStatus", () => {
 });
 describe("isPipelineCardSummary", () => {
     it("detects scanning placeholder summaries", () => {
-        expect(isPipelineCardSummary({
-            mergePosture: null,
-            riskIndex: null,
-            riskIndexBand: null,
-            headline: "Scan in progress",
-            summaryLine: "Waiting for results...",
-            findingCounts: null,
-            topAffectedAreas: [],
-            operationalObservations: [],
-            supportingLine: null,
-            ...pipelinePresentationDefaults,
-        })).toBe(true);
-    });
-    it("detects hybrid completed posture with pipeline summary line", () => {
-        expect(isPipelineCardSummary({
-            mergePosture: "risky",
-            riskIndex: 72,
-            riskIndexBand: "high",
-            headline: "Risky",
-            summaryLine: "Waiting for results...",
-            findingCounts: null,
-            topAffectedAreas: [],
-            operationalObservations: [],
-            supportingLine: null,
-            ...pipelinePresentationDefaults,
-        })).toBe(true);
+        expect(isPipelineCardSummary(pipelineCard({
+            pipeline: {
+                status: "queued",
+                headline: scanSurfaceCopy.pipeline.scanRunning,
+                subheadline: scanSurfaceCopy.pipeline.scanIncomplete,
+            },
+        }))).toBe(true);
+    });
+    it("detects failed pipeline summaries", () => {
+        expect(isPipelineCardSummary(pipelineCard({
+            pipeline: {
+                status: "failed",
+                headline: scanSurfaceCopy.pipeline.analysisIncomplete,
+            },
+        }))).toBe(true);
     });
 });
 describe("isPipelinePlaceholderCopy", () => {
@@ -218,23 +202,21 @@ describe("isPipelinePlaceholderCopy", () => {
     });
 });
 describe("deriveScanCardSummaryFromDenormalized", () => {
-    it("builds risky summary from denormalized columns without generic narration", () => {
+    it("builds risky summary from denormalized columns", () => {
         const summary = deriveScanCardSummaryFromDenormalized("risky", 72, "Auth boundary change", "done");
-        expect(summary.mergePosture).toBe("risky");
-        expect(summary.headline).toBe("Risky");
+        expect(summary.status).toBe("risky");
         expect(summary.riskIndex).toBe(72);
-        expect(summary.summaryLine).toBeNull();
-        expect(summary.operationalObservations).toEqual([]);
+        expect(summary.pipeline).toBeUndefined();
     });
     it("does not inject pipeline placeholder summaryText", () => {
         const summary = deriveScanCardSummaryFromDenormalized("risky", 72, "Waiting for results...", "done");
-        expect(summary.mergePosture).toBe("risky");
-        expect(summary.summaryLine).not.toBe("Waiting for results...");
+        expect(summary.status).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.mergePosture).toBe("safe");
-        expect(summary.summaryLine).toBeNull();
+        expect(summary.status).toBe("safe");
+        expect(summary.pipeline).toBeUndefined();
     });
 });
 describe("resolvePrScanCardSummary", () => {
@@ -246,8 +228,7 @@ describe("resolvePrScanCardSummary", () => {
             summaryText: "Waiting for results...",
             result: null,
         });
-        expect(summary.mergePosture).toBe("risky");
-        expect(summary.headline).toBe("Risky");
-        expect(summary.summaryLine).not.toBe("Waiting for results...");
+        expect(summary.status).toBe("risky");
+        expect(summary.pipeline).toBeUndefined();
     });
 });

package/dist/scanDetailViewModel.d.ts

@@ -122,6 +122,7 @@ export declare function deriveVerdictLine(posture: MergePosture | null, totalSco
 export declare function deriveAct2Themes(result: ScanResult): string[];
 export declare function deriveOperationalImpact(result: ScanResult, verifyLabels?: Set<string>): ScanDetailOperationalImpact;
 export declare function presentScanDetailNarrativeContext(facts: ScanNarrativeFacts): ScanDetailNarrativeContext;
+export declare function deriveVerdictLineFromFacts(facts: ScanNarrativeFacts, result: ScanResult): string;
 /** Scan detail presentation from shared narrative facts. */
 export declare function presentScanDetailViewModel(facts: ScanNarrativeFacts, result: ScanResult, options: DeriveScanDetailOptions): ScanDetailViewModel;
 export declare function deriveScanDetailViewModel(result: ScanResult | null | undefined, options: DeriveScanDetailOptions): ScanDetailViewModel | null;

package/dist/scanDetailViewModel.d.ts.map

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

package/dist/scanDetailViewModel.js

@@ -552,7 +552,7 @@ function deriveBecauseThemesFromFacts(facts) {
     }
     return themes.slice(0, ACT2_MAX_THEMES);
 }
-function deriveVerdictLineFromFacts(facts, result) {
+export function deriveVerdictLineFromFacts(facts, result) {
     const topGuidance = facts.reviewerGuidance.find((g) => (g.scope === "changed" || g.kind === "insight") && g.message.trim());
     if (topGuidance) {
         return truncateWithEllipsis(topGuidance.message.trim(), VERDICT_LINE_MAX_CHARS);

package/dist/scanNarrativeFacts.d.ts

@@ -47,6 +47,13 @@ export type ScanNarrativeFacts = {
             frameworks: string[];
         };
     } | null;
+    /** From sanitized repoIntelligence primary package semantics (ABI 2). */
+    packageSemantics: {
+        runtimeImpact: "none" | "possible" | "confirmed" | "unknown" | null;
+        expectedImpact: "runtime" | "build_time" | "typecheck" | "test_time" | "development_only" | "unknown" | null;
+        suppressRuntimeNarrative: boolean;
+        verificationFocus: string[];
+    } | null;
     blastRadius: {
         level: BlastRadiusLevel;
         changedPackageCount?: number;

package/dist/scanNarrativeFacts.d.ts.map

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

package/dist/scanNarrativeFacts.js

@@ -10,6 +10,7 @@ export const EMPTY_SCAN_NARRATIVE_FACTS = {
     frameworks: [],
     runtimeSurface: null,
     reachability: null,
+    packageSemantics: null,
     blastRadius: null,
     affectedAreas: [],
     hotspots: [],

package/dist/scanSurfaceCopy.d.ts

@@ -288,6 +288,31 @@ export declare const scanSurfaceCopy: {
         readonly areasSeparator: " | ";
         readonly contextSeparator: " | ";
     };
+    /** Shared presentation layer copy (composeHeadline, key points, verification). */
+    readonly presentation: {
+        readonly limitedContextHeadline: "Dependency upgrade with limited scan context";
+        readonly limitedContextMessage: "PR-specific scan context was limited";
+        readonly limitedContextKeyPoint: "PR-specific intelligence was limited for this scan";
+        readonly noChangedPackagesHeadline: "Dependency scan complete";
+        readonly multiRuntimeHeadline: "Multiple runtime dependency upgrades need review";
+        readonly buildOnlyHeadline: "{package} patch upgrade with limited application impact";
+        readonly runtimeHeadline: "{package} upgrade affects {surface}";
+        readonly defaultUpgradeHeadline: "{package} dependency upgrade needs review";
+        readonly changedPackageKeyPoint: "Changed package: {package}";
+        readonly usedInPathsSingle: "Used across application code ({path})";
+        readonly usedInPathsMultiple: "Used across {count} code paths";
+        readonly noRuntimePathsKeyPoint: "No runtime usage paths detected";
+        readonly blastRadiusWideKeyPoint: "Blast radius is wide";
+        readonly blastRadiusLevelKeyPoint: "Blast radius is {level}";
+        readonly noAffectedAreasKeyPoint: "No affected application areas identified";
+        readonly affectedAreasKeyPoint: "Affected areas: {areas}";
+        readonly verifyCiTypecheck: "Confirm CI/typecheck passes";
+        readonly verifyAuthFlow: "Run authenticated API request flow";
+        readonly verifyErrorResponses: "Check error responses and status codes";
+        readonly graphDepthContext: "Repository graph max depth: {depth}";
+        readonly graphSizeContext: "Repository graph: {nodes} nodes, {edges} edges";
+        readonly actionLabelReview: "Review scan";
+    };
     readonly cli: {
         readonly stderrAnalysisIncomplete: "Analysis could not be completed.";
         readonly stderrOutputNotVerified: "These results could not be verified.";

package/dist/scanSurfaceCopy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanSurfaceCopy.d.ts","sourceRoot":"","sources":["../src/scanSurfaceCopy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;QAgBxB,8EAA8E;;QAG9E,6DAA6D;;;;QAO7D,qDAAqD;;;;;QASrD,mEAAmE;;;;QAOnE,yFAAyF;;QAGzF,mFAAmF;;QAGnF,4EAA4E;;QAE5E,8FAA8F;;QAE9F,+DAA+D;;;QAI/D,6EAA6E;;;;;QAK7E,2CAA2C;;;QAK3C,2EAA2E;;QAE3E,4EAA4E;;;QAI5E,sEAAsE;;;IAGxE,2EAA2E;;;;;;;;;;;;;;QAiBzE,oEAAoE;;;IAGtE,wEAAwE;;;;;;QAOtE,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkCzC,yDAAyD;;YAGzD,mDAAmD;;YAGnD,8BAA8B;;YAE9B,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA4CtD,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsI/C,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BvF,sEAAsE;;;;;CAO9D,CAAC;AAEX,iEAAiE;AACjE,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa5D"}
+{"version":3,"file":"scanSurfaceCopy.d.ts","sourceRoot":"","sources":["../src/scanSurfaceCopy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;QAgBxB,8EAA8E;;QAG9E,6DAA6D;;;;QAO7D,qDAAqD;;;;;QASrD,mEAAmE;;;;QAOnE,yFAAyF;;QAGzF,mFAAmF;;QAGnF,4EAA4E;;QAE5E,8FAA8F;;QAE9F,+DAA+D;;;QAI/D,6EAA6E;;;;;QAK7E,2CAA2C;;;QAK3C,2EAA2E;;QAE3E,4EAA4E;;;QAI5E,sEAAsE;;;IAGxE,2EAA2E;;;;;;;;;;;;;;QAiBzE,oEAAoE;;;IAGtE,wEAAwE;;;;;;QAOtE,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkCzC,yDAAyD;;YAGzD,mDAAmD;;YAGnD,8BAA8B;;YAE9B,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA4CtD,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsI/C,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;IAwBvF,kFAAkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+BlF,sEAAsE;;;;;CAO9D,CAAC;AAEX,iEAAiE;AACjE,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa5D"}

package/dist/scanSurfaceCopy.js

@@ -291,6 +291,31 @@ export const scanSurfaceCopy = {
         areasSeparator: " | ",
         contextSeparator: " | ",
     },
+    /** Shared presentation layer copy (composeHeadline, key points, verification). */
+    presentation: {
+        limitedContextHeadline: "Dependency upgrade with limited scan context",
+        limitedContextMessage: "PR-specific scan context was limited",
+        limitedContextKeyPoint: "PR-specific intelligence was limited for this scan",
+        noChangedPackagesHeadline: "Dependency scan complete",
+        multiRuntimeHeadline: "Multiple runtime dependency upgrades need review",
+        buildOnlyHeadline: "{package} patch upgrade with limited application impact",
+        runtimeHeadline: "{package} upgrade affects {surface}",
+        defaultUpgradeHeadline: "{package} dependency upgrade needs review",
+        changedPackageKeyPoint: "Changed package: {package}",
+        usedInPathsSingle: "Used across application code ({path})",
+        usedInPathsMultiple: "Used across {count} code paths",
+        noRuntimePathsKeyPoint: "No runtime usage paths detected",
+        blastRadiusWideKeyPoint: "Blast radius is wide",
+        blastRadiusLevelKeyPoint: "Blast radius is {level}",
+        noAffectedAreasKeyPoint: "No affected application areas identified",
+        affectedAreasKeyPoint: "Affected areas: {areas}",
+        verifyCiTypecheck: "Confirm CI/typecheck passes",
+        verifyAuthFlow: "Run authenticated API request flow",
+        verifyErrorResponses: "Check error responses and status codes",
+        graphDepthContext: "Repository graph max depth: {depth}",
+        graphSizeContext: "Repository graph: {nodes} nodes, {edges} edges",
+        actionLabelReview: "Review scan",
+    },
     cli: {
         stderrAnalysisIncomplete: "Analysis could not be completed.",
         stderrOutputNotVerified: "These results could not be verified.",

package/package.json

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

package/dist/presentScanCardSummary.d.ts

@@ -1,16 +0,0 @@
-import { type ScanCardSummary, type ScanPipelineStatus } from "./scanCardSummary.js";
-import type { ScanNarrativeFacts } from "./scanNarrativeFacts.js";
-import { type CardExposureDisplay } from "./formatCardExposureDisplay.js";
-import { type MergePosture } from "./riskVocabulary.js";
-import type { ScanResult } from "./types.js";
-export type PresentScanCardSummaryOptions = {
-    pipelineStatus?: ScanPipelineStatus;
-    findings?: ScanResult["findings"];
-};
-/**
- * Dashboard card presentation DTO from consumer-agnostic facts.
- */
-export declare function presentScanCardSummary(facts: ScanNarrativeFacts, options?: PresentScanCardSummaryOptions): ScanCardSummary;
-export type { CardExposureDisplay, MergePosture };
-export declare function exposureFromFacts(facts: ScanNarrativeFacts): CardExposureDisplay | null;
-//# sourceMappingURL=presentScanCardSummary.d.ts.map

package/dist/presentScanCardSummary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"presentScanCardSummary.d.ts","sourceRoot":"","sources":["../src/presentScanCardSummary.ts"],"names":[],"mappings":"AAKA,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AAkBxC,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,6BAA6B,GAAG;IAC1C,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;CACnC,CAAC;AA2HF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,6BAAkC,GAC1C,eAAe,CA8HjB;AAED,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,CAAC;AAElD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,GACxB,mBAAmB,GAAG,IAAI,CAE5B"}

package/dist/presentScanCardSummary.js

@@ -1,212 +0,0 @@
-import { isCatalogPhrase, phraseForFamily, } from "./cardObservationCatalog.js";
-import { aggregateFindingCounts, deriveRiskIndexBand, SCAN_CARD_SCANNING_SUMMARY, } from "./scanCardSummary.js";
-import { deriveCardExposureDisplay, } from "./formatCardExposureDisplay.js";
-import { formatCardAreaLabels } from "./formatCardAreaLabels.js";
-import { composeContextLineFromFacts, composeVerificationPrompt, formatBlastRadiusDetailLine, formatChangedPackagesShort, formatFrameworksSummary, formatUsageSummaryLine, labelBlastRadiusLevel, labelReachabilityKind, labelRuntimeSurface, } from "./narrativePresentation.js";
-import { normalizeGeneratedText, normalizeGeneratedTextNullable, } from "./normalizeGeneratedText.js";
-import { MERGE_POSTURE_LABEL } from "./riskVocabulary.js";
-import { scanSurfaceCopy } from "./scanSurfaceCopy.js";
-function formatAffectedAreaLabels(facts) {
-    const ordered = [];
-    for (const area of facts.affectedAreas) {
-        const formatted = formatCardAreaLabels([area.label], 1);
-        if (formatted[0])
-            ordered.push(formatted[0]);
-        if (ordered.length >= 2)
-            break;
-    }
-    return ordered;
-}
-function selectPrimaryInsight(facts) {
-    const changedGuidance = facts.reviewerGuidance.find((g) => g.scope === "changed" && g.message.trim());
-    if (changedGuidance)
-        return changedGuidance.message.trim();
-    const insight = facts.reviewerGuidance.find((g) => g.kind === "insight" && g.message.trim());
-    if (insight)
-        return insight.message.trim();
-    return null;
-}
-function selectSecondaryLines(facts, exclude) {
-    const lines = [];
-    for (const g of facts.reviewerGuidance) {
-        const msg = g.message.trim();
-        if (!msg || msg === exclude)
-            continue;
-        lines.push(msg);
-        if (lines.length >= 2)
-            break;
-    }
-    return lines;
-}
-function repositoryContextPhrases(facts, max) {
-    const phrases = [];
-    const seen = new Set();
-    for (const ctx of facts.repositoryContext) {
-        const phrase = phraseForFamily(ctx.family);
-        if (seen.has(phrase))
-            continue;
-        seen.add(phrase);
-        phrases.push(phrase);
-        if (phrases.length >= max)
-            break;
-    }
-    return phrases;
-}
-function buildLegacyObservations(facts, primaryInsight, repoPhraseCap) {
-    const repoPhrases = repositoryContextPhrases(facts, repoPhraseCap);
-    const secondary = selectSecondaryLines(facts, primaryInsight);
-    if (primaryInsight) {
-        return {
-            operationalObservations: repoPhrases.slice(0, 1),
-            supportingLine: repoPhrases[0] && repoPhrases[0] !== primaryInsight
-                ? repoPhrases[0]
-                : (secondary[0] ?? null),
-        };
-    }
-    if (repoPhrases.length === 0) {
-        return { operationalObservations: [], supportingLine: null };
-    }
-    return {
-        operationalObservations: repoPhrases.slice(0, repoPhraseCap),
-        supportingLine: repoPhrases.length === 1 ? (secondary[0] ?? null) : null,
-    };
-}
-function normalizeCardSummary(summary) {
-    return {
-        ...summary,
-        headline: normalizeGeneratedText(summary.headline),
-        summaryLine: normalizeGeneratedTextNullable(summary.summaryLine),
-        supportingLine: normalizeGeneratedTextNullable(summary.supportingLine),
-        changedPackagesDisplay: normalizeGeneratedTextNullable(summary.changedPackagesDisplay),
-        runtimeSurfaceLabel: normalizeGeneratedTextNullable(summary.runtimeSurfaceLabel),
-        reachabilityLabel: normalizeGeneratedTextNullable(summary.reachabilityLabel),
-        blastRadiusLabel: normalizeGeneratedTextNullable(summary.blastRadiusLabel),
-        primaryInsight: normalizeGeneratedTextNullable(summary.primaryInsight),
-        structuralOnlyDisclaimer: normalizeGeneratedTextNullable(summary.structuralOnlyDisclaimer),
-        usageSummary: normalizeGeneratedTextNullable(summary.usageSummary),
-        verificationLine: normalizeGeneratedTextNullable(summary.verificationLine),
-        blastRadiusDetail: normalizeGeneratedTextNullable(summary.blastRadiusDetail),
-        frameworksSummary: normalizeGeneratedTextNullable(summary.frameworksSummary),
-        affectedAreas: summary.affectedAreas.map((a) => normalizeGeneratedText(a)),
-        topAffectedAreas: summary.topAffectedAreas.map((a) => normalizeGeneratedText(a)),
-        operationalObservations: summary.operationalObservations.map((p) => {
-            const normalized = normalizeGeneratedText(p);
-            return isCatalogPhrase(normalized) ? normalized : p;
-        }),
-    };
-}
-/**
- * Dashboard card presentation DTO from consumer-agnostic facts.
- */
-export function presentScanCardSummary(facts, options = {}) {
-    const pipelineStatus = options.pipelineStatus ?? "done";
-    const emptyPresentationFields = {
-        narrativeMode: facts.availability.mode,
-        codeIntelligenceAvailable: facts.availability.codeIntelligenceAvailable,
-        changedPackagesDisplay: null,
-        runtimeSurfaceLabel: null,
-        reachabilityLabel: null,
-        blastRadiusLabel: null,
-        affectedAreas: [],
-        primaryInsight: null,
-        structuralOnlyDisclaimer: null,
-        usageSummary: null,
-        verificationLine: null,
-        blastRadiusDetail: null,
-        frameworksSummary: null,
-    };
-    if (pipelineStatus === "queued" || pipelineStatus === "running") {
-        return normalizeCardSummary({
-            mergePosture: null,
-            riskIndex: null,
-            riskIndexBand: null,
-            headline: scanSurfaceCopy.pipeline.scanRunning,
-            summaryLine: SCAN_CARD_SCANNING_SUMMARY,
-            findingCounts: null,
-            topAffectedAreas: [],
-            operationalObservations: [],
-            supportingLine: null,
-            ...emptyPresentationFields,
-        });
-    }
-    if (pipelineStatus === "failed") {
-        return normalizeCardSummary({
-            mergePosture: null,
-            riskIndex: null,
-            riskIndexBand: null,
-            headline: scanSurfaceCopy.pipeline.analysisIncomplete,
-            summaryLine: null,
-            findingCounts: null,
-            topAffectedAreas: [],
-            operationalObservations: [],
-            supportingLine: null,
-            ...emptyPresentationFields,
-        });
-    }
-    const posture = facts.mergePosture;
-    const riskIndex = facts.riskIndex;
-    const riskIndexBand = deriveRiskIndexBand(riskIndex);
-    const headline = posture
-        ? MERGE_POSTURE_LABEL[posture]
-        : scanSurfaceCopy.checkRun.mergePostureUnavailable;
-    const findingCounts = options.findings
-        ? aggregateFindingCounts(options.findings)
-        : null;
-    const prIntelligence = facts.availability.mode === "pr_intelligence" ||
-        facts.availability.tiersPresent.tier1;
-    const changedPackagesDisplay = formatChangedPackagesShort(facts, 2);
-    const runtimeSurfaceLabel = labelRuntimeSurface(facts);
-    const reachabilityLabel = labelReachabilityKind(facts);
-    const blastRadiusLabel = labelBlastRadiusLevel(facts);
-    const affectedAreas = formatAffectedAreaLabels(facts);
-    const contextLine = composeContextLineFromFacts(facts, {
-        includePathSample: prIntelligence,
-        maxAreas: 2,
-    });
-    const structuralOnlyDisclaimer = facts.availability.mode === "graph_fallback" &&
-        !facts.availability.tiersPresent.tier1
-        ? scanSurfaceCopy.narrativeCard.structuralOnlyDisclaimer
-        : null;
-    const insightMessage = selectPrimaryInsight(facts);
-    const primaryInsight = insightMessage ??
-        (facts.availability.mode !== "graph_fallback" ? contextLine : null);
-    const usageSummary = prIntelligence ? formatUsageSummaryLine(facts, 1) : null;
-    const verificationLine = prIntelligence
-        ? composeVerificationPrompt(facts)
-        : null;
-    const blastRadiusDetail = prIntelligence
-        ? formatBlastRadiusDetailLine(facts, 1)
-        : null;
-    const frameworksSummary = prIntelligence
-        ? formatFrameworksSummary(facts, 2)
-        : null;
-    const repoPhraseCap = prIntelligence ? 0 : 3;
-    const { operationalObservations, supportingLine } = buildLegacyObservations(facts, primaryInsight, repoPhraseCap);
-    return normalizeCardSummary({
-        mergePosture: posture,
-        riskIndex,
-        riskIndexBand,
-        headline,
-        summaryLine: null,
-        findingCounts,
-        topAffectedAreas: affectedAreas,
-        operationalObservations,
-        supportingLine,
-        narrativeMode: facts.availability.mode,
-        codeIntelligenceAvailable: facts.availability.codeIntelligenceAvailable,
-        changedPackagesDisplay,
-        runtimeSurfaceLabel,
-        reachabilityLabel,
-        blastRadiusLabel,
-        affectedAreas,
-        primaryInsight,
-        structuralOnlyDisclaimer,
-        usageSummary,
-        verificationLine,
-        blastRadiusDetail,
-        frameworksSummary,
-    });
-}
-export function exposureFromFacts(facts) {
-    return deriveCardExposureDisplay(facts.riskIndex) ?? null;
-}