@company-semantics/contracts 21.2.0 → 22.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "21.2.0",
+  "version": "22.0.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 = '04f6a4a8fe16' as const;
-export const SPEC_HASH_FULL = '04f6a4a8fe169119fda699f1854d409df278ac5dd7ab16f1d5affff6cd133e47' as const;
+export const SPEC_HASH = 'c4553ad2d609' as const;
+export const SPEC_HASH_FULL = 'c4553ad2d6092751eed87104b6614f3ef60884954c1d5a029a98129d32c5b9bf' as const;

package/src/api/generated.ts

@@ -3449,6 +3449,8 @@ export interface components {
                     unitName: string;
                     /** @enum {string} */
                     designation: "whole_org" | "admin" | "unit_owner" | "delegate" | "member";
+                    /** @enum {string} */
+                    mutability: "derived" | "user_managed";
                 }[];
                 unitMembershipsTruncated: boolean;
                 inviteStatus: ("active" | "pending" | "expired") | null;
@@ -3644,6 +3646,8 @@ export interface components {
                 unitName: string;
                 /** @enum {string} */
                 designation: "whole_org" | "admin" | "unit_owner" | "delegate" | "member";
+                /** @enum {string} */
+                mutability: "derived" | "user_managed";
             }[];
             unitMembershipsTruncated: boolean;
             inviteStatus: ("active" | "pending" | "expired") | null;
@@ -3774,6 +3778,19 @@ export interface components {
                 homeUnitId?: string;
                 /** @enum {string} */
                 homeUnitRole?: "member" | "unit_owner";
+                stagedPlacement?: {
+                    title?: string;
+                    /** Format: uuid */
+                    managerUserId?: string;
+                    /** Format: uuid */
+                    homeUnitId?: string;
+                    /** @enum {string} */
+                    homeUnitRole?: "member" | "unit_owner";
+                    /** @default [] */
+                    unitOwnerOf: string[];
+                    /** @default [] */
+                    contributesTo: string[];
+                };
                 createdAt: string;
                 expiresAt: string;
                 acceptedAt?: string;
@@ -3805,6 +3822,19 @@ export interface components {
             homeUnitId?: string;
             /** @enum {string} */
             homeUnitRole?: "member" | "unit_owner";
+            stagedPlacement?: {
+                title?: string;
+                /** Format: uuid */
+                managerUserId?: string;
+                /** Format: uuid */
+                homeUnitId?: string;
+                /** @enum {string} */
+                homeUnitRole?: "member" | "unit_owner";
+                /** @default [] */
+                unitOwnerOf: string[];
+                /** @default [] */
+                contributesTo: string[];
+            };
             createdAt: string;
             expiresAt: string;
             acceptedAt?: string;
@@ -4781,6 +4811,8 @@ export interface components {
                     /** Format: uuid */
                     id: string;
                     name: string;
+                    /** @enum {string} */
+                    mutability: "derived" | "user_managed";
                 }[];
             }[];
             edges: {

package/src/identity/README.md

@@ -84,7 +84,7 @@ TypeScript types and functions for user identity and display name resolution.
 
 **Internal domains:**
 
-_None._
+- `org`
 
 **External packages:**
 

package/src/identity/people-org-chart.ts

@@ -12,6 +12,7 @@
  * ADR-BE-120). Tree traversal must never consult either.
  */
 import { z } from "zod";
+import { AuthorityMutabilitySchema } from "../org/schemas";
 
 // ---------------------------------------------------------------------------
 // Reporting Relationship Type
@@ -34,6 +35,14 @@ export type ReportingRelationshipType = z.infer<
 export const PeopleOrgChartOwnedUnitSchema = z.object({
   id: z.string().uuid(),
   name: z.string(),
+  // Whether this local structural ownership is DERIVED from reporting topology
+  // (the senior person homed in a unit with no manager inside it — ADR-BE-267/
+  // 294/329) or an explicit grant (`user_managed`). The chart marks a derived
+  // owner with the distinct ✧ marker (not the held-key glyph). A derived owner
+  // can't be revoked in place — only relinquished. Display + affordance gating
+  // only; never an authorization input. Mirrors `WorkspaceMemberUnitDesignation
+  // Entry.mutability`.
+  mutability: AuthorityMutabilitySchema,
 });
 
 export type PeopleOrgChartOwnedUnit = z.infer<

package/src/org/schemas.ts

@@ -43,10 +43,31 @@ export const OrgUnitDesignationSchema = z.enum([
 ]);
 export type OrgUnitDesignation = z.infer<typeof OrgUnitDesignationSchema>;
 
+/**
+ * Whether the user can change this authority from this surface.
+ *  - `derived`: change the upstream source instead (the org chart, RBAC roles).
+ *  - `user_managed`: removable from this UI.
+ *
+ * Hoisted above {@link WorkspaceMemberUnitDesignationEntrySchema} so the
+ * per-unit designation can carry it; also consumed by {@link OwnerAuthoritySchema}.
+ */
+export const AuthorityMutabilitySchema = z.enum(["derived", "user_managed"]);
+export type AuthorityMutability = z.infer<typeof AuthorityMutabilitySchema>;
+
 export const WorkspaceMemberUnitDesignationEntrySchema = z.object({
   unitId: z.string(),
   unitName: z.string(),
   designation: OrgUnitDesignationSchema,
+  /**
+   * Whether this designation is REMOVABLE in place (`user_managed` — an explicit
+   * overlay grant or `l{N}_unit_owner` membership) or DERIVED from reporting
+   * topology (`derived` — the senior person homed in a unit with no manager
+   * inside it, ADR-BE-267/294). A `derived` owner can't be revoked: the holder
+   * must relinquish it (recorded as a higher-provenance suppression that the
+   * structural projection honors) or the upstream chart must change. Display +
+   * affordance gating only; never an authorization input.
+   */
+  mutability: AuthorityMutabilitySchema,
 });
 export type WorkspaceMemberUnitDesignationEntry = z.infer<
   typeof WorkspaceMemberUnitDesignationEntrySchema
@@ -1141,13 +1162,8 @@ export type AuthorityMechanism = z.infer<typeof AuthorityMechanismSchema>;
 export const AuthorityLocalitySchema = z.enum(["local", "inherited"]);
 export type AuthorityLocality = z.infer<typeof AuthorityLocalitySchema>;
 
-/**
- * Whether the user can change this authority from this surface.
- *  - `derived`: change the upstream source instead (the org chart, RBAC roles).
- *  - `user_managed`: removable from this UI.
- */
-export const AuthorityMutabilitySchema = z.enum(["derived", "user_managed"]);
-export type AuthorityMutability = z.infer<typeof AuthorityMutabilitySchema>;
+// AuthorityMutabilitySchema is defined above (hoisted next to
+// WorkspaceMemberUnitDesignationEntrySchema, which also carries it).
 
 export const OwnerAuthoritySchema = z.object({
   mechanism: AuthorityMechanismSchema,