@company-semantics/contracts 16.0.0 → 17.0.0

package/src/identity/README.md

@@ -16,21 +16,72 @@ TypeScript types and functions for user identity and display name resolution.
 - `resolveDisplayName()` is the ONLY approved way to determine assistant addressing
 - Display name fallback: `preferredName ?? extractFirstWord(fullName)`
 
-## Public API
+<!-- BEGIN GENERATED: readme-public-api — derived from code by `pnpm readme-api`. Do not edit. -->
 
-### Types
+## Public API
 
-- `ISODateString` — ISO 8601 date-time string alias
-- `NameSource` — `'self' | 'sso'` indicating name data source
-- `UserIdentity` — User identity with name fields, source, and timestamps
+- `AccountCancelDeletionResponse` _(type)_
+- `AccountCancelDeletionResponseSchema`
+- `AccountConfirmDeletionResponse` _(type)_
+- `AccountConfirmDeletionResponseSchema`
+- `AccountDeleteResponse` _(type)_
+- `AccountDeleteResponseSchema`
+- `AccountDeletionEligibility` _(type)_
+- `AccountDeletionEligibilityResponse` _(type)_
+- `AccountDeletionEligibilityResponseSchema`
+- `AccountSessionList` _(type)_
+- `AccountSessionListSchema`
+- `AccountSessionRevokeResponse` _(type)_
+- `AccountSessionRevokeResponseSchema`
+- `AuthStartResponse` _(type)_
+- `AuthStartResponseSchema`
+- `AuthVerifyResponse` _(type)_
+- `AuthVerifyResponseSchema`
+- `AvatarSource` _(type)_
+- `BannerDismissResponse` _(type)_
+- `BannerDismissResponseSchema`
+- `BannerDismissedListResponse` _(type)_
+- `BannerDismissedListResponseSchema`
+- `DeletionBlocker` _(type)_
+- `ISODateString` _(type)_
+- `MeResponse` _(type)_
+- `MeResponseSchema`
+- `NameSource` _(type)_
+- `PeopleOrgChartEdge` _(type)_
+- `PeopleOrgChartEdgeSchema`
+- `PeopleOrgChartNode` _(type)_
+- `PeopleOrgChartNodeSchema`
+- `PeopleOrgChartOpenRole` _(type)_
+- `PeopleOrgChartOpenRoleSchema`
+- `PeopleOrgChartResponse` _(type)_
+- `PeopleOrgChartResponseSchema`
+- `ProfileResponse` _(type)_
+- `ProfileResponseSchema`
+- `ReportingRelationshipType` _(type)_
+- `ReportingRelationshipTypeSchema`
+- `ResolvedAvatar` _(type)_
+- `SsoConfigResponse` _(type)_
+- `SsoConfigResponseSchema`
+- `UserIdentity` _(type)_
+- `UserLifecycleStatus` _(type)_
+- `deriveFullName`
+- `extractFirstWord`
+- `generateInitials`
+- `resolveAvatar`
+- `resolveDisplayName`
 
-### Functions
+<!-- END GENERATED: readme-public-api -->
 
-- `extractFirstWord(fullName)` — Extract first word from full name
-- `resolveDisplayName(identity)` — Get display name (preferredName or first word of fullName)
-- `deriveFullName(firstName, lastName?)` — **[DEPRECATED]** Kept for migration only
+<!-- BEGIN GENERATED: readme-dependencies — derived from code by `pnpm readme-api`. Do not edit. -->
 
 ## Dependencies
 
-**Imports from:** (none — leaf module)
-**Imported by:** company-semantics-backend, company-semantics-app
+**Internal domains:**
+
+_None._
+
+**External packages:**
+
+- `zod`
+
+<!-- END GENERATED: readme-dependencies -->

package/src/ingestion/README.md

