@mergesignal/shared 0.4.1 → 0.4.2

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;AAyGF,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,36 +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 semantics = facts.packageSemantics;
-    const runtime = facts.runtimeSurface?.kind === "runtime" ||
-        semantics?.runtimeImpact === "confirmed";
-    const wideOrModerate = facts.blastRadius?.level === "wide" ||
-        facts.blastRadius?.level === "moderate";
-    const hasAreas = facts.affectedAreas.length > 0;
-    const hasRuntimePaths = hasRuntimeUsage(facts);
-    if (runtime && (wideOrModerate || hasAreas || hasRuntimePaths)) {
-        return "rich";
+    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 toolingImpact = semantics?.expectedImpact === "typecheck" ||
-        semantics?.expectedImpact === "development_only" ||
-        semantics?.expectedImpact === "test_time" ||
-        semantics?.expectedImpact === "build_time";
-    const buildOnly = semantics?.suppressRuntimeNarrative === true ||
-        toolingImpact ||
-        facts.runtimeSurface?.kind === "build" ||
-        facts.reachability?.kind === "build_only";
-    const narrowBlast = !facts.blastRadius || facts.blastRadius.level === "narrow";
-    if (buildOnly && narrowBlast && !hasAreas) {
-        return "minimal";
+    if (interpretation.suppressRuntimeNarrative) {
+        const narrow = !facts.blastRadius || facts.blastRadius.level === "narrow";
+        if (narrow && facts.affectedAreas.length === 0) {
+            return "minimal";
+        }
     }
     return "standard";
 }
@@ -75,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
@@ -90,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/repoIntelligenceSchema.d.ts

@@ -39,9 +39,9 @@ export declare const repoIntelligenceWireSchema: z.ZodObject<{
             runtime: "runtime";
             build: "build";
             test: "test";
-            format: "format";
             tooling: "tooling";
             lint: "lint";
+            format: "format";
             ci: "ci";
         }>>;
         packageRole: z.ZodOptional<z.ZodEnum<{

package/dist/scanNarrativeFacts.d.ts

@@ -15,6 +15,33 @@ export type NarrativePackageUsage = {
     areas: string[];
 };
 export type RepoIntelligenceParseStatus = "ok" | "invalid" | "absent" | "untrusted";
+export type PackageDependencyClass = "runtime" | "tooling" | "test" | "lint" | "format" | "build" | "ci" | "unknown";
+export type PackageRoleKind = "typechecker" | "compiler" | "bundler" | "linter" | "formatter" | "test_runner" | "http_framework" | "auth" | "queue" | "orm" | "unknown";
+export type PackageRuntimeImpact = "none" | "possible" | "confirmed" | "unknown";
+export type PackageExpectedImpact = "runtime" | "build_time" | "typecheck" | "test_time" | "development_only" | "unknown";
+export type PackageEvidenceStrength = "high" | "medium" | "low";
+/** Engine semantic projection for one changed package (wire copy only). */
+export type ChangedPackageSemantics = {
+    packageName: string;
+    dependencyClass: PackageDependencyClass | null;
+    packageRole: PackageRoleKind | null;
+    runtimeImpact: PackageRuntimeImpact | null;
+    expectedImpact: PackageExpectedImpact | null;
+    suppressRuntimeNarrative: boolean;
+    evidenceStrength: PackageEvidenceStrength | null;
+    verificationFocus: string[];
+    usagePathCount: number;
+    usageAreaCount: number;
+};
+export type PackageSemanticsSummary = {
+    dependencyClass: PackageDependencyClass | null;
+    packageRole: PackageRoleKind | null;
+    runtimeImpact: PackageRuntimeImpact | null;
+    expectedImpact: PackageExpectedImpact | null;
+    suppressRuntimeNarrative: boolean;
+    evidenceStrength: PackageEvidenceStrength | null;
+    verificationFocus: string[];
+};
 export type ScanNarrativeFacts = {
     availability: {
         mode: NarrativeAvailabilityMode;
@@ -47,13 +74,10 @@ export type ScanNarrativeFacts = {
             frameworks: string[];
         };
     } | null;
-    /** From sanitized repoIntelligence primary package semantics (ABI 2). */
-    packageSemantics: {
-        runtimeImpact: "none" | "possible" | "confirmed" | "unknown" | null;
-        expectedImpact: "runtime" | "build_time" | "typecheck" | "test_time" | "development_only" | "unknown" | null;
-        suppressRuntimeNarrative: boolean;
-        verificationFocus: string[];
-    } | null;
+    /** Primary changed package semantics (ABI 2 wire projection). */
+    packageSemantics: PackageSemanticsSummary | null;
+    /** Per changed package semantics for mixed-PR precedence (wire projection). */
+    changedPackageSemantics: ChangedPackageSemantics[];
     blastRadius: {
         level: BlastRadiusLevel;
         changedPackageCount?: number;

package/dist/scanNarrativeFacts.d.ts.map

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

package/dist/scanNarrativeFacts.js

@@ -11,6 +11,7 @@ export const EMPTY_SCAN_NARRATIVE_FACTS = {
     runtimeSurface: null,
     reachability: null,
     packageSemantics: null,
+    changedPackageSemantics: [],
     blastRadius: null,
     affectedAreas: [],
     hotspots: [],

package/dist/scanSurfaceCopy.d.ts

@@ -297,11 +297,19 @@ export declare const scanSurfaceCopy: {
         readonly multiRuntimeHeadline: "Multiple runtime dependency upgrades need review";
         readonly buildOnlyHeadline: "{package} patch upgrade with limited application impact";
         readonly runtimeHeadline: "{package} upgrade affects {surface}";
+        readonly toolingPatchHeadline: "{package} patch upgrade";
+        readonly toolingUpgradeHeadline: "{package} tooling upgrade";
+        readonly runtimeUpgradeHeadline: "{package} runtime upgrade affects {surface}";
+        readonly safeNeutralHeadline: "{package} dependency upgrade";
         readonly defaultUpgradeHeadline: "{package} dependency upgrade needs review";
         readonly changedPackageKeyPoint: "Changed package: {package}";
         readonly usedInPathsSingle: "Used across application code ({path})";
         readonly usedInPathsMultiple: "Used across {count} code paths";
         readonly noRuntimePathsKeyPoint: "No runtime usage paths detected";
+        readonly expectedImpactLimitedKeyPoint: "Expected impact is limited to {workflows}";
+        readonly limitedEvidenceKeyPoint: "Evidence for this upgrade is limited";
+        readonly usedInRuntimePathsKeyPoint: "Used in runtime application paths";
+        readonly runtimeUsageKeyPoint: "Used in runtime application paths";
         readonly blastRadiusWideKeyPoint: "Blast radius is wide";
         readonly blastRadiusLevelKeyPoint: "Blast radius is {level}";
         readonly noAffectedAreasKeyPoint: "No affected application areas identified";

package/dist/scanSurfaceCopy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanSurfaceCopy.d.ts","sourceRoot":"","sources":["../src/scanSurfaceCopy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;QAgBxB,8EAA8E;;QAG9E,6DAA6D;;;;QAO7D,qDAAqD;;;;;QASrD,mEAAmE;;;;QAOnE,yFAAyF;;QAGzF,mFAAmF;;QAGnF,4EAA4E;;QAE5E,8FAA8F;;QAE9F,+DAA+D;;;QAI/D,6EAA6E;;;;;QAK7E,2CAA2C;;;QAK3C,2EAA2E;;QAE3E,4EAA4E;;;QAI5E,sEAAsE;;;IAGxE,2EAA2E;;;;;;;;;;;;;;QAiBzE,oEAAoE;;;IAGtE,wEAAwE;;;;;;QAOtE,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkCzC,yDAAyD;;YAGzD,mDAAmD;;YAGnD,8BAA8B;;YAE9B,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA4CtD,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsI/C,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;IAwBvF,kFAAkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+BlF,sEAAsE;;;;;CAO9D,CAAC;AAEX,iEAAiE;AACjE,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa5D"}
+{"version":3,"file":"scanSurfaceCopy.d.ts","sourceRoot":"","sources":["../src/scanSurfaceCopy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;QAgBxB,8EAA8E;;QAG9E,6DAA6D;;;;QAO7D,qDAAqD;;;;;QASrD,mEAAmE;;;;QAOnE,yFAAyF;;QAGzF,mFAAmF;;QAGnF,4EAA4E;;QAE5E,8FAA8F;;QAE9F,+DAA+D;;;QAI/D,6EAA6E;;;;;QAK7E,2CAA2C;;;QAK3C,2EAA2E;;QAE3E,4EAA4E;;;QAI5E,sEAAsE;;;IAGxE,2EAA2E;;;;;;;;;;;;;;QAiBzE,oEAAoE;;;IAGtE,wEAAwE;;;;;;QAOtE,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkCzC,yDAAyD;;YAGzD,mDAAmD;;YAGnD,8BAA8B;;YAE9B,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA4CtD,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsI/C,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;IAwBvF,kFAAkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuClF,sEAAsE;;;;;CAO9D,CAAC;AAEX,iEAAiE;AACjE,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa5D"}

package/dist/scanSurfaceCopy.js

@@ -300,11 +300,19 @@ export const scanSurfaceCopy = {
         multiRuntimeHeadline: "Multiple runtime dependency upgrades need review",
         buildOnlyHeadline: "{package} patch upgrade with limited application impact",
         runtimeHeadline: "{package} upgrade affects {surface}",
+        toolingPatchHeadline: "{package} patch upgrade",
+        toolingUpgradeHeadline: "{package} tooling upgrade",
+        runtimeUpgradeHeadline: "{package} runtime upgrade affects {surface}",
+        safeNeutralHeadline: "{package} dependency upgrade",
         defaultUpgradeHeadline: "{package} dependency upgrade needs review",
         changedPackageKeyPoint: "Changed package: {package}",
         usedInPathsSingle: "Used across application code ({path})",
         usedInPathsMultiple: "Used across {count} code paths",
         noRuntimePathsKeyPoint: "No runtime usage paths detected",
+        expectedImpactLimitedKeyPoint: "Expected impact is limited to {workflows}",
+        limitedEvidenceKeyPoint: "Evidence for this upgrade is limited",
+        usedInRuntimePathsKeyPoint: "Used in runtime application paths",
+        runtimeUsageKeyPoint: "Used in runtime application paths",
         blastRadiusWideKeyPoint: "Blast radius is wide",
         blastRadiusLevelKeyPoint: "Blast radius is {level}",
         noAffectedAreasKeyPoint: "No affected application areas identified",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mergesignal/shared",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "MergeSignal shared scan contract, presentation policy, and trusted validation",
   "type": "module",
   "main": "./dist/index.js",