@sparkleideas/claims 3.5.2-patch.1

package/src/domain/index.ts

@@ -0,0 +1,214 @@
+/**
+ * Claims Domain Layer (ADR-016)
+ *
+ * Exports all domain types, events, rules, and repository interfaces
+ * for the issue claiming system.
+ *
+ * @module v3/claims/domain
+ */
+
+// =============================================================================
+// Core Types (from types.ts)
+// =============================================================================
+
+export type {
+  // Core identifiers
+  ClaimId,
+  IssueId,
+  ClaimantType,
+  ClaimStatus,
+  IssueLabel,
+  IssuePriority,
+  IssueComplexity,
+
+  // Value objects
+  Duration,
+
+  // Entities
+  Claimant,
+  Issue,
+  IssueClaim,
+  HandoffRecord,
+  IssueWithClaim,
+  ClaimResult,
+
+  // Query types
+  IssueFilters,
+
+  // Error types
+  ClaimErrorCode,
+  ClaimError,
+
+  // Work stealing types
+  AgentType,
+  StealableReason,
+  StealableInfo,
+  StealErrorCode,
+  StealResult,
+  ContestInfo,
+  ContestResolution,
+  WorkStealingConfig,
+  IssueClaimWithStealing,
+  WorkStealingEventType,
+  WorkStealingEvent,
+
+  // ADR-016 extended types
+  ExtendedClaimStatus,
+  AgentId,
+  UserId,
+  BlockedReason,
+  BlockedInfo,
+  StealReason,
+  ExtendedStealableInfo,
+  HandoffReason,
+  ExtendedHandoffInfo,
+  ClaimantWorkload,
+  ExtendedClaimant,
+  AgentLoadInfo,
+  ClaimMove,
+  RebalanceError,
+  ExtendedRebalanceResult,
+  RebalanceStrategy,
+  LoadBalancingConfig,
+  ExtendedIssueClaim,
+  ClaimNote,
+  StatusChange,
+  ClaimQueryOptions,
+  ClaimStatistics,
+
+  // Repository interfaces
+  IIssueClaimRepository,
+  IWorkStealingEventBus,
+} from './types.js';
+
+export {
+  // Utility functions
+  durationToMs,
+  generateClaimId,
+  isActiveClaimStatus,
+  getValidStatusTransitions,
+
+  // Classes
+  ClaimOperationError,
+
+  // Constants
+  DEFAULT_WORK_STEALING_CONFIG,
+  DEFAULT_LOAD_BALANCING_CONFIG,
+} from './types.js';
+
+// =============================================================================
+// Domain Events (from events.ts)
+// =============================================================================
+
+export type {
+  // Base event types
+  ClaimDomainEvent,
+  ClaimEventType,
+  AllClaimEvents,
+
+  // Claim lifecycle events
+  ClaimCreatedEvent,
+  ClaimReleasedEvent,
+  ClaimExpiredEvent,
+  ClaimStatusChangedEvent,
+  ClaimNoteAddedEvent,
+
+  // Handoff events
+  HandoffRequestedEvent,
+  HandoffAcceptedEvent,
+  HandoffRejectedEvent,
+
+  // Review events
+  ReviewRequestedEvent,
+  ReviewCompletedEvent,
+
+  // ADR-016 extended event types
+  ExtendedClaimEventType,
+  ExtendedClaimDomainEvent,
+  IssueMarkedStealableEvent,
+  IssueStolenEvent,
+  StealContestStartedEvent,
+  StealContestResolvedExtEvent,
+  StealWarningEvent,
+  SwarmRebalancedExtEvent,
+  AgentOverloadedExtEvent,
+  AgentUnderloadedExtEvent,
+  AgentLoadChangedEvent,
+  AllExtendedClaimEvents,
+} from './events.js';
+
+export {
+  // Event factory functions
+  createClaimCreatedEvent,
+  createClaimReleasedEvent,
+  createClaimExpiredEvent,
+  createClaimStatusChangedEvent,
+  createClaimNoteAddedEvent,
+  createHandoffRequestedEvent,
+  createHandoffAcceptedEvent,
+  createHandoffRejectedEvent,
+  createReviewRequestedEvent,
+  createReviewCompletedEvent,
+
+  // ADR-016 extended event factories
+  createIssueMarkedStealableEvent,
+  createIssueStolenExtEvent,
+  createSwarmRebalancedExtEvent,
+  createAgentOverloadedExtEvent,
+  createAgentUnderloadedExtEvent,
+} from './events.js';
+
+// =============================================================================
+// Repository Interfaces (from repositories.ts)
+// =============================================================================
+
+export type {
+  IClaimRepository,
+  IIssueRepository,
+  IClaimantRepository,
+  IClaimEventStore,
+} from './repositories.js';
+
+// =============================================================================
+// Business Rules (from rules.ts)
+// =============================================================================
+
+export type {
+  RuleResult,
+} from './rules.js';
+
+export {
+  // Result helpers
+  ruleSuccess,
+  ruleFailure,
+
+  // Claim eligibility rules
+  canClaimIssue,
+  isIssueClaimed,
+  isActiveClaim,
+  getOriginalStatusTransitions,
+  getExtendedStatusTransitions,
+  canTransitionStatus,
+
+  // Work stealing rules
+  canMarkAsStealable,
+  canStealClaim,
+  requiresStealContest,
+
+  // Handoff rules
+  canInitiateHandoff,
+  canAcceptHandoff,
+  canRejectHandoff,
+
+  // Load balancing rules
+  isAgentOverloaded,
+  isAgentUnderloaded,
+  needsRebalancing,
+  canMoveClaim,
+
+  // Validation rules
+  isValidPriority,
+  isValidStatus,
+  isValidExtendedStatus,
+  isValidRepository,
+} from './rules.js';

