Solo puzzle
solo-puzzle · 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 |
|---|---|---|---|
player-moves | 1 | Player moves | puzzle.player-move |
Within class rules
within-class-rules
This adoption declares no within class rules.
Rank ties
rank-ties
This adoption declares no rank ties.
Rejection cases
rejection-cases
This adoption declares no rejection cases.
Terminal collisions
terminal-collisions
This adoption declares no terminal collisions.
Same target cases
same-target-cases
This adoption declares no same target cases.
Same target exceptions
same-target-exceptions
This adoption declares no same target exceptions.
Presentation driven events
presentation-driven-events
This adoption declares no presentation driven events.
Caused event kinds
caused-event-kinds
This adoption declares no caused event kinds.
Interrupts
interrupts
This adoption declares no interrupts.
Orphan cases
orphan-cases
This adoption declares no orphan cases.
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 tests32 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 solo-puzzle.
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
solo-puzzletreats 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
solo-puzzle-instant-trace
waiting-active-and-first-boundary
waiting and active events are distinguishable
Applies to solo-puzzle.
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
solo-puzzle-waiting-setsolo-puzzle-event-trace
ending-event-records-nothing
ending events record no outcome while resolving
Applies to solo-puzzle.
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
solo-puzzle-event-tracesolo-puzzle-ending-record
file-order-never-decides-resolution
container order never decides event resolution
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-order-tracesolo-puzzle-settlement-report
rejection-case-nothing-changes
Row.id rejects with nothing-changes
Does not apply to solo-puzzle: rejection-cases has no rows.
rejection-case-cost-taken
Row.id rejects with cost-taken
Does not apply to solo-puzzle: rejection-cases has no rows.
rejection-case-clock-advances
Row.id rejects and advances its cited clock
Does not apply to solo-puzzle: rejection-cases has no rows.
rejection-case-cost-and-clock
Row.id rejects with its cost and cited clock advance
Does not apply to solo-puzzle: rejection-cases has no rows.
rejection-case-derates-and-enters-lifecycle
Row.id accepts a scaled action
Does not apply to solo-puzzle: rejection-cases has no rows.
rejection-default-applies-without-row
the rejected-action default governs cases without rows
Applies to solo-puzzle.
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
solo-puzzle-proposal-logsolo-puzzle-cost-logsolo-puzzle-clock-trace
rejection-is-repeatable-from-identical-state
a rejected proposal is repeatable from identical state
Applies to solo-puzzle.
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
solo-puzzle-proposal-logsolo-puzzle-state-before-after
accepted-proposal-creates-one-event
an accepted proposal commits once and creates one event
Applies to solo-puzzle.
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
solo-puzzle-proposal-logsolo-puzzle-cost-logsolo-puzzle-waiting-setsolo-puzzle-event-trace
new-event-uses-one-admission-path
a new event uses the interrupt path or caused-event path
Applies to solo-puzzle.
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
solo-puzzle-proposal-logsolo-puzzle-interrupt-reportsolo-puzzle-caused-event-report
lowest-eligible-rank-resolves-first
the lowest eligible rank resolves first
Applies to solo-puzzle.
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
solo-puzzle-waiting-setsolo-puzzle-order-trace
event-class-never-passes-lower-rank · player-moves
player-moves at rank 1 never passes a lower rank
Applies to the player-moves row.
An event of player-moves 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
player-movesevent 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
player-movesevent - where no lower-rank event is eligible with
player-moves, this test asserts nothing
- the lower-rank event is selected before the
- Diagnostics
solo-puzzle-waiting-setsolo-puzzle-order-trace
within-class-stable-index
Row.class id uses stable index order
Does not apply to solo-puzzle: within-class-rules has no rows.
within-class-arrival-order
Row.class id uses stable arrival order
Does not apply to solo-puzzle: within-class-rules has no rows.
within-class-map-reading-order
Row.class id follows its cited map reading order
Does not apply to solo-puzzle: within-class-rules has no rows.
within-class-clockwise-order
Row.class id follows its cited clockwise order
Does not apply to solo-puzzle: within-class-rules has no rows.
within-class-no-visible-order
Row.class id exposes no within-class order
Does not apply to solo-puzzle: within-class-rules has no rows.
within-class-declared-random-order
Row.class id uses its cited random order
Does not apply to solo-puzzle: within-class-rules has no rows.
within-class-game-rule-order
Row.class id uses its cited game rule order
Does not apply to solo-puzzle: within-class-rules has no rows.
rank-tie-stable-index
Row.id orders its tied classes by stable index
Does not apply to solo-puzzle: rank-ties has no rows.
rank-tie-arrival-order
Row.id orders its tied classes by stable arrival
Does not apply to solo-puzzle: rank-ties has no rows.
rank-tie-map-reading-order
Row.id follows its cited map reading order
Does not apply to solo-puzzle: rank-ties has no rows.
rank-tie-clockwise-order
Row.id follows its cited clockwise order
Does not apply to solo-puzzle: rank-ties has no rows.
rank-tie-no-visible-order
Row.id exposes no shared-rank order
Does not apply to solo-puzzle: rank-ties has no rows.
rank-tie-declared-random-order
Row.id uses its cited random order
Does not apply to solo-puzzle: rank-ties has no rows.
rank-tie-game-rule-order
Row.id uses its cited game rule order
Does not apply to solo-puzzle: rank-ties has no rows.
general-within-class-order
the general within-class answer covers classes without another order
Applies to solo-puzzle.
For every class without a class row and without a shared rank, no event observes another of its class and every permitted order produces the same game state and player-facing 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
- no event observes another of its class and every permitted order produces the same game state and player-facing result
- where no such class or pair exists, this test asserts nothing
- Diagnostics
solo-puzzle-order-tracesolo-puzzle-settlement-report
presentation-never-holds-event
Row.event class never waits for Row.presentation cue
Does not apply to solo-puzzle: presentation timing is not asked for solo-puzzle.
presentation-delay-holds-following-events
Row.event class waits for Row.presentation cue without reordering
Does not apply to solo-puzzle: presentation timing is not asked for solo-puzzle.
presentation-delay-skips-only-held-event
Row.event class may be passed while Row.presentation cue is unfinished
Does not apply to solo-puzzle: presentation timing is not asked for solo-puzzle.
unnamed-event-has-no-presentation-wait
events with no presentation row wait for no cue of their own
Applies to solo-puzzle.
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
solo-puzzle-presentation-tracesolo-puzzle-order-trace
terminal-collision-rows-cover-ending-pairs
declaration check: terminal-collision rows cover every ending pair
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-recordsolo-puzzle-ending-record
same-target-rows-cover-removal-collisions
declaration check: same-target rows cover every removal collision
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-recordsolo-puzzle-collision-report
caused-event-rows-cover-due-now-causes
declaration check: caused-event rows cover every due-now cause
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-recordsolo-puzzle-caused-event-report
interrupt-rows-cover-stops-and-replacements
declaration check: interrupt rows cover every stop and replacement
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-recordsolo-puzzle-interrupt-report
same-target-general-resolution
Row.target kind uses the general collision result
Does not apply to solo-puzzle: two events one target is not asked for solo-puzzle.
same-target-exception-resolution
Row.target kind uses its collision exception
Does not apply to solo-puzzle: same-target-exceptions has no rows.
collision-precedes-orphan-check
same-target grouping precedes the orphan check
Applies to solo-puzzle.
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
solo-puzzle-collision-reportsolo-puzzle-orphan-reportsolo-puzzle-event-trace
orphan-override-resolves-what-remains
Row.id resolves what remains
Does not apply to solo-puzzle: orphan-cases has no rows.
orphan-override-is-cancelled
Row.id is cancelled
Does not apply to solo-puzzle: orphan-cases has no rows.
orphan-default-row
Row.id uses the orphan default
Does not apply to solo-puzzle: orphaned events is not asked for solo-puzzle.
undeclared-orphan-is-invalid
declaration check: an undeclared missing object has no implied result
Applies to solo-puzzle.
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
solo-puzzle-orphan-reportsolo-puzzle-declaration-record
active-event-commits-effects-in-order
an active event commits each effect before the next boundary
Applies to solo-puzzle.
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
solo-puzzle-event-tracesolo-puzzle-interrupt-report
interrupt-stops-original
Row.id enters and stops the original event
Does not apply to solo-puzzle: interrupt entry is not asked for solo-puzzle.
interrupt-replaces-remaining-effects
Row.id enters and replaces the remaining effects
Does not apply to solo-puzzle: interrupt entry is not asked for solo-puzzle.
invalid-interrupt-does-not-enter
Row.id refuses an invalid interrupt offer
Does not apply to solo-puzzle: interrupt entry is not asked for solo-puzzle.
caused-event-follows-declared-route
Row.id creates one caused event on its declared route
Does not apply to solo-puzzle: caused events is not asked for solo-puzzle.
active-event-finishes-and-loop-continues
a finished event returns resolution to the waiting set
Applies to solo-puzzle.
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
solo-puzzle-event-tracesolo-puzzle-waiting-setsolo-puzzle-collision-report
single-ending-records-after-waiting-set-empties
a single ending records from final settled state
Applies to solo-puzzle.
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
solo-puzzle-waiting-setsolo-puzzle-ending-record
terminal-collision-follows-precedence
Row.id records its selected ending result
Does not apply to solo-puzzle: terminal precedence is not asked for solo-puzzle.
instant-commits-state-and-next-waiting-set-together
the instant commits state and next-instant work together
Applies to solo-puzzle.
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
solo-puzzle-instant-tracesolo-puzzle-waiting-set
settlement-report-carries-lifecycle-fields
each settlement report carries the lifecycle record
Applies to solo-puzzle.
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
solo-puzzle, 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
solo-puzzle-settlement-report
within-class-row-class-join
declaration check: Row.class id names an existing event class
Does not apply to solo-puzzle: within-class-rules has no rows.
presentation-row-class-join
declaration check: Row.event class names an existing event class
Does not apply to solo-puzzle: presentation-driven-events has no rows.
caused-row-class-join
declaration check: Row.event class names an existing event class
Does not apply to solo-puzzle: caused-event-kinds has no rows.
orphan-row-class-join
declaration check: Row.event class names an existing event class
Does not apply to solo-puzzle: orphan-cases has no rows.
interrupt-active-class-join
declaration check: Row.active class names an existing event class
Does not apply to solo-puzzle: interrupts has no rows.
interrupt-class-join
declaration check: Row.interrupt class names an existing event class
Does not apply to solo-puzzle: interrupts has no rows.
rank-tie-rows-match-shared-ranks
declaration check: shared ranks and rank-tie rows match exactly
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-record
tied-classes-have-no-within-class-row
declaration check: tied classes have no class-specific order row
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-record
same-target-kinds-do-not-overlap
declaration check: collision cases and exceptions do not overlap
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-record
only-first-needs-visible-order
declaration check: only-first collisions have a visible order
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-record
same-target-exception-differs-from-general
declaration check: each same-target exception differs from the general answer
Does not apply to solo-puzzle: two events one target is not asked for solo-puzzle.
stable-index-second-index-duty
declaration check: stable indexes settle equal first numbers
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-record
visible-tie-needs-class-row
declaration check: visible ties have class rows when named data is needed
Applies to solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-record
rejection-default-citations-have-rows
declaration check: citing rejection defaults have rows for every case
Does not apply to solo-puzzle: 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 solo-puzzle.
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
solo-puzzleadoption 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
solo-puzzle-declaration-record
event-class-citation-states-membership · player-moves
declaration check: the citation for player-moves names its class and members
Applies to the player-moves row.
This declaration check reads the adoption and puzzle.player-move, not the running game. The citation must name player-moves, labelled Player moves 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
solo-puzzleadoption and the prose atpuzzle.player-move, not the running game- When
- a reviewer checks the citation's meaning
- Then
puzzle.player-movenamesplayer-moves, labelledPlayer movesin the game's own words, and the events belonging to it- another meaning is a defect this test fails by construction
- Diagnostics
solo-puzzle-declaration-record
within-class-grid-citation-duty
declaration check: the grid citation for Row.id supplies its order frame
Does not apply to solo-puzzle: within-class-rules has no rows.
within-class-rule-citation-duty
declaration check: the rule citation for Row.id supplies one total order
Does not apply to solo-puzzle: within-class-rules has no rows.
rank-tie-grid-citation-duty
declaration check: the grid citation for Row.id supplies its order frame
Does not apply to solo-puzzle: 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 solo-puzzle: 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 solo-puzzle: rejection-cases has no rows.
rejection-clock-citation-duty
declaration check: the clock citation for Row.id names one advance
Does not apply to solo-puzzle: rejection-cases has no rows.
presentation-cue-citation-duty
declaration check: the presentation citation for Row.id supplies a finite cue
Does not apply to solo-puzzle: presentation-driven-events has no rows.
caused-event-citation-duty
declaration check: the caused-event citation for Row.id supplies its bound
Does not apply to solo-puzzle: caused-event-kinds has no rows.
interrupt-citation-duty
declaration check: the interrupt citation for Row.id supplies its entry rule
Does not apply to solo-puzzle: interrupts has no rows.
interrupt-replacement-citation-duty
declaration check: the replacement citation for Row.id supplies every effect in order
Does not apply to solo-puzzle: interrupts has no rows.
orphan-case-citation-duty
declaration check: the orphan citation for Row.id supplies its case
Does not apply to solo-puzzle: orphan-cases has no rows.
resolution-holds
event resolution holds for the whole run
Applies to solo-puzzle.
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
solo-puzzle-instant-tracesolo-puzzle-proposal-logsolo-puzzle-order-tracesolo-puzzle-collision-reportsolo-puzzle-orphan-reportsolo-puzzle-interrupt-reportsolo-puzzle-ending-recordsolo-puzzle-settlement-reportsolo-puzzle-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": "no-visible-order"
},
"values": {},
"rows": {
"event-classes": [
{
"id": "player-moves",
"rank": 1,
"label": "Player moves",
"declared-in": "puzzle.player-move"
}
],
"within-class-rules": [],
"rank-ties": [],
"rejection-cases": [],
"terminal-collisions": [],
"same-target-cases": [],
"same-target-exceptions": [],
"presentation-driven-events": [],
"caused-event-kinds": [],
"interrupts": [],
"orphan-cases": []
},
"pack": "sha256:571ce2328736c902d7f553fe4b00b2a762faf451393fbf8760e9f67a3fa39f1c"
}