@mergesignal/shared 0.2.8 → 0.4.0

package/dist/presentGitHubPrComment.js

@@ -1,66 +1,21 @@
-import { deriveScanNarrative } from "./deriveScanNarrative.js";
-import { composeVerificationPrompt, formatChangedPackagesShort, formatUsageSummaryLine, selectReviewerGuidance, } from "./narrativePresentation.js";
-import { normalizeGeneratedText } from "./normalizeGeneratedText.js";
-import { MERGE_POSTURE_LABEL, mergePostureFromDecision, } from "./riskVocabulary.js";
-import { scanSurfaceCopy } from "./scanSurfaceCopy.js";
-function renderGuidanceBlock(message, where, action) {
-    return [
-        normalizeGeneratedText(message),
-        "",
-        "**Where it shows up**",
-        "",
-        normalizeGeneratedText(where),
-        "",
-        "**What to do**",
-        "",
-        normalizeGeneratedText(action),
-    ].join("\n");
-}
+import { buildScanPresentationBundle } from "./presentation/orchestration/buildScanPresentationBundle.js";
+import { presentGitHubPrComment as presentGitHubPrCommentFromBundle } from "./presentation/presenters/presentGitHubPrComment.js";
+import { renderGitHubPrCommentMarkdown } from "./presentation/render/renderGitHubPrCommentMarkdown.js";
 /**
- * PR comment markdown from narrative facts (compressed dashboard story).
+ * PR comment markdown from a completed scan (via presentation bundle).
  */
