mirror of https://github.com/basicmachines-co/basic-memory synced 2026-06-21 13:47:35 +00:00

Files

T

phernandez e4b32d7bc9 feat: add automated release management system

- Add version management in __init__.py
- Add justfile targets for release and beta automation
- Create Claude command documentation for /release and /beta
- Implement comprehensive quality checks and validation
- Support automated version updates and git tagging

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-06-11 17:06:23 -05:00

3.0 KiB

Raw Permalink Blame History

/beta - Create Beta Release

Create a new beta release using the automated justfile target with quality checks and tagging.

Usage

/beta <version>

Parameters:

version (required): Beta version like v0.13.2b1 or v0.13.2rc1

Implementation

You are an expert release manager for the Basic Memory project. When the user runs /beta, execute the following steps:

Step 1: Pre-flight Validation

Verify version format matches v\d+\.\d+\.\d+(b\d+|rc\d+) pattern
Check current git status for uncommitted changes
Verify we're on the main branch
Confirm no existing tag with this version

Step 2: Use Justfile Automation

Execute the automated beta release process:

just beta <version>

The justfile target handles:

✅ Beta version format validation (supports b1, b2, rc1, etc.)
✅ Git status and branch checks
✅ Quality checks (just check - lint, format, type-check, tests)
✅ Version update in src/basic_memory/__init__.py
✅ Automatic commit with proper message
✅ Tag creation and pushing to GitHub
✅ Beta release workflow trigger

Step 3: Monitor Beta Release

Check GitHub Actions workflow starts successfully
Monitor workflow at: https://github.com/basicmachines-co/basic-memory/actions
Verify PyPI pre-release publication
Test beta installation: uv tool install basic-memory --pre

Step 4: Beta Testing Instructions

Provide users with beta testing instructions:

# Install/upgrade to beta
uv tool install basic-memory --pre

# Or upgrade existing installation
uv tool upgrade basic-memory --prerelease=allow

Version Guidelines

First beta: v0.13.2b1
Subsequent betas: v0.13.2b2, v0.13.2b3, etc.
Release candidates: v0.13.2rc1, v0.13.2rc2, etc.
Final release: v0.13.2 (use /release command)

Error Handling

If just beta fails, examine the error output for specific issues
If quality checks fail, fix issues and retry
If version format is invalid, correct and retry
If tag already exists, increment version number

Success Output

✅ Beta Release v0.13.2b1 Created Successfully!

🏷️  Tag: v0.13.2b1
🚀 GitHub Actions: Running
📦 PyPI: Will be available in ~5 minutes as pre-release

Install/test with:
uv tool install basic-memory --pre

Monitor release: https://github.com/basicmachines-co/basic-memory/actions

Beta Testing Workflow

Create beta: Use /beta v0.13.2b1
Test features: Install and validate new functionality
Fix issues: Address bugs found during testing
Iterate: Create v0.13.2b2 if needed
Release candidate: Create v0.13.2rc1 when stable
Final release: Use /release v0.13.2 when ready

Context

Beta releases are pre-releases for testing new features
Automatically published to PyPI with pre-release flag
Uses the automated justfile target for consistency
Version is automatically updated in __init__.py
Ideal for validating changes before stable release
Supports both beta (b1, b2) and release candidate (rc1, rc2) versions

3.0 KiB Raw Permalink Blame History