Skip to content

Release Process

Harrier uses semantic versioning for public releases.

Version Format

vMAJOR.MINOR.PATCH

Examples:

v0.1.0
v0.2.0
v1.0.0

Versioning Rules

Change Version
Backward-compatible docs, examples, recommendations, or classifier additions Patch
New optional MCP response fields, new runtime evidence, new recommendation type with compatibility preserved Minor
Removed fields, renamed categories, required request changes, incompatible storage or deployment changes Major

Release Workflow

  1. Update CHANGELOG.md.
  2. Update compatibility.md when runtime or contract support changes.
  3. Confirm CI is green.
  4. Confirm the public surfaces are healthy:

bash make domain-verify curl -I https://harrier.theplatformlayer.com curl -I https://docs.harrier.theplatformlayer.com

  1. Create and push a semver tag:

bash git tag v0.1.0 git push origin v0.1.0

  1. GitHub Actions publishes:
  2. a GitHub release
  3. an ECR image tagged with the version
  4. an ECR image tagged with the short commit SHA

  5. latest

  6. Confirm the GitHub release is visible:

bash gh release view v0.1.0 --repo the-platform-layer/harrier-emr-mcp

The release notes should include links to:

Website And Docs Deployments

The Deploy Website and Deploy Docs workflows create GitHub deployments for the website and docs environments. They deploy to Cloudflare Pages projects:

Environment Cloudflare Pages project Public URL
website harrier-site harrier.theplatformlayer.com
docs harrier-docs docs.harrier.theplatformlayer.com

Manual Wrangler deploys update Cloudflare Pages immediately, but GitHub's deployment history updates only when the GitHub Actions deployment workflows run. After merging deployment-related changes, verify both views:

gh run list --workflow "Deploy Website" --limit 5
gh run list --workflow "Deploy Docs" --limit 5
gh api repos/the-platform-layer/harrier-emr-mcp/deployments
make domain-verify

Repository Release Metadata

The repository right pane should show:

  • Description: Evidence-backed EMR, Spark, and Kubernetes diagnosis MCP server for AWS DevOps Agent
  • Website: harrier.theplatformlayer.com
  • Topics: aws, devops-agent, emr, spark, kubernetes, mcp, observability, incident-response
  • Latest release: the most recent vMAJOR.MINOR.PATCH GitHub release

GitHub social preview images must be uploaded from repository settings unless a supported GitHub API is available in the active tooling.

Demo Deploys

Demo deploys are manual through Deploy Demo. They are not triggered by normal pull requests.