Add full-text search with per-backend SQLite/Postgres implementations

Implements the backend-agnostic search interface from the plan,
selected at runtime by connection.vendor:

- SQLite: an FTS5 virtual table (external-content, mirroring
  Article.title/content_html) created via a vendor-conditional
  migration, kept in sync by insert/update/delete triggers. Queries
  wrap the whole user input as a single FTS5 phrase so punctuation in
  a search box can't break MATCH syntax. `reindex_search` management
  command rebuilds it after bulk imports.
- Postgres: computes the search vector on the fly per the plan's
  decision (title weighted above content, no stored/indexed column)
  rather than diverging the schema from SQLite.

Both backends scope results to the requesting user's own subscriptions
and share the stream/detail article-row template and read/star/save
actions via a new apps.articles.queries.with_user_state() helper,
extracted from apps.reader.views to avoid duplicating that annotation
logic for search results.

Verified live: the SQLite path end-to-end in-browser against the real
Hacker News subscription (search UI, phrase matching, no-match case),
and the Postgres path against a throwaway Postgres container (search,
feed-scoping, and title-vs-content ranking), torn down afterward — not
part of this project's own infrastructure.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
ksmithandClaude Sonnet 5 committed 2026-10-30 16:37:22 -06:00
1 parent 5ed0499845
commit 8653dbeaf9
19 files changed
+569 -20

No files matched your search

Whitespace-only changes.
@@ -0,0 +1,20 @@
from django.core.management.base import BaseCommand
from django.db import connection
class Command(BaseCommand):
help = (
"Rebuild the SQLite FTS5 search index from scratch. No-op on Postgres, "
"which computes its search vector at query time instead of maintaining "
"a separate index."
)
def handle(self, *args, **options):
if connection.vendor != "sqlite":
self.stdout.write("Not using SQLite — nothing to rebuild.")
return
with connection.cursor() as cursor:
cursor.execute("INSERT INTO articles_fts(articles_fts) VALUES ('rebuild')")
self.stdout.write(self.style.SUCCESS("Rebuilt the SQLite FTS5 search index."))