Following the feedback_code_changes_as_ideas_for_future rule, three candidate paths, in increasing complexity:
- Boost canonical framework root in the rewrite path. When a bare query (no
--framework) matches aframework_aliases.synonymsentry, append the canonical framework slug to the query as an OR clause:nfc OR corenfc. This should pull the canonical framework root up. Small surgical change in the SmartQuery layer.
- Per-source authority boost when the query matches a synonym. When the query matches a synonyms entry, give the matching framework a temporary RRF source-weight bonus. Larger change but follows the existing source-weight pattern.
- Document synonym usage in the CLI help. The current
cupertino searchhelp doesn't mention that--frameworkarguments accept synonyms. If the synonyms are filter-only, this should be made discoverable so users know to type--framework nfcrather than expecting bare-query synonym routing.
None is proposed as immediate work. The baseline exists so that any future change to the synonyms mechanism is measured against this 18% top-1 baseline as the regression starting point.