cli/add(refactor): Make repository path the sole positional

why: CLI accepted name+URL combinations that bypassed the path-first flow, leaving repos under './' and skipping confirmations.

what:
- replace the positional name/url pair with a single repo_path argument plus optional --url/--name overrides
- default workspace detection to the directory parent and contract saved config paths with contract_user_home

Author: tony

src/vcspull/cli/add.py

@@ -37,22 +37,22 @@ def create_add_subparser(parser: argparse.ArgumentParser) -> None:
         The parser to configure
     """
     parser.add_argument(
-        "target",
+        "repo_path",
         help=(
-            "Repository name (when providing a URL) or filesystem path to an "
-            "existing project"
+            "Filesystem path to an existing project. The parent directory "
+            "becomes the workspace unless overridden with --workspace."
         ),
     )
-    parser.add_argument(
-        "url",
-        nargs="?",
-        help="Repository URL when explicitly specifying the name",
-    )
     parser.add_argument(
         "--name",
         dest="override_name",
         help="Override detected repository name when importing from a path",
     )
+    parser.add_argument(
+        "--url",
+        dest="url",
+        help="Repository URL to record (overrides detected remotes)",
+    )
     parser.add_argument(
         "-f",
         "--file",
@@ -67,8 +67,8 @@ def create_add_subparser(parser: argparse.ArgumentParser) -> None:
         dest="workspace_root_path",
         metavar="DIR",
         help=(
-            "Workspace root directory in config (e.g., '~/projects/'). "
-            "If not specified, will be inferred from --path or use current directory."
+            "Workspace root directory in config (e.g., '~/projects/'). Defaults "
+            "to the parent directory of the repository path."
         ),
     )
     parser.add_argument(
@@ -322,7 +322,7 @@ def add_repo(
             config_file_path = pathlib.Path.cwd() / ".vcspull.yaml"
             log.info(
                 "No config specified and no default found, will create at %s",
-                config_file_path,
+                contract_user_home(config_file_path),
             )
         elif len(home_configs) > 1:
             log.error(
@@ -335,6 +335,8 @@ def add_repo(
     # Load existing config
     raw_config: dict[str, t.Any]
     duplicate_root_occurrences: dict[str, list[t.Any]]
+    display_config_path = contract_user_home(config_file_path)
+
     if config_file_path.exists() and config_file_path.is_file():
         try:
             (
@@ -494,7 +496,7 @@ def add_repo(
                     Fore.YELLOW,
                     Style.RESET_ALL,
                     Fore.BLUE,
-                    config_file_path,
+                    display_config_path,
                     Style.RESET_ALL,
                 )
             else:
@@ -505,7 +507,7 @@ def add_repo(
                         Fore.GREEN,
                         Style.RESET_ALL,
                         Fore.BLUE,
-                        config_file_path,
+                        display_config_path,
                         Style.RESET_ALL,
                     )
                 except Exception:
@@ -530,7 +532,7 @@ def add_repo(
             url,
             Style.RESET_ALL,
             Fore.BLUE,
-            config_file_path,
+            display_config_path,
             Style.RESET_ALL,
             Fore.MAGENTA,
             workspace_label,
@@ -550,7 +552,7 @@ def add_repo(
                 url,
                 Style.RESET_ALL,
                 Fore.BLUE,
-                config_file_path,
+                display_config_path,
                 Style.RESET_ALL,
                 Fore.MAGENTA,
                 workspace_label,