@@ -20,16 +20,30 @@ attribute and supported-formats copy from the same data.
 - No normalizer-routing fields here (`canonicalKind`, `normalizerKey` are
   backend-only). This package stays pure vocabulary.
 
+<!-- BEGIN GENERATED: readme-public-api — derived from code by `pnpm readme-api`. Do not edit. -->
+
 ## Public API
 
-- `IngestionFormat` — `{ mime, extensions, label, maxBytes }`.
-- `INGESTION_FORMATS: readonly IngestionFormat[]`.
-- `byMime(mime)`, `acceptExtensions()`, `humanLabels()`.
-- `INGEST_ACCEPT: string` — comma-joined extensions for an `accept` attribute.
-- `SUPPORTED_LABEL: string` — human-readable supported-formats summary.
+- `INGESTION_FORMATS`
+- `INGEST_ACCEPT`
+- `IngestionFormat` _(type)_
+- `SUPPORTED_LABEL`
+- `acceptExtensions`
+- `byMime`
+- `humanLabels`
+
+<!-- END GENERATED: readme-public-api -->
+
+<!-- BEGIN GENERATED: readme-dependencies — derived from code by `pnpm readme-api`. Do not edit. -->
 
 ## Dependencies
 
-None beyond `./types`. (The backend registry at
-`company-semantics-backend/src/orgs/ingestion/normalize/format-registry.ts`
-consumes this and adds its private dispatch fields.)
+**Internal domains:**
+
+_None._
+
+**External packages:**
+
+_None._
+
+<!-- END GENERATED: readme-dependencies -->

package/src/mcp/README.md

@@ -15,24 +15,43 @@ Type vocabulary for MCP (Model Context Protocol) tool discovery, invocation meta
 - At most one FailureContext is active at a time (no stacking)
 - Capability graph is a pure derivation from produces/consumes metadata
 
+<!-- BEGIN GENERATED: readme-public-api — derived from code by `pnpm readme-api`. Do not edit. -->
+
 ## Public API
 
-**Types:**
+- `CapabilityGraph` _(type)_
+- `CapabilityGraphEdge` _(type)_
+- `FailureContext` _(type)_
+- `MCPToolDescriptor` _(type)_
+- `RecoveryAction` _(type)_
+- `ResourceType` _(type)_
+- `ToolCategory` _(type)_
+- `ToolComplexity` _(type)_
+- `ToolDiscoveryResponse` _(type)_
+- `ToolDomain` _(type)_
+- `ToolEffectClass` _(type)_
+- `ToolIntegration` _(type)_
+- `ToolIntent` _(type)_
+- `ToolInvocationMode` _(type)_
+- `ToolListDataPart` _(type)_
+- `ToolListMessagePart` _(type)_
+- `ToolStability` _(type)_
+- `ToolVisibility` _(type)_
+- `ToolWorkflow` _(type)_
+- `buildCapabilityGraph`
+
+<!-- END GENERATED: readme-public-api -->
+
+<!-- BEGIN GENERATED: readme-dependencies — derived from code by `pnpm readme-api`. Do not edit. -->
+
+## Dependencies
 
-- `MCPToolDescriptor` — complete tool descriptor for discovery and invocation
-- `ToolDomain`, `ToolCategory` (deprecated), `ToolVisibility`, `ToolInvocationMode` — classification enums
-- `ToolEffectClass`, `ToolIntent`, `ToolStability`, `ToolComplexity` — tool metadata types
-- `ToolIntegration` — extensible integration provider tag
-- `ResourceType` — closed union of tool resource flow types
-- `CapabilityGraph`, `CapabilityGraphEdge`, `ToolWorkflow` — graph types
-- `ToolDiscoveryResponse` — HTTP transport for GET /api/capabilities/tools
-- `ToolListMessagePart`, `ToolListDataPart` — chat protocol and wire format parts
-- `FailureContext`, `RecoveryAction` — structured failure recovery types
+**Internal domains:**
 
-**Runtime values:**
+_None._
 
-- `buildCapabilityGraph(tools)` — pure function deriving graph from produces/consumes metadata
+**External packages:**
 
-## Dependencies
+_None._
 
-- None (leaf domain in contracts; consumed by backend, app)
+<!-- END GENERATED: readme-dependencies -->

package/src/message-parts/README.md

@@ -15,27 +15,87 @@ Canonical vocabulary for structured assistant message output. Defines the type s
 - Execution results carry `state` resolved from ExecutionState (single authority, no redundant status)
 - Undo creates append-only audit rows — original execution is never mutated
 
-## Public API
+<!-- BEGIN GENERATED: readme-public-api — derived from code by `pnpm readme-api`. Do not edit. -->
 
-**Types:**
+## Public API
 
-- `TextPart`, `SurfacePart`, `AssistantMessagePart` — core part unions
-- `ToolListPart`, `StatusPanelPart`, `ChartPart`, `TablePart` — surface part variants
-- `PreviewData`, `PreviewArtifact`, `PreviewPart` — action preview surfaces
-- `ConfirmationData`, `ConfirmationRiskLevel`, `ConfirmationPart` — confirmation surfaces
-- `ExecutionResultData`, `ExecutionArtifactStatus`, `UndoResultData` — execution results
-- `StreamPhase`, `MessageLifecycleEvent` — message lifecycle events
-- `IntegrationKey`, `IntegrationProvider` — integration identifiers
+- `AddPartResult` _(type)_
+- `AssistantMessagePart` _(type)_
+- `CONFIRMATION_LABELS`
+- `CandidateSource` _(type)_
+- `ChartDataPoint` _(type)_
+- `ChartPart` _(type)_
+- `ConfirmationChoice` _(type)_
+- `ConfirmationData` _(type)_
+- `ConfirmationDataPart` _(type)_
+- `ConfirmationPart` _(type)_
+- `ConfirmationResponseData` _(type)_
+- `ConfirmationRiskLevel` _(type)_
+- `ExecutionArtifactStatus` _(type)_
+- `ExecutionResultData` _(type)_
+- `ExecutionResultDataPart` _(type)_
+- `ExecutionResultPart` _(type)_
+- `ExecutionResultSummary` _(type)_
+- `ExecutionUndoCapability` _(type)_
+- `IntegrationArtifactContent` _(type)_
+- `IntegrationKey` _(type)_
+- `IntegrationProvider` _(type)_
+- `InteractiveFieldDescriptor` _(type)_
+- `InteractiveFieldType` _(type)_
+- `InteractiveTaskData` _(type)_
+- `InteractiveTaskDataPart` _(type)_
+- `InteractiveTaskKind` _(type)_
+- `InteractiveTaskPart` _(type)_
+- `InteractiveTaskSubject` _(type)_
+- `MessageCompleteDataPart` _(type)_
+- `MessageCompleteEvent` _(type)_
+- `MessageDeltaDataPart` _(type)_
+- `MessageDeltaEvent` _(type)_
+- `MessageLifecycleEvent` _(type)_
+- `MessageLifecycleEventType` _(type)_
+- `MessageStartDataPart` _(type)_
+- `MessageStartEvent` _(type)_
+- `PartBuilderState` _(type)_
+- `PreviewArtifact` _(type)_
+- `PreviewArtifactKind` _(type)_
+- `PreviewData` _(type)_
+- `PreviewDataPart` _(type)_
+- `PreviewPart` _(type)_
+- `StatusPanelEntry` _(type)_
+- `StatusPanelPart` _(type)_
+- `StreamPhase` _(type)_
+- `SurfacePart` _(type)_
+- `TablePart` _(type)_
+- `TextPart` _(type)_
+- `ToolListPart` _(type)_
+- `ToolResultPart` _(type)_
+- `ToolResultRenderClass` _(type)_
+- `UndoResultData` _(type)_
+- `UndoResultDataPart` _(type)_
+- `WireSurfaceBuilder`
+- `addPart`
+- `addSurface`
+- `addText`
+- `buildParts`
+- `createPartBuilder`
+- `getConfirmationLabel`
+- `getDroppedCount`
+- `isSurfacePart`
+- `isTextPart`
 
