@company-semantics/contracts 0.14.0 → 0.15.0

package/package.json

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

package/src/guards/config.ts

@@ -162,6 +162,42 @@ export interface ContractsFreshnessBaseline {
   skip?: boolean;
 }
 
+/**
+ * Scripts-devDependencies guard configuration.
+ * Checks that tools used in package.json scripts are declared in devDependencies.
+ */
+export interface ScriptsDepsBaseline {
+  /** Path to package.json relative to repo root */
+  packageJsonPath: string;
+
+  /**
+   * Additional tools to exempt from checking.
+   * Runtime-provided tools (node, pnpm, npm, npx) are always exempt.
+   */
+  exempt?: string[];
+
+  /**
+   * If true, violations are errors. If false, violations are warnings.
+   * @default false
+   */
+  strict?: boolean;
+}
+
+/**
+ * Structural 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 StructuralBaselines {
+  /**
+   * Scripts-devDependencies check configuration.
+   * CI injects checkScriptsDeps based on this config.
+   */
+  scriptsDeps?: ScriptsDepsBaseline;
+}
+
 /**
  * Evolution guard baselines.
  * Product repos provide DATA only; CI orchestrator owns guard implementations.
@@ -226,6 +262,13 @@ export interface GuardCheckRegistry {
     meta?: BoundGuardCheck[];
   };
 
+  /**
+   * Structural guard baselines.
+   * CI orchestrator injects structural guards based on these baselines.
+   * Product repos provide data only, never guard implementations.
+   */
+  structuralBaselines?: StructuralBaselines;
+
   /**
    * Evolution guard baselines.
    * CI orchestrator injects evolution guards based on these baselines.

package/src/guards/index.ts

@@ -29,6 +29,8 @@ export type {
   GuardCheckFactory,
   BoundGuardCheck,
   GuardCheckRegistry,
+  StructuralBaselines,
+  ScriptsDepsBaseline,
   EvolutionBaselines,
   ContractsFreshnessBaseline,
 } from './config.js';