@mergesignal/shared 0.4.0 → 0.4.2

package/dist/presentation/intent/packageDisplayName.js

@@ -0,0 +1,17 @@
+const ROLE_DISPLAY = {
+    typechecker: "TypeScript",
+    linter: "ESLint",
+    formatter: "Prettier",
+    test_runner: "Test runner",
+};
+/** Display name from package role when engine classified it; else title-case package name. */
+export function formatPackageDisplayName(packageName, packageRole) {
+    if (packageRole && ROLE_DISPLAY[packageRole]) {
+        return ROLE_DISPLAY[packageRole];
+    }
+    if (!packageName)
+        return packageName;
+    if (packageName.length <= 3)
+        return packageName.toUpperCase();
+    return packageName.charAt(0).toUpperCase() + packageName.slice(1);
+}

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

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

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

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

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

@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+import { applyPostureVocabularyGuardHeadline, applyPostureVocabularyGuardLines, guardHeadlineForPosture, } from "./applyPostureVocabularyGuard.js";
+describe("applyPostureVocabularyGuard", () => {
+    it("substitutes safe headline when review language present", () => {
+        const out = guardHeadlineForPosture("typescript dependency upgrade needs review", "safe", "typescript");
+        expect(out.toLowerCase()).not.toContain("needs review");
+        expect(out.toLowerCase()).toContain("typescript");
+    });
+    it("filters safe-forbidden key points", () => {
+        const lines = applyPostureVocabularyGuardLines(["No runtime usage paths detected", "High risk upgrade path"], "safe");
+        expect(lines).toContain("No runtime usage paths detected");
+        expect(lines.some((l) => /high risk/i.test(l))).toBe(false);
+    });
+    it("filters needs_review forbidden verification", () => {
+        const lines = applyPostureVocabularyGuardLines(["Confirm CI passes", "No action required"], "needs_review");
+        expect(lines).toContain("Confirm CI passes");
+        expect(lines.some((l) => /no action required/i.test(l))).toBe(false);
+    });
+    it("allows review headline for needs_review posture", () => {
+        const out = applyPostureVocabularyGuardHeadline("lodash dependency upgrade needs review", "needs_review", "lodash");
+        expect(out).toContain("needs review");
+    });
+});

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

@@ -0,0 +1,14 @@
+import type { PackageExpectedImpact } from "../../scanNarrativeFacts.js";
+export type PresentationIntent = "limited_context" | "no_changed_packages" | "tooling_patch" | "tooling_upgrade" | "runtime_upgrade" | "auth_runtime_upgrade" | "queue_runtime_upgrade" | "multi_runtime_upgrade" | "unknown_upgrade";
+export type PresentationInterpretation = {
+    intent: PresentationIntent;
+    anchorPackage: string | null;
+    suppressRuntimeNarrative: boolean;
+    allowRuntimeNarrative: boolean;
+    showLimitedEvidence: boolean;
+    expectedImpactKey: PackageExpectedImpact | null;
+    verificationLabels: string[];
+    runtimeSurfaceLabel: string | null;
+    runtimePackages: string[];
+};
+//# sourceMappingURL=presentationIntent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentationIntent.d.ts","sourceRoot":"","sources":["../../../src/presentation/intent/presentationIntent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,qBAAqB,GACrB,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,sBAAsB,GACtB,uBAAuB,GACvB,uBAAuB,GACvB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wBAAwB,EAAE,OAAO,CAAC;IAClC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAChD,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC"}

package/dist/presentation/intent/presentationIntent.js

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,45 @@
+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/presentation.test.js

@@ -64,6 +64,9 @@ describe("presentScanCard personas", () => {
         const card = presentScanCard(bundle);
         expect(card.density).toBe("minimal");
         expect(card.status).toBe("safe");
+        expect(card.presentationIntent).toBe("tooling_patch");
+        expect(card.headline).toMatch(/patch upgrade/i);
+        expect(card.headline).not.toMatch(/needs review/i);
         expect(card.changedPackages).toContain("typescript");
         expect(card.verificationActions.length).toBeGreaterThan(0);
     });

