optical-spec-agent v0.9.0rc9

optical-spec-agent v0.9.0rc9 Release Draft

This is GitHub release draft text only. The v0.9.0rc9 tag was manually created
and verified by the maintainer, the GitHub release has not been created, and
no TestPyPI or PyPI upload has been performed.
rc9 release draft preparation is approved and recorded. Tag creation approval
is recorded for manual maintainer action only; Codex / automation must not
create or push the tag. GitHub Release creation is approved for manual
maintainer action only; Codex / automation must not create or modify the
release. TestPyPI upload, PyPI publication, optional solver execution, and
v1.0.0 remain not approved.

English Summary

v0.9.0rc9 is a draft candidate after v0.9.0rc8 focused on release-readiness
governance and evidence consolidation. It records the unified rc9/v1 readiness
suite, decision records, go/no-go status, and no-skip readiness suite evidence.
It preserves conservative validation boundaries and does not claim
production-grade physical validation, production-grade solver validation,
formal convergence proof, or optical correctness.

中文简介

v0.9.0rc9 是 v0.9.0rc8 之后的候选草案，重点是 readiness governance、
证据链和 suite run evidence，而不是生产级验证声明。该草案记录 unified rc9/v1
readiness suite、decision records、go/no-go status 和 no-skip readiness suite
evidence，并继续保持保守的验证边界。

Highlights

• Unified readiness runner.
• Readiness evidence index.
• Suite review decision.
• Go/no-go current status.
• No-skip suite run evidence.
• Full readiness suite: 21 passed / 0 failed / 0 skipped.
• No solver, upload, tag, or release performed.
• Package, runtime, CI, API, and backend evidence audits.
• Public contract and frozen surface compatibility.
• PyPI and v1.0 remain separately gated.
• rc9 release draft preparation is approved and recorded.
• Version switch is approved and performed; tag/release/upload remain
  separately gated.
• Tag creation approval is granted for manual maintainer action only.
• Automation tag creation is not allowed by project policy.
• GitHub Release creation approval is granted for manual maintainer action only.
• Automation GitHub Release creation is not allowed by project policy.

Verification

• Full readiness suite: 21 passed / 0 failed / 0 skipped.
• Approval-gated post-version-switch readiness suite: 22 passed / 0 failed / 0
  skipped.
• Release-draft approval readiness suite: 22 passed / 0 failed / 0 skipped.
• Full pytest: 1005 passed, 4 warnings.
• python3.11 -m build: passed.
• Package, metadata, runtime, CI, API, and backend evidence audits: passed.
• PYTHON=python3.11 make check: passed after this draft note exists.
• NO SOLVER EXECUTION PERFORMED
• NO UPLOAD PERFORMED
• NO TAG CREATED
• NO RELEASE CREATED

Scope Limitations

• No PyPI publish.
• No TestPyPI upload.
• No automation tag creation.
• No automation GitHub Release creation.
• No production-grade physical validation.
• No production-grade solver validation.
• No formal convergence proof.
• No optical correctness claim.
• External solvers are not run by default.
• External LLMs are not called by default.
• Proprietary solvers are not default dependencies.
• Optional solver evidence is smoke/preflight evidence only.

Important Note

• v0.9.0rc8 tag remains unchanged.
• v0.9.0rc9 tag creation approval is recorded for manual maintainer action
  only.
• This task does not create a tag, push a tag, create a GitHub Release, upload
  TestPyPI, or publish PyPI.
• Version is now 0.9.0rc9 after the separate approved version switch.
• docs/rc9_release_draft_approval_review.md and
  docs/rc9_version_switch_preflight_checklist.md are review inputs only; they
  do not authorize automation tag creation, GitHub release creation,
  TestPyPI upload, PyPI publication, solver execution, or v1.0.0.

Post-tag Status

The v0.9.0rc9 tag was manually created and verified by the maintainer. Codex /
automation did not create or push the tag.

• docs/rc9_tag_creation_verification_2026-05-22.md
• docs/rc9_v1_readiness_suite_post_tag_run_2026-05-22.md
• validation/readiness/rc9_v1_readiness_suite_post_tag_2026-05-22.json