package/src/domain/repositories.ts

@@ -0,0 +1,239 @@
+/**
+ * Claim Repository Interfaces
+ *
+ * Repository interfaces for the claims domain following DDD patterns.
+ *
+ * @module v3/claims/domain/repositories
+ */
+
+import {
+  ClaimId,
+  IssueId,
+  Claimant,
+  ClaimStatus,
+  Issue,
+  IssueClaim,
+  IssueFilters,
+  HandoffRecord,
+} from './types.js';
+
+// =============================================================================
+// Claim Repository Interface
+// =============================================================================
+
+/**
+ * Repository for managing issue claims
+ */
+export interface IClaimRepository {
+  // ==========================================================================
+  // CRUD Operations
+  // ==========================================================================
+
+  /**
+   * Save a new claim or update an existing one
+   */
+  save(claim: IssueClaim): Promise<void>;
+
+  /**
+   * Find a claim by its ID
+   */
+  findById(claimId: ClaimId): Promise<IssueClaim | null>;
+
+  /**
+   * Find the active claim for an issue
+   */
+  findByIssueId(issueId: IssueId): Promise<IssueClaim | null>;
+
+  /**
+   * Find all claims for a specific claimant
+   */
+  findByClaimant(claimant: Claimant): Promise<IssueClaim[]>;
+
+  /**
+   * Find claims by status
+   */
+  findByStatus(status: ClaimStatus): Promise<IssueClaim[]>;
+
+  /**
+   * Delete a claim
+   */
+  delete(claimId: ClaimId): Promise<void>;
+
+  // ==========================================================================
+  // Query Operations
+  // ==========================================================================
+
+  /**
+   * Find all active claims
+   */
+  findActiveClaims(): Promise<IssueClaim[]>;
+
+  /**
+   * Find stale claims (claims with no activity past a threshold)
+   */
+  findStaleClaims(staleSince: Date): Promise<IssueClaim[]>;
+
+  /**
+   * Find claims with pending handoffs
+   */
+  findClaimsWithPendingHandoffs(): Promise<IssueClaim[]>;
+
+  /**
+   * Count claims by claimant
+   */
+  countByClaimant(claimantId: string): Promise<number>;
+
+  // ==========================================================================
+  // Lifecycle
+  // ==========================================================================
+
+  /**
+   * Initialize the repository
+   */
+  initialize(): Promise<void>;
+
+  /**
+   * Shutdown the repository
+   */
+  shutdown(): Promise<void>;
+}
+
+// =============================================================================
+// Issue Repository Interface
+// =============================================================================
+
+/**
+ * Repository for accessing issues
+ */
+export interface IIssueRepository {
+  // ==========================================================================
+  // CRUD Operations
+  // ==========================================================================
+
+  /**
+   * Find an issue by its ID
+   */
+  findById(issueId: IssueId): Promise<Issue | null>;
+
+  /**
+   * Find issues matching filters
+   */
+  findByFilters(filters: IssueFilters): Promise<Issue[]>;
+
+  /**
+   * Find all unclaimed issues matching filters
+   */
+  findAvailable(filters?: IssueFilters): Promise<Issue[]>;
+
+  /**
+   * Check if an issue exists
+   */
+  exists(issueId: IssueId): Promise<boolean>;
+
+  // ==========================================================================
+  // Lifecycle
+  // ==========================================================================
+
+  /**
+   * Initialize the repository
+   */
+  initialize(): Promise<void>;
+
+  /**
+   * Shutdown the repository
+   */
+  shutdown(): Promise<void>;
+}
+
+// =============================================================================
+// Claimant Repository Interface
+// =============================================================================
+
+/**
+ * Repository for managing claimants
+ */
+export interface IClaimantRepository {
+  // ==========================================================================
+  // CRUD Operations
+  // ==========================================================================
+
+  /**
+   * Find a claimant by ID
+   */
+  findById(claimantId: string): Promise<Claimant | null>;
+
+  /**
+   * Find claimants by type
+   */
+  findByType(type: 'human' | 'agent'): Promise<Claimant[]>;
+
+  /**
+   * Find claimants with specific capabilities
+   */
+  findByCapabilities(capabilities: string[]): Promise<Claimant[]>;
+
+  /**
+   * Get all available claimants (not at max workload)
+   */
+  findAvailable(): Promise<Claimant[]>;
+
+  /**
+   * Check if a claimant exists
+   */
+  exists(claimantId: string): Promise<boolean>;
+
+  // ==========================================================================
+  // Lifecycle
+  // ==========================================================================
+
+  /**
+   * Initialize the repository
+   */
+  initialize(): Promise<void>;
+
+  /**
+   * Shutdown the repository
+   */
+  shutdown(): Promise<void>;
+}
+
+// =============================================================================
+// Event Store Interface (for domain events)
+// =============================================================================
+
+import { AllClaimEvents, ClaimDomainEvent } from './events.js';
+
+/**
+ * Event store interface for claim domain events
+ */
+export interface IClaimEventStore {
+  /**
+   * Append a new event to the store
+   */
+  append(event: ClaimDomainEvent): Promise<void>;
+
+  /**
+   * Get events for a specific claim
+   */
+  getEvents(claimId: ClaimId, fromVersion?: number): Promise<ClaimDomainEvent[]>;
+
+  /**
+   * Get events by type
+   */
+  getEventsByType(type: string): Promise<ClaimDomainEvent[]>;
+
+  /**
+   * Get events for an issue across all claims
+   */
+  getEventsByIssueId(issueId: IssueId): Promise<ClaimDomainEvent[]>;
+
+  /**
+   * Initialize the event store
+   */
+  initialize(): Promise<void>;
+
+  /**
+   * Shutdown the event store
+   */
+  shutdown(): Promise<void>;
+}