@company-semantics/contracts 0.28.0 → 0.30.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/guards/config.ts

@@ -269,30 +269,14 @@ export interface MetaBaselines {
  *
  * Design invariant: Product repos must NEVER import CI guard code.
  * They export baselines; CI injects guards at runtime.
+ *
+ * Note: Per-file export/import baselines were removed in favor of
+ * AggregateEvolutionConfig. See ADR-CI-029.
  */
 export interface EvolutionBaselines {
   /** Source directory (explicit, no assumptions). Defaults to 'src' if omitted. */
   srcDir?: string;
 
-  /** Export count baseline per file. Key is file path relative to srcDir. */
-  exports?: Record<string, number>;
-
-  /** Import count baseline per file. Key is file path relative to srcDir. */
-  imports?: Record<string, number>;
-
-  /** File count baseline per domain. Key is domain path. */
-  domains?: Record<string, number>;
-
-  /** Drift thresholds (optional, guards have sensible defaults) */
-  thresholds?: {
-    /** Max allowed export drift before warning */
-    exportDrift?: number;
-    /** Max allowed import drift before warning */
-    importDrift?: number;
-    /** Max allowed domain file count drift before warning */
-    domainDrift?: number;
-  };
-
   /**
    * Contracts freshness check configuration.
    * CI injects checkContractsFreshness based on this config.
@@ -325,6 +309,62 @@ export interface EvolutionBaselines {
   subdirectoryAffinity?: SubdirectoryAffinityBaseline;
 }
 
+// =============================================================================
+// Aggregate Evolution Types
+// =============================================================================
+
+/**
+ * Domain-level aggregate baseline for evolution tracking.
+ * Replaces per-file baselines with domain-aggregated metrics.
+ *
+ * Design: Domains are extracted from file paths (first 2 segments).
+ * Example: 'src/chat/execution/types.ts' → domain 'chat/execution'
+ */
+export interface DomainAggregateBaseline {
+  /** Total exports across all files in domain */
+  exports: number;
+  /** Total imports across all files in domain */
+  imports: number;
+  /** Diagnostic only, not thresholded */
+  fileCount: number;
+  /** ISO timestamp when baseline was captured */
+  capturedAt?: string;
+}
+
+/**
+ * Configuration for aggregate evolution guard.
+ * Uses domain-level metrics instead of per-file tracking.
+ *
+ * Benefits over per-file:
+ * - ~22 entries vs ~300 entries
+ * - Stable under refactors within domains
+ * - Grows O(domains) not O(files)
+ */
+export interface AggregateEvolutionConfig {
+  /** Source directory to scan */
+  srcDir: string;
+  /** Domain baselines keyed by domain path */
+  domains: Record<string, DomainAggregateBaseline>;
+  /** Global totals for sanity checking */
+  totals?: {
+    exports: number;
+    imports: number;
+    files: number;
+    capturedAt?: string;
+  };
+  /** Warning thresholds (sensible defaults applied if omitted) */
+  thresholds?: {
+    /** Absolute export growth before warning (default: 10) */
+    domainExportGrowth?: number;
+    /** Percentage growth before warning (default: 0.25 = 25%) */
+    domainGrowthPercent?: number;
+  };
+}
+
+// =============================================================================
+// Coverage Baseline Types
+// =============================================================================
+
 /**
  * Coverage baseline configuration.
  * Used by CI orchestrator to inject coverage drift guard.

package/src/guards/index.ts

@@ -54,6 +54,9 @@ export type {
   FileClusterBaseline,
   SubdirectoryAffinityBaseline,
   MetaBaselines,
+  // Aggregate evolution types
+  DomainAggregateBaseline,
+  AggregateEvolutionConfig,
   // SOC 2 Guard Configuration types
   SecretsDetectionConfig,
   StructuredLoggingConfig,

package/src/index.ts

@@ -70,6 +70,9 @@ export type {
   ContractsFreshnessBaseline,
   CoverageBaseline,
   MetaBaselines,
+  // Aggregate evolution types
+  DomainAggregateBaseline,
+  AggregateEvolutionConfig,
   // SOC 2 Compliance types
   Soc2ControlArea,
   Soc2ControlStatus,