// Wax deployment orchestration skill. Use when releasing new versions of Wax across npm, Homebrew, OpenClaw, OpenCode, or Claude Code channels. Covers version bumping, congruency validation, binary building, staged publishing, and rollback procedures.
Benchmarking and performance auditing for the Wax repo. Use when running or interpreting Wax benchmarks, diagnosing CPU, memory, or I/O bottlenecks, or investigating Swift 6.2 concurrency issues such as Sendable, actor isolation, `@unchecked Sendable`, task-group fan-out, and data races.
Comprehensive guidance for the Wax on-device memory/RAG framework. Use when integrating MemoryOrchestrator, VideoRAGOrchestrator, Wax/WaxSession, embedding providers, hybrid search, maintenance, or when evaluating Wax constraints like offline-only, single-file .wax persistence and deterministic retrieval.
| name | wax-deploy |
| description | Wax deployment orchestration skill. Use when releasing new versions of Wax across npm, Homebrew, OpenClaw, OpenCode, or Claude Code channels. Covers version bumping, congruency validation, binary building, staged publishing, and rollback procedures. |
Wax deploys to 5 channels from a single source of truth. This skill ensures predictable, resilient, and congruent releases across all channels.
| Channel | Artifact | Location |
|---|---|---|
| npm | waxmcp package | Resources/npm/waxmcp/ |
| Homebrew | wax.rb formula | Resources/npm/waxmcp/homebrew-wax/ |
| OpenClaw | @wax/openclaw-wax-memory plugin | Resources/openclaw/wax-memory-plugin/ |
| OpenCode | .pi extension + agents | .pi/extensions/wax-agents/ |
| Claude Code | MCP server registration | wax-cli mcp install |
# Full pipeline: bump → build → validate → commit message
scripts/release-all.sh 0.1.23
# Then commit, tag, and publish:
git add -A && git commit -m "release: waxmcp v0.1.23"
git tag waxmcp-v0.1.23 && git push origin main --tags
scripts/publish-all.sh --tag next
scripts/validate-congruency.sh
# or JSON output for CI:
scripts/validate-congruency.sh --json
scripts/release-all.sh 0.1.23 --dry-run
scripts/publish-all.sh --tag next --dry-run
scripts/bump-version.sh atomically updates all 7 version surfaces:
Resources/npm/waxmcp/package.jsonSources/WaxMCPServer/main.swiftResources/openclaw/wax-memory-plugin/package.json (version)Resources/openclaw/wax-memory-plugin/package.json (waxmcp dependency)Resources/npm/waxmcp/homebrew-wax/Formula/wax.rb (URL)Resources/npm/waxmcp/homebrew-wax/Formula/wax.rb (SHA256).pi/extensions/wax-agents/package.jsonscripts/bump-version.sh 0.1.23 # exact version
scripts/bump-version.sh patch # or minor/major
scripts/bump-version.sh 0.1.23 --dry-run
scripts/release-all.sh builds darwin-arm64 and darwin-x64 binaries:
scripts/release-all.sh 0.1.23
# Skip build if binaries already exist:
scripts/release-all.sh 0.1.23 --skip-build
scripts/validate-congruency.sh asserts all surfaces match:
scripts/validate-congruency.sh # human-readable
scripts/validate-congruency.sh --json # machine-readable
scripts/validate-congruency.sh --quiet # CI-friendly (exit 0/1 only)
scripts/publish-all.sh supports canary → soak → promote workflow:
# Publish to canary
scripts/publish-all.sh --tag next
# After soak period, promote to latest
scripts/publish-all.sh --promote
# Preview without publishing
scripts/publish-all.sh --tag next --dry-run
All channels must share the same version. The canonical source is Resources/npm/waxmcp/package.json.
| Symptom | Cause | Fix |
|---|---|---|
| openclaw ≠ npm | Plugin not bumped after waxmcp release | scripts/bump-version.sh $(npm version) |
| homebrew ≠ npm | Formula manually edited, not via script | scripts/bump-version.sh recomputes URL + SHA |
| opencode ≠ npm | Extension version never tracked | scripts/bump-version.sh aligns it |
Add to .github/workflows/release-waxmcp.yml before publish:
- name: Validate version congruency
run: scripts/validate-congruency.sh --quiet
git checkout -- Resources/npm/waxmcp/package.json \
Sources/WaxMCPServer/main.swift \
Resources/openclaw/wax-memory-plugin/package.json \
.pi/extensions/wax-agents/package.json \
Resources/npm/waxmcp/homebrew-wax/Formula/wax.rb
# Unpublish within 24 hours
npm unpublish waxmcp@0.1.23
npm unpublish @wax/openclaw-wax-memory@0.1.23
# Republish previous version as latest
npm dist-tag add waxmcp@0.1.22 latest
npm dist-tag add @wax/openclaw-wax-memory@0.1.22 latest
Commit or stash changes before running release-all.sh:
git stash
scripts/release-all.sh 0.1.23
git stash pop
Or use --allow-dirty (not recommended for production releases).
Run the bump script to align all surfaces:
scripts/bump-version.sh $(node -p "require('./Resources/npm/waxmcp/package.json').version")
Version already published. Check:
npm view waxmcp versions --json | tail -5
The SHA in the formula is computed from local git archive. After pushing the tag, verify:
curl -sL https://github.com/christopherkarani/Wax/archive/refs/tags/waxmcp-v0.1.23.tar.gz | shasum -a 256
If different, update the formula manually or re-run bump-version.sh after the tag is pushed.
bump-version.sh updates all surfaces in one invocation--dry-run for safe previewnext tag for canary, latest for productionset -euo pipefail on all scripts; validation gates before publishResources/scripts/ helpers