Compose discovery help through group aliases

This commit is contained in:
2026-10-20 00:25:33 +00:00
parent fa09edf8cc
commit c231a41665
4 changed files with 123 additions and 19 deletions

View File

@@ -146,7 +146,7 @@ The complete offline root suite passed on Go 1.26.8.
## R-4: Resolve discovery-help contexts through group shortcuts
Status: open. Priority: P2. Category: incomplete alias composition.
Status: complete. Priority: P2. Category: incomplete alias composition.
**Evidence:** Discovery contexts are indexed by declared source prefixes in
[discoverFlagContexts](../../flag_aliases.go#L157), while
@@ -176,6 +176,15 @@ show `pk admin` in usage, and list the routes actually reachable there.
Cover the global help alias and a more-specific route override; do not add
canonical groups or inherit descendant flags to make discovery work.
**Completed:** Discovery selection now checks the resolved prefix and retains
the entered route; help merges applicable entered/resolved routes and resolves
each destination through actual shortcut precedence. Regressions first failed
for the missing composed context and omitted inherited routes. Both help forms,
global help aliases, more-specific overrides, entered-only prefixes, expanded
group paths, bare-prefix usage, and descendant-flag exclusion now pass. No
canonical nodes were added. The full offline root suite and added path cases
passed on Go 1.26.8.
## R-5: Include alias routes in help for groups without canonical children
Status: open. Priority: P2. Category: help discovery gap.