@company-semantics/contracts 0.121.0 → 0.123.0

package/src/content/index.ts

@@ -0,0 +1,34 @@
+/**
+ * Content Domain Barrel
+ *
+ * Re-exports content response schemas for company-md, teams, departments, and drive.
+ * Import from '@company-semantics/contracts/content'.
+ */
+
+// Company.md response schemas (PRD-00448)
+export {
+  CompanyMdListResponseSchema,
+  CompanyMdDocResponseSchema,
+  CompanyMdShareResponseSchema,
+  CompanyMdContextBankResponseSchema,
+  CompanyMdSettingsResponseSchema,
+} from './schemas';
+export type {
+  CompanyMdListResponse,
+  CompanyMdDocResponse,
+  CompanyMdShareResponse,
+  CompanyMdContextBankResponse,
+  CompanyMdSettingsResponse,
+} from './schemas';
+
+// Team response schemas (PRD-00448)
+export { TeamListResponseSchema, TeamResponseSchema } from './schemas';
+export type { TeamListResponse, TeamResponse } from './schemas';
+
+// Department response schemas (PRD-00448)
+export { DepartmentListResponseSchema, DepartmentResponseSchema } from './schemas';
+export type { DepartmentListResponse, DepartmentResponse } from './schemas';
+
+// Drive response schemas (PRD-00448)
+export { DriveFileListResponseSchema, DriveFileContentResponseSchema } from './schemas';
+export type { DriveFileListResponse, DriveFileContentResponse } from './schemas';

package/src/content/schemas.ts

