@lcv-ideas-software/cross-review 4.0.0

package/dist/src/core/reports.js

@@ -0,0 +1,82 @@
+function valueOrDash(value) {
+    if (value == null || value === "")
+        return "-";
+    return String(value);
+}
+function costText(session) {
+    const total = session.totals.cost.total_cost;
+    return total == null ? "unknown" : `$${total.toFixed(6)} ${session.totals.cost.currency}`;
+}
+export function sessionReportMarkdown(session, events = []) {
+    const latestRound = session.rounds.at(-1);
+    const lines = [
+        `# Cross Review Session ${session.session_id}`,
+        "",
+        "## Summary",
+        "",
+        `- Version: ${session.version}`,
+        `- Created: ${session.created_at}`,
+        `- Updated: ${session.updated_at}`,
+        `- Caller: ${session.caller}`,
+        `- Outcome: ${valueOrDash(session.outcome)}`,
+        `- Outcome reason: ${valueOrDash(session.outcome_reason)}`,
+        `- Health: ${valueOrDash(session.convergence_health?.state)} - ${valueOrDash(session.convergence_health?.detail)}`,
+        `- Rounds: ${session.rounds.length}`,
+        `- Cost: ${costText(session)}`,
+        `- Total tokens: ${valueOrDash(session.totals.usage.total_tokens)}`,
+        "",
+        "## Task",
+        "",
+        session.task,
+        "",
+        "## Latest Convergence",
+        "",
+        latestRound
+            ? [
+                `- Converged: ${latestRound.convergence.converged}`,
+                `- Reason: ${latestRound.convergence.reason}`,
+                `- Ready: ${latestRound.convergence.ready_peers.join(", ") || "-"}`,
+                `- Not ready: ${latestRound.convergence.not_ready_peers.join(", ") || "-"}`,
+                `- Needs evidence: ${latestRound.convergence.needs_evidence_peers.join(", ") || "-"}`,
+                `- Rejected: ${latestRound.convergence.rejected_peers.join(", ") || "-"}`,
+                `- Blocking details: ${latestRound.convergence.blocking_details.join("; ") || "-"}`,
+            ].join("\n")
+            : "- No round completed yet.",
+        "",
+        "## Peer Decisions",
+        "",
+    ];
+    if (session.generation_files?.length) {
+        lines.push("## Generations", "");
+        for (const generation of session.generation_files) {
+            const totalTokens = generation.usage?.total_tokens ?? "-";
+            const totalCost = generation.cost?.total_cost == null
+                ? "unknown"
+                : `$${generation.cost.total_cost.toFixed(6)} ${generation.cost.currency}`;
+            lines.push(`- round ${generation.round} ${generation.peer}/${generation.label}: ${generation.path} (${totalTokens} tokens, ${totalCost})`);
+        }
+        lines.push("");
+    }
+    for (const round of session.rounds) {
+        lines.push(`### Round ${round.round}`, "");
+        for (const peer of round.peers) {
+            lines.push(`- ${peer.peer}: ${peer.status ?? "NO_STATUS"} (${peer.decision_quality ?? "unknown"}) - ${peer.structured?.summary ?? "no summary"}`);
+            if (peer.parser_warnings.length) {
+                lines.push(`  - Parser warnings: ${peer.parser_warnings.join("; ")}`);
+            }
+        }
+        for (const failure of round.rejected) {
+            lines.push(`- ${failure.peer}: FAILURE ${failure.failure_class} - ${failure.message}`);
+        }
+        lines.push("");
+    }
+    if (events.length) {
+        lines.push("## Events", "");
+        for (const event of events.slice(-100)) {
+            lines.push(`- ${event.seq}. ${event.ts ?? ""} ${event.type}${event.peer ? `/${event.peer}` : ""}: ${event.message ?? ""}`);
+        }
+        lines.push("");
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=reports.js.map

package/dist/src/core/reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.js","sourceRoot":"","sources":["../../../src/core/reports.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,149 @@
+import type { AppConfig, ConvergenceResult, ConvergenceScope, EvidenceChecklistItem, EvidenceChecklistStatus, EvidenceStatusHistoryEntry, GenerationResult, PeerFailure, PeerId, PeerProbeResult, PeerResult, RuntimeEvent, RuntimeMetrics, SessionDoctorReport, SessionEvent, ReviewRound, ReviewStatus, SessionMeta, JudgmentPrecisionReport, ShadowJudgmentRollup } from "./types.js";
+export declare const SWEEP_MIN_IDLE_MS: number;
+export declare class SessionStore {
+    private readonly config;
+    private readonly seqCache;
+    constructor(config: AppConfig);
+    sessionsDir(): string;
+    sessionDir(sessionId: string): string;
+    metaPath(sessionId: string): string;
+    eventsPath(sessionId: string): string;
+    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;
+    markInFlight(sessionId: string, params: {
+        round: number;
+        peers: PeerId[];
+        started_at: string;
+        scope: ConvergenceScope;
+    }): SessionMeta;
+    read(sessionId: string): SessionMeta;
+    private peekNextSeq;
+    private commitSeq;
+    appendEvent(event: RuntimeEvent): void;
+    readEvents(sessionId: string, sinceSeq?: number): SessionEvent[];
+    list(): SessionMeta[];
+    pruneOldSessions(maxAgeDays?: number): {
+        scanned: number;
+        pruned: number;
+    };
+    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;
+    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;
+    appendRound(sessionId: string, params: {
+        caller_status: ReviewStatus;
+        draft_file?: string;
+        prompt_file: string;
+        peers: PeerResult[];
+        rejected: PeerFailure[];
+        convergence: ConvergenceResult;
+        convergence_scope: ConvergenceScope;
+        started_at: string;
+    }): ReviewRound;
+    markBudgetWarningEmitted(sessionId: string): SessionMeta;
+    setCircularState(sessionId: string, state: NonNullable<SessionMeta["circular_state"]>): 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;
+    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;
+    isCancellationRequested(sessionId: string): boolean;
+    appendFallbackEvent(sessionId: string, event: NonNullable<SessionMeta["fallback_events"]>[number]): SessionMeta;
+    appendEvidenceChecklistItems(sessionId: string, round: number, incoming: Array<{
+        peer: PeerId;
+        ask: string;
+    }>): NonNullable<SessionMeta["evidence_checklist"]>;
+    static readonly TERMINAL_STATUSES: ReadonlySet<EvidenceChecklistStatus>;
+    runEvidenceChecklistAddressDetection(sessionId: string, currentRound: number): {
+        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";
+    }): {
+        item: EvidenceChecklistItem;
+        history_entry: EvidenceStatusHistoryEntry;
+    };
+    markEvidenceItemAddressedByJudge(sessionId: string, itemId: string, params: {
+        round: number;
+        rationale: string;
+        judge_peer: PeerId;
+    }): {
+        item: EvidenceChecklistItem;
+        history_entry: EvidenceStatusHistoryEntry;
+    } | null;
+    recoverInterruptedSessions(activeSessionIds?: Set<string>): SessionMeta[];
+    aggregateShadowJudgments(sessionId?: string): ShadowJudgmentRollup;
+    metrics(sessionId?: string): RuntimeMetrics;
+    sessionDoctor(limit?: number, includeLegacy?: boolean, repair?: boolean): SessionDoctorReport;
+    computeJudgmentPrecisionReport(opts?: {
+        peer?: PeerId;
+        since?: string;
+        session_id?: string;
+    }): JudgmentPrecisionReport;
+    readEvidenceAttachments(sessionId: string, totalCapChars: number): Array<{
+        label: string;
+        relative_path: string;
+        content: string;
+        bytes: number;
+        truncated: boolean;
+        content_type?: string;
+    }>;
+    contestVerdict(params: {
+        session_id: string;
+        reason: string;
+        new_task: string;
+        new_initial_draft?: string;
+        new_caller?: PeerId | "operator";
+    }): {
+        contested_meta: SessionMeta;
+        new_session_id: string;
+    };
+    attachEvidence(sessionId: string, params: {
+        label: string;
+        content: string;
+        content_type?: string;
+        extension?: string;
+    }): {
+        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[];
+    pruneCorruptSessions(minAgeMs: number): {
+        scanned: number;
+        removed: number;
+        kept: number;
+    };
+    sweepOrphanTmpFiles(): {
+        scanned: number;
+        removed: number;
+    };
+    clearStaleInFlight(): {
+        scanned: number;
+        cleared: number;
+    };
+    abortStaleSessions(staleHours?: number): {
+        scanned: number;
+        aborted: number;
+    };
+}