GitHub Release creation approval is recorded for manual maintainer action only,
and this draft text is still only draft text until the maintainer manually
creates the release. TestPyPI upload, PyPI publication, optional solver
execution, and v1.0.0 remain not approved.

optical-spec-agent v0.9.0rc8

optical-spec-agent v0.9.0rc8

English Summary

v0.9.0rc8 is the eighth release candidate for v0.9.0. It packages rc8
backend readiness work after v0.9.0rc7, including application domain benchmark
coverage, material provenance diagnostics, validation maturity boundaries,
optional solver evidence summaries, and optional solver-backed micro-benchmark
evidence for Gmsh, Optiland, Meep, and MPB.

PyPI publication remains unapproved and unpublished. v1.0.0 remains unreleased.
This candidate preserves conservative validation boundaries and does not claim
production-grade physical validation, production-grade solver validation,
optical correctness, or a formal convergence proof.

中文简介

v0.9.0rc8 是 v0.9.0 的第八个候选版本。它纳入 v0.9.0rc7 之后的 rc8 后端
readiness 工作，包括应用域 benchmark 覆盖、材料来源诊断、验证成熟度边界、
可选 solver evidence 汇总，以及 Gmsh、Optiland、Meep、MPB 的可选
solver-backed micro-benchmark 证据。

PyPI 仍未发布，仍需单独批准。v1.0.0 仍未发布。本候选版本继续保持保守验证边界，
不声称生产级物理验证、生产级 solver 验证、光学正确性或形式化收敛证明。

Highlights

• Application domain benchmarks: 19 pass / 0 warn / 0 fail.
• Material provenance and suitability diagnostics strengthened.
• Ambiguous requirement and missing-input diagnostics strengthened.
• Fiber coupling and polarization preview calculators added with reference
  sanity evidence.
• Backend validation maturity matrix added.
• Preview boundary policy added.
• Validation claim audit added.
• Optional solver micro-benchmark plan, approval matrix, environment profiles,
  and execution approval packets added.
• Optional solver evidence closed for:
  • Gmsh: executed, passed, reviewed, accepted.
  • Optiland: executed, passed, reviewed, accepted.
  • Meep: executed, passed, reviewed, accepted.
  • MPB: executed, passed, reviewed, accepted.
• Elmer remains deferred and not Level 3.
• Backend evidence pack, backend capability report, and validation maturity
  records updated.
• Agent Studio frontend, Chinese localization, quickstart, and local demo
  package remain available.

Adapter Maturity

• Gmsh: Level 3 plus optional manual micro-benchmark evidence.
• Meep: Level 3 plus optional manual micro-benchmark evidence.
• MPB: Level 3 plus optional manual micro-benchmark evidence.
• Optiland: Level 3 plus optional manual micro-benchmark evidence.
• Elmer: Level 2 plus Level-3-ready, install deferred.

Verification

• validation claim audit: passed.
• application domain benchmarks: 19 pass / 0 warn / 0 fail.
• sub-agent audit: passed.
• optional solver wrapper default no-execute: passed.
• backend evidence pack smoke: passed.
• backend capability smoke: passed.
• backend report smoke: passed.
• API fixture check: passed.
• API smoke: passed.
• TestPyPI no-upload preflight: passed.
• quality gates: passed.
• normal smoke: passed.
• wheel smoke: passed.
• pytest: passed.
• python -m build: passed.
• make check: passed.
• CLI examples: passed.
• dist files:
  • optical_spec_agent-0.9.0rc8-py3-none-any.whl
  • optical_spec_agent-0.9.0rc8.tar.gz

Scope Limitations

• No PyPI publish.
• No TestPyPI upload for 0.9.0rc8.
• No production-grade physical validation.
• No production-grade solver validation.
• No production-grade FDTD validation.
• No production-grade MPB validation.
• No production band-structure validation.
• No formal convergence proof.
• No optical correctness claim.
• External solvers are not run by default.
• External LLMs are not required by default.
• Proprietary solvers are not required by default.
• Elmer Level 3 validation is deferred.
• Calculator results are sanity-checked preview/design-assist.
• Optional solver micro-benchmarks are smoke evidence, not production
  validation.
• Adapter-native golden cases are preview metadata checks, not real solver
  monitor results.
• This release candidate is not final 1.0 stability.

Important Note

