@company-semantics/contracts 1.22.0 → 1.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "1.22.0",
+  "version": "1.24.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -115,15 +115,15 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
+    "@types/node": "^25.7.0",
     "husky": "^9.1.7",
-    "lint-staged": "^16.4.0",
+    "lint-staged": "^17.0.4",
     "markdownlint-cli2": "^0.22.1",
     "openapi-typescript": "^7.13.0",
     "tsx": "^4.21.0",
     "typescript": "^5",
-    "vitest": "^4.1.5",
-    "yaml": "^2.8.4"
+    "vitest": "^4.1.6",
+    "yaml": "^2.9.0"
   },
   "pnpm": {
     "overrides": {

package/src/api/generated.ts

@@ -1368,6 +1368,40 @@ export interface paths {
         patch: operations["reorderCompanyMdContextBankItem"];
         trace?: never;
     };
+    "/api/company-md/docs/{parentSlug}/context-bank/upload": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Upload a file to the context bank for a parent doc and enqueue extraction */
+        post: operations["uploadCompanyMdContextBankFile"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/company-md/docs/{slug}/context-bank/retry": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Retry extraction for a context-bank doc */
+        post: operations["retryCompanyMdContextBankExtraction"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/company-md/docs/{slug}/sharing": {
         parameters: {
             query?: never;
@@ -2186,7 +2220,7 @@ export interface components {
                 initials: string;
             };
             /** Format: uuid */
-            orgId: string;
+            activeOrgId: string;
             orgName: string | null;
             orgSlug: string;
             plan: string;
@@ -5685,6 +5719,73 @@ export interface operations {
             };
         };
     };
+    uploadCompanyMdContextBankFile: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                parentSlug: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "multipart/form-data": {
+                    [key: string]: unknown;
+                };
+            };
+        };
+        responses: {
+            /** @description Context-bank doc created and extraction enqueued */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Unsupported MIME type */
+            415: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Empty document or scanned PDF */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    retryCompanyMdContextBankExtraction: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Retry enqueued */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Retry limit exceeded or invalid slug */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getCompanyMdDocSharing: {
         parameters: {
             query?: never;

package/src/identity/index.ts

@@ -60,3 +60,17 @@ export type {
   BannerDismissedListResponse,
   BannerDismissResponse,
 } from './schemas';
+
+// People Org Chart (GET /api/users/org-chart)
+export {
+  ReportingRelationshipTypeSchema,
+  PeopleOrgChartNodeSchema,
+  PeopleOrgChartEdgeSchema,
+  PeopleOrgChartResponseSchema,
+} from './people-org-chart';
+export type {
+  ReportingRelationshipType,
+  PeopleOrgChartNode,
+  PeopleOrgChartEdge,
+  PeopleOrgChartResponse,
+} from './people-org-chart';

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

@@ -0,0 +1,58 @@
+/**
+ * People Org Chart Response Schemas
+ *
+ * Zod response schemas for GET /api/users/org-chart — the people-org-chart
+ * view rendered from the settings page Structure → Org chart drill-down.
+ *
+ * Nodes are users (with optional avatar + job title); edges encode
+ * person-to-person reporting lines from the `user_reporting` table.
+ *
+ * Person-level reporting is intentionally distinct from
+ * `org_unit_relationships.type = 'reports_to'` (unit-to-unit graph overlay,
+ * ADR-BE-120). Tree traversal must never consult either.
+ */
+import { z } from 'zod';
+
+// ---------------------------------------------------------------------------
+// Reporting Relationship Type
+// ---------------------------------------------------------------------------
+
+export const ReportingRelationshipTypeSchema = z.enum(['solid', 'dotted']);
+export type ReportingRelationshipType = z.infer<typeof ReportingRelationshipTypeSchema>;
+
+// ---------------------------------------------------------------------------
+// Node — a person in the chart
+// ---------------------------------------------------------------------------
+
+export const PeopleOrgChartNodeSchema = z.object({
+  id: z.string().uuid(),
+  fullName: z.string(),
+  jobTitle: z.string().nullable(),
+  slackAvatarUrl: z.string().nullable(),
+  primaryUnitId: z.string().uuid().nullable(),
+});
+
+export type PeopleOrgChartNode = z.infer<typeof PeopleOrgChartNodeSchema>;
+
+// ---------------------------------------------------------------------------
+// Edge — a reporting line between two people
+// ---------------------------------------------------------------------------
+
+export const PeopleOrgChartEdgeSchema = z.object({
+  reportUserId: z.string().uuid(),
+  managerUserId: z.string().uuid(),
+  relationshipType: ReportingRelationshipTypeSchema,
+});
+
+export type PeopleOrgChartEdge = z.infer<typeof PeopleOrgChartEdgeSchema>;
+
+// ---------------------------------------------------------------------------
+// GET /api/users/org-chart
+// ---------------------------------------------------------------------------
+
+export const PeopleOrgChartResponseSchema = z.object({
+  nodes: z.array(PeopleOrgChartNodeSchema),
+  edges: z.array(PeopleOrgChartEdgeSchema),
+});
+
+export type PeopleOrgChartResponse = z.infer<typeof PeopleOrgChartResponseSchema>;

package/src/identity/schemas.ts

@@ -39,7 +39,9 @@ export const MeResponseSchema = z.object({
   primaryUnitId: z.string().nullable(),
   slackUserId: z.string().nullable(),
   avatar: ResolvedAvatarSchema,
-  orgId: z.string().uuid(),
+  // Single canonical active-org field (PRD-00582 api/me-remove-orgid).
+  // Replaces the deprecated `orgId` alias from the dual-field transition.
+  activeOrgId: z.string().uuid(),
   orgName: z.string().nullable(),
   orgSlug: z.string(),
   plan: z.string(),

package/src/identity/types.ts

@@ -66,6 +66,12 @@ 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;