@company-semantics/contracts 0.138.0 → 0.139.0

package/package.json

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

package/src/index.ts

@@ -613,6 +613,9 @@ export type {
   SchedulerEvent,
 } from './requests'
 
+// Mutation policy types (lane behavior semantics)
+export type { MutationPolicy } from './mutations'
+
 // Observability envelope types (shared metric shape)
 export { REQUEST_ID_HEADER } from './observability'
 export type { Labels, MetricEnvelope, SchedulerMetricName } from './observability'

package/src/mutations.ts

@@ -0,0 +1,13 @@
+export type { MutationBehavior } from './requests';
+
+export type MutationPolicy = {
+  /**
+   * collapse — the newer mutation supersedes older in-flight or queued mutations
+   *            on the same resource lane. Use for idempotent field sets (rename).
+   * queue    — FIFO lane per resource. No collapse. Use when each mutation carries
+   *            meaningful intent that must be preserved (reorder, append, toggle-sequence).
+   * parallel — independent mutations on different resourceIds may run concurrently;
+   *            same-resource requests still serialize to avoid lost writes.
+   */
+  behavior: 'collapse' | 'queue' | 'parallel';
+};