atdd 0.4.1__tar.gz → 0.4.3__tar.gz

{atdd-0.4.1/src/atdd.egg-info → atdd-0.4.3}/PKG-INFO

@@ -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 → atdd-0.4.3}/README.md

@@ -216,6 +216,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 → atdd-0.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "atdd"
-version = "0.4.1"
+version = "0.4.3"
 description = "ATDD Platform - Acceptance Test Driven Development toolkit"
 requires-python = ">=3.10"
 readme = "README.md"

{atdd-0.4.1 → atdd-0.4.3}/src/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-0.4.1 → atdd-0.4.3}/src/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-0.4.3/src/atdd/coach/schemas/config.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://atdd.dev/schemas/config.schema.json",
+  "title": "ATDD Config",
+  "description": "Schema for .atdd/config.yaml configuration file",
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Configuration schema version",
+      "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",
+      "properties": {
+        "agents": {
+          "type": "array",
+          "description": "List of agents to sync ATDD rules to",
+          "items": {
+            "type": "string",
+            "enum": ["claude", "codex", "gemini", "qwen"]
+          },
+          "uniqueItems": true,
+          "default": ["claude"]
+        }
+      },
+      "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", "release"],
+  "additionalProperties": false
+}

{atdd-0.4.1 → atdd-0.4.3}/src/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-0.4.3/src/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-0.4.1 → atdd-0.4.3}/src/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-0.4.1 → atdd-0.4.3}/src/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 → atdd-0.4.3/src/atdd.egg-info}/PKG-INFO

@@ -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 → atdd-0.4.3}/src/atdd.egg-info/SOURCES.txt

@@ -46,6 +46,7 @@ src/atdd/coach/validators/__init__.py
 src/atdd/coach/validators/shared_fixtures.py
 src/atdd/coach/validators/test_enrich_wagon_registry.py
 src/atdd/coach/validators/test_registry.py
+src/atdd/coach/validators/test_release_versioning.py
 src/atdd/coach/validators/test_session_validation.py
 src/atdd/coach/validators/test_traceability.py
 src/atdd/coach/validators/test_update_feature_paths.py

atdd-0.4.1/src/atdd/coach/schemas/config.schema.json

@@ -1,34 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://atdd.dev/schemas/config.schema.json",
-  "title": "ATDD Config",
-  "description": "Schema for .atdd/config.yaml configuration file",
-  "type": "object",
-  "properties": {
-    "version": {
-      "type": "string",
-      "description": "Configuration schema version",
-      "pattern": "^[0-9]+\\.[0-9]+$",
-      "examples": ["1.0"]
-    },
-    "sync": {
-      "type": "object",
-      "description": "Agent config file sync settings",
-      "properties": {
-        "agents": {
-          "type": "array",
-          "description": "List of agents to sync ATDD rules to",
-          "items": {
-            "type": "string",
-            "enum": ["claude", "codex", "gemini", "qwen"]
-          },
-          "uniqueItems": true,
-          "default": ["claude"]
-        }
-      },
-      "additionalProperties": false
-    }
-  },
-  "required": ["version"],
-  "additionalProperties": false
-}