atdd 0.7.0__py3-none-any.whl → 0.7.2__py3-none-any.whl

atdd/coach/commands/inventory.py

@@ -148,9 +148,16 @@ class RepositoryInventory:
                 by_theme[theme] += 1
 
             # Gap analysis
-            expectations = train.get("expectations", {})
-            test_fields = train.get("test", {})
-            code_fields = train.get("code", {})
+            expectations = train.get("expectations")
+            test_fields = train.get("test")
+            code_fields = train.get("code")
+
+            if not isinstance(expectations, dict):
+                expectations = {}
+            if test_fields is None:
+                test_fields = {}
+            if code_fields is None:
+                code_fields = {}
 
             # Normalize test/code to dict form
             if isinstance(test_fields, str):

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/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/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/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/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/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/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/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/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/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.0.dist-info → atdd-0.7.2.dist-info}/METADATA

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

{atdd-0.7.0.dist-info → atdd-0.7.2.dist-info}/RECORD

@@ -12,23 +12,24 @@ atdd/coach/commands/gate.py,sha256=_V2GypqoGixTs_kLWxFF3HgEt-Wi2r6Iv0YL75yWrWo,5
 atdd/coach/commands/infer_governance_status.py,sha256=MlLnx8SrJAOQq2rfuxLZMmyNylCQ-OYx4tSi_iFdhRA,4504
 atdd/coach/commands/initializer.py,sha256=wuvzj7QwA11ilNjRZU6Bx2bLQXITdBHJxR9_mZK7xjA,6503
 atdd/coach/commands/interface.py,sha256=FwBrJpWkfSL9n4n0HT_EC-alseXgU0bweKD4TImyHN0,40483
-atdd/coach/commands/inventory.py,sha256=7Znpx2mFh3rQXEguUzIaBage3B5m1L_K2esYyd3pfLY,24764
+atdd/coach/commands/inventory.py,sha256=hI8JwG7Ph-jBhd5a8j3kwDMJVvFjzq8A0Zpt8TYEHXI,24976
 atdd/coach/commands/migration.py,sha256=wRxU7emvvHqWt1MvXKkNTkPBjp0sU9g8F5Uy5yV2YfI,8177
-atdd/coach/commands/registry.py,sha256=9iWW34CCJAr36v91863u8TDdlGQJdLpYYBGb1ojtS1Q,71546
+atdd/coach/commands/registry.py,sha256=Ri2X5AqzojNokxP5-yb3nZj6nO9DsNT-68vgsSOmgg0,71558
 atdd/coach/commands/session.py,sha256=MhuWXd5TR6bB3w0t8vANeZx3L476qwLT6EUQMwg-wQA,14268
 atdd/coach/commands/sync.py,sha256=SLNzhcc6IuzMofMbkH9wM9rBSk5tPfcWPKXn9TaSZ-Y,13782
 atdd/coach/commands/test_interface.py,sha256=a7ut2Hhk0PnQ5LfJZkoQwfkfkVuB5OHA4QBwOS0-jcg,16870
 atdd/coach/commands/test_runner.py,sha256=_6JrDRq5fBHUOC4MtkgXcjkgJjG80otoGRTqnkEphIk,5832
-atdd/coach/commands/traceability.py,sha256=8TmpZDeUVHJAz-p3oxXq55jCFiFpKIQR8h1wLZVYcgA,163612
+atdd/coach/commands/traceability.py,sha256=uB-QMM3MWvY2NSsMDubAN-vY0ddI1uJIRmHLqhZIR_E,163618
 atdd/coach/commands/tests/__init__.py,sha256=svBEnRruMuXuaYi3lFxJlzHNWdZ5vlBTaBpjXupaxDA,33
 atdd/coach/commands/tests/test_telemetry_array_validation.py,sha256=WK5ZXvR1avlzX7mSX84dmxxLFnw7eQB4jtjo7bHG7aE,8464
-atdd/coach/conventions/session.convention.yaml,sha256=1wCxQ_Y2Wb2080Xt2JZs0_WsV8_4SC0Tq87G_BCGdiE,26049
+atdd/coach/conventions/naming.convention.yaml,sha256=GHqymDducgMxcMmSUwoKE6xXGEv8AENodWgAzcS7o60,11191
+atdd/coach/conventions/session.convention.yaml,sha256=Z4hCFNjOizgDXTRVqNZ4VaG40TIFF31zDkMZdA-xrvI,26084
 atdd/coach/overlays/__init__.py,sha256=2lMiMSgfLJ3YHLpbzNI5B88AdQxiMEwjIfsWWb8t3To,123
 atdd/coach/overlays/claude.md,sha256=33mhpqhmsRhCtdWlU7cMXAJDsaVra9uBBK8URV8OtQA,101
 atdd/coach/schemas/config.schema.json,sha256=47cFGE5juBv9ewhtgrNir4b6I9imIIo8VjoD9yvASf4,4578
 atdd/coach/schemas/manifest.schema.json,sha256=WO13-YF_FgH1awh96khCtk-112b6XSC24anlY3B7GjY,2885
