@company-semantics/contracts 15.1.0 → 16.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "15.1.0",
+  "version": "16.0.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -109,7 +109,9 @@
     "generate:api-types": "openapi-typescript openapi/backend.yaml -o src/api/generated.ts",
     "generate:openapi-routes": "tsx scripts/generate-openapi-routes.ts",
     "generate:api-types:check": "openapi-typescript openapi/backend.yaml -o /tmp/cs-api-types-check.ts && diff -q src/api/generated.ts /tmp/cs-api-types-check.ts",
-    "generate:current": "tsx ../company-semantics-ci/scripts/generate-current.ts"
+    "generate:current": "tsx ../company-semantics-ci/scripts/generate-current.ts",
+    "repo-map": "tsx ../company-semantics-ci/scripts/generate-repo-map.ts --roots src --name company-semantics-contracts --write",
+    "repo-map:check": "tsx ../company-semantics-ci/scripts/generate-repo-map.ts --roots src --name company-semantics-contracts --check"
   },
   "packageManager": "pnpm@10.25.0",
   "engines": {

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 = '575c0e0c7f6c' as const;
-export const SPEC_HASH_FULL = '575c0e0c7f6c7fdec000c8914101c527ed9e783b38bbfbe5aab536200d1b1da1' as const;
+export const SPEC_HASH = 'bd74b6f7478d' as const;
+export const SPEC_HASH_FULL = 'bd74b6f7478dcfb445d1e848ab3b65309f9b602b40c3fe2f0ce29b484e94943f' as const;

package/src/api/generated.ts

@@ -3415,7 +3415,7 @@ export interface components {
                 email: string;
                 avatarUrl?: string | null;
                 jobTitle: string | null;
-                role: ("owner" | "leader" | "delegate" | "admin") | null;
+                role: ("owner" | "unit_owner" | "delegate" | "admin") | null;
                 roleNames: string[];
                 joinedAt: string;
                 lastActiveAt: string | null;
@@ -3427,11 +3427,11 @@ export interface components {
                     /** @enum {string} */
                     role: "owner" | "manager" | "member";
                 }[];
-                manages: {
+                unitDesignations: {
                     unitId: string;
                     unitName: string;
                     /** @enum {string} */
-                    designation: "whole_org" | "admin" | "leader" | "delegate" | "member";
+                    designation: "whole_org" | "admin" | "unit_owner" | "delegate" | "member";
                 }[];
                 unitMembershipsTruncated: boolean;
                 inviteStatus: ("active" | "pending" | "expired") | null;
@@ -3610,7 +3610,7 @@ export interface components {
             email: string;
             avatarUrl?: string | null;
             jobTitle: string | null;
-            role: ("owner" | "leader" | "delegate" | "admin") | null;
+            role: ("owner" | "unit_owner" | "delegate" | "admin") | null;
             roleNames: string[];
             joinedAt: string;
             lastActiveAt: string | null;
@@ -3622,11 +3622,11 @@ export interface components {
                 /** @enum {string} */
                 role: "owner" | "manager" | "member";
             }[];
-            manages: {
+            unitDesignations: {
                 unitId: string;
                 unitName: string;
                 /** @enum {string} */
-                designation: "whole_org" | "admin" | "leader" | "delegate" | "member";
+                designation: "whole_org" | "admin" | "unit_owner" | "delegate" | "member";
             }[];
             unitMembershipsTruncated: boolean;
             inviteStatus: ("active" | "pending" | "expired") | null;
@@ -3698,7 +3698,7 @@ export interface components {
                 orgId: string;
                 orgName: string;
                 orgSlug: string;
-                role: ("owner" | "leader" | "delegate" | "admin") | null;
+                role: ("owner" | "unit_owner" | "delegate" | "admin") | null;
                 joinedAt: string;
                 isActive: boolean;
                 /** @enum {string} */
@@ -3743,7 +3743,7 @@ export interface components {
                 /** Format: uuid */
                 homeUnitId?: string;
                 /** @enum {string} */
-                homeUnitRole?: "member" | "leader";
+                homeUnitRole?: "member" | "unit_owner";
                 createdAt: string;
                 expiresAt: string;
                 acceptedAt?: string;
@@ -3757,7 +3757,7 @@ export interface components {
             /** Format: uuid */
             homeUnitId?: string;
             /** @enum {string} */
-            homeUnitRole?: "member" | "leader";
+            homeUnitRole?: "member" | "unit_owner";
         };
         InviteListResponse: {
             id: string;
@@ -3774,7 +3774,7 @@ export interface components {
             /** Format: uuid */
             homeUnitId?: string;
             /** @enum {string} */
-            homeUnitRole?: "member" | "leader";
+            homeUnitRole?: "member" | "unit_owner";
             createdAt: string;
             expiresAt: string;
             acceptedAt?: string;
@@ -4648,7 +4648,7 @@ export interface components {
         OrgUnitMyAuthorityResponse: {
             /** Format: uuid */
             unitId: string;
-            role: ("owner" | "leader" | "delegate" | "admin") | null;
+            role: ("owner" | "unit_owner" | "delegate" | "admin") | null;
             canManageMembers: boolean;
             canAssignDelegate: boolean;
             canAssignAdmin: boolean;

package/src/org/index.ts

@@ -141,8 +141,9 @@ export {
   WorkspaceOverviewSchema,
   WorkspaceMembersResponseSchema,
   WorkspaceMemberDetailSchema,
-  WorkspaceMemberManagesEntrySchema,
+  WorkspaceMemberUnitDesignationEntrySchema,
   OrgUnitDesignationSchema,
+  HomeUnitRoleSchema,
   RoleCatalogEntrySchema,
   RoleCatalogResponseSchema,
   WorkspaceAuthConfigSchema,
@@ -168,8 +169,9 @@ export type {
   WorkspaceAccessResponse,
   WorkspaceOverview as WorkspaceOverviewDto,
   WorkspaceMembersResponse,
-  WorkspaceMemberManagesEntry,
+  WorkspaceMemberUnitDesignationEntry,
   OrgUnitDesignation,
+  HomeUnitRole,
   WorkspaceAuthConfig as WorkspaceAuthConfigDto,
   WorkspaceAuditEvent as WorkspaceAuditEventDto,
   WorkspaceResolvePathResponse,

package/src/org/schemas.ts

@@ -28,7 +28,7 @@ const WorkspaceMemberUnitSummarySchema = z.object({
 /**
  * Designation a member holds over a unit they manage (ADR-CTRL-112).
  *
- * Precedence, highest-first: whole_org > admin > leader > delegate > member.
+ * Precedence, highest-first: whole_org > admin > unit_owner > delegate > member.
  * The org-wide designations (`whole_org`, `admin`) anchor to the org root
  * unit. This vocabulary is DISPLAY-ONLY — it summarizes management reach for
  * UI surfaces and is NEVER an authorization input (authority resolution uses
@@ -37,19 +37,19 @@ const WorkspaceMemberUnitSummarySchema = z.object({
 export const OrgUnitDesignationSchema = z.enum([
   "whole_org",
   "admin",
-  "leader",
+  "unit_owner",
   "delegate",
   "member",
 ]);
 export type OrgUnitDesignation = z.infer<typeof OrgUnitDesignationSchema>;
 
-export const WorkspaceMemberManagesEntrySchema = z.object({
+export const WorkspaceMemberUnitDesignationEntrySchema = z.object({
   unitId: z.string(),
   unitName: z.string(),
   designation: OrgUnitDesignationSchema,
 });
-export type WorkspaceMemberManagesEntry = z.infer<
-  typeof WorkspaceMemberManagesEntrySchema
+export type WorkspaceMemberUnitDesignationEntry = z.infer<
+  typeof WorkspaceMemberUnitDesignationEntrySchema
 >;
 
 const WorkspaceMemberSchema = z.object({
@@ -87,11 +87,13 @@ const WorkspaceMemberSchema = z.object({
   /** OrgUnit memberships for this member, capped at a small number server-side. */
   unitMemberships: z.array(WorkspaceMemberUnitSummarySchema),
   /**
-   * Per-unit org-chart designations the member holds where they manage
-   * (ADR-CTRL-112). Display-only summary of management reach; never an
-   * authorization input. Empty array when the member manages nothing.
+   * Per-unit org-chart designations the member holds (ADR-CTRL-112). Carries
+   * BOTH management-reach entries (whole_org/admin/unit_owner/delegate) and
+   * plain contributor entries (`member`); consumers split by designation.
+   * Display-only summary; never an authorization input. Empty array when the
+   * member holds no per-unit designation.
    */
-  manages: z.array(WorkspaceMemberManagesEntrySchema),
+  unitDesignations: z.array(WorkspaceMemberUnitDesignationEntrySchema),
   /** True when server truncated `unitMemberships`; detail endpoint returns the full list. */
   unitMembershipsTruncated: z.boolean(),
   /** Invite lifecycle status. `null` for members without an invite record. */
@@ -595,6 +597,15 @@ export type ScopeCheckBatchResponse = z.infer<
 // Invite sub-schema
 // ---------------------------------------------------------------------------
 
+/**
+ * Role the invitee takes in their home unit on acceptance. `unit_owner` is a
+ * deferred structural-leadership grant applied at accept time. Source of truth
+ * for the hand-mirrored `OrgInvite`/`CreateInviteRequest` interface unions in
+ * `org/types.ts` (enforced by the `schema-type-mirror` guard).
+ */
+export const HomeUnitRoleSchema = z.enum(["member", "unit_owner"]);
+export type HomeUnitRole = z.infer<typeof HomeUnitRoleSchema>;
+
 const OrgInviteSchema = z.object({
   id: z.string(),
   orgId: z.string(),
@@ -605,9 +616,10 @@ const OrgInviteSchema = z.object({
   // Home unit the invitee is placed in on acceptance (users.primary_unit_id).
   // Optional/nullable: legacy invites predate this field.
   homeUnitId: z.string().uuid().optional(),
-  // Role the invitee takes in homeUnitId on acceptance ('leader' is a deferred
-  // structural-leadership grant). Optional/'member' for legacy + unit-less invites.
-  homeUnitRole: z.enum(["member", "leader"]).optional(),
+  // Role the invitee takes in homeUnitId on acceptance ('unit_owner' is a
+  // deferred structural-leadership grant). Optional/'member' for legacy +
+  // unit-less invites.
+  homeUnitRole: HomeUnitRoleSchema.optional(),
   createdAt: z.string(),
   expiresAt: z.string(),
   acceptedAt: z.string().optional(),

package/src/org/types.ts

@@ -420,11 +420,11 @@ export interface OrgInvite {
   homeUnitId?: string;
   /**
    * Role the invitee takes in `homeUnitId` on acceptance — a plain team member,
-   * or a structural leader of that unit (a *deferred* leadership grant applied
+   * or a unit owner of that unit (a *deferred* leadership grant applied
    * at acceptance time). Distinct from the org-level {@link role}. Optional:
    * legacy invites and unit-less invites have none (treated as `member`).
    */
-  homeUnitRole?: "member" | "leader";
+  homeUnitRole?: "member" | "unit_owner";
   createdAt: string;
   expiresAt: string;
   acceptedAt?: string;
@@ -444,12 +444,12 @@ export interface CreateInviteRequest {
   homeUnitId?: string;
   /**
    * Role the invitee takes in `homeUnitId` on acceptance: a plain team member
-   * (default), or a structural leader of that unit. `leader` is a *deferred*
+   * (default), or a unit owner of that unit. `unit_owner` is a *deferred*
    * grant — the invite is sent now and the leadership is assigned when the
    * invitee accepts. Only meaningful when `homeUnitId` is set; the backend
-   * rejects `leader` without a home unit. Optional/`member` for older callers.
+   * rejects `unit_owner` without a home unit. Optional/`member` for older callers.
    */
-  homeUnitRole?: "member" | "leader";
+  homeUnitRole?: "member" | "unit_owner";
 }
 
 /**

package/src/permissions/orgchart-roles.ts

@@ -24,7 +24,7 @@ import { z } from "zod";
 
 export const ORG_CHART_ROLES = [
   "owner",
-  "leader",
+  "unit_owner",
   "delegate",
   "admin",
 ] as const;
@@ -44,7 +44,7 @@ export const OrgChartRoleSchema = z.enum(ORG_CHART_ROLES);
  */
 export const ORG_CHART_ROLE_LABELS: Record<OrgChartRole, string> = {
   owner: "CEO",
-  leader: "Unit owner",
+  unit_owner: "Unit owner",
   delegate: "Delegate",
   admin: "Admin",
 };