Skip to content

PUBLISHING.md

Latest commit

 

History

History
92 lines (69 loc) · 1.75 KB

PUBLISHING.md

File metadata and controls

92 lines (69 loc) · 1.75 KB

Publishing Checklist

Pre-publish

  • Update version in package.json (v2.0.0)
  • Update CHANGELOG.md with release notes
  • All tests pass (npm test)
  • Build succeeds (npm run build)
  • Type checking passes (npm run typecheck)
  • README.md is up-to-date
  • LICENSE file exists
  • .npmignore configured correctly
  • Examples are working

Publish Steps

1. Final Verification

# Clean build
rm -rf dist node_modules package-lock.json
npm install
npm run build
npm run typecheck

# Test installation locally
npm pack
npm install -g opencode-antigravity-autopilot-2.0.0.tgz

2. Git Release

# Ensure on main branch
git checkout main
git pull origin main

# Tag release
git tag -a v2.0.0 -m "Release v2.0.0"
git push origin v2.0.0

3. NPM Publish

# Login to npm (if needed)
npm login

# Publish
npm publish

# Or dry-run first
npm publish --dry-run

4. GitHub Release

  1. Go to GitHub Releases
  2. Click "Draft a new release"
  3. Select tag v2.0.0
  4. Release title: v2.0.0 - Plugin-Only Implementation
  5. Copy content from CHANGELOG.md
  6. Publish release

5. Post-publish Verification

# Verify on npm
npm view opencode-antigravity-autopilot

# Test installation
npm install -g opencode-antigravity-autopilot
quota_status --help  # or whatever CLI you have

Rollback (if needed)

# Unpublish within 72 hours
npm unpublish [email protected]

# Or deprecate
npm deprecate [email protected] "Use v2.0.1 instead"

Post-Release

  • Announce on GitHub Discussions
  • Update documentation site (if any)
  • Tweet/share announcement
  • Monitor GitHub issues for bug reports
  • Bump version to 2.0.1-dev in package.json