-export function presentGitHubPrComment(facts, result) {
-    const posture = facts.mergePosture ??
-        mergePostureFromDecision(result.decision?.recommendation);
-    const title = posture
-        ? `**${MERGE_POSTURE_LABEL[posture]}**`
-        : `**${scanSurfaceCopy.checkRun.mergePostureUnavailable}**`;
-    const introLines = [];
-    const changed = formatChangedPackagesShort(facts, 3);
-    if (changed)
-        introLines.push(`Changed: ${changed}`);
-    const usage = formatUsageSummaryLine(facts, 1);
-    if (usage)
-        introLines.push(usage);
-    const verify = composeVerificationPrompt(facts);
-    if (verify)
-        introLines.push(`Verify: ${verify}`);
-    const guidance = selectReviewerGuidance(facts, { scope: "changed", max: 3 });
-    if (guidance.length === 0) {
-        const fallback = selectReviewerGuidance(facts, { max: 3 });
-        guidance.push(...fallback.slice(0, 3 - guidance.length));
-    }
-    const blocks = guidance.map((g) => {
-        const where = g.context?.trim() ||
-            facts.packageUsage
-                .flatMap((u) => u.paths.slice(0, 1))
-                .filter(Boolean)[0] ||
-            "See scan detail for affected paths.";
-        const action = g.remediation?.trim() ||
-            composeVerificationPrompt(facts) ||
-            "Review before merge.";
-        return renderGuidanceBlock(g.message, where, action);
+export function presentGitHubPrCommentMarkdownFromResult(result) {
+    const bundle = buildScanPresentationBundle({
+        result,
+        pipelineStatus: "done",
+        decision: result.decision?.recommendation,
+        totalScore: result.totalScore,
     });
-    const parts = [title];
-    if (introLines.length > 0) {
-        parts.push("", introLines.join("\n"));
-    }
-    if (blocks.length > 0) {
-        parts.push("", ...blocks);
-    }
-    return parts.join("\n\n---\n\n").trimEnd();
+    if (!bundle)
+        return "";
+    return renderGitHubPrCommentMarkdown(presentGitHubPrCommentFromBundle(bundle));
 }
-/** Backward-compatible entry: derives facts then presents. */
+/** Backward-compatible entry: derives bundle then renders markdown. */
 export function renderInsightsAsMarkdown(insights, decision) {
     const result = {
         totalScore: 0,
@@ -75,6 +30,5 @@ export function renderInsightsAsMarkdown(insights, decision) {
         insights,
         decision,
     };
-    const facts = deriveScanNarrative(result);
-    return presentGitHubPrComment(facts, result);
+    return presentGitHubPrCommentMarkdownFromResult(result);
 }

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

@@ -0,0 +1,16 @@
+import type { ScanPresentationBundle } from "../orchestration/scanPresentationBundle.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[];
+export declare function composeVerificationActions(bundle: ScanPresentationBundle, max: number): string[];
+export declare function composeAffectedAreaLabels(bundle: ScanPresentationBundle, max: number): string[];
+export declare function composeEvidenceRows(bundle: ScanPresentationBundle, max: number): Array<{
+    label: string;
+    value: string;
+}>;
+export declare function composeSupportingContext(bundle: ScanPresentationBundle): string[] | undefined;
+export declare function evidenceContextFromProfile(bundle: ScanPresentationBundle): {
+    priority: "pr_intelligence" | "limited";
+    degradedMessage?: string;
+};
+//# sourceMappingURL=narrativeCompose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"narrativeCompose.d.ts","sourceRoot":"","sources":["../../../src/presentation/compose/narrativeCompose.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AASzF,wBAAgB,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAwCtE;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,CA2EV;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CA0BV;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,CAiBzC;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

@@ -0,0 +1,167 @@
+import { formatCardAreaLabels } from "../../formatCardAreaLabels.js";
+import { composeVerificationPrompt, formatChangedPackagesShort, labelBlastRadiusLevel, labelReachabilityKind, labelRuntimeSurface, selectReviewerGuidance, summarizeBlastRadius, summarizePackageUsage, } from "../../narrativePresentation.js";
+import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
+function topAreaLabel(bundle) {
+    const area = bundle.facts.affectedAreas[0];
+    if (!area)
+        return null;
+    const formatted = formatCardAreaLabels([area.label], 1);
+    return formatted[0] ?? area.label;
+}
+export function composeHeadline(bundle) {
+    const { facts, profile } = bundle;
+    const primary = facts.changedPackages.primary;
+    if (profile.priority === "limited") {
+        return scanSurfaceCopy.presentation.limitedContextHeadline;
+    }
+    if (!primary) {
+        return scanSurfaceCopy.presentation.noChangedPackagesHeadline;
+    }
+    const runtime = facts.runtimeSurface?.kind === "runtime";
+    const area = topAreaLabel(bundle);
+    if (facts.changedPackages.all.length > 1 && runtime) {
+        return scanSurfaceCopy.presentation.multiRuntimeHeadline;
+    }
+    if (facts.runtimeSurface?.kind === "build" ||
+        facts.reachability?.kind === "build_only") {
+        return scanSurfaceCopy.presentation.buildOnlyHeadline.replace("{package}", primary);
+    }
+    if (runtime) {
+        const surface = area ?? labelRuntimeSurface(facts) ?? "application code";
+        return scanSurfaceCopy.presentation.runtimeHeadline
+            .replace("{package}", primary)
+            .replace("{surface}", surface);
+    }
+    return scanSurfaceCopy.presentation.defaultUpgradeHeadline.replace("{package}", primary);
+}
+export function composeSubheadline(bundle) {
+    const { profile } = bundle;
+    if (profile.degradedMessage)
+        return profile.degradedMessage;
+    return undefined;
+}
+export function composeKeyPoints(bundle, max) {
+    const { facts, profile } = bundle;
+    const points = [];
+    if (profile.priority === "limited") {
+        points.push(scanSurfaceCopy.presentation.limitedContextKeyPoint);
+        if (facts.changedPackages.primary) {
+            points.push(scanSurfaceCopy.presentation.changedPackageKeyPoint.replace("{package}", facts.changedPackages.primary));
+        }
+        return points.slice(0, max);
+    }
+    const usage = summarizePackageUsage(facts, { maxPaths: 2 });
+    if (usage && usage.pathCount > 0) {
+        if (usage.pathCount === 1 && usage.pathSamples[0]) {
+            points.push(scanSurfaceCopy.presentation.usedInPathsSingle.replace("{path}", usage.pathSamples[0]));
+        }
+        else {
+            points.push(scanSurfaceCopy.presentation.usedInPathsMultiple.replace("{count}", String(usage.pathCount)));
+        }
+    }
+    else if (profile.density === "minimal") {
+        points.push(scanSurfaceCopy.presentation.noRuntimePathsKeyPoint);
+    }
+    const blast = summarizeBlastRadius(facts, 2);
+    if (blast.levelLabel) {
+        if (blast.levelLabel.toLowerCase().includes("wide")) {
+            points.push(scanSurfaceCopy.presentation.blastRadiusWideKeyPoint);
+        }
+        else if (profile.density === "rich") {
+            points.push(scanSurfaceCopy.presentation.blastRadiusLevelKeyPoint.replace("{level}", blast.levelLabel));
+        }
+    }
+    if (facts.affectedAreas.length === 0 && profile.density === "minimal") {
+        points.push(scanSurfaceCopy.presentation.noAffectedAreasKeyPoint);
+    }
+    else 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 guidance = selectReviewerGuidance(facts, { scope: "changed", max: 2 });
+    for (const g of guidance) {
+        const msg = g.message.trim();
+        if (msg && !points.includes(msg))
+            points.push(msg);
+        if (points.length >= max)
+            break;
+    }
+    return points.slice(0, max);
+}
+export function composeVerificationActions(bundle, max) {
+    const { facts, profile } = bundle;
+    const actions = [];
+    const guidance = selectReviewerGuidance(facts, { scope: "changed", max: 4 });
+    for (const g of guidance) {
+        const rem = g.remediation?.trim();
+        if (rem)
+            actions.push(rem);
+    }
+    const prompt = composeVerificationPrompt(facts);
+    if (prompt && !actions.includes(prompt))
+        actions.push(prompt);
+    if (actions.length === 0) {
+        if (profile.density === "minimal" ||
+            facts.runtimeSurface?.kind === "build") {
+            actions.push(scanSurfaceCopy.presentation.verifyCiTypecheck);
+        }
+        else if (profile.density === "rich") {
+            actions.push(scanSurfaceCopy.presentation.verifyAuthFlow);
+            actions.push(scanSurfaceCopy.presentation.verifyErrorResponses);
+        }
+    }
+    return actions.slice(0, max);
+}
+export function composeAffectedAreaLabels(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;
+}
+export function composeEvidenceRows(bundle, max) {
+    const { facts } = bundle;
+    const rows = [];
+    const runtime = labelRuntimeSurface(facts);
+    if (runtime)
+        rows.push({ label: "Runtime", value: runtime });
+    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 });
+    const changed = formatChangedPackagesShort(facts, 3);
+    if (changed)
+        rows.push({ label: "Changed", value: changed });
+    return rows.slice(0, max);
+}
+export function composeSupportingContext(bundle) {
+    const { facts, profile, result } = bundle;
+    if (profile.density === "minimal")
+        return undefined;
+    const lines = [];
+    const graph = result.graphInsights;
+    if (graph?.maxDepth != null) {
+        lines.push(scanSurfaceCopy.presentation.graphDepthContext.replace("{depth}", String(graph.maxDepth)));
+    }
+    if (graph?.nodes != null && graph?.edges != null) {
+        lines.push(scanSurfaceCopy.presentation.graphSizeContext
+            .replace("{nodes}", String(graph.nodes))
+            .replace("{edges}", String(graph.edges)));
+    }
+    return lines.length > 0 ? lines.slice(0, 3) : undefined;
+}
+export function evidenceContextFromProfile(bundle) {
+    return {
+        priority: bundle.profile.priority,
+        degradedMessage: bundle.profile.degradedMessage,
+    };
+}

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

@@ -0,0 +1,53 @@
+import type { PresentationConfidence, PresentationDensity, PresentationEvidenceContext, PresentationStatus } from "./types.js";
+export type GitHubCheckRunPresentation = {
+    status: PresentationStatus;
+    density: PresentationDensity;
+    confidence: PresentationConfidence;
+    evidenceContext: PresentationEvidenceContext;
+    title: string;
+    conclusion: "success" | "neutral" | "failure";
+    summaryLead: string;
+    sections: Array<{
+        id: "why" | "actions" | "usage" | "repoContext" | "layers" | "footer";
+        title?: string;
+        bullets: string[];
+        collapsed?: boolean;
+    }>;
+    detailsUrl: string;
+};
+export type GitHubPrCommentPresentation = {
+    status: PresentationStatus;
+    density: PresentationDensity;
+    confidence: PresentationConfidence;
+    evidenceContext: PresentationEvidenceContext;
+    title: string;
+    introLines: string[];
+    guidanceBlocks: Array<{
+        message: string;
+        where?: string;
+        action?: string;
+    }>;
+};
+export type CliScanPresentation = {
+    header: {
+        repoLabel: string;
+        methodology?: string;
+        confidence?: string;
+    };
+    status: PresentationStatus;
+    density: PresentationDensity;
+    confidence: PresentationConfidence;
+    evidenceContext: PresentationEvidenceContext;
+    headline: string;
+    subheadline?: string;
+    keyPoints: string[];
+    verificationActions: string[];
+    metrics?: {
+        riskIndex: number;
+        layerLine: string;
+        findingCount: number;
+        recommendationCount: number;
+    };
+    supportingContext?: string[];
+};
+//# sourceMappingURL=githubAndCliPresentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"githubAndCliPresentation.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/githubAndCliPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,EAAE,sBAAsB,CAAC;IACnC,eAAe,EAAE,2BAA2B,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACtE,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,EAAE,sBAAsB,CAAC;IACnC,eAAe,EAAE,2BAA2B,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,KAAK,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,EAAE,sBAAsB,CAAC;IACnC,eAAe,EAAE,2BAA2B,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC"}

package/dist/presentation/dto/githubAndCliPresentation.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,25 @@
+import type { FindingCountSummary, PresentationConfidence, PresentationDensity, PresentationEvidenceContext, PresentationEvidenceRow, PresentationStatus } from "./types.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;
+};
+//# sourceMappingURL=scanCardPresentation.d.ts.map

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

@@ -0,0 +1 @@
+{"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;AAEpB,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;CACtB,CAAC"}

package/dist/presentation/dto/scanCardPresentation.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,111 @@
+import type { PresentationConfidence, PresentationDensity, PresentationEvidenceContext, PresentationStatus } from "./types.js";
+import type { FindingSeverity, ScoreLayer } from "../../types.js";
+export type ScanDetailsPresentation = {
+    evidenceContext: PresentationEvidenceContext;
+    status: PresentationStatus;
+    density: PresentationDensity;
+    confidence: PresentationConfidence;
+    hero: {
+        headline: string;
+        subheadline?: string;
+        verdictLine: string;
+        scopeChip?: string;
+        postureLabel: string;
+        riskIndex?: number | null;
+    };
+    narrative: {
+        keyPoints: string[];
+        changedPackages: string[];
+        primaryPackage?: string;
+    };
+    usage?: {
+        summary?: string;
+        items: Array<{
+            packageName: string;
+            paths: string[];
+            areas: string[];
+            criticalPaths?: string[];
+        }>;
+        frameworks: string[];
+    };
+    verification: {
+        actions: Array<{
+            title: string;
+            detail?: string;
+            affectedFiles?: string[];
+        }>;
+    };
+    signalSummary?: {
+        riskIndex: number;
+        band: "low" | "medium" | "high";
+        layers: Array<{
+            layer: ScoreLayer;
+            score: number;
+            band: string;
+            label: string;
+        }>;
+    };
+    operationalImpact: {
+        status: "rich" | "compact" | "hidden";
+        items: Array<{
+            message: string;
+            where?: string;
+            verify?: string;
+            affectedFiles?: string[];
+        }>;
+        fallbackMessage?: string;
+    };
+    recommendations: {
+        items: Array<{
+            rank: number;
+            title: string;
+            priority: "high" | "medium" | "low";
+            rationale?: string;
+        }>;
+    };
+    evidence: {
+        defaultCollapsed: boolean;
+        attentionAreas: Array<{
+            problemLabel: string;
+            problemDescription: string;
+            packages: Array<{
+                name: string;
+                version?: string;
+                direct: boolean;
+                severity?: FindingSeverity;
+                evidence?: string;
+            }>;
+            overflowCount: number;
+        }>;
+        findings: Array<{
+            id: string;
+            severity: FindingSeverity;
+            title: string;
+            description: string;
+            packageName: string;
+            recommendation?: string;
+            source: "dependency" | "code";
+        }>;
+        findingsOverflowCount: number;
+        topology?: {
+            summaryLine: string;
+            deepest: Array<{
+                packageName: string;
+                depth: number;
+                direct: boolean;
+                via: string[];
+            }>;
+        };
+    };
+    supportingContext?: {
+        title: string;
+        lines: string[];
+    };
+    metadata: {
+        scanId: string;
+        generatedAt?: string;
+        methodologyVersion?: string | null;
+        changedPackagesSummary?: string;
+    };
+};
+//# sourceMappingURL=scanDetailsPresentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanDetailsPresentation.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/scanDetailsPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAElE,MAAM,MAAM,uBAAuB,GAAG;IACpC,eAAe,EAAE,2BAA2B,CAAC;IAC7C,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,EAAE,sBAAsB,CAAC;IAEnC,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;IAEF,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC;YACX,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,EAAE,MAAM,EAAE,CAAC;YAChB,KAAK,EAAE,MAAM,EAAE,CAAC;YAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;SAC1B,CAAC,CAAC;QACH,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IAEF,YAAY,EAAE;QACZ,OAAO,EAAE,KAAK,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;SAC1B,CAAC,CAAC;KACJ,CAAC;IAEF,aAAa,CAAC,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QAChC,MAAM,EAAE,KAAK,CAAC;YACZ,KAAK,EAAE,UAAU,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;KACJ,CAAC;IAEF,iBAAiB,EAAE;QACjB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;QACtC,KAAK,EAAE,KAAK,CAAC;YACX,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;SAC1B,CAAC,CAAC;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF,eAAe,EAAE;QACf,KAAK,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;YACpC,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC;IAEF,QAAQ,EAAE;QACR,gBAAgB,EAAE,OAAO,CAAC;QAC1B,cAAc,EAAE,KAAK,CAAC;YACpB,YAAY,EAAE,MAAM,CAAC;YACrB,kBAAkB,EAAE,MAAM,CAAC;YAC3B,QAAQ,EAAE,KAAK,CAAC;gBACd,IAAI,EAAE,MAAM,CAAC;gBACb,OAAO,CAAC,EAAE,MAAM,CAAC;gBACjB,MAAM,EAAE,OAAO,CAAC;gBAChB,QAAQ,CAAC,EAAE,eAAe,CAAC;gBAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;aACnB,CAAC,CAAC;YACH,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC,CAAC;QACH,QAAQ,EAAE,KAAK,CAAC;YACd,EAAE,EAAE,MAAM,CAAC;YACX,QAAQ,EAAE,eAAe,CAAC;YAC1B,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,cAAc,CAAC,EAAE,MAAM,CAAC;YACxB,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC;SAC/B,CAAC,CAAC;QACH,qBAAqB,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,EAAE;YACT,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE,KAAK,CAAC;gBACb,WAAW,EAAE,MAAM,CAAC;gBACpB,KAAK,EAAE,MAAM,CAAC;gBACd,MAAM,EAAE,OAAO,CAAC;gBAChB,GAAG,EAAE,MAAM,EAAE,CAAC;aACf,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;IAEF,iBAAiB,CAAC,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IAEF,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH,CAAC"}

package/dist/presentation/dto/scanDetailsPresentation.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,24 @@
+export type PipelineStatus = "queued" | "running" | "done" | "failed";
+export type PresentationStatus = "safe" | "needs_review" | "risky";
+export type PresentationDensity = "minimal" | "standard" | "rich";
+export type PresentationConfidence = "high" | "medium" | "low";
+export type PresentationPriority = "pr_intelligence" | "limited";
+export type PresentationEvidenceRow = {
+    label: string;
+    value: string;
+};
+/** User-facing evidence summary - mirrors profile.priority */
+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

@@ -0,0 +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"}

package/dist/presentation/dto/types.js

@@ -0,0 +1,22 @@
+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;
+}

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

