@mergesignal/shared 0.5.0 → 0.6.0

package/dist/presentation/buildGitHubCheckRunOutput.d.ts

@@ -0,0 +1,20 @@
+import type { ScanResult } from "../types.js";
+export type GitHubCheckRunConclusion = "success" | "neutral" | "failure";
+export type GitHubCheckRunOutput = {
+    /** Short title shown in the checks bar (≤72 chars). */
+    title: string;
+    /** Markdown summary shown in the check run detail panel (≤2000 chars). */
+    summary: string;
+    conclusion: GitHubCheckRunConclusion;
+};
+export declare function resolveWebAppOrigin(): string;
+export type BuildGitHubCheckRunOutputOptions = {
+    scanId: string;
+    webAppOrigin?: string;
+};
+/**
+ * Formats GitHub Check Run output from a persisted ScanResult via Assessment presentation.
+ * Presentation-only — callers own Octokit checks.create.
+ */
+export declare function buildGitHubCheckRunOutput(result: ScanResult, options: BuildGitHubCheckRunOutputOptions | string): GitHubCheckRunOutput;
+//# sourceMappingURL=buildGitHubCheckRunOutput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildGitHubCheckRunOutput.d.ts","sourceRoot":"","sources":["../../src/presentation/buildGitHubCheckRunOutput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE,MAAM,MAAM,oBAAoB,GAAG;IACjC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,wBAAwB,CAAC;CACtC,CAAC;AAKF,wBAAgB,mBAAmB,IAAI,MAAM,CAM5C;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,gCAAgC,GAAG,MAAM,GACjD,oBAAoB,CAkCtB"}

package/dist/presentation/buildGitHubCheckRunOutput.js

@@ -0,0 +1,42 @@
+import { buildScanPresentationBundle } from "./orchestration/buildScanPresentationBundle.js";
+import { presentGitHubCheckRun } from "./presenters/presentGitHubCheckRun.js";
+import { renderGitHubCheckRunMarkdown } from "./render/renderGitHubCheckRunMarkdown.js";
+/** Default Fly web app origin when `MERGESIGNAL_WEB_URL` is unset. */
+const DEFAULT_WEB_APP_ORIGIN = "https://mergesignal-web.fly.dev";
+export function resolveWebAppOrigin() {
+    const url = typeof process !== "undefined"
+        ? process.env.MERGESIGNAL_WEB_URL?.trim()
+        : undefined;
+    return (url || DEFAULT_WEB_APP_ORIGIN).replace(/\/+$/, "");
+}
+/**
+ * Formats GitHub Check Run output from a persisted ScanResult via Assessment presentation.
+ * Presentation-only — callers own Octokit checks.create.
+ */
+export function buildGitHubCheckRunOutput(result, options) {
+    const scanId = typeof options === "string" ? options : options.scanId;
+    const webAppOrigin = typeof options === "string"
+        ? resolveWebAppOrigin()
+        : (options.webAppOrigin ?? resolveWebAppOrigin());
+    if (!result.decision) {
+        throw new Error("buildGitHubCheckRunOutput requires ScanResult.decision");
+    }
+    const bundle = buildScanPresentationBundle({
+        result,
+        pipelineStatus: "done",
+    });
+    if (!bundle) {
+        throw new Error("buildGitHubCheckRunOutput requires ScanResult.assessment for presentation bundle");
+    }
+    const baseline = result.reportPresentation?.mode === "lightweight_pr_graph_baseline";
+    const presentation = presentGitHubCheckRun(bundle, {
+        scanId,
+        webAppOrigin,
+        baseline,
+    });
+    return {
+        title: presentation.title,
+        summary: renderGitHubCheckRunMarkdown(presentation),
+        conclusion: presentation.conclusion,
+    };
+}

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

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

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

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

package/dist/presentation/buildGitHubCheckRunOutput.test.js