-**Runtime values:**
+<!-- END GENERATED: readme-public-api -->
 
-- `CONFIRMATION_LABELS` — exhaustive map of ExecutionKind to human-readable labels
-- `getConfirmationLabel(kind, fallback)` — label lookup with fallback
-- `WireSurfaceBuilder` — factory for creating wire-format data parts
-- `createPartBuilder()`, `addText()`, `addSurface()`, `buildParts()` — functional part builder
-- `isTextPart()`, `isSurfacePart()` — type guards
+<!-- BEGIN GENERATED: readme-dependencies — derived from code by `pnpm readme-api`. Do not edit. -->
 
 ## Dependencies
 
-- `../execution/kinds` — ExecutionKind type for confirmation labels
-- `../mcp/index` — MCPToolDescriptor for tool list parts
+**Internal domains:**
+
+- `execution`
+- `mcp`
+
+**External packages:**
+
+_None._
+
+<!-- END GENERATED: readme-dependencies -->

package/src/org/README.md

@@ -12,14 +12,300 @@ Shared type vocabulary for organization ownership, type classification, and tran
 - All types are vocabulary-only (no runtime behavior, no business logic)
 - Structural details (like `ownerUserId`) remain in backend; only public-facing fields here
 
+<!-- BEGIN GENERATED: readme-public-api — derived from code by `pnpm readme-api`. Do not edit. -->
+
 ## 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
