Optical Design 2.0.0

2.0.0 — 2026-09-14

The skill now guides the coding agent instead of wrapping it: knowledge, recipes and
discipline in the skill, computation in code the agent writes against Optiland or
OpticStudio. The audited job runner remains as an optional mode with unchanged algorithms.

• Reframe the skill around guiding the coding agent: a one-screen SKILL.md with the
  workflow and discipline, an Optiland recipes reference with executable, tested snippets,
  an aberrations primer, a diagnosis template, a rewritten merit-function recipe, and
  rewritten microscopy and OCT design references.
• Add inspect_zmx.py (opens any OpticStudio export through Optiland and classifies its
  directives), first_order.py (paraxial gate with optional pass/fail spec) and
  render_review.py (summary.json plus PNGs to a self-contained review page).
• Add an eleven-form starting-point library in .zmx and Optiland JSON with commentary,
  five eval scenarios with checkable assertions, and a first-order ground-truth checker.
• Move the job-runner documentation under references/audited/ as the audited mode.
• Remove committed release-evidence trees (docs/research/, 98 MB of receipts and logs),
  internal planning documents (docs/superpowers/), the product brief and the deployment
  explainer from the main branch. Evidence stays available at the v1.0.0 and v1.1.0 tags.
• Move the brand guide to assets/brand/README.md; merge the example page into the quickstart.
• Add docs/roadmap/2026-09-14-adoption-review.md: an audit with a prioritized plan.

Upgrade

Run npx optical-design@2.0.0 update --agent codex (or your existing installer target). Existing optical algorithms remain available in the optional audited mode. References for that mode moved to references/audited/; update direct links and scripts that refer to the old documentation paths. Historical research receipts are retained at the v1 tags.

Verification and recovery

The release tarball contains 165 files; historical research trees, worktrees, caches and temporary outputs are excluded. See the attached SHA256 checksum and npm integrity receipt. Native OpticStudio requires its separately installed Windows engine and license; this release does not claim fresh native-engine validation on the release host.

For a regression, pin optical-design@1.1.0; maintainers can restore npm's latest tag to 1.1.0 without deleting this release.
Release checks: all 11 CI jobs passed on the tagged commit. Local package/demo, typecheck, lint and dependency audit passed. A local Python job timeout passed when rerun from identical source outside OneDrive; details are in verification.json.

npm status: optical-design@2.0.0 is published and is the latest release. A fresh public registry install passed, and its integrity matches the verified release tarball.