Devid HWandClaude Sonnet 4.6
20a2d3d6e4
- scripts/release.sh: one-command local release (bump, changelog, tag, push) - .github/workflows/release.yml: fix SHA256 auto-commit back to master, dynamic mcp-publisher version detection, cargo cache, security hardening - .claude/commands/release.md: /release slash command - .windsurf/workflows/release.md: streamlined to use release.sh Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
115 lines
2.5 KiB
Markdown
115 lines
2.5 KiB
Markdown
---
|
|
description: Release a new version of mt5-quant — bump, changelog, tag, push
|
|
---
|
|
|
|
# /release — MT5-Quant Release Workflow
|
|
|
|
Automates the full release cycle: version bump → changelog → git tag → GitHub push → CI triggers build + MCP publish.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/release [patch|minor|major|X.Y.Z]
|
|
```
|
|
|
|
Default is `patch` if no argument is given.
|
|
|
|
---
|
|
|
|
## Step 1 — Check current version and state
|
|
|
|
```bash
|
|
grep '^version' Cargo.toml | head -1
|
|
git status --short
|
|
git log --oneline -5
|
|
```
|
|
|
|
## Step 2 — Count tools (update docs if needed)
|
|
|
|
```bash
|
|
grep -r "pub fn tool_" src/tools/definitions/ | wc -l
|
|
```
|
|
|
|
If the count changed since the last release, update:
|
|
- `README.md` — "MCP Tools (N)" section header and description
|
|
- `docs/MCP_TOOLS.md` — "documents X of Y total tools" line
|
|
|
|
## Step 3 — Run the release script
|
|
|
|
```bash
|
|
bash scripts/release.sh patch
|
|
```
|
|
|
|
Replace `patch` with `minor`, `major`, or an explicit version like `1.33.0`.
|
|
|
|
The script will:
|
|
1. Bump `Cargo.toml` version
|
|
2. Update `server.json` version + download URL (SHA256 = TBD, set by CI)
|
|
3. Generate a `CHANGELOG.md` entry from `git log` since the last tag
|
|
4. Run `cargo check` to verify the build
|
|
5. Commit all changes
|
|
6. Create an annotated git tag
|
|
7. Push branch + tag → triggers GitHub Actions
|
|
|
|
## Step 4 — Monitor GitHub Actions
|
|
|
|
```bash
|
|
gh run list --limit 5
|
|
```
|
|
|
|
Or open: https://github.com/masdevid/mt5-quant/actions
|
|
|
|
The CI pipeline will:
|
|
- Build macOS arm64 + Linux x64 binaries
|
|
- Create the GitHub Release with both artifacts
|
|
- Build the MCP installable package
|
|
- Compute the real SHA256 and commit it back to `server.json`
|
|
- Attempt to publish to the MCP Registry
|
|
|
|
## Step 5 — Install updated binary locally
|
|
|
|
```bash
|
|
cp target/release/mt5-quant ~/.local/bin/mt5-quant
|
|
```
|
|
|
|
Or rebuild from the release tag:
|
|
|
|
```bash
|
|
cargo build --release && cp target/release/mt5-quant ~/.local/bin/mt5-quant
|
|
```
|
|
|
|
## Step 6 — Verify MCP registration
|
|
|
|
```bash
|
|
claude mcp list
|
|
~/.local/bin/mt5-quant --help 2>/dev/null || echo "binary works"
|
|
```
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
**MCP publish failed in CI?**
|
|
|
|
```bash
|
|
# Download latest mcp-publisher
|
|
curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_linux_amd64.tar.gz" | tar xz
|
|
./mcp-publisher login github
|
|
./mcp-publisher publish
|
|
```
|
|
|
|
**Need to re-run CI without a new tag?**
|
|
|
|
```bash
|
|
gh workflow run release.yml -f version=v1.32.0
|
|
```
|
|
|
|
**Rollback a bad release?**
|
|
|
|
```bash
|
|
git tag -d v1.32.0
|
|
git push origin :refs/tags/v1.32.0
|
|
# Then delete the GitHub Release via web UI or:
|
|
gh release delete v1.32.0
|
|
```
|