@mergesignal/shared 0.3.0 → 0.4.1

package/dist/deriveScanNarrative.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deriveScanNarrative.d.ts","sourceRoot":"","sources":["../src/deriveScanNarrative.ts"],"names":[],"mappings":"AAMA,OAAO,EAaL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAKV,UAAU,EACX,MAAM,YAAY,CAAC;AAgapB;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACpC,kBAAkB,CAsGpB"}
+{"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"}

package/dist/deriveScanNarrative.js

@@ -1,5 +1,6 @@
 import { extractRepositoryContextFacts } from "./extractRepositoryContextFacts.js";
 import { readBlastLevel, safeParseRepoIntelligence, } from "./repoIntelligenceSchema.js";
+import { isRuntimeNarrativeSafe } from "./repoIntelligenceSemantics.js";
 import { EMPTY_SCAN_NARRATIVE_FACTS, NARRATIVE_FACT_MAX_AREAS, NARRATIVE_FACT_MAX_HOTSPOTS, NARRATIVE_FACT_MAX_PATHS, } from "./scanNarrativeFacts.js";
 import { mergePostureFromDecision } from "./riskVocabulary.js";
 import { selectTopAffectedAreas } from "./selectTopAffectedAreas.js";
@@ -130,8 +131,12 @@ function extractTier1FromRepoIntelligence(ri, changed) {
     const packageUsage = collectPackageUsageForChanged(ri, changed);
     const frameworks = collectFrameworks(ri);
     const paths = allUsagePaths(packageUsage);
-    const runtimeKind = pkgIntel?.runtimeSurface ?? null;
-    const reachKind = pkgIntel?.reachability ?? null;
+    const suppressRuntime = pkgIntel?.suppressRuntimeNarrative === true;
+    const narrativeSafe = isRuntimeNarrativeSafe(pkgIntel);
+    const runtimeKind = narrativeSafe && !suppressRuntime
+        ? (pkgIntel?.runtimeSurface ?? null)
+        : null;
+    const reachKind = narrativeSafe && !suppressRuntime ? (pkgIntel?.reachability ?? null) : null;
     const runtimeSurface = runtimeKind != null
         ? {
             kind: runtimeKind,
@@ -150,6 +155,14 @@ function extractTier1FromRepoIntelligence(ri, changed) {
             },
         }
         : null;
+    const packageSemantics = pkgIntel
+        ? {
+            runtimeImpact: pkgIntel.runtimeImpact ?? null,
+            expectedImpact: pkgIntel.expectedImpact ?? null,
+            suppressRuntimeNarrative: suppressRuntime,
+            verificationFocus: pkgIntel.verificationFocus ?? [],
+        }
+        : null;
     const blastFromRi = ri.blastRadius;
     const blastLevel = readBlastLevel(blastFromRi?.level) ??
         (changed.all.length > 0
@@ -181,6 +194,7 @@ function extractTier1FromRepoIntelligence(ri, changed) {
         frameworks,
         runtimeSurface,
         reachability,
+        packageSemantics,
         blastRadius,
         affectedAreas: affectedAreas.slice(0, NARRATIVE_FACT_MAX_AREAS),
         hotspots: codeHotspots.slice(0, NARRATIVE_FACT_MAX_HOTSPOTS),
@@ -191,6 +205,7 @@ function hasMeaningfulTier1(tier1) {
         tier1.frameworks.length > 0 ||
         tier1.runtimeSurface != null ||
         tier1.reachability != null ||
+        tier1.packageSemantics?.expectedImpact != null ||
         tier1.blastRadius != null ||
         tier1.affectedAreas.length > 0 ||
         tier1.hotspots.length > 0);
@@ -271,6 +286,7 @@ function emptyTier1Blocks() {
         frameworks: [],
         runtimeSurface: null,
         reachability: null,
+        packageSemantics: null,
         blastRadius: null,
         affectedAreas: [],
         hotspots: [],
@@ -347,7 +363,7 @@ export function deriveScanNarrative(result) {
         tier1Blocks.blastRadius = blastRadiusFromChangedCount(changedPackages.all.length);
     }
     let affectedAreas = tier1Blocks.affectedAreas;
-    if (affectedAreas.length === 0) {
+    if (affectedAreas.length === 0 && mode !== "pr_intelligence") {
         affectedAreas = selectTopAffectedAreas(result, { max: 2 }).map((label) => ({
             id: label.toLowerCase().replace(/\s+/g, "_").slice(0, 48),
             label,
@@ -369,6 +385,7 @@ export function deriveScanNarrative(result) {
         frameworks: tier1Blocks.frameworks,
         runtimeSurface: tier1Blocks.runtimeSurface,
         reachability: tier1Blocks.reachability,
+        packageSemantics: tier1Blocks.packageSemantics,
         blastRadius: tier1Blocks.blastRadius,
         affectedAreas,
         hotspots: tier1Blocks.hotspots,

package/dist/deriveScanNarrative.test.js

@@ -112,7 +112,7 @@ describe("deriveScanNarrative", () => {
         expect(facts.repositoryContext.length).toBeGreaterThan(0);
         expect(facts.repositoryContext[0]?.family).toBe("transitive_volume");
     });
-    it("populates build-only runtime surface from repoIntelligence", () => {
+    it("populates tooling semantics without runtime surface chips for typescript", () => {
         const result = {
             ...baseResult,
             changedPackages: ["typescript"],
@@ -121,8 +121,11 @@ describe("deriveScanNarrative", () => {
         };
         const facts = deriveScanNarrative(result);
         expect(facts.availability.mode).toBe("pr_intelligence");
-        expect(facts.runtimeSurface?.kind).toBe("build");
-        expect(facts.reachability?.kind).toBe("build_only");
+        expect(facts.runtimeSurface).toBeNull();
+        expect(facts.reachability).toBeNull();
+        expect(facts.packageSemantics?.runtimeImpact).toBe("none");
+        expect(facts.packageSemantics?.expectedImpact).toBe("typecheck");
+        expect(facts.packageSemantics?.suppressRuntimeNarrative).toBe(true);
         expect(facts.blastRadius?.level).toBe("narrow");
     });
     it("extracts packageUsage for all changed packages with blast factors and frameworks", () => {

package/dist/engineWireRegression.test.js

@@ -37,8 +37,8 @@ describe("engine wire regression (canonical fixtures)", () => {
         expect(facts.availability.repoIntelligenceParse).toBe("ok");
         expect(facts.packageUsage[0]?.packageName).toBe("fastify");
         const card = deriveScanCardSummary(result, "done");
-        expect(card.usageSummary).toBeTruthy();
-        expect(card.verificationLine).toBeTruthy();
+        expect(card.keyPoints.length).toBeGreaterThan(0);
+        expect(card.verificationActions.length).toBeGreaterThan(0);
     });
     it("multi-package fixture: both packages in packageUsage", () => {
         validateRepoIntelligenceWire(fixtureRepoIntelligenceMultiPackage);

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,gBAmC5C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,iCAAiC,EAAE,gBAc/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,gBAyC5C,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

@@ -4,6 +4,12 @@ export const fixtureRepoIntelligenceFastify = {
         fastify: {
             runtimeSurface: "runtime",
             reachability: "on_runtime_paths",
+            runtimeImpact: "confirmed",
+            expectedImpact: "runtime",
+            evidenceStrength: "high",
+            suppressRuntimeNarrative: false,
+            dependencyClass: "runtime",
+            packageRole: "http_framework",
             usage: {
                 packageName: "fastify",
                 files: [
@@ -41,6 +47,13 @@ export const fixtureRepoIntelligenceTypescript = {
         typescript: {
             runtimeSurface: "build",
             reachability: "build_only",
+            runtimeImpact: "none",
+            expectedImpact: "typecheck",
+            evidenceStrength: "medium",
+            suppressRuntimeNarrative: true,
+            dependencyClass: "tooling",
+            packageRole: "typechecker",
+            verificationFocus: ["ci", "typecheck"],
             usage: {
                 packageName: "typescript",
                 files: ["tsconfig.json"],

package/dist/index.d.ts

@@ -14,14 +14,14 @@ export * from "./deriveCardDisplaySummary.js";
 export * from "./scanNarrativeFacts.js";
 export * from "./repoIntelligenceSchema.js";
 export * from "./repoIntelligenceMappers.js";
+export * from "./repoIntelligenceSemantics.js";
 export * from "./repoIntelligenceValidation.js";
 export * from "./deriveScanNarrative.js";
 export * from "./extractRepositoryContextFacts.js";
-export * from "./presentScanCardSummary.js";
 export * from "./narrativePresentation.js";
 export * from "./normalizeGeneratedText.js";
 export * from "./collectNarrativeWhyBullets.js";
-export * from "./presentGitHubPrComment.js";
+export { presentGitHubPrCommentMarkdownFromResult, renderInsightsAsMarkdown, } from "./presentGitHubPrComment.js";
 export * from "./scanCardSummary.js";
 export * from "./deriveScanDetailRecommendations.js";
 export * from "./deriveRiskScoreSummary.js";
@@ -32,4 +32,5 @@ export * from "./trustedScanGuards.js";
 export * from "./actionsStepSummary.js";
 export * from "./prCheckRunPresentation.js";
 export * from "./productMessaging.js";
+export * from "./presentation/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,OAAO,EACL,wCAAwC,EACxC,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -14,14 +14,14 @@ export * from "./deriveCardDisplaySummary.js";
 export * from "./scanNarrativeFacts.js";
 export * from "./repoIntelligenceSchema.js";
 export * from "./repoIntelligenceMappers.js";
+export * from "./repoIntelligenceSemantics.js";
 export * from "./repoIntelligenceValidation.js";
 export * from "./deriveScanNarrative.js";
 export * from "./extractRepositoryContextFacts.js";
-export * from "./presentScanCardSummary.js";
 export * from "./narrativePresentation.js";
 export * from "./normalizeGeneratedText.js";
 export * from "./collectNarrativeWhyBullets.js";
-export * from "./presentGitHubPrComment.js";
+export { presentGitHubPrCommentMarkdownFromResult, renderInsightsAsMarkdown, } from "./presentGitHubPrComment.js";
 export * from "./scanCardSummary.js";
 export * from "./deriveScanDetailRecommendations.js";
 export * from "./deriveRiskScoreSummary.js";
@@ -32,3 +32,4 @@ export * from "./trustedScanGuards.js";
 export * from "./actionsStepSummary.js";
 export * from "./prCheckRunPresentation.js";
 export * from "./productMessaging.js";
+export * from "./presentation/index.js";

package/dist/narrativeParity.test.js

@@ -1,9 +1,10 @@
 import { describe, expect, it } from "vitest";
-import { deriveScanNarrative } from "./deriveScanNarrative.js";
-import { buildPrCheckRunSummaryMarkdown } from "./prCheckRunPresentation.js";
-import { deriveScanCardSummary } from "./scanCardSummary.js";
-import { deriveScanDetailViewModel } from "./scanDetailViewModel.js";
-import { presentGitHubPrComment } from "./presentGitHubPrComment.js";
+import { buildScanPresentationBundle } from "./presentation/orchestration/buildScanPresentationBundle.js";
+import { presentScanCard } from "./presentation/presenters/presentScanCard.js";
+import { presentScanDetails } from "./presentation/presenters/presentScanDetails.js";
+import { presentGitHubPrComment } from "./presentation/presenters/presentGitHubPrComment.js";
+import { renderGitHubCheckRunMarkdown } from "./presentation/render/renderGitHubCheckRunMarkdown.js";
+import { presentGitHubCheckRun } from "./presentation/presenters/presentGitHubCheckRun.js";
 import { fixtureRepoIntelligenceFastify } from "./fixtures/repoIntelligenceFixtures.js";
 import { analysisPreparationWithValidRepoIntel } from "./fixtures/repoIntelligenceTestHelpers.js";
 const ORIGIN = "https://app.example.com";
@@ -40,26 +41,26 @@ describe("narrative parity across consumers", () => {
                 },
             ],
         };
-        const card = deriveScanCardSummary(result, "done");
-        const detail = deriveScanDetailViewModel(result, {
+        const bundle = buildScanPresentationBundle({
+            result,
+            pipelineStatus: "done",
+        });
+        const card = presentScanCard(bundle);
+        const detail = presentScanDetails(bundle, {
             scanId: SCAN_ID,
-            status: "done",
         });
-        const checkRun = buildPrCheckRunSummaryMarkdown({
-            result,
+        const checkRun = renderGitHubCheckRunMarkdown(presentGitHubCheckRun(bundle, {
             scanId: SCAN_ID,
             webAppOrigin: ORIGIN,
             baseline: false,
-        });
-        const prComment = presentGitHubPrComment(deriveScanNarrative(result), result);
-        expect(card.changedPackagesDisplay).toContain("fastify");
-        expect(detail?.narrativeContext.changedPackagesDisplay).toContain("fastify");
-        expect(card.reachabilityLabel).toBe("On runtime paths");
-        expect(detail?.narrativeContext.reachabilityLabel).toBe("On runtime paths");
+        }));
+        const prComment = presentGitHubPrComment(bundle);
+        expect(card.primaryPackage).toBe("fastify");
+        expect(detail.narrative.primaryPackage).toBe("fastify");
+        expect(card.evidence.some((e) => e.label === "Reachability")).toBe(true);
         const asciiOnly = /^[\x00-\x7F]*$/;
         expect(asciiOnly.test(checkRun)).toBe(true);
-        expect(asciiOnly.test(prComment)).toBe(true);
         expect(checkRun.toLowerCase()).toContain("fastify");
-        expect(prComment.toLowerCase()).toContain("fastify");
+        expect(prComment.title.toLowerCase()).toContain("review");
     });
 });

package/dist/narrativePresentation.d.ts.map

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

package/dist/narrativePresentation.js

@@ -147,12 +147,15 @@ export function formatFrameworksSummary(facts, max = 2) {
 }
 export function composeContextLineFromFacts(facts, options = {}) {
     const parts = [];
-    const runtime = labelRuntimeSurface(facts);
-    const reach = summarizeReachability(facts, options.includePathSample ? 1 : 0);
+    const suppressRuntime = facts.packageSemantics?.suppressRuntimeNarrative === true;
+    const runtime = suppressRuntime ? null : labelRuntimeSurface(facts);
+    const reach = suppressRuntime
+        ? null
+        : summarizeReachability(facts, options.includePathSample ? 1 : 0);
     const blast = labelBlastRadiusLevel(facts);
     if (runtime)
         parts.push(runtime);
-    if (reach.kindLabel) {
+    if (reach?.kindLabel) {
         if (options.includePathSample && reach.pathSamples[0]) {
             parts.push(`${reach.kindLabel} (${reach.pathSamples[0]})`);
         }

package/dist/presentGitHubPrComment.d.ts

@@ -1,9 +1,8 @@
-import type { ScanNarrativeFacts } from "./scanNarrativeFacts.js";
 import type { PRDecision, PRInsight, ScanResult } from "./types.js";
 /**
- * PR comment markdown from narrative facts (compressed dashboard story).
+ * PR comment markdown from a completed scan (via presentation bundle).
  */
-export declare function presentGitHubPrComment(facts: ScanNarrativeFacts, result: ScanResult): string;
-/** Backward-compatible entry: derives facts then presents. */
+export declare function presentGitHubPrCommentMarkdownFromResult(result: ScanResult): string;
+/** Backward-compatible entry: derives bundle then renders markdown. */
 export declare function renderInsightsAsMarkdown(insights: PRInsight[], decision: PRDecision): string;
 //# sourceMappingURL=presentGitHubPrComment.d.ts.map

package/dist/presentGitHubPrComment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presentGitHubPrComment.d.ts","sourceRoot":"","sources":["../src/presentGitHubPrComment.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAoBpE;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,UAAU,GACjB,MAAM,CA6CR;AAED,8DAA8D;AAC9D,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,EAAE,EACrB,QAAQ,EAAE,UAAU,GACnB,MAAM,CAgBR"}
+{"version":3,"file":"presentGitHubPrComment.d.ts","sourceRoot":"","sources":["../src/presentGitHubPrComment.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpE;;GAEG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,UAAU,GACjB,MAAM,CAWR;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,EAAE,EACrB,QAAQ,EAAE,UAAU,GACnB,MAAM,CAeR"}

package/dist/presentGitHubPrComment.js

@@ -1,66 +1,21 @@
-import { deriveScanNarrative } from "./deriveScanNarrative.js";
-import { composeVerificationPrompt, formatChangedPackagesShort, formatUsageSummaryLine, selectReviewerGuidance, } from "./narrativePresentation.js";
-import { normalizeGeneratedText } from "./normalizeGeneratedText.js";
-import { MERGE_POSTURE_LABEL, mergePostureFromDecision, } from "./riskVocabulary.js";
-import { scanSurfaceCopy } from "./scanSurfaceCopy.js";
-function renderGuidanceBlock(message, where, action) {
-    return [
-        normalizeGeneratedText(message),
-        "",
-        "**Where it shows up**",
-        "",
-        normalizeGeneratedText(where),
-        "",
-        "**What to do**",
-        "",
-        normalizeGeneratedText(action),
-    ].join("\n");
-}
+import { buildScanPresentationBundle } from "./presentation/orchestration/buildScanPresentationBundle.js";
+import { presentGitHubPrComment as presentGitHubPrCommentFromBundle } from "./presentation/presenters/presentGitHubPrComment.js";
+import { renderGitHubPrCommentMarkdown } from "./presentation/render/renderGitHubPrCommentMarkdown.js";
 /**
- * PR comment markdown from narrative facts (compressed dashboard story).
+ * PR comment markdown from a completed scan (via presentation bundle).
  */
-export function presentGitHubPrComment(facts, result) {
-    const posture = facts.mergePosture ??
-        mergePostureFromDecision(result.decision?.recommendation);
-    const title = posture
-        ? `**${MERGE_POSTURE_LABEL[posture]}**`
-        : `**${scanSurfaceCopy.checkRun.mergePostureUnavailable}**`;
-    const introLines = [];
-    const changed = formatChangedPackagesShort(facts, 3);
-    if (changed)
-        introLines.push(`Changed: ${changed}`);
-    const usage = formatUsageSummaryLine(facts, 1);
-    if (usage)
-        introLines.push(usage);
-    const verify = composeVerificationPrompt(facts);
-    if (verify)
-        introLines.push(`Verify: ${verify}`);
-    const guidance = selectReviewerGuidance(facts, { scope: "changed", max: 3 });
-    if (guidance.length === 0) {
-        const fallback = selectReviewerGuidance(facts, { max: 3 });
-        guidance.push(...fallback.slice(0, 3 - guidance.length));
-    }
-    const blocks = guidance.map((g) => {
-        const where = g.context?.trim() ||
-            facts.packageUsage
-                .flatMap((u) => u.paths.slice(0, 1))
-                .filter(Boolean)[0] ||
-            "See scan detail for affected paths.";
-        const action = g.remediation?.trim() ||
-            composeVerificationPrompt(facts) ||
-            "Review before merge.";
-        return renderGuidanceBlock(g.message, where, action);
+export function presentGitHubPrCommentMarkdownFromResult(result) {
+    const bundle = buildScanPresentationBundle({
+        result,
+        pipelineStatus: "done",
+        decision: result.decision?.recommendation,
+        totalScore: result.totalScore,
     });
-    const parts = [title];
-    if (introLines.length > 0) {
-        parts.push("", introLines.join("\n"));
-    }
-    if (blocks.length > 0) {
-        parts.push("", ...blocks);
-    }
-    return parts.join("\n\n---\n\n").trimEnd();
+    if (!bundle)
+        return "";
+    return renderGitHubPrCommentMarkdown(presentGitHubPrCommentFromBundle(bundle));
 }
-/** Backward-compatible entry: derives facts then presents. */
+/** Backward-compatible entry: derives bundle then renders markdown. */
 export function renderInsightsAsMarkdown(insights, decision) {
     const result = {
         totalScore: 0,
@@ -75,6 +30,5 @@ export function renderInsightsAsMarkdown(insights, decision) {
         insights,
         decision,
     };
-    const facts = deriveScanNarrative(result);
-    return presentGitHubPrComment(facts, result);
+    return presentGitHubPrCommentMarkdownFromResult(result);
 }

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

@@ -0,0 +1,16 @@
+import type { ScanPresentationBundle } from "../orchestration/scanPresentationBundle.js";
+export declare function composeHeadline(bundle: ScanPresentationBundle): string;
+export declare function composeSubheadline(bundle: ScanPresentationBundle): string | undefined;
+export declare function composeKeyPoints(bundle: ScanPresentationBundle, max: number): string[];
+export declare function composeVerificationActions(bundle: ScanPresentationBundle, max: number): string[];
+export declare function composeAffectedAreaLabels(bundle: ScanPresentationBundle, max: number): string[];
+export declare function composeEvidenceRows(bundle: ScanPresentationBundle, max: number): Array<{
+    label: string;
+    value: string;
+}>;
+export declare function composeSupportingContext(bundle: ScanPresentationBundle): string[] | undefined;
+export declare function evidenceContextFromProfile(bundle: ScanPresentationBundle): {
+    priority: "pr_intelligence" | "limited";
+    degradedMessage?: string;
+};
+//# sourceMappingURL=narrativeCompose.d.ts.map

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

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

package/dist/presentation/compose/narrativeCompose.js

@@ -0,0 +1,167 @@
+import { formatCardAreaLabels } from "../../formatCardAreaLabels.js";
+import { composeVerificationPrompt, formatChangedPackagesShort, labelBlastRadiusLevel, labelReachabilityKind, labelRuntimeSurface, selectReviewerGuidance, summarizeBlastRadius, summarizePackageUsage, } from "../../narrativePresentation.js";
+import { scanSurfaceCopy } from "../../scanSurfaceCopy.js";
+function topAreaLabel(bundle) {
+    const area = bundle.facts.affectedAreas[0];
+    if (!area)
+        return null;
+    const formatted = formatCardAreaLabels([area.label], 1);
+    return formatted[0] ?? area.label;
+}
+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);
+}
+export function composeSubheadline(bundle) {
+    const { profile } = bundle;
+    if (profile.degradedMessage)
+        return profile.degradedMessage;
+    return undefined;
+}
+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);
+}
+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);
+}
+export function composeAffectedAreaLabels(bundle, max) {
+    const labels = [];
+    for (const area of bundle.facts.affectedAreas) {
+        const formatted = formatCardAreaLabels([area.label], 1);
+        if (formatted[0])
+            labels.push(formatted[0]);
+        if (labels.length >= max)
+            break;
+    }
+    return labels;
+}
+export function composeEvidenceRows(bundle, max) {
+    const { facts } = 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 });
+    const blast = labelBlastRadiusLevel(facts);
+    if (blast)
+        rows.push({ label: "Blast radius", value: blast });
+    const changed = formatChangedPackagesShort(facts, 3);
+    if (changed)
+        rows.push({ label: "Changed", value: changed });
+    return rows.slice(0, max);
+}
+export function composeSupportingContext(bundle) {
+    const { facts, profile, result } = bundle;
+    if (profile.density === "minimal")
+        return undefined;
+    const lines = [];
+    const graph = result.graphInsights;
+    if (graph?.maxDepth != null) {
+        lines.push(scanSurfaceCopy.presentation.graphDepthContext.replace("{depth}", String(graph.maxDepth)));
+    }
+    if (graph?.nodes != null && graph?.edges != null) {
+        lines.push(scanSurfaceCopy.presentation.graphSizeContext
+            .replace("{nodes}", String(graph.nodes))
+            .replace("{edges}", String(graph.edges)));
+    }
+    return lines.length > 0 ? lines.slice(0, 3) : undefined;
+}
+export function evidenceContextFromProfile(bundle) {
+    return {
+        priority: bundle.profile.priority,
+        degradedMessage: bundle.profile.degradedMessage,
+    };
+}

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

@@ -0,0 +1,53 @@
+import type { PresentationConfidence, PresentationDensity, PresentationEvidenceContext, PresentationStatus } from "./types.js";
+export type GitHubCheckRunPresentation = {
+    status: PresentationStatus;
+    density: PresentationDensity;
+    confidence: PresentationConfidence;
+    evidenceContext: PresentationEvidenceContext;
+    title: string;
+    conclusion: "success" | "neutral" | "failure";
+    summaryLead: string;
+    sections: Array<{
+        id: "why" | "actions" | "usage" | "repoContext" | "layers" | "footer";
+        title?: string;
+        bullets: string[];
+        collapsed?: boolean;
+    }>;
+    detailsUrl: string;
+};
+export type GitHubPrCommentPresentation = {
+    status: PresentationStatus;
+    density: PresentationDensity;
+    confidence: PresentationConfidence;
+    evidenceContext: PresentationEvidenceContext;
+    title: string;
+    introLines: string[];
+    guidanceBlocks: Array<{
+        message: string;
+        where?: string;
+        action?: string;
+    }>;
+};
+export type CliScanPresentation = {
+    header: {
+        repoLabel: string;
+        methodology?: string;
+        confidence?: string;
+    };
+    status: PresentationStatus;
+    density: PresentationDensity;
+    confidence: PresentationConfidence;
+    evidenceContext: PresentationEvidenceContext;
+    headline: string;
+    subheadline?: string;
+    keyPoints: string[];
+    verificationActions: string[];
+    metrics?: {
+        riskIndex: number;
+        layerLine: string;
+        findingCount: number;
+        recommendationCount: number;
+    };
+    supportingContext?: string[];
+};
+//# sourceMappingURL=githubAndCliPresentation.d.ts.map