atdd 0.1.0__py3-none-any.whl

atdd/tester/schemas/db.tmpl.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Database Test Harness Template",
+  "description": "Template for Supabase database operation tests",
+  "language": "typescript",
+  "framework": "vitest",
+  "category": "backend",
+  "template": "\n// URN: {urn}\nimport { test, expect } from 'vitest';\nimport { createClient } from '@supabase/supabase-js';\n\ntest('{test_name}', async () => {{\n  const supabaseUrl = process.env.SUPABASE_URL;\n  const supabaseKey = process.env.SUPABASE_ANON_KEY;\n  const supabase = createClient(supabaseUrl, supabaseKey);\n\n  // Given\n  {given_setup}\n\n  // When\n  const startTime = Date.now();\n  const {{ data, error, count }} = await supabase\n    .from('{table}')\n    .{operation}({operation_params})\n    {filters}\n    {options};\n  const queryTime = Date.now() - startTime;\n\n  // Then\n  {then_assertions}\n\n  console.log(JSON.stringify({{\n    urn: '{urn}',\n    status: 'PASS',\n    details: {{ table: '{table}', operation: '{operation}', query_time_ms: queryTime }}\n  }}));\n}});\n",
+  "variables": [
+    "urn",
+    "test_name",
+    "given_setup",
+    "table",
+    "operation",
+    "operation_params",
+    "filters",
+    "options",
+    "then_assertions"
+  ]
+}

atdd/tester/schemas/e2e.tmpl.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "E2E Test Harness Template",
+  "description": "Template for end-to-end browser tests",
+  "language": "typescript",
+  "framework": "playwright",
+  "category": "frontend",
+  "template": "\ndescribe('{test_name}', () => {{\n  let page: Page;\n\n  beforeEach(async () => {{\n    page = await browser.newPage();\n  }});\n\n  afterEach(async () => {{\n    await page.close();\n  }});\n\n  it('{acceptance_name}', async () => {{\n    // Given\n    await page.goto('{e2e_url}');\n    {given_setup}\n\n    // When\n    {when_action}\n\n    // Then\n    {then_assertions}\n  }});\n}});\n",
+  "variables": [
+    "test_name",
+    "acceptance_name",
+    "e2e_url",
+    "given_setup",
+    "when_action",
+    "then_assertions"
+  ]
+}

atdd/tester/schemas/edge_function.tmpl.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Edge Function Test Harness Template",
+  "description": "Template for testing Supabase Edge Functions",
+  "language": "typescript",
+  "framework": "vitest",
+  "category": "backend",
+  "template": "\n// URN: {urn}\nimport { test, expect } from 'vitest';\nimport axios from 'axios';\n\ntest('{test_name}', async () => {{\n  const functionUrl = `${{process.env.SUPABASE_URL}}/functions/v1/{function_name}`;\n  const headers = {{\n    'Authorization': `Bearer ${{process.env.SUPABASE_ANON_KEY}}`,\n    'Content-Type': 'application/json'\n  }};\n\n  // Given\n  {given_setup}\n\n  // When\n  const response = await axios.post(\n    functionUrl,\n    {payload},\n    {{ headers, validateStatus: () => true }}\n  );\n\n  // Then\n  {then_assertions}\n\n  console.log(JSON.stringify({{\n    urn: '{urn}',\n    status: 'PASS',\n    details: {{ function: '{function_name}', status: response.status }}\n  }}));\n}});\n",
+  "variables": [
+    "urn",
+    "test_name",
+    "function_name",
+    "given_setup",
+    "payload",
+    "then_assertions"
+  ]
+}

atdd/tester/schemas/event.tmpl.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Event Test Harness Template",
+  "description": "Template for event-driven/message bus tests",
+  "language": "typescript",
+  "framework": "vitest",
+  "category": "backend",
+  "template": "\ndescribe('{test_name}', () => {{\n  let eventBus: EventBus;\n  let publishedEvents: any[] = [];\n\n  beforeEach(() => {{\n    eventBus = new EventBus();\n    eventBus.on('*', (event) => publishedEvents.push(event));\n  }});\n\n  it('{acceptance_name}', async () => {{\n    // Given\n    {given_setup}\n\n    // When\n    await eventBus.publish({{\n      topic: '{event_topic}',\n      payload: {event_payload}\n    }});\n\n    // Then\n    {then_assertions}\n  }});\n}});\n",
+  "variables": [
+    "test_name",
+    "acceptance_name",
+    "given_setup",
+    "event_topic",
+    "event_payload",
+    "then_assertions"
+  ]
+}

