- SDK's createOpencode() internally spawns 'opencode serve' command
- Must install OpenCode CLI first for SDK to function
- Uses repository's install.sh script
- Adds PATH configuration for installed CLI
- Increases timeout to 15min for installation + tests
- Changes ServerManager to use SDK when agent config is provided
- SDK mode uses @opencode-ai/sdk's createOpencode() instead of spawning CLI
- Fixes CI/CD tests that were failing due to missing opencode CLI
- SDK is already installed as dependency, no external tools needed
- Simplifies workflow by removing CLI installation steps
Auto Version Bump:
- Automatically bumps version when PRs are merged to main
- Detects version bump type from commit message:
- feat: → minor bump (v0.1.0 → v0.2.0)
- fix: → patch bump (v0.1.0 → v0.1.1)
- feat!: → major bump (v0.1.0 → v1.0.0)
- [alpha] → alpha bump (v0.1.0-alpha.1 → v0.1.0-alpha.2)
- [beta] → beta bump
- [rc] → rc bump
- default → minor bump (if no type specified)
Automatic Actions:
- Updates VERSION file
- Updates package.json version
- Updates CHANGELOG.md with commit message
- Creates git tag (e.g., v0.2.0)
- Pushes changes back to main
- Adds [skip ci] to prevent infinite loop
Documentation:
- Added VERSION_BUMP_GUIDE.md with examples
- Clear commit message format guidelines
- Manual override instructions
Benefits:
- No manual version bumping needed
- Consistent versioning across the project
- Automatic changelog updates
- Git tags for every release
- Follows semantic versioning conventions
Monorepo Features:
- Root package.json with convenient npm scripts for all agents
- Easy testing from root: npm test, npm run test:openagent, npm run test:opencoder
- Multi-model support: test with Grok, Claude, or GPT-4
- Quick dashboard access: npm run dashboard
- No folder navigation required
Versioning System:
- VERSION file tracking current version (0.1.0-alpha.1)
- CHANGELOG.md with comprehensive version history
- Version bump scripts for alpha, beta, rc, and stable releases
- Semantic versioning with progression: Alpha → Beta → RC → Stable
CI/CD:
- GitHub Actions workflow for automated testing
- Pre-merge validation for agent changes
- Smoke tests for both openagent and opencoder
- Automated test result reporting
- Runs on PRs to main/dev and pushes to main
Helper Scripts:
- scripts/test.sh: Advanced test runner with multi-agent support
- scripts/dashboard.sh: Enhanced dashboard launcher with auto-open
- scripts/bump-version.sh: Version management tool
Documentation:
- QUICK_START.md: Comprehensive testing and usage guide
- Clear examples for all test scenarios
- Multi-agent and multi-model workflows
Benefits:
- Easy testing from root directory
- Automated quality checks before merges
- Clear version tracking and history
- Developer-friendly workflows
- No breaking changes to existing structure
