Skip to main content

[!FROZEN] MPLP Protocol v1.0.0 Frozen Specification Freeze Date: 2025-12-03 Status: FROZEN (no breaking changes permitted) Governance: MPLP Protocol Governance Committee (MPGC) License: Apache-2.0 Note: Any normative change requires a new protocol version.

Release Runbook

1. Purpose​

This runbook defines the standard operating procedure for releasing new versions of MPLP.

2. Pre-Release Checklist​

  • All tests pass: pnpm test
  • Golden Flows pass: pnpm test:golden
  • Python tests pass: pytest
  • Schema validation: node scripts/validate-schemas.js
  • FROZEN headers synced: node scripts/update-frozen-headers.mjs

3. Version Bump​

Update versions in:

  • package.json (root)
  • packages/sdk-ts/package.json
  • packages/sdk-py/pyproject.toml
  • VERSION.txt (if exists)

4. Release Procedure​

4.1 Full Release (MAJOR/MINOR)​

  1. Create release branch: release/v1.x.0
  2. Run all verification steps
  3. Update CHANGELOG.md
  4. Tag: git tag -a v1.x.0 -m "Release v1.x.0"
  5. Build: node scripts/build-release.js
  6. Publish:
    • npm: npm publish (in packages/sdk-ts/)
    • PyPI: python -m build && twine upload dist/* (in packages/sdk-py/)

4.2 Patch Release​

  1. Branch from main
  2. Fix bug
  3. Run verification (Fast Track)
  4. Tag: git tag -a v1.0.x -m "Patch v1.0.x"
  5. Release

5. Post-Release​

  • Create GitHub Release with notes
  • Update documentation links
  • Announce to stakeholders

6. Key Scripts​

ScriptPurpose
scripts/build-release.jsBuild release package
scripts/update-frozen-headers.mjsSync FROZEN headers
scripts/validate-schemas.jsValidate JSON schemas

2025 Bangshi Beijing Network Technology Limited Company Licensed under the Apache License, Version 2.0.