@mergesignal/shared 0.4.1 → 0.4.2

package/dist/deriveScanNarrative.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deriveScanNarrative.d.ts","sourceRoot":"","sources":["../src/deriveScanNarrative.ts"],"names":[],"mappings":"AAOA,OAAO,EAaL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAKV,UAAU,EACX,MAAM,YAAY,CAAC;AAsbpB;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACpC,kBAAkB,CAuGpB"}
+{"version":3,"file":"deriveScanNarrative.d.ts","sourceRoot":"","sources":["../src/deriveScanNarrative.ts"],"names":[],"mappings":"AAOA,OAAO,EAeL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAKV,UAAU,EACX,MAAM,YAAY,CAAC;AA+dpB;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACpC,kBAAkB,CAwGpB"}

package/dist/deriveScanNarrative.js

@@ -125,6 +125,41 @@ function mergeGraphHotspots(codeHotspots, graphHotspots) {
     }
     return [...byName.values()].slice(0, NARRATIVE_FACT_MAX_HOTSPOTS);
 }
+function projectPackageSemanticsFromWire(pkgIntel) {
+    if (!pkgIntel)
+        return null;
+    return {
+        dependencyClass: pkgIntel.dependencyClass ?? null,
+        packageRole: pkgIntel.packageRole ?? null,
+        runtimeImpact: pkgIntel.runtimeImpact ?? null,
+        expectedImpact: pkgIntel.expectedImpact ?? null,
+        suppressRuntimeNarrative: pkgIntel.suppressRuntimeNarrative === true,
+        evidenceStrength: pkgIntel.evidenceStrength ?? null,
+        verificationFocus: pkgIntel.verificationFocus ?? [],
+    };
+}
+function projectChangedPackageSemantics(ri, changed) {
+    return changed.all.map((packageName) => {
+        const pkgIntel = ri.packages?.[packageName];
+        const usage = pkgIntel?.usage;
+        const paths = usage?.paths ?? [];
+        const criticalPaths = usage?.criticalPaths ?? [];
+        const areas = usage?.areas ?? [];
+        const summary = projectPackageSemanticsFromWire(pkgIntel);
+        return {
+            packageName,
+            dependencyClass: summary?.dependencyClass ?? null,
+            packageRole: summary?.packageRole ?? null,
+            runtimeImpact: summary?.runtimeImpact ?? null,
+            expectedImpact: summary?.expectedImpact ?? null,
+            suppressRuntimeNarrative: summary?.suppressRuntimeNarrative ?? false,
+            evidenceStrength: summary?.evidenceStrength ?? null,
+            verificationFocus: summary?.verificationFocus ?? [],
+            usagePathCount: paths.length + criticalPaths.length,
+            usageAreaCount: areas.length,
+        };
+    });
+}
 function extractTier1FromRepoIntelligence(ri, changed) {
     const primary = changed.primary;
     const pkgIntel = primary && ri.packages?.[primary] ? ri.packages[primary] : undefined;
@@ -155,14 +190,8 @@ function extractTier1FromRepoIntelligence(ri, changed) {
             },
         }
         : null;
