@company-semantics/contracts 1.2.0 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "1.2.0",
+  "version": "1.4.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/__tests__/org-units.test.ts

@@ -12,6 +12,8 @@ import {
   OrgUnitClassificationSchema,
   OrgUnitRelationshipTypeSchema,
   OrgUnitMembershipSourceSchema,
+  OrgUnitPermissionsEntrySchema,
+  ListOrgUnitPermissionsResponseSchema,
 } from '../schemas.js';
 
 const UUID_A = '11111111-1111-4111-8111-111111111111';
@@ -200,3 +202,49 @@ describe('Enum exhaustiveness', () => {
     }
   });
 });
+
+describe('OrgUnitPermissionsEntrySchema', () => {
+  const entry = {
+    userId: UUID_A,
+    membershipRole: 'manager' as const,
+    inheritedFromUnitId: UUID_C,
+    inheritedFromUnitName: 'Engineering',
+  };
+
+  it('accepts a well-formed entry', () => {
+    expect(() => OrgUnitPermissionsEntrySchema.parse(entry)).not.toThrow();
+  });
+
+  it('rejects invalid membershipRole', () => {
+    expect(() =>
+      OrgUnitPermissionsEntrySchema.parse({ ...entry, membershipRole: 'member' })
+    ).not.toThrow();
+    expect(() =>
+      OrgUnitPermissionsEntrySchema.parse({ ...entry, membershipRole: 'bogus' })
+    ).toThrow();
+  });
+
+  it('requires UUIDs for user and inherited unit', () => {
+    expect(() =>
+      OrgUnitPermissionsEntrySchema.parse({ ...entry, userId: 'nope' })
+    ).toThrow();
+    expect(() =>
+      OrgUnitPermissionsEntrySchema.parse({ ...entry, inheritedFromUnitId: 'nope' })
+    ).toThrow();
+  });
+
+  it('rejects empty inheritedFromUnitName', () => {
+    expect(() =>
+      OrgUnitPermissionsEntrySchema.parse({ ...entry, inheritedFromUnitName: '' })
+    ).toThrow();
+  });
+
+  it('list response wraps entries with unitId', () => {
+    const parsed = ListOrgUnitPermissionsResponseSchema.parse({
+      unitId: UUID_B,
+      entries: [entry],
+    });
+    expect(parsed.entries).toHaveLength(1);
+    expect(parsed.unitId).toBe(UUID_B);
+  });
+});

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,
@@ -230,6 +225,8 @@ export {
   OrgLevelConfigResponseSchema,
   OrgUnitMembershipResponseSchema,
   OrgUnitMembershipListResponseSchema,
+  OrgUnitPermissionsEntrySchema,
+  ListOrgUnitPermissionsResponseSchema,
 } from './schemas';
 export type {
   OrgUnit,
@@ -246,4 +243,6 @@ export type {
   OrgLevelConfigResponse,
   OrgUnitMembershipResponse,
   OrgUnitMembershipListResponse,
+  OrgUnitPermissionsEntry,
+  ListOrgUnitPermissionsResponse,
 } from './schemas';

package/src/org/schemas.ts

@@ -756,6 +756,26 @@ export const OrgUnitMembershipListResponseSchema = z.object({
   memberships: z.array(OrgUnitMembershipSchema),
 });
 
+/**
+ * Effective manager of an org unit — a user whose membership (direct or
+ * inherited from an ancestor) grants the `orgUnit.{id}.manage` capability.
+ *
+ * Direct grants have `inheritedFromUnitId === unitId`. For inherited grants,
+ * `inheritedFromUnitId` identifies the ancestor whose membership propagates
+ * authority down the subtree (ltree `path @>` containment).
+ */
+export const OrgUnitPermissionsEntrySchema = z.object({
+  userId: z.string().uuid(),
+  membershipRole: OrgUnitMembershipRoleSchema,
+  inheritedFromUnitId: z.string().uuid(),
+  inheritedFromUnitName: z.string().min(1),
+});
+
+export const ListOrgUnitPermissionsResponseSchema = z.object({
+  unitId: z.string().uuid(),
+  entries: z.array(OrgUnitPermissionsEntrySchema),
+});
+
 // --- Inferred types ---
 
 export type OrgUnit = z.infer<typeof OrgUnitSchema>;
@@ -772,3 +792,5 @@ export type OrgUnitRelationshipsResponse = z.infer<typeof OrgUnitRelationshipsRe
 export type OrgLevelConfigResponse = z.infer<typeof OrgLevelConfigResponseSchema>;
 export type OrgUnitMembershipResponse = z.infer<typeof OrgUnitMembershipResponseSchema>;
 export type OrgUnitMembershipListResponse = z.infer<typeof OrgUnitMembershipListResponseSchema>;
+export type OrgUnitPermissionsEntry = z.infer<typeof OrgUnitPermissionsEntrySchema>;
+export type ListOrgUnitPermissionsResponse = z.infer<typeof ListOrgUnitPermissionsResponseSchema>;