-atdd/coach/templates/ATDD.md,sha256=h_oPpKLX7nuafC0VAoKCnkM2-kGQeksR34QWlGyfMwU,13236
-atdd/coach/templates/SESSION-TEMPLATE.md,sha256=cGT_0x5KLbPHOCiuM8evLGpWKIlR-aggqxiBtbjSJoo,9478
+atdd/coach/templates/ATDD.md,sha256=JTSPm-J2Xr6XfPodDCxnVyrKoMf2eHF2rlFw8ft6RLQ,13277
+atdd/coach/templates/SESSION-TEMPLATE.md,sha256=uuvSR-OBVb1QrmU5HcS0iO9ohng0o2nVg-qaAe76HY4,9894
 atdd/coach/utils/__init__.py,sha256=7Jbo-heJEKSAn6I0s35z_2S4R8qGZ48PL6a2IntcNYg,148
 atdd/coach/utils/config.py,sha256=6XXaaeVfjTrJwdaR0IZ6Kf1-1ZHhaCVLO5pNx_A2el4,3320
 atdd/coach/utils/coverage_phase.py,sha256=14CzGiTEeb-Z-CMYnJjx1-4dn3LbQVJUlFr_-1bKVMc,3250
@@ -108,7 +109,7 @@ atdd/planner/conventions/criteria.convention.yaml,sha256=twQElTZEu5hGN5blDE66OUx
 atdd/planner/conventions/feature.convention.yaml,sha256=Jksi04E2h8PaUBbjR1GLKMXf-ec9MJrUcOK2lJC2hjg,11324
 atdd/planner/conventions/interface.convention.yaml,sha256=NBWlIbXuwYtmxkc20zzzgFOs43v9ID6V3b82drrzQ3c,16323
 atdd/planner/conventions/steps.convention.yaml,sha256=DkRry5s0I85BuEmrF7N1VhInZPeE-pRLbJ0zPYSWyY0,6804
-atdd/planner/conventions/train.convention.yaml,sha256=XlHGpKbSBqqdKSNr17RnqmKi9j5hBYLVQQtxSsnsRzE,19454
+atdd/planner/conventions/train.convention.yaml,sha256=5WiODngpAhL7FJcHxXooIjkFJ3zVOn5OG_qK4w2o2IU,20303
 atdd/planner/conventions/wagon.convention.yaml,sha256=0qC0utZGH1cN07Jo5O2gZg-XFQgT1q23zxsHxjkFuz4,11093
 atdd/planner/conventions/wmbt.convention.yaml,sha256=p8kvWR8rqYzQaY3J_BToxaI06Vaa96wM4CR_VP_Y4hc,14393
 atdd/planner/schemas/acceptance.schema.json,sha256=3mQV067ipiYsTcXkDll4zWJBYdOkB_Y3kApV7byjdxs,11889
@@ -125,7 +126,7 @@ atdd/planner/validators/test_hierarchy_coverage.py,sha256=7NG_2GL4B-CQKHAHxTHxCv
 atdd/planner/validators/test_plan_cross_refs.py,sha256=kxlq1uZ2u4mn3r8wHJjXVJsB8nmzwsvSzOlRapJ9pBY,9520
 atdd/planner/validators/test_plan_uniqueness.py,sha256=rlC5khAoBkgpTZJdyHi1JbDUj14v1JiGBFv2iV_AP_Y,7735
 atdd/planner/validators/test_plan_urn_resolution.py,sha256=GoxFiRjOfp69FUmIyKGnsGgpYalOz3qfp6qjyCkga44,9440
-atdd/planner/validators/test_plan_wagons.py,sha256=l4jbHf9Kg-Fy8Gz5O8BO7PDQKbbeLN0uctoErPK_YKI,7357
+atdd/planner/validators/test_plan_wagons.py,sha256=fFK34Ul1dg7fuz0t2BmncEWudDknyQ8ftp_NdNez2pQ,10232
 atdd/planner/validators/test_train_validation.py,sha256=7vlu3P8PenWgZhZCf9kO0UTM-k1n37Ds_jUvrJa-Np0,39264
 atdd/planner/validators/test_wagon_urn_chain.py,sha256=KY_0vrj6CoiQJ80WbqfCGCYbup13cVssaxbNO0eVf74,26697
 atdd/planner/validators/test_wmbt_consistency.py,sha256=jdfu4xWEozzBGwplKDXxuDQNLBDxB_AC96NHLkyHqQ8,10875
