feat: comic pipeline v0.10.0 — iterative chaining, title slugs, comics subfolder, 16:9v0.10.0

- Iterative image chaining: each page receives cover + prev page as pixel-level
  reference (multimodal) so the model copies appearance directly, not from text alone
- --story-theme flag overrides random genre pick per run
- Gemini now generates a short comic title (---COMIC TITLE--- separator) used as
  the output slug; all files named <slug>_cover.png, <slug>_page_1.png, etc.
- All comic output stored under comics/<slug>/ subdirectory
- Aspect ratio changed to 16:9 (ThinkPad X1 Gen 9 screen fit; 16:10 not supported)
- Bulgarian language rule moved to top of every prompt for stronger compliance
- Dynamic story-specific cover masthead + publisher logo badge matching story genre
- --story-theme "a thrilling space..." forces genre without touching random pool

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

13 files changed, 107 insertions, 0 deletions

diff --git a/comics/void-cats-apple/void-cats-apple.pdf b/comics/void-cats-apple/void-cats-apple.pdf
new file mode 100644
index 0000000..132c562
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple.pdf
diff --git a/comics/void-cats-apple/void-cats-apple_back.png b/comics/void-cats-apple/void-cats-apple_back.png
new file mode 100644
index 0000000..7c3a439
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_back.png
diff --git a/comics/void-cats-apple/void-cats-apple_back_attribution.txt b/comics/void-cats-apple/void-cats-apple_back_attribution.txt
new file mode 100644
index 0000000..622ddd2
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_back_attribution.txt
@@ -0,0 +1,16 @@
+Image generated by Google Gemini Nano Banana
+
+Model: gemini-3.1-flash-image-preview
+Text model: gemini-2.5-flash
+Aspect ratio: 4:3
+Size: 896x1200
+Result: Generated educational image for vocabulary story
+
+Prompt used:
+ЗАДЪЛЖИТЕЛНО / MANDATORY LANGUAGE RULE: This is a BULGARIAN comic book. All visible text (blurb box, labels, banners) MUST be in Bulgarian Cyrillic script. English text anywhere on the back cover is STRICTLY FORBIDDEN.
+
+Art style: ultra realistic comic strip with photographic detail and dramatic lighting.
+CHARACTER & SETTING REFERENCE (back cover — follow exactly, do NOT change clothing):
+Kapitan Alex, middle-aged (early 40s), short dark brown slightly messy hair, deep blue eyes, light olive skin, athletic lean build. Wears a form-fitting dark grey spacesuit with subtle silver trim on the shoulders and collar, a black utility belt with a silver buckle, and sturdy black combat boots. No visible branding on the suit. Kosmos, a Sphynx cat, has hairless light pinkish-grey velvety skin, striking emerald green eyes, and is of medium domestic cat size. Small faint scattered darker grey spots mark her back and legs. She is typically alert, often perched or curled up, but can a...
+
+Generated at: 2026-04-03 22:51:14
diff --git a/comics/void-cats-apple/void-cats-apple_cover.png b/comics/void-cats-apple/void-cats-apple_cover.png
new file mode 100644
index 0000000..0ddd15a
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_cover.png
diff --git a/comics/void-cats-apple/void-cats-apple_cover_attribution.txt b/comics/void-cats-apple/void-cats-apple_cover_attribution.txt
new file mode 100644
index 0000000..4d35543
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_cover_attribution.txt
@@ -0,0 +1,16 @@
+Image generated by Google Gemini Nano Banana
+
+Model: gemini-3.1-flash-image-preview
+Text model: gemini-2.5-flash
+Aspect ratio: 4:3
+Size: 896x1200
+Result: Generated educational image for vocabulary story
+
+Prompt used:
+ЗАДЪЛЖИТЕЛНО / MANDATORY LANGUAGE RULE: This is a BULGARIAN comic book. All text on the cover (cover lines, banners, labels) MUST be in Bulgarian Cyrillic script. The masthead title must also be rendered in a striking comic-book font.
+
+Art style: ultra realistic comic strip with photographic detail and dramatic lighting.
+CHARACTER & SETTING REFERENCE (cover — follow exactly, do NOT change clothing):
+Kapitan Alex, middle-aged (early 40s), short dark brown slightly messy hair, deep blue eyes, light olive skin, athletic lean build. Wears a form-fitting dark grey spacesuit with subtle silver trim on the shoulders and collar, a black utility belt with a silver buckle, and sturdy black combat boots. No visible branding on the suit. Kosmos, a Sphynx cat, has hairless light pinkish-grey velvety skin, striking emerald green eyes, and is of medium domestic cat size. Small faint scattered darker grey spots mark her back and legs. She is typically alert, often perched or curled up...
+
+Generated at: 2026-04-03 22:50:10
diff --git a/comics/void-cats-apple/void-cats-apple_narration.mp3 b/comics/void-cats-apple/void-cats-apple_narration.mp3
new file mode 100644
index 0000000..b1ccc60
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_narration.mp3
diff --git a/comics/void-cats-apple/void-cats-apple_page_1.png b/comics/void-cats-apple/void-cats-apple_page_1.png
new file mode 100644
index 0000000..421539a
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_page_1.png
diff --git a/comics/void-cats-apple/void-cats-apple_page_1_attribution.txt b/comics/void-cats-apple/void-cats-apple_page_1_attribution.txt
new file mode 100644
index 0000000..5e86ca3
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_page_1_attribution.txt
@@ -0,0 +1,16 @@
+Image generated by Google Gemini Nano Banana
+
+Model: gemini-3.1-flash-image-preview
+Text model: gemini-2.5-flash
+Aspect ratio: 4:3
+Size: 896x1200
+Result: Generated educational image for vocabulary story
+
+Prompt used:
+ЗАДЪЛЖИТЕЛНО / MANDATORY LANGUAGE RULE: This is a BULGARIAN comic book. Every word of text inside speech bubbles, thought bubbles, caption boxes, and panel labels MUST be written in Bulgarian Cyrillic script (например: Здравей! Какво правиш? Побързай!). English text anywhere in the panels is STRICTLY FORBIDDEN — use ONLY Bulgarian.
+
+Art style: ultra realistic comic strip with photographic detail and dramatic lighting.
+CHARACTER & SETTING REFERENCE (story page 1 of 3 — follow exactly, do NOT change clothing):
+Kapitan Alex, middle-aged (early 40s), short dark brown slightly messy hair, deep blue eyes, light olive skin, athletic lean build. Wears a form-fitting dark grey spacesuit with subtle silver trim on the shoulders and collar, a black utility belt with a silver buckle, and sturdy black combat boots. No visible branding on the suit. Kosmos, a Sphynx cat, has hairless light pinkish-grey velvety skin, striking emerald green eyes, and...
+
+Generated at: 2026-04-03 22:50:27
diff --git a/comics/void-cats-apple/void-cats-apple_page_2.png b/comics/void-cats-apple/void-cats-apple_page_2.png
new file mode 100644
index 0000000..873035f
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_page_2.png
diff --git a/comics/void-cats-apple/void-cats-apple_page_2_attribution.txt b/comics/void-cats-apple/void-cats-apple_page_2_attribution.txt
new file mode 100644
index 0000000..6a2dced
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_page_2_attribution.txt
@@ -0,0 +1,16 @@
+Image generated by Google Gemini Nano Banana
+
+Model: gemini-3.1-flash-image-preview
+Text model: gemini-2.5-flash
+Aspect ratio: 4:3
+Size: 896x1200
+Result: Generated educational image for vocabulary story
+
+Prompt used:
+ЗАДЪЛЖИТЕЛНО / MANDATORY LANGUAGE RULE: This is a BULGARIAN comic book. Every word of text inside speech bubbles, thought bubbles, caption boxes, and panel labels MUST be written in Bulgarian Cyrillic script (например: Здравей! Какво правиш? Побързай!). English text anywhere in the panels is STRICTLY FORBIDDEN — use ONLY Bulgarian.
+
+Art style: ultra realistic comic strip with photographic detail and dramatic lighting.
+CHARACTER & SETTING REFERENCE (story page 2 of 3 — follow exactly, do NOT change clothing):
+Kapitan Alex, middle-aged (early 40s), short dark brown slightly messy hair, deep blue eyes, light olive skin, athletic lean build. Wears a form-fitting dark grey spacesuit with subtle silver trim on the shoulders and collar, a black utility belt with a silver buckle, and sturdy black combat boots. No visible branding on the suit. Kosmos, a Sphynx cat, has hairless light pinkish-grey velvety skin, striking emerald green eyes, and...
+
+Generated at: 2026-04-03 22:50:45
diff --git a/comics/void-cats-apple/void-cats-apple_page_3.png b/comics/void-cats-apple/void-cats-apple_page_3.png
new file mode 100644
index 0000000..01587f6
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_page_3.png
diff --git a/comics/void-cats-apple/void-cats-apple_page_3_attribution.txt b/comics/void-cats-apple/void-cats-apple_page_3_attribution.txt
new file mode 100644
index 0000000..7646019
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_page_3_attribution.txt
@@ -0,0 +1,16 @@
+Image generated by Google Gemini Nano Banana
+
+Model: gemini-3.1-flash-image-preview
+Text model: gemini-2.5-flash
+Aspect ratio: 4:3
+Size: 896x1200
+Result: Generated educational image for vocabulary story
+
+Prompt used:
+ЗАДЪЛЖИТЕЛНО / MANDATORY LANGUAGE RULE: This is a BULGARIAN comic book. Every word of text inside speech bubbles, thought bubbles, caption boxes, and panel labels MUST be written in Bulgarian Cyrillic script (например: Здравей! Какво правиш? Побързай!). English text anywhere in the panels is STRICTLY FORBIDDEN — use ONLY Bulgarian.
+
+Art style: ultra realistic comic strip with photographic detail and dramatic lighting.
+CHARACTER & SETTING REFERENCE (story page 3 of 3 — follow exactly, do NOT change clothing):
+Kapitan Alex, middle-aged (early 40s), short dark brown slightly messy hair, deep blue eyes, light olive skin, athletic lean build. Wears a form-fitting dark grey spacesuit with subtle silver trim on the shoulders and collar, a black utility belt with a silver buckle, and sturdy black combat boots. No visible branding on the suit. Kosmos, a Sphynx cat, has hairless light pinkish-grey velvety skin, striking emerald green eyes, and...
+
+Generated at: 2026-04-03 22:50:58
diff --git a/comics/void-cats-apple/void-cats-apple_story.txt b/comics/void-cats-apple/void-cats-apple_story.txt
new file mode 100644
index 0000000..5861ade
--- /dev/null
+++ b/comics/void-cats-apple/void-cats-apple_story.txt
@@ -0,0 +1,27 @@
+На мостика на космическия кораб „Звезден Скитник“ цареше напрегнато мълчание. Капитан Алекс, с поглед вперен в основния екран, едва чуваше равномерното бръмчене на двигателите. До краката му, на една от празните контролни конзоли, седеше Космос – неговата 1. **котка**. Сфинксът, с кожа като кадифе и големи зелени очи, беше необичаен спътник за капитан на звездолет, но Алекс вярваше в нейните инстинкти. Откакто бяха напуснали последния аванпост, Космос беше неспокойна, мяукаше тихо и въртеше нервно глава.
+
+„Капитане, наближаваме аномалията“, докладва първият офицер Лира, гласът ѝ прекъсвайки тишината. „Сензорите отчитат огромна структура, неорганична, на около 2000 км от нас. Не е обозначена на нито една карта.“
+
+Алекс кимна. „Пригответе се за скачване. Само аз и Космос ще се спуснем.“
+
+Лира повдигна вежди. „Космос, сър? Експедицията е рискована.“
+
+„Тя винаги ме е пазила“, отвърна Алекс, не откъсвайки поглед от приближаващата се структура – колосален, черен обект, наподобяващ древен, забравен храм, реещ се в бездната.
+
+След като се скачиха успешно с шлюз, Алекс и Космос преминаха през въздушния шлюз. Вътрешността беше мрачна и потискаща, осветена от редки, пулсиращи зелени светлини. Космос се притисна плътно до крака на Алекс, очите ѝ бяха разширени. Атмосферата беше дишаща, но въздухът беше тежък, със странен метален привкус.
+
+„Сканирам за живот“, прошепна Алекс в комуникатора си. „Нищо. Пълна тишина.“
+
+Внезапно Космос издаде ниско ръмжене – звук, който Алекс рядко беше чувал от нея. Тя се изправи на задни лапи и зашипя към една от огромните, напълно черни стени. Точно тогава, зелените светлини започнаха да пулсират по-бързо, а сензорите на Алекс изпискаха тревожно. Стената пред тях започна да се разтваря, разкривайки коридор, водещ към още по-дълбоки мрежи от тунели.
+
+От мрака изникнаха сенки – високи, призрачни фигури с множество крайници. Не приличаха на нищо, което Алекс някога беше виждал. Те издаваха пронизителен, свистящ звук, който караше ушите му да бучат.
+
+„Алекс, какво става там?“, чу се паникьосаният глас на Лира по комуникатора.
+
+„Изглежда, че не сме сами…“ Алекс бързо извади бластерното си оръжие, но знаеше, че е превъзхождан. Космос скочи от него и се втурна към една от фигурите, издавайки яростно съскане. За изненада на Алекс, съществото отстъпи леко, сякаш изненадано от малкото животно.
+
+В този миг на отвличане на вниманието, Алекс забеляза малка ниша в стената, която се затваряше. Трябваше му секунда. Той се сети за 2. **ябълка**, която беше оставил в джоба си, предназначен за бърз обяд. Издърпа я, хвърли я с всичка сила в противоположната посока на нишата, към друг тунел. Звукът от удара привлече вниманието на две от съществата.
+
+„Космос, при мен!“ извика Алекс, грабвайки котката, докато тичаше към нишата. Тя се затвори почти веднага след като се плъзнаха вътре. От другата страна се чуваха удари и пронизителни писъци, но стената издържаше.
+
+„Това беше… близо“, промълви Алекс, прегръщайки треперещата котка. „Добро момиче. Понякога и една ябълка може да спаси деня.“ Те бяха в капан, но поне живи, за момента. И Космос, както винаги, беше била права.