package/dist/presentation/presentationPersonas.test.d.ts

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

package/dist/presentation/presentationPersonas.test.d.ts.map

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

package/dist/presentation/presentationPersonas.test.js

@@ -0,0 +1,166 @@
+import { describe, expect, it } from "vitest";
+import { buildScanPresentationBundle } from "./orchestration/buildScanPresentationBundle.js";
+import { presentScanCard } from "./presenters/presentScanCard.js";
+import { presentScanDetails } from "./presenters/presentScanDetails.js";
+import { presentCliScanSummary } from "./presenters/presentCliScanSummary.js";
+import { scanResultBullmq, scanResultEslint, scanResultFastifyRuntime, scanResultLimitedContext, scanResultMixedTypescriptFastify, scanResultNextAuth, scanResultPrettier, scanResultTypescriptPatch, scanResultUnknownSafe, scanResultVitest, } from "./fixtures/presentationPersonaFixtures.js";
+const SCAN_ID = "22222222-2222-4222-8222-222222222222";
+const SAFE_FORBIDDEN = /needs review|high risk|critical concern/i;
+const REVIEW_FORBIDDEN = /no action required|no verification required/i;
+const personas = [
+    {
+        name: "typescript patch",
+        result: scanResultTypescriptPatch,
+        intent: "tooling_patch",
+        status: "safe",
+        density: "minimal",
+        headlineMatch: /patch upgrade/i,
+        headlineMustNot: /needs review/i,
+        verificationIncludes: ["CI", "typecheck"],
+        verificationMustNot: /auth flow/i,
+    },
+    {
+        name: "eslint",
+        result: scanResultEslint,
+        intent: "tooling_upgrade",
+        status: "safe",
+        density: "minimal",
+        headlineMatch: /tooling upgrade/i,
+        headlineMustNot: /needs review/i,
+        verificationIncludes: ["CI", "lint"],
+    },
+    {
+        name: "prettier",
+        result: scanResultPrettier,
+        intent: "tooling_upgrade",
+        status: "safe",
+        density: "minimal",
+        headlineMatch: /tooling upgrade/i,
+        headlineMustNot: /needs review/i,
+        verificationIncludes: ["format"],
+    },
+    {
+        name: "vitest",
+        result: scanResultVitest,
+        intent: "tooling_upgrade",
+        status: "safe",
+        density: "minimal",
+        headlineMatch: /tooling upgrade/i,
+        headlineMustNot: /needs review/i,
+        verificationIncludes: ["test suite"],
+    },
+    {
+        name: "fastify runtime",
+        result: scanResultFastifyRuntime,
+        intent: "runtime_upgrade",
+        status: "needs_review",
+        density: "rich",
+        headlineMatch: /runtime upgrade affects/i,
+        verificationIncludes: ["routes", "middleware"],
+    },
+    {
+        name: "nextauth runtime",
+        result: scanResultNextAuth,
+        intent: "auth_runtime_upgrade",
+        status: "needs_review",
+        density: "rich",
+        headlineMatch: /runtime upgrade affects/i,
+        verificationIncludes: ["auth flow"],
+    },
+    {
+        name: "bullmq runtime",
+        result: scanResultBullmq,
+        intent: "queue_runtime_upgrade",
+        status: "needs_review",
+        density: "rich",
+        headlineMatch: /runtime upgrade affects/i,
+        verificationIncludes: ["workers", "queue"],
+    },
+    {
+        name: "limited context",
+        result: scanResultLimitedContext,
+        intent: "limited_context",
+        status: "needs_review",
+        density: "minimal",
+        headlineMatch: /limited scan context/i,
+    },
+    {
+        name: "unknown safe",
+        result: scanResultUnknownSafe,
+        intent: "unknown_upgrade",
+        status: "safe",
+        density: "standard",
+        headlineMatch: /dependency upgrade/i,
+        headlineMustNot: /needs review/i,
+    },
+];
+function cardFor(result) {
+    const bundle = buildScanPresentationBundle({
+        result,
+        pipelineStatus: "done",
+    });
+    return presentScanCard(bundle);
+}
+describe("presentation personas", () => {
+    for (const persona of personas) {
+        it(`${persona.name}: intent, posture alignment, headline`, () => {
+            const card = cardFor(persona.result);
+            expect(card.presentationIntent).toBe(persona.intent);
+            expect(card.status).toBe(persona.status);
+            expect(card.density).toBe(persona.density);
+            expect(card.headline).toMatch(persona.headlineMatch);
+            if (persona.headlineMustNot) {
+                expect(card.headline).not.toMatch(persona.headlineMustNot);
+            }
+            if (persona.status === "safe") {
+                const combined = [
+                    card.headline,
+                    ...card.keyPoints,
+                    ...card.verificationActions,
+                ].join(" ");
+                expect(combined).not.toMatch(SAFE_FORBIDDEN);
+            }
+            if (persona.status === "needs_review") {
+                const combined = card.verificationActions.join(" ");
+                expect(combined).not.toMatch(REVIEW_FORBIDDEN);
+            }
+            if (persona.verificationIncludes) {
+                for (const v of persona.verificationIncludes) {
+                    expect(card.verificationActions.some((a) => a.toLowerCase().includes(v.toLowerCase()))).toBe(true);
+                }
+            }
+            if (persona.verificationMustNot) {
+                expect(card.verificationActions.join(" ")).not.toMatch(persona.verificationMustNot);
+            }
+        });
+    }
+    it("mixed typescript+fastify: runtime intent, fastify in headline", () => {
+        const card = cardFor(scanResultMixedTypescriptFastify);
+        expect(card.presentationIntent).toBe("runtime_upgrade");
+        expect(card.headline.toLowerCase()).toContain("fastify");
+        expect(card.headline).not.toMatch(/patch upgrade/i);
+    });
+    it("cross-surface parity: fastify headline matches card, details, CLI", () => {
+        const bundle = buildScanPresentationBundle({
+            result: scanResultFastifyRuntime,
+            pipelineStatus: "done",
+        });
+        const card = presentScanCard(bundle);
+        const details = presentScanDetails(bundle, { scanId: SCAN_ID });
+        const cli = presentCliScanSummary(bundle, { repoLabel: "acme/api" });
+        expect(details.hero.headline).toBe(card.headline);
+        expect(cli.headline).toBe(card.headline);
+    });
+    it("cross-surface parity: typescript headline matches card, details, CLI", () => {
+        const bundle = buildScanPresentationBundle({
+            result: scanResultTypescriptPatch,
+            pipelineStatus: "done",
+        });
+        const card = presentScanCard(bundle);
+        const details = presentScanDetails(bundle, { scanId: SCAN_ID });
+        const cli = presentCliScanSummary(bundle, { repoLabel: "acme/api" });
+        expect(details.hero.headline).toBe(card.headline);
+        expect(cli.headline).toBe(card.headline);
+        expect(card.headline).not.toMatch(/needs review/i);
+    });
+});

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

