Skip to content

[codex] Surface updated search and grep UX - #35

Merged
jlitola merged 4 commits into
mainfrom
spiny-cookie
Apr 24, 2026
Merged

[codex] Surface updated search and grep UX#35
jlitola merged 4 commits into
mainfrom
spiny-cookie

Conversation

@jlitola

@jlitola jlitola commented Apr 24, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Surface updated backend search and grep functionality across CLI, MCP schemas, shared request/response builders, and implementation docs.
  • Improve launch UX for search/grep: clearer query syntax, partial-result guidance, grep regex wording, symbol-field discoverability, source-status notes, duplicate folding, and CLI-native help text.
  • Fix production-discovered client issues: docs-only search no longer sends unsupported file-intent defaults, grep symbol hydration uses dynamic GraphQL selections, and help/version output no longer probes auth/keychain.

Validation

  • bun test
  • bun run typecheck
  • bun run build
  • Production smoke checks for search, docs-only search, partial search, grep symbol hydration, invalid symbol-field validation, and MCP search/grep before local keychain prompt blocked non-interactive stored-auth calls.
  • Help/version smoke checks with timeout after the final CLI startup fix.

Notes

  • Remaining result-quality concerns observed during testing are backend ranking/dedup/data-coverage issues and are being handled separately.

jlitola and others added 4 commits April 24, 2026 10:18
Adds discovery partial-result opt-in for unified search and grep symbol hydration across CLI, MCP, service types, response envelopes, and implementation docs.
Clarifies search and grep help text, validates grep symbol hydration fields, builds symbol selections dynamically, and avoids unsupported file-intent defaults for docs-only search.
Drops a stale "full doc fetch" placeholder that leaked to every
documentation_page result, renders sourceStatus notes on zero-result
searches (previously hidden by an early return), surfaces enclosing
symbol hydration inside --verbose grep output, reports ignored and
incompatible query-feature arrays from sourceStatus, suppresses
ignored-filter notes when the filter was auto-defaulted rather than
user-set, warns when --in is missing a registry prefix, folds
near-duplicate docs results in the terminal display with a count
indicator, and hardens several error paths — search-status NOT_FOUND
suggests starting fresh, backend 500s get a retry/narrow-target hint,
and backend "literal anchor" wording is rewritten to "literal
substring" so CLI docs and backend errors use consistent vocabulary.
Symbol-field validation errors now reference --symbol-field instead of
the MCP snake_case name. Help examples swapped from unreliably-indexed
@types/node to lodash and express queries that actually return hits.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Avoid auth/keychain probes when printing help or version output, while still exposing gated command shapes for help. Also rewrites shared grep pattern guidance into CLI flag vocabulary so command help does not leak MCP field names.
@jlitola
jlitola marked this pull request as ready for review April 24, 2026 12:04
@jlitola
jlitola merged commit 015f0ba into main Apr 24, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant