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

atdd/coach/commands/initializer.py

@@ -169,6 +169,10 @@ class ProjectInitializer:
 
         config = {
             "version": "1.0",
+            "release": {
+                "version_file": "VERSION",
+                "tag_prefix": "v",
+            },
             "sync": {
                 "agents": ["claude"],  # Default: only Claude
             },

atdd/coach/commands/registry.py

@@ -1555,6 +1555,6 @@ def main(repo_root: Path):
 
 
 if __name__ == "__main__":
-    from pathlib import Path
-    repo_root = Path(__file__).resolve().parents[4]
+    from atdd.coach.utils.repo import find_repo_root
+    repo_root = find_repo_root()
     main(repo_root)

atdd/coach/schemas/config.schema.json

@@ -11,6 +11,25 @@
       "pattern": "^[0-9]+\\.[0-9]+$",
       "examples": ["1.0"]
     },
+    "release": {
+      "type": "object",
+      "description": "Release/versioning settings",
+      "properties": {
+        "version_file": {
+          "type": "string",
+          "description": "Path to version file (relative to repo root)",
+          "examples": ["pyproject.toml", "package.json", "VERSION"]
+        },
+        "tag_prefix": {
+          "type": "string",
+          "description": "Prefix for git tags",
+          "default": "v",
+          "examples": ["v", ""]
+        }
+      },
+      "required": ["version_file"],
+      "additionalProperties": false
+    },
     "sync": {
       "type": "object",
       "description": "Agent config file sync settings",
@@ -27,8 +46,20 @@
         }
       },
       "additionalProperties": false
+    },
+    "toolkit": {
+      "type": "object",
+      "description": "ATDD toolkit metadata",
+      "properties": {
+        "last_version": {
+          "type": "string",
+          "description": "Last installed ATDD toolkit version"
+        }
+      },
+      "required": ["last_version"],
+      "additionalProperties": false
     }
   },
-  "required": ["version"],
+  "required": ["version", "release"],
   "additionalProperties": false
 }

atdd/coach/templates/ATDD.md

@@ -225,7 +225,9 @@ release:
   mandatory: true
 
   rules:
+    - "Version file is required (configured in .atdd/config.yaml)"
     - "Tag must match version exactly: v{version}"
+    - "Tag must be on HEAD"
     - "No tag without version bump"
     - "No version bump without tag"
     - "Every repo MUST have versioning"
@@ -243,10 +245,11 @@ release:
     - "Push with tags: git push origin {branch} --tags"
     - "Record in Session Log: 'Released: v{version}'"
 
-  # Consumer repos configure version file location in .atdd/config.yaml:
+  # Config (required in .atdd/config.yaml):
   # release:
   #   version_file: "pyproject.toml"  # or package.json, VERSION, etc.
   #   tag_prefix: "v"
+  # Validator: atdd validate coach enforces version file + tag on HEAD
 
 # Agent Coordination (Detailed in action files)
 agents:

atdd/coach/validators/test_release_versioning.py

