@mergesignal/shared 0.3.0 → 0.4.1

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

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

package/dist/presentation/presenters/presentCliScanSummary.js

@@ -0,0 +1,30 @@
+import { composeHeadline, composeKeyPoints, composeSubheadline, composeSupportingContext, composeVerificationActions, evidenceContextFromProfile, } from "../compose/narrativeCompose.js";
+export function presentCliScanSummary(bundle, ctx = {}) {
+    const { facts, profile, result } = bundle;
+    const layers = result.layerScores;
+    const layerLine = layers
+        ? `security=${layers.security} maintainability=${layers.maintainability} ecosystem=${layers.ecosystem} upgradeImpact=${layers.upgradeImpact}`
+        : "";
+    return {
+        header: {
+            repoLabel: ctx.repoLabel ?? "scan",
+            methodology: result.methodologyVersion ?? undefined,
+            confidence: profile.confidence,
+        },
+        status: profile.status,
+        density: profile.density,
+        confidence: profile.confidence,
+        evidenceContext: evidenceContextFromProfile(bundle),
+        headline: composeHeadline(bundle),
+        subheadline: composeSubheadline(bundle),
+        keyPoints: composeKeyPoints(bundle, 6),
+        verificationActions: composeVerificationActions(bundle, 5),
+        metrics: {
+            riskIndex: facts.riskIndex ?? result.totalScore ?? 0,
+            layerLine,
+            findingCount: result.findings?.length ?? 0,
+            recommendationCount: result.recommendations?.length ?? 0,
+        },
+        supportingContext: composeSupportingContext(bundle),
+    };
+}

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

@@ -0,0 +1,8 @@
+import type { GitHubCheckRunPresentation } from "../dto/githubAndCliPresentation.js";
+import type { ScanPresentationBundle } from "../orchestration/scanPresentationBundle.js";
+export declare function presentGitHubCheckRun(bundle: ScanPresentationBundle, ctx: {
+    scanId: string;
+    webAppOrigin: string;
+    baseline?: boolean;
+}): GitHubCheckRunPresentation;
+//# sourceMappingURL=presentGitHubCheckRun.d.ts.map

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

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

package/dist/presentation/presenters/presentGitHubCheckRun.js

@@ -0,0 +1,32 @@
+import { composeHeadline, composeKeyPoints, composeSubheadline, composeVerificationActions, evidenceContextFromProfile, } from "../compose/narrativeCompose.js";
+export function presentGitHubCheckRun(bundle, ctx) {
+    const { profile } = bundle;
+    const headline = composeHeadline(bundle);
+    const keyPoints = composeKeyPoints(bundle, 3);
+    const actions = composeVerificationActions(bundle, 3);
+    const detailsUrl = `${ctx.webAppOrigin.replace(/\/$/, "")}/scan/${ctx.scanId}`;
+    const conclusion = profile.status === "safe"
+        ? "success"
+        : profile.status === "risky"
+            ? "failure"
+            : "neutral";
+    const sections = [];
+    if (keyPoints.length > 0) {
+        sections.push({ id: "why", title: "Why", bullets: keyPoints });
+    }
+    if (actions.length > 0) {
+        sections.push({ id: "actions", title: "What to verify", bullets: actions });
+    }
+    sections.push({ id: "footer", bullets: [`Full scan: ${detailsUrl}`] });
+    return {
+        status: profile.status,
+        density: profile.density,
+        confidence: profile.confidence,
+        evidenceContext: evidenceContextFromProfile(bundle),
+        title: headline,
+        conclusion,
+        summaryLead: composeSubheadline(bundle) ?? headline,
+        sections,
+        detailsUrl,
+    };
+}

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

@@ -0,0 +1,4 @@
+import type { GitHubPrCommentPresentation } from "../dto/githubAndCliPresentation.js";
+import type { ScanPresentationBundle } from "../orchestration/scanPresentationBundle.js";
+export declare function presentGitHubPrComment(bundle: ScanPresentationBundle): GitHubPrCommentPresentation;
+//# sourceMappingURL=presentGitHubPrComment.d.ts.map

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

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

package/dist/presentation/presenters/presentGitHubPrComment.js

@@ -0,0 +1,40 @@
+import { MERGE_POSTURE_LABEL } from "../../riskVocabulary.js";
+import { composeVerificationActions, evidenceContextFromProfile, } from "../compose/narrativeCompose.js";
+import { formatChangedPackagesShort, formatUsageSummaryLine, selectReviewerGuidance, } from "../../narrativePresentation.js";
+export function presentGitHubPrComment(bundle) {
+    const { facts, profile } = bundle;
+    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 = composeVerificationActions(bundle, 1)[0];
+    if (verify)
+        introLines.push(`Verify: ${verify}`);
+    const guidance = selectReviewerGuidance(facts, { scope: "changed", max: 3 });
+    const selected = guidance.length === 0
+        ? selectReviewerGuidance(facts, { max: 3 })
+        : guidance;
+    const guidanceBlocks = selected.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() ||
+            composeVerificationActions(bundle, 1)[0] ||
+            "Review before merge.";
+        return { message: g.message, where, action };
+    });
+    return {
+        status: profile.status,
+        density: profile.density,
+        confidence: profile.confidence,
+        evidenceContext: evidenceContextFromProfile(bundle),
+        title: MERGE_POSTURE_LABEL[profile.status],
+        introLines,
+        guidanceBlocks,
+    };
+}

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

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

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

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

package/dist/presentation/presenters/presentPipelineScanCard.js

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

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

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

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

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

package/dist/presentation/presenters/presentScanCard.js

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

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

@@ -0,0 +1,9 @@
+import type { ScanDetailsPresentation } from "../dto/scanDetailsPresentation.js";
+import type { ScanPresentationBundle } from "../orchestration/scanPresentationBundle.js";
+export type PresentScanDetailsContext = {
+    scanId: string;
+    methodologyVersion?: string | null;
+    prNumber?: number | null;
+};
+export declare function presentScanDetails(bundle: ScanPresentationBundle, ctx: PresentScanDetailsContext): ScanDetailsPresentation;
+//# sourceMappingURL=presentScanDetails.d.ts.map

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

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

package/dist/presentation/presenters/presentScanDetails.js

@@ -0,0 +1,177 @@
+import { deriveDetailReachChip } from "../../formatCardExposureDisplay.js";
+import { MERGE_POSTURE_LABEL } from "../../riskVocabulary.js";
+import { deriveVerdictLineFromFacts, presentScanDetailViewModel, } from "../../scanDetailViewModel.js";
+import { composeHeadline, composeKeyPoints, composeSubheadline, composeSupportingContext, composeVerificationActions, evidenceContextFromProfile, } from "../compose/narrativeCompose.js";
+import { normalizeGeneratedText, normalizeGeneratedTextNullable, } from "../../normalizeGeneratedText.js";
+import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
+function mapOperationalImpact(vm) {
+    const oi = vm.operationalImpact;
+    if (oi.status === "hidden") {
+        return { status: "hidden", items: [] };
+    }
+    if (oi.status === "rich") {
+        return {
+            status: "rich",
+            items: oi.items.map((item) => ({
+                message: item.message,
+                where: item.where,
+                verify: item.verify,
+                affectedFiles: item.affectedFiles,
+            })),
+        };
+    }
+    return {
+        status: "compact",
+        items: oi.items,
+        fallbackMessage: oi.fallbackMessage,
+    };
+}
+function mapRecommendations(vm) {
+    const items = vm.recommendedActions.items.map((item) => ({
+        rank: item.rank,
+        title: item.title,
+        priority: item.priority === "high" ||
+            item.priority === "medium" ||
+            item.priority === "low"
+            ? item.priority
+            : "medium",
+        rationale: item.detail?.why,
+    }));
+    return { items };
+}
+function mapEvidence(bundle, vm) {
+    const defaultCollapsed = bundle.profile.priority === "pr_intelligence" &&
+        bundle.profile.density === "rich";
+    const ev = vm.evidence;
+    if (!ev) {
+        return {
+            defaultCollapsed,
+            attentionAreas: [],
+            findings: [],
+            findingsOverflowCount: 0,
+        };
+    }
+    return {
+        defaultCollapsed,
+        attentionAreas: ev.attentionAreas.map((area) => ({
+            problemLabel: area.problemLabel,
+            problemDescription: area.problemDescription,
+            packages: area.packages.map((p) => ({
+                name: p.name,
+                version: p.version,
+                direct: p.direct,
+                severity: p.severity,
+                evidence: p.evidence,
+            })),
+            overflowCount: area.overflowCount,
+        })),
+        findings: ev.findings.map((f) => ({
+            id: f.id,
+            severity: f.severity,
+            title: f.title,
+            description: f.description,
+            packageName: f.packageName,
+            recommendation: f.recommendation,
+            source: f.source,
+        })),
+        findingsOverflowCount: ev.findingsOverflowCount,
+        topology: ev.topology
+            ? {
+                summaryLine: ev.topology.summaryLine,
+                deepest: ev.topology.deepest,
+            }
+            : undefined,
+    };
+}
+function mapUsage(bundle) {
+    const { facts } = bundle;
+    if (facts.packageUsage.length === 0 && facts.frameworks.length === 0) {
+        return undefined;
+    }
+    return {
+        summary: facts.packageUsage[0]
+            ? `${facts.packageUsage.length} package(s) with usage data`
+            : undefined,
+        items: facts.packageUsage.map((row) => ({
+            packageName: row.packageName,
+            paths: row.paths,
+            areas: row.areas,
+            criticalPaths: row.criticalPaths,
+        })),
+        frameworks: facts.frameworks,
+    };
+}
+export function presentScanDetails(bundle, ctx) {
+    const { facts, profile, result } = bundle;
+    const vm = presentScanDetailViewModel(facts, result, {
+        scanId: ctx.scanId,
+        status: "done",
+        methodologyVersion: ctx.methodologyVersion,
+        prNumber: ctx.prNumber,
+        repoContext: { status: "hidden" },
+    });
+    const headline = composeHeadline(bundle);
+    const subheadline = composeSubheadline(bundle);
+    const keyPoints = composeKeyPoints(bundle, 6);
+    const verificationTitles = composeVerificationActions(bundle, 6);
+    const supportingLines = composeSupportingContext(bundle);
+    const supportingContext = supportingLines
+        ? {
+            title: scanSurfaceCopy.scanDetail.topologyCollapsedHint,
+            lines: supportingLines,
+        }
+        : undefined;
+    const posture = profile.status;
+    const postureLabel = MERGE_POSTURE_LABEL[posture];
+    return {
+        evidenceContext: evidenceContextFromProfile(bundle),
+        status: profile.status,
+        density: profile.density,
+        confidence: profile.confidence,
+        hero: {
+            headline: normalizeGeneratedText(headline),
+            subheadline: normalizeGeneratedTextNullable(subheadline) ?? undefined,
+            verdictLine: deriveVerdictLineFromFacts(facts, result),
+            scopeChip: deriveDetailReachChip(result.totalScore) ?? undefined,
+            postureLabel,
+            riskIndex: facts.riskIndex,
+        },
+        narrative: {
+            keyPoints: keyPoints.map((k) => normalizeGeneratedText(k)),
+            changedPackages: facts.changedPackages.all,
+            primaryPackage: facts.changedPackages.primary ?? undefined,
+        },
+        usage: mapUsage(bundle),
+        verification: {
+            actions: verificationTitles.map((title) => ({
+                title: normalizeGeneratedText(title),
+            })),
+        },
+        signalSummary: vm.signalSummary
+            ? {
+                riskIndex: vm.signalSummary.score,
+                band: vm.signalSummary.overallBand === "moderate"
+                    ? "medium"
+                    : vm.signalSummary.overallBand === "high"
+                        ? "high"
+                        : "low",
+                layers: vm.signalSummary.layers.map((l) => ({
+                    layer: l.layer,
+                    score: l.score,
+                    band: l.concernLabel,
+                    label: l.label,
+                })),
+            }
+            : undefined,
+        operationalImpact: mapOperationalImpact(vm),
+        recommendations: mapRecommendations(vm),
+        evidence: mapEvidence(bundle, vm),
+        supportingContext,
+        metadata: {
+            scanId: ctx.scanId,
+            generatedAt: result.generatedAt,
+            methodologyVersion: ctx.methodologyVersion,
+            changedPackagesSummary: facts.changedPackages.primary ?? facts.changedPackages.all.join(", "),
+        },
+    };
+}