@@ -0,0 +1,188 @@
+import { describe, expect, it } from "vitest";
+import { buildScanPresentationBundle, presentDashboardCard } from "./index.js";
+import { buildGitHubCheckRunOutput } from "./buildGitHubCheckRunOutput.js";
+const safeAssessment = {
+    posture: "safe",
+    confidence: "high",
+    primaryConcern: null,
+    concerns: [],
+    factors: ["tooling_maintenance"],
+    changeClasses: ["tooling_maintenance"],
+    presentation: {
+        narrativeIntensity: "minimal",
+        reachVisibility: "hidden",
+        verificationIntensity: "advisory",
+        insightEmissionFloor: "none",
+        reportMode: "high_signal_pr",
+    },
+};
+const baselineAssessment = {
+    posture: "safe",
+    confidence: "medium",
+    primaryConcern: "graph_baseline_only",
+    concerns: [
+        {
+            kind: "graph_baseline_only",
+            rank: 1,
+            evidenceRefs: ["fixture:baseline"],
+        },
+    ],
+    factors: ["graph_baseline_only"],
+    changeClasses: ["tooling_maintenance"],
+    presentation: {
+        narrativeIntensity: "minimal",
+        reachVisibility: "hidden",
+        verificationIntensity: "none",
+        insightEmissionFloor: "none",
+        reportMode: "lightweight_pr_graph_baseline",
+    },
+};
+const needsReviewAssessment = {
+    posture: "needs_review",
+    confidence: "medium",
+    primaryConcern: "confirmed_runtime_usage",
+    concerns: [
+        {
+            kind: "confirmed_runtime_usage",
+            rank: 1,
+            packages: ["fastify"],
+            evidenceRefs: ["fixture:fastify"],
+        },
+    ],
+    factors: ["confirmed_runtime_usage", "http_framework_infrastructure"],
+    changeClasses: ["runtime_upgrade"],
+    presentation: {
+        narrativeIntensity: "elevated",
+        reachVisibility: "prominent",
+        verificationIntensity: "required",
+        insightEmissionFloor: "full",
+        reportMode: "high_signal_pr",
+    },
+};
+const riskyAssessment = {
+    posture: "risky",
+    confidence: "high",
+    primaryConcern: "breaking_or_major",
+    concerns: [
+        {
+            kind: "breaking_or_major",
+            rank: 1,
+            packages: ["react"],
+            evidenceRefs: ["fixture:breaking"],
+        },
+    ],
+    factors: ["breaking_or_major"],
+    changeClasses: ["breaking_change"],
+    presentation: {
+        narrativeIntensity: "elevated",
+        reachVisibility: "prominent",
+        verificationIntensity: "required",
+        insightEmissionFloor: "full",
+        reportMode: "high_signal_pr",
+    },
+};
+function assertNoLegacyCheckRunMarkers(summary) {
+    expect(summary).not.toContain("Risk index");
+    expect(summary).not.toContain("Layer scores");
+    expect(summary).not.toContain("<details>");
+    expect(summary).not.toMatch(/\d+\/100/);
+}
+function minimalScanResult(overrides = {}) {
+    return {
+        totalScore: 72,
+        layerScores: {
+            security: 10,
+            maintainability: 20,
+            ecosystem: 30,
+            upgradeImpact: 15,
+        },
+        findings: [],
+        methodologyVersion: "mergesignal-engine/test",
+        generatedAt: new Date().toISOString(),
+        assessment: safeAssessment,
+        decision: {
+            recommendation: "safe",
+            confidence: "medium",
+            reasoning: [],
+        },
+        ...overrides,
+    };
+}
+describe("buildGitHubCheckRunOutput", () => {
+    it("maps safe posture to success conclusion with scan link", () => {
+        const out = buildGitHubCheckRunOutput(minimalScanResult(), {
+            scanId: "scan-safe",
+            webAppOrigin: "https://app.test",
+        });
+        expect(out.conclusion).toBe("success");
+        expect(out.summary).toContain("/scan/scan-safe");
+        expect(out.summary).toContain("Full scan:");
+        assertNoLegacyCheckRunMarkers(out.summary);
+    });
+    it("maps needs_review posture to neutral conclusion", () => {
+        const out = buildGitHubCheckRunOutput(minimalScanResult({
+            assessment: needsReviewAssessment,
+            decision: {
+                recommendation: "needs_review",
+                confidence: "medium",
+                reasoning: ["Runtime usage confirmed"],
+            },
+            changedPackages: ["fastify"],
+        }), { scanId: "scan-review", webAppOrigin: "https://app.test" });
+        expect(out.conclusion).toBe("neutral");
+        expect(out.summary).toContain("/scan/scan-review");
+        assertNoLegacyCheckRunMarkers(out.summary);
+    });
+    it("maps risky posture to failure conclusion", () => {
+        const out = buildGitHubCheckRunOutput(minimalScanResult({
+            assessment: riskyAssessment,
+            decision: {
+                recommendation: "risky",
+                confidence: "high",
+                reasoning: ["Breaking change"],
+            },
+        }), { scanId: "scan-risky", webAppOrigin: "https://app.test" });
+        expect(out.conclusion).toBe("failure");
+        assertNoLegacyCheckRunMarkers(out.summary);
+    });
+    it("produces success conclusion for lightweight baseline presentation", () => {
+        const out = buildGitHubCheckRunOutput(minimalScanResult({
+            assessment: baselineAssessment,
+            reportPresentation: { mode: "lightweight_pr_graph_baseline" },
+            changedPackages: ["@types/minimist"],
+            decision: {
+                recommendation: "safe",
+                confidence: "medium",
+                reasoning: [],
+            },
+        }), { scanId: "scan-lw", webAppOrigin: "https://app.test" });
+        expect(out.conclusion).toBe("success");
+        expect(out.summary).toContain("/scan/scan-lw");
+        assertNoLegacyCheckRunMarkers(out.summary);
+    });
+    it("throws when assessment is missing", () => {
+        expect(() => buildGitHubCheckRunOutput(minimalScanResult({ assessment: undefined }), "scan-no-assessment")).toThrow(/assessment/i);
+    });
+    it("title matches dashboard card headline from the same bundle", () => {
+        const result = minimalScanResult({
+            assessment: needsReviewAssessment,
+            decision: {
+                recommendation: "needs_review",
+                confidence: "medium",
+                reasoning: ["Runtime usage confirmed"],
+            },
+            changedPackages: ["fastify"],
+        });
+        const out = buildGitHubCheckRunOutput(result, {
+            scanId: "scan-parity",
+            webAppOrigin: "https://app.test",
+        });
+        const bundle = buildScanPresentationBundle({
+            result,
+            pipelineStatus: "done",
+        });
+        expect(bundle).not.toBeNull();
+        const card = presentDashboardCard(bundle);
+        expect(out.title).toBe(card.headline);
+    });
+});

