Skip to content

Release Packwright 0.2.0

Choose a tag to compare

@pioneerjeff pioneerjeff released this 21 Jul 14:33

Packwright 0.2.0 makes the editable save-context source authoritative across Codex, Claude Code, and Cursor.

What changed

  • The body at skills[].path is now the only semantic source for the required save-context skill. 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