@company-semantics/contracts 0.141.0 → 0.142.0

package/package.json

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

package/src/index.ts

@@ -634,3 +634,6 @@ export {
   CLEAR_HOLDDOWN_MS,
 } from './pressure'
 export type { SystemPressureValue, ShedResponse } from './pressure'
+
+// Timeout ladder (PRD-00491 end-to-end timing budgets)
+export { TIMEOUT_LADDER_MS, getTimeoutForTier } from './timeouts'

package/src/timeouts.ts

@@ -0,0 +1,27 @@
+/**
+ * Timeout ladder (PRD-00491).
+ *
+ * Per-tier hard timeout ceilings shared by every enforcement layer:
+ * client fetch, scheduler, backend handler, DB query. Backend and app
+ * import from here so the ladder cannot drift between layers.
+ *
+ * Extends PRD-00486 (backend query timeouts) and PRD-00487 (client fetch
+ * timeouts) into a single coherent ladder. Per-intent DB budgets in
+ * `company-semantics-backend/src/db/query-intent.ts` are derived from
+ * these ceilings (feedback_derive_dont_duplicate).
+ *
+ * Tiers: P0 = user-blocking, P1 = interactive, P2 = background,
+ * P3 = bulk. See `./requests#Tier` for the canonical tier definition.
+ */
+import type { Tier } from './requests';
+
+export const TIMEOUT_LADDER_MS: Record<Tier, number> = {
+  P0: 2_000,
+  P1: 5_000,
+  P2: 8_000,
+  P3: 15_000,
+};
+
+export function getTimeoutForTier(tier: Tier): number {
+  return TIMEOUT_LADDER_MS[tier];
+}