• v0.9.0rc1, v0.9.0rc2, v0.9.0rc3, v0.9.0rc4, v0.9.0rc5, v0.9.0rc6, and
  v0.9.0rc7 tags are unchanged.
• v0.9.0rc8 tag should be created only after maintainer approval.
• This task does not create a tag, create a GitHub release, or upload packages.
• PyPI publication remains separately gated.

optical-spec-agent v0.9.0rc7

optical-spec-agent v0.9.0rc7

English Summary

v0.9.0rc7 is the seventh release candidate for v0.9.0. It packages backend
evidence hardening and optical design agent capability expansion after
v0.9.0rc6. It adds backend evidence review decision support for rc7 draft
readiness.

This candidate adds the Material Library, optical design examples, design
requirement templates, sub-agent task sessions, tool-call ledger, local optical
calculators, source/monitor diagnostics, observable diagnostics, adapter-native
mappings, adapter golden coverage, and backend evidence review pack.

PyPI publication remains unapproved and unpublished. v1.0.0 remains unreleased.
The release draft preserves conservative validation boundaries.

中文简介

v0.9.0rc7 是 v0.9.0 的第七个候选版本，纳入 v0.9.0rc6 之后的后端证据加固和
光学设计 agent 能力扩展。

本候选版本已记录 backend evidence review decision，结论是可以准备 rc7 release
draft。新增材料库、光学设计示例、设计需求模板、子智能体任务会话、工具调用账本、
本地光学计算器、光源/监测诊断、observable 诊断、adapter-native 映射、adapter
golden coverage 和 backend evidence review pack。

PyPI 仍未发布，仍需单独批准。v1.0.0 仍未发布。仍不声称生产级物理验证或形式化收敛证明。

Highlights

• Backend evidence review decision recorded as sufficient for v0.9.0rc7 release draft.
• Material Library / 材料库 added.
• Optical design examples expanded.
• Design requirement templates added.
• Natural-language to optical-language matching added.
• Agent Command Center task sessions added.
• Tool-call ledger added.
• Local optical calculators deepened with reference sanity cases.
• Source/monitor inference and missing-input diagnostics added.
• Observable diagnostics added.
• Adapter-native source/monitor mapping added.
• Adapter-native golden cases and strict metadata diff checks added.
• Backend evidence review pack added.
• Agent Studio frontend, Chinese localization, quickstart, and local demo package remain available.
• PyPI remains unpublished.

Adapter Maturity

• Gmsh: Level 3
• Meep: Level 3
• MPB: Level 3
• Optiland: Level 3
• Elmer: Level 2 + Level-3-ready, install deferred

Verification

• backend evidence pack smoke: passed
• backend capability smoke: passed
• adapter-native golden checker: passed
• sub-agent audit: passed
• API fixture check: passed
• API smoke: passed
• quality gates: passed
• TestPyPI no-upload preflight: passed
• normal smoke: passed
• wheel smoke: passed
• pytest: 761 passed, 4 warnings
• python -m build: passed
• make check: passed
• CLI examples: passed
• dist files:
  • optical_spec_agent-0.9.0rc7-py3-none-any.whl
  • optical_spec_agent-0.9.0rc7.tar.gz

Scope Limitations

• No PyPI publish.
• No TestPyPI upload for 0.9.0rc7.
• 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.
• Elmer Level 3 validation deferred.
• Calculator results are sanity-checked preview/design-assist, not production-grade validation.
• Adapter-native golden cases are preview metadata checks, not real solver monitor results.
• RC is not final 1.0 stability.

Important Note

• v0.9.0rc1 / v0.9.0rc2 / v0.9.0rc3 / v0.9.0rc4 / v0.9.0rc5 / v0.9.0rc6 tags are unchanged.
• v0.9.0rc7 tag should be created only after maintainer approval.
• This task does not create tag/release or upload packages.
• PyPI publication remains separately gated.

optical-spec-agent v0.9.0rc6

optical-spec-agent v0.9.0rc6

English summary:

• v0.9.0rc6 is the sixth release candidate for v0.9.0.
• It packages post-v0.9.0rc5 v1.0 readiness hardening.
• It records successful TestPyPI Trusted Publishing for 0.9.0rc6.dev0.
• It records clean install verification from TestPyPI.
• It records approved v1.0 public contract freeze.
• It includes PyPI publication readiness and post-publication verification plans.
• It keeps PyPI publication unapproved and unpublished.
• It keeps v1.0.0 unreleased.
• It preserves conservative validation boundaries.

中文简介：

• v0.9.0rc6 是 v0.9.0 的第六个候选版本。
• 纳入 v0.9.0rc5 之后的 v1.0 readiness 加固。
• 已完成 0.9.0rc6.dev0 的 TestPyPI Trusted Publishing 和 clean install 验证。
• 已记录并批准 v1.0 public contract freeze。
• 已补齐 PyPI publication readiness checklist 和 post-publication verification plan。
• PyPI 仍未发布，仍需单独批准。
• v1.0.0 仍未发布。
• 仍不声称生产级物理验证或形式化收敛证明。

Highlights:

• TestPyPI Trusted Publishing verified for 0.9.0rc6.dev0.
• CI and GitHub Actions workflow gates stabilized.
• v1.0 public contract freeze approved.
• PyPI publication readiness checklist added.
• PyPI post-publication verification plan added.
• Publication decision boundaries clarified.
• Adapter maturity remains:
  • Gmsh: Level 3
  • Meep: Level 3
  • MPB: Level 3
  • Optiland: Level 3
  • Elmer: Level 2 + Level-3-ready, install deferred

Verification:

• quality gates: passed
• TestPyPI no-upload preflight: passed
• normal smoke: passed
• wheel smoke: passed
• pytest: passed
• python -m build: passed
• make check: passed
• CLI examples: passed
• dist files:
  • optical_spec_agent-0.9.0rc6-py3-none-any.whl
  • optical_spec_agent-0.9.0rc6.tar.gz

Scope limitations:

• no PyPI publish
• no TestPyPI upload for 0.9.0rc6
• no production-grade physical validation
• no formal convergence proof
• external solvers not run by default
• external LLM not required by default
• proprietary solvers not required by default
• Elmer Level 3 validation deferred
• workflow remains local/synchronous preview
• RC is not final 1.0 stability

Important note:

• v0.9.0rc1 / v0.9.0rc2 / v0.9.0rc3 / v0.9.0rc4 / v0.9.0rc5 tags are unchanged.
• v0.9.0rc6 tag should be created only after maintainer approval.
• This task does not create tag/release or upload packages.
• PyPI publication remains separately gated.

optical-spec-agent v0.9.0rc5

optical-spec-agent v0.9.0rc5

English Summary

v0.9.0rc5 is the fifth release candidate for v0.9.0. It packages the
post-v0.9.0rc4 v1.0 readiness hardening on main, with a focus on repeatable
quality gates, operations readiness, public contract evidence, adapter maturity,
and optional open-source-solver validation boundaries.

This release draft includes optional manual validation evidence for Gmsh, Meep,
MPB, and Optiland. Elmer has a Level-3-ready path, but remains Level 2 because
ElmerSolver is not currently available in the maintained local package routes
tested for this environment. The Elmer deferred record is
validation/elmer/elmer_install_deferred_2026-05-15.md.

The draft also improves Python-aware solver preflight, no-upload quality gates,
release dry-run governance, secrets hygiene, offline user journey evidence,
public contract freeze evidence, and validation manifests. PyPI is not
published, and TestPyPI is not uploaded.

中文简介

v0.9.0rc5 是 v0.9.0 的第五个候选版本，纳入 v0.9.0rc4 之后的 v1.0
readiness 加固。

Gmsh / Meep / MPB / Optiland 已记录窄范围 optional manual validation
evidence。Elmer 已具备 Level-3-ready 路径，但由于当前缺少 ElmerSolver，
仍保持 Level 2 + deferred。

本候选版本仍不声称生产级物理验证，也不声称形式化收敛证明。PyPI/TestPyPI
仍未发布/上传。

Highlights

• Open-source-solver-first release engineering.
• One-command local quality gates.
• CI/workflow parity and release dry-run operations docs.
• Python-aware solver availability preflight.
• Adapter maturity model for Meep, Gmsh, Elmer, MPB, and Optiland.
• Optional manual validation evidence for Gmsh, Meep, MPB, and Optiland.
• Elmer Level-3-ready documentation with an install-deferred record.
• Public contract freeze candidate and public contract manifest.
• Offline examples, examples manifest, and offline end-to-end user journey.
• Validation evidence manifest.
• Packaging and validation gates.
• Wheel install smoke.
• No proprietary solver dependency by default.
• No external solver or external LLM required by default.

