⚙️ 🤖 zpub import episode: Episodenordner/Zip aus zentonic-mix übernehmen #170

Closed
opened 2026-11-16 14:29:42 +01:00 by holm · 3 comments
Owner
Dimension Bewertung Einschätzung
Aufwand ████░░░░░░ Mittel — Zip/Ordner prüfen, kopieren, validieren; Bibliothek scripts/lib/episode.sh vorhanden
Nutzen ████████░░ Hoch — Folge aus zentonic-mix ohne Handarbeit in den Tenant
Bruchhäufigkeit ███░░░░░░░ Niedrig — Format ist mit #168 (Eingang aus zentonic-mix) festgelegt
Dringlichkeit ████░░░░░░ Mittel — zentonic-mix liefert schon Episodenordner

Auftrag

Folgt aus #168 (Eingang aus zentonic-mix), Bitte 3: Import-Befehl für einen Episodenordner bzw. dessen Zip. Holm 2026-11-15 (zentonic-audio#135): „in publisher nur noch das fertige master-out ankommt und publisher nur noch die podcast spezifika wie chapter und cover reinrendert“.

Befund (gemessen 2026-11-16 im Mini-Tenant)

  • Heute gibt es nur zpub import feed. Ein Mix-Ordner wird von Hand nach episodes/<slug>/ kopiert.
  • zpub api validate meldet unbekannte Sprecher-IDs als Fehler, der Build nicht: build.sh baut mit Exit 0 und 0 ⚠, die unbekannte ID erscheint als Name im Player (data-ep-speakers) und im Feed.

Vorschlag

