Lushly Dev Afd Do Release

Do Release

Release a new version using the repo's versioning flows for npm packages and Python.

AFD-Specific Release Tracks

The AFD monorepo uses two release tracks:

• npm packages — @changesets/cli versions and publishes the @lushly-dev/* packages with fixed versioning.
• Python package — python/pyproject.toml is versioned separately and published through publish-python.yml on python-v* tags or GitHub Releases.

How npm Changesets Work

1. During development: When you change a released @lushly-dev/* package, create a changeset:

   pnpm changeset
   

   This prompts for the semver bump type and a description, then creates a markdown file in .changeset/.

2. At release time: The GitHub Actions workflow (or manual command) consumes all changesets:

   pnpm version-packages    # bumps versions + updates CHANGELOGs
   

3. Publishing: CI handles this automatically, or manually:

   pnpm publish:npm          # build + publish to npm
   

Python Release Flow

When the Python afd package changes:

1. Bump python/pyproject.toml
2. Update CHANGELOG.md
3. Push a python-v<version> tag or publish a GitHub Release
4. Let .github/workflows/publish-python.yml build, test, and publish to PyPI

Automated CI Flow

The Release workflow runs on every push to main:

1. If pending changesets exist → opens a "Release" PR that bumps versions and updates CHANGELOGs
2. When the Release PR is merged → publishes all bumped packages to npm with provenance

No manual tagging or version bumping needed.

Manual Release (if needed)

# 1. Ensure all changes have changesets
pnpm changeset status

# 2. Version bump + changelog update
pnpm version-packages

# 3. Commit the version bump
git add -A
git commit -m "chore: release packages"

# 4. Push to trigger publish
git push origin main

# 5. Or publish locally
pnpm publish:npm

Design Principles

Creating a Changeset

When making changes to released npm packages that should be versioned:

pnpm changeset

Choose the bump type:

• patch — bug fixes, dependency updates, npm-package docs
• minor — new features, non-breaking additions
• major — breaking changes

Write a concise description of what changed. The changeset file is committed with your PR.

Do not create a no-op changeset for Python-only or docs/skills-only changes.

Configuration

Config lives in .changeset/config.json:

• "fixed": [["@lushly-dev/*"]] — all published packages share one version
• "access": "public" — packages are public on npm
• "ignore" — example apps and root package are excluded from versioning
• "changelog" — uses @changesets/changelog-github for PR links in changelogs

Workflow

Step 1: Pre-Flight

Verify the repo is ready for release:

Step 2: Version + Changelog

pnpm version-packages

This consumes all .changeset/*.md files, bumps versions in all @lushly-dev/* package.json files, and appends entries to each package's CHANGELOG.md.

Python Versioning

For Python-only releases:

cd python
$EDITOR pyproject.toml   # bump version
cd ..
git add python/pyproject.toml CHANGELOG.md
git commit -m "chore(python): release afd <version>"
git tag python-v<version>
git push origin main --tags

Step 3: Build + Test

pnpm check

Step 4: Commit + Push

git add -A
git commit -m "chore: release packages"
git push origin main

Step 5: Publish

CI publishes automatically when it detects version bumps on main. Or publish manually:

pnpm publish:npm

Step 6: Post-Release

1. Verify packages are available: npm info @lushly-dev/afd-core
2. Check GitHub Release was created
3. Announce if applicable

Reference

See release-checklist.md for the expanded checklist.

Source: lushly-dev/afd — distributed by TomeVault.