@mergesignal/shared 0.4.3 → 0.6.0

package/dist/presentation/intent/derivePresentationInterpretation.js

@@ -1,202 +0,0 @@
-import { formatCardAreaLabels } from "../../formatCardAreaLabels.js";
-import { mergeVerificationFocusLabels } from "./verificationFocusLabels.js";
-const TOOLING_CLASSES = new Set([
-    "tooling",
-    "test",
-    "lint",
-    "format",
-    "build",
-    "ci",
-]);
-const RUNTIME_IMPACT_RANK = {
-    confirmed: 3,
-    possible: 2,
-    unknown: 1,
-    none: 0,
-};
-const EVIDENCE_RANK = {
-    high: 3,
-    medium: 2,
-    low: 1,
-};
-function isRuntimeEligible(row) {
-    if (row.suppressRuntimeNarrative)
-        return false;
-    if (row.runtimeImpact === "confirmed" || row.runtimeImpact === "possible") {
-        return true;
-    }
-    if (row.dependencyClass === "runtime")
-        return true;
-    if (row.usagePathCount > 0)
-        return true;
-    return false;
-}
-function isToolingOriented(row) {
-    if (row.suppressRuntimeNarrative)
-        return true;
-    if (row.dependencyClass && TOOLING_CLASSES.has(row.dependencyClass)) {
-        return true;
-    }
-    return false;
-}
-function compareRuntimePackages(a, b, order) {
-    const impactA = RUNTIME_IMPACT_RANK[a.runtimeImpact ?? "none"] ?? 0;
-    const impactB = RUNTIME_IMPACT_RANK[b.runtimeImpact ?? "none"] ?? 0;
-    if (impactB !== impactA)
-        return impactB - impactA;
-    const evA = EVIDENCE_RANK[a.evidenceStrength ?? "low"] ?? 0;
-    const evB = EVIDENCE_RANK[b.evidenceStrength ?? "low"] ?? 0;
-    if (evB !== evA)
-        return evB - evA;
-    return order.indexOf(a.packageName) - order.indexOf(b.packageName);
-}
-function pickAnchorPackage(rows, changedOrder) {
-    if (rows.length === 0)
-        return null;
-    const sorted = [...rows].sort((a, b) => compareRuntimePackages(a, b, changedOrder));
-    return sorted[0]?.packageName ?? null;
-}
-function pickToolingAnchor(rows, changedOrder) {
-    if (rows.length === 0)
-        return null;
-    const sorted = [...rows].sort((a, b) => changedOrder.indexOf(a.packageName) - changedOrder.indexOf(b.packageName));
-    return sorted[0]?.packageName ?? null;
-}
-function isToolingPatchSet(rows, facts) {
-    if (rows.length === 0)
-        return false;
-    const narrow = !facts.blastRadius || facts.blastRadius.level === "narrow";
-    if (!narrow)
-        return false;
-    return rows.every((row) => row.suppressRuntimeNarrative &&
-        (row.expectedImpact === "typecheck" ||
-            row.expectedImpact === "build_time"));
-}
-function runtimeSurfaceLabelFromFacts(facts, anchorRow) {
-    const area = facts.affectedAreas[0];
-    if (area) {
-        const formatted = formatCardAreaLabels([area.label], 1);
-        return formatted[0] ?? area.label;
-    }
-    if (anchorRow?.packageRole === "http_framework") {
-        return "API request handling";
-    }
-    if (anchorRow?.packageRole === "auth") {
-        return "authentication flows";
-    }
-    if (anchorRow?.packageRole === "queue") {
-        return "background job processing";
-    }
-    return "application code";
-}
-function collectVerificationLabels(rows) {
-    return mergeVerificationFocusLabels(rows.map((r) => r.verificationFocus));
-}
-function showLimitedEvidence(rows) {
-    return rows.some((r) => r.evidenceStrength === "low");
-}
-function dominantExpectedImpact(rows) {
-    for (const row of rows) {
-        if (row.expectedImpact && row.expectedImpact !== "unknown") {
-            return row.expectedImpact;
-        }
-    }
-    return null;
-}
-function emptyInterpretation(intent) {
-    return {
-        intent,
-        anchorPackage: null,
-        suppressRuntimeNarrative: intent.startsWith("tooling"),
-        allowRuntimeNarrative: intent.includes("runtime"),
-        showLimitedEvidence: false,
-        expectedImpactKey: null,
-        verificationLabels: [],
-        runtimeSurfaceLabel: null,
-        runtimePackages: [],
-    };
-}
-export function derivePresentationInterpretation(facts) {
-    const changedOrder = facts.changedPackages.all;
-    const semantics = facts.changedPackageSemantics.length > 0
-        ? facts.changedPackageSemantics
-        : facts.packageSemantics && facts.changedPackages.primary
-            ? [
-                {
-                    packageName: facts.changedPackages.primary,
-                    dependencyClass: facts.packageSemantics.dependencyClass,
-                    packageRole: facts.packageSemantics.packageRole,
-                    runtimeImpact: facts.packageSemantics.runtimeImpact,
-                    expectedImpact: facts.packageSemantics.expectedImpact,
-                    suppressRuntimeNarrative: facts.packageSemantics.suppressRuntimeNarrative,
-                    evidenceStrength: facts.packageSemantics.evidenceStrength,
-                    verificationFocus: facts.packageSemantics.verificationFocus,
-                    usagePathCount: 0,
-                    usageAreaCount: 0,
-                },
-            ]
-            : [];
-    const tier1Ok = facts.availability.tiersPresent.tier1 &&
-        facts.availability.repoIntelligenceParse === "ok";
-    if (!tier1Ok) {
-        return emptyInterpretation("limited_context");
-    }
-    if (!facts.changedPackages.primary) {
-        return emptyInterpretation("no_changed_packages");
-    }
-    const runtimeEligible = semantics.filter(isRuntimeEligible);
-    if (runtimeEligible.length > 0) {
-        const anchorPackage = pickAnchorPackage(runtimeEligible, changedOrder);
-        const anchorRow = runtimeEligible.find((r) => r.packageName === anchorPackage);
-        const runtimeSurfaceLabel = runtimeSurfaceLabelFromFacts(facts, anchorRow);
-        const verificationLabels = collectVerificationLabels(runtimeEligible);
-        let intent = "runtime_upgrade";
-        if (runtimeEligible.length > 1) {
-            intent = "multi_runtime_upgrade";
-        }
-        else if (runtimeEligible.some((r) => r.packageRole === "auth")) {
-            intent = "auth_runtime_upgrade";
-        }
-        else if (runtimeEligible.some((r) => r.packageRole === "queue")) {
-            intent = "queue_runtime_upgrade";
-        }
-        return {
-            intent,
-            anchorPackage,
-            suppressRuntimeNarrative: false,
-            allowRuntimeNarrative: true,
-            showLimitedEvidence: showLimitedEvidence(runtimeEligible),
-            expectedImpactKey: dominantExpectedImpact(runtimeEligible),
-            verificationLabels,
-            runtimeSurfaceLabel,
-            runtimePackages: runtimeEligible.map((r) => r.packageName),
-        };
-    }
-    const toolingOnly = semantics.length > 0 && semantics.every(isToolingOriented);
-    if (toolingOnly) {
-        const anchorPackage = pickToolingAnchor(semantics, changedOrder);
-        const isPatch = isToolingPatchSet(semantics, facts);
-        const intent = isPatch
-            ? "tooling_patch"
-            : "tooling_upgrade";
-        const anchorRow = semantics.find((r) => r.packageName === anchorPackage);
-        return {
-            intent,
-            anchorPackage,
-            suppressRuntimeNarrative: true,
-            allowRuntimeNarrative: false,
-            showLimitedEvidence: showLimitedEvidence(semantics),
-            expectedImpactKey: anchorRow?.expectedImpact ?? null,
-            verificationLabels: collectVerificationLabels(semantics),
-            runtimeSurfaceLabel: null,
-            runtimePackages: [],
-        };
-    }
-    return {
-        ...emptyInterpretation("unknown_upgrade"),
-        anchorPackage: facts.changedPackages.primary,
-        verificationLabels: collectVerificationLabels(semantics),
-        showLimitedEvidence: showLimitedEvidence(semantics),
-        expectedImpactKey: dominantExpectedImpact(semantics),
-    };
-}

