feat(images): wire image pipeline into article flow (commit 1b) (#14)

Completes the image + A/B experiment workstream by integrating
image generation into the post publishing pipeline.

New classes:
- class-image-pipeline.php: Orchestrates A/B generation (article-driven
  Image A → featured; source-driven Image B → post meta). Each image
  independently fallible; article publishes even if both fail.
- class-image-prompt-builder.php: Synthesizes visual prompts from article
  title+content and Reddit source data. Appends CEO-locked 90s infomercial
  style suffix. Keeps prompts concise for FLUX.1 quality.
- class-image-media-sideloader.php: Downloads image bytes, creates temp
  file, sideloads via media_handle_sideload(), sets alt text and metadata,
  cleans up temp files.

Changes to existing files:
- Publisher.attach_generated_images(): Runs image pipeline post-creation,
  sets _thumbnail_id (Image A) and _prautoblogger_image_b_id (Image B).
  Errors logged but don't block post publication.
- Settings: prautoblogger_image_enabled (toggle, default off).

Tests:
- ImagePipelineTest.php: Orchestration, cost tracking, graceful failures.
- ImagePromptBuilderTest.php: Prompt generation, length limits.

Docs:
- ARCHITECTURE.md: New step 6b in data flow, new files in file tree.
- CHANGELOG.md: Commit 1a/1b breakdown.

Co-authored-by: peptiderepo <peptiderepo@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
peptiderepo
2026-04-16 16:51:22 +07:00
committed by GitHub
parent be5c659999
commit 2e41c3f2f6
9 changed files with 967 additions and 10 deletions

View File

@@ -8,6 +8,33 @@ and this project uses [Semantic Versioning](https://semver.org/).
## [Unreleased]
### Added
- **Image pipeline integration: wires image generation into article flow** (commit 1b).
Completes the image + Instagram A/B experiment workstream by adding three
orchestration classes that generate and sideload two images per published post.
- `includes/core/class-image-pipeline.php` — Orchestrates A/B image generation:
generates Image A (article-driven prompt) as featured image and Image B
(source-driven prompt) stored in post meta `_prautoblogger_image_b_id`. Each
image is independently fallible; article publishes even if both fail.
- `includes/core/class-image-prompt-builder.php` — Synthesizes visual prompts
from article title + first paragraph (for Image A) and Reddit thread title +
top comment (for Image B). Both prompts append the CEO-locked 90s infomercial
style suffix from settings. Prompts kept concise (under 200 words) for FLUX.1
generation quality.
- `includes/core/class-image-media-sideloader.php` — Downloads generated image
bytes, creates temporary file, imports via `media_handle_sideload()`, sets alt
text and generation metadata (`_prautoblogger_image_*`), cleans up temp files.
- Settings: `prautoblogger_image_enabled` (toggle, default off) — allows users to
enable/disable image generation after providing Cloudflare credentials.
- `PRAutoBlogger_Publisher::attach_generated_images()` — New private method that
runs the image pipeline post-creation and sets `_thumbnail_id` (Image A) and
`_prautoblogger_image_b_id` (Image B) post meta. Errors are logged but do not
block post publication.
- Tests: `tests/unit/Core/ImagePipelineTest.php` (orchestration, cost tracking,
graceful failure modes), `tests/unit/Core/ImagePromptBuilderTest.php` (prompt
generation from various article/source shapes, length limits).
- ARCHITECTURE.md: added new image pipeline step (6b) to data flow, three new files
to core/ section of file tree.
- **OpenRouter model registry (model-picker commit 1).** Foundation for the
smart model picker: fetches, normalizes, and caches the OpenRouter model
list (`/api/v1/models` — free, unauthenticated). Daily refresh via the
@@ -20,13 +47,10 @@ and this project uses [Semantic Versioning](https://semver.org/).
into a shared Composer package requires only a namespace rename.
- Cost impact: $0/month (free endpoint, no LLM tokens).
- **Image provider: Cloudflare Workers AI (FLUX.1 family).** First commit of
the image + Instagram A/B pipeline workstream. Ships the provider, its
- **Image provider: Cloudflare Workers AI (FLUX.1 family).** Ships the provider, its
pricing + validator helpers, four new settings fields in a new "Images"
admin section, and unit tests with mocked HTTP. Nothing calls the provider
yet from the article pipeline — integration lands in commit 1b.
- `includes/providers/interface-image-provider.php` (adopted from the CTO's
uncommitted draft) — contract for any image provider.
admin section, and unit tests with mocked HTTP.
- `includes/providers/interface-image-provider.php` — contract for any image provider.
- `includes/providers/class-cloudflare-image-provider.php` — FLUX on Workers
AI, direct call to `/accounts/{id}/ai/run/...` (bypassing AI Gateway per
decision D-001); exponential-backoff retries on 429 / 5xx / network,
@@ -41,10 +65,7 @@ and this project uses [Semantic Versioning](https://semver.org/).
90s infomercial prompt).
- Constants: `PRAUTOBLOGGER_DEFAULT_IMAGE_MODEL`,
`PRAUTOBLOGGER_DEFAULT_IMAGE_STYLE_SUFFIX`.
- Tests: `tests/unit/Providers/CloudflareImageProviderTest.php` covers
happy path (raw bytes + JSON envelope), dimension + empty-prompt
validation, 4xx loud-fail without retry, unexpected response shape,
cost scaling across models and dimensions, and missing-token diagnostics.
- Tests: `tests/unit/Providers/CloudflareImageProviderTest.php`.
- ARCHITECTURE.md: new key decision #16 (image pipeline: Cloudflare Workers
AI), new external API integration row, new options rows, file tree updates.
- CONVENTIONS.md: new "How To: Add a New Image Provider" section.