feat: Pipeline Settings M4 — generation history list + per-step I/O drill-down (v0.26.0)

CEO ask #5 complete: browsable paginated run list + full input/output inspection
per pipeline stage.

## What was built

### Generations list (prautoblogger-gen-history)
Hidden admin page (options.php-parent, priority 14) showing all pipeline runs newest
first, 20 per page. Each row: article title (linked to dossier when a post exists),
start date, status chip, distinct model(s), settled cost, duration. Queries bounded
(LIMIT/OFFSET) — no unbounded SELECT *.

New files:
- includes/admin/class-gen-history-query.php — paginated run list + per-run I/O queries
- includes/admin/class-gen-history-page.php  — hidden admin page + asset enqueue
- assets/css/gen-history.css, assets/js/gen-history.js — table + drill-down UI
- templates/admin/gen-history-page.php       — HTML template

### Per-step input + output drill-down (Stage I/O)
'Stage I/O' toggle opens an AJAX-loaded inline panel. For each generation_log stage:
  - input_system: system-role message content from generation_log.request_json
  - input_user: last user-role message from request_json (rendered instruction)
  - output: model response from run_stages.meta_json.output
  - output_pruned: true when meta_json present but output key absent (retention prune)

New AJAX endpoint: prautoblogger_gen_run_io (manage_options + nonce)
New file: includes/ajax/class-gen-run-io-handler.php

### gen-log INPUT/OUTPUT coverage verified
- INPUT: generation_log.request_json stores the chat body WITHOUT the Authorization
  header (Request_Recorder captures body after build_body(), before headers are added).
  System + user message content extracted and surfaced.
- OUTPUT: run_stages.meta_json.output is the LLM response text (Run_Stage_State::done()).
  Image/log-only stages (image_a, image_b, llm_research, image_prompt_rewrite) have no
  run_stages row; output is null, NOT pruned. Pruned outputs are flagged honestly.

### Dossier as entry point
Runs with a linked post show a 'Dossier' button deep-linking into the existing dossier
(which renders full per-stage I/O with editorial context). Stage I/O is complementary —
works for failed/orphan runs and provides the same data in a lighter inline UI.

### Stage-list-driven
Stage labels via Stage_Display_Map::label() — Phase 2b curate/seo appear automatically.

### Dead prautoblogger_pipeline_history endpoint
Not dead — it IS used by pipeline-settings.js for prompt version history (M3 feature).
Left in place. No dangling endpoint.

## M3 P2 sweep
- Removed dead data-preview-nonce and data-diff-nonce HTML attrs from
  pipeline-settings-prompt-panel.php (JS uses prabPipeline.*Nonce from
  wp_localize_script, not data-* attrs — confirmed by grep).
- Removed 3 redundant wp_create_nonce() calls from class-pipeline-settings-renderer.php
  (preview_nonce, history_nonce, diff_nonce keys that fed the now-removed dead attrs).
- Updated CONTEXT.md: added M3 + M4 terminology tables.
- Updated ARCHITECTURE.md: added ajax/ section to file tree; M3/M4 design notes.
- Updated INFORMATION-ARCHITECTURE.md: prautoblogger-gen-history entry.

## Security
- manage_options cap + prautoblogger_gen_run_io nonce on the AJAX endpoint.
- All output esc_html()/esc_url() server-side before JSON-encoding.
- JS renders prompt/response text via textContent — never innerHTML.
- No writes from history UI; request_json never contains auth headers.

## Version: v0.25.0 → v0.26.0

Agent-Session: pipeline-settings-m4
This commit is contained in:
PRAutoBlogger Engineer
2026-06-23 06:57:54 +00:00
parent 2569b08862
commit baae383c76
16 changed files with 1497 additions and 16 deletions

View File