+- `AcceptInviteRequest` _(type)_
+- `AccessExplanation` _(type)_
+- `AccessLevel` _(type)_
+- `AccessReason` _(type)_
+- `AccessSource` _(type)_
+- `AcknowledgeSystemEventResponse` _(type)_
+- `AcknowledgeSystemEventResponseSchema`
+- `AclEntry` _(type)_
+- `ActionCapability` _(type)_
+- `ActionCapabilitySchema`
+- `AuthMethodConfig` _(type)_
+- `AuthorityConfidence` _(type)_
+- `AuthorityConfidenceSchema`
+- `AuthorityLocality` _(type)_
+- `AuthorityLocalitySchema`
+- `AuthorityMechanism` _(type)_
+- `AuthorityMechanismSchema`
+- `AuthorityMutability` _(type)_
+- `AuthorityMutabilitySchema`
+- `AuthorityOrigin` _(type)_
+- `AuthorityOriginSchema`
+- `AuthoritySource` _(type)_
+- `AuthoritySourceSchema`
+- `AuthorizableView` _(type)_
+- `CapabilitiesResponse` _(type)_
+- `CapabilitiesResponseSchema`
+- `ChangeMemberRoleRequest` _(type)_
+- `ChangeMemberRoleResponse` _(type)_
+- `ChangeMemberRoleResponseSchema`
+- `CompanyMdContextBankItem` _(type)_
+- `CompanyMdDependency` _(type)_
+- `CompanyMdDoc` _(type)_
+- `CompanyMdDocCollaborators` _(type)_
+- `CompanyMdDocCore` _(type)_
+- `CompanyMdDocKind` _(type)_
+- `CompanyMdDocLevel` _(type)_
+- `CompanyMdDocRelations` _(type)_
+- `CompanyMdNodeIdentity` _(type)_
+- `CompanyMdNodeType` _(type)_
+- `CompanyMdSource` _(type)_
+- `CompanyMdTreeNode` _(type)_
+- `CompanyMdVisibility` _(type)_
+- `CreateDelegationRequest` _(type)_
+- `CreateDelegationRequestSchema`
+- `CreateInviteRequest` _(type)_
+- `CreateOpenRoleRequest` _(type)_
+- `CreateOpenRoleRequestSchema`
+- `Delegation` _(type)_
+- `DelegationListResponse` _(type)_
+- `DelegationListResponseSchema`
+- `DelegationSchema`
+- `DomainListResponse` _(type)_
+- `DomainListResponseSchema`
+- `DomainResponse` _(type)_
+- `DomainResponseSchema`
+- `DomainStatus` _(type)_
+- `DomainVerificationMethod` _(type)_
+- `EffectiveAccess` _(type)_
+- `EvaluationStep` _(type)_
+- `ExecutionScope` _(type)_
+- `FACT_SOURCE_TIER_PRECEDENCE`
+- `FactProvenance` _(type)_
+- `FactProvenanceSchema`
+- `FactSourceTier` _(type)_
+- `FactSourceTierSchema`
+- `FieldCapability` _(type)_
+- `FieldCapabilitySchema`
+- `FillOpenRoleRequest` _(type)_
+- `FillOpenRoleRequestSchema`
+- `HomeAssignment` _(type)_
+- `HomeAssignmentSchema`
+- `HomeUnitRole` _(type)_
+- `HomeUnitRoleSchema`
+- `IDENTITY_TRUST_LEVEL_LABELS`
+- `IdentityTrustLevel` _(type)_
+- `IntegrationRequest` _(type)_
+- `IntegrationRequestStatus` _(type)_
+- `InviteListResponse` _(type)_
+- `InviteListResponseSchema`
+- `InviteResponse` _(type)_
+- `InviteResponseSchema`
+- `LeaveOrgResponse` _(type)_
+- `LeaveOrgResponseSchema`
+- `ListOrgUnitPermissionsResponse` _(type)_
+- `ListOrgUnitPermissionsResponseSchema`
+- `MemberRecentAction` _(type)_
+- `MissingAtNextLevel` _(type)_
+- `MissingAtNextLevelSchema`
+- `ORG_UNITS_ROUTES`
+- `OidcValidationResult` _(type)_
+- `OidcValidationResultDto` _(type)_
+- `OidcValidationResultSchema`
+- `OpenRole` _(type)_
+- `OpenRoleListResponse` _(type)_
+- `OpenRoleListResponseSchema`
+- `OpenRoleResponse` _(type)_
+- `OpenRoleResponseSchema`
+- `OpenRoleSchema`
+- `OpenRoleStatus` _(type)_
+- `OpenRoleStatusSchema`
+- `OrgAuthPolicy` _(type)_
+- `OrgAuthPolicyDto` _(type)_
+- `OrgAuthPolicySchema`
+- `OrgBillingResponse` _(type)_
+- `OrgBillingResponseSchema`
+- `OrgBudgetConfig` _(type)_
+- `OrgBudgetConfigSchema`
+- `OrgDeletionStatus` _(type)_
+- `OrgDeletionStatusSchema`
+- `OrgDomain` _(type)_
+- `OrgInvite` _(type)_
+- `OrgInviteStatus` _(type)_
+- `OrgLevelConfig` _(type)_
+- `OrgLevelConfigResponse` _(type)_
+- `OrgLevelConfigResponseSchema`
+- `OrgLevelConfigSchema`
+- `OrgLevelIcon` _(type)_
+- `OrgLevelIconSchema`
+- `OrgOwnerIcon` _(type)_
+- `OrgOwnerIconSchema`
+- `OrgScopedContext` _(type)_
+- `OrgSystemEventsList` _(type)_
+- `OrgSystemEventsListSchema`
+- `OrgTreeResponse` _(type)_
+- `OrgType` _(type)_
+- `OrgUnit` _(type)_
+- `OrgUnitAncestorsResponse` _(type)_
+- `OrgUnitAncestorsResponseSchema`
+- `OrgUnitChildrenResponse` _(type)_
+- `OrgUnitChildrenResponseSchema`
+- `OrgUnitClassification` _(type)_
+- `OrgUnitClassificationSchema`
+- `OrgUnitDescendantsResponse` _(type)_
+- `OrgUnitDescendantsResponseSchema`
+- `OrgUnitDesignation` _(type)_
+- `OrgUnitDesignationSchema`
+- `OrgUnitErrorCode` _(type)_
+- `OrgUnitErrorCodeSchema`
+- `OrgUnitMembership` _(type)_
+- `OrgUnitMembershipListResponse` _(type)_
+- `OrgUnitMembershipListResponseSchema`
+- `OrgUnitMembershipResponse` _(type)_
+- `OrgUnitMembershipResponseSchema`
+- `OrgUnitMembershipSchema`
+- `OrgUnitMembershipSource` _(type)_
+- `OrgUnitMembershipSourceSchema`
+- `OrgUnitMembershipStatus` _(type)_
+- `OrgUnitMembershipStatusSchema`
+- `OrgUnitOwner` _(type)_
+- `OrgUnitOwnerSchema`
+- `OrgUnitOwnersResponse` _(type)_
+- `OrgUnitOwnersResponseSchema`
+- `OrgUnitPermissionsEntry` _(type)_
+- `OrgUnitPermissionsEntrySchema`
+- `OrgUnitRelationship` _(type)_
+- `OrgUnitRelationshipRole` _(type)_
+- `OrgUnitRelationshipRoleSchema`
+- `OrgUnitRelationshipSchema`
+- `OrgUnitRelationshipType` _(type)_
+- `OrgUnitRelationshipTypeSchema`
+- `OrgUnitRelationshipsResponse` _(type)_
+- `OrgUnitRelationshipsResponseSchema`
+- `OrgUnitResponse` _(type)_
+- `OrgUnitResponseSchema`
+- `OrgUnitSchema`
+- `OrgUnitSyncMode` _(type)_
+- `OrgUnitSyncModeSchema`
+- `OrgUnitTreeNode` _(type)_
+- `OrgUnitTreeNodeSchema`
+- `OrgUnitTreeResponse` _(type)_
+- `OrgUnitTreeResponseSchema`
+- `OrgUnitVisibility` _(type)_
+- `OrgUnitVisibilitySchema`
+- `OrgUsageResponse` _(type)_
+- `OrgUsageResponseSchema`
+- `OrganizationInfo` _(type)_
+- `OwnerAuthority` _(type)_
+- `OwnerAuthoritySchema`
+- `OwnerIdentityInfo` _(type)_
+- `OwnershipTransferPreview` _(type)_
+- `OwnershipTransferPreviewSchema`
+- `OwnershipTransferRequest` _(type)_
+- `OwnershipTransferResponse` _(type)_
+- `OwnershipTransferResponseSchema`
+- `OwnershipTransferStatus` _(type)_
+- `PermissionAuditEntry` _(type)_
+- `Phase3AuditAction` _(type)_
+- `Phase4AuditAction` _(type)_
+- `ProviderStatus` _(type)_
+- `ProviderSuggestion` _(type)_
+- `RemoveMemberRequest` _(type)_
+- `RemoveMemberResponse` _(type)_
+- `RemoveMemberResponseSchema`
+- `RoleCatalogEntry` _(type)_
+- `RoleCatalogEntrySchema`
+- `RoleCatalogResponseSchema`
+- `ScopeCheckBatchResponse` _(type)_
+- `ScopeCheckBatchResponseSchema`
+- `ScopeCheckResponse` _(type)_
+- `ScopeCheckResponseSchema`
+- `SetActiveOrgResponse` _(type)_
+- `SetActiveOrgResponseSchema`
+- `SetMemberManagerResponse` _(type)_
+- `SetMemberManagerResponseSchema`
+- `SharePolicy` _(type)_
+- `ShareState` _(type)_
+- `SsoCredentialStatus` _(type)_
+- `SsoDiscoveryConfig` _(type)_
+- `SsoEnforcementStatus` _(type)_
+- `SsoOperationalState` _(type)_
+- `SsoReadiness` _(type)_
+- `SsoReadinessCheck` _(type)_
+- `SsoSetupInfo` _(type)_
+- `SsoStepperStep` _(type)_
+- `SubmitInteractiveTaskResponse` _(type)_
+- `SubmitInteractiveTaskResponseSchema`
+- `TRANSFER_RESPONSIBILITIES`
+- `TestSsoInitiation` _(type)_
+- `TestSsoInitiationDto` _(type)_
+- `TestSsoInitiationSchema`
+- `TestSsoResult` _(type)_
+- `TestSsoResultDto` _(type)_
+- `TestSsoResultSchema`
+- `TransferAcceptanceView` _(type)_
+- `TransferEligibilityResult` _(type)_
+- `TransferInitiateRequest` _(type)_
+- `TransferMemberEligibility` _(type)_
+- `TransferResponsibility` _(type)_
+- `TransferStatusResponse` _(type)_
+- `TreeOrderableNode` _(type)_
+- `UnitMembershipRole` _(type)_
+- `UnitMembershipRoleSchema`
+- `UpdateAuthPolicyRequest` _(type)_
+- `UpdateDelegationRequest` _(type)_
+- `UpdateDelegationRequestSchema`
+- `UpdateOpenRoleStatusRequest` _(type)_
+- `UpdateOpenRoleStatusRequestSchema`
+- `UpdateOrgUnitRequest` _(type)_
+- `UpdateOrgUnitRequestSchema`
+- `UpdateOrgUnitResponse` _(type)_
+- `UpdateOrgUnitResponseSchema`
+- `UserOrgMembership` _(type)_
+- `UserOrgsResponse` _(type)_
+- `UserOrgsResponseSchema`
+- `VIEW_SCOPE_MAP`
+- `WorkspaceAccessResponse` _(type)_
+- `WorkspaceAccessResponseSchema`
+- `WorkspaceAuditEvent` _(type)_
+- `WorkspaceAuditEventDto` _(type)_
+- `WorkspaceAuditEventSchema`
+- `WorkspaceAuditResponseSchema`
+- `WorkspaceAuthConfig` _(type)_
+- `WorkspaceAuthConfigDto` _(type)_
+- `WorkspaceAuthConfigSchema`
+- `WorkspaceInfoOverview` _(type)_
+- `WorkspaceMember` _(type)_
+- `WorkspaceMemberDetail` _(type)_
+- `WorkspaceMemberDetailSchema`
+- `WorkspaceMemberInviteStatus` _(type)_
+- `WorkspaceMemberUnitDesignationEntry` _(type)_
+- `WorkspaceMemberUnitDesignationEntrySchema`
+- `WorkspaceMemberUnitSummary` _(type)_
+- `WorkspaceMembersResponse` _(type)_
+- `WorkspaceMembersResponseSchema`
+- `WorkspaceOverview` _(type)_
+- `WorkspaceOverviewDto` _(type)_
+- `WorkspaceOverviewSchema`
+- `WorkspaceResolvePathResponse` _(type)_
+- `WorkspaceResolvePathResponseSchema`
+- `WorkspaceResyncSlackLogoResponse` _(type)_
+- `WorkspaceResyncSlackLogoResponseSchema`
+- `WorkspaceSettingsOverview` _(type)_
+- `WorkspaceSsoState` _(type)_
+- `WorkspaceSurface` _(type)_
+- `getViewScope`
+- `orderTreeNodes`
+
+<!-- END GENERATED: readme-public-api -->
+
+<!-- BEGIN GENERATED: readme-dependencies — derived from code by `pnpm readme-api`. Do not edit. -->
 
 ## Dependencies
 
