Skip to content

Make pkg changelog package-only with compact targets - #407

Open
jlitola wants to merge 5 commits into
mainfrom
jlitola/mcp-tool-surface-plan
Open

jlitola wants to merge 5 commits into
mainfrom
jlitola/mcp-tool-surface-plan

Conversation

@jlitola

@jlitola jlitola commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Make MCP and CLI pkg changelog package-only: one compact registry:name[@version|@from..to] target, no repository or site coordinates.
  • Route exact pins through packageInfo.selectedVersion.changelog and timelines through packageChangelog. Empty selections and no-notes exact releases succeed; missing pins stay VERSION_NOT_FOUND.
  • Align discovery copy so the tool first sentence, routing table, CLI help, and package skill all ask for package changelog history. Schema owns grammar and package-only rejection; descriptions keep modes and outcomes.

Test plan

  • Targeted unit tests for changelog parser/request/response, MCP tool, CLI help, parity, skills packaging, and catalog first-sentence/first-80 contracts
  • bun run plugins:generate and bun run plugins:check
  • bun run smoke:mcp and bun run smoke:cli (live-capable; exact pin plus repository rejection)
  • Pipeline agent evals for changelog routing (package-changelog.md, package-changelog-exact.md, package-changelog-range.md, descriptor-only catalog probe)

Made with Cursor

@jlitola jlitola added the enhancement New feature or request label Sep 18, 2026
jlitola and others added 4 commits September 18, 2026 14:19
MCP pkg_changelog now takes one required package target for latest, exact,
and interval lookups instead of structured coordinates or repository
addressing. CLI keeps --from/--to as package flags, exact pins use
packageInfo changelog, and empty timeline selections succeed.

Co-authored-by: Cursor <[email protected]>
Keep the first sentence and first 80 characters, drop repeated grammar from
the tool description, and align routing and skills with package-only targets.

Co-authored-by: Cursor <[email protected]>
Exact mode text was echoing the requested selector in the summary header.
Keep filter.version as the selector and show the concrete entry version.

Co-authored-by: Cursor <[email protected]>
Keep the package-only changelog note as a new 0.21 fragment instead of
editing the fragment that 0.20.0 already consumed.

Co-authored-by: Cursor <[email protected]>
@jlitola
jlitola force-pushed the jlitola/mcp-tool-surface-plan branch from 45eb6c4 to 642cd45 Compare September 18, 2026 11:19
Cover executeExactPackageChangelog GraphQL 'No matching version found'
the same way packageDependencies already does, so a missing pin stays
VERSION_NOT_FOUND.

Co-authored-by: Cursor <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant