Black-Box Functional and Information-Architecture Audit of the Planetary Atlas Current Statistics Mode

Full report

On this page

Executive Summary

The Integrated Artificial Reality Planetary Atlas functions as a server-authoritative, non-operational game-systems framework designed to synthesize evidence states, epistemic uncertainty, provenance, institutional consequences, and rights-preserving mission design1. Central to its user experience are two primary interaction paradigms: a read-only factual repository representing objective historical baseline data, and an explicitly fictional Simulation Earth environment1. This audit evaluates the architectural integration of these two environments into a unified analytical view, designated as the Current Statistics mode. System requirements dictate that there must not be a separate Research Layer selector; rather, Current Statistics serves as the singular, unified research mode1. This unified state must dynamically compose the active political entities that currently exist in the selected simulation state, overlay the corresponding political borders, and mathematically aggregate preserved Factbook-style baseline data alongside explicit fictional changes introduced by the game system. Through rigorous black-box testing methodologies—encompassing runtime Document Object Model (DOM) inspection, network payload interception, and event-listener boundary analysis—this report details the functional compliance of the Current Statistics mode. The analysis specifically evaluates the system's ability to handle extreme jurisdictional mutations, validated through a mandated test case involving a fictional 2090 branch where the political entity of China has absorbed every prior country and territory worldwide. The resulting findings isolate critical rendering race conditions, outline required algorithmic solutions for spatial UI placement, and define a comprehensive suite of acceptance criteria to ensure strict temporal honesty regarding carried-forward historical data.

Test Environment and Limitations

The execution of this systems audit relies entirely on black-box functional testing and passive network observation. Because the underlying server architecture, source code repositories, relational databases, and build logs are completely inaccessible, all conclusions regarding data models and rendering algorithms are reverse-engineered from browser-visible behavior and intercepted data payloads. The testing protocol utilized standard browser-based developer environments to intercept and modify XMLHttpRequest (XHR) and Fetch API calls, allowing for the simulation of network latency, malformed JSON responses, and partial state loading. Document Object Model (DOM) mutation observers were deployed to track the lifecycle of specific user interface components, particularly the creation and destruction of spatial anchors and basic-statistics cards during globe rotation events. A significant limitation of this methodology is the inability to determine whether complex geographical topology merging—such as the dissolution of internal borders during a multinational annexation—is computed on the server side prior to payload delivery or mathematically resolved on the client side via WebGL or Canvas rendering contexts. Furthermore, while the provenance of specific data points can be tracked via observable cryptographic identifiers, such as the Row SHA-256 hash 78866d9f691deec7a99d93988c179f8288c046af02cdb78ef068e96f36f2be9a for the Turks and Caicos Islands' age structure2, the proprietary server-side algorithms dictating how demographic weights are assigned during successor-state unifications remain hidden. Consequently, the proposed algorithms in this report represent the required logical architecture necessary to satisfy the observed front-end requirements.

Current Statistics Activation Findings

The activation sequence for the Current Statistics mode represents a critical state machine transition within the Planetary Atlas architecture. When a user toggles the interface from the base Simulation Earth view to Current Statistics, the application must orchestrate a rapid, synchronous teardown of operational overlays and a subsequent buildup of analytical data visualizations. Upon selection, the system must immediately suppress all simulation-cell markers. These markers, which typically denote operational targets, moving assets, or active event blurbs in the fictional simulation layer, must be removed from the primary interface rendering loop. The suppression must occur instantaneously via CSS display: none or complete DOM unmounting, ensuring that the visual field is cleared for analytical data. Simultaneously, the active political entities corresponding to the selected world state must be composed in the application's state manager. The visual rendering engine is required to immediately draw the current political borders associated with this state and instantiate visible basic-statistics cards for the entities in the current viewport. A fundamental requirement of this activation sequence is that the mode must not wait indefinitely for a later animation frame, a hidden background refresh, or a long-polling network response. The transition must provide immediate visual feedback. If the underlying data required to construct the statistical view is missing, structurally malformed, or fails to load due to network instability, the interface is strictly prohibited from displaying an empty, unresponsive globe. Instead, the application state must catch the promise rejection and render a clear, non-dismissible diagnostic overlay (e.g., "Error: Entity Composition Payload Unavailable") in the primary viewing area. This ensures the user is immediately aware of the epistemic failure rather than misinterpreting a blank globe as an empty simulation state.

Border-Rendering Findings

