atdd 0.7.1__tar.gz → 0.7.2__tar.gz

{atdd-0.7.1/src/atdd.egg-info → atdd-0.7.2}/PKG-INFO

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

{atdd-0.7.1 → atdd-0.7.2}/pyproject.toml

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

{atdd-0.7.1 → atdd-0.7.2}/src/atdd/coach/commands/registry.py

@@ -10,7 +10,7 @@ Architecture: 4-Layer Clean Architecture (single file)
 Registries:
 - plan/_wagons.yaml from wagon manifests
 - contracts/_artifacts.yaml from contract schemas
-- telemetry/_signals.yaml from telemetry signals
+- telemetry/_telemetry.yaml from telemetry signals
 - atdd/tester/_tests.yaml from test files
 - python/_implementations.yaml from Python files
 - supabase/_functions.yaml from function files
@@ -89,8 +89,8 @@ class RegistryLoader:
             return yaml.safe_load(f) or {"artifacts": []}
 
     def load_telemetry(self) -> Dict[str, Any]:
-        """Load telemetry registry (telemetry/_signals.yaml)."""
-        registry_path = self.telemetry_dir / "_signals.yaml"
+        """Load telemetry registry (telemetry/_telemetry.yaml)."""
+        registry_path = self.telemetry_dir / "_telemetry.yaml"
         if not registry_path.exists():
             return {"signals": []}
 
