array, // current DB state for the picked post
* 'events' => array, // chronologically-sorted events
* 'event_total' => int, // total matched (may exceed events count if truncated)
* 'truncated' => bool,
* 'request_count' => int,
* }
*
* @return string
*/
public function renderTimeline( array $payload ) {
ob_start();
$state = isset( $payload['state'] ) && is_array( $payload['state'] ) ? $payload['state'] : [];
$events = isset( $payload['events'] ) && is_array( $payload['events'] ) ? $payload['events'] : [];
$eventTotal = isset( $payload['event_total'] ) ? (int) $payload['event_total'] : count( $events );
$truncated = ! empty( $payload['truncated'] );
$requestCount = isset( $payload['request_count'] ) ? (int) $payload['request_count'] : 0;
$this->renderStatePanel( $state );
$this->renderTimelineBody( $events, $requestCount, $eventTotal, $truncated );
return ob_get_clean();
}
private function renderStatePanel( array $state ) {
$postId = isset( $state['post_id'] ) ? (int) $state['post_id'] : 0;
$title = (string) ( $state['post_title'] ?? '' );
$postType = (string) ( $state['post_type'] ?? '' );
$sourceLang = (string) ( $state['source_lang'] ?? '' );
$modified = (string) ( $state['modified_utc'] ?? '' );
$trid = isset( $state['trid'] ) ? (int) $state['trid'] : 0;
$translations = isset( $state['translations'] ) && is_array( $state['translations'] ) ? $state['translations'] : [];
$activeJobs = isset( $state['active_jobs'] ) && is_array( $state['active_jobs'] ) ? $state['active_jobs'] : [];
?>
renderEventRow( $event ); ?>
0 ? '#' . $tpId : 'no translated post' )
. ( $status !== '' ? ' (status ' . $status . ')' : '' )
. "\n";
}
}
$activeJobs = isset( $state['active_jobs'] ) && is_array( $state['active_jobs'] ) ? $state['active_jobs'] : [];
echo "\nIn-flight jobs (translated = 0):\n";
if ( empty( $activeJobs ) ) {
echo " (none)\n";
} else {
foreach ( $activeJobs as $j ) {
echo ' #' . (int) ( $j['job_id'] ?? 0 )
. ' (' . (string) ( $j['target_lang'] ?? '?' ) . ', '
. 'status ' . (string) ( $j['status'] ?? '?' ) . ', '
. 'age ' . self::formatAge( $j['age_seconds'] ?? null )
. ")\n";
}
}
echo "\n";
flush();
// Timeline.
echo "==========================================\n";
echo 'TIMELINE — ' . $eventTotal . ' events across ' . $requestCount . ' requests';
if ( $truncated ) {
echo ' (truncated — only the most recent shown)';
}
echo "\n==========================================\n\n";
if ( empty( $events ) ) {
echo "(no events found for this post)\n";
return;
}
$lastReq = null;
foreach ( $events as $event ) {
$ts = (string) ( $event['timestamp_utc'] ?? '' );
$logUid = (string) ( $event['__logUid'] ?? '' );
$reqTag = $logUid !== '' ? 'req:' . substr( $logUid, 0, 6 ) : '';
$label = self::eventLabel( $event );
$isErr = isset( $event['logType'] ) && (int) $event['logType'] === JobLog::LOG_TYPE_ERROR;
$marker = $isErr ? ' [ERROR]' : '';
echo $ts . ' [' . $reqTag . '] ' . $label . $marker . "\n";
if ( isset( $event['data'] ) && is_array( $event['data'] ) && ! empty( $event['data'] ) ) {
$json = wp_json_encode( $event['data'], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES );
if ( is_string( $json ) ) {
echo ' ' . str_replace( "\n", "\n ", $json ) . "\n";
}
}
// Flush every request boundary so reverse-proxy timeouts don't
// stall the stream on long timelines.
if ( $reqTag !== $lastReq ) {
flush();
$lastReq = $reqTag;
}
}
echo "\n========================================\n";
echo "End of timeline\n";
echo "========================================\n";
}
/**
* Mirror of renderEventRow's per-type label logic, in plain text.
*
* @param array $event
*
* @return string
*/
private static function eventLabel( array $event ) {
$type = (string) ( $event['type'] ?? '' );
switch ( $type ) {
case 'log':
return (string) ( $event['id'] ?? '' );
case 'group_started':
$lbl = (string) ( $event['label'] ?? '' );
return '▶ group: ' . ( $lbl !== '' ? $lbl : ( 'id ' . ( $event['groupId'] ?? '?' ) ) );
case 'group_finished':
return '◀ end of group ' . ( $event['groupId'] ?? '?' );
case 'request_started':
return '▶ request started';
case 'request_finished':
return ! empty( $event['aborted'] ) ? '◀ request aborted' : '◀ request finished';
}
return $type !== '' ? '[' . $type . ']' : '(unknown event)';
}
}