atdd 0.7.3__tar.gz → 0.7.5__tar.gz

{atdd-0.7.3/src/atdd.egg-info → atdd-0.7.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.7.3
+Version: 0.7.5
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10

{atdd-0.7.3 → atdd-0.7.5}/pyproject.toml

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

{atdd-0.7.3 → atdd-0.7.5}/src/atdd/coach/commands/inventory.py

@@ -302,27 +302,89 @@ class RepositoryInventory:
         }
 
     def scan_telemetry(self) -> Dict[str, Any]:
-        """Scan telemetry/ for signal definitions."""
+        """Scan telemetry/ for signal definitions.
+
+        Signal file pattern: {aspect}.{type}.{plane}[.{measure}].json
+        Examples: metric.ui.duration.json, event.be.json
+
+        Excludes: _telemetry.yaml, _taxonomy.yaml, .pack.* files
+        Falls back to _telemetry.yaml registry if no signal files found.
+        """
         telemetry_dir = self.repo_root / "telemetry"
 
         if not telemetry_dir.exists():
-            return {"total": 0, "by_domain": {}}
+            return {"total": 0, "by_theme": {}, "source": "none"}
+
+        # Find JSON signal files (primary) and YAML signal files (legacy)
+        json_files = list(telemetry_dir.glob("**/*.json"))
+        yaml_files = list(telemetry_dir.glob("**/*.yaml"))
 
-        # Find all signal files
-        signal_files = list(telemetry_dir.glob("**/*.signal.yaml"))
+        # Filter out manifest/registry/pack files
+        def is_signal_file(f: Path) -> bool:
+            name = f.name
+            # Exclude registry and manifest files
+            if name.startswith("_"):
+                return False
+            # Exclude pack files
+            if ".pack." in name:
+                return False
+            return True
 
-        by_domain = defaultdict(int)
+        signal_files = [f for f in json_files + yaml_files if is_signal_file(f)]
+
+        by_theme = defaultdict(int)
 
         for signal_file in signal_files:
             rel_path = signal_file.relative_to(telemetry_dir)
-            domain = rel_path.parts[0] if rel_path.parts else "unknown"
-            by_domain[domain] += 1
+            # First path segment is theme (per artifact-naming.convention.yaml v2.1)
+            theme = rel_path.parts[0] if rel_path.parts else "unknown"
+            by_theme[theme] += 1
+
+        # If no signal files found, fallback to registry
+        if not signal_files:
+            return self._scan_telemetry_from_registry(telemetry_dir)
 
         return {
             "total": len(signal_files),
-            "by_domain": dict(by_domain)
+            "by_theme": dict(by_theme),
+            "source": "files"
         }
 
+    def _scan_telemetry_from_registry(self, telemetry_dir: Path) -> Dict[str, Any]:
+        """Fallback: count telemetry entries from _telemetry.yaml registry."""
+        registry_file = telemetry_dir / "_telemetry.yaml"
+
+        if not registry_file.exists():
+            return {"total": 0, "by_theme": {}, "source": "none"}
+
+        try:
+            with open(registry_file, 'r', encoding='utf-8') as f:
+                registry = yaml.safe_load(f) or {}
+
+            signals = registry.get("signals", [])
+            by_theme = defaultdict(int)
+            valid_count = 0
+
+            for signal in signals:
+                # Only count signals with non-empty ids
+                signal_id = signal.get("id") or signal.get("$id", "")
+                if not signal_id:
+                    continue
+
+                valid_count += 1
+                # Parse theme from id (first segment before colon)
+                parts = signal_id.split(":")
+                theme = parts[0] if parts else "unknown"
+                by_theme[theme] += 1
+
+            return {
+                "total": valid_count,
+                "by_theme": dict(by_theme),
+                "source": "registry"
+            }
+        except Exception:
+            return {"total": 0, "by_theme": {}, "source": "error"}
+
     def count_test_cases_in_file(self, test_file: Path) -> int:
         """Count number of test functions/cases in a test file."""
         try:

{atdd-0.7.3 → atdd-0.7.5}/src/atdd/planner/conventions/wagon.convention.yaml

@@ -177,30 +177,35 @@ artifact_contracts:
   note: "Full artifact contract conventions defined in artifact.convention.yaml"
 
   urn_format:
