fix: address code review feedback on scope implementation

Co-authored-by: sergio-sisternes-epam <207026618+sergio-sisternes-epam@users.noreply.github.com>
Agent-Logs-Url: https://github.com/microsoft/apm/sessions/b5b08e0d-ae11-469c-b041-1397894f0e20

Author: Copilot

docs/src/content/docs/guides/scoped-installation.md

@@ -19,7 +19,7 @@ apm install microsoft/apm-sample-package
 - Lockfile: `./apm.lock.yaml`
 - Deployed primitives: `./.github/`, `./.claude/`, `./.cursor/`, `./.opencode/`
 
-This is the standard behavior -- every collaborator who clones the repo gets the same setup.
+This is the standard behavior. Every collaborator who clones the repo gets the same setup.
 
 ## User scope (`--global`)
 

src/apm_cli/commands/install.py

@@ -567,7 +567,7 @@ def install(ctx, packages, runtime, exclude, only, update, dry_run, force, verbo
         # Auto-bootstrap: create minimal apm.yml when packages specified but no apm.yml
         if not apm_yml_exists and packages:
             # Get current directory name as project name
-            project_name = Path.cwd().name if scope is InstallScope.PROJECT else "user"
+            project_name = Path.cwd().name if scope is InstallScope.PROJECT else Path.home().name
             config = _get_default_config(project_name)
             _create_minimal_apm_yml(config, target_path=manifest_path)
             logger.success(f"Created {manifest_display}")

src/apm_cli/core/scope.py

@@ -105,6 +105,11 @@ def ensure_user_dirs() -> Path:
 
 # ---------------------------------------------------------------------------
 # Per-target user-level support information
+#
+# Registry used by downstream tooling (e.g. ``apm config``, diagnostics)
+# to report which targets support user-scope deployment and where files
+# will land.  Not consumed directly by ``install`` / ``uninstall`` today,
+# but keeps target metadata co-located with scope logic.
 # ---------------------------------------------------------------------------
 
 USER_SCOPE_TARGETS: Dict[str, Dict[str, object]] = {

tests/unit/test_install_command.py

@@ -640,14 +640,17 @@ def test_global_flag_shows_scope_info(self):
                 os.chdir(self.original_dir)
 
     def test_global_short_flag_g(self):
-        """-g short flag should work the same as --global."""
+        """-g short flag creates user dirs and shows scope info like --global."""
         with tempfile.TemporaryDirectory() as tmp_dir:
             try:
                 os.chdir(tmp_dir)
                 fake_home = Path(tmp_dir) / "fakehome"
                 fake_home.mkdir()
                 with patch.object(Path, "home", return_value=fake_home):
                     result = self.runner.invoke(cli, ["install", "-g"])
+                # Should create ~/.apm/ directory
+                assert (fake_home / ".apm").is_dir()
+                assert (fake_home / ".apm" / "apm_modules").is_dir()
                 assert "user scope" in result.output.lower() or "~/.apm/" in result.output
             finally:
                 os.chdir(self.original_dir)