@@ -1 +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"}
+{"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,CA0BtB"}

package/dist/presentation/presenters/presentScanCard.js

@@ -38,6 +38,7 @@ export function presentScanCard(bundle, ctx = {}) {
             ? aggregateFindingCounts(result.findings)
             : null,
         actionLabel: scanSurfaceCopy.presentation.actionLabelReview,
+        presentationIntent: profile.interpretation.intent,
     };
     return normalizeCard(presentation);
 }

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

@@ -1 +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"}
+{"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,CAyFzB"}

package/dist/presentation/presenters/presentScanDetails.js

@@ -123,15 +123,21 @@ export function presentScanDetails(bundle, ctx) {
         : undefined;
     const posture = profile.status;
     const postureLabel = MERGE_POSTURE_LABEL[posture];
+    const toolingIntent = profile.interpretation.intent === "tooling_patch" ||
+        profile.interpretation.intent === "tooling_upgrade";
+    const verdictLine = profile.priority === "pr_intelligence" && toolingIntent && keyPoints[0]
+        ? keyPoints[0]
+        : deriveVerdictLineFromFacts(facts, result);
     return {
         evidenceContext: evidenceContextFromProfile(bundle),
         status: profile.status,
         density: profile.density,
         confidence: profile.confidence,
+        presentationIntent: profile.interpretation.intent,
         hero: {
             headline: normalizeGeneratedText(headline),
             subheadline: normalizeGeneratedTextNullable(subheadline) ?? undefined,
-            verdictLine: deriveVerdictLineFromFacts(facts, result),
+            verdictLine: normalizeGeneratedText(verdictLine),
             scopeChip: deriveDetailReachChip(result.totalScore) ?? undefined,
             postureLabel,
             riskIndex: facts.riskIndex,

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

@@ -1 +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"}
+{"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,5 +1,6 @@
 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";
@@ -26,28 +27,24 @@ 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) {
+function deriveDensity(facts, priority, interpretation) {
     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";
+    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";
+        }
     }
-    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";
+    if (interpretation.suppressRuntimeNarrative) {
+        const narrow = !facts.blastRadius || facts.blastRadius.level === "narrow";
+        if (narrow && facts.affectedAreas.length === 0) {
+            return "minimal";
+        }
     }
     return "standard";
 }
@@ -67,11 +64,12 @@ function deriveConfidence(facts, priority) {
 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);
+    const density = deriveDensity(facts, priority, interpretation);
     const confidence = deriveConfidence(facts, priority);
     const degradedMessage = priority === "limited"
         ? scanSurfaceCopy.presentation.limitedContextMessage
@@ -82,5 +80,6 @@ export function derivePresentationProfile(facts, ctx) {
         confidence,
         priority,
         degradedMessage,
+        interpretation,
     };
 }

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

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

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

@@ -1 +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"}
+{"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;AACzB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAElF,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;IACzB,cAAc,EAAE,0BAA0B,CAAC;CAC5C,CAAC"}

package/dist/repoIntelligenceMappers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repoIntelligenceMappers.d.ts","sourceRoot":"","sources":["../src/repoIntelligenceMappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpE,mDAAmD;AACnD,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC;AAEhF,8CAA8C;AAC9C,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;AAE/E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,sBAAsB,GAC5B,gBAAgB,CAalB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CAapB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,wBAAwB,CAAC;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,oBAAoB,CAAC;CACvC,GAAG,gBAAgB,CAwBnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD"}
+{"version":3,"file":"repoIntelligenceMappers.d.ts","sourceRoot":"","sources":["../src/repoIntelligenceMappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpE,mDAAmD;AACnD,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC;AAEhF,8CAA8C;AAC9C,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;AAE/E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,sBAAsB,GAC5B,gBAAgB,CAalB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CAapB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,wBAAwB,CAAC;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,oBAAoB,CAAC;CACvC,GAAG,gBAAgB,CAgCnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/repoIntelligenceMappers.js

@@ -48,7 +48,14 @@ export function mapReachabilityKind(input) {
         return "unreachable";
     }
     if (bucket === "moderate" || bucket === "high") {
-        return "on_runtime_paths";
+        if (dominantSurface === "test")
+            return "test_only";
+        if (dominantSurface === "build" ||
+            dominantSurface === "dev" ||
+            dominantSurface === "ci") {
+            return "build_only";
+        }
+        return "unknown";
     }
     return "unknown";
 }

package/dist/repoIntelligenceSchema.d.ts

@@ -9,7 +9,7 @@ import { z } from "zod";
 import type { ScanResult } from "./types.js";
 import type { BlastRadiusLevel } from "./scanNarrativeFacts.js";
 /** Bump when wire schema changes incompatibly. */
-export declare const REPO_INTELLIGENCE_ABI: "1";
+export declare const REPO_INTELLIGENCE_ABI: "2";
 /** Strict canonical wire schema — single source of truth. */
 export declare const repoIntelligenceWireSchema: z.ZodObject<{
     packages: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -34,6 +34,73 @@ export declare const repoIntelligenceWireSchema: z.ZodObject<{
             areas: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>;
         areas: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        dependencyClass: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            runtime: "runtime";
+            build: "build";
+            test: "test";
+            tooling: "tooling";
+            lint: "lint";
+            format: "format";
+            ci: "ci";
+        }>>;
+        packageRole: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            typechecker: "typechecker";
+            compiler: "compiler";
+            bundler: "bundler";
+            linter: "linter";
+            formatter: "formatter";
+            test_runner: "test_runner";
+            http_framework: "http_framework";
+            auth: "auth";
+            queue: "queue";
+            orm: "orm";
+        }>>;
+        lockfileKind: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            optional: "optional";
+            production: "production";
+            development: "development";
+        }>>;
+        runtimeImpact: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            confirmed: "confirmed";
+            none: "none";
+            possible: "possible";
+        }>>;
+        expectedImpact: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            runtime: "runtime";
+            build_time: "build_time";
+            typecheck: "typecheck";
+            test_time: "test_time";
+            development_only: "development_only";
+        }>>;
+        evidenceStrength: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        confidenceReason: z.ZodOptional<z.ZodString>;
+        verificationFocus: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        suppressRuntimeNarrative: z.ZodOptional<z.ZodBoolean>;
+        classificationProvenance: z.ZodOptional<z.ZodObject<{
+            dependencyClass: z.ZodEnum<{
+                unknown: "unknown";
+                graph: "graph";
+                registry: "registry";
+                lockfile: "lockfile";
+                heuristic: "heuristic";
+            }>;
+            packageRole: z.ZodEnum<{
+                unknown: "unknown";
+                graph: "graph";
+                registry: "registry";
+                heuristic: "heuristic";
+            }>;
+            registryEntryId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     packageUsage: z.ZodOptional<z.ZodArray<z.ZodObject<{
         packageName: z.ZodString;
@@ -69,6 +136,13 @@ export declare const repoIntelligenceWireSchema: z.ZodObject<{
         paths: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>>;
     frameworks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    semanticDiagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        ruleId: z.ZodString;
+        before: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        after: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type RepoIntelligence = z.infer<typeof repoIntelligenceWireSchema>;
 export type ParseRepoIntelligenceSuccess = {

package/dist/repoIntelligenceSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repoIntelligenceSchema.d.ts","sourceRoot":"","sources":["../src/repoIntelligenceSchema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,EAAG,GAAY,CAAC;AA+ClD,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQrC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE1E,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GACnC,4BAA4B,GAC5B,4BAA4B,CAAC;AAQjC,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAUlE;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,GACX,2BAA2B,CAyC7B;AAED,uEAAuE;AACvE,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAM3E;AAED,mFAAmF;AACnF,wBAAgB,uCAAuC,CACrD,IAAI,EAAE,UAAU,GACf,IAAI,CAGN;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAClC,gBAAgB,GAAG,IAAI,CAKzB"}
+{"version":3,"file":"repoIntelligenceSchema.d.ts","sourceRoot":"","sources":["../src/repoIntelligenceSchema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,EAAG,GAAY,CAAC;AA+HlD,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASrC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE1E,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GACnC,4BAA4B,GAC5B,4BAA4B,CAAC;AAQjC,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAUlE;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,GACX,2BAA2B,CAyC7B;AAED,uEAAuE;AACvE,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAM3E;AAED,mFAAmF;AACnF,wBAAgB,uCAAuC,CACrD,IAAI,EAAE,UAAU,GACf,IAAI,CAGN;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAClC,gBAAgB,GAAG,IAAI,CAKzB"}