Tighten workspace path handle docs

Author: chubes4

inc/Abilities/WorkspaceAbilities.php

@@ -79,14 +79,14 @@ private function registerAbilities(): void {
 				'datamachine-code/workspace-path',
 				array(
 					'label'               => 'Get Workspace Path',
-					'description'         => 'Get the agent workspace directory path, or the path for a workspace repository handle. Optionally create the workspace root directory.',
+					'description'         => 'Get the agent workspace root path, or the path for a workspace repository handle.',
 					'category'            => 'datamachine-code-workspace',
 					'input_schema'        => array(
 						'type'       => 'object',
 						'properties' => array(
 							'name'   => array(
 								'type'        => 'string',
-								'description' => 'Optional workspace repository handle. Accepts either <repo> for a primary checkout or <repo>@<branch-slug> for a worktree.',
+								'description' => 'Optional primary or worktree handle, such as <repo> or <repo>@<branch-slug>.',
 							),
 							'ensure' => array(
 								'type'        => 'boolean',

inc/Cli/Commands/WorkspaceCommand.php

@@ -46,7 +46,7 @@ class WorkspaceCommand extends BaseCommand {
 	 * ## OPTIONS
 	 *
 	 * [<name>]
-	 * : Optional repository handle. Accepts either <repo> for a primary checkout or <repo>@<branch-slug> for a worktree.
+	 * : Optional primary or worktree handle, such as <repo> or <repo>@<branch-slug>.
 	 *
 	 * [--ensure]
 	 * : Create the directory if it doesn't exist.

inc/Tools/WorkspaceTools.php

@@ -996,7 +996,7 @@ public function getPathDefinition(): array
             'properties' => array(
             'name'   => array(
             'type'        => 'string',
-            'description' => 'Optional workspace repository handle. Accepts either <repo> for a primary checkout or <repo>@<branch-slug> for a worktree.',
+            'description' => 'Optional primary or worktree handle, such as <repo> or <repo>@<branch-slug>.',
                     ),
             'ensure' => array(
             'type'        => 'boolean',

tests/smoke-workspace-path-cli.php

@@ -40,7 +40,7 @@ public static function warning( string $message ): void
         }
     }
 
-    function is_wp_error( $value ): bool
+    function is_wp_error( $_value ): bool
     {
         return false;
     }