@company-semantics/contracts 20.1.0 → 21.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "20.1.0",
+  "version": "21.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 = '79972d6725ff' as const;
-export const SPEC_HASH_FULL = '79972d6725ff3dfd29ee68945c8006039eddc196eadaeb0bcd77abeeebf2b066' as const;
+export const SPEC_HASH = '04f6a4a8fe16' as const;
+export const SPEC_HASH_FULL = '04f6a4a8fe169119fda699f1854d409df278ac5dd7ab16f1d5affff6cd133e47' as const;

package/src/api/generated.ts

@@ -736,6 +736,23 @@ export interface paths {
         patch: operations["setMemberManager"];
         trace?: never;
     };
+    "/api/reporting/bulk-reparent": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Atomically re-point many members' solid manager to one new manager */
+        post: operations["bulkReparentReporting"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/chat/interactive-tasks/submit": {
         parameters: {
             query?: never;
@@ -3667,6 +3684,19 @@ export interface components {
             /** Format: uuid */
             managerUserId: string;
         };
+        BulkReparentReportingResponse: {
+            /** @constant */
+            success: true;
+            movedCount: number;
+            /** Format: uuid */
+            toManagerId: string;
+        };
+        BulkReparentReportingRequest: {
+            memberIds: string[];
+            /** Format: uuid */
+            toManagerId: string;
+            idempotencyKey: string;
+        };
         SubmitInteractiveTaskResponse: {
             executionId: string;
             /** @enum {string} */
@@ -4147,6 +4177,7 @@ export interface components {
                 name: string;
             } | null;
             canEdit: boolean;
+            inheritsFromId: string | null;
             inheritsFrom: string | null;
             sources: {
                 label: string;
@@ -4155,6 +4186,7 @@ export interface components {
                 referencedAt: string;
             }[];
             dependencies: {
+                targetId: string;
                 targetSlug: string;
                 description: string;
             }[];
@@ -6573,6 +6605,30 @@ export interface operations {
             };
         };
     };
+    bulkReparentReporting: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BulkReparentReportingRequest"];
+            };
+        };
+        responses: {
+            /** @description Cluster reorg applied atomically */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BulkReparentReportingResponse"];
+                };
+            };
+        };
+    };
     submitInteractiveTask: {
         parameters: {
             query?: never;

package/src/content/schemas.ts

@@ -28,6 +28,9 @@ const CompanyMdSourceSchema = z.object({
 });
 
 const CompanyMdDependencySchema = z.object({
+  // Stable id of the target doc — the resolution key (ADR-BE-315). `targetSlug`
+  // is presentation only; slugs are only parent-scoped unique post-ADR-BE-315.
+  targetId: z.string(),
   targetSlug: z.string(),
   description: z.string(),
 });
@@ -85,6 +88,9 @@ export const CompanyMdDocResponseSchema = z.object({
   owningUnitId: z.string().nullable(),
   owner: CompanyMdPersonSchema.nullable(),
   canEdit: z.boolean(),
+  // Stable id of the inherited-from doc — the resolution key (mirrors the
+  // resolved parentId). `inheritsFrom` is presentation only (ADR-BE-315).
+  inheritsFromId: z.string().nullable(),
   inheritsFrom: z.string().nullable(),
   sources: z.array(CompanyMdSourceSchema),
   dependencies: z.array(CompanyMdDependencySchema),

package/src/generated/openapi-routes.ts

@@ -22,20 +22,20 @@ export const openApiRoutes = {
   '/api/chats/{id}/messages/{messageId}': ['DELETE'],
   '/api/chats/{id}/pin': ['DELETE', 'POST'],
   '/api/company-md/context-bank': ['POST'],
-  '/api/company-md/docs/{parentSlug}/context-bank/upload': ['POST'],
-  '/api/company-md/docs/{slug}': ['GET'],
-  '/api/company-md/docs/{slug}/content': ['PUT'],
-  '/api/company-md/docs/{slug}/context-bank': ['GET'],
-  '/api/company-md/docs/{slug}/context-bank/associate': ['POST'],
-  '/api/company-md/docs/{slug}/context-bank/retry': ['POST'],
-  '/api/company-md/docs/{slug}/context-bank/{contextDocSlug}': ['DELETE'],
-  '/api/company-md/docs/{slug}/context-bank/{id}/order': ['PATCH'],
-  '/api/company-md/docs/{slug}/sharing': ['GET'],
-  '/api/company-md/docs/{slug}/sharing/acl': ['POST'],
-  '/api/company-md/docs/{slug}/sharing/acl/{aclId}': ['DELETE', 'PUT'],
-  '/api/company-md/docs/{slug}/sharing/policy': ['PUT'],
-  '/api/company-md/docs/{slug}/title': ['PUT'],
-  '/api/company-md/docs/{slug}/transfer-owner': ['POST'],
+  '/api/company-md/docs/{id}': ['GET'],
+  '/api/company-md/docs/{id}/content': ['PUT'],
+  '/api/company-md/docs/{id}/context-bank': ['GET'],
+  '/api/company-md/docs/{id}/context-bank/associate': ['POST'],
+  '/api/company-md/docs/{id}/context-bank/retry': ['POST'],
+  '/api/company-md/docs/{id}/context-bank/upload': ['POST'],
+  '/api/company-md/docs/{id}/context-bank/{contextDocId}': ['DELETE'],
+  '/api/company-md/docs/{id}/context-bank/{contextDocId}/order': ['PATCH'],
+  '/api/company-md/docs/{id}/sharing': ['GET'],
+  '/api/company-md/docs/{id}/sharing/acl': ['POST'],
+  '/api/company-md/docs/{id}/sharing/acl/{aclId}': ['DELETE', 'PUT'],
+  '/api/company-md/docs/{id}/sharing/policy': ['PUT'],
+  '/api/company-md/docs/{id}/title': ['PUT'],
+  '/api/company-md/docs/{id}/transfer-owner': ['POST'],
   '/api/company-md/extract': ['POST'],
   '/api/company-md/ownership/reassign': ['POST'],
   '/api/company-md/ownership/reassign/suggestion': ['GET'],
@@ -115,6 +115,7 @@ export const openApiRoutes = {
   '/api/orgs/{orgId}/budget-config': ['GET', 'PUT'],
   '/api/orgs/{orgId}/level-config': ['GET', 'PUT'],
   '/api/rbac/roles': ['GET'],
+  '/api/reporting/bulk-reparent': ['POST'],
   '/api/scope/check': ['GET'],
   '/api/scope/check-batch': ['POST'],
   '/api/shared/{token}': ['GET'],

package/src/identity/types.ts

@@ -66,12 +66,6 @@ export type UserIdentity = {
    */
   nameSource: NameSource;
 
-  /**
-   * Free-text job title displayed in the people org chart and team views.
-   * Optional; not authoritative for role/RBAC.
-   */
-  jobTitle?: string | null;
-
   /** When the identity was created */
   createdAt: ISODateString;
 

package/src/org/company-md.ts

@@ -80,6 +80,13 @@ export interface CompanyMdSource {
 }
 
 export interface CompanyMdDependency {
+  /**
+   * Stable id of the target doc — the identity used to resolve the reference.
+   * Post-ADR-BE-315 slugs are only parent-scoped unique, so `targetSlug` cannot
+   * identify a doc unambiguously; resolve by `targetId`, display `targetSlug`.
+   */
+  readonly targetId: string;
+  /** Human-readable slug of the target doc — presentation/label only. */
   readonly targetSlug: string;
   readonly description: string;
 }
@@ -137,6 +144,13 @@ export interface CompanyMdDocCollaborators {
 }
 
 export interface CompanyMdDocRelations {
+  /**
+   * Stable id of the doc this one inherits from — the identity used to resolve
+   * the reference (mirrors the resolved `parentId`). Resolve by `inheritsFromId`,
+   * display `inheritsFrom`. See ADR-BE-315: slugs are only parent-scoped unique.
+   */
+  readonly inheritsFromId: string | null;
+  /** Human-readable slug of the inherited-from doc — presentation/label only. */
   readonly inheritsFrom: string | null;
   readonly sources: readonly CompanyMdSource[];
   readonly dependencies: readonly CompanyMdDependency[];

package/src/org/schemas.ts

@@ -66,7 +66,7 @@ const WorkspaceMemberSchema = z.object({
    * display-only enrichment (see ADR-CONTRACTS-055).
    */
   avatarUrl: z.string().nullable().optional(),
-  /** Free-text job title (`users.job_title`). Null when unset. */
+  /** The occupant's Position seat title (org-scoped). Null when the seat is untitled. */
   jobTitle: z.string().nullable(),
   /**
    * Display role — the member's highest org-chart standing, or `null` for a