From 36d83d3cfcc78f674d6cc3c96430d935bb18ee0f Mon Sep 17 00:00:00 2001 From: docushell-admin Date: Sun, 21 Jun 2026 23:33:30 +0530 Subject: [PATCH] Record package public installation wording review Signed-off-by: docushell-admin --- ...one_e_package_publication_approval_prep.py | 1 + ...tion_public_installation_wording_review.py | 206 ++++++++++++++++++ ...t_milestone_e_prep_guard_sequence_index.py | 1 + .../scripts/test_milestone_e_prep_scope.py | 1 + ...est_milestone_e_validation_record_index.py | 19 ++ .github/workflows/ci.yml | 2 + Makefile | 1 + docs/execution-status.md | 2 + ...e-e-package-publication-approval-prep.json | 3 +- docs/milestone-e-prep-scope.md | 5 + docs/roadmap.md | 5 + docs/validation/README.md | 5 + ...on-wording-review-validation-2026-06-21.md | 123 +++++++++++ ...kage-publication-approval-prep.schema.json | 6 +- 14 files changed, 378 insertions(+), 2 deletions(-) create mode 100644 .github/scripts/test_milestone_e_package_publication_public_installation_wording_review.py create mode 100644 docs/validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md diff --git a/.github/scripts/test_milestone_e_package_publication_approval_prep.py b/.github/scripts/test_milestone_e_package_publication_approval_prep.py index 3e7a436..a7b4473 100644 --- a/.github/scripts/test_milestone_e_package_publication_approval_prep.py +++ b/.github/scripts/test_milestone_e_package_publication_approval_prep.py @@ -96,6 +96,7 @@ "package_approval_readiness_review": "docs/validation/milestone-e-package-publication-approval-readiness-review-validation-2026-06-21.md", "package_manifest_activation_diff_review": "docs/validation/milestone-e-package-publication-manifest-activation-diff-review-validation-2026-06-21.md", "package_registry_assembly_evidence_review": "docs/validation/milestone-e-package-publication-registry-assembly-evidence-review-validation-2026-06-21.md", + "package_public_installation_wording_review": "docs/validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md", } EXPECTED_PUBLICATION_DECISION_INPUTS = { "decision_status": "not_approved_pending_exact_decision", diff --git a/.github/scripts/test_milestone_e_package_publication_public_installation_wording_review.py b/.github/scripts/test_milestone_e_package_publication_public_installation_wording_review.py new file mode 100644 index 0000000..5b24b97 --- /dev/null +++ b/.github/scripts/test_milestone_e_package_publication_public_installation_wording_review.py @@ -0,0 +1,206 @@ +#!/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-package-publication-approval-prep.json" +RECORD = ( + ROOT + / "docs/validation/" + "milestone-e-package-publication-public-installation-wording-review-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" +CI_WORKFLOW = ROOT / ".github/workflows/ci.yml" + +SOURCE_COMMIT = "8b446e3554c9b4b223e43ee46d218c47a7931c76" +SOURCE_SHORT = "8b446e3" +SOURCE_TREE = "385dd7799cf898fc850555ce13d6d74e8ee15196" +EXPECTED_CANDIDATE_WORDING = ( + "Ethos Rust crates are proposed for crates.io installation after dedicated package-publication " + "approval. The first candidate crate surface is limited to ethos-doc-core, ethos-verify, and " + "ethos-pdf. Wheels, npm packages, binaries, hosted surfaces, production positioning, public " + "benchmark reports, public benchmark claims, release artifacts, project-maintained PDFium " + "builds, ethos-doc, and ethos-rag remain excluded." +) +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 MilestoneEPackagePublicationPublicInstallationWordingReviewTests(unittest.TestCase): + def test_wording_review_record_is_indexed_and_source_bound(self) -> None: + prep = load_json(PREP) + readme = read(VALIDATION_README) + record = normalized(RECORD) + + self.assertIn(RECORD.name, readme) + self.assertIn("package publication public installation wording review validation", readme) + self.assertEqual( + "docs/validation/" + "milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md", + prep["follow_up_records"]["package_public_installation_wording_review"], + ) + self.assertIn(f"Validated source HEAD before this record: `{SOURCE_SHORT}`", read(RECORD)) + self.assertIn(f"Public installation wording review source commit: `{SOURCE_COMMIT}`", record) + self.assertIn(f"Public installation wording review source tree: `{SOURCE_TREE}`", record) + self.assertEqual(SOURCE_COMMIT, git("rev-parse", SOURCE_SHORT)) + self.assertEqual(SOURCE_TREE, git("rev-parse", f"{SOURCE_SHORT}^{{tree}}")) + + def test_candidate_wording_is_review_only_and_exclusion_bound(self) -> None: + record = normalized(RECORD) + lower_record = record.lower() + + self.assertIn(EXPECTED_CANDIDATE_WORDING, record) + self.assertIn("This candidate wording is not approved public wording", record) + self.assertIn("No public installation wording is approved by this record", record) + self.assertIn("Public installation remains blocked", record) + self.assertIn("Package publication remains blocked", record) + for included in ("ethos-doc-core", "ethos-verify", "ethos-pdf"): + self.assertIn(included, record) + for excluded in ( + "wheels", + "npm packages", + "binaries", + "hosted surfaces", + "production positioning", + "public benchmark reports", + "public benchmark claims", + "release artifacts", + "project-maintained PDFium builds", + "ethos-doc", + "ethos-rag", + ): + self.assertIn(excluded.lower(), lower_record) + self.assertIn("public-surface posture check after exact public installation wording changes remains required", record) + self.assertIn("claims gate after exact public installation wording changes remains required", record) + + def test_current_manifests_tags_and_registry_state_stay_unactivated(self) -> None: + packet = load_json(PREP)["package_publication_decision_input_packet"] + core_manifest = read(ROOT / "crates/ethos-core/Cargo.toml") + verify_manifest = read(ROOT / "crates/ethos-verify/Cargo.toml") + pdf_manifest = read(ROOT / "crates/ethos-pdf/Cargo.toml") + + for value in packet["candidate_package_tag_names"]: + tag = value.split(": ", maxsplit=1)[1].split(";", maxsplit=1)[0] + self.assertEqual("", git("tag", "--list", tag)) + self.assertIn('name = "ethos-core"', core_manifest) + self.assertIn("publish = false", core_manifest) + self.assertIn("publish = false", verify_manifest) + self.assertIn("publish = false", pdf_manifest) + self.assertNotIn('package = "ethos-doc-core"', verify_manifest) + self.assertNotIn('package = "ethos-doc-core"', pdf_manifest) + self.assertFalse((ROOT / ".cargo/config.toml").exists()) + self.assertFalse((ROOT / "target/package-registry").exists()) + + def test_docs_reference_wording_review_and_retained_blockers(self) -> None: + for path in (PREP_SCOPE, ROADMAP, EXECUTION_STATUS, VALIDATION_README): + doc = normalized(path) + + self.assertIn(RECORD.name, doc, str(path)) + self.assertIn("public installation wording review", doc.lower(), str(path)) + self.assertIn("package publication remains blocked", doc, str(path)) + self.assertIn("public installation remains blocked", doc, str(path)) + + def test_make_and_ci_run_wording_review_after_registry_evidence_review(self) -> None: + make_block = target_block("milestone-e-prep") + ci = read(CI_WORKFLOW) + evidence_guard = "test_milestone_e_package_publication_registry_assembly_evidence_review.py" + wording_guard = "test_milestone_e_package_publication_public_installation_wording_review.py" + public_facing_guard = "test_milestone_e_public_facing_readiness_ledger.py" + + for text, prefix in ((make_block, "$(PYTHON) .github/scripts/"), (ci, "python3 .github/scripts/")): + self.assertIn(prefix + wording_guard, text) + self.assertEqual(1, text.count(prefix + wording_guard)) + self.assertLess(text.index(prefix + evidence_guard), text.index(prefix + wording_guard)) + self.assertLess(text.index(prefix + wording_guard), text.index(prefix + public_facing_guard)) + + def test_record_avoids_scope_expansion_language_or_private_paths(self) -> None: + lower = normalized(RECORD).lower() + raw = read(RECORD) + + for phrase in FORBIDDEN_SCOPE_EXPANSION: + self.assertNotIn(phrase, 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_prep_guard_sequence_index.py b/.github/scripts/test_milestone_e_prep_guard_sequence_index.py index 3c8156a..47e7fe2 100644 --- a/.github/scripts/test_milestone_e_prep_guard_sequence_index.py +++ b/.github/scripts/test_milestone_e_prep_guard_sequence_index.py @@ -111,6 +111,7 @@ "$(PYTHON) .github/scripts/test_milestone_e_package_publication_approval_readiness_review.py", "$(PYTHON) .github/scripts/test_milestone_e_package_publication_manifest_activation_diff_review.py", "$(PYTHON) .github/scripts/test_milestone_e_package_publication_registry_assembly_evidence_review.py", + "$(PYTHON) .github/scripts/test_milestone_e_package_publication_public_installation_wording_review.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_public_beta_current_main_source_only_approval.py", diff --git a/.github/scripts/test_milestone_e_prep_scope.py b/.github/scripts/test_milestone_e_prep_scope.py index c754fc6..948591a 100644 --- a/.github/scripts/test_milestone_e_prep_scope.py +++ b/.github/scripts/test_milestone_e_prep_scope.py @@ -410,6 +410,7 @@ def test_make_target_is_narrow_and_guarded(self) -> None: "$(PYTHON) .github/scripts/test_milestone_e_package_publication_approval_readiness_review.py", "$(PYTHON) .github/scripts/test_milestone_e_package_publication_manifest_activation_diff_review.py", "$(PYTHON) .github/scripts/test_milestone_e_package_publication_registry_assembly_evidence_review.py", + "$(PYTHON) .github/scripts/test_milestone_e_package_publication_public_installation_wording_review.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_public_beta_current_main_source_only_approval.py", diff --git a/.github/scripts/test_milestone_e_validation_record_index.py b/.github/scripts/test_milestone_e_validation_record_index.py index 7628262..b89dd3e 100644 --- a/.github/scripts/test_milestone_e_validation_record_index.py +++ b/.github/scripts/test_milestone_e_validation_record_index.py @@ -278,6 +278,10 @@ class RecordCoverage: "milestone-e-package-publication-registry-assembly-evidence-review-validation-2026-06-21.md", "test_milestone_e_package_publication_registry_assembly_evidence_review.py", ), + RecordCoverage( + "milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md", + "test_milestone_e_package_publication_public_installation_wording_review.py", + ), RecordCoverage( "milestone-e-public-facing-readiness-ledger-validation-2026-06-21.md", "test_milestone_e_public_facing_readiness_ledger.py", @@ -404,6 +408,9 @@ def test_index_guards_run_after_row_and_schema_records(self) -> None: package_registry_evidence_review_guard = ( "test_milestone_e_package_publication_registry_assembly_evidence_review.py" ) + package_public_installation_wording_guard = ( + "test_milestone_e_package_publication_public_installation_wording_review.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" @@ -484,11 +491,23 @@ def test_index_guards_run_after_row_and_schema_records(self) -> None: ) self.assertLess( text.index(prefix + package_registry_evidence_review_guard), + text.index(prefix + package_public_installation_wording_guard), + ) + self.assertLess( + text.index(prefix + package_public_installation_wording_guard), text.index(prefix + readiness_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_public_installation_wording_guard), + text.index(prefix + command_guard), + ) + self.assertLess( + text.index(prefix + package_public_installation_wording_guard), + text.index(prefix + index_guard), + ) self.assertLess( text.index(prefix + package_registry_evidence_review_guard), text.index(prefix + command_guard), diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index a6a4da5..137b079 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -236,6 +236,8 @@ jobs: run: python3 .github/scripts/test_milestone_e_package_publication_manifest_activation_diff_review.py - name: Milestone E package publication registry-assembly evidence review tests run: python3 .github/scripts/test_milestone_e_package_publication_registry_assembly_evidence_review.py + - name: Milestone E package publication public installation wording review tests + run: python3 .github/scripts/test_milestone_e_package_publication_public_installation_wording_review.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 diff --git a/Makefile b/Makefile index 24a082f..fc81984 100644 --- a/Makefile +++ b/Makefile @@ -225,6 +225,7 @@ milestone-e-prep: $(PYTHON) .github/scripts/test_milestone_e_package_publication_approval_readiness_review.py $(PYTHON) .github/scripts/test_milestone_e_package_publication_manifest_activation_diff_review.py $(PYTHON) .github/scripts/test_milestone_e_package_publication_registry_assembly_evidence_review.py + $(PYTHON) .github/scripts/test_milestone_e_package_publication_public_installation_wording_review.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_public_beta_current_main_source_only_approval.py diff --git a/docs/execution-status.md b/docs/execution-status.md index 4729788..db2bb14 100644 --- a/docs/execution-status.md +++ b/docs/execution-status.md @@ -205,6 +205,8 @@ The package publication manifest-activation diff review in `docs/validation/mile The package publication registry-assembly evidence review in `docs/validation/milestone-e-package-publication-registry-assembly-evidence-review-validation-2026-06-21.md` records registry-backed dependent package assembly evidence requirements against source commit `3f0f3ed` / tree `6c748cd6f4a8de7789e42666697d1f25aa99f6f9`. No registry is created, registry-backed assembly is not activated, package publication remains blocked, and public installation remains blocked. +The package publication public installation wording review in `docs/validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md` records candidate wording and explicit exclusions against source commit `8b446e3` / tree `385dd7799cf898fc850555ce13d6d74e8ee15196`. The wording is not approved, package publication remains blocked, and public installation remains blocked. + | Work item | Current status | Remaining blocker | | --- | --- | --- | | PDFium Phase 1 profile | Landed: pinned profile, V8/XFA-disabled state, platform hashes, runtime library hashes, and provenance are recorded | Phase 2 project-maintained builds still block Public Beta | diff --git a/docs/milestone-e-package-publication-approval-prep.json b/docs/milestone-e-package-publication-approval-prep.json index cb814c0..124dd82 100644 --- a/docs/milestone-e-package-publication-approval-prep.json +++ b/docs/milestone-e-package-publication-approval-prep.json @@ -83,7 +83,8 @@ "package_decision_input_packet": "docs/validation/milestone-e-package-publication-decision-input-packet-validation-2026-06-21.md", "package_approval_readiness_review": "docs/validation/milestone-e-package-publication-approval-readiness-review-validation-2026-06-21.md", "package_manifest_activation_diff_review": "docs/validation/milestone-e-package-publication-manifest-activation-diff-review-validation-2026-06-21.md", - "package_registry_assembly_evidence_review": "docs/validation/milestone-e-package-publication-registry-assembly-evidence-review-validation-2026-06-21.md" + "package_registry_assembly_evidence_review": "docs/validation/milestone-e-package-publication-registry-assembly-evidence-review-validation-2026-06-21.md", + "package_public_installation_wording_review": "docs/validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md" }, "publication_approval_decision_inputs": { "decision_status": "not_approved_pending_exact_decision", diff --git a/docs/milestone-e-prep-scope.md b/docs/milestone-e-prep-scope.md index 2a5141f..3eee2b9 100644 --- a/docs/milestone-e-prep-scope.md +++ b/docs/milestone-e-prep-scope.md @@ -133,6 +133,11 @@ It records registry-backed dependent package assembly evidence requirements for `3f0f3ed` / tree `6c748cd6f4a8de7789e42666697d1f25aa99f6f9` while no registry is created, registry-backed assembly is not activated, package publication remains blocked, and public installation remains blocked. +The package publication public installation wording review is recorded in +`docs/validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md`. +It records candidate public installation wording and explicit exclusions for source commit +`8b446e3` / tree `385dd7799cf898fc850555ce13d6d74e8ee15196` while the wording is not approved, +package publication remains blocked, and public installation remains blocked. The metadata-readiness follow-up record under `docs/validation/` covers README, NOTICE, manifest metadata, and include-list readiness for `ethos-core`, `ethos-verify`, and `ethos-pdf` only. `ethos-doc` and `ethos-rag` remain reserved placeholders without in-tree package manifests, and diff --git a/docs/roadmap.md b/docs/roadmap.md index 69f6ade..0010f8f 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -185,6 +185,11 @@ for source commit `3f0f3ed` / tree `6c748cd6f4a8de7789e42666697d1f25aa99f6f9`. R dependent package assembly evidence requirements are recorded while no registry is created, registry-backed assembly is not activated, package publication remains blocked, and public installation remains blocked. +The package publication public installation wording review is recorded in +[`docs/validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md`](validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md) +for source commit `8b446e3` / tree `385dd7799cf898fc850555ce13d6d74e8ee15196`. Candidate +wording and explicit exclusions are recorded for later approval review only while package +publication remains blocked and public installation remains blocked. This prep only identifies tracked trust-loop fixture candidates and guard wiring for internal continuation; blocked-output alignment keeps the current trust-loop protocol, rehearsal/evidence matrix, blocker ledger, and matching schemas on the same explicit blockers, while evidence-lane diff --git a/docs/validation/README.md b/docs/validation/README.md index 826c557..b1d142f 100644 --- a/docs/validation/README.md +++ b/docs/validation/README.md @@ -356,6 +356,11 @@ recording the exact current-main source candidate and required follow-up evidenc dependent package assembly evidence requirements; the record binds the requirements to source commit `3f0f3ed` / tree `6c748cd6f4a8de7789e42666697d1f25aa99f6f9` while package publication remains blocked and public installation remains blocked. +- `milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md` - + package publication public installation wording review validation for candidate wording and + explicit exclusions; the record binds the wording review to source commit `8b446e3` / tree + `385dd7799cf898fc850555ce13d6d74e8ee15196` while package publication remains blocked and + public installation remains blocked. - `milestone-e-public-facing-readiness-ledger-validation-2026-06-21.md` - public-facing readiness ledger validation recorded `docs/milestone-e-public-facing-readiness-ledger.json` as a current-main refresh candidate and package-publication gap-retention artifact; current main diff --git a/docs/validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md b/docs/validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md new file mode 100644 index 0000000..730df3c --- /dev/null +++ b/docs/validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md @@ -0,0 +1,123 @@ +# Milestone E Package Publication Public Installation Wording Review Validation - 2026-06-21 + +## Purpose + +Record the public installation wording review boundary for the package publication approval lane +without approving public installation, package publication, Cargo manifest changes, package +dependency manifest activation, registry-backed dependent package assembly activation, package tag +creation, or package publication version selection. + +## Status + +Status: **pass for package public installation wording review with publication blocked**. + +Decision: record candidate public installation wording for later approval review only. + +Ethos remains source-only pre-alpha outside the approved GitHub source-repository public beta +surface. Package publication remains blocked. Public installation remains blocked. + +## Subject + +- Repository: `docushell/ethos` +- Validated source HEAD before this record: `8b446e3` +- Public installation wording review source commit: `8b446e3554c9b4b223e43ee46d218c47a7931c76` +- Public installation wording review source tree: `385dd7799cf898fc850555ce13d6d74e8ee15196` +- Lane: package publication +- Reviewed registry assembly evidence record: `docs/validation/milestone-e-package-publication-registry-assembly-evidence-review-validation-2026-06-21.md` + +## Candidate Wording Under Review + +Candidate public installation wording for later review only: + +```text +Ethos Rust crates are proposed for crates.io installation after dedicated package-publication approval. The first candidate crate surface is limited to ethos-doc-core, ethos-verify, and ethos-pdf. Wheels, npm packages, binaries, hosted surfaces, production positioning, public benchmark reports, public benchmark claims, release artifacts, project-maintained PDFium builds, ethos-doc, and ethos-rag remain excluded. +``` + +This candidate wording is not approved public wording and must not be used as installation +instructions until a later dedicated package publication approval decision records exact wording, +exact candidate crates, exact package version, exact package tag source binding, exact manifest +activation diff, exact registry-backed dependent package assembly evidence, and passing +public-surface posture and claims gates after the exact wording change. + +## Evidence Review + +- No public installation wording is approved by this record. +- Public installation remains blocked. +- Package publication remains blocked. +- The candidate wording limits any later approval review to `ethos-doc-core`, `ethos-verify`, and + `ethos-pdf`. +- `ethos-doc` and `ethos-rag` remain excluded. +- Wheels, npm packages, binaries, hosted surfaces, production positioning, public benchmark + reports, public benchmark claims, release artifacts, and project-maintained PDFium builds remain + excluded. +- The wording review must be followed by public-surface posture and claims gates after any exact + public installation wording change. + +## Approval Inputs Still Required + +- exact package publication approval decision record remains required +- decider signoff on the exact candidate version map remains required +- decider signoff on the exact package tag name set and source binding remains required +- package dependency manifest activation approval remains required +- registry-backed dependent package assembly evidence after manifest activation remains required +- exact public installation wording approval remains required +- public-surface posture check after exact public installation wording changes remains required +- claims gate after exact public installation wording changes remains required +- make milestone-e-prep after exact decision record remains required + +## Non-Approvals + +- this public installation wording review does not select a package publication version +- this public installation wording review does not create a package tag +- this public installation wording review does not change Cargo manifests +- this public installation wording review does not activate package dependency manifests +- this public installation wording review does not create a registry +- this public installation wording review does not activate registry-backed dependent package assembly +- this public installation wording review does not invite public installation +- this public installation wording review does not approve public installation wording +- this public installation wording review does not approve package publication + +## Retained Blockers + +- candidate package version map is recorded but no package publication version is selected +- candidate package tag names are recorded but no package tag is created +- candidate manifest activation diff is reviewed but no Cargo manifest is changed +- package dependency manifest activation remains blocked +- registry-backed dependent package assembly evidence remains required +- registry-backed dependent package assembly activation remains blocked +- public installation wording approval remains blocked +- public installation remains blocked +- package publication remains blocked +- real-version cargo publish remains blocked +- Public reports remain blocked +- Public result wording remains blocked + +## Commands + +```sh +python3 .github/scripts/test_milestone_e_package_publication_approval_prep.py +python3 .github/scripts/test_milestone_e_package_publication_registry_assembly_evidence_review.py +python3 .github/scripts/test_milestone_e_package_publication_public_installation_wording_review.py +python3 .github/scripts/test_public_surface_posture.py +python3 .github/scripts/claims_gate.py +cargo build --locked -p ethos-cli +make milestone-e-prep PYTHON=/bin/python +git diff --check +``` + +## Result + +```text +Package publication public installation wording review validation passed +Candidate public installation wording is recorded for later approval review only +No public installation wording was approved +No package version was selected +No package tag was created +No Cargo manifest was changed +No registry was created +No registry-backed assembly was activated +Package publication and public installation remained blocked +Public-surface posture and claims gates passed +Milestone E prep target passed +git diff --check passed +``` diff --git a/schemas/ethos-milestone-e-package-publication-approval-prep.schema.json b/schemas/ethos-milestone-e-package-publication-approval-prep.schema.json index d68922f..57d2b1d 100644 --- a/schemas/ethos-milestone-e-package-publication-approval-prep.schema.json +++ b/schemas/ethos-milestone-e-package-publication-approval-prep.schema.json @@ -291,7 +291,8 @@ "package_decision_input_packet", "package_approval_readiness_review", "package_manifest_activation_diff_review", - "package_registry_assembly_evidence_review" + "package_registry_assembly_evidence_review", + "package_public_installation_wording_review" ], "additionalProperties": false, "properties": { @@ -345,6 +346,9 @@ }, "package_registry_assembly_evidence_review": { "const": "docs/validation/milestone-e-package-publication-registry-assembly-evidence-review-validation-2026-06-21.md" + }, + "package_public_installation_wording_review": { + "const": "docs/validation/milestone-e-package-publication-public-installation-wording-review-validation-2026-06-21.md" } } },