Release Packwright 0.2.0
Packwright 0.2.0 makes the editable save-context source authoritative across Codex, Claude Code, and Cursor.
What changed
- The body at
skills[].pathis now the only semantic source for the requiredsave-contextskill. Adapters generate only the runtime destination path and front matter. - New English and Chinese scaffolds include a Memory Tracks section generated from the same structured track data as
memory-policy.yaml. - Customized and older sources do not need a Memory Tracks heading. The checker still requires a Procedure section,
memory/session-index.md, canonical-owner guidance, and runtime-neutral wording. - Save-context is mandatory and cannot be capability-gated.
- Projection-neutrality failures now identify the canonical source path and the runtime-specific token that must be removed.
Upgrade and reconcile behavior
Installing 0.2.0 does not modify an installed target. On the first reconcile from a canonical work directory, dry-run reports the save-context projection as a normal managed update. Apply replaces that managed projection with the work-directory source body, refreshes the embedded source snapshot and lock, and preserves portable instance state. --force is not required.
Users who customized the work-directory source will see that content projected for the first time. Users who kept the default source may see save-context wording change from the old adapter-owned template to the scaffolded source.
The canonical edit location is the work directory, such as work/<character>/skills/save-context/SKILL.md. Changes made only in an installed runtime projection or in .packwright/source are not canonical and are overwritten by a later reconcile.
Before the first reconcile, doctor continues to validate the target against its existing lock. If the old projection is manually changed during this window, doctor --fix may refuse repair because the 0.2.0 compiler output no longer matches the old lock. Reconcile first, then rerun doctor.
Verification
- 101/101 tests passed.
- Full source, package, three-adapter install, doctor, score, and migration release gate passed.
- Python 3.9–3.14 CI and package checks passed.
Install
python -m pip install packwright==0.2.0