@company-semantics/contracts 12.1.0 → 13.0.0

package/package.json

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

package/src/api/generated.ts

@@ -718,6 +718,24 @@ export interface paths {
         patch: operations["changeMemberRole"];
         trace?: never;
     };
+    "/api/workspace/members/{id}/manager": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Clear a member's solid-line manager (org-chart reporting edge) */
+        delete: operations["clearMemberManager"];
+        options?: never;
+        head?: never;
+        /** Set a member's solid-line manager (org-chart reporting edge) */
+        patch: operations["setMemberManager"];
+        trace?: never;
+    };
     "/api/rbac/roles": {
         parameters: {
             query?: never;
@@ -3490,6 +3508,17 @@ export interface components {
             /** @enum {string} */
             newRole: "admin" | "member";
         };
+        SetMemberManagerResponse: {
+            success: boolean;
+            memberId: string;
+            managerUserId: string | null;
+            relationshipType: string;
+            message: string;
+        };
+        SetMemberManagerRequest: {
+            /** Format: uuid */
+            managerUserId: string;
+        };
         RoleCatalogResponse: {
             roles: {
                 name: string;
@@ -6163,6 +6192,54 @@ export interface operations {
             };
         };
     };
+    clearMemberManager: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Manager cleared successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SetMemberManagerResponse"];
+                };
+            };
+        };
+    };
+    setMemberManager: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SetMemberManagerRequest"];
+            };
+        };
+        responses: {
+            /** @description Manager set successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SetMemberManagerResponse"];
+                };
+            };
+        };
+    };
     getRbacRoles: {
         parameters: {
             query?: never;

package/src/generated/openapi-routes.ts

@@ -145,6 +145,7 @@ export const openApiRoutes = {
   '/api/workspace/invites/{id}': ['DELETE'],
   '/api/workspace/members': ['GET'],
   '/api/workspace/members/{id}': ['DELETE', 'GET'],
+  '/api/workspace/members/{id}/manager': ['DELETE', 'PATCH'],
   '/api/workspace/members/{id}/role': ['PATCH'],
   '/api/workspace/name': ['PATCH'],
   '/api/workspace/organization': ['PATCH'],

package/src/org/schemas.ts

@@ -73,7 +73,7 @@ const WorkspaceMemberSchema = z.object({
    * plain member with no org-chart authority. Render via `orgChartRoleLabel`.
    */
   role: OrgChartRoleSchema.nullable(),
-  /** Raw RBAC role names (e.g. 'ceo', 'admin', 'delegate'). Superset of `role`. */
+  /** Raw RBAC role names (e.g. 'owner', 'admin', 'delegate'). Superset of `role`. */
   roleNames: z.array(z.string()),
   joinedAt: z.string(),
   /** ISO timestamp of last activity; null if never recorded. */
@@ -165,6 +165,14 @@ export const WorkspaceOverviewSchema = z.object({
   type: z.enum(["personal", "shared"]),
   logoUrl: z.string().nullable(),
   owner: WorkspaceOwnerSchema,
+  /**
+   * Org-configured display title for the `owner` org-chart role
+   * (ADR-CONTRACTS-061). Server-resolved: `orgs.owner_title` when set,
+   * otherwise the default "CEO". Always present; pass to
+   * `orgChartRoleLabel(role, { ownerTitle })` wherever the owner badge or
+   * section heading renders. Presentation only — never an authorization input.
+   */
+  ownerTitle: z.string(),
   createdAt: z.string(),
   memberCount: z.number(),
   claimable: z.boolean(),
@@ -455,7 +463,7 @@ export type ChangeMemberRoleResponse = z.infer<
  *
  * Distinct from team membership (RBAC scopes) and `primary_unit_id` (home
  * unit): neither of those places a person in the reporting hierarchy.
- * See ADR-BE-250.
+ * See ADR-BE-253.
  */
 export const SetMemberManagerResponseSchema = z.object({
   success: z.boolean(),

package/src/permissions/orgchart-roles.ts

@@ -22,7 +22,12 @@
  */
 import { z } from "zod";
 
-export const ORG_CHART_ROLES = ["ceo", "leader", "delegate", "admin"] as const;
+export const ORG_CHART_ROLES = [
+  "owner",
+  "leader",
+  "delegate",
+  "admin",
+] as const;
 export type OrgChartRole = (typeof ORG_CHART_ROLES)[number];
 
 export const OrgChartRoleSchema = z.enum(ORG_CHART_ROLES);
@@ -30,15 +35,32 @@ export const OrgChartRoleSchema = z.enum(ORG_CHART_ROLES);
 /**
  * Human-readable labels for the org-chart role display badge. `null` (no
  * org-chart standing) renders as "Member" via {@link orgChartRoleLabel}.
+ *
+ * `owner` is the organization's highest-authority individual (the account
+ * owner, or a structural leader of the root unit). Its DEFAULT label is
+ * "CEO" — what every new org sees — and is org-renamable via the
+ * `owner_title` org setting (ADR-CONTRACTS-061); pass the org's resolved
+ * title through {@link orgChartRoleLabel}'s `ownerTitle` option to apply it.
  */
 export const ORG_CHART_ROLE_LABELS: Record<OrgChartRole, string> = {
-  ceo: "CEO",
+  owner: "CEO",
   leader: "Leader",
   delegate: "Delegate",
   admin: "Admin",
 };
 
-/** Display label for a (possibly null) org-chart role; `null` = plain member. */
-export function orgChartRoleLabel(role: OrgChartRole | null): string {
-  return role === null ? "Member" : ORG_CHART_ROLE_LABELS[role];
+/**
+ * Display label for a (possibly null) org-chart role; `null` = plain member.
+ *
+ * `ownerTitle` is the org's configured owner display title
+ * (`WorkspaceOverview.ownerTitle`, server-resolved, default "CEO"); it
+ * overrides the static label for the `owner` role only.
+ */
+export function orgChartRoleLabel(
+  role: OrgChartRole | null,
+  opts?: { ownerTitle?: string },
+): string {
+  if (role === null) return "Member";
+  if (role === "owner" && opts?.ownerTitle) return opts.ownerTitle;
+  return ORG_CHART_ROLE_LABELS[role];
 }