zpub import episode [--dry-run] <zip|ordner> <tenant>
  • Zip nach Temp entpacken (Pfade nur unterhalb <slug>/, keine Links, kein ..), genau ein Ordner mit episode.md.
  • Nie überschreiben: existiert episodes/<slug>/, Abbruch (Exit 3 wie die Offline-API).
  • Frontmatter über episode_validate prüfen (Pflichtfelder, Sprecher müssen existieren), erst danach kopieren.
  • Erlaubte Dateien: episode.md, audio/<basename>.wav|.mp3, transcript.vtt, episode.png, gimmicks/**.
  • Zusätzlich: Build warnt (⚠) bei Sprecher-ID ohne speaker/<id>/speaker.toml.
  • Werkzeuge: bash, jq, yq, unzip/bsdtar. Kein Python.

Abnahme

  • Import eines Mix-Zips in einen Wegwerf-Tenant, danach zpub build --local + zpub check --no-browser ohne ✗
  • Abbruch bei vorhandenem Slug, unbekanntem Sprecher, Pfad mit ..
  • Build-⚠ bei unbekanntem Sprecher
  • docs/import.md und docs/episode-format.md ergänzt

🤖 angelegt von Claude claude2604 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `████░░░░░░` | Mittel — Zip/Ordner prüfen, kopieren, validieren; Bibliothek `scripts/lib/episode.sh` vorhanden | | Nutzen | `████████░░` | Hoch — Folge aus zentonic-mix ohne Handarbeit in den Tenant | | Bruchhäufigkeit | `███░░░░░░░` | Niedrig — Format ist mit [#168](https://forgejo.mueller.network/Zentonic/zentonic-publisher/issues/168) (Eingang aus zentonic-mix) festgelegt | | Dringlichkeit | `████░░░░░░` | Mittel — zentonic-mix liefert schon Episodenordner | ## Auftrag Folgt aus [#168](https://forgejo.mueller.network/Zentonic/zentonic-publisher/issues/168) (Eingang aus zentonic-mix), Bitte 3: Import-Befehl für einen Episodenordner bzw. dessen Zip. Holm 2026-11-15 (zentonic-audio#135): „in publisher nur noch das fertige master-out ankommt und publisher nur noch die podcast spezifika wie chapter und cover reinrendert“. ## Befund (gemessen 2026-11-16 im Mini-Tenant) - Heute gibt es nur `zpub import feed`. Ein Mix-Ordner wird von Hand nach `episodes/<slug>/` kopiert. - `zpub api validate` meldet unbekannte Sprecher-IDs als Fehler, **der Build nicht**: `build.sh` baut mit Exit 0 und 0 ⚠, die unbekannte ID erscheint als Name im Player (`data-ep-speakers`) und im Feed. ## Vorschlag ``` zpub import episode [--dry-run] <zip|ordner> <tenant> ``` - Zip nach Temp entpacken (Pfade nur unterhalb `<slug>/`, keine Links, kein `..`), genau ein Ordner mit `episode.md`. - Nie überschreiben: existiert `episodes/<slug>/`, Abbruch (Exit 3 wie die Offline-API). - Frontmatter über `episode_validate` prüfen (Pflichtfelder, Sprecher müssen existieren), erst danach kopieren. - Erlaubte Dateien: `episode.md`, `audio/<basename>.wav|.mp3`, `transcript.vtt`, `episode.png`, `gimmicks/**`. - Zusätzlich: Build warnt (⚠) bei Sprecher-ID ohne `speaker/<id>/speaker.toml`. - Werkzeuge: bash, jq, yq, unzip/bsdtar. Kein Python. ## Abnahme - [ ] Import eines Mix-Zips in einen Wegwerf-Tenant, danach `zpub build --local` + `zpub check --no-browser` ohne ✗ - [ ] Abbruch bei vorhandenem Slug, unbekanntem Sprecher, Pfad mit `..` - [ ] Build-⚠ bei unbekanntem Sprecher - [ ] docs/import.md und docs/episode-format.md ergänzt > 🤖 angelegt von Claude claude2604 (API/Token holm)
Author
Owner

Stand: auf dev, Release steht aus

  • Commit 88a1f0a (feat(import): zpub import episode …), gemergt in dev (c13f6d8), gepusht. Pemmikan STAND rc.41: 23167aa.
  • Neu: scripts/import-episode.sh, zpub import episode [--dry-run] <zip|ordner> <tenant>, Build-⚠ Sprecher ohne speaker/<id>/speaker.toml, Doku in docs/import.md und docs/episode-format.md, unzip/zip in shell.nix und README.

Gemessen (bash scripts/check/import-episode-test.sh, alle ✓, ≈ 15 s):

  • --dry-run schreibt nichts; Ordner und Zip übernommen, Dateien identisch, keine _import.*-Reste, Ordnerrechte 755.
  • Slug vorhanden → Exit 3; unbekannter Sprecher + fremde Datei + falscher Audioname + slug ≠ Ordner → Exit 1 mit allen vier Meldungen; Zip mit ../ bzw. zwei Ordnern → Exit 1. Tenant jeweils unverändert (Prüfsumme über Baum).
  • Build: importierte Folgen ohne ⚠, MP3 aus WAV erzeugt; Folge mit unbekanntem Sprecher → ⚠.
  • zpub check --no-browser am Test-Tenant: 15 ✓ 0 ✗ 0 ⚠. Sample-Build: 0 ⚠ (keine neue Warnung im Bestand). import-test.sh (Feed-Import) ✓. docs-drift.sh: 0.

Offen: Das installierte zpub (toolctl, Zweig main) kennt import episode erst nach dem nächsten Release (rc.41). Issue bleibt bis dahin offen.

🤖 angelegt von Claude claude2604 (API/Token holm)

## Stand: auf dev, Release steht aus - Commit 88a1f0a (`feat(import): zpub import episode …`), gemergt in dev (c13f6d8), gepusht. Pemmikan STAND rc.41: 23167aa. - Neu: `scripts/import-episode.sh`, `zpub import episode [--dry-run] <zip|ordner> <tenant>`, Build-⚠ `Sprecher ohne speaker/<id>/speaker.toml`, Doku in `docs/import.md` und `docs/episode-format.md`, `unzip`/`zip` in shell.nix und README. **Gemessen** (`bash scripts/check/import-episode-test.sh`, alle ✓, ≈ 15 s): - --dry-run schreibt nichts; Ordner und Zip übernommen, Dateien identisch, keine `_import.*`-Reste, Ordnerrechte 755. - Slug vorhanden → Exit 3; unbekannter Sprecher + fremde Datei + falscher Audioname + slug ≠ Ordner → Exit 1 mit allen vier Meldungen; Zip mit `../` bzw. zwei Ordnern → Exit 1. Tenant jeweils unverändert (Prüfsumme über Baum). - Build: importierte Folgen ohne ⚠, MP3 aus WAV erzeugt; Folge mit unbekanntem Sprecher → ⚠. - `zpub check --no-browser` am Test-Tenant: 15 ✓ 0 ✗ 0 ⚠. Sample-Build: 0 ⚠ (keine neue Warnung im Bestand). `import-test.sh` (Feed-Import) ✓. `docs-drift.sh`: 0. **Offen:** Das installierte `zpub` (toolctl, Zweig main) kennt `import episode` erst nach dem nächsten Release (rc.41). Issue bleibt bis dahin offen. > 🤖 angelegt von Claude claude2604 (API/Token holm)
Author
Owner

Release: versehentlich v1.0.0 statt rc.41

  • /home/holm/bin/release --yes ohne --rc aufgerufen → final v1.0.0 getaggt (Commit 563194c auf dev), Tag gepusht, Forgejo-Release veröffentlicht. Der final fasst alle rc-Abschnitte im CHANGELOG zusammen (155+/446−) und schließt die rc-Linie.
  • Fehler: --rc fehlte; die rc-Releases liefen bisher mit dieser Option.
  • main ist nicht gemergt; toolctl (main) hat also noch rc.40, nichts verteilt.
  • Entscheidung bei Holm: v1.0.0 behalten (dann main-Merge + toolctl-Prüfung) oder zurücknehmen (Tag + Forgejo-Release löschen nur durch Holm, danach Revert auf dev und release --rc).

🤖 angelegt von Claude claude2604 (API/Token holm)

## Release: versehentlich v1.0.0 statt rc.41 - `/home/holm/bin/release --yes` ohne `--rc` aufgerufen → **final v1.0.0** getaggt (Commit 563194c auf dev), Tag gepusht, Forgejo-Release veröffentlicht. Der final fasst alle rc-Abschnitte im CHANGELOG zusammen (155+/446−) und schließt die rc-Linie. - Fehler: `--rc` fehlte; die rc-Releases liefen bisher mit dieser Option. - `main` ist **nicht** gemergt; toolctl (main) hat also noch rc.40, nichts verteilt. - Entscheidung bei Holm: v1.0.0 behalten (dann main-Merge + toolctl-Prüfung) oder zurücknehmen (Tag + Forgejo-Release löschen nur durch Holm, danach Revert auf dev und `release --rc`). > 🤖 angelegt von Claude claude2604 (API/Token holm)
Author
Owner

Erledigt (Beleg): ausgeliefert mit v1.0.0-rc.41

  • v1.0.0 von Holm gelöscht, Revert d8fe703. release korrigiert durch v00-release (release#12: -rc.N-Linie, Final-Gate).
  • release --local --rc → v1.0.0-rc.41, CHANGELOG genau ein neuer Abschnitt (+17), VERSION 1.0.0-rc.41; vor dem Publish bash zpub --version und zpub import episode --dry-run aus der Worktree geprüft. release --publish: Tag + Forgejo-Prerelease, dev c2bf0ee.
  • main: Merge 6d31af9 (--no-ff), gepusht.
  • HOME=/home/holm toolctl sync zentonic-publisher → main auf 6d31af9, Exit 0. Installiertes /home/holm/bin/zpub --version → zpub 1.0.0-rc.41, zpub import zeigt import episode.

🤖 angelegt von Claude claude2604 (API/Token holm)

## Erledigt (Beleg): ausgeliefert mit v1.0.0-rc.41 - v1.0.0 von Holm gelöscht, Revert d8fe703. `release` korrigiert durch v00-release (release#12: `-rc.N`-Linie, Final-Gate). - `release --local --rc` → `v1.0.0-rc.41`, CHANGELOG genau ein neuer Abschnitt (+17), VERSION 1.0.0-rc.41; vor dem Publish `bash zpub --version` und `zpub import episode --dry-run` aus der Worktree geprüft. `release --publish`: Tag + Forgejo-Prerelease, dev c2bf0ee. - main: Merge 6d31af9 (`--no-ff`), gepusht. - `HOME=/home/holm toolctl sync zentonic-publisher` → main auf 6d31af9, Exit 0. Installiertes `/home/holm/bin/zpub --version` → `zpub 1.0.0-rc.41`, `zpub import` zeigt `import episode`. > 🤖 angelegt von Claude claude2604 (API/Token holm)
holm closed this issue 2026-11-16 15:27:05 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Zentonic/zentonic-publisher#170
No description provided.