@company-semantics/contracts 1.5.0 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -99,6 +99,7 @@
     "release": "npx tsx scripts/release.ts",
     "prepublishOnly": "echo 'ERROR: Publishing is CI-only via tag push. Use pnpm release instead.' && exit 1",
     "test": "vitest run",
+    "test:run": "vitest run",
     "generate:spec-hash": "tsx scripts/generate-spec-hash.ts",
     "generate:api": "pnpm generate:api-types && pnpm generate:spec-hash",
     "generate:api-types": "openapi-typescript openapi/backend.yaml -o src/api/generated.ts",

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 = '9740ec13f6ea' as const;
-export const SPEC_HASH_FULL = '9740ec13f6ea493d93a5b3cf1e8d7f6b0a1130a0e85846a446fe74aaa7a40fde' as const;
+export const SPEC_HASH = '6dcd4788f96e' as const;
+export const SPEC_HASH_FULL = '6dcd4788f96e0955ff7b5fcc0fa336cbaa88d3e8fced75e9f1cce650f8f8c0d7' as const;

package/src/api/generated.ts

@@ -1501,6 +1501,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/org-units/{unitId}/reorder": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Reorder a unit within its current parent (sibling reorder) */
+        post: operations["reorderOrgUnit"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/org-units/{unitId}/archive": {
         parameters: {
             query?: never;
@@ -1560,9 +1577,9 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List per-depth labels + allow_doc policy */
+        /** List per-depth labels */
         get: operations["listOrgLevelConfig"];
-        /** Replace per-depth labels + allow_doc policy */
+        /** Replace per-depth labels */
         put: operations["upsertOrgLevelConfig"];
         post?: never;
         delete?: never;
@@ -3096,7 +3113,6 @@ export interface components {
                 orgId: string;
                 depth: number;
                 label: string;
-                allowDoc: boolean;
                 createdAt: string;
                 updatedAt: string;
             }[];
@@ -3107,7 +3123,6 @@ export interface components {
                 orgId: string;
                 depth: number;
                 label: string;
-                allowDoc: boolean;
                 createdAt: string;
                 updatedAt: string;
             }[];
@@ -5598,6 +5613,36 @@ export interface operations {
             };
         };
     };
+    reorderOrgUnit: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                unitId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    prevId: string | null;
+                    nextId: string | null;
+                    orderKey?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Reordered unit */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrgUnitResponse"];
+                };
+            };
+        };
+    };
     archiveOrgUnit: {
         parameters: {
             query?: never;
@@ -5742,7 +5787,6 @@ export interface operations {
                     entries: {
                         depth: number;
                         label: string;
-                        allowDoc: boolean;
                     }[];
                 };
             };

package/src/generated/openapi-routes.ts

@@ -4,10 +4,11 @@
 export const openApiRoutes = {
   '/ai/chat': ['POST'],
   '/api/account/cancel-deletion': ['POST'],
+  '/api/account/confirm-deletion': ['POST'],
   '/api/account/delete': ['POST'],
+  '/api/account/deletion-eligibility': ['GET'],
   '/api/account/sessions': ['GET'],
   '/api/account/sessions/{sessionId}': ['DELETE'],
-  '/api/capabilities/tools': ['GET'],
   '/api/chats': ['GET', 'POST'],
   '/api/chats/by-interaction/{interactionId}': ['GET'],
   '/api/chats/events': ['GET'],
@@ -17,9 +18,13 @@ export const openApiRoutes = {
   '/api/chats/{id}/messages': ['POST'],
   '/api/chats/{id}/messages/{messageId}': ['DELETE'],
   '/api/chats/{id}/pin': ['DELETE', 'POST'],
+  '/api/company-md/context-bank': ['POST'],
   '/api/company-md/docs/{slug}': ['GET'],
   '/api/company-md/docs/{slug}/content': ['PUT'],
   '/api/company-md/docs/{slug}/context-bank': ['GET'],
+  '/api/company-md/docs/{slug}/context-bank/associate': ['POST'],
+  '/api/company-md/docs/{slug}/context-bank/{contextDocSlug}': ['DELETE'],
+  '/api/company-md/docs/{slug}/context-bank/{id}/order': ['PATCH'],
   '/api/company-md/docs/{slug}/sharing': ['GET'],
   '/api/company-md/docs/{slug}/sharing/acl': ['POST'],
   '/api/company-md/docs/{slug}/sharing/acl/{aclId}': ['DELETE', 'PUT'],
@@ -27,10 +32,6 @@ export const openApiRoutes = {
   '/api/company-md/docs/{slug}/title': ['PUT'],
   '/api/company-md/extract': ['POST'],
   '/api/company-md/tree': ['GET'],
-  '/api/departments': ['GET', 'POST'],
-  '/api/departments/{id}': ['DELETE', 'GET', 'PATCH'],
-  '/api/departments/{id}/members': ['GET', 'POST'],
-  '/api/departments/{id}/members/{userId}': ['DELETE'],
   '/api/drive/files': ['GET'],
   '/api/drive/files/recent': ['GET'],
   '/api/drive/files/{fileId}/content': ['GET'],
@@ -41,8 +42,23 @@ export const openApiRoutes = {
   '/api/executions/{executionId}/summary': ['GET'],
   '/api/executions/{executionId}/timeline': ['GET'],
   '/api/executions/{executionId}/undo': ['POST'],
-  '/api/integrations/status': ['GET'],
+  '/api/internal-admin/impersonate/end': ['POST'],
+  '/api/internal-admin/impersonate/session': ['GET'],
+  '/api/internal-admin/impersonate/start': ['POST'],
   '/api/me': ['GET'],
+  '/api/org-units': ['POST'],
+  '/api/org-units/{unitId}': ['GET'],
+  '/api/org-units/{unitId}/ancestors': ['GET'],
+  '/api/org-units/{unitId}/archive': ['POST'],
+  '/api/org-units/{unitId}/children': ['GET'],
+  '/api/org-units/{unitId}/descendants': ['GET'],
+  '/api/org-units/{unitId}/memberships': ['GET', 'POST'],
+  '/api/org-units/{unitId}/memberships/{userId}': ['DELETE'],
+  '/api/org-units/{unitId}/memberships/{userId}/role': ['PUT'],
+  '/api/org-units/{unitId}/permissions': ['GET'],
+  '/api/org-units/{unitId}/relationships': ['GET', 'POST'],
+  '/api/org-units/{unitId}/reorder': ['POST'],
+  '/api/org-units/{unitId}/reparent': ['POST'],
   '/api/org/cancel-deletion': ['POST'],
   '/api/org/delete': ['POST'],
   '/api/org/deletion-eligibility': ['GET'],
@@ -56,14 +72,12 @@ export const openApiRoutes = {
   '/api/orgs/{orgId}/ai-usage': ['GET'],
   '/api/orgs/{orgId}/billing': ['GET'],
   '/api/orgs/{orgId}/budget-config': ['GET', 'PUT'],
+  '/api/orgs/{orgId}/level-config': ['GET', 'PUT'],
+  '/api/orgs/{orgId}/tree': ['GET'],
+  '/api/scope/check': ['GET'],
   '/api/scope/check-batch': ['POST'],
   '/api/shared/{token}': ['GET'],
   '/api/shares/{shareId}': ['DELETE', 'PATCH'],
-  '/api/teams': ['GET', 'POST'],
-  '/api/teams/{teamId}': ['DELETE', 'GET', 'PUT'],
-  '/api/teams/{teamId}/members': ['POST'],
-  '/api/teams/{teamId}/members/{userId}': ['DELETE'],
-  '/api/teams/{teamId}/members/{userId}/role': ['PUT'],
   '/api/timeline': ['GET'],
   '/api/user/active-org': ['POST'],
   '/api/user/orgs': ['GET'],
@@ -83,6 +97,7 @@ export const openApiRoutes = {
   '/api/workspace/domains': ['GET', 'POST'],
   '/api/workspace/domains/{id}': ['DELETE'],
   '/api/workspace/domains/{id}/verify': ['POST'],
+  '/api/workspace/handle': ['PATCH'],
   '/api/workspace/invites': ['GET', 'POST'],
   '/api/workspace/invites/accept': ['POST'],
   '/api/workspace/invites/validate': ['GET'],
@@ -100,8 +115,6 @@ export const openApiRoutes = {
   '/auth/start': ['POST'],
   '/auth/verify': ['POST'],
   '/connect/{provider}': ['GET'],
-  '/healthz': ['GET'],
-  '/healthz/details': ['GET'],
   '/oauth/{provider}/callback': ['GET'],
 } as const;
 

package/src/org/__tests__/org-units.test.ts

@@ -133,7 +133,6 @@ describe('OrgLevelConfigSchema', () => {
       orgId: UUID_B,
       depth: 2,
       label: 'Department',
-      allowDoc: true,
       createdAt: '2026-04-17T00:00:00Z',
       updatedAt: '2026-04-17T00:00:00Z',
     };
@@ -168,7 +167,7 @@ describe('Response schemas', () => {
 });
 
 describe('Enum exhaustiveness', () => {
-  it('OrgUnitErrorCodeSchema enumerates all 7 known codes', () => {
+  it('OrgUnitErrorCodeSchema enumerates all 10 known codes', () => {
     const codes = [
       'CYCLE_BLOCKED',
       'DEPTH_EXCEEDED',
@@ -177,6 +176,9 @@ describe('Enum exhaustiveness', () => {
       'PARENT_ARCHIVED',
       'SLUG_TAKEN',
       'CROSS_ORG_REPARENT',
+      'ORDERKEY_CONFLICT',
+      'SIBLING_NOT_FOUND',
+      'SIBLINGS_DIFFERENT_PARENT',
     ];
     for (const code of codes) {
       expect(() => OrgUnitErrorCodeSchema.parse(code)).not.toThrow();

package/src/org/org-units.ts

@@ -63,4 +63,10 @@ export type OrgUnitErrorCode =
   /** Slug already taken under the target parent. */
   | 'SLUG_TAKEN'
   /** Attempted to reparent across orgs (or create with mismatched orgId). */
-  | 'CROSS_ORG_REPARENT';
+  | 'CROSS_ORG_REPARENT'
+  /** Reorder: computed order_key collided with an existing sibling; client should re-fetch neighbors and retry. */
+  | 'ORDERKEY_CONFLICT'
+  /** Reorder: prev or next sibling id does not resolve to a live unit. */
+  | 'SIBLING_NOT_FOUND'
+  /** Reorder: prev or next sibling belongs to a different parent than the moving unit. */
+  | 'SIBLINGS_DIFFERENT_PARENT';

package/src/org/schemas.ts

@@ -652,6 +652,9 @@ export const OrgUnitErrorCodeSchema = z.enum([
   'PARENT_ARCHIVED',
   'SLUG_TAKEN',
   'CROSS_ORG_REPARENT',
+  'ORDERKEY_CONFLICT',
+  'SIBLING_NOT_FOUND',
+  'SIBLINGS_DIFFERENT_PARENT',
 ]);
 
 export const OrgUnitSchema = z.object({
@@ -708,7 +711,6 @@ export const OrgLevelConfigSchema = z.object({
   orgId: z.string().uuid(),
   depth: z.number().int().min(1).max(5),
   label: z.string().min(1),
-  allowDoc: z.boolean(),
   createdAt: z.string(),
   updatedAt: z.string(),
 });