@mergesignal/shared 0.3.0 → 0.4.0

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;AA+FF,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,86 @@
+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 runtime = facts.runtimeSurface?.kind === "runtime";
+    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 buildOnly = 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();
+}

package/dist/scanCardSummary.d.ts

@@ -1,6 +1,4 @@
-import type { CatalogPhrase } from "./cardObservationCatalog.js";
-import type { NarrativeAvailabilityMode } from "./scanNarrativeFacts.js";
-import { type MergePosture } from "./riskVocabulary.js";
+import type { ScanCardPresentation } from "./presentation/dto/scanCardPresentation.js";
 import type { Finding, ScanResult } from "./types.js";
 export type ScanPipelineStatus = "queued" | "running" | "done" | "failed";
 export type ScanCardPresentationState = "not_scanned" | "scanning" | "analysis_failed" | "ready" | "stale";
@@ -11,38 +9,9 @@ export type FindingCountSummary = {
     medium: number;
     low: number;
 };
-export type ScanCardSummary = {
-    mergePosture: MergePosture | null;
-    riskIndex: number | null;
-    riskIndexBand: RiskIndexBand | null;
-    headline: string;
-    /** @deprecated Use operationalObservations */
-    summaryLine: string | null;
-    findingCounts: FindingCountSummary | null;
-    /** @deprecated Use affectedAreas */
-    topAffectedAreas: string[];
-    /** Catalog-mapped topology observations (0–3). Tier 3 repo context — legacy wire field. */
-    operationalObservations: CatalogPhrase[];
-    /** Optional quiet subline when exactly one observation is shown. */
-    supportingLine: string | null;
-    narrativeMode: NarrativeAvailabilityMode;
-    codeIntelligenceAvailable: boolean;
-    changedPackagesDisplay: string | null;
-    runtimeSurfaceLabel: string | null;
-    reachabilityLabel: string | null;
-    blastRadiusLabel: string | null;
-    affectedAreas: string[];
-    primaryInsight: string | null;
-    structuralOnlyDisclaimer: string | null;
-    /** One-line usage hint from packageUsage paths or areas. */
-    usageSummary: string | null;
-    /** Single verification prompt from changed-scope guidance or usage. */
-    verificationLine: string | null;
-    /** Optional blast factor subline when factors exist. */
-    blastRadiusDetail: string | null;
-    /** Short framework list (max 2 on card). */
-    frameworksSummary: string | null;
-};
+/** @deprecated Use ScanCardPresentation */
+export type ScanCardSummary = ScanCardPresentation;
+export { ScanCardPresentation };
 export declare const SCAN_CARD_SCANNING_SUMMARY = "Waiting for results...";
 export type PipelineCompletionEvidence = {
     scannedAt?: string | null;

package/dist/scanCardSummary.d.ts.map

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