@afokapu/atdd-bun 0.1.0

package/detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_smoke_coverage/plan/_trains/_interlockings/match-resolution.yaml

@@ -0,0 +1,51 @@
+# Interlocking route space (core afokapu/atdd#1248). Two admissible routes; each requires a covering
+# e2e test. entrypoint.exposed:true -> the resolve_match action requires a smoke test.
+schema_version: 1.0.0
+interlocking_id: interlocking:match-resolution
+title: Match resolution route interlocking
+status: checked
+
+entrypoint:
+  surfaces: [backend]
+  exposed: true
+  actions:
+    - resolve_match
+  reason: null
+
+route_resolution:
+  strategy: fail_on_multiple_match
+
+routes:
+  - route_id: nominal-all-voted
+    priority: 1
+    projection:
+      expected_sequence_digest: "d285d26427cb21fedb4c5b56edc673743f6d63c85686bdeb37f5e8c5ed4736d8"
+    category: nominal
+    guard_ref: guard:all-voted
+    train_id: train:match:match-resolution-standard
+    train_path: plan/_trains/train:match:match-resolution-standard.yaml
+  - route_id: alternate-timeout
+    priority: 2
+    projection:
+      expected_sequence_digest: "417c29734ac10c6a6c9a59dc3c568011aa9bdf4bc46e753f351657679d791672"
+    category: alternate
+    guard_ref: guard:timer-expires
+    train_id: train:match:match-resolution-timeout
+    train_path: plan/_trains/train:match:match-resolution-timeout.yaml
+
+theme: match-resolution
+lifelines:
+  - ref: user:actor
+  - ref: wagon:match-resolution
+messages:
+  - id: msg:match-resolution-request
+    kind: boundary
+    from: user:actor
+    to: wagon:match-resolution
+    intent: The actor requests Match Resolution
+    payload:
+      contract: match-resolution:request-v1
+
+source:
+  path: official/atdd.workspace.bun/implementations/bun_interlocking_coverage/fixtures/dirty/interlocking_smoke_coverage/plan/_trains/_interlockings/match-resolution.yaml
+  content_digest: "8bc1d15141bd8d3a33ffc144a4014f727eb6ee85ccf637ba0303c0750bad4999"

package/detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_trace_binds/e2e/interlockings/match-resolution/routes.test.ts

@@ -0,0 +1,21 @@
+// End-to-end route coverage — exercises EVERY admissible route through the production runners.
+import { InterlockingRunner } from "../../../convex/trains/interlocking";
+import { TrainRunner } from "../../../convex/trains/runner";
+
+function runner() {
+  return new InterlockingRunner("plan/_trains/_interlockings/match-resolution.yaml");
+}
+
+test("nominal-all-voted resolves the standard train", () => {
+  const resolution = runner().resolveTrain("resolve_match", { allPlayersVoted: true });
+  expect(resolution.routeId).toBe("nominal-all-voted");
+  expect(resolution.trainId).toBe("train:match:match-resolution-standard");
+  new TrainRunner(resolution.trainId).execute({});
+});
+
+test("alternate-timeout resolves the timeout train", () => {
+  const resolution = runner().resolveTrain("resolve_match", { timerExpired: true });
+  expect(resolution.routeId).toBe("alternate-timeout");
+  expect(resolution.trainId).toBe("train:match:match-resolution-timeout");
+  new TrainRunner(resolution.trainId).execute({});
+});

package/detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_trace_binds/e2e/interlockings/match-resolution/trace.test.ts

@@ -0,0 +1,13 @@
+// DIRTY — the trace assertion checks only selected_train_id; it omits routeId/routeCategory/
+// routeCategoryDigit/guardId/resolutionStrategy/resolutionReason/interlockingId, so the run could
+// resolve the wrong route/category/guard and still pass.
+import { InterlockingRunner } from "../../../convex/trains/interlocking";
+import { TrainRunner } from "../../../convex/trains/runner";
+
+test("trace only checks the selected train", () => {
+  const runner = new InterlockingRunner("plan/_trains/_interlockings/match-resolution.yaml");
+  const resolution = runner.resolveTrain("resolve_match", { timerExpired: true });
+  const result: any = new TrainRunner(resolution.trainId).execute({});
+  const trace = result.trace;
+  expect(trace.selectedTrainId).toBe("train:match:match-resolution-timeout");
+});

package/detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_trace_binds/e2e/smoke/resolve-match.smoke.test.ts

@@ -0,0 +1,13 @@
+// Station Master smoke test for the exposed resolve_match action — drives the real entrypoint ->
+// Station Master -> InterlockingRunner -> TrainRunner path.
+import { StationMaster } from "../../convex/app";
+import { InterlockingRunner } from "../../convex/trains/interlocking";
+import { TrainRunner } from "../../convex/trains/runner";
+
+test("resolve_match smoke reaches the Station Master", () => {
+  const stationMaster = new StationMaster();
+  const result: any = stationMaster.handleAction("resolve_match", { allPlayersVoted: true });
+  expect(stationMaster.interlockingRunner).toBeInstanceOf(InterlockingRunner);
+  expect(stationMaster.trainRunner).toBeInstanceOf(TrainRunner);
+  expect(result.selectedTrainId).toBe("train:match:match-resolution-standard");
+});

package/detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_trace_binds/plan/_trains/_interlockings/match-resolution.yaml

