Card duel
card-duel · an adoption of Event resolution, version 1
Use in your game
Opens the authoring tool with these answers and settings already filled in. You still add your game's own rules and tuning.
What is in the ZIP
The ZIP holds the adoption and its acceptance tests. In the authoring tool, choose Add contract and pick this ZIP. If you keep your design as files, put them in contracts/.
The contract behind it
Covers actions and events that meet at one game moment. It decides their order, ties, interruptions, chain reactions, and rejected actions. It also settles missing sources or targets, two removals reaching one target, simultaneous endings, and presentation delays. Individual effects, input buffering, clocks and pausing, displayed facts, and simulation pipeline stages stay elsewhere.
Questions
The supplied answer is marked on each question. Pick other answers to see what changes. Nothing is saved here: the ZIP and the authoring tool use the supplied answers.
An action cannot happen exactly as proposed. What happens by default?
Why this is asked
The attempt may fail, spend a resource, use time, or continue at a smaller scale. Particular cases can choose another result in their own rows.
Two events of the same kind are ready together. What decides which goes first?
Why this is asked
The event rank cannot separate two events from one class. Their order can change targets, rewards, and later chains.
A win and a loss land at the same moment. Which ending does the game record?
- Asked when
- the terminal collisions list has at least one row.
- If not asked
- No declared ending pair can produce a win and a loss at the same instant.
Why this is asked
Ending checks may arrive through different events. This answer decides the recorded result after both conditions are known.
Can an animation or sound delay an event, and can another event pass it?
- Asked when
- the presentation driven events list has at least one row.
- If not asked
- No visual or sound delays an event or changes event order.
Why this is asked
A visual delay and a rules delay are different decisions. The answer fixes whether only time changes or order changes too.
Two events would each remove the same target at this moment. What happens to the second one?
- Asked when
- the same target cases list has at least one row, or the same target exceptions list has at least one row.
- If not asked
- No two events in this adoption can each remove the same target at one instant.
Why this is asked
The second event may vanish, still count, or create another ending. Particular target kinds can choose a different result.
An event happening now causes another event due at this moment. When does the new event resolve?
- Asked when
- the caused event kinds list has at least one row.
- If not asked
- No non-interrupt event in this adoption causes another event due at the same instant.
Why this is asked
A chain can continue immediately, join the normal order, or wait for the next game moment.
A reaction can stop or replace an event already happening. When does it cut in?
- Asked when
- the interrupts list has at least one row.
- If not asked
- No event in this adoption stops or replaces another event once it has been selected to resolve, at any point including before its first effect.
Why this is asked
An interrupt needs a fixed entry point before it can stop or replace the event already in progress.
An event loses the source or target it needs. What happens by default?
- Asked when
- the orphan cases list has at least one row.
- If not asked
- No event in this adoption can lose its required source or target while waiting or resolving.
Why this is asked
A queued card effect or tactics shot may outlive a source or target. The result must not depend on which object was cleaned up first.
Numbersno numbers
This contract has no numbers to set.
Rules1 rule
A rule is a check between the numbers. Validation reports a rule that fails.
-
Forbidden when Within class order is No visible order, and Two events one target is Only first resolves. (a warning, not an error)
Lists11 lists
Each list holds the rows this adoption supplies. A list can be empty.
Event classes
event-classes
| Id | Rank | Label | Declared in |
|---|---|---|---|
card-actions | 1 | Card actions | cards.play-card |
secrets | 2 | Secrets | cards.secrets |
card-effects | 3 | Card effects | cards.effects |
triggered-effects | 4 | Triggered effects | cards.triggers |
removals | 5 | Removals | cards.removals |
match-endings | 6 | Match endings | cards.endings |
Within class rules
within-class-rules
| Id | Class id | Order | Index name | Second index name | Grid declared in | Rule declared in |
|---|---|---|---|---|---|---|
trigger-board-order | triggered-effects | stable-index | board-position | — | — | — |
secrets-order | secrets | stable-index | secret-play-order | — | — | — |
removal-order | removals | stable-index | board-position | — | — | — |
Rank ties
rank-ties
This adoption declares no rank ties.
Rejection cases
rejection-cases
This adoption declares no rejection cases.
Terminal collisions
terminal-collisions
| Id | Win condition | Loss condition | Declared in |
|---|---|---|---|
both-heroes-at-zero | opposing hero defeated | own hero defeated | cards.endings |
Same target cases
same-target-cases
| Id | Target kind | Declared in |
|---|---|---|
minion-under-two-lethal-effects | minion | cards.minion-damage |
Same target exceptions
same-target-exceptions
This adoption declares no same target exceptions.
Presentation driven events
presentation-driven-events
| Id | Event class | Presentation cue | Declared in |
|---|---|---|---|
attack-landing | card-effects | attack animation | cards.attack-animation |
Caused event kinds
caused-event-kinds
| Id | Event class | Declared in |
|---|---|---|
defeat-trigger | triggered-effects | cards.defeat-triggers |
Interrupts
interrupts
| Id | Active class | Interrupt class | Boundary granularity | Result | Declared in | Replacement declared in |
|---|---|---|---|---|---|---|
counterspell-secret | card-effects | secrets | before-first-effect | stop-original | cards.counterspell-secret | — |
Orphan cases
orphan-cases
| Id | Event class | Missing | Resolution | Declared in |
|---|---|---|---|---|
queued-trigger-after-source-loss | triggered-effects | source | resolves-what-remains | cards.trigger-survival |
Test inputsscope and seeds
Some tests need a scope or seeds from the adoption before they can run.
This adoption supplies none; every test uses its defaults.
Acceptance tests65 tests apply
The contract comes with 83 tests. A test that runs once per row is counted once for each row. Tests that do not apply to these answers are still listed, with the reason.
instant-and-turn-boundary
an instant is one simultaneous moment
Applies to card-duel.
An instant is one moment the game treats as simultaneous. A turn boundary the adoption can construct is an instant like any other; where there is no turn boundary, that clause asserts nothing.
Test steps and diagnostics
- Given
events at one moment
card-dueltreats as simultaneous, including a turn boundary where the adoption has one- When
- the moment is resolved
- Then
- all events belong to one instant and follow one lifecycle
- a constructed turn boundary is handled as an instant like any other; where no turn boundary exists, that clause asserts nothing
- Diagnostics
card-duel-instant-trace
waiting-active-and-first-boundary
waiting and active events are distinguishable
Applies to card-duel.
A waiting event is accepted but has not begun. An active event is applying ordered effects. Every active event visits an effect boundary before its first effect.
Test steps and diagnostics
- Given
an accepted event before and during resolution
- When
- the event enters the waiting set and is selected
- Then
- before selection it is recorded as a waiting event that has not begun
- during ordered effect application it is recorded as the active event
- the active event visits an effect boundary before its first effect
- Diagnostics
card-duel-waiting-setcard-duel-event-trace
ending-event-records-nothing
ending events record no outcome while resolving
Applies to card-duel.
Each ending event the adoption can construct follows the ordinary event lifecycle but records no outcome when it resolves. Only step 15 records an outcome, after the waiting set is empty. Where none exists, this test asserts nothing.
Test steps and diagnostics
- Given
each ending event the adoption can construct whose effects make an ending condition hold
- When
- the ending event resolves and the instant later reaches settlement
- Then
- resolving the ending event records no match outcome
- an outcome is recorded only after the waiting set is empty at step 15
- the ending record distinguishes event resolution from outcome recording
- where no ending event exists, this test asserts nothing
- Diagnostics
card-duel-event-tracecard-duel-ending-record
file-order-never-decides-resolution
container order never decides event resolution
Applies to card-duel.
Changing container order or document order without changing declarations never changes event resolution. Rank, a rank tie, and within-class order decide the sequence; document order never does. Step 5 says container order in the adoption file never selects an event.
Test steps and diagnostics
- Given
two equivalent
card-dueladoption documents whose container order or document order differs, with the same recorded random inputs where a declared random order is used- When
- the same instant is resolved from the same pre-instant state under each document
- Then
- the two runs select and resolve the same events in the same declared order
- no event order is taken from container order or document order
- Diagnostics
card-duel-order-tracecard-duel-settlement-report
rejection-case-nothing-changes
Row.id rejects with nothing-changes
Does not apply to card-duel: rejection-cases has no rows.
rejection-case-cost-taken
Row.id rejects with cost-taken
Does not apply to card-duel: rejection-cases has no rows.
rejection-case-clock-advances
Row.id rejects and advances its cited clock
Does not apply to card-duel: rejection-cases has no rows.
rejection-case-cost-and-clock
Row.id rejects with its cost and cited clock advance
Does not apply to card-duel: rejection-cases has no rows.
rejection-case-derates-and-enters-lifecycle
Row.id accepts a scaled action
Does not apply to card-duel: rejection-cases has no rows.
rejection-default-applies-without-row
the rejected-action default governs cases without rows
Applies to card-duel.
For every rejected proposal with no matching rejection-cases row, the selected default applies once: it ends without an event, changes no state, spends no cost, and advances no clock because of the rejection. Where no such rejected proposal exists, this test asserts nothing.
Test steps and diagnostics
- Given
each rejected proposal that matches no rejection-cases row
- When
- the proposal is checked
- Then
- each such proposal ends without an event, changes no state, spends no cost, and advances no clock because of the rejection; the proposal log distinguishes rejection from ordinary acceptance; where no such rejected proposal exists, this test asserts nothing
- Diagnostics
card-duel-proposal-logcard-duel-cost-logcard-duel-clock-trace
rejection-is-repeatable-from-identical-state
a rejected proposal is repeatable from identical state
Applies to card-duel.
The same proposal rejected from an identical pre-attempt state produces the same result. The comparison resets the whole pre-attempt state; it does not repeat from state changed by an earlier attempt.
Test steps and diagnostics
- Given
two executions of each rejecting proposal the adoption can construct from identical recorded pre-attempt states
- When
- the proposal is checked in each execution
- Then
- both executions produce the same rejection result and the same recorded cost and clock consequence
- the comparison starts from identical pre-attempt state rather than the state left by the first execution
- where no rejecting proposal exists, this test asserts nothing
- Diagnostics
card-duel-proposal-logcard-duel-state-before-after
accepted-proposal-creates-one-event
an accepted proposal commits once and creates one event
Applies to card-duel.
An accepted proposal creates one payload once and enters its declared event class at its due instant. Where it has an ordinary cost, that cost commits once at the point its rule names; otherwise the cost clause asserts nothing. The payload captures every value that must survive later source loss; where no such loss can occur, that observation asserts nothing.
Test steps and diagnostics
- Given
a valid proposal with distinguishable payload values, event class, due instant, and an ordinary cost where its Fixed rule declares one
- When
- the proposal is accepted and its event is admitted
- where the adoption can construct later source loss, the source becomes unavailable before a captured value is used
- Then
- where an ordinary cost is declared, it is committed once at the point its Fixed game rule names; otherwise the cost clause asserts nothing
- one event payload is created once and enters its declared event class at its due instant
- the payload contains every value required to survive later source loss, while uncaptured state is read only when an effect resolves
- where later source loss cannot be constructed, the payload-survival observation asserts nothing
- Diagnostics
card-duel-proposal-logcard-duel-cost-logcard-duel-waiting-setcard-duel-event-trace
new-event-uses-one-admission-path
a new event uses the interrupt path or caused-event path
Applies to card-duel.
After an instant opens, a valid declared interrupt enters only through the interrupt path. Every other newly created event due now follows caused-events. An unavailable branch asserts nothing, and no event uses both paths.
Test steps and diagnostics
- Given
events created after an instant opens, including valid declared interrupts and other new events where the adoption can construct them
- When
- each new event is admitted
- Then
- an event backed by a valid interrupts row enters only through the interrupt path and is governed by interrupt-entry
- every other new event due now follows caused-events
- a branch the adoption cannot construct asserts nothing and no event uses both paths
- Diagnostics
card-duel-proposal-logcard-duel-interrupt-reportcard-duel-caused-event-report
lowest-eligible-rank-resolves-first
the lowest eligible rank resolves first
Applies to card-duel.
At every selection, the lowest eligible rank resolves first without changing the selected event's payload. Where no instant has two eligible ranks, the comparison asserts nothing. Step 4 selects the lowest eligible rank; step 5 selects within the class without changing the payload.
Test steps and diagnostics
- Given
each instant the adoption can construct with eligible waiting events from at least two declared ranks
- When
- the next waiting event is selected repeatedly
- Then
- each selection comes from the lowest rank that is eligible at that selection
- selection does not change the selected event's payload
- where no instant has two eligible ranks, the comparison asserts nothing
- Diagnostics
card-duel-waiting-setcard-duel-order-trace
event-class-never-passes-lower-rank · card-actions
card-actions at rank 1 never passes a lower rank
Applies to the card-actions row.
An event of card-actions at rank 1 never resolves before an eligible lower-rank event in the same instant. Where the adoption cannot construct that pairing, the test asserts nothing.
Test steps and diagnostics
- Given
an eligible
card-actionsevent and an eligible event of a lower declared rank in the same instant- When
- the waiting set is selected
- Then
- the lower-rank event is selected before the
card-actionsevent - where no lower-rank event is eligible with
card-actions, this test asserts nothing
- the lower-rank event is selected before the
- Diagnostics
card-duel-waiting-setcard-duel-order-trace
event-class-never-passes-lower-rank · secrets
secrets at rank 2 never passes a lower rank
Applies to the secrets row.
An event of secrets at rank 2 never resolves before an eligible lower-rank event in the same instant. Where the adoption cannot construct that pairing, the test asserts nothing.
Test steps and diagnostics
- Given
an eligible
secretsevent and an eligible event of a lower declared rank in the same instant- When
- the waiting set is selected
- Then
- the lower-rank event is selected before the
secretsevent - where no lower-rank event is eligible with
secrets, this test asserts nothing
- the lower-rank event is selected before the
- Diagnostics
card-duel-waiting-setcard-duel-order-trace
event-class-never-passes-lower-rank · card-effects
card-effects at rank 3 never passes a lower rank
Applies to the card-effects row.
An event of card-effects at rank 3 never resolves before an eligible lower-rank event in the same instant. Where the adoption cannot construct that pairing, the test asserts nothing.
Test steps and diagnostics
- Given
an eligible
card-effectsevent and an eligible event of a lower declared rank in the same instant- When
- the waiting set is selected
- Then
- the lower-rank event is selected before the
card-effectsevent - where no lower-rank event is eligible with
card-effects, this test asserts nothing
- the lower-rank event is selected before the
- Diagnostics
card-duel-waiting-setcard-duel-order-trace
event-class-never-passes-lower-rank · triggered-effects
triggered-effects at rank 4 never passes a lower rank
Applies to the triggered-effects row.
An event of triggered-effects at rank 4 never resolves before an eligible lower-rank event in the same instant. Where the adoption cannot construct that pairing, the test asserts nothing.
Test steps and diagnostics
- Given
an eligible
triggered-effectsevent and an eligible event of a lower declared rank in the same instant- When
- the waiting set is selected
- Then
- the lower-rank event is selected before the
triggered-effectsevent - where no lower-rank event is eligible with
triggered-effects, this test asserts nothing
- the lower-rank event is selected before the
- Diagnostics
card-duel-waiting-setcard-duel-order-trace
event-class-never-passes-lower-rank · removals
removals at rank 5 never passes a lower rank
Applies to the removals row.
An event of removals at rank 5 never resolves before an eligible lower-rank event in the same instant. Where the adoption cannot construct that pairing, the test asserts nothing.
Test steps and diagnostics
- Given
an eligible
removalsevent and an eligible event of a lower declared rank in the same instant- When
- the waiting set is selected
- Then
- the lower-rank event is selected before the
removalsevent - where no lower-rank event is eligible with
removals, this test asserts nothing
- the lower-rank event is selected before the
- Diagnostics
card-duel-waiting-setcard-duel-order-trace
event-class-never-passes-lower-rank · match-endings
match-endings at rank 6 never passes a lower rank
Applies to the match-endings row.
An event of match-endings at rank 6 never resolves before an eligible lower-rank event in the same instant. Where the adoption cannot construct that pairing, the test asserts nothing.
Test steps and diagnostics
- Given
an eligible
match-endingsevent and an eligible event of a lower declared rank in the same instant- When
- the waiting set is selected
- Then
- the lower-rank event is selected before the
match-endingsevent - where no lower-rank event is eligible with
match-endings, this test asserts nothing
- the lower-rank event is selected before the
- Diagnostics
card-duel-waiting-setcard-duel-order-trace
within-class-stable-index · trigger-board-order
triggered-effects uses stable index order
Applies to the trigger-board-order row.
Within triggered-effects, lower board-position resolves first. Where the row names a second index, equal first numbers resolve by it; otherwise equal first numbers cannot arise or cannot change the result.
Test steps and diagnostics
- Given
two eligible
triggered-effectsevents with differentboard-positionvalues, plus equal first values where the row names a second index and the adoption can construct them- When
- their within-class order is selected
- Then
- the event with the lower
board-positionresolves first - where the row names a second index, equal first numbers resolve by the lower second number; otherwise equal first numbers cannot arise or cannot change the result
- the order trace distinguishes selection by stable index from selection by rank or container order
- the event with the lower
- Diagnostics
card-duel-order-trace
within-class-stable-index · secrets-order
secrets uses stable index order
Applies to the secrets-order row.
Within secrets, lower secret-play-order resolves first. Where the row names a second index, equal first numbers resolve by it; otherwise equal first numbers cannot arise or cannot change the result.
Test steps and diagnostics
- Given
two eligible
secretsevents with differentsecret-play-ordervalues, plus equal first values where the row names a second index and the adoption can construct them- When
- their within-class order is selected
- Then
- the event with the lower
secret-play-orderresolves first - where the row names a second index, equal first numbers resolve by the lower second number; otherwise equal first numbers cannot arise or cannot change the result
- the order trace distinguishes selection by stable index from selection by rank or container order
- the event with the lower
- Diagnostics
card-duel-order-trace
within-class-stable-index · removal-order
removals uses stable index order
Applies to the removal-order row.
Within removals, lower board-position resolves first. Where the row names a second index, equal first numbers resolve by it; otherwise equal first numbers cannot arise or cannot change the result.
Test steps and diagnostics
- Given
two eligible
removalsevents with differentboard-positionvalues, plus equal first values where the row names a second index and the adoption can construct them- When
- their within-class order is selected
- Then
- the event with the lower
board-positionresolves first - where the row names a second index, equal first numbers resolve by the lower second number; otherwise equal first numbers cannot arise or cannot change the result
- the order trace distinguishes selection by stable index from selection by rank or container order
- the event with the lower
- Diagnostics
card-duel-order-trace
within-class-arrival-order
Row.class id uses stable arrival order
Does not apply to card-duel: no row in within-class-rules matches order arrival order.
within-class-map-reading-order
Row.class id follows its cited map reading order
Does not apply to card-duel: no row in within-class-rules matches order map reading order.
within-class-clockwise-order
Row.class id follows its cited clockwise order
Does not apply to card-duel: no row in within-class-rules matches order clockwise.
within-class-no-visible-order
Row.class id exposes no within-class order
Does not apply to card-duel: no row in within-class-rules matches order no visible order.
within-class-declared-random-order
Row.class id uses its cited random order
Does not apply to card-duel: no row in within-class-rules matches order declared random.
within-class-game-rule-order
Row.class id uses its cited game rule order
Does not apply to card-duel: no row in within-class-rules matches order game rule.
rank-tie-stable-index
Row.id orders its tied classes by stable index
Does not apply to card-duel: rank-ties has no rows.
rank-tie-arrival-order
Row.id orders its tied classes by stable arrival
Does not apply to card-duel: rank-ties has no rows.
rank-tie-map-reading-order
Row.id follows its cited map reading order
Does not apply to card-duel: rank-ties has no rows.
rank-tie-clockwise-order
Row.id follows its cited clockwise order
Does not apply to card-duel: rank-ties has no rows.
rank-tie-no-visible-order
Row.id exposes no shared-rank order
Does not apply to card-duel: rank-ties has no rows.
rank-tie-declared-random-order
Row.id uses its cited random order
Does not apply to card-duel: rank-ties has no rows.
rank-tie-game-rule-order
Row.id uses its cited game rule order
Does not apply to card-duel: rank-ties has no rows.
general-within-class-order
the general within-class answer covers classes without another order
Applies to card-duel.
For every class without a class row and without a shared rank, the general answer has no named data to compare here, so two ready events cannot arise or cannot change the result. Where no such class or pair exists, this test asserts nothing.
Test steps and diagnostics
- Given
each event class with no within-class-rules row and no shared rank
- When
- two events of that class are ready together where the adoption can construct them
- Then
- the general answer has no named data to compare here, so two ready events cannot arise or cannot change the result
- where no such class or pair exists, this test asserts nothing
- Diagnostics
card-duel-order-tracecard-duel-settlement-report
presentation-never-holds-event
Row.event class never waits for Row.presentation cue
Does not apply to card-duel: presentation timing is may delay, not never.
presentation-delay-holds-following-events · attack-landing
card-effects waits for attack animation without reordering
Applies to the attack-landing row.
An unfinished attack animation holds card-effects and every event behind it until the cue finishes; none passes it, and the instant cannot close. cards.attack-animation names the cue rule; the test names the address and restates nothing from it.
Test steps and diagnostics
- Given
a selected
card-effectsevent with unfinishedattack animationand a later eligible event- When
- the cue remains unfinished and then finishes under
cards.attack-animation
- the cue remains unfinished and then finishes under
- Then
- the selected event and every event behind it remain held until the cue finishes
- no later event passes it, and the held event then resumes with its original payload
- the instant remains open while the event is held
- Diagnostics
card-duel-waiting-setcard-duel-presentation-tracecard-duel-order-trace
presentation-delay-skips-only-held-event
Row.event class may be passed while Row.presentation cue is unfinished
Does not apply to card-duel: presentation timing is may delay, not may delay and reorder.
unnamed-event-has-no-presentation-wait
events with no presentation row wait for no cue of their own
Applies to card-duel.
A selected event named by no presentation-driven-events row never waits for a cue of its own; where the adoption answers may-delay and it stands behind a held event, it waits with that event; otherwise it is admitted at once. Where every selected class has a row, this test asserts nothing. This follows the presentation-timing option semantics and step 6.
Test steps and diagnostics
- Given
each selected event class not named by a presentation-driven-events row
- When
- presentation waiting is checked
- Then
- the event never waits for a cue of its own; where the adoption answers may-delay and it stands behind a held event, it waits with that event; otherwise it is admitted at once
- where every selected class is named by a presentation row, this test asserts nothing
- Diagnostics
card-duel-presentation-tracecard-duel-order-trace
terminal-collision-rows-cover-ending-pairs
declaration check: terminal-collision rows cover every ending pair
Applies to card-duel.
This declaration check reads the adoption and its Fixed ending rules, not the running game. A terminal-collisions row must exist for every win-and-loss pair that can meet at one instant; the collection's when-empty sentence supplies the empty direction. A constructible pair with no row is a defect this test fails by construction; where no pair can meet, the check asserts nothing.
Test steps and diagnostics
- Given
the
card-dueladoption and the ending pairs its Fixed rules can construct, not the running game- When
- a reviewer compares every pair with terminal-collisions
- Then
- a terminal-collisions row exists for every pair that can produce a win and a loss at the same instant
- the terminal-collisions when-empty sentence supplies the empty direction
- a constructible pair with no row is a defect this test fails by construction; where no pair can meet, this check asserts nothing
- Diagnostics
card-duel-declaration-recordcard-duel-ending-record
same-target-rows-cover-removal-collisions
declaration check: same-target rows cover every removal collision
Applies to card-duel.
This declaration check reads the adoption and its Fixed removal rules, not the running game. A same-target-cases or same-target-exceptions row must exist for every target kind with a same-instant removal collision; the row sets' when-empty sentences supply the empty direction. A constructible target kind with no row is a defect this test fails by construction; where none can occur, the check asserts nothing. This says nothing about a shared target with no removal.
Test steps and diagnostics
- Given
the
card-dueladoption and the target-removal cases its Fixed rules can construct, not the running game- When
- a reviewer compares every target kind with same-target-cases and same-target-exceptions
- Then
- a same-target-cases or same-target-exceptions row exists for every target kind for which two events can each remove one target at one instant
- the two row sets' when-empty sentences supply the empty direction
- a constructible target kind with no row is a defect this test fails by construction; where no such collision can occur, this check asserts nothing
- Diagnostics
card-duel-declaration-recordcard-duel-collision-report
caused-event-rows-cover-due-now-causes
declaration check: caused-event rows cover every due-now cause
Applies to card-duel.
This declaration check reads the adoption and its Fixed cause rules, not the running game. A caused-event-kinds row must exist for every non-interrupt event caused due in the same instant; the collection's when-empty sentence supplies the empty direction. A constructible due-now caused event with no row is a defect this test fails by construction; where none exists, the check asserts nothing.
Test steps and diagnostics
- Given
the
card-dueladoption and the non-interrupt event causes its Fixed rules can construct, not the running game- When
- a reviewer compares every newly caused due-now kind with caused-event-kinds
- Then
- a caused-event-kinds row exists for every non-interrupt event caused due in the same instant
- the caused-event-kinds when-empty sentence supplies the empty direction
- a constructible due-now caused event with no row is a defect this test fails by construction; where no such event exists, this check asserts nothing
- Diagnostics
card-duel-declaration-recordcard-duel-caused-event-report
interrupt-rows-cover-stops-and-replacements
declaration check: interrupt rows cover every stop and replacement
Applies to card-duel.
This declaration check reads the adoption and its Fixed interaction rules, not the running game. An interrupts row must exist for every event that stops or replaces another after selection, including before its first effect; the collection's when-empty sentence supplies the empty direction. A constructible stopping or replacement interaction with no row is a defect this test fails by construction; where none exists, the check asserts nothing.
Test steps and diagnostics
- Given
the
card-dueladoption and the event interactions its Fixed rules can construct after resolution starts, not the running game- When
- a reviewer compares every stopping or replacement interaction with interrupts
- Then
- an interrupts row exists for every event that stops or replaces another after selection, including before its first effect
- the interrupts when-empty sentence supplies the empty direction
- a constructible stopping or replacement interaction with no row is a defect this test fails by construction; where no such interaction exists, this check asserts nothing
- Diagnostics
card-duel-declaration-recordcard-duel-interrupt-report
same-target-general-resolution · minion-under-two-lethal-effects
minion uses the general collision result
Applies to the minion-under-two-lethal-effects row.
For minion, all group members apply to the target in order, removal waits until the complete group ends, and one removal consequence is recorded. cards.minion-damage identifies the collision case; the test names the address and restates nothing from it.
Test steps and diagnostics
- Given
two events in one instant that can each remove one
minionundercards.minion-damage- When
- their collision group resolves
- Then
- all group members apply to the target in order, removal waits until the complete group ends, and one removal consequence is recorded
- the collision report distinguishes this result from an orphan result or an ordinary event with no effect
- Diagnostics
card-duel-collision-reportcard-duel-event-trace
same-target-exception-resolution
Row.target kind uses its collision exception
Does not apply to card-duel: same-target-exceptions has no rows.
collision-precedes-orphan-check
same-target grouping precedes the orphan check
Applies to card-duel.
For each same-target collision group the adoption can construct, grouping settles before the orphan check and removal inside it never orphans another member. Under all-resolve-one-ending, the target stays live for members and for a non-member that resolves before the group ends. An unavailable case asserts nothing.
Test steps and diagnostics
- Given
each same-target collision group the adoption can construct, plus each non-member event that can resolve before deferred removal
- When
- the group is settled and source and target availability are checked
- Then
- the same-target decision is settled before the general orphan check
- removal inside the group never turns another group member into an orphan
- under all-resolve-one-ending, the target remains live for group members and any non-member that resolves before the group ends
- where no such group or non-member exists, the corresponding clause asserts nothing
- Diagnostics
card-duel-collision-reportcard-duel-orphan-reportcard-duel-event-trace
orphan-override-resolves-what-remains · queued-trigger-after-source-loss
queued-trigger-after-source-loss resolves what remains
Applies to the queued-trigger-after-source-loss row.
For queued-trigger-after-source-loss, a missing source leaves the captured payload in place. Only effects needing that object are skipped; every independent effect resolves. cards.trigger-survival identifies the case; the test names the address and restates nothing from it.
Test steps and diagnostics
- Given
a waiting and then active
triggered-effectsevent whose required source becomes unavailable undercards.trigger-survival- When
- availability is checked before the first effect and at every later effect boundary
- Then
- the event keeps its captured payload and skips only effects requiring the missing object
- every independent remaining effect resolves in declared order
- the orphan report distinguishes this route from cancellation and from an event that independently had no applicable effect
- Diagnostics
card-duel-orphan-reportcard-duel-event-trace
orphan-override-is-cancelled
Row.id is cancelled
Does not apply to card-duel: no row in orphan-cases matches resolution is cancelled.
orphan-default-row
Row.id uses the orphan default
Does not apply to card-duel: no row in orphan-cases matches resolution default.
undeclared-orphan-is-invalid
declaration check: an undeclared missing object has no implied result
Applies to card-duel.
This declaration check reads the adoption, not the running game. Every event that can lose a required source or target has an orphan-cases row. Outside those rows, missing-object behavior is invalid rather than implied and is a defect this test fails by construction. Where no event can become an orphan, this test asserts nothing.
Test steps and diagnostics
- Given
each event that can lose a required source or target while waiting or resolving
- When
- a reviewer compares that case with orphan-cases before the build is audited
- Then
- every such case has a matching orphan-cases row
- a missing object outside those rows is an invalid adoption and receives no implied cancellation or remaining-effects result
- an undeclared case is a defect this test fails by construction; where no event can lose a required object, this test asserts nothing
- Diagnostics
card-duel-orphan-reportcard-duel-declaration-record
active-event-commits-effects-in-order
an active event commits each effect before the next boundary
Applies to card-duel.
An active event visits the boundary before its first effect, applies effects in its Fixed rule's order, and commits each effect before the next boundary. If no multi-effect event exists, the between-effects observation asserts nothing.
Test steps and diagnostics
- Given
an eligible event with two or more ordered effects where the adoption can construct one
- When
- the event becomes active and applies its effects
- Then
- the event visits the boundary before its first effect
- effects are applied in the order stated by the event's Fixed game rule
- each effect commits before the next declared boundary is visited
- where no multi-effect event exists, the between-effects observation asserts nothing
- Diagnostics
card-duel-event-tracecard-duel-interrupt-report
interrupt-stops-original · counterspell-secret
counterspell-secret enters and stops the original event
Applies to the counterspell-secret row.
For an active card-effects event whose before-first-effect boundaries are named at cards.counterspell-secret, counterspell-secret creates one valid secrets interrupt offered at a named boundary and enters before the next effect, including before the first effect. Where the interrupt enters at a boundary of the active event, event order selects one valid interrupt, the active event advances only to permitted boundaries while it waits, and the interrupt passes through steps 6 to 11 before changing that event; where it joins the next instant instead, the active event runs to completion in this one. Then after it resolves, every remaining original effect is discarded while committed effects and costs remain. A presentation skip returns to the interrupted boundary; where none is possible, that clause asserts nothing. cards.counterspell-secret supplies validity and the finite chain; the test names the address and restates nothing from it.
Test steps and diagnostics
- Given
an active
card-effectsevent whosebefore-first-effectboundaries are named atcards.counterspell-secret, and a validsecretsinterrupt offered at one of them- When
- the valid interrupt is discovered, selected, and resolved
- Then
- one interrupt event is created through the interrupt path and enters before the next effect, including before the first effect
- where the interrupt enters at a boundary of the active event: when several interrupts are valid, event rank, the shared-rank order, and then within-class order select one; the active event advances only to boundaries
cards.counterspell-secretpermits while it waits; and the interrupt passes through presentation waiting, collision grouping, orphan checks, and its own boundaries before changing that event - where the interrupt joins the next instant instead, the active event runs to completion in this one
- after it resolves, every remaining original effect is discarded while committed effects and costs remain
- only one selected interrupt resolves at a time and the report distinguishes a valid interrupt from an invalid offer
- where presentation skips the interrupt, control returns to the interrupted event's boundary rather than step 4; where no such skip is possible, this clause asserts nothing
- Diagnostics
card-duel-interrupt-reportcard-duel-event-tracecard-duel-cost-log
interrupt-replaces-remaining-effects
Row.id enters and replaces the remaining effects
Does not apply to card-duel: no row in interrupts matches result replace remaining effects.
invalid-interrupt-does-not-enter · counterspell-secret
counterspell-secret refuses an invalid interrupt offer
Applies to the counterspell-secret row.
An interrupt of secrets offered outside the validity window named at cards.counterspell-secret, or at a point that is not one of the before-first-effect boundaries, creates no interrupt event. The active card-effects event advances unchanged, and the interrupt report distinguishes the invalid offer from a valid interrupt that was not selected. Where the adoption cannot construct an invalid offer, this test asserts nothing.
Test steps and diagnostics
- Given
an interrupt of
secretsoffered outside the validity window named atcards.counterspell-secret, or at a point that is not one of thebefore-first-effectboundaries- When
- the interrupt offer is checked
- Then
- no interrupt event is created
- the active
card-effectsevent advances unchanged - the interrupt report distinguishes an invalid offer from a valid interrupt that was not selected
- where the adoption cannot construct an invalid offer, this test asserts nothing
- Diagnostics
card-duel-interrupt-reportcard-duel-event-trace
caused-event-follows-declared-route · defeat-trigger
defeat-trigger creates one caused event on its declared route
Applies to the defeat-trigger row.
defeat-trigger creates one caused event of class triggered-effects once; it resolves at the current effect boundary before the active event continues, and no chain runs past the bound named at cards.defeat-triggers. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
an effect that causes
defeat-triggerdue now under the finite chain rule atcards.defeat-triggers- When
- the causing effect commits and the caused event is admitted
- Then
- one caused event of class
triggered-effectsis created once and resolves at the current effect boundary before the active event continues - no chain runs past the bound named at
cards.defeat-triggers - the caused-event report distinguishes this accepted route from rejection and from an interrupt
- one caused event of class
- Diagnostics
card-duel-caused-event-reportcard-duel-event-tracecard-duel-waiting-set
active-event-finishes-and-loop-continues
a finished event returns resolution to the waiting set
Applies to card-duel.
Finishing an active event applies any due deferred removal, records each selected consequence once, removes the event, and returns to step 4. The instant drains the waiting set and waits for any held cue; unavailable branches assert nothing.
Test steps and diagnostics
- Given
each active event, including a collision-group member where the adoption can construct one
- When
- the active event finishes
- Then
- any deferred target removal due at that point is applied and each selected consequence is recorded once
- the event is removed from the waiting set and selection returns to step 4
- the instant continues until the waiting set is empty, waiting for a cited cue when only presentation-held events remain
- where no deferred removal or held event exists, the corresponding clause asserts nothing
- Diagnostics
card-duel-event-tracecard-duel-waiting-setcard-duel-collision-report
single-ending-records-after-waiting-set-empties
a single ending records from final settled state
Applies to card-duel.
After the waiting set is empty, a single ending that holds in final settled state is recorded once through the game's cited ending rule. Earlier ending-event resolution and class rank do not record or override it. If no single ending can hold, this test asserts nothing.
Test steps and diagnostics
- Given
each instant the adoption can construct whose final settled state makes one ending hold outside every declared terminal collision
- When
- the waiting set becomes empty and step 15 runs
- Then
- the game's cited ending rule records that ending once from final settled state
- no earlier ending-event resolution or class rank records or overrides it
- where no such single ending can hold, this test asserts nothing
- Diagnostics
card-duel-waiting-setcard-duel-ending-record
terminal-collision-follows-precedence · both-heroes-at-zero
both-heroes-at-zero records its selected ending result
Applies to the both-heroes-at-zero row.
When opposing hero defeated and own hero defeated both hold in final settled state, both-heroes-at-zero records both the win and the loss, regardless of rank or detection order. cards.endings identifies the pair; the test names the address and restates nothing from it.
Test steps and diagnostics
- Given
an instant whose final settled state makes
opposing hero defeatedandown hero defeatedboth hold undercards.endings- When
- the waiting set becomes empty and step 15 reads the pair
- Then
- the lifecycle records both the win and the loss
- the result is unchanged by event rank or the order in which the two conditions were detected
- the ending record distinguishes this terminal collision from single-ending recording
- Diagnostics
card-duel-ending-recordcard-duel-settlement-report
instant-commits-state-and-next-waiting-set-together
the instant commits state and next-instant work together
Applies to card-duel.
Step 16 commits final state and the next-instant waiting set together. No event from a closed instant can re-enter it. Where there is no next-instant event, that membership observation asserts nothing.
Test steps and diagnostics
- Given
an instant with distinguishable final state and next-instant waiting events where the adoption can construct them
- When
- step 16 closes the instant
- Then
- the final state and next-instant waiting set commit together
- no event from the closed instant later re-enters it
- where no next-instant event exists, its membership observation asserts nothing
- Diagnostics
card-duel-instant-tracecard-duel-waiting-set
settlement-report-carries-lifecycle-fields
each settlement report carries the lifecycle record
Applies to card-duel.
Every settlement report carries the instant, event id, class, rank, tie-break when used, within-class order, source and target availability, applied effects, interrupt and replacement when present, caused-event destination, removal result, and terminal result when present. An unavailable optional circumstance asserts nothing.
Test steps and diagnostics
- Given
each event settled by
card-duel, with optional tie, interrupt, replacement, caused event, removal, and terminal result where present- When
- its settlement report is read
- Then
- the report carries instant, event id, class, rank, tie-break when used, within-class order, source and target availability, effects applied, interrupt and replacement when present, caused-event destination, removal result, and terminal result when present
- an optional circumstance the adoption cannot construct asserts nothing
- Diagnostics
card-duel-settlement-report
within-class-row-class-join · trigger-board-order
declaration check: triggered-effects names an existing event class
Applies to the trigger-board-order row.
This declaration check reads the adoption, not the running game. triggered-effects must name exactly one event class in this adoption. Any other shape is a defect this test fails by construction.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares
triggered-effectswith event-classes ids
- a reviewer compares
- Then
triggered-effectsnames exactly one event-classes row in this adoption; any other shape is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
within-class-row-class-join · secrets-order
declaration check: secrets names an existing event class
Applies to the secrets-order row.
This declaration check reads the adoption, not the running game. secrets must name exactly one event class in this adoption. Any other shape is a defect this test fails by construction.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares
secretswith event-classes ids
- a reviewer compares
- Then
secretsnames exactly one event-classes row in this adoption; any other shape is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
within-class-row-class-join · removal-order
declaration check: removals names an existing event class
Applies to the removal-order row.
This declaration check reads the adoption, not the running game. removals must name exactly one event class in this adoption. Any other shape is a defect this test fails by construction.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares
removalswith event-classes ids
- a reviewer compares
- Then
removalsnames exactly one event-classes row in this adoption; any other shape is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
presentation-row-class-join · attack-landing
declaration check: card-effects names an existing event class
Applies to the attack-landing row.
This declaration check reads the adoption, not the running game. card-effects must name exactly one event class in this adoption. Any other shape is a defect this test fails by construction.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares
card-effectswith event-classes ids
- a reviewer compares
- Then
card-effectsnames exactly one event-classes row in this adoption; any other shape is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
caused-row-class-join · defeat-trigger
declaration check: triggered-effects names an existing event class
Applies to the defeat-trigger row.
This declaration check reads the adoption, not the running game. triggered-effects must name exactly one event class in this adoption. Any other shape is a defect this test fails by construction.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares
triggered-effectswith event-classes ids
- a reviewer compares
- Then
triggered-effectsnames exactly one event-classes row in this adoption; any other shape is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
orphan-row-class-join · queued-trigger-after-source-loss
declaration check: triggered-effects names an existing event class
Applies to the queued-trigger-after-source-loss row.
This declaration check reads the adoption, not the running game. triggered-effects must name exactly one event class in this adoption. Any other shape is a defect this test fails by construction.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares
triggered-effectswith event-classes ids
- a reviewer compares
- Then
triggered-effectsnames exactly one event-classes row in this adoption; any other shape is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
interrupt-active-class-join · counterspell-secret
declaration check: card-effects names an existing event class
Applies to the counterspell-secret row.
This declaration check reads the adoption, not the running game. card-effects must name exactly one event class in this adoption. Any other shape is a defect this test fails by construction.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares
card-effectswith event-classes ids
- a reviewer compares
- Then
card-effectsnames exactly one event-classes row in this adoption; any other shape is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
interrupt-class-join · counterspell-secret
declaration check: secrets names an existing event class
Applies to the counterspell-secret row.
This declaration check reads the adoption, not the running game. secrets must name exactly one event class in this adoption. Any other shape is a defect this test fails by construction.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares
secretswith event-classes ids
- a reviewer compares
- Then
secretsnames exactly one event-classes row in this adoption; any other shape is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
rank-tie-rows-match-shared-ranks
declaration check: shared ranks and rank-tie rows match exactly
Applies to card-duel.
This declaration check reads the adoption, not the running game. Shared ranks and rank-ties rows must match one-for-one. Each comma-separated class-ids string lists every and only event class at that rank; the class-ids description requires each id to be listed once. Any other shape is a defect this test fails by construction; with no shared rank and no row, the check asserts nothing.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer groups event-classes rows by rank and compares the groups with rank-ties rows
- Then
- every rank shared by two or more event classes has exactly one rank-ties row, and every rank-ties row names a rank shared by at least two event classes
- each rank-ties class-ids string lists every and only event-classes id at that rank; the class-ids description requires each id to be listed once
- any other shape is a defect this test fails by construction; when no rank is shared and no rank-ties row exists, this check asserts nothing
- Diagnostics
card-duel-declaration-record
tied-classes-have-no-within-class-row
declaration check: tied classes have no class-specific order row
Applies to card-duel.
This declaration check reads the adoption, not the running game. A class already ordered by a rank-ties row must have no within-class-rules row. An inert class row is a defect this test fails by construction; with no rank tie, the check asserts nothing.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares every class named by rank-ties with within-class-rules class-id fields
- Then
- no event class named by a rank-ties row has a within-class-rules row
- a matching class row is inert and is a defect this test fails by construction; with no rank tie, this check asserts nothing
- Diagnostics
card-duel-declaration-record
same-target-kinds-do-not-overlap
declaration check: collision cases and exceptions do not overlap
Applies to card-duel.
This declaration check reads the adoption, not the running game. same-target-cases and same-target-exceptions must not name the same target kind. An overlap is a defect this test fails by construction; with either set empty, the comparison asserts nothing.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares target-kind across same-target-cases and same-target-exceptions
- Then
- no target kind is named in both row sets
- any overlap is a defect this test fails by construction; when either set is empty, the cross-set comparison asserts nothing
- Diagnostics
card-duel-declaration-record
only-first-needs-visible-order
declaration check: only-first collisions have a visible order
Applies to card-duel.
This declaration check reads the adoption, not the running game. Every event class that can supply two events to a collision resolved by only-first-resolves, through the general answer or a same-target-exceptions row, must have a visible class-row, rank-tie, or general order. A no-visible-order path or any other shape is a defect this test fails by construction; where no target kind uses only-first-resolves, the check asserts nothing. The only-first-resolves semantics supplies this duty.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer finds every event class that can supply two events to a collision resolved by only-first-resolves through the general answer or a same-target-exceptions row
- Then
- every such class has a visible order: a within-class-rules row whose order is not no-visible-order, a rank-ties row whose tie-break is not no-visible-order, or a general within-class-order answer other than no-visible-order
- any other shape is a defect this test fails by construction; where no target kind is resolved by only-first-resolves, this check asserts nothing
- Diagnostics
card-duel-declaration-record
same-target-exception-differs-from-general
declaration check: each same-target exception differs from the general answer
Applies to card-duel.
This declaration check reads the adoption, not the running game. No same-target-exceptions row may repeat the general two-events-one-target answer. An inert exception is a defect this test fails by construction; with no exception row, the check asserts nothing. The same-target-exceptions description supplies this duty.
Test steps and diagnostics
- Given
the
card-dueladoption document, not the running game- When
- a reviewer compares every same-target-exceptions resolution with the general two-events-one-target answer
- Then
- no same-target-exceptions row names the same resolution as the general answer
- an inert exception is a defect this test fails by construction; with no exception row, this check asserts nothing
- Diagnostics
card-duel-declaration-record
stable-index-second-index-duty
declaration check: stable indexes settle equal first numbers
Applies to card-duel.
This declaration check reads the adoption and its Fixed event rules, not the running game. Every stable-index class row or rank tie must name a second index or belong to a class or tied group that cannot produce equal first numbers that change the result. Any other shape is a defect this test fails by construction; with no stable-index row, the check asserts nothing.
Test steps and diagnostics
- Given
the
card-dueladoption document and its Fixed event rules, not the running game- When
- a reviewer checks every within-class-rules row and every rank-ties row using stable-index
- Then
- every such row either names a second index or belongs to a class or tied group that cannot produce equal first numbers that change the result
- any other shape is a defect this test fails by construction; with no stable-index row, this check asserts nothing
- Diagnostics
card-duel-declaration-record
visible-tie-needs-class-row
declaration check: visible ties have class rows when named data is needed
Applies to card-duel.
This declaration check reads the adoption and its Fixed event rules, not the running game. A class that can have a visible tie outside a rank tie must have a within-class-rules row when the general answer is stable-index, map-reading-order, clockwise, or declared-random. Any other shape is a defect this test fails by construction; for arrival-order or no-visible-order, or with no such class, the check asserts nothing.
Test steps and diagnostics
- Given
the
card-dueladoption document and the event classes its Fixed rules can tie visibly, not the running game- When
- a reviewer compares each such class outside a rank tie with within-class-rules and the general within-class-order answer
- Then
- every class that can have a visible tie and is not in a rank tie has a within-class-rules row when the general answer needs named data: stable-index, map-reading-order, clockwise, or declared-random
- any other shape is a defect this test fails by construction; where the general answer is arrival-order or no-visible-order, or no such class exists, this check asserts nothing
- Diagnostics
card-duel-declaration-record
rejection-default-citations-have-rows
declaration check: citing rejection defaults have rows for every case
Does not apply to card-duel: rejected action effect is nothing changes, not derate or clock advances or cost and clock.
event-class-list-is-complete
declaration check: event-classes covers every event due at an instant
Applies to card-duel.
This declaration check reads the adoption and its Fixed event rules, not the running game. event-classes must cover every event due at an instant exactly once, must name event classes rather than simulation stages, and must invert authored numbers once when the game's source convention is higher-first. An omission, category error, or runtime reversal is a defect this test fails by construction.
Test steps and diagnostics
- Given
the
card-dueladoption and its Fixed event rules, not the running game- When
- a reviewer compares every event due at an instant with event-classes
- Then
- every event due at an instant belongs to exactly one event-classes row
- a game whose source convention is higher-first has inverted its authored numbers once in event-classes rather than reversing them at runtime
- an omitted event class or a list of simulation stages presented as classes is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
event-class-citation-states-membership · card-actions
declaration check: the citation for card-actions names its class and members
Applies to the card-actions row.
This declaration check reads the adoption and cards.play-card, not the running game. The citation must name card-actions, labelled Card actions in the game's own words, and the events belonging to it. Another meaning is a defect this test fails by construction. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
the
card-dueladoption and the prose atcards.play-card, not the running game- When
- a reviewer checks the citation's meaning
- Then
cards.play-cardnamescard-actions, labelledCard actionsin the game's own words, and the events belonging to it- another meaning is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
event-class-citation-states-membership · secrets
declaration check: the citation for secrets names its class and members
Applies to the secrets row.
This declaration check reads the adoption and cards.secrets, not the running game. The citation must name secrets, labelled Secrets in the game's own words, and the events belonging to it. Another meaning is a defect this test fails by construction. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
the
card-dueladoption and the prose atcards.secrets, not the running game- When
- a reviewer checks the citation's meaning
- Then
cards.secretsnamessecrets, labelledSecretsin the game's own words, and the events belonging to it- another meaning is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
event-class-citation-states-membership · card-effects
declaration check: the citation for card-effects names its class and members
Applies to the card-effects row.
This declaration check reads the adoption and cards.effects, not the running game. The citation must name card-effects, labelled Card effects in the game's own words, and the events belonging to it. Another meaning is a defect this test fails by construction. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
the
card-dueladoption and the prose atcards.effects, not the running game- When
- a reviewer checks the citation's meaning
- Then
cards.effectsnamescard-effects, labelledCard effectsin the game's own words, and the events belonging to it- another meaning is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
event-class-citation-states-membership · triggered-effects
declaration check: the citation for triggered-effects names its class and members
Applies to the triggered-effects row.
This declaration check reads the adoption and cards.triggers, not the running game. The citation must name triggered-effects, labelled Triggered effects in the game's own words, and the events belonging to it. Another meaning is a defect this test fails by construction. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
the
card-dueladoption and the prose atcards.triggers, not the running game- When
- a reviewer checks the citation's meaning
- Then
cards.triggersnamestriggered-effects, labelledTriggered effectsin the game's own words, and the events belonging to it- another meaning is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
event-class-citation-states-membership · removals
declaration check: the citation for removals names its class and members
Applies to the removals row.
This declaration check reads the adoption and cards.removals, not the running game. The citation must name removals, labelled Removals in the game's own words, and the events belonging to it. Another meaning is a defect this test fails by construction. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
the
card-dueladoption and the prose atcards.removals, not the running game- When
- a reviewer checks the citation's meaning
- Then
cards.removalsnamesremovals, labelledRemovalsin the game's own words, and the events belonging to it- another meaning is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
event-class-citation-states-membership · match-endings
declaration check: the citation for match-endings names its class and members
Applies to the match-endings row.
This declaration check reads the adoption and cards.endings, not the running game. The citation must name match-endings, labelled Match endings in the game's own words, and the events belonging to it. Another meaning is a defect this test fails by construction. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
the
card-dueladoption and the prose atcards.endings, not the running game- When
- a reviewer checks the citation's meaning
- Then
cards.endingsnamesmatch-endings, labelledMatch endingsin the game's own words, and the events belonging to it- another meaning is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
within-class-grid-citation-duty
declaration check: the grid citation for Row.id supplies its order frame
Does not apply to card-duel: no row in within-class-rules matches order map reading order or clockwise.
within-class-rule-citation-duty
declaration check: the rule citation for Row.id supplies one total order
Does not apply to card-duel: no row in within-class-rules matches order declared random or game rule.
rank-tie-grid-citation-duty
declaration check: the grid citation for Row.id supplies its order frame
Does not apply to card-duel: rank-ties has no rows.
rank-tie-rule-citation-duty
declaration check: the rule citation for Row.id supplies one total order
Does not apply to card-duel: rank-ties has no rows.
rejection-scale-citation-duty
declaration check: the scale citation for Row.id covers effect and cost
Does not apply to card-duel: rejection-cases has no rows.
rejection-clock-citation-duty
declaration check: the clock citation for Row.id names one advance
Does not apply to card-duel: rejection-cases has no rows.
presentation-cue-citation-duty · attack-landing
declaration check: the presentation citation for attack-landing supplies a finite cue
Applies to the attack-landing row.
This declaration check reads the adoption and cards.attack-animation, not the running game. The citation must relate the game timing of card-effects to attack animation and show that the cue finishes in finite game or real time, keeping an instant from waiting forever. A missing duty is a defect this test fails by construction. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
the
card-dueladoption and the prose atcards.attack-animation, not the running game- When
- a reviewer checks the cited presentation rule
- Then
cards.attack-animationrelates the game timing ofcard-effectstoattack animationand shows the cue finishes in finite game or real time, which is what keeps an instant from waiting forever- a missing duty is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
caused-event-citation-duty · defeat-trigger
declaration check: the caused-event citation for defeat-trigger supplies its bound
Applies to the defeat-trigger row.
This declaration check reads the adoption and cards.defeat-triggers, not the running game. The citation must name the cause, the new triggered-effects event, and the finite bound on repeated caused events. A missing duty is a defect this test fails by construction. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
the
card-dueladoption and the prose atcards.defeat-triggers, not the running game- When
- a reviewer checks the cited caused-event rule
- Then
cards.defeat-triggersnames the cause, the newtriggered-effectsevent, and the finite bound on repeated caused events- a missing duty is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
interrupt-citation-duty · counterspell-secret
declaration check: the interrupt citation for counterspell-secret supplies its entry rule
Applies to the counterspell-secret row.
This declaration check reads the adoption and cards.counterspell-secret, not the running game. The citation must name the validity window, the before-first-effect effect boundaries, and the stop result. A missing duty is a defect this test fails by construction. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
the
card-dueladoption and the prose atcards.counterspell-secret, not the running game- When
- a reviewer checks the cited interrupt rule
- Then
cards.counterspell-secretnames the validity window, thebefore-first-effecteffect boundaries, and the stop result- a missing duty is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
interrupt-replacement-citation-duty
declaration check: the replacement citation for Row.id supplies every effect in order
Does not apply to card-duel: no row in interrupts matches result replace remaining effects.
orphan-case-citation-duty · queued-trigger-after-source-loss
declaration check: the orphan citation for queued-trigger-after-source-loss supplies its case
Applies to the queued-trigger-after-source-loss row.
This declaration check reads the adoption and cards.trigger-survival, not the running game. The citation must identify the case, when it applies, the captured payload, and the source or target requirement. A missing duty is a defect this test fails by construction. The test names the address and restates nothing from it.
Test steps and diagnostics
- Given
the
card-dueladoption and the prose atcards.trigger-survival, not the running game- When
- a reviewer checks the cited orphan rule
- Then
cards.trigger-survivalidentifies the case, when it applies, the captured payload, and the source or target requirement- a missing duty is a defect this test fails by construction
- Diagnostics
card-duel-declaration-record
resolution-holds
event resolution holds for the whole run
Applies to card-duel.
Across every instant of the audited run that this adoption owns in full, lower eligible ranks never resolve late, each tie and within-class order holds, each proposal follows its case or default, each accepted proposal creates one payload, each valid interrupt takes effect at its entry point, each caused event follows its route, each orphan follows its row, and each ending records once at step 15. An instant shared with another adoption asserts nothing here. A case the adoption cannot construct asserts nothing.
Test steps and diagnostics
- Holds
for every instant of the audited run that this adoption owns in full, every event resolved at or after every eligible lower-rank event; every rank tie and within-class selection followed its declared order; every rejection followed its matching case or default; every accepted proposal created one payload once; every valid interrupt entered at its declared point and took effect; every caused event was created once and followed its route; every orphan followed its row; every ending was recorded once at step 15; an instant shared with another adoption asserts nothing here; a case the adoption cannot construct asserts nothing
- Seeds
["audit-a","audit-b"]- Scope
every instant of the audited run that this adoption owns in full- Diagnostics
card-duel-instant-tracecard-duel-proposal-logcard-duel-order-tracecard-duel-collision-reportcard-duel-orphan-reportcard-duel-interrupt-reportcard-duel-ending-recordcard-duel-settlement-reportcard-duel-first-ordering-violation
JSONthe adoption as one file
The adoption file as supplied. Answers you try on this page are not written into it; to change an adoption, open it in the authoring tool.
{
"contract": "event-resolution",
"version": 1,
"summary": "Covers actions and events that meet at one game moment. It decides their order, ties, interruptions, chain reactions, and rejected actions. It also settles missing sources or targets, two removals reaching one target, simultaneous endings, and presentation delays. Individual effects, input buffering, clocks and pausing, displayed facts, and simulation pipeline stages stay elsewhere.",
"questions": {
"rejected-action-effect": {
"asks": "An action cannot happen exactly as proposed. What happens by default?",
"rationale": "The attempt may fail, spend a resource, use time, or continue at a smaller scale. Particular cases can choose another result in their own rows.",
"options": {
"nothing-changes": {
"meaning": "The rejected attempt changes nothing. A tactics unit blocked by a closed gate keeps its stamina and its turn.",
"semantics": "The rejection changes no game state, spends no cost, and advances no clock. Time already advancing independently may continue."
},
"cost-taken": {
"meaning": "The rejected attempt spends its cost and changes nothing else. A card rejected after commitment still spends its mana.",
"semantics": "The rejection applies the action's complete declared cost, produces none of the action's effects, and does not advance a clock because of the rejection."
},
"clock-advances": {
"meaning": "The rejected attempt moves time forward and spends no cost. A roguelike hero who walks into a wall still uses a turn.",
"semantics": "The rejection advances one clock once, applies no cost, and produces none of the action's effects. Every case using this result cites the clock rule in its rejection-cases row."
},
"cost-and-clock": {
"meaning": "The rejected attempt spends its cost and moves time forward. A dungeon wand that fizzles uses one charge and one turn.",
"semantics": "The rejection applies the complete declared cost and advances one clock once, but produces none of the action's effects. Every case using this result cites the clock rule in its rejection-cases row."
},
"derate": {
"meaning": "The action happens with a smaller result instead of failing. A factory machine on low power makes parts more slowly.",
"semantics": "The proposal is accepted rather than rejected. The scale rule cited by its rejection-cases row scales the complete effect and cost, and the event continues through this lifecycle."
},
"not-applicable": {
"meaning": "Every proposed action in this family is accepted. An arcade blaster always fires because ammunition and cooldown never refuse a shot.",
"semantics": "No action governed by this adoption has a rejection branch."
}
}
},
"within-class-order": {
"asks": "Two events of the same kind are ready together. What decides which goes first?",
"rationale": "The event rank cannot separate two events from one class. Their order can change targets, rewards, and later chains.",
"options": {
"stable-index": {
"meaning": "A named stable number decides the order. Strategy effects use priority first and spawn number to break a tie.",
"semantics": "Every class with a visible tie has a row naming an integer the event holds when it enters the waiting set. The number may be the event's own or inherited from its source object, such as a relic's acquisition number or a minion's board position. Lower numbers resolve first. An optional second named integer breaks equal first numbers; without one, equal-number order cannot arise or cannot change the result."
},
"arrival-order": {
"meaning": "The event that entered the waiting list first goes first. Card effects triggered together resolve in the order they were added.",
"semantics": "Earlier admission to the waiting list resolves first. Admission order is stable for the complete instant."
},
"map-reading-order": {
"meaning": "Positions decide the order like reading the game's map. Tied tactics units follow its first row, then its first column.",
"semantics": "The grid cited by the class or rank-tie row owns row and column meaning. Its own first row resolves first; within that row, its own first column resolves first."
},
"clockwise": {
"meaning": "Positions resolve clockwise around a fixed centre. Four boss hazards start from the direction the arena marks first.",
"semantics": "The grid cited by the class or rank-tie row owns the centre and first direction. Clockwise angle continues the order, and the row's named stable index breaks an equal angle and distance."
},
"no-visible-order": {
"meaning": "No order can change the game result. Racing-game confetti bursts may update in either order because neither affects the race.",
"semantics": "No event in the class observes another event in the same class during the instant, and every permitted execution order produces the same game state and player-facing result. This includes the case where two such events cannot arise together."
},
"declared-random": {
"meaning": "A declared random draw breaks the tie. Two creatures with equal speed roll to see which acts first.",
"semantics": "Each affected class has a within-class-rules row citing the random rule and its complete draw procedure. The result may vary between runs; the cited rule, not container order, selects it."
}
}
},
"terminal-precedence": {
"asks": "A win and a loss land at the same moment. Which ending does the game record?",
"rationale": "Ending checks may arrive through different events. This answer decides the recorded result after both conditions are known.",
"when": {
"row-count": {
"terminal-collisions": "non-empty"
}
},
"otherwise": "No declared ending pair can produce a win and a loss at the same instant.",
"options": {
"loss-only": {
"meaning": "Only the loss is recorded. An arena hero who defeats the boss while reaching zero health loses the run.",
"semantics": "The lifecycle records only the loss, regardless of event rank or the order in which the two ending conditions were detected."
},
"win-only": {
"meaning": "Only the win is recorded. A racing driver who crosses the finish line while crashing still wins.",
"semantics": "The lifecycle records only the win, regardless of event rank or the order in which the two ending conditions were detected."
},
"both-recorded": {
"meaning": "Both endings are recorded. A card duel in which both heroes reach zero health records a shared defeat and a completed victory condition.",
"semantics": "The lifecycle records both the win and the loss. The game's presentation rule decides whether that appears as a draw, one combined result, or two named results."
}
}
},
"presentation-timing": {
"asks": "Can an animation or sound delay an event, and can another event pass it?",
"rationale": "A visual delay and a rules delay are different decisions. The answer fixes whether only time changes or order changes too.",
"when": {
"row-count": {
"presentation-driven-events": "non-empty"
}
},
"otherwise": "No visual or sound delays an event or changes event order.",
"options": {
"never": {
"meaning": "Presentation never changes game timing or order. An attack lands at game time even when its animation runs early or late.",
"semantics": "No named event waits for presentation. The rows record that the game considered and declared this boundary; an empty row set is the undeclared closed case."
},
"may-delay": {
"meaning": "These events may wait, but later events wait behind them. A card attack lands after its animation while later effects keep their order.",
"semantics": "Only events named by presentation-driven-events wait for a cue of their own. Every event behind a held event in the order waits with it, so the delay cannot let a later event resolve first."
},
"may-delay-and-reorder": {
"meaning": "These events may wait while later events continue. A fighting-game cinematic can finish after a later poison pulse has already landed.",
"semantics": "Only events named by presentation-driven-events may wait. A later eligible event may resolve before a delayed event, and the delayed event keeps its original payload."
}
}
},
"two-events-one-target": {
"asks": "Two events would each remove the same target at this moment. What happens to the second one?",
"rationale": "The second event may vanish, still count, or create another ending. Particular target kinds can choose a different result.",
"when": {
"any": [
{
"row-count": {
"same-target-cases": "non-empty"
}
},
{
"row-count": {
"same-target-exceptions": "non-empty"
}
}
]
},
"otherwise": "No two events in this adoption can each remove the same target at one instant.",
"options": {
"only-first-resolves": {
"meaning": "Only the first event affects the target. Two tactics arrows reach the last enemy, and the later arrow finds no target.",
"semantics": "The first ordered event applies to the target and removes it. Every later event in the collision applies nothing to that target; its cost and carrier follow their own game rules. Every class that can supply two events to such a collision has a visible order: its class row, its rank tie, or the general answer is not no-visible-order."
},
"all-resolve-one-ending": {
"meaning": "Every event lands, but the target is removed once. Two arena hits both count before one enemy defeat is recorded.",
"semantics": "All events in the collision apply to the target in order. Removal is deferred until the collision group ends and is recorded once."
},
"all-resolve-each-ending": {
"meaning": "Every event lands and each records its own removal result. Two arcade lasers can each award a break bonus from one target.",
"semantics": "Every event in the collision applies in order and records its own declared removal consequence, even after an earlier event recorded one."
}
}
},
"caused-events": {
"asks": "An event happening now causes another event due at this moment. When does the new event resolve?",
"rationale": "A chain can continue immediately, join the normal order, or wait for the next game moment.",
"when": {
"row-count": {
"caused-event-kinds": "non-empty"
}
},
"otherwise": "No non-interrupt event in this adoption causes another event due at the same instant.",
"options": {
"resolves-now": {
"meaning": "The new event resolves inside the event that caused it. A card's defeat effect draws a replacement before the next waiting card effect.",
"semantics": "The caused event finishes inside the event that caused it, before the next waiting event. Every caused-event row cites a finite chain bound."
},
"waits-for-its-place": {
"meaning": "The new event joins its normal place in the current order. An arena enemy activated early can attack later in the same moment.",
"semantics": "The caused event resolves in its declared class's place, this instant or the next. Every caused-event row cites a finite chain bound."
},
"next-instant": {
"meaning": "The new event always waits for the next game moment. A factory alarm raised now closes the conveyor gate on the next update.",
"semantics": "Every caused event is admitted to the next instant and none of its effects resolve during the instant that created it. Every caused-event row cites a finite chain bound."
}
}
},
"interrupt-entry": {
"asks": "A reaction can stop or replace an event already happening. When does it cut in?",
"rationale": "An interrupt needs a fixed entry point before it can stop or replace the event already in progress.",
"when": {
"row-count": {
"interrupts": "non-empty"
}
},
"otherwise": "No event in this adoption stops or replaces another event once it has been selected to resolve, at any point including before its first effect.",
"options": {
"before-next-effect": {
"meaning": "The interrupt cuts in before the current event's next effect. A card secret counters a spell before its damage lands.",
"semantics": "At each declared effect boundary, a valid interrupt resolves before the next effect of the active event. The interrupt row then stops or replaces the active event."
},
"after-current-effect": {
"meaning": "The current effect finishes before the interrupt cuts in. A parry accepts the sword's contact, prevents the remaining damage, and replaces it with stagger.",
"semantics": "The active effect commits first. A valid interrupt then resolves at the following declared boundary and stops or replaces every remaining effect of the active event."
},
"at-normal-rank": {
"meaning": "The interrupt joins the normal event order. A factory emergency stop waits for the safety rank, then cancels later machine work.",
"semantics": "The interrupt joins this instant when its class is current or has not passed, and otherwise joins the next instant. When it joins the next instant, the active event finishes unchanged in this one and the interrupt stops or replaces only events of its active class that are still waiting or active when it resolves. It remains an interrupt creation path, so the caused-events answer does not govern it."
}
}
},
"orphaned-events": {
"asks": "An event loses the source or target it needs. What happens by default?",
"rationale": "A queued card effect or tactics shot may outlive a source or target. The result must not depend on which object was cleaned up first.",
"when": {
"row-count": {
"orphan-cases": "non-empty"
}
},
"otherwise": "No event in this adoption can lose its required source or target while waiting or resolving.",
"options": {
"resolves-what-remains": {
"meaning": "The event still resolves with the state that remains. A card's queued effect continues after its minion leaves play.",
"semantics": "The event keeps its captured payload. A missing source or target is unavailable, effects that require it are skipped, and every independent effect still resolves. This is the default unless the orphan-cases row chooses another result."
},
"is-cancelled": {
"meaning": "The event is cancelled. A homing shot disappears when its only target leaves play before impact.",
"semantics": "The event produces no further effect after the required source or target becomes unavailable. Costs already committed are not restored by this contract. This is the default unless the orphan-cases row chooses another result."
}
}
}
},
"declares": {
"values": {},
"rows": {
"event-classes": {
"description": "The event kinds ordered at one instant. Lower rank resolves first; a higher-first game inverts its numbers once in this list. Rank may repeat only when one rank-ties row declares the shared rank. An ending event's resolution records nothing.",
"when-empty": "An empty event-classes list is never a behavior choice: this adoption requires at least one row, and a reviewer rejects a file without it.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "A stable game-facing name for the event class, such as card-effects or enemy-removals."
},
"rank": {
"type": "integer",
"required": true,
"description": "The class position, lowest first. Equal ranks are allowed only with one matching rank-ties row."
},
"label": {
"type": "string",
"required": true,
"description": "The event class in the game's own words. A card duel might use triggered effects."
},
"declared-in": {
"type": "citation",
"required": true,
"description": "The Fixed game rule that names the class and the events belonging to it."
}
}
},
"within-class-rules": {
"description": "Classes that use an order different from the general answer or must name the data that answer compares. A class using a stable number, map order, clockwise order, declared random draw, or custom game rule has a row whenever a visible tie can occur.",
"when-empty": "Every event class uses the general within-class answer.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "A stable name for this class-specific order."
},
"class-id": {
"type": "string",
"required": true,
"unique": true,
"description": "The id of the affected event class."
},
"order": {
"type": "string",
"required": true,
"options": [
"stable-index",
"arrival-order",
"map-reading-order",
"clockwise",
"no-visible-order",
"declared-random",
"game-rule"
],
"description": "The class-specific order. A custom game rule is available here, not as the general answer."
},
"index-name": {
"type": "string",
"when": {
"row": {
"order": [
"stable-index",
"clockwise"
]
}
},
"description": "For stable-index, the first named number. For clockwise, the stable number that breaks an equal angle and distance."
},
"second-index-name": {
"type": "string",
"required": false,
"description": "An optional stable second number that breaks an equal first number under stable-index. Omit it for every other order."
},
"grid-declared-in": {
"type": "citation",
"when": {
"row": {
"order": [
"map-reading-order",
"clockwise"
]
}
},
"description": "The adopted Grid and direction rule that supplies the grid's own first row and first column, or the centre, first direction, and clockwise sense."
},
"rule-declared-in": {
"type": "citation",
"when": {
"row": {
"order": [
"declared-random",
"game-rule"
]
}
},
"description": "For declared-random, the complete draw that produces one total order for the instant. For game-rule, one total deterministic order. The Fixed rule never points back here."
}
}
},
"rank-ties": {
"description": "Every rank shared by two or more event classes, with one tie-break for those classes.",
"when-empty": "No two event classes share a rank.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "A stable name for the shared-rank group."
},
"rank": {
"type": "integer",
"required": true,
"unique": true,
"description": "The rank shared by the named classes."
},
"class-ids": {
"type": "string",
"required": true,
"description": "The comma-separated ids of every event class at this rank, each listed once."
},
"tie-break": {
"type": "string",
"required": true,
"options": [
"stable-index",
"arrival-order",
"map-reading-order",
"clockwise",
"no-visible-order",
"declared-random",
"game-rule"
],
"description": "The order used across all events of the tied classes at this rank."
},
"index-name": {
"type": "string",
"when": {
"row": {
"tie-break": [
"stable-index",
"clockwise"
]
}
},
"description": "The stable number compared across tied classes, or the stable number that breaks an equal clockwise position."
},
"second-index-name": {
"type": "string",
"required": false,
"description": "An optional stable second number that breaks an equal first number under stable-index. Omit it for every other tie-break."
},
"grid-declared-in": {
"type": "citation",
"when": {
"row": {
"tie-break": [
"map-reading-order",
"clockwise"
]
}
},
"description": "The adopted Grid and direction rule that supplies the grid's own first row and first column, or the centre, first direction, and clockwise sense."
},
"rule-declared-in": {
"type": "citation",
"when": {
"row": {
"tie-break": [
"declared-random",
"game-rule"
]
}
},
"description": "For declared-random, the complete draw that produces one total order for the instant. For game-rule, one total deterministic order. The Fixed rule never points back here."
}
}
},
"rejection-cases": {
"description": "Named action-proposal cases that override the default answer or supply the scale or clock citation that answer requires.",
"when-empty": "No named case overrides the default. A reviewer rejects an empty list when a derated or clock-advancing rejection can occur, because that result requires its citation row.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "The proposal case in game language, such as blocked-movement or low-power-crafting."
},
"result": {
"type": "string",
"required": true,
"options": [
"nothing-changes",
"cost-taken",
"clock-advances",
"cost-and-clock",
"derate"
],
"description": "The result for this case. It may repeat the default only to carry a required scale or clock citation. A case that never rejects is not a rejection case and has no row."
},
"declared-in": {
"type": "citation",
"required": true,
"description": "The Fixed game rule identifying this rejection case and when it applies."
},
"scale-rule-declared-in": {
"type": "citation",
"when": {
"row": {
"result": [
"derate"
]
}
},
"description": "The Fixed rule that scales the complete effect and cost."
},
"clock-rule-declared-in": {
"type": "citation",
"when": {
"row": {
"result": [
"clock-advances",
"cost-and-clock"
]
}
},
"description": "The Fixed clock or turn rule naming exactly one advance caused by this rejection."
}
}
},
"terminal-collisions": {
"description": "Pairs of win and loss conditions that can become true in one instant.",
"when-empty": "A win and a loss cannot land together in this adoption.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "A stable name for this ending collision."
},
"win-condition": {
"type": "string",
"required": true,
"description": "The winning condition in game language, such as boss defeated."
},
"loss-condition": {
"type": "string",
"required": true,
"description": "The losing condition in game language, such as hero defeated."
},
"declared-in": {
"type": "citation",
"required": true,
"description": "The Fixed game rules that name both ending conditions and show how they can meet."
}
}
},
"same-target-cases": {
"description": "Target kinds for which two events can each be enough to remove the same target at one instant.",
"when-empty": "No general same-target removal case is declared; any same-target-exceptions rows are the only declared collisions.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "A stable name for the target case."
},
"target-kind": {
"type": "string",
"required": true,
"unique": true,
"description": "The target kind, such as arena enemies or breakable cover."
},
"declared-in": {
"type": "citation",
"required": true,
"description": "The Fixed game rule showing how two same-instant events can each remove this target kind."
}
}
},
"same-target-exceptions": {
"description": "Target kinds that use a result different from the general same-target answer.",
"when-empty": "Every declared same-target case uses the general answer.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "A stable name for the exception."
},
"target-kind": {
"type": "string",
"required": true,
"unique": true,
"description": "The non-overlapping target kind covered by this exception."
},
"resolution": {
"type": "string",
"required": true,
"options": [
"only-first-resolves",
"all-resolve-one-ending",
"all-resolve-each-ending"
],
"description": "The result used for this target kind instead of the general answer."
},
"declared-in": {
"type": "citation",
"required": true,
"description": "The Fixed game rule naming the target kind and its same-instant collision."
}
}
},
"presentation-driven-events": {
"description": "Events whose relation to a visual or sound is explicitly declared, including events declared never to wait.",
"when-empty": "No presentation timing rule is declared for an event in this adoption, so presentation does not delay an event or change event order.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "A stable name for the event and presentation case."
},
"event-class": {
"type": "string",
"required": true,
"description": "The id of the event class whose timing is compared with presentation."
},
"presentation-cue": {
"type": "string",
"required": true,
"description": "The visual or sound in game language, such as a card attack animation."
},
"declared-in": {
"type": "citation",
"required": true,
"description": "The Fixed game rule relating the event's game timing to its presentation cue and showing that the cue finishes in finite game or real time."
}
}
},
"caused-event-kinds": {
"description": "Non-interrupt events that can create another event due during the instant that created it.",
"when-empty": "No non-interrupt event creates another event due in the same instant.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "A stable name for the chain, such as enemy-activation-to-attack."
},
"event-class": {
"type": "string",
"required": true,
"description": "The class of the newly caused event."
},
"declared-in": {
"type": "citation",
"required": true,
"description": "The Fixed game rule naming the cause, the new event, and the finite bound on repeated caused events."
}
}
},
"interrupts": {
"description": "Events created through the interrupt path that can stop or replace another event at a declared effect boundary, including the boundary before its first effect.",
"when-empty": "No event stops or replaces another event after resolution begins or before its first effect.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "The interrupt in game language, such as counter-secret or sword-parry."
},
"active-class": {
"type": "string",
"required": true,
"description": "The event class that can be interrupted."
},
"interrupt-class": {
"type": "string",
"required": true,
"description": "The event class that cuts in."
},
"boundary-granularity": {
"type": "string",
"required": true,
"description": "The smallest named boundary the interrupt can use, such as before the first effect, after each hit, or at each crossed tile edge."
},
"result": {
"type": "string",
"required": true,
"options": [
"stop-original",
"replace-remaining-effects"
],
"description": "Whether the interrupt ends the active event or substitutes a cited set of effects for what remains."
},
"declared-in": {
"type": "citation",
"required": true,
"description": "The Fixed game rule naming the validity window, effect boundaries, and stop result."
},
"replacement-declared-in": {
"type": "citation",
"when": {
"row": {
"result": [
"replace-remaining-effects"
]
}
},
"description": "The Fixed game rule stating every replacement effect and its order."
}
}
},
"orphan-cases": {
"description": "Events that can lose a required source or target while waiting or resolving. Each row selects its result, so opposite policies share one adoption.",
"when-empty": "No event can lose a required source or target while waiting or resolving.",
"record": {
"id": {
"type": "string",
"required": true,
"pattern": "kebab-case",
"unique": true,
"description": "The missing-object case in game language, such as trigger-after-source-loss."
},
"event-class": {
"type": "string",
"required": true,
"description": "The event class that may become orphaned."
},
"missing": {
"type": "string",
"required": true,
"options": [
"source",
"target",
"source-or-target"
],
"description": "Which required game object may become unavailable while the event waits or resolves."
},
"resolution": {
"type": "string",
"required": true,
"options": [
"default",
"resolves-what-remains",
"is-cancelled"
],
"description": "Use the adoption's default orphan answer, or choose the result for this case."
},
"declared-in": {
"type": "citation",
"required": true,
"description": "The Fixed game rule identifying this orphan case, when it applies, the captured payload, and the source or target requirement."
}
}
}
}
},
"rules": {
"visible-first-needs-order": {
"forbid": {
"all": [
{
"flag": {
"within-class-order": [
"no-visible-order"
]
}
},
{
"flag": {
"two-events-one-target": [
"only-first-resolves"
]
}
}
]
},
"severity": "warning",
"message": "Only-first removal needs a visible order for the colliding class; add a within-class row that decides which event reaches the target first."
}
},
"origin": "https://opengdd.org/contracts/event-resolution-1",
"mechanism": [
"This is the single normative authority for how a proposed action becomes a resolved event, how waiting events are ordered, where ties break, where an interrupt enters, and what happens to an orphan. Questions and rows supply choices and game rules; they do not define another sequence.",
"An **instant** is one moment the game treats as simultaneous. A **proposal** is an action requested by an actor. A **waiting event** has been accepted for an instant but has not begun resolving. An **active event** is currently applying its ordered effects. An **effect boundary** is a point named by a game rule at which an interrupt may enter; one exists before the event's first effect. An **orphan** is an event whose required source or target is no longer available. An **ending event** represents a possible match outcome, but its resolution records nothing. Step 15 is the sole outcome-recording step and reads final settled state: a single ending records there through the game's own cited rule, and a declared collision records through `terminal-precedence`.",
"A move through three tiles can be modelled as one effect per crossed tile edge. An overwatch shot can then name the edge where it enters. Each interrupt row carries that boundary granularity instead of leaving the decomposition implicit.",
"Turn-based games ask three of these in turn words: a tie on initiative is the same-instant question, a skipped turn is a rejected action, and a turn boundary is an instant like any other.",
"### Propose and admit",
"1. Read the proposed action against its Fixed game rules. A matching `rejection-cases` row supplies its result; otherwise apply the default `rejected-action-effect` once. `nothing-changes`, `cost-taken`, `clock-advances`, and `cost-and-clock` end the proposal without creating an event. `derate` accepts a scaled action and continues. `not-applicable` admits every proposal in this family. Repeating `nothing-changes` from the same state produces the same result because the first rejection left nothing behind. For every answer, the same proposal rejected from an identical pre-attempt state produces the same result. This idempotence is an obligation of the adoption, not a description of every observed game. 2. For an accepted action, commit its ordinary cost at the point named by its game rule. Create its event payload once. The payload captures every value that must survive later source loss; uncaptured state is read only when an effect resolves. 3. Assign every event to its declared class and due instant. Events already due when the instant opens enter its waiting set. An event created after the instant opens has one of two admission paths. A valid `interrupts` row creates an interrupt event; the interrupt entry answer governs it. Every other newly created event follows `caused-events`. The caused-event rows and their `otherwise` sentence exclude declared interrupts.",
"### Order the waiting set",
"4. Select the lowest rank among eligible waiting events. If several classes share that rank, the matching `rank-ties` row produces one total order over all events in those tied classes. A `no-visible-order` tie may use any order only because the result cannot expose it. 5. Within each class's remaining events at the selected rank, apply that class's `within-class-rules` row or the general `within-class-order` answer, and select the first event without changing its payload. Container order in the adoption file never selects an event. Where a `rank-ties` row produced one total order over the tied classes' events in step 4, that order already fixes each tied class's internal sequence; a tied class under such an order carries no `within-class-rules` row, and a reviewer rejects one as inert. 6. Apply presentation waiting to the selected event. `presentation-timing.otherwise` admits it immediately. Under `may-delay`, an unfinished cue holds that event and every event behind it in the order from steps 4–5. Under `may-delay-and-reorder`, temporarily skip only the named event and return to step 4; later eligible events may pass it. Under `never`, presentation does not hold it. A held event becomes eligible again when its cited cue finishes. The instant waits and cannot close while any presentation-held event remains. Carrying it to a later instant would invent a new game-time rule, so this branch waits instead. 7. Form any same-target collision group containing the selected event. Under `only-first-resolves`, only the first event keeps the target. Under `all-resolve-one-ending`, removal waits until the complete group resolves. Under `all-resolve-each-ending`, every event keeps its own removal consequence. A matching exception row replaces the general answer.",
"### Check the event and resolve it",
"8. Settle the same-target decision before the general orphan check. Later events suppressed by `only-first-resolves` apply nothing to that target. The other two answers keep the target available to every member of the collision group. A removal inside that group never turns another member into an orphan. Until an `all-resolve-one-ending` group ends, its target is live for non-member rules too; a non-member resolving before deferred removal therefore reads a live target. 9. Check the selected event's required source and target after its collision group is known, before its first effect, and again at every effect boundary. The matching `orphan-cases` row selects its own result or the adoption's default `orphaned-events` answer. `resolves-what-remains` skips only effects that require the missing object. `is-cancelled` removes a waiting event or discards an active event's remaining effects. This continuous gate covers a unit killed midway through a cast. A missing object outside the declared cases is an invalid adoption, not an implied result. 10. Make the selected event active and visit the boundary before its first effect. If it continues, apply effects in the order stated by its Fixed game rule. After each effect, commit that effect before reaching the next declared boundary. An ending event follows the same ordering and boundary rules, but its resolution records nothing. 11. At each boundary, discover every valid interrupt and create it through the interrupt path in step 3. When several are valid, select lowest rank first, apply the shared-rank event order when needed, then the selected class's within-class order. Under `before-next-effect`, the selected interrupt enters before the next effect, including before the first. Under `after-current-effect`, the just-finished effect remains committed. Under `at-normal-rank`, place it by the same current-or-next-instant rule as `waits-for-its-place`, then return to step 4. The active event advances only to boundaries its interrupt row permits while that interrupt waits. 12. An interrupt entering at the current boundary keeps presentation waiting, same-target collision grouping, continuous orphan checks, and its own boundaries: it passes through steps 6–11 before its result changes the interrupted event. `stop-original` discards every remaining original effect. `replace-remaining-effects` discards them and installs the complete cited replacement. Already committed effects and costs remain. The cited interrupt rule supplies a finite chain bound, and only one selected interrupt resolves at a time. A presentation skip of an interrupt returns to the interrupted event's boundary, not to step 4. 13. When an effect causes another event due now, apply `caused-events`. `resolves-now` resolves it at the current boundary before the active event continues. `waits-for-its-place` adds it to the current waiting set when its declared class is current or has not passed, otherwise to the next instant. `next-instant` always adds it to the next instant. Every route creates the caused event once and obeys the row's finite chain bound. The standard end-of-instant-sink model gives caused work one last class and drains that class to closure. 14. Finish the active event. Apply any deferred target removal required by its same-target group, record each selected consequence once, and remove the event from the waiting set. Return to step 4. If only presentation-held events remain, wait for a cited cue; a `may-delay-and-reorder` skip ends as soon as that event's cue finishes. Continue until the waiting set is empty.",
"### Settle the instant",
"15. After the waiting set is empty, the game's own cited ending rules record any single ending that holds in the final settled state; this contract does not re-derive them. Then read each `terminal-collisions` row's `win-condition` and `loss-condition` from that state. When both hold, record only the loss, only the win, or both according to `terminal-precedence`, overriding the single-ending recording for that pair. This is the only step at which a match outcome is recorded; class rank and ending-event resolution never override it. 16. Commit the instant's final state and the next-instant waiting set together. No event from the closed instant may later re-enter it. A presentation-held event never faces that rule, because step 14 forbids closure while it remains held. Presentation may continue after commitment only when its cited rule cannot change gameplay state or order.",
"Every settlement report carries the instant, event id, class, rank, tie-break when used, within-class order, source and target availability, effects applied, interrupt and replacement when present, caused-event destination, removal result, and terminal result when present."
],
"answers": {
"rejected-action-effect": "nothing-changes",
"within-class-order": "stable-index",
"terminal-precedence": "both-recorded",
"presentation-timing": "may-delay",
"two-events-one-target": "all-resolve-one-ending",
"caused-events": "resolves-now",
"interrupt-entry": "before-next-effect",
"orphaned-events": "resolves-what-remains"
},
"values": {},
"rows": {
"event-classes": [
{
"id": "card-actions",
"rank": 1,
"label": "Card actions",
"declared-in": "cards.play-card"
},
{
"id": "secrets",
"rank": 2,
"label": "Secrets",
"declared-in": "cards.secrets"
},
{
"id": "card-effects",
"rank": 3,
"label": "Card effects",
"declared-in": "cards.effects"
},
{
"id": "triggered-effects",
"rank": 4,
"label": "Triggered effects",
"declared-in": "cards.triggers"
},
{
"id": "removals",
"rank": 5,
"label": "Removals",
"declared-in": "cards.removals"
},
{
"id": "match-endings",
"rank": 6,
"label": "Match endings",
"declared-in": "cards.endings"
}
],
"within-class-rules": [
{
"id": "trigger-board-order",
"class-id": "triggered-effects",
"order": "stable-index",
"index-name": "board-position"
},
{
"id": "secrets-order",
"class-id": "secrets",
"order": "stable-index",
"index-name": "secret-play-order"
},
{
"id": "removal-order",
"class-id": "removals",
"order": "stable-index",
"index-name": "board-position"
}
],
"terminal-collisions": [
{
"id": "both-heroes-at-zero",
"win-condition": "opposing hero defeated",
"loss-condition": "own hero defeated",
"declared-in": "cards.endings"
}
],
"same-target-cases": [
{
"id": "minion-under-two-lethal-effects",
"target-kind": "minion",
"declared-in": "cards.minion-damage"
}
],
"presentation-driven-events": [
{
"id": "attack-landing",
"event-class": "card-effects",
"presentation-cue": "attack animation",
"declared-in": "cards.attack-animation"
}
],
"caused-event-kinds": [
{
"id": "defeat-trigger",
"event-class": "triggered-effects",
"declared-in": "cards.defeat-triggers"
}
],
"interrupts": [
{
"id": "counterspell-secret",
"active-class": "card-effects",
"interrupt-class": "secrets",
"boundary-granularity": "before-first-effect",
"result": "stop-original",
"declared-in": "cards.counterspell-secret"
}
],
"orphan-cases": [
{
"id": "queued-trigger-after-source-loss",
"event-class": "triggered-effects",
"missing": "source",
"resolution": "resolves-what-remains",
"declared-in": "cards.trigger-survival"
}
],
"rank-ties": [],
"rejection-cases": [],
"same-target-exceptions": []
},
"pack": "sha256:571ce2328736c902d7f553fe4b00b2a762faf451393fbf8760e9f67a3fa39f1c"
}