feat(phase2b): P2b.5 — Authority admin controls + new-stage panels (#182, v0.32.0)

Surfaces the master enable toggle (default OFF), per-category tier-map editor, citation threshold, and curate/seo/authority step panels + research-agent-count/editorial-max-rounds in Pipeline Settings. Image pipeline honors _prautoblogger_imagery_suppressed. Completes Phase 2b. QA APPROVE-WITH-P2 d1447340; CI green (phpcs+phpunit VPS-verified). 3 trivial P2 docs/cleanup follow-ups noted.

Agent-Session: prab-phase2b-5-merge

tests/unit/Core/PostAssemblerImageryTest.php

@@ -0,0 +1,88 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Tests for PRAutoBlogger_Post_Assembler::attach_generated_images() imagery-suppression gate.
+ *
+ * What: Verifies that the _prautoblogger_imagery_suppressed post meta flag
+ *       causes attach_generated_images() to return early without touching the
+ *       image pipeline, and that clearing the flag lets the method proceed.
+ * Dependencies: Brain\Monkey (stubs WordPress functions), PRAutoBlogger_Logger stub.
+ *
+ * @package PRAutoBlogger\Tests\Core
+ */
+
+namespace PRAutoBlogger\Tests\Core;
+
+use PRAutoBlogger\Tests\BaseTestCase;
+use Brain\Monkey\Functions;
+
+class PostAssemblerImageryTest extends BaseTestCase {
+
+	/** @var \PHPUnit\Framework\MockObject\MockObject&object Mock Article_Idea. */
+	private object $idea;
+
+	protected function setUp(): void {
+		parent::setUp();
+
+		// Logger::instance()->info() reads log level from wp_options — stub it.
+		$this->stub_get_option( array(
+			'prautoblogger_log_level' => 'info',
+		) );
+
+		// Minimal Article_Idea mock — get_source_ids() is needed only for the non-suppressed path.
+		$this->idea = $this->getMockBuilder( \PRAutoBlogger_Article_Idea::class )
+			->disableOriginalConstructor()
+			->onlyMethods( array( 'get_source_ids' ) )
+			->getMock();
+	}
+
+	/**
+	 * When _prautoblogger_imagery_suppressed = '1', the method returns without
+	 * reaching the Source_Collector or Image_Pipeline.
+	 * The get_source_ids() mock has no expectation — if it were called, PHPUnit
+	 * would throw (unexpected call). Reaching assertTrue confirms early return.
+	 */
+	public function test_imagery_suppressed_flag_causes_early_return(): void {
+		Functions\when( 'get_post_meta' )
+			->alias( static function ( int $post_id, string $key, bool $single ) {
+				if ( 99 === $post_id && '_prautoblogger_imagery_suppressed' === $key && $single ) {
+					return '1';
+				}
+				return '';
+			} );
+
+		// current_time is called by Logger — already stubbed in BaseTestCase.
+		// No expectation on get_source_ids — if called, that means the guard failed.
+		\PRAutoBlogger_Post_Assembler::attach_generated_images( 99, $this->idea, array(), null );
+
+		$this->assertTrue( true, 'Method returned early when imagery_suppressed = 1' );
+	}
+
+	/**
+	 * When _prautoblogger_imagery_suppressed is empty the method proceeds past
+	 * the guard and calls get_source_ids() before attempting Source_Collector.
+	 * We assert the guard did not fire by verifying get_source_ids() is reached.
+	 */
+	public function test_no_suppression_flag_proceeds_past_guard(): void {
+		Functions\when( 'get_post_meta' )
+			->alias( static function ( int $post_id, string $key, bool $single ) {
+				return ''; // Flag not set.
+			} );
+
+		$this->idea->expects( $this->once() )
+			->method( 'get_source_ids' )
+			->willReturn( array() );
+
+		// Source_Collector::get_source_data_for_image will attempt a DB call — let it throw.
+		// We only care that get_source_ids() was called (guard passed).
+		try {
+			\PRAutoBlogger_Post_Assembler::attach_generated_images( 99, $this->idea, array(), null );
+		} catch ( \Throwable $e ) {
+			// Expected: DB/class not available in unit context.
+		}
+
+		// PHPUnit verifies the ->once() expectation on mock teardown.
+		$this->assertTrue( true, 'Guard was not triggered; method proceeded past suppression check.' );
+	}
+}