@company-semantics/contracts 0.47.2 → 0.49.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.47.2",
+  "version": "0.49.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -51,6 +51,7 @@
     "access": "public"
   },
   "scripts": {
+    "build": "tsc -b --noEmit",
     "typecheck": "tsc -b --noEmit",
     "typecheck:ci": "tsc -p scripts/ci/tsconfig.json",
     "lint:md": "markdownlint-cli2 '**/*.md' '#node_modules'",
@@ -67,6 +68,8 @@
     "guard:version-tag:json": "npx tsx scripts/ci/version-tag-guard.ts --json",
     "guard:decisions-deprecation": "npx tsx scripts/ci/decisions-deprecation-guard.ts",
     "guard:decisions-deprecation:json": "npx tsx scripts/ci/decisions-deprecation-guard.ts --json",
+    "guard:quick": "pnpm guard:export && pnpm guard:vocabulary && pnpm guard:scripts-deps",
+    "guard": "pnpm guard:export && pnpm guard:vocabulary && pnpm guard:scripts-deps && pnpm guard:decision && pnpm guard:decisions-deprecation",
     "guard:test": "vitest run scripts/ci/__tests__",
     "release": "npx tsx scripts/release.ts",
     "prepublishOnly": "echo 'ERROR: Publishing is CI-only via tag push. Use pnpm release instead.' && exit 1",

package/src/index.ts

@@ -332,17 +332,12 @@ export type {
   RalphIteration,
   RalphMode,
   RalphProgress,
-  // Trust types
-  RalphTrustLevel,
-  RalphRunResult,
-  RalphCIStatus,
-  RalphTrustLog,
-  RalphTL1Policy,
-  RalphTL2Policy,
-  RalphTL3Policy,
-  RalphTrustPolicy,
-  RalphDemotionReason,
 } from './ralph/index';
 
 // Ralph constants (cross-repo support)
 export { REPO_PRECEDENCE } from './ralph/index'
+
+// Rate limit domain types
+// @see PRD-00013 for contracts integration
+export type { RateLimitConfig, RateLimitResult } from './rate-limit/index'
+export { RateLimitTier } from './rate-limit/index'

package/src/ralph/index.ts

@@ -5,7 +5,7 @@
  * Import from '@company-semantics/contracts/ralph' or '@company-semantics/contracts'.
  *
  * Note: This module exports types only (no runtime code per contracts policy).
- * Orchestration, prompts, and trust logic live in company-semantics-control.
+ * Orchestration and prompts live in company-semantics-control.
  *
  * @see company-semantics-control/docs/ralph.md for usage
  */
@@ -40,15 +40,3 @@ export type {
   RalphProgress,
 } from './progress';
 
-// Trust types
-export type {
-  RalphTrustLevel,
-  RalphRunResult,
-  RalphCIStatus,
-  RalphTrustLog,
-  RalphTL1Policy,
-  RalphTL2Policy,
-  RalphTL3Policy,
-  RalphTrustPolicy,
-  RalphDemotionReason,
-} from './trust';

package/src/ralph/progress.ts

@@ -11,8 +11,6 @@
  * @see company-semantics-control/docs/ralph.md for usage
  */
 
-import type { RalphTrustLevel } from './trust';
-
 // =============================================================================
 // Iteration Types
 // =============================================================================
@@ -60,8 +58,8 @@ export type RalphProgress = {
   sessionId: string;
   /** Target repository name */
   repo: string;
-  /** Current trust level (0-3) */
-  trustLevel: RalphTrustLevel;
+  /** @deprecated Trust level removed — field retained for serialization compat */
+  trustLevel?: number;
   /** Operation mode (HITL or AFK) */
   mode: RalphMode;
   /** Completed iterations */

package/src/rate-limit/README.md

@@ -0,0 +1,51 @@
+# Rate Limit Domain
+
+Shared vocabulary types for rate limiting across Company Semantics codebases.
+
+## Types
+
+### RateLimitTier
+
+Enum defining the rate limit tiers available to users:
+
+- `FREE` - Default tier for free users
+- `PRO` - Elevated limits for pro subscribers
+- `ENTERPRISE` - Custom limits for enterprise customers
+
+### RateLimitConfig
+
+Configuration for rate limit windows:
+
+```typescript
+interface RateLimitConfig {
+  maxRequests: number;  // Maximum requests allowed in window
+  windowMs: number;     // Window duration in milliseconds
+}
+```
+
+### RateLimitResult
+
+Result of a rate limit check:
+
+```typescript
+interface RateLimitResult {
+  allowed: boolean;  // true = permitted, false = rate limited
+  remaining: number; // Requests remaining in current window
+  resetAt: number;   // Unix timestamp when window resets
+}
+```
+
+## Semantic Convention
+
+This domain uses `allowed: boolean` where `true` means the request is permitted.
+This is the canonical semantic across all Company Semantics repos.
+
+## Consumers
+
+- `company-semantics-edge` - Rate limiter implementation
+- `company-semantics-backend` - Rate limit service
+
+## See Also
+
+- PRD-00012: Foundational rate limiting implementation
+- PRD-00013: Contracts integration (this promotion)

package/src/rate-limit/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Rate limiting vocabulary types.
+ * @see PRD-00012 for foundational implementation
+ * @see PRD-00013 for contracts integration
+ */
+
+export enum RateLimitTier {
+  FREE = 'free',
+  PRO = 'pro',
+  ENTERPRISE = 'enterprise',
+}
+
+export interface RateLimitConfig {
+  maxRequests: number;
+  windowMs: number;
+}
+
+export interface RateLimitResult {
+  /** Whether the request is allowed (true = permitted, false = rate limited) */
+  allowed: boolean;
+  remaining: number;
+  resetAt: number;
+}

package/src/ralph/trust.ts

@@ -1,125 +0,0 @@
-/**
- * Ralph Trust Level Types
- *
- * Defines the Trust Promotion framework for graduated AI autonomy.
- * Ralph earns trust through repeated, measurable compliance — not intent.
- *
- * Trust Level Summary:
- * - TL0 (Sandbox): Default, no network, single repo
- * - TL1 (Verified): Earned after 8+ consecutive clean runs
- * - TL2 (Limited Network): Requires human approval, npm/GitHub access
- * - TL3 (Full AFK): Rare, mechanical tasks only, full network
- *
- * @see company-semantics-control/docs/ralph.md for usage
- */
-
-// =============================================================================
-// Trust Level Types
-// =============================================================================
-
-/**
- * Trust level numeric value.
- *
- * - 0: Sandbox (default)
- * - 1: Verified AFK
- * - 2: Limited Network
- * - 3: Full AFK
- */
-export type RalphTrustLevel = 0 | 1 | 2 | 3;
-
-/**
- * Result of a Ralph run.
- */
-export type RalphRunResult = 'success' | 'failure';
-
-/**
- * CI status after a Ralph run.
- */
-export type RalphCIStatus = 'green' | 'red' | 'skipped';
-
-// =============================================================================
-// Trust Log Types
-// =============================================================================
-
-/**
- * Record of a single Ralph run outcome.
- *
- * Stored in `.ralph/trust-log.json` for audit and promotion decisions.
- */
-export type RalphTrustLog = {
-  /** Run identifier (ISO timestamp) */
-  runId: string;
-  /** Repository where run occurred */
-  repo: string;
-  /** Trust level at time of run */
-  trustLevel: RalphTrustLevel;
-  /** Overall run result */
-  result: RalphRunResult;
-  /** CI status after run */
-  ciStatus: RalphCIStatus;
-  /** Whether human fixes were required post-run */
-  humanFixesRequired: boolean;
-  /** Reason for demotion if applicable */
-  demotionReason?: string;
-  /** Number of iterations completed */
-  iterationsCompleted?: number;
-  /** Number of features completed */
-  featuresCompleted?: number;
-};
-
-// =============================================================================
-// Trust Policy Types
-// =============================================================================
-
-/**
- * Promotion criteria for TL1 (Verified AFK).
- */
-export type RalphTL1Policy = {
-  requiredConsecutiveRuns: number;
-  allowNetwork: false;
-};
-
-/**
- * Promotion criteria for TL2 (Limited Network).
- */
-export type RalphTL2Policy = {
-  requiresHumanApproval: true;
-  /** Domains allowed for network access */
-  networkAllowlist: string[];
-};
-
-/**
- * Promotion criteria for TL3 (Full AFK).
- */
-export type RalphTL3Policy = {
-  requiresExplicitPromotion: true;
-  /** Glob patterns for allowed repos */
-  allowedRepoPatterns: string[];
-};
-
-/**
- * Complete trust policy configuration.
- *
- * Note: Policy logic lives in control repo, not here.
- * This type defines vocabulary only.
- */
-export type RalphTrustPolicy = {
-  trustLevel1: RalphTL1Policy;
-  trustLevel2: RalphTL2Policy;
-  trustLevel3: RalphTL3Policy;
-};
-
-// =============================================================================
-// Demotion Types
-// =============================================================================
-
-/**
- * Reasons for automatic demotion to TL0.
- */
-export type RalphDemotionReason =
-  | 'ci_failed'
-  | 'guard_violation'
-  | 'manual_patch_required'
-  | 'scope_violation'
-  | 'network_abuse'
-  | 'prd_marked_complete_incorrectly';