atdd 0.3.3__py3-none-any.whl → 0.4.1__py3-none-any.whl

atdd/coach/commands/test_runner.py

@@ -1,8 +1,15 @@
 #!/usr/bin/env python3
 """
-Test runner for ATDD meta-tests.
+Validator runner for ATDD.
 
-Replaces run_all_tests.sh with a more flexible Python-based test runner.
+Executes validators from the installed atdd package against the current
+consumer repository. Validators are discovered from the package's
+planner/tester/coder/coach validator directories.
+
+Usage:
+    atdd validate                # Run all validators
+    atdd validate planner        # Run planner validators only
+    atdd validate --quick        # Quick smoke test
 """
 
 import subprocess
@@ -10,13 +17,26 @@ import sys
 from pathlib import Path
 from typing import List, Optional
 
+import atdd
+from atdd.coach.utils.repo import find_repo_root
+
+
+def _xdist_available() -> bool:
+    """Check if pytest-xdist is installed."""
+    try:
+        import xdist  # noqa: F401
+        return True
+    except ImportError:
+        return False
+
 
 class TestRunner:
-    """Run ATDD meta-tests with various configurations."""
+    """Run ATDD validators with various configurations."""
 
     def __init__(self, repo_root: Path = None):
-        self.repo_root = repo_root or Path.cwd()
-        self.atdd_dir = self.repo_root / "atdd"
+        self.repo_root = repo_root or find_repo_root()
+        # Point to the installed atdd package validators, not a local atdd/ dir
+        self.atdd_pkg_dir = Path(atdd.__file__).resolve().parent
 
     def run_tests(
         self,
@@ -28,15 +48,15 @@ class TestRunner:
         parallel: bool = True,
     ) -> int:
         """
-        Run ATDD tests with specified options.
+        Run ATDD validators with specified options.
 
         Args:
-            phase: Test phase to run (planner, tester, coder, all, None=all)
+            phase: Validator phase to run (planner, tester, coder, coach, all, None=all)
             verbose: Enable verbose output
             coverage: Generate coverage report
             html_report: Generate HTML report
             markers: Additional pytest markers to filter
-            parallel: Run tests in parallel (uses pytest-xdist)
+            parallel: Run validators in parallel (uses pytest-xdist if available)
 
         Returns:
             Exit code from pytest
@@ -44,16 +64,25 @@ class TestRunner:
         # Build pytest command
         cmd = ["pytest"]
 
-        # Determine test path
+        # Determine test path from installed package
         if phase and phase != "all":
-            test_path = self.atdd_dir / phase
+            test_path = self.atdd_pkg_dir / phase / "validators"
             if not test_path.exists():
                 print(f"❌ Error: Test phase '{phase}' not found at {test_path}")
                 return 1
             cmd.append(str(test_path))
         else:
-            # Run all atdd tests
-            cmd.append(str(self.atdd_dir))
+            # Run all validator tests from the package
+            # Include validators from all phases
+            validator_dirs = []
+            for subdir in ["planner", "tester", "coder", "coach"]:
+                validators_path = self.atdd_pkg_dir / subdir / "validators"
+                if validators_path.exists():
+                    validator_dirs.append(str(validators_path))
+            if not validator_dirs:
+                print("❌ Error: No validator directories found in atdd package")
+                return 1
+            cmd.extend(validator_dirs)
 
         # Add verbosity
         if verbose:
@@ -66,46 +95,56 @@ class TestRunner:
             for marker in markers:
                 cmd.extend(["-m", marker])
 
-        # Add coverage
+        # Add coverage (coverage reports go to consumer repo's .atdd/ dir)
         if coverage:
+            htmlcov_path = self.repo_root / ".atdd" / "htmlcov"
             cmd.extend([
                 "--cov=atdd",
                 "--cov-report=term-missing",
-                "--cov-report=html:atdd/htmlcov"
+                f"--cov-report=html:{htmlcov_path}"
             ])
 
-        # Add HTML report
+        # Add HTML report (reports go to consumer repo's .atdd/ dir)
         if html_report:
+            report_path = self.repo_root / ".atdd" / "test_report.html"
             cmd.extend([
-                "--html=atdd/test_report.html",
+                f"--html={report_path}",
                 "--self-contained-html"
             ])
 
-        # Add parallel execution
-        if parallel:
+        # Add parallel execution (only if pytest-xdist is available)
+        if parallel and _xdist_available():
             cmd.extend(["-n", "auto"])
+        elif parallel and not _xdist_available():
+            print("⚠️  pytest-xdist not installed, running validators sequentially")
 
         # Show collected tests summary
         cmd.append("--tb=short")
 
-        # Run pytest from current directory (consumer repo)
+        # Set up environment with repo root for validators
+        import os
+        env = os.environ.copy()
+        env["ATDD_REPO_ROOT"] = str(self.repo_root)
+
+        # Run pytest with consumer repo as cwd
         print(f"🧪 Running: {' '.join(cmd)}")
+        print(f"📁 Repo root: {self.repo_root}")
         print("=" * 60)
 
-        result = subprocess.run(cmd)
+        result = subprocess.run(cmd, env=env, cwd=str(self.repo_root))
         return result.returncode
 
     def run_phase(self, phase: str, **kwargs) -> int:
-        """Run tests for a specific phase."""
+        """Run validators for a specific phase."""
         return self.run_tests(phase=phase, **kwargs)
 
     def run_all(self, **kwargs) -> int:
-        """Run all ATDD meta-tests."""
+        """Run all ATDD validators."""
         return self.run_tests(phase="all", **kwargs)
 
     def quick_check(self) -> int:
-        """Quick smoke test - run without parallelization."""
-        print("🚀 Running quick check (no parallel)...")
+        """Quick smoke validation - run without parallelization."""
+        print("🚀 Running quick validation (no parallel)...")
         return self.run_tests(
             phase="all",
             verbose=False,
@@ -114,8 +153,8 @@ class TestRunner:
         )
 
     def full_suite(self) -> int:
-        """Full test suite with coverage and HTML report."""
-        print("🎯 Running full test suite...")
+        """Full validation suite with coverage and HTML report."""
+        print("🎯 Running full validation suite...")
         return self.run_tests(
             phase="all",
             verbose=True,
@@ -126,7 +165,7 @@ class TestRunner:
 
 
 def main():
-    """CLI entry point for test runner."""
+    """CLI entry point for validator runner."""
     runner = TestRunner()
 
     # Simple usage for now - can be enhanced with argparse

atdd/coach/commands/traceability.py

@@ -26,9 +26,11 @@ from typing import Dict, List, Optional, Tuple, Union
 from dataclasses import dataclass, field
 from collections import defaultdict
 
+from atdd.coach.utils.repo import find_repo_root
+
 
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+REPO_ROOT = find_repo_root()
 PLAN_DIR = REPO_ROOT / "plan"
 CONTRACTS_DIR = REPO_ROOT / "contracts"
 TELEMETRY_DIR = REPO_ROOT / "telemetry"

atdd/coach/conventions/session.convention.yaml

@@ -43,7 +43,7 @@ workflow:
         - "atdd/planner/validators/test_wagon_urn_chain.py"
         - "atdd/planner/validators/test_wmbt_consistency.py"
         - "atdd/planner/validators/test_wmbt_vocabulary.py"
-      gate_command: "python3 -m pytest atdd/planner/validators/ -v"
+      gate_command: "atdd validate planner"
       gate_expected: "PASS"
       completion_criteria:
         - "Train manifest exists and is valid"
@@ -73,7 +73,7 @@ workflow:
         - "atdd/tester/validators/test_acceptance_urn_filename_mapping.py"
         - "atdd/tester/validators/test_python_test_naming.py"
         - "atdd/tester/validators/test_typescript_test_naming.py"
-      gate_command: "python3 -m pytest atdd/tester/validators/ -v"
+      gate_command: "atdd validate tester"
       gate_expected: "PASS"
       red_phase:
         description: "Write failing tests BEFORE any implementation"
@@ -104,7 +104,7 @@ workflow:
         - "atdd/coder/validators/test_typescript_architecture.py"
         - "atdd/coder/validators/test_import_boundaries.py"
         - "atdd/coder/validators/test_wagon_boundaries.py"
-      gate_command: "python3 -m pytest atdd/coder/validators/ -v"
+      gate_command: "atdd validate coder"
       gate_expected: "PASS"
       green_phase:
         description: "Make tests pass with minimal implementation"
@@ -116,7 +116,7 @@ workflow:
         description: "Clean architecture, convention compliance"
         rule: "All coder validators must pass after GREEN"
         convention: "atdd/coder/conventions/refactor.convention.yaml"
-        gate_command: "python3 -m pytest atdd/coder/validators/ -v"
+        gate_command: "atdd validate coder"
         gate_expected: "PASS"
       completion_criteria:
         - "All acceptance tests pass"
@@ -289,7 +289,7 @@ archetypes:
       - "Application: Use cases, orchestration"
       - "Integration: Adapters, clients, repositories"
       - "Presentation: Controllers, DTOs"
-    validation: "python3 -m pytest atdd/coder/validators/test_python_architecture.py -v"
+    validation: "atdd validate coder"
 
   frontend:
     id: "fe"
@@ -315,7 +315,7 @@ archetypes:
       - "Schema-first design"
       - "Version in filename if breaking changes"
       - "Shared via contracts/ directory"
-    validation: "python3 -m pytest atdd/tester/validators/test_contract_*.py -v"
+    validation: "atdd validate tester"
 
   wmbt:
     id: "wmbt"
@@ -326,7 +326,7 @@ archetypes:
       - "URN: wmbt:{wagon}:{STEP_CODE}{NNN}"
       - "Step codes: D=define, L=locate, P=prepare, C=confirm, E=execute, M=monitor, Y=modify, R=resolve, K=conclude"
       - "Max 5 acceptances per WMBT"
-    validation: "python3 -m pytest atdd/planner/validators/test_wmbt_*.py -v"
+    validation: "atdd validate planner"
 
   wagon:
     id: "wagon"
@@ -338,7 +338,7 @@ archetypes:
       - "Manifest: plan/{wagon}/_{wagon}.yaml"
       - "Features: plan/{wagon}/features/{feature}.yaml"
       - "Registered in plan/_wagons.yaml"
-    validation: "python3 -m pytest atdd/planner/validators/test_wagon_*.py -v"
+    validation: "atdd validate planner"
 
   train:
     id: "train"
@@ -348,7 +348,7 @@ archetypes:
     patterns:
       - "Train = release with multiple wagons"
       - "Defines deployment order and dependencies"
-    validation: "python3 -m pytest atdd/planner/validators/test_train_*.py -v"
+    validation: "atdd validate planner"
 
   telemetry:
     id: "telemetry"
@@ -360,7 +360,7 @@ archetypes:
       - "Metrics: telemetry:metric:{layer}:{wagon}:{name}"
       - "Logs: Structured with URN attributes"
       - "Traces: Span context propagation"
-    validation: "python3 -m pytest atdd/tester/validators/test_telemetry_*.py -v"
+    validation: "atdd validate tester"
 
   migrations:
     id: "migrations"
@@ -503,7 +503,7 @@ sections:
             gate: "pytest {test-path} -v (expect PASS)"
           REFACTOR:
             description: "Clean architecture, 4-layer compliance"
-            gate: "pytest atdd/coder/validators/ -v"
+            gate: "atdd validate coder"
 
   validation:
     required: true
@@ -645,47 +645,47 @@ gate_tests:
     db:
       - command: "supabase db push --dry-run"
         atdd_validator: "manual"
-      - command: "python3 -m pytest atdd/tester/validators/test_migration_*.py -v"
+      - command: "atdd validate tester"
         atdd_validator: "atdd/tester/validators/test_migration_coverage.py"
 
     be:
-      - command: "python3 -m pytest atdd/coder/validators/test_python_architecture.py -v"
+      - command: "atdd validate coder"
         atdd_validator: "atdd/coder/validators/test_python_architecture.py"
-      - command: "python3 -m pytest atdd/coder/validators/test_import_boundaries.py -v"
+      - command: "atdd validate coder"
         atdd_validator: "atdd/coder/validators/test_import_boundaries.py"
 
     fe:
       - command: "cd web && npm run typecheck"
         atdd_validator: "manual"
-      - command: "python3 -m pytest atdd/coder/validators/test_typescript_architecture.py -v"
+      - command: "atdd validate coder"
         atdd_validator: "atdd/coder/validators/test_typescript_architecture.py"
 
     contracts:
-      - command: "python3 -m pytest atdd/tester/validators/test_contract_*.py -v"
+      - command: "atdd validate tester"
         atdd_validator: "atdd/tester/validators/test_contract_schema_compliance.py"
 
     wmbt:
-      - command: "python3 -m pytest atdd/planner/validators/test_wmbt_*.py -v"
+      - command: "atdd validate planner"
         atdd_validator: "atdd/planner/validators/test_wmbt_consistency.py"
 
     wagon:
-      - command: "python3 -m pytest atdd/planner/validators/test_wagon_*.py -v"
+      - command: "atdd validate planner"
         atdd_validator: "atdd/planner/validators/test_wagon_urn_chain.py"
-      - command: "python3 -m pytest atdd/coder/validators/test_wagon_boundaries.py -v"
+      - command: "atdd validate coder"
         atdd_validator: "atdd/coder/validators/test_wagon_boundaries.py"
 
     train:
-      - command: "python3 -m pytest atdd/planner/validators/test_train_*.py -v"
+      - command: "atdd validate planner"
         atdd_validator: "atdd/planner/validators/test_train_validation.py"
 
     telemetry:
-      - command: "python3 -m pytest atdd/tester/validators/test_telemetry_*.py -v"
+      - command: "atdd validate tester"
         atdd_validator: "atdd/tester/validators/test_telemetry_structure.py"
 
     migrations:
       - command: "supabase db push --dry-run"
         atdd_validator: "manual"
-      - command: "python3 -m pytest atdd/tester/validators/test_migration_*.py -v"
+      - command: "atdd validate tester"
         atdd_validator: "atdd/tester/validators/test_migration_coverage.py"
 
   # Universal gates (all sessions)
@@ -694,7 +694,7 @@ gate_tests:
       - id: "GT-001"
         phase: "design"
         archetype: "all"
-        command: "python3 -m pytest atdd/coach/validators/test_session_validation.py -v"
+        command: "atdd validate coach"
         expected: "PASS"
         atdd_validator: "atdd/coach/validators/test_session_validation.py"
         description: "Session structure compliance"
@@ -703,7 +703,7 @@ gate_tests:
       - id: "GT-900"
         phase: "completion"
         archetype: "all"
-        command: "python3 -m pytest atdd/ -v --tb=short"
+        command: "atdd validate"
         expected: "PASS"
         atdd_validator: "atdd/"
         description: "Full ATDD validator suite"
@@ -735,14 +735,14 @@ gate_tests:
       gates:
         - id: "GT-300"
           phase: "implementation"
-          command: "python3 -m pytest atdd/coder/validators/ -v"
+          command: "atdd validate coder"
           expected: "PASS"
           atdd_validator: "atdd/coder/validators/"
           description: "Architecture conventions met"
 
 # Validation
 validation:
-  command: "python3 -m pytest atdd/coach/validators/test_session_*.py -v"
+  command: "atdd validate coach"
   checks:
     - "All required sections present"
     - "Status is valid value"

atdd/coach/templates/ATDD.md

@@ -85,30 +85,30 @@ dev_servers:
 # Audits & Validation (Give context, pinpoint issues, validate compliance)
 audits:
   cli: "atdd"
-  purpose: "Meta-tests that validate ATDD artifacts against conventions"
+  purpose: "Validators that check ATDD artifacts against conventions"
 
   commands:
-    inventory: "atdd --inventory"
-    status: "atdd --status"
-    quick_check: "atdd --quick"
-    validate_all: "atdd --test all"
-    validate_planner: "atdd --test planner"
-    validate_tester: "atdd --test tester"
-    validate_coder: "atdd --test coder"
-    with_coverage: "atdd --test all --coverage"
-    with_html: "atdd --test all --html"
+    validate_all: "atdd validate"
+    validate_planner: "atdd validate planner"
+    validate_tester: "atdd validate tester"
+    validate_coder: "atdd validate coder"
+    quick_check: "atdd validate --quick"
+    with_coverage: "atdd validate --coverage"
+    with_html: "atdd validate --html"
+    inventory: "atdd inventory"
+    status: "atdd status"
 
   workflow:
-    before_init: "Run planner audits to validate plan structure"
+    before_init: "Run planner validators to check plan structure"
     after_init: "Validate wagon URNs, cross-refs, uniqueness"
-    before_planned: "Run tester audits to validate test prerequisites"
+    before_planned: "Run tester validators to check test prerequisites"
     after_planned: "Validate test naming, contracts, coverage"
     before_red: "Validate layer structure expectations"
     after_red: "Validate tests are RED and properly structured"
-    before_green: "Run coder audits for architecture readiness"
+    before_green: "Run coder validators for architecture readiness"
     after_green: "Validate layer dependencies, boundaries"
     after_refactor: "Validate architecture compliance, quality metrics"
-    continuous: "CI runs 'atdd --test all' on every commit"
+    continuous: "CI runs 'atdd validate' on every commit"
 
   audit_scope:
     planner: "src/atdd/planner/validators/*.py (wagons, trains, URNs, cross-refs, WMBT)"
@@ -291,7 +291,7 @@ sessions:
     create: "Run 'atdd session new <slug>' to create new session from template"
     fill: "Fill ALL sections - write 'N/A' if not applicable, never omit"
     track: "Update Progress Tracker and Session Log after each work item"
-    validate: "python3 -m pytest src/atdd/coach/validators/test_session_*.py -v"
+    validate: "atdd validate coach"
 
   archetypes:
     db: "Supabase PostgreSQL + JSONB"

atdd/coach/templates/SESSION-TEMPLATE.md

@@ -42,7 +42,7 @@ workflow_phases:
       wagon: false      # plan/{wagon}/_{wagon}.yaml exists
       feature: false    # plan/{wagon}/features/{feature}.yaml exists
       wmbt: false       # WMBTs defined in feature YAML
-    gate: "python3 -m pytest src/src/atdd/planner/validators/ -v"
+    gate: "atdd validate planner"
     gate_status: "TODO"
 
   tester:
@@ -51,7 +51,7 @@ workflow_phases:
     artifacts:
       contracts: false  # contracts/{domain}/{resource}.schema.json exists
       red_tests: false  # Failing tests exist for all WMBTs
-    gate: "python3 -m pytest src/src/atdd/tester/validators/ -v"
+    gate: "atdd validate tester"
     gate_status: "TODO"
     red_gate: "pytest {test_path} -v (expect FAIL)"
     red_gate_status: "TODO"
@@ -61,11 +61,11 @@ workflow_phases:
     depends_on: "tester"
     artifacts:
       implementation: false  # Code exists in {runtime}/{wagon}/{feature}/src/
-    gate: "python3 -m pytest src/atdd/coder/validators/ -v"
+    gate: "atdd validate coder"
     gate_status: "TODO"
     green_gate: "pytest {test_path} -v (expect PASS)"
     green_gate_status: "TODO"
-    refactor_gate: "python3 -m pytest src/atdd/coder/validators/ -v"
+    refactor_gate: "atdd validate coder"
     refactor_gate_status: "TODO"
 
 # Progress tracking (machine-readable)
@@ -103,7 +103,7 @@ progress:
       gate: "pytest {test-path} -v (expect PASS)"
     refactor:
       status: "TODO"
-      gate: "pytest src/atdd/coder/validators/ -v"
+      gate: "atdd validate coder"
 
 # Gate Tests - Required validation gates with ATDD validators
 # See: src/atdd/coach/conventions/session.convention.yaml for required gates per archetype
@@ -112,7 +112,7 @@ gate_tests:
   - id: "GT-001"
     phase: "design"
     archetype: "all"
-    command: "python3 -m pytest src/atdd/coach/validators/test_session_validation.py -v"
+    command: "atdd validate coach"
     expected: "PASS"
     atdd_validator: "src/atdd/coach/validators/test_session_validation.py"
     status: "TODO"
@@ -122,7 +122,7 @@ gate_tests:
   # - id: "GT-010"
   #   phase: "implementation"
   #   archetype: "be"
-  #   command: "python3 -m pytest src/atdd/coder/validators/test_python_architecture.py -v"
+  #   command: "atdd validate coder"
   #   expected: "PASS"
   #   atdd_validator: "src/atdd/coder/validators/test_python_architecture.py"
   #   status: "TODO"
@@ -131,7 +131,7 @@ gate_tests:
   # - id: "GT-020"
   #   phase: "implementation"
   #   archetype: "fe"
-  #   command: "python3 -m pytest src/atdd/coder/validators/test_typescript_architecture.py -v"
+  #   command: "atdd validate coder"
   #   expected: "PASS"
   #   atdd_validator: "src/atdd/coder/validators/test_typescript_architecture.py"
   #   status: "TODO"
@@ -140,7 +140,7 @@ gate_tests:
   - id: "GT-900"
     phase: "completion"
     archetype: "all"
-    command: "python3 -m pytest src/atdd/ -v --tb=short"
+    command: "atdd validate"
     expected: "PASS"
     atdd_validator: "src/atdd/"
     status: "TODO"
@@ -180,7 +180,7 @@ IMPLEMENTATION RULES:
 3. New files MUST match patterns of similar existing files
 4. When in doubt: find 2-3 similar files and replicate their structure
 5. NEVER introduce new patterns without explicit decision documented
-6. Validate: python3 -m pytest src/atdd/ -v --tb=short
+6. Validate: atdd validate
 -->
 
 # SESSION-{NN}: {Title}
@@ -288,9 +288,9 @@ Reference: src/atdd/coach/conventions/session.convention.yaml
 
 | ID | Phase | Archetype | Command | Expected | ATDD Validator | Status |
 |----|-------|-----------|---------|----------|----------------|--------|
-| GT-001 | design | all | `python3 -m pytest src/atdd/coach/validators/test_session_validation.py -v` | PASS | `src/atdd/coach/validators/test_session_validation.py` | TODO |
+| GT-001 | design | all | `atdd validate coach` | PASS | `src/atdd/coach/validators/test_session_validation.py` | TODO |
 | GT-010 | implementation | {archetype} | `{command}` | PASS | `{atdd_validator_path}` | TODO |
-| GT-900 | completion | all | `python3 -m pytest src/atdd/ -v --tb=short` | PASS | `src/atdd/` | TODO |
+| GT-900 | completion | all | `atdd validate` | PASS | `src/atdd/` | TODO |
 
 ### Phase Gates
 

atdd/coach/utils/repo.py

@@ -2,14 +2,19 @@
 Repository root detection utility.
 
 Finds the consumer repository root using multiple detection strategies:
-1. .atdd/manifest.yaml (preferred - explicit ATDD project marker)
-2. plan/ AND contracts/ both exist (ATDD project structure)
-3. .git/ directory (fallback - any git repo)
-4. cwd (last resort - allows commands to work on uninitialized repos)
+1. ATDD_REPO_ROOT env var (set by test runner for validators)
+2. .atdd/manifest.yaml (preferred - explicit ATDD project marker)
+3. plan/ AND contracts/ both exist (ATDD project structure)
+4. .git/ directory (fallback - any git repo)
+5. cwd (last resort - allows commands to work on uninitialized repos)
 
 This ensures ATDD commands operate on the user's repo, not the package root.
+
+For validators running from the installed package, the test runner sets
+ATDD_REPO_ROOT to point to the consumer repo being validated.
 """
 
