@lcv-ideas-software/cross-review 4.0.8 → 4.1.0

package/dist/src/core/session-store.d.ts

@@ -3,6 +3,7 @@ export declare const SWEEP_MIN_IDLE_MS: number;
 export declare class SessionStore {
     private readonly config;
     private readonly seqCache;
+    private readonly pendingEventWrites;
     constructor(config: AppConfig);
     sessionsDir(): string;
     sessionDir(sessionId: string): string;
@@ -11,20 +12,20 @@ export declare class SessionStore {
     assertSessionId(sessionId: string): void;
     private isPathContained;
     private processAlive;
-    private sleepSync;
     private totalsFor;
     private withSessionLock;
-    init(task: string, caller: PeerId | "operator", snapshot: PeerProbeResult[], reviewFocus?: string): SessionMeta;
+    init(task: string, caller: PeerId | "operator", snapshot: PeerProbeResult[], reviewFocus?: string): Promise<SessionMeta>;
     markInFlight(sessionId: string, params: {
         round: number;
         peers: PeerId[];
         started_at: string;
         scope: ConvergenceScope;
-    }): SessionMeta;
+    }): Promise<SessionMeta>;
     read(sessionId: string): SessionMeta;
     private peekNextSeq;
     private commitSeq;
-    appendEvent(event: RuntimeEvent): void;
+    appendEvent(event: RuntimeEvent): Promise<void>;
+    flushPendingEvents(): Promise<void>;
     readEvents(sessionId: string, sinceSeq?: number): SessionEvent[];
     list(): SessionMeta[];
     pruneOldSessions(maxAgeDays?: number): {
@@ -33,11 +34,11 @@ export declare class SessionStore {
     };
     savePrompt(sessionId: string, round: number, prompt: string): string;
     saveDraft(sessionId: string, round: number, draft: string): string;
-    saveGeneration(sessionId: string, round: number, result: GenerationResult, label?: string): string;
+    saveGeneration(sessionId: string, round: number, result: GenerationResult, label?: string): Promise<string>;
     saveFinal(sessionId: string, text: string): string;
     saveReport(sessionId: string, text: string): string;
-    savePeerResult(sessionId: string, round: number, result: PeerResult, label?: string): string;
-    savePeerFailure(sessionId: string, round: number, failure: PeerFailure): string;
+    savePeerResult(sessionId: string, round: number, result: PeerResult, label?: string): Promise<string>;
+    savePeerFailure(sessionId: string, round: number, failure: PeerFailure): Promise<string>;
     appendRound(sessionId: string, params: {
         caller_status: ReviewStatus;
         draft_file?: string;
@@ -47,51 +48,51 @@ export declare class SessionStore {
         convergence: ConvergenceResult;
         convergence_scope: ConvergenceScope;
         started_at: string;
-    }): ReviewRound;
-    markBudgetWarningEmitted(sessionId: string): SessionMeta;
-    setCircularState(sessionId: string, state: NonNullable<SessionMeta["circular_state"]>): SessionMeta;
+    }): Promise<ReviewRound>;
+    markBudgetWarningEmitted(sessionId: string): Promise<SessionMeta>;
+    setCircularState(sessionId: string, state: NonNullable<SessionMeta["circular_state"]>): Promise<SessionMeta>;
     setSessionTraceability(sessionId: string, traceability: {
         requested_max_rounds: number | null;
         effective_max_rounds: number | null;
         requested_max_cost_usd: number | null;
         effective_cost_ceiling_usd: number | null;
         cost_ceiling_source: "call_arg" | "env_default" | "config_default";
-    }): SessionMeta;
+    }): Promise<SessionMeta>;
     assertNotFinalized(sessionId: string): void;
-    finalize(sessionId: string, outcome: NonNullable<SessionMeta["outcome"]>, reason?: string): SessionMeta;
-    requestCancellation(sessionId: string, reason?: string, jobId?: string): SessionMeta;
-    markCancelled(sessionId: string, reason?: string): SessionMeta;
+    finalize(sessionId: string, outcome: NonNullable<SessionMeta["outcome"]>, reason?: string): Promise<SessionMeta>;
+    requestCancellation(sessionId: string, reason?: string, jobId?: string): Promise<SessionMeta>;
+    markCancelled(sessionId: string, reason?: string): Promise<SessionMeta>;
     isCancellationRequested(sessionId: string): boolean;
-    appendFallbackEvent(sessionId: string, event: NonNullable<SessionMeta["fallback_events"]>[number]): SessionMeta;
+    appendFallbackEvent(sessionId: string, event: NonNullable<SessionMeta["fallback_events"]>[number]): Promise<SessionMeta>;
     appendEvidenceChecklistItems(sessionId: string, round: number, incoming: Array<{
         peer: PeerId;
         ask: string;
-    }>): NonNullable<SessionMeta["evidence_checklist"]>;
+    }>): Promise<NonNullable<SessionMeta["evidence_checklist"]>>;
     static readonly TERMINAL_STATUSES: ReadonlySet<EvidenceChecklistStatus>;
-    runEvidenceChecklistAddressDetection(sessionId: string, currentRound: number): {
+    runEvidenceChecklistAddressDetection(sessionId: string, currentRound: number): Promise<{
         not_resurfaced: EvidenceChecklistItem[];
         reopened: EvidenceChecklistItem[];
         peer_resurfaced_terminal: EvidenceChecklistItem[];
-    };
+    }>;
     setEvidenceChecklistItemStatus(sessionId: string, itemId: string, status: Exclude<EvidenceChecklistStatus, "addressed" | "not_resurfaced">, options?: {
         note?: string;
         by?: "operator" | "runtime";
-    }): {
+    }): Promise<{
         item: EvidenceChecklistItem;
         history_entry: EvidenceStatusHistoryEntry;
-    };
+    }>;
     markEvidenceItemAddressedByJudge(sessionId: string, itemId: string, params: {
         round: number;
         rationale: string;
         judge_peer: PeerId;
-    }): {
+    }): Promise<{
         item: EvidenceChecklistItem;
         history_entry: EvidenceStatusHistoryEntry;
-    } | null;
-    recoverInterruptedSessions(activeSessionIds?: Set<string>): SessionMeta[];
+    } | null>;
+    recoverInterruptedSessions(activeSessionIds?: Set<string>): Promise<SessionMeta[]>;
     aggregateShadowJudgments(sessionId?: string): ShadowJudgmentRollup;
     metrics(sessionId?: string): RuntimeMetrics;
-    sessionDoctor(limit?: number, includeLegacy?: boolean, repair?: boolean): SessionDoctorReport;
+    sessionDoctor(limit?: number, includeLegacy?: boolean, repair?: boolean): Promise<SessionDoctorReport>;
     computeJudgmentPrecisionReport(opts?: {
         peer?: PeerId;
         since?: string;
@@ -111,24 +112,24 @@ export declare class SessionStore {
         new_task: string;
         new_initial_draft?: string;
         new_caller?: PeerId | "operator";
-    }): {
+    }): Promise<{
         contested_meta: SessionMeta;
         new_session_id: string;
-    };
+    }>;
     attachEvidence(sessionId: string, params: {
         label: string;
         content: string;
         content_type?: string;
         extension?: string;
-    }): {
+    }): Promise<{
         path: string;
         meta: SessionMeta;
-    };
+    }>;
     escalateToOperator(sessionId: string, params: {
         reason: string;
         severity: "info" | "warning" | "critical";
-    }): SessionMeta;
-    sweepIdle(idleMs: number, outcome?: "aborted" | "max-rounds", reason?: string): SessionMeta[];
+    }): Promise<SessionMeta>;
+    sweepIdle(idleMs: number, outcome?: "aborted" | "max-rounds", reason?: string): Promise<SessionMeta[]>;
     pruneCorruptSessions(minAgeMs: number): {
         scanned: number;
         removed: number;
@@ -138,12 +139,12 @@ export declare class SessionStore {
         scanned: number;
         removed: number;
     };
-    clearStaleInFlight(): {
+    clearStaleInFlight(): Promise<{
         scanned: number;
         cleared: number;
-    };
-    abortStaleSessions(staleHours?: number): {
+    }>;
+    abortStaleSessions(staleHours?: number): Promise<{
         scanned: number;
         aborted: number;
-    };
+    }>;
 }