diff --git a/.secrets.baseline b/.secrets.baseline index 8fc8413..9272f03 100644 --- a/.secrets.baseline +++ b/.secrets.baseline @@ -295,13 +295,6 @@ "is_verified": false, "line_number": 124 }, - { - "type": "Base64 High Entropy String", - "filename": "tests/core/test_redaction.py", - "hashed_secret": "94aa1800131a3019b26b317536a1ff3f702722d4", - "is_verified": false, - "line_number": 125 - }, { "type": "Secret Keyword", "filename": "tests/core/test_redaction.py", @@ -399,5 +392,5 @@ } ] }, - "generated_at": "2026-09-08T10:54:32Z" + "generated_at": "2026-09-13T21:06:39Z" } diff --git a/README.md b/README.md index 10cad6b..f8b5b03 100644 --- a/README.md +++ b/README.md @@ -7,16 +7,28 @@ **Evolve code. Show the evidence.** -LibreEvolve is an open-source workbench for inspectable code-evolution -experiments. **Engineering preview: bounded Python bin-packing optimization -with Codex OAuth.** It starts from a small Python heuristic, searches a bounded -local space of changes, records candidate workspaces and evaluations, and lets -you inspect a saved run before a fresh export check. +LibreEvolve is an **open-source workbench for inspectable code-evolution +experiments**. **Engineering preview: bounded Python bin-packing optimization +with Codex OAuth.** + +It starts from a deliberately simple Python bin-packing heuristic, searches a +bounded local space of changes, and saves every candidate workspace and +evaluation so you can read the evidence yourself — before a fresh export check +re-runs the candidate you chose. The product is an experiment you can examine, not a promise that every search improves code. No improvement is a valid result. A successful named check is not proof of universal correctness, optimality, security, or performance. +## What makes it worth inspecting + +| | | +| --- | --- | +| **Bounded by design** | Local call, evaluation and runtime limits keep a run small enough to follow. They are not token or dollar caps, and subscription usage may stay unknown. | +| **Saved, not summarized** | Candidate workspaces, evaluations, archive events and LLM calls land in a run directory you can read. | +| **Honest by construction** | Run status, validity, quality, retention and usage stay separate, so a finished run is never mistaken for a win. | +| **Checked again before use** | Reports and exports re-run the selected candidate in fresh local subprocesses instead of trusting old metadata. | + ## What is available today - A source install for the public engineering-preview checkout. @@ -33,10 +45,22 @@ An approved inspectable example viewer is not included in this branch. The seed-only flow in the quickstart is an onboarding check, not an optimization result or live-model demonstration. -The broader research platform, additional providers, plugins, examples, papers -and experimental tools live in the private -[experimental repository](https://github.com/LibreEvolve/libreevolve-experimental); -they are not capabilities of this public engineering preview. +Research features, additional providers, plugins, papers and experimental tools +are out of scope for this checkout; they are not capabilities of this public engineering preview. + +## How a run moves + +1. **Seed.** Initialize the bundled bin-packing task and inspect its + intentionally simple heuristic. +2. **Change.** Propose and evaluate bounded local changes — optionally through + the Codex OAuth lane, after you authorize your own subscription use. +3. **Inspect.** Read the saved run. Completion, validity, training quality, + retention and recorded usage are separate dimensions, so a finished run is + not the same as a retained win. +4. **Verify.** Freeze your selection, then let a fresh export check it on named + training and held-out cases and record its identity. + +**Run the preview** through the [canonical quickstart](docs/alpha-quickstart.md). ## Start with the canonical quickstart diff --git a/tests/test_brand_docs.py b/tests/test_brand_docs.py index c4b4c99..0fbe567 100644 --- a/tests/test_brand_docs.py +++ b/tests/test_brand_docs.py @@ -168,7 +168,7 @@ def test_docs_keep_future_items_and_example_slot_unpublished(): readme = _read("README.md") roadmap = _read("docs/roadmap.md") assert "approved inspectable example viewer is not included" in readme - assert "private\n[experimental repository](https://github.com/LibreEvolve/libreevolve-experimental)" in readme + assert "libreevolve-experimental" not in readme assert "not capabilities of this public engineering preview" in readme assert "Planned or proposed work" in roadmap assert "not current capabilities" in roadmap