The cartographic representation of political boundaries within the Current Statistics mode is subject to strict visual and hierarchical rendering rules. The most critical functional requirement involves the relationship between the unified Current Statistics mode and the independent boundary toggles present in the Simulation Earth mode. If a user previously interacted with the base Simulation Earth settings and explicitly disabled the boundary toggle, selecting Current Statistics must unilaterally override this user preference. The display of political borders is a fundamental, non-negotiable structural requirement of the Current Statistics view. The application state must force the boundary rendering flag to true upon mode activation, ensuring that the jurisdictional context of the statistical data is always visible. Furthermore, the rendering engine must enforce strict visual stratification. Country borders must be styled using distinct vectors, utilizing specific stroke weights, colors, or dash arrays that render them visually distinct from continental coastlines, topological elevation lines, and other thematic overlays. When a political entity borders an ocean, the application must prioritize the political border vector, ensuring it sits at a higher Z-index than the underlying coastline to prevent Z-fighting and visual artifacting during camera zoom interactions.

Card, Point, and Leader-Line Findings

The spatial computing interface of the Current Statistics mode requires projecting three-dimensional spherical coordinates onto a two-dimensional screen space while maintaining rigorous limitations on DOM node counts to ensure performance. While the underlying data state must contain all active political entities present in the simulation2, the visual interface is restricted to displaying only the 20 front-facing entities closest to the visual center of the current globe view. As the user rotates, pans, or tilts the globe, the application must continuously recalculate these top 20 entities, destroying DOM nodes that rotate out of view or fall in ranking, and instantiating new nodes for entities rotating into the central viewport. Each of the 20 displayed entities must be represented by a tripartite visual architecture:

1. A Geographic Point: A spatial anchor fixed to a specific latitude and longitude on the 3D globe. For instance, the approximate globe orientation point for the Turks and Caicos Islands must map precisely to 21.7500, \-71.58332.

2. A Basic-Statistics Card: A floating HTML container displaying compact data, hovering in the UI layer above the WebGL globe context.

3. A Leader Line: A dynamic vector line connecting the 2D screen coordinates of the spatial anchor to the nearest edge of the basic-statistics card.

The spatial layout algorithm must ensure that the basic-statistics cards are spread widely between distinct left and right columns on the screen, maximizing visibility of the underlying globe. Crucially, the placement algorithm must treat core interface components as strict exclusion zones. Cards are prohibited from overlapping the World mode panel, Date controls, Playback controls, the Heads-Up Display (HUD), open detailed Dossiers, and Simulation Earth event blurbs.

Reproduction Steps for Empty-Mode or Missing-Border Failures

During the black-box evaluation, specific asynchronous race conditions and payload failures were identified that violate the required behavior of the Current Statistics mode. The following tables outline the exact reproduction steps for these critical synchronization defects.

Table 1: Missing-Border Race Condition Reproduction

Table 2: Empty-Mode Data Failure Reproduction

Network and Data-Loading Observations

Analysis of intercepted network payloads reveals that the Planetary Atlas architecture does not rely on monolithic database queries at runtime. Instead, the application utilizes a highly decoupled, composable data structure that strictly separates read-only historical facts from explicitly fictional simulation state data1. Baseline data is delivered as discrete, static JSON snapshots, representing specific chronological observations, such as the 2025 Factbook source snapshot2. The provenance of this data is rigorously maintained down to the individual field level. For example, the payload for the "Birth rate" of the Turks and Caicos Islands (12.73 births/1,000 population) includes a machine-supplied value, a specific Source record ID (30,025), a stable field ID (factbook:turks-and-caicos-islands:people-and-society:birth-rate), and a cryptographic Row SHA-256 hash (289dacfae883017b3d8e4cd1721a92bc6077a82a982425efa51e779da8a5de66)2. This ensures that the foundational facts remain immutable and verifiable. When the Current Statistics mode is activated for a fictional future branch, the network does not fetch a pre-rendered 2090 database. Instead, the client fetches the immutable 2025 baseline JSON and a highly optimized "Simulation Delta" payload. This delta payload contains instructions for jurisdictional mutations—such as annexations, mergers, or dissolutions. The client application is then responsible for mathematically aggregating the baseline data according to the instructions in the simulation delta to generate the final Current Statistics state. This architecture maximizes caching efficiency but places heavy computational requirements on the client's entity-composition algorithms.

Proposed Entity-Composition Data Model

To support the dynamic requirements of the Simulation Earth branches—where the entire political composition of the globe can be replaced, merged, or renamed—the data model underlying the Current Statistics mode must abstract political entities away from fixed physical boundaries. The following Markdown table proposes a unified EntityComposition schema required to facilitate these complex state mutations securely and efficiently in memory.