package/dist/presentation/profile/derivePresentationProfile.d.ts

@@ -0,0 +1,12 @@
+import type { ScanNarrativeFacts } from "../../scanNarrativeFacts.js";
+import type { PipelineStatus } from "../dto/types.js";
+import type { PresentationProfile } from "./presentationProfile.js";
+type DerivePresentationProfileContext = {
+    pipelineStatus: PipelineStatus;
+    decision?: string | null;
+    totalScore?: number | null;
+};
+/** INTERNAL - only called from buildScanPresentationBundle */
+export declare function derivePresentationProfile(facts: ScanNarrativeFacts, ctx: DerivePresentationProfileContext): PresentationProfile | null;
+export {};
+//# sourceMappingURL=derivePresentationProfile.d.ts.map

package/dist/presentation/profile/derivePresentationProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivePresentationProfile.d.ts","sourceRoot":"","sources":["../../../src/presentation/profile/derivePresentationProfile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,KAAK,gCAAgC,GAAG;IACtC,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAyGF,8DAA8D;AAC9D,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,gCAAgC,GACpC,mBAAmB,GAAG,IAAI,CAsB5B"}

package/dist/presentation/profile/derivePresentationProfile.js

@@ -0,0 +1,94 @@
+import { mergePostureFromDecision } from "../../riskVocabulary.js";
+import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
+function statusFromScore(totalScore) {
+    if (totalScore == null || !Number.isFinite(totalScore))
+        return "needs_review";
+    if (totalScore <= 30)
+        return "safe";
+    if (totalScore <= 60)
+        return "needs_review";
+    return "risky";
+}
+function resolveStatus(facts, ctx) {
+    const fromFacts = facts.mergePosture;
+    if (fromFacts)
+        return fromFacts;
+    const fromDecision = mergePostureFromDecision(ctx.decision ?? undefined);
+    if (fromDecision)
+        return fromDecision;
+    return statusFromScore(ctx.totalScore ?? facts.riskIndex);
+}
+function hasStrongPrIntelligence(facts) {
+    return (facts.availability.tiersPresent.tier1 &&
+        facts.availability.repoIntelligenceParse === "ok");
+}
+function hasHighSeverityFindings(facts) {
+    return facts.reviewerGuidance.some((g) => g.kind === "finding" &&
+        (g.priority === "critical" || g.priority === "high"));
+}
+function hasRuntimeUsage(facts) {
+    if (facts.runtimeSurface?.kind === "runtime")
+        return true;
+    return facts.packageUsage.some((u) => u.paths.length > 0 || u.criticalPaths.length > 0);
+}
+function deriveDensity(facts, priority) {
+    if (priority === "limited") {
+        return hasHighSeverityFindings(facts) ? "standard" : "minimal";
+    }
+    const semantics = facts.packageSemantics;
+    const runtime = facts.runtimeSurface?.kind === "runtime" ||
+        semantics?.runtimeImpact === "confirmed";
+    const wideOrModerate = facts.blastRadius?.level === "wide" ||
+        facts.blastRadius?.level === "moderate";
+    const hasAreas = facts.affectedAreas.length > 0;
+    const hasRuntimePaths = hasRuntimeUsage(facts);
+    if (runtime && (wideOrModerate || hasAreas || hasRuntimePaths)) {
+        return "rich";
+    }
+    const toolingImpact = semantics?.expectedImpact === "typecheck" ||
+        semantics?.expectedImpact === "development_only" ||
+        semantics?.expectedImpact === "test_time" ||
+        semantics?.expectedImpact === "build_time";
+    const buildOnly = semantics?.suppressRuntimeNarrative === true ||
+        toolingImpact ||
+        facts.runtimeSurface?.kind === "build" ||
+        facts.reachability?.kind === "build_only";
+    const narrowBlast = !facts.blastRadius || facts.blastRadius.level === "narrow";
+    if (buildOnly && narrowBlast && !hasAreas) {
+        return "minimal";
+    }
+    return "standard";
+}
+function deriveConfidence(facts, priority) {
+    if (priority === "limited")
+        return "low";
+    const decisionConf = facts.confidence.decision;
+    if (decisionConf === "high" || decisionConf === "medium")
+        return "high";
+    const sparseUsage = facts.packageUsage.length === 0 ||
+        facts.packageUsage.every((u) => u.paths.length === 0 && u.criticalPaths.length === 0);
+    if (sparseUsage)
+        return "medium";
+    return "high";
+}
+/** INTERNAL - only called from buildScanPresentationBundle */
+export function derivePresentationProfile(facts, ctx) {
+    if (ctx.pipelineStatus !== "done")
+        return null;
+    const priority = hasStrongPrIntelligence(facts)
+        ? "pr_intelligence"
+        : "limited";
+    const status = resolveStatus(facts, ctx);
+    const density = deriveDensity(facts, priority);
+    const confidence = deriveConfidence(facts, priority);
+    const degradedMessage = priority === "limited"
+        ? scanSurfaceCopy.presentation.limitedContextMessage
+        : undefined;
+    return {
+        status,
+        density,
+        confidence,
+        priority,
+        degradedMessage,
+    };
+}

package/dist/presentation/profile/presentationProfile.d.ts

@@ -0,0 +1,9 @@
+import type { PresentationConfidence, PresentationDensity, PresentationPriority, PresentationStatus } from "../dto/types.js";
+export type PresentationProfile = {
+    status: PresentationStatus;
+    density: PresentationDensity;
+    confidence: PresentationConfidence;
+    priority: PresentationPriority;
+    degradedMessage?: string;
+};
+//# sourceMappingURL=presentationProfile.d.ts.map

package/dist/presentation/profile/presentationProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentationProfile.d.ts","sourceRoot":"","sources":["../../../src/presentation/profile/presentationProfile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,EAAE,sBAAsB,CAAC;IACnC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC"}

package/dist/presentation/profile/presentationProfile.js

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

package/dist/presentation/render/renderCliScanSummaryText.d.ts

@@ -0,0 +1,3 @@
+import type { CliScanPresentation } from "../dto/githubAndCliPresentation.js";
+export declare function renderCliScanSummaryText(p: CliScanPresentation): string;
+//# sourceMappingURL=renderCliScanSummaryText.d.ts.map

package/dist/presentation/render/renderCliScanSummaryText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderCliScanSummaryText.d.ts","sourceRoot":"","sources":["../../../src/presentation/render/renderCliScanSummaryText.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CA+BvE"}

package/dist/presentation/render/renderCliScanSummaryText.js

@@ -0,0 +1,30 @@
+import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
+export function renderCliScanSummaryText(p) {
+    const lines = [
+        `MergeSignal - ${p.header.repoLabel}`,
+        "",
+        p.headline,
+    ];
+    if (p.subheadline)
+        lines.push(p.subheadline);
+    lines.push("", `Status: ${p.status} | Density: ${p.density} | Confidence: ${p.confidence}`);
+    if (p.metrics) {
+        lines.push(`Risk index: ${p.metrics.riskIndex} (${scanSurfaceCopy.actions.riskIndexDirectionShort})`, p.metrics.layerLine, `Findings: ${p.metrics.findingCount} | Recommendations: ${p.metrics.recommendationCount}`);
+    }
+    if (p.keyPoints.length > 0) {
+        lines.push("", "Key points:");
+        for (const point of p.keyPoints)
+            lines.push(`  - ${point}`);
+    }
+    if (p.verificationActions.length > 0) {
+        lines.push("", "Verify:");
+        for (const action of p.verificationActions)
+            lines.push(`  - ${action}`);
+    }
+    if (p.supportingContext?.length) {
+        lines.push("", "Supporting context:");
+        for (const line of p.supportingContext)
+            lines.push(`  - ${line}`);
+    }
+    return lines.join("\n");
+}

