kryten-webqueue 0.35.0__tar.gz → 0.35.1__tar.gz

{kryten_webqueue-0.35.0 → kryten_webqueue-0.35.1}/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 ## [Unreleased]
 
+## [0.35.1] - 2026-08-13
+
+### Fixed
+
+- **Catalog Enrich job UX.** The `catalog_enrich` admin job modal was
+  unusable — raw comma-separated step names, unexplained "tokens" field.
+
+  - **Steps** is now a dropdown of labelled presets (e.g. *"Full pipeline",
+    "Enrichment only", "Art only", "Title cleanup only"*) rather than a
+    free-text field requiring knowledge of internal step names.
+  - **Specific items** replaces the opaque "Tokens" label. Placeholder text
+    and help text explain that these are the short MediaCMS media IDs visible
+    in item URLs, and that leaving it blank processes the whole catalog.
+  - **All fields** now show help text beneath them (Force re-run, Dry run,
+    Item limit, Description quality threshold are all explained).
+  - Help text rendering added to `_jobFieldHtml` in `admin.js` — all jobs
+    that define a `help` key on their schema fields now display it. A
+    `placeholder` key is also honoured on text/number inputs.
+  - `.field-help` CSS class added for the muted hint lines.
+  - Token parsing accepts comma- or space-separated IDs and ignores `"all"`
+    for the default blank case.
+
 ## [0.35.0] - 2026-08-13
 
 ### Added

{kryten_webqueue-0.35.0 → kryten_webqueue-0.35.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: kryten-webqueue
-Version: 0.35.0
+Version: 0.35.1
 Summary: Netflix/Tubi-style catalog browser and pay-to-play queue management for CyTube
 Author: grobertson
 License-Expression: MIT

{kryten_webqueue-0.35.0 → kryten_webqueue-0.35.1}/kryten_webqueue/jobs/tasks.py

@@ -104,9 +104,11 @@ async def catalog_enrich_job(params: dict, ctx) -> dict:
     )
     step_param = params.get("steps", "all")
     steps = None if step_param == "all" else [s.strip() for s in step_param.split(",")]
