@company-semantics/contracts 0.12.0 → 0.13.0

package/package.json

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

package/src/guards/config.ts

@@ -136,6 +136,37 @@ export type GuardCheckFactory = (
  */
 export type BoundGuardCheck = () => Promise<CheckResult> | CheckResult;
 
+/**
+ * Evolution guard baselines.
+ * Product repos provide DATA only; CI orchestrator owns guard implementations.
+ *
+ * Design invariant: Product repos must NEVER import CI guard code.
+ * They export baselines; CI injects guards at runtime.
+ */
+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;
+  };
+}
+
 /**
  * Registry of checks grouped by tier.
  * Each repo exports this from guard-entries.ts for universal orchestration.
@@ -152,10 +183,21 @@ export interface GuardCheckRegistry {
     structural?: BoundGuardCheck[];
     behavioral?: BoundGuardCheck[];
     invariants?: BoundGuardCheck[];
+    /**
+     * @deprecated Evolution guards are CI-owned. Use evolutionBaselines instead.
+     * Product repos should not provide evolution check implementations.
+     */
     evolution?: BoundGuardCheck[];
     /** Meta-guards: protect the guard system itself (coverage correctness) */
     meta?: BoundGuardCheck[];
   };
+
+  /**
+   * Evolution guard baselines.
+   * CI orchestrator injects evolution guards based on these baselines.
+   * Product repos provide data only, never guard implementations.
+   */
+  evolutionBaselines?: EvolutionBaselines;
 }
 
 // =============================================================================

package/src/guards/index.ts

@@ -29,6 +29,7 @@ export type {
   GuardCheckFactory,
   BoundGuardCheck,
   GuardCheckRegistry,
+  EvolutionBaselines,
 } from './config.js';
 
 // Config constants (type-level defaults)

package/src/index.ts

@@ -55,6 +55,7 @@ export type {
   GuardCheckFactory,
   BoundGuardCheck,
   GuardCheckRegistry,
+  EvolutionBaselines,
 } from './guards/index.js'
 
 export {