<?php
/**
 * WP-CLI command reference for the Broken Links module.
 *
 * @package BlaminhorEssentials
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

return array(
	array(
		'name'        => 'wp blaminhor broken-links get',
		'description' => __( 'Show the current Broken Links settings + last scan timestamp.', 'blaminhor-essentials' ),
		'example'     => 'wp blaminhor broken-links get',
	),
	array(
		'name'        => 'wp blaminhor broken-links set',
		'description' => __( 'Update Broken Links scanner settings.', 'blaminhor-essentials' ),
		'example'     => 'wp blaminhor broken-links set --post-types=post,page',
	),
	array(
		'name'        => 'wp blaminhor broken-links list',
		'description' => __( 'List broken links currently stored in the database.', 'blaminhor-essentials' ),
		'example'     => 'wp blaminhor broken-links list',
	),
	array(
		'name'        => 'wp blaminhor broken-links check-url',
		'description' => __( 'Check a single URL outside of any scan run (read-only diagnostic).', 'blaminhor-essentials' ),
		'example'     => 'wp blaminhor broken-links check-url https://example.com',
	),
	array(
		'name'        => 'wp blaminhor broken-links dismiss',
		'description' => __( 'Mark a broken link as dismissed (won\'t be reported again until re-scanned).', 'blaminhor-essentials' ),
		'example'     => 'wp blaminhor broken-links dismiss 123',
	),
	array(
		'name'        => 'wp blaminhor broken-links delete',
		'description' => __( 'Permanently delete one or more broken-link entries.', 'blaminhor-essentials' ),
		'example'     => 'wp blaminhor broken-links delete 123 --yes',
	),
	array(
		'name'        => 'wp blaminhor broken-links stats',
		'description' => __( 'Print summary stats (count broken, count dismissed, last scan).', 'blaminhor-essentials' ),
		'example'     => 'wp blaminhor broken-links stats',
	),
	array(
		'name'        => 'wp blaminhor broken-links scan',
		'description' => __( 'Scan posts for broken links synchronously (no AJAX batches).', 'blaminhor-essentials' ),
		'example'     => 'wp blaminhor broken-links scan --limit=10 --dry-run',
	),
	array(
		'name'        => 'wp blaminhor broken-links re-check',
		'description' => __( 'Re-check a single stored broken-link entry.', 'blaminhor-essentials' ),
		'example'     => 'wp blaminhor broken-links re-check 42',
	),
	array(
		'name'        => 'wp blaminhor broken-links export',
		'description' => __( 'Dump every stored broken-link entry as CSV or JSON on STDOUT.', 'blaminhor-essentials' ),
		'example'     => 'wp blaminhor broken-links export > broken.csv',
	),
);
