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

atdd/planner/validators/test_wmbt_vocabulary.py

@@ -23,11 +23,17 @@ import re
 from pathlib import Path
 from typing import Dict, List, Tuple, Set, Optional
 
+import atdd
+from atdd.coach.utils.repo import find_repo_root
 
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+# Consumer repo artifacts
+REPO_ROOT = find_repo_root()
 PLAN_DIR = REPO_ROOT / "plan"
-WMBT_CONVENTION = REPO_ROOT / "atdd" / "planner" / "conventions" / "wmbt.convention.yaml"
+
+# Package resources (conventions, schemas)
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
+WMBT_CONVENTION = ATDD_PKG_DIR / "planner" / "conventions" / "wmbt.convention.yaml"
 
 
 # Authorized vocabulary from convention

atdd/tester/conventions/contract.convention.yaml

@@ -444,7 +444,7 @@ persistence_traceability:
 
   workflow:
     1_identify_persistent_contracts:
-      command: "python atdd/coach/commands/migration.py"
+      command: "python -m atdd.coach.commands.migration"
       output: "List of contracts needing persistence"
 
     2_create_migration:

atdd/tester/conventions/migration.convention.yaml

@@ -16,7 +16,7 @@ workflow:
   automation_level: "template_generation"
   requires_human_review: true
 
-  command: "python atdd/coach/command/migration.py"
+  command: "python -m atdd.coach.commands.migration"
 
 # Table Naming Convention
 table_naming:
@@ -171,16 +171,16 @@ references:
 # Command Usage
 usage: |
   # Generate all missing migrations
-  python atdd/coach/command/migration.py
+  python -m atdd.coach.commands.migration
 
   # Generate for specific contract
-  python atdd/coach/command/migration.py --contract contracts/match/dilemma/current.schema.json
+  python -m atdd.coach.commands.migration --contract contracts/match/dilemma/current.schema.json
 
   # Validate coverage
-  python atdd/coach/command/migration.py --validate
+  python -m atdd.coach.commands.migration --validate
 
   # Check for unreviewed TODOs
-  pytest atdd/tester/test_migration_coverage.py::test_migration_templates_reviewed
+  atdd validate tester
 
 # JSONB-First Storage Strategy
 jsonb_strategy:

atdd/tester/validators/cleanup_duplicate_headers.py

@@ -9,8 +9,10 @@ and keeps only the new standardized ones.
 import re
 from pathlib import Path
 
+from atdd.coach.utils.repo import find_repo_root
 
-REPO_ROOT = Path(__file__).resolve().parents[4]
+
+REPO_ROOT = find_repo_root()
 PYTHON_DIR = REPO_ROOT / "python"
 
 

atdd/tester/validators/cleanup_duplicate_headers_v2.py

@@ -9,8 +9,10 @@ keeping only the new standardized header at the top.
 import re
 from pathlib import Path
 
+from atdd.coach.utils.repo import find_repo_root
 
-REPO_ROOT = Path(__file__).resolve().parents[4]
+
+REPO_ROOT = find_repo_root()
 PYTHON_DIR = REPO_ROOT / "python"
 
 

atdd/tester/validators/coverage_gap_report.py

@@ -17,9 +17,11 @@ from pathlib import Path
 from collections import defaultdict
 from typing import Dict, List, Set, Tuple
 
+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"
 PYTHON_DIR = REPO_ROOT / "python"
 LIB_DIR = REPO_ROOT / "lib"

atdd/tester/validators/fix_dual_ac_references.py

@@ -10,8 +10,10 @@ Fixes:
 import re
 from pathlib import Path
 
+from atdd.coach.utils.repo import find_repo_root
 
-REPO_ROOT = Path(__file__).resolve().parents[4]
+
+REPO_ROOT = find_repo_root()
 PYTHON_DIR = REPO_ROOT / "python"
 
 

atdd/tester/validators/remove_duplicate_lines.py

@@ -5,8 +5,10 @@ Simple script to remove consecutive duplicate lines in test files.
 
 from pathlib import Path
 
+from atdd.coach.utils.repo import find_repo_root
 
-REPO_ROOT = Path(__file__).resolve().parents[4]
+
+REPO_ROOT = find_repo_root()
 PYTHON_DIR = REPO_ROOT / "python"
 
 

