[{"data":1,"prerenderedAt":2648},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-telemetry-setup":534,"-use-cases-telemetry-setup-surround":2643},[4,30,80,128,308,440,499],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Start","\u002Fstart","1.start",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":25,"path":26,"stem":27,"icon":28},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Learn","\u002Flearn","2.learn",[35,40,45,50,55,60,65,70,75],{"title":36,"path":37,"stem":38,"icon":39},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":41,"path":42,"stem":43,"icon":44},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":46,"path":47,"stem":48,"icon":49},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":51,"path":52,"stem":53,"icon":54},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":56,"path":57,"stem":58,"icon":59},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":61,"path":62,"stem":63,"icon":64},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":66,"path":67,"stem":68,"icon":69},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":71,"path":72,"stem":73,"icon":74},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":76,"path":77,"stem":78,"icon":79},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":81,"path":82,"stem":83,"children":84,"page":29},"CLI","\u002Fcli","3.cli",[85,88,93,98,103,108,113,118,123],{"title":36,"path":86,"stem":87,"icon":44},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":89,"path":90,"stem":91,"icon":92},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":94,"path":95,"stem":96,"icon":97},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":99,"path":100,"stem":101,"icon":102},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":104,"path":105,"stem":106,"icon":107},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":109,"path":110,"stem":111,"icon":112},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":114,"path":115,"stem":116,"icon":117},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":119,"path":120,"stem":121,"icon":122},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":124,"path":125,"stem":126,"icon":127},"agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents","i-lucide-bot",{"title":129,"path":130,"stem":131,"children":132,"page":29},"Integrate","\u002Fintegrate","4.integrate",[133,137,220],{"title":36,"path":134,"stem":135,"icon":136},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":138,"path":139,"stem":140,"children":141,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[142,145,175,200],{"title":36,"path":143,"stem":144,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":146,"path":147,"stem":148,"children":149,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[150,155,160,165,170],{"title":151,"path":152,"stem":153,"icon":154},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":156,"path":157,"stem":158,"icon":159},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":161,"path":162,"stem":163,"icon":164},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":166,"path":167,"stem":168,"icon":169},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":171,"path":172,"stem":173,"icon":174},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":176,"path":177,"stem":178,"children":179,"page":29},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[180,185,190,195],{"title":181,"path":182,"stem":183,"icon":184},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":186,"path":187,"stem":188,"icon":189},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":191,"path":192,"stem":193,"icon":194},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":196,"path":197,"stem":198,"icon":199},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":201,"path":202,"stem":203,"children":204,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[205,210,215],{"title":206,"path":207,"stem":208,"icon":209},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":211,"path":212,"stem":213,"icon":214},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":216,"path":217,"stem":218,"icon":219},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":221,"path":222,"stem":223,"children":224,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[225,229,234,239,244,249,254,259,264,269,274,279,284,289,293,298,303],{"title":36,"path":226,"stem":227,"icon":228},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":230,"path":231,"stem":232,"icon":233},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":235,"path":236,"stem":237,"icon":238},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":240,"path":241,"stem":242,"icon":243},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":245,"path":246,"stem":247,"icon":248},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":250,"path":251,"stem":252,"icon":253},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":255,"path":256,"stem":257,"icon":258},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":260,"path":261,"stem":262,"icon":263},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":265,"path":266,"stem":267,"icon":268},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":270,"path":271,"stem":272,"icon":273},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":275,"path":276,"stem":277,"icon":278},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":280,"path":281,"stem":282,"icon":283},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":285,"path":286,"stem":287,"icon":288},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":290,"path":291,"stem":292,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":294,"path":295,"stem":296,"icon":297},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":299,"path":300,"stem":301,"icon":302},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":304,"path":305,"stem":306,"icon":307},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":309,"path":310,"stem":311,"children":312,"page":29},"Use Cases","\u002Fuse-cases","5.use-cases",[313,316,321,350,377,409,430,435],{"title":36,"path":314,"stem":315,"icon":102},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":317,"path":318,"stem":319,"icon":320},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":322,"icon":323,"path":324,"stem":325,"children":326,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[327,330,335,340,345],{"title":36,"path":328,"stem":329,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":331,"path":332,"stem":333,"icon":334},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":336,"path":337,"stem":338,"icon":339},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":341,"path":342,"stem":343,"icon":344},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":346,"path":347,"stem":348,"icon":349},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":351,"icon":352,"path":353,"stem":354,"children":355,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[356,359,364,369,373],{"title":36,"path":357,"stem":358,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":360,"path":361,"stem":362,"icon":363},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":365,"path":366,"stem":367,"icon":368},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":370,"path":371,"stem":372,"icon":320},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":374,"path":375,"stem":376,"icon":107},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":378,"icon":379,"path":380,"stem":381,"children":382,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[383,386,391,396,401,405],{"title":36,"path":384,"stem":385,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":387,"path":388,"stem":389,"icon":390},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":392,"path":393,"stem":394,"icon":395},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":397,"path":398,"stem":399,"icon":400},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":402,"path":403,"stem":404,"icon":379},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":406,"path":407,"stem":408,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":346,"icon":107,"path":410,"stem":411,"children":412,"page":29},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[413,416,421,426],{"title":36,"path":414,"stem":415,"icon":39},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":417,"path":418,"stem":419,"icon":420},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":422,"path":423,"stem":424,"icon":425},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":427,"path":428,"stem":429,"icon":79},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":431,"path":432,"stem":433,"icon":434},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":436,"path":437,"stem":438,"icon":439},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":441,"path":442,"stem":443,"children":444,"page":29},"Extend","\u002Fextend","6.extend",[445,449,454,459,463,468,472,476,480,484,489,494],{"title":36,"path":446,"stem":447,"icon":448},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":450,"path":451,"stem":452,"icon":453},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":455,"path":456,"stem":457,"icon":458},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":460,"path":461,"stem":462,"icon":453},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","6.extend\u002F11.diagnostics-channel",{"title":464,"path":465,"stem":466,"icon":467},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":406,"path":469,"stem":470,"icon":471},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":473,"path":474,"stem":475,"icon":448},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":477,"path":478,"stem":479,"icon":434},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":481,"path":482,"stem":483,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":485,"path":486,"stem":487,"icon":488},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":490,"path":491,"stem":492,"icon":493},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":495,"path":496,"stem":497,"icon":498},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":427,"path":500,"stem":501,"children":502,"page":29},"\u002Freference","7.reference",[503,508,511,516,520,525,529],{"title":504,"path":505,"stem":506,"icon":507},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":374,"path":509,"stem":510,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":512,"path":513,"stem":514,"icon":515},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":517,"path":518,"stem":519,"icon":379},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":521,"path":522,"stem":523,"icon":524},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":526,"path":527,"stem":528,"icon":434},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"title":530,"path":531,"stem":532,"icon":533},"Cost","\u002Freference\u002Fcost","7.reference\u002F7.cost","i-lucide-receipt",{"id":535,"title":536,"body":537,"description":2631,"extension":2632,"links":2633,"meta":2639,"navigation":2640,"path":418,"seo":2641,"stem":419,"__hash__":2642},"docs\u002F5.use-cases\u002F4.telemetry\u002F02.setup.md","Telemetry Setup",{"type":538,"value":539,"toc":2622},"minimark",[540,545,549,638,692,711,715,733,1200,1205,1214,1322,1333,1337,1344,1910,1924,1976,1983,2178,2182,2192,2387,2417,2573,2577,2615,2618],[541,542,544],"h2",{"id":543},"configure-delivery","Configure delivery",[546,547,548],"p",{},"Point the CLI at your ingestion URL when you ship it — baked into the binary, overridable per environment:",[550,551,557],"pre",{"className":552,"code":553,"filename":554,"language":555,"meta":556,"style":556},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","withTelemetry(command, {\n  name: TOOL,\n  version: VERSION,\n  endpoint: 'https:\u002F\u002Ftelemetry.my-tool.dev\u002Fapi\u002Ftelemetry\u002Fingest',\n})\n","src\u002Findex.ts","ts","",[558,559,560,580,596,609,629],"code",{"__ignoreMap":556},[561,562,565,569,573,577],"span",{"class":563,"line":564},"line",1,[561,566,568],{"class":567},"s2Zo4","withTelemetry",[561,570,572],{"class":571},"sTEyZ","(command",[561,574,576],{"class":575},"sMK4o",",",[561,578,579],{"class":575}," {\n",[561,581,583,587,590,593],{"class":563,"line":582},2,[561,584,586],{"class":585},"swJcz","  name",[561,588,589],{"class":575},":",[561,591,592],{"class":571}," TOOL",[561,594,595],{"class":575},",\n",[561,597,599,602,604,607],{"class":563,"line":598},3,[561,600,601],{"class":585},"  version",[561,603,589],{"class":575},[561,605,606],{"class":571}," VERSION",[561,608,595],{"class":575},[561,610,612,615,617,620,624,627],{"class":563,"line":611},4,[561,613,614],{"class":585},"  endpoint",[561,616,589],{"class":575},[561,618,619],{"class":575}," '",[561,621,623],{"class":622},"sfazB","https:\u002F\u002Ftelemetry.my-tool.dev\u002Fapi\u002Ftelemetry\u002Fingest",[561,625,626],{"class":575},"'",[561,628,595],{"class":575},[561,630,632,635],{"class":563,"line":631},5,[561,633,634],{"class":575},"}",[561,636,637],{"class":571},")\n",[639,640,641,654],"table",{},[642,643,644],"thead",{},[645,646,647,651],"tr",{},[648,649,650],"th",{},"Override",[648,652,653],{},"Effect",[655,656,657,668,682],"tbody",{},[645,658,659,665],{},[660,661,662],"td",{},[558,663,664],{},"EVLOG_TELEMETRY_ENDPOINT",[660,666,667],{},"Replaces the baked-in URL (staging, self-hosted)",[645,669,670,679],{},[660,671,672,675,676],{},[558,673,674],{},"EVLOG_TELEMETRY=0"," \u002F ",[558,677,678],{},"DO_NOT_TRACK=1",[660,680,681],{},"No recording, no send",[645,683,684,689],{},[660,685,686],{},[558,687,688],{},"EVLOG_TELEMETRY_DEBUG=1",[660,690,691],{},"Print payloads to stderr without sending",[546,693,694,695,698,699,702,703,706,707,710],{},"The built-in HTTP drain POSTs ",[558,696,697],{},"Content-Type: application\u002Fjson"," with body ",[558,700,701],{},"{ events: RunEvent[] }"," and a 400ms timeout. On success (",[558,704,705],{},"res.ok","), delivered keys are removed from the outbox. ",[558,708,709],{},"flush()"," is capped at 500ms and never throws.",[541,712,714],{"id":713},"setup-with-citty","Setup with citty",[546,716,717,718,721,722,724,725,728,729,732],{},"Wrap your root command in ",[558,719,720],{},"withTelemetry()"," — typically in ",[558,723,554],{},", the file that calls ",[558,726,727],{},"runMain()",". Subcommands can live in the same file or in ",[558,730,731],{},"src\u002Fcommands\u002F*.ts","; only the entrypoint needs the wrapper.",[550,734,736],{"className":552,"code":735,"filename":554,"language":555,"meta":556,"style":556},"import { defineCommand, runMain } from 'citty'\nimport { withTelemetry, defineTelemetryCommands } from '@evlog\u002Ftelemetry'\nimport { doctorCommand } from '.\u002Fcommands\u002Fdoctor'\nimport { syncCommand } from '.\u002Fcommands\u002Fsync'\n\nconst TOOL = 'my-tool'\nconst VERSION = '1.0.0'\n\nexport const main = withTelemetry(\n  defineCommand({\n    meta: { name: 'my-tool', description: '…', version: VERSION },\n    subCommands: {\n      doctor: doctorCommand,\n      sync: syncCommand,\n      telemetry: defineTelemetryCommands({ name: TOOL }),\n    },\n  }),\n  {\n    name: TOOL,\n    version: VERSION,\n    endpoint: 'https:\u002F\u002Ftelemetry.my-tool.dev\u002Fapi\u002Ftelemetry\u002Fingest',\n    collect: {\n      flags: { format: ['json', 'csv'] },\n      fields: { framework: ['nuxt', 'next'] },\n    },\n  },\n)\n\nrunMain(main)\n",[558,737,738,769,794,814,834,840,860,877,882,901,913,960,970,982,994,1022,1028,1038,1044,1056,1068,1084,1094,1133,1170,1175,1181,1186,1191],{"__ignoreMap":556},[561,739,740,744,747,750,752,755,758,761,763,766],{"class":563,"line":564},[561,741,743],{"class":742},"s7zQu","import",[561,745,746],{"class":575}," {",[561,748,749],{"class":571}," defineCommand",[561,751,576],{"class":575},[561,753,754],{"class":571}," runMain",[561,756,757],{"class":575}," }",[561,759,760],{"class":742}," from",[561,762,619],{"class":575},[561,764,765],{"class":622},"citty",[561,767,768],{"class":575},"'\n",[561,770,771,773,775,778,780,783,785,787,789,792],{"class":563,"line":582},[561,772,743],{"class":742},[561,774,746],{"class":575},[561,776,777],{"class":571}," withTelemetry",[561,779,576],{"class":575},[561,781,782],{"class":571}," defineTelemetryCommands",[561,784,757],{"class":575},[561,786,760],{"class":742},[561,788,619],{"class":575},[561,790,791],{"class":622},"@evlog\u002Ftelemetry",[561,793,768],{"class":575},[561,795,796,798,800,803,805,807,809,812],{"class":563,"line":598},[561,797,743],{"class":742},[561,799,746],{"class":575},[561,801,802],{"class":571}," doctorCommand",[561,804,757],{"class":575},[561,806,760],{"class":742},[561,808,619],{"class":575},[561,810,811],{"class":622},".\u002Fcommands\u002Fdoctor",[561,813,768],{"class":575},[561,815,816,818,820,823,825,827,829,832],{"class":563,"line":611},[561,817,743],{"class":742},[561,819,746],{"class":575},[561,821,822],{"class":571}," syncCommand",[561,824,757],{"class":575},[561,826,760],{"class":742},[561,828,619],{"class":575},[561,830,831],{"class":622},".\u002Fcommands\u002Fsync",[561,833,768],{"class":575},[561,835,836],{"class":563,"line":631},[561,837,839],{"emptyLinePlaceholder":838},true,"\n",[561,841,843,847,850,853,855,858],{"class":563,"line":842},6,[561,844,846],{"class":845},"spNyl","const",[561,848,849],{"class":571}," TOOL ",[561,851,852],{"class":575},"=",[561,854,619],{"class":575},[561,856,857],{"class":622},"my-tool",[561,859,768],{"class":575},[561,861,863,865,868,870,872,875],{"class":563,"line":862},7,[561,864,846],{"class":845},[561,866,867],{"class":571}," VERSION ",[561,869,852],{"class":575},[561,871,619],{"class":575},[561,873,874],{"class":622},"1.0.0",[561,876,768],{"class":575},[561,878,880],{"class":563,"line":879},8,[561,881,839],{"emptyLinePlaceholder":838},[561,883,885,888,891,894,896,898],{"class":563,"line":884},9,[561,886,887],{"class":742},"export",[561,889,890],{"class":845}," const",[561,892,893],{"class":571}," main ",[561,895,852],{"class":575},[561,897,777],{"class":567},[561,899,900],{"class":571},"(\n",[561,902,904,907,910],{"class":563,"line":903},10,[561,905,906],{"class":567},"  defineCommand",[561,908,909],{"class":571},"(",[561,911,912],{"class":575},"{\n",[561,914,916,919,921,923,926,928,930,932,934,936,939,941,943,946,948,950,953,955,957],{"class":563,"line":915},11,[561,917,918],{"class":585},"    meta",[561,920,589],{"class":575},[561,922,746],{"class":575},[561,924,925],{"class":585}," name",[561,927,589],{"class":575},[561,929,619],{"class":575},[561,931,857],{"class":622},[561,933,626],{"class":575},[561,935,576],{"class":575},[561,937,938],{"class":585}," description",[561,940,589],{"class":575},[561,942,619],{"class":575},[561,944,945],{"class":622},"…",[561,947,626],{"class":575},[561,949,576],{"class":575},[561,951,952],{"class":585}," version",[561,954,589],{"class":575},[561,956,867],{"class":571},[561,958,959],{"class":575},"},\n",[561,961,963,966,968],{"class":563,"line":962},12,[561,964,965],{"class":585},"    subCommands",[561,967,589],{"class":575},[561,969,579],{"class":575},[561,971,973,976,978,980],{"class":563,"line":972},13,[561,974,975],{"class":585},"      doctor",[561,977,589],{"class":575},[561,979,802],{"class":571},[561,981,595],{"class":575},[561,983,985,988,990,992],{"class":563,"line":984},14,[561,986,987],{"class":585},"      sync",[561,989,589],{"class":575},[561,991,822],{"class":571},[561,993,595],{"class":575},[561,995,997,1000,1002,1004,1006,1009,1011,1013,1015,1017,1020],{"class":563,"line":996},15,[561,998,999],{"class":585},"      telemetry",[561,1001,589],{"class":575},[561,1003,782],{"class":567},[561,1005,909],{"class":571},[561,1007,1008],{"class":575},"{",[561,1010,925],{"class":585},[561,1012,589],{"class":575},[561,1014,849],{"class":571},[561,1016,634],{"class":575},[561,1018,1019],{"class":571},")",[561,1021,595],{"class":575},[561,1023,1025],{"class":563,"line":1024},16,[561,1026,1027],{"class":575},"    },\n",[561,1029,1031,1034,1036],{"class":563,"line":1030},17,[561,1032,1033],{"class":575},"  }",[561,1035,1019],{"class":571},[561,1037,595],{"class":575},[561,1039,1041],{"class":563,"line":1040},18,[561,1042,1043],{"class":575},"  {\n",[561,1045,1047,1050,1052,1054],{"class":563,"line":1046},19,[561,1048,1049],{"class":585},"    name",[561,1051,589],{"class":575},[561,1053,592],{"class":571},[561,1055,595],{"class":575},[561,1057,1059,1062,1064,1066],{"class":563,"line":1058},20,[561,1060,1061],{"class":585},"    version",[561,1063,589],{"class":575},[561,1065,606],{"class":571},[561,1067,595],{"class":575},[561,1069,1071,1074,1076,1078,1080,1082],{"class":563,"line":1070},21,[561,1072,1073],{"class":585},"    endpoint",[561,1075,589],{"class":575},[561,1077,619],{"class":575},[561,1079,623],{"class":622},[561,1081,626],{"class":575},[561,1083,595],{"class":575},[561,1085,1087,1090,1092],{"class":563,"line":1086},22,[561,1088,1089],{"class":585},"    collect",[561,1091,589],{"class":575},[561,1093,579],{"class":575},[561,1095,1097,1100,1102,1104,1107,1109,1112,1114,1117,1119,1121,1123,1126,1128,1131],{"class":563,"line":1096},23,[561,1098,1099],{"class":585},"      flags",[561,1101,589],{"class":575},[561,1103,746],{"class":575},[561,1105,1106],{"class":585}," format",[561,1108,589],{"class":575},[561,1110,1111],{"class":571}," [",[561,1113,626],{"class":575},[561,1115,1116],{"class":622},"json",[561,1118,626],{"class":575},[561,1120,576],{"class":575},[561,1122,619],{"class":575},[561,1124,1125],{"class":622},"csv",[561,1127,626],{"class":575},[561,1129,1130],{"class":571},"] ",[561,1132,959],{"class":575},[561,1134,1136,1139,1141,1143,1146,1148,1150,1152,1155,1157,1159,1161,1164,1166,1168],{"class":563,"line":1135},24,[561,1137,1138],{"class":585},"      fields",[561,1140,589],{"class":575},[561,1142,746],{"class":575},[561,1144,1145],{"class":585}," framework",[561,1147,589],{"class":575},[561,1149,1111],{"class":571},[561,1151,626],{"class":575},[561,1153,1154],{"class":622},"nuxt",[561,1156,626],{"class":575},[561,1158,576],{"class":575},[561,1160,619],{"class":575},[561,1162,1163],{"class":622},"next",[561,1165,626],{"class":575},[561,1167,1130],{"class":571},[561,1169,959],{"class":575},[561,1171,1173],{"class":563,"line":1172},25,[561,1174,1027],{"class":575},[561,1176,1178],{"class":563,"line":1177},26,[561,1179,1180],{"class":575},"  },\n",[561,1182,1184],{"class":563,"line":1183},27,[561,1185,637],{"class":571},[561,1187,1189],{"class":563,"line":1188},28,[561,1190,839],{"emptyLinePlaceholder":838},[561,1192,1194,1197],{"class":563,"line":1193},29,[561,1195,1196],{"class":567},"runMain",[561,1198,1199],{"class":571},"(main)\n",[1201,1202,1204],"h3",{"id":1203},"what-gets-recorded-automatically","What gets recorded automatically",[546,1206,1207,1209,1210,1213],{},[558,1208,568],{}," walks your citty tree. Each ",[558,1211,1212],{},"run"," handler produces one event — no per-command telemetry boilerplate.",[639,1215,1216,1234],{},[642,1217,1218],{},[645,1219,1220,1223,1228],{},[648,1221,1222],{},"Invocation",[648,1224,1225],{},[558,1226,1227],{},"event.command",[648,1229,1230,1231],{},"Notes on ",[558,1232,1233],{},"flags",[655,1235,1236,1253,1269,1287,1307],{},[645,1237,1238,1243,1247],{},[660,1239,1240],{},[558,1241,1242],{},"my-tool doctor",[660,1244,1245],{},[558,1246,114],{},[660,1248,1249,1252],{},[558,1250,1251],{},"{}"," — nothing was passed, and defaults are not choices",[645,1254,1255,1260,1264],{},[660,1256,1257],{},[558,1258,1259],{},"my-tool doctor --json",[660,1261,1262],{},[558,1263,114],{},[660,1265,1266],{},[558,1267,1268],{},"{ json: true }",[645,1270,1271,1276,1281],{},[660,1272,1273],{},[558,1274,1275],{},"my-tool sync --dry-run --output .\u002Fout",[660,1277,1278],{},[558,1279,1280],{},"sync",[660,1282,1283,1286],{},[558,1284,1285],{},"{ dryRun: true, output: \"\u003Cset>\" }"," — the path itself is never sent",[645,1288,1289,1294,1298],{},[660,1290,1291],{},[558,1292,1293],{},"my-tool sync --format json",[660,1295,1296],{},[558,1297,1280],{},[660,1299,1300,1303,1304],{},[558,1301,1302],{},"{ format: \"json\" }"," only if allowlisted in ",[558,1305,1306],{},"collect.flags",[645,1308,1309,1314,1319],{},[660,1310,1311],{},[558,1312,1313],{},"my-tool telemetry status",[660,1315,1316],{},[558,1317,1318],{},"telemetry status",[660,1320,1321],{},"nested subcommands join with a space",[546,1323,1324,1325,1328,1329,1332],{},"The root ",[558,1326,1327],{},"meta.name"," is not prefixed when the root only delegates to ",[558,1330,1331],{},"subCommands",".",[1201,1334,1336],{"id":1335},"enriching-a-run","Enriching a run",[546,1338,1339,1340,1343],{},"Call ",[558,1341,1342],{},"telemetry.set()"," anywhere inside a command handler — or in helpers that run on the same async stack (the run context is preserved via AsyncLocalStorage).",[1345,1346,1347],"code-collapse",{},[550,1348,1351],{"className":552,"code":1349,"filename":1350,"language":555,"meta":556,"style":556},"import { telemetry } from '@evlog\u002Ftelemetry'\nimport { existsSync } from 'node:fs'\nimport { resolveConfigPath } from '..\u002Flib\u002Fconfig'\n\nasync function runHealthChecks() {\n  let checksFailed = 0\n  let checksWarn = 0\n\n  const configPath = resolveConfigPath()\n  if (!existsSync(configPath)) {\n    checksFailed++\n  }\n\n  try {\n    await fetch('https:\u002F\u002Fregistry.npmjs.org\u002Fmy-tool')\n  } catch {\n    checksWarn++\n  }\n\n  \u002F\u002F Counters land in event.custom on the wide event for this run\n  telemetry.set({ checksFailed, checksWarn })\n  return checksFailed === 0\n}\n\nexport const doctorCommand = {\n  meta: { name: 'doctor', description: 'Check environment' },\n  args: {\n    json: { type: 'boolean', alias: 'j' },\n  },\n  async run({ args }: { args: { json?: boolean } }) {\n    const ok = await runHealthChecks()\n    if (!ok) {\n      throw Object.assign(new Error('Health checks failed'), { code: 'DOCTOR_FAILED' })\n    }\n    if (!args.json) process.stdout.write('ok\\n')\n  },\n}\n","src\u002Fcommands\u002Fdoctor.ts",[558,1352,1353,1372,1392,1412,1416,1432,1447,1458,1462,1477,1501,1509,1514,1518,1525,1544,1553,1560,1564,1568,1574,1598,1610,1615,1619,1632,1667,1676,1713,1717,1761,1779,1797,1850,1856,1900,1905],{"__ignoreMap":556},[561,1354,1355,1357,1359,1362,1364,1366,1368,1370],{"class":563,"line":564},[561,1356,743],{"class":742},[561,1358,746],{"class":575},[561,1360,1361],{"class":571}," telemetry",[561,1363,757],{"class":575},[561,1365,760],{"class":742},[561,1367,619],{"class":575},[561,1369,791],{"class":622},[561,1371,768],{"class":575},[561,1373,1374,1376,1378,1381,1383,1385,1387,1390],{"class":563,"line":582},[561,1375,743],{"class":742},[561,1377,746],{"class":575},[561,1379,1380],{"class":571}," existsSync",[561,1382,757],{"class":575},[561,1384,760],{"class":742},[561,1386,619],{"class":575},[561,1388,1389],{"class":622},"node:fs",[561,1391,768],{"class":575},[561,1393,1394,1396,1398,1401,1403,1405,1407,1410],{"class":563,"line":598},[561,1395,743],{"class":742},[561,1397,746],{"class":575},[561,1399,1400],{"class":571}," resolveConfigPath",[561,1402,757],{"class":575},[561,1404,760],{"class":742},[561,1406,619],{"class":575},[561,1408,1409],{"class":622},"..\u002Flib\u002Fconfig",[561,1411,768],{"class":575},[561,1413,1414],{"class":563,"line":611},[561,1415,839],{"emptyLinePlaceholder":838},[561,1417,1418,1421,1424,1427,1430],{"class":563,"line":631},[561,1419,1420],{"class":845},"async",[561,1422,1423],{"class":845}," function",[561,1425,1426],{"class":567}," runHealthChecks",[561,1428,1429],{"class":575},"()",[561,1431,579],{"class":575},[561,1433,1434,1437,1440,1443],{"class":563,"line":842},[561,1435,1436],{"class":845},"  let",[561,1438,1439],{"class":571}," checksFailed",[561,1441,1442],{"class":575}," =",[561,1444,1446],{"class":1445},"sbssI"," 0\n",[561,1448,1449,1451,1454,1456],{"class":563,"line":862},[561,1450,1436],{"class":845},[561,1452,1453],{"class":571}," checksWarn",[561,1455,1442],{"class":575},[561,1457,1446],{"class":1445},[561,1459,1460],{"class":563,"line":879},[561,1461,839],{"emptyLinePlaceholder":838},[561,1463,1464,1467,1470,1472,1474],{"class":563,"line":884},[561,1465,1466],{"class":845},"  const",[561,1468,1469],{"class":571}," configPath",[561,1471,1442],{"class":575},[561,1473,1400],{"class":567},[561,1475,1476],{"class":585},"()\n",[561,1478,1479,1482,1485,1488,1491,1493,1496,1499],{"class":563,"line":903},[561,1480,1481],{"class":742},"  if",[561,1483,1484],{"class":585}," (",[561,1486,1487],{"class":575},"!",[561,1489,1490],{"class":567},"existsSync",[561,1492,909],{"class":585},[561,1494,1495],{"class":571},"configPath",[561,1497,1498],{"class":585},")) ",[561,1500,912],{"class":575},[561,1502,1503,1506],{"class":563,"line":915},[561,1504,1505],{"class":571},"    checksFailed",[561,1507,1508],{"class":575},"++\n",[561,1510,1511],{"class":563,"line":962},[561,1512,1513],{"class":575},"  }\n",[561,1515,1516],{"class":563,"line":972},[561,1517,839],{"emptyLinePlaceholder":838},[561,1519,1520,1523],{"class":563,"line":984},[561,1521,1522],{"class":742},"  try",[561,1524,579],{"class":575},[561,1526,1527,1530,1533,1535,1537,1540,1542],{"class":563,"line":996},[561,1528,1529],{"class":742},"    await",[561,1531,1532],{"class":567}," fetch",[561,1534,909],{"class":585},[561,1536,626],{"class":575},[561,1538,1539],{"class":622},"https:\u002F\u002Fregistry.npmjs.org\u002Fmy-tool",[561,1541,626],{"class":575},[561,1543,637],{"class":585},[561,1545,1546,1548,1551],{"class":563,"line":1024},[561,1547,1033],{"class":575},[561,1549,1550],{"class":742}," catch",[561,1552,579],{"class":575},[561,1554,1555,1558],{"class":563,"line":1030},[561,1556,1557],{"class":571},"    checksWarn",[561,1559,1508],{"class":575},[561,1561,1562],{"class":563,"line":1040},[561,1563,1513],{"class":575},[561,1565,1566],{"class":563,"line":1046},[561,1567,839],{"emptyLinePlaceholder":838},[561,1569,1570],{"class":563,"line":1058},[561,1571,1573],{"class":1572},"sHwdD","  \u002F\u002F Counters land in event.custom on the wide event for this run\n",[561,1575,1576,1579,1581,1584,1586,1588,1590,1592,1594,1596],{"class":563,"line":1070},[561,1577,1578],{"class":571},"  telemetry",[561,1580,1332],{"class":575},[561,1582,1583],{"class":567},"set",[561,1585,909],{"class":585},[561,1587,1008],{"class":575},[561,1589,1439],{"class":571},[561,1591,576],{"class":575},[561,1593,1453],{"class":571},[561,1595,757],{"class":575},[561,1597,637],{"class":585},[561,1599,1600,1603,1605,1608],{"class":563,"line":1086},[561,1601,1602],{"class":742},"  return",[561,1604,1439],{"class":571},[561,1606,1607],{"class":575}," ===",[561,1609,1446],{"class":1445},[561,1611,1612],{"class":563,"line":1096},[561,1613,1614],{"class":575},"}\n",[561,1616,1617],{"class":563,"line":1135},[561,1618,839],{"emptyLinePlaceholder":838},[561,1620,1621,1623,1625,1628,1630],{"class":563,"line":1172},[561,1622,887],{"class":742},[561,1624,890],{"class":845},[561,1626,1627],{"class":571}," doctorCommand ",[561,1629,852],{"class":575},[561,1631,579],{"class":575},[561,1633,1634,1637,1639,1641,1643,1645,1647,1649,1651,1653,1655,1657,1659,1662,1664],{"class":563,"line":1177},[561,1635,1636],{"class":585},"  meta",[561,1638,589],{"class":575},[561,1640,746],{"class":575},[561,1642,925],{"class":585},[561,1644,589],{"class":575},[561,1646,619],{"class":575},[561,1648,114],{"class":622},[561,1650,626],{"class":575},[561,1652,576],{"class":575},[561,1654,938],{"class":585},[561,1656,589],{"class":575},[561,1658,619],{"class":575},[561,1660,1661],{"class":622},"Check environment",[561,1663,626],{"class":575},[561,1665,1666],{"class":575}," },\n",[561,1668,1669,1672,1674],{"class":563,"line":1183},[561,1670,1671],{"class":585},"  args",[561,1673,589],{"class":575},[561,1675,579],{"class":575},[561,1677,1678,1681,1683,1685,1688,1690,1692,1695,1697,1699,1702,1704,1706,1709,1711],{"class":563,"line":1188},[561,1679,1680],{"class":585},"    json",[561,1682,589],{"class":575},[561,1684,746],{"class":575},[561,1686,1687],{"class":585}," type",[561,1689,589],{"class":575},[561,1691,619],{"class":575},[561,1693,1694],{"class":622},"boolean",[561,1696,626],{"class":575},[561,1698,576],{"class":575},[561,1700,1701],{"class":585}," alias",[561,1703,589],{"class":575},[561,1705,619],{"class":575},[561,1707,1708],{"class":622},"j",[561,1710,626],{"class":575},[561,1712,1666],{"class":575},[561,1714,1715],{"class":563,"line":1193},[561,1716,1180],{"class":575},[561,1718,1720,1723,1726,1729,1733,1736,1738,1740,1742,1744,1747,1750,1754,1756,1759],{"class":563,"line":1719},30,[561,1721,1722],{"class":845},"  async",[561,1724,1725],{"class":585}," run",[561,1727,1728],{"class":575},"({",[561,1730,1732],{"class":1731},"sHdIc"," args",[561,1734,1735],{"class":575}," }:",[561,1737,746],{"class":575},[561,1739,1732],{"class":585},[561,1741,589],{"class":575},[561,1743,746],{"class":575},[561,1745,1746],{"class":585}," json",[561,1748,1749],{"class":575},"?:",[561,1751,1753],{"class":1752},"sBMFI"," boolean",[561,1755,757],{"class":575},[561,1757,1758],{"class":575}," })",[561,1760,579],{"class":575},[561,1762,1764,1767,1770,1772,1775,1777],{"class":563,"line":1763},31,[561,1765,1766],{"class":845},"    const",[561,1768,1769],{"class":571}," ok",[561,1771,1442],{"class":575},[561,1773,1774],{"class":742}," await",[561,1776,1426],{"class":567},[561,1778,1476],{"class":585},[561,1780,1782,1785,1787,1789,1792,1795],{"class":563,"line":1781},32,[561,1783,1784],{"class":742},"    if",[561,1786,1484],{"class":585},[561,1788,1487],{"class":575},[561,1790,1791],{"class":571},"ok",[561,1793,1794],{"class":585},") ",[561,1796,912],{"class":575},[561,1798,1800,1803,1806,1808,1811,1813,1816,1819,1821,1823,1826,1828,1830,1832,1834,1837,1839,1841,1844,1846,1848],{"class":563,"line":1799},33,[561,1801,1802],{"class":742},"      throw",[561,1804,1805],{"class":571}," Object",[561,1807,1332],{"class":575},[561,1809,1810],{"class":567},"assign",[561,1812,909],{"class":585},[561,1814,1815],{"class":575},"new",[561,1817,1818],{"class":567}," Error",[561,1820,909],{"class":585},[561,1822,626],{"class":575},[561,1824,1825],{"class":622},"Health checks failed",[561,1827,626],{"class":575},[561,1829,1019],{"class":585},[561,1831,576],{"class":575},[561,1833,746],{"class":575},[561,1835,1836],{"class":585}," code",[561,1838,589],{"class":575},[561,1840,619],{"class":575},[561,1842,1843],{"class":622},"DOCTOR_FAILED",[561,1845,626],{"class":575},[561,1847,757],{"class":575},[561,1849,637],{"class":585},[561,1851,1853],{"class":563,"line":1852},34,[561,1854,1855],{"class":575},"    }\n",[561,1857,1859,1861,1863,1865,1868,1870,1872,1874,1877,1879,1882,1884,1887,1889,1891,1893,1896,1898],{"class":563,"line":1858},35,[561,1860,1784],{"class":742},[561,1862,1484],{"class":585},[561,1864,1487],{"class":575},[561,1866,1867],{"class":571},"args",[561,1869,1332],{"class":575},[561,1871,1116],{"class":571},[561,1873,1794],{"class":585},[561,1875,1876],{"class":571},"process",[561,1878,1332],{"class":575},[561,1880,1881],{"class":571},"stdout",[561,1883,1332],{"class":575},[561,1885,1886],{"class":567},"write",[561,1888,909],{"class":585},[561,1890,626],{"class":575},[561,1892,1791],{"class":622},[561,1894,1895],{"class":571},"\\n",[561,1897,626],{"class":575},[561,1899,637],{"class":585},[561,1901,1903],{"class":563,"line":1902},36,[561,1904,1180],{"class":575},[561,1906,1908],{"class":563,"line":1907},37,[561,1909,1614],{"class":575},[546,1911,1912,1913,1915,1916,1919,1920,1923],{},"Throw an error with a ",[558,1914,558],{}," property and ",[558,1917,1918],{},"outcome: \"error\""," plus ",[558,1921,1922],{},"errorCode"," are recorded automatically:",[550,1925,1927],{"className":552,"code":1926,"filename":1350,"language":555,"meta":556,"style":556},"throw Object.assign(new Error('Config missing'), { code: 'CONFIG_NOT_FOUND' })\n",[558,1928,1929],{"__ignoreMap":556},[561,1930,1931,1934,1936,1938,1940,1942,1944,1946,1948,1950,1953,1955,1957,1959,1961,1963,1965,1967,1970,1972,1974],{"class":563,"line":564},[561,1932,1933],{"class":742},"throw",[561,1935,1805],{"class":571},[561,1937,1332],{"class":575},[561,1939,1810],{"class":567},[561,1941,909],{"class":571},[561,1943,1815],{"class":575},[561,1945,1818],{"class":567},[561,1947,909],{"class":571},[561,1949,626],{"class":575},[561,1951,1952],{"class":622},"Config missing",[561,1954,626],{"class":575},[561,1956,1019],{"class":571},[561,1958,576],{"class":575},[561,1960,746],{"class":575},[561,1962,1836],{"class":585},[561,1964,589],{"class":575},[561,1966,619],{"class":575},[561,1968,1969],{"class":622},"CONFIG_NOT_FOUND",[561,1971,626],{"class":575},[561,1973,757],{"class":575},[561,1975,637],{"class":571},[546,1977,1978,1979,1982],{},"A minimal sync handler for comparison — flags are auto-captured, you only ",[558,1980,1981],{},"set()"," business counters:",[550,1984,1987],{"className":552,"code":1985,"filename":1986,"language":555,"meta":556,"style":556},"import { telemetry } from '@evlog\u002Ftelemetry'\n\nexport const syncCommand = {\n  meta: { name: 'sync', description: 'Pull remote state' },\n  args: {\n    dryRun: { type: 'boolean' },\n    output: { type: 'string', description: 'Output path' },\n  },\n  async run() {\n    const itemsSynced = await pullRemoteState()\n    telemetry.set({ itemsSynced })\n  },\n}\n","src\u002Fcommands\u002Fsync.ts",[558,1988,1989,2007,2011,2024,2057,2065,2086,2121,2125,2135,2151,2170,2174],{"__ignoreMap":556},[561,1990,1991,1993,1995,1997,1999,2001,2003,2005],{"class":563,"line":564},[561,1992,743],{"class":742},[561,1994,746],{"class":575},[561,1996,1361],{"class":571},[561,1998,757],{"class":575},[561,2000,760],{"class":742},[561,2002,619],{"class":575},[561,2004,791],{"class":622},[561,2006,768],{"class":575},[561,2008,2009],{"class":563,"line":582},[561,2010,839],{"emptyLinePlaceholder":838},[561,2012,2013,2015,2017,2020,2022],{"class":563,"line":598},[561,2014,887],{"class":742},[561,2016,890],{"class":845},[561,2018,2019],{"class":571}," syncCommand ",[561,2021,852],{"class":575},[561,2023,579],{"class":575},[561,2025,2026,2028,2030,2032,2034,2036,2038,2040,2042,2044,2046,2048,2050,2053,2055],{"class":563,"line":611},[561,2027,1636],{"class":585},[561,2029,589],{"class":575},[561,2031,746],{"class":575},[561,2033,925],{"class":585},[561,2035,589],{"class":575},[561,2037,619],{"class":575},[561,2039,1280],{"class":622},[561,2041,626],{"class":575},[561,2043,576],{"class":575},[561,2045,938],{"class":585},[561,2047,589],{"class":575},[561,2049,619],{"class":575},[561,2051,2052],{"class":622},"Pull remote state",[561,2054,626],{"class":575},[561,2056,1666],{"class":575},[561,2058,2059,2061,2063],{"class":563,"line":631},[561,2060,1671],{"class":585},[561,2062,589],{"class":575},[561,2064,579],{"class":575},[561,2066,2067,2070,2072,2074,2076,2078,2080,2082,2084],{"class":563,"line":842},[561,2068,2069],{"class":585},"    dryRun",[561,2071,589],{"class":575},[561,2073,746],{"class":575},[561,2075,1687],{"class":585},[561,2077,589],{"class":575},[561,2079,619],{"class":575},[561,2081,1694],{"class":622},[561,2083,626],{"class":575},[561,2085,1666],{"class":575},[561,2087,2088,2091,2093,2095,2097,2099,2101,2104,2106,2108,2110,2112,2114,2117,2119],{"class":563,"line":862},[561,2089,2090],{"class":585},"    output",[561,2092,589],{"class":575},[561,2094,746],{"class":575},[561,2096,1687],{"class":585},[561,2098,589],{"class":575},[561,2100,619],{"class":575},[561,2102,2103],{"class":622},"string",[561,2105,626],{"class":575},[561,2107,576],{"class":575},[561,2109,938],{"class":585},[561,2111,589],{"class":575},[561,2113,619],{"class":575},[561,2115,2116],{"class":622},"Output path",[561,2118,626],{"class":575},[561,2120,1666],{"class":575},[561,2122,2123],{"class":563,"line":879},[561,2124,1180],{"class":575},[561,2126,2127,2129,2131,2133],{"class":563,"line":884},[561,2128,1722],{"class":845},[561,2130,1725],{"class":585},[561,2132,1429],{"class":575},[561,2134,579],{"class":575},[561,2136,2137,2139,2142,2144,2146,2149],{"class":563,"line":903},[561,2138,1766],{"class":845},[561,2140,2141],{"class":571}," itemsSynced",[561,2143,1442],{"class":575},[561,2145,1774],{"class":742},[561,2147,2148],{"class":567}," pullRemoteState",[561,2150,1476],{"class":585},[561,2152,2153,2156,2158,2160,2162,2164,2166,2168],{"class":563,"line":915},[561,2154,2155],{"class":571},"    telemetry",[561,2157,1332],{"class":575},[561,2159,1583],{"class":567},[561,2161,909],{"class":585},[561,2163,1008],{"class":575},[561,2165,2141],{"class":571},[561,2167,757],{"class":575},[561,2169,637],{"class":585},[561,2171,2172],{"class":563,"line":962},[561,2173,1180],{"class":575},[561,2175,2176],{"class":563,"line":972},[561,2177,1614],{"class":575},[541,2179,2181],{"id":2180},"setup-without-citty","Setup without citty",[546,2183,2184,2185,2188,2189,589],{},"For scripts, migrators, or custom CLIs, use ",[558,2186,2187],{},"createTelemetry()"," and wrap each logical run with ",[558,2190,2191],{},"t.run()",[550,2193,2196],{"className":552,"code":2194,"filename":2195,"language":555,"meta":556,"style":556},"import { createTelemetry, telemetry } from '@evlog\u002Ftelemetry'\n\nconst t = createTelemetry({ name: 'my-migrator', version: '2.0.0' })\n\nawait t.run('migrate', async () => {\n  const rows = await migrateBatch()\n  telemetry.set({ rowsMigrated: rows.length, batchSize: 500 })\n})\n\nawait t.flush() \u002F\u002F optional — also runs at end of each t.run()\n","scripts\u002Fmigrate.ts",[558,2197,2198,2221,2225,2268,2272,2306,2322,2360,2366,2370],{"__ignoreMap":556},[561,2199,2200,2202,2204,2207,2209,2211,2213,2215,2217,2219],{"class":563,"line":564},[561,2201,743],{"class":742},[561,2203,746],{"class":575},[561,2205,2206],{"class":571}," createTelemetry",[561,2208,576],{"class":575},[561,2210,1361],{"class":571},[561,2212,757],{"class":575},[561,2214,760],{"class":742},[561,2216,619],{"class":575},[561,2218,791],{"class":622},[561,2220,768],{"class":575},[561,2222,2223],{"class":563,"line":582},[561,2224,839],{"emptyLinePlaceholder":838},[561,2226,2227,2229,2232,2234,2236,2238,2240,2242,2244,2246,2249,2251,2253,2255,2257,2259,2262,2264,2266],{"class":563,"line":598},[561,2228,846],{"class":845},[561,2230,2231],{"class":571}," t ",[561,2233,852],{"class":575},[561,2235,2206],{"class":567},[561,2237,909],{"class":571},[561,2239,1008],{"class":575},[561,2241,925],{"class":585},[561,2243,589],{"class":575},[561,2245,619],{"class":575},[561,2247,2248],{"class":622},"my-migrator",[561,2250,626],{"class":575},[561,2252,576],{"class":575},[561,2254,952],{"class":585},[561,2256,589],{"class":575},[561,2258,619],{"class":575},[561,2260,2261],{"class":622},"2.0.0",[561,2263,626],{"class":575},[561,2265,757],{"class":575},[561,2267,637],{"class":571},[561,2269,2270],{"class":563,"line":611},[561,2271,839],{"emptyLinePlaceholder":838},[561,2273,2274,2277,2280,2282,2284,2286,2288,2291,2293,2295,2298,2301,2304],{"class":563,"line":631},[561,2275,2276],{"class":742},"await",[561,2278,2279],{"class":571}," t",[561,2281,1332],{"class":575},[561,2283,1212],{"class":567},[561,2285,909],{"class":571},[561,2287,626],{"class":575},[561,2289,2290],{"class":622},"migrate",[561,2292,626],{"class":575},[561,2294,576],{"class":575},[561,2296,2297],{"class":845}," async",[561,2299,2300],{"class":575}," ()",[561,2302,2303],{"class":845}," =>",[561,2305,579],{"class":575},[561,2307,2308,2310,2313,2315,2317,2320],{"class":563,"line":842},[561,2309,1466],{"class":845},[561,2311,2312],{"class":571}," rows",[561,2314,1442],{"class":575},[561,2316,1774],{"class":742},[561,2318,2319],{"class":567}," migrateBatch",[561,2321,1476],{"class":585},[561,2323,2324,2326,2328,2330,2332,2334,2337,2339,2341,2343,2346,2348,2351,2353,2356,2358],{"class":563,"line":862},[561,2325,1578],{"class":571},[561,2327,1332],{"class":575},[561,2329,1583],{"class":567},[561,2331,909],{"class":585},[561,2333,1008],{"class":575},[561,2335,2336],{"class":585}," rowsMigrated",[561,2338,589],{"class":575},[561,2340,2312],{"class":571},[561,2342,1332],{"class":575},[561,2344,2345],{"class":571},"length",[561,2347,576],{"class":575},[561,2349,2350],{"class":585}," batchSize",[561,2352,589],{"class":575},[561,2354,2355],{"class":1445}," 500",[561,2357,757],{"class":575},[561,2359,637],{"class":585},[561,2361,2362,2364],{"class":563,"line":879},[561,2363,634],{"class":575},[561,2365,637],{"class":571},[561,2367,2368],{"class":563,"line":884},[561,2369,839],{"emptyLinePlaceholder":838},[561,2371,2372,2374,2376,2378,2381,2384],{"class":563,"line":903},[561,2373,2276],{"class":742},[561,2375,2279],{"class":571},[561,2377,1332],{"class":575},[561,2379,2380],{"class":567},"flush",[561,2382,2383],{"class":571},"() ",[561,2385,2386],{"class":1572},"\u002F\u002F optional — also runs at end of each t.run()\n",[546,2388,2389,2390,2393,2394,2397,2398,2401,2402,2405,2406,2409,2410,675,2413,2416],{},"GitHub Actions: swap ",[558,2391,2392],{},"createTelemetry"," for ",[558,2395,2396],{},"createGitHubActionsTelemetry()"," in the same file — it adds ",[558,2399,2400],{},"ghaAction"," and ",[558,2403,2404],{},"ghaEvent"," to ",[558,2407,2408],{},"custom"," from ",[558,2411,2412],{},"GITHUB_ACTION",[558,2414,2415],{},"GITHUB_EVENT_NAME"," only (never repo content).",[550,2418,2421],{"className":552,"code":2419,"filename":2420,"language":555,"meta":556,"style":556},"import { createGitHubActionsTelemetry, telemetry } from '@evlog\u002Ftelemetry'\n\nconst t = createGitHubActionsTelemetry({ name: 'my-action', version: '1.0.0' })\n\nawait t.run('report', async () => {\n  const artifacts = await collectArtifacts()\n  telemetry.set({ artifactCount: artifacts.length })\n})\n","scripts\u002Fci-report.ts",[558,2422,2423,2446,2450,2491,2495,2524,2540,2567],{"__ignoreMap":556},[561,2424,2425,2427,2429,2432,2434,2436,2438,2440,2442,2444],{"class":563,"line":564},[561,2426,743],{"class":742},[561,2428,746],{"class":575},[561,2430,2431],{"class":571}," createGitHubActionsTelemetry",[561,2433,576],{"class":575},[561,2435,1361],{"class":571},[561,2437,757],{"class":575},[561,2439,760],{"class":742},[561,2441,619],{"class":575},[561,2443,791],{"class":622},[561,2445,768],{"class":575},[561,2447,2448],{"class":563,"line":582},[561,2449,839],{"emptyLinePlaceholder":838},[561,2451,2452,2454,2456,2458,2460,2462,2464,2466,2468,2470,2473,2475,2477,2479,2481,2483,2485,2487,2489],{"class":563,"line":598},[561,2453,846],{"class":845},[561,2455,2231],{"class":571},[561,2457,852],{"class":575},[561,2459,2431],{"class":567},[561,2461,909],{"class":571},[561,2463,1008],{"class":575},[561,2465,925],{"class":585},[561,2467,589],{"class":575},[561,2469,619],{"class":575},[561,2471,2472],{"class":622},"my-action",[561,2474,626],{"class":575},[561,2476,576],{"class":575},[561,2478,952],{"class":585},[561,2480,589],{"class":575},[561,2482,619],{"class":575},[561,2484,874],{"class":622},[561,2486,626],{"class":575},[561,2488,757],{"class":575},[561,2490,637],{"class":571},[561,2492,2493],{"class":563,"line":611},[561,2494,839],{"emptyLinePlaceholder":838},[561,2496,2497,2499,2501,2503,2505,2507,2509,2512,2514,2516,2518,2520,2522],{"class":563,"line":631},[561,2498,2276],{"class":742},[561,2500,2279],{"class":571},[561,2502,1332],{"class":575},[561,2504,1212],{"class":567},[561,2506,909],{"class":571},[561,2508,626],{"class":575},[561,2510,2511],{"class":622},"report",[561,2513,626],{"class":575},[561,2515,576],{"class":575},[561,2517,2297],{"class":845},[561,2519,2300],{"class":575},[561,2521,2303],{"class":845},[561,2523,579],{"class":575},[561,2525,2526,2528,2531,2533,2535,2538],{"class":563,"line":842},[561,2527,1466],{"class":845},[561,2529,2530],{"class":571}," artifacts",[561,2532,1442],{"class":575},[561,2534,1774],{"class":742},[561,2536,2537],{"class":567}," collectArtifacts",[561,2539,1476],{"class":585},[561,2541,2542,2544,2546,2548,2550,2552,2555,2557,2559,2561,2563,2565],{"class":563,"line":862},[561,2543,1578],{"class":571},[561,2545,1332],{"class":575},[561,2547,1583],{"class":567},[561,2549,909],{"class":585},[561,2551,1008],{"class":575},[561,2553,2554],{"class":585}," artifactCount",[561,2556,589],{"class":575},[561,2558,2530],{"class":571},[561,2560,1332],{"class":575},[561,2562,2345],{"class":571},[561,2564,757],{"class":575},[561,2566,637],{"class":585},[561,2568,2569,2571],{"class":563,"line":879},[561,2570,634],{"class":575},[561,2572,637],{"class":571},[541,2574,2576],{"id":2575},"debug","Debug",[550,2578,2582],{"className":2579,"code":2580,"language":2581,"meta":556,"style":556},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","EVLOG_TELEMETRY_DEBUG=1 my-tool doctor\nEVLOG_TELEMETRY=0 my-tool sync\n","bash",[558,2583,2584,2600],{"__ignoreMap":556},[561,2585,2586,2589,2591,2594,2597],{"class":563,"line":564},[561,2587,2588],{"class":571},"EVLOG_TELEMETRY_DEBUG",[561,2590,852],{"class":575},[561,2592,2593],{"class":622},"1",[561,2595,2596],{"class":1752}," my-tool",[561,2598,2599],{"class":622}," doctor\n",[561,2601,2602,2605,2607,2610,2612],{"class":563,"line":582},[561,2603,2604],{"class":571},"EVLOG_TELEMETRY",[561,2606,852],{"class":575},[561,2608,2609],{"class":622},"0",[561,2611,2596],{"class":1752},[561,2613,2614],{"class":622}," sync\n",[546,2616,2617],{},"Debug mode prints would-be payloads to stderr. Nothing is sent unless an endpoint is configured and delivery succeeds.",[2619,2620,2621],"style",{},"html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":556,"searchDepth":582,"depth":582,"links":2623},[2624,2625,2629,2630],{"id":543,"depth":582,"text":544},{"id":713,"depth":582,"text":714,"children":2626},[2627,2628],{"id":1203,"depth":598,"text":1204},{"id":1335,"depth":598,"text":1336},{"id":2180,"depth":582,"text":2181},{"id":2575,"depth":582,"text":2576},"Wire @evlog\u002Ftelemetry into citty CLIs, standalone scripts, and GitHub Actions — delivery config, automatic flag capture, telemetry.set(), and debug mode.","md",[2634,2637,2638],{"label":36,"icon":39,"to":414,"color":2635,"variant":2636},"neutral","subtle",{"label":422,"icon":425,"to":423,"color":2635,"variant":2636},{"label":427,"icon":79,"to":428,"color":2635,"variant":2636},{},{"title":417,"icon":420},{"title":536,"description":2631},"zsC4jkj4B4QMmFDZXGjeRuvYwZ6VyYcHWeZrNGXGo4s",[2644,2646],{"title":36,"path":414,"stem":415,"description":2645,"icon":39,"children":-1},"Wide-event telemetry for CLIs and automation — evlog's one-event-per-run model for tools on user machines, with privacy-safe flags, consent, outbox, and auto-generated disclosure.",{"title":422,"path":423,"stem":424,"description":2647,"icon":425,"children":-1},"Build a server ingestion endpoint for @evlog\u002Ftelemetry — semi-public threat model, parseIngestBody validation, framework routes, idempotent storage, and rate limiting.",1786743657920]