@company-semantics/contracts 0.135.0 → 0.137.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.135.0",
+  "version": "0.137.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -113,14 +113,14 @@
     "zod": "^4.2.1"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.6.0",
     "husky": "^9.1.7",
     "lint-staged": "^16.4.0",
     "markdownlint-cli2": "^0.22.0",
     "openapi-typescript": "^7.13.0",
     "tsx": "^4.21.0",
     "typescript": "^5",
-    "vitest": "^4.1.2",
+    "vitest": "^4.1.4",
     "yaml": "^2.8.3"
   },
   "pnpm": {

package/src/api/generated-spec-hash.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
-export const SPEC_HASH = 'a80bfe7f3d4e' as const;
-export const SPEC_HASH_FULL = 'a80bfe7f3d4e02405e34d3db57b55c81869ee846066ab54c5e4d071fa940378a' as const;
+export const SPEC_HASH = 'e00b8f6ac17d' as const;
+export const SPEC_HASH_FULL = 'e00b8f6ac17d37c793d851d3c26864d86ba8dbbf4451608615966a23d0b891ad' as const;

package/src/api/generated.ts

@@ -1313,6 +1313,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/company-md/docs/{slug}/context-bank/{id}/order": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** Set order key for a single context bank item */
+        patch: operations["reorderCompanyMdContextBankItem"];
+        trace?: never;
+    };
     "/api/company-md/settings": {
         parameters: {
             query?: never;
@@ -1453,6 +1470,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/teams/{teamId}/order": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** Set order key for a single team */
+        patch: operations["reorderTeamItem"];
+        trace?: never;
+    };
     "/api/teams/{teamId}/members": {
         parameters: {
             query?: never;
@@ -1541,6 +1575,23 @@ export interface paths {
         patch: operations["updateDepartment"];
         trace?: never;
     };
+    "/api/departments/{id}/order": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** Set order key for a single department */
+        patch: operations["reorderDepartmentItem"];
+        trace?: never;
+    };
     "/api/departments/{id}/members": {
         parameters: {
             query?: never;
@@ -2788,7 +2839,6 @@ export interface components {
                 title: string;
                 /** @enum {string} */
                 visibility: "public" | "private";
-                position: number;
                 updatedAt: string;
             }[];
         };
@@ -2860,7 +2910,6 @@ export interface components {
                 slug: string;
                 description: string | null;
                 memberCount: number;
-                position: number;
                 /** @enum {string} */
                 scope: "department" | "cross_department" | "org";
                 department: {
@@ -2881,7 +2930,6 @@ export interface components {
             slug: string;
             description: string | null;
             memberCount: number;
-            position: number;
             /** @enum {string} */
             scope: "department" | "cross_department" | "org";
             department: {
@@ -2912,7 +2960,6 @@ export interface components {
                 slug: string;
                 description: string | null;
                 memberCount: number;
-                position: number;
             }[];
         };
         DepartmentResponse: {
@@ -2920,7 +2967,6 @@ export interface components {
             name: string;
             slug: string;
             description: string | null;
-            position: number;
             /** @enum {string} */
             syncMode: "manual_only" | "scim" | "hris";
             memberCount: number;
@@ -5054,6 +5100,49 @@ export interface operations {
             };
         };
     };
+    reorderCompanyMdContextBankItem: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                slug: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    orderKey: string;
+                    prevId: string | null;
+                    nextId: string | null;
+                };
+            };
+        };
+        responses: {
+            /** @description Order key updated */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid order key */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Order key collision */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getCompanyMdSettings: {
         parameters: {
             query?: never;
@@ -5332,6 +5421,48 @@ export interface operations {
             };
         };
     };
+    reorderTeamItem: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                teamId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    orderKey: string;
+                    prevId: string | null;
+                    nextId: string | null;
+                };
+            };
+        };
+        responses: {
+            /** @description Order key updated */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid order key */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Order key collision */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     addTeamMember: {
         parameters: {
             query?: never;
@@ -5521,6 +5652,48 @@ export interface operations {
             };
         };
     };
+    reorderDepartmentItem: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    orderKey: string;
+                    prevId: string | null;
+                    nextId: string | null;
+                };
+            };
+        };
+        responses: {
+            /** @description Order key updated */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid order key */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Order key collision */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     listDepartmentMembers: {
         parameters: {
             query?: never;

package/src/content/schemas.ts

@@ -128,7 +128,6 @@ const CompanyMdContextBankItemSchema = z.object({
   slug: z.string(),
   title: z.string(),
   visibility: z.enum(['public', 'private']),
-  position: z.number().int(),
   updatedAt: z.string(),
 });
 
@@ -166,7 +165,6 @@ const TeamSummarySchema = z.object({
   slug: z.string(),
   description: z.string().nullable(),
   memberCount: z.number().int(),
-  position: z.number().int(),
   scope: z.enum(['department', 'cross_department', 'org']),
   department: z.object({ id: z.string(), name: z.string(), slug: z.string() }).nullable(),
   homeDepartment: z.object({ id: z.string(), name: z.string(), slug: z.string() }).nullable(),
@@ -205,7 +203,6 @@ const DepartmentSummarySchema = z.object({
   slug: z.string(),
   description: z.string().nullable(),
   memberCount: z.number().int(),
-  position: z.number().int(),
 });
 
 // ---------------------------------------------------------------------------
@@ -223,7 +220,6 @@ export const DepartmentResponseSchema = z.object({
   name: z.string(),
   slug: z.string(),
   description: z.string().nullable(),
-  position: z.number().int(),
   syncMode: z.enum(['manual_only', 'scim', 'hris']),
   memberCount: z.number().int(),
   members: z.array(DepartmentMemberSchema),

package/src/index.ts

@@ -603,3 +603,12 @@ export { wrapSecret, unwrapSecret } from './security/index'
 // Analytics response metadata (shared vocabulary for OLTP/OLAP separation)
 // @see ADR-CTRL-053 for design rationale
 export type { AnalyticsBackend, AnalyticsResponseMeta } from './types/analytics'
+
+// Client request scheduler types (shared tier vocabulary)
+export type {
+  Tier,
+  MutationBehavior,
+  SchedulerResourceKey,
+  RequestDescriptor,
+  SchedulerEvent,
+} from './requests'

package/src/org/company-md.ts

@@ -104,6 +104,5 @@ export interface CompanyMdContextBankItem {
   readonly slug: string;
   readonly title: string;
   readonly visibility: CompanyMdVisibility;
-  readonly position: number;
   readonly updatedAt: string;
 }

package/src/org/departments.ts

@@ -22,7 +22,6 @@ export interface Department {
   readonly slug: string;
   readonly description: string | null;
   readonly memberCount: number;
-  readonly position: number;
 }
 
 /**

package/src/org/teams.ts

@@ -28,7 +28,6 @@ export interface Team {
   readonly slug: string;
   readonly description: string | null;
   readonly memberCount: number;
-  readonly position: number;
   readonly scope: import('./departments').TeamScope;
   readonly department: { readonly id: string; readonly name: string; readonly slug: string } | null;
   readonly homeDepartment: { readonly id: string; readonly name: string; readonly slug: string } | null;

package/src/requests.ts

@@ -0,0 +1,28 @@
+export type Tier = 'P0' | 'P1' | 'P2' | 'P3';
+
+export type MutationBehavior = 'collapse' | 'queue' | 'parallel';
+
+export type SchedulerResourceKey = {
+  type: string;
+  orgId?: string;
+  resourceId?: string;
+};
+
+export type RequestDescriptor = {
+  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+  path: string;
+  params?: Record<string, unknown>;
+  tier: Tier;
+  resourceKey: SchedulerResourceKey;
+  signal?: AbortSignal;
+  mutationBehavior?: MutationBehavior;
+  headers?: Record<string, string>;
+  body?: unknown;
+};
+
+export type SchedulerEvent =
+  | { type: 'enqueued'; id: string; descriptor: RequestDescriptor; queuedAt: number }
+  | { type: 'started'; id: string; descriptor: RequestDescriptor; startedAt: number; waitedMs: number }
+  | { type: 'settled'; id: string; descriptor: RequestDescriptor; durationMs: number; ok: boolean; status?: number }
+  | { type: 'aborted'; id: string; descriptor: RequestDescriptor; reason: 'superseded' | 'invalidated' | 'unmounted' | 'external' }
+  | { type: 'deduped'; id: string; descriptor: RequestDescriptor; sharedWith: string };