@mergesignal/shared 0.2.7 → 0.3.0

package/dist/presentScanCardSummary.js

@@ -1,35 +1,11 @@
-import { phraseForFamily, } from "./cardObservationCatalog.js";
-import { aggregateFindingCounts, deriveRiskIndexBand, } from "./scanCardSummary.js";
+import { isCatalogPhrase, phraseForFamily, } from "./cardObservationCatalog.js";
+import { aggregateFindingCounts, deriveRiskIndexBand, SCAN_CARD_SCANNING_SUMMARY, } from "./scanCardSummary.js";
 import { deriveCardExposureDisplay, } from "./formatCardExposureDisplay.js";
 import { formatCardAreaLabels } from "./formatCardAreaLabels.js";
+import { composeContextLineFromFacts, composeVerificationPrompt, formatBlastRadiusDetailLine, formatChangedPackagesShort, formatFrameworksSummary, formatUsageSummaryLine, labelBlastRadiusLevel, labelReachabilityKind, labelRuntimeSurface, } from "./narrativePresentation.js";
+import { normalizeGeneratedText, normalizeGeneratedTextNullable, } from "./normalizeGeneratedText.js";
 import { MERGE_POSTURE_LABEL } from "./riskVocabulary.js";
 import { scanSurfaceCopy } from "./scanSurfaceCopy.js";
