Skip to content

[AUTO] Adding MCP Servers docs update#925

Closed
evantahler wants to merge 6 commits intomainfrom
automation/toolkit-docs-24590972808
Closed

[AUTO] Adding MCP Servers docs update#925
evantahler wants to merge 6 commits intomainfrom
automation/toolkit-docs-24590972808

Conversation

@evantahler
Copy link
Copy Markdown
Contributor

@evantahler evantahler commented Apr 17, 2026

This PR was generated after a Porter deploy succeeded.


Note

Low Risk
Low risk because changes are confined to generated documentation/metadata JSON (tool listings, counts, timestamps) with no runtime code changes; main impact is potential drift if removed tools were expected to be documented.

Overview
Updates the generated toolkit docs data under toolkit-docs-generator/data/toolkits.

GitHub toolkit: removes the two notifications-related tools (GetNotificationSummary, ListNotifications) and updates the toolkit toolCount accordingly.

Jira toolkit: drops two priority-scheme association tools and updates toolCount.

Linear toolkit: bumps docs metadata from 3.3.2 to 3.3.3 and clarifies UpdateIssue.assignee docs to describe how to clear an assignee.

Also refreshes generatedAt timestamps and removes the embedded summary fields from the GitHub and Jira JSON outputs.

Reviewed by Cursor Bugbot for commit abd5c64. Bugbot is set up for automated code reviews on this repo. Configure here.

jottakka and others added 6 commits April 17, 2026 00:29
Ensure version coherence prefers stable releases over matching pre-release tags, and make fetchAll toolkit metadata resolution use the same providerId fallback path as single-toolkit fetches.

Made-with: Cursor
Reduce comparator complexity while preserving semver precedence behavior for stable and pre-release versions.

Made-with: Cursor
Extract optional prerelease part comparison so the semver helper stays readable and below complexity warning thresholds.

Made-with: Cursor
Fix redundant metadata lookups in fetchToolkitData and add regression tests for semver prerelease ordering plus metadata lookup behavior across single and bulk toolkit paths.

Made-with: Cursor
Address review findings from six parallel reviewers:
- Use compareVersions for filter equality so semver-equal tools (e.g. @1.0.0 vs @1.0.0+build.1) no longer get silently dropped.
- Replace localeCompare("en") with ASCII byte ordering per SemVer 2.0.0 §11.4.2 so mixed-case prerelease tags rank correctly.
- Replace ambiguous best === "" sentinel with a null sentinel in getHighestVersion.
- Drop the allowToolkitIdLookup flag and lift the toolkit-id retry into the fetchAllToolkitsData call site; shared helper now only owns the *Api provider-id fallback.
- Inline single-use compareOptionalPrereleasePart and simplify comparePrereleaseIdentifier with typeof narrowing.
- Add regression tests: direct-map-hit no-relookup, patch-only version diff, ASCII prerelease ordering, string-vs-string prerelease, all-unversioned tools, semver-equal tools with differing build metadata.

Made-with: Cursor
@evantahler evantahler requested a review from a team April 17, 2026 23:26
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 17, 2026

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Apr 17, 2026 11:30pm

Request Review

Base automatically changed from fix/version-coherence-prerelease-metadata-fallback to main April 17, 2026 23:29
@jottakka jottakka closed this Apr 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants