@afokapu/atdd-bun 0.1.0

package/planner-nodes/nodes/planner.train.validation-rules.convention.yaml

@@ -0,0 +1,31 @@
+schema_version: 1.1.0
+rule_id: planner.train.validation-rules
+kind: constraint
+status: active
+name: Train validation rules
+statement: A train must satisfy the documented validation rules (typed id, declared themes, spec file
+  exists, participants declared, valid dependencies, domain:resource artifacts, category declared as a
+  field).
+source:
+  legacy_path: src/atdd/planner/conventions/train.convention.yaml
+  legacy_section: validation_rules
+  legacy_sha: 825602729f11a3a4
+  extraction_mode: high_fidelity
+content:
+  constraints:
+  - 'train_id must match the typed pattern: train:{subject}:{slug}'
+  - Category is a declared field (nominal|error|alternate|exception), never a digit in the identity
+  - Spec file must exist at the train's declared path
+  - All participants must be declared in participants list
+  - Dependencies must reference valid train_ids
+  - Artifacts in sequence must follow domain:resource pattern
+  - Themes must be declared in the themes array
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: validation_rule
+  text: a train structural validation rule.

package/planner-nodes/nodes/planner.train.variation-strategies.convention.yaml

@@ -0,0 +1,26 @@
+schema_version: 1.1.0
+rule_id: planner.train.variation-strategies
+kind: family
+status: active
+name: Train variation strategies
+statement: Create train variations within a theme by mode, complexity, persona, or phase.
+source:
+  legacy_path: src/atdd/planner/conventions/train.convention.yaml
+  legacy_section: variation_strategies
+  legacy_sha: 825602729f11a3a4
+  extraction_mode: high_fidelity
+parity:
+  source_fragments_preserved: true
+  examples_preserved: true
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: variation_strategy
+  label: Variation strategies
+  text: strategy -> example.
+  values:
+    by_mode: train:match:solo / train:match:duel / train:match:team
+    by_complexity: train:decision:core / train:decision:timeout / train:decision:preview
+    by_persona: train:player:registration / train:partnership:sponsor-registration
+    by_phase: train:league:tournament-setup / train:league:tournament-active / train:league:tournament-complete

package/planner-nodes/nodes/planner.wagon.artifact-contracts.convention.yaml

@@ -0,0 +1,29 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.artifact-contracts
+kind: rule
+status: active
+name: Wagon artifact URN formats
+statement: A wagon's produced artifacts carry a contract URN (contract:{...}) and a telemetry URN (telemetry:{...})
+  following the artifact-naming grammar.
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: artifact_contracts.urn_format
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+content:
+  examples:
+  - contract:commons:ux:foundations:color
+  - contract:mechanic:decision.choice
+  - telemetry:commons:ux:foundations
+parity:
+  source_fragments_preserved: true
+  examples_preserved: true
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: artifact_urn
+  text: the contract/telemetry URN forms.
+  values:
+    contract_urn: contract:{theme}(:{category})*:{aspect}(.{variant})?
+    telemetry_urn: telemetry:{theme}(:{category})*:{aspect}(.{variant})?

package/planner-nodes/nodes/planner.wagon.complexity-model.convention.yaml

