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

atdd/cli.py

@@ -45,7 +45,7 @@ from atdd.coach.commands.session import SessionManager
 from atdd.coach.commands.sync import AgentConfigSync
 from atdd.coach.commands.gate import ATDDGate
 from atdd.coach.utils.repo import find_repo_root
-from atdd.version_check import print_update_notice
+from atdd.version_check import print_update_notice, print_upgrade_sync_notice
 
 
 class ATDDCoach:
@@ -436,10 +436,14 @@ Phase descriptions:
 
 
 def cli() -> int:
-    """CLI entry point with version check."""
+    """CLI entry point with version and upgrade checks."""
+    # Check if repo needs sync after ATDD upgrade (at startup)
+    print_upgrade_sync_notice()
+
     try:
         result = main()
     finally:
+        # Check for newer versions on PyPI (at end)
         print_update_notice()
     return result
 

atdd/coach/commands/initializer.py

@@ -160,11 +160,21 @@ class ProjectInitializer:
             print(f"Config already exists: {self.config_file}")
             return
 
+        # Get installed ATDD version
+        try:
+            from atdd import __version__
+            toolkit_version = __version__
+        except ImportError:
+            toolkit_version = "0.0.0"
+
         config = {
             "version": "1.0",
             "sync": {
                 "agents": ["claude"],  # Default: only Claude
             },
+            "toolkit": {
+                "last_version": toolkit_version,  # Track installed version
+            },
         }
 
         with open(self.config_file, "w") as f:

atdd/coach/commands/sync.py

@@ -115,6 +115,13 @@ class AgentConfigSync:
                 unchanged_count += 1
 
         print(f"\nSync complete: {synced_count} updated, {unchanged_count} unchanged")
+
+        # Update toolkit.last_version to mark sync complete
+        from atdd.version_check import update_toolkit_version
+        if update_toolkit_version(self.config_file):
+            from atdd import __version__
+            print(f"Updated toolkit.last_version to {__version__}")
+
         return 0
 
     def verify(self) -> int:

atdd/coach/templates/ATDD.md

@@ -219,6 +219,35 @@ git:
       - "GREEN: commit passing implementation"
       - "REFACTOR: commit clean architecture"
 
+# Release Gate (MANDATORY - session completion)
+# Every session MUST end with version bump + tag
+release:
+  mandatory: true
+
+  rules:
+    - "Tag must match version exactly: v{version}"
+    - "No tag without version bump"
+    - "No version bump without tag"
+    - "Every repo MUST have versioning"
+
+  change_class:
+    PATCH: "bug fixes, docs, refactors, internal changes"
+    MINOR: "new feature, new validator, new command, new convention (non-breaking)"
+    MAJOR: "breaking API/CLI/schema/convention change or behavior removal"
+
+  workflow:
+    - "Determine change class"
+    - "Bump version in version file"
+    - "Commit: 'Bump version to {version}'"
+    - "Create tag: git tag v{version}"
+    - "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:
+  # release:
+  #   version_file: "pyproject.toml"  # or package.json, VERSION, etc.
+  #   tag_prefix: "v"
+
 # Agent Coordination (Detailed in action files)
 agents:
   planner:

atdd/coach/templates/SESSION-TEMPLATE.md

@@ -331,6 +331,31 @@ Reference: src/atdd/coach/conventions/session.convention.yaml
 
 ---
 
