Per the feedback_code_changes_as_ideas_for_future rule:
- CLI flag for kind-based filtering.
cupertino search --kind initializeror--kind actorwould route throughSearchByAttributeand return all pages with at least one matching symbol. Small CLI surface change; harness logic already exists. Highest-value first move. - Heuristic intent routing for attribute queries. Queries that match the pattern
^(async|throws|public|static|init|subscript|typealias|@\w+|.* conformance)$route throughSearchByAttributeautomatically. More work, but no flag-discovery burden on the consumer. - Augment FTS5 with attribute tokens. Add a
attributescolumn todocs_ftscontaining concatenated per-page attribute / conformance strings, BM25F-weighted (similar tosymbols). Largest surface change; affects schema (user_versionbump); requires reindex.
The acronym audit (search-quality-acronym-baseline-v1.2.0.md) raised analogous concerns about framework_aliases.synonyms not being consulted at FTS5 ranking time. Both audits point at the same broader pattern: cupertino's relational metadata tables are richer than the default FTS5 search path consults. A consolidated design for "non-text search modes" could address both classes simultaneously.