package/dist/presentation/index.d.ts

@@ -14,13 +14,14 @@ export type { DashboardCardLayout } from "./dto/dashboardCardPresentation.js";
 export type { DashboardCardPresentation as ScanCardPresentation } from "./dto/dashboardCardPresentation.js";
 export type { ScanDetailsPresentation } from "./dto/scanDetailsPresentation.js";
 export type { GitHubCheckRunPresentation, GitHubPrCommentPresentation, CliScanPresentation, } from "./dto/githubAndCliPresentation.js";
-export { presentDashboardCard, presentPipelineDashboardCard, } from "./presenters/presentDashboardCard.js";
+export { presentDashboardCard, presentPipelineDashboardCard, presentSurfacesIncompleteDashboardCard, } from "./presenters/presentDashboardCard.js";
 export { presentScanDetails } from "./presenters/presentScanDetails.js";
 export type { PresentScanDetailsContext } from "./presenters/presentScanDetails.js";
 export { presentGitHubCheckRun } from "./presenters/presentGitHubCheckRun.js";
 export { presentGitHubPrComment } from "./presenters/presentGitHubPrComment.js";
 export { presentCliScanSummary } from "./presenters/presentCliScanSummary.js";
 export { renderGitHubCheckRunMarkdown } from "./render/renderGitHubCheckRunMarkdown.js";