atdd/tester/validators/test_acceptance_urn_filename_mapping.py

@@ -13,8 +13,14 @@ import re
 from pathlib import Path
 import pytest
 
+import atdd
+from atdd.coach.utils.repo import find_repo_root
 
-REPO_ROOT = Path(__file__).parent.parent.parent
+
+REPO_ROOT = find_repo_root()
+
+# Package resources
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
 
 
 # SPEC-TESTER-CONV-0069: Dart URN to filename mapping
@@ -297,8 +303,8 @@ def test_python_files_match_convention():
 
     test_dirs = [
         REPO_ROOT / "tests",
-        REPO_ROOT / "atdd" / "coach" / "validators",
-        REPO_ROOT / "atdd" / "tester" / "validators",
+        ATDD_PKG_DIR / "coach" / "validators",
+        ATDD_PKG_DIR / "tester" / "validators",
     ]
 
     violations = []

atdd/tester/validators/test_acceptance_urn_separator.py

@@ -24,10 +24,16 @@ import yaml
 import re
 from pathlib import Path
 
+import atdd
+from atdd.coach.utils.repo import find_repo_root
+
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
-CONVENTIONS_DIR = REPO_ROOT / "atdd" / "planner" / "conventions"
-SCHEMAS_DIR = REPO_ROOT / "atdd" / "planner" / "schemas"
+REPO_ROOT = find_repo_root()
+
+# Package resources (conventions, schemas)
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
+CONVENTIONS_DIR = ATDD_PKG_DIR / "planner" / "conventions"
+SCHEMAS_DIR = ATDD_PKG_DIR / "planner" / "schemas"
 
 
 # SPEC-COACH-UTILS-0282

atdd/tester/validators/test_contract_schema_compliance.py

@@ -12,11 +12,18 @@ import re
 from pathlib import Path
 from jsonschema import validate, ValidationError, Draft7Validator
 
+import atdd
+from atdd.coach.utils.repo import find_repo_root
+
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+# Consumer repo artifacts
+REPO_ROOT = find_repo_root()
 CONTRACTS_DIR = REPO_ROOT / "contracts"
 PLAN_DIR = REPO_ROOT / "plan"
-META_SCHEMA_PATH = REPO_ROOT / "atdd" / "tester" / "schemas" / "contract.schema.json"
+
+# Package resources (conventions, schemas)
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
+META_SCHEMA_PATH = ATDD_PKG_DIR / "tester" / "schemas" / "contract.schema.json"
 
 
 @pytest.fixture

atdd/tester/validators/test_contracts_structure.py

@@ -9,8 +9,10 @@ import re
 from pathlib import Path
 from typing import Optional
 
+from atdd.coach.utils.repo import find_repo_root
+
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+REPO_ROOT = find_repo_root()
 CONTRACTS_DIR = REPO_ROOT / "contracts"
 
 

atdd/tester/validators/test_coverage_adequacy.py

@@ -25,9 +25,11 @@ from typing import Dict, List, Set, Tuple, Optional
 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"
 PYTHON_DIR = REPO_ROOT / "python"
 LIB_DIR = REPO_ROOT / "lib"

atdd/tester/validators/test_dual_ac_reference.py

@@ -15,9 +15,11 @@ import pytest
 import re
 from pathlib import Path
 
+from atdd.coach.utils.repo import find_repo_root
 
-# Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+
+# Path constants - consumer repo artifacts
+REPO_ROOT = find_repo_root()
 PYTHON_DIR = REPO_ROOT / "python"
 
 
@@ -210,6 +212,8 @@ Purpose: Verify timebank decrements during active decision
 
 import pytest
 
+from atdd.coach.utils.repo import find_repo_root
+
 
 def test_e001_unit_001_timebank_decrements_during_decision():
     """Test implementation..."""

atdd/tester/validators/test_fixture_validity.py

@@ -17,9 +17,10 @@ import yaml
 from pathlib import Path
 from typing import Dict, List, Any
 
+from atdd.coach.utils.repo import find_repo_root
 
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+REPO_ROOT = find_repo_root()
 PYTHON_DIR = REPO_ROOT / "python"
 CONTRACTS_DIR = REPO_ROOT / "contracts"
 