@@ -0,0 +1,51 @@
+# Interlocking route space (core afokapu/atdd#1248). Two admissible routes; each requires a covering
+# e2e test. entrypoint.exposed:true -> the resolve_match action requires a smoke test.
+schema_version: 1.0.0
+interlocking_id: interlocking:match-resolution
+title: Match resolution route interlocking
+status: checked
+
+entrypoint:
+  surfaces: [backend]
+  exposed: true
+  actions:
+    - resolve_match
+  reason: null
+
+route_resolution:
+  strategy: fail_on_multiple_match
+
+routes:
+  - route_id: nominal-all-voted
+    priority: 1
+    projection:
+      expected_sequence_digest: "d285d26427cb21fedb4c5b56edc673743f6d63c85686bdeb37f5e8c5ed4736d8"
+    category: nominal
+    guard_ref: guard:all-voted
+    train_id: train:match:match-resolution-standard
+    train_path: plan/_trains/train:match:match-resolution-standard.yaml
+  - route_id: alternate-timeout
+    priority: 2
+    projection:
+      expected_sequence_digest: "417c29734ac10c6a6c9a59dc3c568011aa9bdf4bc46e753f351657679d791672"
+    category: alternate
+    guard_ref: guard:timer-expires
+    train_id: train:match:match-resolution-timeout
+    train_path: plan/_trains/train:match:match-resolution-timeout.yaml
+
+theme: match-resolution
+lifelines:
+  - ref: user:actor
+  - ref: wagon:match-resolution
+messages:
+  - id: msg:match-resolution-request
+    kind: boundary
+    from: user:actor
+    to: wagon:match-resolution
+    intent: The actor requests Match Resolution
+    payload:
+      contract: match-resolution:request-v1
+
+source:
+  path: official/atdd.workspace.bun/implementations/bun_interlocking_coverage/fixtures/dirty/interlocking_trace_binds/plan/_trains/_interlockings/match-resolution.yaml
+  content_digest: "8bc1d15141bd8d3a33ffc144a4014f727eb6ee85ccf637ba0303c0750bad4999"

package/detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_train_sequence/e2e/interlockings/match-resolution/routes.test.ts

@@ -0,0 +1,16 @@
+// Asserts WHICH train each route selects — and nothing about the ORDER it executes.
+// That is the gap: reorder either train's wagons and every assertion here still holds.
+import { test, expect } from "bun:test";
+import { InterlockingRunner } from "../../../src/trains/interlocking";
+
+const IL = "plan/_trains/_interlockings/match-resolution.yaml";
+
+test("nominal route selects the standard train", () => {
+  const r = new InterlockingRunner(IL).resolveTrain("resolve_match", {}, {});
+  expect(r.trainId).toBe("train:match:match-resolution-standard");
+});
+
+test("alternate route selects the timeout train", () => {
+  const r = new InterlockingRunner(IL).resolveTrain("resolve_match", {}, { voteWindowExpired: true });
+  expect(r.trainId).toBe("train:match:match-resolution-timeout");
+});

package/detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_train_sequence/plan/_trains/_interlockings/match-resolution.yaml

@@ -0,0 +1,51 @@
+# Interlocking route space (core afokapu/atdd#1248). Two admissible routes; each requires a covering
+# e2e test. entrypoint.exposed:true -> the resolve_match action requires a smoke test.
+schema_version: 1.0.0
+interlocking_id: interlocking:match-resolution
+title: Match resolution route interlocking
+status: checked
+
+entrypoint:
+  surfaces: [backend]
+  exposed: true
+  actions:
+    - resolve_match
+  reason: null
+
+route_resolution:
+  strategy: fail_on_multiple_match
+
+routes:
+  - route_id: nominal-all-voted
+    priority: 1
+    projection:
+      expected_sequence_digest: "d285d26427cb21fedb4c5b56edc673743f6d63c85686bdeb37f5e8c5ed4736d8"
+    category: nominal
+    guard_ref: guard:all-voted
+    train_id: train:match:match-resolution-standard
+    train_path: plan/_trains/train:match:match-resolution-standard.yaml
+  - route_id: alternate-timeout
+    priority: 2
+    projection:
+      expected_sequence_digest: "417c29734ac10c6a6c9a59dc3c568011aa9bdf4bc46e753f351657679d791672"
+    category: alternate
+    guard_ref: guard:timer-expires
+    train_id: train:match:match-resolution-timeout
+    train_path: plan/_trains/train:match:match-resolution-timeout.yaml
+
+theme: match-resolution
+lifelines:
+  - ref: user:actor
+  - ref: wagon:match-resolution
+messages:
+  - id: msg:match-resolution-request
+    kind: boundary
+    from: user:actor
+    to: wagon:match-resolution
+    intent: The actor requests Match Resolution
+    payload:
+      contract: match-resolution:request-v1
+
+source:
+  path: official/atdd.workspace.bun/implementations/bun_interlocking_coverage/fixtures/clean/interlocking_route_coverage/plan/_trains/_interlockings/match-resolution.yaml
+  content_digest: "8bc1d15141bd8d3a33ffc144a4014f727eb6ee85ccf637ba0303c0750bad4999"

package/detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_train_sequence/plan/_trains/train:match:match-resolution-standard.yaml

@@ -0,0 +1,8 @@
+# DIRTY fixture for tester.bun.interlocking-train-sequence-is-exercised.
+# The sequence is DECLARED here, and no test below asserts the order it runs in:
+# reorder these wagons and the suite stays green.
+train_id: train:match:match-resolution-standard
+sequence:
+  - wagon: collect-votes
+  - wagon: tally-votes
+  - wagon: publish-result

package/detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_train_sequence/plan/_trains/train:match:match-resolution-timeout.yaml

@@ -0,0 +1,5 @@
+train_id: train:match:match-resolution-timeout
+sequence:
+  - wagon: collect-votes
+  - wagon: expire-window
+  - wagon: publish-result