Prepare v0.9.0rc4 release draft

Author: zixiao146-design

README.md

@@ -32,9 +32,9 @@ COMSOL, or proprietary Ansys tools. External solvers are optional and not run by
 default. External LLM access is optional and not required by default.
 
 Release status: the current public release candidate is `v0.9.0rc3`, while the
-current `main` development version is `0.9.0rc4.dev0`. `main` may contain
-post-`v0.9.0rc3` hardening changes. `v0.9.0rc4.dev0` is not a public release,
-and the `v0.9.0rc4` tag has not been created.
+current `main` release draft is `0.9.0rc4`. `main` contains post-`v0.9.0rc3`
+hardening changes prepared for maintainer review. The `v0.9.0rc4` tag and
+GitHub release have not been created.
 It includes v0.6 local/manual diagnostics, v0.7 multi-solver adapter MVP
 scaffolds, v0.8 LLM parser foundation work, and v0.9 synchronous workflow
 orchestration foundation work as preview/scaffold/evaluation capabilities.
@@ -49,7 +49,7 @@ current release policy and release-readiness matrix. Use
 for the repeatable RC procedure and
 [`docs/v1_0_readiness_plan.md`](docs/v1_0_readiness_plan.md) for the path from
 the current RC line toward `v1.0`.
-Current rc4 development readiness and publication gates are tracked in
+Current rc4 release draft readiness and publication gates are tracked in
 [`docs/release_readiness_v0.9.0rc4.md`](docs/release_readiness_v0.9.0rc4.md),
 [`docs/testpypi_dry_run_gate.md`](docs/testpypi_dry_run_gate.md), and
 [`docs/v1_0_stability_gate.md`](docs/v1_0_stability_gate.md).
@@ -89,8 +89,8 @@ optical-spec-agent 是一个开源仿真工具链优先的光学仿真工作流
 一个面向光学仿真的规格编译层：它把中英文自然语言
 仿真需求转换为经过校验的 OpticalSpec JSON，并可进一步生成 Meep / MPB /
 Gmsh / Elmer / Optiland 的 solver-native input scaffold。当前公开
-pre-release 是 `v0.9.0rc3`，当前 `main` package version 是 `0.9.0rc4.dev0`。
-`main` 可能包含 post-`v0.9.0rc3` hardening changes；`v0.9.0rc4.dev0` 不是公开
+pre-release 是 `v0.9.0rc3`，当前 `main` package version 是 `0.9.0rc4`。
+`main` 可能包含 post-`v0.9.0rc3` hardening changes；`v0.9.0rc4` 不是公开
 release，`v0.9.0rc4` tag 尚未创建，也不是最终稳定版。
 本项目不是求解器，也不提供 production-grade physical validation。完整中文文档见
 [README.zh-CN.md](README.zh-CN.md)。
@@ -132,7 +132,7 @@ Optical simulation tasks are inherently multi-parameter: geometry, materials, so
 - **Output**: typed, validated spec JSON with per-field provenance (confirmed / inferred / missing)
 - **Contract**: every field carries its status and derivation note, so downstream agents know what to trust and what to verify
 
-## Current scope (main `0.9.0rc4.dev0`: post-v0.9.0rc3 hardening)
+## Current scope (main `0.9.0rc4`: post-v0.9.0rc3 hardening)
 
 `v0.6` diagnostics are post-hoc, local/manual checks around generated Meep run
 artifacts. `v0.7` adapters generate annotated solver-input scaffolds for
@@ -231,7 +231,7 @@ no-proprietary-solver flow, see
 [`examples/e2e/README.md`](examples/e2e/README.md).
 
 The checked-in fixtures under [`examples/`](examples/README.md) are the
-canonical no-network examples for the current `0.9.0rc4.dev0` main branch and
+canonical no-network examples for the current `0.9.0rc4` main branch and
 the public `v0.9.0rc3` RC line:
 
 ```bash

README.zh-CN.md

@@ -36,10 +36,9 @@ PyPI/TestPyPI 仍未发布/上传。
 
 ## 发布状态
 
-当前公开 release candidate 是 `v0.9.0rc3`。当前 `main` 的 package version 是
-`0.9.0rc4.dev0`，可能包含 post-`v0.9.0rc3` hardening changes。
-`v0.9.0rc4.dev0` 不是公开 release，`v0.9.0rc4` tag 尚未创建；这仍然不是
-final stable `1.0`。
+当前公开 release candidate 是 `v0.9.0rc3`。当前 `main` 的 release draft
+version 是 `0.9.0rc4`，包含 post-`v0.9.0rc3` hardening changes。
+`v0.9.0rc4` tag 和 GitHub release 尚未创建；这仍然不是 final stable `1.0`。
 
 `v0.6` 到 `v0.9` 的能力属于 preview/scaffold/evaluation capabilities：
 
@@ -159,7 +158,7 @@ pip install -e ".[dev]"
 完整的无网络、无外部 solver、无外部 LLM、无 proprietary solver 默认依赖的
 端到端路径见 `docs/offline_user_journey.md` 和 `examples/e2e/README.md`。
 
-`examples/` 目录中的 fixture 是当前 `0.9.0rc4.dev0` main 和公开
+`examples/` 目录中的 fixture 是当前 `0.9.0rc4` main 和公开
 `v0.9.0rc3` RC 线的本地示例证据：
 
 ```bash

docs/adapter_support_matrix.md

@@ -1,7 +1,7 @@
 # Adapter Support Matrix
 
 Version scope: current public prerelease `v0.9.0rc3`; current `main`
-development version `0.9.0rc4.dev0`. `v0.9.0rc4.dev0` is not a release, the
+development version `0.9.0rc4`. `v0.9.0rc4` is not a release, the
 `v0.9.0rc4` tag has not been created, and PyPI/TestPyPI remain unpublished.
 Continue v1.0 readiness engineering and prepare a `v0.9.0rc4` release draft
 only when accumulated changes should be published as another RC.

docs/cli_contract.md

@@ -1,7 +1,7 @@
 # CLI Contract
 
 Version scope: current public prerelease `v0.9.0rc3`; current `main`
-development version `0.9.0rc4.dev0`. `v0.9.0rc4.dev0` is not a release, the
+development version `0.9.0rc4`. `v0.9.0rc4` is not a release, the
 `v0.9.0rc4` tag has not been created, and PyPI/TestPyPI remain unpublished.
 Continue v1.0 readiness engineering and prepare a `v0.9.0rc4` release draft
 only when accumulated changes should be published as another RC.

docs/external_llm_policy.md

@@ -2,8 +2,8 @@
 
 External LLM access is not required by default.
 
-Current public prerelease: `v0.9.0rc3`. Current main development version:
-`0.9.0rc4.dev0`. `v0.9.0rc4.dev0` is not a release, the `v0.9.0rc4` tag has
+Current public prerelease: `v0.9.0rc3`. Current main release draft:
+`0.9.0rc4`. `v0.9.0rc4` is not a release, the `v0.9.0rc4` tag has
 not been created, and PyPI/TestPyPI remain unpublished. Continue v1.0 readiness
 engineering and prepare a `v0.9.0rc4` release draft only when accumulated
 changes should be published as another RC.

docs/external_solver_policy.md

@@ -4,8 +4,8 @@ External solvers are not run by default. optical-spec-agent is
 open-source-solver-first: the default route is local artifact preview and
 offline evidence, not automatic solver execution.
 
-Current public prerelease: `v0.9.0rc3`. Current main development version:
-`0.9.0rc4.dev0`. `v0.9.0rc4.dev0` is not a release, the `v0.9.0rc4` tag has
+Current public prerelease: `v0.9.0rc3`. Current main release draft:
+`0.9.0rc4`. `v0.9.0rc4` is not a release, the `v0.9.0rc4` tag has
 not been created, and PyPI/TestPyPI remain unpublished. Continue v1.0 readiness
 engineering and prepare a `v0.9.0rc4` release draft only when accumulated
 changes should be published as another RC.

docs/github_release_draft_v0.9.0rc4.md

@@ -0,0 +1,78 @@
+# optical-spec-agent v0.9.0rc4
+
+## English summary
+
+`v0.9.0rc4` is the fourth release candidate for the `v0.9.0` line. It packages
+the v1.0 readiness hardening accumulated after `v0.9.0rc3`.
+
+Highlights include:
+
+- Open-source-solver-first product strategy.
+- Broader adapter family evidence for Meep, Gmsh, Elmer, MPB, and Optiland.
+- Offline examples and `examples/examples_manifest.json`.
+- Offline end-to-end user journey.
+- Error model and pre-v1 migration notes.
+- Public contract freeze candidate.
+- Public contract manifest.
+- Validation evidence manifest.
+- TestPyPI no-upload preflight.
+- Packaging and validation gates.
+- Wheel install smoke.
+- No proprietary solver dependency by default.
+- No external solver or external LLM required by default.
+
+## 中文简介
+
+`v0.9.0rc4` 是 `v0.9.0` 的第四个候选版本，纳入了 `v0.9.0rc3`
+之后的 v1.0 readiness 加固。
+
+本候选版本明确 open-source-solver-first 定位，扩展了 Meep、Gmsh、Elmer、
+MPB、Optiland 的 adapter family evidence，增加了离线端到端用户旅程、
+public contract freeze candidate、public contract manifest、TestPyPI
+no-upload preflight，以及 packaging / validation gates。
+
+PyPI 仍未发布，TestPyPI 仍未上传。
+
+## Verification
+
+- `scripts/testpypi_preflight.sh`: passed
+- `scripts/smoke_release.sh`: passed
+- Wheel install smoke: passed
+- `pytest`: 429 passed, 4 warnings
+- `python -m build`: passed
+- `make check`: passed
+- CLI examples passed:
+  - `optical-spec --help`
+  - `optical-spec adapter-list --json`
+  - `optical-spec validate examples/specs/minimal_nanoparticle.json`
+  - `optical-spec parse examples/specs/minimal_nanoparticle.json --json`
+  - `optical-spec workflow-plan examples/workflows/local_preview_request.json --json`
+  - `optical-spec workflow-plan examples/e2e/local_optical_workflow.json --json`
+- Dist files:
+  - `optical_spec_agent-0.9.0rc4-py3-none-any.whl`
+  - `optical_spec_agent-0.9.0rc4.tar.gz`
+- PyPI: not published
+- TestPyPI: not uploaded
+
+## Scope limitations
+
+- No PyPI publish.
+- No TestPyPI upload.
+- No production-grade physical validation.
+- No formal convergence proof.
+- External solvers are not run by default.
+- External LLM is not required by default.
+- Proprietary solvers are not required by default.
+- Adapter outputs may still be MVP/scaffold unless explicitly validated.
+- Workflow is local/synchronous preview.
+- This RC is not final 1.0 stability.
+
+## Important note
+
+- `v0.9.0rc1`, `v0.9.0rc2`, and `v0.9.0rc3` tags are unchanged.
+- `v0.9.0rc4` should be created as a new annotated tag only after final
+  readiness checks pass.
+- This draft does not create or move any tag.
+- This draft does not create a GitHub release.
+- This draft does not upload TestPyPI.
+- This draft does not publish PyPI.

docs/migration_notes_pre_v1.md

@@ -3,7 +3,7 @@
 ## Current status
 
 - Current public prerelease: v0.9.0rc3
-- Current main development version: 0.9.0rc4.dev0
+- Current main release draft: 0.9.0rc4
 - v1.0.0 not released
 - PyPI/TestPyPI not published/uploaded
 - Public contract freeze candidate: `docs/v1_0_public_contract_freeze.md`

docs/offline_user_journey.md

@@ -9,7 +9,7 @@ no proprietary software, and no proprietary optical software.
 ## Current version scope
 
 - Current public prerelease: v0.9.0rc3
-- Current main development version: 0.9.0rc4.dev0
+- Current main release draft: 0.9.0rc4
 - PyPI/TestPyPI: not published / not uploaded
 - v0.9.0rc4 tag: not created
 

docs/packaging_gate.md

@@ -1,24 +1,24 @@
 # Packaging Gate
 
-Version scope: current `main` development version `0.9.0rc4.dev0` after the
+Version scope: current `main` release draft `0.9.0rc4` after the
 verified public `v0.9.0rc3` prerelease.
 
 ## Current package baseline
 
 - Package name: `optical-spec-agent`
-- Current package version on `main`: `0.9.0rc4.dev0`
-- Current main development version: `0.9.0rc4.dev0`
+- Current package version on `main`: `0.9.0rc4`
+- Current main release draft: `0.9.0rc4`
 - Current public prerelease: `v0.9.0rc3`
 - Product positioning: open-source-solver-first
 - `v0.9.0rc1`, `v0.9.0rc2`, and `v0.9.0rc3` tags remain unchanged.
-- `v0.9.0rc4.dev0` is not a public release.
+- `v0.9.0rc4` GitHub release: not created
 - `v0.9.0rc4` tag: not created
 - PyPI status: not published
 - TestPyPI status: not published
 - TestPyPI dry-run gate doc: `docs/testpypi_dry_run_gate.md`
 - TestPyPI no-upload preflight script: `scripts/testpypi_preflight.sh`
 - TestPyPI upload approval record:
-  `docs/testpypi_upload_approval_v0.9.0rc4.dev0.md`
+  `docs/testpypi_upload_approval_v0.9.0rc4.md`
 - TestPyPI upload approval status: pending
 - TestPyPI upload authorized: no
 - PyPI publication approval: not granted
@@ -28,8 +28,8 @@ verified public `v0.9.0rc3` prerelease.
 - Build backend: `hatchling`
 - Console script: `optical-spec`
 - Expected build artifacts for current main:
-  - `optical_spec_agent-0.9.0rc4.dev0-py3-none-any.whl`
-  - `optical_spec_agent-0.9.0rc4.dev0.tar.gz`
+  - `optical_spec_agent-0.9.0rc4-py3-none-any.whl`
+  - `optical_spec_agent-0.9.0rc4.tar.gz`
 
 ## Packaging checks required before publication
 
@@ -73,7 +73,7 @@ verified public `v0.9.0rc3` prerelease.
   GitHub releases.
 - TestPyPI upload requires explicit maintainer approval.
 - Approval remains pending in
-  `docs/testpypi_upload_approval_v0.9.0rc4.dev0.md`.
+  `docs/testpypi_upload_approval_v0.9.0rc4.md`.
 - TestPyPI upload must not be part of the default smoke script.
 - Wheel smoke remains local only.
 - Smoke script must not publish or upload packages.