-None. This is a leaf vocabulary module.
+**Internal domains:**
+
+- `api`
+- `permissions`
+
+**External packages:**
+
+- `zod`
+
+<!-- END GENERATED: readme-dependencies -->

package/src/ralph/README.md

@@ -12,31 +12,44 @@ TypeScript types for Ralph, an autonomous AI coding loop with graduated trust le
 - PRD `passes` field is the only field Ralph should modify during execution
 - Orchestration, prompts, and trust logic live in company-semantics-control, not here
 
-## Public API
+<!-- BEGIN GENERATED: readme-public-api — derived from code by `pnpm readme-api`. Do not edit. -->
 
-### PRD Types
+## Public API
 
-- `RalphPRDCategory` — Category of feature item (`functional`, `architectural`, `integration`, `polish`)
-- `RalphPRDPriority` — Priority level (`high`, `medium`, `low`)
-- `RalphPRDItem` — Single feature item in a PRD
-- `RalphPRD` — Complete PRD document
+- `AllowedRepo` _(type)_
+- `REPO_PRECEDENCE`
+- `RalphAcceptanceCriteria` _(type)_
+- `RalphAgentContract` _(type)_
+- `RalphCapabilities` _(type)_
+- `RalphCommitPolicy` _(type)_
+- `RalphExecutionPolicy` _(type)_
+- `RalphFailurePolicy` _(type)_
+- `RalphFeatureGroup` _(type)_
+- `RalphInteractionFlow` _(type)_
+- `RalphIteration` _(type)_
+- `RalphMeta` _(type)_
+- `RalphMode` _(type)_
+- `RalphPRD` _(type)_
+- `RalphPRDCategory` _(type)_
+- `RalphPRDItem` _(type)_
+- `RalphPRDPriority` _(type)_
+- `RalphProgress` _(type)_
+- `RalphReferenceImplementation` _(type)_
+- `RalphScope` _(type)_
+- `RalphSuccessCriteria` _(type)_
+
+<!-- END GENERATED: readme-public-api -->
+
+<!-- BEGIN GENERATED: readme-dependencies — derived from code by `pnpm readme-api`. Do not edit. -->
 
