atdd 0.1.0__py3-none-any.whl

atdd/tester/schemas/telemetry_tracking_manifest.schema.json

@@ -0,0 +1,143 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "telemetry-tracking-manifest-schema",
+  "title": "Telemetry Tracking Manifest Schema",
+  "description": "Schema for telemetry/_tracking.yaml manifest file",
+  "type": "object",
+  "required": ["version", "planes", "measures", "artifacts"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the manifest"
+    },
+    "planes": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["ui", "ux", "be", "db", "nw", "st", "tm", "sc", "au", "fn", "if"]
+      },
+      "minItems": 1,
+      "uniqueItems": true,
+      "description": "Valid plane identifiers"
+    },
+    "measures": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "latency",
+          "duration",
+          "count",
+          "size",
+          "error_rate",
+          "success_rate",
+          "throughput"
+        ]
+      },
+      "minItems": 1,
+      "uniqueItems": true,
+      "description": "Valid measure types"
+    },
+    "artifacts": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/artifact_entry"
+      },
+      "minItems": 1,
+      "description": "Array of artifact signal declarations"
+    }
+  },
+  "definitions": {
+    "artifact_entry": {
+      "type": "object",
+      "required": ["artifact", "contract_ref", "signals"],
+      "properties": {
+        "artifact": {
+          "type": "string",
+          "pattern": "^[a-z_]+:[a-z_]+(\\.[a-z_]+)?$",
+          "description": "Artifact identifier in domain:resource[.category] format"
+        },
+        "contract_ref": {
+          "type": "string",
+          "pattern": "^contract:[a-z_]+:[a-z_]+(\\.[a-z_]+)?$",
+          "description": "Contract reference (supports category facets)"
+        },
+        "signals": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/signal_declaration"
+          },
+          "minItems": 1,
+          "description": "Array of signal declarations for this artifact"
+        }
+      },
+      "additionalProperties": false
+    },
+    "signal_declaration": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["event", "metric", "trace", "log"],
+          "description": "Signal type"
+        },
+        "plane": {
+          "type": "string",
+          "enum": ["ui", "ux", "be", "db", "nw", "st", "tm", "sc", "au", "fn", "if"],
+          "description": "Plane identifier (required for metric/trace)"
+        },
+        "measure": {
+          "type": "string",
+          "enum": [
+            "latency",
+            "duration",
+            "count",
+            "size",
+            "error_rate",
+            "success_rate",
+            "throughput"
+          ],
+          "description": "Measure type (required for metric)"
+        },
+        "unit": {
+          "type": "string",
+          "description": "Unit of measurement (e.g., ms, bytes, count)"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "type": { "const": "metric" } }
+          },
+          "then": {
+            "required": ["plane", "measure"]
+          }
+        },
+        {
+          "if": {
+            "properties": { "type": { "const": "trace" } }
+          },
+          "then": {
+            "required": ["plane"]
+          }
+        },
+        {
+          "if": {
+            "properties": { "type": { "const": "event" } }
+          },
+          "then": {
+            "not": {
+              "anyOf": [
+                { "required": ["plane"] },
+                { "required": ["measure"] }
+              ]
+            }
+          }
+        }
+      ],
+      "additionalProperties": false
+    }
+  }
+}

atdd/tester/schemas/test_filename.schema.json

@@ -0,0 +1,194 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wagons.dev/schemas/tester/test_filename.schema.json",
+  "title": "Test Filename Generation Schema",
+  "description": "Schema for test filename generation from acceptance URNs with language-specific conventions",
+  "type": "object",
+  "required": ["urn", "language"],
+  "properties": {
+    "urn": {
+      "type": "string",
+      "description": "Acceptance URN in format acc:{wagon}:{WMBT}-{HARNESS}-{NNN}[-{slug}]",
+      "pattern": "^acc:([a-z][a-z0-9-]*):([DLPCEMYRK][0-9]{3})-([A-Z0-9]+)-([0-9]{3})(?:-([a-z0-9-]+))?$",
+      "examples": [
+        "acc:maintain-ux:C004-E2E-019-user-connection",
+        "acc:pace-dilemmas:P003-UNIT-042",
+        "acc:commit-state:D001-HTTP-007"
+      ]
+    },
+    "language": {
+      "type": "string",
+      "description": "Target language for test filename generation",
+      "enum": ["dart", "typescript", "typescript_preact", "python", "go", "java", "kotlin"],
+      "examples": ["dart", "typescript", "typescript_preact"]
+    },
+    "filename": {
+      "type": "string",
+      "description": "Generated test filename following language conventions",
+      "examples": [
+        "C004_E2E_019_user_connection_test.dart",
+        "c004-e2e-019-user-connection.test.ts",
+        "C001_WIDGET_001_button.test.tsx",
+        "test_c004_e2e_019_user_connection.py"
+      ]
+    },
+    "components": {
+      "type": "object",
+      "description": "Parsed URN components",
+      "properties": {
+        "wagon": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Wagon identifier in kebab-case",
+          "examples": ["maintain-ux", "pace-dilemmas"]
+        },
+        "WMBT": {
+          "type": "string",
+          "pattern": "^[DLPCEMYRK][0-9]{3}$",
+          "description": "Step code + zero-padded WMBT sequence",
+          "examples": ["C004", "E019", "P003"]
+        },
+        "HARNESS": {
+          "type": "string",
+          "pattern": "^[A-Z0-9]+$",
+          "description": "Test harness code (uppercase)",
+          "examples": ["UNIT", "HTTP", "E2E", "EVENT", "WIDGET"]
+        },
+        "NNN": {
+          "type": "string",
+          "pattern": "^[0-9]{3}$",
+          "description": "Zero-padded 3-digit acceptance sequence",
+          "examples": ["001", "019", "042"]
+        },
+        "slug": {
+          "type": ["string", "null"],
+          "pattern": "^[a-z0-9-]+$",
+          "description": "Optional kebab-case descriptor",
+          "examples": ["user-connection", "primitive-endpoint", null]
+        }
+      },
+      "required": ["wagon", "WMBT", "HARNESS", "NNN"],
+      "additionalProperties": false
+    }
+  },
+  "definitions": {
+    "dart_filename": {
+      "type": "string",
+      "pattern": "^[A-Z][0-9]{3}_[A-Z0-9]+_[0-9]{3}(?:_[a-z0-9_]+)?_test\\.dart$",
+      "description": "Dart test filename pattern: {WMBT}_{HARNESS}_{NNN}[_{slug_snake}]_test.dart",
+      "examples": [
+        "C004_E2E_019_user_connection_test.dart",
+        "P003_UNIT_042_test.dart"
+      ]
+    },
+    "typescript_filename": {
+      "type": "string",
+      "pattern": "^[a-z][0-9]{3}-[a-z0-9]+-[0-9]{3}(?:-[a-z0-9-]+)?\\.test\\.ts$",
+      "description": "TypeScript test filename pattern: {wmbt_lower}-{harness_lower}-{nnn}[-{slug-kebab}].test.ts",
+      "examples": [
+        "c004-e2e-019-user-connection.test.ts",
+        "p003-unit-042.test.ts"
+      ]
+    },
+    "typescript_preact_filename": {
+      "type": "string",
+      "pattern": "^[A-Z][0-9]{3}_[A-Z0-9]+_[0-9]{3}(?:_[a-z0-9_]+)?\\.test\\.ts(x)?$",
+      "description": "Preact TypeScript test filename pattern: {WMBT}_{HARNESS}_{NNN}[_{slug_snake}].test.ts[x]",
+      "examples": [
+        "C004_E2E_019_user_connection.test.ts",
+        "C001_WIDGET_001_button.test.tsx"
+      ]
+    },
+    "python_filename": {
+      "type": "string",
+      "pattern": "^test_[a-z][0-9]{3}_[a-z0-9]+_[0-9]{3}(?:_[a-z0-9_]+)?\\.py$",
+      "description": "Python test filename pattern: test_{wmbt_lower}_{harness_lower}_{nnn}[_{slug_snake}].py",
+      "examples": [
+        "test_c004_e2e_019_user_connection.py",
+        "test_p003_unit_042.py"
+      ]
+    },
+    "go_filename": {
+      "type": "string",
+      "pattern": "^[a-z][0-9]{3}_[a-z0-9]+_[0-9]{3}(?:_[a-z0-9_]+)?_test\\.go$",
+      "description": "Go test filename pattern: {wmbt_lower}_{harness_lower}_{nnn}[_{slug_snake}]_test.go",
+      "examples": [
+        "c004_e2e_019_user_connection_test.go",
+        "p003_unit_042_test.go"
+      ]
+    },
+    "java_classname": {
+      "type": "string",
+      "pattern": "^[A-Z][0-9]{3}[A-Z0-9]+[0-9]{3}(?:[A-Z][a-zA-Z0-9]*)?Test$",
+      "description": "Java/Kotlin test classname pattern: {WMBT}{HARNESS}{NNN}{SlugPascal}Test",
+      "examples": [
+        "C004E2E019UserConnectionTest",
+        "P003UNIT042Test"
+      ]
+    },
+    "harness_code": {
+      "type": "string",
+      "enum": [
+        "UNIT", "HTTP", "EVENT", "WS", "E2E", "A11Y", "VIS",
+        "METRIC", "JOB", "DB", "SEC", "LOAD", "SCRIPT",
+        "WIDGET", "GOLDEN", "BLOC", "INTEGRATION", "RLS",
+        "EDGE", "REALTIME", "STORAGE"
+      ],
+      "description": "Valid test harness codes"
+    },
+    "wmbt_code": {
+      "type": "string",
+      "enum": ["D", "L", "P", "C", "E", "M", "Y", "R", "K"],
+      "description": "Valid WMBT step codes",
+      "x-descriptions": {
+        "D": "Derive (Derive Entities)",
+        "L": "Launch (Launch Cascade)",
+        "P": "Pace (Pace Dilemmas)",
+        "C": "Commit (Commit State)",
+        "E": "Evaluate (Evaluate Cascade)",
+        "M": "Match (Match Priorities)",
+        "Y": "Yield (Yield Options)",
+        "R": "Resolve (Resolve Dilemmas)",
+        "K": "Keep (Keep Momentum)"
+      }
+    }
+  },
+  "examples": [
+    {
+      "urn": "acc:maintain-ux:C004-E2E-019-user-connection",
+      "language": "dart",
+      "filename": "C004_E2E_019_user_connection_test.dart",
+      "components": {
+        "wagon": "maintain-ux",
+        "WMBT": "C004",
+        "HARNESS": "E2E",
+        "NNN": "019",
+        "slug": "user-connection"
+      }
+    },
+    {
+      "urn": "acc:pace-dilemmas:P003-UNIT-042",
+      "language": "python",
+      "filename": "test_p003_unit_042.py",
+      "components": {
+        "wagon": "pace-dilemmas",
+        "WMBT": "P003",
+        "HARNESS": "UNIT",
+        "NNN": "042",
+        "slug": null
+      }
+    },
+    {
+      "urn": "acc:commit-state:D001-HTTP-007-create-endpoint",
+      "language": "typescript",
+      "filename": "d001-http-007-create-endpoint.test.ts",
+      "components": {
+        "wagon": "commit-state",
+        "WMBT": "D001",
+        "HARNESS": "HTTP",
+        "NNN": "007",
+        "slug": "create-endpoint"
+      }
+    }
+  ]
+}

