Open-source readiness: engine bootstrap, branding, release infra
Merged
AN
8mo ago+2146+2146+0123456789012345678901234567890123456789-910-910-012345678901234567890123456789
Summary
Prepares the monorepo for open-source release at github.com/AltimateAI/altimate-code. This PR covers four areas:
- Engine bootstrap — uv-managed Python engine isolation (
bridge/engine.ts). The CLI auto-downloadsuv, creates an isolated Python 3.12 venv at~/.local/share/altimate-code/engine/, and installsaltimate-enginewith zero system dependencies required. Addsaltimate-code engine status/reset/pathsubcommand. - Branding cleanup — Renames all
opencode/anomalyco/OPENCODE_*references toaltimate-code/AltimateAI/ALTIMATE_CLI_*across 100+ files (source, build scripts, Docker, Homebrew, AUR, SDK exports, tests, theme URLs). Fixes a critical bug where build defines (OPENCODE_VERSION) didn't match consumer declarations (ALTIMATE_CLI_VERSION), causing version detection to fall back to "local" in production builds. - Release infrastructure — Unified release workflow (
v*tag → npm + PyPI + GitHub Release), engine-only publish workflow (engine-v*→ PyPI), version sync script (bump-version.ts), andRELEASING.mdguide. - Open-source files — LICENSE (MIT), README, CONTRIBUTING, CODE_OF_CONDUCT, CHANGELOG, SECURITY, GitHub issue/PR templates, dependabot config, CI workflow.
Files changed: 120 (101 modified + 18 new + 1 snapshot)
Key new files
| File | Purpose |
|---|---|
packages/altimate-code/src/bridge/engine.ts | uv-managed engine lifecycle (download, venv, install, upgrade) |
packages/altimate-code/src/cli/cmd/engine.ts | altimate-code engine CLI subcommand |
packages/altimate-code/script/bump-version.ts | Version sync between pyproject.toml and init.py |
.github/workflows/release.yml | Unified release: npm + PyPI + GitHub Release |
.github/workflows/ci.yml | CI: TypeScript (Bun) + Python (3.10/3.11/3.12 matrix) |
.github/workflows/publish-engine.yml | Engine-only PyPI releases |
RELEASING.md | Complete release process documentation |
Remaining opencode references (all legitimate)
@gitlab/opencode-gitlab-auth— third-party npm packageproviderID: "opencode"in test fixture — external OpenCode Zen AI providersst/opencodein test — generic GitHub URL parser test datamodels-api.json— external provider definition from models.dev
Before publishing checklist
These steps must be completed before the first release:
1. npm token
- Create an npm access token with publish permissions
- Add it as
NPM_TOKENin GitHub repository secrets (Settings > Secrets and variables > Actions)
2. PyPI trusted publishing (OIDC — no API tokens needed)
- Go to https://pypi.org/manage/account/publishing/ (logged in as
<pypi-account>) - Add a new pending publisher:
- Package name:
altimate-engine - Owner:
AltimateAI - Repository:
altimate-code - Workflow:
release.yml - Environment:
pypi
- Package name:
- Create a
pypienvironment in GitHub repo settings (Settings > Environments > New environment >pypi)
3. Homebrew tap
- Create
AltimateAI/homebrew-taprepository on GitHub - Ensure the
GITHUB_TOKENused in Actions has write access to this repo (or add a PAT asHOMEBREW_TAP_TOKEN)
4. First release
# Bump engine version
bun run packages/altimate-code/script/bump-version.ts --engine 0.1.0
# Commit and tag
git add -A
git commit -m "release: v0.1.0"
git tag v0.1.0
git push origin main --tags
5. Optional: AUR (Linux)
- Register
altimate-code-binpackage on AUR - Set up SSH key for AUR push access in CI secrets
6. Verify after first release
npm info altimate-code-ai version # npm
pip install altimate-engine==0.1.0 # PyPI
brew update && brew info altimate/tap/altimate-code # Homebrew
docker pull ghcr.io/<org>/altimate-code:<version> # Docker
Test plan
- Verify
bun run packages/altimate-code/script/build.ts --singlesucceeds andALTIMATE_ENGINE_VERSIONis injected - Verify
cd packages/altimate-engine && pytestpasses (283+ tests) - Verify
cd packages/altimate-engine && python -m build --sdistproduces valid package - Verify CI workflow runs on this PR
- Verify no
OPENCODE_oranomalycoreferences remain:grep -rn "OPENCODE_\|anomalyco" --include="*.ts" --include="*.py" --include="*.yml"
🤖 Generated with Claude Code