atdd/tester/schemas/http.tmpl.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "HTTP Test Harness Template",
+  "description": "Template for HTTP/REST API tests",
+  "language": "typescript",
+  "framework": "supertest",
+  "category": "backend",
+  "template": "\ndescribe('{test_name}', () => {{\n  let request: SuperTest<any>;\n\n  beforeEach(() => {{\n    request = supertest(app);\n  }});\n\n  it('{acceptance_name}', async () => {{\n    // Given\n    {given_setup}\n\n    // When\n    const response = await request\n      .{http_method}('{http_path}')\n      {http_headers}\n      {http_body};\n\n    // Then\n    {then_assertions}\n  }});\n}});\n",
+  "variables": [
+    "test_name",
+    "acceptance_name",
+    "given_setup",
+    "http_method",
+    "http_path",
+    "http_headers",
+    "http_body",
+    "then_assertions"
+  ]
+}

atdd/tester/schemas/job.tmpl.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Job Test Harness Template",
+  "description": "Template for background job/cron tests",
+  "language": "python",
+  "framework": "pytest",
+  "category": "integration",
+  "template": "\n# URN: {urn}\nimport pytest\nimport json\nimport time\n{imports}\n\ndef test_{test_name}():\n    # Given\n    {given_setup}\n    \n    # When\n    start_time = time.time()\n    result = {job_invocation}\n    duration = time.time() - start_time\n    \n    # Then\n    {then_assertions}\n    \n    print(json.dumps({{\n        'urn': '{urn}',\n        'status': 'PASS',\n        'details': {{\n            'job': '{job_name}',\n            'duration_seconds': duration,\n            'result': str(result)\n        }}\n    }}))\n",
+  "variables": [
+    "urn",
+    "test_name",
+    "imports",
+    "given_setup",
+    "job_name",
+    "job_invocation",
+    "then_assertions"
+  ]
+}

atdd/tester/schemas/load.tmpl.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Load Test Harness Template",
+  "description": "Template for load/performance tests using k6",
+  "language": "javascript",
+  "framework": "k6",
+  "category": "integration",
+  "template": "\n// URN: {urn}\nimport http from 'k6/http';\nimport {{ check, sleep }} from 'k6';\n\nexport const options = {{\n  vus: {vus},\n  duration: '{duration}',\n  thresholds: {{\n    http_req_duration: ['p(95)<{threshold_ms}'],\n  }},\n}};\n\nexport default function() {{\n  // Given\n  {given_setup}\n\n  // When\n  const response = http.{method}('{url}', {params});\n\n  // Then\n  check(response, {{\n    'status is {expected_status}': (r) => r.status === {expected_status},\n    {additional_checks}\n  }});\n\n  sleep(1);\n}}\n",
+  "variables": [
+    "urn",
+    "vus",
+    "duration",
+    "threshold_ms",
+    "given_setup",
+    "method",
+    "url",
+    "params",
+    "expected_status",
+    "additional_checks"
+  ]
+}

atdd/tester/schemas/metric.tmpl.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Metric Test Harness Template",
+  "description": "Template for metric/monitoring tests",
+  "language": "python",
+  "framework": "pytest",
+  "category": "integration",
+  "template": "\n# URN: {urn}\nimport pytest\nimport json\nfrom datetime import datetime, timedelta\n{imports}\n\ndef test_{test_name}():\n    # Given\n    {given_setup}\n    \n    # When\n    start_time = datetime.now() - timedelta(minutes={window_minutes})\n    metrics = {metric_query}\n    \n    # Then\n    {then_assertions}\n    \n    print(json.dumps({{\n        'urn': '{urn}',\n        'status': 'PASS',\n        'details': {{\n            'metric': '{metric_name}',\n            'value': metrics.get('value')\n        }}\n    }}))\n",
+  "variables": [
+    "urn",
+    "test_name",
+    "imports",
+    "given_setup",
+    "window_minutes",
+    "metric_query",
+    "metric_name",
+    "then_assertions"
+  ]
+}

atdd/tester/schemas/pack.schema.json