atdd/tester/validators/test_isolation.py

@@ -17,13 +17,20 @@ import ast
 from pathlib import Path
 from typing import List, Set, Tuple
 
+import atdd
+from atdd.coach.utils.repo import find_repo_root
+
 
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+REPO_ROOT = find_repo_root()
+
+# Package resources
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
+
 TEST_DIRS = [
     REPO_ROOT / "test",
     REPO_ROOT / "tests",
-    REPO_ROOT / "atdd",
+    ATDD_PKG_DIR,  # Validators in installed package
 ]
 
 

atdd/tester/validators/test_migration_coverage.py

@@ -7,8 +7,10 @@ SPEC-TESTER-CONV-0032: Reject migrations with unresolved TODOs
 import pytest
 from pathlib import Path
 
+from atdd.coach.utils.repo import find_repo_root
+
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+REPO_ROOT = find_repo_root()
 CONTRACTS_DIR = REPO_ROOT / "contracts"
 MIGRATIONS_DIR = REPO_ROOT / "supabase" / "migrations"
 
@@ -145,7 +147,7 @@ def test_all_contracts_have_migrations():
             error_msg += f"\n  ... and {len(missing) - 20} more"
         if skipped > 0:
             error_msg += f"\n\nℹ️  Skipped {skipped} internal/transient contracts"
-        error_msg += "\n\nRun: python atdd/coach/commands/migration.py to generate"
+        error_msg += "\n\nRun: python -m atdd.coach.commands.migration to generate"
         pytest.fail(error_msg)
 
 

atdd/tester/validators/test_migration_generation.py

@@ -9,8 +9,10 @@ import json
 import tempfile
 from pathlib import Path
 
+from atdd.coach.utils.repo import find_repo_root
+
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+REPO_ROOT = find_repo_root()
 CONTRACTS_DIR = REPO_ROOT / "contracts"
 
 

atdd/tester/validators/test_python_test_naming.py

@@ -16,9 +16,11 @@ import pytest
 import re
 from pathlib import Path
 
+from atdd.coach.utils.repo import find_repo_root
+
 
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+REPO_ROOT = find_repo_root()
 PYTHON_DIR = REPO_ROOT / "python"
 
 

atdd/tester/validators/test_red_layer_validation.py

@@ -8,9 +8,14 @@ import pytest
 from pathlib import Path
 import yaml
 
+import atdd
+from atdd.coach.utils.repo import find_repo_root
 
-REPO_ROOT = Path(__file__).resolve().parents[4]
-RED_CONVENTION = REPO_ROOT / "atdd" / "tester" / "conventions" / "red.convention.yaml"
+REPO_ROOT = find_repo_root()
+
+# Package resources (conventions, schemas)
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
+RED_CONVENTION = ATDD_PKG_DIR / "tester" / "conventions" / "red.convention.yaml"
 
 
 @pytest.mark.tester

atdd/tester/validators/test_red_python_layer_structure.py

@@ -8,9 +8,14 @@ import pytest
 from pathlib import Path
 import yaml
 
+import atdd
+from atdd.coach.utils.repo import find_repo_root
 
-REPO_ROOT = Path(__file__).resolve().parents[4]
-RED_CONVENTION = REPO_ROOT / "atdd" / "tester" / "conventions" / "red.convention.yaml"
+REPO_ROOT = find_repo_root()
+
+# Package resources (conventions, schemas)
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
+RED_CONVENTION = ATDD_PKG_DIR / "tester" / "conventions" / "red.convention.yaml"
 
 
 @pytest.mark.tester

atdd/tester/validators/test_red_supabase_layer_structure.py

@@ -8,9 +8,15 @@ import pytest
 from pathlib import Path
 import yaml
 
+import atdd
+from atdd.coach.utils.repo import find_repo_root
 
-REPO_ROOT = Path(__file__).resolve().parents[4]
-RED_CONVENTION = REPO_ROOT / "atdd" / "tester" / "conventions" / "red.convention.yaml"
+
+REPO_ROOT = find_repo_root()
+
+# Package resources (conventions, schemas)
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
+RED_CONVENTION = ATDD_PKG_DIR / "tester" / "conventions" / "red.convention.yaml"
 
 
 @pytest.mark.tester

