Future: WorkGraph stable release

[GeigerJ2]

WorkGraph1.0 Release

Goal: deliver a stable user-facing API for aiida-workgraph, with up-to-date docs. Non-essential/volatile features are explicitly marked experimental.

Scope

• Stabilize the user API: WorkGraph, task, spec, error handlers that users actually touch.
• Docs: quickstart, howtos and others, and experimental labeling.
• Tests & CI: coverage >=90%.
• Packaging & release plan: beta this week -> stable in ~1 month.

Non-goals

• Deep refactors of low-level internals that don’t affect the user API.
• Unfinalized advanced features (GUI, map zone etc.): ship as experimental.

---

Timeline

• Fri, Sep 12, 2025 — v1.0.0b1 (beta)
  Public preview on PyPI
• Fri, Oct 01, 2025 — API Freeze & v1.0.0rc1
  Only bug fixes, doc fixes.
• Sat, Oct 15, 2025 — v1.0.0 (stable)
  Final stable release.

---

Checklists

• Having a stable and well-defined API
• Up-to-date documentation
• Testing infrastructure