CONTEXT CONTROL FOR CODEX

Keep the truth.
Compress the noise.

ContextGC protects goals, constraints, decisions, and test evidence around Codex compaction—then shows exactly what moved, why, and how to get it back.

Inspect verified evidence Open GitHub Read the boundary

3 / 3: deterministic fixtures passed
100%: required critical facts retained
0: adaptive manual interventions

Synthetic replay only · adaptive UPVS is 3.20% below fixed and 9.36% above the six-intervention manual schedule · liveCodexProof=false

01 · POLICY LAB

Three traces. Three policies. No vibes.

Switch policies to inspect a frozen replay across three software engineering fixtures. Success is scored by deterministic tests—not by an LLM judge.

OUTCOMEVerified synthetic replay · 4 simulated events

Total usage proxy: 196,465
UPVS: 65,488.33
Verified success: 3 / 3
Critical retention: 100%

Manual59,884.67 UPVS

Fixed 75%67,653.67 UPVS

ContextGC65,488.33 UPVS

Lower UPVS is better. Manual is lowest here but requires 6 frozen-schedule interventions; adaptive is 3.20% below fixed with none. All policies passed 3 / 3.

02 · INVARIANT PROBE

Protected facts get a fail-closed gate.

This control reveals a result already recorded by the deterministic synthetic evaluator. It does not run Codex or a new benchmark in the visitor's browser.

fixture/exact-config-migrationGATE: READY

CONSTRAINTnode runtime must remain "22.13.0"protected
CONSTRAINTpackage manager must remain "npm@10.9.2"protected
CHANGE GUARDDo not modify .github/workflows/release.ymlprotected
TRANSIENTOptional peer warnings from unrelated packageseligible

awaiting recorded-result reveal…

03 · RECOVERY

Important non-secret evidence stays recoverable.

Externalized means moved with a content hash—not deleted. Rehydrate only what the next turn needs, or restore the last valid frame. This interaction is a capability walkthrough, not benchmark evidence.

hashed archiveevidence indexed

valid framereversible checkpoint

next turnready

CAPABILITY WALKTHROUGH · NON-BENCHMARKcontent-addressed local archive

non-secret bytes preservedbounded retrievallocal only

Sanitized non-secret evidence is archived and addressable.

Detected secret bytes are redacted before persistence and are not recoverable from ContextGC.

04 · RECEIPT

A claim you can inspect.

The sanitized receipt preserves the source hash, metric definition, policy results, replay-only apiCallsMade: 0 field, and the exact proof caveat.

PASSExact Config Migration10 turns

PASSInterrupted Refactor11 turns

PASSNoisy Incident Debug12 turns

demo-receipt.jsonSYNTHETIC

{
  "schemaVersion": 1,
  "sourceReceiptHash": "f7699823546f79657aea0faa290c0c648b8876236456f7a8ff02003875147ddd",
  "benchmarkVersion": "contextgc-synthetic-v1",
  "scope": "deterministic-synthetic-policy-simulation",
  "primaryMetric": "UPVS",
  "codexCredits": null,
  "liveCodexProof": false,
  "apiCallsMade": 0,
  "usageProxyDefinition": {
    "id": "neutral-v1",
    "unit": "weighted-token-units",
    "weights": {
      "uncachedInputWeight": 1,
      "cachedInputWeight": 1,
      "cacheWriteInputWeight": 1,
      "outputWeight": 1
    },
    "codexCredits": null,
    "estimatedApiEquivalentUsd": null,
    "limitation": "The proxy sums non-overlapping token categories with neutral weights. It is not a ChatGPT/Codex bill, credit estimate, or model-quality measurement."
  },
  "policies": [
    {
      "policy": "M_MANUAL",
      "upvs": 59884.666667,
      "totalUsageProxy": 179654,
      "verifiedSuccesses": 3,
      "fixtureCount": 3,
      "criticalRetentionRate": 1,
      "compactions": 6,
      "manualInterventions": 6
    },
    {
      "policy": "F_FIXED",
      "upvs": 67653.666667,
      "totalUsageProxy": 202961,
      "verifiedSuccesses": 3,
      "fixtureCount": 3,
      "criticalRetentionRate": 1,
      "compactions": 5,
      "manualInterventions": 0
    },
    {
      "policy": "A_ADAPTIVE",
      "upvs": 65488.333333,
      "totalUsageProxy": 196465,
      "verifiedSuccesses": 3,
      "fixtureCount": 3,
      "criticalRetentionRate": 1,
      "compactions": 4,
      "manualInterventions": 0
    }
  ],
  "caveat": "Deterministic synthetic replay only. These results do not prove native Codex compaction quality, live integration, real credits, or production savings."
}

Deterministic synthetic replay only. These results do not prove native Codex compaction quality, live integration, real credits, or production savings. Codex credits are unknown—not publicly derivable.

HONEST INTEGRATION BOUNDARY

ContextGC prepares, protects, and restores.

The plugin does not claim to replace Codex's opaque native compaction state or force /compact inside an arbitrary existing thread. Native compaction remains Codex-owned; ContextGC is the auditable safety and control plane around it.

INSTALL · VERIFY · INSPECT

No build. Three commands.

Clone, enter the repository, and reproduce the checked-in receipt. Node.js 22.13 or newer is required; dependencies, an API key, and a rebuild are not.