@afokapu/atdd-bun 0.1.0

package/planner-nodes/nodes/planner.wmbt.context-clarifier.convention.yaml

@@ -0,0 +1,24 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.context-clarifier
+kind: rule
+status: active
+name: WMBT context clarifier
+statement: Declare a context clarifier — a detailed situational phrase specifying when/where/how the WMBT
+  applies (required, one line).
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: context_clarifier
+  legacy_sha: 040256ed5588a6c7
+  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: context_clarifier
+  text: a one-line situational qualifier.
+  values:
+    required: true
+    pattern: detailed situational phrase, one line maximum

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

@@ -0,0 +1,29 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.definition
+kind: family
+status: draft
+name: WMBT — advisory semantic anchor
+statement: A WMBT (What Must Be True) is a falsifiable statement of a single outcome
+  that must hold for an artifact — scoped to one object of control along one dimension,
+  direction, and lens — declared with an id and a statement, and paired with the
+  acceptances that prove it, including at least one smoke acceptance. 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: wmbt
+  label: WMBT
+  text: wmbt -> {well-shaped, single-object-of-control, single-axis, statement-formed,
+    smoke-covered}.
+  values:
+    well-shaped: declares its id, its statement, and the artifacts that prove the statement
+      (see planner.wmbt.shape).
+    single-object-of-control: scoped to exactly one object of control (see planner.wmbt.object-of-control).
+    single-axis: one dimension, one direction, one lens (see planner.wmbt.dimension-selection,
+      planner.wmbt.direction-selection, planner.wmbt.lens-selection, planner.wmbt.splitting-rules).
+    statement-formed: follows the statement template (see planner.wmbt.statement-template).
+    smoke-covered: has at least one smoke acceptance (see planner.wmbt.must-have-smoke-acceptance).

package/planner-nodes/nodes/planner.wmbt.dimension-selection.convention.yaml

@@ -0,0 +1,37 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.dimension-selection
+kind: family
+status: active
+name: WMBT dimensions
+statement: Select exactly one optimization dimension (the core metric the user wants to optimize) for
+  a WMBT.
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: dimensions + dimension_instructions
+  legacy_sha: 040256ed5588a6c7
+  extraction_mode: high_fidelity
+content:
+  operational_guidance: Match the user's intent to a dimension via its keywords; decompose into dimension/actor/action/object
+    using the description and rationale.
+parity:
+  source_fragments_preserved: true
+  examples_preserved: true
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: dimension
+  label: Dimensions
+  text: name -> {keywords, description}.
+  values:
+    Time: duration/speed/waiting/delay/rework — the performer's most finite resource
+    Effort: physical or cognitive load — muscular force or concentration/learning/decision-making
+    Likelihood: probability of an outcome — predictability, control, success vs error
+    Frequency: rate of occurrence — reduce repetitive/non-value-added tasks
+    Quantity/Amount: volume of a resource consumed or produced — optimize inputs/outputs
+    Financial Value: monetary impact — cost, revenue, opportunity cost
+  examples:
+    positive:
+    - 'Time: minimize onboarding time'
+    - 'Likelihood: increase usable experiment results'
+    - 'Effort: reduce mental effort to find a bug'

package/planner-nodes/nodes/planner.wmbt.direction-selection.convention.yaml

@@ -0,0 +1,41 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.direction-selection
+kind: family
+status: active
+name: WMBT directions
+statement: Select the optimization direction verb that matches the goal, from the controlled palette.
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: directions
+  legacy_sha: 040256ed5588a6c7
+  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: direction
+  label: Direction palette
+  text: canonical direction -> synonyms.
+  values:
+    minimize:
+    - reduce
+    - decrease
+    - lower
+    - shrink
+    maximize:
+    - increase
+    - boost
+    - raise
+    - grow
+    increase:
+    - improve
+    - elevate
+    - accelerate
+    decrease:
+    - cut
+    - dampen
+    - slow
+    - limit

package/planner-nodes/nodes/planner.wmbt.filename-pattern.convention.yaml

@@ -0,0 +1,27 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.filename-pattern
+kind: rule
+status: active
+name: WMBT filename pattern
+statement: A WMBT file is named {STEP_CODE}{NNN}.yaml — step-coded, no prefix.
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: filename
+  legacy_sha: 040256ed5588a6c7
+  extraction_mode: high_fidelity
+content:
+  examples:
+  - E001.yaml
+  - L045.yaml
+  - K023.yaml
+parity:
+  source_fragments_preserved: true
+  examples_preserved: true
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: filename
+  text: the WMBT file name.
+  values:
+    pattern: '{STEP_CODE}{NNN}.yaml'

package/planner-nodes/nodes/planner.wmbt.lens-selection.convention.yaml

@@ -0,0 +1,44 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.lens-selection
+kind: family
+status: active
+name: WMBT lenses
+statement: Select one quality lens (social, functional, or emotional) most relevant to the work.
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: lenses
+  legacy_sha: 040256ed5588a6c7
+  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: social_lens
+  text: identity/belonging drives.
+  values:
+    belong: accepted by a group, align with norms
+    stand_out: differentiate positively — uniqueness/status/taste/expertise
+    affirm: reinforce an existing identity
+    aspire: become a better future self
+- term_id: functional_lens
+  text: task-outcome qualities.
+  values:
+    efficiency: minimize time/effort/resources
+    effectiveness: improve quality/accuracy/impact
+    availability: accessible and operational when needed
+    adaptability: handle new/changing requirements
+    sustainability: maintain performance over time
+- term_id: emotional_lens
+  text: felt reactions.
+  values:
+    joy: pleasure when friction is removed
+    trust: confidence it is reliable and safe
+    fear: anxiety about a negative outcome
+    surprise: reaction to the unexpected
+    sadness: unhappiness from loss/blocked goal
+    disgust: aversion to unethical/cluttered design
+    anger: frustration when things fail
+    anticipation: hopeful expectation

package/planner-nodes/nodes/planner.wmbt.must-have-smoke-acceptance.convention.yaml

