Add --site-path filter to wp site list to avoid conflict with global --path (#595)

* Initial plan

* Fix wp site list path filter conflict by adding --site-path parameter

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

* Restore path in site_cols for WP_CLI_STRICT_ARGS_MODE compatibility

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

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>
Co-authored-by: Pascal Birchler <pascalb@google.com>

Author: Copilot

features/site.feature

@@ -98,6 +98,12 @@ Feature: Manage sites in a multisite installation
       {SCHEME}://example.com/first/
       """
 
+    When I run `wp site list --field=url --site-path=/first/`
+    Then STDOUT should be:
+      """
+      {SCHEME}://example.com/first/
+      """
+
   Scenario: Filter site list by user
     Given a WP multisite install
 

src/Site_Command.php

@@ -962,13 +962,18 @@ private function get_network( $network_id ) {
 	 * [--<field>=<value>]
 	 * : Filter by one or more fields (see "Available Fields" section). However,
 	 * 'url' isn't an available filter, as it comes from 'home' in wp_options.
+	 * Note: '--path' conflicts with the global parameter of the same name; use
+	 * '--site-path' to filter by path instead.
 	 *
 	 * [--site__in=<value>]
 	 * : Only list the sites with these blog_id values (comma-separated).
 	 *
 	 * [--site_user=<value>]
 	 * : Only list the sites with this user.
 	 *
+	 * [--site-path=<path>]
+	 * : Filter by path. Avoids conflict with the global `--path` parameter.
+	 *
 	 * [--field=<field>]
 	 * : Prints the value of a single field for each site.
 	 *
@@ -1045,6 +1050,10 @@ public function list_( $args, $assoc_args ) {
 			}
 		}
 
+		if ( isset( $assoc_args['site-path'] ) ) {
+			$where['path'] = $assoc_args['site-path'];
+		}
+
 		if ( isset( $assoc_args['site__in'] ) ) {
 			$where['blog_id'] = explode( ',', $assoc_args['site__in'] );
 			$append           = 'ORDER BY FIELD( blog_id, ' . implode( ',', array_map( 'intval', $where['blog_id'] ) ) . ' )';