@company-semantics/contracts 0.66.0 → 0.67.1

package/package.json

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

package/src/impersonation-events.ts

@@ -0,0 +1,54 @@
+/**
+ * Impersonation SSE Event Types
+ *
+ * Real-time push events for impersonation session state changes.
+ * Replaces 30-second polling mechanism.
+ * Follows the same BaseEvent envelope pattern as chat SSE events.
+ */
+
+import type { BaseEvent } from './chat/types'
+import type { ImpersonationSession } from './impersonation'
+
+/**
+ * Sent as the first frame on SSE connection.
+ * Carries the current active session (or null if none).
+ * Eliminates need for a separate GET /session request.
+ */
+export interface ImpersonationSessionSnapshotEvent extends BaseEvent {
+  type: 'impersonation.session.snapshot'
+  data: {
+    session: ImpersonationSession | null
+  }
+}
+
+/** Emitted when a new impersonation session starts (enables multi-tab sync). */
+export interface ImpersonationSessionStartedEvent extends BaseEvent {
+  type: 'impersonation.session.started'
+  data: {
+    session: ImpersonationSession
+  }
+}
+
+/** Emitted when an admin manually ends an impersonation session. */
+export interface ImpersonationSessionEndedEvent extends BaseEvent {
+  type: 'impersonation.session.ended'
+  data: {
+    sessionId: string
+    endedAt: string
+  }
+}
+
+/** Emitted when enforceExpiry() auto-expires a session. */
+export interface ImpersonationSessionExpiredEvent extends BaseEvent {
+  type: 'impersonation.session.expired'
+  data: {
+    sessionId: string
+    expiredAt: string
+  }
+}
+
+export type ImpersonationSseEvent =
+  | ImpersonationSessionSnapshotEvent
+  | ImpersonationSessionStartedEvent
+  | ImpersonationSessionEndedEvent
+  | ImpersonationSessionExpiredEvent

package/src/index.ts

@@ -238,6 +238,13 @@ export type {
   PromotionRequest,
   PromotionRecord,
   PromotionReadinessResult,
+  // Strategy domain types (PRD-00173)
+  StrategyVisibility,
+  StrategyDocLevel,
+  StrategySource,
+  StrategyDependency,
+  StrategyTreeNode,
+  StrategyDoc,
 } from './org/index'
 
 export { ROLE_DISPLAY_MAP, WORKSPACE_CAPABILITIES, ROLE_CAPABILITY_MAP, VIEW_SCOPE_MAP, getViewScope, TRANSFER_RESPONSIBILITIES, IDENTITY_TRUST_LEVEL_LABELS, MANAGEMENT_TIER_LABELS } from './org/index'
@@ -430,6 +437,16 @@ export type {
 
 export { RESTRICTED_IMPERSONATION_ACTIONS } from './impersonation'
 
+// Impersonation SSE event types (real-time push)
+// @see PRD-00176 for design rationale
+export type {
+  ImpersonationSessionSnapshotEvent,
+  ImpersonationSessionStartedEvent,
+  ImpersonationSessionEndedEvent,
+  ImpersonationSessionExpiredEvent,
+  ImpersonationSseEvent,
+} from './impersonation-events'
+
 // Usage tracking types (internal admin)
 // @see PRD-00166 for design rationale
 export type {

package/src/org/index.ts

@@ -72,3 +72,13 @@ export type {
 // View authorization scopes (Phase 5 - ADR-APP-013)
 export type { AuthorizableView } from './view-scopes';
 export { VIEW_SCOPE_MAP, getViewScope } from './view-scopes';
+
+// Strategy domain types (PRD-00173)
+export type {
+  StrategyVisibility,
+  StrategyDocLevel,
+  StrategySource,
+  StrategyDependency,
+  StrategyTreeNode,
+  StrategyDoc,
+} from './strategy';

package/src/org/strategy.ts

@@ -0,0 +1,53 @@
+/**
+ * Strategy Domain Types
+ *
+ * Vocabulary types for the Company.md strategy feature.
+ * Shared between backend (persistence/service) and app (UI rendering).
+ * @see PRD-00173 for design rationale
+ */
+
+export type StrategyVisibility = 'public' | 'private';
+
+export type StrategyDocLevel = 'root' | 'department';
+
+export interface StrategySource {
+  readonly label: string;
+  readonly sourceType: 'meeting' | 'document' | 'conversation' | 'manual';
+  readonly referencedAt: string;
+}
+
+export interface StrategyDependency {
+  readonly targetSlug: string;
+  readonly description: string;
+}
+
+export interface StrategyTreeNode {
+  readonly id: string;
+  readonly slug: string;
+  readonly title: string;
+  readonly level: StrategyDocLevel;
+  readonly department: string | null;
+  readonly visibility: StrategyVisibility;
+  readonly canEdit: boolean;
+  readonly memberCount: number;
+}
+
+export interface StrategyDoc {
+  readonly id: string;
+  readonly slug: string;
+  readonly title: string;
+  readonly level: StrategyDocLevel;
+  readonly department: string | null;
+  readonly content: string;
+  readonly visibility: StrategyVisibility;
+  readonly parentId: string | null;
+  readonly owner: { readonly id: string; readonly name: string } | null;
+  readonly coOwners: ReadonlyArray<{ readonly id: string; readonly name: string }>;
+  readonly canEdit: boolean;
+  readonly inheritsFrom: string | null;
+  readonly sources: readonly StrategySource[];
+  readonly dependencies: readonly StrategyDependency[];
+  readonly members: ReadonlyArray<{ readonly id: string; readonly name: string }>;
+  readonly createdAt: string;
+  readonly updatedAt: string;
+}