# IARPG-OPS-2 2.0.20-wip Release Notes

## Status

**Work in progress.** This release adds a browser-local Country Context Composer and completes the transition from archival world orientation to separately sourced, reviewable current-country proposals. It does not publish a live geopolitical feed or claim that any proposal is verified current intelligence.

## Release Summary

IARPG already provides an archival World Context Explorer based on the preserved 2025 all-countries dataset. That archive is useful for orientation, but it cannot safely be treated as current country truth. The new **Country Context Composer** creates a deliberate boundary between what the archive said, what current sources establish, what an analyst assumes, and what a fictional game designer proposes.

The composer supports all **195 country-roadmap entries** and retains their archival source routing. It preserves the separate West Bank and Gaza Strip source components associated with the State of Palestine, keeps `source_code` separate from stable `entity_id`, and exposes the eight known source-code collision groups rather than hiding them.

## Country Context Composer

The new `/country-context-composer` route provides a browser-local proposal workspace with four independent layers:

1. **Archival orientation** from the 2025 World Context publication
2. **Current observations** supported by claim-level source records
3. **Analyst assumptions** with rationale, confidence, and a required test
4. **Fictional gameplay translations** linked to current claims and bounded by anti-typecasting safeguards

A proposal can document:

- locally used country name and endonym notes;
- research cutoff and scope;
- current institutions;
- formal and practical authority;
- oversight, remedy, and correction routes;
- rights and affected-community context;
- economy and infrastructure conditions;
- environmental constraints;
- alliances and issue-specific relationships;
- source disagreements and missing evidence;
- uncertainty, corrections, and supersession.

Every current claim requires publication and access dates, source identity and URL, source type, source language, perspective origin, geographic or institutional scope, confidence, and review state. An archival fact is never silently copied into the current claim ledger.

## Fail-Closed Publication Gate

The deterministic gate rejects a proposal that lacks:

- required current-context sections;
- explicit uncertainty and missing-evidence treatment;
- oversight and remedy analysis;
- rights and affected-community context;
- correction history;
- at least one perspective that is not solely external;
- complete claim-level source metadata;
- bounded assumptions and gameplay translations.

A passing gate means the proposal is structurally reviewable. It does not establish factual correctness, legal validity, political neutrality, source completeness, local acceptance, or approval for public publication.

## Comparative Fairness Review

The composer compares locally loaded proposals for differences in:

- adjective intensity;
- unsupported threat framing;
- uncertainty language;
- rights, oversight, and remedy coverage;
- affected-community visibility;
- source perspective diversity;
- claim and review-record burden.

The result is an editorial findings list, not a country score. The system produces no development, stability, morality, threat, loyalty, dangerousness, recruitability, targetability, diagnosis, or protected-characteristic score.

## Local Import, Export, and Preservation

The composer operates entirely in the browser and adds no account, analytics, remote storage, external model provider, or third-party runtime dependency.

It supports:

- local JSON import and export;
- deterministic validation;
- unknown top-level extension preservation;
- neutral quarantine labels for invalid imports;
- unchanged download of invalid source bytes;
- correction and supersession records;
- accessible nonvisual output;
- print, mobile, high-zoom, reduced-motion, forced-colors, and light/dark presentation.

## Public-Site Integration

Country-context methodology and routes now appear in:

- the homepage;
- Start Here;
- the Global Intelligence Atlas;
- the World Context Explorer;
- Editorial and Evidence Method;
- the Research Archive;
- the Answer Center;
- the glossary;
- search, sitemap, feed, structured data, and machine-readable discovery.

The explanatory sequence is now explicit:

```text
Archival world context
→ current-source proposal
→ relationship and alignment analysis
→ fictional faction and mission translation
```

Context does not determine alignment. Alignment is not inferred from geography, religion, ethnicity, language, demographics, government form, trade volume, one vote, one arms purchase, one leader statement, or one shared adversary.

## Machine-Readable Publication

Added:

- `country-context-composer-config.json`
- `country-context-composer-config.schema.json`
- `country-context-proposal.schema.json`
- `country-context-proposal-example.json`
- `COUNTRY-CONTEXT-COMPOSER-EVIDENCE-IARPG-OPS-2-2.0.20-wip.json`
- `COUNTRY-CONTEXT-COMPOSER-EVIDENCE-IARPG-OPS-2-2.0.20-wip.txt`
- `COUNTRY-CONTEXT-COMPOSER-BROWSER-EVIDENCE-IARPG-OPS-2-2.0.20-wip.json`
- `COUNTRY-CONTEXT-COMPOSER-BROWSER-EVIDENCE-IARPG-OPS-2-2.0.20-wip.txt`

The release also refreshes current campaign and scenario publication envelopes and their deterministic examples to 2.0.20-wip while preserving the immutable 2.0.16 campaign baseline.

## Interface Refinement

The compact shell remains unchanged in principle:

- search and release context remain in the non-sticky masthead;
- the IARPG mark and primary navigation remain in the sole sticky `.menu-strip`;
- one compact non-sticky orientation/evidence rail remains below it;
- the linked five-path `/start` hero remains intact;
- the institutional-model `/factions` hero remains intact.

Mobile Start Here spacing was tightened after the added context routes. The page retains every orientation section while remaining inside its established density budget.

## Split-Memory Integration

The memory architecture remains:

```text
.uai/                                  Active startup and current-state memory
.uai/country-context-composer.uai      Current composer contract
.uai/long-term-memory.uai              Pointer-only durable-memory ledger
docs/long-term-memory/                 Durable reviewed knowledge
docs/long-term-memory/reports/         Every canonical report
docs/source-files/                     Individually preserved source evidence
```

Current inventory:

- **364** preserved source files across **8** collections
- **242** canonical reports
- **251** authoritative durable documents and pointer records
- **103** active UAI records
- **103** byte-identical public UAI mirrors
- **399** sitemap routes
- **912** search records
- **69** direct-answer records
- **0** nested archives

Relevant hot-memory records deep-link to the durable Country Context Composer findings. The report links back through its Memory References section, and the pointer ledger remains body-free.

## Validation

Final validation results are summarized in the aggregate validation report and package-verification evidence.

| Validation area | Result |
|---|---:|
| Static PHP, JavaScript, Python, JSON, XML, and CSS | **1,099/1,099 passed** |
| Schema-declared machine records | **356/356 passed** |
| IARPG-CJSON-1 vectors | **20/20 passed** |
| Country Context Composer checks | **40/40 passed** |
| Country Context Composer Chromium checks | **11/11 passed** |
| World Context checks | **35/35 passed** |
| World Context Chromium checks | **7/7 passed** |
| Campaign state and archive checks | **26/26 passed** |
| General, alliance, campaign, and archive Chromium groups | **38/38 passed** |
| Shell and UI-density checks | **47/47 passed** |
| Site-identity and onboarding checks | **39/39 passed** |
| Preserved source hashes | **364/364 verified** |
| Certificate-verified local TLS staging | **22/22 passed; 399/399 sitemap routes** |
| Controlled production-edge checks | **59/59 passed** |
| Structural accessibility | **97 routes, 0 deterministic findings** |
| Delivery budgets | **10/10 passed** |
| Documentation checksums | **1,221/1,221 verified** |
| Active UAI mirrors | **103/103 byte-identical** |
| Finalizer idempotency | **2,443 files, 0 differences** |
| Fresh ZIP extraction | **2,446/2,446 byte-identical** |

## Promotion Boundary

The release remains WIP. Automated validation establishes deterministic structure and local behavior only. It does not establish:

- current geopolitical accuracy;
- legal or scientific validity;
- complete local or affected-community representation;
- human comprehension or task success;
- native Firefox behavior;
- native assistive-technology speech output;
- externally reachable production-host behavior;
- field Core Web Vitals or representative-device results;
- live Google, Bing, IndexNow, crawler-log, or generative-citation outcomes.

Current laws, officeholders, institutions, memberships, conflicts, sanctions, borders, population figures, markets, technologies, and policy claims require renewed primary or authoritative research before public use.

## Recommended Next Action

Create the first balanced five-region batch of **draft current-country proposals** using current primary, authoritative, local, and local-language sources. Run claim-level review and an independent comparative-fairness pass before promoting any proposal to public country-profile content.
