Repository navigation
feat: webjs source <Export> prints one export's signature and doc - #1624
Merged
Merged
Conversation
|
Preview for Next: fix the listed keys in the compose file |
Collaborator
Author
|
Benchmark, one warm-cache task-board build (same harness, model and credential as the $0.63 baseline; this branch alone):
Equal acceptance and looks, equal turns, cost within noise. Qualifies under the one-build gate. CI cannot run while the base is feat/context-pack (#1618); once that merges this PR retargets to main and |
vivek7405
marked this pull request as ready for review
October 8, 2026 03:17
vivek7405
force-pushed
the
feat/context-pack
branch
2 times, most recently
from
October 8, 2026 03:35
f6e84db to
be26980
Compare
An agent that needs one framework contract today greps or prints whole files under node_modules/@webjsdev/*. The unit it wants is one export: its signature and the doc comment above it. lookupExport() in @webjsdev/mcp finds the export in the installed packages' typed declarations first (index.d.ts, src/*.d.ts), falls back to the authored JSDoc in src/ when no typed hit carries a doc, prints every overload and names the searched packages on a miss. The MCP source tool takes it as `export`, and `webjs source <Export> [--pkg <name>]` prints the same text for a Bash-only agent (exit 1 on a miss). The skill, the scaffold AGENTS.md, the CLI reference and the docs site teach it; the source stays the source of truth, this is the cheap first step. Closes #1623 Claude-Session: https://claude.ai/code/session_01SZ72LSPAo4NvYvBDSD6RLo
vivek7405
force-pushed
the
feat/source-export
branch
from
October 8, 2026 04:31
139cc22 to
4d04796
Compare
The hook's drift guard requires every CLI subcommand in its list, so the new webjs source command failed the unit and Bun matrices. Claude-Session: https://claude.ai/code/session_01SZ72LSPAo4NvYvBDSD6RLo
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 #1623
lookupExport()in@webjsdev/mcpreturns one export's signature plus the doc comment above it from the installed@webjsdev/*packages: the typed declarations first (index.d.ts,src/*.d.ts), the authored JSDoc insrc/when no typed hit carries a doc, every overload, and a miss that names the searched packages. The MCPsourcetool takes it asexport;webjs source <Export> [--pkg <name>]prints the same text for a Bash-only agent (exit 1 on a miss). Taught in the skill ("Full Documentation"), the scaffold AGENTS.md step 3, the root AGENTS.md CLI reference,packages/mcp/AGENTS.mdand the docs configuration page.Tests:
packages/mcp/test/mcp-source.test.mjs(fake tree plus the realcreateAuth),test/cli/source.test.mjs,test/cli/help.test.mjs.https://claude.ai/code/session_01SZ72LSPAo4NvYvBDSD6RLo