@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
104 lines (92 loc) • 3.89 kB
text/typescript
import { inspectCodexLogs, type CodexLogGuardInspection } from "../codex/log-guard/inspect";
import {
getCodexLogGuardProtectionStatus,
type CodexLogGuardStatus,
} from "../codex/log-guard/protection";
function kib(bytes: number): string {
return `${(bytes / 1024).toFixed(1)} KiB`;
}
function fileMetadataLines(report: CodexLogGuardInspection): string[] {
if (report.externalSqliteHome === null) return [];
const location = report.externalSqliteHome ? "external sqlite_home" : "CODEX_HOME sqlite_home";
return [
` ${location}; DB ${kib(report.files.databaseBytes)}, WAL ${kib(report.files.walBytes)}, SHM ${kib(report.files.shmBytes)}`,
];
}
type DoctorReport = CodexLogGuardInspection | CodexLogGuardStatus;
function protectionLines(report: DoctorReport): string[] {
if (!("protection" in report)) return [];
const protection = report.protection;
switch (protection.state) {
case "active":
return [` ok protection active (${protection.desiredMode})`];
case "off":
return [" -- protection off"];
case "drifted":
return [
` WARN protection drifted (desired ${protection.desiredMode}; observed ${protection.observedMode})`,
" Action: ocx storage codex-logs repair",
];
case "unsupported":
return [" -- protection unavailable for this schema"];
case "unknown":
return [" WARN protection state unknown; inspect reserved Log Guard triggers before changing mode"];
}
}
export function formatCodexLogGuardDoctor(report: DoctorReport): string[] {
const lines = ["Codex diagnostic logs"];
lines.push(...protectionLines(report));
if (report.schema.state === "unavailable") {
lines.push(" -- inspection unavailable");
return lines;
}
if (report.schema.state === "missing") {
lines.push(" -- logs_2.sqlite is not present");
return lines;
}
if (report.schema.state === "unreadable") {
lines.push(" -- logs_2.sqlite is unreadable; inspection metadata only");
lines.push(...fileMetadataLines(report));
lines.push(" checkpointed read-only snapshot; activity rate not measured");
return lines;
}
if (report.schema.state === "unsupported") {
lines.push(" -- unknown schema; inspection only");
} else {
lines.push(" ok schema compatible");
}
lines.push(...fileMetadataLines(report));
if (report.metrics) {
lines.push(
` ${report.metrics.totalRows} rows; TRACE ${(report.metrics.traceShare * 100).toFixed(1)}%; reclaimable ${kib(report.metrics.reclaimableBytes)}`,
);
const top = report.metrics.topTargets[0];
if (top) lines.push(` top target ${top.target} (${top.rows} rows)`);
}
lines.push(" checkpointed read-only snapshot; activity rate not measured");
return lines;
}
export interface CodexLogGuardDoctorDeps {
inspect?: () => DoctorReport;
log?: (line: string) => void;
}
/** Observe-only doctor section. Inspection failures are reported without mutating or failing doctor. */
export function printCodexLogGuardDoctor(deps: CodexLogGuardDoctorDeps = {}): void {
const inspect = deps.inspect ?? getCodexLogGuardProtectionStatus;
const log = deps.log ?? console.log;
try {
for (const line of formatCodexLogGuardDoctor(inspect())) log(line);
} catch (error) {
// Production can still fall back to PR 1's simpler inspector if the enriched
// protection lookup fails. An injected inspector is a test/caller boundary:
// never escape that boundary and touch the real Codex home behind its back.
if (!deps.inspect) {
try {
for (const line of formatCodexLogGuardDoctor(inspectCodexLogs())) log(line);
return;
} catch { /* report the original failure below */ }
}
log("Codex diagnostic logs");
log(" -- inspection unavailable");
}
}