chore: enforce semantic migration sequence

[Yehonal]

Summary

• release PAM 0.3.1 with semantic migration enforcement
• add npm run migrations:check and tests for contiguous semver migration paths
• add 0.3.0 -> 0.3.1 migration/adoption guide for the enforcement policy

Validation

• npm test
• npm run migrations:check
• npm run memory:graph:validate
• git diff --check

Follow-up

PR #5 should rebase onto this branch/main after merge and rename its migration path to start from 0.3.1, for example 0.3.1-to-0.4.0-agent-layer.md.

[Copilot]

Pull request overview

Releases PAM 0.3.1, which introduces an automated semantic migration sequencing policy and its supporting tooling/tests, plus a CI workflow that runs the new check alongside graph validation and tests.

Changes:

• New tools/check-migrations.mjs (with migrations:check script) that verifies package.json/pam.version.json version alignment, valid semver migration filenames, one-step patch/minor/major increments, and a contiguous migration chain when migration-sensitive paths change.
• New tools/test-check-migrations.mjs exercising semver helpers, sensitive-path detection, and end-to-end pass/fail scenarios.
• Version bump to 0.3.1, new migrationEnforcement feature flag, 0.3.0→0.3.1 migration guide, CHANGELOG entry, and a CI GitHub Actions workflow running checks, graph validation, and tests.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
tools/check-migrations.mjs	New CLI/library implementing the migration sequence policy.
tools/test-check-migrations.mjs	Unit tests for semver helpers, parsing, sensitivity checks, and chain validation.
package.json	Bumps version to 0.3.1 and adds migrations:check script.
memory/pam.version.json	Bumps pamVersion to 0.3.1, adds migrationEnforcement flag, updates date.
migrations/0.3.0-to-0.3.1-migration-enforcement.md	Adoption/migration guide for the new enforcement policy.
CHANGELOG.md	0.3.1 release notes describing the enforcement additions.
.github/workflows/ci.yml	New CI workflow running migrations check, graph validate, and tests on Node 20.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.