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

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.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

@@ -961,14 +961,19 @@ 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.
+	 * 'url' isn't an available filter, as it comes from 'home' in wp_options,
+	 * and 'path' isn't an available filter, as it conflicts with the global
+	 * `--path` parameter. 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.
 	 *
@@ -1038,13 +1043,17 @@ public function list_( $args, $assoc_args ) {
 		$where  = [];
 		$append = '';
 
-		$site_cols = [ 'blog_id', 'last_updated', 'registered', 'site_id', 'domain', 'path', 'public', 'archived', 'mature', 'spam', 'deleted', 'lang_id' ];
+		$site_cols = [ 'blog_id', 'last_updated', 'registered', 'site_id', 'domain', 'public', 'archived', 'mature', 'spam', 'deleted', 'lang_id' ];
 		foreach ( $site_cols as $col ) {
 			if ( isset( $assoc_args[ $col ] ) ) {
 				$where[ $col ] = $assoc_args[ $col ];
 			}
 		}
 
+		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'] ) ) . ' )';