mt5-quant/.windsurf/workflows/release.md

description, tags

description	tags
Release workflow — bump version, build, tag, push, publish MCP	release publish workflow

MT5-Quant Release Workflow

One-command release: bash scripts/release.sh [patch|minor|major|X.Y.Z]

---

0. Pre-release checklist

• Features implemented and tested
• Docs updated (README.md, docs/MCP_TOOLS.md) with correct tool count
• cargo check passes

Check tool count:

// turbo

grep -r "pub fn tool_" src/tools/definitions/ | wc -l

---

1. Run the release script

// turbo

bash scripts/release.sh patch

Accepts: patch · minor · major · 1.32.0 · v1.32.0

The script handles:

• Version bump in Cargo.toml
• server.json version + download URL update
• CHANGELOG.md entry generation from git log
• cargo check verification
• Release commit + annotated git tag
• git push → triggers GitHub Actions

---

2. Monitor CI

// turbo

gh run list --limit 3

CI pipeline stages:

1. build-macos / build-linux — parallel Rust builds with cache
2. release — creates GitHub Release with both binaries
3. build-mcp-package — packages binary + config + docs, computes SHA256
4. update-server-json — commits real SHA256 back to server.json on master
5. mcp-publish — publishes to MCP Registry via GitHub OIDC
6. release-info — prints registration commands for all MCP clients

---

3. Install locally

// turbo

cp target/release/mt5-quant ~/.local/bin/mt5-quant

---

4. Verify

// turbo

claude mcp list

---

Manual MCP publish (if CI publish fails)

// turbo

# Get latest mcp-publisher
LATEST=$(curl -sf https://api.github.com/repos/modelcontextprotocol/registry/releases/latest | python3 -c "import sys,json; print(json.load(sys.stdin)['tag_name'])")
VERSION="${LATEST#v}"
curl -fsSL -o pub.tar.gz "https://github.com/modelcontextprotocol/registry/releases/download/${LATEST}/mcp-publisher_${VERSION}_$(uname -s | tr '[:upper:]' '[:lower:]')_amd64.tar.gz"
tar -xzf pub.tar.gz && chmod +x mcp-publisher
./mcp-publisher login github
./mcp-publisher publish

---

Re-trigger CI without a new tag

// turbo

gh workflow run release.yml -f version=v1.32.0

---

Rollback

# Remove tag locally and remotely
git tag -d v1.32.0
git push origin :refs/tags/v1.32.0
# Delete GitHub Release
gh release delete v1.32.0 --yes