Skip to content

Update stacklok/toolhive-registry-server to v1.5.1 - #1085

Open
renovate[bot] wants to merge 5 commits into
mainfrom
renovate/stacklok-toolhive-registry-server-1.x
Open

Update stacklok/toolhive-registry-server to v1.5.1#1085
renovate[bot] wants to merge 5 commits into
mainfrom
renovate/stacklok-toolhive-registry-server-1.x

Conversation

@renovate

@renovate renovate Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

This PR contains the following updates:

Package Update Change
stacklok/toolhive-registry-server patch v1.5.0v1.5.1

After this PR opens, .github/workflows/upstream-release-docs.yml adds source-verified content edits for the new release. For stacklok/toolhive, the same workflow also syncs reference assets (CLI help, Swagger) and regenerates the CRD MDX pages.


Release Notes

stacklok/toolhive-registry-server (stacklok/toolhive-registry-server)

v1.5.1

Compare Source

What's Changed

New Contributors

Full Changelog: stacklok/toolhive-registry-server@v1.5.0...v1.5.1


Configuration

📅 Schedule: (in timezone America/New_York)

  • Branch creation
    • At any time (no schedule defined)
  • Automerge
    • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Never, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.


Docs update for toolhive-registry-server v1.5.1

At a glance

Upstream stacklok/toolhive-registry-server v1.5.0v1.5.1
Hand-written changes 2 commit(s)
Reference assets refreshed (separate commit)
Gaps 0
Release contributors 3 auto-assigned (see sidebar)
Action required Spot-check skill-authored prose for accuracy

Summary of changes

  • Added new plugins guide at docs/toolhive/guides-registry/plugins.mdx covering the /registry/{name}/v0.1/x/dev.toolhive/plugins extension API and the plugin payload on /v1/entries, wired into the Registry Server sidebar.
  • Rewrote docs/toolhive/guides-registry/telemetry-metrics.mdx for the stacklok_registry_* / OTel-semconv rename: renamed every metric, updated labels (registrysource, success bool → outcome label), documented the new /metrics scrape endpoint on :8081, the constant stacklok_component / stacklok_product labels, and the new stacklok_registry_plugins, stacklok_registry_errors_total, and stacklok_build_info_ratio series.
  • Updated docs/toolhive/guides-registry/audit-logging.mdx to document the new plugin.list / plugin.read / plugin.versions.list / plugin.version.read events and include plugin.list in the high-frequency-read exclusion example.
  • Updated docs/toolhive/guides-registry/publish-servers.mdx to describe the data.plugins array in the registry file format and cross-link to the new plugins guide.
  • Swept "MCP servers and skills" → "MCP servers, skills, and plugins" across intro.mdx, index.mdx, configuration.mdx, and authorization.mdx where the release now includes plugins.

Run cost

Session Turns Cost (USD)
Generation 117 $10.6666
Editorial review 73 $6.3835
Total 190 $17.0501
How this PR was built

Two Claude Opus sessions run per release: a generation pass
(upstream-release-docs skill, 6 phases) followed by a fresh-
context editorial pass (docs-review). Prettier/ESLint
auto-fixes are applied after.

Auto-synced paths — do not hand-edit these in review:

  • static/api-specs/
  • docs/toolhive/reference/cli/ (toolhive only)

If a "Gaps needing human context" section is present above,
each entry includes a paste-ready Helper prompt for local
Claude
a reviewer can use to resolve the gap.

Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
@renovate renovate Bot added the autogen-docs Pull requests generated by automated release workflows label Aug 4, 2026
@vercel

vercel Bot commented Aug 4, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview Aug 4, 2026 7:03pm

Request Review

@github-actions
github-actions Bot marked this pull request as draft August 4, 2026 18:42
@claude

claude Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Claude finished @renovate[bot]'s task in 11m 19s —— View job


Upstream release docs: toolhive-registry-server v1.5.1

Doc edits pushed to the PR branch.

  • Phase 1: Discover changes since v1.5.0
  • Phase 2: Deep-dive PRs and verify against source at v1.5.1
  • Phase 3: Audit docs for impact (displaced-concept sweep on "servers and skills")
  • Phase 4: Implement source-verified edits
  • Phase 5: npm run prettier:fix + npm run eslint:fix clean
  • Phase 6: Commit and push

