Add wp menu item add-post-type-archive command

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>

Author: Copilot

features/menu-item.feature

@@ -252,3 +252,24 @@ Feature: Manage WordPress menu items
       """
     And the return code should be 1
 
+  Scenario: Add a post type archive as a menu item
+
+    When I run `wp menu create "Archive Menu"`
+    Then STDOUT should not be empty
+
+    When I run `wp menu item add-post-type-archive archive-menu post --porcelain`
+    Then STDOUT should be a number
+    And save STDOUT as {ITEM_ID}
+
+    When I run `wp menu item list archive-menu --fields=db_id,type,object`
+    Then STDOUT should be a table containing rows:
+      | db_id     | type               | object |
+      | {ITEM_ID} | post_type_archive  | post   |
+
+    When I try `wp menu item add-post-type-archive archive-menu invalidposttype`
+    Then STDERR should be:
+      """
+      Error: Invalid post type.
+      """
+    And the return code should be 1
+

src/Menu_Item_Command.php

@@ -329,6 +329,63 @@ public function add_term( $args, $assoc_args ) {
 		$this->add_or_update_item( 'add', 'taxonomy', $args, $assoc_args );
 	}
 
+	/**
+	 * Adds a post type archive as a menu item.
+	 *
+	 * ## OPTIONS
+	 *
+	 * <menu>
+	 * : The name, slug, or term ID for the menu.
+	 *
+	 * <post-type>
+	 * : Post type slug.
+	 *
+	 * [--title=<title>]
+	 * : Set a custom title for the menu item.
+	 *
+	 * [--link=<link>]
+	 * : Set a custom url for the menu item.
+	 *
+	 * [--description=<description>]
+	 * : Set a custom description for the menu item.
+	 *
+	 * [--attr-title=<attr-title>]
+	 * : Set a custom title attribute for the menu item.
+	 *
+	 * [--target=<target>]
+	 * : Set a custom link target for the menu item.
+	 *
+	 * [--classes=<classes>]
+	 * : Set a custom link classes for the menu item.
+	 *
+	 * [--position=<position>]
+	 * : Specify the position of this menu item.
+	 *
+	 * [--parent-id=<parent-id>]
+	 * : Make this menu item a child of another menu item.
+	 *
+	 * [--porcelain]
+	 * : Output just the new menu item id.
+	 *
+	 * ## EXAMPLES
+	 *
+	 *     $ wp menu item add-post-type-archive sidebar-menu post
+	 *     Success: Menu item added.
+	 *
+	 * @subcommand add-post-type-archive
+	 */
+	public function add_post_type_archive( $args, $assoc_args ) {
+
+		$assoc_args['object'] = $args[1];
+		unset( $args[1] );
+
+		if ( ! get_post_type_object( $assoc_args['object'] ) ) {
+			WP_CLI::error( 'Invalid post type.' );
+		}
+
+		$this->add_or_update_item( 'add', 'post_type_archive', $args, $assoc_args );
+	}
+
 	/**
 	 * Adds a custom menu item.
 	 *