Nudgarr v5.0.1 — Patch Release

Patch: Library search & imports filtering (v5.0.1 follow-up)

Imports

Title search now works: GET /api/stats accepts a search query param; get_confirmed_entries() filters with LOWER(title) LIKE (substring, case-insensitive). The UI sends importsSearch on refresh.
Imports · CF Score · Exclusions

Search box + clear: Replaced x-model.debounce + immediate @input refresh (stale value) with x-model + @input.debounce on refresh, matching Library History. Typing and clearing the field now match what the server returns.
Docs

CHANGELOG (v5.0.1), CONTRIBUTING (/api/stats params), and entries.py module notes updated.
No DB migrations; restart / redeploy to pick up changes.

Author: MMagTech

CHANGELOG.md

@@ -11,7 +11,7 @@ All notable changes to Nudgarr are documented here.
 - **Library History:** `GET /api/state/items` now applies `type` (Cutoff Unmet, Backlog, CF Score) and `search` (case-insensitive title substring). `get_search_history()` in `db/history.py` implements filters; Cutoff Unmet matches DB values `Cutoff`, `Cutoff Unmet`, and empty legacy `sweep_type`. History title search uses immediate `x-model` with debounced refresh so the request uses the typed text.
 - **CF Score table:** Column sort (`sort` / `dir`) and title `search` are applied in SQL; `total` for pagination is a filtered count via `count_cf_score_entries()`. **Instance filter** dropdown uses `app|normalised_url` (`cfKey` on each `allInstances` row) to match `arr_instance_id` in `cf_score_entries` (same format as `cf_score_syncer._make_instance_id`), fixing per-instance filter when not on “All Instances”.
 - **Library Exclusions:** Sortable columns (title, search count, excluded date); **Unexclude** uses the green `.btn.ok` style; `unexcludeItem` refreshes the filtered paginated list.
-- **Library Imports:** Turnaround column is sortable (uses numeric `turnaround_days`).
+- **Library Imports:** Turnaround column is sortable (uses numeric `turnaround_days`). Title **`search`** query param wired through `GET /api/stats` to `get_confirmed_entries()`. Imports / CF Score / Exclusions title fields use immediate `x-model` with **`@input.debounce`** on refresh (not debounced `x-model` with immediate `@input`) so typing and clearing the search box match the data Nudgarr fetches.
 - **Default panel:** `VALID_TABS` in `constants.py` includes v5 panels `library` and `pipelines` (and keeps legacy `history`, `imports`, `cf-scores`) so saving Advanced “Default Panel” validates correctly.
 - **Docs:** `CONTRIBUTING.md` documents History/CF query params and `allInstances` `key` vs `cfKey`.
 - **Tests:** `tests/test_config_validation.py` asserts `library` and `pipelines` as valid `default_tab`; `tests/test_frontend_structure.py` raises the `app.js` line ceiling to match current file size.

CONTRIBUTING.md

