{
  "$comment": "CANONICAL BRAND SOURCE OF TRUTH. Machine-readable by design: agents generating decks, social posts, email or images read this file rather than a PDF. Web tokens, the /brand page and any human view are derived from it. Every `status` field says whether a value is approved or still needs the brand owner. Do not restate these values anywhere else — see README.md.",
  "meta": {
    "version": "1.1.0",
    "updated": "2026-08-28",
    "owner": "Lennie Turner",
    "authority": "canonical",
    "supersedes": "The 2023 Trusted brand one-sheet, archived as historical on 2026-08-26. A future brand refresh extends this source rather than replacing it.",
    "derivedFrom": [
      "packages/ui/src/tokens.css (palette, type roles, spacing, shape)",
      "packages/ui/src/brands/trustedhealth.css",
      "docs/brand-visual-system.md (approved 2026-08-11)",
      "docs/brand-architecture.md (approved 2026-08-05)"
    ]
  },
  "company": {
    "$comment": "The boilerplate an agent needs before it writes a word: who the legal entity is, the slogan, the mission, what the company does, and which of the two brands it is writing as. `brands[].name`, `tagline` and `description` are cross-checked against apps/trustedhealth/src/lib/products.ts in CI, because that file feeds /about, /technology and the footer — two copies of a product descriptor is exactly the drift this package exists to prevent.",
    "status": "approved",
    "decision": "Decided by Lennie Turner, brand owner, 2026-08-28.",
    "parent": "Trusted, Inc.",
    "slogan": "(Em)powering the healthcare workforce",
    "mission": "Helping people everywhere get care",
    "whatWeDo": "Trusted builds products that power real-time, AI-driven decisions and automations across the healthcare staffing and scheduling lifecycle.",
    "brands": [
      {
        "productId": "marketplace",
        "name": "Trusted Health",
        "tagline": "Jobs Marketplace for Clinicians",
        "voice": "clinician",
        "description": "Trusted's Marketplace is the easiest way for clinicians to connect with flexible job opportunities, matching nursing & allied professionals to contract jobs across all 50 states while managing the entire employee lifecycle through our mobile-first, self-serve platform."
      },
      {
        "productId": "works",
        "name": "Trusted Works",
        "tagline": "Staffing and Scheduling Optimization for Health Systems",
        "voice": "employer",
        "description": "Trusted Works is the leading staffing & scheduling optimization platform for hospitals & health systems, forecasting demand, balancing schedules, and automating matching & recruitment to fill every open shift in the most efficient manner."
      }
    ]
  },
  "palette": {
    "$comment": "hex is canonical. rgb and cmyk were computed from hex, and are RECORDED here rather than verified — CI stopped re-deriving them on 2026-09-02, so a hand-edit can now make them disagree with the hex. Recompute rather than trust if a print job depends on them. cmyk is a naive unmanaged conversion suitable for briefing a printer, NOT a colour-managed proof — see print.status.",
    "colors": [
      {
        "id": "mint",
        "name": "Fresh Mint",
        "role": "primary",
        "hex": "#49e1bb",
        "rgb": [
          73,
          225,
          187
        ],
        "cmyk": [
          68,
          0,
          17,
          12
        ],
        "pantone": null,
        "usage": "The primary brand colour. Graphic elements, module boxes, button fills, underlines, tints, chart series. Not a rationed accent.",
        "contrast": {
          "onWhite": 1.64,
          "onNightSky": 10.91
        },
        "status": "approved",
        "inkOn": "night-sky"
      },
      {
        "id": "night-sky",
        "name": "Night Sky",
        "role": "primary-ink",
        "hex": "#0f1041",
        "rgb": [
          15,
          16,
          65
        ],
        "cmyk": [
          77,
          75,
          0,
          75
        ],
        "pantone": null,
        "usage": "Text, dark backgrounds, high-contrast CTA. The only navy.",
        "contrast": {
          "onWhite": 17.94,
          "onMint": 10.91
        },
        "status": "approved",
        "inkOn": "white"
      },
      {
        "id": "pink",
        "name": "Party Pink",
        "role": "secondary",
        "hex": "#d7128a",
        "rgb": [
          215,
          18,
          138
        ],
        "cmyk": [
          0,
          92,
          36,
          16
        ],
        "pantone": null,
        "usage": "CTA, accent lines, graphic elements.",
        "contrast": {
          "onWhite": 4.84,
          "onNightSky": 3.71
        },
        "status": "approved",
        "inkOn": "white"
      },
      {
        "id": "gold",
        "name": "Golden Sunshine",
        "role": "secondary",
        "hex": "#f9cb32",
        "rgb": [
          249,
          203,
          50
        ],
        "cmyk": [
          0,
          18,
          80,
          2
        ],
        "pantone": null,
        "usage": "CTA, accent lines, graphic elements.",
        "contrast": {
          "onWhite": 1.54,
          "onNightSky": 11.63
        },
        "status": "approved",
        "inkOn": "night-sky"
      },
      {
        "id": "white",
        "name": "White",
        "role": "ground",
        "hex": "#ffffff",
        "rgb": [
          255,
          255,
          255
        ],
        "cmyk": [
          0,
          0,
          0,
          0
        ],
        "pantone": null,
        "usage": "Preferred background.",
        "contrast": {
          "onNightSky": 17.94
        },
        "status": "approved",
        "inkOn": "night-sky"
      },
      {
        "id": "snow",
        "name": "Snow",
        "role": "ground",
        "hex": "#f9f9f9",
        "rgb": [
          249,
          249,
          249
        ],
        "cmyk": [
          0,
          0,
          0,
          2
        ],
        "pantone": null,
        "usage": "Section background, second choice after White.",
        "contrast": {
          "onNightSky": 17.04
        },
        "status": "approved",
        "inkOn": "night-sky"
      },
      {
        "id": "cool-gray",
        "name": "Cool Gray",
        "role": "ground",
        "hex": "#ededed",
        "rgb": [
          237,
          237,
          237
        ],
        "cmyk": [
          0,
          0,
          0,
          7
        ],
        "pantone": null,
        "usage": "Section background, third choice. Use sparingly.",
        "contrast": {
          "onNightSky": 15.32
        },
        "status": "approved",
        "inkOn": "night-sky"
      },
      {
        "id": "true-black",
        "name": "True Black",
        "role": "ink",
        "hex": "#000000",
        "rgb": [
          0,
          0,
          0
        ],
        "cmyk": [
          0,
          0,
          0,
          100
        ],
        "pantone": null,
        "usage": "Text and high contrast ONLY. Never a fill or a colour block.",
        "contrast": {
          "onWhite": 21
        },
        "status": "approved",
        "inkOn": "white"
      }
    ],
    "print": {
      "status": "approved",
      "decision": "Decided by Lennie Turner, brand owner, 2026-08-26.",
      "rule": "Hex is canonical. No Pantone equivalents are specified, and none should be invented.",
      "cmyk": "The cmyk values in this file are an unmanaged algebraic conversion. They are a starting point for briefing a printer — never a proof, and never a colour match.",
      "beforeAnyRun": "Require a press proof from the vendor and check it against an on-screen reference before approving a run. Record the vendor-confirmed CMYK here afterwards, alongside the substrate and profile it was proofed on, because those values are only valid for that combination.",
      "watchFreshMint": "Fresh Mint #49E1BB is a highly saturated cyan-green at high lightness — the colour family most likely to fall outside a standard coated CMYK gamut and print duller than it appears on screen. Check it first on any proof. If mint fidelity is critical to a piece, specify a spot colour for it rather than accepting the process build.",
      "whyNoPantone": "A Pantone number is a physical ink standard. Deriving one arithmetically from a hex value produces a plausible number that a printer will actually use, which is worse than having none. Assign it from a physical book or a vendor proof, or not at all."
    },
    "$inkOn": "inkOn names the palette colour to set TEXT in when this colour is the background. Read it before putting type on any fill. It exists because every other contrast figure here describes this colour measured against a ground, which does not answer the question an agent actually has when it fills a shape.",
    "retiredButLive": {
      "status": "needs-verification",
      "what": "Two colours sit on a retired list while shipping with a real job. Worth resolving so the retired list stays meaningful, but neither is breaking anything today.",
      "cases": [
        {
          "token": "--chart-nursing",
          "colour": "the brighter mint retired by one-mint",
          "liveAs": "the nursing series in the marketplace chart",
          "options": "Recolour the series to Fresh Mint, or lift it off the retired list and record it as a secondary hue with the job 'nursing chart series'."
        },
        {
          "token": "--sec-black",
          "colour": "Space Navy, retired by one-navy",
          "liveAs": "the near-black ground under the marketplace chart",
          "options": "Recolour the ground to a depth step over Night Sky, or lift it off the retired list as a secondary hue with the job 'data ground'."
        }
      ],
      "$comment": "Colours are named by token and by brand name here, never by literal hex. A second exemption in check-retired-colours.mjs would be a second place to hide a violation; the token is also the thing you would actually change."
    }
  },
  "rules": [
    {
      "id": "one-mint",
      "title": "There is one mint",
      "topic": "colour",
      "rule": "Fresh Mint #49e1bb is the only sanctioned mint. No deep, dark or muted variant exists.",
      "retired": [
        "#087e64",
        "#0f8f6e",
        "#1f8f73",
        "#2f816d",
        "#48c7a7",
        "#34e3b4",
        "#87e0cc"
      ],
      "why": "Darkening mint to make it readable makes it a different colour.",
      "status": "approved",
      "strength": "intent"
    },
    {
      "id": "mint-fills-never-writes",
      "title": "On light, mint fills and rules — it does not write",
      "topic": "colour",
      "rule": "On a light ground, mint may be a fill, an underline, a tint, a rule, a chart series or a graphic block. It is never text and never a meaningful icon. The ink on light is Night Sky. On a dark ground mint may do both.",
      "why": "Fresh Mint on white measures 1.64:1 — far below the 4.5:1 text floor and the 3:1 floor for meaningful icons. The constraint resolves by role, not by shade.",
      "examples": {
        "link on light": "Night Sky text with a Fresh Mint underline",
        "icon on light": "Night Sky glyph, or a Night Sky glyph inside a mint fill",
        "button on light": "Fresh Mint fill with Night Sky text (10.91:1)"
      },
      "status": "approved",
      "strength": "invariant"
    },
    {
      "id": "one-navy",
      "title": "One navy, with a depth ramp",
      "topic": "colour",
      "rule": "Night Sky #0f1041 is the only navy. Depth is a black-alpha descent over it (12%, 24%, 35%), not additional named colours.",
      "retired": [
        "#0b0c2e",
        "#101235",
        "#14163f",
        "#10152f"
      ],
      "why": "The retired navies measured ΔE 3.1–4.5 apart against a just-noticeable difference of about 2.3 — several colours doing the work of one.",
      "status": "approved",
      "strength": "intent"
    },
    {
      "id": "eyebrows",
      "title": "Eyebrows take two colours, decided by the ground",
      "topic": "colour",
      "rule": "Night Sky on light, Fresh Mint on dark. Nothing else.",
      "why": "An eyebrow is small, heavy, wide-tracked uppercase — the least forgiving text there is. This pairing has headroom everywhere: 17.94:1 on white, 10.91:1 on navy.",
      "status": "approved",
      "strength": "intent"
    },
    {
      "id": "ground-follows-job",
      "title": "Ground follows the job of the surface",
      "topic": "colour",
      "rule": "Dark is the instrument — where the product is visibly doing something: product mechanics, decision logs, data set pieces. Light is the record — anything meant to be read, forwarded, printed or verified: case studies, editorial, guides, press, careers, legal.",
      "status": "approved",
      "strength": "intent"
    },
    {
      "id": "sharp-edges",
      "title": "Sharp edges everywhere",
      "topic": "shape",
      "rule": "Cards, tiles, panels and images square off. The pill is the one sanctioned curved shape, used for buttons and chips. Photographic and video media may carry a small radius so they do not read as raw rectangles.",
      "status": "approved",
      "strength": "intent"
    },
    {
      "id": "ledger-voice",
      "title": "The Ledger Voice Rule",
      "topic": "voice",
      "rule": "Anything the SYSTEM says — labels, rates, counters, log lines, axis ticks, phase names — is set in Roboto Mono. Anything a HUMAN says to the reader is set in Inter.",
      "why": "It is the load-bearing typographic distinction in the family.",
      "status": "approved",
      "strength": "intent"
    },
    {
      "id": "no-dark-mode",
      "title": "There is no user-facing dark mode",
      "topic": "colour",
      "rule": "Dark is a section-painting device, not a user preference. Nothing honours prefers-color-scheme and nothing ships a theme toggle.",
      "status": "approved",
      "strength": "statement"
    },
    {
      "id": "no-stock-photography",
      "title": "No stock photography",
      "topic": "photography",
      "rule": "Do not use stock photography. Not on the sites, not in decks, not in social, not in email. Commission it, shoot it, or use a real customer or team image with permission.",
      "why": "It reads as generic to the audience that most needs to trust us, and it carries licensing exposure.",
      "status": "approved",
      "decision": "Decided by Lennie Turner, brand owner, 2026-08-27.",
      "strength": "invariant"
    },
    {
      "id": "stylise-photography",
      "title": "Stylise photography for a consistent look",
      "topic": "photography",
      "rule": "In most cases, photography is stylised before use so that images from different shoots, sources and eras read as one brand. Ship the stylised version; keep the original as the source.",
      "how": "The existing convention names the treated file explicitly — `betty-jo-rocchio-stylized.webp`, `mercy-facility-stylized.webp` — so the stylised asset is identifiable and the untreated original is never shipped by accident.",
      "exceptions": "Press and newsroom imagery, headshots supplied by a partner, and anything where a publication requires an untreated original.",
      "status": "approved",
      "decision": "Decided by Lennie Turner, brand owner, 2026-08-27.",
      "strength": "intent"
    }
  ],
  "typography": {
    "faces": [
      {
        "id": "display",
        "family": "Inter",
        "job": "Display and headings — the brand's voice",
        "status": "approved"
      },
      {
        "id": "body",
        "family": "Inter",
        "job": "Body copy",
        "status": "approved"
      },
      {
        "id": "serif",
        "family": "Merriweather",
        "job": "Editorial serif — quotes, callouts, long-form",
        "status": "approved"
      },
      {
        "id": "mono",
        "family": "Roboto Mono",
        "job": "Ledger voice — anything the system says",
        "status": "approved",
        "note": "Functional. Sits outside the brand guideline."
      }
    ],
    "fallbacks": {
      "$comment": "For surfaces where brand fonts may not be installed — Google Slides, Docs, Office, email clients.",
      "display": [
        "Inter",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "body": [
        "Inter",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "serif": [
        "Merriweather",
        "Georgia",
        "serif"
      ],
      "mono": [
        "Roboto Mono",
        "Menlo",
        "Consolas",
        "monospace"
      ],
      "status": "approved"
    },
    "licensing": {
      "status": "approved",
      "decision": "Decided by Lennie Turner, brand owner, 2026-08-26.",
      "rule": "Inter, Merriweather and Roboto Mono are all cleared for every use Trusted makes of them — screen, print, embedding in documents and PDFs, video and broadcast, and paid media. No additional licence needs to be bought for any surface.",
      "theOnlyProhibition": "Do not sell or redistribute the font files as fonts. Embedding them in a document, a video or an application is not redistribution.",
      "why": "Inter and Merriweather are SIL Open Font License 1.1. Roboto Mono has shipped under both Apache 2.0 and OFL 1.1 depending on vintage; both permit exactly the uses above, so the clearance does not depend on resolving which applies to the vendored copy.",
      "openGap": "The three faces are self-hosted in apps/*/public/fonts without their licence text alongside. Both OFL and Apache require the licence to travel with redistributed files, and a public web font is a redistribution. See packages/brand/FONTS.md."
    },
    "eyebrow": {
      "transform": "uppercase",
      "tracking": "0.14em",
      "weight": "heavy",
      "status": "approved"
    }
  },
  "logo": {
    "variants": [
      {
        "id": "th-lockup-navy",
        "brand": "trusted-health",
        "kind": "lockup",
        "ground": "light",
        "aspectRatio": 4.6,
        "path": "apps/trustedhealth/public/assets/logo/trusted-lockup-navy.svg",
        "url": "/assets/logo/trusted-lockup-navy.svg",
        "use": "Primary Trusted lockup — mark and wordmark. The default whenever there is room for it.",
        "kitFile": "logos/trusted-health/trusted-lockup-navy.svg",
        "pngUrl": "/assets/logos-png/trusted-health/trusted-lockup-navy.png"
      },
      {
        "id": "th-lockup-black",
        "brand": "trusted-health",
        "kind": "lockup",
        "ground": "light",
        "aspectRatio": 4.6,
        "path": "apps/trustedhealth/public/assets/logo/trusted-lockup-black.svg",
        "url": "/assets/logo/trusted-lockup-black.svg",
        "use": "Single-ink lockup for light grounds where the palette cannot reproduce.",
        "kitFile": "logos/trusted-health/trusted-lockup-black.svg",
        "pngUrl": "/assets/logos-png/trusted-health/trusted-lockup-black.png"
      },
      {
        "id": "th-lockup-white",
        "brand": "trusted-health",
        "kind": "lockup",
        "ground": "dark",
        "aspectRatio": 4.6,
        "path": "apps/trustedhealth/public/assets/logo/trusted-lockup-white.svg",
        "url": "/assets/logo/trusted-lockup-white.svg",
        "use": "Lockup for dark grounds.",
        "kitFile": "logos/trusted-health/trusted-lockup-white.svg",
        "pngUrl": "/assets/logos-png/trusted-health/trusted-lockup-white.png"
      },
      {
        "id": "th-mark-navy",
        "brand": "trusted-health",
        "kind": "mark",
        "ground": "light",
        "aspectRatio": 0.8353,
        "path": "apps/trustedhealth/public/assets/logo/trusted-t-navy.svg",
        "url": "/assets/logo/trusted-t-navy.svg",
        "use": "Default mark on light grounds.",
        "kitFile": "logos/trusted-health/trusted-t-navy.svg",
        "pngUrl": "/assets/logos-png/trusted-health/trusted-t-navy.png"
      },
      {
        "id": "th-mark-navy-white",
        "brand": "trusted-health",
        "kind": "mark",
        "ground": "brand",
        "aspectRatio": 0.8353,
        "path": "apps/trustedhealth/public/assets/logo/trusted-t-navy-white.svg",
        "url": "/assets/logo/trusted-t-navy-white.svg",
        "use": "Knockout mark for saturated brand grounds — Fresh Mint, Party Pink, Golden Sunshine. The crossbar is a white knockout, so it disappears on white and the body disappears on navy.",
        "kitFile": "logos/trusted-health/trusted-t-navy-white.svg",
        "pngUrl": "/assets/logos-png/trusted-health/trusted-t-navy-white.png"
      },
      {
        "id": "th-mark-for-light",
        "brand": "trusted-health",
        "kind": "mark",
        "ground": "light",
        "aspectRatio": 0.8353,
        "path": "apps/trustedhealth/public/assets/logo/trusted-t-light.svg",
        "url": "/assets/logo/trusted-t-light.svg",
        "use": "Navy and mint mark for light grounds.",
        "kitFile": "logos/trusted-health/trusted-t-light.svg",
        "pngUrl": "/assets/logos-png/trusted-health/trusted-t-light.png"
      },
      {
        "id": "th-mark-for-dark",
        "brand": "trusted-health",
        "kind": "mark",
        "ground": "dark",
        "aspectRatio": 0.8353,
        "path": "apps/trustedhealth/public/assets/logo/trusted-t-dark.svg",
        "url": "/assets/logo/trusted-t-dark.svg",
        "use": "Mint and white mark for dark grounds.",
        "kitFile": "logos/trusted-health/trusted-t-dark.svg",
        "pngUrl": "/assets/logos-png/trusted-health/trusted-t-dark.png"
      },
      {
        "id": "th-mark-black",
        "brand": "trusted-health",
        "kind": "mark",
        "ground": "light",
        "aspectRatio": 0.8353,
        "path": "apps/trustedhealth/public/assets/logo/trusted-t-black.svg",
        "url": "/assets/logo/trusted-t-black.svg",
        "use": "Near-black and mint mark, for light grounds where navy is unavailable.",
        "kitFile": "logos/trusted-health/trusted-t-black.svg",
        "pngUrl": "/assets/logos-png/trusted-health/trusted-t-black.png"
      },
      {
        "id": "th-mark-black-solid",
        "brand": "trusted-health",
        "kind": "mark",
        "ground": "light",
        "aspectRatio": 0.8353,
        "path": "apps/trustedhealth/public/assets/logo/trusted-t-black-solid.svg",
        "url": "/assets/logo/trusted-t-black-solid.svg",
        "use": "Single-colour reproduction — stamp, engraving, fax.",
        "kitFile": "logos/trusted-health/trusted-t-black-solid.svg",
        "pngUrl": "/assets/logos-png/trusted-health/trusted-t-black-solid.png"
      },
      {
        "id": "th-wordmark-navy",
        "brand": "trusted-health",
        "kind": "wordmark",
        "ground": "light",
        "aspectRatio": 5.3571,
        "path": "apps/trustedhealth/public/assets/wordmark-navy.svg",
        "url": "/assets/wordmark-navy.svg",
        "use": "Wordmark on light grounds.",
        "kitFile": "logos/trusted-health/wordmark-navy.svg",
        "pngUrl": "/assets/logos-png/trusted-health/wordmark-navy.png"
      },
      {
        "id": "th-wordmark-black",
        "brand": "trusted-health",
        "kind": "wordmark",
        "ground": "light",
        "aspectRatio": 5.3571,
        "path": "apps/trustedhealth/public/assets/wordmark-black.svg",
        "url": "/assets/wordmark-black.svg",
        "use": "Single-colour wordmark on light grounds.",
        "kitFile": "logos/trusted-health/wordmark-black.svg",
        "pngUrl": "/assets/logos-png/trusted-health/wordmark-black.png"
      },
      {
        "id": "th-wordmark-white",
        "brand": "trusted-health",
        "kind": "wordmark",
        "ground": "dark",
        "aspectRatio": 5.3393,
        "path": "apps/trustedhealth/public/assets/wordmark-white.svg",
        "url": "/assets/wordmark-white.svg",
        "use": "Wordmark on dark grounds.",
        "kitFile": "logos/trusted-health/wordmark-white.svg",
        "pngUrl": "/assets/logos-png/trusted-health/wordmark-white.png"
      },
      {
        "id": "th-logomark-mint",
        "brand": "trusted-health",
        "kind": "logomark",
        "ground": "dark",
        "aspectRatio": 0.8571,
        "path": "apps/trustedhealth/public/assets/logomark-mint-white.svg",
        "url": "/assets/logomark-mint-white.svg",
        "use": "Compact logomark on dark grounds.",
        "kitFile": "logos/trusted-health/logomark-mint-white.svg",
        "pngUrl": "/assets/logos-png/trusted-health/logomark-mint-white.png"
      },
      {
        "id": "works-lockup-navy",
        "brand": "trusted-works",
        "kind": "lockup",
        "ground": "light",
        "aspectRatio": 5.8125,
        "path": "apps/trustedhealth/public/assets/press-kit/trusted-works-lockup-navy.svg",
        "url": "/assets/press-kit/trusted-works-lockup-navy.svg",
        "use": "Primary Trusted Works lockup on light grounds.",
        "kitFile": "logos/trusted-works/trusted-works-lockup-navy.svg",
        "pngUrl": "/assets/logos-png/trusted-works/trusted-works-lockup-navy.png"
      },
      {
        "id": "works-lockup-white",
        "brand": "trusted-works",
        "kind": "lockup",
        "ground": "dark",
        "aspectRatio": 5.8125,
        "path": "apps/trustedhealth/public/assets/brand/trusted-works-lockup-white.svg",
        "url": "/assets/brand/trusted-works-lockup-white.svg",
        "use": "Primary lockup on dark grounds.",
        "kitFile": "logos/trusted-works/trusted-works-lockup-white.svg",
        "pngUrl": "/assets/logos-png/trusted-works/trusted-works-lockup-white.png"
      },
      {
        "id": "works-lockup-mono-navy",
        "brand": "trusted-works",
        "kind": "lockup",
        "ground": "light",
        "aspectRatio": 5.8125,
        "path": "apps/trustedhealth/public/assets/brand/trusted-works-lockup-mono-navy.svg",
        "url": "/assets/brand/trusted-works-lockup-mono-navy.svg",
        "use": "Single-colour lockup where mint cannot reproduce.",
        "kitFile": "logos/trusted-works/trusted-works-lockup-mono-navy.svg",
        "pngUrl": "/assets/logos-png/trusted-works/trusted-works-lockup-mono-navy.png"
      },
      {
        "id": "works-lockup-mono-white",
        "brand": "trusted-works",
        "kind": "lockup",
        "ground": "dark",
        "aspectRatio": 5.8125,
        "path": "apps/trustedhealth/public/assets/brand/trusted-works-lockup-mono-white.svg",
        "url": "/assets/brand/trusted-works-lockup-mono-white.svg",
        "use": "Single-colour lockup on dark grounds.",
        "kitFile": "logos/trusted-works/trusted-works-lockup-mono-white.svg",
        "pngUrl": "/assets/logos-png/trusted-works/trusted-works-lockup-mono-white.png"
      },
      {
        "id": "works-lockup-stacked-navy",
        "brand": "trusted-works",
        "kind": "lockup",
        "ground": "light",
        "aspectRatio": 3.5312,
        "path": "apps/trustedhealth/public/assets/brand/trusted-works-lockup-stacked-navy.svg",
        "url": "/assets/brand/trusted-works-lockup-stacked-navy.svg",
        "use": "Stacked lockup for narrow or square placements.",
        "kitFile": "logos/trusted-works/trusted-works-lockup-stacked-navy.svg",
        "pngUrl": "/assets/logos-png/trusted-works/trusted-works-lockup-stacked-navy.png"
      },
      {
        "id": "works-lockup-stacked-white",
        "brand": "trusted-works",
        "kind": "lockup",
        "ground": "dark",
        "aspectRatio": 3.5312,
        "path": "apps/trustedhealth/public/assets/brand/trusted-works-lockup-stacked-white.svg",
        "url": "/assets/brand/trusted-works-lockup-stacked-white.svg",
        "use": "Stacked lockup on dark grounds.",
        "kitFile": "logos/trusted-works/trusted-works-lockup-stacked-white.svg",
        "pngUrl": "/assets/logos-png/trusted-works/trusted-works-lockup-stacked-white.png"
      },
      {
        "id": "works-wordmark-navy",
        "brand": "trusted-works",
        "kind": "wordmark",
        "ground": "light",
        "aspectRatio": 2.4375,
        "path": "apps/trustedhealth/public/assets/press-kit/works-wordmark-navy.svg",
        "url": "/assets/press-kit/works-wordmark-navy.svg",
        "use": "Works wordmark alone, where Trusted is already established.",
        "kitFile": "logos/trusted-works/works-wordmark-navy.svg",
        "pngUrl": "/assets/logos-png/trusted-works/works-wordmark-navy.png"
      },
      {
        "id": "works-wordmark-white",
        "brand": "trusted-works",
        "kind": "wordmark",
        "ground": "dark",
        "aspectRatio": 2.4375,
        "path": "apps/trustedhealth/public/assets/brand/works-wordmark-white.svg",
        "url": "/assets/brand/works-wordmark-white.svg",
        "use": "Works wordmark on dark grounds.",
        "kitFile": "logos/trusted-works/works-wordmark-white.svg",
        "pngUrl": "/assets/logos-png/trusted-works/works-wordmark-white.png"
      },
      {
        "id": "works-ai-wordmark-black",
        "brand": "works-ai",
        "kind": "wordmark",
        "ground": "light",
        "aspectRatio": 3.9583,
        "path": "apps/trustedhealth/public/assets/brand/works-ai-wordmark-black.svg",
        "url": "/assets/brand/works-ai-wordmark-black.svg",
        "use": "Domain wordmark on light grounds, for the product's own web property.",
        "kitFile": "logos/works-ai/works-ai-wordmark-black.svg",
        "pngUrl": "/assets/logos-png/works-ai/works-ai-wordmark-black.png"
      },
      {
        "id": "works-ai-wordmark-white",
        "brand": "works-ai",
        "kind": "wordmark",
        "ground": "dark",
        "aspectRatio": 3.9583,
        "path": "apps/trustedhealth/public/assets/brand/works-ai-wordmark-white.svg",
        "url": "/assets/brand/works-ai-wordmark-white.svg",
        "use": "Domain wordmark on dark grounds, for the product's own web property.",
        "kitFile": "logos/works-ai/works-ai-wordmark-white.svg",
        "pngUrl": "/assets/logos-png/works-ai/works-ai-wordmark-white.png"
      }
    ],
    "clearSpace": {
      "status": "approved",
      "decision": "Decided by Lennie Turner, brand owner, 2026-08-26.",
      "rule": "Clear space on all four sides equals 25% of the mark's height. For a lockup, it equals the height of the 't' mark inside that lockup.",
      "enforcement": "Nothing enters that zone — no type, image, rule, edge or another logo. When in doubt, give it more."
    },
    "minSize": {
      "status": "approved",
      "rule": {
        "mark": {
          "screenPx": 24,
          "printMm": 8,
          "note": "Below roughly 24px the counterform inside the T begins to fill in."
        },
        "horizontalLockup": {
          "screenPx": 140,
          "printMm": 32,
          "note": "Measured on width. At 140px wide the 186x32 lockup is 24px tall and its wordmark still reads; below about 120px it does not."
        },
        "stackedLockup": {
          "screenPx": 100,
          "printMm": 24,
          "note": "Measured on width, for narrow and square placements."
        },
        "wordmark": {
          "screenPx": 100,
          "printMm": 24,
          "note": "Measured on width."
        }
      },
      "belowMinimum": "Use the mark alone rather than shrinking a lockup past its floor. A lockup that cannot be read is worse than a mark that can."
    },
    "misuse": {
      "status": "approved",
      "rules": [
        "Do not recolour the mark to anything outside the palette.",
        "Do not place the navy mark on a dark ground, or the light mark on a light ground — pick the variant that matches the ground.",
        "Do not stretch, skew, rotate or add effects (shadow, glow, bevel, outline).",
        "Do not place the mark over a busy area of a photograph; use a clear area or a solid plate.",
        "Do not rebuild the lockup by setting the wordmark next to the mark — use the supplied lockup file.",
        "Do not use the mark as a repeating pattern or a background texture."
      ]
    },
    "$comment": "Assets are referenced, not duplicated, so each file has one copy. `ground` is the ground the mark is FOR, derived from its actual fills — not a guess from the filename. Rendering a light-ground mark on dark (or the reverse) makes it invisible, which is exactly what happened on the first version of /brand. `aspectRatio` is width/height from the artwork viewBox; wordmarks and lockups are wide and must never be forced into a square box.",
    "grounds": {
      "light": "White, Snow or Cool Gray.",
      "dark": "Night Sky, or a photograph dark enough to hold white ink.",
      "brand": "A saturated brand colour — Fresh Mint, Party Pink, Golden Sunshine. Marks that mix navy and white knockout need this; they break on both white and navy."
    },
    "colourChoice": {
      "status": "approved",
      "decision": "Decided by Lennie Turner, brand owner, 2026-08-27.",
      "default": "Navy is the default. Black is a sanctioned secondary style choice — reach for it deliberately, not only when colour cannot reproduce.",
      "rules": [
        {
          "use": "Navy — th-mark-navy, th-wordmark-navy, works-lockup-navy",
          "when": "Every ordinary light-ground placement: web, decks, documents, signage, full-colour print."
        },
        {
          "use": "Near-black with mint — th-mark-black",
          "when": "A deliberate mono or editorial treatment, a light ground where navy competes with the imagery, or a partner template that expects neutral ink. A style choice, not only a fallback."
        },
        {
          "use": "Single ink — th-mark-black-solid, th-wordmark-black",
          "when": "One-colour reproduction — engraving, embroidery in a single thread, laser etch, stamps, fax, newsprint — and any deliberate single-ink treatment."
        },
        {
          "use": "Mono lockups — works-lockup-mono-navy, works-lockup-mono-white",
          "when": "The Works lockup where mint cannot reproduce but a single brand ink can."
        }
      ],
      "neverDo": "Do not mix: pick navy or black for a given surface and stay with it. A deck that alternates reads as an accident rather than a choice."
    },
    "missing": {
      "status": "needs-owner",
      "worksW": "A standalone Trusted Works 'W' logomark does not exist — not as artwork, and not as a favicon, so the product's browser tab shows the parent Trusted mark. It needs real artwork from design: cropping the 'w' out of the wordmark would violate this file's own rule against rebuilding marks from parts."
    }
  },
  "surfaces": {
    "$comment": "Dimensions an agent needs to actually produce an artifact. Platform specs change; verify before a launch that depends on one.",
    "presentation": {
      "status": "approved",
      "slideSize": {
        "ratio": "16:9",
        "px": [
          1920,
          1080
        ]
      },
      "ground": "Light by default — a deck is a record, per ground-follows-job. Use dark only for a slide that demonstrates the product working.",
      "titleFace": "display",
      "bodyFace": "body",
      "dataFace": "mono",
      "accent": "Mint fills and rules. On light slides, headings and body are Night Sky."
    },
    "social": {
      "status": "needs-verification",
      "note": "Platform-published specs as of 2026-08. Verify before a campaign.",
      "profileImagePx": [
        400,
        400
      ],
      "linkedinBannerPx": [
        1584,
        396
      ],
      "xHeaderPx": [
        1500,
        500
      ],
      "openGraphPx": [
        1200,
        630
      ],
      "squarePostPx": [
        1080,
        1080
      ],
      "safeArea": "Keep the mark and any type at least 8% in from every edge — platforms crop differently across surfaces.",
      "postLengthChars": [
        138,
        150
      ],
      "hashtags": {
        "perPost": [
          5,
          9
        ],
        "maxCharsEach": 24
      },
      "instagramPx": {
        "square": [
          1080,
          1080
        ],
        "portrait": [
          1080,
          1350
        ],
        "landscape": [
          1080,
          608
        ]
      },
      "callToAction": "Every post carries one — a follow, a like or a link click.",
      "contentNote": "A lifestyle feed, not a business one: post what clinicians find interesting, which need not be about Trusted. Behind-the-scenes and personal images build the in-group feel."
    },
    "email": {
      "status": "approved",
      "bodyWidthPx": 600,
      "ground": "White or Snow. Email clients render dark grounds unpredictably and many strip background colours.",
      "face": "Use the fallback stack, not the brand face — most clients will not load a web font.",
      "note": "Mint fills survive as table cell backgrounds; mint text does not meet contrast and is also the first thing a client's dark-mode transform breaks."
    },
    "document": {
      "status": "approved",
      "decision": "Decided by Lennie Turner, brand owner, 2026-08-26.",
      "page": {
        "size": "US Letter, 8.5 x 11in",
        "marginsIn": {
          "top": 1,
          "bottom": 0.75,
          "left": 1,
          "right": 1
        }
      },
      "logo": {
        "variant": "th-wordmark-navy",
        "position": "top left, aligned to the left margin",
        "heightIn": 0.32
      },
      "type": {
        "body": "Inter 10.5pt on 15pt",
        "heading": "Inter 14pt semibold",
        "ground": "White"
      },
      "footer": {
        "entity": "Trusted, Inc.",
        "disclaimer": "Trusted, Inc. is not affiliated with Trusted Nurse Staffing LLC",
        "note": "The disclaimer already appears in the site footer and belongs on outbound correspondence for the same reason. Confirm the registered address with legal before the first print run rather than copying it from an inbound letter."
      },
      "continuationPages": "No logo. Page number bottom right, Inter 9pt."
    }
  },
  "voice": {
    "owner": "Lennie Turner",
    "status": "approved",
    "$comment": "Two audiences, deliberately different registers. Read the one matching who you are writing to; `relationshipToClinicianVoice` explains what carries across.",
    "clinician": {
      "scope": "trusted-health",
      "sources": [
        "Brand voice document (values, archetype, write/don't-write pairs)",
        "Instagram guidelines (personality, social cadence)",
        "www.trustedhealth.com homepage copy, read 2026-08-26"
      ],
      "values": [
        {
          "id": "empowering",
          "statement": "We leverage technology so nurses can understand and connect to opportunities with unparalleled transparency and efficiency.",
          "writeLikeThis": "We leverage technology to enable modern nurses to understand and connect to opportunities with unparalleled transparency and efficiency.",
          "notLikeThis": "There are countless career directions for nursing pros. If your goal is to find more independence in your work, becoming a nurse practitioner can be a great option.",
          "why": "Solve a problem by addressing the need, not by offering generic information.",
          "title": "Empowering"
        },
        {
          "id": "ambitious",
          "statement": "We go after the best opportunities for our clinicians to grow professionally.",
          "writeLikeThis": "We want nurses to have increased flexibility and control over their careers to pursue diverse opportunities.",
          "notLikeThis": "We want you to have the best opportunities possible to feel fulfilled in your career.",
          "why": "Draw them in with competence and care. Never salesy, never preachy, no gimmicks.",
          "title": "Ambitious"
        },
        {
          "id": "relatable",
          "statement": "We aren't recruiters or salespeople — we're nurses. We understand the need because we have had it.",
          "writeLikeThis": "Welcome to the Trusted fam! We're super psyched to have you on board. Let me know what questions you have or how I can help out at any point!",
          "notLikeThis": "Welcome to Trusted Health. We are looking forward to working with you and helping you accomplish your career goals. Please let us know how we may assist you throughout your employment.",
          "why": "We write how we speak — the way we would talk to a friend or colleague. Never stiff, never formal.",
          "title": "Relatable"
        }
      ],
      "tone": [
        "Excited, raw, funny, with an edge",
        "Friend to friend — never brand to user",
        "Sarcasm is fine; snideness and punching down are not",
        "Talk TO them, never AT them, and never about them",
        "Straightforward and clear — edge is not the same as vague",
        "Use language to educate and help, not to impress",
        "Ask open-ended questions",
        "Assume they are smart, busy, and have heard every pitch"
      ],
      "patterns": {
        "$comment": "Observable in shipped homepage copy — these are what the voice actually looks like, not aspirations.",
        "rules": [
          {
            "rule": "Second person, always. The reader is 'you'; Trusted is 'we'.",
            "example": "You're never alone. Your dedicated Advocate is here as much—or little—as you need."
          },
          {
            "rule": "Short declaratives, where a second sentence turns the first.",
            "example": "The best contracts go fast. So do we. / A better experience didn't exist. So we built it."
          },
          {
            "rule": "Name the pain, then remove it.",
            "example": "No more back & forth. / Forget the haggle."
          },
          {
            "rule": "Concrete over abstract — a number or a thing, not a claim.",
            "example": "See real pay for your role in any city. No resume or phone call required."
          },
          {
            "rule": "Contractions everywhere. Writing that cannot be read aloud is wrong.",
            "example": "We might be tech-first, but you'll always be in good hands with us."
          },
          {
            "rule": "Calls to action are written in the reader's voice, not commanded at them.",
            "example": "Show me matches → · Show me the $$$ → (not 'Get started' or 'Submit')"
          },
          {
            "rule": "'Trusted Fam' is the in-group term for clinicians and is used sincerely.",
            "example": "Join Over 1 Million Clinicians In the Trusted Fam"
          }
        ]
      },
      "valueStatementFormula": "Trusted Health [does this] to help [these people] with [this problem]. Example: Trusted Health enables nurses to find opportunities and take control of their careers.",
      "status": "approved",
      "audience": "A younger, hip, tech-savvy clinician — a few years in, lives on their phone, fluent in the internet, and allergic to being marketed to. NOT clinicians broadly, and never the generic caregiver.",
      "register": "A friend talking to a friend. Not brand to user, not mentor to mentee, not institution to caregiver. Two peers who do the same work, one of whom found something good.",
      "characteristics": {
        "status": "approved",
        "decision": "Decided by Lennie Turner, brand owner, 2026-08-27.",
        "note": "Characteristics, deliberately — not a persona, a role or a celebrity. A named person dates and carries whatever they do next; a role implies a seniority gradient this voice does not have.",
        "traits": [
          {
            "id": "excited",
            "trait": "Excited",
            "means": "Genuinely into this, and it shows. Enthusiasm is allowed to be visible rather than managed.",
            "sounds_like": "A better experience didn't exist. So we built it."
          },
          {
            "id": "raw",
            "trait": "Raw",
            "means": "Says the real thing. Names what actually sucks about the work without sanding it into HR language.",
            "sounds_like": "Forget the haggle. / No more back & forth."
          },
          {
            "id": "funny",
            "trait": "Funny",
            "means": "Earns the laugh rather than performing one. Dry, quick, never a punchline that costs credibility.",
            "sounds_like": "Show me the $$$ →"
          },
          {
            "id": "edged",
            "trait": "Edged",
            "means": "Has a point of view and will take a side. Mild sarcasm is fine. Toothless positivity is not.",
            "sounds_like": "We replaced the old-school staffing agency with a simple app that puts you in the driver's seat."
          },
          {
            "id": "peer",
            "trait": "A peer",
            "means": "Same level, same job, no gradient. Never explains the reader's own profession back to them.",
            "sounds_like": "Join Over 1 Million Clinicians In the Trusted Fam"
          },
          {
            "id": "tech-fluent",
            "trait": "Tech-fluent",
            "means": "Assumes the reader is comfortable with apps and lives on their phone. Never explains technology to them.",
            "sounds_like": "The only app that shows you all the jobs, and all the details, all the time."
          }
        ]
      },
      "avoid": [
        "Vocational-awe language — 'heroes', 'angels', 'caregivers', 'called to serve'. It is the register they are escaping.",
        "Generic healthcare-marketing warmth that could belong to a hospital system or an insurer.",
        "Explaining technology, or the reader's own profession, back to them.",
        "Toothless positivity. If it could not be disagreed with, it is not saying anything.",
        "Corporate hedging — 'we strive to', 'we are committed to', 'solutions'.",
        "Speaking to 'clinicians' as an undifferentiated group when the reader is a specific person a few years into their career."
      ],
      "tensionToWatch": "Some shipped copy is warmer and more reassuring than this brief — 'You're never alone. Your dedicated Advocate is here as much—or little—as you need.' That is supportive rather than raw. It is not wrong, but the voice is now edgier than parts of the live site, so new copy should lead the site rather than match it."
    },
    "employer": {
      "status": "approved",
      "audience": "Health-system buyers and operators: nursing executives, frontline managers, HR, finance and operations.",
      "scope": "trusted-works",
      "$comment": "Employer voice, derived from live Trusted Works homepage copy and approved by the brand owner on 2026-08-26. Extend it as sales decks, one-pagers and outbound email are written; those should conform to this rather than redefine it.",
      "sources": [
        "Trusted Works homepage copy, read 2026-08-26"
      ],
      "relationshipToClinicianVoice": "Same person, different room. Second person and 'we' carry over, as does the two-beat sentence where the second line turns the first. What changes is register: drier wit, every claim backed by proof, and the anxiety answered is operational risk rather than career control.",
      "patterns": {
        "rules": [
          {
            "rule": "Answer the rip-and-replace fear first. Trusted is additive to the stack, never a migration.",
            "example": "We make your existing tech smart. / Built Around Your Existing Systems / We play nice with most* cloud providers."
          },
          {
            "rule": "Proof, not adjectives. Quantify the outcome or name the customer.",
            "example": "12 weeks of decisions, resolved before anyone had to pick up a phone."
          },
          {
            "rule": "Never choose between the two constituencies — clinicians and the institution appear in the same sentence.",
            "example": "We create products that clinicians love and drive results that hospitals need. / Loved by visionary leaders and busy clinicians."
          },
          {
            "rule": "Dry wit, lightly used. The joke never costs credibility, and it carries its own asterisk.",
            "example": "We play nice with most* cloud providers."
          },
          {
            "rule": "Name the reader's function rather than addressing a generic buyer.",
            "example": "By function: Nursing Executives · Frontline Managers · Human Resources · Finance & Operations"
          },
          {
            "rule": "Calls to action stay warm and low-commitment — a conversation, not a procurement step.",
            "example": "Let's Chat · Get a Demo · We'd love to show you how we can help. (not 'Request a consultation')"
          },
          {
            "rule": "Confidence without hype. Say the capability plainly and let the proof carry it.",
            "example": "Intelligence you can trust. / Staffing & scheduling built for the future right now."
          }
        ]
      },
      "tone": [
        "Warm but businesslike — the clinician warmth, without the sarcasm",
        "Confident and plain; no hype adjectives, no superlative stacking",
        "Evidence-led: a number, a named system or a named customer beats a claim",
        "Reassuring about risk — additive, integrated, safe",
        "Respects the reader's time and expertise; never explains their own job to them"
      ],
      "avoid": [
        "The clinician register — sarcasm, '$$$', 'fam' and playful slang read as unserious to a CFO",
        "Rip-and-replace or displacement language, which triggers the exact objection the copy exists to answer",
        "Vendor hype ('revolutionary', 'best-in-class', 'game-changing') — the proof points are stronger than any adjective"
      ],
      "approval": "Approved by Lennie Turner, brand owner, 2026-08-26, on the strength of the employer homepage derivation."
    }
  },
  "elements": {
    "status": "approved",
    "decision": "Decided by Lennie Turner, brand owner, 2026-08-27.",
    "shape": {
      "rule": "Sharp edges everywhere. Cards, tiles, panels, images and data cells square off.",
      "pill": "The pill is the one sanctioned curved shape, used for buttons and chips (radius 80px).",
      "media": "Photographic and video media may carry a small radius (works uses 12px) so they do not read as raw rectangles. That is the only deviation.",
      "why": "A stock component arriving rounded is not a reason to round it. Sharpness is the brand's posture; the pill is the deliberate exception.",
      "radius": [
        {
          "element": "card, panel, surface",
          "token": "--radius-card / --radius-surface",
          "value": "0"
        },
        {
          "element": "tile, data cell",
          "token": "--radius-tile",
          "value": "0"
        },
        {
          "element": "button, chip, control",
          "token": "--radius-control",
          "value": "80px (pill)"
        },
        {
          "element": "photographic and video media",
          "token": "--radius-image",
          "value": "0 on Trusted Health · 12px on Works — see divergence"
        },
        {
          "element": "input, form field",
          "token": "inherits control",
          "value": "80px (pill)"
        }
      ],
      "borders": "One hairline at 1px. 2px is reserved for a deliberate accent — a mint underline under a heading — and is never a container edge.",
      "divergence": {
        "status": "needs-verification",
        "what": "The two apps disagree on media radius. Trusted Health inherits --radius-image: 0 and squares photographs; Works overrides it to 0.75rem (12px). The rule as written permits both, because it says media 'may' carry a small radius.",
        "why_it_matters": "Photography is the most visible surface either site has, and the same case-study image can appear on both. Right now it is square on one and rounded on the other.",
        "recommendation": "Converge on 12px when someone is next in this area — sharp edges is a rule about structure, and media is where the brief already grants the exception. Not urgent, and not a defect: two surfaces made different reasonable calls."
      }
    },
    "elevation": {
      "rule": "Depth on a dark ground is white-alpha over whatever ground the element sits on — never a new hue, never a darker navy.",
      "steps": [
        {
          "level": "card on ground",
          "alpha": 0.09
        },
        {
          "level": "instrument panel inside a card",
          "alpha": 0.16
        },
        {
          "level": "hairline bounding a surface",
          "alpha": 0.22
        },
        {
          "level": "band boundary between sections",
          "alpha": 0.14
        }
      ]
    },
    "shadow": {
      "rule": "A shadow asserts that an element hovers, and is reserved for elements that genuinely do. It is never a substitute for elevation and never decoration.",
      "sanctioned": "0 24px 70px rgba(5, 9, 18, 0.12)"
    },
    "borders": {
      "rule": "One hairline weight. A border earns its place by bounding a surface, not by decorating it."
    },
    "spacing": {
      "status": "approved",
      "scale": [
        "0.25rem",
        "0.5rem",
        "0.75rem",
        "1rem",
        "1.5rem",
        "2rem",
        "3rem",
        "4rem",
        "6rem"
      ],
      "rule": "Space comes from the scale. A value between two steps is drift, and it is how a layout stops feeling like one system.",
      "section": {
        "vertical": "96px between major sections, fluid via --section-block (4.5rem to 8rem)",
        "horizontal": "56px, with --layout-gutter fluid from 1.25rem to 3.5rem"
      }
    },
    "layout": {
      "status": "approved",
      "widths": [
        {
          "name": "content",
          "value": "1120px",
          "use": "Default reading and section width."
        },
        {
          "name": "prose",
          "value": "65ch",
          "use": "Long-form editorial measure. Never wider — line length governs, not the container."
        },
        {
          "name": "wide",
          "value": "90rem",
          "use": "Full-bleed data set pieces and galleries."
        },
        {
          "name": "footer",
          "value": "1200px",
          "use": "Footer only."
        }
      ],
      "rule": "Long-form text is measured in characters, not pixels. Everything else is measured in the container."
    },
    "motion": {
      "status": "approved",
      "durations": [
        {
          "name": "fast",
          "value": "120ms",
          "use": "State change on a control — hover, focus, toggle."
        },
        {
          "name": "glass",
          "value": "550ms",
          "use": "Surface and panel transitions."
        },
        {
          "name": "enter",
          "value": "700ms",
          "use": "An element arriving on first view."
        }
      ],
      "easing": [
        {
          "name": "standard",
          "value": "cubic-bezier(0.4, 0, 0.2, 1)",
          "use": "Most transitions."
        },
        {
          "name": "enter",
          "value": "cubic-bezier(0.16, 1, 0.3, 1)",
          "use": "Entrances — decelerates hard, so the element settles rather than stops."
        }
      ],
      "rule": "Motion explains a change; it does not decorate one. If removing the animation loses no information, remove it.",
      "reducedMotion": "Every motion needs a prefers-reduced-motion equivalent that still communicates the change. An animation with no reduced-motion path is unfinished, not optional."
    },
    "dataViz": {
      "status": "approved",
      "grid": "White-alpha over the ground — 0.08 subtle, 0.16 standard, 0.32 for a guide line. Never a solid grey.",
      "rule": "Data lives on dark. Labels, rates, axis ticks and counters are Roboto Mono per the Ledger Voice Rule; a chart is the system speaking.",
      "note": "The two series colours are chart-specific and sit outside the core palette. Do not reuse them as brand colours.",
      "seriesConflict": "See palette.retiredButLive."
    },
    "colourBlocks": {
      "status": "needs-verification",
      "backgroundHierarchy": {
        "status": "approved",
        "rule": "White is the preferred background. Snow is the second choice. Cool Gray is the third and is used sparingly.",
        "note": "Stated in the one-sheet as 'preferred / option 2 / option 3 — use at a minimum'. It was previously split across three separate colour usage strings, which is not how anyone reads a hierarchy."
      },
      "tintVsSaturated": {
        "rule": "Large areas take a tint. Full-saturation brand colour is for small, deliberate moments — a hero field, a button, a plate behind a mark.",
        "why": "Fresh Mint at full strength across a section leaves no headroom for the thing that is supposed to stand out on it."
      },
      "moduleBox": {
        "rule": "A module box is a filled block that carries content — a stat, a quote, a callout, a step. It takes a tint or a brand colour as its ground, squares off per the shape rule, and its ink follows the ground: Night Sky on light and tinted grounds, white on Night Sky."
      },
      "accentLine": {
        "status": "needs-verification",
        "rule": "A short rule in a brand colour, used to mark a heading or bound a block — not a container edge.",
        "variation": "Production runs 2px, 3px and 4px in mint. Worth converging on one weight so the device reads as deliberate, but this is tidying rather than a defect — pick one when someone is next in this area."
      },
      "graphicElements": {
        "status": "needs-verification",
        "note": "'Graphic elements' appears against mint, Party Pink and Golden Sunshine in the one-sheet and is nowhere defined. Read it as: a brand colour may carry a non-textual graphic form. Worth tightening if it starts being used to justify anything."
      },
      "neverAColourBlock": "True Black is text and high contrast only. It is never a fill and never a colour block.",
      "source": "Background hierarchy is the 2023 one-sheet verbatim. The rest is reconstructed from live use and unverified against the original."
    }
  },
  "howToRead": {
    "status": "approved",
    "summary": "This describes what Trusted is aiming at, not a specification the live sites are audited against. Adhere to it by default and deviate deliberately.",
    "strengths": {
      "invariant": "Do not deviate. Few, and each carries a cost beyond taste — accessibility, licensing, or someone else's guidelines.",
      "intent": "The goal. Follow it by default; a considered deviation with a reason is fine, an accidental one is drift.",
      "statement": "A description of how things are today, recorded so nobody re-derives it. Not an instruction."
    },
    "onVariation": "Where the live sites differ, that is not automatically a defect — some variation is a surface making a reasonable local choice. What matters is that it was chosen.",
    "whatIsNotFlexible": "The invariants above, and the values themselves — a hex is a hex. Everything else is judgement."
  }
}