atdd 0.1.0__tar.gz → 0.2.6__tar.gz

{atdd-0.1.0/src/atdd.egg-info → atdd-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.1.0
+Version: 0.2.6
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10
@@ -18,10 +18,10 @@ Acceptance Test Driven Development toolkit for structured planning and conventio
 
 ## Installation
 
-### From GitHub (recommended for now)
+### From PyPI
 
 ```bash
-pip install git+https://github.com/afokapu/atdd.git
+pip install atdd
 ```
 
 ### For Development
@@ -38,13 +38,6 @@ pip install -e ".[dev]"
 atdd --help
 ```
 
-### Future: PyPI
-
-Once published to PyPI:
-```bash
-pip install atdd
-```
-
 ## Quick Start
 
 ```bash
@@ -57,6 +50,9 @@ atdd session new my-feature
 # List sessions
 atdd session list
 
+# Sync ATDD rules to agent config files
+atdd sync
+
 # Run validators
 atdd --test all
 ```
@@ -68,24 +64,27 @@ ATDD provides:
 1. **Session Management** - Structured planning documents with templates and tracking
 2. **Convention Enforcement** - YAML-based conventions validated via pytest
 3. **ATDD Lifecycle** - Planner → Tester → Coder phase gates
+4. **Agent Config Sync** - Keep ATDD rules in sync across AI agent config files
 
 ## Commands
 
 ### Project Initialization
 
 ```bash
-atdd init              # Create atdd-sessions/ and .atdd/ directories
+atdd init              # Create atdd-sessions/, .atdd/, and CLAUDE.md
 atdd init --force      # Reinitialize (overwrites existing)
 ```
 
 Creates:
 ```
 your-project/
+├── CLAUDE.md              # With managed ATDD block
 ├── atdd-sessions/
 │   ├── SESSION-TEMPLATE.md
 │   └── archive/
 └── .atdd/
-    └── manifest.yaml
+    ├── manifest.yaml      # Session tracking
+    └── config.yaml        # Agent sync configuration
 ```
 
 ### Session Management
@@ -100,6 +99,99 @@ atdd session sync                       # Sync manifest with files
 
 Session types: `implementation`, `migration`, `refactor`, `analysis`, `planning`, `cleanup`, `tracking`
 
+### Agent Config Sync
+
+Sync ATDD rules to agent config files using managed blocks that preserve user content:
+
+```bash
+atdd sync                  # Sync all enabled agents from config
+atdd sync --agent claude   # Sync specific agent only
+atdd sync --verify         # Check if files are in sync (for CI)
+atdd sync --status         # Show sync status for all agents
+```
+
+Supported agents:
+| Agent | File |
+|-------|------|
+| claude | CLAUDE.md |
+| codex | AGENTS.md |
+| gemini | GEMINI.md |
+| qwen | QWEN.md |
+
+Configure which agents to sync in `.atdd/config.yaml`:
+```yaml
+version: "1.0"
+sync:
+  agents:
+    - claude      # Enabled by default
+    # - codex     # Uncomment to sync AGENTS.md
+    # - gemini    # Uncomment to sync GEMINI.md
+    # - 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 (Bootstrap Protocol)
+
+Agents often skip instruction files. The gate solves this by injecting rules via mandatory tool output.
+
+**Protocol:**
+
+1. Run this command first:
+   ```bash
+   atdd gate
+   ```
+
+2. Agent must paste output and confirm:
+   - Which file(s) were loaded
+   - The reported hash
+   - The key constraints
+
+3. If files are missing/unsynced:
+   ```bash
+   atdd sync
+   atdd gate  # Re-verify
+   ```
+
+**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.
+------------------------------------------------------------
+```
+
+**Why this works:**
+- Gate output is mandatory tool output - agent can't ignore it
+- Proves which ATDD files were actually loaded
+- Forces consistency across all agents
+
+**Rule:** If ATDD rules matter, start with `atdd gate`. No gate = no guarantees.
+
 ### Validation
 
 ```bash
@@ -126,8 +218,9 @@ src/atdd/
 ├── coach/
 │   ├── commands/          # CLI command implementations
 │   ├── conventions/       # Coach conventions (YAML)
+│   ├── overlays/          # Agent-specific additions
 │   ├── schemas/           # JSON schemas
-│   ├── templates/         # Session templates
+│   ├── templates/         # Session templates, ATDD.md
 │   └── validators/        # Coach validators
 ├── planner/
 │   ├── conventions/       # Planning conventions

{atdd-0.1.0 → atdd-0.2.6}/README.md

@@ -4,10 +4,10 @@ Acceptance Test Driven Development toolkit for structured planning and conventio
 
 ## Installation
 
-### From GitHub (recommended for now)
+### From PyPI
 
 ```bash
-pip install git+https://github.com/afokapu/atdd.git
+pip install atdd
 ```
 
 ### For Development
@@ -24,13 +24,6 @@ pip install -e ".[dev]"
 atdd --help
 ```
 
-### Future: PyPI
-
-Once published to PyPI:
-```bash
-pip install atdd
-```
-
 ## Quick Start
 
 ```bash
@@ -43,6 +36,9 @@ atdd session new my-feature
 # List sessions
 atdd session list
 
+# Sync ATDD rules to agent config files
+atdd sync
+
 # Run validators
 atdd --test all
 ```
@@ -54,24 +50,27 @@ ATDD provides:
 1. **Session Management** - Structured planning documents with templates and tracking
 2. **Convention Enforcement** - YAML-based conventions validated via pytest
 3. **ATDD Lifecycle** - Planner → Tester → Coder phase gates
+4. **Agent Config Sync** - Keep ATDD rules in sync across AI agent config files
 
 ## Commands
 
 ### Project Initialization
 
 ```bash
-atdd init              # Create atdd-sessions/ and .atdd/ directories
+atdd init              # Create atdd-sessions/, .atdd/, and CLAUDE.md
 atdd init --force      # Reinitialize (overwrites existing)
 ```
 
 Creates:
 ```
 your-project/
+├── CLAUDE.md              # With managed ATDD block
 ├── atdd-sessions/
 │   ├── SESSION-TEMPLATE.md
 │   └── archive/
 └── .atdd/
-    └── manifest.yaml
+    ├── manifest.yaml      # Session tracking
+    └── config.yaml        # Agent sync configuration
 ```
 
 ### Session Management
@@ -86,6 +85,99 @@ atdd session sync                       # Sync manifest with files
 
 Session types: `implementation`, `migration`, `refactor`, `analysis`, `planning`, `cleanup`, `tracking`
 
+### Agent Config Sync
+
+Sync ATDD rules to agent config files using managed blocks that preserve user content:
+
+```bash
+atdd sync                  # Sync all enabled agents from config
+atdd sync --agent claude   # Sync specific agent only
+atdd sync --verify         # Check if files are in sync (for CI)
+atdd sync --status         # Show sync status for all agents
+```
+
+Supported agents:
+| Agent | File |
+|-------|------|
+| claude | CLAUDE.md |
+| codex | AGENTS.md |
+| gemini | GEMINI.md |
+| qwen | QWEN.md |
+
+Configure which agents to sync in `.atdd/config.yaml`:
+```yaml
+version: "1.0"
+sync:
+  agents:
+    - claude      # Enabled by default
+    # - codex     # Uncomment to sync AGENTS.md
+    # - gemini    # Uncomment to sync GEMINI.md
+    # - 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 (Bootstrap Protocol)
+
+Agents often skip instruction files. The gate solves this by injecting rules via mandatory tool output.
+
+**Protocol:**
+
+1. Run this command first:
+   ```bash
+   atdd gate
+   ```
+
+2. Agent must paste output and confirm:
+   - Which file(s) were loaded
+   - The reported hash
+   - The key constraints
+
+3. If files are missing/unsynced:
+   ```bash
+   atdd sync
+   atdd gate  # Re-verify
+   ```
+
+**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.
+------------------------------------------------------------
+```
+
+**Why this works:**
+- Gate output is mandatory tool output - agent can't ignore it
+- Proves which ATDD files were actually loaded
+- Forces consistency across all agents
+
+**Rule:** If ATDD rules matter, start with `atdd gate`. No gate = no guarantees.
+
 ### Validation
 
 ```bash
@@ -112,8 +204,9 @@ src/atdd/
 ├── coach/
 │   ├── commands/          # CLI command implementations
 │   ├── conventions/       # Coach conventions (YAML)
+│   ├── overlays/          # Agent-specific additions
 │   ├── schemas/           # JSON schemas
-│   ├── templates/         # Session templates
+│   ├── templates/         # Session templates, ATDD.md
 │   └── validators/        # Coach validators
 ├── planner/
 │   ├── conventions/       # Planning conventions

{atdd-0.1.0 → atdd-0.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "atdd"
-version = "0.1.0"
+version = "0.2.6"
 description = "ATDD Platform - Acceptance Test Driven Development toolkit"
 requires-python = ">=3.10"
 readme = "README.md"
@@ -15,7 +15,7 @@ dependencies = ["pyyaml"]
 dev = ["pytest", "pytest-xdist"]
 
 [project.scripts]
-atdd = "atdd.cli:main"
+atdd = "atdd.cli:cli"
 
 [tool.setuptools.packages.find]
 where = ["src"]

atdd-0.2.6/src/atdd/__init__.py

@@ -0,0 +1,6 @@
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("atdd")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

atdd-0.2.6/src/atdd/__main__.py

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

{atdd-0.1.0 → atdd-0.2.6}/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,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-0.2.6/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.1.0 → atdd-0.2.6}/src/atdd/coach/templates/ATDD.md

@@ -4,6 +4,42 @@ missions:
   validate_phase_transitions: "Phase transitions and quality gates per conventions and schemas"
   required: true
 
+# =============================================================================
+# ATDD AGENT BOOTSTRAP PROTOCOL (REQUIRED)
+# =============================================================================
+#
+# Problem: Agents often skip instruction files and work without ATDD context.
+# Solution: Coercive context - inject rules via mandatory tool output.
+#
+# PROTOCOL:
+# ---------
+# 1. Run this command FIRST:
+#
+#    atdd gate
+#
+# 2. Paste the output and confirm:
+#    - Which file(s) were loaded
+#    - The reported hash
+#    - The key ATDD constraints
+#
+# 3. If output shows missing/unsynced files, run:
+#
+#    atdd sync
+#
+#    Then re-run: atdd gate
+#
+# WHY THIS WORKS:
+# - Gate output is mandatory tool output - agent can't ignore it
+# - Proves which ATDD files were actually loaded
+# - Forces consistency across all agents
+#
+# FAILURE MODE:
+# - If agent skips the gate: STOP and run atdd gate again
+# - Don't proceed until gate confirmation is posted
+#
+# RULE: If ATDD rules matter, start with `atdd gate`. No gate = no guarantees.
+# =============================================================================
+
 manifest:
   - trains: "plan/_trains.yaml"
   - wagons: "plan/_wagons.yaml"