@company-semantics/contracts 0.64.0 → 0.66.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.64.0",
+  "version": "0.66.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/index.ts

@@ -223,9 +223,24 @@ export type {
   WorkspaceSettingsOverview,
   IntegrationRequestStatus,
   IntegrationRequest,
+  // Ownership transfer DTOs (PRD-00153)
+  TransferInitiateRequest,
+  TransferStatusResponse,
+  TransferAcceptanceView,
+  TransferResponsibility,
+  // Identity Trust Level types (PRD-00154)
+  IdentityTrustLevel,
+  TransferEligibilityResult,
+  TransferMemberEligibility,
+  // Management Tier types (PRD-00155)
+  ManagementTier,
+  PromotionStatus,
+  PromotionRequest,
+  PromotionRecord,
+  PromotionReadinessResult,
 } from './org/index'
 
-export { ROLE_DISPLAY_MAP, WORKSPACE_CAPABILITIES, ROLE_CAPABILITY_MAP, VIEW_SCOPE_MAP, getViewScope } from './org/index'
+export { ROLE_DISPLAY_MAP, WORKSPACE_CAPABILITIES, ROLE_CAPABILITY_MAP, VIEW_SCOPE_MAP, getViewScope, TRANSFER_RESPONSIBILITIES, IDENTITY_TRUST_LEVEL_LABELS, MANAGEMENT_TIER_LABELS } from './org/index'
 
 // View authorization types (Phase 5 - ADR-APP-013)
 export type { AuthorizableView } from './org/index'

package/src/org/index.ts

@@ -38,9 +38,24 @@ export type {
   WorkspaceSettingsOverview,
   IntegrationRequestStatus,
   IntegrationRequest,
+  // Ownership transfer DTOs (PRD-00153)
+  TransferInitiateRequest,
+  TransferStatusResponse,
+  TransferAcceptanceView,
+  TransferResponsibility,
+  // Identity Trust Level types (PRD-00154)
+  IdentityTrustLevel,
+  TransferEligibilityResult,
+  TransferMemberEligibility,
+  // Management Tier types (PRD-00155)
+  ManagementTier,
+  PromotionStatus,
+  PromotionRequest,
+  PromotionRecord,
+  PromotionReadinessResult,
 } from './types';
 
-export { ROLE_DISPLAY_MAP } from './types';
+export { ROLE_DISPLAY_MAP, TRANSFER_RESPONSIBILITIES, IDENTITY_TRUST_LEVEL_LABELS, MANAGEMENT_TIER_LABELS } from './types';
 
 // Workspace capability types (Phase 3)
 export type { WorkspaceCapability } from './capabilities';

package/src/org/types.ts

@@ -386,6 +386,135 @@ export interface WorkspaceSettingsOverview extends WorkspaceInfoOverview {
   };
 }
 
+// =============================================================================
+// Ownership Transfer DTOs (PRD-00153)
+// Rich types for the transfer UI flows, supplementing OwnershipTransferRequest
+// and OwnershipTransferStatus above.
+// =============================================================================
+
+/** Request body for initiating ownership transfer (extends existing to include optional note). */
+export interface TransferInitiateRequest {
+  readonly newOwnerEmail: string;
+  readonly note?: string;
+}
+
+/** Response for transfer status queries — extends existing OwnershipTransferStatus. */
+export interface TransferStatusResponse {
+  readonly pending: boolean;
+  readonly newOwnerEmail?: string;
+  readonly note?: string;
+  readonly requestedAt?: string;
+  readonly expiresAt?: string;
+  readonly initiatorName?: string;
+}
+
+/** Read-only view for the transfer acceptance page. */
+export interface TransferAcceptanceView {
+  readonly workspaceName: string;
+  readonly initiatorName: string;
+  readonly initiatorEmail: string;
+  readonly note?: string;
+  readonly expiresAt: string;
+  readonly token: string;
+}
+
+/** Responsibility checklist items shown on the acceptance page. */
+export const TRANSFER_RESPONSIBILITIES = [
+  'You will become the sole owner of this workspace',
+  'You will be responsible for billing and compliance',
+  'The current owner will be downgraded to admin',
+  'This action cannot be undone without a new transfer',
+] as const;
+
+export type TransferResponsibility = (typeof TRANSFER_RESPONSIBILITIES)[number];
+
+// =============================================================================
+// Identity Trust Level Types (PRD-00154)
+// Org identity posture for ownership transfer constraints.
+// =============================================================================
+
+/** Identity Trust Level — org's identity posture */
+export type IdentityTrustLevel = 'ITL_0' | 'ITL_1' | 'ITL_2';
+
+export const IDENTITY_TRUST_LEVEL_LABELS: Record<IdentityTrustLevel, string> = {
+  ITL_0: 'No verified domains',
+  ITL_1: 'Domain verified',
+  ITL_2: 'SSO enforced',
+} as const;
+
+/** Transfer eligibility result with ITL context */
+export interface TransferEligibilityResult {
+  readonly eligible: boolean;
+  readonly itl: IdentityTrustLevel;
+  readonly reason?: string;
+  readonly domainRequired?: boolean;
+  readonly ssoRequired?: boolean;
+  readonly lockoutRisk?: boolean;
+}
+
+/** Per-member eligibility for transfer recipient picker */
+export interface TransferMemberEligibility {
+  readonly userId: string;
+  readonly email: string;
+  readonly fullName?: string;
+  readonly eligible: boolean;
+  readonly reason?: string;
+  readonly ssoLinked: boolean;
+  readonly domainMatch: boolean;
+}
+
+// =============================================================================
+// Management Tier Types (PRD-00155)
+// Workspace governance level and promotion ceremony vocabulary.
+// =============================================================================
+
+/** Workspace governance level */
+export type ManagementTier = 'grassroots' | 'company_managed';
+
+export const MANAGEMENT_TIER_LABELS: Record<ManagementTier, { label: string; description: string }> = {
+  grassroots: {
+    label: 'Community workspace',
+    description: 'Community-originated workspace with no special governance constraints.',
+  },
+  company_managed: {
+    label: 'Company-managed workspace',
+    description: 'Domain verified, SSO enforced, ownership formally established.',
+  },
+} as const;
+
+/** Wizard progress tracking */
+export type PromotionStatus = 'not_started' | 'in_progress' | 'completed';
+
+/** Promotion ceremony state */
+export interface PromotionRequest {
+  readonly orgId: string;
+  readonly promotedBy: string;
+  readonly ownershipConfirmed: boolean;
+  readonly domainVerified: boolean;
+  readonly ssoConfigured: boolean;
+  readonly responsibilityAcknowledged: boolean;
+}
+
+/** Audit record for completed promotion */
+export interface PromotionRecord {
+  readonly orgId: string;
+  readonly promotedAt: string;
+  readonly promotedBy: string;
+  readonly previousTier: ManagementTier;
+  readonly newTier: ManagementTier;
+}
+
+/** Readiness check output */
+export interface PromotionReadinessResult {
+  readonly ready: boolean;
+  readonly checks: ReadonlyArray<{
+    readonly id: string;
+    readonly label: string;
+    readonly passed: boolean;
+    readonly reason?: string;
+  }>;
+}
+
 /**
  * Status of an integration request from a member.
  */