{
  "schema": "unitiqx.public-experience-standard.v2",
  "title": "Universal UNITIQX Public Experience Contract",
  "edition": "2.0.0",
  "scope": [
    "games",
    "websites",
    "web applications",
    "APIs",
    "research collections",
    "AI/agent workflows",
    "hardware/OS reference tools",
    "videos",
    "tutorials",
    "creative work",
    "product demos"
  ],
  "purpose": "Every public product should explain what it is, why it matters, how to start, how to succeed, what can fail, how to think through it without tools, and what was actually verified.",
  "required_fields": [
    "id",
    "title",
    "type",
    "version",
    "tagline",
    "public_url",
    "what_it_is",
    "why_it_exists",
    "who_it_is_for",
    "how_to_start",
    "interaction",
    "success_criteria",
    "expected_results",
    "failure_and_recovery",
    "think_mode",
    "vision_mode",
    "read_only_ai",
    "read_only_urls",
    "media",
    "privacy",
    "evidence",
    "limits",
    "mental_example",
    "verification_class"
  ],
  "formats": {
    "human": "static semantic HTML that is readable without JavaScript",
    "machine": "versioned JSON over HTTPS with no authentication",
    "visual": "genuine screenshot with descriptive alt text and source",
    "video": "short introduction/demonstration with captions and transcript",
    "text": "self-contained scenarios, instructions, worked examples and failure cases"
  },
  "trust_labels": {
    "observed_public_route": "An HTTPS/HTTP response from a specific approved public endpoint at a recorded time",
    "automated_browser_receipt": "A browser actually visited and acted on a page; not a human experience or provider inference run",
    "unit_rule_simulation": "Deterministic state transitions computed from published local code",
    "hypothetical_thought_exercise": "An illustrative plan or decision without any software execution",
    "photo_or_screenshot": "Must state whether actual product capture, test environment, stock imagery or generated illustration",
    "narrated_screenshot_tour": "A locally rendered audio/video introduction from screenshots, NOT a real click-by-click workflow demonstration",
    "independent_model_run": "Needs actual connector response, model identity, tool receipt, permitted route and time",
    "verified_human_test": "Requires real participant and observed or consented feedback",
    "unknown": "Never silently upgrade unknown or historical assertions to verified."
  },
  "minimum_access_modes": {
    "hands_on": "Keyboard/mouse/touch interactions with clear outcome and recovery",
    "mental": "Rules, initial state, decisions, explanations and expected outcomes",
    "vision": "Authentic visuals and complete text alternatives",
    "text_only": "Content and examples readable by any text reader without JavaScript",
    "read_only_ai": "Public GET/HEAD docs, actions and states; no assumption that browser writes exist"
  },
  "minimum_media_per_product": {
    "screenshot": "Actual product image or explicit unavailable label",
    "image_alt": "Useful description of what the user sees",
    "video": "At least one truthful narrated introduction when feasible; do not fake live workflow",
    "captions": "WebVTT",
    "transcript": "Plain accessible text"
  },
  "security": {
    "publish_only_approved_static_paths": true,
    "publish_secrets": false,
    "give_anonymous_admin_or_shell": false,
    "read_only_connector_may_mutate_owner_state": false,
    "credential_free_public_experience": true,
    "expose_internal_evidence_path": false,
    "redact_sensitive_or_personal_details_before_publication": true,
    "rate_limit_any_costly_dynamic_endpoint": true
  },
  "publication_steps": [
    "Identify canonical product version and safe public source of truth.",
    "Write plain-language purpose, audience, how-to, goals, feedback, failure and recovery.",
    "Write independent machine-readable contract and read-only hypothetical scenario.",
    "Capture actual public product screenshots; label source and avoid private pages.",
    "Make locally narrated intro/real authorized demo and transcript; label what actually happened.",
    "Check keyboard, mobile viewport, alt text and readable non-JavaScript content.",
    "Review privacy, sensitivity, URLs, credentials, rate limits and no-admin boundary.",
    "Run representative positive and negative QA; record actual proof separately from claims.",
    "Publish through an explicit static route allowlist with backup/rollback.",
    "Monitor availability and review each product upon version changes."
  ],
  "medium_extensions": {
    "game": [
      "player controls",
      "mission definitions",
      "legal actions",
      "initial state",
      "loss and win conditions",
      "progress and replay",
      "hints",
      "spoiler reference"
    ],
    "web_service": [
      "accepted input format",
      "bounded quotas",
      "result schema",
      "error codes",
      "retry policy",
      "provenance"
    ],
    "research": [
      "source date",
      "evidence level",
      "citation",
      "uncertainty and competing interpretations"
    ],
    "ai_agent": [
      "authorization/permissions",
      "provider route",
      "pricing/logging retention",
      "proof of actual call",
      "unsafe input handling"
    ],
    "hardware_software": [
      "OS version",
      "hardware minimums",
      "drivers",
      "licensing",
      "compatibility provenance and date"
    ],
    "media": [
      "original and derivative distinction",
      "rights",
      "captions",
      "accessibility",
      "resolution, duration and codec"
    ]
  },
  "verification": {
    "public_catalog_has_real_live_routes": true,
    "all_products_feature_certified": false,
    "physical_device_certified": false
  }
}