package/dist/presentation/intent/formatPresentationCopy.d.ts

@@ -1,8 +0,0 @@
-import type { ScanNarrativeFacts } from "../../scanNarrativeFacts.js";
-import type { PresentationStatus } from "../dto/types.js";
-import type { PresentationInterpretation } from "./presentationIntent.js";
-export declare function formatPresentationHeadline(interpretation: PresentationInterpretation, facts: ScanNarrativeFacts, status: PresentationStatus | undefined): string;
-/** Atomic insight lines — no embedded areas or blast radius (those live in separate channels). */
-export declare function formatPresentationInsightLines(interpretation: PresentationInterpretation, facts: ScanNarrativeFacts, status: PresentationStatus | undefined): string[];
-export declare function formatPresentationVerification(interpretation: PresentationInterpretation, status: PresentationStatus | undefined, max: number): string[];
-//# sourceMappingURL=formatPresentationCopy.d.ts.map

package/dist/presentation/intent/formatPresentationCopy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatPresentationCopy.d.ts","sourceRoot":"","sources":["../../../src/presentation/intent/formatPresentationCopy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAM1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAa1E,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,0BAA0B,EAC1C,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,MAAM,CAmDR;AA0BD,kGAAkG;AAClG,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,0BAA0B,EAC1C,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,MAAM,EAAE,CA0CV;AAuBD,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,0BAA0B,EAC1C,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAmBV"}