@@ -82,7 +82,8 @@ nudgarr/                    <- Python package
     state.py                <- /api/state/*, /api/state/clear, /api/file/*, /api/exclusions*,
                                /api/arr-link; GET /api/state/items passes type & search query
                                params through to get_search_history()
-    stats.py                <- /api/stats, /api/stats/clear, check-imports
+    stats.py                <- /api/stats (instance, type, search, period, pagination),
+                               /api/stats/clear, check-imports
     intel.py                <- /api/intel, /api/intel/reset
     cf_scores.py            <- /api/cf-scores/status, /api/cf-scores/entries (instance_id,
                                search, sort, dir), /api/cf-scores/scan, /api/cf-scores/reset

nudgarr/db/entries.py

@@ -6,7 +6,8 @@
   upsert_stat_entry()       -- insert or update the active (unimported) row
   confirm_stat_entry()      -- mark a row as imported; insert quality_history row
   get_unconfirmed_entries() -- entries eligible for import checking
-  get_confirmed_entries()   -- paginated confirmed imports with quality history
+  get_confirmed_entries()   -- paginated confirmed imports with quality history;
+                               optional title_search (substring)
   get_period_totals()       -- confirmed import counts for a rolling day window
   rename_instance_in_history() -- update instance name after a rename
   clear_stat_entries()      -- delete all rows
@@ -332,13 +333,14 @@ def get_confirmed_entries(
     offset: int = 0,
     limit: int = 25,
     period_days: Optional[int] = None,
+    title_search: str = "",
 ) -> Tuple[int, List[Dict], List[str]]:
     """Return paginated confirmed (imported) stat entries with optional filters.
     Returns a three-tuple: (total, entries, available_types) where total is the
-    count matching instance / type / period filters, entries is the current page
+    count matching instance / type / period / title_search filters, entries is the current page
     of dicts with a computed turnaround field and quality_history list, and
     available_types is the distinct list of entry types present for the current
-    instance and period filters (type filter is not applied to that list).
+    instance and period filters (type filter and title_search are not applied to that list).
 
     When ``period_days`` is 7 or 30, only rows with ``imported_ts`` within the
     last N days are included (same cutoff as ``get_period_totals``). When
@@ -363,7 +365,11 @@ def get_confirmed_entries(
     if type_filter:
         where.append("se.type = ?")
         params.append(type_filter)
-        where_sql = "WHERE " + " AND ".join(where)
+    q = (title_search or "").strip()
+    if q:
+        where.append("LOWER(se.title) LIKE ?")
+        params.append("%" + q.lower() + "%")
+    where_sql = "WHERE " + " AND ".join(where)
 
     total = conn.execute(
         f"SELECT COUNT(*) FROM stat_entries se {where_sql}", params

nudgarr/routes/stats.py

@@ -7,7 +7,9 @@
   POST /api/stats/clear          -- clear all stat entries (preserves lifetime totals)
   POST /api/stats/check-imports  -- manually trigger import check now
 
-The GET endpoint accepts an optional `period` query param (lifetime, 30, 7).
+The GET endpoint accepts optional query params: `period` (lifetime, 30, 7),
+`instance`, `type`, `search` (case-insensitive title substring on confirmed imports),
+plus `offset` and `limit` for pagination.
 Lifetime returns the persistent lifetime totals; 30 and 7 return rolling window
 counts calculated from imported_ts in stat_entries.
 """
@@ -51,12 +53,15 @@ def api_get_stats():
     elif period == "30":
         period_days = 30
 
+    title_search = request.args.get("search", "").strip()
+
     total, entries, available_types = db.get_confirmed_entries(
         instance_url_filter=instance_filter,
         type_filter=type_filter,
         offset=offset,
         limit=limit,
         period_days=period_days,
+        title_search=title_search,
     )
 
     # Resolve totals for the requested period.

nudgarr/templates/ui.html

@@ -358,7 +358,7 @@
             <div class="field"><select x-model.number="importsPageSize" @change="importsPage=0;refreshImports()" style="width:auto">
               <option value="10">10</option><option value="25">25</option><option value="50">50</option>
             </select></div>
-            <div class="field" style="flex:1;min-width:180px"><input type="text" placeholder="Search title&hellip;" x-model.debounce.400ms="importsSearch" @input="importsPage=0;refreshImports()"></div>
+            <div class="field" style="flex:1;min-width:180px"><input type="text" placeholder="Search title&hellip;" x-model="importsSearch" @input.debounce.400ms="importsPage=0;refreshImports()"></div>
             <button class="btn sm ac" @click="checkImportsNow()">Refresh</button>
           </div>
           <div class="table-wrap">
@@ -427,7 +427,7 @@
               <template x-for="inst in allInstances" :key="inst.cfKey"><option :value="inst.cfKey" x-text="inst.name"></option></template>
             </select></div>
             <div class="field"><select x-model.number="cfPageSize" @change="cfPage=0;refreshCfScores()" style="width:auto"><option value="25">25</option><option value="50">50</option></select></div>
-            <div class="field" style="flex:1;min-width:180px"><input type="text" placeholder="Search title&hellip;" x-model.debounce.400ms="cfSearch" @input="cfPage=0;refreshCfScores()"></div>
+            <div class="field" style="flex:1;min-width:180px"><input type="text" placeholder="Search title&hellip;" x-model="cfSearch" @input.debounce.400ms="cfPage=0;refreshCfScores()"></div>
           </div>
           <div class="table-wrap">
           <table>
@@ -477,7 +477,7 @@
             <div class="field"><select x-model.number="exclPageSize" @change="exclPage=0;refreshExclusions()" style="width:auto">
               <option value="10">10</option><option value="25">25</option><option value="50">50</option>
             </select></div>
-            <div class="field" style="flex:1;min-width:180px"><input type="text" placeholder="Search title&hellip;" x-model.debounce.400ms="exclSearch" @input="exclPage=0;refreshExclusions()"></div>
+            <div class="field" style="flex:1;min-width:180px"><input type="text" placeholder="Search title&hellip;" x-model="exclSearch" @input.debounce.400ms="exclPage=0;refreshExclusions()"></div>
             <button class="btn sm dng" @click="openClearExclModal()">Clear Exclusions</button>
           </div>
           <div class="table-wrap">