Discover help routes through intermediate aliases

This commit is contained in:
2026-10-20 01:03:54 +00:00
parent 4ddf960836
commit bafd365115
5 changed files with 121 additions and 59 deletions

View File

@@ -1,6 +1,6 @@
# Alias interaction audit remediation
Status: open; three confirmed findings.
Status: in progress; completed findings are marked individually below.
## Review scope and evidence
@@ -38,7 +38,7 @@ messages as contracts.
## R-1: Include intermediate alias prefixes in help discovery
Status: open. Priority: P2. Category: alias-chain composition.
Status: complete. Priority: P2. Category: alias-chain composition.
**Evidence:** [resolveEnteredRoute](../../route.go#L25) resolves the entered path
to its final form, then looks for discovery contexts using only that final path
@@ -86,6 +86,16 @@ Cover an overriding mapping and applicable global help aliases while preserving
descendant flag exclusion and metadata-only help. Execution and help must agree
on the displayed destinations.
**Completed:** Discovery selection now checks intermediate rewrite paths when
the entered and final paths do not supply a context. Canonical and discovery
help share alias listing across the resolution chain and resolve each displayed
suffix through actual execution precedence. New public-boundary regressions
failed before the correction and now cover group/discovery help, expanded
chains, entered overrides, both help forms, global help aliases, descendant
flag exclusion, metadata-only help, and matching execution destinations. The
complete offline root suite passed on Go 1.26.8. No canonical nodes or public
invocation metadata were added.
## R-2: Retain discovery-prefix context in usage diagnostics
Status: open. Priority: P3. Category: presentation consistency.