+export { buildGitHubCheckRunOutput, resolveWebAppOrigin, type GitHubCheckRunConclusion, type GitHubCheckRunOutput, type BuildGitHubCheckRunOutputOptions, } from "./buildGitHubCheckRunOutput.js";
 export { renderGitHubPrCommentMarkdown } from "./render/renderGitHubPrCommentMarkdown.js";
 export { renderCliScanSummaryText } from "./render/renderCliScanSummaryText.js";
 export { buildNarrativeChannels, projectCompactKeyPoints, composeHeadline, composeSubheadline, composeKeyPoints, composeVerificationActions, composeAffectedAreaLabels, composeEvidenceRows, composeSupportingContext, evidenceContextFromProfile, } from "./compose/narrativeCompose.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,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,gDAAgD;AAChD,YAAY,EAAE,yBAAyB,IAAI,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC5G,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,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,sBAAsB,EACtB,uBAAuB,EACvB,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,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,gDAAgD;AAChD,YAAY,EAAE,yBAAyB,IAAI,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC5G,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,sCAAsC,CAAC;AAC9C,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,EACL,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,gCAAgC,GACtC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,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,12 +1,13 @@
 export { buildScanPresentationBundle } from "./orchestration/buildScanPresentationBundle.js";
 export { buildScanCardPresentation } from "./orchestration/buildScanCardPresentation.js";
 export { buildScanDetailsPresentation } from "./orchestration/buildScanDetailsPresentation.js";
-export { presentDashboardCard, presentPipelineDashboardCard, } from "./presenters/presentDashboardCard.js";
+export { presentDashboardCard, presentPipelineDashboardCard, presentSurfacesIncompleteDashboardCard, } from "./presenters/presentDashboardCard.js";
 export { presentScanDetails } from "./presenters/presentScanDetails.js";
 export { presentGitHubCheckRun } from "./presenters/presentGitHubCheckRun.js";
 export { presentGitHubPrComment } from "./presenters/presentGitHubPrComment.js";
 export { presentCliScanSummary } from "./presenters/presentCliScanSummary.js";
 export { renderGitHubCheckRunMarkdown } from "./render/renderGitHubCheckRunMarkdown.js";
+export { buildGitHubCheckRunOutput, resolveWebAppOrigin, } from "./buildGitHubCheckRunOutput.js";
 export { renderGitHubPrCommentMarkdown } from "./render/renderGitHubPrCommentMarkdown.js";
 export { renderCliScanSummaryText } from "./render/renderCliScanSummaryText.js";
 export { buildNarrativeChannels, projectCompactKeyPoints, composeHeadline, composeSubheadline, composeKeyPoints, composeVerificationActions, composeAffectedAreaLabels, composeEvidenceRows, composeSupportingContext, evidenceContextFromProfile, } from "./compose/narrativeCompose.js";

package/dist/presentation/presenters/presentDashboardCard.d.ts

@@ -1,5 +1,6 @@
 import type { DashboardCardPresentation } from "../dto/dashboardCardPresentation.js";
 import type { ScanPresentationBundle } from "../orchestration/scanPresentationBundle.js";
 export declare function presentDashboardCard(bundle: ScanPresentationBundle): DashboardCardPresentation;
+export declare function presentSurfacesIncompleteDashboardCard(): DashboardCardPresentation;
 export declare function presentPipelineDashboardCard(pipelineStatus: "queued" | "running" | "failed"): DashboardCardPresentation;
 //# sourceMappingURL=presentDashboardCard.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"presentDashboardCard.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentDashboardCard.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAErF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAoEzF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,sBAAsB,GAC7B,yBAAyB,CA8C3B;AAED,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAC9C,yBAAyB,CAqB3B"}
