VANTAGE
Documentation

XTND Vantage — Documentation & Platform Reference

Unified, 100% Event-Driven Telemetry, Observability & AI Intelligence Platform
Developed by XTND DYNAMICS • Operating across the Global Cloudflare Edge

1. Executive Summary

XTND Vantage is the centralized observability, telemetry, and artificial intelligence accounting platform powering the XTND DYNAMICS service ecosystem (including LaoGPT.com, EvergreenAI.la, X360 Task Command, XTND Transfer, and XTND Auth).

Unlike legacy observability stacks that rely on synchronous HTTP calls, heavy agents, or invasive DOM instrumentation, XTND Vantage is built on three strict foundational principles:

  1. 100% Event-Driven & Local-First: Every internal component, background worker, and browser client logs telemetry exclusively into an asynchronous, local-first storage buffer (Memory or IndexedDB). Application code is never blocked waiting for network roundtrips.
  2. Urgency-Classified Routing: The system continuously evaluates events against dynamic urgency rules, triaging them into P0 Critical (immediate edge push, kill-switches, alerts), P1 High (stream completions, user conversions), P2 Normal (standard UX telemetry, batched every 10s), and P3 Deferred (heartbeats, debug traces).
  3. Transparent Edge Interception & AI Cost Accounting: Real-time observability for web applications and multi-model AI inference (OpenAI, Anthropic Claude, Google Gemini) is performed transparently at the Cloudflare edge—measuring TTFT, token burn rates, prompt caching ROI, and multi-tenant quotas with zero impact on user experience.

2. Repository Ecosystem Map

The platform is maintained across 9 dedicated Git repositories in the XTND-DYNAMICS organization:

Workspaces/xtnd-vantage/
├── xtnd-vantage/               # Core Platform Monorepo (packages)
│   └── packages/
│       ├── aegis/             # System health probes, uptime & incident declaration
│       ├── chronos/           # Human activity telemetry, attribution & Notion reconciliation
│       ├── core/              # EventBus, base contracts, types, UUID engine
│       ├── radar/             # Browser UX dispatcher & Edge interceptor
│       ├── sentinel/          # Circuit breakers & runaway AI loop prevention
│       ├── sonar/             # AI parsers, pricing tables, token cost matrix
│       ├── storage-local/     # Memory & IndexedDB adapters for local buffers
│       ├── sync-manager/      # VantageStorageManager, UrgencyEngine, HTTP transport
│       └── vantage/           # Unified VantageClient aggregator
├── xtnd-vantage-api/          # Central Ingestion & Storage Worker (api.vantage.xgi.io)
├── xtnd-sonar-api/            # Dedicated AI Observability Gateway Worker (api.sonar.vantage.xgi.io)
├── xtnd-radar-api/            # Dedicated Web Analytics Gateway Worker (api.radar.vantage.xgi.io)
├── xtnd-chronos-api/          # Dedicated Human Activity Gateway Worker (api.chronos.vantage.xgi.io)
├── xtnd-argus-web/            # Argus — live operational dashboard (argus.xgi.io)
├── xtnd-vantage-web/          # Vantage portal & documentation, built from this repo (vantage.xgi.io)
├── xtnd-sonar-sdk/            # Standalone npm library: @xtnd-dynamics/xtnd-sonar-sdk
├── xtnd-radar-sdk/            # XRADAR: @xtnd-dynamics/xtnd-radar-sdk (data layer, capture, replay)
├── xtnd-chronos-sdk/          # Standalone npm library: @xtnd-dynamics/xtnd-chronos-sdk
├── xtnd-argus-sdk/            # Standalone npm library: @xtnd-dynamics/xtnd-argus-sdk
└── xtnd-vantage-doc/          # [THIS REPO] Exhaustive Architecture & Platform Documentation

3. High-Level Architecture Topology

flowchart TB
    subgraph ClientLayer["Client & Origin Layer"]
        LaoGPT["LaoGPT.com (Origin)"]
        Evergreen["EvergreenAI.la (Origin)"]
        X360["X360 / XTransfer Apps"]
        BrowserSDK["Radar SDK (@xtnd-dynamics/xtnd-radar-sdk)"]
        AISDK["Sonar SDK (@xtnd-dynamics/xtnd-sonar-sdk)"]
    end

    subgraph EdgeGateways["Cloudflare Edge Workers (Gateways)"]
        SonarAPI["xtnd-sonar-api\n(api.sonar.vantage.xgi.io)\nAI Proxy & Token Metering"]
        RadarAPI["xtnd-radar-api\n(api.radar.vantage.xgi.io)\nWeb Telemetry Interceptor"]
    end

    subgraph ExternalAI["External AI Model Providers"]
        OpenAI["OpenAI (GPT-4o, o1, o3-mini)"]
        Anthropic["Anthropic (Claude 3.7 / 3.5)"]
        Gemini["Google (Gemini 2.0 Flash / Pro)"]
    end

    subgraph CentralEngine["Central Exchange & Storage"]
        VantageAPI["xtnd-vantage-api\n(api.vantage.xgi.io)\nCentral Ingestion Worker"]
        CFKV["Cloudflare KV\n(Urgent Events Buffer)"]
        CFAnalytics["Cloudflare Analytics Engine\n(High-Throughput Time-Series)"]
    end

    subgraph CommandCenter["Visualization & Governance"]
        ArgusWeb["Argus dashboard\n(argus.xgi.io)"]
        VantageWeb["Vantage portal & docs\n(vantage.xgi.io)"]
        ArgusSDK["Argus Embeddable Widgets\n(@xtnd-dynamics/xtnd-argus-sdk)"]
    end

    %% Client traffic
    LaoGPT & Evergreen --> RadarAPI
    X360 --> BrowserSDK
    BrowserSDK --> RadarAPI

    %% AI traffic
    AISDK --> SonarAPI
    SonarAPI <--> OpenAI & Anthropic & Gemini

    %% Telemetry flows
    SonarAPI -- "P0 (Immediate) / P2 (Batch)" --> VantageAPI
    RadarAPI -- "P0 (Immediate) / P2 (Batch)" --> VantageAPI

    %% Storage
    VantageAPI --> CFKV
    VantageAPI --> CFAnalytics

    %% Visualization
    VantageAPI -.-> ArgusWeb
    VantageWeb -. system access .-> ArgusWeb
    ArgusSDK -.-> ArgusWeb

4. Documentation Directory Guide

Dive deeper into specific topics using the structured guides below:

Architecture & System Design

  • System Overview: Deep dive into the end-to-end data pipeline, components, and communication protocols.
  • Event-Driven Pipeline: The cardinal rules of local-first storage, UrgencyEngine classification (P0–P3), and idle sync loops.
  • Cloudflare Edge Infrastructure: Details on Cloudflare Workers, KV, Analytics Engine, and custom domains (*.vantage.xgi.io, argus.xgi.io).

Monorepo Packages (xtnd-vantage/packages/*)

Services & API Workers

Dashboards & Embeddable UI

Standalone Client Libraries

Integration Guides & Operations