docs(fred): README, design doc, marketplace entry - #40
Merged
Conversation
Makes the plugin installable, which is why it comes after all five tools exist
rather than before.
The design doc's "what the curation buys" table is measured against the live API
rather than estimated. The headline row: the fed funds rate over 20 years is
694,388 chars of raw FRED payload and 4,194 from this server, and the shorter one
is the better answer, because the exact 20-year min of 0.04 and max of 5.41 are
in the summary instead of somewhere in 5,000 rows.
Also adds two guards this repo has needed before: that ${CLAUDE_PLUGIN_ROOT}
carries no :-default (the default silently wins and the server launches from the
user's own directory), and that the marketplace entry's source path resolves to
this plugin directory.
Version 0.5.0, one minor per PR in the stack, as the plugin-version gate requires.
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.
Closes #35, and completes the stack from #30. On top of #39. No new code in
src/.This is the PR that makes the plugin installable, which is why it comes last rather than first: the stack should not advertise a server whose tools do not exist yet.
What's here
plugins/fred/README.md— install, credentials, the five tools, development.plugins/fred/docs/design.md— the reasoning, followingplugins/tastytrade/docs/design.md..claude-plugin/marketplace.json— thefredentry.README.md— a row in the servers table, andfredin the layout tree.What the curation buys, measured
The design doc's central table is measured against the live API, not estimated. Response sizes in characters:
The first row is the argument for the whole design: 0.6% of the payload, and a better answer, because the exact 20-year minimum of 0.04 and maximum of 5.41 are in the summary rather than somewhere in 5,000 rows a model has to scan.
Two guards this repo has needed before
${CLAUDE_PLUGIN_ROOT}must be bare. The:-defaultform is handled by env-var expansion, which does not know that variable, so the default always wins and the server launches against the user's own project directory. tastytrade carries the same test with a note that a sibling plugin shipped broken three times before it existed.sourcemust resolve to this directory. A listed plugin pointing at the wrong path fails at install with nothing useful to read.Version ladder
The
plugin versiongate compares each PR against its own base, so every PR in a stack that touches shipped files needs its own bump. Applied bottom-up:Nothing is installable until this PR lands, so no intermediate version ever reaches a user.
Verification
284 tests, 98% coverage,
make checkclean.End to end through the real launcher, minimal PATH, real API key:
The version reported over the wire comes from
plugin.jsonrather than a constant, so the two cannot drift.