@company-semantics/contracts 0.21.1 → 0.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.21.1",
+  "version": "0.23.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -20,6 +20,14 @@
       "types": "./src/compatibility.ts",
       "default": "./src/compatibility.ts"
     },
+    "./identity": {
+      "types": "./src/identity/index.ts",
+      "default": "./src/identity/index.ts"
+    },
+    "./mcp": {
+      "types": "./src/mcp/index.ts",
+      "default": "./src/mcp/index.ts"
+    },
     "./schemas/guard-result.schema.json": "./schemas/guard-result.schema.json"
   },
   "types": "./src/index.ts",
@@ -32,6 +40,7 @@
   },
   "scripts": {
     "typecheck": "tsc -b --noEmit",
+    "typecheck:ci": "tsc -p scripts/ci/tsconfig.json",
     "lint:md": "markdownlint-cli2 '**/*.md' '#node_modules'",
     "lint:json": "node -e \"JSON.parse(require('fs').readFileSync('package.json'))\"",
     "prepare": "husky",

package/src/guards/config.ts

@@ -288,6 +288,22 @@ export interface EvolutionBaselines {
    * Errors when coverage drops below baseline (enforced).
    */
   coverage?: CoverageBaseline;
+
+  /**
+   * File cluster detection configuration.
+   * CI injects checkFileClusters based on this config.
+   * Advisory only: suggests folder reorganization.
+   *
+   * @see ADR-CI-010
+   */
+  fileClusters?: FileClusterBaseline;
+
+  /**
+   * Subdirectory affinity detection configuration.
+   * CI injects checkSubdirectoryAffinity based on this config.
+   * Advisory only: suggests moving files to subdirectories.
+   */
+  subdirectoryAffinity?: SubdirectoryAffinityBaseline;
 }
 
 /**
@@ -303,6 +319,44 @@ export interface CoverageBaseline {
   dropThreshold?: number;
 }
 
+/**
+ * File cluster detection configuration.
+ * Detects clusters of related files that could benefit from
+ * parent-child folder organization.
+ *
+ * @see ADR-CI-010
+ */
+export interface FileClusterBaseline {
+  /** Minimum files to form a cluster */
+  minClusterSize: number;
+  /** Minimum stragglers to suggest reorganization */
+  minStragglers: number;
+  /** Suffixes to strip when detecting clusters (e.g., '.test', '.spec') */
+  stripSuffixes: string[];
+  /** Role words to strip (e.g., 'Service', 'Handler') */
+  stripRoleWords: string[];
+  /** Directories to ignore */
+  ignoredDirectories: string[];
+}
+
+/**
+ * Subdirectory affinity detection configuration.
+ * Detects files in a parent directory that are only imported by
+ * files within a single subdirectory, suggesting they should move.
+ */
+export interface SubdirectoryAffinityBaseline {
+  /** Minimum importers required */
+  minImporters: number;
+  /** Maximum non-subdirectory imports allowed */
+  maxNonSubdirImports: number;
+  /** Patterns to exclude from analysis */
+  excludePatterns: RegExp[];
+  /** Importer patterns to ignore */
+  ignoredImporterPatterns: RegExp[];
+  /** Directories to ignore */
+  ignoredDirectories: string[];
+}
+
 /**
  * Registry of checks grouped by tier.
  * Each repo exports this from guard-entries.ts for universal orchestration.

package/src/guards/index.ts

@@ -50,6 +50,8 @@ export type {
   EvolutionBaselines,
   ContractsFreshnessBaseline,
   CoverageBaseline,
+  FileClusterBaseline,
+  SubdirectoryAffinityBaseline,
   MetaBaselines,
 } from './config.js';