Adds a new 'Pipeline' wp-admin submenu page (prautoblogger-pipeline) with a step rail covering all LLM stages: Research, Analysis, Writer, Editorial, Image. Per-step panels surface: - The existing PRAutoBlogger_OpenRouter_Model_Field picker (no new dropdown) with stage-accurate cost-preview for each step. - System-instructions editor + agent-prompt editor(s) bound to the versioned prompt registry. Saving creates a new immutable version; reset-to-default available; active version number shown per panel. - Step params read from PRAutoBlogger_Prompt_Registry::defs() (read-only in M1). Writer panel marks inactive sub-stage prompts based on current pipeline mode. No existing Settings sections changed — both surfaces edit the same wp_options and prompts table. Decomposition of AI Models / Content / Sources tabs is M2. get_stages_for_setting() extended: prautoblogger_research_model → [research, llm_research] and prautoblogger_image_model → [image_a, image_b] for cost-preview accuracy. New files (4 classes + 1 CSS + 1 JS + 2 templates, all <=300 lines): includes/admin/class-pipeline-settings-page.php includes/admin/class-pipeline-settings-renderer.php includes/admin/class-pipeline-settings-save-handler.php includes/admin/class-pipeline-settings-step-map.php assets/css/pipeline-settings.css assets/js/pipeline-settings.js templates/admin/pipeline-settings-page.php templates/admin/pipeline-settings-prompt-panel.php Modified: includes/admin/fields/class-open-router-model-field.php includes/class-prautoblogger.php prautoblogger.php (v0.23.0) ARCHITECTURE.md / INFORMATION-ARCHITECTURE.md / CHANGELOG.md No new wp_options; uninstall unchanged. Agent-Session: pipeline-settings-m1
86 lines
3.8 KiB
Markdown
86 lines
3.8 KiB
Markdown
# Information Architecture — PRAutoBlogger
|
|
|
|
Auto-generated index of all admin surfaces, data flows, and integrations.
|
|
Maintained per DoD v1.1.0 (same-PR update rule).
|
|
|
|
---
|
|
|
|
## Admin Pages
|
|
|
|
| Slug | Class | Template | Purpose |
|
|
|------|-------|----------|---------|
|
|
| `prautoblogger-settings` | `PRAutoBlogger_Admin_Page` | `admin-page.php` | Main settings (schedule, models, budget, board limits) |
|
|
| `prautoblogger-board` | `PRAutoBlogger_Board_Page` | `board-page.php` | Kanban board: Generating / Failed / In Review / Published columns. New Article button (v0.21.0). |
|
|
| `prautoblogger-pipeline` | `PRAutoBlogger_Pipeline_Settings_Page` | `pipeline-settings-page.php` | Per-step pipeline config: model picker, system instructions, agent prompts, params (M1, v0.23.0). |
|
|
| `prautoblogger-articles` | `PRAutoBlogger_Articles_Page` | `articles-page.php` | Paginated list of all articles/runs |
|
|
| `prautoblogger-dossier` | `PRAutoBlogger_Dossier_Page` | `dossier-page.php` | Per-article generation log + stage edit/re-run (M3) |
|
|
| `prautoblogger-ideas` | `PRAutoBlogger_Ideas_Browser` | `ideas-browser.php` | Analysis results browser with per-idea generation |
|
|
| `prautoblogger-activity` | `PRAutoBlogger_Activity_Page` | `activity-page.php` | Cost + generation activity log |
|
|
|
|
---
|
|
|
|
## Generation Entry Points (v0.21.0)
|
|
|
|
```
|
|
Board "New Article" button
|
|
└─ AJAX prautoblogger_generate_now
|
|
└─ Generation_Status_Poller::on_ajax_generate_now()
|
|
└─ schedules prautoblogger_manual_generation cron
|
|
└─ Executor::on_manual_generation()
|
|
└─ Generation_Checkpoint_Runner::on_orchestrate_tick() ← Tick 1
|
|
└─ schedules prautoblogger_gen_tick
|
|
└─ Generation_Checkpoint_Runner::on_generate_tick() ← Tick 2..N
|
|
|
|
WP-CLI: wp prautoblogger generate
|
|
└─ WP_CLI_Commands::generate_command()
|
|
└─ Generation_Checkpoint_Runner::kick_off()
|
|
└─ schedules prautoblogger_gen_orchestrate
|
|
└─ Generation_Checkpoint_Runner::on_orchestrate_tick() ← Tick 1
|
|
|
|
Daily auto-generation cron
|
|
└─ prautoblogger_daily_generation
|
|
└─ Executor::on_cron_run()
|
|
└─ Pipeline_Runner::run() (legacy synchronous path — runs in a single PHP process)
|
|
```
|
|
|
|
---
|
|
|
|
## Database Tables
|
|
|
|
| Table | DB Version | Purpose |
|
|
|-------|-----------|---------|
|
|
| `prautoblogger_sources` | 1.0.0 | Collected Reddit/RSS source content |
|
|
| `prautoblogger_analysis_results` | 1.0.0 | Scored article ideas |
|
|
| `prautoblogger_generation_log` | 1.0.0 | Per-LLM-call log (cost, tokens, status) |
|
|
| `prautoblogger_runs` | 1.0.0 | Per-run ledger (status, ceiling_usd) |
|
|
| `prautoblogger_run_stages` | 1.2.0 | Per-stage state for M3 re-run |
|
|
| `prautoblogger_stage_inputs` | 1.3.0 | Immutable input versions for stage edits (M3) |
|
|
| `prautoblogger_run_decisions` | 1.2.0 | Editorial decisions per run |
|
|
|
|
DB version history: 1.0→1.1 (schema normalisation), 1.1→1.2 (M2 dossier), 1.2→1.3 (M3 stage inputs), 1.3→1.4 (M4 indexes).
|
|
|
|
---
|
|
|
|
## Key Options
|
|
|
|
| Option | Type | Default | Purpose |
|
|
|--------|------|---------|---------|
|
|
| `prautoblogger_board_column_limit` | int | 20 | Max cards per board column |
|
|
| `prautoblogger_ideas_per_page` | int | 30 | Ideas browser page size |
|
|
| `prautoblogger_article_queue` | array | — | Checkpoint queue (run_id + ideas + results) |
|
|
| `prautoblogger_checkpoint_run_id` | string | — | Current run UUID for Tick 2..N finalize path |
|
|
| `prautoblogger_db_version` | string | — | Installed schema version (triggers dbDelta on mismatch) |
|
|
|
|
---
|
|
|
|
## WP-CLI Commands
|
|
|
|
| Command | Since | Description |
|
|
|---------|-------|-------------|
|
|
| `wp prautoblogger generate` | 0.21.0 | Queue article generation via chained-cron checkpoints |
|
|
| `wp prautoblogger opik:eval` | 0.12.0 | Trigger Opik eval run |
|
|
|
|
---
|
|
|
|
*Last updated: v0.21.0 (2026-06-14)*
|