Verification

• Quality gates: passed.
• TestPyPI no-upload preflight: passed.
• Normal smoke: passed.
• Wheel smoke: passed.
• pytest: 475 passed, 4 warnings.
• python -m build: passed.
• make check: passed.
• CLI examples: passed.
• E2E example: passed.
• Dist files:
  • optical_spec_agent-0.9.0rc5-py3-none-any.whl
  • optical_spec_agent-0.9.0rc5.tar.gz

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.
• Elmer Level 3 validation is deferred.
• Workflow remains a local/synchronous preview.
• This release candidate is not final 1.0 stability.

Important Note

• v0.9.0rc1, v0.9.0rc2, v0.9.0rc3, and v0.9.0rc4 tags are unchanged.
• v0.9.0rc5 tag should be created only after maintainer approval.
• This task does not create a tag, create a GitHub release, or upload packages.

optical-spec-agent v0.9.0rc4

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.

optical-spec-agent v0.9.0rc3

optical-spec-agent v0.9.0rc3

English Summary

v0.9.0rc3 is the third release candidate for the v0.9.0 line. It includes
the v1.0 readiness hardening work that landed after the verified v0.9.0rc2
pre-release.

Highlights:

• Moves main from 0.9.0rc3.dev0 to the 0.9.0rc3 release-candidate draft
  state.
• Adds and stabilizes v1.0 readiness contracts.
• Adds or updates CLI contract coverage.
• Adds schema contract coverage.
• Adds adapter support matrix coverage.
• Adds workflow preview contract coverage.
• Adds validation boundary documentation.
• Adds PyPI/TestPyPI decision documentation and packaging gates.
• Adds validation gate documentation.
• Adds optional external solver and external LLM policy docs.
• Adds a wheel install smoke path to the release smoke script.
• Confirms clean install with the test extra.
• Confirms pytest passes.
• Confirms python -m build passes.
• Confirms make check passes.
• Confirms documented offline optical-spec CLI examples pass.

中文简介

v0.9.0rc3 是 v0.9.0 的第三个候选版本，纳入了 v0.9.0rc2
之后的 v1.0 readiness 加固工作。

本候选版本包括：

• CLI / schema / adapter / workflow contract 文档与测试加固。
• validation boundary、packaging gate、validation gate 和 PyPI decision gate。
• external solver / external LLM 默认不启用的策略文档。
• release smoke script 的 wheel install smoke 路径。
• pytest 通过：357 passed, 4 warnings。
• python -m build 通过。
• make check 通过。
• optical-spec 离线 CLI 示例通过。
• PyPI / TestPyPI 仍未发布。

Verification

• scripts/smoke_release.sh: passed.
• Wheel install smoke: passed.
• pytest: 357 passed, 4 warnings.
• python -m build: passed.
• make check: passed.
• CLI examples passed:
  • optical-spec --help
  • optical-spec adapter-list --json
  • optical-spec schema
  • optical-spec parse
  • optical-spec validate
  • optical-spec workflow-plan --json
• 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 providers are not required by default.
• Adapter outputs may still be MVP/scaffold unless explicitly validated.
• Workflow orchestration is a local/synchronous preview.
• This release candidate is not final 1.0 stability.

Important Note

• The v0.9.0rc1 and v0.9.0rc2 tags are unchanged.
• v0.9.0rc3 should be created as a new annotated tag only after final
  readiness checks pass.
• This draft does not publish PyPI or TestPyPI.
• This draft does not create or move any tag.

optical-spec-agent v0.9.0rc2

optical-spec-agent v0.9.0rc2

English Summary

v0.9.0rc2 is the next release candidate for the v0.9.0 line. It follows
v0.9.0rc1 and focuses on the post-release smoke-test dependency fix and
release automation added on main.

What changed since v0.9.0rc1:

• Adds an explicit test extra with pytest and httpx.
• Fixes the clean test environment failure caused by missing httpx for the
  FastAPI / Starlette TestClient.
• Adds scripts/smoke_release.sh for repeatable release smoke testing.
• Adds docs/release_readiness_v0.9.0rc2.md.
• Confirms clean install with the test extra.
• Confirms pytest passes.
• Confirms package build passes.
• Confirms optical-spec --help passes.

中文简介

v0.9.0rc2 是 v0.9.0 的第二个候选版本。它包含 v0.9.0rc1
发布后发现的测试依赖修复，并把 release smoke test 固化为自动化脚本。

本候选版本确认：

• clean venv 中可通过 python -m pip install -e ".[test]" 安装测试依赖。
• pytest 通过：331 passed, 4 warnings。
• python -m build 通过。
• optical-spec --help 通过。
• 新增 release smoke test 自动化脚本：scripts/smoke_release.sh。

Verification

• scripts/smoke_release.sh: passed
• pytest: 331 passed, 4 warnings
• build: passed
• CLI help: optical-spec --help passed
• PyPI: not published

Scope Limitations

• No PyPI publish.
• No production-grade physical validation.
• No formal convergence proof.
• External solvers are not run by default.
• External LLM providers are not required by default.
• Adapter outputs remain MVP/scaffold.
• Workflow orchestration is local/synchronous preview.
• RC is not final 1.0 stability.

Important Note

The v0.9.0rc1 tag is unchanged. v0.9.0rc2 should be created as a new tag
from the appropriate main commit after readiness checks pass.

optical-spec-agent v0.9.0rc1

GitHub Release Draft: v0.9.0rc1

This file is a maintainer draft only. Do not treat it as evidence that a
GitHub release, git tag, or PyPI package has been published.

Release Title

optical-spec-agent v0.9.0rc1

Release Type

Release candidate / preview / not final stable.

Suggested Tag

v0.9.0rc1

Summary

This release candidate packages the current main-branch engineering surface:

• v0.6 local/manual post-hoc diagnostics.
• v0.7 multi-solver adapter MVP scaffolds for Meep, MPB, Gmsh, Elmer, and
  Optiland.
• v0.8 provider-agnostic LLM parser foundation with deterministic mock
  provider and conservative hybrid parser.
• v0.9 synchronous local workflow orchestration with auditable artifacts,
  replay, reports, and human-review checklists.
• Release engineering quality gates for tests, benchmarks, docs consistency,
  CLI surface, artifact contracts, package build, and release dry-runs.

中文简介

v0.9.0rc1 是 optical-spec-agent 的 release candidate，不是最终稳定
1.0。它把中英文自然语言光学仿真需求转换为经过校验的 OpticalSpec JSON，
并可生成 Meep / MPB / Gmsh / Elmer / Optiland 的 solver-native input
scaffold。本项目不是求解器，不提供 production-grade physical validation，也
不提供 formal convergence proof。外部 solver 默认不运行，外部 LLM 默认不
需要；workflow 是本地同步 preview。完整中文说明见 README.zh-CN.md。

What Changed

• Added optical-spec diagnose for post-hoc diagnostics.
• Added optical-spec adapter-list and optical-spec adapter-generate for
  solver-native input scaffold generation.
• Added optical-spec llm-eval for deterministic mock-provider parser
  evaluation.
• Added optical-spec workflow-plan, workflow-run, workflow-replay, and
  workflow-report.
• Added CI workflows for deterministic local quality gates, manual benchmark
  reports, docs/contract checks, and release dry-run builds.
• Added Makefile quality gates for tests, benchmarks, docs, CLI, release, and
  artifact contract checks.
• Added release engineering scripts for CLI surface, docs consistency, release
  readiness, artifact contracts, and demo output regeneration.
• Added artifact, API, CLI, benchmark, security, robustness, versioning, and
  release-readiness documentation.

Verification

Most recent known local validation before this draft:

