{
  "schema_version": "1",
  "portal_version": "1.0.0-foundation",
  "updated_at": "2026-07-20",
  "source": "marco.public_portal",
  "provenance": "canonical_registry",
  "data": {
    "version": "0.1.0-directive-01",
    "updated_at": "2026-07-20",
    "status": "DIRECTIVE_01_EXPLORATION",
    "form_factor": {
      "aspect_ratio": "1.62 : 1 (landscape)",
      "intent": "Wallet-native proportion with a deliberate deviation from the credit-card ratio (1.586). The Passport is a wallet object, not a card.",
      "distinctive_silhouette": [
        "Three softly-rounded corners at 42px + one signature architectural chamfer on the top-right.",
        "A single hairline accent stroke traces the chamfer in the tier's accent color.",
        "Unique per-Passport guilloche fingerprint, derived from the identity seed.",
        "No embossed name. No signature strip. No card-network artefacts. No section labels on the front face."
      ],
      "qr": {
        "role": "Authority surface — bridge between digital identity and physical world.",
        "never": "Never decorative. Never generated for marketing. Never shares its frame.",
        "surfaces": [
          "Merchant terminal",
          "Event access gate",
          "Mission validation",
          "Proof of Presence",
          "M-Credit payment (Treasury Runtime — future)"
        ]
      }
    },
    "materials": [
      {
        "id": "explorer",
        "label": "Explorer",
        "material": "Graphite",
        "description": "The entry material. Cold, honest, unornamented. Belongs to the ones who arrive first.",
        "accent": "Neutral white hairline. No gold. No sheen.",
        "edge": "Micro-hairline in ivory at 8% opacity."
      },
      {
        "id": "silver",
        "label": "Silver",
        "material": "Titanium",
        "description": "The verified base tier. Brushed cool metal — quiet, industrial, structural.",
        "accent": "Cool silver typographic accent, brushed grain overlay.",
        "edge": "Titanium hairline at 40% opacity."
      },
      {
        "id": "gold",
        "label": "Gold",
        "material": "Matte black + warm brushed gold",
        "description": "The flagship material. Deep matte body with restrained warm-gold detailing — the reference Passport.",
        "accent": "Warm brushed gold on hairlines and single typographic element.",
        "edge": "Gold hairline at 55% opacity."
      },
      {
        "id": "platinum",
        "label": "Platinum",
        "material": "Dark ceramic + platinum",
        "description": "The rarest material. Deep ceramic body with a cold platinum edge and a faint iridescent sheen.",
        "accent": "Cold platinum + subtle iridescence on the upper edge only.",
        "edge": "Platinum hairline at 65% opacity, iridescent inner glow."
      }
    ],
    "subjects": [
      {
        "id": "human",
        "label": "Human",
        "role": "Personal identity in the Melega ecosystem.",
        "visible_marker": "HUMAN VERIFIED indicator, pseudonymous handle by default.",
        "never": "Never displays legal name or KYC documents on the object."
      },
      {
        "id": "agent",
        "label": "AI Agent",
        "role": "Autonomous participant with declared boundaries.",
        "visible_marker": "AGENT indicator, capability and authority scope printed as mono strip.",
        "never": "Never impersonates a human. Never omits its principal."
      },
      {
        "id": "organization",
        "label": "Organization",
        "role": "Institutional identity with delegated Passport relationships.",
        "visible_marker": "ORG indicator, delegated-signer count printed as mono strip.",
        "never": "Never issues personal claims about its members."
      },
      {
        "id": "service",
        "label": "Digital Service",
        "role": "Capability endpoint with declared interface and provenance.",
        "visible_marker": "SERVICE indicator, capability surface printed as mono strip.",
        "never": "Never claims subjectivity. Never omits its operator."
      }
    ],
    "wallet_targets": [
      {
        "id": "apple_wallet",
        "label": "Apple Wallet",
        "status": "PLANNED",
        "render_intent": "Native .pkpass rendering. Front face shows tier material, level, HUMAN/AGENT/ORG indicator and rotating QR. Back of pass carries machine layer."
      },
      {
        "id": "google_wallet",
        "label": "Google Wallet",
        "status": "PLANNED",
        "render_intent": "Generic Wallet Object rendering. Hero image is the Passport object; card fields expose level, tier, subject type; QR module carries the rotating verification code."
      },
      {
        "id": "future_wallets",
        "label": "Future digital identity wallets",
        "status": "RESEARCH",
        "render_intent": "The Passport object is portable to any wallet surface that supports verifiable credentials + a scannable presentation."
      }
    ],
    "motion_principles": [
      {
        "id": "restraint",
        "title": "Restraint over spectacle",
        "body": "Motion exists to confirm state, never to entertain. No parallax, no confetti, no bounce. If a motion cannot be justified by verification or hierarchy, it is removed."
      },
      {
        "id": "material",
        "title": "Material response",
        "body": "The Passport reacts as a physical object. Hover lifts by 6px with a 180ms ease-out; the gold hairline gains 15% luminance. It never rotates in space unless the user is inspecting it directly."
      },
      {
        "id": "verification",
        "title": "Verification is the only celebration",
        "body": "A successful scan pulses the QR bracket once, in the tier's accent, for 240ms. Nothing else in the object moves. Failure state is silent — a single hairline turns copper."
      },
      {
        "id": "presence",
        "title": "Presence pulse",
        "body": "When the Passport is live and reachable, a 1.6s low-opacity breath animates the NFC glyph — never the body, never the typography, never the QR."
      }
    ],
    "interaction_principles": [
      {
        "id": "one-gesture",
        "title": "One gesture, one meaning",
        "body": "Tap opens. Long-press reveals machine layer. Scan verifies. The Passport learns no other gestures."
      },
      {
        "id": "two-layers",
        "title": "Two-layer object",
        "body": "Humans see the front face. Machines see the JSON-LD credential layer. Both layers are the same Passport — never two products."
      },
      {
        "id": "qr-authority",
        "title": "The QR is authority",
        "body": "The QR is not decoration. It is the presentation channel for verification. It rotates every 60s in wallet, is bracketed, and never shares its frame with marketing."
      },
      {
        "id": "wallet-native",
        "title": "Wallet-native, portal-agnostic",
        "body": "The Passport must render identically in Apple Wallet, Google Wallet, and any future digital wallet. The portal is never the source of truth for the object — the wallet is."
      },
      {
        "id": "silence",
        "title": "Silence by default",
        "body": "No banner. No badge. No notification. The Passport speaks only when scanned, tapped, or verified."
      }
    ],
    "prohibitions": [
      "No credit-card imitation.",
      "No government-passport imitation.",
      "No fake balances, fake handles, fake holders, fake thresholds.",
      "No modification of the immutable MARCO logo on the object.",
      "No MARCO Chad on the Passport object — Chad is cultural, the Passport is institutional."
    ],
    "tokens": {
      "version": "2.0.0-directive-02",
      "status": "READY_FOR_FOUNDER_REVIEW",
      "updated_at": "2026-07-21",
      "geometry": {
        "aspect_ratio": 1.62,
        "view_box": {
          "w": 1000,
          "h": 617
        },
        "corner_radius": 42,
        "chamfer_edge": 78,
        "chamfer_position": "top-right",
        "rounded_corners": [
          "top-left",
          "bottom-left",
          "bottom-right"
        ],
        "hairline_stroke_px": 1.5,
        "chamfer_accent_stroke_px": 1.2,
        "canonical_source": "src/components/passport/silhouette.ts"
      },
      "layout": {
        "safe_area_px": {
          "sm": 16,
          "md": 24,
          "lg": 34
        },
        "logo_px": {
          "sm": 20,
          "md": 28,
          "lg": 40
        },
        "wordmark_px": {
          "sm": 12,
          "md": 15,
          "lg": 20
        },
        "tier_wordmark_px": {
          "sm": 22,
          "md": 36,
          "lg": 54
        },
        "handle_px": {
          "sm": 10,
          "md": 12,
          "lg": 14
        },
        "qr_px": {
          "sm": 60,
          "md": 92,
          "lg": 128
        },
        "qr_quiet_zone_px": 4
      },
      "motion": {
        "respects_reduced_motion": true,
        "hover_lift_px": 6,
        "hover_duration_ms": 180,
        "verification_pulse_ms": 240,
        "presence_pulse_s": 1.6,
        "disallowed": [
          "continuous_spin",
          "3d_rotation",
          "neon_pulse",
          "parallax",
          "auto_playing_video"
        ]
      },
      "qr": {
        "role": "authority-surface",
        "concept_status": "STATIC_SCANNABLE_TEST",
        "dynamic_status": "PLANNED",
        "minimum_render_size_px": 56,
        "quiet_zone_px": 4,
        "encoded_data": "/qr-test (safe project-owned design-system destination)",
        "error_correction_level": "M",
        "never_encodes": [
          "personal_identifiable_information",
          "wallet_balances",
          "private_credentials",
          "access_tokens",
          "secrets",
          "payment_authorization"
        ]
      },
      "guilloche": {
        "algorithm": "harmonic-sine-field-v1",
        "seed_source": "public visual seed (tier + subject + handle + serial)",
        "never_derived_from": [
          "legal_name",
          "birth_date",
          "government_document",
          "address",
          "private_key",
          "email",
          "phone"
        ],
        "reversible": false,
        "max_opacity": 0.1
      },
      "wallet": {
        "apple": "PLANNED",
        "google": "PLANNED",
        "concept_label": "CONCEPT PREVIEW — WALLET INTEGRATION NOT ACTIVE",
        "nfc_payments": "NOT_CLAIMED"
      },
      "accessibility": {
        "min_contrast_ratio_text": 4.5,
        "min_contrast_ratio_ui": 3,
        "keyboard_focus": "visible-hairline",
        "reduced_motion": "honored"
      }
    }
  },
  "registry_version": "0.1.0-directive-01",
  "tokens_version": "2.0.0-directive-02",
  "canonical_url": "/api/public/passport-design-system"
}