Thanks to visit codestin.com
Credit goes to github.com

Skip to content

docs(docs/ai-coder/agents): document the chat search: full-text filter - #28474

Merged
f0ssel merged 3 commits into
mainfrom
garrett/codagt-727-chat-search-documentation-and-release-notes
Aug 25, 2026
Merged

docs(docs/ai-coder/agents): document the chat search: full-text filter#28474
f0ssel merged 3 commits into
mainfrom
garrett/codagt-727-chat-search-documentation-and-release-notes

Conversation

@f0ssel

@f0ssel f0ssel commented Aug 24, 2026

Copy link
Copy Markdown
Member

Documents the search: full-text filter in docs/ai-coder/agents/chat-search-syntax.md and drafts the release notes copy for chat history search.

Describes main plus #28319, which must merge first: stemming and stopword removal apply to message content only; titles and PR titles keep simple whole-word matching. All claims verified against the implementation. Two statements in CODAGT-727 were inaccurate and are documented as the code behaves:

  • A value that tokenizes to no searchable words returns an empty list, not HTTP 400 (TestListChats_Search/NoSearchableWordsReturnsEmpty). HTTP 400 covers only an empty search: value, unsupported keys, bare terms, or combining search: with title:, pr_title:, or pr: (coderd/searchquery/search.go).
  • Results are paginated with the standard chat list cursor (default 50), not a bounded non-paginated set (GetChats, listChats). Ordering is pinned first, then most recently updated.

Also verified: message bodies are indexed by the dbpurge sweep (10-minute tick, up to 5 x 10,000 rows, newest first) while titles and PR titles are searchable immediately; numeric values match exact PR numbers; title:, pr_title:, and repo: retain ILIKE semantics.

pnpm run format-docs and pnpm run lint-docs pass.

Closes CODAGT-727

Release notes draft

Chat history search

You can now search your chat history by what was said, not just by title. The chat list q parameter accepts a new search: filter that performs full-text search across chat titles, pull request titles, PR numbers, and message content, for example ?q=search:"kubernetes restart". Matching is case-insensitive and supports quoted phrases, OR, and - negation. Message content additionally matches English word stems (refactor finds a message containing refactoring). search: cannot be combined with the title:, pr_title:, or pr: filters; the existing substring filters are unchanged.

Upgrading with existing chat history: the message search index is populated by a background job (every 10 minutes, up to 50,000 messages per run, newest first). Upgrades are not blocked, and chat reads and writes are unaffected while the index fills. Older messages appear in search results progressively; messages indexed before the stemming upgrade match exact word forms until re-indexed. Titles and PR titles are searchable immediately.


🤖 This PR was generated by Coder Agents on behalf of @f0ssel.

@linear-code

linear-code Bot commented Aug 24, 2026

Copy link
Copy Markdown

CODAGT-727

@github-actions

github-actions Bot commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Docs preview

Check off each page once it's been reviewed. If a page changes in a later push, its checkbox clears automatically so it gets a fresh look. Pages not yet wired into the docs navigation aren't listed here.

@f0ssel

f0ssel commented Aug 24, 2026

Copy link
Copy Markdown
Member Author

Relies on #28319 being merged first to stay accurate.

@f0ssel
f0ssel marked this pull request as ready for review August 24, 2026 17:51
@f0ssel
f0ssel requested a review from johnstcn August 24, 2026 20:20
@f0ssel
f0ssel merged commit 7cf24b1 into main Aug 25, 2026
33 checks passed
@f0ssel
f0ssel deleted the garrett/codagt-727-chat-search-documentation-and-release-notes branch August 25, 2026 13:09
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 25, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants