⚙️ 🤖 zpub: CLI-Einstieg, init mit Layout/HTML (sofort baubar), toolctl-Verteilung #102

Closed
opened 2026-11-02 23:24:47 +01:00 by holm · 2 comments
Owner
Dimension Bewertung Einschätzung
Aufwand ██████░░░░ Mittel: CLI-Einstieg, init mit Template, Template-Suche Tenant→Publisher, toolctl-Hook
Nutzen █████████░ Sehr hoch: Voraussetzung für jeden Tenant (#101)
Bruchhäufigkeit ██░░░░░░░░ –
Nachhaltigkeit ████████░░ Hoch
Dringlichkeit ██████░░░░ Mittel-hoch: vor dem ersten Import

Entscheid Holm (2026-11-02, Fragen 11/16/17/18)

  • 18a: Der Publisher wird über toolctl verteilt; kein eigenes Skeleton-Repo.
  • Ein Einstieg zpub mit Unterbefehlen init, build, check, deploy, import (#101). Eigener Pfad per readlink -f -- "${BASH_SOURCE[0]}".
  • zpub init <ordner> muss sofort baubar sein (Holm): neben podcast.toml, episodes/, speaker/, .gitignore, Beispiel-deploy.local.toml wird auch Layout/HTML kopiert (Template zentonic26 → <tenant>/templates/<name>/). Der Tenant passt es danach an. Folge für build.sh: Template-Suche zuerst im Tenant, dann im Publisher.
  • Versionsbindung (11a): Tenant trägt die Publisher-Version (publisher = "v1.0.0-rc.12"); zpub build warnt bei Abweichung. toolctl zieht main (= Releases) ff-only.
  • Tenant-Repos (16b): neue Forgejo-Org Podcasts, ein Repo pro Podcast (Podcasts/<name>).
  • Audio im Git (17): Audio, Shownotes, Cover werden im Tenant versioniert — „die Files entstehen um zu bleiben; eine Änderung ist eine Revision“. public/ (Build-Ausgabe) bleibt im Tenant ungetrackt. Die init-.gitignore sperrt also public/, nicht *.mp3.
  • Fonts: Tenant-Repos sind privat; Berkeley Mono darf dort liegen, Auslieferung nur auf lizenzierten Domains (SKILL:fonts). Vorerst localhost (Frage 12).

toolctl (Auftrag Holm 18a)

  • .toolctl-install im Publisher legt nur ~/bin/zpub an (idempotent, fremde Symlinks melden, kein rm).
  • Eintrag in distribution/registry.list des toolctl-Repos (Zweig main), sobald zpub auf main released ist.

🤖 angelegt von Claude v00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `██████░░░░` | Mittel: CLI-Einstieg, init mit Template, Template-Suche Tenant→Publisher, toolctl-Hook | | Nutzen | `█████████░` | Sehr hoch: Voraussetzung für jeden Tenant (#101) | | Bruchhäufigkeit | `██░░░░░░░░` | – | | Nachhaltigkeit | `████████░░` | Hoch | | Dringlichkeit | `██████░░░░` | Mittel-hoch: vor dem ersten Import | ## Entscheid Holm (2026-11-02, Fragen 11/16/17/18) - **18a:** Der Publisher wird über toolctl verteilt; kein eigenes Skeleton-Repo. - **Ein Einstieg** `zpub` mit Unterbefehlen `init`, `build`, `check`, `deploy`, `import` (#101). Eigener Pfad per `readlink -f -- "${BASH_SOURCE[0]}"`. - **`zpub init <ordner>` muss sofort baubar sein (Holm):** neben `podcast.toml`, `episodes/`, `speaker/`, `.gitignore`, Beispiel-`deploy.local.toml` wird **auch Layout/HTML kopiert** (Template `zentonic26` → `<tenant>/templates/<name>/`). Der Tenant passt es danach an. Folge für `build.sh`: Template-Suche zuerst im Tenant, dann im Publisher. - **Versionsbindung (11a):** Tenant trägt die Publisher-Version (`publisher = "v1.0.0-rc.12"`); `zpub build` warnt bei Abweichung. toolctl zieht `main` (= Releases) ff-only. - **Tenant-Repos (16b):** neue Forgejo-Org `Podcasts`, ein Repo pro Podcast (`Podcasts/<name>`). - **Audio im Git (17):** Audio, Shownotes, Cover werden im Tenant **versioniert** — „die Files entstehen um zu bleiben; eine Änderung ist eine Revision“. `public/` (Build-Ausgabe) bleibt im Tenant ungetrackt. Die init-`.gitignore` sperrt also `public/`, **nicht** `*.mp3`. - Fonts: Tenant-Repos sind privat; Berkeley Mono darf dort liegen, Auslieferung nur auf lizenzierten Domains (SKILL:fonts). Vorerst localhost (Frage 12). ## toolctl (Auftrag Holm 18a) - `.toolctl-install` im Publisher legt nur `~/bin/zpub` an (idempotent, fremde Symlinks melden, kein `rm`). - Eintrag in `distribution/registry.list` des toolctl-Repos (Zweig `main`), sobald `zpub` auf `main` released ist. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Gemergt (81766f8; Worker 6e549af, 58defa7, 898f8fe, 7c1ceaa; v00 5fa65ef = Holm 19b: check meldet bei Tenant ohne Audio ⚠ statt ✗). Beleg v00: zpub init → build --local → check --no-browser: 6 ✓ 0 ✗ 1 ⚠. Sample-Build in nix-shell ohne Diff. Bleibt offen bis zum Release + Eintrag in distribution/registry.list (toolctl, Holm-Auftrag 18a).

🤖 angelegt von Claude v00 (API/Token holm)

Gemergt (81766f8; Worker 6e549af, 58defa7, 898f8fe, 7c1ceaa; v00 5fa65ef = Holm 19b: `check` meldet bei Tenant ohne Audio ⚠ statt ✗). Beleg v00: `zpub init` → `build --local` → `check --no-browser`: 6 ✓ 0 ✗ 1 ⚠. Sample-Build in nix-shell ohne Diff. **Bleibt offen** bis zum Release + Eintrag in `distribution/registry.list` (toolctl, Holm-Auftrag 18a). > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Abgeschlossen: Release v1.0.0-rc.14 (main a9007d5) enthält zpub + .toolctl-install; zpub version → 1.0.0-rc.14 (release bumpt die VERSION-Zeile jetzt mit). toolctl-Registry: holm.tools.secret/toolctl#10 (main ac65841). Template-Kopie bei init wird durch #105 abgelöst.

🤖 angelegt von Claude v00 (API/Token holm)

Abgeschlossen: Release v1.0.0-rc.14 (main a9007d5) enthält zpub + `.toolctl-install`; `zpub version` → 1.0.0-rc.14 (release bumpt die VERSION-Zeile jetzt mit). toolctl-Registry: holm.tools.secret/toolctl#10 (main ac65841). Template-Kopie bei init wird durch #105 abgelöst. > 🤖 angelegt von Claude v00 (API/Token holm)
holm closed this issue 2026-11-02 23:55:36 +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#102
No description provided.