@@ -776,7 +776,7 @@ class RegistryBuilder:
 
     def update_telemetry_registry(self, mode: str = "interactive", preview_only: bool = None) -> Dict[str, Any]:
         """
-        Update telemetry/_signals.yaml from telemetry signal files.
+        Update telemetry/_telemetry.yaml from telemetry signal files.
 
         Args:
             mode: "interactive" (prompt), "apply" (no prompt), or "check" (verify only)
@@ -791,7 +791,7 @@ class RegistryBuilder:
         print("\n📊 Analyzing telemetry registry from signal files...")
 
         # Load existing registry
-        registry_path = self.telemetry_dir / "_signals.yaml"
+        registry_path = self.telemetry_dir / "_telemetry.yaml"
         existing_signals = {}
         if registry_path.exists():
             with open(registry_path) as f:
@@ -812,7 +812,7 @@ class RegistryBuilder:
         # Scan for telemetry signal files (JSON or YAML)
         json_files = list(self.telemetry_dir.glob("**/*.json"))
         yaml_files = list(self.telemetry_dir.glob("**/*.yaml"))
-        signal_files = [f for f in (json_files + yaml_files) if "_signals" not in f.name]
+        signal_files = [f for f in (json_files + yaml_files) if "_telemetry" not in f.name]
 
         stats["total_files"] = len(signal_files)
 

{atdd-0.7.1 → atdd-0.7.2}/src/atdd/coach/commands/traceability.py

@@ -1435,8 +1435,8 @@ class TraceabilityReconciler:
 
         for telemetry in telemetry_files:
             # Skip manifest and pack files (not signal files)
-            if (telemetry.file_path.endswith('_tracking.yaml') or
-                telemetry.file_path.endswith('_signals.yaml') or
+            if (telemetry.file_path.endswith('_taxonomy.yaml') or
+                telemetry.file_path.endswith('_telemetry.yaml') or
                 '.pack.' in telemetry.file_path):
                 continue
 
@@ -1493,9 +1493,9 @@ class TraceabilityReconciler:
 
             telemetry_id = telemetry.telemetry_id
 
-            # Skip manifest files (_tracking.yaml, _signals.yaml)
-            if telemetry.file_path.endswith('_tracking.yaml') or \
-               telemetry.file_path.endswith('_signals.yaml') or \
+            # Skip manifest files (_taxonomy.yaml, _telemetry.yaml)
+            if telemetry.file_path.endswith('_taxonomy.yaml') or \
+               telemetry.file_path.endswith('_telemetry.yaml') or \
                '.pack.' in telemetry.file_path:
                 continue
 

atdd-0.7.2/src/atdd/coach/conventions/naming.convention.yaml

@@ -0,0 +1,296 @@
+version: "1.0"
+name: "Master Naming Convention"
+description: "Consolidated naming patterns for all ATDD archetypes with regex validation"
+
+# Purpose
+purpose: |
+  Single source of truth for naming patterns across all archetypes.
+  Each archetype has: pattern, regex, examples, and validator reference.
+  For detailed semantics, see archetype-specific conventions.
+
+# Separator Semantics (from artifact-naming.convention.yaml)
+separator_semantics:
+  colon: "Hierarchical descent (unlimited depth)"
+  dot: "Lateral variation (typically 0-1 levels)"
+  hyphen: "Word separator within segments (kebab-case)"
+
+# Naming Patterns by Archetype
+patterns:
+
+  wagon:
+    description: "Bounded context performing specific action on specific object"
+    semantic_pattern: "verb-object"
+    format: "kebab-case"
+    regex: "^[a-z][a-z0-9]*-[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*$"
+    urn_format: "wagon:{wagon-name}"
+    urn_regex: "^wagon:[a-z][a-z0-9-]+$"
+    examples:
+      valid:
+        - "authenticate-identity"
+        - "resolve-dilemmas"
+        - "commit-state"
+        - "burn-timebank"
+        - "juggle-domains"
+        - "manage-inventory"
+      invalid:
+        - "authentication"      # Missing object (noun only)
+        - "dilemma-resolver"    # Wrong order (object-verb)
+        - "resolving-dilemmas"  # Gerund instead of verb
+        - "ResolveDilemmas"     # PascalCase
+    filesystem:
+      directory: "plan/{wagon_snake_case}/"
+      manifest: "plan/{wagon_snake_case}/_{wagon_snake_case}.yaml"
+      note: "Directory uses snake_case: resolve_dilemmas"
+    validator:
+      file: "src/atdd/planner/validators/test_plan_wagons.py"
+      spec: "SPEC-PLATFORM-WAGONS-0008"
+    convention_ref: "atdd/planner/conventions/wagon.convention.yaml"
+
+  feature:
+    description: "Specific capability within a wagon"
+    semantic_pattern: "verb-object"
+    format: "kebab-case"
+    regex: "^[a-z][a-z0-9]*-[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*$"
+    urn_format: "feature:{wagon}:{feature-name}"
+    urn_regex: "^feature:[a-z][a-z0-9-]+:[a-z][a-z0-9-]+$"
+    examples:
+      valid:
+        - "capture-choice"
+        - "pair-fragments"
+        - "score-domains"
+        - "sign-commit"
+        - "validate-input"
+      invalid:
+        - "choice-capture"      # Wrong order
+        - "capturing"           # Missing object
+        - "fragment_pairing"    # Snake case
+    filesystem:
+      file: "plan/{wagon}/features/{feature_snake_case}.yaml"
+    validator:
+      file: "src/atdd/planner/validators/test_plan_wagons.py"
+      spec: "SPEC-PLATFORM-WAGONS-0009"
+    convention_ref: "atdd/planner/conventions/feature.convention.yaml"
+
+  contract:
+    description: "Data exchange contract between wagons"
+    semantic_pattern: "theme:hierarchy:aspect(.variant)?"
+    format: "kebab-case segments with colon/dot separators"
+    id_regex: "^[a-z][a-z0-9-]*(:[a-z][a-z0-9-]+)+(\\.[a-z][a-z0-9-]+)?$"
+    urn_format: "contract:{artifact-name}"
+    urn_regex: "^contract:[a-z][a-z0-9-]*(:[a-z][a-z0-9-]+)+(\\.[a-z][a-z0-9-]+)?$"
+    examples:
+      schema_id:
+        - "mechanic:timebank.remaining"
+        - "match:dilemma:current"
+        - "commons:ux:foundations:color"
+        - "sensory:gesture.raw"
+      urn:
+        - "contract:mechanic:timebank.remaining"
+        - "contract:match:dilemma:current"
+        - "contract:commons:ux:foundations:color"
+    id_vs_urn:
+      schema_id: "NO 'contract:' prefix (e.g., mechanic:timebank.remaining)"
+      wagon_urn: "WITH 'contract:' prefix (e.g., contract:mechanic:timebank.remaining)"
+    filesystem:
+      pattern: "contracts/{theme}/{domain}/{aspect}.schema.json"
+      example: "contracts/mechanic/timebank/remaining.schema.json"
+    validator:
+      file: "src/atdd/tester/validators/test_contract_schema_compliance.py"
+      spec: "SPEC-TESTER-VAL-0001"
+    convention_ref: "atdd/tester/conventions/contract.convention.yaml"
+    naming_authority: "atdd/planner/conventions/artifact-naming.convention.yaml"
+
+  telemetry:
+    description: "Observability and analytics tracking signals"
+    semantic_pattern: "theme:hierarchy:aspect(.variant)?"
+    format: "kebab-case segments with colon/dot separators"
+    signal_id_regex: "^[a-z][a-z0-9-]*(:[a-z][a-z0-9-]+)+\\.(event|metric|trace|log)\\.(ui|ux|be|db|nw|st|tm|sc|au|fn|if)(\\.[a-z][a-z0-9-]+)?$"
+    urn_format: "telemetry:{theme}(:{path})*:{aspect}(.{variant})?"
+    urn_regex: "^telemetry:[a-z][a-z0-9-]*(:[a-z][a-z0-9-]+)*(\\.[a-z][a-z0-9-]+)?$"
+    examples:
+      signal_id:
+        - "mechanic:decision.choice.event.be"
+        - "match:dilemma:current.metric.be.selection-duration"
+        - "juggle:goal.detected.event.be"
+      urn:
+        - "telemetry:mechanic:decision.choice"
+        - "telemetry:juggle:goal.detected"
+        - "telemetry:mechanic:episode.timer"
+    id_vs_urn:
+      signal_id: "NO 'telemetry:' prefix, includes .type.plane (e.g., mechanic:decision.choice.event.be)"
+      wagon_urn: "WITH 'telemetry:' prefix, NO type.plane (e.g., telemetry:mechanic:decision.choice)"
+    filesystem:
+      pattern: "telemetry/{theme}/{domain}/{aspect}.{type}.{plane}[.{measure}].json"
+      example: "telemetry/mechanic/decision/choice.event.be.json"
+    validator:
+      file: "src/atdd/tester/validators/test_telemetry_structure.py"
+      spec: "SPEC-TESTER-CONV-0050"
+    convention_ref: "atdd/tester/conventions/telemetry.convention.yaml"
+
+  train:
+    description: "User journey or end-to-end workflow"
+    semantic_pattern: "{NNNN}-{slug}"
+    format: "4-digit hierarchical prefix + kebab-case slug"
+    regex: "^\\d{4}-[a-z][a-z0-9-]+$"
+    numbering:
+      pattern: "[Theme][Category][Variation]-{slug}"
+      theme_digit: "0-9 (commons=0, mechanic=1, scenario=2, match=3, etc.)"
+      category_digit: "0=nominal, 1=error, 2=alternate, 3=exception"
+      variation_digits: "01-99"
+    examples:
+      valid:
+        - "1001-decision-standard"
+        - "3006-episode-match-complete"
+        - "0201-sso-authentication"
+        - "2301-empty-input-file"
+      invalid:
+        - "101-decision"        # Only 3 digits
+        - "1001_decision"       # Underscore
+        - "1001-Decision"       # PascalCase
+    filesystem:
+      registry: "plan/_trains.yaml"
+      spec: "plan/_trains/{train_id}.yaml"
+    validator:
+      file: "src/atdd/planner/validators/test_train_validation.py"
+      spec: "SPEC-TRAIN-VAL-0001"
+    convention_ref: "atdd/planner/conventions/train.convention.yaml"
+
+  acceptance:
+    description: "Acceptance criteria URN for test traceability"
+    semantic_pattern: "acc:{wagon}:{wmbt}-{harness}-{NNN}[-{slug}]"
+    format: "Structured URN with step code, harness, and sequence"
+    regex: "^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})$"
+    components:
+      wagon: "Parent wagon (kebab-case)"
+      wmbt_id: "Step code [DLPCEMYRK] + 3-digit sequence (e.g., C004)"
+      harness: "Test harness type (uppercase)"
+      sequence: "Zero-padded 3-digit number (001-999)"
+      slug: "Optional kebab-case descriptor"
+    step_codes:
+      D: "Discovery"
+      L: "Load"
+      P: "Parse"
+      C: "Compute"
+      E: "Emit"
+      M: "Mutate"
+      Y: "Yield"
+      R: "Render"
+      K: "Keep"
+    harness_types:
+      - "UNIT"
+      - "HTTP"
+      - "EVENT"
+      - "WS"
+      - "E2E"
+      - "A11Y"
+      - "VIS"
+      - "METRIC"
+      - "JOB"
+      - "DB"
+      - "SEC"
+      - "LOAD"
+      - "SCRIPT"
+      - "WIDGET"
+      - "GOLDEN"
+      - "BLOC"
+      - "INTEGRATION"
+      - "RLS"
+      - "EDGE"
+      - "REALTIME"
+      - "STORAGE"
+    examples:
+      valid:
+        - "acc:commit-state:M001-INTEGRATION-001"
+        - "acc:pace-dilemmas:P011-VISUAL-001"
+        - "acc:maintain-ux:C004-E2E-019-user-connection"
+        - "acc:resolve-dilemmas:C001-UNIT-001-choice-validation"
+      invalid:
+        - "acc:commit-state:M01-INTEGRATION-001"  # Only 2 digits in WMBT
+        - "acc:commit-state:M001-integration-001"  # Lowercase harness
+        - "acc:commit-state:M001-INTEGRATION-01"   # Only 2 digits in sequence
+    validator:
+      file: "src/atdd/tester/validators/test_contract_schema_compliance.py"
+      spec: "SPEC-TESTER-VAL-0020"
+    convention_ref: "atdd/planner/conventions/acceptance.convention.yaml"
+
+  wmbt:
+    description: "What Must Be True step identifier"
+    semantic_pattern: "wmbt:{wagon}:{step_code}{NNN}"
+    format: "Step code letter + 3-digit sequence"
+    regex: "^wmbt:[a-z][a-z0-9-]+:[DLPCEMYRK][0-9]{3}$"
+    examples:
+      valid:
+        - "wmbt:resolve-dilemmas:C001"
+        - "wmbt:commit-state:M001"
+        - "wmbt:pace-dilemmas:P011"
+      invalid:
+        - "wmbt:resolve-dilemmas:C01"   # Only 2 digits
+        - "wmbt:resolve-dilemmas:X001"  # Invalid step code
+    filesystem:
+      file: "plan/{wagon}/wmbt/{step_code}{NNN}.yaml"
+    validator:
+      file: "src/atdd/planner/validators/test_wmbt_consistency.py"
+      spec: "SPEC-PLANNER-VAL-0030"
+    convention_ref: "atdd/planner/conventions/wmbt.convention.yaml"
+
+  appendix:
+    description: "Supplementary reference data"
+    semantic_pattern: "appendix:{type}"
+    format: "kebab-case type identifier"
+    regex: "^appendix:[a-z][a-z0-9-]+$"
+    examples:
+      valid:
+        - "appendix:theme-catalog"
+        - "appendix:error-codes"
+        - "appendix:locale-mappings"
+      invalid:
+        - "appendix:ThemeCatalog"  # PascalCase
+        - "appendix_theme"         # Underscore separator
+    note: "Currently not strictly enforced - documentation pattern"
+    validator:
+      file: "Not yet implemented"
+      spec: "Pending"
+
+  system:
+    description: "External system or service reference"
+    semantic_pattern: "system:{service-name}"
+    format: "kebab-case service identifier"
+    regex: "^system:[a-z][a-z0-9-]+$"
+    examples:
+      valid:
+        - "system:external"
+        - "system:scenario-library"
+        - "system:filesystem"
+        - "system:posthog"
+      invalid:
+        - "system:External"       # PascalCase
+        - "external-system"       # Missing prefix
+    note: "Used in wagon consume references for external dependencies"
+    validator:
+      file: "Not yet implemented"
+      spec: "Pending"
+
+# Validation Summary
+validation_summary:
+  enforced:
+    - wagon: "SPEC-PLATFORM-WAGONS-0008"
+    - feature: "SPEC-PLATFORM-WAGONS-0009"
+    - contract: "SPEC-PLATFORM-WAGONS-0006"
+    - telemetry: "SPEC-PLATFORM-WAGONS-0007"
+    - train: "SPEC-TRAIN-VAL-0001"
+    - acceptance: "SPEC-TESTER-VAL-0020"
+    - wmbt: "SPEC-PLANNER-VAL-0030"
+  pending:
+    - appendix: "Not yet enforced"
+    - system: "Not yet enforced"
+
+# Cross-References
+references:
+  artifact_naming: "atdd/planner/conventions/artifact-naming.convention.yaml"
+  wagon: "atdd/planner/conventions/wagon.convention.yaml"
+  feature: "atdd/planner/conventions/feature.convention.yaml"
+  contract: "atdd/tester/conventions/contract.convention.yaml"
+  telemetry: "atdd/tester/conventions/telemetry.convention.yaml"
+  train: "atdd/planner/conventions/train.convention.yaml"
+  acceptance: "atdd/planner/conventions/acceptance.convention.yaml"
+  wmbt: "atdd/planner/conventions/wmbt.convention.yaml"

{atdd-0.7.1 → atdd-0.7.2}/src/atdd/coach/conventions/session.convention.yaml

@@ -354,6 +354,7 @@ archetypes:
     id: "telemetry"
     description: "Observability and monitoring artifacts"
     artifacts:
+      - "telemetry/_taxonomy.yaml"
       - "telemetry/_telemetry.yaml"
       - "telemetry/{domain}/*.yaml"
     patterns:

{atdd-0.7.1 → atdd-0.7.2}/src/atdd/coach/templates/ATDD.md

@@ -53,6 +53,7 @@ manifest:
   - artifacts: "contracts/_artifacts.yaml"
   - contracts: "contracts/_contracts.yaml"
   - telemetry: "telemetry/_telemetry.yaml"
+  - taxonomy: "telemetry/_taxonomy.yaml"
 
 tests:
   - frontend: "web/tests"

{atdd-0.7.1 → atdd-0.7.2}/src/atdd/coach/templates/SESSION-TEMPLATE.md

@@ -21,6 +21,10 @@ type: "{type}"  # implementation | migration | refactor | analysis | planning |
 complexity: 3  # 1=Trivial, 2=Low, 3=Medium, 4=High, 5=Very High
 archetypes:
   - "{archetype}"  # db | be | fe | contracts | wmbt | wagon | train | telemetry | migrations
+  # NOTE: If archetypes includes 'train', you MUST create/update BOTH:
+  #   1. plan/_trains.yaml (registry entry with train_id, description, path, wagons)
+  #   2. plan/_trains/{train_id}.yaml (full spec with participants, sequence, etc.)
+  # Validator SPEC-TRAIN-VAL-0003 enforces spec file exists for each registry entry.
 
 # Scope definition
 scope:
@@ -38,7 +42,8 @@ workflow_phases:
   planner:
     status: "TODO"  # TODO | IN_PROGRESS | DONE | SKIPPED | N/A
     artifacts:
-      train: false      # plan/_trains.yaml updated
+      train: false      # plan/_trains.yaml updated (registry entry)
+      train_spec: false # plan/_trains/{train_id}.yaml exists (full spec)
       wagon: false      # plan/{wagon}/_{wagon}.yaml exists
       feature: false    # plan/{wagon}/features/{feature}.yaml exists
       wmbt: false       # WMBTs defined in feature YAML

{atdd-0.7.1 → atdd-0.7.2}/src/atdd/planner/conventions/train.convention.yaml

@@ -257,6 +257,23 @@ registry:
   structure: "theme-category-grouped"
   description: "Trains grouped by theme, then by category (nominal/error/alternate/exception) in _trains.yaml manifest"
 
+  # Two-file pattern: Registry + Per-Train Spec Files
+  two_file_pattern:
+    description: "Each train requires two files: a registry entry and a spec file"
+    files:
+      registry:
+        path: "plan/_trains.yaml"
+        purpose: "Central manifest listing all trains with summary metadata"
+        contains: "train_id, description, path, wagons (summary list)"
+      spec:
+        path: "plan/_trains/{train_id}.yaml"
+        purpose: "Full train specification with complete workflow definition"
+        contains: "train_id, title, themes, participants, sequence, dependencies, test, code, expectations"
+    validation:
+      rule: "Every registry entry MUST have a corresponding spec file"
+      validator: "SPEC-TRAIN-VAL-0003 (test_train_files_exist_for_registry_entries)"
+      enforcement: "Planner phase gate fails if spec file missing"
+
   format: |
     trains:
       0-commons:

{atdd-0.7.1 → atdd-0.7.2}/src/atdd/planner/validators/test_plan_wagons.py

@@ -95,6 +95,72 @@ def test_wagon_slugs_match_directory_names(wagon_manifests):
                 f"Wagon slug '{wagon_slug}' doesn't match expected slug '{expected_slug}' (from directory '{directory_name}') for {path}"
 
 
+@pytest.mark.platform
+def test_wagon_names_follow_verb_object_pattern(wagon_manifests):
+    """
+    SPEC-PLATFORM-WAGONS-0008: Wagon names follow verb-object semantic pattern
+
+    Given: All wagon manifests
+    When: Checking wagon name format
+    Then: Wagon names follow verb-object pattern (e.g., resolve-dilemmas, commit-state)
+          - Format: verb-object (kebab-case, at least 2 hyphen-separated words)
+          - First segment should be a verb (action)
+          - Subsequent segments describe the object/domain
+          Per naming.convention.yaml wagon section
+    """
+    import re
+
+    # Pattern: verb-object with optional additional words (e.g., burn-timebank, juggle-domains)
+    # Requires at least 2 segments separated by hyphens
+    verb_object_pattern = re.compile(r"^[a-z][a-z0-9]*-[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*$")
+
+    for path, manifest in wagon_manifests:
+        wagon_name = manifest.get("wagon", "")
+        if wagon_name:
+            assert verb_object_pattern.match(wagon_name), \
+                f"Wagon {path}: name '{wagon_name}' doesn't follow verb-object pattern (e.g., resolve-dilemmas)"
+
+
+@pytest.mark.platform
+def test_feature_names_follow_verb_object_pattern(wagon_manifests):
+    """
+    SPEC-PLATFORM-WAGONS-0009: Feature names follow verb-object semantic pattern
+
+    Given: All wagon manifests with features[] entries
+    When: Checking feature name format from URNs
+    Then: Feature names follow verb-object pattern (e.g., capture-choice, pair-fragments)
+          - URN format: feature:{wagon}:{feature-name}
+          - Feature name requires at least 2 hyphen-separated words
+          Per naming.convention.yaml feature section
+    """
+    import re
+
+    # Pattern: verb-object with optional additional words
+    verb_object_pattern = re.compile(r"^[a-z][a-z0-9]*-[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*$")
+
+    for path, manifest in wagon_manifests:
+        features_list = manifest.get("features", [])
+        wagon_name = manifest.get("wagon", "")
+
+        for feature in features_list:
+            feature_name = None
+
+            # Extract feature name from URN
+            if isinstance(feature, dict) and "urn" in feature:
+                urn = feature["urn"]
+                parts = urn.split(":")
+                if len(parts) >= 3:
+                    feature_name = parts[2]
+            elif isinstance(feature, str) and feature.startswith("feature:"):
+                parts = feature.split(":")
+                if len(parts) >= 3:
+                    feature_name = parts[2]
+
+            if feature_name:
+                assert verb_object_pattern.match(feature_name), \
+                    f"Wagon {wagon_name}: feature '{feature_name}' doesn't follow verb-object pattern (e.g., capture-choice)"
+
+
 @pytest.mark.platform
 def test_produce_artifact_names_follow_convention(wagon_manifests):
     """