@@ -0,0 +1,33 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.complexity-model
+kind: principle
+status: active
+name: Wagon complexity is super-linear in cross-wagon coupling
+statement: Wagon sizing has two orthogonal axes — intrinsic footprint (how much work is inside) and coupling complexity (whether the cut is correct). Complexity is modeled as super-linear in cross-wagon coupling, not additive in component count.
+source:
+  legacy_path: docs/recompose
+  legacy_section: complexity-sizing
+  extraction_mode: summary
+content:
+  normative_text: 'Two orthogonal axes size a wagon. (1) SIZE — intrinsic footprint, already covered by planner.feature.footprint-scoring (additive: sum(count x weight)). (2) SEPARABILITY/COMPLEXITY — whether the wagon is a well-separated unit in the produce/consume graph. Complexity is modeled as SUPER-LINEAR in cross-wagon coupling; a wagon can be small in footprint yet mis-cut (densely coupled to a neighbor -> MERGE; two internal clusters -> SPLIT). The first enforcement (planner.wagon.no-consume-cycle) is the exact invariant; separability and granularity signals are advisory and calibrated before any promotion to strict.'
+  rationale: 'Henry-Kafura (fan_in x fan_out)^2 and treewidth provide the conceptual backing for super-linearity, but they are RATIONALE, not day-one enforcement: the implementation uses conservative graph proxies (cross-wagon fan-in/fan-out, shared-artifact adjacency, SCCs, community-cut signals) so validators do not become noisy before corpus calibration.'
+metadata:
+  severity: 2
+  disposition: documentation-only
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-18'
+terms:
+- term_id: size_axis
+  text: intrinsic footprint — additive volume of components (planner.feature.footprint-scoring).
+- term_id: separability_axis
+  text: coupling complexity — whether the wagon is a well-separated unit in the produce/consume graph.
+- term_id: cohesion
+  text: intra-wagon shared-artifact / object-of-control density of a wagon's own WMBTs.
+- term_id: coupling
+  text: shared produce/consume artifact-name weight between a wagon and a neighbor wagon.
+- term_id: separable
+  text: a wagon is separable when its internal cohesion is at least its tightest coupling to any single neighbor.

package/planner-nodes/nodes/planner.wagon.coupling-complexity.convention.yaml

@@ -0,0 +1,32 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.coupling-complexity
+kind: rule
+status: active
+name: Wagon coupling complexity (advisory reporter)
+statement: Report each wagon's cross-wagon coupling complexity (fan_in x fan_out over the produce->consume name graph); flag wagons above a soft, config-driven threshold. Advisory and non-blocking.
+implementation:
+  type: validator
+  ref: conventions/sizing/test_wagon_coupling_complexity::test_fault_injection_legacy_parity
+source:
+  legacy_path: docs/recompose
+  legacy_section: complexity-sizing
+  extraction_mode: summary
+content:
+  normative_text: 'Build the directed wagon graph from produce->consume artifact NAMES. For each wagon compute fan_in (wagons it consumes from) and fan_out (wagons that consume its outputs); the coupling-complexity proxy is fan_in x fan_out (Henry-Kafura). Emit an ADVISORY finding for any wagon whose proxy exceeds a soft threshold (config key planner.wagon.coupling_complexity_threshold, default 6). Non-blocking: makes complexity runnable and visible via `atdd validate planner` without halting planning. Promotion to a hard threshold/strict is deferred to corpus calibration.'
+  constraints:
+  - advisory only — never blocks
+  - keyed on produce/consume artifact name, not the nullable contract field
+metadata:
+  severity: 2
+  disposition: advisory
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: true
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-18'
+terms:
+- term_id: coupling_complexity
+  text: fan_in x fan_out over the cross-wagon produce/consume graph (Henry-Kafura proxy).
+- term_id: soft_threshold
+  text: config-driven advisory cutoff (planner.wagon.coupling_complexity_threshold, default 6); over it emits an advisory finding.

package/planner-nodes/nodes/planner.wagon.definition.convention.yaml

@@ -0,0 +1,30 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.definition
+kind: family
+status: draft
+name: Wagon — advisory semantic anchor
+statement: A wagon is a separable, semantically-coherent unit of work within a journey
+  — a single subject/action/goal that consumes and produces declared artifacts and
+  composes with sibling wagons into trains without forming a produce/consume cycle.
+  This is a planner domain-decomposition artifact naming a unit of the domain; how the
+  unit executes at runtime is a coder/tester concern. This node is an advisory semantic
+  anchor — it enforces nothing directly; the enforceable parts of this meaning are
+  decomposed into the constraint/rule nodes that require it.
+terms:
+- term_id: semantic_anchor
+  label: Advisory semantic anchor
+  text: a definitional node that gives the artifact a stable meaning but is not itself
+    bound to a validator; it is transitively protected by the enforceable constraint/rule
+    nodes that require it.
+- term_id: wagon
+  label: Wagon
+  text: wagon -> {separable, semantically-coherent, artifact-producing, artifact-consuming,
+    acyclic, feature-bearing}.
+  values:
+    separable: cut from siblings along a correct boundary (see planner.wagon.separability,
+      planner.wagon.coupling-complexity).
+    semantically-coherent: subject/action/goal align, outcome is measurable (see planner.wagon.semantic-coherence).
+    artifacts: consumes and produces declared artifacts across contracts (see planner.wagon.produce-consume-artifacts,
+      planner.wagon.artifact-contracts).
+    acyclic: wagons must not form a produce/consume cycle (see planner.wagon.no-consume-cycle).
+    feature-bearing: groups the features that decompose its behavior (see planner.wagon.features).

package/planner-nodes/nodes/planner.wagon.features-format.convention.yaml

@@ -0,0 +1,28 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.features-format
+kind: rule
+status: active
+name: Wagon features format
+statement: A wagon's features are declared as an array of URN objects (feature:{wagon-slug}:{feature-name});
+  the legacy object map is deprecated.
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: artifact_contracts.features_format
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+content:
+  examples:
+  - 'urn_format: [{urn: feature:maintain-ux:provide-foundations}, {urn: feature:maintain-ux:compose-primitives}]'
+  - 'legacy_format (object): {provide-foundations: ''Provide foundation design tokens''}'
+parity:
+  source_fragments_preserved: true
+  examples_preserved: true
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: features_format
+  text: the features declaration shape.
+  values:
+    urn_format: 'array of {urn: feature:{wagon-slug}:{feature-name}}'
+    legacy_format: object map (deprecated)

package/planner-nodes/nodes/planner.wagon.features.convention.yaml

@@ -0,0 +1,27 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.features
+kind: rule
+status: active
+name: Wagon features manifest
+statement: A wagon's _features.yaml lists every feature module and its current status.
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: rules
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+  legacy_rule_id: planner.wagon.features
+metadata:
+  aliases:
+  - PLANNER-WAGON-FEATURES-001
+  severity: 2
+  disposition: documentation-only
+  introduced_in: 1.67.0
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: features_manifest
+  text: the wagon's _features.yaml index of feature modules + statuses.

package/planner-nodes/nodes/planner.wagon.logical-vs-filesystem-naming.convention.yaml

@@ -0,0 +1,34 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.logical-vs-filesystem-naming
+kind: rule
+status: active
+name: Logical (kebab) vs filesystem (snake) naming
+statement: Logical identifiers (URNs, slugs, YAML refs) use kebab-case; the filesystem (directories, manifest
+  files, feature files) uses snake_case.
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: naming.filesystem_naming
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+content:
+  normative_text: Consistent filesystem naming reduces conversion complexity; clear separation between
+    logical (kebab) and physical (snake) identifiers.
+  examples:
+  - feature:authenticate-identity:verify-session -> plan/authenticate_identity/ + _authenticate_identity.yaml
+    + features/verify_session.yaml
+parity:
+  source_fragments_preserved: true
+  examples_preserved: true
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: naming_surface
+  label: Naming by surface
+  text: surface -> format + pattern.
+  values:
+    urns_and_slugs: kebab-case (URNs, slug fields, references)
+    directories: snake_case, plan/{wagon_dirname}/
+    manifest_files: _{dirname}.yaml at plan/{dirname}/_{dirname}.yaml (matches DIR name, not slug)
+    feature_files: snake_case, plan/{wagon_dirname}/features/{feature_name}.yaml (underscores even though
+      URNs use hyphens)

package/planner-nodes/nodes/planner.wagon.name-is-verb-object.convention.yaml

@@ -0,0 +1,39 @@
+schema_version: 1.0.0
+rule_id: planner.wagon.name-is-verb-object
+kind: rule
+status: active
+name: Wagon name is verb-object
+statement: A wagon slug must be verb-object — kebab-case, at least two tokens, the
+  leading token a verb from the convention verb lexicon, and no connective tokens.
+  Brand or proper-noun slugs must be listed explicitly in wagon.convention.yaml
+  verb_object_enforcement.brand_exceptions; an implicit exception is a violation.
+terms:
+- term_id: wagon_verb_object
+  text: the verb-object naming rule for a wagon slug
+  values:
+    lexicon_source: conventions:planner:feature#/artifact_seeds/verb_selection
+    examples_ok:
+    - resolve-dilemmas
+    - manage-users
+    - route-request
+    - preview-changes
+    - respond-event
+    examples_bad:
+    - mode-select
+    - blitz
+implementation:
+  type: validator
+  ref: test_wagon_name_is_verb_object::test_confirm_blocks_non_verb_object_wagon
+metadata:
+  severity: 3
+  disposition: strict
+validation:
+  family: format
+  template: naming_pattern
+  variant: planner_wagon_name_is_verb_object
+  phase: CONFIRM
+  enforcement: confirm-blocking
+  subject_kind: wagon
+  failure_evidence:
+  - wagon_slug
+  - reason

package/planner-nodes/nodes/planner.wagon.no-consume-cycle.convention.yaml

@@ -0,0 +1,30 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.no-consume-cycle
+kind: constraint
+status: active
+name: No cross-wagon produce/consume cycle
+statement: The directed wagon graph built from produce->consume artifact NAMES must be acyclic; no strongly-connected component may span more than one wagon.
+implementation:
+  type: validator
+  ref: conventions/acyclicity/test_no_cross_wagon_consume_cycle::test_fault_injection_convention_catches
+source:
+  legacy_path: docs/recompose
+  legacy_section: complexity-sizing
+  extraction_mode: summary
+content:
+  normative_text: 'Build a directed graph whose nodes are wagons and whose edges go producer-wagon -> consumer-wagon whenever an artifact NAME produced by one wagon is consumed by another wagon. Run strongly-connected-component analysis; any SCC containing more than one wagon is a cross-wagon dependency cycle and a violation. The graph is keyed on artifact name, never on the contract field (contract is nullable corpus-wide).'
+  constraints:
+  - the cross-wagon produce/consume graph is a DAG
+  - edges are keyed on the produce/consume artifact name, not the nullable contract field
+metadata:
+  severity: 3
+  disposition: strict
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: true
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-18'
+terms:
+- term_id: consume_cycle
+  text: a strongly-connected component of the directed wagon produce/consume graph whose size exceeds one wagon.

package/planner-nodes/nodes/planner.wagon.produce-consume-artifacts.convention.yaml

@@ -0,0 +1,46 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.produce-consume-artifacts
+kind: rule
+status: active
+name: Produce/consume artifact shape
+statement: produce[] entries declare name + contract + telemetry (optional to/urn/version); consume[]
+  entries declare name (optional from/contract/telemetry/urn/version).
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: artifact_contracts.produce_artifacts + artifact_contracts.consume_artifacts
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+content:
+  examples:
+  - 'produce: {name: commons:ux:foundations, contract: contract:..., telemetry: telemetry:...}; {name:
+    internal:cache, contract: null, telemetry: null, to: internal}'
+  - 'consume: {name: commons:ux:foundations, from: wagon:maintain-ux, contract: contract:...}'
+parity:
+  source_fragments_preserved: true
+  examples_preserved: true
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: produce_fields
+  text: produce[] entry fields.
+  values:
+    required:
+    - name
+    - contract
+    - telemetry
+    optional:
+    - to (internal|external, default external)
+    - urn
+    - version
+- term_id: consume_fields
+  text: consume[] entry fields.
+  values:
+    required:
+    - name
+    optional:
+    - from (wagon:slug|system:service|appendix:type|internal)
+    - contract
+    - telemetry
+    - urn
+    - version

package/planner-nodes/nodes/planner.wagon.refinement-extraction.convention.yaml

@@ -0,0 +1,49 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.refinement-extraction
+kind: family
+status: active
+name: Wagon refinement extraction
+statement: Refine ambiguous input into a structured wagon by extracting subject, action, goal, context,
+  outcome, produce/consume artifacts, and theme.
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: refinement.extraction
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+content:
+  operational_guidance: subject = WHO/WHAT performs the action (actor:role/entity:state); action = core
+    present-tense verb phrase; goal = WHY/motivation; context = WHEN/WHERE (comma-separated conditions);
+    outcome = measurable result; description >=10 chars.
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: extraction_field
+  label: Refinement fields
+  text: field -> what to extract.
+  values:
+    subject: WHO/WHAT performs the action (actor:role or entity:state)
+    action: core present-tense verb phrase
+    goal: WHY/motivation, single intent statement
+    context: WHEN/WHERE, comma-separated conditions
+    outcome: measurable progress statement
+    produce: owned output artifacts
+    consume: input artifacts owned by other wagons
+- term_id: wagon_theme
+  label: Wagon theme options
+  text: theme -> scope.
+  values:
+    mechanic: Core game rules, decision systems, and immediate feedback loops
+    scenario: Content ingestion, entity extraction, and narrative structure processing
+    match: Session orchestration, state management, and lifecycle control, Multi-player coordination,
+      turn management
+    sensory: UI rendering, audio mixing, gesture capture, and player interaction
+    player: Individual lifecycle, onboarding, progression, and session management
+    league: Competitive organization, bracket management, and tournament operations
+    audience: Spectator engagement, streaming infrastructure, and viewer participation
+    monetization: Token economy, wallet operations, and transaction processing
+    partnership: Sponsor/partner onboarding, delegation, and commercial integration
+    commons: Shared infrastructure, cross-cutting utilities, and platform services

package/planner-nodes/nodes/planner.wagon.semantic-coherence.convention.yaml

@@ -0,0 +1,30 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.semantic-coherence
+kind: constraint
+status: active
+name: Wagon semantic coherence
+statement: 'A wagon must be semantically coherent: subject/action/goal align, outcome is measurable, produce
+  is owned, consume is foreign, and at least one produce is external.'
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: validation.coherence_checks
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+content:
+  constraints:
+  - subject and action must align (subject can perform the action)
+  - action and goal must align (action serves the goal)
+  - outcome must be measurable result of action
+  - all produce artifacts must be owned by this wagon
+  - all consume artifacts must be owned by different wagons
+  - context must make sense for when/where action occurs
+  - 'at least one produce artifact must be external (scope: ''external'')'
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: coherence_check
+  text: one semantic-coherence validation on a wagon definition.

package/planner-nodes/nodes/planner.wagon.separability.convention.yaml

@@ -0,0 +1,33 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.separability
+kind: constraint
+status: active
+name: Wagon separability (advisory)
+statement: A wagon should be separable — its internal cohesion (intra-wagon shared-token WMBT edges) at least its tightest coupling to any single neighbor wagon. A wagon more bound to a neighbor than to itself emits a [MERGE] signal. Advisory and non-blocking.
+implementation:
+  type: validator
+  ref: conventions/sizing/test_wagon_separability::test_live_corpus_legacy_parity
+source:
+  legacy_path: docs/recompose
+  legacy_section: complexity-sizing
+  extraction_mode: summary
+content:
+  normative_text: 'Build ONE undirected graph over WMBTs where an edge joins two WMBTs that share >= min_shared salient tokens (from object_of_control). cohesion(W) = intra-wagon edges; coupling(W,N) = cross-wagon edges. A wagon is separable iff cohesion(W) >= max over neighbors N of coupling(W,N). Non-separable wagons emit an ADVISORY [MERGE] finding (it is more coupled to a neighbor than cohesive internally). Wagons below a min-graph-size guard are skipped. Token vocabulary, min_shared, and min-graph-size are config-driven calibration knobs (planner.wagon.*); promotion to strict is deferred to calibration.'
+  constraints:
+  - advisory only — never blocks
+  - cohesion and coupling are measured on the same WMBT shared-token graph (commensurable)
+  - small wagons (< min-graph-size) are skipped, not flagged
+metadata:
+  severity: 2
+  disposition: advisory
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: true
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-18'
+terms:
+- term_id: separable
+  text: cohesion(W) >= max-neighbor coupling(W,N) on the WMBT shared-token graph.
+- term_id: merge_signal
+  text: a wagon whose tightest single-neighbor coupling exceeds its internal cohesion — advisory hint to merge.