@@ -139,7 +140,7 @@ atdd/tester/conventions/migration.convention.yaml,sha256=Xx5EIwNct6wb--sYtm7EJp8
 atdd/tester/conventions/red.convention.yaml,sha256=S0mc4JpvNuOSYhqmt6bm0tCuDTCFYFRsSBru3XMwXgs,28901
 atdd/tester/conventions/routing.convention.yaml,sha256=gRJrnQd-cXCUGby0CeaJdRmrFXZx70kl-FxXCoXiu5Y,2751
 atdd/tester/conventions/security.convention.yaml,sha256=3QjQZqw1Iw8g6jUmuKWkOqcZ1n1sc1OJDvKD0eTk070,5445
-atdd/tester/conventions/telemetry.convention.yaml,sha256=n8Q8x7BtiDnDf920EWiq3xBzaf8tYev7WIi1pQ27O6o,16119
+atdd/tester/conventions/telemetry.convention.yaml,sha256=B1-j4jqPenXVrKBrYaiWy8sAP0VgbJyC5LRLXmzDdeg,16260
 atdd/tester/schemas/a11y.tmpl.json,sha256=o-i8-fQeLxqTPgeDysOQDvyoHdlcCDOlUGtPG1-_Wro,1088
 atdd/tester/schemas/artifact.schema.json,sha256=CVmhmz9dsSsZW4HYS_wohn-kzq_mx4YPYunwrBHtbQg,5755
 atdd/tester/schemas/contract.schema.json,sha256=2fHyVeLzFUkdQuWGxt3gdxblIPFTB0tkmHUYUYdcf-E,19639
@@ -160,7 +161,7 @@ atdd/tester/schemas/script.tmpl.json,sha256=VML3qBtWX6giG1yXZSDpgAoPHWzm8UkFUO0a
 atdd/tester/schemas/sec.tmpl.json,sha256=XIahZQMd128nmpvTPC6TXgOqrwHsGnS-qhkORMo7gGE,909
 atdd/tester/schemas/storage.tmpl.json,sha256=BLGzhrvt79x2zjmhml8L01AlBj0xsCtuqIlF_aQAuw0,1038
 atdd/tester/schemas/telemetry.schema.json,sha256=dJjKM66uur032rUTkzxEwtpfVS5njI83wCIzbrE_Vo4,3319
-atdd/tester/schemas/telemetry_tracking_manifest.schema.json,sha256=hw844n-k5SCOfzTPhIwYWV4tT8z-bxhby6ILUZknNao,3846
+atdd/tester/schemas/telemetry_tracking_manifest.schema.json,sha256=uFibjN6V-GHK45tz5ZXs4z3kjcjJa9A_AalNdu-1jyI,3846
 atdd/tester/schemas/test_filename.schema.json,sha256=-kzKAyeXhgNc7J1W35HmubbOi1_YPpEruT30wZLQe_U,6717
 atdd/tester/schemas/test_intent.schema.json,sha256=4gt0We9rwoQXF0p1TSY3eC37BMmM-MR8-BOA4tlO22o,5206
 atdd/tester/schemas/unit.tmpl.json,sha256=dWxUT2zWdvg1GRyMcSY-J_EBs0yCSu9F0cmuh6rtBXs,823
@@ -200,9 +201,9 @@ atdd/tester/validators/test_train_frontend_e2e.py,sha256=fpfUwTbAWzuqxbVKoaFw-ab
 atdd/tester/validators/test_train_frontend_python.py,sha256=KK2U3oNFWLyBK7YHC0fU7shR05k93gVcO762AI8Q3pw,9018
 atdd/tester/validators/test_typescript_test_naming.py,sha256=E-TyGv_GVlTfsbyuxrtv9sOWSZS_QcpH6rrJFbWoeeU,11280
 atdd/tester/validators/test_typescript_test_structure.py,sha256=eV89SD1RaKtchBZupqhnJmaruoROosf3LwB4Fwe4UJI,2612
-atdd-0.7.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-atdd-0.7.0.dist-info/METADATA,sha256=EEjcJY5c8XfUKF8ebYBc1o3mjFrJqqJldicW2coK-iQ,8716
-atdd-0.7.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-atdd-0.7.0.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
-atdd-0.7.0.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
-atdd-0.7.0.dist-info/RECORD,,
+atdd-0.7.2.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+atdd-0.7.2.dist-info/METADATA,sha256=_Rvqn06owPOazCQlN34cO_5tPLWZipNsRU0yfUABKrU,8716
+atdd-0.7.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+atdd-0.7.2.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
+atdd-0.7.2.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
+atdd-0.7.2.dist-info/RECORD,,