@company-semantics/contracts 1.18.0 → 1.19.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "1.18.0",
+  "version": "1.19.1",
   "private": false,
   "repository": {
     "type": "git",
@@ -112,7 +112,7 @@
     "node": "22.x"
   },
   "dependencies": {
-    "zod": "^4.4.1"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
@@ -123,7 +123,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5",
     "vitest": "^4.1.5",
-    "yaml": "^2.8.3"
+    "yaml": "^2.8.4"
   },
   "pnpm": {
     "overrides": {

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 = '6edfe6e7117c' as const;
-export const SPEC_HASH_FULL = '6edfe6e7117c49e81cd7cad51ac9cd5c6f4c9e18cf7a37ff82a5630855404a00' as const;
+export const SPEC_HASH = '31649ac66bff' as const;
+export const SPEC_HASH_FULL = '31649ac66bff5a6c278ce4139c06aa4df50333ef325c11e916698f9b578d68e8' as const;

package/src/api/generated.ts

@@ -2394,6 +2394,7 @@ export interface components {
                 roleNames: string[];
                 joinedAt: string;
                 lastActiveAt: string | null;
+                primaryUnitId: string | null;
                 unitMemberships: {
                     unitId: string;
                     unitName: string;
@@ -2581,6 +2582,7 @@ export interface components {
             roleNames: string[];
             joinedAt: string;
             lastActiveAt: string | null;
+            primaryUnitId: string | null;
             unitMemberships: {
                 unitId: string;
                 unitName: string;
@@ -3085,6 +3087,10 @@ export interface components {
                 depth: number;
                 hasChildren: boolean;
                 memberCount: number;
+                missingAtNextLevel: {
+                    count: number;
+                    userIds: string[];
+                } | null;
             }[];
         };
         OrgUnitDescendantsResponse: {
@@ -3228,6 +3234,10 @@ export interface components {
                 depth: number;
                 hasChildren: boolean;
                 memberCount: number;
+                missingAtNextLevel: {
+                    count: number;
+                    userIds: string[];
+                } | null;
             }[];
             levelConfig: {
                 /** Format: uuid */

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

@@ -78,7 +78,13 @@ describe('OrgUnitSchema', () => {
 
 describe('OrgUnitTreeNodeSchema', () => {
   it('requires depth 1..5', () => {
-    const base = { ...makeUnit(), depth: 3, hasChildren: true, memberCount: 5 };
+    const base = {
+      ...makeUnit(),
+      depth: 3,
+      hasChildren: true,
+      memberCount: 5,
+      missingAtNextLevel: null,
+    };
     expect(() => OrgUnitTreeNodeSchema.parse(base)).not.toThrow();
     expect(() => OrgUnitTreeNodeSchema.parse({ ...base, depth: 0 })).toThrow();
     expect(() => OrgUnitTreeNodeSchema.parse({ ...base, depth: 6 })).toThrow();
@@ -154,7 +160,10 @@ describe('OrgLevelConfigSchema', () => {
 describe('Response schemas', () => {
   it('OrgUnitTreeResponseSchema accepts empty tree', () => {
     expect(() =>
-      OrgUnitTreeResponseSchema.parse({ nodes: [], levelConfig: [] })
+      OrgUnitTreeResponseSchema.parse({
+        nodes: [],
+        levelConfig: [],
+      })
     ).not.toThrow();
   });
 

package/src/org/index.ts

@@ -234,6 +234,7 @@ export {
   OrgLevelIconSchema,
   OrgUnitResponseSchema,
   OrgUnitTreeResponseSchema,
+  MissingAtNextLevelSchema,
   OrgUnitChildrenResponseSchema,
   OrgUnitAncestorsResponseSchema,
   OrgUnitDescendantsResponseSchema,
@@ -255,6 +256,7 @@ export type {
   OrgLevelIcon,
   OrgUnitResponse,
   OrgUnitTreeResponse,
+  MissingAtNextLevel,
   OrgUnitChildrenResponse,
   OrgUnitAncestorsResponse,
   OrgUnitDescendantsResponse,

package/src/org/schemas.ts

@@ -32,6 +32,7 @@ const WorkspaceMemberSchema = z.object({
   roleNames: z.array(z.string()),
   joinedAt: z.string(),
   lastActiveAt: z.string().nullable(),
+  primaryUnitId: z.string().uuid().nullable(),
   unitMemberships: z.array(WorkspaceMemberUnitSummarySchema),
   unitMembershipsTruncated: z.boolean(),
   inviteStatus: z.enum(['active', 'pending', 'expired']).nullable(),
@@ -712,10 +713,23 @@ export const OrgUnitSchema = z.object({
   updatedAt: z.string(),
 });
 
+/**
+ * Active users home directly at this unit who have no level-(depth+1) home
+ * assignment within its subtree. The settings UI surfaces this as a
+ * synthetic "[child level label] assignment missing" row above the
+ * children list at every level. `null` for leaf-level units (no children
+ * configured below them) where the concept is meaningless.
+ */
+export const MissingAtNextLevelSchema = z.object({
+  count: z.number().int().min(0),
+  userIds: z.array(z.string().uuid()),
+});
+
 export const OrgUnitTreeNodeSchema = OrgUnitSchema.extend({
   depth: z.number().int().min(1).max(5),
   hasChildren: z.boolean(),
   memberCount: z.number().int().min(0),
+  missingAtNextLevel: MissingAtNextLevelSchema.nullable(),
 });
 
 export const OrgUnitMembershipSchema = z.object({
@@ -852,6 +866,7 @@ export type OrgLevelConfig = z.infer<typeof OrgLevelConfigSchema>;
 export type OrgLevelIcon = z.infer<typeof OrgLevelIconSchema>;
 export type OrgUnitResponse = z.infer<typeof OrgUnitResponseSchema>;
 export type OrgUnitTreeResponse = z.infer<typeof OrgUnitTreeResponseSchema>;
+export type MissingAtNextLevel = z.infer<typeof MissingAtNextLevelSchema>;
 export type OrgUnitChildrenResponse = z.infer<typeof OrgUnitChildrenResponseSchema>;
 export type OrgUnitAncestorsResponse = z.infer<typeof OrgUnitAncestorsResponseSchema>;
 export type OrgUnitDescendantsResponse = z.infer<typeof OrgUnitDescendantsResponseSchema>;

package/src/org/types.ts

@@ -125,6 +125,12 @@ export interface WorkspaceMember {
   joinedAt: string;
   /** ISO timestamp of last activity; null if never recorded. */
   lastActiveAt: string | null;
+  /**
+   * Home org-unit (`users.primary_unit_id`). Null for org-scoped users
+   * (no level-2 home assignment). Used by the unit-detail Members table to
+   * roll up "people in this org-unit" across the subtree.
+   */
+  primaryUnitId: string | null;
   /** OrgUnit memberships for this member, capped at a small number server-side. */
   unitMemberships: WorkspaceMemberUnitSummary[];
   /** True when server truncated `unitMemberships`; detail endpoint returns the full list. */