@company-semantics/contracts 0.120.0 → 0.122.0

package/src/execution/index.ts

@@ -145,3 +145,25 @@ export type {
   TimelineIcon,
   TimelineUIEvent,
 } from './timeline-ui'
+
+// =============================================================================
+// HTTP Response Schemas (Zod)
+// =============================================================================
+
+export {
+  ExecutionSummarySchema,
+  ExecutionListResponseSchema,
+  TimelineEventSchema,
+  ExecutionTimelineResponseSchema,
+  ConfirmExecutionResponseSchema,
+  RejectExecutionResponseSchema,
+} from './schemas'
+
+export type {
+  ExecutionSummaryResponse,
+  ExecutionListResponse,
+  TimelineEvent,
+  ExecutionTimelineResponse,
+  ConfirmExecutionResponse,
+  RejectExecutionResponse,
+} from './schemas'

package/src/execution/schemas.ts

@@ -0,0 +1,95 @@
+/**
+ * Execution Response Schemas
+ *
+ * Zod schemas for execution HTTP endpoint responses.
+ * These schemas are used for runtime validation at API contract surfaces.
+ *
+ * @see ADR-CONT-029 for design rationale
+ */
+
+import { z } from 'zod'
+
+// =============================================================================
+// Execution Summary
+// =============================================================================
+
+export const ExecutionSummarySchema = z.object({
+  executionId: z.string().uuid(),
+  kind: z.string(),
+  status: z.enum(['pending', 'succeeded', 'failed']),
+  decidedAt: z.string().datetime({ offset: true }),
+  completedAt: z.string().datetime({ offset: true }).optional(),
+  target: z.object({ type: z.string() }),
+})
+
+export type ExecutionSummaryResponse = z.infer<typeof ExecutionSummarySchema>
+
+// =============================================================================
+// Execution List Response
+// =============================================================================
+
+export const ExecutionListResponseSchema = z.object({
+  executions: z.array(ExecutionSummarySchema),
+  nextCursor: z.string().nullable().optional(),
+  hasMore: z.boolean().optional(),
+})
+
+export type ExecutionListResponse = z.infer<typeof ExecutionListResponseSchema>
+
+// =============================================================================
+// Timeline Event
+// =============================================================================
+
+const TimelineRelatedIdsSchema = z.object({
+  decisionId: z.string().optional(),
+  artifactId: z.string().optional(),
+  rollbackId: z.string().optional(),
+  provenanceIds: z.array(z.string()).optional(),
+})
+
+export const TimelineEventSchema = z.object({
+  eventId: z.string(),
+  executionId: z.string().uuid(),
+  timestamp: z.string(),
+  createdAt: z.string(),
+  kind: z.string(),
+  summary: z.string(),
+  details: z.record(z.string(), z.unknown()).optional(),
+  relatedIds: TimelineRelatedIdsSchema.optional(),
+  visibilityLevel: z.enum(['system', 'oversight', 'org_admin', 'user']),
+})
+
+export type TimelineEvent = z.infer<typeof TimelineEventSchema>
+
+// =============================================================================
+// Execution Timeline Response
+// =============================================================================
+
+export const ExecutionTimelineResponseSchema = z.object({
+  events: z.array(TimelineEventSchema),
+})
+
+export type ExecutionTimelineResponse = z.infer<typeof ExecutionTimelineResponseSchema>
+
+// =============================================================================
+// Execution Lifecycle Responses
+// =============================================================================
+
+export const ConfirmExecutionResponseSchema = z.object({
+  status: z.enum([
+    'executing',
+    'blocked_pending_approval',
+    'already_confirmed',
+    'awaiting_approval',
+  ]),
+  code: z.string().optional(),
+  executionId: z.string().optional(),
+})
+
+export type ConfirmExecutionResponse = z.infer<typeof ConfirmExecutionResponseSchema>
+
+export const RejectExecutionResponseSchema = z.object({
+  status: z.literal('cancelled'),
+})
+
+export type RejectExecutionResponse = z.infer<typeof RejectExecutionResponseSchema>

package/src/org/index.ts

@@ -179,3 +179,25 @@ export type {
   ScopeCheckResponse,
   ScopeCheckBatchResponse,
 } from './schemas';
+
+// Org lifecycle response schemas (PRD-00446)
+export {
+  InviteResponseSchema,
+  InviteListResponseSchema,
+  DomainResponseSchema,
+  DomainListResponseSchema,
+  OrgBillingResponseSchema,
+  OrgDeletionStatusSchema,
+  OwnershipTransferResponseSchema,
+  OwnershipTransferPreviewSchema,
+} from './schemas';
+export type {
+  InviteResponse,
+  InviteListResponse,
+  DomainResponse,
+  DomainListResponse,
+  OrgBillingResponse,
+  OrgDeletionStatus,
+  OwnershipTransferResponse,
+  OwnershipTransferPreview,
+} from './schemas';

