Urban Decision OS · Saudi/Riyadh · decision readiness

Decision Readiness Surface

A contract-aligned illustrative readiness view across the four rule-based scoring formulas from the Engine Architecture Blueprint. Demonstration-corpus only — not production readiness.

Important

Decision readiness is not a decision and does not recommend an outcome.

Advisory only. Every consequential transition stays with a named human reviewer. This surface presents contract-aligned readiness breakdowns from a demonstration corpus — no production scoring engine is live and no automated decision is produced.

Advisory only
Human review required
Evidence-linked
No automated action

Readiness verdict

Current verdict: Reference-only · human review pending.
Reason: Evidence tokens require review; pack clearance is blocked until reviewer-of-record and source registry validation are complete.
Next human action: Assign reviewer-of-record and validate source registry.

Decision readiness board

Current readiness state
Reference-only · human review pending.
Evidence position
10 evidence tokens · 10 pending review · 1 blocked.
Allowed output
Internal review only · no recommendation.
Next human action
Assign reviewer-of-record and validate source registry.

Readiness path

RegistryCleared
Evidence tokensNeeds review
Scenario eligibilityPending
Human reviewPending
Pack clearanceBlocked

Blocking reason: pack clearance is blocked because evidence tokens and human review are not cleared.

Registry-derived summary

Source registry records

Evidence tokens (curated)

Pending human review

Blocked (UI state)

Readiness distribution

A — Decision-support ready
0
Pack complete; senior reviewer concurrence required before any executive review hand-off.
Allowed UI
Surfaced with senior concurrence and the fixed disclaimer.
Review required
Senior reviewer concurrence required.
B — Usable with caution
0
Case reviewer + senior reviewer working the pack; caveats remain attached.
Allowed UI
Surfaced in case-review pack with explicit caveats and the fixed disclaimer.
Review required
Case + senior reviewer must work the pack.
C — Reference-only · needs more review
9
Reference posture; cannot advance until provenance gaps close.
Allowed UI
Reference-only on evidence surfaces with limitation list and the fixed disclaimer.
Review required
Reviewer attention; gaps must close before advance.
D — Blocked from decision layer
1
Blocked by governance lock or missing-source caveat; never an enforcement output.
Allowed UI
Blocked UI state with explicit blocking reason; never advanced.
Review required
Governance escalation; token may not enter review pack.

Why not cleared · blockers

Pack clearance is blocked until the items below are resolved. Each is a human gate, not a missing model output.

Reviewer-of-record pending assignment for the demonstration corpus.
Source registry validation incomplete — capture dates and provenance pending.
Evidence diversity across required signal classes not yet confirmed by reviewer.
No band advancement until reviewer note is recorded.

Output gate

No executive brief, registry export, buyer pack, or scenario output is enabled from this surface.

Executive brief PDF
Locked until reviewer-cleared.
Registry CSV export
Locked until metadata complete.
Buyer-pack PDF
Locked until gold-set concurrence.
Scenario recommendation output
Not produced — advisory posture only.

Score contracts, evidence tokens, scenarios, and reviewer prompts remain available for audit review.

Audit details · score contract, evidence tokens, scenarios, reviewer promptsExpand audit

Expand to read the score contract, the per-token readiness table, scenario eligibility cross-reference, reviewer prompts, structural invariants, and companion surfaces.

Score-contract explainers

