fix: correct release trust and onboarding metadata#16
Merged
Conversation
gael55x
marked this pull request as ready for review
July 14, 2026 10:20
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
Grape 1.0 shipped with two release-trust defects:
0.1.0and linked tograperoot.dev, an unrelated product that advertises a different installer.grape-context@beta, which currently resolves to beta.9 instead oflatest=1.0.0.The README also presented repo-local Codex marketplace commands as normal onboarding even though those commands require a Grape source checkout. Public npm metadata had no focused discovery keywords.
Root cause
The plugin check hardcoded the stale plugin version and did not validate homepage ownership or package-version alignment. Beta-era operational guidance survived the stable release because active onboarding had no release-consistency check.
Changes
Plugin trust
package.json.plugin:checkreject future version, homepage, repository, and website drift.Stable onboarding
@betainstall and recovery commands with the stable package.Discovery
Behavioral comparison
0.1.01.0.0@betalatestValidation
npm run check: passed on the combined branch, including 456 of 456 behavior testsnpm run package:check: passednpm run plugin:check: passednpm run docs:check: passed again after the final README review changenpm run benchmark:run: all seven existing fixtures passed on synchronizedmainbefore editsnpm run e2e:alpha: passednpm run test:connect: packed CLI and MCP trial passednpm audit --audit-level=low: zero known vulnerabilitiesThe packed-package baseline is 237,262 bytes compressed and 1,141,779 bytes unpacked across 316 files.
Benchmark limits
The existing fixtures show same-session body reduction and invalidation behavior, but they do not prove real-agent token savings, production-scale performance, or superiority over external tools. Those claims remain intentionally out of scope.
Risks and tradeoffs
CHANGELOG.mdmay need a small conflict resolution if PR chore: capability audit with transport and scalability fixes #15 lands first.Remaining follow-ups
PR #15 is merged into
mainand included in this branch through merge commit45a443b. It owns unchanged-turn self-invalidation, warm MCP marker payload reduction, Git output limits, and bootstrap snapshot duplication.Validated follow-up work still needs separate design or evidence:
Adoption implications
This removes two trust-breaking onboarding defects and improves npm discovery without changing the approved README tagline. Broader promotion should wait for this combined branch to ship in a verified patch release.