atdd 0.2.1__py3-none-any.whl → 0.2.4__py3-none-any.whl

atdd/__main__.py

@@ -1,4 +1,4 @@
-from .cli import main
+from .cli import cli
 
 if __name__ == "__main__":
-    main()
+    raise SystemExit(cli())

atdd/cli.py

@@ -10,6 +10,7 @@ The coach orchestrates all ATDD lifecycle operations:
 - Init: Initialize ATDD structure in consumer repos
 - Session: Manage session files
 - Sync: Sync ATDD rules to agent config files
+- Gate: Verify agents loaded ATDD rules
 
 Usage:
     atdd init                                # Initialize ATDD in consumer repo
@@ -19,6 +20,7 @@ Usage:
     atdd sync                                # Sync ATDD rules to agent configs
     atdd sync --verify                       # Check if files are in sync
     atdd sync --agent claude                 # Sync specific agent only
+    atdd gate                                # Show ATDD gate verification
     atdd --inventory                         # Generate inventory
     atdd --test all                          # Run all meta-tests
     atdd --test planner                      # Run planner phase tests
@@ -41,6 +43,8 @@ from atdd.coach.commands.registry import RegistryUpdater
 from atdd.coach.commands.initializer import ProjectInitializer
 from atdd.coach.commands.session import SessionManager
 from atdd.coach.commands.sync import AgentConfigSync
+from atdd.coach.commands.gate import ATDDGate
+from atdd.version_check import print_update_notice
 
 
 class ATDDCoach:
@@ -156,6 +160,10 @@ Examples:
   %(prog)s sync --agent claude            Sync specific agent only
   %(prog)s sync --status                  Show sync status
 
+  # ATDD gate verification
+  %(prog)s gate                           Show gate verification info
+  %(prog)s gate --json                    Output as JSON
+
   # Existing flag-based commands (backwards compatible)
   %(prog)s --inventory                    Generate full inventory (YAML)
   %(prog)s --inventory --format json      Generate inventory (JSON)
@@ -268,6 +276,18 @@ Phase descriptions:
         help="Show sync status for all agents"
     )
 
+    # ----- atdd gate -----
+    gate_parser = subparsers.add_parser(
+        "gate",
+        help="Show ATDD gate verification info",
+        description="Verify agents have loaded ATDD rules before starting work"
+    )
+    gate_parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Output as JSON for programmatic use"
+    )
+
     # ----- Existing flag-based arguments (backwards compatible) -----
 
     # Main command groups
@@ -367,6 +387,11 @@ Phase descriptions:
             return syncer.verify()
         return syncer.sync(agents=[args.agent] if args.agent else None)
 
+    # atdd gate
+    elif args.command == "gate":
+        gate = ATDDGate()
+        return gate.verify(json=args.json)
+
     # ----- Handle flag-based commands (backwards compatible) -----
 
     # Create coach instance
@@ -400,5 +425,14 @@ Phase descriptions:
         return 0
 
 
+def cli() -> int:
+    """CLI entry point with version check."""
+    try:
+        result = main()
+    finally:
+        print_update_notice()
+    return result
+
+
 if __name__ == "__main__":
-    sys.exit(main())
+    sys.exit(cli())

atdd/coach/commands/gate.py

@@ -0,0 +1,168 @@
+"""
+ATDD Gate verification command.
+
+Ensures agents have loaded and confirmed ATDD rules before starting work.
+Outputs the expected hash and key constraints for verification.
+
+Usage:
+    atdd gate                    # Show gate verification info
+    atdd gate --json             # Output as JSON for programmatic use
+"""
+import hashlib
+import json as json_module
+from pathlib import Path
+from typing import Dict, List, Optional
+
+from atdd.coach.commands.sync import AgentConfigSync
+
+
+class ATDDGate:
+    """ATDD Gate verification."""
+
+    # Key constraints agents must acknowledge
+    KEY_CONSTRAINTS = [
+        "No ad-hoc tests - follow ATDD conventions",
+        "Domain layer NEVER imports from other layers",
+        "Phase transitions require quality gates (INIT → PLANNED → RED → GREEN → REFACTOR)",
+    ]
+
+    def __init__(self, target_dir: Optional[Path] = None):
+        """
+        Initialize the ATDDGate.
+
+        Args:
+            target_dir: Target directory containing agent config files.
+        """
+        self.target_dir = target_dir or Path.cwd()
+        self.syncer = AgentConfigSync(self.target_dir)
+
+    def _compute_block_hash(self, content: str) -> Optional[str]:
+        """
+        Compute SHA256 hash of the managed block in content.
+
+        Args:
+            content: File content.
+
+        Returns:
+            SHA256 hash or None if no managed block found.
+        """
+        block, _, _ = self.syncer._extract_managed_block(content)
+        if block is None:
+            return None
+
+        return hashlib.sha256(block.encode()).hexdigest()
+
+    def _get_synced_files(self) -> Dict[str, Dict]:
+        """
+        Get info about synced agent config files.
+
+        Returns:
+            Dict mapping agent name to file info.
+        """
+        agents = self.syncer._get_enabled_agents()
+        result = {}
+
+        for agent in agents:
+            target_file = self.syncer.AGENT_FILES.get(agent)
+            if not target_file:
+                continue
+
+            target_path = self.target_dir / target_file
+            if not target_path.exists():
+                result[agent] = {
+                    "file": target_file,
+                    "exists": False,
+                    "hash": None,
+                }
+                continue
+
+            content = target_path.read_text()
+            block_hash = self._compute_block_hash(content)
+
+            result[agent] = {
+                "file": target_file,
+                "exists": True,
+                "has_block": block_hash is not None,
+                "hash": block_hash[:16] if block_hash else None,  # Short hash for display
+                "hash_full": block_hash,
+            }
+
+        return result
+
+    def verify(self, json: bool = False) -> int:
+        """
+        Output gate verification info.
+
+        Args:
+            json: If True, output as JSON.
+
+        Returns:
+            0 on success, 1 if no synced files found.
+        """
+        files = self._get_synced_files()
+
+        if not files:
+            print("No agent config files configured.")
+            print("Run 'atdd init' to set up ATDD in this repo.")
+            return 1
+
+        if json:
+            output = {
+                "files": files,
+                "constraints": self.KEY_CONSTRAINTS,
+            }
+            print(json_module.dumps(output, indent=2))
+            return 0
+
+        # Human-readable output
+        print("=" * 60)
+        print("ATDD Gate Verification")
+        print("=" * 60)
+
+        print("\nLoaded files:")
+        for agent, info in files.items():
+            if info["exists"] and info.get("has_block"):
+                print(f"  - {info['file']} (hash: {info['hash']}...)")
+            elif info["exists"]:
+                print(f"  - {info['file']} (no managed block)")
+            else:
+                print(f"  - {info['file']} (missing)")
+
+        print("\nKey constraints:")
+        for i, constraint in enumerate(self.KEY_CONSTRAINTS, 1):
+            print(f"  {i}. {constraint}")
+
+        print("\n" + "-" * 60)
+        print("Before starting work, confirm you have loaded these rules.")
+        print("-" * 60)
+
+        return 0
+
+    def get_confirmation_template(self) -> str:
+        """
+        Get a template agents can use to confirm gate compliance.
+
+        Returns:
+            Markdown template for gate confirmation.
+        """
+        files = self._get_synced_files()
+
+        lines = [
+            "## ATDD Gate Confirmation",
+            "",
+            "**Files loaded:**",
+        ]
+
+        for agent, info in files.items():
+            if info["exists"] and info.get("has_block"):
+                lines.append(f"- {info['file']} (hash: `{info['hash']}...`)")
+
+        lines.extend([
+            "",
+            "**Key constraints acknowledged:**",
+        ])
+
+        for constraint in self.KEY_CONSTRAINTS:
+            lines.append(f"- {constraint}")
+
+        return "\n".join(lines)

atdd/coach/templates/ATDD.md

@@ -4,6 +4,21 @@ missions:
   validate_phase_transitions: "Phase transitions and quality gates per conventions and schemas"
   required: true
 
+# ATDD Gate (REQUIRED before any work)
+# =====================================
+# Before starting ANY task, you MUST confirm you have loaded these rules.
+# Provide this confirmation at the start of your first response:
+#
+#   ## ATDD Gate Confirmation
+#   - **File loaded:** CLAUDE.md (or AGENTS.md, etc.)
+#   - **Key constraints:**
+#     1. No ad-hoc tests - follow ATDD conventions
+#     2. Domain layer NEVER imports from other layers
+#     3. Phase transitions require quality gates
+#
+# If you cannot provide this confirmation, STOP and reload the rules.
+# Run `atdd gate` to verify the expected values.
+
 manifest:
   - trains: "plan/_trains.yaml"
   - wagons: "plan/_wagons.yaml"