-function formatChangedPackagesDisplay(facts) {
-    const { primary, others } = facts.changedPackages;
-    if (!primary)
-        return null;
-    if (others.length === 0)
-        return primary;
-    return `${primary} +${others.length}`;
-}
-function labelRuntimeSurface(facts) {
-    const rs = facts.runtimeSurface;
-    if (!rs)
-        return null;
-    return scanSurfaceCopy.narrativeCard.runtimeSurface[rs.kind];
-}
-function labelReachability(facts) {
-    const r = facts.reachability;
-    if (!r)
-        return null;
-    return scanSurfaceCopy.narrativeCard.reachability[r.kind];
-}
-function labelBlastRadius(facts) {
-    const br = facts.blastRadius;
-    if (!br)
-        return null;
-    return scanSurfaceCopy.narrativeCard.blastRadius[br.level];
-}
 function formatAffectedAreaLabels(facts) {
     const ordered = [];
     for (const area of facts.affectedAreas) {
@@ -62,7 +38,7 @@ function selectSecondaryLines(facts, exclude) {
     }
     return lines;
 }
-function repositoryContextPhrases(facts) {
+function repositoryContextPhrases(facts, max) {
     const phrases = [];
     const seen = new Set();
     for (const ctx of facts.repositoryContext) {
@@ -71,32 +47,13 @@ function repositoryContextPhrases(facts) {
             continue;
         seen.add(phrase);
         phrases.push(phrase);
-        if (phrases.length >= 3)
+        if (phrases.length >= max)
             break;
     }
     return phrases;
 }
-function composeContextLine(facts) {
-    const parts = [];
-    const runtime = labelRuntimeSurface(facts);
-    const reach = labelReachability(facts);
-    const blast = labelBlastRadius(facts);
-    if (runtime)
-        parts.push(runtime);
-    if (reach)
-        parts.push(reach);
-    if (blast)
-        parts.push(blast);
-    const areas = formatAffectedAreaLabels(facts);
-    if (areas.length > 0) {
-        parts.push(areas.join(scanSurfaceCopy.narrativeCard.areasSeparator));
-    }
-    if (parts.length === 0)
-        return null;
-    return parts.join(scanSurfaceCopy.narrativeCard.contextSeparator);
-}
-function buildLegacyObservations(facts, primaryInsight) {
-    const repoPhrases = repositoryContextPhrases(facts);
+function buildLegacyObservations(facts, primaryInsight, repoPhraseCap) {
+    const repoPhrases = repositoryContextPhrases(facts, repoPhraseCap);
     const secondary = selectSecondaryLines(facts, primaryInsight);
     if (primaryInsight) {
         return {
@@ -110,10 +67,34 @@ function buildLegacyObservations(facts, primaryInsight) {
         return { operationalObservations: [], supportingLine: null };
     }
     return {
-        operationalObservations: repoPhrases.slice(0, 3),
+        operationalObservations: repoPhrases.slice(0, repoPhraseCap),
         supportingLine: repoPhrases.length === 1 ? (secondary[0] ?? null) : null,
     };
 }
+function normalizeCardSummary(summary) {
+    return {
+        ...summary,
+        headline: normalizeGeneratedText(summary.headline),
+        summaryLine: normalizeGeneratedTextNullable(summary.summaryLine),
+        supportingLine: normalizeGeneratedTextNullable(summary.supportingLine),
+        changedPackagesDisplay: normalizeGeneratedTextNullable(summary.changedPackagesDisplay),
+        runtimeSurfaceLabel: normalizeGeneratedTextNullable(summary.runtimeSurfaceLabel),
+        reachabilityLabel: normalizeGeneratedTextNullable(summary.reachabilityLabel),
+        blastRadiusLabel: normalizeGeneratedTextNullable(summary.blastRadiusLabel),
+        primaryInsight: normalizeGeneratedTextNullable(summary.primaryInsight),
+        structuralOnlyDisclaimer: normalizeGeneratedTextNullable(summary.structuralOnlyDisclaimer),
+        usageSummary: normalizeGeneratedTextNullable(summary.usageSummary),
+        verificationLine: normalizeGeneratedTextNullable(summary.verificationLine),
+        blastRadiusDetail: normalizeGeneratedTextNullable(summary.blastRadiusDetail),
+        frameworksSummary: normalizeGeneratedTextNullable(summary.frameworksSummary),
+        affectedAreas: summary.affectedAreas.map((a) => normalizeGeneratedText(a)),
+        topAffectedAreas: summary.topAffectedAreas.map((a) => normalizeGeneratedText(a)),
+        operationalObservations: summary.operationalObservations.map((p) => {
+            const normalized = normalizeGeneratedText(p);
+            return isCatalogPhrase(normalized) ? normalized : p;
+        }),
+    };
+}
 /**
  * Dashboard card presentation DTO from consumer-agnostic facts.
  */
@@ -129,23 +110,27 @@ export function presentScanCardSummary(facts, options = {}) {
         affectedAreas: [],
         primaryInsight: null,
         structuralOnlyDisclaimer: null,
+        usageSummary: null,
+        verificationLine: null,
+        blastRadiusDetail: null,
+        frameworksSummary: null,
     };
     if (pipelineStatus === "queued" || pipelineStatus === "running") {
-        return {
+        return normalizeCardSummary({
             mergePosture: null,
             riskIndex: null,
             riskIndexBand: null,
             headline: scanSurfaceCopy.pipeline.scanRunning,
-            summaryLine: "Waiting for results…",
+            summaryLine: SCAN_CARD_SCANNING_SUMMARY,
             findingCounts: null,
             topAffectedAreas: [],
             operationalObservations: [],
             supportingLine: null,
             ...emptyPresentationFields,
-        };
+        });
     }
     if (pipelineStatus === "failed") {
-        return {
+        return normalizeCardSummary({
             mergePosture: null,
             riskIndex: null,
             riskIndexBand: null,
@@ -156,7 +141,7 @@ export function presentScanCardSummary(facts, options = {}) {
             operationalObservations: [],
             supportingLine: null,
             ...emptyPresentationFields,
-        };
+        });
     }
     const posture = facts.mergePosture;
     const riskIndex = facts.riskIndex;
@@ -167,12 +152,17 @@ export function presentScanCardSummary(facts, options = {}) {
     const findingCounts = options.findings
         ? aggregateFindingCounts(options.findings)
         : null;
-    const changedPackagesDisplay = formatChangedPackagesDisplay(facts);
+    const prIntelligence = facts.availability.mode === "pr_intelligence" ||
+        facts.availability.tiersPresent.tier1;
+    const changedPackagesDisplay = formatChangedPackagesShort(facts, 2);
     const runtimeSurfaceLabel = labelRuntimeSurface(facts);
-    const reachabilityLabel = labelReachability(facts);
-    const blastRadiusLabel = labelBlastRadius(facts);
+    const reachabilityLabel = labelReachabilityKind(facts);
+    const blastRadiusLabel = labelBlastRadiusLevel(facts);
     const affectedAreas = formatAffectedAreaLabels(facts);
-    const contextLine = composeContextLine(facts);
+    const contextLine = composeContextLineFromFacts(facts, {
+        includePathSample: prIntelligence,
+        maxAreas: 2,
+    });
     const structuralOnlyDisclaimer = facts.availability.mode === "graph_fallback" &&
         !facts.availability.tiersPresent.tier1
         ? scanSurfaceCopy.narrativeCard.structuralOnlyDisclaimer
@@ -180,8 +170,19 @@ export function presentScanCardSummary(facts, options = {}) {
     const insightMessage = selectPrimaryInsight(facts);
     const primaryInsight = insightMessage ??
         (facts.availability.mode !== "graph_fallback" ? contextLine : null);
-    const { operationalObservations, supportingLine } = buildLegacyObservations(facts, primaryInsight);
-    return {
+    const usageSummary = prIntelligence ? formatUsageSummaryLine(facts, 1) : null;
+    const verificationLine = prIntelligence
+        ? composeVerificationPrompt(facts)
+        : null;
+    const blastRadiusDetail = prIntelligence
+        ? formatBlastRadiusDetailLine(facts, 1)
+        : null;
+    const frameworksSummary = prIntelligence
+        ? formatFrameworksSummary(facts, 2)
+        : null;
+    const repoPhraseCap = prIntelligence ? 0 : 3;
+    const { operationalObservations, supportingLine } = buildLegacyObservations(facts, primaryInsight, repoPhraseCap);
+    return normalizeCardSummary({
         mergePosture: posture,
         riskIndex,
         riskIndexBand,
@@ -200,7 +201,11 @@ export function presentScanCardSummary(facts, options = {}) {
         affectedAreas,
         primaryInsight,
         structuralOnlyDisclaimer,
-    };
+        usageSummary,
+        verificationLine,
+        blastRadiusDetail,
+        frameworksSummary,
+    });
 }
 export function exposureFromFacts(facts) {
     return deriveCardExposureDisplay(facts.riskIndex) ?? null;

package/dist/repoIntelligenceMappers.d.ts

@@ -0,0 +1,20 @@
+import type { BlastRadiusLevel, ReachabilityKind, RuntimeSurfaceKind } from "./scanNarrativeFacts.js";
+/** Engine-internal blast radius vocabulary → canonical wire. */
+export type EngineBlastRadiusLevel = "small" | "moderate" | "large";
+/** Engine-internal reachability spread buckets. */
+export type EngineReachabilityBucket = "very_low" | "low" | "moderate" | "high";
+/** Engine-internal runtime surface labels. */
+export type EngineRuntimeSurface = "runtime" | "test" | "build" | "dev" | "ci";
+export declare function mapBlastRadiusLevel(level: EngineBlastRadiusLevel): BlastRadiusLevel;
+export declare function mapRuntimeSurfaceKind(surface: EngineRuntimeSurface): RuntimeSurfaceKind;
+/**
+ * Maps engine reachability spread + runtime classification to narrative reachability kind.
+ * Documented in repoIntelligenceSchema.ts header.
+ */
+export declare function mapReachabilityKind(input: {
+    bucket: EngineReachabilityBucket;
+    reachesRuntime: boolean;
+    dominantSurface: EngineRuntimeSurface;
+}): ReachabilityKind;
+export declare function areaSlugToLabel(slug: string): string;
+//# sourceMappingURL=repoIntelligenceMappers.d.ts.map

package/dist/repoIntelligenceMappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repoIntelligenceMappers.d.ts","sourceRoot":"","sources":["../src/repoIntelligenceMappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpE,mDAAmD;AACnD,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC;AAEhF,8CAA8C;AAC9C,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;AAE/E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,sBAAsB,GAC5B,gBAAgB,CAalB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CAapB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,wBAAwB,CAAC;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,oBAAoB,CAAC;CACvC,GAAG,gBAAgB,CAwBnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/repoIntelligenceMappers.js

@@ -0,0 +1,60 @@
+export function mapBlastRadiusLevel(level) {
+    switch (level) {
+        case "small":
+            return "narrow";
+        case "moderate":
+            return "moderate";
+        case "large":
+            return "wide";
+        default: {
+            const x = level;
+            return x;
+        }
+    }
+}
+export function mapRuntimeSurfaceKind(surface) {
+    switch (surface) {
+        case "runtime":
+            return "runtime";
+        case "test":
+            return "test";
+        case "build":
+        case "dev":
+        case "ci":
+            return "build";
+        default:
+            return "unknown";
+    }
+}
+/**
+ * Maps engine reachability spread + runtime classification to narrative reachability kind.
+ * Documented in repoIntelligenceSchema.ts header.
+ */
+export function mapReachabilityKind(input) {
+    const { bucket, reachesRuntime, dominantSurface } = input;
+    if (dominantSurface === "test" && !reachesRuntime) {
+        return "test_only";
+    }
+    if ((dominantSurface === "build" ||
+        dominantSurface === "dev" ||
+        dominantSurface === "ci") &&
+        !reachesRuntime) {
+        return "build_only";
+    }
+    if (reachesRuntime) {
+        return "on_runtime_paths";
+    }
+    if (bucket === "very_low" || bucket === "low") {
+        return "unreachable";
+    }
+    if (bucket === "moderate" || bucket === "high") {
+        return "on_runtime_paths";
+    }
+    return "unknown";
+}
+export function areaSlugToLabel(slug) {
+    return slug
+        .split("_")
+        .map((w) => (w ? w[0].toUpperCase() + w.slice(1) : w))
+        .join(" ");
+}

package/dist/repoIntelligenceSchema.contract.test.d.ts

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

package/dist/repoIntelligenceSchema.contract.test.d.ts.map

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

package/dist/repoIntelligenceSchema.contract.test.js

@@ -0,0 +1,19 @@
+import { describe, expect, it } from "vitest";
+import { fixtureRepoIntelligenceFastify, fixtureRepoIntelligenceMultiPackage, } from "./fixtures/repoIntelligenceFixtures.js";
+import { legacyEngineRepoIntelligenceJwt } from "./fixtures/legacyEngineRepoIntelligence.js";
+import { safeParseRepoIntelligence, validateRepoIntelligenceWire, } from "./repoIntelligenceSchema.js";
+describe("repoIntelligenceWireSchema contract", () => {
+    it("accepts canonical consumer fixtures", () => {
+        expect(() => validateRepoIntelligenceWire(fixtureRepoIntelligenceFastify)).not.toThrow();
+        expect(() => validateRepoIntelligenceWire(fixtureRepoIntelligenceMultiPackage)).not.toThrow();
+    });
+    it("rejects legacy engine wire (name, large blast, object frameworks, file hotspots)", () => {
+        const r = safeParseRepoIntelligence(legacyEngineRepoIntelligenceJwt);
+        expect(r.ok).toBe(false);
+        if (r.ok)
+            return;
+        expect(r.issueCount).toBeGreaterThan(0);
+        const joined = r.issues.join(" ");
+        expect(joined.length).toBeGreaterThan(0);
+    });
+});

package/dist/repoIntelligenceSchema.d.ts

@@ -1,106 +1,64 @@
+/**
+ * Canonical `ScanResult.repoIntelligence` wire contract (Wave 1 + Wave 2).
+ *
+ * Bump {@link REPO_INTELLIGENCE_ABI} when this schema changes incompatibly.
+ * Engine maps internal signals to this shape at emit time; consumers must use
+ * {@link safeParseRepoIntelligence} and honor `analysisPreparation.repoIntelligenceValidation`.
+ */
 import { z } from "zod";
-import type { BlastRadiusLevel, ReachabilityKind, RuntimeSurfaceKind } from "./scanNarrativeFacts.js";
-declare const looseSurfaceSchema: z.ZodUnion<readonly [z.ZodEnum<{
-    unknown: "unknown";
-    runtime: "runtime";
-    build: "build";
-    test: "test";
-}>, z.ZodString, z.ZodObject<{
-    kind: z.ZodString;
-}, z.core.$loose>]>;
-declare const looseReachabilitySchema: z.ZodUnion<readonly [z.ZodEnum<{
-    unknown: "unknown";
-    on_runtime_paths: "on_runtime_paths";
-    build_only: "build_only";
-    test_only: "test_only";
-    unreachable: "unreachable";
-}>, z.ZodString, z.ZodObject<{
-    kind: z.ZodString;
-}, z.core.$loose>]>;
-export declare const repoIntelligenceSchema: z.ZodObject<{
-    packages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        runtimeSurface: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+import type { ScanResult } from "./types.js";
+import type { BlastRadiusLevel } from "./scanNarrativeFacts.js";
+/** Bump when wire schema changes incompatibly. */
+export declare const REPO_INTELLIGENCE_ABI: "1";
+/** Strict canonical wire schema — single source of truth. */
+export declare const repoIntelligenceWireSchema: z.ZodObject<{
+    packages: z.ZodRecord<z.ZodString, z.ZodObject<{
+        runtimeSurface: z.ZodEnum<{
             unknown: "unknown";
             runtime: "runtime";
             build: "build";
             test: "test";
-        }>, z.ZodString, z.ZodObject<{
-            kind: z.ZodString;
-        }, z.core.$loose>]>>;
-        reachability: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        }>;
+        reachability: z.ZodEnum<{
             unknown: "unknown";
             on_runtime_paths: "on_runtime_paths";
             build_only: "build_only";
             test_only: "test_only";
             unreachable: "unreachable";
-        }>, z.ZodString, z.ZodObject<{
-            kind: z.ZodString;
-        }, z.core.$loose>]>>;
-        packageUsage: z.ZodOptional<z.ZodObject<{
-            packageName: z.ZodOptional<z.ZodString>;
-            package: z.ZodOptional<z.ZodString>;
-            files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }>;
+        usage: z.ZodObject<{
+            packageName: z.ZodString;
+            files: z.ZodArray<z.ZodString>;
             paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
             criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
             areas: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$loose>>;
-        usage: z.ZodOptional<z.ZodObject<{
-            packageName: z.ZodOptional<z.ZodString>;
-            package: z.ZodOptional<z.ZodString>;
-            files: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            areas: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$loose>>;
+        }, z.core.$strip>;
         areas: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        hotspots: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            packageName: z.ZodOptional<z.ZodString>;
-            paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            depth: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$loose>>>;
-    }, z.core.$loose>>>;
+    }, z.core.$strip>>;
     packageUsage: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        packageName: z.ZodOptional<z.ZodString>;
-        package: z.ZodOptional<z.ZodString>;
-        files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        packageName: z.ZodString;
+        files: z.ZodArray<z.ZodString>;
         paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
         criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
         areas: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$loose>>>;
+    }, z.core.$strip>>>;
     blastRadius: z.ZodOptional<z.ZodObject<{
-        level: z.ZodOptional<z.ZodEnum<{
+        level: z.ZodEnum<{
             moderate: "moderate";
             narrow: "narrow";
             wide: "wide";
-        }>>;
+        }>;
         factors: z.ZodOptional<z.ZodArray<z.ZodString>>;
         changedPackageCount: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$loose>>;
-    runtimeSurface: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-        unknown: "unknown";
-        runtime: "runtime";
-        build: "build";
-        test: "test";
-    }>, z.ZodString, z.ZodObject<{
-        kind: z.ZodString;
-    }, z.core.$loose>]>>;
-    reachability: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-        unknown: "unknown";
-        on_runtime_paths: "on_runtime_paths";
-        build_only: "build_only";
-        test_only: "test_only";
-        unreachable: "unreachable";
-    }>, z.ZodString, z.ZodObject<{
-        kind: z.ZodString;
-    }, z.core.$loose>]>>;
+    }, z.core.$strip>>;
     applicationAreas: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
-    }, z.core.$loose>>>;
+    }, z.core.$strip>>>;
     affectedAreas: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
-    }, z.core.$loose>>>;
+    }, z.core.$strip>>>;
     hotspots: z.ZodOptional<z.ZodArray<z.ZodObject<{
         packageName: z.ZodString;
         source: z.ZodOptional<z.ZodEnum<{
@@ -108,16 +66,27 @@ export declare const repoIntelligenceSchema: z.ZodObject<{
             graph: "graph";
         }>>;
         depth: z.ZodOptional<z.ZodNumber>;
-        paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$loose>>>;
+        paths: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
     frameworks: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$loose>;
-export type RepoIntelligence = z.infer<typeof repoIntelligenceSchema>;
-export declare function parseRepoIntelligence(raw: unknown): RepoIntelligence | null;
-export declare function normalizeRuntimeSurfaceKind(raw: string | undefined): RuntimeSurfaceKind;
-export declare function normalizeReachabilityKind(raw: string | undefined): ReachabilityKind;
-export declare function readSurfaceFromLoose(value: z.infer<typeof looseSurfaceSchema> | undefined): RuntimeSurfaceKind | null;
-export declare function readReachabilityFromLoose(value: z.infer<typeof looseReachabilitySchema> | undefined): ReachabilityKind | null;
+}, z.core.$strip>;
+export type RepoIntelligence = z.infer<typeof repoIntelligenceWireSchema>;
+export type ParseRepoIntelligenceSuccess = {
+    ok: true;
+    value: RepoIntelligence;
+};
+export type ParseRepoIntelligenceFailure = {
+    ok: false;
+    issues: string[];
+    issueCount: number;
+    packageCount: number;
+};
+export type ParseRepoIntelligenceResult = ParseRepoIntelligenceSuccess | ParseRepoIntelligenceFailure;
+export declare function countRepoIntelligencePackages(raw: unknown): number;
+export declare function safeParseRepoIntelligence(raw: unknown): ParseRepoIntelligenceResult;
+/** Throws when wire block is present but invalid (CI / tests only). */
+export declare function validateRepoIntelligenceWire(raw: unknown): RepoIntelligence;
+/** CI helper — fails test when engine output includes invalid repoIntelligence. */
+export declare function assertEngineOutputRepoIntelligenceValid(scan: ScanResult): void;
 export declare function readBlastLevel(level: BlastRadiusLevel | undefined): BlastRadiusLevel | null;
-export {};
 //# sourceMappingURL=repoIntelligenceSchema.d.ts.map

package/dist/repoIntelligenceSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repoIntelligenceSchema.d.ts","sourceRoot":"","sources":["../src/repoIntelligenceSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAcjC,QAAA,MAAM,kBAAkB;;;;;;;mBAItB,CAAC;AAEH,QAAA,MAAM,uBAAuB;;;;;;;;mBAI3B,CAAC;AAyCH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BnB,CAAC;AAEjB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAc3E;AAuBD,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,kBAAkB,CAUpB;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,gBAAgB,CAgBlB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GAAG,SAAS,GACpD,kBAAkB,GAAG,IAAI,CAO3B;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,GAAG,SAAS,GACzD,gBAAgB,GAAG,IAAI,CAOzB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAClC,gBAAgB,GAAG,IAAI,CAKzB"}
+{"version":3,"file":"repoIntelligenceSchema.d.ts","sourceRoot":"","sources":["../src/repoIntelligenceSchema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,EAAG,GAAY,CAAC;AA+ClD,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQrC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE1E,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GACnC,4BAA4B,GAC5B,4BAA4B,CAAC;AAQjC,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAUlE;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,GACX,2BAA2B,CAyC7B;AAED,uEAAuE;AACvE,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAM3E;AAED,mFAAmF;AACnF,wBAAgB,uCAAuC,CACrD,IAAI,EAAE,UAAU,GACf,IAAI,CAGN;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAClC,gBAAgB,GAAG,IAAI,CAKzB"}