{
  "schema_version": "1",
  "portal_version": "1.0.0-foundation",
  "updated_at": "2026-07-20",
  "source": "marco.public_portal",
  "provenance": "canonical_registry",
  "data": {
    "version": "1.0.0",
    "status": "LIVING",
    "chapters": [
      {
        "id": "what",
        "number": 1,
        "title": "What is MARCO?",
        "statement": "Identity, payments and rewards for the Melega Ecosystem.",
        "visual": "statement"
      },
      {
        "id": "pillars",
        "number": 2,
        "title": "The Four Pillars",
        "statement": "Identity. Payments. Rewards. Growth.",
        "visual": "pillar-cascade"
      },
      {
        "id": "passport",
        "number": 3,
        "title": "MARCO Passport",
        "statement": "One subject. One Passport. Every application.",
        "visual": "passport-object"
      },
      {
        "id": "levels",
        "number": 4,
        "title": "Passport Levels",
        "statement": "Explorer. Silver. Gold. Platinum.",
        "visual": "levels"
      },
      {
        "id": "connect",
        "number": 5,
        "title": "MARCO Connect",
        "statement": "Your gateway to the MARCO Economy.",
        "visual": "live-widget"
      },
      {
        "id": "premium",
        "number": 6,
        "title": "MARCO Connect Premium",
        "statement": "Your product. Your surface. Your identity.",
        "visual": "premium-tiers"
      },
      {
        "id": "pay",
        "number": 7,
        "title": "MARCO Pay",
        "statement": "Every payment gives something back.",
        "visual": "payment-flywheel"
      },
      {
        "id": "credits",
        "number": 8,
        "title": "M-Credits",
        "statement": "Earn. Store. Spend. Earn again.",
        "visual": "circular-economy"
      },
      {
        "id": "rewards",
        "number": 9,
        "title": "Rewards",
        "statement": "5% to the user. 1% to the Partner.",
        "visual": "rewards"
      },
      {
        "id": "partners",
        "number": 10,
        "title": "Partners",
        "statement": "Grow your community. Grow with it.",
        "visual": "partner-flow"
      },
      {
        "id": "build",
        "number": 11,
        "title": "Builders",
        "statement": "Two products. One installation.",
        "visual": "build-kit"
      },
      {
        "id": "roadmap",
        "number": 12,
        "title": "Roadmap",
        "statement": "Now. Next. Then.",
        "visual": "timeline"
      },
      {
        "id": "machine",
        "number": 13,
        "title": "Machine Readability",
        "statement": "MARCO is readable by people and by machines.",
        "visual": "machine-concepts"
      },
      {
        "id": "ecosystem",
        "number": 14,
        "title": "The MARCO Ecosystem",
        "statement": "One centre. Many surfaces.",
        "visual": "ecosystem-orbit"
      },
      {
        "id": "faq",
        "number": 15,
        "title": "Questions",
        "statement": "Every common question, answered here.",
        "visual": "faq"
      }
    ],
    "pillars": [
      {
        "icon": "Fingerprint",
        "title": "Identity",
        "line": "One Passport recognised across every application."
      },
      {
        "icon": "CreditCard",
        "title": "Payments",
        "line": "MARCO accepted natively, without a crypto checkout."
      },
      {
        "icon": "Gift",
        "title": "Rewards",
        "line": "Eligible payments return M-Credits automatically."
      },
      {
        "icon": "Orbit",
        "title": "Growth",
        "line": "Rewards bring people back, and the ecosystem compounds."
      }
    ],
    "build_kit": [
      {
        "icon": "Fingerprint",
        "title": "MARCO Connect",
        "line": "Identity in one click.",
        "status": "AVAILABLE"
      },
      {
        "icon": "CreditCard",
        "title": "MARCO Pay",
        "line": "Accept MARCO.",
        "status": "AVAILABLE"
      },
      {
        "icon": "Store",
        "title": "Merchant Kit",
        "line": "Payments, orders, rewards.",
        "status": "AVAILABLE"
      },
      {
        "icon": "Plug",
        "title": "SDK",
        "line": "One runtime, every framework.",
        "status": "AVAILABLE"
      },
      {
        "icon": "Package",
        "title": "Widgets",
        "line": "Drop-in, no build step.",
        "status": "AVAILABLE"
      }
    ],
    "roadmap": [
      {
        "phase": "NOW",
        "items": [
          "MARCO Connect"
        ]
      },
      {
        "phase": "NEXT",
        "items": [
          "MARCO Pay"
        ]
      },
      {
        "phase": "THEN",
        "items": [
          "SmartDrop",
          "Melega DEX",
          "MAIORA"
        ]
      }
    ],
    "machine_readability": [
      {
        "icon": "Globe",
        "title": "JSON",
        "line": "Every public truth has a machine copy."
      },
      {
        "icon": "Plug",
        "title": "SDK",
        "line": "One runtime for every framework."
      },
      {
        "icon": "Package",
        "title": "Widgets",
        "line": "Identity without a build step."
      },
      {
        "icon": "Eye",
        "title": "Public APIs",
        "line": "Read MARCO without asking anyone."
      },
      {
        "icon": "Sparkles",
        "title": "OpenAPI",
        "line": "Described, versioned, discoverable."
      }
    ],
    "ecosystem": {
      "center": "MARCO",
      "nodes": [
        {
          "id": "passport",
          "label": "Passport",
          "line": "One identity across the ecosystem.",
          "status": "AVAILABLE"
        },
        {
          "id": "connect",
          "label": "Connect",
          "line": "The embeddable entry point.",
          "status": "AVAILABLE"
        },
        {
          "id": "pay",
          "label": "Pay",
          "line": "Payments that reward everyone.",
          "status": "AVAILABLE"
        },
        {
          "id": "partners",
          "label": "Partners",
          "line": "Projects growing with MARCO.",
          "status": "AVAILABLE"
        },
        {
          "id": "space",
          "label": "Space",
          "line": "Where the community gathers.",
          "status": "AVAILABLE"
        },
        {
          "id": "smartdrop",
          "label": "SmartDrop",
          "line": "Distribution, done properly.",
          "status": "COMING_SOON"
        },
        {
          "id": "dex",
          "label": "DEX",
          "line": "Native ecosystem liquidity.",
          "status": "COMING_SOON"
        },
        {
          "id": "black",
          "label": "BLACK",
          "line": "Community launches.",
          "status": "COMING_SOON"
        },
        {
          "id": "maiora",
          "label": "MAIORA",
          "line": "The premium tier of Melega.",
          "status": "COMING_SOON"
        },
        {
          "id": "ai",
          "label": "AI Services",
          "line": "Melega AI, from your Passport.",
          "status": "COMING_SOON"
        }
      ]
    },
    "changelog": [
      {
        "version": "1.0.0",
        "date": "2026-08-01",
        "note": "The Living Whitepaper becomes the MARCO Handbook — interactive, visual, machine-readable."
      },
      {
        "version": "0.2.0",
        "date": "2026-08-01",
        "note": "Chapter audit and diagram slots."
      },
      {
        "version": "0.1.0",
        "date": "2026-07-20",
        "note": "Foundation — canonical structure established."
      }
    ]
  },
  "canonical_url": "/handbook",
  "json_url": "/api/public/handbook"
}