@@ -0,0 +1,139 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Contract Pack Manifest",
+  "description": "Schema for contract packs that define I/O interfaces with strict validation",
+  "type": "object",
+  "required": ["feature", "version", "map", "acceptance_refs"],
+  "additionalProperties": false,
+  "properties": {
+    "feature": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Feature identifier in kebab-case"
+    },
+    "version": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Pack version number (increments on breaking changes)"
+    },
+    "acceptance_refs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^\\.\\./\\.\\./plan/.+\\.yaml$"
+      },
+      "description": "References to acceptance YAML files"
+    },
+    "map": {
+      "type": "object",
+      "required": ["consume", "produce"],
+      "additionalProperties": false,
+      "properties": {
+        "consume": {
+          "type": "array",
+          "maxItems": 3,
+          "items": {"$ref": "#/definitions/io_item"},
+          "description": "Inputs consumed by this feature (cap: 3)"
+        },
+        "produce": {
+          "type": "array",
+          "maxItems": 2,
+          "items": {"$ref": "#/definitions/io_item"},
+          "description": "Outputs produced by this feature (cap: 2)"
+        }
+      }
+    },
+    "schemas": {
+      "type": "array",
+      "items": {"type": "string"},
+      "description": "List of schema files generated for this pack"
+    },
+    "ports": {
+      "type": "array",
+      "items": {"type": "string"},
+      "description": "List of port interface files"
+    },
+    "tests": {
+      "type": "array",
+      "items": {"type": "string"},
+      "description": "List of generated RED test files"
+    }
+  },
+  "definitions": {
+    "io_item": {
+      "type": "object",
+      "required": ["name", "scope", "kind", "port"],
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z]+:[a-z][a-z0-9-]*$",
+          "description": "Typed identifier (e.g., match:dilemma.current)"
+        },
+        "scope": {
+          "type": "string",
+          "enum": ["external", "internal"],
+          "description": "External crosses port boundary, internal stays in domain"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "dto", "command", "query", "event", "message", "notification",
+            "artifact", "config", "metric", "clock", "id", "job", "stream", "saga",
+            "entity", "value", "mutation", "state", "domain-input"
+          ],
+          "description": "Type of I/O artifact"
+        },
+        "port": {
+          "type": "string",
+          "enum": ["Repo", "Http", "Bus", "Knowledge", "Runner", "Clock", "IdGen", "Stream", "(none)"],
+          "description": "Port through which the I/O flows"
+        },
+        "schema": {
+          "type": "string",
+          "pattern": "^[a-z]+\\.[a-zA-Z0-9.-]+$",
+          "description": "Schema name without version (e.g., event.decision.chosen)"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^v[0-9]+$",
+          "description": "Schema version (e.g., v1)"
+        },
+        "durability": {
+          "type": "string",
+          "enum": ["transient", "persisted"],
+          "description": "Whether the artifact is persisted"
+        },
+        "idempotent": {
+          "type": "boolean",
+          "description": "Whether operations are idempotent"
+        }
+      },
+      "allOf": [
+        {
+          "if": {"properties": {"scope": {"const": "external"}}},
+          "then": {
+            "required": ["schema", "version"],
+            "properties": {"port": {"not": {"const": "(none)"}}},
+            "errorMessage": "External I/O requires schema, version, and real port"
+          }
+        },
+        {
+          "if": {"properties": {"scope": {"const": "internal"}}},
+          "then": {
+            "properties": {"port": {"const": "(none)"}},
+            "not": {"required": ["version"]},
+            "errorMessage": "Internal I/O must have port=(none) and no version"
+          }
+        },
+        {
+          "if": {"properties": {"kind": {"enum": ["entity", "value", "mutation", "state", "domain-input"]}}},
+          "then": {"properties": {"scope": {"const": "internal"}},
+            "errorMessage": "Domain kinds (entity, value, mutation, state, domain-input) must be internal"
+          }
+        }
+      ]
+    }
+  }
+}

atdd/tester/schemas/realtime.tmpl.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Realtime Test Harness Template",
+  "description": "Template for testing Supabase Realtime subscriptions",
+  "language": "typescript",
+  "framework": "vitest",
+  "category": "backend",
+  "template": "\n// URN: {urn}\nimport { test, expect } from 'vitest';\nimport { createClient } from '@supabase/supabase-js';\n\ntest('{test_name}', async () => {{\n  const supabase = createClient(\n    process.env.SUPABASE_URL,\n    process.env.SUPABASE_ANON_KEY\n  );\n\n  const messages = [];\n  \n  // Given\n  {given_setup}\n\n  // When\n  const channel = supabase\n    .channel('{channel_name}')\n    .on('{event_type}', {{ event: '{event_filter}' }}, (payload) => {{\n      messages.push(payload);\n    }})\n    .subscribe();\n\n  {trigger_action}\n\n  await new Promise(resolve => setTimeout(resolve, {wait_ms}));\n\n  // Then\n  {then_assertions}\n\n  await channel.unsubscribe();\n}});\n",
+  "variables": [
+    "urn",
+    "test_name",
+    "given_setup",
+    "channel_name",
+    "event_type",
+    "event_filter",
+    "trigger_action",
+    "wait_ms",
+    "then_assertions"
+  ]
+}