@@ -0,0 +1,178 @@
+"""
+Release versioning validation.
+
+Ensures:
+- .atdd/config.yaml defines release.version_file
+- Version file exists and contains a version
+- Git tag on HEAD matches tag_prefix + version
+"""
+
+import json
+import re
+import subprocess
+from pathlib import Path
+from typing import Optional
+
+import pytest
+import yaml
+
+from atdd.coach.utils.repo import find_repo_root
+
+
+REPO_ROOT = find_repo_root()
+CONFIG_FILE = REPO_ROOT / ".atdd" / "config.yaml"
+
+
+def _load_config() -> dict:
+    if not CONFIG_FILE.exists():
+        pytest.skip(f"Config not found: {CONFIG_FILE}. Run 'atdd init' first.")
+
+    with open(CONFIG_FILE) as f:
+        return yaml.safe_load(f) or {}
+
+
+def _get_release_config(config: dict) -> tuple[str, str]:
+    release = config.get("release")
+    if not isinstance(release, dict):
+        pytest.fail(
+            "Missing release config in .atdd/config.yaml. "
+            "Add release.version_file and release.tag_prefix."
+        )
+
+    version_file = release.get("version_file")
+    if not version_file or not isinstance(version_file, str):
+        pytest.fail("Missing release.version_file in .atdd/config.yaml.")
+
+    tag_prefix = release.get("tag_prefix", "v")
+    if tag_prefix is None:
+        tag_prefix = ""
+    if not isinstance(tag_prefix, str):
+        pytest.fail("release.tag_prefix must be a string.")
+
+    return version_file, tag_prefix
+
+
+def _read_version_from_file(path: Path) -> str:
+    if not path.exists():
+        pytest.fail(f"Version file not found: {path}")
+
+    if path.name == "pyproject.toml":
+        version = _parse_pyproject_version(path)
+    elif path.name == "package.json":
+        version = _parse_package_json_version(path)
+    else:
+        version = _parse_plain_version(path)
+
+    if not version:
+        pytest.fail(f"Could not read version from {path}")
+
+    return version
+
+
+def _parse_pyproject_version(path: Path) -> Optional[str]:
+    text = path.read_text()
+
+    # Try tomllib/tomli first for correctness
+    data = _load_toml(text)
+    if isinstance(data, dict):
+        project = data.get("project", {})
+        if isinstance(project, dict) and project.get("version"):
+            return str(project["version"]).strip()
+        tool = data.get("tool", {})
+        if isinstance(tool, dict):
+            poetry = tool.get("poetry", {})
+            if isinstance(poetry, dict) and poetry.get("version"):
+                return str(poetry["version"]).strip()
+
+    # Fallback to lightweight parsing
+    return _parse_pyproject_version_text(text)
+
+
+def _load_toml(text: str) -> Optional[dict]:
+    try:
+        import tomllib  # type: ignore[attr-defined]
+        return tomllib.loads(text)
+    except Exception:
+        try:
+            import tomli  # type: ignore
+            return tomli.loads(text)
+        except Exception:
+            return None
+
+
+def _parse_pyproject_version_text(text: str) -> Optional[str]:
+    current_section = None
+    for line in text.splitlines():
+        stripped = line.strip()
+        if not stripped or stripped.startswith("#"):
+            continue
+        if stripped.startswith("[") and stripped.endswith("]"):
+            current_section = stripped.strip("[]").strip()
+            continue
+        if current_section in {"project", "tool.poetry"}:
+            match = re.match(r'version\s*=\s*["\']([^"\']+)["\']', stripped)
+            if match:
+                return match.group(1).strip()
+    return None
+
+
+def _parse_package_json_version(path: Path) -> Optional[str]:
+    try:
+        data = json.loads(path.read_text())
+    except json.JSONDecodeError:
+        return None
+
+    version = data.get("version")
+    return str(version).strip() if version else None
+
+
+def _parse_plain_version(path: Path) -> Optional[str]:
+    for line in path.read_text().splitlines():
+        stripped = line.strip()
+        if not stripped or stripped.startswith("#"):
+            continue
+        return stripped
+    return None
+
+
+def _git_tags_on_head(repo_root: Path) -> list[str]:
+    result = subprocess.run(
+        ["git", "tag", "--points-at", "HEAD"],
+        cwd=str(repo_root),
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        stderr = result.stderr.strip() or "git tag --points-at HEAD failed"
+        pytest.fail(stderr)
+
+    tags = [line.strip() for line in result.stdout.splitlines() if line.strip()]
+    return tags
+
+
+def test_release_version_file_and_tag_on_head():
+    """
+    SPEC-RELEASE-0001: Version file exists and tag on HEAD matches version.
+    """
+    config = _load_config()
+    version_file, tag_prefix = _get_release_config(config)
+
+    version_path = Path(version_file)
+    if not version_path.is_absolute():
+        version_path = (REPO_ROOT / version_path).resolve()
+
+    version = _read_version_from_file(version_path)
+    expected_tag = f"{tag_prefix}{version}"
+
+    tags = _git_tags_on_head(REPO_ROOT)
+    if not tags:
+        pytest.fail(
+            "No git tag found on HEAD. "
+            f"Create tag: git tag {expected_tag}"
+        )
+
+    if expected_tag not in tags:
+        found = ", ".join(tags) if tags else "none"
+        pytest.fail(
+            f"Expected tag '{expected_tag}' on HEAD, found: {found}"
+        )

atdd/planner/validators/test_plan_cross_refs.py

@@ -5,8 +5,11 @@ Validates that cross-references between wagons, trains, and artifacts are cohere
 Tests ensure that consume references point to valid produce artifacts.
 """
 import pytest
+from pathlib import Path
 from typing import Dict, Set, List, Tuple, Any
 
+from atdd.coach.utils.repo import find_repo_root
+
 
 @pytest.mark.platform
 @pytest.mark.e2e
@@ -117,8 +120,7 @@ def test_trains_reference_valid_wagons(trains_registry, wagon_manifests):
             # Load individual train file if path exists
             if train_path:
                 import yaml
-                from pathlib import Path
-                train_file = Path(__file__).resolve().parents[4] / train_path
+                train_file = find_repo_root() / train_path
 
                 if train_file.exists():
                     with open(train_file) as f:

atdd/planner/validators/test_train_validation.py

@@ -13,6 +13,8 @@ import yaml
 from pathlib import Path
 from typing import Dict, List, Set, Tuple
 
+from atdd.coach.utils.repo import find_repo_root
+
 
 @pytest.mark.platform
 def test_train_ids_follow_numbering_convention(trains_registry):
@@ -91,7 +93,7 @@ def test_train_files_exist_for_registry_entries(trains_registry):
     When: Checking for train files
     Then: Each train has a file at plan/_trains/{train_id}.yaml
     """
-    repo_root = Path(__file__).resolve().parents[4]
+    repo_root = find_repo_root()
     trains_dir = repo_root / "plan" / "_trains"
 
     missing_files = []
@@ -121,7 +123,7 @@ def test_all_train_files_registered(trains_registry):
     When: Checking registry
     Then: Each file is registered in plan/_trains.yaml
     """
-    repo_root = Path(__file__).resolve().parents[4]
+    repo_root = find_repo_root()
     trains_dir = repo_root / "plan" / "_trains"
 
     # Get all registered train IDs
@@ -153,7 +155,7 @@ def test_train_id_matches_filename(trains_registry):
     When: Loading train data
     Then: train_id field matches filename (without .yaml)
     """
-    repo_root = Path(__file__).resolve().parents[4]
+    repo_root = find_repo_root()
     trains_dir = repo_root / "plan" / "_trains"
 
     mismatches = []
@@ -183,7 +185,7 @@ def test_train_wagons_exist(trains_registry, wagon_manifests):
     When: Checking wagon references
     Then: Each wagon exists in registry or has a manifest in plan/*
     """
-    repo_root = Path(__file__).resolve().parents[4]
+    repo_root = find_repo_root()
     trains_dir = repo_root / "plan" / "_trains"
 
     # Build wagon name set from manifests
@@ -231,7 +233,7 @@ def test_train_dependencies_are_valid(trains_registry):
     When: Checking dependency references
     Then: Each dependency points to a valid train_id
     """
-    repo_root = Path(__file__).resolve().parents[4]
+    repo_root = find_repo_root()
     trains_dir = repo_root / "plan" / "_trains"
 
     # Get all valid train IDs
@@ -287,7 +289,7 @@ def test_train_artifacts_follow_naming_convention(trains_registry):
     """
     import re
 
-    repo_root = Path(__file__).resolve().parents[4]
+    repo_root = find_repo_root()
     trains_dir = repo_root / "plan" / "_trains"
 
     pattern = re.compile(r"^[a-z][a-z0-9-]*(?::[a-z][a-z0-9-]*)+(?:\.[a-z][a-z0-9-]*)*$")
@@ -355,7 +357,7 @@ def test_train_artifacts_exist_in_wagons(trains_registry, wagon_manifests):
     Then: Each artifact should be in wagon produce/consume lists
     Note: Soft check - external/system artifacts are allowed
     """
-    repo_root = Path(__file__).resolve().parents[4]
+    repo_root = find_repo_root()
     trains_dir = repo_root / "plan" / "_trains"
 
     # Build artifact index from wagons
@@ -488,7 +490,7 @@ def test_trains_match_schema(trains_registry):
     from jsonschema import Draft7Validator
     import json
 
-    repo_root = Path(__file__).resolve().parents[4]
+    repo_root = find_repo_root()
     schema_path = repo_root / ".claude" / "schemas" / "planner" / "train.schema.json"
     trains_dir = repo_root / "plan" / "_trains"
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.4.1
+Version: 0.4.3
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10
@@ -230,6 +230,20 @@ atdd validate --coverage   # With coverage report
 atdd validate --html       # With HTML report
 ```
 
+### Release Versioning
+
+ATDD enforces release versioning via coach validators. Configure the version file and tag prefix in `.atdd/config.yaml`:
+
+```yaml
+release:
+  version_file: "pyproject.toml"  # or package.json, VERSION, etc.
+  tag_prefix: "v"
+```
+
+Validation (`atdd validate coach` or `atdd validate`) requires:
+- Version file exists and contains a version
+- Git tag on HEAD matches `{tag_prefix}{version}`
+
 ### Other Commands
 
 ```bash

{atdd-0.4.1.dist-info → atdd-0.4.3.dist-info}/RECORD

@@ -10,11 +10,11 @@ atdd/coach/commands/analyze_migrations.py,sha256=2bLfR7OwicBXAZWB4R3Sm4d5jFe87d0
 atdd/coach/commands/consumers.py,sha256=7vTexse8xznXSzNWjPGYuF4iJ8ZWymmOSkpcA6IWyxU,27514
 atdd/coach/commands/gate.py,sha256=_V2GypqoGixTs_kLWxFF3HgEt-Wi2r6Iv0YL75yWrWo,5829
 atdd/coach/commands/infer_governance_status.py,sha256=MlLnx8SrJAOQq2rfuxLZMmyNylCQ-OYx4tSi_iFdhRA,4504
-atdd/coach/commands/initializer.py,sha256=s7NnITF4c6xGlN6ZJVjyv4a4jxGMjK9OPG1C-OIG55A,6385
+atdd/coach/commands/initializer.py,sha256=wuvzj7QwA11ilNjRZU6Bx2bLQXITdBHJxR9_mZK7xjA,6503
 atdd/coach/commands/interface.py,sha256=FwBrJpWkfSL9n4n0HT_EC-alseXgU0bweKD4TImyHN0,40483
 atdd/coach/commands/inventory.py,sha256=qU42MnkXt1JSBh5GU7pPSKmCO27Zfga7XwMT19RquJE,20969
 atdd/coach/commands/migration.py,sha256=wRxU7emvvHqWt1MvXKkNTkPBjp0sU9g8F5Uy5yV2YfI,8177
-atdd/coach/commands/registry.py,sha256=r1QWg841eK6bS4vEbYEviylDCpFkInUVMTsf5h4ArrQ,58344
+atdd/coach/commands/registry.py,sha256=76-Pe3_cN483JR1pXUdDIE5WSZjWtVV0Jl8dRtRw_9Y,58349
 atdd/coach/commands/session.py,sha256=MhuWXd5TR6bB3w0t8vANeZx3L476qwLT6EUQMwg-wQA,14268
 atdd/coach/commands/sync.py,sha256=4HNzg8AVaePDwhyBlQcywvNVZDP5NIW8TBsEPbqmJuQ,12545
 atdd/coach/commands/test_interface.py,sha256=a7ut2Hhk0PnQ5LfJZkoQwfkfkVuB5OHA4QBwOS0-jcg,16870
@@ -25,9 +25,9 @@ atdd/coach/commands/tests/test_telemetry_array_validation.py,sha256=WK5ZXvR1avlz
 atdd/coach/conventions/session.convention.yaml,sha256=1wCxQ_Y2Wb2080Xt2JZs0_WsV8_4SC0Tq87G_BCGdiE,26049
 atdd/coach/overlays/__init__.py,sha256=2lMiMSgfLJ3YHLpbzNI5B88AdQxiMEwjIfsWWb8t3To,123
 atdd/coach/overlays/claude.md,sha256=33mhpqhmsRhCtdWlU7cMXAJDsaVra9uBBK8URV8OtQA,101
-atdd/coach/schemas/config.schema.json,sha256=xzct7gBoPTIGh3NFPSGtfW0zIiyFdHDZkvjuy1qgAqA,951
+atdd/coach/schemas/config.schema.json,sha256=CpePppEAB6WiLeWVgWW3EKOxlLvMHHcWisRnJL9z_SE,1863
 atdd/coach/schemas/manifest.schema.json,sha256=WO13-YF_FgH1awh96khCtk-112b6XSC24anlY3B7GjY,2885
-atdd/coach/templates/ATDD.md,sha256=jovi7CeJKidboZPKLmge5OCNESq998dHPr8zTHRRvlg,13100
+atdd/coach/templates/ATDD.md,sha256=MLbrVbCETJre4c05d5FXGuf6W95Hz9E0jpE4RI9r4cg,13237
 atdd/coach/templates/SESSION-TEMPLATE.md,sha256=gcmfDDD6rREI20vhWXlf01AGbRbR8Hh7Q4QZX4H-pVw,9455
 atdd/coach/utils/__init__.py,sha256=7Jbo-heJEKSAn6I0s35z_2S4R8qGZ48PL6a2IntcNYg,148
 atdd/coach/utils/repo.py,sha256=0kiF5WpVTen0nO14u5T0RflznZhgGco2i9CwKobOh38,3757
@@ -37,6 +37,7 @@ atdd/coach/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3h
 atdd/coach/validators/shared_fixtures.py,sha256=tdqAb4675P-oOCL08mvSCG9XpmwMCjL9iSq1W5U7-wk,12558
 atdd/coach/validators/test_enrich_wagon_registry.py,sha256=WeTwYJqoNY6mEYc-QAvQo7YVagSOjaNKxB6Q6dpWqIM,6561
 atdd/coach/validators/test_registry.py,sha256=ffN70yA_1xxL3R8gdpGbY2M8dQXyuajIZhBZ-ylNiNs,17845
+atdd/coach/validators/test_release_versioning.py,sha256=-H2hCRfdikVP54LHNDqW9IDmm6JLNBUZRdnF2uICvOI,5194
 atdd/coach/validators/test_session_validation.py,sha256=0VszXtFwRTO04b5CxDPO3klk0VfiqlpdbNpshjMn-qU,39079
 atdd/coach/validators/test_traceability.py,sha256=qTyobt41VBiCr6xRN2C7BPtGYvk_2poVQIe814Blt8E,15977
 atdd/coach/validators/test_update_feature_paths.py,sha256=zOKVDgEIpncSJwDh_shyyou5Pu-Ai7Z_XgF8zAbQVTA,4528
@@ -110,11 +111,11 @@ atdd/planner/schemas/wmbt.schema.json,sha256=KU_D6r0kQTJod-XHQT5QiiHcUUPJrLgg3aP
 atdd/planner/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atdd/planner/validators/conftest.py,sha256=CVr3m9mv4xc8G6azcdbZ1VArVvLZw2Utqt2EIOyYdbQ,155
 atdd/planner/validators/test_draft_wagon_registry.py,sha256=Bt4xTjgKddEnnxNOMh8jWhvb3aqRaWGBd227Vv3rWz0,13798
-atdd/planner/validators/test_plan_cross_refs.py,sha256=MlRMuM_eo3h8Q1pOdcvxyRNqRie9xPiYamOeofwiKaM,9505
+atdd/planner/validators/test_plan_cross_refs.py,sha256=kxlq1uZ2u4mn3r8wHJjXVJsB8nmzwsvSzOlRapJ9pBY,9520
 atdd/planner/validators/test_plan_uniqueness.py,sha256=rlC5khAoBkgpTZJdyHi1JbDUj14v1JiGBFv2iV_AP_Y,7735
 atdd/planner/validators/test_plan_urn_resolution.py,sha256=GoxFiRjOfp69FUmIyKGnsGgpYalOz3qfp6qjyCkga44,9440
 atdd/planner/validators/test_plan_wagons.py,sha256=l4jbHf9Kg-Fy8Gz5O8BO7PDQKbbeLN0uctoErPK_YKI,7357
-atdd/planner/validators/test_train_validation.py,sha256=13j5hx_bcBhf3xFeqCJGo79y8lN9xpNEXXRzjV17tHQ,16972
+atdd/planner/validators/test_train_validation.py,sha256=KsAMxtuyipHse02x91k4rLWUxRiHW29sYBWZ6KNbfJ4,16870
 atdd/planner/validators/test_wagon_urn_chain.py,sha256=KY_0vrj6CoiQJ80WbqfCGCYbup13cVssaxbNO0eVf74,26697
 atdd/planner/validators/test_wmbt_consistency.py,sha256=jdfu4xWEozzBGwplKDXxuDQNLBDxB_AC96NHLkyHqQ8,10875
 atdd/planner/validators/test_wmbt_vocabulary.py,sha256=PCivTzV7ntlZBa-PVzpBwEiKqLumsEZXfj1r2xl9usM,18803
@@ -181,9 +182,9 @@ atdd/tester/validators/test_red_supabase_layer_structure.py,sha256=zbUjsMWSJE1MP
 atdd/tester/validators/test_telemetry_structure.py,sha256=uU5frZnxSlOn60iHyqhe7Pg9b0wrOV7N14D4S6Aw6TE,22626
 atdd/tester/validators/test_typescript_test_naming.py,sha256=E-TyGv_GVlTfsbyuxrtv9sOWSZS_QcpH6rrJFbWoeeU,11280
 atdd/tester/validators/test_typescript_test_structure.py,sha256=eV89SD1RaKtchBZupqhnJmaruoROosf3LwB4Fwe4UJI,2612
-atdd-0.4.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-atdd-0.4.1.dist-info/METADATA,sha256=iTk5GkFTyh-znp87feeNCmw7Sfy302zPdf12mHMy_24,8013
-atdd-0.4.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-atdd-0.4.1.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
-atdd-0.4.1.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
-atdd-0.4.1.dist-info/RECORD,,
+atdd-0.4.3.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+atdd-0.4.3.dist-info/METADATA,sha256=KAH0NMoqTXf3-U24pNLCP6-x0G5-otbGLiCvPa1t5cE,8426
+atdd-0.4.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+atdd-0.4.3.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
+atdd-0.4.3.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
+atdd-0.4.3.dist-info/RECORD,,