@@ -0,0 +1,161 @@
<?php
/**
* Template: Generation History page (M4).
*
* Variables provided by PRAutoBlogger_Gen_History_Page::render_page():
* array $rows -- list of run rows from Gen_History_Query::get_page().
* array $pagination -- { current, total, count, base }.
*
* SECURITY: All output escaped (esc_html / esc_url / number_format).
* Stage I/O loaded via AJAX (gen-history.js) and rendered with
* textContent — no innerHTML for prompt/response text.
*
* @see admin/class-gen-history-page.php -- Registers page + passes vars.
* @see assets/js/gen-history.js -- Stage I/O drill-down JS.
* @see assets/css/gen-history.css -- Styles.
*/
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
?>
<div class="wrap prab-gen-history">
<h1><?php esc_html_e( 'Generation History', 'prautoblogger' ); ?></h1>
<p class="prab-gen-history__subtitle">
<?php
printf(
/* translators: %d: total number of runs */
esc_html__( '%d total runs — newest first. Click "Stage I/O" to inspect the full input and output of each pipeline step.', 'prautoblogger' ),
(int) $pagination['count']
);
?>
</p>
<?php if ( empty( $rows ) ) : ?>
<p><?php esc_html_e( 'No generation runs found.', 'prautoblogger' ); ?></p>
<?php else : ?>
<table class="wp-list-table widefat fixed striped prab-gen-history__table">
<thead>
<tr>
<th scope="col"><?php esc_html_e( 'Article', 'prautoblogger' ); ?></th>
<th scope="col"><?php esc_html_e( 'Date', 'prautoblogger' ); ?></th>
<th scope="col"><?php esc_html_e( 'Status', 'prautoblogger' ); ?></th>
<th scope="col"><?php esc_html_e( 'Model(s)', 'prautoblogger' ); ?></th>
<th scope="col"><?php esc_html_e( 'Cost', 'prautoblogger' ); ?></th>
<th scope="col"><?php esc_html_e( 'Duration', 'prautoblogger' ); ?></th>
<th scope="col"><?php esc_html_e( 'Actions', 'prautoblogger' ); ?></th>
</tr>
</thead>
<tbody>
<?php foreach ( $rows as $row ) : ?>
<?php
$run_id = (string) ( $row['run_id'] ?? '' );
$post_id = (int) ( $row['post_id'] ?? 0 );
$post_title = '' !== (string) ( $row['post_title'] ?? '' )
? (string) $row['post_title'] : '';
$status = (string) ( $row['status'] ?? '' );
$started_at = (string) ( $row['started_at'] ?? '' );
$cost_total = round( (float) ( $row['cost_total'] ?? 0 ), 4 );
$models_raw = (string) ( $row['models'] ?? '' );
$duration_s = isset( $row['duration_seconds'] ) && null !== $row['duration_seconds']
? (int) $row['duration_seconds'] : null;
$dossier_url = $post_id > 0
? PRAutoBlogger_Dossier_Page::url_for_post( $post_id ) : '';
// Status chip CSS class.
$status_class = 'prab-chip prab-chip--' . esc_attr( $status );
?>
<tr class="prab-gen-history__row" data-run-id="<?php echo esc_attr( $run_id ); ?>">
<td>
<?php if ( '' !== $post_title && $post_id > 0 ) : ?>
<a href="<?php echo esc_url( $dossier_url ); ?>">
<?php echo esc_html( $post_title ); ?>
</a>
<?php elseif ( '' !== $post_title ) : ?>
<?php echo esc_html( $post_title ); ?>
<?php else : ?>
<span class="prab-gen-history__no-title">
<?php
printf(
/* translators: %s: abbreviated run ID */
esc_html__( 'Run %s', 'prautoblogger' ),
esc_html( substr( $run_id, 0, 8 ) )
);
?>
</span>
<?php endif; ?>
</td>
<td><?php echo esc_html( $started_at ); ?></td>
<td><span class="<?php echo esc_attr( $status_class ); ?>"><?php echo esc_html( $status ); ?></span></td>
<td class="prab-gen-history__models">
<span title="<?php echo esc_attr( $models_raw ); ?>">
<?php echo esc_html( $models_raw ); ?>
</span>
</td>
<td>$<?php echo esc_html( number_format( $cost_total, 4 ) ); ?></td>
<td>
<?php
if ( null !== $duration_s ) {
$mins = (int) floor( $duration_s / 60 );
$secs = $duration_s % 60;
if ( $mins > 0 ) {
printf(
/* translators: 1: minutes, 2: seconds */
esc_html__( '%1$dm %2$ds', 'prautoblogger' ),
$mins,
$secs
);
} else {
printf(
/* translators: %d: seconds */
esc_html__( '%ds', 'prautoblogger' ),
$secs
);
}
} else {
esc_html_e( '—', 'prautoblogger' );
}
?>
</td>
<td class="prab-gen-history__actions">
<?php if ( '' !== $dossier_url ) : ?>
<a href="<?php echo esc_url( $dossier_url ); ?>" class="button button-small">
<?php esc_html_e( 'Dossier', 'prautoblogger' ); ?>
</a>
<?php endif; ?>
<button type="button"
class="button button-small prab-gen-history__io-toggle"
data-run-id="<?php echo esc_attr( $run_id ); ?>">
<?php esc_html_e( 'Stage I/O', 'prautoblogger' ); ?>
</button>
</td>
</tr>
<tr class="prab-gen-history__io-row" id="prab-io-<?php echo esc_attr( $run_id ); ?>" hidden>
<td colspan="7">
<div class="prab-gen-history__io-panel">
<p class="prab-gen-history__io-loading">
<?php esc_html_e( 'Loading…', 'prautoblogger' ); ?>
</p>
</div>
</td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
<?php if ( $pagination['total'] > 1 ) : ?>
<div class="prab-gen-history__pagination">
<?php for ( $p = 1; $p <= $pagination['total']; $p++ ) : ?>
<?php if ( $p === $pagination['current'] ) : ?>
<span class="prab-gen-history__page-current"><?php echo (int) $p; ?></span>
<?php else : ?>
<a href="<?php echo esc_url( add_query_arg( 'paged', $p, $pagination['base'] ) ); ?>">
<?php echo (int) $p; ?>
</a>
<?php endif; ?>
<?php endfor; ?>
</div>
<?php endif; ?>
<?php endif; ?>
</div>