-    const packageSemantics = pkgIntel
-        ? {
-            runtimeImpact: pkgIntel.runtimeImpact ?? null,
-            expectedImpact: pkgIntel.expectedImpact ?? null,
-            suppressRuntimeNarrative: suppressRuntime,
-            verificationFocus: pkgIntel.verificationFocus ?? [],
-        }
-        : null;
+    const packageSemantics = projectPackageSemanticsFromWire(pkgIntel);
+    const changedPackageSemantics = projectChangedPackageSemantics(ri, changed);
     const blastFromRi = ri.blastRadius;
     const blastLevel = readBlastLevel(blastFromRi?.level) ??
         (changed.all.length > 0
@@ -195,6 +224,7 @@ function extractTier1FromRepoIntelligence(ri, changed) {
         runtimeSurface,
         reachability,
         packageSemantics,
+        changedPackageSemantics,
         blastRadius,
         affectedAreas: affectedAreas.slice(0, NARRATIVE_FACT_MAX_AREAS),
         hotspots: codeHotspots.slice(0, NARRATIVE_FACT_MAX_HOTSPOTS),
@@ -206,6 +236,7 @@ function hasMeaningfulTier1(tier1) {
         tier1.runtimeSurface != null ||
         tier1.reachability != null ||
         tier1.packageSemantics?.expectedImpact != null ||
+        tier1.changedPackageSemantics.length > 0 ||
         tier1.blastRadius != null ||
         tier1.affectedAreas.length > 0 ||
         tier1.hotspots.length > 0);
@@ -287,6 +318,7 @@ function emptyTier1Blocks() {
         runtimeSurface: null,
         reachability: null,
         packageSemantics: null,
+        changedPackageSemantics: [],
         blastRadius: null,
         affectedAreas: [],
         hotspots: [],
@@ -386,6 +418,7 @@ export function deriveScanNarrative(result) {
         runtimeSurface: tier1Blocks.runtimeSurface,
         reachability: tier1Blocks.reachability,
         packageSemantics: tier1Blocks.packageSemantics,
+        changedPackageSemantics: tier1Blocks.changedPackageSemantics,
         blastRadius: tier1Blocks.blastRadius,
         affectedAreas,
         hotspots: tier1Blocks.hotspots,

package/dist/deriveScanNarrative.test.js

@@ -126,6 +126,10 @@ describe("deriveScanNarrative", () => {
         expect(facts.packageSemantics?.runtimeImpact).toBe("none");
         expect(facts.packageSemantics?.expectedImpact).toBe("typecheck");
         expect(facts.packageSemantics?.suppressRuntimeNarrative).toBe(true);
+        expect(facts.packageSemantics?.dependencyClass).toBe("tooling");
+        expect(facts.packageSemantics?.packageRole).toBe("typechecker");
+        expect(facts.changedPackageSemantics).toHaveLength(1);
+        expect(facts.changedPackageSemantics[0]?.packageName).toBe("typescript");
         expect(facts.blastRadius?.level).toBe("narrow");
     });
     it("extracts packageUsage for all changed packages with blast factors and frameworks", () => {

package/dist/fixtures/repoIntelligenceFixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repoIntelligenceFixtures.d.ts","sourceRoot":"","sources":["../../src/fixtures/repoIntelligenceFixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,iEAAiE;AACjE,eAAO,MAAM,8BAA8B,EAAE,gBAyC5C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,iCAAiC,EAAE,gBAqB/C,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,mCAAmC,EAAE,gBAgDjD,CAAC"}
+{"version":3,"file":"repoIntelligenceFixtures.d.ts","sourceRoot":"","sources":["../../src/fixtures/repoIntelligenceFixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,iEAAiE;AACjE,eAAO,MAAM,8BAA8B,EAAE,gBAgD5C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,iCAAiC,EAAE,gBAqB/C,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,mCAAmC,EAAE,gBAgDjD,CAAC"}

package/dist/fixtures/repoIntelligenceFixtures.js

@@ -10,6 +10,13 @@ export const fixtureRepoIntelligenceFastify = {
             suppressRuntimeNarrative: false,
             dependencyClass: "runtime",
             packageRole: "http_framework",
+            verificationFocus: [
+                "routes",
+                "middleware",
+                "auth_flow",
+                "serialization",
+                "error_handling",
+            ],
             usage: {
                 packageName: "fastify",
                 files: [
@@ -29,7 +36,7 @@ export const fixtureRepoIntelligenceFastify = {
         changedPackageCount: 1,
     },
     applicationAreas: [
-        { id: "api", label: "API routes" },
+        { id: "api", label: "API request handling" },
         { id: "auth", label: "Auth middleware" },
     ],
     hotspots: [

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

@@ -1 +1 @@
-{"version":3,"file":"narrativeCompose.d.ts","sourceRoot":"","sources":["../../../src/presentation/compose/narrativeCompose.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AASzF,wBAAgB,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAwCtE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CA2EV;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CA0BV;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAQV;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBzC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,EAAE,GAAG,SAAS,CAwBtB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,GAAG;IAC1E,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAKA"}
+{"version":3,"file":"narrativeCompose.d.ts","sourceRoot":"","sources":["../../../src/presentation/compose/narrativeCompose.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AASzF,wBAAgB,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAOtE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAQV;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAOV;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAQV;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBzC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,EAAE,GAAG,SAAS,CAwBtB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,GAAG;IAC1E,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAKA"}

package/dist/presentation/compose/narrativeCompose.js

@@ -1,6 +1,7 @@
 import { formatCardAreaLabels } from "../../formatCardAreaLabels.js";
-import { composeVerificationPrompt, formatChangedPackagesShort, labelBlastRadiusLevel, labelReachabilityKind, labelRuntimeSurface, selectReviewerGuidance, summarizeBlastRadius, summarizePackageUsage, } from "../../narrativePresentation.js";
+import { formatChangedPackagesShort, labelBlastRadiusLevel, labelReachabilityKind, labelRuntimeSurface, } from "../../narrativePresentation.js";
 import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
+import { formatPresentationHeadline, formatPresentationKeyPoints, formatPresentationVerification, } from "../intent/formatPresentationCopy.js";
 function topAreaLabel(bundle) {
     const area = bundle.facts.affectedAreas[0];
     if (!area)
@@ -10,29 +11,7 @@ function topAreaLabel(bundle) {
 }
 export function composeHeadline(bundle) {
     const { facts, profile } = bundle;
-    const primary = facts.changedPackages.primary;
-    if (profile.priority === "limited") {
-        return scanSurfaceCopy.presentation.limitedContextHeadline;
-    }
-    if (!primary) {
-        return scanSurfaceCopy.presentation.noChangedPackagesHeadline;
-    }
-    const runtime = facts.runtimeSurface?.kind === "runtime";
-    const area = topAreaLabel(bundle);
-    if (facts.changedPackages.all.length > 1 && runtime) {
-        return scanSurfaceCopy.presentation.multiRuntimeHeadline;
-    }
-    if (facts.runtimeSurface?.kind === "build" ||
-        facts.reachability?.kind === "build_only") {
-        return scanSurfaceCopy.presentation.buildOnlyHeadline.replace("{package}", primary);
-    }
-    if (runtime) {
-        const surface = area ?? labelRuntimeSurface(facts) ?? "application code";
-        return scanSurfaceCopy.presentation.runtimeHeadline
-            .replace("{package}", primary)
-            .replace("{surface}", surface);
-    }
-    return scanSurfaceCopy.presentation.defaultUpgradeHeadline.replace("{package}", primary);
+    return formatPresentationHeadline(profile.interpretation, facts, profile.status);
 }
 export function composeSubheadline(bundle) {
     const { profile } = bundle;
@@ -42,78 +21,11 @@ export function composeSubheadline(bundle) {
 }
 export function composeKeyPoints(bundle, max) {
     const { facts, profile } = bundle;
-    const points = [];
-    if (profile.priority === "limited") {
-        points.push(scanSurfaceCopy.presentation.limitedContextKeyPoint);
-        if (facts.changedPackages.primary) {
-            points.push(scanSurfaceCopy.presentation.changedPackageKeyPoint.replace("{package}", facts.changedPackages.primary));
-        }
-        return points.slice(0, max);
-    }
-    const usage = summarizePackageUsage(facts, { maxPaths: 2 });
-    if (usage && usage.pathCount > 0) {
-        if (usage.pathCount === 1 && usage.pathSamples[0]) {
-            points.push(scanSurfaceCopy.presentation.usedInPathsSingle.replace("{path}", usage.pathSamples[0]));
-        }
-        else {
-            points.push(scanSurfaceCopy.presentation.usedInPathsMultiple.replace("{count}", String(usage.pathCount)));
-        }
-    }
-    else if (profile.density === "minimal") {
-        points.push(scanSurfaceCopy.presentation.noRuntimePathsKeyPoint);
-    }
-    const blast = summarizeBlastRadius(facts, 2);
-    if (blast.levelLabel) {
-        if (blast.levelLabel.toLowerCase().includes("wide")) {
-            points.push(scanSurfaceCopy.presentation.blastRadiusWideKeyPoint);
-        }
-        else if (profile.density === "rich") {
-            points.push(scanSurfaceCopy.presentation.blastRadiusLevelKeyPoint.replace("{level}", blast.levelLabel));
-        }
-    }
-    if (facts.affectedAreas.length === 0 && profile.density === "minimal") {
-        points.push(scanSurfaceCopy.presentation.noAffectedAreasKeyPoint);
-    }
-    else if (facts.affectedAreas.length > 0) {
-        const labels = facts.affectedAreas
-            .slice(0, 2)
-            .map((a) => a.label)
-            .join(", ");
-        points.push(scanSurfaceCopy.presentation.affectedAreasKeyPoint.replace("{areas}", labels));
-    }
-    const guidance = selectReviewerGuidance(facts, { scope: "changed", max: 2 });
-    for (const g of guidance) {
-        const msg = g.message.trim();
-        if (msg && !points.includes(msg))
-            points.push(msg);
-        if (points.length >= max)
-            break;
-    }
-    return points.slice(0, max);
+    return formatPresentationKeyPoints(profile.interpretation, facts, profile.status, max);
 }
 export function composeVerificationActions(bundle, max) {
-    const { facts, profile } = bundle;
-    const actions = [];
-    const guidance = selectReviewerGuidance(facts, { scope: "changed", max: 4 });
-    for (const g of guidance) {
-        const rem = g.remediation?.trim();
-        if (rem)
-            actions.push(rem);
-    }
-    const prompt = composeVerificationPrompt(facts);
-    if (prompt && !actions.includes(prompt))
-        actions.push(prompt);
-    if (actions.length === 0) {
-        if (profile.density === "minimal" ||
-            facts.runtimeSurface?.kind === "build") {
-            actions.push(scanSurfaceCopy.presentation.verifyCiTypecheck);
-        }
-        else if (profile.density === "rich") {
-            actions.push(scanSurfaceCopy.presentation.verifyAuthFlow);
-            actions.push(scanSurfaceCopy.presentation.verifyErrorResponses);
-        }
-    }
-    return actions.slice(0, max);
+    const { profile } = bundle;
+    return formatPresentationVerification(profile.interpretation, profile.status, max);
 }
 export function composeAffectedAreaLabels(bundle, max) {
     const labels = [];
@@ -127,14 +39,16 @@ export function composeAffectedAreaLabels(bundle, max) {
     return labels;
 }
 export function composeEvidenceRows(bundle, max) {
-    const { facts } = bundle;
+    const { facts, profile } = bundle;
     const rows = [];
-    const runtime = labelRuntimeSurface(facts);
-    if (runtime)
-        rows.push({ label: "Runtime", value: runtime });
-    const reach = labelReachabilityKind(facts);
-    if (reach)
-        rows.push({ label: "Reachability", value: reach });
+    if (!profile.interpretation.suppressRuntimeNarrative) {
+        const runtime = labelRuntimeSurface(facts);
+        if (runtime)
+            rows.push({ label: "Runtime", value: runtime });
+        const reach = labelReachabilityKind(facts);
+        if (reach)
+            rows.push({ label: "Reachability", value: reach });
+    }
     const blast = labelBlastRadiusLevel(facts);
     if (blast)
         rows.push({ label: "Blast radius", value: blast });

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

@@ -1,4 +1,5 @@
 import type { FindingCountSummary, PresentationConfidence, PresentationDensity, PresentationEvidenceContext, PresentationEvidenceRow, PresentationStatus } from "./types.js";
+import type { PresentationIntent } from "../intent/presentationIntent.js";
 export type ScanCardPresentation = {
     pipeline?: {
         status: "queued" | "running" | "failed";
@@ -21,5 +22,6 @@ export type ScanCardPresentation = {
     riskIndex?: number | null;
     findingCounts?: FindingCountSummary | null;
     actionLabel?: string;
+    presentationIntent?: PresentationIntent;
 };
 //# sourceMappingURL=scanCardPresentation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scanCardPresentation.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/scanCardPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;QACxC,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IAEpC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}
+{"version":3,"file":"scanCardPresentation.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/scanCardPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;QACxC,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IAEpC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC,CAAC"}

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

@@ -1,4 +1,5 @@
 import type { PresentationConfidence, PresentationDensity, PresentationEvidenceContext, PresentationStatus } from "./types.js";
+import type { PresentationIntent } from "../intent/presentationIntent.js";
 import type { FindingSeverity, ScoreLayer } from "../../types.js";
 export type ScanDetailsPresentation = {
     evidenceContext: PresentationEvidenceContext;
@@ -107,5 +108,6 @@ export type ScanDetailsPresentation = {
         methodologyVersion?: string | null;
         changedPackagesSummary?: string;
     };
+    presentationIntent?: PresentationIntent;
 };
 //# sourceMappingURL=scanDetailsPresentation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scanDetailsPresentation.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/scanDetailsPresentation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scanDetailsPresentation.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/scanDetailsPresentation.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+import type { ScanResult } from "../../types.js";
+import { scanResultFastifyRuntime, scanResultLimitedContext, scanResultTypescriptPatch } from "./scanResultFixtures.js";
+export declare const scanResultEslint: ScanResult;
+export declare const scanResultPrettier: ScanResult;
+export declare const scanResultVitest: ScanResult;
+export declare const scanResultNextAuth: ScanResult;
+export declare const scanResultBullmq: ScanResult;
+export declare const scanResultUnknownSafe: ScanResult;
+export declare const scanResultMixedTypescriptFastify: ScanResult;
+export { scanResultFastifyRuntime, scanResultLimitedContext, scanResultTypescriptPatch, };
+//# sourceMappingURL=presentationPersonaFixtures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentationPersonaFixtures.d.ts","sourceRoot":"","sources":["../../../src/presentation/fixtures/presentationPersonaFixtures.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMjD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,yBAAyB,CAAC;AA8JjC,eAAO,MAAM,gBAAgB,EAAE,UAG7B,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,UAG/B,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,UAG7B,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,UAS/B,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,UAS7B,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,UAGlC,CAAC;AAEH,eAAO,MAAM,gCAAgC,EAAE,UAS7C,CAAC;AAEH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,GAC1B,CAAC"}

package/dist/presentation/fixtures/presentationPersonaFixtures.js

@@ -0,0 +1,197 @@
+import { fixtureRepoIntelligenceFastify, fixtureRepoIntelligenceTypescript, } from "../../fixtures/repoIntelligenceFixtures.js";
+import { analysisPreparationWithValidRepoIntel } from "../../fixtures/repoIntelligenceTestHelpers.js";
+import { scanResultFastifyRuntime, scanResultLimitedContext, scanResultTypescriptPatch, } from "./scanResultFixtures.js";
+const basePrep = analysisPreparationWithValidRepoIntel();
+const fixtureRepoIntelligenceEslint = {
+    packages: {
+        eslint: {
+            runtimeSurface: "build",
+            reachability: "build_only",
+            runtimeImpact: "none",
+            expectedImpact: "development_only",
+            evidenceStrength: "medium",
+            suppressRuntimeNarrative: true,
+            dependencyClass: "lint",
+            packageRole: "linter",
+            verificationFocus: ["ci", "lint"],
+            usage: { packageName: "eslint", files: [".eslintrc.cjs"], paths: [] },
+        },
+    },
+    blastRadius: { level: "narrow", changedPackageCount: 1 },
+    applicationAreas: [],
+};
+const fixtureRepoIntelligencePrettier = {
+    packages: {
+        prettier: {
+            runtimeSurface: "build",
+            reachability: "build_only",
+            runtimeImpact: "none",
+            expectedImpact: "development_only",
+            evidenceStrength: "medium",
+            suppressRuntimeNarrative: true,
+            dependencyClass: "format",
+            packageRole: "formatter",
+            verificationFocus: ["ci", "format"],
+            usage: { packageName: "prettier", files: [".prettierrc"], paths: [] },
+        },
+    },
+    blastRadius: { level: "narrow", changedPackageCount: 1 },
+    applicationAreas: [],
+};
+const fixtureRepoIntelligenceVitest = {
+    packages: {
+        vitest: {
+            runtimeSurface: "test",
+            reachability: "test_only",
+            runtimeImpact: "none",
+            expectedImpact: "test_time",
+            evidenceStrength: "medium",
+            suppressRuntimeNarrative: true,
+            dependencyClass: "test",
+            packageRole: "test_runner",
+            verificationFocus: ["ci", "test_suite"],
+            usage: { packageName: "vitest", files: ["vitest.config.ts"], paths: [] },
+        },
+    },
+    blastRadius: { level: "narrow", changedPackageCount: 1 },
+    applicationAreas: [],
+};
+const fixtureRepoIntelligenceNextAuth = {
+    packages: {
+        "next-auth": {
+            runtimeSurface: "runtime",
+            reachability: "on_runtime_paths",
+            runtimeImpact: "confirmed",
+            expectedImpact: "runtime",
+            evidenceStrength: "high",
+            suppressRuntimeNarrative: false,
+            dependencyClass: "runtime",
+            packageRole: "auth",
+            verificationFocus: ["auth_flow", "session", "routes"],
+            usage: {
+                packageName: "next-auth",
+                files: ["apps/web/src/auth.ts"],
+                paths: ["apps/web/src/auth.ts"],
+                areas: ["Auth"],
+            },
+        },
+    },
+    blastRadius: { level: "moderate", changedPackageCount: 1 },
+    applicationAreas: [{ id: "auth", label: "authentication flows" }],
+};
+const fixtureRepoIntelligenceBullmq = {
+    packages: {
+        bullmq: {
+            runtimeSurface: "runtime",
+            reachability: "on_runtime_paths",
+            runtimeImpact: "confirmed",
+            expectedImpact: "runtime",
+            evidenceStrength: "high",
+            suppressRuntimeNarrative: false,
+            dependencyClass: "runtime",
+            packageRole: "queue",
+            verificationFocus: ["workers", "queue", "serialization"],
+            usage: {
+                packageName: "bullmq",
+                files: ["apps/worker/src/queue.ts"],
+                paths: ["apps/worker/src/queue.ts"],
+                areas: ["Workers"],
+            },
+        },
+    },
+    blastRadius: { level: "moderate", changedPackageCount: 1 },
+    applicationAreas: [{ id: "workers", label: "background job processing" }],
+};
+const fixtureRepoIntelligenceUnknown = {
+    packages: {
+        "opaque-pkg": {
+            runtimeSurface: "unknown",
+            reachability: "unknown",
+            runtimeImpact: "unknown",
+            expectedImpact: "unknown",
+            evidenceStrength: "low",
+            suppressRuntimeNarrative: false,
+            dependencyClass: "unknown",
+            packageRole: "unknown",
+            verificationFocus: [],
+            usage: { packageName: "opaque-pkg", files: [], paths: [] },
+        },
+    },
+    blastRadius: { level: "narrow", changedPackageCount: 1 },
+    applicationAreas: [],
+};
+const fixtureRepoIntelligenceMixedToolingRuntime = {
+    packages: {
+        typescript: fixtureRepoIntelligenceTypescript.packages.typescript,
+        fastify: fixtureRepoIntelligenceFastify.packages.fastify,
+    },
+    blastRadius: fixtureRepoIntelligenceFastify.blastRadius,
+    applicationAreas: fixtureRepoIntelligenceFastify.applicationAreas,
+};
+function scanBase(over = {}) {
+    return {
+        totalScore: 18,
+        layerScores: {
+            security: 5,
+            maintainability: 8,
+            ecosystem: 10,
+            upgradeImpact: 5,
+        },
+        findings: [],
+        generatedAt: "2026-01-01T00:00:00.000Z",
+        decision: {
+            recommendation: "safe",
+            confidence: "high",
+            reasoning: [],
+        },
+        analysisPreparation: basePrep,
+        ...over,
+    };
+}
+export const scanResultEslint = scanBase({
+    changedPackages: ["eslint"],
+    repoIntelligence: fixtureRepoIntelligenceEslint,
+});
+export const scanResultPrettier = scanBase({
+    changedPackages: ["prettier"],
+    repoIntelligence: fixtureRepoIntelligencePrettier,
+});
+export const scanResultVitest = scanBase({
+    changedPackages: ["vitest"],
+    repoIntelligence: fixtureRepoIntelligenceVitest,
+});
+export const scanResultNextAuth = scanBase({
+    totalScore: 52,
+    changedPackages: ["next-auth"],
+    repoIntelligence: fixtureRepoIntelligenceNextAuth,
+    decision: {
+        recommendation: "needs_review",
+        confidence: "medium",
+        reasoning: [],
+    },
+});
+export const scanResultBullmq = scanBase({
+    totalScore: 48,
+    changedPackages: ["bullmq"],
+    repoIntelligence: fixtureRepoIntelligenceBullmq,
+    decision: {
+        recommendation: "needs_review",
+        confidence: "medium",
+        reasoning: [],
+    },
+});
+export const scanResultUnknownSafe = scanBase({
+    changedPackages: ["opaque-pkg"],
+    repoIntelligence: fixtureRepoIntelligenceUnknown,
+});
+export const scanResultMixedTypescriptFastify = scanBase({
+    totalScore: 55,
+    changedPackages: ["typescript", "fastify"],
+    repoIntelligence: fixtureRepoIntelligenceMixedToolingRuntime,
+    decision: {
+        recommendation: "needs_review",
+        confidence: "medium",
+        reasoning: [],
+    },
+});
+export { scanResultFastifyRuntime, scanResultLimitedContext, scanResultTypescriptPatch, };

package/dist/presentation/index.d.ts

@@ -6,6 +6,8 @@ export type { BuildScanCardPresentationInput } from "./orchestration/buildScanCa
 export { buildScanDetailsPresentation } from "./orchestration/buildScanDetailsPresentation.js";
 export type { BuildScanDetailsPresentationInput } from "./orchestration/buildScanDetailsPresentation.js";
 export type { PresentationProfile } from "./profile/presentationProfile.js";
+export type { PresentationIntent, PresentationInterpretation, } from "./intent/presentationIntent.js";
+export { derivePresentationInterpretation } from "./intent/derivePresentationInterpretation.js";
 export type { PipelineStatus, PresentationStatus, PresentationDensity, PresentationConfidence, PresentationPriority, PresentationEvidenceContext, PresentationEvidenceRow, } from "./dto/types.js";
 export type { ScanCardPresentation } from "./dto/scanCardPresentation.js";
 export type { ScanDetailsPresentation } from "./dto/scanDetailsPresentation.js";

package/dist/presentation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,gCAAgC,EAAE,MAAM,gDAAgD,CAAC;AACvG,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,YAAY,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AACnG,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,YAAY,EAAE,iCAAiC,EAAE,MAAM,iDAAiD,CAAC;AAEzG,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,gCAAgC,EAAE,MAAM,gDAAgD,CAAC;AACvG,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,YAAY,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AACnG,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,YAAY,EAAE,iCAAiC,EAAE,MAAM,iDAAiD,CAAC;AAEzG,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EACV,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,gCAAgC,EAAE,MAAM,8CAA8C,CAAC;AAChG,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC"}

package/dist/presentation/index.js

@@ -1,6 +1,7 @@
 export { buildScanPresentationBundle } from "./orchestration/buildScanPresentationBundle.js";
 export { buildScanCardPresentation } from "./orchestration/buildScanCardPresentation.js";
 export { buildScanDetailsPresentation } from "./orchestration/buildScanDetailsPresentation.js";
+export { derivePresentationInterpretation } from "./intent/derivePresentationInterpretation.js";
 export { presentScanCard } from "./presenters/presentScanCard.js";
 export { presentPipelineScanCard } from "./presenters/presentPipelineScanCard.js";
 export { presentScanDetails } from "./presenters/presentScanDetails.js";

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

@@ -0,0 +1,5 @@
+import type { PresentationStatus } from "../dto/types.js";
+export declare function guardHeadlineForPosture(headline: string, status: PresentationStatus, anchorPackage: string | null): string;
+export declare function applyPostureVocabularyGuardHeadline(headline: string, status: PresentationStatus | undefined, anchorPackage: string | null): string;
+export declare function applyPostureVocabularyGuardLines(lines: string[], status: PresentationStatus | undefined): string[];
+//# sourceMappingURL=applyPostureVocabularyGuard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"applyPostureVocabularyGuard.d.ts","sourceRoot":"","sources":["../../../src/presentation/intent/applyPostureVocabularyGuard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AA2B1D,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAYR;AASD,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAGR;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,MAAM,EAAE,CAGV"}

package/dist/presentation/intent/applyPostureVocabularyGuard.js

@@ -0,0 +1,44 @@
+import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
+import { formatPackageDisplayName } from "./packageDisplayName.js";
+const SAFE_FORBIDDEN = /\b(needs\s+review|critical\s+concern|high\s+risk|significant\s+impact|urgent\s+verification|severe\s+exposure|review\s+before\s+merge|wide\s+blast\s+radius)\b/i;
+const NEEDS_REVIEW_FORBIDDEN = /\b(no\s+action\s+required|no\s+verification\s+required|safe\s+to\s+merge|no\s+concerns)\b/i;
+const RISKY_FORBIDDEN = /\b(no\s+action\s+required|minor\s+findings\s+only|low\s+risk|no\s+concerns)\b/i;
+function violatesPosture(text, status) {
+    const t = text.trim();
+    if (!t)
+        return true;
+    switch (status) {
+        case "safe":
+            return SAFE_FORBIDDEN.test(t);
+        case "needs_review":
+            return NEEDS_REVIEW_FORBIDDEN.test(t);
+        case "risky":
+            return RISKY_FORBIDDEN.test(t);
+        default:
+            return false;
+    }
+}
+export function guardHeadlineForPosture(headline, status, anchorPackage) {
+    if (!violatesPosture(headline, status))
+        return headline;
+    const pkg = anchorPackage
+        ? formatPackageDisplayName(anchorPackage)
+        : "Dependency";
+    if (status === "safe") {
+        return scanSurfaceCopy.presentation.safeNeutralHeadline.replace("{package}", pkg);
+    }
+    return headline;
+}
+function guardLinesForPosture(lines, status) {
+    return lines.filter((line) => !violatesPosture(line, status));
+}
+export function applyPostureVocabularyGuardHeadline(headline, status, anchorPackage) {
+    if (!status)
+        return headline;
+    return guardHeadlineForPosture(headline, status, anchorPackage);
+}
+export function applyPostureVocabularyGuardLines(lines, status) {
+    if (!status)
+        return lines;
+    return guardLinesForPosture(lines, status);
+}

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

@@ -0,0 +1,4 @@
+import type { ScanNarrativeFacts } from "../../scanNarrativeFacts.js";
+import type { PresentationInterpretation } from "./presentationIntent.js";
+export declare function derivePresentationInterpretation(facts: ScanNarrativeFacts): PresentationInterpretation;
+//# sourceMappingURL=derivePresentationInterpretation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"derivePresentationInterpretation.d.ts","sourceRoot":"","sources":["../../../src/presentation/intent/derivePresentationInterpretation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,yBAAyB,CAAC;AAsJjC,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,kBAAkB,GACxB,0BAA0B,CAkG5B"}