@company-semantics/contracts 0.65.0 → 0.67.0

package/package.json

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

package/src/index.ts

@@ -228,9 +228,26 @@ export type {
   TransferStatusResponse,
   TransferAcceptanceView,
   TransferResponsibility,
+  // Identity Trust Level types (PRD-00154)
+  IdentityTrustLevel,
+  TransferEligibilityResult,
+  TransferMemberEligibility,
+  // Management Tier types (PRD-00155)
+  ManagementTier,
+  PromotionStatus,
+  PromotionRequest,
+  PromotionRecord,
+  PromotionReadinessResult,
+  // Strategy domain types (PRD-00173)
+  StrategyVisibility,
+  StrategyDocLevel,
+  StrategySource,
+  StrategyDependency,
+  StrategyTreeNode,
+  StrategyDoc,
 } from './org/index'
 
-export { ROLE_DISPLAY_MAP, WORKSPACE_CAPABILITIES, ROLE_CAPABILITY_MAP, VIEW_SCOPE_MAP, getViewScope, TRANSFER_RESPONSIBILITIES } 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

@@ -43,9 +43,19 @@ export type {
   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, TRANSFER_RESPONSIBILITIES } 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';
@@ -62,3 +72,13 @@ export type {
 // View authorization scopes (Phase 5 - ADR-APP-013)
 export type { AuthorizableView } from './view-scopes';
 export { VIEW_SCOPE_MAP, getViewScope } from './view-scopes';
+
+// Strategy domain types (PRD-00173)
+export type {
+  StrategyVisibility,
+  StrategyDocLevel,
+  StrategySource,
+  StrategyDependency,
+  StrategyTreeNode,
+  StrategyDoc,
+} from './strategy';

package/src/org/strategy.ts

@@ -0,0 +1,53 @@
+/**
+ * Strategy Domain Types
+ *
+ * Vocabulary types for the Company.md strategy feature.
+ * Shared between backend (persistence/service) and app (UI rendering).
+ * @see PRD-00173 for design rationale
+ */
+
+export type StrategyVisibility = 'public' | 'private';
+
+export type StrategyDocLevel = 'root' | 'department';
+
+export interface StrategySource {
+  readonly label: string;
+  readonly sourceType: 'meeting' | 'document' | 'conversation' | 'manual';
+  readonly referencedAt: string;
+}
+
+export interface StrategyDependency {
+  readonly targetSlug: string;
+  readonly description: string;
+}
+
+export interface StrategyTreeNode {
+  readonly id: string;
+  readonly slug: string;
+  readonly title: string;
+  readonly level: StrategyDocLevel;
+  readonly department: string | null;
+  readonly visibility: StrategyVisibility;
+  readonly canEdit: boolean;
+  readonly memberCount: number;
+}
+
+export interface StrategyDoc {
+  readonly id: string;
+  readonly slug: string;
+  readonly title: string;
+  readonly level: StrategyDocLevel;
+  readonly department: string | null;
+  readonly content: string;
+  readonly visibility: StrategyVisibility;
+  readonly parentId: string | null;
+  readonly owner: { readonly id: string; readonly name: string } | null;
+  readonly coOwners: ReadonlyArray<{ readonly id: string; readonly name: string }>;
+  readonly canEdit: boolean;
+  readonly inheritsFrom: string | null;
+  readonly sources: readonly StrategySource[];
+  readonly dependencies: readonly StrategyDependency[];
+  readonly members: ReadonlyArray<{ readonly id: string; readonly name: string }>;
+  readonly createdAt: string;
+  readonly updatedAt: string;
+}

package/src/org/types.ts

@@ -428,6 +428,93 @@ export const TRANSFER_RESPONSIBILITIES = [
 
 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.
  */