sawz/last30days-skill
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update plan to reflect single upstream PR strategy

Browse Source
This commit is contained in:
Jeffrey Sperling
2026-03-11 15:45:42 -07:00
parent 046795c4ae
commit 6c402f66b7
1 changed files with 12 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/plans/2026-03-11-refactor-query-relevance-consolidation-plan.md
+12 -7
View File
@@ -1,16 +1,17 @@
# Search Pipeline: Query & Relevance Consolidation # Search Pipeline: Query & Relevance Consolidation
## Strategy: Two-phase delivery ## Strategy: Single upstream PR
**Phase 1 — Upstream PR** (`refactor/query-relevance-consolidation` -> `mvanhorn/last30days-skill:main`) **Branch**: `refactor/query-relevance-consolidation` -> `mvanhorn/last30days-skill:main`
Pure refactors and bug fixes anyone would want. No behavior changes. **PR**: https://github.com/mvanhorn/last30days-skill/pull/65
**Phase 2 — Fork-only** (`feat/search-quality` on `j-sperling/last30days-skill`) All changes (refactors + behavior improvements) combined into one upstream PR.
Opinionated behavior changes: computed relevance scores, platform-specific query optimization, post-retrieval filtering. Originally planned as two phases, but the search quality improvements are
broadly useful, not opinionated — merged into a single contribution.
--- ---
## Phase 1: Upstream PR (refactors + bug fixes) ## Refactors (commits 1-5)
### Step 1: New `query.py` — shared query utilities ### Step 1: New `query.py` — shared query utilities
- Consolidate 7 duplicated `_extract_core_subject()` (bird_x, reddit, youtube_yt, tiktok, instagram, bluesky, scrapecreators_x) into one parameterized function - Consolidate 7 duplicated `_extract_core_subject()` (bird_x, reddit, youtube_yt, tiktok, instagram, bluesky, scrapecreators_x) into one parameterized function
@@ -49,7 +50,7 @@ Opinionated behavior changes: computed relevance scores, platform-specific query
--- ---
## Phase 2: Fork-only (behavior changes) ## Search quality improvements (commits 6-8)
### Step 4: Replace hardcoded relevance with computed scores ### Step 4: Replace hardcoded relevance with computed scores
- `bird_x.py:471` — `"relevance": 0.7` → `token_overlap_relevance(core_topic, text)` - `bird_x.py:471` — `"relevance": 0.7` → `token_overlap_relevance(core_topic, text)`
@@ -73,6 +74,10 @@ Opinionated behavior changes: computed relevance scores, platform-specific query
--- ---
## Status: COMPLETE
All 8 commits pushed to `refactor/query-relevance-consolidation`. PR #65 updated.
## Verify ## Verify
```bash ```bash