query · world.settlement

Settlement spatial executions

Returns the bounded Settlement-owned lifecycle binding selected spatial options to authoritative Building Construction, Infrastructure Construction, or Land conversion.

world.settlement.spatial-executions(filters?, cursor?, page_size?) -> query-page

Stable ID: world.settlement.spatial-executions
Owner: game.settlement
Authority: read_only
Timing: immediate
Availability: active-session
Side effects: none
Determinism: stable owner order at the current committed tick
Introduced: 1.19.0

Usage

Inspect the bounded Settlement-owned lifecycle that binds a selected spatial option to its authoritative physical owner. Supply settlement_id. The query cannot start, advance, cancel, or mutate the retained project.

Parameters

filters.settlement_id: required stable Settlement identity.
cursor: optional continuation cursor over stable execution identities.
page_size: bounded execution-row limit.

Returns

Detached execution rows with stable identity, source option and service, physical owner kind, optional owner identity, owner revision, active or terminal status, source portfolio tick, direct blocker or outcome, and creation and update ticks.

Cost

One exact Settlement lookup plus one bounded traversal of the retained spatial execution ledger. Runtime reconciliation visits only active executions under its authored budget.

Fields

ID	Type	Units	Required	Description
`created_at_tick`	`unsigned-integer`	fixed-ticks	yes	Execution creation tick.
`detail`	`string`	none	yes	Direct lifecycle, blocker, or outcome explanation.
`execution_id`	`stable-id`	none	yes	Durable spatial execution identity.
`option_key`	`string`	none	yes	Selected spatial option identity.
`owner_id`	`stable-id-or-null`	none	no	Authoritative physical owner identity.
`owner_kind`	`enumeration`	none	yes	Authoritative physical owner kind.
`owner_revision`	`revision`	none	yes	Latest authoritative owner revision.
`service`	`enumeration`	none	yes	Selected spatial service.
`settlement_id`	`stable-id`	none	yes	Settlement identity.
`settlement_revision`	`revision`	none	yes	Current Settlement owner revision.
`source_portfolio_evaluation_tick`	`unsigned-integer`	fixed-ticks	yes	Portfolio evaluation used.
`status`	`enumeration`	none	yes	Active, completed, blocked, cancelled, or failed.
`updated_at_tick`	`unsigned-integer`	fixed-ticks	yes	Latest lifecycle update tick.

Errors

Examples

local executions = world.query("world.settlement.spatial-executions", {filters = {settlement_id = 1}, page_size = 16})
for _, execution in ipairs(executions.records) do
    ui.text(execution.service, execution.status .. ": " .. execution.detail)
end

API history

1.19.0: Durable spatial execution bindings, blockers, and authoritative outcomes added for Phase 19Q6E.