package/src/org/schemas.ts

@@ -371,3 +371,134 @@ export const ScopeCheckBatchResponseSchema = z.object({
 });
 
 export type ScopeCheckBatchResponse = z.infer<typeof ScopeCheckBatchResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// Invite sub-schema
+// ---------------------------------------------------------------------------
+
+const OrgInviteSchema = z.object({
+  id: z.string(),
+  orgId: z.string(),
+  email: z.string(),
+  role: z.enum(['owner', 'admin', 'member', 'auditor']),
+  invitedBy: z.object({ id: z.string(), name: z.string() }),
+  status: z.enum(['pending', 'accepted', 'expired', 'revoked']),
+  createdAt: z.string(),
+  expiresAt: z.string(),
+  acceptedAt: z.string().optional(),
+});
+
+// ---------------------------------------------------------------------------
+// POST /api/workspace/invites
+// ---------------------------------------------------------------------------
+
+export const InviteResponseSchema = z.object({
+  invite: OrgInviteSchema,
+});
+
+export type InviteResponse = z.infer<typeof InviteResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// GET /api/workspace/invites
+// ---------------------------------------------------------------------------
+
+export const InviteListResponseSchema = z.array(OrgInviteSchema);
+
+export type InviteListResponse = z.infer<typeof InviteListResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// OrgDomain sub-schema
+// ---------------------------------------------------------------------------
+
+const OrgDomainSchema = z.object({
+  id: z.string(),
+  orgId: z.string(),
+  domain: z.string(),
+  status: z.enum(['pending', 'verified']),
+  verificationMethod: z.enum(['dns_txt', 'email', 'idp']),
+  verificationToken: z.string().optional(),
+  verifiedAt: z.string().nullable(),
+  createdAt: z.string(),
+  verifiedBy: z.object({ id: z.string(), name: z.string(), email: z.string() }).optional(),
+});
+
+// ---------------------------------------------------------------------------
+// GET /api/workspace/domains/:id/verify (single domain)
+// POST /api/workspace/domains/:id/verify (returns verified OrgDomain)
+// ---------------------------------------------------------------------------
+
+export const DomainResponseSchema = OrgDomainSchema;
+
+export type DomainResponse = z.infer<typeof DomainResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// GET /api/workspace/domains
+// ---------------------------------------------------------------------------
+
+export const DomainListResponseSchema = z.array(OrgDomainSchema);
+
+export type DomainListResponse = z.infer<typeof DomainListResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// GET /api/orgs/:orgId/billing
+// ---------------------------------------------------------------------------
+
+export const OrgBillingResponseSchema = z.object({
+  planName: z.string(),
+  planStatus: z.enum(['active', 'trialing', 'past_due', 'canceled']),
+  billingCadence: z.string(),
+  seatCount: z.number(),
+  seatLimit: z.number(),
+  billingOwnerUserId: z.string(),
+});
+
+export type OrgBillingResponse = z.infer<typeof OrgBillingResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// GET /api/org/deletion-eligibility
+// ---------------------------------------------------------------------------
+
+const MemberClassificationSchema = z.object({
+  userId: z.string(),
+  email: z.string(),
+  suggestedFate: z.enum(['REMOVE_FROM_ORG', 'DELETE_ACCOUNT', 'BLOCKED']),
+  reason: z.string(),
+});
+
+export const OrgDeletionStatusSchema = z.object({
+  orgId: z.string(),
+  eligible: z.boolean(),
+  isPersonalOrg: z.boolean(),
+  ownerStatus: z.string().optional(),
+  deletionRequestedAt: z.string().optional(),
+  classifications: z.array(MemberClassificationSchema),
+});
+
+export type OrgDeletionStatus = z.infer<typeof OrgDeletionStatusSchema>;
+
+// ---------------------------------------------------------------------------
+// POST /api/org/transfer-ownership (initiate)
+// ---------------------------------------------------------------------------
+
+export const OwnershipTransferResponseSchema = z.object({
+  transferId: z.string(),
+  expiresAt: z.string(),
+  message: z.string(),
+});
+
+export type OwnershipTransferResponse = z.infer<typeof OwnershipTransferResponseSchema>;
+
+// ---------------------------------------------------------------------------
+// POST /api/org/transfer-ownership/preview
+// ---------------------------------------------------------------------------
+
+export const OwnershipTransferPreviewSchema = z.object({
+  workspaceName: z.string(),
+  initiatorName: z.string(),
+  initiatorEmail: z.string(),
+  note: z.string().optional(),
+  expiresAt: z.string(),
+  token: z.string(),
+});
+
+export type OwnershipTransferPreview = z.infer<typeof OwnershipTransferPreviewSchema>;