@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
text/typescript
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" };
});
}