Purpose
Evidence Quality Score
Per-token rule-based composition of source reliability, metadata completeness, geo / time fit, reproducibility, and governance safety.
Scope · Per Evidence Token
- Source Reliability0.25
- Metadata Completeness0.20
- Geo Fit0.20
- Time Fit0.15
- Reproducibility0.10
- Governance Safety0.10
Current status
Demonstration corpus — no production scoring engine live. Banded qualitative readiness only.
Limiting factors
Every token defaults to confidence band pending; capture date / license / lineage fields render the canonical Source registry validation pending sentinel rather than an inferred value.
Next human action
Reviewer of record verifies source completeness and records concurrence per token before advancing the case band.
Governance caveat
No automated decision. The literal-typed boundary `automated_decision: false` is enforced at the score-output type.
Purpose
Relationship Score
Per-token-pair rule-based composition of spatial proximity, temporal alignment, semantic similarity, source complementarity, and decision relevance.
Scope · Per token pair / per-case relationship graph
- Spatial Proximity0.30
- Temporal Alignment0.20
- Semantic Similarity0.20
- Source Complementarity0.15
- Decision Relevance0.15
Current status
Demonstration corpus — no production scoring engine live. Banded qualitative readiness only.
Limiting factors
Every token defaults to confidence band pending; capture date / license / lineage fields render the canonical Source registry validation pending sentinel rather than an inferred value.
Next human action
Reviewer reads relationships across the case's tokens; the engine never picks a winner among contradictory tokens.
Governance caveat
No automated decision. The literal-typed boundary `automated_decision: false` is enforced at the score-output type.
Purpose
Decision Readiness Score
Per-case composite. Governance Safety is dominant — a red value forces the composite band to D.
Scope · Per case
- Evidence Quality Average0.30
- Evidence Diversity0.20
- Relationship Strength0.20
- Governance Safety0.15
- Human Review Status0.15
Current status
Demonstration corpus — no production scoring engine live. Banded qualitative readiness only.
Limiting factors
Every token defaults to confidence band pending; capture date / license / lineage fields render the canonical Source registry validation pending sentinel rather than an inferred value.
Next human action
Senior reviewer concurrence is required before any executive review hand-off, irrespective of computed band.
Governance caveat
No automated decision. The literal-typed boundary `automated_decision: false` is enforced at the score-output type.
Purpose
Scenario Priority Score
Per scenario × case. Surfaces reviewer-ordering signal only — never a binding cohort assignment.
Scope · Per scenario × case
- Change Intensity0.25
- Infrastructure Proximity0.20
- Population / Activity Signal0.15
- Municipal Relevance0.20
- Evidence Readiness0.20
Current status
Demonstration corpus — no production scoring engine live. Banded qualitative readiness only.
Limiting factors
Every token defaults to confidence band pending; capture date / license / lineage fields render the canonical Source registry validation pending sentinel rather than an inferred value.
Next human action
Senior reviewer confirms scenario eligibility before any review-priority elevation surfaces to the reviewer cohort.
Governance caveat
No automated decision. The literal-typed boundary `automated_decision: false` is enforced at the score-output type.

Evidence-token readiness

Token ID	Evidence class	Readiness	Confidence band	UI state	Review status	Zone
tok.usgs.core.context	imagery	C	pending	candidate	unreviewed	Riyadh core (illustrative)
tok.usgs.east.context	imagery	C	pending	candidate	unreviewed	Riyadh east (illustrative)
tok.usgs.north.context	imagery	C	pending	candidate	unreviewed	Riyadh north (illustrative)
tok.usgs.south.context	imagery	C	pending	candidate	unreviewed	Riyadh south (illustrative)
tok.usgs.west.context	imagery	C	pending	candidate	unreviewed	Riyadh west (illustrative)
tok.saudi.balady.surface	surface	C	pending	reference_only	unreviewed	—
tok.rega.market.signal	overlay	C	pending	reference_only	unreviewed	—
tok.gastat.national.signal	statistical	C	pending	reference_only	unreviewed	—
tok.pack.metadata.completeness	metadata	D	pending	blocked	unreviewed	—
tok.governance.note	governance_note	C	pending	reference_only	unreviewed	—

Scenario eligibility preview

Scenario eligibility preview
Urban Growth Pressure
Required evidence
Imagery (before / after) · municipal surface · national statistics.
Output shape
Qualitative effect statement: review attention warranted / not warranted.
Caveat
Illustrative only — not a forecast, not a recommendation, not a physical model, not production simulation.
Human review
Reviewer reads the rationale and accepts or escalates; scenario never advances a case on its own.
Scenario eligibility preview
Infrastructure Load Sensitivity
Required evidence
Infrastructure-proximity context · municipal surface · governance note.
Output shape
Qualitative sensitivity flag: elevated / standard reviewer attention.
Caveat
Illustrative only — not a forecast, not a recommendation, not a physical model, not production simulation.
Human review
Senior reviewer attention if priority is elevated; case reviewer otherwise.
Scenario eligibility preview
Municipal Review Priority
Required evidence
Municipal surface · governance note · current case state.
Output shape
Reviewer ordering signal — qualitative only; never numeric.
Caveat
Illustrative only — not a forecast, not a recommendation, not a physical model, not production simulation.
Human review
Senior reviewer confirms priority elevation before any pack advance.
Scenario eligibility preview
Market / Development Signal
Required evidence
REGA market signal (public-source-informed) · municipal surface · imagery before / after.
Output shape
Qualitative market-context flag for reviewer consideration.
Caveat
Illustrative only — not a forecast, not a recommendation, not a physical model, not production simulation.
Human review
Reviewer reads context as one input among many; never the sole driver.
Scenario eligibility preview
Governance Readiness Gap
Required evidence
Governance note · metadata-completeness token · pack-level audit trace.
Output shape
Qualitative gap flag: governance gap blocks advancement / posture clear.
Caveat
Illustrative only — not a forecast, not a recommendation, not a physical model, not production simulation.
Human review
Senior reviewer escalation when gap is red; case reviewer attention when amber.

Human review

State

Current state: reviewer-of-record pending assignment for the demonstration corpus.

Human review is structurally required on every score output. The literal-typed boundary `human_review_required: true` is enforced at the type system level; no code path advances a case past this boundary without a reviewer-initiated transition.

Next human actions

Verify source completeness for each evidence token.
Review governance caveats and resolve or attach reviewer note.
Confirm evidence diversity across required signal classes.
Record reviewer note before any band advancement.

human_review_required: trueautomated_decision: false

Dynamic interaction overview

Important

Dynamic interaction is a traceable cross-reference view only. It does not create a forecast, recommendation, decision, approval, enforcement action, or production simulation.

Cross-references this readiness surface to the Scenario Preview Surface. Every relation below is a static projection of the registry — never a forecast, never a recommendation.

Scenario → evidence basis cross-reference

urban-growth-pressure · Urban Growth Pressure
Related evidence tokens
tok.usgs.core.context · tok.usgs.east.context · tok.usgs.north.context · tok.usgs.south.context · tok.usgs.west.context · tok.saudi.balady.surface · tok.gastat.national.signal
Blocking evidence tokens
—
Reviewer: confirm at least three evidence classes (imagery / surface / statistical) are present at confidence ≥ low before this scenario is cited in a review pack.
infrastructure-load-sensitivity · Infrastructure Load Sensitivity
Related evidence tokens
tok.saudi.balady.surface · tok.rega.market.signal
Blocking evidence tokens
—
Reviewer: confirm an infrastructure-class token at confidence ≥ medium is paired with a municipal-surface token in the same zone before this scenario is cited.
municipal-review-priority · Municipal Review Priority
Related evidence tokens
tok.saudi.balady.surface · tok.governance.note
Blocking evidence tokens
—
Senior reviewer: confirm a municipal-governance token plus an explicit case-state record exist in the audit trace before priority elevation.
market-development-signal · Market / Development Signal
Related evidence tokens
tok.usgs.core.context · tok.usgs.east.context · tok.usgs.north.context · tok.usgs.south.context · tok.usgs.west.context · tok.saudi.balady.surface · tok.rega.market.signal
Blocking evidence tokens
—
Reviewer: confirm the REGA market-signal token is corroborated by at least one municipal-surface or imagery token in the same zone before this scenario is cited.
governance-readiness-gap · Governance Readiness Gap
Related evidence tokens
tok.governance.note
Blocking evidence tokens
tok.pack.metadata.completeness
Senior reviewer: when the gap is red, escalate before any other scenario is cited; when amber, attach a reviewer note to the audit trace.

Evidence token → scenario cross-reference

tok.usgs.core.context · imagery · band C · conf pending · candidate
Related scenarios:urban-growth-pressure · market-development-signal
Reviewer: verify the imagery token's capture-date provenance via the source registry before citing it in a review pack.
tok.usgs.east.context · imagery · band C · conf pending · candidate
Related scenarios:urban-growth-pressure · market-development-signal
Reviewer: verify the imagery token's capture-date provenance via the source registry before citing it in a review pack.
tok.usgs.north.context · imagery · band C · conf pending · candidate
Related scenarios:urban-growth-pressure · market-development-signal
Reviewer: verify the imagery token's capture-date provenance via the source registry before citing it in a review pack.
tok.usgs.south.context · imagery · band C · conf pending · candidate
Related scenarios:urban-growth-pressure · market-development-signal
Reviewer: verify the imagery token's capture-date provenance via the source registry before citing it in a review pack.
tok.usgs.west.context · imagery · band C · conf pending · candidate
Related scenarios:urban-growth-pressure · market-development-signal
Reviewer: verify the imagery token's capture-date provenance via the source registry before citing it in a review pack.
tok.saudi.balady.surface · surface · band C · conf pending · reference_only
Related scenarios:urban-growth-pressure · infrastructure-load-sensitivity · municipal-review-priority · market-development-signal
Reviewer: confirm the municipal-surface token is treated as a public-source-informed reference, not an official zoning classification.
tok.rega.market.signal · overlay · band C · conf pending · reference_only
Related scenarios:infrastructure-load-sensitivity · market-development-signal
Reviewer: confirm the overlay token is treated as aggregate public-source context; no per-property identifier and no ownership inferred.
tok.gastat.national.signal · statistical · band C · conf pending · reference_only
Related scenarios:urban-growth-pressure
Reviewer: confirm the statistical token is treated as aggregate national-statistics context; no per-citizen identifier and no profiling.
tok.pack.metadata.completeness · metadata · band D · conf pending · blocked
Related scenarios:—
Reviewer: when pack-level metadata is blocked, complete per-asset provenance review before any scenario preview cites the pack.
tok.governance.note · governance_note · band C · conf pending · reference_only
Related scenarios:municipal-review-priority · governance-readiness-gap
Reviewer: read the governance note as an internal canonical boundary; never publish it as an institutional finding.

Readiness band → scenario eligibility crosswalk

Band A — ready for executive review
Eligible scenarios
urban-growth-pressure · infrastructure-load-sensitivity · municipal-review-priority · market-development-signal · governance-readiness-gap
Blocked scenarios
—
Reason:All five scenario categories are eligible to surface at this band; selection still requires reviewer confirmation.
Reviewer action:Reviewer confirms the eligible scenario set before any scenario preview is cited in an executive brief.
Band B — usable with caution, review required
Eligible scenarios
urban-growth-pressure · infrastructure-load-sensitivity · municipal-review-priority · market-development-signal · governance-readiness-gap
Blocked scenarios
—
Reason:All five scenario categories are eligible with caution; the reviewer reads the rationale and accepts or escalates.
Reviewer action:Reviewer reads the per-scenario rationale and accepts or escalates; no automated transition.
Band C — reference only, needs more evidence
Eligible scenarios
urban-growth-pressure · infrastructure-load-sensitivity · municipal-review-priority · market-development-signal · governance-readiness-gap
Blocked scenarios
—
Reason:All scenario categories whose readiness floor is band C remain eligible; senior-attention scenarios require band B for elevated priority.
Reviewer action:Reviewer attaches missing-evidence notes before the case advances; scenario preview cannot override the band.
Band D — blocked from the decision layer
Eligible scenarios
governance-readiness-gap
Blocked scenarios
urban-growth-pressure · infrastructure-load-sensitivity · municipal-review-priority · market-development-signal
Reason:Decision layer is blocked at band D; only the Governance Readiness Gap scenario surfaces, because it flags platform-internal gaps rather than case readiness.
Reviewer action:Senior reviewer escalation: resolve the governance gap or per-asset provenance gap before any scenario other than the Governance Readiness Gap is cited.