package/planner-nodes/nodes/planner.wagon.slug-dirname-conversion.convention.yaml

@@ -0,0 +1,26 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.slug-dirname-conversion
+kind: rule
+status: active
+name: Slug/dirname conversion
+statement: Convert between logical slugs and filesystem names by swapping hyphens and underscores.
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: naming.conversion + naming.slug_derivation
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: conversion
+  text: the kebab<->snake conversion functions.
+  values:
+    slug_to_dirname: slug.replace('-', '_')
+    dirname_to_slug: dirname.replace('_', '-')
+    feature_slug_to_filename: feature_slug.replace('-', '_') + '.yaml'
+    feature_filename_to_slug: filename.replace('_', '-').replace('.yaml', '')
+    slug_derivation: lowercase, replace spaces/underscores with hyphens (verb-object preferred)

package/planner-nodes/nodes/planner.wagon.telemetry-filesystem.convention.yaml

@@ -0,0 +1,52 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.telemetry-filesystem
+kind: rule
+status: active
+name: Telemetry URN -> filesystem
+statement: 'A telemetry URN maps to a filesystem directory of signal files: telemetry:{theme}:{segments}
+  -> telemetry/{theme}/{segments}/{signal-type}.{plane}[.{measure}].json.'
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: artifact_contracts.urn_format.telemetry_filesystem
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+content:
+  normative_text: metric signals require a measure suffix; event signals do not (pattern {signal-type}.{plane}.json).
+    Manifest is generated from telemetry/{domain}/{resource}/*.json.
+  examples:
+  - telemetry:mechanic:decision.choice -> telemetry/mechanic/decision/choice/ (metric.db.count.json, metric.be.duration.json,
+    event.be.json)
+parity:
+  source_fragments_preserved: true
+  examples_preserved: true
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: signal_type
+  text: metric vs event.
+  values:
+    metric: OpenTelemetry metric - requires measure suffix
+    event: analytics event - no measure suffix
+- term_id: telemetry_axes
+  text: the controlled planes and measures.
+  values:
+    planes:
+    - ui
+    - ux
+    - be
+    - nw
+    - db
+    - st
+    - tm
+    - sc
+    - au
+    - fn
+    - if
+    measures_metrics_only:
+    - count
+    - duration
+    - latency
+    - size
+    - rate
+    - percentage

package/planner-nodes/nodes/planner.wagon.urn-naming.convention.yaml

@@ -0,0 +1,28 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.urn-naming
+kind: rule
+status: active
+name: Wagon URN naming
+statement: A wagon URN is wagon:{kebab-case-name}, preferring a verb-object slug; built via URNBuilder.wagon.
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: urn_naming
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+content:
+  examples:
+  - wagon:resolve-dilemmas
+  - wagon:burn-timebank
+  - wagon:manage-users
+parity:
+  source_fragments_preserved: true
+  examples_preserved: true
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: wagon_urn_pattern
+  text: the wagon URN grammar.
+  values:
+    pattern: ^wagon:[a-z][a-z0-9-]*$
+    preference: verb-object (resolve-dilemmas, commit-state)

package/planner-nodes/nodes/planner.wagon.urn.convention.yaml

@@ -0,0 +1,29 @@
+schema_version: 1.1.0
+rule_id: planner.wagon.urn
+kind: rule
+status: active
+name: Wagon URN + layout
+statement: Wagons declare a stable URN and live under plan/<wagon-slug>/ with the documented file layout.
+source:
+  legacy_path: src/atdd/planner/conventions/wagon.convention.yaml
+  legacy_section: rules
+  legacy_sha: ee0a3e1d5af414c9
+  extraction_mode: high_fidelity
+  legacy_rule_id: planner.wagon.urn
+metadata:
+  aliases:
+  - PLANNER-WAGON-URN-001
+  severity: 3
+  disposition: documentation-only
+  introduced_in: 1.67.0
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: wagon_urn
+  text: a wagon's stable URN.
+- term_id: wagon_layout
+  text: the plan/<wagon-slug>/ directory layout.