package/dist/presentation/render/renderGitHubCheckRunMarkdown.d.ts

@@ -0,0 +1,3 @@
+import type { GitHubCheckRunPresentation } from "../dto/githubAndCliPresentation.js";
+export declare function renderGitHubCheckRunMarkdown(p: GitHubCheckRunPresentation): string;
+//# sourceMappingURL=renderGitHubCheckRunMarkdown.d.ts.map

package/dist/presentation/render/renderGitHubCheckRunMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderGitHubCheckRunMarkdown.d.ts","sourceRoot":"","sources":["../../../src/presentation/render/renderGitHubCheckRunMarkdown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAErF,wBAAgB,4BAA4B,CAC1C,CAAC,EAAE,0BAA0B,GAC5B,MAAM,CAuBR"}

package/dist/presentation/render/renderGitHubCheckRunMarkdown.js

@@ -0,0 +1,23 @@
+import { normalizeGeneratedText } from "../../normalizeGeneratedText.js";
+export function renderGitHubCheckRunMarkdown(p) {
+    const parts = [
+        `**${normalizeGeneratedText(p.title)}**`,
+        "",
+        p.summaryLead,
+        "",
+    ];
+    for (const section of p.sections) {
+        if (section.id === "footer") {
+            parts.push(section.bullets.join("\n"));
+            continue;
+        }
+        if (section.title) {
+            parts.push(`### ${section.title}`, "");
+        }
+        for (const bullet of section.bullets) {
+            parts.push(`- ${normalizeGeneratedText(bullet)}`);
+        }
+        parts.push("");
+    }
+    return parts.join("\n").trimEnd();
+}

package/dist/presentation/render/renderGitHubPrCommentMarkdown.d.ts

@@ -0,0 +1,3 @@
+import type { GitHubPrCommentPresentation } from "../dto/githubAndCliPresentation.js";
+export declare function renderGitHubPrCommentMarkdown(p: GitHubPrCommentPresentation): string;
+//# sourceMappingURL=renderGitHubPrCommentMarkdown.d.ts.map

package/dist/presentation/render/renderGitHubPrCommentMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderGitHubPrCommentMarkdown.d.ts","sourceRoot":"","sources":["../../../src/presentation/render/renderGitHubPrCommentMarkdown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAoBtF,wBAAgB,6BAA6B,CAC3C,CAAC,EAAE,2BAA2B,GAC7B,MAAM,CAmBR"}

package/dist/presentation/render/renderGitHubPrCommentMarkdown.js

@@ -0,0 +1,24 @@
+import { normalizeGeneratedText } from "../../normalizeGeneratedText.js";
+function renderGuidanceBlock(message, where, action) {
+    return [
+        normalizeGeneratedText(message),
+        "",
+        "**Where it shows up**",
+        "",
+        normalizeGeneratedText(where),
+        "",
+        "**What to do**",
+        "",
+        normalizeGeneratedText(action),
+    ].join("\n");
+}
+export function renderGitHubPrCommentMarkdown(p) {
+    const parts = [`**${normalizeGeneratedText(p.title)}**`];
+    if (p.introLines.length > 0) {
+        parts.push("", p.introLines.map((l) => normalizeGeneratedText(l)).join("\n"));
+    }
+    for (const block of p.guidanceBlocks) {
+        parts.push("", renderGuidanceBlock(block.message, block.where ?? "See scan detail.", block.action ?? "Review before merge."));
+    }
+    return parts.join("\n\n---\n\n").trimEnd();
+}