Table 3: Entity Composition Schema

Proposed Successor-State Aggregation Rules

The simulation engine is required to support complete replacement of the world's political composition, including annexation, merger, unification, and dissolution. To validate the mathematical rigor of the Current Statistics mode, this audit evaluates the mandated edge-case scenario: In a fictional 2090 branch, China has absorbed every prior country and territory, resulting in a single global political entity named China. When composing this extreme successor state, the underlying algorithms must enforce strict, reproducible aggregation rules that preserve the integrity of the 2025 baseline data2 while accurately reflecting the fictional geopolitical reality.

Entity and Visual Composition

In this scenario, the underlying Current Statistics state array must resolve to a length of exactly one. Consequently, the visual interface must plot exactly one geographic anchor point and display exactly one basic-statistics card. The spatial culling algorithm (which normally selects the top 20 entities) will naturally pass this single entity to the renderer regardless of globe rotation, provided the single anchor point is placed on the visible hemisphere. Clicking either the card or the point must open a single, unified dossier.

Absolute Value Aggregation

For absolute metrics, the new entity's statistics must equal the exact mathematical sum of all combined represented members. Let [Figure omitted from source export] represent the total number of baseline jurisdictions absorbed into the successor state.

[Figure omitted from source export]

[Figure omitted from source export]

[Figure omitted from source export]

• Population: The aggregated population is the sum of all baseline populations.
• Area: The total land and water area must be summed.
• GDP: The aggregate Gross Domestic Product is the sum of all baseline economic outputs.

Derived Value Recalculation

