// SQLite reliability stress proof exercises snapshots during concurrent writes. import fs from "node:fs"; import path from "node:path"; import { pathToFileURL } from "node:url"; import { CliUsageError, parseSqliteReliabilityCli } from "./lib/sqlite-reliability-cli.js"; import type { ReliabilityReport } from "./lib/sqlite-reliability-contract.js"; function printUsage(): void { console.log(`OpenClaw SQLite reliability stress proof Usage: node --import tsx scripts/bench-sqlite-reliability.ts [options] Options: --profile Stress profile (default: default) --agent Stress one per-agent database (default: global) --state-dir Reuse a state directory and retain proof artifacts --repository Snapshot repository path --output Write machine-readable JSON report --help Show this text `); } function printProofLines(report: ReliabilityReport): void { console.log(`SQLITE_RELIABILITY_PROFILE=${report.profile}`); console.log(`SQLITE_RELIABILITY_TARGET=${report.target}`); console.log(`SQLITE_RELIABILITY_PLATFORM=${report.platform}`); console.log(`SQLITE_RELIABILITY_ARCH=${report.arch}`); console.log(`SQLITE_RELIABILITY_ITERATIONS=${report.iterations}`); console.log(`SQLITE_RELIABILITY_RETAINED_BATCHES=${report.retainedBatches}`); console.log( `SQLITE_RELIABILITY_CONCURRENT_RESTORES_VERIFIED=${report.concurrentRestoresVerified}`, ); console.log(`SQLITE_RELIABILITY_RESTORES_VERIFIED=${report.restoresVerified}`); console.log(`SQLITE_RELIABILITY_WRITER_ROWS=${report.writer.rowsCommitted}`); console.log( `SQLITE_RELIABILITY_WAL_SENTINEL=${report.transactionProof.committedWalSentinel ? "verified" : "missing"}`, ); console.log(`SQLITE_RELIABILITY_HELD_BATCH=${report.transactionProof.heldBatch}`); console.log(`SQLITE_RELIABILITY_SNAPSHOT_P95_MS=${report.timingsMs.snapshotP95.toFixed(3)}`); console.log(`SQLITE_RELIABILITY_RESTORE_P95_MS=${report.timingsMs.restoreP95.toFixed(3)}`); console.log(`SQLITE_RELIABILITY_SNAPSHOT_BYTES_MAX=${report.snapshotBytes.max}`); console.log( `SQLITE_RELIABILITY_COMPACT_RECLAIMED_BYTES=${report.maintenanceProof.compaction.reclaimedBytes}`, ); console.log( `SQLITE_RELIABILITY_POST_COMPACT_RESTORE=${report.maintenanceProof.postCompact.restoreVerified ? "verified" : "missing"}`, ); console.log(`SQLITE_RELIABILITY_FINAL_ROWS=${report.maintenanceProof.postCompact.state.rows}`); console.log( `SQLITE_RELIABILITY_FINAL_STATE_SHA256=${report.maintenanceProof.postCompact.state.sha256}`, ); console.log(`SQLITE_RELIABILITY_WAL_PEAK_BYTES=${report.walBytes.peak}`); console.log(`SQLITE_RELIABILITY_WAL_LIMIT_BYTES=${report.walBytes.limit}`); } async function main(argv: string[]): Promise { try { const cli = parseSqliteReliabilityCli(argv); if (cli.help) { printUsage(); return; } const { options } = cli; const { runReliabilityStress } = await import("./lib/sqlite-reliability-runner.js"); const report = await runReliabilityStress(options); if (options.output) { fs.mkdirSync(path.dirname(options.output), { recursive: true }); fs.writeFileSync(options.output, `${JSON.stringify(report, null, 2)}\n`, "utf8"); } printProofLines(report); } catch (error) { if (error instanceof CliUsageError) { console.error(`error: ${error.message}`); process.exitCode = 2; return; } throw error; } } if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) { await main(process.argv.slice(2)); }