+## Release Gate (MANDATORY)
+
+<!--
+Every session MUST end with a version bump + matching git tag.
+
+Change Class:
+- PATCH: bug fixes, docs, refactors, internal changes
+- MINOR: new feature, new validator, new command, new convention (non-breaking)
+- MAJOR: breaking API/CLI/schema/convention change or behavior removal
+
+Rules:
+- Tag must match version exactly: v{version}
+- No tag without version bump
+- No version bump without tag
+-->
+
+- [ ] Determine change class: PATCH / MINOR / MAJOR
+- [ ] Bump version in version file (pyproject.toml, package.json, etc.)
+- [ ] Commit: "Bump version to {version}"
+- [ ] Create tag: `git tag v{version}`
+- [ ] Push with tags: `git push origin {branch} --tags`
+- [ ] Record tag in Session Log: "Released: v{version}"
+
+---
+
 ## Notes
 
 {Additional context, learnings, or decisions that don't fit elsewhere.}

atdd/version_check.py

@@ -1,11 +1,13 @@
 """
 Version check for ATDD CLI.
 
-Checks PyPI for newer versions and notifies users. Uses a cached check
-to avoid adding latency to every command.
+Two types of version checks:
+1. PyPI update check - notifies when a newer version is available on PyPI
+2. Repo sync check - notifies when installed version is newer than repo's last_version
 
 Cache location: ~/.atdd/version_cache.json
-Disable: Set ATDD_NO_UPDATE_CHECK=1 environment variable
+Disable PyPI check: Set ATDD_NO_UPDATE_CHECK=1
+Disable sync reminder: Set ATDD_NO_UPGRADE_NOTICE=1
 """
 import json
 import os
@@ -16,6 +18,8 @@ from typing import Optional, Tuple
 from urllib.request import urlopen
 from urllib.error import URLError
 
+import yaml
+
 from atdd import __version__
 
 # Check once per day (86400 seconds)
@@ -124,3 +128,107 @@ def print_update_notice() -> None:
             print(notice, file=sys.stderr)
     except Exception:
         pass  # Never fail the main command due to version check
+
+
+# --- Repo sync upgrade check ---
+
+def _load_repo_config() -> Tuple[Optional[dict], Optional[Path]]:
+    """
+    Load .atdd/config.yaml from current directory.
+
+    Returns:
+        Tuple of (config_dict, config_path) or (None, None) if not found.
+    """
+    config_path = Path.cwd() / ".atdd" / "config.yaml"
+    if not config_path.exists():
+        return None, None
+
+    try:
+        with open(config_path) as f:
+            return yaml.safe_load(f) or {}, config_path
+    except (yaml.YAMLError, OSError):
+        return None, None
+
+
+def _get_last_toolkit_version(config: dict) -> Optional[str]:
+    """Extract toolkit.last_version from config."""
+    toolkit = config.get("toolkit", {})
+    return toolkit.get("last_version")
+
+
+def check_upgrade_sync_needed() -> Optional[str]:
+    """
+    Check if repo needs sync after ATDD upgrade.
+
+    Compares installed version vs toolkit.last_version in .atdd/config.yaml.
+
+    Returns:
+        Message to display if sync needed, None otherwise.
+    """
+    # Respect disable flag
+    if os.environ.get("ATDD_NO_UPGRADE_NOTICE", "").lower() in ("1", "true", "yes"):
+        return None
+
+    # Skip if running in development
+    if __version__ == "0.0.0":
+        return None
+
+    config, config_path = _load_repo_config()
+    if config is None:
+        # No .atdd/config.yaml - not an ATDD repo or not initialized
+        return None
+
+    last_version = _get_last_toolkit_version(config)
+    if last_version is None:
+        # First run or old config without toolkit.last_version
+        # Treat as needing sync
+        return f"ATDD upgraded to {__version__}. Run: atdd sync"
+
+    # Compare versions
+    if _is_newer(__version__, last_version):
+        return f"ATDD upgraded ({last_version} → {__version__}). Run: atdd sync"
+
+    return None
+
+
+def update_toolkit_version(config_path: Optional[Path] = None) -> bool:
+    """
+    Update toolkit.last_version in .atdd/config.yaml to current installed version.
+
+    Args:
+        config_path: Path to config file. Defaults to .atdd/config.yaml in cwd.
+
+    Returns:
+        True if updated, False otherwise.
+    """
+    if config_path is None:
+        config_path = Path.cwd() / ".atdd" / "config.yaml"
+
+    if not config_path.exists():
+        return False
+
+    try:
+        with open(config_path) as f:
+            config = yaml.safe_load(f) or {}
+
+        # Update toolkit.last_version
+        if "toolkit" not in config:
+            config["toolkit"] = {}
+        config["toolkit"]["last_version"] = __version__
+
+        with open(config_path, "w") as f:
+            yaml.dump(config, f, default_flow_style=False, sort_keys=False)
+
+        return True
+    except (yaml.YAMLError, OSError):
+        return False
+
+
+def print_upgrade_sync_notice() -> None:
+    """Print upgrade sync notice to stderr if needed."""
+    try:
+        notice = check_upgrade_sync_needed()
+        if notice:
+            print(f"\n⚠️  {notice}\n", file=sys.stderr)
+    except Exception:
+        pass  # Never fail the main command

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.3.1
+Version: 0.3.3
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10

{atdd-0.3.1.dist-info → atdd-0.3.3.dist-info}/RECORD

@@ -1,8 +1,8 @@
 atdd/__init__.py,sha256=-S8i9OahH-t9FJkPn6nprxipnjVum3rLeVsCS74T6eY,156
 atdd/__main__.py,sha256=B0sXDQLjFN9GowTlXo4NMWwPZPjDsrT8Frq7DnbdOD8,77
-atdd/cli.py,sha256=osZ_WFMbp3BFGgH-K7vApnoeulgeSU7-z6LB86-htnI,14534
+atdd/cli.py,sha256=IiD7CpLEOSpgldgI55bc540cBGwKug_rUiih41aq5R4,14722
 atdd/conftest.py,sha256=Fj3kIhCETbj2QBCIjySBgdS3stKNRZcZzKTJr7A4LaQ,5300
-atdd/version_check.py,sha256=B9MbbxO_sJrEC3fxFJhTlOIkLLTRQCDO1_8ec1KvuWY,3540
+atdd/version_check.py,sha256=BlPcLwzNnm457vWUolB3wMtZEI-fXvpzfm6p8U_j7rc,6684
 atdd/coach/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atdd/coach/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atdd/coach/commands/add_persistence_metadata.py,sha256=xAdeO9k53CIGTBhzNQbWenuzeoWKZimDBR9xBWaA3NU,6887
@@ -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=91-VnI64mOzijc1Cgkmr7cnNCir2-z2ITA2-SGwk3TU,4473
-atdd/coach/commands/initializer.py,sha256=Hli3hlL_aHnuDIzK0lHzE6KjG2QGvl2E2TvjmYoPPNE,6069
+atdd/coach/commands/initializer.py,sha256=s7NnITF4c6xGlN6ZJVjyv4a4jxGMjK9OPG1C-OIG55A,6385
 atdd/coach/commands/interface.py,sha256=PPCwICFNN4ddPqucUATIiBrfEkDO66MZbYQkwNu6lm4,40459
 atdd/coach/commands/inventory.py,sha256=Xakb6U3SfnEcR7rhZ0Wg8SK5frg-oPE7C0fCvE-VoH4,20923
 atdd/coach/commands/migration.py,sha256=KlRXXM1O-ZqfwGOWxN5C_gxfTttbXUG_yq9pOLYsGnQ,8119
 atdd/coach/commands/registry.py,sha256=r1QWg841eK6bS4vEbYEviylDCpFkInUVMTsf5h4ArrQ,58344
 atdd/coach/commands/session.py,sha256=MhuWXd5TR6bB3w0t8vANeZx3L476qwLT6EUQMwg-wQA,14268
-atdd/coach/commands/sync.py,sha256=dA6BYsebTT1zOMXgea6DqawkvjU_N-JJJMFj9GP2onk,12259
+atdd/coach/commands/sync.py,sha256=4HNzg8AVaePDwhyBlQcywvNVZDP5NIW8TBsEPbqmJuQ,12545
 atdd/coach/commands/test_interface.py,sha256=a7ut2Hhk0PnQ5LfJZkoQwfkfkVuB5OHA4QBwOS0-jcg,16870
 atdd/coach/commands/test_runner.py,sha256=Lutclc8Qr8BmLBvAYshXAjf8ynUM4eJgHF8GLPa1Usw,3929
 atdd/coach/commands/traceability.py,sha256=SYl0dRB_nQZJKe1IOCHxX193vaxOChVjnh6hcqcSOB0,163581
@@ -27,8 +27,8 @@ atdd/coach/overlays/__init__.py,sha256=2lMiMSgfLJ3YHLpbzNI5B88AdQxiMEwjIfsWWb8t3
 atdd/coach/overlays/claude.md,sha256=33mhpqhmsRhCtdWlU7cMXAJDsaVra9uBBK8URV8OtQA,101
 atdd/coach/schemas/config.schema.json,sha256=xzct7gBoPTIGh3NFPSGtfW0zIiyFdHDZkvjuy1qgAqA,951
 atdd/coach/schemas/manifest.schema.json,sha256=WO13-YF_FgH1awh96khCtk-112b6XSC24anlY3B7GjY,2885
-atdd/coach/templates/ATDD.md,sha256=DnJ1jzdoUWATEwvnweh2DCfoCepLMC_f35wlSvKF1FI,12153
-atdd/coach/templates/SESSION-TEMPLATE.md,sha256=tZ4Bgf4MZ6uHXwhy1C43SGpTiYm-_AvmFS6QxA2ISng,9140
+atdd/coach/templates/ATDD.md,sha256=eHdibGHQ66U5sYUvZFzLmTP3Z9J8P-J6dUzrYbjAd_w,13139
+atdd/coach/templates/SESSION-TEMPLATE.md,sha256=CPrCh279fQzDmgVob24ctH-vvKpUHr2SrJ3RLCiV05o,9898
 atdd/coach/utils/__init__.py,sha256=7Jbo-heJEKSAn6I0s35z_2S4R8qGZ48PL6a2IntcNYg,148
 atdd/coach/utils/repo.py,sha256=9rZeAf1b7-modoTiPZAwtjnoiI8YyHWIZhpqXvkJ7Qo,3104
 atdd/coach/utils/graph/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -181,9 +181,9 @@ atdd/tester/validators/test_red_supabase_layer_structure.py,sha256=26cnzPZAwSFy0
 atdd/tester/validators/test_telemetry_structure.py,sha256=hIUnU2WU-8PNIg9EVHe2fnUdIQKIOUm5AWEtCBUXLVk,22467
 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.3.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-atdd-0.3.1.dist-info/METADATA,sha256=xAWoy8Xg4lpkMoYfxoNn6gFJxUuX8lHE8fhT5Ns3DOw,7081
-atdd-0.3.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-atdd-0.3.1.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
-atdd-0.3.1.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
-atdd-0.3.1.dist-info/RECORD,,
+atdd-0.3.3.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+atdd-0.3.3.dist-info/METADATA,sha256=K0LQB_4qxlKQ4o7hmBpSDG2zMRoNVbI4QCUggzEb4ws,7081
+atdd-0.3.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+atdd-0.3.3.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
+atdd-0.3.3.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
+atdd-0.3.3.dist-info/RECORD,,