@mergesignal/shared 0.4.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: [],
@@ -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/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,6 +14,7 @@ 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";

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,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"}
+{"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,6 +14,7 @@ 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";

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/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;AA+FF,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;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"}

package/dist/presentation/profile/derivePresentationProfile.js

@@ -35,7 +35,9 @@ function deriveDensity(facts, priority) {
     if (priority === "limited") {
         return hasHighSeverityFindings(facts) ? "standard" : "minimal";
     }
-    const runtime = facts.runtimeSurface?.kind === "runtime";
+    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;
@@ -43,7 +45,13 @@ function deriveDensity(facts, priority) {
     if (runtime && (wideOrModerate || hasAreas || hasRuntimePaths)) {
         return "rich";
     }
-    const buildOnly = facts.runtimeSurface?.kind === "build" ||
+    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) {

package/dist/repoIntelligenceMappers.d.ts.map

@@ -1 +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"}
+{"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,CAgCnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/repoIntelligenceMappers.js

@@ -48,7 +48,14 @@ export function mapReachabilityKind(input) {
         return "unreachable";
     }
     if (bucket === "moderate" || bucket === "high") {
-        return "on_runtime_paths";
+        if (dominantSurface === "test")
+            return "test_only";
+        if (dominantSurface === "build" ||
+            dominantSurface === "dev" ||
+            dominantSurface === "ci") {
+            return "build_only";
+        }
+        return "unknown";
     }
     return "unknown";
 }

package/dist/repoIntelligenceSchema.d.ts

@@ -9,7 +9,7 @@ import { z } from "zod";
 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";
+export declare const REPO_INTELLIGENCE_ABI: "2";
 /** Strict canonical wire schema — single source of truth. */
 export declare const repoIntelligenceWireSchema: z.ZodObject<{
     packages: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -34,6 +34,73 @@ export declare const repoIntelligenceWireSchema: z.ZodObject<{
             areas: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>;
         areas: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        dependencyClass: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            runtime: "runtime";
+            build: "build";
+            test: "test";
+            format: "format";
+            tooling: "tooling";
+            lint: "lint";
+            ci: "ci";
+        }>>;
+        packageRole: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            typechecker: "typechecker";
+            compiler: "compiler";
+            bundler: "bundler";
+            linter: "linter";
+            formatter: "formatter";
+            test_runner: "test_runner";
+            http_framework: "http_framework";
+            auth: "auth";
+            queue: "queue";
+            orm: "orm";
+        }>>;
+        lockfileKind: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            optional: "optional";
+            production: "production";
+            development: "development";
+        }>>;
+        runtimeImpact: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            confirmed: "confirmed";
+            none: "none";
+            possible: "possible";
+        }>>;
+        expectedImpact: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            runtime: "runtime";
+            build_time: "build_time";
+            typecheck: "typecheck";
+            test_time: "test_time";
+            development_only: "development_only";
+        }>>;
+        evidenceStrength: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        confidenceReason: z.ZodOptional<z.ZodString>;
+        verificationFocus: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        suppressRuntimeNarrative: z.ZodOptional<z.ZodBoolean>;
+        classificationProvenance: z.ZodOptional<z.ZodObject<{
+            dependencyClass: z.ZodEnum<{
+                unknown: "unknown";
+                graph: "graph";
+                registry: "registry";
+                lockfile: "lockfile";
+                heuristic: "heuristic";
+            }>;
+            packageRole: z.ZodEnum<{
+                unknown: "unknown";
+                graph: "graph";
+                registry: "registry";
+                heuristic: "heuristic";
+            }>;
+            registryEntryId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     packageUsage: z.ZodOptional<z.ZodArray<z.ZodObject<{
         packageName: z.ZodString;
@@ -69,6 +136,13 @@ export declare const repoIntelligenceWireSchema: z.ZodObject<{
         paths: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>>;
     frameworks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    semanticDiagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        ruleId: z.ZodString;
+        before: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        after: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type RepoIntelligence = z.infer<typeof repoIntelligenceWireSchema>;
 export type ParseRepoIntelligenceSuccess = {

package/dist/repoIntelligenceSchema.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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+HlD,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASrC,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"}

package/dist/repoIntelligenceSchema.js

@@ -7,7 +7,7 @@
  */
 import { z } from "zod";
 /** Bump when wire schema changes incompatibly. */
-export const REPO_INTELLIGENCE_ABI = "1";
+export const REPO_INTELLIGENCE_ABI = "2";
 const surfaceKindSchema = z.enum(["runtime", "build", "test", "unknown"]);
 const reachabilityKindSchema = z.enum([
     "on_runtime_paths",
@@ -24,11 +24,83 @@ const packageUsageWireSchema = z.object({
     criticalPaths: z.array(z.string()).optional(),
     areas: z.array(z.string()).optional(),
 });
+const dependencyClassSchema = z.enum([
+    "runtime",
+    "tooling",
+    "test",
+    "lint",
+    "format",
+    "build",
+    "ci",
+    "unknown",
+]);
+const packageRoleSchema = z.enum([
+    "typechecker",
+    "compiler",
+    "bundler",
+    "linter",
+    "formatter",
+    "test_runner",
+    "http_framework",
+    "auth",
+    "queue",
+    "orm",
+    "unknown",
+]);
+const lockfileKindSchema = z.enum([
+    "production",
+    "development",
+    "optional",
+    "unknown",
+]);
+const runtimeImpactSchema = z.enum([
+    "none",
+    "possible",
+    "confirmed",
+    "unknown",
+]);
+const expectedImpactSchema = z.enum([
+    "runtime",
+    "build_time",
+    "typecheck",
+    "test_time",
+    "development_only",
+    "unknown",
+]);
+const evidenceStrengthSchema = z.enum(["high", "medium", "low"]);
+const classificationProvenanceSchema = z.object({
+    dependencyClass: z.enum([
+        "registry",
+        "graph",
+        "lockfile",
+        "heuristic",
+        "unknown",
+    ]),
+    packageRole: z.enum(["registry", "graph", "heuristic", "unknown"]),
+    registryEntryId: z.string().optional(),
+});
+const semanticDiagnosticSchema = z.object({
+    packageName: z.string().min(1),
+    ruleId: z.string().min(1),
+    before: z.record(z.string(), z.unknown()),
+    after: z.record(z.string(), z.unknown()),
+    reason: z.string().min(1),
+});
 const packageIntelWireSchema = z.object({
     runtimeSurface: surfaceKindSchema,
     reachability: reachabilityKindSchema,
     usage: packageUsageWireSchema,
     areas: z.array(z.string()).optional(),
+    dependencyClass: dependencyClassSchema.optional(),
+    packageRole: packageRoleSchema.optional(),
+    lockfileKind: lockfileKindSchema.optional(),
+    runtimeImpact: runtimeImpactSchema.optional(),
+    expectedImpact: expectedImpactSchema.optional(),
+    evidenceStrength: evidenceStrengthSchema.optional(),
+    confidenceReason: z.string().optional(),
+    verificationFocus: z.array(z.string()).optional(),
+    suppressRuntimeNarrative: z.boolean().optional(),
+    classificationProvenance: classificationProvenanceSchema.optional(),
 });
 const areaSchema = z.object({
     id: z.string().min(1),
@@ -54,6 +126,7 @@ export const repoIntelligenceWireSchema = z.object({
     affectedAreas: z.array(areaSchema).optional(),
     hotspots: z.array(hotspotWireSchema).optional(),
     frameworks: z.array(z.string().min(1)).optional(),
+    semanticDiagnostics: z.array(semanticDiagnosticSchema).optional(),
 });
 function formatZodIssues(error) {
     return error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`);

package/dist/repoIntelligenceSemantics.d.ts

@@ -0,0 +1,29 @@
+import type { RepoIntelligence } from "./repoIntelligenceSchema.js";
+export type DependencyClass = "runtime" | "tooling" | "test" | "lint" | "format" | "build" | "ci" | "unknown";
+export type PackageRole = "typechecker" | "compiler" | "bundler" | "linter" | "formatter" | "test_runner" | "http_framework" | "auth" | "queue" | "orm" | "unknown";
+export type LockfileKind = "production" | "development" | "optional" | "unknown";
+export type RuntimeImpact = "none" | "possible" | "confirmed" | "unknown";
+export type ExpectedImpact = "runtime" | "build_time" | "typecheck" | "test_time" | "development_only" | "unknown";
+export type EvidenceStrength = "high" | "medium" | "low";
+export type ClassificationSource = "registry" | "graph" | "lockfile" | "heuristic" | "unknown";
+export type SemanticDiagnostic = {
+    packageName: string;
+    ruleId: string;
+    before: Record<string, unknown>;
+    after: Record<string, unknown>;
+    reason: string;
+};
+export type SanitizeRepoIntelligenceResult = {
+    wire: RepoIntelligence;
+    diagnostics: SemanticDiagnostic[];
+    degradedPackages: string[];
+};
+type PackageRow = RepoIntelligence["packages"][string];
+/**
+ * Hard gate: normalize contradictory package intelligence before wire emit.
+ */
+export declare function sanitizeRepoIntelligenceSemantics(draft: RepoIntelligence): SanitizeRepoIntelligenceResult;
+/** Returns true when wire is safe for runtime narrative tier1. */
+export declare function isRuntimeNarrativeSafe(row: PackageRow | undefined): boolean;
+export {};
+//# sourceMappingURL=repoIntelligenceSemantics.d.ts.map

package/dist/repoIntelligenceSemantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repoIntelligenceSemantics.d.ts","sourceRoot":"","sources":["../src/repoIntelligenceSemantics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,SAAS,GACT,MAAM,GACN,MAAM,GACN,QAAQ,GACR,OAAO,GACP,IAAI,GACJ,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,UAAU,GACV,SAAS,GACT,QAAQ,GACR,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,MAAM,GACN,OAAO,GACP,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,aAAa,GACb,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAE1E,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzD,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,OAAO,GACP,UAAU,GACV,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAyBF,KAAK,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AA+IvD;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,gBAAgB,GACtB,8BAA8B,CAoBhC;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAa3E"}

package/dist/repoIntelligenceSemantics.js

@@ -0,0 +1,146 @@
+const TOOLING_CLASSES = new Set([
+    "tooling",
+    "test",
+    "lint",
+    "format",
+    "build",
+    "ci",
+]);
+const RUNTIME_VERIFICATION = new Set([
+    "auth_flow",
+    "route_handlers",
+    "routes",
+    "handlers",
+    "serialization",
+    "hooks",
+    "plugins",
+    "session",
+    "auth",
+    "queue",
+    "workers",
+]);
+function cloneWire(wire) {
+    return structuredClone(wire);
+}
+function isToolingClass(dc) {
+    return dc != null && TOOLING_CLASSES.has(dc);
+}
+function stripRuntimeVerification(focus) {
+    if (!focus?.length)
+        return [];
+    return focus.filter((f) => !RUNTIME_VERIFICATION.has(f));
+}
+function applyS1(row) {
+    return row.runtimeSurface === "runtime" && row.reachability === "unreachable";
+}
+function applyS2(row) {
+    return (row.runtimeImpact === "none" && row.reachability === "on_runtime_paths");
+}
+function applyS3(row) {
+    return (isToolingClass(row.dependencyClass) && row.runtimeImpact === "confirmed");
+}
+function applyS4(row) {
+    return (row.runtimeImpact === "confirmed" && (row.usage?.files?.length ?? 0) === 0);
+}
+function applyS5(row) {
+    if (!row.suppressRuntimeNarrative)
+        return false;
+    const focus = row.verificationFocus ?? [];
+    return focus.some((f) => RUNTIME_VERIFICATION.has(f));
+}
+function sanitizePackageRow(packageName, row) {
+    const diagnostics = [];
+    let degraded = false;
+    const next = { ...row };
+    const record = (ruleId, before, after, reason) => {
+        diagnostics.push({ packageName, ruleId, before, after, reason });
+        degraded = true;
+    };
+    if (applyS1(next)) {
+        const before = {
+            runtimeSurface: next.runtimeSurface,
+            reachability: next.reachability,
+        };
+        next.runtimeSurface = "build";
+        next.reachability = "build_only";
+        next.runtimeImpact = next.runtimeImpact ?? "none";
+        next.suppressRuntimeNarrative = true;
+        record("S1", before, { runtimeSurface: next.runtimeSurface, reachability: next.reachability }, "runtime_surface_unreachable");
+    }
+    if (applyS3(next)) {
+        const before = { runtimeImpact: next.runtimeImpact };
+        next.runtimeImpact = "none";
+        next.suppressRuntimeNarrative = true;
+        record("S3", before, { runtimeImpact: next.runtimeImpact }, "tooling_confirmed_without_proof");
+    }
+    if (applyS4(next)) {
+        const before = { runtimeImpact: next.runtimeImpact };
+        next.runtimeImpact = "none";
+        next.evidenceStrength = "low";
+        next.suppressRuntimeNarrative = true;
+        record("S4", before, { runtimeImpact: next.runtimeImpact }, "confirmed_without_imports");
+    }
+    if (applyS2(next)) {
+        const before = { reachability: next.reachability };
+        next.reachability = "unknown";
+        record("S2", before, { reachability: next.reachability }, "none_but_on_runtime_paths");
+    }
+    if (applyS5(next)) {
+        const before = { verificationFocus: next.verificationFocus };
+        next.verificationFocus = stripRuntimeVerification(next.verificationFocus);
+        record("S5", before, { verificationFocus: next.verificationFocus }, "runtime_focus_while_suppressed");
+    }
+    if (next.runtimeSurface === "runtime" &&
+        next.reachability === "unreachable") {
+        next.runtimeSurface = "unknown";
+        next.reachability = "unknown";
+        next.suppressRuntimeNarrative = true;
+        degraded = true;
+    }
+    if (next.suppressRuntimeNarrative && next.runtimeImpact === "confirmed") {
+        next.runtimeImpact = "unknown";
+        degraded = true;
+    }
+    return { row: next, diagnostics, degraded };
+}
+/**
+ * Hard gate: normalize contradictory package intelligence before wire emit.
+ */
+export function sanitizeRepoIntelligenceSemantics(draft) {
+    const wire = cloneWire(draft);
+    const diagnostics = [];
+    const degradedPackages = [];
+    for (const [packageName, row] of Object.entries(wire.packages)) {
+        const result = sanitizePackageRow(packageName, row);
+        wire.packages[packageName] = result.row;
+        diagnostics.push(...result.diagnostics);
+        if (result.degraded)
+            degradedPackages.push(packageName);
+    }
+    if (diagnostics.length > 0) {
+        wire.semanticDiagnostics = [
+            ...(wire.semanticDiagnostics ?? []),
+            ...diagnostics,
+        ];
+    }
+    return { wire, diagnostics, degradedPackages };
+}
+/** Returns true when wire is safe for runtime narrative tier1. */
+export function isRuntimeNarrativeSafe(row) {
+    if (!row)
+        return false;
+    if (row.suppressRuntimeNarrative === true)
+        return false;
+    if (row.runtimeImpact === "none")
+        return false;
+    if (row.runtimeSurface === "runtime" && row.reachability === "unreachable") {
+        return false;
+    }
+    if (row.runtimeImpact === "confirmed" || row.runtimeImpact === "possible") {
+        return true;
+    }
+    if (row.runtimeImpact === "unknown")
+        return false;
+    // ABI 1 wire without semantic fields: allow non-contradictory surface/reach pairs.
+    return row.runtimeSurface != null && row.reachability != null;
+}

package/dist/repoIntelligenceSemantics.test.d.ts

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

package/dist/repoIntelligenceSemantics.test.d.ts.map

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

package/dist/repoIntelligenceSemantics.test.js

@@ -0,0 +1,63 @@
+import { describe, expect, it } from "vitest";
+import { isRuntimeNarrativeSafe, sanitizeRepoIntelligenceSemantics, } from "./repoIntelligenceSemantics.js";
+function basePkg(overrides = {}) {
+    return {
+        runtimeSurface: "runtime",
+        reachability: "unreachable",
+        usage: { packageName: "typescript", files: [] },
+        ...overrides,
+    };
+}
+describe("sanitizeRepoIntelligenceSemantics", () => {
+    it("S1: neutralizes runtime + unreachable", () => {
+        const draft = {
+            packages: {
+                typescript: basePkg({
+                    runtimeImpact: "unknown",
+                }),
+            },
+        };
+        const { wire, diagnostics } = sanitizeRepoIntelligenceSemantics(draft);
+        expect(wire.packages.typescript?.runtimeSurface).not.toBe("runtime");
+        expect(wire.packages.typescript?.reachability).not.toBe("unreachable");
+        expect(wire.packages.typescript?.suppressRuntimeNarrative).toBe(true);
+        expect(diagnostics.some((d) => d.ruleId === "S1")).toBe(true);
+    });
+    it("S3: tooling class cannot stay confirmed", () => {
+        const draft = {
+            packages: {
+                typescript: basePkg({
+                    dependencyClass: "tooling",
+                    runtimeImpact: "confirmed",
+                    runtimeSurface: "build",
+                    reachability: "build_only",
+                }),
+            },
+        };
+        const { wire } = sanitizeRepoIntelligenceSemantics(draft);
+        expect(wire.packages.typescript?.runtimeImpact).toBe("none");
+    });
+    it("S4: confirmed without imports downgrades", () => {
+        const draft = {
+            packages: {
+                fastify: basePkg({
+                    runtimeImpact: "confirmed",
+                    usage: { packageName: "fastify", files: [] },
+                }),
+            },
+        };
+        const { wire } = sanitizeRepoIntelligenceSemantics(draft);
+        expect(wire.packages.fastify?.runtimeImpact).toBe("none");
+    });
+});
+describe("isRuntimeNarrativeSafe", () => {
+    it("returns false for suppressed runtime narrative", () => {
+        expect(isRuntimeNarrativeSafe({
+            runtimeSurface: "runtime",
+            reachability: "on_runtime_paths",
+            usage: { packageName: "x", files: ["src/a.ts"] },
+            suppressRuntimeNarrative: true,
+            runtimeImpact: "none",
+        })).toBe(false);
+    });
+});

package/dist/scanNarrativeFacts.d.ts

@@ -47,6 +47,13 @@ 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;
     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

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

package/package.json

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