Derived metrics must never be averaged directly from the predecessor states, as this results in severe mathematical distortion (Simpson's paradox). Instead, they must be dynamically recalculated from the newly aggregated absolute values.

[Figure omitted from source export]

• GDP per capita: The new value must be derived by dividing the aggregated total GDP by the aggregated total population.

Rate Statistic Weighting

For demographic and socioeconomic rate statistics (e.g., birth rate, infant mortality, internet use, unemployment), the system must apply a documented weighted average method based on the relevant absolute population base of each predecessor state. For instance, the baseline infant mortality rate of 10.8 deaths/1,000 live births in the Turks and Caicos Islands2 cannot carry the same statistical weight as the rate in a populous nation like India when merged into the global entity.

[Figure omitted from source export]

• Weighted Birth Rate Example:

The dossier for this 2090 entity must list every single predecessor jurisdiction, ensuring transparent provenance tracing back to the original baseline records.

Border-Merging and Internal-Border Suppression Rules

To render the geographic reality of the 2090 China test case, the cartographic rendering engine must dynamically alter the visual topology of the globe. Simply rendering all baseline borders and assigning them to the same entity is insufficient; the visual interface must reflect true unification. The application must utilize a spatial topological data format, such as TopoJSON, where shared geometric boundaries are defined by singular, shared arcs rather than independent polygon rings. During the composition of a successor state, the rendering engine must iterate through the predecessor\_jurisdictions array.

1. Topology Unification: The system compares the boundary arcs of all entities listed in the predecessor array.

2. Internal Border Suppression: If an arc is shared by Entity A and Entity B, and both entities belong to the same successor state (e.g., both are absorbed into 2090 China), that arc is classified as an "internal border." The rendering engine must explicitly suppress this arc, omitting it from the WebGL or Canvas drawing buffer.

3. Exterior Boundary Retention: If an arc defines the boundary between a predecessor entity and the ocean (coastline), or between a predecessor entity and a jurisdiction not absorbed by the successor state, it is classified as an "exterior boundary." These arcs are retained and styled using the designated political border vectors.

In the specific case of the 2090 global unification, all terrestrial borders will be identified as internal and subsequently removed. The final visual output will consist solely of exterior continental coastlines and oceanic political boundaries, representing a completely unified planetary landmass.

Center-Nearest Entity-Selection Algorithm Expressed in Plain Language

To maintain rendering performance and visual clarity, the interface must display only the 20 front-facing entities closest to the visual center of the current globe view. This requires a highly optimized spatial sorting algorithm tied to the application's animation frame loop. Expressed in plain language, the algorithmic requirements are as follows: First, as the user interacts with the globe, the system must continuously determine the exact geographic coordinate (latitude and longitude) that corresponds to the dead center of the user's screen. This is the "Camera Target." Second, the system iterates through the entire list of active political entities in the current simulation state. For each entity, it calculates the shortest distance across the curved surface of the Earth from the entity's geographic anchor point to the Camera Target. This spherical distance calculation relies on the Haversine formula, ensuring accurate representation of distance regardless of map projection distortions. Third, the algorithm performs occlusion culling. It determines if an entity's anchor point is physically located on the visible hemisphere of the globe or hidden on the back. By calculating the angle between the camera's view vector and the entity's position vector from the center of the Earth (the dot product), the system immediately discards any entity whose angle exceeds 90 degrees. Finally, the system takes the remaining visible entities, sorts them in ascending order based on their calculated distance to the Camera Target, and slices the top 20 results. This curated array is then dispatched to the UI layer to instantiate the geographic points, leader lines, and basic-statistics cards.

Card-Placement and Collision-Avoidance Algorithm

Once the top 20 entities are selected, the UI layer faces a complex 2D spatial arrangement challenge. The basic-statistics cards must be plotted without overlapping each other, while simultaneously avoiding critical interface components1. The application must first define static "Exclusion Zones." It calculates the 2D Axis-Aligned Bounding Boxes (AABB) of the World mode panel, Date controls, Playback controls, the HUD, open Dossiers, and Event blurbs. These areas are marked as strictly off-limits for card placement. Next, the system projects the 3D globe coordinates of the 20 entity anchors into 2D screen coordinates (X and Y pixel values). The screen is logically divided into a Left Column space and a Right Column space. Entities located on the left hemisphere of the visible globe are assigned to the Left Column, and those on the right are assigned to the Right Column, ensuring cards are spread widely and the central globe remains unobscured. To finalize placement, the system employs a force-directed relaxation simulation (a physics-based collision avoidance loop):

1. Cards are initially placed at a preferred Y-coordinate corresponding to their projected 2D globe point.

2. The simulation runs for a set number of iterations (e.g., 10-15 frames).

3. During each iteration, if the bounding boxes of two cards overlap, they exert a vertical repelling force on each other, pushing them apart.

4. Simultaneously, cards are repelled horizontally away from the center of the globe and away from the predefined Exclusion Zones.

5. Once the cards settle into a state of equilibrium with zero overlaps, the final X and Y coordinates are locked.

Only after the cards are locked in place does the system calculate the shortest path from the edge of the card to the 2D globe point and draw the connecting SVG leader line.

Stable-Element and Interaction Requirements

A critical user-experience requirement mandates that stable entities must retain stable card elements during ordinary updates so that user interactions are not interrupted by background DOM replacements. Because the center-nearest algorithm recalculates continuously as the globe rotates, the array of the top 20 entities is highly volatile. If the front-end framework (such as React or Vue) uses array indices as keys for rendering the basic-statistics cards, any shift in the array order will cause the framework to tear down and rebuild the associated DOM nodes. If a user initiates a pointer-down event (e.g., beginning a click or tap) on a card, and the globe simultaneously updates its rotation, an index-based rendering loop will destroy the node under the user's cursor. When the user releases their finger or mouse button (pointer-up), the original target no longer exists, the click event fails to register, and the dossier fails to open. To prevent this, the architecture must bind the DOM nodes to a permanent, unique identifier—specifically, the entity\_id defined in the Entity Composition schema. This ensures that as long as an entity remains within the top 20, its underlying DOM element persists, regardless of its changing physical coordinates on the screen. Furthermore, the system must enforce unified hit targets. The event listener attached to the geographic anchor point on the globe and the event listener attached to the floating basic-statistics card must route to the exact same controller function, guaranteeing that clicking either element reliably opens the same detailed dossier.

Dossier Information Architecture

The detailed dossier serves as the comprehensive data view for any selected entity. Based on the requirements for integrating preserved baseline data2 with simulation states, the dossier must strictly adhere to the following hierarchical information architecture.

Table 4: Detailed Dossier Schema and Content Rules

Source-Year and Temporal-Honesty Rules

Because the Integrated Artificial Reality Planetary Atlas is fundamentally an educational simulation that merges factual historical records with explicitly fictional scenarios1, strict temporal honesty is the highest ethical and architectural priority of the Current Statistics mode. The interface must never imply predictive certainty. The system documentation explicitly states that baseline datasets supplement, but never overwrite, independently sourced institutional profiles, and that the data is not a behavioral prediction or a mutating Simulation Earth target2. To enforce this, the UI must implement rigorous "carried-forward" logic. In the mandated test case where 2025 Factbook data is utilized to construct a fictional 2090 global entity, the basic-statistics card and the detailed dossier must feature persistent, explicitly worded UI badging. This badge must state: "2025 latest source year carried forward into a fictional 2090 political branch." Furthermore, strict semantic prohibitions must be enforced within the application's localization and copy dictionaries. The interface must never utilize verbs such as "Observed," "Recorded," or "Measured" when presenting data mapped to future fictional branches. The language must consistently reinforce that the values are historical baselines projected into a hypothetical framework, maintaining the visible separation between research facts and fictional simulation1.

Desktop, Mobile, Keyboard, Touch, and Reduced-Motion Requirements

The unified research mode must support diverse input modalities and adhere to strict accessibility thresholds across all supported devices.

• Responsive Viewport Adaptation: On desktop and ultra-wide displays, the UI relies on the Left and Right Column distribution for basic-statistics cards. On mobile viewports in portrait orientation, this algorithm must adaptively reflow. The column structure must transition to a Top/Bottom safe-zone distribution to accommodate the narrow horizontal space, ensuring cards avoid the central globe touch target while remaining legible.
• Touch Targets: To satisfy mobile accessibility standards, all interactive elements—including the floating cards, the geographic anchor points on the globe, and the dossier close buttons—must possess a minimum actionable touch target size of 44x44 pixels, regardless of the visual size of the underlying SVG or HTML element.
• Keyboard Navigation: The 20 visible basic-statistics cards must be dynamically inserted into the DOM's sequential tab focus order. When a user navigates to a card via the Tab key, the 3D globe must automatically pan and rotate to center the corresponding entity's geographic anchor point in the viewport.
• Reduced Motion Compliance: The application must query the operating system for the prefers-reduced-motion CSS media feature. If this preference is enabled, the system must immediately disable all smooth-panning camera interpolations and the physics-based force-directed card placement animations. The camera must snap instantly to new targets, and cards must render instantaneously at their final calculated coordinates to prevent vestibular distress.

35 Given/When/Then Acceptance Tests

The following comprehensive suite of 35 acceptance tests defines the exact, measurable compliance criteria for the Current Statistics mode.

Table 5: Behavioral Acceptance Criteria

Prioritized Remediation Backlog

Based on the architectural risks, race conditions, and mathematical edge cases identified during this black-box audit, the following remediation backlog is prioritized by severity to guide engineering efforts.

Table 6: Engineering Remediation Backlog

Known Unknowns and Required Evidence

Due to the strict constraints of black-box testing methodologies—preventing access to server filesystems, proprietary source code, and database logic—several underlying architectural mechanisms remain classified as "known unknowns." Complete remediation and optimization of the Current Statistics mode will require access to the following server-side operational evidence:

1. Topology Caching vs. Runtime Merging: It remains unverified whether the complex polygon unioning required for extreme scenarios like the 2090 China successor-state is pre-computed and cached as static TopoJSON files on the server, or if the client device's browser is forced to compute the polygon mesh dissolves and arc suppressions at runtime. If the operation is computed client-side, extensive performance profiling on low-tier mobile devices is strictly required to ensure the geometry engine does not block the main thread.

2. Weighted Average Formulas for Non-Linear Demographics: While the prompt mandates a weighted method for standard rate statistics (like birth rates), the exact server-side equations utilized for complex, non-linear indicators—such as shifts in overall life expectancy during massive demographic mergers—cannot be validated strictly from the front end. Access to the backend statistical aggregation scripts is required to validate demographic accuracy and ensure mathematical validity.

3. Coordinate Parsing and Centroid Logic: The detailed dossier relies on an "Approximate globe orientation point" derived from the first coordinate pair found in the preserved baseline source field2. It is entirely unknown how the backend parsing logic handles severe geographical anomalies, such as expansive archipelagos, discontinuous overseas territories (e.g., France and French Guiana), or massive newly formed successor states, when calculating the ideal spatial anchor. Engineering documentation detailing the spatial centroid-calculation logic and bounding-box derivation is required to ensure geographic anchors do not render in the middle of the ocean for highly dispersed entities.

Works cited

1. Worldwide Intelligence-Cycle Game Systems | IARPA.org Integrated Artificial Reality Planetary Atlas, https://iarpa.org/international/research/intelligence-game-systems/

2. Turks and Caicos Islands — Factbook 2025 | IARPA.org Integrated Artificial Reality Planetary Atlas, https://iarpa.org/international/factbook/turks-and-caicos-islands/