Add progressive orientation discovery - #78
Merged
Conversation
jlrickert
marked this pull request as ready for review
July 30, 2026 01:42
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.
Summary
keg_settingswith ordered, multi-KEG minimal retrieval grouped into one batch request per compatible Hubsummaryas concise discovery text andinstructionsas targeted operational guidance, then refresh rendered integration artifactsWhy
Aggregate orientation currently loads every covered KEG's operational instructions up front. That increases latency and token use before an agent has identified which KEGs are relevant. This change keeps session flight selection immutable and moves KEG-specific instructions behind an explicit targeted settings request.
Behavior
GET /api/v1/orientonce per Hub for compact discoverykeg_settingsaccepts mutually exclusivekegandkegs; batches are limited to 100 canonical references and minimal modeminimal=falsecontinues to return the complete config for exactly one KEGfull_accessThe corresponding Tapper Hub endpoints and hosted catalog integration are a coordinated follow-up change.
Validation
go test ./... -count=1go test -race ./pkg/mcp ./pkg/tappertask lint:docstask render-integrationsgo test ./pkg/tapper ./pkg/mcp ./pkg/integrations/... ./pkg/parity/...git diff --check