-    token_param = params.get("tokens", "all")
+    token_param = (params.get("tokens") or "").strip()
     tokens = (
-        None if token_param == "all" else [t.strip() for t in token_param.split(",")]
+        None
+        if not token_param or token_param == "all"
+        else [t.strip() for t in token_param.replace(",", " ").split() if t.strip()]
     )
 
     report = await pipeline.run(
@@ -124,19 +126,55 @@ async def catalog_enrich_job(params: dict, ctx) -> dict:
 CATALOG_ENRICH_SCHEMA = [
     {
         "name": "steps",
-        "label": "Steps",
-        "type": "string",
+        "label": "Pipeline steps",
+        "type": "enum",
         "default": "all",
         "required": False,
-        "help": "Comma-separated: sync,classify,title,meta,art,tags,categories — or 'all'",
+        "options": [
+            {
+                "value": "all",
+                "label": "Full pipeline — sync → classify → title → meta → art → tags",
+            },
+            {
+                "value": "classify,meta,art,tags",
+                "label": "Enrichment only — classify, fetch metadata, art, and tags (no sync)",
+            },
+            {"value": "art", "label": "Art only — (re-)fetch poster art"},
+            {
+                "value": "classify,art",
+                "label": "Classify + art — re-detect content type then fetch art",
+            },
+            {
+                "value": "classify,meta",
+                "label": "Classify + metadata — descriptions and credits only",
+            },
+            {
+                "value": "tags",
+                "label": "Tags only — push genres/MPAA/hosted-show tags to CMS",
+            },
+            {
+                "value": "title",
+                "label": "Title cleanup only — normalise and push corrected titles",
+            },
+            {"value": "sync", "label": "Sync only — pull latest items from MediaCMS"},
+            {
+                "value": "classify",
+                "label": "Classify only — detect hosted shows, TV episodes, etc.",
+            },
+        ],
+        "help": "Choose which parts of the pipeline to run. 'Full pipeline' is the normal nightly run.",
     },
     {
         "name": "tokens",
-        "label": "Tokens",
+        "label": "Specific items (optional)",
         "type": "string",
-        "default": "all",
+        "default": None,
         "required": False,
-        "help": "Comma-separated friendly_tokens to process, or 'all'",
+        "placeholder": "Leave blank for entire catalog",
+        "help": (
+            "Paste one or more MediaCMS media IDs (the short alphanumeric codes in item URLs, "
+            "e.g. AbCd1234) separated by commas or spaces. Leave blank to process the entire catalog."
+        ),
     },
     {
         "name": "force",
@@ -144,28 +182,36 @@ CATALOG_ENRICH_SCHEMA = [
         "type": "bool",
         "default": False,
         "required": False,
+        "help": "Re-process items even if they were enriched before. Useful after fixing a bug or adding a new hosted-show pattern.",
     },
     {
         "name": "dry_run",
-        "label": "Dry run",
+        "label": "Dry run (preview only)",
         "type": "bool",
         "default": False,
         "required": False,
+        "help": "Walk through the pipeline and log what would change, but write nothing to the database or CMS.",
     },
     {
         "name": "limit",
-        "label": "Limit",
+        "label": "Item limit per step",
         "type": "int",
         "default": None,
         "required": False,
-        "help": "Max items per step (leave blank for all)",
+        "placeholder": "blank = no limit",
+        "help": "Stop after processing this many items per step. Handy for a quick test run before committing to the full catalog.",
     },
     {
         "name": "min_score",
-        "label": "Min description score",
+        "label": "Description quality threshold",
         "type": "int",
         "default": 50,
         "required": False,
+        "help": (
+            "Skip the metadata step for items whose description already scores at or above this value "
+            "(0–130 scale; a fully-enriched description scores ~100). Lower this or use Force re-run "
+            "to refresh already-enriched items."
+        ),
     },
 ]
 

{kryten_webqueue-0.35.0 → kryten_webqueue-0.35.1}/kryten_webqueue/static/css/main.css

@@ -1506,6 +1506,12 @@ a.np-chip {
     font: inherit;
     width: 100%;
 }
+.field-help {
+    font-size: 0.74rem;
+    color: var(--text-secondary);
+    opacity: 0.8;
+    line-height: 1.4;
+}
 .check {
     display: flex;
     align-items: center;

{kryten_webqueue-0.35.0 → kryten_webqueue-0.35.1}/kryten_webqueue/static/js/admin.js

@@ -49,11 +49,12 @@ function _jobFieldHtml(f, prefix = 'jobparam-') {
     const id = `${prefix}${f.name}`;
     const label = escapeHtml(f.label || f.name);
     const def = f.default;
+    const helpHtml = f.help ? `<span class="field-help">${escapeHtml(f.help)}</span>` : '';
     if (f.type === 'bool') {
         return `<label class="field field-inline">
             <input type="checkbox" id="${id}" ${def ? 'checked' : ''}>
             <span>${label}</span>
-        </label>`;
+        </label>${helpHtml ? `<div style="margin:-0.5rem 0 0.85rem 0">${helpHtml}</div>` : ''}`;
     }
     if (f.type === 'enum') {
         const opts = (f.options || []).map(o => {
@@ -63,17 +64,18 @@ function _jobFieldHtml(f, prefix = 'jobparam-') {
             return `<option value="${escapeHtml(String(val))}" ${sel}>${escapeHtml(String(txt))}</option>`;
         }).join('');
         return `<label class="field"><span>${label}</span>
-            <select id="${id}">${opts}</select></label>`;
+            <select id="${id}">${opts}</select>${helpHtml}</label>`;
     }
     if (f.type === 'playlist') {
         return `<label class="field"><span>${label}</span>
-            <select id="${id}" data-playlist-picker="1"><option value="">—</option></select></label>`;
+            <select id="${id}" data-playlist-picker="1"><option value="">—</option></select>${helpHtml}</label>`;
     }
     const inputType = (f.type === 'int' || f.type === 'float') ? 'number' : 'text';
     const step = f.type === 'float' ? ' step="any"' : '';
     const val = (def === null || def === undefined) ? '' : escapeHtml(String(def));
+    const placeholder = f.placeholder ? ` placeholder="${escapeHtml(f.placeholder)}"` : '';
     return `<label class="field"><span>${label}${f.required ? ' *' : ''}</span>
-        <input type="${inputType}"${step} id="${id}" value="${val}"></label>`;
+        <input type="${inputType}"${step}${placeholder} id="${id}" value="${val}">${helpHtml}</label>`;
 }
 
 async function openJobRunnerModal(job) {

{kryten_webqueue-0.35.0 → kryten_webqueue-0.35.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kryten-webqueue"
-version = "0.35.0"
+version = "0.35.1"
 description = "Netflix/Tubi-style catalog browser and pay-to-play queue management for CyTube"
 readme = "README.md"
 license = "MIT"