package/dist/presentation/intent/formatPresentationCopy.js

@@ -1,140 +0,0 @@
-import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
-import { applyPostureVocabularyGuardHeadline, applyPostureVocabularyGuardLines, } from "./applyPostureVocabularyGuard.js";
-import { formatPackageDisplayName } from "./packageDisplayName.js";
-function anchorSemantics(facts, interpretation) {
-    const name = interpretation.anchorPackage;
-    if (!name)
-        return null;
-    return (facts.changedPackageSemantics.find((r) => r.packageName === name) ?? null);
-}
-export function formatPresentationHeadline(interpretation, facts, status) {
-    const anchor = interpretation.anchorPackage ?? facts.changedPackages.primary;
-    const row = anchorSemantics(facts, interpretation);
-    const pkgDisplay = formatPackageDisplayName(anchor ?? "dependency", row?.packageRole);
-    const copy = scanSurfaceCopy.presentation;
-    let headline;
-    switch (interpretation.intent) {
-        case "limited_context":
-            headline = copy.limitedContextHeadline;
-            break;
-        case "no_changed_packages":
-            headline = copy.noChangedPackagesHeadline;
-            break;
-        case "tooling_patch":
-            headline = copy.toolingPatchHeadline.replace("{package}", pkgDisplay);
-            break;
-        case "tooling_upgrade":
-            headline = copy.toolingUpgradeHeadline.replace("{package}", pkgDisplay);
-            break;
-        case "multi_runtime_upgrade":
-            headline = copy.multiRuntimeHeadline;
-            break;
-        case "auth_runtime_upgrade":
-        case "queue_runtime_upgrade":
-        case "runtime_upgrade": {
-            const surface = interpretation.runtimeSurfaceLabel ?? "application code";
-            headline = copy.runtimeUpgradeHeadline
-                .replace("{package}", pkgDisplay)
-                .replace("{surface}", surface);
-            break;
-        }
-        case "unknown_upgrade":
-            if (status === "safe") {
-                headline = copy.safeNeutralHeadline.replace("{package}", pkgDisplay);
-            }
-            else {
-                headline = copy.defaultUpgradeHeadline.replace("{package}", pkgDisplay);
-            }
-            break;
-        default:
-            headline = copy.safeNeutralHeadline.replace("{package}", pkgDisplay);
-    }
-    return applyPostureVocabularyGuardHeadline(headline, status, interpretation.anchorPackage);
-}
-function formatExpectedImpactKeyPoint(interpretation) {
-    if (interpretation.intent !== "tooling_patch" &&
-        interpretation.intent !== "tooling_upgrade") {
-        return null;
-    }
-    const key = interpretation.expectedImpactKey;
-    let workflows = "build and typecheck workflows";
-    if (key === "test_time")
-        workflows = "test workflows";
-    else if (key === "development_only")
-        workflows = "development workflows";
-    else if (key === "build_time")
-        workflows = "build workflows";
-    return scanSurfaceCopy.presentation.expectedImpactLimitedKeyPoint.replace("{workflows}", workflows);
-}
-function formatLimitedEvidenceKeyPoint() {
-    return scanSurfaceCopy.presentation.limitedEvidenceKeyPoint;
-}
-/** Atomic insight lines — no embedded areas or blast radius (those live in separate channels). */
-export function formatPresentationInsightLines(interpretation, facts, status) {
-    const points = [];
-    if (interpretation.intent === "limited_context") {
-        points.push(scanSurfaceCopy.presentation.limitedContextKeyPoint);
-        if (facts.changedPackages.primary) {
-            points.push(scanSurfaceCopy.presentation.changedPackageKeyPoint.replace("{package}", facts.changedPackages.primary));
-        }
-        return applyPostureVocabularyGuardLines(points, status);
-    }
-    if (interpretation.showLimitedEvidence) {
-        points.push(formatLimitedEvidenceKeyPoint());
-    }
-    if (interpretation.suppressRuntimeNarrative) {
-        points.push(scanSurfaceCopy.presentation.noRuntimePathsKeyPoint);
-        const impact = formatExpectedImpactKeyPoint(interpretation);
-        if (impact)
-            points.push(impact);
-    }
-    else if (interpretation.allowRuntimeNarrative) {
-        const usage = facts.packageUsage.find((u) => u.packageName === interpretation.anchorPackage);
-        const paths = [...(usage?.paths ?? []), ...(usage?.criticalPaths ?? [])];
-        if (paths.length > 0) {
-            points.push(scanSurfaceCopy.presentation.usedInRuntimePathsKeyPoint.replace("{count}", String(paths.length)));
-        }
-        else {
-            points.push(scanSurfaceCopy.presentation.runtimeUsageKeyPoint);
-        }
-    }
-    return applyPostureVocabularyGuardLines(points, status);
-}
-const AUTH_VERIFICATION = [
-    "routes",
-    "middleware/hooks",
-    "auth flow",
-    "serialization",
-    "error handling",
-];
-const QUEUE_VERIFICATION = [
-    "workers",
-    "queue",
-    "serialization",
-    "error handling",
-];
-const RUNTIME_DEFAULT_VERIFICATION = [
-    "routes",
-    "middleware/hooks",
-    "error handling",
-];
-export function formatPresentationVerification(interpretation, status, max) {
-    let actions = [];
-    if (interpretation.verificationLabels.length > 0) {
-        actions = [...interpretation.verificationLabels];
-    }
-    else if (interpretation.intent === "auth_runtime_upgrade") {
-        actions = [...AUTH_VERIFICATION];
-    }
-    else if (interpretation.intent === "queue_runtime_upgrade") {
-        actions = [...QUEUE_VERIFICATION];
-    }
-    else if (interpretation.allowRuntimeNarrative) {
-        actions = [...RUNTIME_DEFAULT_VERIFICATION];
-    }
-    else if (interpretation.intent === "tooling_patch" ||
-        interpretation.intent === "tooling_upgrade") {
-        actions = ["CI", "typecheck", "build"];
-    }
-    return applyPostureVocabularyGuardLines(actions, status).slice(0, max);
-}

package/dist/presentation/intent/presentationIntent.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=presentationIntent.test.d.ts.map

package/dist/presentation/intent/presentationIntent.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"presentationIntent.test.d.ts","sourceRoot":"","sources":["../../../src/presentation/intent/presentationIntent.test.ts"],"names":[],"mappings":""}

package/dist/presentation/intent/presentationIntent.test.js

@@ -1,29 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { deriveScanNarrative } from "../../deriveScanNarrative.js";
-import { scanResultMixedTypescriptFastify, scanResultTypescriptPatch, scanResultFastifyRuntime, } from "../fixtures/presentationPersonaFixtures.js";
-import { derivePresentationInterpretation } from "./derivePresentationInterpretation.js";
-describe("derivePresentationInterpretation", () => {
-    it("typescript patch: tooling_patch intent from engine semantics", () => {
-        const facts = deriveScanNarrative(scanResultTypescriptPatch);
-        const interp = derivePresentationInterpretation(facts);
-        // Engine: suppressRuntimeNarrative=true, expectedImpact=typecheck, dependencyClass=tooling
-        expect(interp.intent).toBe("tooling_patch");
-        expect(interp.anchorPackage).toBe("typescript");
-        expect(interp.suppressRuntimeNarrative).toBe(true);
-    });
-    it("fastify: runtime_upgrade from runtimeImpact=confirmed", () => {
-        const facts = deriveScanNarrative(scanResultFastifyRuntime);
-        const interp = derivePresentationInterpretation(facts);
-        expect(interp.intent).toBe("runtime_upgrade");
-        expect(interp.anchorPackage).toBe("fastify");
-        expect(interp.allowRuntimeNarrative).toBe(true);
-    });
-    it("mixed typescript+fastify: runtime dominates tooling (anchor fastify)", () => {
-        const facts = deriveScanNarrative(scanResultMixedTypescriptFastify);
-        const interp = derivePresentationInterpretation(facts);
-        expect(interp.intent).toBe("runtime_upgrade");
-        expect(interp.anchorPackage).toBe("fastify");
-        expect(interp.runtimePackages).toContain("fastify");
-        expect(interp.runtimePackages).not.toContain("typescript");
-    });
-});

