{
  "$schema": "https://rootz.global/ai/schemas/ai-discovery-v1.2.json",
  "specVersion": "1.2.0",
  "schemaVersion": "2026-02",
  "generated": "2026-03-28T00:00:00Z",
  "organization": {
    "name": "Rootz Portal",
    "legalName": "Rootz, Corp.",
    "domain": "portal.rootz.global",
    "founded": "2025",
    "headquarters": "United States",
    "digitalName": "0xD36AAf65a91bB7dc69942cF6B6d1dBa4Ef171664",
    "blockchain": "Polygon",
    "tagline": "The gateway to AI visual interaction",
    "mission": "Building the first graphical interface designed for AI output — where AI draws, narrates, and interacts visually with humans in real time.",
    "sector": ["AI", "visual-computing", "developer-tools", "MCP"],
    "stage": "beta",
    "contact": "discover@rootz.global",
    "parentOrg": {
      "name": "Rootz Corp",
      "domain": "rootz.global",
      "digitalName": "0xD36AAf65a91bB7dc69942cF6B6d1dBa4Ef171664"
    }
  },
  "people": [
    {
      "name": "Steven Sprague",
      "role": "CEO & Co-Founder",
      "background": "Former CEO of Wave Systems Corp. 25+ years in hardware security and Trusted Computing.",
      "expertise": ["trusted-computing", "hardware-security", "AI-interfaces", "blockchain-architecture"]
    }
  ],
  "knowledge": {
    "description": "Structured knowledge base for Portal capabilities, templates, and protocol",
    "url": "https://portal.rootz.global/.well-known/ai/knowledge",
    "format": "application/json",
    "schema": "rootz-knowledge-v1"
  },
  "feed": {
    "description": "AI-optimized updates on Portal features, demos, and integrations",
    "url": "https://portal.rootz.global/.well-known/ai/feed",
    "format": "application/json",
    "schema": "rootz-feed-v1",
    "frequency": "weekly"
  },
  "capabilities": {
    "discovery": true,
    "knowledge": {
      "available": true,
      "url": "/.well-known/ai/knowledge",
      "auth": "none",
      "rateLimit": "100/hour",
      "languages": ["en"]
    },
    "feed": {
      "available": true,
      "url": "/.well-known/ai/feed",
      "auth": "none",
      "rateLimit": "100/hour"
    },
    "content": {
      "available": true,
      "url": "/.well-known/ai/content",
      "auth": "none",
      "description": "Structured content for all Portal pages — spec, skill file, whitepaper"
    },
    "mcp": {
      "available": true,
      "url": "https://portal.rootz.global/mcp/{walletAddress}",
      "transport": "http-streamable",
      "auth": "wallet-session",
      "description": "16 MCP tools for visual rendering, state management, templates, branching logic, and interactive navigation. Any AI with MCP support can draw on the Portal.",
      "toolCount": 16,
      "tools": [
        "stage_render", "stage_add", "stage_remove", "stage_update",
        "stage_clear", "stage_capture", "stage_narrate", "stage_status",
        "stage_open", "stage_screenshot", "stage_listen", "stage_instructions",
        "stage_state", "stage_branch", "stage_wait"
      ]
    },
    "agentSkills": {
      "available": true,
      "description": "Skill file teaches any AI how to use the Portal — narration technique, layout patterns, element types, templates.",
      "skills": [
        {
          "name": "portal-skill",
          "version": "0.4.0",
          "description": "Teaches AI to draw GPU-rendered visuals with voice narration via the Rootz Portal",
          "skillUrl": "https://portal.rootz.global/skill.md",
          "format": "markdown",
          "license": "CC-BY-4.0"
        }
      ]
    }
  },
  "pages": [
    {"path": "/", "title": "Portal Launcher", "purpose": "Onboarding screen with setup instructions for Claude Code, ChatGPT, and other AIs"},
    {"path": "/about", "title": "About", "purpose": "What the Portal is, privacy policy, and how to get started"},
    {"path": "/docs", "title": "Documentation", "purpose": "Per-platform setup guides with copy-paste instructions"},
    {"path": "/whitepaper", "title": "Whitepaper", "purpose": "Full architecture, roadmap, and the Mac/Mosaic/Portal historical parallel"},
    {"path": "/skill.md", "title": "AI Skill File", "purpose": "Quick reference for AI — element types, templates, narration rules, layout patterns"},
    {"path": "/spec.md", "title": "Complete Specification", "purpose": "Every element type with working JSON examples, common mistakes, and clickable examples"}
  ],
  "coreConcepts": [
    {
      "term": "Portal",
      "definition": "A GPU-accelerated visual display that AI controls via MCP. The AI sends structured JSON, the renderer draws it in real time with voice narration. Like the Macintosh GUI for personal computing, the Portal is the visual layer for AI."
    },
    {
      "term": "Template",
      "definition": "A reusable layout pattern (hero, stats, hub, comparison, timeline) that auto-generates scenes from data. AI provides {template, theme, data} instead of hand-crafting elements.",
      "relatedTerms": ["Theme", "Scene"]
    },
    {
      "term": "Scene",
      "definition": "A single visual frame with elements, background, particles, and narration. Scenes queue up and crossfade automatically. Narration is the clock — the next scene starts when the voice finishes."
    },
    {
      "term": "World Stack",
      "definition": "Persistent key-value state that survives scene transitions. Enables multi-step workflows, game worlds, and context tracking across scenes.",
      "relatedTerms": ["Protocol v1", "Branch"]
    },
    {
      "term": "Protocol v1",
      "definition": "The Portal message protocol — 18 message types across 7 categories: render, voice, state, logic, transition, query, meta. Message-driven architecture where AI is not a stream but an instruction."
    },
    {
      "term": "Wallet Session",
      "definition": "Each browser generates a crypto wallet in localStorage. The wallet address becomes the session ID, MCP endpoint, and archive key. No passwords, no accounts."
    },
    {
      "term": "Narration",
      "definition": "Voice storytelling via browser TTS. The narration tells the full story while visuals anchor key points. DO NOT read the slides — the voice should contain MORE information than the screen."
    },
    {
      "term": "AI Browser",
      "definition": "When elements are clickable and respond to user interaction, the Portal becomes an AI Browser — navigation without URLs, content generated not fetched."
    }
  ],
  "technology": {
    "renderer": "PixiJS 8 (WebGL2 GPU-accelerated)",
    "server": "Node.js with @modelcontextprotocol/sdk",
    "transport": "MCP HTTP Streamable + WebSocket",
    "voice": "Browser SpeechSynthesis API",
    "identity": "localStorage wallet (ECDSA-ready)",
    "persistence": "IndexedDB session auto-save",
    "primitives": ["text", "box", "circle", "line", "arrow", "grid", "image", "progress", "table"],
    "templates": {
      "layouts": ["hero", "stats", "hub", "comparison", "timeline"],
      "themes": ["dark-ops", "warm", "ocean", "minimal"]
    }
  },
  "contact": {
    "website": "https://portal.rootz.global",
    "email": "discover@rootz.global",
    "parent": "https://rootz.global"
  },
  "humanReadable": "https://portal.rootz.global/about",
  "_signature": {
    "digitalName": "0xD36AAf65a91bB7dc69942cF6B6d1dBa4Ef171664",
    "network": "polygon",
    "publishedAt": "2026-03-28T00:00:00Z",
    "method": "epistery-domain-v1",
    "note": "Signed by Rootz Corp Digital Name. Portal is a subdomain product of rootz.global."
  },
  "meta": {
    "standardDraft": "https://rootz.global/ai/standard.md",
    "purpose": "This file enables AI agents to discover, understand, and interact with the Rootz Portal — the first visual interface designed for AI output. It follows the AI Discovery Standard v1.2.",
    "license": "CC-BY-4.0"
  }
}
