@mergesignal/shared 0.2.2 → 0.2.4

package/dist/deriveScanDetailRecommendations.d.ts

@@ -0,0 +1,63 @@
+import { type ObservationSignalFamily } from "./cardObservationCatalog.js";
+import { type MergePosture } from "./riskVocabulary.js";
+import type { ScanResult } from "./types.js";
+export declare const RECOMMENDATION_MAX_ITEMS = 3;
+export declare const RECOMMENDATION_MAX_TITLE_CHARS = 80;
+export declare const RECOMMENDATION_PREFER_MAX_ON_SAFE = 2;
+export declare const RECOMMENDATION_MAX_SIGNALS = 4;
+export declare const RECOMMENDATION_MAX_PACKAGES = 5;
+export type RecommendationPriority = "high" | "medium" | "low";
+/** @deprecated Use RecommendationPriority */
+export type GuidanceUrgency = RecommendationPriority;
+export type GuidanceSource = "insight" | "recommendation" | "signal" | "finding" | "posture_playbook";
+export type ScanDetailRecommendationDetail = {
+    why: string;
+    whyNow: string;
+    signals: string[];
+    affectedPackages?: {
+        names: string[];
+        overflowCount: number;
+    };
+    expectedBenefit: string;
+};
+export type ScanDetailRecommendation = {
+    id: string;
+    rank: number;
+    title: string;
+    priority: RecommendationPriority;
+    source: GuidanceSource;
+    signalFamily?: ObservationSignalFamily | null;
+    detail: ScanDetailRecommendationDetail;
+    proofRefs?: {
+        findingIds?: string[];
+    };
+};
+export type ScanDetailRecommendationCenter = {
+    heading: string;
+    defaultSelectedId: string;
+    items: ScanDetailRecommendation[];
+    posture: MergePosture | null;
+    scanContext?: string;
+};
+/** @deprecated Use ScanDetailRecommendationCenter */
+export type ScanDetailWhatToDo = {
+    items: Array<{
+        id: string;
+        label: string;
+        emphasis: "primary" | "secondary";
+        priority: RecommendationPriority;
+        source: GuidanceSource;
+    }>;
+    posture: MergePosture | null;
+};
+export declare const GUIDANCE_ACTION_FOR_FAMILY: Record<ObservationSignalFamily, string>;
+/** Derive the scan detail recommendation center — always returns 1–3 enriched items. */
+export declare function deriveScanDetailRecommendations(result: ScanResult): ScanDetailRecommendationCenter;
+export declare function recommendationTitlesForDedupe(center: ScanDetailRecommendationCenter): Set<string>;
+export declare function findingIdsCoveredByRecommendations(center: ScanDetailRecommendationCenter): Set<string>;
+export declare function verifyLabelsForDedupe(center: ScanDetailRecommendationCenter): Set<string>;
+/** @deprecated Use deriveScanDetailRecommendations */
+export declare function deriveScanDetailGuidance(result: ScanResult): ScanDetailWhatToDo;
+/** @deprecated Use recommendationTitlesForDedupe */
+export declare function guidanceLabelsForDedupe(whatToDo: ScanDetailWhatToDo): Set<string>;
+//# sourceMappingURL=deriveScanDetailRecommendations.d.ts.map

package/dist/deriveScanDetailRecommendations.d.ts.map

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