+import os
 from functools import lru_cache
 from pathlib import Path
 from typing import Optional
@@ -21,10 +26,11 @@ def find_repo_root(start: Optional[Path] = None) -> Path:
     Find repo root by searching upward for ATDD project markers.
 
     Detection order (first match wins):
-    1. .atdd/manifest.yaml - explicit ATDD project marker
-    2. plan/ AND contracts/ both exist - ATDD project structure
-    3. .git/ directory - fallback for any git repository
-    4. cwd - last resort if no markers found
+    1. ATDD_REPO_ROOT env var - set by test runner for validators
+    2. .atdd/manifest.yaml - explicit ATDD project marker
+    3. plan/ AND contracts/ both exist - ATDD project structure
+    4. .git/ directory - fallback for any git repository
+    5. cwd - last resort if no markers found
 
     Args:
         start: Starting directory (default: cwd)
@@ -35,7 +41,17 @@ def find_repo_root(start: Optional[Path] = None) -> Path:
     Note:
         Results are cached for performance. If .atdd/manifest.yaml is not found,
         commands may operate in a degraded mode.
+
+        For validators running from installed package, ATDD_REPO_ROOT env var
+        is set by the test runner to point to the consumer repo.
     """
+    # Strategy 0: Check ATDD_REPO_ROOT env var (set by test runner)
+    env_root = os.environ.get("ATDD_REPO_ROOT")
+    if env_root:
+        env_path = Path(env_root).resolve()
+        if env_path.is_dir():
+            return env_path
+
     current = start or Path.cwd()
     current = current.resolve()