From bfbbbfc43f79415d56b372c028515197788c1195 Mon Sep 17 00:00:00 2001 From: Timothy Wayne Gregg <5861166+CompleteDotTech@users.noreply.github.com> Date: Sun, 13 Sep 2026 21:01:26 +0000 Subject: [PATCH 1/2] docs: refresh README and drop private-repo reference Make the README more engaging while preserving the engineering-preview scope, required brand wording, section ordering and honest limits. - Add a benefit-first intro, a "What makes it worth inspecting" table and a four-step run walkthrough with a quickstart CTA. - Remove the private libreevolve-experimental repository reference. - Update test_brand_docs to assert the private reference is absent. Verification: brand/docs tests pass (34 passed, 10 subtests) and brand/check_claims.py reports validation passed. --- README.md | 42 +++++++++++++++++++++++++++++++--------- tests/test_brand_docs.py | 2 +- 2 files changed, 34 insertions(+), 10 deletions(-) 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 From 068539942efa72d1e7ecbd34250fa1129cdcca68 Mon Sep 17 00:00:00 2001 From: Timothy Wayne Gregg <5861166+CompleteDotTech@users.noreply.github.com> Date: Sun, 13 Sep 2026 21:07:50 +0000 Subject: [PATCH 2/2] chore: refresh detect-secrets baseline --- .secrets.baseline | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) 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" }