UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

102 lines (88 loc) • 4.77 kB
import type { OcxConfig } from "../types"; import { projectPersistedConfigMigrations } from "./persisted-projections"; import { readConfigFileSnapshot, type ConfigFileSnapshot } from "./diagnostics"; import { bumpGenerationForCooperatingConfigWrite, withConfigMutationLockSync } from "./mutation-lock"; import { persistConfigUnlocked } from "./persist-unlocked"; import { projectConfigRebaseProvenance } from "./rebase-provenance"; export type PersistedConfigMutation<T> = { changed: boolean; value: T; }; export type PersistedConfigMutationOutcome<T> = | { status: "committed" | "unchanged"; value: T } | { status: "unavailable"; reason: "missing" | "invalid" | "conflict" }; const CONFIG_MUTATION_MAX_REBASE_ATTEMPTS = 3; let persistedConfigMutationBeforeCommitForTests: (() => void) | null = null; /** Re-read authority inside ACL admission without starting another optional hardening flight. */ export function readConfigForAdmittedMutation(): OcxConfig { const { diagnostics } = readConfigFileSnapshot(); if (diagnostics.source !== "file") throw new Error("config_unavailable"); return diagnostics.config; } /** Test-only one-shot seam: inject a competing mutation after the first decision, before freshness revalidation. */ export function setPersistedConfigMutationBeforeCommitForTests(hook: (() => void) | null): void { persistedConfigMutationBeforeCommitForTests = hook; } function unavailableConfigMutationReason(snapshot: ConfigFileSnapshot): "missing" | "invalid" { return snapshot.diagnostics.source === "default" ? "missing" : "invalid"; } /** * Patch a schema-valid on-disk config under the shared mutation lock. Cooperating writers are * serialized; the callback is rerun on the newest snapshot so observed direct byte changes rebase * and credential predicates are re-evaluated immediately before the atomic commit. A writer that * ignores the coordinator can still change bytes after the final check because the filesystem has * no portable conditional rename. Missing or malformed config always fails closed and is never * recreated from a prior snapshot. */ export function mutatePersistedConfig<T>( mutate: (config: OcxConfig) => PersistedConfigMutation<T>, ): PersistedConfigMutationOutcome<T> { // Avoid creating/opening the coordinator database for a read-path update that already knows // there is no valid config. The same check runs again under the transaction for authority. const observed = readConfigFileSnapshot(); if (observed.diagnostics.source !== "file" || observed.raw === undefined) { return { status: "unavailable", reason: unavailableConfigMutationReason(observed) }; } return withConfigMutationLockSync(() => { let base = readConfigFileSnapshot(); for (let attempt = 0; attempt < CONFIG_MUTATION_MAX_REBASE_ATTEMPTS; attempt += 1) { if (base.diagnostics.source !== "file" || base.raw === undefined) { return { status: "unavailable", reason: unavailableConfigMutationReason(base) }; } const tentativeConfig = structuredClone(base.diagnostics.config); const tentative = mutate(tentativeConfig); if (!tentative.changed) return { status: "unchanged", value: tentative.value }; const hook = persistedConfigMutationBeforeCommitForTests; persistedConfigMutationBeforeCommitForTests = null; hook?.(); const latest = readConfigFileSnapshot(); if (latest.diagnostics.source !== "file" || latest.raw === undefined) { return { status: "unavailable", reason: unavailableConfigMutationReason(latest) }; } if (latest.raw !== base.raw) { base = latest; continue; } // Re-run against a fresh clone even when config bytes are unchanged: a Codex credential // generation lives in a separate file and may have changed at the injected seam. const confirmedConfig = structuredClone(latest.diagnostics.config); const confirmed = mutate(confirmedConfig); if (!confirmed.changed) return { status: "unchanged", value: confirmed.value }; const commitBase = readConfigFileSnapshot(); if (commitBase.diagnostics.source !== "file" || commitBase.raw === undefined) { return { status: "unavailable", reason: unavailableConfigMutationReason(commitBase) }; } if (commitBase.raw !== latest.raw) { base = commitBase; continue; } const projected = projectPersistedConfigMigrations( commitBase.diagnostics.config, projectConfigRebaseProvenance(confirmedConfig), ); if (persistConfigUnlocked(projected)) bumpGenerationForCooperatingConfigWrite(); return { status: "committed", value: confirmed.value }; } return { status: "unavailable", reason: "conflict" }; }); }