Skip to content

Promote target resolution to stable CLI and MCP - #457

Merged
jlitola merged 9 commits into
mainfrom
jlitola/resolve-target-ga
Oct 6, 2026
Merged

jlitola merged 9 commits into
mainfrom
jlitola/resolve-target-ga

Conversation

@jlitola

@jlitola jlitola commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

resolve_target and githits resolve become default stable surfaces for fuzzy public package, repository and documentation-site names. The public MCP catalog contains 14 tools; Research remains experimental. MCP providers must now supply resolveTargetService, using the existing public /client implementation and /tools factory.

Resolver discovery now frames the agent task as identifying an OSS dependency’s canonical package, repository or docs target in a complete 79-character sentence. The descriptor and quick_start remove repeated argument, format and read-locator mechanics; the public MCP skill remains an exact guide copy. Compact result text gives uncertainty/empty-result instructions once, retains filter narrowing, and no longer claims multiple visible candidates for a singleton. Confidence/security gates, warnings, canonical locators, ranking, queries and JSON remain unchanged.

The implementation docs retain accepted launch limits, measured guidance/output sizes, neutral agent traces and the release/hosted rollout checklist. The pending fragment declares minor impact for both packages. Hosted clients receive the change after coordinated release, remote-mcp adoption and deployment.

Validation:

  • bun test: 5,486 passing tests, zero failures across 233 files. Review corrections passed 159 affected adapter/guide/parity/smoke tests.
  • Typecheck, lint, formatting, plugin generation/check and build passed. Existing packed-import/type/browser/artifact validation remains applicable; imports/exports are unchanged by the guidance refinement.
  • Authenticated dev CLI/MCP smokes passed, including resolver text/verbose/JSON, selected-target inventory and JSON parity. Experimental Research checks also passed. Built Node CLI/MCP smokes passed without credentials.
  • Exact text sizes: resolver description 1,121→580 bytes; full definition 3,342→2,799; guide 7,807→7,551 and public skill 8,338→8,082. Fixed ambiguous/empty cases 365→237 and 257→145; actionable and blocked fixtures unchanged. These are text sizes, not provider-token savings.
  • Four follow-up Claude/Codex runs produced structured answers with zero recorded isolation violations. Claude used fuzzy resolution then source; both agents used site resolution/docs and preserved MEDIUM identity uncertainty. Both full-guidance runs omitted quick_start. Codex still used web with zero GitHits calls on the neutral fuzzy prompt, so that run does not prove resolver discovery. Whole-run metrics and adapter limitations are documented.

Luna promotion preflight and internal reviews passed. Claude Opus 5.5 promotion round 1 was clean after minor wording fixes; refinement round 2 was clean after restoring the ambiguous filter remedy; round 3 approved the user’s OSS dependency framing. Both included permitted fresh-context final checks. Both temporary plans were retired after their clean reviews. Final PR CI and MCP package validation passed at 1913f7e: build/checks, Linux/Windows tests, Bun and Node 20/22/24/26 compatibility. Publishing was skipped. Two new targeted Claude/Codex runs also used the resolver and preserved MEDIUM identity uncertainty, with no recorded isolation violations.

Register the resolver by default and expose its required service and public factory. Preserve resolution gates, synchronize stable guidance, and validate source, packed, Node and dev paths before release and hosted adoption.
Describe Research as the remaining local experimental tool after resolver promotion.
Remove stale experimental resolver labels and document standalone site names in CLI help and command guidance. Record clean review closure and completed promotion evidence in the plan.
Keep reviewed promotion contracts, validation evidence, accepted launch limits and the pending release and hosted rollout checklist in permanent documentation.
@jlitola jlitola added the enhancement New feature or request label Oct 6, 2026
Expose the vague-name trigger within the discovery preview and remove repeated call mechanics from the resolver guide. Keep public skill parity and selection gates, compact uncertainty/empty text, and update catalog and smoke contracts with measured size and agent trace evidence.
Restore the narrowing options when consolidating the ambiguity action, and preserve explicit-choice and no-auto-selection checks. Simplify release-note wording and update the measured output size after review.
Retain the measured text reductions, agent limitations and clean review evidence in implementation documentation. Complete the temporary plan lifecycle after the second refinement review round.
Describe the agent task of identifying canonical dependency targets in the complete 79-character discovery sentence. Align quick_start and its public skill copy while retaining known-target skip rules and all continuation gates.
Record the user-requested descriptor correction and its clean internal, external and fresh-context verification.
@jlitola
jlitola marked this pull request as ready for review October 6, 2026 08:38
@jlitola
jlitola merged commit d2cfc30 into main Oct 6, 2026
10 checks passed
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