docushell · docushell-dev · Jun 21, 2026 · Jun 21, 2026
diff --git a/.github/scripts/test_milestone_e_prep_guard_sequence_index.py b/.github/scripts/test_milestone_e_prep_guard_sequence_index.py
@@ -107,6 +107,7 @@
     "$(PYTHON) .github/scripts/test_milestone_e_package_publication_decision_bundle_validation_record.py",
     "$(PYTHON) .github/scripts/test_milestone_e_package_publication_pre_approval_gap_ledger.py",
     "$(PYTHON) .github/scripts/test_milestone_e_public_facing_readiness_ledger.py",
+    "$(PYTHON) .github/scripts/test_milestone_e_public_beta_current_main_refresh_prep.py",
     "$(PYTHON) .github/scripts/test_milestone_e_validation_command_index.py",
     "$(PYTHON) .github/scripts/test_milestone_e_validation_command_index_validation_record.py",
     "$(PYTHON) .github/scripts/test_milestone_e_validation_record_index.py",

diff --git a/.github/scripts/test_milestone_e_prep_scope.py b/.github/scripts/test_milestone_e_prep_scope.py
@@ -406,6 +406,7 @@ def test_make_target_is_narrow_and_guarded(self) -> None:
     "$(PYTHON) .github/scripts/test_milestone_e_package_publication_decision_bundle_validation_record.py",
     "$(PYTHON) .github/scripts/test_milestone_e_package_publication_pre_approval_gap_ledger.py",
     "$(PYTHON) .github/scripts/test_milestone_e_public_facing_readiness_ledger.py",
+    "$(PYTHON) .github/scripts/test_milestone_e_public_beta_current_main_refresh_prep.py",
     "$(PYTHON) .github/scripts/test_milestone_e_validation_command_index.py",
             "$(PYTHON) .github/scripts/test_milestone_e_validation_command_index_validation_record.py",
             "$(PYTHON) .github/scripts/test_milestone_e_validation_record_index.py",

diff --git a/.github/scripts/test_milestone_e_public_beta_current_main_refresh_prep.py b/.github/scripts/test_milestone_e_public_beta_current_main_refresh_prep.py
@@ -0,0 +1,245 @@
+#!/usr/bin/env python3
+#
+# Copyright 2026 The Ethos maintainers
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+from __future__ import annotations
+
+import json
+import re
+import subprocess
+import unittest
+from pathlib import Path
+
+from makefile_guard import target_block
+
+
+ROOT = Path(__file__).resolve().parents[2]
+PREP = ROOT / "docs/milestone-e-public-beta-current-main-refresh-prep.json"
+SCHEMA = ROOT / "schemas/ethos-milestone-e-public-beta-current-main-refresh-prep.schema.json"
+PUBLIC_BETA_PREP = ROOT / "docs/milestone-e-public-beta-approval-prep.json"
+READINESS_LEDGER = ROOT / "docs/milestone-e-public-facing-readiness-ledger.json"
+RECORD = (
+    ROOT
+    / "docs/validation/"
+    "milestone-e-public-beta-current-main-refresh-prep-validation-2026-06-21.md"
+)
+VALIDATION_README = ROOT / "docs/validation/README.md"
+PREP_SCOPE = ROOT / "docs/milestone-e-prep-scope.md"
+ROADMAP = ROOT / "docs/roadmap.md"
+EXECUTION_STATUS = ROOT / "docs/execution-status.md"
+SCHEMAS_README = ROOT / "schemas/README.md"
+VALIDATE_EXAMPLES = ROOT / "schemas/validate_examples.py"
+CI_WORKFLOW = ROOT / ".github/workflows/ci.yml"
+
+REFRESH_COMMIT = "9262b281ee2cfb7fb0c9adf9f70afafe624e6878"
+REFRESH_TREE = "9f18f9e40c57551aef9b0cb2a53641c87207546b"
+EXPECTED_BOUNDARY = [
+    "public reports remain blocked",
+    "release artifacts remain blocked",
+    "package publication remains blocked",
+    "hosted surfaces remain blocked",
+    "public result wording remains blocked",
+    "performance claims remain blocked",
+    "quality claims remain blocked",
+    "footprint claims remain blocked",
+    "table-quality claims remain blocked",
+    "parser-quality claims remain blocked",
+]
+FORBIDDEN_SCOPE_EXPANSION = [
+    "public reports are approved",
+    "public result wording approved",
+    "release-ready",
+    "release artifact approved",
+    "package-ready",
+    "package publication is approved",
+    "package publication approved",
+    "packages are published",
+    "published packages",
+    "production-ready",
+    "production positioning approved",
+    "benchmark-validated",
+    "public benchmark pass",
+    "speed validated",
+    "fastest",
+    "launch-ready",
+    "hosted surface approved",
+    "hosted demo approved",
+    "demo-ready",
+    "performance validated",
+    "quality validated",
+    "footprint validated",
+    "table-quality validated",
+    "parser-quality validated",
+]
+
+
+def read(path: Path) -> str:
+    return path.read_text(encoding="utf-8")
+
+
+def normalized(path: Path) -> str:
+    return re.sub(r"\s+", " ", read(path))
+
+
+def load_json(path: Path) -> dict:
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+def git(*args: str) -> str:
+    return subprocess.check_output(
+        ["git", *args],
+        cwd=ROOT,
+        encoding="utf-8",
+        stderr=subprocess.DEVNULL,
+    ).strip()
+
+
+class MilestoneEPublicBetaCurrentMainRefreshPrepTests(unittest.TestCase):
+    def test_refresh_prep_records_candidate_without_approval(self) -> None:
+        prep = load_json(PREP)
+
+        self.assertEqual(1, prep["schema_version"])
+        self.assertEqual("source-only-pre-alpha-internal-milestone-e-prep", prep["status"])
+        self.assertEqual("public_beta_current_main_refresh_prep", prep["scope"])
+        self.assertEqual("public-beta-approval", prep["lane_id"])
+        self.assertEqual("current_main_refresh_prepared_approval_blocked", prep["decision_state"])
+        self.assertEqual(REFRESH_COMMIT, prep["refresh_candidate"]["candidate_commit"])
+        self.assertEqual(REFRESH_TREE, prep["refresh_candidate"]["candidate_tree"])
+        self.assertIn("no refreshed source approval", prep["refresh_candidate"]["candidate_state"])
+        self.assertEqual(EXPECTED_BOUNDARY, prep["public_boundary"])
+
+    def test_refresh_candidate_resolves_in_repository_history(self) -> None:
+        prep = load_json(PREP)
+
+        self.assertEqual(REFRESH_COMMIT, git("rev-parse", REFRESH_COMMIT))
+        self.assertEqual(REFRESH_TREE, git("rev-parse", f"{REFRESH_COMMIT}^{{tree}}"))
+        subprocess.check_call(
+            ["git", "merge-base", "--is-ancestor", REFRESH_COMMIT, "HEAD"],
+            cwd=ROOT,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+        )
+        self.assertEqual(REFRESH_COMMIT, prep["refresh_candidate"]["candidate_commit"])
+        self.assertEqual(REFRESH_TREE, prep["refresh_candidate"]["candidate_tree"])
+
+    def test_existing_public_beta_and_readiness_bindings_stay_separate(self) -> None:
+        prep = load_json(PREP)
+        public_beta = load_json(PUBLIC_BETA_PREP)
+        readiness = load_json(READINESS_LEDGER)
+
+        self.assertEqual(public_beta["approved_public_beta_source"], prep["existing_public_beta_source"])
+        self.assertEqual(
+            readiness["current_main_refresh_candidate"]["candidate_commit"],
+            prep["prior_readiness_ledger_candidate"]["candidate_commit"],
+        )
+        self.assertNotEqual(
+            prep["existing_public_beta_source"]["tree"],
+            prep["refresh_candidate"]["candidate_tree"],
+        )
+        self.assertNotEqual(
+            prep["prior_readiness_ledger_candidate"]["candidate_tree"],
+            prep["refresh_candidate"]["candidate_tree"],
+        )
+
+    def test_required_evidence_non_approvals_and_blockers_are_explicit(self) -> None:
+        prep = load_json(PREP)
+
+        self.assertEqual(7, len(prep["refresh_required_evidence"]))
+        self.assertEqual(8, len(prep["refresh_non_approvals"]))
+        self.assertEqual(14, len(prep["retained_blockers"]))
+        self.assertIn("dedicated source-only public beta refresh decision record", prep["refresh_required_evidence"])
+        self.assertIn("exact refreshed source commit and tree", prep["refresh_required_evidence"])
+        self.assertIn("this prep does not refresh the reviewed public beta source state", prep["refresh_non_approvals"])
+        self.assertIn("this prep does not approve package publication", prep["refresh_non_approvals"])
+        self.assertIn("package publication remains blocked", prep["retained_blockers"])
+        self.assertIn("public installation remains blocked", prep["retained_blockers"])
+        self.assertIn("public benchmark claims remain blocked", prep["retained_blockers"])
+
+    def test_schema_validation_covers_current_main_refresh_prep(self) -> None:
+        schema = load_json(SCHEMA)
+        validate_examples = read(VALIDATE_EXAMPLES)
+        schemas_readme = read(SCHEMAS_README)
+
+        self.assertEqual(False, schema["additionalProperties"])
+        self.assertIn("refresh_candidate", schema["required"])
+        self.assertIn("existing_public_beta_source", schema["required"])
+        self.assertEqual(7, schema["properties"]["refresh_required_evidence"]["minItems"])
+        self.assertEqual(8, schema["properties"]["refresh_non_approvals"]["minItems"])
+        self.assertIn("ethos-milestone-e-public-beta-current-main-refresh-prep.schema.json", validate_examples)
+        self.assertIn("docs\" / \"milestone-e-public-beta-current-main-refresh-prep.json", validate_examples)
+        self.assertIn("ethos-milestone-e-public-beta-current-main-refresh-prep.schema.json", schemas_readme)
+        self.assertIn("docs/milestone-e-public-beta-current-main-refresh-prep.json", schemas_readme)
+
+    def test_validation_record_indexes_commands_and_boundaries(self) -> None:
+        readme = read(VALIDATION_README)
+        record = normalized(RECORD)
+        record_lower = record.lower()
+        prep = load_json(PREP)
+
+        self.assertIn(RECORD.name, readme)
+        self.assertIn("public beta current-main refresh prep validation", re.sub(r"\s+", " ", readme))
+        self.assertIn("Validated source HEAD before this record: `9262b28`", read(RECORD))
+        for gate in prep["required_gates"]:
+            self.assertIn(gate, record)
+        for blocker in prep["retained_blockers"]:
+            self.assertIn(blocker.lower(), record_lower)
+        self.assertIn("Ethos remains source-only pre-alpha", record)
+        self.assertIn("Public reports remain blocked", record)
+        self.assertIn("Public result wording remains blocked", record)
+
+    def test_docs_reference_current_main_refresh_prep(self) -> None:
+        for path in (PREP_SCOPE, ROADMAP, EXECUTION_STATUS, VALIDATION_README):
+            doc = normalized(path)
+
+            self.assertIn("docs/milestone-e-public-beta-current-main-refresh-prep.json", doc, str(path))
+            self.assertIn("public beta current-main refresh prep", doc, str(path))
+            self.assertIn("current-main refresh candidate", doc, str(path))
+            self.assertIn("package publication remains blocked", doc, str(path))
+
+    def test_make_and_ci_run_refresh_prep_after_readiness_ledger(self) -> None:
+        make_block = target_block("milestone-e-prep")
+        ci = read(CI_WORKFLOW)
+        readiness_guard = "test_milestone_e_public_facing_readiness_ledger.py"
+        refresh_guard = "test_milestone_e_public_beta_current_main_refresh_prep.py"
+        command_guard = "test_milestone_e_validation_command_index.py"
+
+        for text, prefix in ((make_block, "$(PYTHON) .github/scripts/"), (ci, "python3 .github/scripts/")):
+            self.assertIn(prefix + refresh_guard, text)
+            self.assertEqual(1, text.count(prefix + refresh_guard))
+            self.assertLess(text.index(prefix + readiness_guard), text.index(prefix + refresh_guard))
+            self.assertLess(text.index(prefix + refresh_guard), text.index(prefix + command_guard))
+
+    def test_refresh_prep_avoids_scope_expansion_language_or_private_paths(self) -> None:
+        lower = json.dumps(load_json(PREP), sort_keys=True).lower()
+        record_lower = normalized(RECORD).lower()
+        raw = read(PREP) + read(RECORD)
+
+        for phrase in FORBIDDEN_SCOPE_EXPANSION:
+            self.assertNotIn(phrase, lower)
+            self.assertNotIn(phrase, record_lower)
+        self.assertNotIn("/Users/", raw)
+        self.assertNotIn("/private/tmp", raw)
+        self.assertNotIn("/private/var", raw)
+        self.assertNotIn("/var/folders", raw)
+        self.assertNotIn("saumildiwaker", raw)
+        self.assertNotIn("Desktop/Stuff", raw)
+        self.assertNotIn("project/repo/ethos", raw)
+        self.assertNotIn("docs/.roadmap.md.swp", raw)
+        self.assertNotIn("web/", raw)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/.github/scripts/test_milestone_e_public_boundary_alignment.py b/.github/scripts/test_milestone_e_public_boundary_alignment.py
@@ -89,6 +89,10 @@ class BoundaryArtifact:
         "docs/milestone-e-public-facing-readiness-ledger.json",
         "schemas/ethos-milestone-e-public-facing-readiness-ledger.schema.json",
     ),
+    BoundaryArtifact(
+        "docs/milestone-e-public-beta-current-main-refresh-prep.json",
+        "schemas/ethos-milestone-e-public-beta-current-main-refresh-prep.schema.json",
+    ),
 )
 
 

diff --git a/.github/scripts/test_milestone_e_schema_registry_alignment.py b/.github/scripts/test_milestone_e_schema_registry_alignment.py
@@ -99,6 +99,11 @@ def schema_name(self) -> str:
         "docs/milestone-e-public-facing-readiness-ledger.json",
         "public_facing_readiness_current_main_ledger",
     ),
+    RegistryEntry(
+        "schemas/ethos-milestone-e-public-beta-current-main-refresh-prep.schema.json",
+        "docs/milestone-e-public-beta-current-main-refresh-prep.json",
+        "public_beta_current_main_refresh_prep",
+    ),
 )
 
 
@@ -160,7 +165,7 @@ def assert_tracked_file(self, path: str) -> None:
         self.assertEqual(0, result.returncode, path)
 
     def test_registry_has_exact_tracked_schema_artifact_pairs(self) -> None:
-        self.assertEqual(10, len(EXPECTED_REGISTRY))
+        self.assertEqual(11, len(EXPECTED_REGISTRY))
         self.assertEqual(
             len(EXPECTED_REGISTRY),
             len({(entry.schema, entry.artifact) for entry in EXPECTED_REGISTRY}),

diff --git a/.github/scripts/test_milestone_e_source_status_alignment.py b/.github/scripts/test_milestone_e_source_status_alignment.py
@@ -115,6 +115,10 @@ class SourceStatusArtifact:
         "docs/milestone-e-public-facing-readiness-ledger.json",
         "schemas/ethos-milestone-e-public-facing-readiness-ledger.schema.json",
     ),
+    SourceStatusArtifact(
+        "docs/milestone-e-public-beta-current-main-refresh-prep.json",
+        "schemas/ethos-milestone-e-public-beta-current-main-refresh-prep.schema.json",
+    ),
 )
 
 STATUS_VALIDATION_RECORDS = (

diff --git a/.github/scripts/test_milestone_e_validation_record_index.py b/.github/scripts/test_milestone_e_validation_record_index.py
@@ -262,6 +262,10 @@ class RecordCoverage:
         "milestone-e-public-facing-readiness-ledger-validation-2026-06-21.md",
         "test_milestone_e_public_facing_readiness_ledger.py",
     ),
+    RecordCoverage(
+        "milestone-e-public-beta-current-main-refresh-prep-validation-2026-06-21.md",
+        "test_milestone_e_public_beta_current_main_refresh_prep.py",
+    ),
     RecordCoverage(
         "milestone-e-validation-command-index-validation-2026-06-20.md",
         "test_milestone_e_validation_command_index_validation_record.py",
@@ -362,6 +366,7 @@ def test_index_guards_run_after_row_and_schema_records(self) -> None:
         )
         package_gap_ledger_guard = "test_milestone_e_package_publication_pre_approval_gap_ledger.py"
         readiness_guard = "test_milestone_e_public_facing_readiness_ledger.py"
+        beta_refresh_guard = "test_milestone_e_public_beta_current_main_refresh_prep.py"
         command_guard = "test_milestone_e_validation_command_index_validation_record.py"
         index_guard = "test_milestone_e_validation_record_index.py"
         index_record_guard = "test_milestone_e_validation_record_index_validation_record.py"
@@ -419,8 +424,9 @@ def test_index_guards_run_after_row_and_schema_records(self) -> None:
                 text.index(prefix + package_gap_ledger_guard),
             )
             self.assertLess(text.index(prefix + package_gap_ledger_guard), text.index(prefix + readiness_guard))
-            self.assertLess(text.index(prefix + readiness_guard), text.index(prefix + command_guard))
-            self.assertLess(text.index(prefix + readiness_guard), text.index(prefix + index_guard))
+            self.assertLess(text.index(prefix + readiness_guard), text.index(prefix + beta_refresh_guard))
+            self.assertLess(text.index(prefix + beta_refresh_guard), text.index(prefix + command_guard))
+            self.assertLess(text.index(prefix + beta_refresh_guard), text.index(prefix + index_guard))
             self.assertLess(text.index(prefix + package_manifest_activation_guard), text.index(prefix + command_guard))
             self.assertLess(text.index(prefix + package_manifest_activation_guard), text.index(prefix + index_guard))
             self.assertLess(text.index(prefix + package_tag_guard), text.index(prefix + command_guard))

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -228,6 +228,8 @@ jobs:
         run: python3 .github/scripts/test_milestone_e_package_publication_pre_approval_gap_ledger.py
       - name: Milestone E public-facing readiness ledger tests
         run: python3 .github/scripts/test_milestone_e_public_facing_readiness_ledger.py
+      - name: Milestone E public beta current-main refresh prep tests
+        run: python3 .github/scripts/test_milestone_e_public_beta_current_main_refresh_prep.py
       - name: Milestone E validation-command index tests
         run: python3 .github/scripts/test_milestone_e_validation_command_index.py
       - name: Milestone E validation-command index validation record tests

diff --git a/Makefile b/Makefile
@@ -221,6 +221,7 @@ milestone-e-prep:
 	$(PYTHON) .github/scripts/test_milestone_e_package_publication_decision_bundle_validation_record.py
 	$(PYTHON) .github/scripts/test_milestone_e_package_publication_pre_approval_gap_ledger.py
 	$(PYTHON) .github/scripts/test_milestone_e_public_facing_readiness_ledger.py
+	$(PYTHON) .github/scripts/test_milestone_e_public_beta_current_main_refresh_prep.py
 	$(PYTHON) .github/scripts/test_milestone_e_validation_command_index.py
 	$(PYTHON) .github/scripts/test_milestone_e_validation_command_index_validation_record.py
 	$(PYTHON) .github/scripts/test_milestone_e_validation_record_index.py