@@ -0,0 +1,286 @@
+/**
+ * Content Domain Response Schemas
+ *
+ * Zod response schemas for content and org structure endpoints.
+ * Canonical location for runtime validation of company-md, team,
+ * department, and drive API responses.
+ *
+ * Covers:
+ *  - company-md.ts        (GET /api/company-md/tree, GET /api/company-md/docs/:slug, etc.)
+ *  - company-md-sharing.ts (GET /api/company-md/docs/:slug/sharing)
+ *  - teams.ts             (GET /api/teams, GET /api/teams/:teamId, etc.)
+ *  - departments.ts       (GET /api/departments, GET /api/departments/:id, etc.)
+ *  - drive.ts             (GET /api/drive/files, GET /api/drive/files/recent, etc.)
+ */
+import { z } from 'zod';
+import { CursorPageSchema } from '../api/primitives';
+
+// ---------------------------------------------------------------------------
+// Company.md Sub-schemas
+// ---------------------------------------------------------------------------
+
+const CompanyMdOwningTeamSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+});
+
+const CompanyMdPersonSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+});
+
+const CompanyMdSourceSchema = z.object({
+  label: z.string(),
+  sourceType: z.enum(['meeting', 'document', 'conversation', 'manual']),
+  referencedAt: z.string(),
+});
+
+const CompanyMdDependencySchema = z.object({
+  targetSlug: z.string(),
+  description: z.string(),
+});
+
+const CompanyMdTreeNodeSchema = z.object({
+  id: z.string(),
+  slug: z.string(),
+  title: z.string(),
+  level: z.enum(['root', 'department', 'team', 'context']),
+  parentId: z.string().nullable(),
+  department: z.string().nullable(),
+  departmentId: z.string().nullable(),
+  visibility: z.enum(['public', 'private']),
+  owningTeam: CompanyMdOwningTeamSchema.nullable(),
+  type: z.enum(['company', 'department', 'team', 'cross_team', 'doc', 'goal', 'source', 'map', 'context_bank']),
+  canEdit: z.boolean(),
+  memberCount: z.number().int(),
+  description: z.string().optional(),
+  departmentIds: z.array(z.string()).optional(),
+});
+
+// ---------------------------------------------------------------------------
+// Company.md HTTP Response Schemas
+// ---------------------------------------------------------------------------
+
+/** Response for GET /api/company-md/tree */
+export const CompanyMdListResponseSchema = CursorPageSchema(CompanyMdTreeNodeSchema);
+
+/** Response for GET /api/company-md/docs/:slug */
+export const CompanyMdDocResponseSchema = z.object({
+  id: z.string(),
+  slug: z.string(),
+  title: z.string(),
+  level: z.enum(['root', 'department', 'team', 'context']),
+  department: z.string().nullable(),
+  departmentId: z.string().nullable(),
+  content: z.string(),
+  visibility: z.enum(['public', 'private']),
+  parentId: z.string().nullable(),
+  owningTeam: CompanyMdOwningTeamSchema.nullable(),
+  owner: CompanyMdPersonSchema.nullable(),
+  coOwners: z.array(CompanyMdPersonSchema),
+  canEdit: z.boolean(),
+  inheritsFrom: z.string().nullable(),
+  sources: z.array(CompanyMdSourceSchema),
+  dependencies: z.array(CompanyMdDependencySchema),
+  members: z.array(CompanyMdPersonSchema),
+  extractionStatus: z.enum(['pending', 'extracting', 'complete', 'failed']),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+// ---------------------------------------------------------------------------
+// Company.md Sharing Sub-schemas
+// ---------------------------------------------------------------------------
+
+const AclEntrySchema = z.object({
+  principalType: z.enum(['user', 'team']),
+  principalId: z.string(),
+  principalName: z.string(),
+  accessLevel: z.enum(['viewer', 'commenter', 'editor']),
+  grantedBy: z.object({ id: z.string(), name: z.string() }).nullable(),
+  grantedAt: z.string(),
+});
+
+const AccessReasonSchema = z.object({
+  source: z.enum(['org_rbac', 'sharing_policy', 'team_baseline', 'acl_grant', 'doc_ownership']),
+  detail: z.string(),
+});
+
+const EffectiveAccessSchema = z.object({
+  level: z.enum(['none', 'viewer', 'commenter', 'editor']),
+  reasons: z.array(AccessReasonSchema),
+  canShare: z.boolean(),
+});
+
+/** Response for GET /api/company-md/docs/:slug/sharing */
+export const CompanyMdShareResponseSchema = z.object({
+  sharingPolicy: z.enum(['restricted', 'org_read', 'org_comment', 'org_edit']),
+  acl: z.array(AclEntrySchema),
+  effectiveAccess: EffectiveAccessSchema,
+});
+
+// ---------------------------------------------------------------------------
+// Company.md Context Bank + Settings Response Schemas
+// ---------------------------------------------------------------------------
+
+const CompanyMdContextBankItemSchema = z.object({
+  id: z.string(),
+  slug: z.string(),
+  title: z.string(),
+  visibility: z.enum(['public', 'private']),
+  updatedAt: z.string(),
+});
+
+/** Response for GET /api/company-md/docs/:slug/context-bank */
+export const CompanyMdContextBankResponseSchema = z.object({
+  items: z.array(CompanyMdContextBankItemSchema),
+});
+
+const CompanyMdLevelLabelsSchema = z.object({
+  root: z.string(),
+  department: z.string(),
+  team: z.string(),
+});
+
+/** Response for GET /api/company-md/settings */
+export const CompanyMdSettingsResponseSchema = z.object({
+  levelLabels: CompanyMdLevelLabelsSchema,
+});
+
+// ---------------------------------------------------------------------------
+// Team Sub-schemas
+// ---------------------------------------------------------------------------
+
+const TeamMemberSchema = z.object({
+  userId: z.string(),
+  name: z.string(),
+  email: z.string(),
+  role: z.enum(['member', 'manager', 'owner']),
+  joinedAt: z.string(),
+});
+
+const TeamSummarySchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  slug: z.string(),
+  description: z.string().nullable(),
+  memberCount: z.number().int(),
+  scope: z.enum(['department', 'cross_department', 'org']),
+  department: z.object({ id: z.string(), name: z.string(), slug: z.string() }).nullable(),
+  homeDepartment: z.object({ id: z.string(), name: z.string(), slug: z.string() }).nullable(),
+});
+
+// ---------------------------------------------------------------------------
+// Team HTTP Response Schemas
+// ---------------------------------------------------------------------------
+
+/** Response for GET /api/teams */
+export const TeamListResponseSchema = z.object({
+  teams: z.array(TeamSummarySchema),
+});
+
+/** Response for GET /api/teams/:teamId */
+export const TeamResponseSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  slug: z.string(),
+  description: z.string().nullable(),
+  syncMode: z.enum(['manual_only', 'synced_readonly', 'synced_with_overrides']),
+  members: z.array(TeamMemberSchema),
+});
+
+// ---------------------------------------------------------------------------
+// Department Sub-schemas
+// ---------------------------------------------------------------------------
+
+const DepartmentMemberSchema = z.object({
+  userId: z.string(),
+  name: z.string(),
+  email: z.string(),
+  role: z.enum(['member', 'manager', 'owner']),
+  joinedAt: z.string(),
+});
+
+const DepartmentSummarySchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  slug: z.string(),
+  description: z.string().nullable(),
+  memberCount: z.number().int(),
+  position: z.number().int(),
+});
+
+// ---------------------------------------------------------------------------
+// Department HTTP Response Schemas
+// ---------------------------------------------------------------------------
+
+/** Response for GET /api/departments */
+export const DepartmentListResponseSchema = z.object({
+  departments: z.array(DepartmentSummarySchema),
+});
+
+/** Response for GET /api/departments/:id */
+export const DepartmentResponseSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  slug: z.string(),
+  description: z.string().nullable(),
+  position: z.number().int(),
+  syncMode: z.enum(['manual_only', 'scim', 'hris']),
+  memberCount: z.number().int(),
+  members: z.array(DepartmentMemberSchema),
+});
+
+// ---------------------------------------------------------------------------
+// Drive Sub-schemas
+// ---------------------------------------------------------------------------
+
+const DriveFileOwnerSchema = z.object({
+  displayName: z.string().optional(),
+  emailAddress: z.string().optional(),
+});
+
+const DriveFileSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  mimeType: z.string(),
+  createdTime: z.string().optional(),
+  modifiedTime: z.string().optional(),
+  owners: z.array(DriveFileOwnerSchema).optional(),
+  webViewLink: z.string().optional(),
+  iconLink: z.string().optional(),
+  size: z.string().optional(),
+});
+
+// ---------------------------------------------------------------------------
+// Drive HTTP Response Schemas
+// ---------------------------------------------------------------------------
+
+/** Response for GET /api/drive/files and GET /api/drive/files/recent */
+export const DriveFileListResponseSchema = z.object({
+  files: z.array(DriveFileSchema),
+  nextPageToken: z.string().optional(),
+});
+
+/** Response for GET /api/drive/files/:fileId/content */
+export const DriveFileContentResponseSchema = z.object({
+  content: z.string(),
+  exportedAs: z.string(),
+  truncated: z.boolean(),
+});
+
+// ---------------------------------------------------------------------------
+// Inferred Types
+// ---------------------------------------------------------------------------
+
+export type CompanyMdListResponse = z.infer<typeof CompanyMdListResponseSchema>;
+export type CompanyMdDocResponse = z.infer<typeof CompanyMdDocResponseSchema>;
+export type CompanyMdShareResponse = z.infer<typeof CompanyMdShareResponseSchema>;
+export type CompanyMdContextBankResponse = z.infer<typeof CompanyMdContextBankResponseSchema>;
+export type CompanyMdSettingsResponse = z.infer<typeof CompanyMdSettingsResponseSchema>;
+export type TeamListResponse = z.infer<typeof TeamListResponseSchema>;
+export type TeamResponse = z.infer<typeof TeamResponseSchema>;
+export type DepartmentListResponse = z.infer<typeof DepartmentListResponseSchema>;
+export type DepartmentResponse = z.infer<typeof DepartmentResponseSchema>;
+export type DriveFileListResponse = z.infer<typeof DriveFileListResponseSchema>;
+export type DriveFileContentResponse = z.infer<typeof DriveFileContentResponseSchema>;

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>