Governance blockers

token-blocked-tok.pack.metadata.completeness
Token: tok.pack.metadata.completeness
Why it blocks:Token is at ui_state `blocked` until provenance review completes. Affected scenarios cannot read this token as part of their evidence basis until the reviewer-of-record clears the block.
Affected scenarios:governance-readiness-gap
Reviewer action:Senior reviewer: complete per-asset provenance review for the underlying source and re-classify the token before any cited scenario consumes it.

Human review actions

Scenario: Urban Growth Pressure
Reviewer role:Case reviewer
Prompt:Reviewer: confirm at least three evidence classes (imagery / surface / statistical) are present at confidence ≥ low before this scenario is cited in a review pack.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Scenario: Infrastructure Load Sensitivity
Reviewer role:Case reviewer
Prompt:Reviewer: confirm an infrastructure-class token at confidence ≥ medium is paired with a municipal-surface token in the same zone before this scenario is cited.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Scenario: Municipal Review Priority
Reviewer role:Senior reviewer
Prompt:Senior reviewer: confirm a municipal-governance token plus an explicit case-state record exist in the audit trace before priority elevation.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Scenario: Market / Development Signal
Reviewer role:Case reviewer
Prompt:Reviewer: confirm the REGA market-signal token is corroborated by at least one municipal-surface or imagery token in the same zone before this scenario is cited.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Scenario: Governance Readiness Gap
Reviewer role:Senior reviewer
Prompt:Senior reviewer: when the gap is red, escalate before any other scenario is cited; when amber, attach a reviewer note to the audit trace.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Token: tok.usgs.core.context
Reviewer role:Case reviewer
Prompt:Reviewer: verify the imagery token's capture-date provenance via the source registry before citing it in a review pack.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Token: tok.usgs.east.context
Reviewer role:Case reviewer
Prompt:Reviewer: verify the imagery token's capture-date provenance via the source registry before citing it in a review pack.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Token: tok.usgs.north.context
Reviewer role:Case reviewer
Prompt:Reviewer: verify the imagery token's capture-date provenance via the source registry before citing it in a review pack.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Token: tok.usgs.south.context
Reviewer role:Case reviewer
Prompt:Reviewer: verify the imagery token's capture-date provenance via the source registry before citing it in a review pack.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Token: tok.usgs.west.context
Reviewer role:Case reviewer
Prompt:Reviewer: verify the imagery token's capture-date provenance via the source registry before citing it in a review pack.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Token: tok.saudi.balady.surface
Reviewer role:Case reviewer
Prompt:Reviewer: confirm the municipal-surface token is treated as a public-source-informed reference, not an official zoning classification.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Token: tok.rega.market.signal
Reviewer role:Case reviewer
Prompt:Reviewer: confirm the overlay token is treated as aggregate public-source context; no per-property identifier and no ownership inferred.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Token: tok.gastat.national.signal
Reviewer role:Case reviewer
Prompt:Reviewer: confirm the statistical token is treated as aggregate national-statistics context; no per-citizen identifier and no profiling.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Token: tok.pack.metadata.completeness
Reviewer role:Senior reviewer
Prompt:Reviewer: when pack-level metadata is blocked, complete per-asset provenance review before any scenario preview cites the pack.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.
Token: tok.governance.note
Reviewer role:Case reviewer
Prompt:Reviewer: read the governance note as an internal canonical boundary; never publish it as an institutional finding.
No automated transition. Scenario preview and decision readiness never advance a case on their own.
Record a reviewer note before any cross-reference is cited in a review pack.

Structural invariants

human_review_required: trueautomated_decision: false

Projection computed at: 2026-06-14T13:12:19.335Z · Source blueprint: docs/architecture/urban_decision_intelligence_engine_architecture_blueprint_v1.md#13

Companion surfaces