• pip install -e ".[dev]": passed
• pytest -q: 329 passed, 4 warnings
• key_fields benchmark: 16/16 passed
• semantic benchmark: 27/27 passed
• LLM benchmark: 40/40 passed
• workflow benchmark: 12/12 passed
• make check: passed
• docs-check: ready
• cli-check: ready
• release-check: ready
• artifact-check: ready
• python -m build: passed
• twine check dist/*: passed

Maintainers should verify GitHub Actions after pushing the release-candidate
commit.

Installation

If this candidate is published to PyPI after separate approval:

pip install optical-spec-agent==0.9.0rc1

This task does not publish to PyPI.

Known Limitations

• No production-grade physical validation.
• No formal convergence proof.
• No full solver automation.
• External solvers are not run by default.
• External LLM providers are not required by default.
• The mock LLM provider is deterministic test infrastructure, not proof of
  real model quality.
• Adapter outputs are MVP/scaffold unless separately validated.
• Workflow orchestration is synchronous/local preview.
• Meep execution remains optional/local.
• This is not a final stable 1.0 API.

Manual Maintainer Steps

1. Review the final diff on main.

2. Push main and verify GitHub Actions.

3. Create the tag manually only after approval:

   git tag v0.9.0rc1
   git push origin v0.9.0rc1

4. Draft a GitHub pre-release using this file.

5. Attach release_readiness_report.json if desired.

6. Publish to PyPI only after separate approval.

v0.2.0 — Spec Hardening + Meep Adapter Preview

Overview

optical-spec-agent v0.2.0 adds a Meep adapter preview that converts validated spec JSON into runnable Meep Python scripts. The main pipeline is now:

Natural language → Rule-based parser → Structured spec JSON → Validation → Meep script generation

This release also hardens the spec schema and adds dual-mode benchmarks.

What's New in v0.2.0

Meep adapter (preview)

• Script generation: validated OpticalSpec → complete Meep Python script (.py)
• CLI: optical-spec meep-generate <spec.json> -o out.py
• Supported path (strictly limited):
  • physical_system: nanoparticle_on_film
  • solver_method: fdtd
  • software_tool: meep
  • excitation_source: plane_wave
  • output_observables: scattering_spectrum
• Materials: simplified Drude model for Au/Ag (placeholder; production needs Johnson–Christy data)
• Geometry: sphere, cube, cylinder particles on single-layer film
• Post-processing: resonance peak finding, FWHM extraction, T₂ estimation
• Sweep: gap thickness parameter sweep
• Smoke test: minimal local run validation (auto-skip if Meep not installed)

Spec hardening

• Schema stability policy
• Expanded dual-mode benchmarks (exact match + key-fields)
• Stricter cross-field validation
• Demo gallery and community templates

Current Scope

Capability	Status
Natural language → spec JSON	Rule-based (keyword + regex)
Spec validation	Full 5-section validation with task-type awareness
Meep script generation	Preview — nanoparticle_on_film only
Meep smoke test	Local optional (auto-skip without Meep)
LLM parser	Placeholder only
Solver execution	Not included
Result parsing	Not included
Visualization pipeline	Not included

Current Limitations

• Meep adapter covers only nanoparticle_on_film + fdtd + plane_wave + scattering_spectrum
• Material models are simplified (single-Drude), not production-grade
• No solver execution or result parsing — the user runs the generated script manually
• Parser is rule-based only; no LLM integration
• No Lumerical, COMSOL, or other solver adapters yet

Next Focus

Version	Goal
v0.3	Meep adapter hardening: production material models, expanded geometry
v0.4	Lumerical adapter (spec → .lsf)
v0.5	LLM parser integration

---

概述

optical-spec-agent v0.2.0 新增 Meep adapter 预览版，可将已验证的 spec JSON 转换为可运行的 Meep Python 脚本。主流程扩展为：

自然语言 → 规则解析器 → 结构化 spec JSON → 校验 → Meep 脚本生成

同时强化了 spec schema 和双模式 benchmark。

v0.2.0 新增内容

• Meep adapter 预览：spec → Meep Python 脚本，支持 nanoparticle_on_film + fdtd + plane_wave + scattering_spectrum
• CLI 命令：optical-spec meep-generate
• Smoke test：本地最小运行验证（无 Meep 环境自动跳过）
• Spec 强化：schema stability policy、双模式 benchmark、更严格的跨字段校验

当前局限

• Meep adapter 仅覆盖 nanoparticle_on_film 最小路径
• 材料模型为简化 Drude，非生产级
• 无求解器执行、结果解析或可视化管线
• 解析器仍为规则型，无 LLM 集成