-### Progress Types
+## Dependencies
 
-- `RalphIteration` — Record of a single iteration
-- `RalphMode` — Operation mode (`hitl`, `afk`)
-- `RalphProgress` — Complete session progress state
+**Internal domains:**
 
-### Trust Types
+_None._
 
-- `RalphTrustLevel` — Trust level (0-3)
-- `RalphRunResult` — Run outcome (`success`, `failure`)
-- `RalphCIStatus` — CI status (`green`, `red`, `skipped`)
-- `RalphTrustLog` — Run outcome record for audit
-- `RalphTrustPolicy` — Trust policy configuration
-- `RalphDemotionReason` — Reasons for automatic demotion
+**External packages:**
 
-## Dependencies
+_None._
 
-**Imports from:** (none — leaf module)
-**Imported by:** company-semantics-control
+<!-- END GENERATED: readme-dependencies -->

package/src/rate-limit/README.md

@@ -49,3 +49,27 @@ This is the canonical semantic across all Company Semantics repos.
 
 - PRD-00012: Foundational rate limiting implementation
 - PRD-00013: Contracts integration (this promotion)
+
+<!-- BEGIN GENERATED: readme-public-api — derived from code by `pnpm readme-api`. Do not edit. -->
+
+## Public API
+
+- `RateLimitConfig` _(type)_
+- `RateLimitResult` _(type)_
+- `RateLimitTier`
+
+<!-- END GENERATED: readme-public-api -->
+
+<!-- BEGIN GENERATED: readme-dependencies — derived from code by `pnpm readme-api`. Do not edit. -->
+
+## Dependencies
+
+**Internal domains:**
+
+_None._
+
+**External packages:**
+
+_None._
+
+<!-- END GENERATED: readme-dependencies -->