@company-semantics/contracts 1.1.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "1.1.0",
+  "version": "1.3.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 = '0e90960db25d' as const;
-export const SPEC_HASH_FULL = '0e90960db25d88b3945b8fa9533362f10776b9d1d59ead1291806198b1f3c703' as const;
+export const SPEC_HASH = '2378a6034349' as const;
+export const SPEC_HASH_FULL = '2378a6034349f4280d4f9aa3536002db130f8a1c03911b6f2513e14e036d85c4' as const;

package/src/api/generated.ts

@@ -1330,40 +1330,6 @@ export interface paths {
         patch: operations["reorderCompanyMdContextBankItem"];
         trace?: never;
     };
-    "/api/company-md/settings": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** Get company.md settings for the org */
-        get: operations["getCompanyMdSettings"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/company-md/settings/level-labels": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        /** Update company.md level labels */
-        put: operations["updateCompanyMdLevelLabels"];
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/company-md/docs/{slug}/sharing": {
         parameters: {
             query?: never;
@@ -2869,18 +2835,6 @@ export interface components {
         AssociateContextDocRequest: {
             contextDocSlug: string;
         };
-        CompanyMdSettingsResponse: {
-            levelLabels: {
-                root: string;
-                department: string;
-                team: string;
-            };
-        };
-        UpdateCompanyMdLevelLabelsRequest: {
-            root?: string;
-            department?: string;
-            team?: string;
-        };
         CompanyMdShareResponse: {
             /** @enum {string} */
             sharingPolicy: "restricted" | "org_read" | "org_comment" | "org_edit";
@@ -5341,50 +5295,6 @@ export interface operations {
             };
         };
     };
-    getCompanyMdSettings: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Company.md settings */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["CompanyMdSettingsResponse"];
-                };
-            };
-        };
-    };
-    updateCompanyMdLevelLabels: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["UpdateCompanyMdLevelLabelsRequest"];
-            };
-        };
-        responses: {
-            /** @description Updated settings */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["CompanyMdSettingsResponse"];
-                };
-            };
-        };
-    };
     getCompanyMdDocSharing: {
         parameters: {
             query?: never;

package/src/content/index.ts

@@ -11,14 +11,12 @@ export {
   CompanyMdDocResponseSchema,
   CompanyMdShareResponseSchema,
   CompanyMdContextBankResponseSchema,
-  CompanyMdSettingsResponseSchema,
 } from './schemas';
 export type {
   CompanyMdListResponse,
   CompanyMdDocResponse,
   CompanyMdShareResponse,
   CompanyMdContextBankResponse,
-  CompanyMdSettingsResponse,
 } from './schemas';
 
 // Drive response schemas (PRD-00448)

package/src/content/schemas.ts

@@ -125,17 +125,6 @@ export const CompanyMdContextBankResponseSchema = z.object({
   items: z.array(CompanyMdContextBankItemSchema),
 });
 
-const CompanyMdLevelLabelsSchema = z.object({
-  root: z.string(),
-  department: z.string(),
-  team: z.string(),
-});
-
-/** Response for GET /api/company-md/settings */
-export const CompanyMdSettingsResponseSchema = z.object({
-  levelLabels: CompanyMdLevelLabelsSchema,
-});
-
 // ---------------------------------------------------------------------------
 // Drive Sub-schemas
 // ---------------------------------------------------------------------------
@@ -182,6 +171,5 @@ export type CompanyMdListResponse = z.infer<typeof CompanyMdListResponseSchema>;
 export type CompanyMdDocResponse = z.infer<typeof CompanyMdDocResponseSchema>;
 export type CompanyMdShareResponse = z.infer<typeof CompanyMdShareResponseSchema>;
 export type CompanyMdContextBankResponse = z.infer<typeof CompanyMdContextBankResponseSchema>;
-export type CompanyMdSettingsResponse = z.infer<typeof CompanyMdSettingsResponseSchema>;
 export type DriveFileListResponse = z.infer<typeof DriveFileListResponseSchema>;
 export type DriveFileContentResponse = z.infer<typeof DriveFileContentResponseSchema>;

package/src/org/company-md.ts

@@ -68,25 +68,6 @@ export interface CompanyMdDocRelations {
 
 export type CompanyMdDoc = CompanyMdDocCore & CompanyMdDocCollaborators & CompanyMdDocRelations;
 
-export interface CompanyMdLevelLabels {
-  /** L1 label — defaults to org name */
-  readonly root: string;
-  /** L2 label — defaults to 'Department' */
-  readonly department: string;
-  /** L3 label — defaults to 'Team' */
-  readonly team: string;
-}
-
-export interface CompanyMdSettings {
-  readonly levelLabels: CompanyMdLevelLabels;
-}
-
-/** System defaults for level labels. L1 (root) is set per-org at read time. */
-export const DEFAULT_LEVEL_LABELS: Omit<CompanyMdLevelLabels, 'root'> = {
-  department: 'Department',
-  team: 'Team',
-} as const;
-
 /**
  * A context bank item — a company.md doc associated with one or more parent nodes.
  * Context bank files can belong to company, department, or team levels.

package/src/org/index.ts

@@ -94,13 +94,8 @@ export type {
   CompanyMdDocRelations,
   CompanyMdDoc,
   CompanyMdContextBankItem,
-  // Level labels settings types (PRD-00453)
-  CompanyMdLevelLabels,
-  CompanyMdSettings,
 } from './company-md';
 
-export { DEFAULT_LEVEL_LABELS } from './company-md';
-
 // Sharing and ACL types (PRD-00306)
 export type {
   AccessLevel,

package/src/resource-keys.ts

@@ -28,6 +28,13 @@ export type ResourceKey =
   | { type: 'deletionEligibility'; orgId: string }
   | { type: 'transferOwnership'; orgId: string }
   | { type: 'companyMdDocs'; orgId: string }
+  // OrgUnit canonical model (ADR-BE-120) — Phase 2 Wave 4
+  | { type: 'orgTree'; orgId: string }
+  | { type: 'orgLevelConfig'; orgId: string }
+  | { type: 'orgUnit'; orgId: string; unitId: string }
+  | { type: 'orgUnitChildren'; orgId: string; unitId: string }
+  | { type: 'orgUnitAncestors'; orgId: string; unitId: string }
+  | { type: 'orgUnitMemberships'; orgId: string; unitId: string }
   // User-scoped
   | { type: 'dismissedBanners'; userId: string }
   | { type: 'userOrgs'; userId: string }
@@ -54,6 +61,7 @@ const ORG_SCOPED_TYPES = [
   'members', 'departments', 'chats', 'teams', 'integrations', 'invites',
   'auditEvents', 'timeline', 'workspace', 'workspaceDomains', 'authSettings',
   'billing', 'aiUsage', 'deletionEligibility', 'transferOwnership', 'companyMdDocs',
+  'orgTree', 'orgLevelConfig',
 ] as const;
 
 const USER_SCOPED_TYPES = ['dismissedBanners', 'userOrgs', 'sessions', 'viewer'] as const;
@@ -82,6 +90,13 @@ export function toQueryKey(key: ResourceKey): readonly string[] {
     case 'companyMdContextBank':
       return [key.type, key.orgId, key.slug] as const;
 
+    // OrgUnit identity keys (ADR-BE-120)
+    case 'orgUnit':
+    case 'orgUnitChildren':
+    case 'orgUnitAncestors':
+    case 'orgUnitMemberships':
+      return [key.type, key.orgId, key.unitId] as const;
+
     // User-scoped
     case 'dismissedBanners':
     case 'userOrgs':
@@ -106,6 +121,8 @@ export function toQueryKey(key: ResourceKey): readonly string[] {
     case 'deletionEligibility':
     case 'transferOwnership':
     case 'companyMdDocs':
+    case 'orgTree':
+    case 'orgLevelConfig':
       return [key.type, key.orgId] as const;
 
     default: {
@@ -134,6 +151,10 @@ export function fromQueryKey(queryKey: readonly string[]): ResourceKey {
     chat: 'chatId',
     companyMdDoc: 'slug',
     companyMdContextBank: 'slug',
+    orgUnit: 'unitId',
+    orgUnitChildren: 'unitId',
+    orgUnitAncestors: 'unitId',
+    orgUnitMemberships: 'unitId',
   };
 
   if (type in identityFields) {
@@ -172,6 +193,13 @@ export const resourceRelationships: Record<string, string[]> = {
   team: ['teams'],
   companyMdDocs: ['companyMdDoc'],
   companyMdDoc: ['companyMdDocs'],
+  // OrgUnit: reparent/create/archive invalidates the tree view of the whole org;
+  // membership mutations invalidate the unit + its memberships list.
+  orgTree: ['orgUnit', 'orgUnitChildren', 'orgUnitAncestors'],
+  orgUnit: ['orgTree'],
+  orgUnitChildren: ['orgTree'],
+  orgUnitAncestors: ['orgTree'],
+  orgUnitMemberships: ['orgUnit'],
 };
 
 /**
@@ -200,6 +228,7 @@ export function matchesResourceKey(queryKey: readonly unknown[], targetKey: Reso
   if ('departmentId' in parsed && 'departmentId' in targetKey && parsed.departmentId !== targetKey.departmentId) return false;
   if ('chatId' in parsed && 'chatId' in targetKey && parsed.chatId !== targetKey.chatId) return false;
   if ('slug' in parsed && 'slug' in targetKey && parsed.slug !== targetKey.slug) return false;
+  if ('unitId' in parsed && 'unitId' in targetKey && parsed.unitId !== targetKey.unitId) return false;
 
   return true;
 }