-    contract_urn: "contract:domain:resource (e.g., contract:ux:foundations, contract:match:result)"
-    telemetry_urn: "telemetry:domain:resource[.category] (e.g., telemetry:ux:foundations, telemetry:ux:foundations.colors)"
+    contract_urn: "contract:{theme}(:{category})*:{aspect}(.{variant})?"
+    telemetry_urn: "telemetry:{theme}(:{category})*:{aspect}(.{variant})?"
+    examples:
+      - "contract:commons:ux:foundations:color"
+      - "contract:mechanic:decision.choice"
+      - "contract:sensory:gesture.raw"
+      - "telemetry:commons:ux:foundations"
 
     telemetry_filesystem:
       description: "Telemetry URN maps to filesystem directory containing signal files"
-      pattern: "telemetry/{domain}/{resource}[/{category}]/{signal-type}.{plane}[.{measure}].json"
-      urn_to_path: "telemetry:{domain}:{resource}[.{category}] → telemetry/{domain}/{resource}[/{category}]/"
+      pattern: "telemetry/{segments}/{signal-type}.{plane}[.{measure}].json"
+      urn_to_path: "telemetry:{theme}:{segments} → telemetry/{theme}/{segments}/"
 
       examples:
         - urn: "telemetry:mechanic:decision.choice"
-          path: "telemetry/decision/choice/"
+          path: "telemetry/mechanic/decision/choice/"
           files:
             - "metric.db.count.json"
             - "metric.be.duration.json"
             - "event.be.json"
 
-        - urn: "telemetry:ux:foundations"
-          path: "telemetry/ux/foundations/"
+        - urn: "telemetry:commons:ux:foundations"
+          path: "telemetry/commons/ux/foundations/"
           files:
             - "metric.ui.render_latency.json"
             - "event.ui.json"
 
-        - urn: "telemetry:ux:foundations.colors"
-          path: "telemetry/ux/foundations/colors/"
+        - urn: "telemetry:commons:ux:foundations:color"
+          path: "telemetry/commons/ux/foundations/color/"
           files:
             - "metric.ui.render_latency.json"
             - "event.ui.json"
@@ -222,18 +227,21 @@ artifact_contracts:
 
   produce_artifacts:
     required_fields:
-      - name: "Artifact name (e.g., ux:foundations)"
-      - contract: "Contract URN or null (e.g., contract:ux:foundations)"
-      - telemetry: "Telemetry URN for observability and analytics or null (e.g., telemetry:ux:foundations)"
+      - name: "Artifact name (e.g., commons:ux:foundations)"
+      - contract: "Contract URN or null (e.g., contract:commons:ux:foundations)"
+      - telemetry: "Telemetry URN for observability and analytics or null (e.g., telemetry:commons:ux:foundations)"
     optional_fields:
       - to: "Visibility (internal|external), defaults to external"
       - urn: "Legacy artifact URN"
       - version: "Version string (e.g., v1)"
 
     example:
-      - name: ux:foundations
-        contract: contract:ux:foundations
-        telemetry: telemetry:ux:foundations
+      - name: commons:ux:foundations
+        contract: contract:commons:ux:foundations
+        telemetry: telemetry:commons:ux:foundations
+      - name: commons:ux:foundations:color
+        contract: contract:commons:ux:foundations:color
+        telemetry: telemetry:commons:ux:foundations:color
       - name: internal:cache
         contract: null
         telemetry: null
@@ -251,10 +259,10 @@ artifact_contracts:
 
     example:
       - name: appendix:mockup
-      - name: match:config
-        from: wagon:setup-match
-        contract: contract:match:config
-        telemetry: telemetry:match:config
+      - name: commons:ux:foundations
+        from: wagon:maintain-ux
+        contract: contract:commons:ux:foundations
+        telemetry: telemetry:commons:ux:foundations
 
   features_format:
     legacy_format:

atdd-0.7.5/src/atdd/tester/conventions/artifact.convention.yaml