atdd/version_check.py

@@ -0,0 +1,126 @@
+"""
+Version check for ATDD CLI.
+
+Checks PyPI for newer versions and notifies users. Uses a cached check
+to avoid adding latency to every command.
+
+Cache location: ~/.atdd/version_cache.json
+Disable: Set ATDD_NO_UPDATE_CHECK=1 environment variable
+"""
+import json
+import os
+import sys
+import time
+from pathlib import Path
+from typing import Optional, Tuple
+from urllib.request import urlopen
+from urllib.error import URLError
+
+from atdd import __version__
+
+# Check once per day (86400 seconds)
+CHECK_INTERVAL = 86400
+CACHE_DIR = Path.home() / ".atdd"
+CACHE_FILE = CACHE_DIR / "version_cache.json"
+PYPI_URL = "https://pypi.org/pypi/atdd/json"
+
+
+def _parse_version(version: str) -> Tuple[int, ...]:
+    """Parse version string into tuple for comparison."""
+    try:
+        return tuple(int(x) for x in version.split(".")[:3])
+    except (ValueError, AttributeError):
+        return (0, 0, 0)
+
+
+def _is_newer(latest: str, current: str) -> bool:
+    """Check if latest version is newer than current."""
+    return _parse_version(latest) > _parse_version(current)
+
+
+def _load_cache() -> dict:
+    """Load version cache from disk."""
+    try:
+        if CACHE_FILE.exists():
+            with open(CACHE_FILE) as f:
+                return json.load(f)
+    except (json.JSONDecodeError, OSError):
+        pass
+    return {}
+
+
+def _save_cache(data: dict) -> None:
+    """Save version cache to disk."""
+    try:
+        CACHE_DIR.mkdir(parents=True, exist_ok=True)
+        with open(CACHE_FILE, "w") as f:
+            json.dump(data, f)
+    except OSError:
+        pass  # Silently fail if we can't write cache
+
+
+def _fetch_latest_version() -> Optional[str]:
+    """Fetch latest version from PyPI."""
+    try:
+        with urlopen(PYPI_URL, timeout=2) as response:
+            data = json.loads(response.read().decode())
+            return data.get("info", {}).get("version")
+    except (URLError, json.JSONDecodeError, OSError, TimeoutError):
+        return None
+
+
+def check_for_updates() -> Optional[str]:
+    """
+    Check for updates if cache is stale.
+
+    Returns:
+        Message to display if update available, None otherwise.
+    """
+    # Respect disable flag
+    if os.environ.get("ATDD_NO_UPDATE_CHECK", "").lower() in ("1", "true", "yes"):
+        return None
+
+    # Skip if running in development (version 0.0.0)
+    if __version__ == "0.0.0":
+        return None
+
+    cache = _load_cache()
+    now = time.time()
+    last_check = cache.get("last_check", 0)
+    cached_latest = cache.get("latest_version")
+
+    # Check if cache is fresh
+    if now - last_check < CHECK_INTERVAL and cached_latest:
+        latest = cached_latest
+    else:
+        # Fetch from PyPI
+        latest = _fetch_latest_version()
+        if latest:
+            _save_cache({
+                "last_check": now,
+                "latest_version": latest,
+            })
+        elif cached_latest:
+            # Use cached version if fetch failed
+            latest = cached_latest
+        else:
+            return None
+
+    # Compare versions
+    if latest and _is_newer(latest, __version__):
+        return (
+            f"\nA new version of atdd is available: {__version__} → {latest}\n"
+            f"Run `pip install --upgrade atdd` to update."
+        )
+
+    return None
+
+
+def print_update_notice() -> None:
+    """Print update notice to stderr if available."""
+    try:
+        notice = check_for_updates()
+        if notice:
+            print(notice, file=sys.stderr)
+    except Exception:
+        pass  # Never fail the main command due to version check

{atdd-0.2.1.dist-info → atdd-0.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.2.1
+Version: 0.2.4
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10
@@ -129,6 +129,38 @@ sync:
     # - qwen      # Uncomment to sync QWEN.md
 ```
 
+### ATDD Gate
+
+Verify agents have loaded ATDD rules before starting work:
+
+```bash
+atdd gate                  # Show gate verification info
+atdd gate --json           # Output as JSON for programmatic use
+```
+
+Example output:
+```
+============================================================
+ATDD Gate Verification
+============================================================
+
+Loaded files:
+  - CLAUDE.md (hash: d04f897c6691dc13...)
+
+Key constraints:
+  1. No ad-hoc tests - follow ATDD conventions
+  2. Domain layer NEVER imports from other layers
+  3. Phase transitions require quality gates
+
+------------------------------------------------------------
+Before starting work, confirm you have loaded these rules.
+------------------------------------------------------------
+```
+
+Agents should confirm at the start of each session:
+- Which ATDD file(s) they loaded
+- The key constraints they will follow
+
 ### Validation
 
 ```bash

{atdd-0.2.1.dist-info → atdd-0.2.4.dist-info}/RECORD

@@ -1,12 +1,14 @@
 atdd/__init__.py,sha256=-S8i9OahH-t9FJkPn6nprxipnjVum3rLeVsCS74T6eY,156
-atdd/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
-atdd/cli.py,sha256=POp59pszeoxh5KKJKWxkr0mrWv7-xlg1AWXhONEnipU,13149
+atdd/__main__.py,sha256=B0sXDQLjFN9GowTlXo4NMWwPZPjDsrT8Frq7DnbdOD8,77
+atdd/cli.py,sha256=ONdVyLKHb4PCCmRg2Qi9UCU6CScihKBdPSrzgtdHbg0,14149
 atdd/conftest.py,sha256=Fj3kIhCETbj2QBCIjySBgdS3stKNRZcZzKTJr7A4LaQ,5300
+atdd/version_check.py,sha256=B9MbbxO_sJrEC3fxFJhTlOIkLLTRQCDO1_8ec1KvuWY,3540
 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
 atdd/coach/commands/analyze_migrations.py,sha256=2bLfR7OwicBXAZWB4R3Sm4d5jFe87d0O_kO68X96ykU,6083
 atdd/coach/commands/consumers.py,sha256=7vTexse8xznXSzNWjPGYuF4iJ8ZWymmOSkpcA6IWyxU,27514
+atdd/coach/commands/gate.py,sha256=Snua6kLXV1AE8xV67O5rmbWotFafdEXaN6OF_vnKrr0,4942
 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/interface.py,sha256=PPCwICFNN4ddPqucUATIiBrfEkDO66MZbYQkwNu6lm4,40459
@@ -25,7 +27,7 @@ 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=I3pI2EeAQselGqB_-ZDKM6UyIFLp8OSEGUhckDTYIrk,10803
+atdd/coach/templates/ATDD.md,sha256=oHZi7g-quHSmE4NPhN20AFSPrB2N03lzeuldX3LG8Xk,11410
 atdd/coach/templates/SESSION-TEMPLATE.md,sha256=p_AwdV9ktKS-FGcg8ocDso74NdR7yeMEQO3dJmeb4VQ,8647
 atdd/coach/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atdd/coach/utils/graph/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -176,9 +178,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.2.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-atdd-0.2.1.dist-info/METADATA,sha256=ePniZ2i1mFTZaHz4dQrXpsxYxq0o0QWUD3K2HA5qS-o,5215
-atdd-0.2.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-atdd-0.2.1.dist-info/entry_points.txt,sha256=z0s90AA3SVM-A2hXQiOw-V3B_ygwqdgeib4-NbKTMyQ,39
-atdd-0.2.1.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
-atdd-0.2.1.dist-info/RECORD,,
+atdd-0.2.4.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+atdd-0.2.4.dist-info/METADATA,sha256=vahm6OJ7nJ8Sb__7-2nWWprbq2D3Q92kAHoV5sJSkZ0,6119
+atdd-0.2.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+atdd-0.2.4.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
+atdd-0.2.4.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
+atdd-0.2.4.dist-info/RECORD,,

atdd-0.2.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+atdd = atdd.cli:cli

atdd-0.2.1.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-atdd = atdd.cli:main