@@ -153,9 +219,10 @@ def test_telemetry_urns_match_pattern(wagon_manifests):
 
     Given: Wagon produce items with non-null telemetry URNs
     When: Validating URN format
-    Then: Telemetry URNs match pattern telemetry:{path}:{aspect}
-          Supports multi-level paths (e.g., telemetry:commons:ux:foundations)
-          Uses colons (not dots) for hierarchy
+    Then: Telemetry URNs match pattern telemetry:{path}:{aspect}(.{variant})?
+          - Colons (:) for hierarchical descent (e.g., telemetry:commons:ux:foundations)
+          - Dots (.) for lateral variants (e.g., telemetry:mechanic:decision.choice)
+          Per telemetry.convention.yaml id_vs_urn section
     """
     import re
 

{atdd-0.7.1 → atdd-0.7.2}/src/atdd/tester/conventions/telemetry.convention.yaml

@@ -318,7 +318,7 @@ tracking_structure:
   version: "1.1.0"
 
   manifest:
-    location: "telemetry/_tracking.yaml"
+    location: "telemetry/_taxonomy.yaml"
     format: "YAML"
     purpose: "Central registry of all telemetry signals per artifact"
 
@@ -401,18 +401,23 @@ tracking_structure:
     signal_id_examples:
       - "commons:ux:foundations:color.metric.be.count"
       - "match:dilemma:current.metric.be.selection_duration"
-      - "commons:ux:foundations:foundations.metric.be.error_rate"
-    urn: "telemetry:{theme}(:{path})*:{aspect}"
+      - "mechanic:decision.choice.event.be"
+    urn: "telemetry:{theme}(:{path})*:{aspect}(.{variant})?"
     urn_examples:
-      - "telemetry:commons:ux:foundations"
-      - "telemetry:match:dilemma"
+      - "telemetry:mechanic:decision.choice"
+      - "telemetry:juggle:goal.detected"
+      - "telemetry:mechanic:episode.timer"
+      - "telemetry:match:dilemma:current"
     note: |
-      $id in signal file: NO "telemetry:" prefix (e.g., commons:ux:foundations:color.metric.be.count)
-      URN in wagon manifests: WITH "telemetry:" prefix (e.g., telemetry:commons:ux:foundations)
-      artifact_ref: WITH "contract:" prefix (e.g., contract:commons:ux:foundations:color)
+      $id in signal file: NO "telemetry:" prefix (e.g., mechanic:decision.choice.event.be)
+      URN in wagon manifests: WITH "telemetry:" prefix (e.g., telemetry:mechanic:decision.choice)
+      artifact_ref: WITH "contract:" prefix (e.g., contract:mechanic:decision.choice)
 
-      Hierarchy (colons) for path segments, dots for signal facets (type.plane.measure).
-      Mirrors contract structure perfectly.
+      Hierarchy (colons) for path segments, dots for:
+      - Variants in URN (e.g., decision.choice, goal.detected)
+      - Signal facets in $id (type.plane.measure)
+
+      Aligns with artifact-naming.convention.yaml separator semantics.
 
       Examples:
         File: telemetry/commons/ux/foundations/color.metric.be.count.json
@@ -421,19 +426,19 @@ tracking_structure:
         artifact_ref: contract:commons:ux:foundations:color
 
   urn_path_mapping:
-    pattern: "telemetry:{theme}(:{path})*:{aspect} (wagon manifest format)"
+    pattern: "telemetry:{theme}(:{path})*:{aspect}(.{variant})? (wagon manifest format)"
     path_construction:
-      directory: "telemetry/{theme}/{path}/{aspect}/"
-      filename: "{resource}.{type}.{plane}[.{measure}].json"
+      directory: "telemetry/{theme}/{path}/"
+      filename: "{aspect}[.{variant}].{type}.{plane}[.{measure}].json"
     round_trip: "URN ↔ path must be identity transformation"
-    note: "Directory structure mirrors contracts exactly - aspect is subdirectory, resource is filename prefix"
+    note: "Directory structure mirrors contracts. Dot notation allowed for variants in URN."
     comparison:
-      contract_path: "contracts/commons/ux/foundations/color.schema.json"
-      contract_id: "commons:ux:foundations:color"
-      contract_urn: "contract:commons:ux:foundations:color"
-      telemetry_path: "telemetry/commons/ux/foundations/color.metric.be.count.json"
-      telemetry_id: "commons:ux:foundations:color.metric.be.count"
-      telemetry_urn: "telemetry:commons:ux:foundations"
+      contract_path: "contracts/mechanic/decision/choice.schema.json"
+      contract_id: "mechanic:decision.choice"
+      contract_urn: "contract:mechanic:decision.choice"
+      telemetry_path: "telemetry/mechanic/decision/choice.event.be.json"
+      telemetry_id: "mechanic:decision.choice.event.be"
+      telemetry_urn: "telemetry:mechanic:decision.choice"
 
   artifact_naming_grammar:
     pattern: "{theme}:{domain}:{aspect}"

{atdd-0.7.1 → atdd-0.7.2}/src/atdd/tester/schemas/telemetry_tracking_manifest.schema.json

@@ -2,7 +2,7 @@
   "$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",
+  "description": "Schema for telemetry/_taxonomy.yaml manifest file",
   "type": "object",
   "required": ["version", "planes", "measures", "artifacts"],
   "properties": {

{atdd-0.7.1 → atdd-0.7.2/src/atdd.egg-info}/PKG-INFO

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

{atdd-0.7.1 → atdd-0.7.2}/src/atdd.egg-info/SOURCES.txt

@@ -31,6 +31,7 @@ src/atdd/coach/commands/test_runner.py
 src/atdd/coach/commands/traceability.py
 src/atdd/coach/commands/tests/__init__.py
 src/atdd/coach/commands/tests/test_telemetry_array_validation.py
+src/atdd/coach/conventions/naming.convention.yaml
 src/atdd/coach/conventions/session.convention.yaml
 src/atdd/coach/overlays/__init__.py
 src/atdd/coach/overlays/claude.md