+{"version":3,"file":"presentDashboardCard.d.ts","sourceRoot":"","sources":["../../../src/presentation/presenters/presentDashboardCard.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAErF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAoEzF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,sBAAsB,GAC7B,yBAAyB,CA8C3B;AAED,wBAAgB,sCAAsC,IAAI,yBAAyB,CAelF;AAED,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAC9C,yBAAyB,CAqB3B"}

package/dist/presentation/presenters/presentDashboardCard.js

@@ -96,6 +96,22 @@ export function presentDashboardCard(bundle) {
     };
     return normalizeDashboardCard(card);
 }
+export function presentSurfacesIncompleteDashboardCard() {
+    const headline = scanSurfaceCopy.pipeline.surfacesNotSynchronized;
+    return normalizeDashboardCard({
+        pipeline: {
+            status: "failed",
+            headline,
+            subheadline: scanSurfaceCopy.pipeline.surfacesNotSynchronizedDetail,
+        },
+        headline,
+        insights: [],
+        verification: [],
+        layout: "standard",
+        detailActionLabel: scanSurfaceCopy.presentation.actionLabelReview,
+        sortKey: { postureRank: -1, riskIndex: -1 },
+    });
+}
 export function presentPipelineDashboardCard(pipelineStatus) {
     const isRunning = pipelineStatus === "queued" || pipelineStatus === "running";
     const headline = isRunning

package/dist/scanCardPresentationState.d.ts

@@ -1,4 +1,10 @@
-/** Dashboard PR card lifecycle — distinct from pipeline status. */
-export type ScanCardPresentationState = "not_scanned" | "scanning" | "analysis_failed" | "ready" | "stale";
+/**
+ * Dashboard PR card lifecycle — distinct from pipeline status.
+ *
+ * Pipeline / infrastructure: `scanning`, `analysis_failed`, `surfaces_incomplete`
+ * Product / assessment: `ready`, `stale`
+ * Absence: `not_scanned`
+ */
+export type ScanCardPresentationState = "not_scanned" | "scanning" | "analysis_failed" | "surfaces_incomplete" | "ready" | "stale";
 export declare function staleScanSubline(): string;
 //# sourceMappingURL=scanCardPresentationState.d.ts.map

package/dist/scanCardPresentationState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanCardPresentationState.d.ts","sourceRoot":"","sources":["../src/scanCardPresentationState.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,MAAM,yBAAyB,GACjC,aAAa,GACb,UAAU,GACV,iBAAiB,GACjB,OAAO,GACP,OAAO,CAAC;AAIZ,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}
+{"version":3,"file":"scanCardPresentationState.d.ts","sourceRoot":"","sources":["../src/scanCardPresentationState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GACjC,aAAa,GACb,UAAU,GACV,iBAAiB,GACjB,qBAAqB,GACrB,OAAO,GACP,OAAO,CAAC;AAIZ,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/scanSurfaceCopy.d.ts

@@ -8,6 +8,8 @@ export declare const scanSurfaceCopy: {
         readonly scanIncomplete: "Waiting for scan results";
         readonly scanUnavailable: "Scan data unavailable";
         readonly analysisIncomplete: "Analysis could not be completed";
+        readonly surfacesNotSynchronized: "Analysis complete - GitHub check not synchronized";
+        readonly surfacesNotSynchronizedDetail: "Scan results are saved; the GitHub Check Run will appear after publishing completes.";
         readonly outputNotVerified: "These results could not be verified";
     };
     readonly actions: {

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuClF,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;;;;;;;;;;;;;;;;QAoBxB,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

@@ -8,6 +8,8 @@ export const scanSurfaceCopy = {
         scanIncomplete: "Waiting for scan results",
         scanUnavailable: "Scan data unavailable",
         analysisIncomplete: "Analysis could not be completed",
+        surfacesNotSynchronized: "Analysis complete - GitHub check not synchronized",
+        surfacesNotSynchronizedDetail: "Scan results are saved; the GitHub Check Run will appear after publishing completes.",
         outputNotVerified: "These results could not be verified",
     },
     actions: {

package/package.json

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