@company-semantics/contracts 0.33.0 → 0.34.0

package/package.json

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

package/src/index.ts

@@ -112,6 +112,16 @@ export { deriveFullName, resolveDisplayName } from './identity/index'
 // Auth domain types
 export { OTPErrorCode } from './auth/index'
 
+// Organization domain types
+// @see ADR-BE-XXX for design rationale (Personal vs Shared Organization Model)
+export type {
+  OrgType,
+  ExecutionScope,
+  OrganizationInfo,
+  OwnershipTransferRequest,
+  OwnershipTransferStatus,
+} from './org/index'
+
 // MCP tool discovery types
 // @see company-semantics-backend/src/interfaces/mcp/ for implementation
 export type {

package/src/org/README.md

@@ -0,0 +1,25 @@
+# org/
+
+Organization domain vocabulary types for the personal → shared organization model.
+
+## Purpose
+
+Shared type vocabulary for organization ownership, type classification, and transfer workflows.
+
+## Invariants
+
+- `OrgType` and `ExecutionScope` are exhaustive union types (no 'unknown' or catch-all)
+- All types are vocabulary-only (no runtime behavior, no business logic)
+- Structural details (like `ownerUserId`) remain in backend; only public-facing fields here
+
+## Public API
+
+- `OrgType` - 'personal' | 'shared' organization classification
+- `ExecutionScope` - 'self' | 'org' execution identity scope
+- `OrganizationInfo` - Public organization details for API responses
+- `OwnershipTransferRequest` - Transfer initiation payload
+- `OwnershipTransferStatus` - Pending transfer status
+
+## Dependencies
+
+None. This is a leaf vocabulary module.

package/src/org/index.ts

@@ -0,0 +1,14 @@
+/**
+ * Organization Types Barrel
+ *
+ * Re-exports organization vocabulary types.
+ * Import from '@company-semantics/contracts' (root).
+ */
+
+export type {
+  OrgType,
+  ExecutionScope,
+  OrganizationInfo,
+  OwnershipTransferRequest,
+  OwnershipTransferStatus,
+} from './types';

package/src/org/types.ts

@@ -0,0 +1,49 @@
+/**
+ * Organization Types
+ *
+ * Vocabulary types for the personal → shared organization model.
+ * @see ADR-BE-XXX (Personal vs Shared Organization Model)
+ */
+
+/**
+ * Organization type distinguishes personal workspaces from shared organizations.
+ * - 'personal': Single-user workspace, owned by creator, claimable
+ * - 'shared': Multi-user organization, owned by one user, not claimable
+ */
+export type OrgType = 'personal' | 'shared';
+
+/**
+ * Execution scope determines whose identity is used when executing actions.
+ * - 'self': Actions execute under the connecting user's identity only
+ * - 'org': Actions execute on behalf of the organization (shared access)
+ */
+export type ExecutionScope = 'self' | 'org';
+
+/**
+ * Public organization information suitable for API responses.
+ * Does not include sensitive fields like ownerUserId.
+ */
+export interface OrganizationInfo {
+  id: string;
+  name: string;
+  slug: string;
+  type: OrgType;
+  claimable: boolean;
+}
+
+/**
+ * Request payload for initiating ownership transfer.
+ */
+export interface OwnershipTransferRequest {
+  newOwnerEmail: string;
+}
+
+/**
+ * Status of pending ownership transfer for an organization.
+ */
+export interface OwnershipTransferStatus {
+  pending: boolean;
+  newOwnerEmail?: string;
+  requestedAt?: string;
+  expiresAt?: string;
+}