path-link 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

{project_paths → path_link}/__init__.py

@@ -1,12 +1,12 @@
 """
-ptool-serena: Type-safe path configuration for Python projects
+path-link: Type-safe path configuration for Python projects
 
 A powerful library for managing project paths with built-in validation,
 static model generation, and comprehensive security features.
 
 Quick Start
 -----------
-    >>> from project_paths import ProjectPaths
+    >>> from path_link import ProjectPaths
     >>>
     >>> # Load paths from pyproject.toml
     >>> paths = ProjectPaths.from_pyproject()
@@ -28,7 +28,7 @@ Documentation Access (Offline)
 -------------------------------
 Access comprehensive documentation programmatically, even in airgapped environments:
 
-    >>> from project_paths import get_ai_guidelines, get_developer_guide, get_metadata
+    >>> from path_link import get_ai_guidelines, get_developer_guide, get_metadata
     >>> import json
     >>>
     >>> # Get AI assistant usage patterns and best practices
@@ -45,7 +45,7 @@ Access comprehensive documentation programmatically, even in airgapped environme
 
 Validation Example
 ------------------
-    >>> from project_paths import validate_or_raise, StrictPathValidator
+    >>> from path_link import validate_or_raise, StrictPathValidator
     >>>
     >>> paths = ProjectPaths.from_pyproject()
     >>> validator = StrictPathValidator(
@@ -75,14 +75,14 @@ See Also
 - AI guidelines: get_ai_guidelines()
 - Developer guide: get_developer_guide()
 - Package metadata: get_metadata()
-- GitHub: https://github.com/yourusername/ptool-serena
+- GitHub: https://github.com/yourusername/path-link
 """
 
 from importlib.resources import files
 
-from .model import ProjectPaths
-from .get_paths import write_dataclass_file
-from .validation import (
+from path_link.model import ProjectPaths
+from path_link.get_paths import write_dataclass_file
+from path_link.validation import (
     Severity,
     Finding,
     ValidationResult,
@@ -91,15 +91,18 @@ from .validation import (
     validate_or_raise,
     CompositeValidator,
 )
-from .builtin_validators.strict import StrictPathValidator
-from .builtin_validators.sandbox import SandboxPathValidator
+from path_link.builtin_validators.strict import StrictPathValidator
+from path_link.builtin_validators.sandbox import SandboxPathValidator
+from path_link.url_factory import ProjectUrls
+from path_link.url_model import ValidationMode
+from path_link.url_static import write_url_dataclass_file
 
 
 def get_ai_guidelines() -> str:
     """
     Return AI assistant guidelines for working with this package.
 
-    This provides comprehensive guidance for AI agents helping users with ptool-serena,
+    This provides comprehensive guidance for AI agents helping users with path-link,
     including usage patterns, critical rules, validation patterns, and troubleshooting.
 
     Returns:
@@ -109,7 +112,7 @@ def get_ai_guidelines() -> str:
         >>> guidelines = get_ai_guidelines()
         >>> print(guidelines[:100])
     """
-    return files("project_paths.docs").joinpath("ai_guidelines.md").read_text()
+    return files("path_link.docs").joinpath("ai_guidelines.md").read_text()
 
 
 def get_developer_guide() -> str:
@@ -117,7 +120,7 @@ def get_developer_guide() -> str:
     Return developer guide for contributing to this package.
 
     This provides architecture details, development setup, testing patterns,
-    and contribution guidelines for developers working on ptool-serena.
+    and contribution guidelines for developers working on path-link.
 
     Returns:
         str: Full content of developer guide (formerly CLAUDE.md)
@@ -126,7 +129,7 @@ def get_developer_guide() -> str:
         >>> guide = get_developer_guide()
         >>> print(guide[:100])
     """
-    return files("project_paths.docs").joinpath("developer_guide.md").read_text()
+    return files("path_link.docs").joinpath("developer_guide.md").read_text()
 
 
 def get_metadata() -> str:
@@ -144,7 +147,7 @@ def get_metadata() -> str:
         >>> metadata = json.loads(get_metadata())
         >>> print(metadata['version'])
     """
-    return files("project_paths.docs").joinpath("metadata.json").read_text()
+    return files("path_link.docs").joinpath("metadata.json").read_text()
 
 
 __all__ = [
@@ -159,6 +162,9 @@ __all__ = [
     "CompositeValidator",
     "StrictPathValidator",
     "SandboxPathValidator",
+    "ProjectUrls",
+    "ValidationMode",
+    "write_url_dataclass_file",
     "get_ai_guidelines",
     "get_developer_guide",
     "get_metadata",

{project_paths → path_link}/builder.py

@@ -17,7 +17,7 @@ def get_paths_from_pyproject() -> Dict[str, str]:
     with pyproject_path.open("rb") as f:
         pyproject_data = toml_load(f)
 
-    tool_config = pyproject_data.get("tool", {}).get("project_paths", {})
+    tool_config = pyproject_data.get("tool", {}).get("path_link", {})
     if not tool_config:
         return {}
 
@@ -82,3 +82,65 @@ def build_field_definitions(
             )
 
     return fields
+
+
+def get_urls_from_pyproject() -> Dict[str, str]:
+    """Load URL variables from pyproject.toml [tool.path_link.urls] section."""
+    pyproject_path = Path.cwd() / "pyproject.toml"
+    if not pyproject_path.is_file():
+        return {}
+
+    with pyproject_path.open("rb") as f:
+        pyproject_data = toml_load(f)
+
+    tool_config = pyproject_data.get("tool", {}).get("path_link", {})
+    if not tool_config:
+        return {}
+
+    urls = tool_config.get("urls", {})
+
+    if not isinstance(urls, dict):
+        raise TypeError("`urls` must be a table in pyproject.toml")
+
+    return urls
+
+
+def get_urls_from_dot_urls(path_to_config: Path) -> Dict[str, str]:
+    """Load URL variables from a .urls file (dotenv format)."""
+    if not path_to_config.is_file():
+        raise FileNotFoundError(f"Configuration file not found: {path_to_config}")
+
+    values = dotenv_values(path_to_config)
+
+    # Filter out None values which can occur with empty lines
+    return {k: v for k, v in values.items() if v is not None}
+
+
+def get_urls_merged(dotenv_path: Optional[Path] = None) -> Dict[str, str]:
+    """
+    Load URLs from both pyproject.toml and .urls file with defined precedence.
+
+    Precedence: pyproject.toml > .urls file
+    Missing keys are merged; duplicates resolved by pyproject.toml.
+
+    Args:
+        dotenv_path: Optional path to .urls file (default: ./.urls)
+
+    Returns:
+        Merged dictionary of URL key-value pairs
+    """
+    # Start with dotenv values (lower priority)
+    urls = {}
+
+    # Load from .urls file if it exists
+    if dotenv_path is None:
+        dotenv_path = Path.cwd() / ".urls"
+
+    if dotenv_path.is_file():
+        urls = get_urls_from_dot_urls(dotenv_path)
+
+    # Override with pyproject.toml values (higher priority)
+    pyproject_urls = get_urls_from_pyproject()
+    urls.update(pyproject_urls)
+
+    return urls

path_link/builtin_validators/__init__.py

@@ -0,0 +1,6 @@
+"""Built-in validators for common validation scenarios."""
+
+from path_link.builtin_validators.strict import StrictPathValidator
+from path_link.builtin_validators.sandbox import SandboxPathValidator
+
+__all__ = ["StrictPathValidator", "SandboxPathValidator"]

{project_paths → path_link}/builtin_validators/sandbox.py

@@ -3,10 +3,10 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import Iterable, TYPE_CHECKING
 
-from ..validation import Finding, Severity, ValidationResult
+from path_link.validation import Finding, Severity, ValidationResult
 
 if TYPE_CHECKING:
-    from ..model import _ProjectPathsBase
+    from path_link.model import _ProjectPathsBase
 
 
 @dataclass

{project_paths → path_link}/builtin_validators/strict.py

@@ -3,10 +3,10 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import Iterable, TYPE_CHECKING
 
-from ..validation import Finding, Severity, ValidationResult
+from path_link.validation import Finding, Severity, ValidationResult
 
 if TYPE_CHECKING:
-    from ..model import _ProjectPathsBase
+    from path_link.model import _ProjectPathsBase
 
 
 @dataclass

{project_paths → path_link}/cli.py

@@ -1,4 +1,4 @@
-"""Command-line interface for ptool-serena.
+"""Command-line interface for path-link.
 
 Provides three commands:
 1. print - Print resolved paths as JSON
@@ -12,9 +12,12 @@ import sys
 from pathlib import Path
 from typing import NoReturn
 
-from project_paths import ProjectPaths, write_dataclass_file, validate_or_raise
-from project_paths.builtin_validators import StrictPathValidator
-from project_paths.validation import PathValidationError
+from path_link import ProjectPaths, write_dataclass_file, validate_or_raise
+from path_link.builtin_validators import StrictPathValidator
+from path_link.validation import PathValidationError
+from path_link.url_factory import ProjectUrls
+from path_link.url_model import ValidationMode
+from path_link.url_static import write_url_dataclass_file
 
 
 def cmd_print(args: argparse.Namespace) -> int:
@@ -126,10 +129,97 @@ def cmd_gen_static(args: argparse.Namespace) -> int:
         return 1
 
 
+def cmd_print_urls(args: argparse.Namespace) -> int:
+    """Print resolved URLs as JSON."""
+    try:
+        # Determine validation mode
+        mode = ValidationMode(args.mode.lower()) if hasattr(args, "mode") and args.mode else ValidationMode.LENIENT
+
+        # Load URLs based on source
+        if args.src == "pyproject":
+            urls = ProjectUrls.from_pyproject(mode=mode)
+        elif args.src == "dotenv":
+            config_file = args.config if hasattr(args, "config") and args.config else ".urls"
+            urls = ProjectUrls.from_config(config_file, mode=mode)
+        elif args.src == "all":
+            urls = ProjectUrls.from_merged(mode=mode)
+        else:
+            print(f"Unknown source: {args.src}", file=sys.stderr)
+            return 1
+
+        # Convert URLs to dict
+        urls_dict = urls.to_dict()
+
+        # Output based on format
+        if args.format == "json":
+            print(json.dumps(urls_dict, indent=2))
+        else:  # table format
+            print(f"URLs (mode: {mode.value}, source: {args.src}):")
+            for key, value in sorted(urls_dict.items()):
+                print(f"  {key}: {value}")
+
+        return 0
+
+    except Exception as e:
+        print(f"Error loading URLs: {e}", file=sys.stderr)
+        return 1
+
+
+def cmd_validate_urls(args: argparse.Namespace) -> int:
+    """Validate URLs and report results."""
+    try:
+        # Determine validation mode
+        mode = ValidationMode(args.mode.lower()) if hasattr(args, "mode") and args.mode else ValidationMode.LENIENT
+
+        # Load URLs based on source
+        if args.src == "pyproject":
+            urls = ProjectUrls.from_pyproject(mode=mode)
+        elif args.src == "dotenv":
+            config_file = args.config if hasattr(args, "config") and args.config else ".urls"
+            urls = ProjectUrls.from_config(config_file, mode=mode)
+        elif args.src == "all":
+            urls = ProjectUrls.from_merged(mode=mode)
+        else:
+            print(f"Unknown source: {args.src}", file=sys.stderr)
+            return 1
+
+        # If we got here, all URLs are valid
+        urls_dict = urls.to_dict()
+        print(f"✅ All {len(urls_dict)} URLs valid (mode: {mode.value})")
+        return 0
+
+    except Exception as e:
+        print(f"❌ URL validation failed: {e}", file=sys.stderr)
+        return 1
+
+
+def cmd_gen_static_urls(args: argparse.Namespace) -> int:
+    """Generate static URL dataclass file."""
+    try:
+        # Determine validation mode
+        mode = ValidationMode(args.mode.lower()) if hasattr(args, "mode") and args.mode else ValidationMode.LENIENT
+
+        # Determine output path
+        output_path = Path(args.output) if hasattr(args, "output") and args.output else None
+
+        # Generate static model
+        if output_path:
+            print(f"Generating static URL model at: {output_path} (mode: {mode.value})")
+        else:
+            print(f"Generating static URL model at default location (mode: {mode.value})")
+
+        write_url_dataclass_file(output_path=output_path, mode=mode)
+        return 0
+
+    except Exception as e:
+        print(f"Error generating static URL model: {e}", file=sys.stderr)
+        return 1
+
+
 def main() -> NoReturn:
     """Main entry point for ptool CLI."""
     parser = argparse.ArgumentParser(
-        prog="ptool", description="Type-safe project path management tool"
+        prog="pathlink", description="Type-safe project path management tool"
     )
 
     subparsers = parser.add_subparsers(dest="command", help="Available commands")
@@ -181,6 +271,66 @@ def main() -> NoReturn:
         help="Output path for static model (default: src/project_paths/project_paths_static.py)",
     )
 
+    # print-urls command
+    print_urls_parser = subparsers.add_parser("print-urls", help="Print resolved URLs")
+    print_urls_parser.add_argument(
+        "--mode",
+        choices=["lenient", "strict"],
+        default="lenient",
+        help="Validation mode (default: lenient)",
+    )
+    print_urls_parser.add_argument(
+        "--format",
+        choices=["json", "table"],
+        default="json",
+        help="Output format (default: json)",
+    )
+    print_urls_parser.add_argument(
+        "--src",
+        choices=["pyproject", "dotenv", "all"],
+        default="all",
+        help="URL source (default: all - merged from both sources)",
+    )
+    print_urls_parser.add_argument(
+        "--config", type=str, help="Path to .urls config file (default: .urls)"
+    )
+
+    # validate-urls command
+    validate_urls_parser = subparsers.add_parser(
+        "validate-urls", help="Validate URLs and report results"
+    )
+    validate_urls_parser.add_argument(
+        "--mode",
+        choices=["lenient", "strict"],
+        default="lenient",
+        help="Validation mode (default: lenient)",
+    )
+    validate_urls_parser.add_argument(
+        "--src",
+        choices=["pyproject", "dotenv", "all"],
+        default="all",
+        help="URL source (default: all - merged from both sources)",
+    )
+    validate_urls_parser.add_argument(
+        "--config", type=str, help="Path to .urls config file (default: .urls)"
+    )
+
+    # gen-static-urls command
+    gen_static_urls_parser = subparsers.add_parser(
+        "gen-static-urls", help="Generate static URL dataclass file"
+    )
+    gen_static_urls_parser.add_argument(
+        "--mode",
+        choices=["lenient", "strict"],
+        default="lenient",
+        help="Validation mode (default: lenient)",
+    )
+    gen_static_urls_parser.add_argument(
+        "--output",
+        type=str,
+        help="Output path for static model (default: src/project_paths/project_urls_static.py)",
+    )
+
     args = parser.parse_args()
 
     # Dispatch to appropriate command handler
@@ -190,6 +340,12 @@ def main() -> NoReturn:
         exit_code = cmd_validate(args)
     elif args.command == "gen-static":
         exit_code = cmd_gen_static(args)
+    elif args.command == "print-urls":
+        exit_code = cmd_print_urls(args)
+    elif args.command == "validate-urls":
+        exit_code = cmd_validate_urls(args)
+    elif args.command == "gen-static-urls":
+        exit_code = cmd_gen_static_urls(args)
     else:
         parser.print_help()
         exit_code = 1

{project_paths → path_link}/docs/ai_guidelines.md

@@ -1,4 +1,4 @@
-# Assistant Context — ptool-serena v0.2.0
+# Assistant Context — path-link v0.2.0
 
 **Last Updated:** 2025-10-10
 **Status:** Active (Production)
@@ -8,10 +8,10 @@
 
 ## Overview
 
-`ptool-serena` is a Python library for type-safe project path management using Pydantic models.
+`path-link` is a Python library for type-safe project path management using Pydantic models.
 
 **Key Facts:**
-- **Package:** `ptool-serena` → imports as `project_paths`
+- **Package:** `path-link` → imports as `project_paths`
 - **Pattern:** Dynamic Pydantic model creation via factory methods (v2 API)
 - **Tool:** `uv` for dependency management
 - **Python:** 3.11+
@@ -33,13 +33,13 @@
 uv pip install -e ".[test]"
 
 # One-liner smoke test (verify installation)
-uv run python -c "from project_paths import ProjectPaths; p=ProjectPaths.from_pyproject(); print('✅ OK:', len(p.to_dict()), 'paths loaded')"
+uv run python -c "from path_link import ProjectPaths; p=ProjectPaths.from_pyproject(); print('✅ OK:', len(p.to_dict()), 'paths loaded')"
 ```
 
 ### 2. Basic Usage
 
 ```python
-from project_paths import ProjectPaths
+from path_link import ProjectPaths
 
 # ✅ CORRECT: Use factory methods
 paths = ProjectPaths.from_pyproject()         # Load from pyproject.toml
@@ -69,17 +69,17 @@ uv run pytest tests/test_validators.py          # Specific file
 | Purpose | Command |
 |---------|---------|
 | **Install** | `uv pip install -e ".[test]"` |
-| **Smoke test** | `uv run python -c "from project_paths import ProjectPaths; p=ProjectPaths.from_pyproject(); print('✅ OK:', len(p.to_dict()))"` |
+| **Smoke test** | `uv run python -c "from path_link import ProjectPaths; p=ProjectPaths.from_pyproject(); print('✅ OK:', len(p.to_dict()))"` |
 | **Run all tests** | `uv run pytest` |
 | **Coverage check** | `uv run pytest --cov=src --cov-report=term-missing:skip-covered` |
 | **Type check** | `uv run mypy src/` |
 | **Lint** | `uv run ruff check .` |
 | **Format** | `uv run ruff format .` |
-| **Regenerate static model** | `uv run python -c "from project_paths import write_dataclass_file; write_dataclass_file()"` |
+| **Regenerate static model** | `uv run python -c "from path_link import write_dataclass_file; write_dataclass_file()"` |
 | **Verify static sync** | `git diff --exit-code src/project_paths/project_paths_static.py` |
-| **Access AI guidelines** | `uv run python -c "from project_paths import get_ai_guidelines; print(get_ai_guidelines()[:200])"` |
-| **Access dev guide** | `uv run python -c "from project_paths import get_developer_guide; print(get_developer_guide()[:200])"` |
-| **Access metadata** | `uv run python -c "import json; from project_paths import get_metadata; print(json.loads(get_metadata())['version'])"` |
+| **Access AI guidelines** | `uv run python -c "from path_link import get_ai_guidelines; print(get_ai_guidelines()[:200])"` |
+| **Access dev guide** | `uv run python -c "from path_link import get_developer_guide; print(get_developer_guide()[:200])"` |
+| **Access metadata** | `uv run python -c "import json; from path_link import get_metadata; print(json.loads(get_metadata())['version'])"` |
 | **Run example** | `uv run python examples/minimal_project/src/main.py` |
 
 ---
@@ -103,8 +103,8 @@ uv run pytest tests/test_validators.py          # Specific file
 
 - **Validate paths:**
   ```python
-  from project_paths import validate_or_raise
-  from project_paths.builtin_validators import StrictPathValidator
+  from path_link import validate_or_raise
+  from path_link.builtin_validators import StrictPathValidator
 
   validator = StrictPathValidator(
       required=["config_dir", "data_dir"],
@@ -157,11 +157,11 @@ paths = ProjectPaths()  # Raises NotImplementedError by design
 
 ## Static Model Sync
 
-**When to regenerate:** After any change to `[tool.project_paths]` in `pyproject.toml`
+**When to regenerate:** After any change to `[tool.path_link]` in `pyproject.toml`
 
 ```bash
 # 1. Regenerate static model
-uv run python -c "from project_paths import write_dataclass_file; write_dataclass_file()"
+uv run python -c "from path_link import write_dataclass_file; write_dataclass_file()"
 
 # 2. Verify no drift (CI check)
 git diff --exit-code src/project_paths/project_paths_static.py || \
@@ -212,7 +212,7 @@ except FileExistsError:
 **`StrictPathValidator(allow_symlinks=False)` blocks both live and dangling symlinks by default.**
 
 ```python
-from project_paths.builtin_validators import StrictPathValidator
+from path_link.builtin_validators import StrictPathValidator
 
 # Blocks symlinks (default behavior)
 validator = StrictPathValidator(
@@ -239,14 +239,14 @@ validator_permissive = StrictPathValidator(
 ### Basic Validation
 
 ```python
-from project_paths import (
+from path_link import (
     ProjectPaths,
     validate_or_raise,
     ValidationResult,
     Finding,
     Severity
 )
-from project_paths.builtin_validators import StrictPathValidator
+from path_link.builtin_validators import StrictPathValidator
 
 # Load paths
 paths = ProjectPaths.from_pyproject()
@@ -289,7 +289,7 @@ else:
 
 ```python
 from dataclasses import dataclass
-from project_paths import ValidationResult, Finding, Severity
+from path_link import ValidationResult, Finding, Severity
 
 @dataclass
 class MyValidator:
@@ -325,7 +325,7 @@ validate_or_raise(paths, validator)
 The package includes three functions to access documentation programmatically, even in airgapped or offline environments. This is especially useful for AI assistants helping users with the package.
 
 ```python
-from project_paths import get_ai_guidelines, get_developer_guide, get_metadata
+from path_link import get_ai_guidelines, get_developer_guide, get_metadata
 import json
 
 # Get AI assistant guidelines (this file - comprehensive usage patterns)
@@ -363,13 +363,13 @@ print(f"CLI Commands: {len(metadata['cli_commands'])} available")
 uv run python -c "import sys; print(sys.version)"
 
 # 2. Verify editable install
-uv pip list | grep ptool-serena  # Should show editable install
+uv pip list | grep path-link  # Should show editable install
 
 # 3. Reinstall if needed
 uv pip install -e ".[test]"
 
 # 4. Test import
-uv run python -c "import project_paths; print('✅ Import OK')"
+uv run python -c "import path_link; print('✅ Import OK')"
 ```
 
 ### Test Failures
@@ -379,7 +379,7 @@ uv run python -c "import project_paths; print('✅ Import OK')"
 uv run pytest tests/test_static_model_equivalence.py -v
 
 # 2. If failing, regenerate static model
-uv run python -c "from project_paths import write_dataclass_file; write_dataclass_file()"
+uv run python -c "from path_link import write_dataclass_file; write_dataclass_file()"
 
 # 3. Re-run all tests
 uv run pytest -v
@@ -406,7 +406,7 @@ paths = ProjectPaths.from_pyproject()
 **Fix:**
 ```bash
 # Regenerate in current environment
-uv run python -c "from project_paths import write_dataclass_file; write_dataclass_file()"
+uv run python -c "from path_link import write_dataclass_file; write_dataclass_file()"
 
 # Verify fix
 uv run pytest tests/test_static_model_equivalence.py -v
@@ -465,7 +465,7 @@ When working with this codebase, AI assistants MUST:
 
 1. **Always use factory methods** — Never call `ProjectPaths()` directly
 2. **Keep static model in sync** — Regenerate after `pyproject.toml` changes
-3. **Follow `src` layout** — Use absolute imports: `from project_paths.model import ...`
+3. **Follow `src` layout** — Use absolute imports: `from path_link.model import ...`
 4. **Refer to this document first** — Before any path-related task
 5. **Verify changes** — Run tests after modifications: `uv run pytest`
 6. **Use atomic operations** — Follow TOCTOU prevention patterns
@@ -474,8 +474,8 @@ When working with this codebase, AI assistants MUST:
 ### Example Pattern
 
 ```python
-from project_paths import ProjectPaths, validate_or_raise
-from project_paths.builtin_validators import StrictPathValidator
+from path_link import ProjectPaths, validate_or_raise
+from path_link.builtin_validators import StrictPathValidator
 
 # 1. Load paths
 paths = ProjectPaths.from_pyproject()
@@ -517,12 +517,12 @@ except FileExistsError:
 ### pyproject.toml
 
 ```toml
-[tool.project_paths.paths]
+[tool.path_link.paths]
 config_dir = "config"
 data_dir = "data"
 logs_dir = "logs"
 
-[tool.project_paths.files]
+[tool.path_link.files]
 settings_file = "config/settings.json"
 log_file = "logs/app.log"
 ```
@@ -569,7 +569,7 @@ user_data=~/projects/${PROJECT_NAME}/data
 
 **Example pyproject.toml:**
 ```toml
-[tool.project_paths.paths]
+[tool.path_link.paths]
 data_dir = "${DATA_ROOT}/app_data"
 config_dir = "~/.config/myapp"
 ```
@@ -609,13 +609,13 @@ If you encounter issues, run these commands in order:
 uv run python -c "import sys; print('Python:', sys.version)"  # Should be 3.11+
 
 # 2. Check editable install
-uv pip list | grep ptool-serena  # Should show path with "(editable)"
+uv pip list | grep path-link  # Should show path with "(editable)"
 
 # 3. Test import
-uv run python -c "import project_paths; print('✅ Import OK')"
+uv run python -c "import path_link; print('✅ Import OK')"
 
 # 4. Run smoke test
-uv run python -c "from project_paths import ProjectPaths; p=ProjectPaths.from_pyproject(); print('✅ OK:', len(p.to_dict()), 'paths loaded')"
+uv run python -c "from path_link import ProjectPaths; p=ProjectPaths.from_pyproject(); print('✅ OK:', len(p.to_dict()), 'paths loaded')"
 
 # 5. Check config files
 ls -l pyproject.toml .paths 2>/dev/null
@@ -649,7 +649,7 @@ git diff src/project_paths/project_paths_static.py
 
 ## Summary
 
-**ptool-serena (v0.2.0)** provides type-safe, validated path management for Python projects.
+**path-link (v0.2.0)** provides type-safe, validated path management for Python projects.
 
 **Core Principles:**
 - Factory methods only (v2 API)
@@ -661,7 +661,7 @@ git diff src/project_paths/project_paths_static.py
 
 ---
 
-**Project:** ptool-serena v0.2.0
+**Project:** path-link v0.2.0
 **Python:** 3.11+
 **License:** MIT
 **Package Manager:** uv