atdd/tester/schemas/rls.tmpl.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Row Level Security Test Harness Template",
+  "description": "Template for testing RLS policies in Supabase",
+  "language": "typescript",
+  "framework": "vitest",
+  "category": "backend",
+  "template": "\n// URN: {urn}\nimport { test, expect } from 'vitest';\nimport { createClient } from '@supabase/supabase-js';\n\ntest('{test_name}', async () => {{\n  const supabaseUrl = process.env.SUPABASE_URL;\n  \n  const testCases = [\n    {{\n      name: 'anonymous_user',\n      key: process.env.SUPABASE_ANON_KEY,\n      shouldAccess: {anon_access}\n    }},\n    {{\n      name: 'authenticated_user',\n      key: process.env.SUPABASE_USER_KEY,\n      shouldAccess: {user_access}\n    }}\n  ];\n\n  const results = [];\n  for (const testCase of testCases) {{\n    const supabase = createClient(supabaseUrl, testCase.key);\n    const {{ data, error }} = await supabase\n      .from('{table}')\n      .{operation}({operation_params});\n    \n    const hasAccess = error === null;\n    results.push({{\n      context: testCase.name,\n      expected: testCase.shouldAccess,\n      actual: hasAccess,\n      passed: hasAccess === testCase.shouldAccess\n    }});\n  }}\n\n  const allPassed = results.every(r => r.passed);\n  expect(allPassed).toBe(true);\n}});\n",
+  "variables": [
+    "urn",
+    "test_name",
+    "table",
+    "operation",
+    "operation_params",
+    "anon_access",
+    "user_access"
+  ]
+}

atdd/tester/schemas/script.tmpl.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Script Test Harness Template",
+  "description": "Template for general script execution tests",
+  "language": "shell",
+  "framework": "bash",
+  "category": "integration",
+  "template": "\n#!/bin/bash\n# URN: {urn}\n\n# Given\n{given_setup}\n\n# When\nstart_time=$(date +%s)\noutput=$({script_command} {script_args} 2>&1)\nexit_code=$?\nend_time=$(date +%s)\nduration=$((end_time - start_time))\n\n# Then\nif [ $exit_code -eq {expected_exit_code} ]; then\n  status=\"PASS\"\nelse\n  status=\"FAIL\"\nfi\n\necho \"{\\\"urn\\\":\\\"{urn}\\\",\\\"status\\\":\\\"$status\\\",\\\"details\\\":{\\\"exit_code\\\":$exit_code,\\\"duration_seconds\\\":$duration}}\"\n\n[ \"$status\" == \"PASS\" ]\n",
+  "variables": [
+    "urn",
+    "given_setup",
+    "script_command",
+    "script_args",
+    "expected_exit_code"
+  ]
+}

atdd/tester/schemas/sec.tmpl.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Security Test Harness Template",
+  "description": "Template for security/penetration tests",
+  "language": "shell",
+  "framework": "bash",
+  "category": "integration",
+  "template": "\n#!/bin/bash\n# URN: {urn}\n\n# Given\n{given_setup}\n\n# When\nresponse=$(curl -s -w \"\\n%{{http_code}}\" \\\n  -X {method} \\\n  {headers} \\\n  {body} \\\n  \"{url}\")\n\nstatus_code=$(echo \"$response\" | tail -n1)\nbody=$(echo \"$response\" | head -n-1)\n\n# Then\nif [ \"$status_code\" -eq {expected_status} ]; then\n  status=\"PASS\"\nelse\n  status=\"FAIL\"\nfi\n\necho \"{\\\"urn\\\":\\\"{urn}\\\",\\\"status\\\":\\\"$status\\\",\\\"details\\\":{\\\"status_code\\\":$status_code}}\"\n\n[ \"$status\" == \"PASS\" ]\n",
+  "variables": [
+    "urn",
+    "given_setup",
+    "method",
+    "headers",
+    "body",
+    "url",
+    "expected_status"
+  ]
+}