@@ -0,0 +1,55 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.must-have-smoke-acceptance
+kind: rule
+status: active
+name: WMBT must have a SMOKE acceptance
+statement: Every WMBT must declare at least one acceptance URN with the SMOKE harness token (acc:<wagon>:<wmbt_id>-SMOKE-NNN[-<slug>])
+  so the lifecycle has explicit real-infrastructure coverage before REFACTOR.
+implementation:
+  type: validator
+  ref: conventions/coverage/test_wmbt_has_smoke_acceptance::test_fault_injection_legacy_parity_both_catch
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: rules
+  legacy_sha: 040256ed5588a6c7
+  extraction_mode: high_fidelity
+  legacy_rule_id: planner.wmbt.must-have-smoke-acceptance
+content:
+  normative_text: Mirrors tester.smoke.pres (#293) — closes the asymmetry where tester checks coverage
+    of SMOKE tests that exist but no rule requires SMOKE acceptances be declared in the first place.
+  fix_hint: "The named WMBT declares 0 acceptance URNs with a SMOKE harness token,\nso the lifecycle has\
+    \ no explicit real-infrastructure verification\nbetween GREEN and REFACTOR. Repair as follows\n(run\
+    \ `atdd repo resolve <wmbt-urn>` to inspect the WMBT file path,\n e.g. \"atdd repo resolve wmbt:govern-lifecycle:E003\"\
+    ):\n\n  1. Open the WMBT YAML named in the violation location\n     (e.g. \"plan/govern_lifecycle/E003.yaml:1\"\
+    ).\n  2. Add at least one acceptance whose identity.urn matches\n     \"acc:<wagon>:<wmbt_id>-SMOKE-NNN[-<slug>]\"\
+    \ and whose\n     identity.phase is \"SMOKE\".\n  3. If this WMBT is genuinely docs-only / metadata\
+    \ (no real infra\n     to verify), add a suppression marker on the urn: line of the\n     WMBT YAML\
+    \ — substitute YYYY-MM-DD with today + 90 days:\n       urn: \"wmbt:<wagon>:<wmbt_id>\"  # atdd:suppress(planner.wmbt.must-have-smoke-acceptance)\
+    \ UNTIL=YYYY-MM-DD\n  4. Re-run the validator to confirm clean\n     (pytest src/atdd/validators/conventions/coverage/test_wmbt_has_smoke_acceptance.py\
+    \ -v).\n\nSee src/atdd/tester/conventions/smoke.convention.yaml::TESTER-SMOKE-PRES-001\nfor the template\
+    \ pattern this rule mirrors, and issue #681 for the\nsubstrate-asymmetry incident this rule closes."
+  exceptions:
+  - 'Docs-only WMBTs that have no real infra to verify can suppress inline with `# atdd:suppress(planner.wmbt.must-have-smoke-acceptance)
+    UNTIL=YYYY-MM-DD` on the WMBT''s urn: line.'
+metadata:
+  severity: 3
+  disposition: suppress-and-clean
+  introduced_in: 3.50.0
+  aliases: []
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: true
+  fix_hint_preserved: true
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: smoke_acceptance
+  text: an acceptance URN carrying the SMOKE harness token.
+  values:
+    urn_shape: acc:<wagon>:<wmbt_id>-SMOKE-NNN[-<slug>]
+    phase: SMOKE
+- term_id: suppression_marker
+  text: inline opt-out for genuinely docs-only WMBTs with no real infra.
+  values:
+    syntax: '# atdd:suppress(planner.wmbt.must-have-smoke-acceptance) UNTIL=YYYY-MM-DD'
+    placement: 'the WMBT''s urn: line'

package/planner-nodes/nodes/planner.wmbt.object-of-control.convention.yaml

@@ -0,0 +1,26 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.object-of-control
+kind: rule
+status: active
+name: WMBT object of control
+statement: Synthesize the specific thing being controlled or manipulated as a kebab-case noun phrase.
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: object_of_control
+  legacy_sha: 040256ed5588a6c7
+  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: object_of_control
+  text: the controlled subject of the WMBT.
+  values:
+    pattern: kebab-case noun phrase
+  examples:
+    positive:
+    - user-profile
+    - payment-flow

package/planner-nodes/nodes/planner.wmbt.shape.convention.yaml

@@ -0,0 +1,29 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.shape
+kind: rule
+status: active
+name: WMBT shape
+statement: A WMBT entry declares its id, its statement, and the artifacts that prove the statement.
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: rules
+  legacy_sha: 040256ed5588a6c7
+  extraction_mode: high_fidelity
+  legacy_rule_id: planner.wmbt.shape
+metadata:
+  aliases:
+  - PLANNER-WMBT-SHAPE-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: wmbt_entry
+  text: a What-Must-Be-True entry in a wagon decomposition.
+- term_id: proving_artifacts
+  text: the acceptances/tests that prove the WMBT statement.

package/planner-nodes/nodes/planner.wmbt.splitting-rules.convention.yaml

@@ -0,0 +1,37 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.splitting-rules
+kind: rule
+status: active
+name: WMBT splitting rules
+statement: Keep <=5 acceptances per WMBT; split on mixed dimensions, multiple actors, or divergent gates;
+  keep together for single-truth-multiple-layers or a coherent sequence.
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: splitting_rules
+  legacy_sha: 040256ed5588a6c7
+  extraction_mode: high_fidelity
+content:
+  normative_text: acceptance_cap maximum 5 — beyond 5 indicates mixed concerns that should be separate
+    WMBTs. Advisory guidance, not schema-enforced (wmbt.schema.json is not applied as a file-level
+    gate; see #760). Aligns with conventions:planner:acceptance acceptance_cap.
+  operational_guidance: 'when_to_split: mixed_dimensions (statement mentions multiple dimensions) / multiple_actors
+    (different actors+actions) / divergent_gates (ALL vs ANY). when_to_keep_together: single_truth_multiple_layers
+    (same outcome at UI/API/DB, gate ALL) / coherent_sequence (sequential steps of one process).'
+parity:
+  source_fragments_preserved: true
+  examples_preserved: false
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: acceptance_cap
+  text: the per-WMBT acceptance ceiling.
+  values:
+    maximum: 5
+- term_id: split_trigger
+  text: when to split a WMBT.
+  values:
+    allowed:
+    - mixed_dimensions
+    - multiple_actors
+    - divergent_gates

package/planner-nodes/nodes/planner.wmbt.statement-template.convention.yaml

@@ -0,0 +1,23 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.statement-template
+kind: rule
+status: active
+name: WMBT statement template
+statement: 'A WMBT statement is composed as: {direction} {dimension} of {object_of_control} [context_clarifier].'
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: statement + generators
+  legacy_sha: 040256ed5588a6c7
+  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: statement_pattern
+  text: the WMBT statement composition.
+  values:
+    pattern: '${direction} ${dimension} of ${object_of_control}${context_clarifier ? '' '' + context_clarifier
+      : ''''}'

package/planner-nodes/nodes/planner.wmbt.step-code-vocabulary.convention.yaml

@@ -0,0 +1,31 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.step-code-vocabulary
+kind: family
+status: active
+name: WMBT step codes
+statement: The single-letter step codes (D L P C E M Y R K) that prefix a WMBT sequence.
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: urn_naming.step_codes
+  legacy_sha: 040256ed5588a6c7
+  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: step_code
+  label: Step codes
+  text: letter -> step name + intent.
+  values:
+    D: define - Define requirements, criteria, or constraints
+    L: locate - Locate, discover, or find resources
+    P: prepare - Prepare, setup, or configure prerequisites
+    C: confirm - Confirm, verify, or validate conditions
+    E: execute - Execute, perform, or run the main action
+    M: monitor - Monitor, observe, or track progress
+    Y: modify - Modify, update, or adjust state
+    R: resolve - Resolve, fix, or handle issues
+    K: conclude - Conclude, complete, or finalize

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

@@ -0,0 +1,31 @@
+schema_version: 1.1.0
+rule_id: planner.wmbt.urn-naming
+kind: rule
+status: active
+name: WMBT URN naming
+statement: A WMBT URN is wmbt:{wagon}:{STEP_CODE}{NNN} — a unique step-coded identifier built via URNBuilder.wmbt(wagon_id,
+  sequence).
+source:
+  legacy_path: src/atdd/planner/conventions/wmbt.convention.yaml
+  legacy_section: urn_naming
+  legacy_sha: 040256ed5588a6c7
+  extraction_mode: high_fidelity
+content:
+  normative_text: wagon = parent wagon (kebab-case); STEP_CODE = single step letter; NNN = three-digit
+    zero-padded sequence (001-999).
+  examples:
+  - wmbt:resolve-dilemmas:E001
+  - wmbt:burn-timebank:M045
+  - wmbt:user-mgmt:C023
+parity:
+  source_fragments_preserved: true
+  examples_preserved: true
+  implementation_preserved: false
+  fix_hint_preserved: false
+  reviewed_at: '2026-06-16'
+terms:
+- term_id: wmbt_urn
+  text: the WMBT identifier.
+  values:
+    pattern: ^wmbt:[a-z][a-z0-9-]*:[DLPCEMYRK][0-9]{3}$
+    sequence_range: 001-999