@obora/runtime 0.1.0

package/dist/_legacy/blackboard/events/types.d.ts

@@ -0,0 +1,554 @@
+/**
+ * @module events/types
+ * @description 이벤트 타입 정의 - Blackboard Event Bus용 이벤트 타입
+ */
+import type { AgentId, TaskId, AgendaId } from '../types';
+import type { Agenda as DomainAgenda, AgendaStatus as DomainAgendaStatus } from '../domains/agenda/types';
+import { BoardPhase, AgentStatus, TaskError, TaskStatus, AgendaStatus, Task, Agenda, Opinion, Resolution, Fact, Inference, Pattern } from '../types';
+export type { BoardPhase, AgentStatus, TaskStatus, AgendaStatus, Task, Agenda, Opinion, Resolution, Fact, Inference, Pattern, TaskError, };
+/**
+ * 이벤트 카테고리
+ */
+export type EventCategory = 'state' | 'knowledge' | 'decision' | 'task' | 'agent' | 'agenda' | 'system';
+/**
+ * 기본 이벤트 인터페이스
+ */
+export interface BaseEvent {
+    /** 이벤트 ID (고유) */
+    readonly id: string;
+    /** 이벤트 타입 (예: 'state.phase.changed') */
+    readonly type: string;
+    /** 발생 시간 */
+    readonly timestamp: Date;
+    /** 발생 소스 (에이전트 ID 또는 'system') */
+    readonly source: AgentId | 'system';
+    /** 상관 ID (관련 이벤트 추적용) */
+    readonly correlationId?: string;
+}
+/**
+ * 단계 변경 이벤트
+ */
+export interface PhaseChangedEvent extends BaseEvent {
+    type: 'state.phase.changed';
+    payload: {
+        previousPhase: BoardPhase;
+        newPhase: BoardPhase;
+    };
+}
+/**
+ * 컨텍스트 업데이트 이벤트
+ */
+export interface ContextUpdatedEvent extends BaseEvent {
+    type: 'state.context.updated';
+    payload: {
+        key: string;
+        previousValue: unknown;
+        newValue: unknown;
+    };
+}
+/**
+ * 에이전트 등록 이벤트 (spec 호환)
+ */
+export interface StateAgentRegisteredEvent extends BaseEvent {
+    type: 'state.agent.registered';
+    payload: {
+        agent: AgentStatus;
+    };
+}
+/**
+ * 에이전트 업데이트 이벤트 (spec 호환)
+ */
+export interface StateAgentUpdatedEvent extends BaseEvent {
+    type: 'state.agent.updated';
+    payload: {
+        agentId: AgentId;
+        previousStatus: AgentStatus;
+        newStatus: AgentStatus;
+    };
+}
+/**
+ * 작업 생성 이벤트 (spec 호환)
+ */
+export interface StateTaskCreatedEvent extends BaseEvent {
+    type: 'state.task.created';
+    payload: {
+        task: Task;
+    };
+}
+/**
+ * 작업 할당 이벤트 (spec 호환)
+ */
+export interface StateTaskAssignedEvent extends BaseEvent {
+    type: 'state.task.assigned';
+    payload: {
+        taskId: TaskId;
+        assignedTo: AgentId;
+    };
+}
+/**
+ * 작업 완료 이벤트 (spec 호환)
+ */
+export interface StateTaskCompletedEvent extends BaseEvent {
+    type: 'state.task.completed';
+    payload: {
+        taskId: TaskId;
+        result: unknown;
+        duration: number;
+    };
+}
+/**
+ * 작업 실패 이벤트 (spec 호환)
+ */
+export interface StateTaskFailedEvent extends BaseEvent {
+    type: 'state.task.failed';
+    payload: {
+        taskId: TaskId;
+        error: TaskError;
+        retryable: boolean;
+    };
+}
+/**
+ * 에이전트 등록 이벤트
+ */
+export interface AgentRegisteredEvent extends BaseEvent {
+    type: 'state.agent.registered';
+    payload: {
+        agent: AgentStatus;
+    };
+}
+/**
+ * 에이전트 상태 변경 이벤트
+ */
+export interface AgentStatusChangedEvent extends BaseEvent {
+    type: 'agent.status.changed';
+    payload: {
+        agentId: AgentId;
+        previousStatus: AgentStatus;
+        newStatus: AgentStatus;
+    };
+}
+/**
+ * 에이전트 업데이트 이벤트 (테스트 호환)
+ */
+export interface AgentUpdatedEvent extends BaseEvent {
+    type: 'state.agent.updated';
+    payload: {
+        agentId: AgentId;
+        changes: Partial<AgentStatus>;
+        previousValues: Partial<AgentStatus>;
+    };
+}
+/**
+ * 에이전트 제거 이벤트
+ */
+export interface AgentRemovedEvent extends BaseEvent {
+    type: 'state.agent.removed';
+    payload: {
+        agentId: AgentId;
+        reason: string;
+    };
+}
+/**
+ * 작업 생성 이벤트
+ */
+export interface TaskCreatedEvent extends BaseEvent {
+    type: 'task.created';
+    payload: {
+        task: Task;
+    };
+}
+/**
+ * 작업 할당 이벤트
+ */
+export interface TaskAssignedEvent extends BaseEvent {
+    type: 'task.assigned';
+    payload: {
+        taskId: TaskId;
+        assignedTo: AgentId;
+    };
+}
+/**
+ * 작업 상태 변경 이벤트
+ */
+export interface TaskStatusChangedEvent extends BaseEvent {
+    type: 'task.status.changed';
+    payload: {
+        taskId: TaskId;
+        previousStatus: TaskStatus;
+        newStatus: TaskStatus;
+    };
+}
+/**
+ * 작업 완료 이벤트
+ */
+export interface TaskCompletedEvent extends BaseEvent {
+    type: 'task.completed';
+    payload: {
+        taskId: TaskId;
+        outputs: unknown;
+        duration: number;
+    };
+}
+/**
+ * 작업 실패 이벤트
+ */
+export interface TaskFailedEvent extends BaseEvent {
+    type: 'task.failed';
+    payload: {
+        taskId: TaskId;
+        error: TaskError;
+        duration: number;
+    };
+}
+/**
+ * 작업 시작 이벤트
+ */
+export interface TaskStartedEvent extends BaseEvent {
+    type: 'task.started';
+    payload: {
+        taskId: TaskId;
+        agentId: AgentId;
+        startedAt: Date;
+    };
+}
+/**
+ * 작업 취소 이벤트
+ */
+export interface TaskCancelledEvent extends BaseEvent {
+    type: 'task.cancelled';
+    payload: {
+        taskId: TaskId;
+        reason: string;
+    };
+}
+/**
+ * 안건 생성 이벤트 (spec 호환)
+ */
+export interface DecisionsAgendaCreatedEvent extends BaseEvent {
+    type: 'decisions.agenda.created';
+    payload: {
+        agenda: Agenda;
+    };
+}
+/**
+ * 안건 시작 이벤트 (spec 호환)
+ */
+export interface DecisionsAgendaStartedEvent extends BaseEvent {
+    type: 'decisions.agenda.started';
+    payload: {
+        agendaId: AgendaId;
+    };
+}
+/**
+ * 의견 제출 이벤트 (spec 호환)
+ */
+export interface DecisionsOpinionSubmittedEvent extends BaseEvent {
+    type: 'decisions.opinion.submitted';
+    payload: {
+        opinion: Opinion;
+    };
+}
+/**
+ * 투표 시작 이벤트 (spec 호환)
+ */
+export interface DecisionsVotingStartedEvent extends BaseEvent {
+    type: 'decisions.voting.started';
+    payload: {
+        agendaId: AgendaId;
+        deadline: Date;
+    };
+}
+/**
+ * 투표 제출 이벤트 (spec 호환)
+ */
+export interface DecisionsVoteSubmittedEvent extends BaseEvent {
+    type: 'decisions.vote.submitted';
+    payload: {
+        agendaId: AgendaId;
+        agentId: AgentId;
+        vote: 'approve' | 'reject' | 'abstain';
+    };
+}
+/**
+ * 투표 종료 이벤트 (spec 호환)
+ */
+export interface DecisionsVotingEndedEvent extends BaseEvent {
+    type: 'decisions.voting.ended';
+    payload: {
+        agendaId: AgendaId;
+        result: Resolution;
+    };
+}
+/**
+ * 합의 도달 이벤트 (spec 호환)
+ */
+export interface DecisionsConsensusReachedEvent extends BaseEvent {
+    type: 'decisions.consensus.reached';
+    payload: {
+        resolution: Resolution;
+    };
+}
+/**
+ * 안건 해결 이벤트 (spec 호환)
+ */
+export interface DecisionsAgendaResolvedEvent extends BaseEvent {
+    type: 'decisions.agenda.resolved';
+    payload: {
+        agendaId: AgendaId;
+        resolution: Resolution;
+    };
+}
+/**
+ * 안건 제출 이벤트 (기존 호환성 유지)
+ */
+export interface AgendaSubmittedEvent extends BaseEvent {
+    type: 'decision.agenda.submitted';
+    payload: {
+        agenda: Agenda;
+    };
+}
+/**
+ * 안건 상태 변경 이벤트
+ */
+export interface AgendaStatusChangedEvent extends BaseEvent {
+    type: 'decision.agenda.status_changed';
+    payload: {
+        agendaId: AgendaId;
+        previousStatus: AgendaStatus;
+        newStatus: AgendaStatus;
+    };
+}
+/**
+ * 의견 제출 이벤트
+ */
+export interface OpinionSubmittedEvent extends BaseEvent {
+    type: 'decision.opinion.submitted';
+    payload: {
+        opinion: Opinion;
+    };
+}
+/**
+ * 투표 요청 이벤트
+ */
+export interface VoteRequestedEvent extends BaseEvent {
+    type: 'decision.vote.requested';
+    payload: {
+        agendaId: AgendaId;
+        deadline: Date;
+        requiredVoters: AgentId[];
+    };
+}
+/**
+ * 합의 도달 이벤트
+ */
+export interface ConsensusReachedEvent extends BaseEvent {
+    type: 'decision.consensus.reached';
+    payload: {
+        resolution: Resolution;
+    };
+}
+/**
+ * 투표 완료 이벤트
+ */
+export interface VotingCompletedEvent extends BaseEvent {
+    type: 'decision.voting.completed';
+    payload: {
+        agendaId: AgendaId;
+        result: {
+            passed: boolean;
+            method: string;
+            summary: {
+                total: number;
+                approve: number;
+                reject: number;
+                abstain: number;
+                approvalRate: number;
+                quorumReached: boolean;
+            };
+        };
+    };
+}
+/**
+ * Agenda 생성 이벤트
+ */
+export interface AgendaCreatedDomainEvent extends BaseEvent {
+    type: 'agenda.created';
+    payload: {
+        agenda: DomainAgenda;
+    };
+}
+/**
+ * Agenda 수정 이벤트
+ */
+export interface AgendaUpdatedDomainEvent extends BaseEvent {
+    type: 'agenda.updated';
+    payload: {
+        agendaId: AgendaId;
+        previous: DomainAgenda;
+        current: DomainAgenda;
+    };
+}
+/**
+ * Agenda 상태 변경 이벤트
+ */
+export interface AgendaStatusChangedDomainEvent extends BaseEvent {
+    type: 'agenda.status.changed';
+    payload: {
+        agendaId: AgendaId;
+        previousStatus: DomainAgendaStatus;
+        newStatus: DomainAgendaStatus;
+    };
+}
+/**
+ * Agenda 삭제 이벤트
+ */
+export interface AgendaDeletedDomainEvent extends BaseEvent {
+    type: 'agenda.deleted';
+    payload: {
+        agendaId: AgendaId;
+        deleted: DomainAgenda;
+    };
+}
+/**
+ * 사실 추가 이벤트
+ */
+export interface FactAddedEvent extends BaseEvent {
+    type: 'knowledge.fact.added';
+    payload: {
+        fact: Fact;
+    };
+}
+/**
+ * 추론 추가 이벤트
+ */
+export interface InferenceAddedEvent extends BaseEvent {
+    type: 'knowledge.inference.added';
+    payload: {
+        inference: Inference;
+    };
+}
+/**
+ * 패턴 학습 이벤트 (spec 호환)
+ */
+export interface KnowledgePatternLearnedEvent extends BaseEvent {
+    type: 'knowledge.pattern.learned';
+    payload: {
+        pattern: Pattern;
+    };
+}
+/**
+ * 사실 업데이트 이벤트
+ */
+export interface FactUpdatedEvent extends BaseEvent {
+    type: 'knowledge.fact.updated';
+    payload: {
+        factId: string;
+        changes: Partial<Fact>;
+        previousValues?: Partial<Fact>;
+    };
+}
+/**
+ * 사실 제거 이벤트
+ */
+export interface FactRemovedEvent extends BaseEvent {
+    type: 'knowledge.fact.removed';
+    payload: {
+        factId: string;
+        reason: string;
+    };
+}
+/**
+ * 패턴 추가 이벤트
+ */
+export interface PatternAddedEvent extends BaseEvent {
+    type: 'knowledge.pattern.added';
+    payload: {
+        pattern: Pattern;
+    };
+}
+/**
+ * 스냅샷 생성 이벤트 (spec 호환)
+ */
+export interface SystemSnapshotCreatedEvent extends BaseEvent {
+    type: 'system.snapshot.created';
+    payload: {
+        snapshotId: string;
+        timestamp: Date;
+    };
+}
+/**
+ * 스냅샷 복원 이벤트 (spec 호환)
+ */
+export interface SystemSnapshotRestoredEvent extends BaseEvent {
+    type: 'system.snapshot.restored';
+    payload: {
+        snapshotId: string;
+        timestamp: Date;
+    };
+}
+/**
+ * 상태 초기화 이벤트
+ */
+export interface StateInitializedEvent extends BaseEvent {
+    type: 'state.initialized';
+    payload: {
+        sessionId: string;
+    };
+}
+/**
+ * 스냅샷 생성 이벤트 (테스트 호환)
+ */
+export interface SnapshotCreatedEvent extends BaseEvent {
+    type: 'snapshot.created';
+    payload: {
+        snapshotId: string;
+        version: number;
+    };
+}
+/**
+ * 스냅샷 복원 이벤트 (테스트 호환)
+ */
+export interface SnapshotRestoredEvent extends BaseEvent {
+    type: 'snapshot.restored';
+    payload: {
+        snapshotId: string;
+        previousVersion: number;
+        restoredVersion: number;
+    };
+}
+/**
+ * 시스템 오류 이벤트
+ */
+export interface SystemErrorEvent extends BaseEvent {
+    type: 'system.error';
+    payload: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * 버전 충돌 이벤트
+ */
+export interface VersionConflictEvent extends BaseEvent {
+    type: 'system.version.conflict';
+    payload: {
+        path: string;
+        expectedVersion: number;
+        actualVersion: number;
+    };
+}
+/**
+ * 모든 이벤트 타입 유니온
+ */
+export type Event = PhaseChangedEvent | ContextUpdatedEvent | StateAgentRegisteredEvent | StateAgentUpdatedEvent | StateTaskCreatedEvent | StateTaskAssignedEvent | StateTaskCompletedEvent | StateTaskFailedEvent | AgentRegisteredEvent | AgentStatusChangedEvent | AgentUpdatedEvent | AgentRemovedEvent | TaskCreatedEvent | TaskAssignedEvent | TaskStartedEvent | TaskStatusChangedEvent | TaskCompletedEvent | TaskFailedEvent | TaskCancelledEvent | DecisionsAgendaCreatedEvent | DecisionsAgendaStartedEvent | DecisionsOpinionSubmittedEvent | DecisionsVotingStartedEvent | DecisionsVoteSubmittedEvent | DecisionsVotingEndedEvent | DecisionsConsensusReachedEvent | DecisionsAgendaResolvedEvent | AgendaSubmittedEvent | AgendaStatusChangedEvent | OpinionSubmittedEvent | VoteRequestedEvent | ConsensusReachedEvent | VotingCompletedEvent | AgendaCreatedDomainEvent | AgendaUpdatedDomainEvent | AgendaStatusChangedDomainEvent | AgendaDeletedDomainEvent | FactAddedEvent | FactUpdatedEvent | FactRemovedEvent | InferenceAddedEvent | KnowledgePatternLearnedEvent | PatternAddedEvent | SystemSnapshotCreatedEvent | SystemSnapshotRestoredEvent | SystemErrorEvent | VersionConflictEvent | StateInitializedEvent | SnapshotCreatedEvent | SnapshotRestoredEvent;
+/**
+ * 이벤트 타입 문자열 유니온
+ */
+export type EventType = Event['type'];
+/**
+ * 이벤트 타입에서 이벤트 추출
+ */
+export type EventByType<T extends EventType> = Extract<Event, {
+    type: T;
+}>;

package/dist/_legacy/blackboard/snapshot/compression.d.ts

@@ -0,0 +1,170 @@
+/**
+ * @module snapshot/compression
+ * @description 압축 유틸리티 (브라우저/Node.js 호환)
+ */
+/**
+ * 압축 알고리즘
+ * @note brotli는 pako에서 지원하지 않음
+ */
+export type CompressionAlgorithm = 'gzip' | 'none';
+/**
+ * 압축 레벨 (테스트 호환 타입)
+ */
+export type CompressionLevel = 'none' | 'fast' | 'balanced' | 'max';
+/**
+ * 내부 pako 압축 레벨 숫자 타입
+ */
+type PakoCompressionLevel = -1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+/**
+ * 압축 옵션
+ */
+export interface CompressionOptions {
+    /** 알고리즘 (기본: 'gzip') */
+    algorithm?: CompressionAlgorithm;
+    /** 압축 레벨 (기본: 'balanced') */
+    level?: CompressionLevel | PakoCompressionLevel;
+    /** 출력 형식 (기본: 'base64') */
+    outputFormat?: 'base64' | 'buffer' | 'uint8array';
+    /** 메타데이터 포함 여부 */
+    includeMetadata?: boolean;
+}
+/**
+ * 압축 해제 옵션
+ */
+export interface DecompressionOptions {
+    /** 압축 알고리즘 */
+    algorithm?: CompressionAlgorithm;
+    /** 입력 형식 (기본: 'base64') */
+    inputFormat?: 'base64' | 'buffer' | 'uint8array';
+    /** 유효성 검사 건너뛰기 (algorithm='none'인 경우 자동 true) */
+    skipValidation?: boolean;
+}
+/**
+ * 압축 메타데이터
+ */
+export interface CompressionMetadata {
+    /** 원본 크기 */
+    originalSize: number;
+    /** 압축된 크기 */
+    compressedSize: number;
+    /** 사용된 알고리즘 */
+    algorithm: CompressionAlgorithm;
+    /** 사용된 압축 레벨 */
+    level: CompressionLevel | PakoCompressionLevel;
+    /** 타임스탬프 */
+    timestamp: string;
+}
+/**
+ * 메타데이터가 포함된 압축 결과
+ */
+export interface CompressedWithMeta {
+    /** 압축된 데이터 */
+    data: string;
+    /** 메타데이터 */
+    metadata: CompressionMetadata;
+}
+/**
+ * 압축 통계
+ */
+export interface CompressionStats {
+    /** 원본 크기 */
+    originalSize: number;
+    /** 압축된 크기 */
+    compressedSize: number;
+    /** 압축 비율 (originalSize / compressedSize) */
+    ratio: number;
+    /** 절감된 크기 (bytes) */
+    savings: number;
+    /** 절감 비율 (%) */
+    savingsPercent: number;
+}
+/**
+ * 데이터 압축
+ * @param data - 압축할 데이터 (string | Uint8Array | Buffer)
+ * @param options - 압축 옵션
+ * @returns 압축된 데이터 (string | Uint8Array | Buffer)
+ */
+export declare function compress(data: string | Uint8Array | Buffer, options?: CompressionOptions): string | Uint8Array | Buffer;
+/**
+ * 데이터 압축 해제
+ * @param compressed - 압축된 데이터
+ * @param options - 압축 해제 옵션
+ * @returns 원본 데이터
+ * @throws {Error} 데이터 크기 제한 초과 시
+ */
+export declare function decompress(compressed: string | Uint8Array | Buffer, options?: DecompressionOptions): string | Uint8Array | Buffer;
+/**
+ * 압축 여부 감지
+ * @param data - 검사할 데이터
+ * @returns 압축 알고리즘 또는 null
+ */
+export declare function detectCompression(data: string): CompressionAlgorithm | null;
+/**
+ * 체크섬 계산 (비동기)
+ */
+export declare function calculateChecksumAsync(data: string): Promise<string>;
+/**
+ * 체크섬 검증
+ */
+export declare function verifyChecksum(data: string, expectedChecksum: string): Promise<boolean>;
+/**
+ * Compressor 클래스 - 상태 저장형 압축
+ */
+export declare class Compressor {
+    private options;
+    private history;
+    constructor(options?: CompressionOptions);
+    /**
+     * 데이터 압축
+     */
+    compress(data: string | Uint8Array | Buffer): Uint8Array;
+    /**
+     * 데이터 압축 해제
+     */
+    decompress(data: Uint8Array): string;
+    /**
+     * 비동기 압축
+     */
+    compressAsync(data: string | Uint8Array | Buffer): Promise<Uint8Array>;
+    /**
+     * 비동기 압축 해제
+     */
+    decompressAsync(data: Uint8Array): Promise<string>;
+    /**
+     * 압축 비율 계산
+     */
+    ratio(originalSize: number, compressedSize: number): number;
+    /**
+     * 압축 통계 계산
+     */
+    stats(originalSize: number, compressedSize: number): CompressionStats;
+    /**
+     * 내부 통계 계산
+     */
+    private calculateStatsInternal;
+    /**
+     * 메타데이터 포함 압축
+     */
+    compressWithMeta(data: string | Uint8Array | Buffer): CompressedWithMeta;
+    /**
+     * 메타데이터 포함 압축 해제
+     */
+    decompressWithMeta(compressed: CompressedWithMeta | string): string;
+    /**
+     * 기록된 압축 통계 가져오기
+     */
+    getHistory(): CompressionStats[];
+    /**
+     * 기록된 통계 지우기
+     */
+    clearHistory(): void;
+    /**
+     * 옵션 업데이트
+     */
+    setOptions(options: Partial<CompressionOptions>): void;
+    /**
+     * 현재 옵션 가져오기
+     */
+    getOptions(): CompressionOptions;
+}
+export {};