zer0-image-generator 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24975e688896196e8e883c15ed17d09e5856a9b68f18b47b347bc61d701cc265
-  data.tar.gz: da2d123ed3067f36c2e5962bd3a351a9d1ae48e1fd97bfe6dbcccb23aac53e52
+  metadata.gz: c105d9c5a9aab3c6b772c558fbf070788058e929a4ce846e9cbaa5da019e117d
+  data.tar.gz: '0597cbdb685887b2733b29123aee8704366d96b1bca6781395a7bccf760d3748'
 SHA512:
-  metadata.gz: 2add913663a1f13bfebc00746b3ace4ebf5c4e096fd34ee1db89754245762d011e1a2ca8173ed2f0aefbf46abdacb041625f9ac916f9b8e48aa13c6c38c87467
-  data.tar.gz: e275f913cfeb197728138bc154a6963e31b1cdf0a1b11081a8526ef002667dfa504b1c7a0e55bac799a5977a599995012f2fe0f66aa28a3e5b28d599244c16a1
+  metadata.gz: e791021d473f1b0b0246973a2e9dab6add20919b5c96b1e2df0806fa12269fd6ea3053ee20b3094dfa1aa365bcdb38ca5ea3e5f315116ff83fd073429aa40487
+  data.tar.gz: edd3c2fcad1bbe57e3b87bab8a30b168855865b4ab79a6fc215727d8cbc9a42467da587bde09217798c0eb7bd2b40552db67ca5217ab7de71f7e08bf41a36f0d

data/CHANGELOG.md

@@ -5,6 +5,37 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0](https://github.com/bamr87/zer0-image-generator/compare/zer0-image-generator-v0.4.0...zer0-image-generator/v0.5.0) (2026-07-15)
+
+
+### Features
+
+* extract the AI preview-image engine from zer0-mistakes as a portable Jekyll plugin ([58190c9](https://github.com/bamr87/zer0-image-generator/commit/58190c996ccc93ae2bdfee7d3086196eb11ea297))
+* honor Jekyll's top-level `source:` key (zer0-pages layouts) ([baa34df](https://github.com/bamr87/zer0-image-generator/commit/baa34dfa36a836677684e1244dd87953d6f6746d))
+* low-effort Claude orchestration for faster generation ([f037fc9](https://github.com/bamr87/zer0-image-generator/commit/f037fc9f304da937b8575b0da5371f5fc7686189))
+* per-collection preview styles (collection_styles) ([0f14eeb](https://github.com/bamr87/zer0-image-generator/commit/0f14eeb9eda472e2c6540559f2aab32c97c8146b))
+
+
+### Bug Fixes
+
+* accept repo-root-relative --file paths on `source:` sites ([30d950d](https://github.com/bamr87/zer0-image-generator/commit/30d950d48f5245511e5790671e6b6cfd7af9b588))
+* forward Mercenary options to the engine (symbol hash keys) ([1e91fc6](https://github.com/bamr87/zer0-image-generator/commit/1e91fc6bcd10fff2e278b6c76c25d1cd0b00cf7f))
+
+## [0.4.0] - 2026-07-15
+
+### Added
+
+- `claude_effort` knob (default `low`): the Claude art-brief and vision-review
+  calls now send `output_config: {effort: ...}` — short creative tasks don't
+  need deep reasoning, and `low` substantially cuts per-image orchestration
+  latency. Configurable per site (`preview_images.claude_effort`); `''`
+  disables. Gracefully retries without the parameter on models that reject it.
+
+### Changed
+
+- README documents the batch-performance contract: one `--collection` run
+  parallelizes across files (`--parallel N`, default 4); per-file loops don't.
+
 ## [0.3.0] - 2026-07-14
 
 ### Added

data/README.md

@@ -87,6 +87,9 @@ preview_images:
   output_dir: assets/images/previews
   prompt_engine: claude       # claude analyzes each article | template
   review_engine: claude       # claude vision-reviews each render | none
+  claude_effort: low          # output_config.effort for the brief/review calls
+                              # (low = fastest, right-sized for short briefs;
+                              #  high = deepest; '' sends no effort parameter)
   # --- portability knobs (the zer0-isms, now configurable) ---
   collections: [posts]        # list of collections, or 'auto' to discover
                               # them from Jekyll's own `collections:` map
@@ -130,6 +133,21 @@ preview_images:
   # front_matter_key/preview + /assets prefixing are already the defaults
 ```
 
+### Batch performance
+
+The engine parallelizes **within one invocation** (4 workers by default, `-j N`
+to change). For many files, one collection run beats a loop of single-file
+runs — the loop pays process startup per file and never engages the pool:
+
+```bash
+bundle exec jekyll preview-images --collection posts --parallel 6   # ✓ parallel
+for f in ...; do jekyll preview-images -f "$f"; done                # ✗ serial
+```
+
+Claude orchestration runs at `claude_effort: low` by default — right-sized for
+a short art brief and a render verdict. Raise it (or set `claude_model`) if you
+want deeper art direction at the cost of latency.
+
 ### Per-collection styles
 
 Give each collection its own visual identity — tutorials render differently

data/lib/zer0_image_generator/preview_generator.py

@@ -128,6 +128,8 @@ DEFAULTS: Dict[str, Any] = {
     "prompt_engine": "claude",   # claude analyzes the article; falls back to template
     "review_engine": "claude",   # claude vision-reviews the render; `none` disables
     "claude_model": "",          # empty → DEFAULT_CLAUDE_MODEL
+    "claude_effort": "low",      # output_config.effort for brief/review calls
+                                 # (short creative tasks; "" sends no effort)
 }
 
 # Enhance mode (OpenAI /v1/images/edits — see OpenAIProvider.edit)
@@ -650,6 +652,7 @@ class Settings:
     prompt_engine: str = DEFAULTS["prompt_engine"]
     review_engine: str = DEFAULTS["review_engine"]
     claude_model: str = DEFAULTS["claude_model"]
+    claude_effort: str = DEFAULTS["claude_effort"]
 
     dry_run: bool = False
     verbose: bool = False
@@ -752,6 +755,7 @@ def resolve_settings(args: argparse.Namespace, config: Dict[str, Any]) -> Settin
         prompt_engine=pick(args.prompt_engine, "PROMPT_ENGINE", "prompt_engine"),
         review_engine=pick(args.review, "REVIEW_ENGINE", "review_engine"),
         claude_model=str(cfg("claude_model", "") or ""),
+        claude_effort=str(cfg("claude_effort", DEFAULTS["claude_effort"]) or ""),
         dry_run=args.dry_run or _env_flag("DRY_RUN"),
         verbose=args.verbose or _env_flag("VERBOSE"),
         force=args.force or _env_flag("FORCE"),
@@ -1120,6 +1124,7 @@ def claude_article_brief(client: "AnthropicClient", cf: ContentFile,
         text = client.complete(
             ART_DIRECTOR_SYSTEM, article,
             model=claude_model_for(settings), max_tokens=2048,
+            effort=settings.claude_effort,
         ).strip()
         if text:
             debug(f"Claude art-direction brief: {text[:300]}...")
@@ -1159,6 +1164,7 @@ def claude_review_image(client: "AnthropicClient", image_path: Path,
         text = client.complete_vision(
             REVIEWER_SYSTEM, context, image_path,
             model=claude_model_for(settings),
+            effort=settings.claude_effort,
         )
         data = _extract_json_object(text)
         if not data:
@@ -1496,6 +1502,7 @@ class AnthropicClient:
         user_text: str,
         model: str = DEFAULT_CLAUDE_MODEL,
         max_tokens: int = CLAUDE_MAX_TOKENS,
+        effort: str = "",
     ) -> str:
         """One Messages-API turn (or CLI run); returns concatenated text blocks.
 
@@ -1520,6 +1527,8 @@ class AnthropicClient:
             "system": system_blocks,
             "messages": [{"role": "user", "content": user_text}],
         }
+        if effort:
+            payload["output_config"] = {"effort": effort}
 
         def call(body: Dict[str, Any]) -> dict:
             return with_retries(
@@ -1530,7 +1539,12 @@ class AnthropicClient:
         try:
             data = call(payload)
         except HttpStatusError as exc:
-            if exc.status == 400 and "thinking" in exc.message().lower():
+            message = exc.message().lower() if exc.status == 400 else ""
+            if exc.status == 400 and ("output_config" in message or "effort" in message):
+                debug("Retrying without output_config parameter")
+                payload.pop("output_config", None)
+                data = call(payload)
+            elif exc.status == 400 and "thinking" in message:
                 debug("Retrying without thinking parameter")
                 payload.pop("thinking", None)
                 data = call(payload)
@@ -1564,6 +1578,7 @@ class AnthropicClient:
         image_path: Path,
         model: str = DEFAULT_CLAUDE_MODEL,
         max_tokens: int = 2048,
+        effort: str = "",
     ) -> str:
         """One vision turn over a local PNG (review stage). CLI mode passes the
         file path and lets `claude -p` read it; API modes embed base64."""
@@ -1595,10 +1610,25 @@ class AnthropicClient:
                 ],
             }],
         }
-        data = with_retries(
-            lambda: http_json(ANTHROPIC_API_URL, payload, self.headers(), timeout=900),
-            "Anthropic API (review)",
-        )
+        if effort:
+            payload["output_config"] = {"effort": effort}
+
+        def call(body: Dict[str, Any]) -> dict:
+            return with_retries(
+                lambda: http_json(ANTHROPIC_API_URL, body, self.headers(), timeout=900),
+                "Anthropic API (review)",
+            )
+
+        try:
+            data = call(payload)
+        except HttpStatusError as exc:
+            message = exc.message().lower() if exc.status == 400 else ""
+            if exc.status == 400 and ("output_config" in message or "effort" in message):
+                debug("Retrying review without output_config parameter")
+                payload.pop("output_config", None)
+                data = call(payload)
+            else:
+                raise
         if data.get("stop_reason") == "refusal":
             details = data.get("stop_details") or {}
             raise ClaudeRefusal(details.get("category") if isinstance(details, dict) else None)

data/lib/zer0_image_generator/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Zer0ImageGenerator
-  VERSION = "0.3.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zer0-image-generator
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Amr Abdel
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -59,6 +60,7 @@ metadata:
   changelog_uri: https://github.com/bamr87/zer0-image-generator/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/bamr87/zer0-image-generator/issues
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -74,7 +76,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - Python 3.9+ with PyYAML (python3 -m pip install pyyaml)
-rubygems_version: 4.0.11
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: AI preview/social images for any Jekyll site — Claude directs and reviews,
   an image model renders.