Skip to content

RELEASING.md

Latest commit

 

History

History
61 lines (47 loc) · 4.07 KB

RELEASING.md

File metadata and controls

61 lines (47 loc) · 4.07 KB
Raw

Releasing

How metagraphed ships. Most of it is automatic — the only steps that need a manual trigger are the MCP registry listings. This is the operational runbook (a reference, not a per-change checklist); the channel policy and rationale live in ADR 0005.

Automatic — no action needed

Surface Trigger Mechanism
Code + bundled assets push to main Cloudflare Workers Builds (CF git integration)
Data artifacts (R2 / KV) push to registry/** + daily schedule publish-cloudflare.yml
Health scheduled crons Worker-native cron (HEALTH_PRUNE_CRON, workers/api.mjs), …
Economics / metagraph / account-identity / subnet-hyperparams scheduled systemd timers indexer-box data-refresh-cron / data-refresh-economics (JSONbored/metagraphed-infra) -- moved off GitHub Actions 2026-07-13 / 2026-07-15

Data is probe- and chain-derived and rebuilt on schedule — it is never hand-edited (health/uptime/latency especially). See ADR 0001 for the data architecture.

Versioned packages — release-please

@jsonbored/metagraphed (npm) and metagraphed (PyPI) are cut by release-please:

  1. Conventional-commit merges to main accumulate into a Release PR.
  2. Merging the Release PR dispatches publish-client.yml (npm) and publish-python.yml (PyPI) via OIDC Trusted Publishing — no tokens.

A bare manual dispatch of either workflow is the override path.

MCP registry listings — manual

The hosted MCP server (https://api.metagraph.sh/mcp, defined in server.json) is listed in three registries. Run these after changing MCP tools / prompts / resources or server.json metadata so the listings reflect the live server:

  1. Canonical — registry.modelcontextprotocol.io
    • sync-mcp-version.yml bumps server.json's version (and the matching MCP_SERVER_VERSION) automatically once a tool-registry change lands on main, so it's normally already ahead of the last-published version by the time you run this. If it isn't (e.g. a metadata-only server.json edit the automation doesn't watch), bump version in server.json yourself first — the registry rejects re-publishing an existing version.
    • Actions → Publish MCP Registry (publish-mcp-registry.yml). GitHub OIDC, no secret.
  2. Smithery — smithery.ai/servers/metagraphed/metagraphed
    • Actions → Publish to Smithery (smithery-publish.yml). Uses the SMITHERY_API_KEY secret scoped to the smithery deployment environment.
  3. mcp.so — mcp.so/server/metagraphed---bittensor-subnet-registry/JSONbored
    • Community directory; manual UI edit, only on notable changes.

Both #1 and #2 are workflow_dispatch — run them together so the canonical and Smithery listings stay in sync. (#3 rarely needs touching.) The canonical endpoint stays https://api.metagraph.sh/mcp everywhere — registries are distribution mirrors, not the source of truth.

Frontend

The UI lives in metagraphed-ui and deploys via Cloudflare Workers Builds (Bun) on push to its main.