@company-semantics/contracts 0.28.0 → 0.29.0

package/package.json

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

package/src/guards/config.ts

@@ -325,6 +325,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,