Summary of changes

  • New docs/toolhive/guides-registry/plugins.mdx — Manage plugins guide for the new /registry/{name}/v0.1/x/dev.toolhive/plugins extension API and plugin payload on /v1/entries (from stacklok/toolhive-registry-server#859). Wired into the Registry Server sidebar between skills and authentication.
  • Rewrote docs/toolhive/guides-registry/telemetry-metrics.mdx for the stacklok_registry_* / OTel-semconv rename (from stacklok/toolhive-registry-server#853): renamed every metric, updated labels (registrysource, success bool → outcome label), added the new Prometheus /metrics scrape endpoint on :8081, the constant stacklok_component / stacklok_product labels, the _OTHER HTTP-method normalization, and the new stacklok_registry_plugins, stacklok_registry_errors_total, stacklok_build_info_ratio series.
  • Updated docs/toolhive/guides-registry/audit-logging.mdx — added the plugin.list / plugin.read / plugin.versions.list / plugin.version.read events.
  • Updated docs/toolhive/guides-registry/publish-servers.mdx — described the data.plugins array in the registry file format and cross-linked to the new plugins guide.
  • Swept "servers and skills" → "servers, skills, and plugins" across intro.mdx, index.mdx, configuration.mdx, authorization.mdx, and added a cross-link from skills.mdx.

Verification notes

  • All new API paths verified against source at v1.5.1: internal/api/registry/v01/routes.go, internal/api/x/plugins/routes.go, internal/api/v1/entries.go, internal/service/entry_types.go, and internal/audit/audit.go.
  • Metrics rewrite verified against docs/observability.md and internal/telemetry/metrics.go at the tag.
  • npm run build could not run to completion here: the mcp-metadata-plugin requires the thv CLI to fetch registry data at build time, which isn't available in this sandbox. This is an environment limitation, not a defect in the doc changes; the same plugin runs on the PR's Vercel preview.
    Branch

- Add Manage plugins guide for the new /x/dev.toolhive/plugins extension API
  and plugin payload on /v1/entries; wire it into the Registry Server sidebar.
- Rewrite Telemetry and metrics for the stacklok_registry_* / OTel-semconv
  rename, the /metrics endpoint on :8081, the new constant labels, and the
  new plugins/errors/build-info series.
- Add plugin.* audit event rows in Audit logging.
- Extend Publish MCP servers to cover the data.plugins array.
- Sweep 'servers and skills' -> 'servers, skills, and plugins' across the
  intro, index, configuration, and authorization pages.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@claude

claude Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Claude finished @renovate[bot]'s task in 7m 0s —— View job


Editorial review: registry-server v1.5.1 docs

Editorial pass complete. Verified factual claims against stacklok/toolhive-registry-server@v1.5.1; applied three small wording fixes.

  • Identify changed files
  • Review each changed doc against the style guide
  • Verify factual claims against upstream at v1.5.1
  • Apply actionable fixes
  • npm run prettier:fix and npm run eslint:fix clean
  • Commit and push

Fixes applied

  • plugins.mdx - Reworded the plugin definition to describe the current bundle format directly instead of narrating that Claude Code "pioneered" it. Per the style guide, docs describe current behavior and shouldn't lean on history/marketing framing. Kept the "Claude Code plugin bundle" reference so readers still know whose spec they're consuming.
  • configuration.mdx - Normalized the link text in the "Supported operations" list from [Skills management] / [plugins management] (inconsistent capitalization, doesn't match either page title) to [Manage skills] / [Manage plugins], matching the target page titles in sentence case.
  • telemetry-metrics.mdx - Rephrased the trailing note in "Excluded endpoints" that said /metrics "does emit HTTP metrics on itself." Now: "is not excluded, so scrapes appear in the http_server_* series with http_route=\"/metrics\"."

Verification notes

Cross-checked against the local upstream clone at v1.5.1:

  • Extension routes (/registry/{name}/v0.1/x/dev.toolhive/plugins/...) match internal/api/registry/v01/routes.go and internal/api/x/plugins/routes.go.
  • Audit event names (plugin.list, plugin.read, plugin.versions.list, plugin.version.read) match internal/audit/audit.go.
  • Metric names, labels, and the _OTHER HTTP-method normalization match internal/telemetry/metrics.go, internal/telemetry/middleware.go, and docs/observability.md.
  • stacklok_product="stacklok-platform" verified against toolhive-core v0.0.38 at telemetry/metrics/ownership.go; stacklok_build_info_ratio labels (component, version, commit) verified against telemetry/metrics/buildinfo.go.
  • service.exposeInternalPort is real and defaults to true in deploy/charts/toolhive-registry-server/values.yaml.
  • Publish payload shape (server / skill / plugin mutually exclusive on POST /v1/entries) matches internal/api/v1/entries.go.

What I didn't change

  • The upgrade note in authorization.mdx ("Registry Server v1.4.x treated array-valued claims as AND-within-array...") is a valid change-in-behavior admonition per the style guide's exception clause. It documents a change upgraders need to know about and can act on.
  • Auto-generated files under static/api-specs/ were not touched.

Files edited on top of the release-docs commit

  • docs/toolhive/guides-registry/configuration.mdx
  • docs/toolhive/guides-registry/plugins.mdx
  • docs/toolhive/guides-registry/telemetry-metrics.mdx
  • Branch

github-actions Bot and others added 2 commits August 4, 2026 19:01
- Plugins guide: describe the plugin bundle format directly instead of
  narrating that Claude Code pioneered it, per the style guide's guidance
  against history framing when documenting current behavior.
- Configuration: normalize link text to match target page titles
  ("Manage skills" / "Manage plugins") for consistent sentence-case
  references.
- Telemetry: rephrase the trailing note about /metrics being
  instrumented; the previous "does emit HTTP metrics on itself" read
  awkwardly.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@github-actions
github-actions Bot requested review from JAORMX and rdimitrov August 4, 2026 19:02
@github-actions
github-actions Bot marked this pull request as ready for review August 4, 2026 19:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

autogen-docs Pull requests generated by automated release workflows

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant