atdd 0.4.2__py3-none-any.whl → 0.4.4__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/sync.py

@@ -194,6 +194,11 @@ class AgentConfigSync:
         """
         agents = self._get_enabled_agents()
 
+        # Get configured vs detected for display
+        config = self._load_config()
+        sync_config = config.get("sync", {})
+        configured_agents = set(sync_config.get("agents", []))
+
         print("\n" + "=" * 60)
         print("ATDD Agent Config Sync Status")
         print("=" * 60)
@@ -202,8 +207,8 @@ class AgentConfigSync:
         print(f"ATDD template: {self.atdd_template}")
         print(f"Overlays dir: {self.overlays_dir}")
 
-        print(f"\n{'Agent':<10} {'File':<15} {'Status':<20}")
-        print("-" * 50)
+        print(f"\n{'Agent':<10} {'File':<15} {'Status':<20} {'Source':<12}")
+        print("-" * 62)
 
         for agent, target_file in sorted(self.AGENT_FILES.items()):
             target_path = self.target_dir / target_file
@@ -211,18 +216,22 @@ class AgentConfigSync:
 
             if not enabled:
                 status = "disabled"
+                source = ""
             elif not target_path.exists():
                 status = "missing"
+                source = "config"
             elif not self._has_managed_block(target_path.read_text()):
                 status = "no managed block"
+                source = "auto" if agent not in configured_agents else "config"
             else:
                 status = "synced"
+                source = "auto" if agent not in configured_agents else "config"
 
             enabled_marker = "*" if enabled else " "
-            print(f"{enabled_marker} {agent:<8} {target_file:<15} {status:<20}")
+            print(f"{enabled_marker} {agent:<8} {target_file:<15} {status:<20} {source:<12}")
 
-        print("-" * 50)
-        print("* = enabled in config")
+        print("-" * 62)
+        print("* = enabled for sync (config = explicit, auto = file exists)")
 
         # Show overlay status
         print("\nOverlays:")
@@ -250,14 +259,32 @@ class AgentConfigSync:
 
     def _get_enabled_agents(self) -> List[str]:
         """
-        Return agents from config.
+        Return agents to sync: configured agents + existing agent files.
+
+        Auto-includes any supported agent file that already exists in the
+        target directory, in addition to explicitly configured agents.
+        This ensures existing agent files stay in sync without requiring
+        explicit configuration.
 
         Returns:
-            List of agent names enabled for sync.
+            List of unique agent names enabled for sync.
         """
+        # Get explicitly configured agents
         config = self._load_config()
         sync_config = config.get("sync", {})
-        return sync_config.get("agents", [])
+        configured_agents = set(sync_config.get("agents", []))
+
+        # Auto-detect existing agent files
+        detected_agents = set()
+        for agent, filename in self.AGENT_FILES.items():
+            agent_path = self.target_dir / filename
+            if agent_path.exists():
+                detected_agents.add(agent)
+
+        # Merge: configured + detected
+        all_agents = configured_agents | detected_agents
+
+        return sorted(all_agents)
 
     def _load_base_content(self) -> Optional[str]:
         """

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-0.4.2.dist-info → atdd-0.4.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.4.2
+Version: 0.4.4
 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.2.dist-info → atdd-0.4.4.dist-info}/RECORD

@@ -10,13 +10,13 @@ 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=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/sync.py,sha256=SLNzhcc6IuzMofMbkH9wM9rBSk5tPfcWPKXn9TaSZ-Y,13782
 atdd/coach/commands/test_interface.py,sha256=a7ut2Hhk0PnQ5LfJZkoQwfkfkVuB5OHA4QBwOS0-jcg,16870
 atdd/coach/commands/test_runner.py,sha256=_6JrDRq5fBHUOC4MtkgXcjkgJjG80otoGRTqnkEphIk,5832
 atdd/coach/commands/traceability.py,sha256=8TmpZDeUVHJAz-p3oxXq55jCFiFpKIQR8h1wLZVYcgA,163612
@@ -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
@@ -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.2.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-atdd-0.4.2.dist-info/METADATA,sha256=u367DyQRsEduvaTko1XLLX7sfVQZSmvC8Gmrr5tRSVE,8013
-atdd-0.4.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-atdd-0.4.2.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
-atdd-0.4.2.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
-atdd-0.4.2.dist-info/RECORD,,
+atdd-0.4.4.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+atdd-0.4.4.dist-info/METADATA,sha256=cBMNKGmx5Uyw5kwn_v6ezv-CKbuFd5QpsZ6hFG_rg9k,8426
+atdd-0.4.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+atdd-0.4.4.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
+atdd-0.4.4.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
+atdd-0.4.4.dist-info/RECORD,,