package/dist/presentation/intent/verificationFocusLabels.d.ts

@@ -1,2 +0,0 @@
-export declare function mergeVerificationFocusLabels(focusLists: string[][], max?: number): string[];
-//# sourceMappingURL=verificationFocusLabels.d.ts.map

package/dist/presentation/intent/verificationFocusLabels.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"verificationFocusLabels.d.ts","sourceRoot":"","sources":["../../../src/presentation/intent/verificationFocusLabels.ts"],"names":[],"mappings":"AA2BA,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAAE,EAAE,EACtB,GAAG,SAAI,GACN,MAAM,EAAE,CAeV"}

package/dist/presentation/intent/verificationFocusLabels.js

@@ -1,45 +0,0 @@
-const FOCUS_LABELS = {
-    ci: "CI",
-    typecheck: "typecheck",
-    build: "build",
-    routes: "routes",
-    middleware: "middleware/hooks",
-    hooks: "middleware/hooks",
-    auth_flow: "auth flow",
-    auth: "auth flow",
-    serialization: "serialization",
-    error_handling: "error handling",
-    handlers: "handlers",
-    plugins: "plugins",
-    session: "session",
-    workers: "workers",
-    queue: "queue",
-    test_suite: "test suite",
-    lint: "lint",
-    format: "format",
-};
-function labelVerificationFocus(focus) {
-    const key = focus.trim().toLowerCase();
-    if (!key)
-        return "";
-    return FOCUS_LABELS[key] ?? focus.replace(/_/g, " ");
-}
-export function mergeVerificationFocusLabels(focusLists, max = 6) {
-    const seen = new Set();
-    const out = [];
-    for (const list of focusLists) {
-        for (const f of list) {
-            const label = labelVerificationFocus(f);
-            if (!label)
-                continue;
-            const norm = label.toLowerCase();
-            if (seen.has(norm))
-                continue;
-            seen.add(norm);
-            out.push(label);
-            if (out.length >= max)
-                return out;
-        }
-    }
-    return out;
-}

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

@@ -1,12 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"derivePresentationProfile.d.ts","sourceRoot":"","sources":["../../../src/presentation/profile/derivePresentationProfile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAKtE,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;AAwFF,8DAA8D;AAC9D,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,gCAAgC,GACpC,mBAAmB,GAAG,IAAI,CAwB5B"}

package/dist/presentation/profile/derivePresentationProfile.js

