atdd 0.2.12__tar.gz → 0.4.1__tar.gz

{atdd-0.2.12/src/atdd.egg-info → atdd-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.2.12
+Version: 0.4.1
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10
@@ -16,6 +16,15 @@ Dynamic: license-file
 
 Acceptance Test Driven Development toolkit for structured planning and convention enforcement.
 
+ATDD covers the full software lifecycle, not just code. It starts from a job to be done (e.g., user problem or goal), turns it into deterministic requirements, validates them with tests, and then drives implementation.
+
+```mermaid
+flowchart LR
+    A[Job to be Done] -->|Planner| B[Wagon + Acceptance Criteria]
+    B -->|Tester| C[RED Tests]
+    C -->|Coder| D[GREEN Code]
+```
+
 ## Installation
 
 ### From PyPI
@@ -49,9 +58,9 @@ atdd --help
 ```bash
 atdd init                      # Initialize ATDD in your project
 atdd gate                      # ⚠️ START EVERY SESSION WITH THIS
-atdd session new my-feature    # Create a planning session
+atdd session new <capability>    # Create a planning session
 atdd sync                      # Sync rules to agent config files
-atdd --test all                # Run validators
+atdd validate                  # Run all validators
 ```
 
 > **⚠️ `atdd gate` is required.** 
@@ -67,6 +76,22 @@ ATDD provides:
 3. **ATDD Lifecycle** - Planner → Tester → Coder phase gates
 4. **Agent Config Sync** - Keep ATDD rules in sync across AI agent config files
 
+```mermaid
+flowchart LR
+    A[Job to be Done] -->|Planner| B[Wagon + Acceptance Criteria]
+    B -->|Tester| C[RED Tests]
+    C -->|Coder| D[GREEN Code]
+    D -->|Coder| E[REFACTOR]
+    E -.->|feedback| B
+
+    subgraph "ATDD Lifecycle"
+        B
+        C
+        D
+        E
+    end
+```
+
 ## Commands
 
 ### Project Initialization
@@ -196,19 +221,23 @@ Before starting work, confirm you have loaded these rules.
 ### Validation
 
 ```bash
-atdd --test all        # Run all validators
-atdd --test planner    # Planning artifacts only
-atdd --test tester     # Testing artifacts only
-atdd --test coder      # Implementation only
-atdd --quick           # Fast smoke test
+atdd validate              # Run all validators
+atdd validate planner      # Planning validators only
+atdd validate tester       # Testing validators only
+atdd validate coder        # Implementation validators only
+atdd validate --quick      # Fast smoke test
+atdd validate --coverage   # With coverage report
+atdd validate --html       # With HTML report
 ```
 
 ### Other Commands
 
 ```bash
-atdd --status          # Platform status
-atdd --inventory       # Generate artifact inventory
-atdd --help            # Full help
+atdd status                    # Platform status
+atdd inventory                 # Generate artifact inventory
+atdd inventory --format json   # Inventory as JSON
+atdd registry update           # Update all registries
+atdd --help                    # Full help
 ```
 
 ## Project Structure
@@ -264,7 +293,7 @@ pytest --cov=atdd --cov-report=html
 
 1. Create `src/atdd/{phase}/validators/test_{name}.py`
 2. Write pytest test functions
-3. Run `atdd --test {phase}`
+3. Run `atdd validate {phase}`
 
 Validators are auto-discovered by pytest.
 

{atdd-0.2.12 → atdd-0.4.1}/README.md

@@ -2,6 +2,15 @@
 
 Acceptance Test Driven Development toolkit for structured planning and convention enforcement.
 
+ATDD covers the full software lifecycle, not just code. It starts from a job to be done (e.g., user problem or goal), turns it into deterministic requirements, validates them with tests, and then drives implementation.
+
+```mermaid
+flowchart LR
+    A[Job to be Done] -->|Planner| B[Wagon + Acceptance Criteria]
+    B -->|Tester| C[RED Tests]
+    C -->|Coder| D[GREEN Code]
+```
+
 ## Installation
 
 ### From PyPI
@@ -35,9 +44,9 @@ atdd --help
 ```bash
 atdd init                      # Initialize ATDD in your project
 atdd gate                      # ⚠️ START EVERY SESSION WITH THIS
-atdd session new my-feature    # Create a planning session
+atdd session new <capability>    # Create a planning session
 atdd sync                      # Sync rules to agent config files
-atdd --test all                # Run validators
+atdd validate                  # Run all validators
 ```
 
 > **⚠️ `atdd gate` is required.** 
@@ -53,6 +62,22 @@ ATDD provides:
 3. **ATDD Lifecycle** - Planner → Tester → Coder phase gates
 4. **Agent Config Sync** - Keep ATDD rules in sync across AI agent config files
 
+```mermaid
+flowchart LR
+    A[Job to be Done] -->|Planner| B[Wagon + Acceptance Criteria]
+    B -->|Tester| C[RED Tests]
+    C -->|Coder| D[GREEN Code]
+    D -->|Coder| E[REFACTOR]
+    E -.->|feedback| B
+
+    subgraph "ATDD Lifecycle"
+        B
+        C
+        D
+        E
+    end
+```
+
 ## Commands
 
 ### Project Initialization
@@ -182,19 +207,23 @@ Before starting work, confirm you have loaded these rules.
 ### Validation
 
 ```bash
-atdd --test all        # Run all validators
-atdd --test planner    # Planning artifacts only
-atdd --test tester     # Testing artifacts only
-atdd --test coder      # Implementation only
-atdd --quick           # Fast smoke test
+atdd validate              # Run all validators
+atdd validate planner      # Planning validators only
+atdd validate tester       # Testing validators only
+atdd validate coder        # Implementation validators only
+atdd validate --quick      # Fast smoke test
+atdd validate --coverage   # With coverage report
+atdd validate --html       # With HTML report
 ```
 
 ### Other Commands
 
 ```bash
-atdd --status          # Platform status
-atdd --inventory       # Generate artifact inventory
-atdd --help            # Full help
+atdd status                    # Platform status
+atdd inventory                 # Generate artifact inventory
+atdd inventory --format json   # Inventory as JSON
+atdd registry update           # Update all registries
+atdd --help                    # Full help
 ```
 
 ## Project Structure
@@ -250,7 +279,7 @@ pytest --cov=atdd --cov-report=html
 
 1. Create `src/atdd/{phase}/validators/test_{name}.py`
 2. Write pytest test functions
-3. Run `atdd --test {phase}`
+3. Run `atdd validate {phase}`
 
 Validators are auto-discovered by pytest.
 

{atdd-0.2.12 → atdd-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "atdd"
-version = "0.2.12"
+version = "0.4.1"
 description = "ATDD Platform - Acceptance Test Driven Development toolkit"
 requires-python = ">=3.10"
 readme = "README.md"
@@ -35,3 +35,8 @@ where = ["src"]
 [tool.pytest.ini_options]
 pythonpath = ["src"]
 testpaths = ["src/atdd"]
+markers = [
+    "tester: marks tests as tester validators",
+    "platform: marks tests as platform validators",
+    "security: marks tests as security validators",
+]