fix: search populate snippet field from EFTS highlight payload (#47)

[joce]

Summary

Fixes #47 — edgarq search was returning rows with \"snippet\": \"\" always.

Root cause: the EFTS API (efts.sec.gov/LATEST/search-index) does NOT return highlight fragments at all. The server-side Elasticsearch query excludes doc_text from _source and never adds a highlight clause, so the existing code that read hit[\"highlight\"] always found an empty dict. The SEC's own EDGAR full-text search UI confirms this — it doesn't show per-row snippets either.

Fix: after fetching each EFTS page, fetch the matched filing's primary document (https://www.sec.gov/Archives/edgar/data/{cik}/{accession_no_dashes}/{filename}), strip tags, and extract a ±150-char window around the first case-insensitive match of the query. Best-effort: a 404/5xx on the doc fetch yields an empty snippet but never aborts the search. Non-text primaries (.pdf, etc.) are skipped.

Test plan

• New unit test test_search_snippet_populated_from_filing_text — mocks EFTS + filing HTML, asserts snippet contains query terms (failed before fix, passes after).
• New unit test test_search_snippet_fetch_failure_yields_empty — verifies a 404 on the filing fetch leaves snippet empty without affecting other row fields.
• Existing 14 unit tests in test_search.py updated to register a catch-all archive 404 mock (snippet stays empty for them, all other assertions unchanged).
• Full uv run tox matrix py3.10–3.14 green (black, ruff format, ruff check, pyright, pytest).
• Live smoke uv run edgarq search \"climate risk\" --forms 10-K --limit 2 --no-cache returns non-empty snippets containing "Climate Risk" excerpts for both Carnival Corp and MSCI Inc.

🤖 Generated with Claude Code

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 67.34694% with 16 lines in your changes missing coverage. Please review.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
src/edgarq/commands_impl/search.py	67.34%	8 Missing and 8 partials ⚠️

📢 Thoughts on this report? Let us know!

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 685f932216

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".