@@ -1,85 +0,0 @@
-import { mergePostureFromDecision } from "../../riskVocabulary.js";
-import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
-import { derivePresentationInterpretation } from "../intent/derivePresentationInterpretation.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 deriveDensity(facts, priority, interpretation) {
-    if (priority === "limited") {
-        return hasHighSeverityFindings(facts) ? "standard" : "minimal";
-    }
-    if (interpretation.allowRuntimeNarrative) {
-        const wideOrModerate = facts.blastRadius?.level === "wide" ||
-            facts.blastRadius?.level === "moderate";
-        const hasAreas = facts.affectedAreas.length > 0;
-        const hasPaths = facts.packageUsage.some((u) => u.paths.length > 0 || u.criticalPaths.length > 0);
-        if (wideOrModerate || hasAreas || hasPaths) {
-            return "rich";
-        }
-    }
-    if (interpretation.suppressRuntimeNarrative) {
-        const narrow = !facts.blastRadius || facts.blastRadius.level === "narrow";
-        if (narrow && facts.affectedAreas.length === 0) {
-            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 interpretation = derivePresentationInterpretation(facts);
-    const priority = hasStrongPrIntelligence(facts)
-        ? "pr_intelligence"
-        : "limited";
-    const status = resolveStatus(facts, ctx);
-    const density = deriveDensity(facts, priority, interpretation);
-    const confidence = deriveConfidence(facts, priority);
-    const degradedMessage = priority === "limited"
-        ? scanSurfaceCopy.presentation.limitedContextMessage
-        : undefined;
-    return {
-        status,
-        density,
-        confidence,
-        priority,
-        degradedMessage,
-        interpretation,
-    };
-}

package/dist/scanCardSummary.d.ts

@@ -1,58 +0,0 @@
-import type { DashboardCardPresentation } from "./presentation/dto/dashboardCardPresentation.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";
-export type RiskIndexBand = "low" | "medium" | "high";
-export type FindingCountSummary = {
-    critical: number;
-    high: number;
-    medium: number;
-    low: number;
-};
-/** @deprecated Use DashboardCardPresentation */
-export type ScanCardSummary = DashboardCardPresentation;
-export declare const SCAN_CARD_SCANNING_SUMMARY = "Waiting for results...";
-export type PipelineCompletionEvidence = {
-    scannedAt?: string | null;
-    decision?: string | null;
-    totalScore?: number | null;
-    hasResult?: boolean;
-};
-/** Scan completion signals — decision/totalScore/result are only set after analysis. */
-export declare function hasScanCompletionEvidence(evidence: PipelineCompletionEvidence): boolean;
-/**
- * Resolve wire status using completion evidence (decision, totalScore, result).
- * Handles races where denormalized columns are written before status flips to done.
- */
-export declare function resolvePipelineStatus(status: string | undefined, evidence: PipelineCompletionEvidence): ScanPipelineStatus;
-/** Pipeline lifecycle copy that must never appear on completed scan cards. */
-export declare function isPipelinePlaceholderCopy(text: string | null | undefined): boolean;
-/** True when summary reflects pipeline lifecycle, not merge posture. */
-export declare function isPipelineCardSummary(summary: ScanCardSummary): boolean;
-/** Single source for risk index color bands (aligns with decision score bands). */
-export declare function deriveRiskIndexBand(score: number | null | undefined): RiskIndexBand | null;
-export declare function aggregateFindingCounts(findings: Finding[] | null | undefined): FindingCountSummary;
-/**
- * Server-side card summary for PR dashboard list views.
- * Pipeline lifecycle copy is included when `pipelineStatus !== "done"`.
- *
- * Quiet safe cards with no mappable signals show posture + exposure only.
- */
-export declare function deriveScanCardSummary(result: ScanResult | null | undefined, pipelineStatus: ScanPipelineStatus): ScanCardSummary;
-/** Subline appended when scan results are stale (head SHA mismatch). */
-export declare function staleScanSubline(): string;
-/** Rebuild card summary from denormalized scan columns when result JSON is unavailable. */
-export declare function deriveScanCardSummaryFromDenormalized(decision: string | null, totalScore: number | null, summaryText: string | null, pipelineStatus: ScanPipelineStatus): ScanCardSummary;
-export type PrScanCardSummaryInput = {
-    pipelineStatus: string;
-    decision: string | null;
-    totalScore: number | null;
-    summaryText: string | null;
-    result: ScanResult | null;
-    scannedAt?: string | null;
-};
-/**
- * Canonical card summary for PR list/dashboard — single derivation path for API + web.
- */
-export declare function resolvePrScanCardSummary(input: PrScanCardSummaryInput): ScanCardSummary;
-//# sourceMappingURL=scanCardSummary.d.ts.map

package/dist/scanCardSummary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scanCardSummary.d.ts","sourceRoot":"","sources":["../src/scanCardSummary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAMjG,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,gDAAgD;AAChD,MAAM,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAGxD,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"}