@company-semantics/contracts 1.23.0 → 1.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "1.23.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/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/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;