Docs / Phase 16

Phase 16 Reality Demo Report

Real-company demo, reviews, cases, contracts, geo import, and critique.

Phase 16 Reality Demo / Reputation Court Report

Date: 2026-05-18

What Is Live

  • Public demo page: /demo/reality
  • Demo API: /api/v2/demo/reality
  • Public synthetic citizen profile: /citizens/demo_citizen_iona_marin
  • Citizen profile API: /api/v2/citizens/[worldId]
  • Score rebuild API: /api/v2/citizens/[worldId]/score/rebuild
  • Public reputation cases API: /api/v2/reputation/cases
  • Case reply/escalation APIs: /api/v2/reputation/cases/[id]/reply, /api/v2/reputation/cases/[id]/escalate
  • Strategic agreements API: /api/v2/agreements
  • Application acceptance API: /api/v2/jobs/[id]/applications/[applicationId]/accept

Seeded Reality Demo

Real company records, with official/public source URLs:

  • Google DeepMind - official source: https://deepmind.google/about/
  • Veea Inc. - official source: https://www.veea.com/
  • lablab.ai - official source: https://lablab.ai/

Synthetic citizens only:

  • demo_citizen_iona_marin - high score, accepted, signed remote contract, document-share consent, portable level 6.
  • demo_citizen_noah_kowalski - good score, customer-style review path.
  • demo_citizen_sara_okafor - mid score, under-review application.
  • demo_citizen_matei_dobre - repair status, bad company review, public case, remediation agreement, score rebuild path.

Workflow Coverage

  • Companies and citizens can review each other.
  • Review cases are public, bilateral, and can receive counterparty replies.
  • Unresolved cases can be escalated to judges.
  • Jobs can be created and applications can be accepted.
  • Acceptance creates or updates a LaborNet contract, strategic agreement, document-share consent, and career progression row.
  • Citizen profile displays contracts, document-share proof status, applications, reviews, public cases, and portable levels.
  • Score rebuild recomputes from platform rows only: reviews, cases, agreements, progression, and trust profile.
  • Governance claim rules define mayor/ministry/head-of-state/enterprise-owner authority paths and hard limits.

Geo Backbone

  • Continents/countries: REST Countries v3.1.
  • Cities/councils: GeoNames cities500 populated-place dataset.
  • Imported counts verified by E2E: 250 countries and 232,902 city/council rows.

E2E Evidence

Final E2E script: /tmp/phase16_reality_demo_e2e.sh

Verified:

  • /demo/reality -> 200
  • /api/v2/demo/reality -> 200 JSON
  • /citizens/demo_citizen_iona_marin -> 200
  • /api/v2/citizens/demo_citizen_iona_marin -> 200 JSON
  • /api/v2/reputation/cases -> 200 JSON
  • /api/v2/agreements -> 200 JSON
  • /jobs -> 200
  • /api/v2/jobs?enterprise=google-deepmind -> 200 JSON
  • Public review reads -> OK
  • Case create -> OK
  • Case reply -> OK
  • Case escalate -> OK
  • Application accept -> OK
  • Score rebuild -> OK
  • Live Next chunk -> 200
  • PM2 gdcos-architect online, unstable restarts 0

Database counts after E2E:

  • Demo companies: 3
  • Demo citizens: 4
  • Demo reviews: 7
  • Reputation cases: 3
  • Agreements: 3
  • Document shares: 2
  • Progression rows: 5
  • Countries: 250
  • Cities/councils: 232,902

Hard Critique

  • Company facts are official/public-source backed, but platform scores for those companies are demo scores. They must not be marketed as legal credit, compliance, financial, or employment ratings until the score formula and appeal process are formally governed.
  • Synthetic citizens are clearly labelled. Production real citizens require KYC, consent, data portability notices, retention policy, and deletion/export controls before rollout.
  • Public review GET is now open, while POST remains session-protected by the route. Abuse controls still need per-IP/user throttling, defamation reporting, and judge tooling UI.
  • Case escalation writes public status, but judge adjudication is not yet a full multi-judge workflow with decision signatures, dissent, remedies, and appeal deadlines.
  • The application acceptance route now creates the right contract/agreement/document/progression chain, but enterprise-owner authorization needs stronger production enforcement beyond demo-safe IDs.
  • Document shares store proof/consent state only, not actual public files. Real official document storage must use encrypted object storage, expiry, audit log, and revocation UI.
  • GeoNames cities500 is broad and practical, but it is not literally every hamlet or administrative unit on Earth. For full statutory coverage, add national administrative boundary/council registries and OSM/GeoNames allCountries reconciliation.
  • Government claim rules are encoded, but real president/prime-minister/ministry/mayor claims need provider-specific eIDAS/OIDC credentials, mandate registry checks, and manual legal review by jurisdiction.
  • A known Turbopack NFT warning remains from KYC document verification runtime filesystem reads; build still succeeds and PM2 is stable.