@company-semantics/contracts 63.2.0 → 63.4.0

package/package.json

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

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 = '387045558d18' as const;
-export const SPEC_HASH_FULL = '387045558d1867722a744ddb05cf5ebb7260c54df0ff272b868bd4dd2ad2a973' as const;
+export const SPEC_HASH = 'c73ab06a4768' as const;
+export const SPEC_HASH_FULL = 'c73ab06a476873a5f782ce5969fd3641f07372d69b4a60feade7305c428f116f' as const;

package/src/api/generated.ts

@@ -3778,6 +3778,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/comments/threads/{threadId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Soft-delete a thread of either kind (creator or subject owner) */
+        delete: operations["deleteCommentThread"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/comments/threads/{threadId}/accept-intent": {
         parameters: {
             query?: never;
@@ -3863,6 +3880,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/comments/threads/{threadId}/revert": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Revert a decided suggestion, restoring the passage an acceptance replaced */
+        post: operations["revertSuggestion"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -5938,7 +5972,7 @@ export interface components {
                 /** Format: uuid */
                 userId: string;
                 /** @enum {string} */
-                membershipRole: "member" | "l1_unit_owner" | "l2_unit_owner" | "l3_unit_owner" | "l4_unit_owner" | "l5_unit_owner";
+                membershipRole: "member" | "l1_unit_owner" | "l2_unit_owner" | "l3_unit_owner" | "l4_unit_owner" | "l5_unit_owner" | "l6_unit_owner" | "l7_unit_owner" | "l8_unit_owner" | "l9_unit_owner" | "l10_unit_owner" | "l11_unit_owner" | "l12_unit_owner" | "l13_unit_owner" | "l14_unit_owner" | "l15_unit_owner" | "l16_unit_owner" | "l17_unit_owner" | "l18_unit_owner" | "l19_unit_owner" | "l20_unit_owner";
                 /** Format: uuid */
                 inheritedFromUnitId: string;
                 inheritedFromUnitName: string;
@@ -6074,7 +6108,7 @@ export interface components {
                 /** Format: uuid */
                 userId: string;
                 /** @enum {string} */
-                membershipRole: "member" | "l1_unit_owner" | "l2_unit_owner" | "l3_unit_owner" | "l4_unit_owner" | "l5_unit_owner";
+                membershipRole: "member" | "l1_unit_owner" | "l2_unit_owner" | "l3_unit_owner" | "l4_unit_owner" | "l5_unit_owner" | "l6_unit_owner" | "l7_unit_owner" | "l8_unit_owner" | "l9_unit_owner" | "l10_unit_owner" | "l11_unit_owner" | "l12_unit_owner" | "l13_unit_owner" | "l14_unit_owner" | "l15_unit_owner" | "l16_unit_owner" | "l17_unit_owner" | "l18_unit_owner" | "l19_unit_owner" | "l20_unit_owner";
                 /** @enum {string} */
                 status: "active" | "pending" | "removed";
                 /** @enum {string} */
@@ -6095,7 +6129,7 @@ export interface components {
                 /** Format: uuid */
                 userId: string;
                 /** @enum {string} */
-                membershipRole: "member" | "l1_unit_owner" | "l2_unit_owner" | "l3_unit_owner" | "l4_unit_owner" | "l5_unit_owner";
+                membershipRole: "member" | "l1_unit_owner" | "l2_unit_owner" | "l3_unit_owner" | "l4_unit_owner" | "l5_unit_owner" | "l6_unit_owner" | "l7_unit_owner" | "l8_unit_owner" | "l9_unit_owner" | "l10_unit_owner" | "l11_unit_owner" | "l12_unit_owner" | "l13_unit_owner" | "l14_unit_owner" | "l15_unit_owner" | "l16_unit_owner" | "l17_unit_owner" | "l18_unit_owner" | "l19_unit_owner" | "l20_unit_owner";
                 /** @enum {string} */
                 status: "active" | "pending" | "removed";
                 /** @enum {string} */
@@ -7028,6 +7062,11 @@ export interface components {
         AnchorTraceRequest: {
             lastAnchoredOffset: number;
         };
+        /** @description Acknowledges a soft-deleted thread: its id and the deletion stamp. */
+        CommentThreadDeletedResponse: {
+            threadId: string;
+            deletedAt: string;
+        };
         /** @description The acceptance lease: the opaque claim token that alone can complete the accept, and how long the lease lives. */
         SuggestionClaimResponse: {
             claimToken: string;
@@ -7045,6 +7084,14 @@ export interface components {
             claimToken: string;
             expectedRevision: string;
         };
+        /** @description The reverted thread and the inverse document mutation that landed with it, or null when the suggestion had never been applied. */
+        SuggestionRevertedResponse: {
+            thread: components["schemas"]["CommentThreadSummary"];
+            reverted: components["schemas"]["SuggestionApplied"] | null;
+        };
+        SuggestionRevertRequest: {
+            expectedRevision?: string;
+        };
         /** @description Server-enforced collaboration size limits, published so clients can pre-check. */
         CollabSyncLimits: {
             maxUpdateBytes: number;
@@ -7205,7 +7252,7 @@ export interface components {
             op: "insert" | "delete" | "replace";
             insertedText?: string;
             /** @enum {string} */
-            status: "open" | "accepted" | "rejected";
+            status: "open" | "accepted" | "rejected" | "reverted";
         };
         /** @description One comment; body is null iff soft-deleted (redacted projection with empty mentions). */
         Comment: {
@@ -7246,6 +7293,8 @@ export interface components {
             canReopen: boolean;
             canDecideSuggestion: boolean;
             canWithdraw: boolean;
+            canRevertSuggestion: boolean;
+            canDeleteThread: boolean;
         };
         /** @description A comment thread without its comments. */
         CommentThreadSummary: {
@@ -11472,7 +11521,7 @@ export interface operations {
                     /** Format: uuid */
                     userId: string;
                     /** @enum {string} */
-                    role?: "member" | "l1_unit_owner" | "l2_unit_owner" | "l3_unit_owner" | "l4_unit_owner" | "l5_unit_owner";
+                    role?: "member" | "l1_unit_owner" | "l2_unit_owner" | "l3_unit_owner" | "l4_unit_owner" | "l5_unit_owner" | "l6_unit_owner" | "l7_unit_owner" | "l8_unit_owner" | "l9_unit_owner" | "l10_unit_owner" | "l11_unit_owner" | "l12_unit_owner" | "l13_unit_owner" | "l14_unit_owner" | "l15_unit_owner" | "l16_unit_owner" | "l17_unit_owner" | "l18_unit_owner" | "l19_unit_owner" | "l20_unit_owner";
                 };
             };
         };
@@ -11502,7 +11551,7 @@ export interface operations {
             content: {
                 "application/json": {
                     /** @enum {string} */
-                    role: "member" | "l1_unit_owner" | "l2_unit_owner" | "l3_unit_owner" | "l4_unit_owner" | "l5_unit_owner";
+                    role: "member" | "l1_unit_owner" | "l2_unit_owner" | "l3_unit_owner" | "l4_unit_owner" | "l5_unit_owner" | "l6_unit_owner" | "l7_unit_owner" | "l8_unit_owner" | "l9_unit_owner" | "l10_unit_owner" | "l11_unit_owner" | "l12_unit_owner" | "l13_unit_owner" | "l14_unit_owner" | "l15_unit_owner" | "l16_unit_owner" | "l17_unit_owner" | "l18_unit_owner" | "l19_unit_owner" | "l20_unit_owner";
                 };
             };
         };
@@ -13750,6 +13799,42 @@ export interface operations {
             };
         };
     };
+    deleteCommentThread: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                threadId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Thread soft-deleted; the response acknowledges the id and the deletion stamp. Accepted suggestion text stays in the document */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentThreadDeletedResponse"];
+                };
+            };
+            /** @description Thread not found, already deleted, or the caller is neither its creator nor a subject owner */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description A live acceptance lease is held on the suggestion */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     acceptSuggestionIntent: {
         parameters: {
             query?: never;
@@ -13963,4 +14048,51 @@ export interface operations {
             };
         };
     };
+    revertSuggestion: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                threadId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SuggestionRevertRequest"];
+            };
+        };
+        responses: {
+            /** @description Suggestion reverted (terminal; thread stays resolved). On an accepted suggestion the inverse edit landed in the document on the SAME transaction and is reported; on a rejected one `reverted` is null */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuggestionRevertedResponse"];
+                };
+            };
+            /** @description Malformed expectedRevision, or an accepted suggestion reverted without one */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Thread not found, or the caller may not decide suggestions on it */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Terminal, never retry: not a suggestion thread, still open, already reverted, a claim is on the row, the document moved past expectedRevision, or the inserted text cannot be found or no longer reads as inserted — re-read the document and decide again */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
 }

package/src/generated/openapi-routes.ts

@@ -24,6 +24,7 @@ export const openApiRoutes = {
   '/api/chats/{id}/pin': ['DELETE', 'POST'],
   '/api/comments': ['GET'],
   '/api/comments/threads': ['POST'],
+  '/api/comments/threads/{threadId}': ['DELETE'],
   '/api/comments/threads/{threadId}/accept-apply': ['POST'],
   '/api/comments/threads/{threadId}/accept-complete': ['POST'],
   '/api/comments/threads/{threadId}/accept-intent': ['POST'],
@@ -33,6 +34,7 @@ export const openApiRoutes = {
   '/api/comments/threads/{threadId}/reject': ['POST'],
   '/api/comments/threads/{threadId}/reopen': ['POST'],
   '/api/comments/threads/{threadId}/resolve': ['POST'],
+  '/api/comments/threads/{threadId}/revert': ['POST'],
   '/api/comments/{commentId}': ['DELETE', 'PATCH'],
   '/api/company-md/access-requests/{id}/approve': ['POST'],
   '/api/company-md/access-requests/{id}/deny': ['POST'],

package/src/index.ts

@@ -683,6 +683,8 @@ export {
   getViewScope,
   TRANSFER_RESPONSIBILITIES,
   IDENTITY_TRUST_LEVEL_LABELS,
+  ORG_UNIT_DESIGNED_MAX_DEPTH,
+  ORG_UNIT_ABSOLUTE_MAX_DEPTH,
 } from "./org/index";
 
 // View authorization types (Phase 5 - ADR-APP-013)

package/src/org/README.md

@@ -193,6 +193,8 @@ Shared type vocabulary for organization ownership, type classification, and tran
 - `MissingAtNextLevel` _(type)_
 - `MissingAtNextLevelSchema` — Active users home directly at this unit who have no level-(depth+1) home assignment within its subtree.
 - `ORG_UNITS_ROUTES` — Canonical route path constants for the `/api/org-units` surface.
+- `ORG_UNIT_ABSOLUTE_MAX_DEPTH` — Hard ceiling mirrored by the `org_units_depth_max` CHECK; ingest-only past designed.
+- `ORG_UNIT_DESIGNED_MAX_DEPTH` — Depth a human may build from scratch; the UI ceiling for a fresh org.
 - `Occupancy` _(type)_
 - `OccupancySchema`
 - `OccupancyStatus` _(type)_

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

@@ -0,0 +1,64 @@
+import { describe, it, expect } from "vitest";
+import {
+  ORG_UNIT_ABSOLUTE_MAX_DEPTH,
+  ORG_UNIT_DESIGNED_MAX_DEPTH,
+} from "../../index.js";
+import {
+  OrgLevelConfigSchema,
+  OrgUnitTreeNodeSchema,
+  UnitMembershipRoleSchema,
+} from "../schemas.js";
+
+const UUID_A = "11111111-1111-4111-8111-111111111111";
+
+describe("org-unit depth ceilings", () => {
+  it("designed stays below absolute and both reach the package root", () => {
+    expect(ORG_UNIT_DESIGNED_MAX_DEPTH).toBe(5);
+    expect(ORG_UNIT_ABSOLUTE_MAX_DEPTH).toBe(20);
+    expect(ORG_UNIT_DESIGNED_MAX_DEPTH).toBeLessThan(
+      ORG_UNIT_ABSOLUTE_MAX_DEPTH,
+    );
+  });
+
+  it("OrgLevelConfigSchema accepts every depth up to the absolute ceiling", () => {
+    const row = (depth: number) => ({
+      orgId: UUID_A,
+      depth,
+      label: "Pod",
+      labelPlural: "Pods",
+      icon: "users",
+      createdAt: "2026-01-01T00:00:00.000Z",
+      updatedAt: "2026-01-01T00:00:00.000Z",
+    });
+    expect(
+      OrgLevelConfigSchema.safeParse(row(ORG_UNIT_DESIGNED_MAX_DEPTH + 1))
+        .success,
+    ).toBe(true);
+    expect(
+      OrgLevelConfigSchema.safeParse(row(ORG_UNIT_ABSOLUTE_MAX_DEPTH)).success,
+    ).toBe(true);
+    expect(
+      OrgLevelConfigSchema.safeParse(row(ORG_UNIT_ABSOLUTE_MAX_DEPTH + 1))
+        .success,
+    ).toBe(false);
+  });
+
+  it("OrgUnitTreeNodeSchema bounds depth by the absolute ceiling, not the designed one", () => {
+    const shape = OrgUnitTreeNodeSchema.shape.depth;
+    expect(shape.safeParse(ORG_UNIT_DESIGNED_MAX_DEPTH + 1).success).toBe(true);
+    expect(shape.safeParse(ORG_UNIT_ABSOLUTE_MAX_DEPTH).success).toBe(true);
+    expect(shape.safeParse(ORG_UNIT_ABSOLUTE_MAX_DEPTH + 1).success).toBe(
+      false,
+    );
+  });
+
+  it("carries one unit-owner membership role per depth up to the absolute ceiling", () => {
+    const owners = UnitMembershipRoleSchema.options.filter(
+      (r) => r !== "member",
+    );
+    expect(owners).toHaveLength(ORG_UNIT_ABSOLUTE_MAX_DEPTH);
+    for (let depth = 1; depth <= ORG_UNIT_ABSOLUTE_MAX_DEPTH; depth++) {
+      expect(owners).toContain(`l${depth}_unit_owner`);
+    }
+  });
+});

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

@@ -90,7 +90,7 @@ describe("OrgUnitSchema", () => {
 });
 
 describe("OrgUnitTreeNodeSchema", () => {
-  it("requires depth 1..5", () => {
+  it("requires depth 1..20 (absolute ceiling)", () => {
     const base = {
       ...makeUnit(),
       depth: 3,
@@ -102,7 +102,10 @@ describe("OrgUnitTreeNodeSchema", () => {
     };
     expect(() => OrgUnitTreeNodeSchema.parse(base)).not.toThrow();
     expect(() => OrgUnitTreeNodeSchema.parse({ ...base, depth: 0 })).toThrow();
-    expect(() => OrgUnitTreeNodeSchema.parse({ ...base, depth: 6 })).toThrow();
+    expect(() =>
+      OrgUnitTreeNodeSchema.parse({ ...base, depth: 6 }),
+    ).not.toThrow();
+    expect(() => OrgUnitTreeNodeSchema.parse({ ...base, depth: 21 })).toThrow();
   });
 
   it("requires a non-negative openRoleCount", () => {
@@ -277,7 +280,7 @@ describe("OrgUnitRelationshipSchema", () => {
 });
 
 describe("OrgLevelConfigSchema", () => {
-  it("enforces depth 1..5, non-empty-when-present label/labelPlural, and icon enum", () => {
+  it("enforces depth 1..20, non-empty-when-present label/labelPlural, and icon enum", () => {
     const entry = {
       orgId: UUID_B,
       depth: 2,
@@ -296,7 +299,10 @@ describe("OrgLevelConfigSchema", () => {
         icon: null,
       }),
     ).not.toThrow();
-    expect(() => OrgLevelConfigSchema.parse({ ...entry, depth: 6 })).toThrow();
+    expect(() =>
+      OrgLevelConfigSchema.parse({ ...entry, depth: 6 }),
+    ).not.toThrow();
+    expect(() => OrgLevelConfigSchema.parse({ ...entry, depth: 21 })).toThrow();
     expect(() => OrgLevelConfigSchema.parse({ ...entry, label: "" })).toThrow();
     expect(() =>
       OrgLevelConfigSchema.parse({ ...entry, labelPlural: "" }),

package/src/org/company-md.ts

@@ -144,9 +144,9 @@ export interface CompanyMdNodeIdentity {
    * docs/goals/sources/maps that are not owned by a unit).
    *
    * Prefer this over `level` for structural reasoning. `level` is retained for
-   * backward compatibility and is @deprecated.
+   * backward compatibility and is @deprecated. Bounded 1..`ORG_UNIT_ABSOLUTE_MAX_DEPTH`.
    */
-  readonly depth: 1 | 2 | 3 | 4 | 5 | null;
+  readonly depth: number | null;
   readonly parentId: string | null;
   readonly visibility: CompanyMdVisibility;
   /**

package/src/org/index.ts

@@ -498,6 +498,10 @@ export type {
   OrgTreeResponse,
 } from "./org-units";
 export { ORG_UNITS_ROUTES } from "./org-units";
+export {
+  ORG_UNIT_DESIGNED_MAX_DEPTH,
+  ORG_UNIT_ABSOLUTE_MAX_DEPTH,
+} from "./org-depth";
 export {
   OrgUnitClassificationSchema,
   OrgUnitSyncModeSchema,

package/src/org/org-depth.ts

@@ -0,0 +1,51 @@
+/**
+ * Org-unit tree depth ceilings.
+ *
+ * Depth counts the org root as 1 (`nlevel(org_units.path)`). Two ceilings,
+ * deliberately distinct (backend ADR: org-unit depth, designed vs absolute):
+ *
+ * - {@link ORG_UNIT_DESIGNED_MAX_DEPTH} is the depth a human can build from
+ *   scratch. The UI's "+ New child", "Add level" and drag-reparent, and the
+ *   server's default (`designed`) depth policy, never deepen an org past
+ *   `max(DESIGNED, the org's current deepest unit)`.
+ * - {@link ORG_UNIT_ABSOLUTE_MAX_DEPTH} mirrors the database CHECK
+ *   (`org_units_depth_max`). Only ingest (structure inference apply, HRIS sync,
+ *   org-chart import) runs under the `absolute` policy and may deepen an org
+ *   past the designed depth, up to this bound. Nothing exceeds it.
+ *
+ * Both are compile-time constants, not per-org configuration.
+ */
+
+/** Depth a human may build from scratch; the UI ceiling for a fresh org. */
+export const ORG_UNIT_DESIGNED_MAX_DEPTH = 5;
+
+/** Hard ceiling mirrored by the `org_units_depth_max` CHECK; ingest-only past designed. */
+export const ORG_UNIT_ABSOLUTE_MAX_DEPTH = 20;
+
+/**
+ * The positional unit-owner membership roles, one per depth 1..absolute. Spelled
+ * out rather than generated so each member stays a string literal type; the
+ * schema that consumes it (`UnitMembershipRoleSchema`) adds `member` in front.
+ */
+export const UNIT_OWNER_MEMBERSHIP_ROLES = [
+  "l1_unit_owner",
+  "l2_unit_owner",
+  "l3_unit_owner",
+  "l4_unit_owner",
+  "l5_unit_owner",
+  "l6_unit_owner",
+  "l7_unit_owner",
+  "l8_unit_owner",
+  "l9_unit_owner",
+  "l10_unit_owner",
+  "l11_unit_owner",
+  "l12_unit_owner",
+  "l13_unit_owner",
+  "l14_unit_owner",
+  "l15_unit_owner",
+  "l16_unit_owner",
+  "l17_unit_owner",
+  "l18_unit_owner",
+  "l19_unit_owner",
+  "l20_unit_owner",
+] as const;

package/src/org/org-units.ts

@@ -18,7 +18,8 @@
  * - `path` is an ltree string maintained by a DB trigger; never written from
  *   application code.
  * - Depth is derived from `path`. `OrgLevelConfig.depth` is only a key for
- *   per-depth labels and policy — not authoritative structure.
+ *   per-depth labels and policy — not authoritative structure. Ceilings live in
+ *   `./org-depth` (designed 5, absolute 20; ingest-only past designed).
  */
 
 /** Semantic classification — projection-only, never drives traversal. */
@@ -113,7 +114,7 @@ export type { OrgUnitTreeResponse as OrgTreeResponse } from "./schemas";
 export type OrgUnitErrorCode =
   /** newParent.path contains unit.path — would create a cycle. */
   | "CYCLE_BLOCKED"
-  /** Reparent would push subtree above depth 5. */
+  /** Create/reparent would push the subtree past the effective depth ceiling (`./org-depth`). */
   | "DEPTH_EXCEEDED"
   /** Target parent is archived; reparenting into archived subtrees is forbidden. */
   | "TARGET_ARCHIVED"

package/src/org/schemas.ts

@@ -14,6 +14,10 @@ import { z } from "zod";
 import { CursorPageSchema, IsoDateTime } from "../api/primitives";
 import { OrgChartRoleSchema } from "../permissions/orgchart-roles";
 import { PositionRefSchema } from "../identity/position-ref";
+import {
+  ORG_UNIT_ABSOLUTE_MAX_DEPTH,
+  UNIT_OWNER_MEMBERSHIP_ROLES,
+} from "./org-depth";
 
 // ---------------------------------------------------------------------------
 // Sub-schemas
@@ -1496,15 +1500,12 @@ export const OrgUnitRelationshipRoleSchema = z.enum([
 /**
  * Positional slot a member holds in the org-unit tree. ORTHOGONAL to the
  * `OrgChartRole` policy vocabulary (this is an INPUT to authority resolution,
- * not the derived policy role). Level is encoded in the value (l1…l5).
+ * not the derived policy role). Level is encoded in the value (l1…l20, one
+ * per depth up to `ORG_UNIT_ABSOLUTE_MAX_DEPTH`).
  */
 export const UnitMembershipRoleSchema = z.enum([
   "member",
-  "l1_unit_owner",
-  "l2_unit_owner",
-  "l3_unit_owner",
-  "l4_unit_owner",
-  "l5_unit_owner",
+  ...UNIT_OWNER_MEMBERSHIP_ROLES,
 ]);
 
 export type UnitMembershipRole = z.infer<typeof UnitMembershipRoleSchema>;
@@ -1579,7 +1580,7 @@ export const MissingAtNextLevelSchema = z.object({
 });
 
 export const OrgUnitTreeNodeSchema = OrgUnitSchema.extend({
-  depth: z.number().int().min(1).max(5),
+  depth: z.number().int().min(1).max(ORG_UNIT_ABSOLUTE_MAX_DEPTH),
   hasChildren: z.boolean(),
   /**
    * WHAT it counts is the `.describe()` below — the single field-level
@@ -1871,7 +1872,7 @@ export const OrgLevelIconSchema = z.enum([
 
 export const OrgLevelConfigSchema = z.object({
   orgId: z.string().uuid(),
-  depth: z.number().int().min(1).max(5),
+  depth: z.number().int().min(1).max(ORG_UNIT_ABSOLUTE_MAX_DEPTH),
   label: z.string().min(1).nullable(),
   labelPlural: z.string().min(1).nullable(),
   icon: OrgLevelIconSchema.nullable(),