@@ -0,0 +1,5 @@
+import type { ScanResult } from "../../types.js";
+export declare const scanResultFastifyRuntime: ScanResult;
+export declare const scanResultTypescriptPatch: ScanResult;
+export declare const scanResultLimitedContext: ScanResult;
+//# sourceMappingURL=scanResultFixtures.d.ts.map

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

@@ -0,0 +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"}

package/dist/presentation/fixtures/scanResultFixtures.js

@@ -0,0 +1,83 @@
+import { fixtureRepoIntelligenceFastify, fixtureRepoIntelligenceTypescript, } from "../../fixtures/repoIntelligenceFixtures.js";
+import { analysisPreparationWithValidRepoIntel } from "../../fixtures/repoIntelligenceTestHelpers.js";
+export const scanResultFastifyRuntime = {
+    totalScore: 55,
+    layerScores: {
+        security: 10,
+        maintainability: 20,
+        ecosystem: 30,
+        upgradeImpact: 15,
+    },
+    findings: [],
+    generatedAt: "2026-01-01T00:00:00.000Z",
+    changedPackages: ["fastify"],
+    analysisPreparation: analysisPreparationWithValidRepoIntel(),
+    repoIntelligence: fixtureRepoIntelligenceFastify,
+    decision: {
+        recommendation: "needs_review",
+        confidence: "medium",
+        reasoning: [],
+    },
+    insights: [
+        {
+            type: "usage_risk",
+            priority: "high",
+            confidence: "confirmed",
+            scope: "changed",
+            message: "Review fastify middleware ordering",
+            context: "apps/api/src/middleware/auth.ts",
+            remediation: "Run auth smoke tests",
+        },
+    ],
+};
+export const scanResultTypescriptPatch = {
+    totalScore: 18,
+    layerScores: {
+        security: 5,
+        maintainability: 8,
+        ecosystem: 10,
+        upgradeImpact: 5,
+    },
+    findings: [],
+    generatedAt: "2026-01-01T00:00:00.000Z",
+    changedPackages: ["typescript"],
+    analysisPreparation: analysisPreparationWithValidRepoIntel(),
+    repoIntelligence: fixtureRepoIntelligenceTypescript,
+    decision: {
+        recommendation: "safe",
+        confidence: "high",
+        reasoning: [],
+    },
+    graphInsights: {
+        maxDepth: 4,
+        nodes: 120,
+        edges: 340,
+        hotspots: [],
+    },
+};
+export const scanResultLimitedContext = {
+    totalScore: 40,
+    layerScores: {
+        security: 10,
+        maintainability: 10,
+        ecosystem: 10,
+        upgradeImpact: 10,
+    },
+    findings: [],
+    generatedAt: "2026-01-01T00:00:00.000Z",
+    changedPackages: ["lodash"],
+    repoIntelligence: { invalid: true },
+    graphInsights: {
+        maxDepth: 5,
+        nodes: 200,
+        edges: 500,
+        hotspots: [
+            { kind: "hotspot", packageName: "lodash", direct: true, depth: 2 },
+        ],
+    },
+    decision: {
+        recommendation: "needs_review",
+        confidence: "low",
+        reasoning: [],
+    },
+};