@@ -0,0 +1,276 @@
+# Artifact Convention
+# Defines naming, versioning, organization, and API mapping rules for artifact-centric contracts
+# Aligned with canonical artifact-naming.convention.yaml v2.1
+
+description: "Artifact-centric contract system using theme-based hierarchical taxonomy with variant facets"
+
+naming:
+  logical_pattern: "{theme}(:{category})*:{aspect}(.{variant})?"
+  physical_pattern: "contracts/{theme}/{segments}/{aspect}[/{variant}].schema.json"
+  rationale: "Theme-based organization enables clear architectural boundaries. Colon separator denotes hierarchical descent (unlimited depth), dot separator denotes lateral variant (typically 0-1). Each segment becomes a directory level."
+
+  examples:
+    - logical: "commons:ux:foundations"
+      physical: "contracts/commons/ux/foundations.schema.json"
+
+    - logical: "commons:ux:foundations:color"
+      physical: "contracts/commons/ux/foundations/color.schema.json"
+
+    - logical: "mechanic:decision.choice"
+      physical: "contracts/mechanic/decision/choice.schema.json"
+
+    - logical: "match:result"
+      physical: "contracts/match/result.schema.json"
+
+    - logical: "sensory:gesture.raw"
+      physical: "contracts/sensory/gesture/raw.schema.json"
+
+versioning:
+  location: "Separate version field"
+  filename_pattern: "{segments}.schema.json"
+  id_pattern: "{artifact_name}"
+  version_field: "version"
+  rationale: "Version tracked in separate 'version' field, NOT embedded in $id. Allows artifact identity to remain stable across versions. Supports monolithic deployment with coordinated releases."
+
+  examples:
+    - artifact: "commons/ux/foundations/color.schema.json"
+      id_field: "commons:ux:foundations:color"
+      version_field: "1.0.0"
+
+    - artifact: "mechanic/decision/choice.schema.json"
+      id_field: "mechanic:decision.choice"
+      version_field: "1.0.0"
+
+    - artifact: "match/result.schema.json"
+      id_field: "match:result"
+      version_field: "1.2.3"
+
+    - artifact: "sensory/gesture/raw.schema.json"
+      id_field: "sensory:gesture.raw"
+      version_field: "1.0.0"
+
+organization:
+  strategy: "by_theme"
+  directory_structure: "contracts/{theme}/"
+  rationale: "Theme-based directories enable clear architectural boundaries. Each theme represents a bounded context. Unlimited hierarchical depth supported via colons."
+
+  structure:
+    root: "contracts/"
+    themes:
+      - "commons/"
+      - "match/"
+      - "mechanic/"
+      - "sensory/"
+      - "player/"
+      - "scenario/"
+      - "partnership/"
+      - "league/"
+      - "audience/"
+      - "monetization/"
+
+api_mapping:
+  description: "Artifact names map to REST API endpoints for external consumption. Hierarchy levels add path segments, variants treated as resources."
+  pattern: "/{theme}s/{id}/{segments}[/{variant}]"
+
+  methods:
+    new: POST
+    created: POST
+    registered: POST
+    started: POST
+    result: GET
+    active: GET
+    config: GET
+    events: GET
+    current: GET
+    foundations: GET
+    updated: PUT
+    closed: PUT
+    completed: PUT
+    terminated: DELETE
+    deleted: DELETE
+
+  examples:
+    - artifact: "commons:ux:foundations"
+      endpoint: "GET /commons/{id}/ux/foundations"
+      description: "Retrieve UX foundations"
+
+    - artifact: "commons:ux:foundations:color"
+      endpoint: "GET /commons/{id}/ux/foundations/color"
+      description: "Retrieve UX color foundations"
+
+    - artifact: "match:result"
+      endpoint: "GET /matches/{id}/result"
+      description: "Retrieve match result"
+
+    - artifact: "session:new"
+      endpoint: "POST /sessions"
+      description: "Create new session"
+
+    - artifact: "player:identity"
+      endpoint: "GET /players/{id}"
+      description: "Retrieve player identity"
+
+    - artifact: "match:config"
+      endpoint: "GET /matches/{id}/config"
+      description: "Retrieve match configuration"
+
+    - artifact: "player:updated"
+      endpoint: "PUT /players/{id}"
+      description: "Update player"
+
+    - artifact: "match:terminated"
+      endpoint: "DELETE /matches/{id}"
+      description: "Terminate match"
+
+ownership:
+  producer: "Generates artifact contract (wagon that declares artifact in produce[])"
+  consumer: "References existing contract (wagon that declares artifact in consume[])"
+  single_source: "One artifact = one JSON file. Multiple wagons reference same file. Zero duplication."
+
+  rules:
+    - "Producer wagon owns the artifact schema generation"
+    - "Consumer wagon validates artifact existence and references it"
+    - "Artifact path declared in wagon manifest contract: field"
+    - "Only producer generates; consumers must never modify"
+
+metadata:
+  description: "Artifact schemas include x-artifact-metadata for tooling and API generation"
+
+  fields:
+    theme: "Architectural theme (commons, match, mechanic, etc.)"
+    aspect: "Final leaf resource noun"
+    variant: "Optional lateral variation"
+    api:
+      method: "HTTP method (GET, POST, PUT, DELETE)"
+      path: "REST endpoint path"
+
+  example:
+    theme: "match"
+    aspect: "result"
+    api:
+      method: "GET"
+      path: "/matches/{id}/result"
+
+validation:
+  required_fields: ["$schema", "$id", "version", "title", "type", "properties"]
+  schema_compliance: "JSON Schema Draft-07"
+  id_pattern: "^[a-z]+(?::[a-z][a-z0-9-]*)+(?:\\.[a-z][a-z0-9-]*)?$"
+  version_pattern: "^\\d+\\.\\d+\\.\\d+$"
+
+artifact_urns:
+  urn_pattern:
+    format: "contract:{artifact_name}"
+    conversion_rule: "URN exactly matches artifact name - preserves colons for hierarchy and dots for variants. Pattern: contract:{theme}(:{category})*:{aspect}(.{variant})?"
+
+  examples:
+    artifact_to_urn:
+      - artifact_name: "commons:ux:foundations"
+        urn: "contract:commons:ux:foundations"
+
+      - artifact_name: "commons:ux:foundations:color"
+        urn: "contract:commons:ux:foundations:color"
+
+      - artifact_name: "mechanic:decision.choice"
+        urn: "contract:mechanic:decision.choice"
+
+      - artifact_name: "sensory:gesture.raw"
+        urn: "contract:sensory:gesture.raw"
+
+  bidirectional_linkage:
+    validation: "URN must resolve to a contract in the registry. All colons and dots preserved."
+
+  migration_strategy:
+    refactor_note: "Legacy URNs contract:{domain}:{resource}[.{category}] migrate to contract:{theme}(:{category})*:{aspect}(.{variant})?. Version suffix removed from $id."
+
+wagon_artifacts:
+  produce_example:
+    wagon: "maintain-ux"
+    produce:
+      - name: "commons:ux:foundations"
+        urn: "contract:commons:ux:foundations"
+        to: "external"
+
+      - name: "commons:ux:foundations:color"
+        urn: "contract:commons:ux:foundations:color"
+        to: "external"
+
+  consume_example:
+    wagon: "stage-characters"
+    consume:
+      - name: "commons:ux:foundations"
+        urn: "contract:commons:ux:foundations"
+        from: "wagon:maintain-ux"
+
+contract_artifacts:
+  id_field: "id: {artifact_name}"
+  urn_mapping: "URN contract:{artifact_name} maps directly to $id {artifact_name}"
+
+  example:
+    - id: "commons:ux:foundations"
+      version: "1.0.0"
+      path: "commons/ux/foundations.schema.json"
+      producer: "wagon:maintain-ux"
+      urn_match: "contract:commons:ux:foundations"
+
+    - id: "commons:ux:foundations:color"
+      version: "1.0.0"
+      path: "commons/ux/foundations/color.schema.json"
+      producer: "wagon:maintain-ux"
+      urn_match: "contract:commons:ux:foundations:color"
+
+    - id: "mechanic:decision.choice"
+      version: "1.0.0"
+      path: "mechanic/decision/choice.schema.json"
+      producer: "wagon:resolve-dilemmas"
+      urn_match: "contract:mechanic:decision.choice"
+
+demo_mode:
+  description: "Artifacts write to demo/contracts/artifacts/ when mode_demo: true"
+  path_prefix: "demo/contracts/artifacts/"
+
+examples:
+  complete_workflow:
+    - step: "Wagon declares artifact in produce[]"
+      example: |
+        produce:
+          - name: mechanic:decision.choice
+            to: external
+            contract: contracts/mechanic/decision/choice.schema.json
+
+    - step: "Tester agent classifies artifact ownership"
+      result: "producer: true, path: mechanic/decision/choice.schema.json"
+
+    - step: "Schema generation creates artifact"
+      output: "contracts/mechanic/decision/choice.schema.json"
+      content: |
+        {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "$id": "mechanic:decision.choice",
+          "version": "1.0.0",
+          "title": "Decision Choice",
+          "type": "object",
+          "properties": {...},
+          "x-artifact-metadata": {
+            "theme": "mechanic",
+            "aspect": "decision",
+            "variant": "choice",
+            "api": {
+              "method": "POST",
+              "path": "/decisions"
+            }
+          }
+        }
+
+    - step: "Consumer wagon references artifact"
+      example: |
+        consume:
+          - name: mechanic:decision.choice
+            from: wagon:resolve-dilemmas
+            contract: contracts/mechanic/decision/choice.schema.json
+
+    - step: "Pack generation references (not embeds) artifact"
+      pack_manifest: |
+        produce:
+          - artifact: mechanic:decision.choice
+            contract: ../artifacts/mechanic/decision/choice.schema.json
+            owner: true