Conversation
jlitola
force-pushed
the
jlitola/unified-list-mcp
branch
from
September 29, 2026 14:43
8400a48 to
01fc63f
Compare
Export the transport-neutral list client API and require ListService in public and local MCP service providers.
Expose the backend list contract through a token-efficient MCP tool with shared text, JSON, validation, and error behavior.
Use MCP-native list actions and translate them to top-level githits list commands at CLI boundaries.
Register one list tool, update stable routing guidance, and remove code_files and docs_list from callable catalogs.
Replace retired public smoke inventories and fixture cases with the unified list tool. Exercise package and site text/JSON inventories, returned read actions, and cursor continuation.
Replace the retired docs_list and code_files parity cases with package and explicit-site list fixtures. Keep compact-package assertions scoped to package-addressed fixtures.
Replace separate source-directory and package-docs routing with one unified inventory route. Guide package-hosted documentation through an emitted explicit site target and assert exact-page reads use list results.
Add neutral descriptor-only scenarios for inventory boundaries, recursion and glob behavior, site-page locator reuse, continuation, and package-to-site discovery. Update active eval selection guidance while keeping pre-unification observations historical.
Drop CLI-to-MCP parity tests that require removed callable tools, while retaining direct legacy CLI implementation coverage and repository target checks for code_grep and read.
Include the five neutral list scenarios in the stable-full eval suite and pin the updated workload inventory and selection.
Keep the package.json exact-file read probe on its single-path listing, and exercise cursor replay with a root inventory query that returns two different pages.
Delete the unregistered code_files and docs_list factories and their MCP text renderers. Keep the grouped CLI request and response helpers, and document the host migration requirement for the unified list service.
Capture the completed review rounds, deterministic evidence, and the local Keychain limitation that still blocks authenticated live and agent-eval gates.
Preserve the 0.23.0 release-preparation facts while rebasing the Phase 2 plan onto current main.
Keep Phase 2 review evidence accurate after rebasing the implementation onto the 0.23.0 release commit.
Update the Phase 2 verification record for the exact head rebased onto the 0.23.0 release commit.
Add text-mode continuation commands for CLI and MCP, align list guidance with target-relative site paths, and preserve unified grep and read behavior after rebasing onto main.
Preserve main's search locator wording while asserting the unified list route.
jlitola
force-pushed
the
jlitola/unified-list-mcp
branch
from
September 29, 2026 14:46
01fc63f to
53509c4
Compare
This branch has not been deployed
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
1 participant
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.
The MCP catalog splits inventory browsing across
code_filesanddocs_list, giving packages, repositories, and hosted sites different schemas and leaving stale client guidance without one canonical replacement.This change replaces both callable tools with one ten-argument
listtool backed by the existing transport-neutralListService. Package and repository targets expose source and documentation together; hosted documentation remains a separate explicitsite:inventory. Paths are target-relative literals or globs for every target, directory recursion is independent of glob depth, and the shared CLI/MCP formatter emits only the source header, paths, and read/continuation guidance.Default text now carries the opaque continuation directly:
CLI renders the equivalent
--aftercommand. JSON remains available for programmatic consumers, while--silentstays paths-only for piping. The descriptor leads with listing intent and later saysReplaces code_files and docs_list.so full-description searches from stale skills still find the replacement.The branch was rebased onto current
main, preserving unified grep, target-relative site listing, and backend-authored unified read actions.Hosts upgrading
@githits/mcpmust provideMcpToolServices.listService.ListServiceandListServiceImplare exported from@githits/mcp/client, and custom endpoints must implementQuery.list.Validation:
bun test— 5,168 pass, 0 failbun run typecheckbun run format:checkbun run lint— nine pre-existing non-null assertion warningsbun run buildbun run plugins:generate/bun run plugins:checkbun run validate:packages