atdd/tester/schemas/storage.tmpl.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Storage Test Harness Template",
+  "description": "Template for testing Supabase Storage operations",
+  "language": "typescript",
+  "framework": "vitest",
+  "category": "backend",
+  "template": "\n// URN: {urn}\nimport { test, expect } from 'vitest';\nimport { createClient } from '@supabase/supabase-js';\n\ntest('{test_name}', async () => {{\n  const supabase = createClient(\n    process.env.SUPABASE_URL,\n    process.env.SUPABASE_ANON_KEY\n  );\n\n  // Given\n  {given_setup}\n\n  // When\n  const {{ data, error }} = await supabase\n    .storage\n    .from('{bucket_name}')\n    .{operation}({operation_params});\n\n  // Then\n  {then_assertions}\n\n  console.log(JSON.stringify({{\n    urn: '{urn}',\n    status: 'PASS',\n    details: {{ bucket: '{bucket_name}', operation: '{operation}' }}\n  }}));\n}});\n",
+  "variables": [
+    "urn",
+    "test_name",
+    "given_setup",
+    "bucket_name",
+    "operation",
+    "operation_params",
+    "then_assertions"
+  ]
+}

atdd/tester/schemas/telemetry.schema.json

@@ -0,0 +1,128 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wagons.dev/schemas/tester/telemetry.schema.json",
+  "title": "Telemetry Signal Schema",
+  "description": "Meta-schema that validates telemetry signal files for naming, metadata, and traceability.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "$schema",
+    "$id",
+    "version",
+    "type",
+    "plane",
+    "artifact_ref",
+    "acceptance_criteria",
+    "properties",
+    "required"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "http://json-schema.org/draft-07/schema#",
+      "description": "Must use JSON Schema Draft-07"
+    },
+    "$id": {
+      "type": "string",
+      "pattern": "^([a-z][a-z0-9\\-]*:)+[a-z][a-z0-9\\-.]*\\.(event|metric|trace|log)\\.(ui|ux|be|nw|db|st|tm|sc|au|fn|if)(\\.[a-z0-9_-]+)?$",
+      "description": "Signal ID pattern: {theme}(:{path})*:{aspect}.{type}.{plane}[.{measure}] (aspect may include dots)"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version (REQUIRED): 0.x.x for draft, 1.x.x+ for stable"
+    },
+    "type": {
+      "type": "string",
+      "enum": [
+        "event",
+        "metric",
+        "trace",
+        "log"
+      ],
+      "description": "Signal type"
+    },
+    "plane": {
+      "type": "string",
+      "enum": [
+        "ui",
+        "ux",
+        "be",
+        "nw",
+        "db",
+        "st",
+        "tm",
+        "sc",
+        "au",
+        "fn",
+        "if"
+      ],
+      "description": "Logical observability layer"
+    },
+    "measure": {
+      "type": "string",
+      "description": "Metric measure (required for type=metric)"
+    },
+    "unit": {
+      "type": "string",
+      "description": "Metric unit"
+    },
+    "artifact_ref": {
+      "type": "string",
+      "pattern": "^contract:([a-z][a-z0-9\\-]*:)+[a-z][a-z0-9\\-]*$",
+      "description": "Reference to contract schema with URN format: contract:{theme}(:{path})*:{resource}"
+    },
+    "acceptance_criteria": {
+      "type": "array",
+      "minItems": 0,
+      "items": {
+        "type": "string",
+        "pattern": "^acc:[a-z][a-z0-9_-]*:([DLPCEMYRK][0-9]{3}-(UNIT|HTTP|EVENT|WS|E2E|A11Y|VIS|METRIC|JOB|DB|SEC|LOAD|SCRIPT|WIDGET|GOLDEN|BLOC|INTEGRATION|RLS|EDGE|REALTIME|STORAGE)-[0-9]{3}(?:-[a-z0-9-]+)?|[A-Z][0-9]{3})$"
+      },
+      "description": "Array of acceptance criteria URNs that validate this signal"
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable signal description"
+    },
+    "note": {
+      "type": "string",
+      "description": "Optional placeholder or implementation notes"
+    },
+    "properties": {
+      "type": "object",
+      "description": "JSON Schema properties object"
+    },
+    "required": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Required property names"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "type": { "const": "metric" }
+        }
+      },
+      "then": {
+        "required": ["measure"]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": { "const": "event" }
+        }
+      },
+      "then": {
+        "not": {
+          "required": ["measure"]
+        }
+      }
+    }
+  ]
+}