atdd/tester/validators/test_telemetry_structure.py

@@ -10,12 +10,19 @@ import re
 import json
 from jsonschema import validate, ValidationError
 
+import atdd
+from atdd.coach.utils.repo import find_repo_root
+
 # Path constants
-REPO_ROOT = Path(__file__).resolve().parents[4]
+# Consumer repo artifacts
+REPO_ROOT = find_repo_root()
 TELEMETRY_DIR = REPO_ROOT / "telemetry"
 CONTRACTS_DIR = REPO_ROOT / "contracts"
 PLAN_DIR = REPO_ROOT / "plan"
-META_SCHEMA_PATH = REPO_ROOT / "atdd" / "tester" / "schemas" / "telemetry.schema.json"
+
+# Package resources (conventions, schemas)
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
+META_SCHEMA_PATH = ATDD_PKG_DIR / "tester" / "schemas" / "telemetry.schema.json"
 
 
 @pytest.fixture

{atdd-0.3.3.dist-info → atdd-0.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.3.3
+Version: 0.4.1
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10
@@ -16,6 +16,15 @@ Dynamic: license-file
 
 Acceptance Test Driven Development toolkit for structured planning and convention enforcement.
 
+ATDD covers the full software lifecycle, not just code. It starts from a job to be done (e.g., user problem or goal), turns it into deterministic requirements, validates them with tests, and then drives implementation.
+
+```mermaid
+flowchart LR
+    A[Job to be Done] -->|Planner| B[Wagon + Acceptance Criteria]
+    B -->|Tester| C[RED Tests]
+    C -->|Coder| D[GREEN Code]
+```
+
 ## Installation
 
 ### From PyPI
@@ -49,9 +58,9 @@ atdd --help
 ```bash
 atdd init                      # Initialize ATDD in your project
 atdd gate                      # ⚠️ START EVERY SESSION WITH THIS
-atdd session new my-feature    # Create a planning session
+atdd session new <capability>    # Create a planning session
 atdd sync                      # Sync rules to agent config files
-atdd --test all                # Run validators
+atdd validate                  # Run all validators
 ```
 
 > **⚠️ `atdd gate` is required.** 
@@ -67,6 +76,22 @@ ATDD provides:
 3. **ATDD Lifecycle** - Planner → Tester → Coder phase gates
 4. **Agent Config Sync** - Keep ATDD rules in sync across AI agent config files
 
+```mermaid
+flowchart LR
+    A[Job to be Done] -->|Planner| B[Wagon + Acceptance Criteria]
+    B -->|Tester| C[RED Tests]
+    C -->|Coder| D[GREEN Code]
+    D -->|Coder| E[REFACTOR]
+    E -.->|feedback| B
+
+    subgraph "ATDD Lifecycle"
+        B
+        C
+        D
+        E
+    end
+```
+
 ## Commands
 
 ### Project Initialization
@@ -196,19 +221,23 @@ Before starting work, confirm you have loaded these rules.
 ### Validation
 
 ```bash
-atdd --test all        # Run all validators
-atdd --test planner    # Planning artifacts only
-atdd --test tester     # Testing artifacts only
-atdd --test coder      # Implementation only
-atdd --quick           # Fast smoke test
+atdd validate              # Run all validators
+atdd validate planner      # Planning validators only
+atdd validate tester       # Testing validators only
+atdd validate coder        # Implementation validators only
+atdd validate --quick      # Fast smoke test
+atdd validate --coverage   # With coverage report
+atdd validate --html       # With HTML report
 ```
 
 ### Other Commands
 
 ```bash
-atdd --status          # Platform status
-atdd --inventory       # Generate artifact inventory
-atdd --help            # Full help
+atdd status                    # Platform status
+atdd inventory                 # Generate artifact inventory
+atdd inventory --format json   # Inventory as JSON
+atdd registry update           # Update all registries
+atdd --help                    # Full help
 ```
 
 ## Project Structure
@@ -264,7 +293,7 @@ pytest --cov=atdd --cov-report=html
 
 1. Create `src/atdd/{phase}/validators/test_{name}.py`
 2. Write pytest test functions
-3. Run `atdd --test {phase}`
+3. Run `atdd validate {phase}`
 
 Validators are auto-discovered by pytest.