atdd 0.2.3__tar.gz → 0.2.5__tar.gz

{atdd-0.2.3/src/atdd.egg-info → atdd-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.2.3
+Version: 0.2.5
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10
@@ -129,6 +129,53 @@ sync:
     # - qwen      # Uncomment to sync QWEN.md
 ```
 
+**Multi-agent setup:** To use multiple agents with consistent rules, enable them all in config and run sync:
+
+```yaml
+sync:
+  agents:
+    - claude
+    - codex
+    - gemini
+    - qwen
+```
+
+```bash
+atdd sync  # Creates/updates CLAUDE.md, AGENTS.md, GEMINI.md, 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.3 → atdd-0.2.5}/README.md

@@ -115,6 +115,53 @@ sync:
     # - qwen      # Uncomment to sync QWEN.md
 ```
 
+**Multi-agent setup:** To use multiple agents with consistent rules, enable them all in config and run sync:
+
+```yaml
+sync:
+  agents:
+    - claude
+    - codex
+    - gemini
+    - qwen
+```
+
+```bash
+atdd sync  # Creates/updates CLAUDE.md, AGENTS.md, GEMINI.md, 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.3 → atdd-0.2.5}/pyproject.toml

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

{atdd-0.2.3 → atdd-0.2.5}/src/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,7 @@ 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
 
 
@@ -157,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)
@@ -269,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
@@ -368,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

atdd-0.2.5/src/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-0.2.3 → atdd-0.2.5}/src/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-0.2.3 → atdd-0.2.5/src/atdd.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.2.3
+Version: 0.2.5
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10
@@ -129,6 +129,53 @@ sync:
     # - qwen      # Uncomment to sync QWEN.md
 ```
 
+**Multi-agent setup:** To use multiple agents with consistent rules, enable them all in config and run sync:
+
+```yaml
+sync:
+  agents:
+    - claude
+    - codex
+    - gemini
+    - qwen
+```
+
+```bash
+atdd sync  # Creates/updates CLAUDE.md, AGENTS.md, GEMINI.md, 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.3 → atdd-0.2.5}/src/atdd.egg-info/SOURCES.txt

@@ -17,6 +17,7 @@ src/atdd/coach/commands/__init__.py
 src/atdd/coach/commands/add_persistence_metadata.py
 src/atdd/coach/commands/analyze_migrations.py
 src/atdd/coach/commands/consumers.py
+src/atdd/coach/commands/gate.py
 src/atdd/coach/commands/infer_governance_status.py
 src/atdd/coach/commands/initializer.py
 src/atdd/coach/commands/interface.py