atdd/tester/schemas/test_intent.schema.json

@@ -0,0 +1,179 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "test_intent.schema.json",
+  "title": "Test Intent Structure",
+  "description": "Schema for test intent built from acceptance criteria during RED test generation",
+  "type": "object",
+  "required": [
+    "identity",
+    "harness",
+    "given",
+    "when",
+    "then",
+    "metadata",
+    "contract_schema"
+  ],
+  "properties": {
+    "identity": {
+      "type": "object",
+      "description": "Test identity information",
+      "required": ["urn", "id", "phase"],
+      "properties": {
+        "urn": {
+          "type": "string",
+          "description": "Unique resource name for the test",
+          "pattern": "^acc:"
+        },
+        "id": {
+          "type": "string",
+          "description": "Acceptance criteria ID"
+        },
+        "phase": {
+          "type": "string",
+          "description": "ATDD phase (RED, GREEN, REFACTOR)",
+          "enum": ["RED", "GREEN", "REFACTOR"]
+        }
+      }
+    },
+    "harness": {
+      "type": "object",
+      "description": "Test harness information",
+      "required": ["type", "category"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "Harness type",
+          "enum": [
+            "unit", "http", "event", "ws", "e2e", "db",
+            "widget", "bloc", "golden", "a11y", "visual",
+            "integration", "metric", "job", "load", "sec", "script",
+            "rls", "edge_function", "realtime", "storage"
+          ]
+        },
+        "category": {
+          "type": "string",
+          "description": "Harness category",
+          "enum": ["frontend", "backend", "integration"]
+        }
+      }
+    },
+    "given": {
+      "type": "object",
+      "description": "Test preconditions",
+      "properties": {
+        "auth": {
+          "type": ["object", "null"],
+          "description": "Authentication setup"
+        },
+        "data": {
+          "type": ["object", "array", "null"],
+          "description": "Initial data state"
+        },
+        "environment": {
+          "type": ["object", "null"],
+          "description": "Environment configuration"
+        }
+      }
+    },
+    "when": {
+      "type": "object",
+      "description": "Test action",
+      "required": ["action"],
+      "properties": {
+        "action": {
+          "type": "string",
+          "description": "Action to perform"
+        },
+        "target": {
+          "type": "string",
+          "description": "Action target (endpoint, function, component)"
+        },
+        "parameters": {
+          "type": ["object", "array", "null"],
+          "description": "Action parameters"
+        }
+      }
+    },
+    "then": {
+      "type": "object",
+      "description": "Expected outcomes",
+      "required": ["assertions"],
+      "properties": {
+        "assertions": {
+          "type": "array",
+          "description": "List of assertions to verify",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1
+        },
+        "red_strategy": {
+          "type": "string",
+          "description": "Strategy for ensuring RED state",
+          "enum": ["fail", "throw", "expect_false", "assert_false"]
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Test metadata",
+      "required": ["wagon", "feature"],
+      "properties": {
+        "wagon": {
+          "type": "string",
+          "description": "Wagon name"
+        },
+        "feature": {
+          "type": "string",
+          "description": "Feature name"
+        },
+        "route": {
+          "type": "string",
+          "description": "Route hint for language detection"
+        },
+        "filename": {
+          "type": "object",
+          "description": "URN-based filename metadata (optional, for new approach)",
+          "properties": {
+            "urn": {
+              "type": "string",
+              "description": "Acceptance URN for filename generation",
+              "pattern": "^acc:([a-z][a-z0-9-]*):([DLPCEMYRK][0-9]{3})-([A-Z0-9]+)-([0-9]{3})(?:-([a-z0-9-]+))?$"
+            },
+            "language": {
+              "type": "string",
+              "description": "Target language for filename generation",
+              "enum": ["dart", "typescript", "python", "go", "java", "kotlin"]
+            },
+            "generated_filename": {
+              "type": "string",
+              "description": "Generated test filename following language conventions"
+            },
+            "convention_ref": {
+              "type": "string",
+              "description": "Reference to filename convention",
+              "const": "filename.convention.yaml"
+            }
+          }
+        }
+      }
+    },
+    "contract_schema": {
+      "type": "object",
+      "description": "Contract schema reference for I/O validation",
+      "required": ["schema_ref", "version"],
+      "properties": {
+        "schema_ref": {
+          "type": "string",
+          "description": "Path to contract schema file",
+          "pattern": "^contracts/"
+        },
+        "version": {
+          "type": "string",
+          "description": "Schema version",
+          "pattern": "^v\\d+$"
+        }
+      }
+    }
+  }
+}

atdd/tester/schemas/unit.tmpl.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Unit Test Harness Template",
+  "description": "Template for unit/component tests",
+  "language": "typescript",
+  "framework": "vitest",
+  "category": "frontend",
+  "template": "\ndescribe('{test_name}', () => {{\n  let component: {component_name};\n  let mockDependencies: any;\n\n  beforeEach(() => {{\n    mockDependencies = {{\n      {mock_setup}\n    }};\n    component = new {component_name}(mockDependencies);\n  }});\n\n  it('{acceptance_name}', async () => {{\n    // Given\n    {given_setup}\n\n    // When\n    {when_action}\n\n    // Then\n    {then_assertions}\n  }});\n}});\n",
+  "variables": [
+    "test_name",
+    "component_name",
+    "mock_setup",
+    "acceptance_name",
+    "given_setup",
+    "when_action",
+    "then_assertions"
+  ]
+}

atdd/tester/schemas/visual.tmpl.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Visual Regression Test Harness Template",
+  "description": "Template for visual regression tests",
+  "language": "typescript",
+  "framework": "playwright",
+  "category": "frontend",
+  "template": "\n// URN: {urn}\nimport {{ test, expect }} from '@playwright/test';\n\ntest('{test_name}', async ({{ page }}) => {{\n  // Given\n  await page.goto('{url}');\n  {given_setup}\n\n  // When\n  await page.waitForLoadState('networkidle');\n  {when_action}\n\n  // Then\n  await expect(page).toHaveScreenshot('{snapshot_name}.png', {{\n    threshold: {threshold}\n  }});\n}});\n",
+  "variables": [
+    "urn",
+    "test_name",
+    "url",
+    "given_setup",
+    "when_action",
+    "snapshot_name",
+    "threshold"
+  ]
+}

atdd/tester/schemas/ws.tmpl.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "WebSocket Test Harness Template",
+  "description": "Template for WebSocket/real-time connection tests",
+  "language": "typescript",
+  "framework": "ws",
+  "category": "backend",
+  "template": "\ndescribe('{test_name}', () => {{\n  let wsClient: WebSocket;\n  let messages: any[] = [];\n\n  beforeEach(async () => {{\n    wsClient = new WebSocket('{ws_url}');\n    wsClient.on('message', (data) => messages.push(JSON.parse(data)));\n    await waitForConnection(wsClient);\n  }});\n\n  afterEach(() => {{\n    wsClient.close();\n  }});\n\n  it('{acceptance_name}', async () => {{\n    // Given\n    {given_setup}\n\n    // When\n    wsClient.send(JSON.stringify({ws_message}));\n    await waitForMessages(1);\n\n    // Then\n    {then_assertions}\n  }});\n}});\n",
+  "variables": [
+    "test_name",
+    "ws_url",
+    "acceptance_name",
+    "given_setup",
+    "ws_message",
+    "then_assertions"
+  ]
+}