{
  "$comment": "The Zenith Suite — machine-readable reference. Six apps and their shared layer, structured for assistants and tooling. Human manual: /user-guide/ · plain text: /user-guide/zenith-manual.md. Where a fact was not verifiable in an app's source it is omitted here rather than guessed.",
  "suite": {
    "name": "Zenith Suite",
    "developer": "Black Syntax",
    "publisher": "Friend Castle",
    "contact": "support@zenithsuite.app",
    "site": "https://zenithsuite.app/",
    "platform": "Android 8.0+ (minSdk 26)",
    "defaultOrientation": "portrait",
    "playStoreStatus": "not yet published; waitlist only",
    "goldPricing": "No suite-wide unlock. Each app has its own one-time Zenith Gold, bought in that app: Launcher $3.99; Tasks/Mind/Calendar/AI/Tulpa $1.99 each; Icons $0.99 (a standalone pack).",
    "oneKey": "One BYO AI key entered in any app is read by all (encrypted on device).",
    "oneAccount": "Connections links a Google account once for the whole suite."
  },

  "apps": [
    { "id": "launcher", "name": "Zenith Launcher", "package": "com.zenith.launcher", "build": "b0.8", "accent": "#E8E8E6", "role": "the home screen", "doc": ".zsd (a Sky / Star Chart)" },
    { "id": "tasks", "name": "Zenith Tasks", "package": "com.zenith.tasks", "build": "b0.1", "accent": "#BEE8D2", "role": "a to-do web", "doc": ".ztd (a Web)" },
    { "id": "mind", "name": "Zenith Mind", "package": "com.zenith.mind", "accent": "#D9C6F0", "role": "a 3D mind-map you fly through", "doc": ".zmd (a Map)" },
    { "id": "calendar", "name": "Zenith Calendar", "package": "com.zenith.calendar", "build": "b0.1", "accent": "#F6E7B9", "role": "time as a solar system", "doc": ".zcd (an Almanac)" },
    { "id": "ai", "name": "Zenith AI", "package": "com.zenith.ai", "accent": "#BFD8F2", "role": "the assistant (persona: Cielo)", "companion": "Zenith Tulpa (com.zenith.tulpa) forges .tulpa beings" },
    { "id": "icons", "name": "Zenith Icons", "package": "com.zenith.iconpack", "version": "1.0 (versionCode 10)", "accent": "#F2C6C6", "role": "a constellation icon pack", "pricing": "$0.99 standalone pack with its own Play listing; not an app with a Gold tier" }
  ],

  "vocabulary": {
    "node": "the unit — one selectable thing (app, task, idea, commitment). A folder is a node with children.",
    "star": "NOT the unit; only a shape a node can be drawn as, or a visual flourish.",
    "sky": "the working canvas of any app.",
    "ring": "a circle of nodes that blooms open under the finger (Launcher, Tasks, Mind classic).",
    "hub": "a central node others spoke off.",
    "link": "one connection between two nodes.",
    "constellation": "a named, coloured group of links = a relationship layer.",
    "web": "the whole saved structure (Tasks/Mind).",
    "starChart": "a saved sky, as a file (Launcher).",
    "bloom": "a ring opening.",
    "nova": "the ripple when you select something.",
    "supernova": "the full burst when something launches or completes.",
    "comet": "the finger trail; also a Launcher notification and a Mind body shape.",
    "cielo": "the AI persona you talk to.",
    "askTheSky": "the universal invocation to summon Cielo from any app.",
    "talk": "AI scoped to one node (Tasks, Mind).",
    "zenithAssist": "the device-assistant capability (home-hold reads the screen, acts across apps).",
    "shuttle": "the suite's shared share-inbox.",
    "tulpa": "an AI persona; Cielo is the default.",
    "lens": "how the active Tulpa responds right now; stackable.",
    "zenithGold": "each app's own one-time paid tier, bought in that app (Launcher $3.99; Tasks/Mind/Calendar/AI/Tulpa $1.99; Icons $0.99). No suite-wide unlock."
  },

  "sharedLayer": {
    "gold": {
      "model": "per-app; no suite-wide unlock. Each app sells and licenses its own Gold, bought inside that app.",
      "prices": { "launcher": "$3.99", "tasks": "$1.99", "mind": "$1.99", "calendar": "$1.99", "ai": "$1.99", "tulpa": "$1.99", "icons": "$0.99 (standalone pack, not a Gold tier)" },
      "type": "one-time managed product (not a subscription)",
      "productId": "zenith_gold (per app)",
      "authority": "each app is its own license authority; a purchase in one app does not unlock another.",
      "accent": "#C8912E (burnt gold)",
      "principle": "every feature is usable free; Gold buys depth/quantity/flourish; all accessibility is always free.",
      "demoBuilds": "each app's Gold is a free toggle in that app's settings › system; replaced by Play Billing at v1.0.",
      "note": "Zenith Icons is a $0.99 standalone icon pack, not an app with a Gold tier."
    },
    "connections": {
      "what": "link a Google account once; every app reads it via the shared Connect screen.",
      "providers": ["Google (wired)", "Microsoft (declared)", "Apple (declared)"],
      "services": ["Calendar", "Tasks", "Drive (drive.file — the suite's own files only)", "Photos (picker)", "Contacts (reserved)"],
      "screen": "each app's settings (Launcher: 'suite connections'); one shared screen, no per-app sign-in.",
      "caveat": "link after your intended host app is installed; a standalone link is not auto-migrated to a later host."
    },
    "shuttle": {
      "what": "a suite-wide shared inbox: share from any Zenith app, pick up in another.",
      "sendTo": "Android share sheet to a Zenith app, or a node's 'to shuttle' / '↗ share'.",
      "pickUp": "the 🚀 button (Tasks, Calendar), the Launcher add sheet's 'Zenith' tab, or Mind's File › 'From Shuttle'."
    },
    "documents": {
      "envelope": "shared ZenithDoc; opening/importing always lands as NEW, never overwrites.",
      "extensions": { "launcher": ".zsd", "tasks": ".ztd", "mind": ".zmd", "calendar": ".zcd", "tulpa": ".tulpa", "backup": ".zbak" },
      "deepLink": "every node has an address zenith://app/type/id; results appear as tappable chips."
    },
    "sound": {
      "sharedCues": "a free suite-wide set of quiet interface cues (tap/open/close/complete/error/nav); one master switch (Launcher: settings › system › suite tap & nav sounds).",
      "skysVoice": "a procedural glass-and-bell instrument in Launcher/Tasks/Calendar where a node's place decides its note; never takes audio focus. Playback & volume free; TUNING is Gold (Launcher).",
      "cieloVoice": "on-device Piper neural voice; falls back to system TTS; belongs to the active Tulpa."
    },
    "foldable": {
      "rule": "CANVAS (the real spatial UI) at every size by default; a linear TRIAGE outline only where an app opts in.",
      "note": "both views bind to the same data. Widgets, Quick Settings tiles and floating bubbles adapt too."
    },
    "privacy": {
      "core": "no servers, no accounts, no analytics; data lives in each app's private storage; uninstall removes it.",
      "outbound": [
        "weather / real sky: location rounded to ~1km, to Open-Meteo, only if enabled",
        "Cielo: your messages to the AI provider YOU chose, with YOUR key — no Zenith server",
        "Connections/Drive: files an app creates, to your own Drive"
      ],
      "assist": "screen is read only at the moment you invoke Cielo, never in the background; the floating bubble never reads the screen."
    }
  },

  "aiSafety": {
    "posture": "Zenith's AI is filtered for safety on-device. This is a safety FLOOR — the developer's own safeguard layered on the model's own alignment, not a guarantee of understanding.",
    "twoChecks": {
      "input": "Before the AI runs, the request is checked; restricted-content requests and bypass/jailbreak attempts are refused and never sent to any model — including requests to generate restricted images/video/audio, even in apps that don't make media.",
      "output": "Before a reply is shown or spoken, it is checked; a flagged reply is replaced with a short refusal."
    },
    "onDevice": "Both checks run locally; prompts are not sent to Black Syntax to moderate. A safety log (blocks + Reported content) stays in the app's private storage; view/export/clear it in the app's safety settings.",
    "labeling": "AI output is labelled 'AI-generated', can be wrong, and is not professional advice — verify what matters.",
    "reporting": "Every AI reply has a Report action; reporting is in-app, logs on-device, removes the content from the conversation, and improves the filters.",
    "selfHarm": "Met with support, not a wall. US: call or text 988 (Suicide & Crisis Lifeline); immediate danger → local emergency services.",
    "refused": ["child safety (CSAE, zero tolerance)", "sexual content / non-consensual intimate imagery", "hate & harassment", "dangerous or illegal instructions", "deception & impersonation for harm", "self-harm facilitation", "jailbreak / safety-bypass attempts"],
    "pages": {
      "aiSafety": "https://zenithsuite.app/compliance/ai-safety",
      "acceptableUse": "https://zenithsuite.app/compliance/acceptable-use",
      "privacy": "https://zenithsuite.app/compliance/privacy",
      "support": "https://zenithsuite.app/support"
    }
  },

  "launcher": {
    "coreGesture": "hold empty sky → a ring of app-nodes blooms; slide onto one and lift to open; lift on empty sky to dissolve.",
    "timings": [
      { "id": "holdDelayMs", "label": "ring opens after a hold", "default": 220, "unit": "ms", "range": [120, 450], "rangeAccessibility": [120, 600] },
      { "id": "delayFolderBloom", "label": "folder ring blooms after a dwell", "default": 330, "unit": "ms", "range": [150, 1200] },
      { "id": "delayDoubleTap", "label": "double-tap window", "default": 340, "unit": "ms", "range": [200, 700] },
      { "id": "a11yDwellMs", "label": "dwell to select", "default": 900, "unit": "ms", "range": [400, 2500] },
      { "id": "ringBloom", "label": "ring bloom animation", "default": 240, "unit": "ms", "fixed": true },
      { "id": "ritualStep", "label": "ritual step spacing", "default": 650, "unit": "ms", "fixed": true },
      { "id": "breathe", "label": "breathe pause", "default": 2600, "unit": "ms", "fixed": true },
      { "id": "veilRest", "label": "veil rest-to-unseal", "default": 4000, "unit": "ms", "fixed": true }
    ],
    "hitZones": [
      { "id": "corner", "size": "52 × 52 dp" },
      { "id": "edgeBand", "size": "18 dp" },
      { "id": "nodeHit", "size": "1.4 × node size, × a11y touch-target 1.0–2.5×" }
    ],
    "geometry": { "baseRadiusDp": { "default": 150, "range": [80, 280] }, "nodeSizeDp": { "default": 26, "range": [18, 36] }, "orbit": { "min": 0.4, "max": 6, "snap": 0.25, "angle": "0° up, clockwise" } },
    "nodeTypes": ["app", "folder", "shortcut", "widget", "file"],
    "dock": [
      { "glyph": "✛", "name": "add", "release": "add sheet", "secondFinger": "live placement" },
      { "glyph": "◈", "name": "icon", "release": "icon picker" },
      { "glyph": "✎", "name": "edit", "release": "node editor" },
      { "glyph": "−", "name": "remove", "release": "remove", "secondFinger": "remove and keep the ring open" }
    ],
    "addSheetTabs": ["Apps", "Folder", "Widgets", "Shortcuts", "Files", "System", "Direct", "Zenith (Shuttle)", "Edit"],
    "gesturePositions": {
      "corners": { "default": ["settings", "deep sky", "shade", "lock"], "order": "↙ ↘ ↖ ↗" },
      "edges": { "default": "all none" },
      "flicks": { "default": { "up": "deep sky", "down": "shade", "left": "none", "right": "none" }, "note": "left/right lose to Android back-swipe" },
      "doubleTap": { "default": "lock" }
    },
    "actions": ["none", "settings", "deep sky", "star index", "shade", "quick tiles", "recents", "screenshot", "power menu", "back", "home", "lock", "seal the sky (veil)", "ask assistant (third-party, NOT Cielo)", "app or shortcut"],
    "assistiveService": "Zenith actions — needed for lock/shade/recents/quick tiles/screenshot/power/back/home; reads nothing from the screen; lock & screenshot need Android 9+.",
    "settingsPages": ["talismans", "system", "suite connections", "gestures", "regions & star index", "background & light", "rings & effects", "the sky's voice", "accessibility", "sky overlays", "star chart", "privacy & permissions", "about"],
    "themes": { "free": ["clean", "mono", "pastel"], "gold": ["rainbow", "daytime", "mono inverted", "iridescent", "neon"] },
    "nodeStyles": ["app icons", "monochrome", "text only", "inverted mono"],
    "quickRing": "a floating ✦ over any app that blooms the real ring; needs 'display over other apps'; free.",
    "talismans": { "cast": "draw fast on empty sky before the ring blooms", "priority": "list order wins ambiguous matches", "freeCap": 3, "ritual": "a folder that fires everything inside ~0.65s apart" },
    "comets": { "requires": "notification access", "catch": "hold the head → open · dismiss · snooze 30 min", "flight": "~11–17s", "stored": "nothing" },
    "veil": { "what": "a curtain over the launcher (NOT device security)", "unseal": ["draw the sigil (if inscribed)", "rest one still finger 4s (always works)"] },
    "regions": { "max": 9, "freeCap": 2, "each": "keeps its own root ring; where you start the hold picks the constellation" },
    "skies": { "freeCap": 1, "starChart": { "save": ".zsd (this sky)", "backupAll": ".zbak" } },
    "mySky": { "gold": true, "what": "the real night sky by location + sidereal time; constellation hairlines; two-finger pinch/pan/twist, three-finger recenter" },
    "gold": ["unlimited regions/talismans/skies", "every theme", "My Sky", "your own images as icons", "twinkle & sparkler", "tuning the sky's voice", "a separate sky per fold screen"]
  },

  "tasks": {
    "model": "one tree: a hidden Hub → branches (projects) → subtasks, nesting infinitely. A task is a Node.",
    "interactionModes": ["hold & drag (default)", "tap & place (latched)"],
    "complete": "lift on a leaf task (or strike it) → supernova + strike-through; lift again to reopen.",
    "dock": ["− remove", "✎ edit", "◎ re-place", "✛ add"],
    "capture": ["Quick Add (on-device natural-language parse)", "Catch It tile (Quick Settings)", "Voice Dump (system speech)", "Task it (text selection + share target)", "floating bubble", "the Shuttle", "paste a list", "Ask the Sky (AI extraction)"],
    "organise": {
      "actuation": "a saved lens/checklist whose ticking strikes the source task",
      "focusDeck": "one task at a time (swipe right complete, left skip)",
      "focusTimer": "per-task Pomodoro 15/25/45 min",
      "blockers": "gate a branch on its subtasks; the Blockers sheet ranks by tasks freed",
      "recurrence": { "term": "bloom rule", "options": ["Never", "Daily", "Weekly", "Monthly", "Annually"], "missedPolicy": ["re-open", "stack a copy", "skip"], "catchUpCeiling": "at most one re-bloom per period", "completionAnchored": true },
      "cadenceVacation": "pause a routine without losing history",
      "contexts": ["charging", "headphones", "wifi", "offline", "in a meeting", "at a place"]
    },
    "timings": { "holdDelayMs": 220, "delayFolderBloom": 330 },
    "crossApp": { "docs": [".ztd", ".zbak"], "google": "via Connections (import Google Tasks → Shuttle; Drive backup/restore/board)", "toMind": "send / Analyze in Mind", "toCalendar": "push a task" },
    "gold": ["every theme", "custom colours", "your own background image", "your own images as node symbols", "a second list side-by-side on a big screen"],
    "goldFreeTalismans": 3
  },

  "mind": {
    "model": "Nodes drawn as body shapes (star/planet/sun/moon/comet/diamond/ringed/nebula/pulsar — cosmetic), joined by Links grouped into named Constellations; the whole is a Web/map.",
    "mapStyles": ["stellar (3D, default)", "classic (rings)"],
    "readOnlyOrigins": ["cielo (Cielo's memory)", "tasks (a dependency projection)"],
    "navigation": { "orbit": "drag one finger", "zoom": "pinch", "pan": "two-finger drag", "select": "tap (Nova)", "flyTo": "double-tap a node", "recenter": "double-tap empty", "named": ["Fly To", "Anchor", "Dive/Surface", "Warp", "Reset view"] },
    "build": { "add": "＋ (long-press for child/parent/sibling)", "connect": "Connect mode: tap two nodes or rubber-band; new links join the active constellation", "lineStyles": ["solid", "glow", "dashed", "beam", "thread"], "fold": "hides a node's descendants" },
    "analyze": ["circular reasoning", "single points of failure", "dead ends", "tensions", "roots", "orphans"],
    "present": "Present Mode / Tour flies body to body; the Offline Generator scatters a hub-and-spokes cluster with no AI key.",
    "settings": { "Halo": "the global glow multiplier (node light-spread)", "labels": ["off", "selected", "near", "always"], "themesFree": ["clean", "mono", "pastel"], "themesGold": ["rainbow", "daytime", "ink", "iridescent", "neon", "ember", "abyss"] },
    "tools": ["list_map", "add_node", "update_node", "link_nodes", "unlink_nodes", "add_constellation", "move_node", "delete_node", "create_map", "analyze", "fly_to", "summarize_map"],
    "gold": { "freeMaps": 3, "freeBoundaries": 2, "unlocks": ["unlimited maps & boundaries", "every theme", "your own photos as node symbols"] }
  },

  "calendar": {
    "model": "the model IS the calendar: Sun = the year, orbit ring = 12 month-arcs (winter solstice bottom), Earth = today (real-time), Moon = the week (real phase), Zodiac band = fixed annual anchors.",
    "zoom": { "year": "Sun + ring + Zodiac", "day": "tap the Earth — a globe with a real day/night terminator", "week": "tap the Moon — four phase-weeks (9-day windows)", "monthGrid": "pull the Moon down", "yearsLadder": "tap the Sun" },
    "navigate": { "today": "the ◉ button or the date header", "back": "‹ (Year is the root)", "travel": "tap/long-press the ring for a date" },
    "commitments": [
      { "kind": "Meteor", "chip": "☄ once", "recurs": "one-time" },
      { "kind": "Asteroid", "chip": "↻ repeats", "recurs": "weekly / biweekly / monthly" },
      { "kind": "fixed star", "chip": "✦ yearly", "recurs": "annual (in the Zodiac band)" }
    ],
    "crud": { "add": "✛, long-press, tile/shortcut, shared text, or Cielo", "confirm": "place it", "dismiss": "let it pass", "edit": "detail card › ✎ edit", "delete": "burn out (Cielo confirms first)" },
    "settings": ["The Sky (theme×10, halo, nebula, starfield, my sky)", "True directions (reverse year/earth/moon)", "The sky's voice (suite sound + volume, haptics)", "Ease (reduce motion, remove glows)", "Almanacs", "Shuttle", "Beyond (Google)"],
    "almanac": "a whole calendar set-up; keep several; save/export .zcd; each Google calendar becomes a mirror almanac (read-only pull).",
    "tools": ["add_commitment", "query_commitments", "update_commitment", "move_commitment", "delete_commitment (destructive)", "next_commitments", "set_recurrence", "find_free_time", "add_from_task", "summarize_day", "summarize_week", "summarize_month"],
    "gold": { "freeAlmanacs": 3, "freeGoogleMirrors": 1, "unlocks": ["unlimited almanacs", "unlimited Google mirrors"] }
  },

  "ai": {
    "appVsPersona": "Zenith AI is the app; Cielo is the persona (the default Tulpa), bundled into every suite app.",
    "invocation": "Ask the Sky (from any app); Talk (scoped to one node, in Tasks/Mind); Zenith Assist (the OS home-hold).",
    "chatModes": ["Chat (transcript)", "Sky mode (kinetic typography, default)"],
    "byoKey": { "stored": "encrypted on-device; one key read by every Zenith app", "freeToStart": ["gemini", "groq"] },
    "providers": [
      { "id": "anthropic", "label": "Claude (Anthropic)", "default": "claude-opus-4-8", "note": "built-in default" },
      { "id": "openai", "label": "OpenAI (GPT)", "default": "gpt-4o" },
      { "id": "gemini", "label": "Gemini (Google)", "default": "gemini-2.0-flash" },
      { "id": "xai", "label": "Grok (xAI)", "default": "grok-2-latest" },
      { "id": "deepseek", "label": "DeepSeek", "default": "deepseek-chat" },
      { "id": "groq", "label": "Groq", "default": "llama-3.3-70b-versatile" },
      { "id": "mistral", "label": "Mistral", "default": "mistral-large-latest" },
      { "id": "openrouter", "label": "OpenRouter (many models)", "default": "openai/gpt-4o" },
      { "id": "together", "label": "Together AI", "default": "meta-llama/Llama-3.3-70B-Instruct-Turbo" }
    ],
    "onDevice": "a fully local/on-device model is planned, not yet shipped.",
    "memory": "a Zenith Mind graph (cielo-memory) — each memory a crystal (a hub node + child facts); openable read-only in Mind.",
    "library": ["Chats", "Knowledge (attached files)", "Mind (memory stars)"],
    "acting": "Cielo picks tools, chains across installed apps, confirms destructive actions (Allow/Cancel), returns deep-link chips.",
    "tulpas": { "default": "Cielo (bundled, unremovable)", "switch": "suite-wide; each keeps its own voice & memory", "install": "Zenith AI is the only installer of .tulpa files; installing new beings is Gold", "forge": "Zenith Tulpa creates/exports .tulpa via 'The Invocation'" },
    "lenses": { "all": ["Blunt", "Brief", "Spark", "Investigate", "Riddle"], "free": ["Blunt", "Brief"], "stackable": true },
    "voice": { "engine": "Piper (on-device)", "default": "Amy (placeholder)", "fallback": "system TTS", "freeToUse": true, "goldToClone": true },
    "assist": { "enable": "settings › presence › cielo as your assistant → Choose (OS digital-assistant picker)", "readsScreen": "only at the moment of invoke", "bubble": "opens Ask-the-Sky from anywhere; does NOT read the screen" },
    "gold": ["every lens stacked", "recall your last three sessions (free: 1)", "unlimited memory stars (free: 5)", "unlimited snips (free: 3)", "unlimited knowledge files (free: 5)", "install new beings"]
  },

  "icons": {
    "version": "1.0",
    "iconCount": 975,
    "mappings": 1377,
    "categories": ["System", "Google", "Communication", "Social", "Media", "Tools", "Shopping", "Zenith", "Zenith Features", "Apps", "Node Symbols", "Constellation Sigils", "Life & Productivity", "Media & Hobbies", "Esoteric", "Expressions", "Hand Gestures", "Cosmos", "Star Constellations", "Asterisms", "Other"],
    "extras": "real constellations, asterisms, cosmic imagery, alchemical/zodiac sigils, hand gestures, expressions — hand-pickable as custom icons.",
    "style": "glowing white artwork on black with soft bloom, 192×192, ~86% fill.",
    "pricing": "$0.99 one-time standalone pack with its own Play listing; not an app with a Gold tier.",
    "attribution": "app→icon mappings derived from Lawnicons (Apache 2.0, attributed); all artwork original.",
    "apply": {
      "worksIn": ["Nova", "Lawnchair", "Smart Launcher", "Niagara", "Zenith Launcher"],
      "cannotUse": ["stock Pixel launcher", "stock Samsung launcher"],
      "third-party": "install the APK, then choose 'Zenith Icons' in the launcher's icon-pack setting.",
      "zenithLauncher": "settings › background & light › icon set applies it to all apps; the ◈ picker sets one node or browses the whole library.",
      "extrasUse": "reach sigils/expressions through your launcher's manual icon picker for custom shortcuts; unmatched art ships under 'Other'."
    }
  },

  "troubleshooting": [
    { "symptom": "Nothing happens when I hold the screen", "fix": "You may be in a corner (52 dp) or edge band (18 dp), which run actions — start nearer the middle; or you're moving (that becomes a flick/talisman) — hold still; or the hold delay is long; or that region opens the Star Index. Applies to Tasks and Mind classic too." },
    { "symptom": "The ring opens but it's empty", "fix": "That region has no nodes — slide to ✛. Each region keeps its own ring." },
    { "symptom": "Folders open when I don't want them to, or won't open", "fix": "Folders open on a dwell — keep moving. Adjust 'folder ring blooms after' in accessibility › extended." },
    { "symptom": "I hid the gear and can't find settings", "fix": "Hold the lower-left corner, or Deep Sky › ✦ zenith settings (always first)." },
    { "symptom": "App shortcuts or Direct don't work", "fix": "Set Zenith as the default launcher." },
    { "symptom": "Lock, shade, recents or screenshot do nothing", "fix": "Enable Zenith actions (system › enable zenith actions); lock & screenshot need Android 9+." },
    { "symptom": "No comets appear", "fix": "Grant notification access; only new, non-ongoing notifications become comets, on the home screen." },
    { "symptom": "My talisman won't cast", "fix": "Draw it faster and bigger; a look-alike higher in the priority list may be winning." },
    { "symptom": "I'm locked behind the sky veil", "fix": "Press one finger and hold perfectly still for four seconds." },
    { "symptom": "I bought Gold in one app but another app still shows it locked", "fix": "Expected — Gold is per app, not suite-wide. Buy Gold in the app whose feature is locked; a purchase in one app never carries to another." },
    { "symptom": "Cielo says I need a key", "fix": "Add an AI key in any Zenith app; the free Gemini or Groq option is quickest; it works suite-wide." },
    { "symptom": "An app can't see my Google calendar or tasks", "fix": "Link the account in Connections and tick the service; link after your host app is installed." },
    { "symptom": "The icon pack won't apply", "fix": "Stock Pixel/Samsung launchers can't use icon packs — install Nova, Lawnchair, Smart Launcher, Niagara or Zenith Launcher, then choose 'Zenith Icons'." },
    { "symptom": "A widget says 'unavailable' after restoring a backup", "fix": "Widget and file nodes are device-local — re-add them on the new device." }
  ]
}