@company-semantics/contracts 86.1.0 → 88.0.0

package/src/chat/types.ts

@@ -8,7 +8,6 @@
 
 import { z } from "zod";
 import {
-  ChatVisibilitySchema,
   TitleSourceSchema,
   InvalidationReasonSchema,
   ChatChangedFieldSchema,
@@ -17,9 +16,6 @@ import {
   ChatSummaryExtendedSchema,
   ProactiveChatResolutionSchema,
   TitleGenerationResponseSchema,
-  ChatShareInfoSchema,
-  SharedChatViewSchema,
-  SharedChatMessageSchema,
   BaseEventSchema,
   ChatCreatedEventSchema,
   ChatUpdatedEventSchema,
@@ -33,13 +29,11 @@ import {
   ChatByInteractionResponseSchema,
   ChatListResponseSchema,
   CreateChatResponseSchema,
-  CreateShareResponseSchema,
-  ListSharesResponseSchema,
-  UpdateShareResponseSchema,
   ChatMessageSchema,
   ChatMessageMentionSchema,
   ChatMentionableResponseSchema,
   ChatParticipantRoleSchema,
+  ChatGrantableRoleSchema,
   ChatParticipantSchema,
   ChatParticipantsResponseSchema,
   ChatDetailSchema,
@@ -48,17 +42,6 @@ import {
   ChatPageContextSchema,
 } from "./schemas";
 
-// =============================================================================
-// Visibility
-// =============================================================================
-
-/**
- * Chat share visibility.
- * - private: Token exists but access requires authentication as chat owner
- * - public: Token grants anonymous access to anyone with the link
- */
-export type ChatVisibility = z.infer<typeof ChatVisibilitySchema>;
-
 // =============================================================================
 // Chat Summary
 // =============================================================================
@@ -68,53 +51,6 @@ export type ChatVisibility = z.infer<typeof ChatVisibilitySchema>;
  */
 export type ChatSummary = z.infer<typeof ChatSummarySchema>;
 
-// =============================================================================
-// Share Types
-// =============================================================================
-
-/**
- * Chat share record with snapshot metadata.
- *
- * CRITICAL INVARIANT (SNAPSHOT-1):
- * A chat share must never expose messages with sequenceNumber > messageCountAtShare.
- * Enforced in ChatShareService.viewSharedChat() only.
- */
-export type ChatShareInfo = z.infer<typeof ChatShareInfoSchema>;
-
-/**
- * Shared chat view returned to viewers.
- * Messages are limited by the snapshot boundary.
- */
-export type SharedChatView = z.infer<typeof SharedChatViewSchema>;
-
-/**
- * Individual message in a shared chat view.
- */
-export type SharedChatMessage = z.infer<typeof SharedChatMessageSchema>;
-
-// =============================================================================
-// API Request/Response Types
-// =============================================================================
-
-/**
- * Request to create a new share for a chat.
- */
-export interface CreateShareRequest {
-  chatId: string;
-  visibility: ChatVisibility;
-  /** Optional: send email notification to this address */
-  recipientEmail?: string;
-}
-
-/**
- * Request to update an existing share.
- */
-export interface UpdateShareRequest {
-  visibility?: ChatVisibility;
-  /** If true, update snapshot to include new messages added since share creation */
-  updateSnapshot?: boolean;
-}
-
 // =============================================================================
 // Chat Lifecycle Types
 // =============================================================================
@@ -288,15 +224,6 @@ export type ChatListResponse = z.infer<typeof ChatListResponseSchema>;
 /** Response for POST /api/chats */
 export type CreateChatResponse = z.infer<typeof CreateChatResponseSchema>;
 
-/** Response for POST /api/chats/:chatId/shares */
-export type CreateShareResponse = z.infer<typeof CreateShareResponseSchema>;
-
-/** Response for GET /api/chats/:chatId/shares */
-export type ListSharesResponse = z.infer<typeof ListSharesResponseSchema>;
-
-/** Response for PATCH /api/shares/:shareId */
-export type UpdateShareResponse = z.infer<typeof UpdateShareResponseSchema>;
-
 /** Individual message in a chat response (GET /api/chats/:id). */
 export type ChatMessage = z.infer<typeof ChatMessageSchema>;
 
@@ -316,12 +243,33 @@ export type ChatMentionableResponse = z.infer<
 // =============================================================================
 
 /**
- * What one person is to a chat: `owner` or `participant`. Participation, not an
- * access band — there is no `viewer` and no per-participant scope, because a
- * chat you can read half of is not a thing this surface models.
+ * What one person is to a chat: `owner`, `participant` (Collaborate) or
+ * `viewer` (Read only). Whole-chat access, never a per-participant scope
+ * (ADR-CONTRACTS-206).
  */
 export type ChatParticipantRole = z.infer<typeof ChatParticipantRoleSchema>;
 
+/** A role a share can grant: `participant` (Collaborate) or `viewer` (Read only). */
+export type ChatGrantableRole = z.infer<typeof ChatGrantableRoleSchema>;
+
+/**
+ * Request for POST /api/chats/:chatId/participants — sharing the chat with one
+ * org member at a grantable role. A request-only type (no runtime schema), like
+ * the other chat requests.
+ */
+export interface AddChatParticipantRequest {
+  userId: string;
+  role: ChatGrantableRole;
+}
+
+/**
+ * Request for PATCH /api/chats/:chatId/participants/:userId — the owner moving
+ * someone between Read only and Collaborate.
+ */
+export interface UpdateChatParticipantRequest {
+  role: ChatGrantableRole;
+}
+
 /**
  * One ACTIVE participant of a chat — a user id, a role, a read-time display
  * name and when they joined. Never a `PrincipalRef`: the agent takes part in

package/src/generated/openapi-routes.ts

@@ -21,13 +21,12 @@ export const openApiRoutes = {
   '/api/chats/mentionable': ['GET'],
   '/api/chats/proactive/{eventId}': ['GET'],
   '/api/chats/resolve-launch': ['POST'],
-  '/api/chats/{chatId}/shares': ['GET', 'POST'],
   '/api/chats/{id}': ['DELETE', 'GET', 'PATCH'],
   '/api/chats/{id}/generate-title': ['POST'],
   '/api/chats/{id}/messages': ['POST'],
   '/api/chats/{id}/messages/{messageId}': ['DELETE'],
   '/api/chats/{id}/participants': ['GET', 'POST'],
-  '/api/chats/{id}/participants/{userId}': ['DELETE'],
+  '/api/chats/{id}/participants/{userId}': ['DELETE', 'PATCH'],
   '/api/chats/{id}/pin': ['DELETE', 'POST'],
   '/api/chats/{id}/start-fresh': ['POST'],
   '/api/comments': ['GET'],
@@ -186,8 +185,6 @@ export const openApiRoutes = {
   '/api/reporting/positions/{positionId}/manager': ['PUT'],
   '/api/scope/check': ['GET'],
   '/api/scope/check-batch': ['POST'],
-  '/api/shared/{token}': ['GET'],
-  '/api/shares/{shareId}': ['DELETE', 'PATCH'],
   '/api/source-sync/candidate-sets/current': ['GET'],
   '/api/source-sync/candidate-sets/{setId}/approve': ['POST'],
   '/api/source-sync/candidate-sets/{setId}/items': ['POST'],

package/src/guards/README.md

@@ -26,7 +26,6 @@ This module exports **types only** — runtime helper functions live in the work
 - `CheckResult` _(type)_ — Result from a single guard check.
 - `ContractsConsumerBaseline` _(type)_ — Contracts consumer guard configuration.
 - `ContractsFreshnessBaseline` _(type)_ — Contracts freshness baseline configuration.
-- `CoverageBaseline` _(type)_ — Coverage baseline configuration.
 - `DEFAULT_DOMAIN_SECTIONS` — Default README sections for domain directories.
 - `DEFAULT_INFRA_SECTIONS` — Default README sections for infrastructure directories.
 - `DEFAULT_SKIP_DIRECTORIES` — Default directories to skip when walking file trees.

package/src/guards/config.ts

@@ -12,7 +12,6 @@ import type { CheckResult } from "./types";
 // The EvolutionBaselines interface below references these evolution baseline
 // types, which now live in ./evolution-config.
 import type {
-  CoverageBaseline,
   FileClusterBaseline,
   SubdirectoryAffinityBaseline,
 } from "./evolution-config";
@@ -34,7 +33,6 @@ export type {
 export type {
   DomainAggregateBaseline,
   AggregateEvolutionConfig,
-  CoverageBaseline,
   FileClusterBaseline,
   SubdirectoryAffinityBaseline,
 } from "./evolution-config";
@@ -197,7 +195,7 @@ export interface ScriptsDepsBaseline {
 
   /**
    * If true, violations are errors. If false, violations are warnings.
-   * @default false
+   * @default true (company-semantics-ci ADR-CI-254)
    */
   strict?: boolean;
 }
@@ -326,13 +324,6 @@ export interface EvolutionBaselines {
    */
   contractsFreshness?: ContractsFreshnessBaseline;
 
-  /**
-   * Coverage drift check configuration.
-   * CI injects checkCoverageDrift based on this config.
-   * Errors when coverage drops below baseline (enforced).
-   */
-  coverage?: CoverageBaseline;
-
   /**
    * File cluster detection configuration.
    * CI injects checkFileClusters based on this config.

package/src/guards/evolution-config.ts

@@ -2,7 +2,7 @@
  * Evolution & Drift-Detection Guard Configuration Vocabulary
  *
  * Polymorphic configuration types for the evolution/drift guards: domain-level
- * aggregate tracking plus the coverage, file-cluster, and subdirectory-affinity
+ * aggregate tracking plus the file-cluster and subdirectory-affinity
  * baselines referenced by EvolutionBaselines.
  *
  * Extracted from ./config.ts as a cohesive sub-module (the evolution guard
@@ -65,23 +65,6 @@ export interface AggregateEvolutionConfig {
   };
 }
 
-// =============================================================================
-// Coverage Baseline Types
-// =============================================================================
-
-/**
- * Coverage baseline configuration.
- * Used by CI orchestrator to inject coverage drift guard.
- */
-export interface CoverageBaseline {
-  /** Path to coverage-summary.json (default: 'coverage/coverage-summary.json') */
-  coverageFile?: string;
-  /** Baseline coverage percentage (lines) */
-  baseline: number;
-  /** Allowed drop threshold before error (default: 0 = any drop errors) */
-  dropThreshold?: number;
-}
-
 /**
  * File cluster detection configuration.
  * Detects clusters of related files that could benefit from

package/src/guards/index.ts

@@ -50,7 +50,6 @@ export type {
   ContractsConsumerBaseline,
   EvolutionBaselines,
   ContractsFreshnessBaseline,
-  CoverageBaseline,
   FileClusterBaseline,
   SubdirectoryAffinityBaseline,
   MetaBaselines,