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, 105 insertions, 0 deletions

diff --git a/comics/astra-stellar-shield/astra-stellar-shield.pdf b/comics/astra-stellar-shield/astra-stellar-shield.pdf
new file mode 100644
index 0000000..9c14dbf
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield.pdf
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_back.png b/comics/astra-stellar-shield/astra-stellar-shield_back.png
new file mode 100644
index 0000000..6c273d3
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_back.png
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_back_attribution.txt b/comics/astra-stellar-shield/astra-stellar-shield_back_attribution.txt
new file mode 100644
index 0000000..769bcb9
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_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: 1376x768
+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):
+Astra: Middle-aged, long flowing dark brown hair often styled in a high ponytail or half-up, determined emerald green eyes, warm olive skin tone, very athletic and muscular build. She wears a golden armored breastplate with ornate eagle-wing motifs, red form-fitting leggings, golden knee-high boots, and golden wrist gauntlets. A deep blue cape with gold trim flows from her shoulders. Zara: Young adult, short spiky bright purple hair, sharp sky blue eyes, pale skin tone, lean and agile build. Her uniform is a fitted dark grey flight suit with bright cyan accents on the shoulders and cu...
+
+Generated at: 2026-04-03 23:00:03
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_cover.png b/comics/astra-stellar-shield/astra-stellar-shield_cover.png
new file mode 100644
index 0000000..bd7b10a
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_cover.png
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_cover_attribution.txt b/comics/astra-stellar-shield/astra-stellar-shield_cover_attribution.txt
new file mode 100644
index 0000000..01bea79
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_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: 1376x768
+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):
+Astra: Middle-aged, long flowing dark brown hair often styled in a high ponytail or half-up, determined emerald green eyes, warm olive skin tone, very athletic and muscular build. She wears a golden armored breastplate with ornate eagle-wing motifs, red form-fitting leggings, golden knee-high boots, and golden wrist gauntlets. A deep blue cape with gold trim flows from her shoulders. Zara: Young adult, short spiky bright purple hair, sharp sky blue eyes, pale skin tone, lean and agile build. Her uniform is a fitted dark grey flight suit with bright cyan accents on the shoul...
+
+Generated at: 2026-04-03 22:58:32
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_narration.mp3 b/comics/astra-stellar-shield/astra-stellar-shield_narration.mp3
new file mode 100644
index 0000000..872fcd1
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_narration.mp3
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_page_1.png b/comics/astra-stellar-shield/astra-stellar-shield_page_1.png
new file mode 100644
index 0000000..ce7ae13
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_page_1.png
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_page_1_attribution.txt b/comics/astra-stellar-shield/astra-stellar-shield_page_1_attribution.txt
new file mode 100644
index 0000000..af6ad50
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_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: 1376x768
+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):
+Astra: Middle-aged, long flowing dark brown hair often styled in a high ponytail or half-up, determined emerald green eyes, warm olive skin tone, very athletic and muscular build. She wears a golden armored breastplate with ornate eagle-wing motifs, red form-fitting leggings, golden knee-high boots, and golden wrist gauntlets. A deep blue cape with gold trim flows from her shoulders. Zara: Young adult, short spiky bright purple h...
+
+Generated at: 2026-04-03 22:58:51
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_page_2.png b/comics/astra-stellar-shield/astra-stellar-shield_page_2.png
new file mode 100644
index 0000000..ce8d549
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_page_2.png
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_page_2_attribution.txt b/comics/astra-stellar-shield/astra-stellar-shield_page_2_attribution.txt
new file mode 100644
index 0000000..26c95b2
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_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: 1376x768
+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):
+Astra: Middle-aged, long flowing dark brown hair often styled in a high ponytail or half-up, determined emerald green eyes, warm olive skin tone, very athletic and muscular build. She wears a golden armored breastplate with ornate eagle-wing motifs, red form-fitting leggings, golden knee-high boots, and golden wrist gauntlets. A deep blue cape with gold trim flows from her shoulders. Zara: Young adult, short spiky bright purple h...
+
+Generated at: 2026-04-03 22:59:14
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_page_3.png b/comics/astra-stellar-shield/astra-stellar-shield_page_3.png
new file mode 100644
index 0000000..4081140
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_page_3.png
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_page_3_attribution.txt b/comics/astra-stellar-shield/astra-stellar-shield_page_3_attribution.txt
new file mode 100644
index 0000000..3bb6541
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_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: 1376x768
+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):
+Astra: Middle-aged, long flowing dark brown hair often styled in a high ponytail or half-up, determined emerald green eyes, warm olive skin tone, very athletic and muscular build. She wears a golden armored breastplate with ornate eagle-wing motifs, red form-fitting leggings, golden knee-high boots, and golden wrist gauntlets. A deep blue cape with gold trim flows from her shoulders. Zara: Young adult, short spiky bright purple h...
+
+Generated at: 2026-04-03 22:59:42
diff --git a/comics/astra-stellar-shield/astra-stellar-shield_story.txt b/comics/astra-stellar-shield/astra-stellar-shield_story.txt
new file mode 100644
index 0000000..baec415
--- /dev/null
+++ b/comics/astra-stellar-shield/astra-stellar-shield_story.txt
@@ -0,0 +1,25 @@
+Командир Астра стоеше на мостика на звездния си кораб „Зора“, оглеждайки безкрайната космическа шир. Нейната екипажна, състояща се от пилота Зара и техник Лео, работеха в синхрон, подготвяйки се за скок през хиперпространството. Астра, с нейната внушителна осанка и поглед, изпълнен с решителност, беше жива легенда – защитник на галактиката, известна с несравнимата си сила и безстрашие.
+
+„Скок след трийсет секунди, командир“, докладва Зара, докато пръстите ѝ танцуваха по контролния панел.
+„Разбрано, Зара. Лео, всички системи ли са зелени?“
+„Да, командир. Всичко е стабилно“, отвърна Лео, без да откъсва поглед от холографските дисплеи пред него.
+Внезапно аларма прониза тишината на мостика. Екраните присветнаха в червено.
+„Нещо излиза от хиперпространството точно пред нас!“ извика Лео. „Множество кораби, командир! Неизвестна формация!“
+
+Преди Астра да успее да реагира, мощна енергийна вълна разтърси „Зора“. Корабът се затресе. „Ксениди!“ процеди Астра, вече поемайки контрол. Тя знаеше тези същества – агресивни, технологично напреднали извънземни, които се появяваха от нищото, за да унищожават.
+Астра моментално се преобрази. Нейният брониран боен костюм, украсен със златни символи и светещ щит, се появи, заменяйки обикновената ѝ униформа. Тя грабна своето енергийно копие. „Зара, защитни щитове на максимум! Лео, открий им слабост!“
+
+Докато битката бушуваше, една малка, черна 1. котка се стрелна от вентилационния отвор и се сви до краката на Лео, търсейки утеха. Луна, корабното талисманче, бе свикнала с битките, но все пак предпочиташе спокойствието. Лео галеше успокоително главата ѝ, докато продължаваше да анализира тактиката на врага.
+
+Ксенидите бяха безмилостни, корабите им бяха бързи и смъртоносни. Един от вражеските кораби се приближи опасно и започна да стреля по мостика. Част от енергийния щит на „Зора“ отслабна.
+„Те ще се опитат да ни абордират!“ извика Зара.
+„Не и докато аз съм тук!“ прогърмя гласът на Астра. Тя се изправи пред вратата на мостика, копието ѝ излъчваше синя светлина. Когато първите Ксениди пробиха бронята на кораба и се появиха, тя ги посрещна с безмилостна точност и сила. Всяко движение беше прецизно, всеки удар – фатален.
+
+Докато Астра отблъскваше вълна след вълна от нападатели, Лео най-накрая извика: „Командир! Открих слабост в техните основни кораби! Енергийните им ядра са уязвими, когато преминават в нападателен режим!“
+„Зара, приготви торпедата! Фокусирай огъня върху основния им флагман! Лео, насочи я!“
+Астра се върна на бойния си пост, избърсвайки капка пот от челото си. Зара ѝ подаде голяма, червена 2. ябълка. „За енергия, командир. Нужна ни е на всички.“
+Астра отхапа от ябълката, усещайки освежаващия вкус. „Благодаря, Зара. Всички оставаме съсредоточени! Почти сме готови!“
+
+С новата информация и подновена сила, екипажът на „Зора“ започна контраатака. Торпедата, насочени прецизно от Лео и изстреляни от Зара, пробиха щитовете на флагмана на Ксенидите. Експлозия разтърси вражеския кораб. Останалите Ксенидски кораби, обезкуражени от загубата на лидера си, започнаха да се оттеглят обратно в хиперпространството.
+„Успех!“ възкликна Зара.
+Астра свали щита си, но запази копието в ръка. „Не е свършило, Зара. Те ще се върнат. Но и ние ще сме готови.“ Тя погледна към безкрайното пространство, истински пазител на реда в хаотична галактика.