⚙️ 🤖 Offline-API: gemeinsame Episoden-Bibliothek für CLI, Import und Web-Editor (zpub episode new) #126
Labels
No labels
Compat/Breaking
Kind/Bug
Kind/Documentation
Kind/Enhancement
Kind/Feature
Kind/Security
Kind/Testing
Priority/Critical
Priority/High
Priority/Low
Priority/Medium
Reviewed/Confirmed
Reviewed/Duplicate
Reviewed/Invalid
Reviewed/Won't Fix
Status/Abandoned
Status/Blocked
Status/Need More Info
Status/Needs-v00-Abnahme
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
Zentonic/zentonic-publisher#126
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
██████░░░░████████░░zpub episode newfällt fast gratis ab█████░░░░░█████████░████░░░░░░Ziel (Holm 2026-11-04, Entscheid 46)
„Offline-API“: eine Bibliothek, die CLI (
zpub episode new), Feed-Importer und Web-Editor gemeinsam nutzen — kein redundanter Code.Befund: heute zwei getrennte Schreibpfade für
episode.mdPOST /api/episodewebwizard/app.shcreate_episode_norm_time), eigener TOML-Writer perprintf; keinseason— für Mehrstaffel-Tenants wie advent unbrauchbarscripts/import-feed.sh(jq-Writer)season,guid,transcript_*, Herkunfts-Kommentar; Datum nach UTCzpub episode new)Vorschlag
scripts/lib/episode.sh(Bash + jq + yq, kein Python): JSON rein, JSON raus, Exit-Codes statt HTTPepisode_next <projekt> [--season S]→ nächste freie Nummer/Slugepisode_validate→ normalisiertes JSON oder Fehlerliste (Slug, Datum mit Zeitzone, Dauer, Typ, Sprecher existieren)episode_write <projekt>→episodes/<slug>/episode.md+ Ordneraudio/,gimmicks/; nie überschreibenspeaker_list,episode_list(heute im Web-Editor)zpub api <verb>(stdin JSON → stdout JSON) — die eigentliche „Offline-API“, auch für Scriptszpub episode new [--season 2026] [--title …]baut das JSON aus Flags/Defaultsepisode_write, Shownotes/Gimmicks bleiben im ImporterSchwächster Punkt
Der Importer schreibt mehr Felder als der Editor (guid, transcript, Kommentare). Das Schema muss die Obermenge tragen — das ist die eigentliche Arbeit, nicht die Funktionen. Zweitens: pro Folge mehrere jq/yq-Prozesse; beim Import von 100 Folgen spürbar, aber im Sekundenbereich.
Abnahme
zpub episode new --season 2026im advent-Tenant erzeugt2026-01mit gültigem Frontmatter, Build ✅seasonan; bestehende Editor-Tests grünepisode.mdwie vor dem UmbauIn Arbeit (Holm 2026-11-04: „126 go worker“)
feat/126-…; Merge nach dev durch v00 nach AbnahmeErledigt — gemergt nach dev (
412c090)zpub episode new --season 2026im advent-Tenantepisodes/2026-01/episode.md(season 2026, Sprecher der neuesten Folge), Build rc=0, Folge in Feed + Index; zweiter Lauf rc=3 (existiert)seasonanepisode.md+ podcast.toml byte-gleich; synthetischer Grenzfall-Feed 4/4zpub episode new --dry-run sample_project→ gültiges Frontmatter 007;zpub api validate→ JSON-Fehlerliste; Build +zpub check14 ✓ 0 ✗ 0 ⚠;schema-doc.sh: 22 Felder dokumentiertNeu:
scripts/lib/episode.sh+scripts/lib/episode-schema.jq(einzige Feldquelle, inkl.eventfür #128),zpub episode new [--season] [--title] [--speaker] [--episode] [--slug] [--dry-run],zpub api <schema|speakers|episodes|next|validate|write>(stdin JSON → stdout JSON; Exit 0 ok · 1 ungültig/400 · 2 Fehler/500 · 3 existiert/409 · 4 kein Tenant/404). Web-Editor-Handler und Importer nutzen die Bibliothek.Abweichungen: Tags beliebiger Text ohne Steuerzeichen (Obermenge Importer); Zeit ohne Zeitzone abgewiesen;
duration = ""immer geschrieben; Importer bricht bei ungültigem Typ/Titel an der Folge ab statt still zu schreiben.Grenzen: Importer prüft je Folge beim Schreiben, nicht vorab → ein ungültiges Item mitten im Feed hinterlässt einen Teilimport. Laufzeit Import +7 s auf 56 Folgen. Nebenbefund
escape-test.sh(10 FAIL auf Basis und Branch identisch) → #132 (escape-test.sh veraltet).