[{"data":1,"prerenderedAt":3125},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-telemetry-reference":529,"-use-cases-telemetry-reference-surround":3120},[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],{"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",{"id":530,"title":531,"body":532,"description":3108,"extension":3109,"links":3110,"meta":3116,"navigation":3117,"path":428,"seo":3118,"stem":429,"__hash__":3119},"docs\u002F5.use-cases\u002F4.telemetry\u002F04.reference.md","Telemetry Reference",{"type":533,"value":534,"toc":3092},"minimark",[535,540,544,915,919,937,940,997,1000,1033,1038,1049,1352,1355,1512,1521,1541,1545,1548,1818,1826,1830,1837,2122,2131,2137,2146,2225,2235,2239,2245,2383,2387,2482,2497,2501,2504,2513,2685,2694,2707,2713,2717,2728,2764,2857,2868,2872,2884,3022,3032,3036,3056,3066,3075,3088],[536,537,539],"h2",{"id":538},"standard-envelope","Standard envelope",[541,542,543],"p",{},"Every run shares the same shape. You do not declare per-command schemas.",[545,546,551],"pre",{"className":547,"code":548,"language":549,"meta":550,"style":550},"language-jsonc shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"event\": \"run\",\n  \"command\": \"sync\",\n  \"durationMs\": 412,\n  \"outcome\": \"success\",\n  \"flags\": { \"dryRun\": true, \"output\": true },\n  \"tool\": { \"name\": \"my-tool\", \"version\": \"1.0.0\" },\n  \"env\": {\n    \"node\": \"20.11\",\n    \"ci\": false,\n    \"provider\": null,\n    \"tty\": true,\n    \"agent\": \"cursor\"   \u002F\u002F std-env: cursor, claude, codex, … or null\n  },\n  \"machineId\": \"ab3f…\", \u002F\u002F hashed; omitted in ephemeral CI\n  \"custom\": { \"itemsSynced\": 42 }\n}\n","jsonc","",[552,553,554,563,591,612,630,651,694,745,760,782,797,812,827,850,856,880,909],"code",{"__ignoreMap":550},[555,556,559],"span",{"class":557,"line":558},"line",1,[555,560,562],{"class":561},"sMK4o","{\n",[555,564,566,569,573,576,579,582,586,588],{"class":557,"line":565},2,[555,567,568],{"class":561},"  \"",[555,570,572],{"class":571},"spNyl","event",[555,574,575],{"class":561},"\"",[555,577,578],{"class":561},":",[555,580,581],{"class":561}," \"",[555,583,585],{"class":584},"sfazB","run",[555,587,575],{"class":561},[555,589,590],{"class":561},",\n",[555,592,594,596,599,601,603,605,608,610],{"class":557,"line":593},3,[555,595,568],{"class":561},[555,597,598],{"class":571},"command",[555,600,575],{"class":561},[555,602,578],{"class":561},[555,604,581],{"class":561},[555,606,607],{"class":584},"sync",[555,609,575],{"class":561},[555,611,590],{"class":561},[555,613,615,617,620,622,624,628],{"class":557,"line":614},4,[555,616,568],{"class":561},[555,618,619],{"class":571},"durationMs",[555,621,575],{"class":561},[555,623,578],{"class":561},[555,625,627],{"class":626},"sbssI"," 412",[555,629,590],{"class":561},[555,631,633,635,638,640,642,644,647,649],{"class":557,"line":632},5,[555,634,568],{"class":561},[555,636,637],{"class":571},"outcome",[555,639,575],{"class":561},[555,641,578],{"class":561},[555,643,581],{"class":561},[555,645,646],{"class":584},"success",[555,648,575],{"class":561},[555,650,590],{"class":561},[555,652,654,656,659,661,663,666,668,672,674,676,679,681,684,686,688,691],{"class":557,"line":653},6,[555,655,568],{"class":561},[555,657,658],{"class":571},"flags",[555,660,575],{"class":561},[555,662,578],{"class":561},[555,664,665],{"class":561}," {",[555,667,581],{"class":561},[555,669,671],{"class":670},"sBMFI","dryRun",[555,673,575],{"class":561},[555,675,578],{"class":561},[555,677,678],{"class":561}," true,",[555,680,581],{"class":561},[555,682,683],{"class":670},"output",[555,685,575],{"class":561},[555,687,578],{"class":561},[555,689,690],{"class":561}," true",[555,692,693],{"class":561}," },\n",[555,695,697,699,702,704,706,708,710,713,715,717,719,722,724,727,729,732,734,736,738,741,743],{"class":557,"line":696},7,[555,698,568],{"class":561},[555,700,701],{"class":571},"tool",[555,703,575],{"class":561},[555,705,578],{"class":561},[555,707,665],{"class":561},[555,709,581],{"class":561},[555,711,712],{"class":670},"name",[555,714,575],{"class":561},[555,716,578],{"class":561},[555,718,581],{"class":561},[555,720,721],{"class":584},"my-tool",[555,723,575],{"class":561},[555,725,726],{"class":561},",",[555,728,581],{"class":561},[555,730,731],{"class":670},"version",[555,733,575],{"class":561},[555,735,578],{"class":561},[555,737,581],{"class":561},[555,739,740],{"class":584},"1.0.0",[555,742,575],{"class":561},[555,744,693],{"class":561},[555,746,748,750,753,755,757],{"class":557,"line":747},8,[555,749,568],{"class":561},[555,751,752],{"class":571},"env",[555,754,575],{"class":561},[555,756,578],{"class":561},[555,758,759],{"class":561}," {\n",[555,761,763,766,769,771,773,775,778,780],{"class":557,"line":762},9,[555,764,765],{"class":561},"    \"",[555,767,768],{"class":670},"node",[555,770,575],{"class":561},[555,772,578],{"class":561},[555,774,581],{"class":561},[555,776,777],{"class":584},"20.11",[555,779,575],{"class":561},[555,781,590],{"class":561},[555,783,785,787,790,792,794],{"class":557,"line":784},10,[555,786,765],{"class":561},[555,788,789],{"class":670},"ci",[555,791,575],{"class":561},[555,793,578],{"class":561},[555,795,796],{"class":561}," false,\n",[555,798,800,802,805,807,809],{"class":557,"line":799},11,[555,801,765],{"class":561},[555,803,804],{"class":670},"provider",[555,806,575],{"class":561},[555,808,578],{"class":561},[555,810,811],{"class":561}," null,\n",[555,813,815,817,820,822,824],{"class":557,"line":814},12,[555,816,765],{"class":561},[555,818,819],{"class":670},"tty",[555,821,575],{"class":561},[555,823,578],{"class":561},[555,825,826],{"class":561}," true,\n",[555,828,830,832,835,837,839,841,844,846],{"class":557,"line":829},13,[555,831,765],{"class":561},[555,833,834],{"class":670},"agent",[555,836,575],{"class":561},[555,838,578],{"class":561},[555,840,581],{"class":561},[555,842,843],{"class":584},"cursor",[555,845,575],{"class":561},[555,847,849],{"class":848},"sHwdD","   \u002F\u002F std-env: cursor, claude, codex, … or null\n",[555,851,853],{"class":557,"line":852},14,[555,854,855],{"class":561},"  },\n",[555,857,859,861,864,866,868,870,873,875,877],{"class":557,"line":858},15,[555,860,568],{"class":561},[555,862,863],{"class":571},"machineId",[555,865,575],{"class":561},[555,867,578],{"class":561},[555,869,581],{"class":561},[555,871,872],{"class":584},"ab3f…",[555,874,575],{"class":561},[555,876,726],{"class":561},[555,878,879],{"class":848}," \u002F\u002F hashed; omitted in ephemeral CI\n",[555,881,883,885,888,890,892,894,896,899,901,903,906],{"class":557,"line":882},16,[555,884,568],{"class":561},[555,886,887],{"class":571},"custom",[555,889,575],{"class":561},[555,891,578],{"class":561},[555,893,665],{"class":561},[555,895,581],{"class":561},[555,897,898],{"class":670},"itemsSynced",[555,900,575],{"class":561},[555,902,578],{"class":561},[555,904,905],{"class":626}," 42",[555,907,908],{"class":561}," }\n",[555,910,912],{"class":557,"line":911},17,[555,913,914],{"class":561},"}\n",[536,916,918],{"id":917},"extending-the-schema","Extending the schema",[541,920,921,922,926,927,930,931,933,934,936],{},"The envelope above is ",[923,924,925],"strong",{},"fixed"," — every tool sends the same top-level shape so ",[552,928,929],{},"parseIngestBody()"," and disclosure stay predictable. You do not add fields next to ",[552,932,598],{}," or ",[552,935,619],{},".",[541,938,939],{},"Your product schema lives in two extension zones:",[941,942,943,959],"table",{},[944,945,946],"thead",{},[947,948,949,953,956],"tr",{},[950,951,952],"th",{},"Zone",[950,954,955],{},"Who sets it",[950,957,958],{},"What goes there",[960,961,962,978],"tbody",{},[947,963,964,969,975],{},[965,966,967],"td",{},[552,968,658],{},[965,970,971,972],{},"citty (auto) + ",[552,973,974],{},"collect.flags",[965,976,977],{},"CLI switches — booleans\u002Fnumbers as values, strings only when allowlisted",[947,979,980,984,994],{},[965,981,982],{},[552,983,887],{},[965,985,986,987,990,991],{},"you via ",[552,988,989],{},"telemetry.set()"," + ",[552,992,993],{},"collect.fields",[965,995,996],{},"Business counters, categorical dimensions, schema version",[541,998,999],{},"Think of it as two contracts:",[1001,1002,1003,1018],"ul",{},[1004,1005,1006,1009,1010,1013,1014,1017],"li",{},[923,1007,1008],{},"Transport contract"," (",[552,1011,1012],{},"RunEvent",") — owned by ",[552,1015,1016],{},"@evlog\u002Ftelemetry",", stable across tools",[1004,1019,1020,1009,1023,1025,1026,1028,1029,1032],{},[923,1021,1022],{},"Product contract",[552,1024,887],{}," + declared ",[552,1027,658],{},") — owned by you, declared in ",[552,1030,1031],{},"collect",", mirrored on the server",[1034,1035,1037],"h3",{"id":1036},"declare-your-extensions-once","Declare your extensions once",[541,1039,1040,1041,1044,1045,1048],{},"Everything you collect beyond the standard envelope is declared inline in the same ",[552,1042,1043],{},"withTelemetry()"," \u002F ",[552,1046,1047],{},"createTelemetry()"," call:",[545,1050,1055],{"className":1051,"code":1052,"filename":1053,"language":1054,"meta":550,"style":550},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","withTelemetry(command, {\n  name: 'acme-cli',\n  version: '2.1.0',\n  endpoint: 'https:\u002F\u002Ftelemetry.acme.dev\u002Fapi\u002Fingest',\n  collect: {\n    flags: {\n      format: ['json', 'yaml', 'table'],\n      target: ['staging', 'production'],\n    },\n    fields: {\n      product: ['cli', 'action', 'migrator'],\n      plan: ['free', 'pro', 'enterprise'],\n      framework: ['nuxt', 'next', 'remix'],\n    },\n  },\n})\n","src\u002Findex.ts","ts",[552,1056,1057,1071,1090,1106,1122,1131,1140,1179,1208,1213,1222,1260,1298,1336,1340,1344],{"__ignoreMap":550},[555,1058,1059,1063,1067,1069],{"class":557,"line":558},[555,1060,1062],{"class":1061},"s2Zo4","withTelemetry",[555,1064,1066],{"class":1065},"sTEyZ","(command",[555,1068,726],{"class":561},[555,1070,759],{"class":561},[555,1072,1073,1077,1079,1082,1085,1088],{"class":557,"line":565},[555,1074,1076],{"class":1075},"swJcz","  name",[555,1078,578],{"class":561},[555,1080,1081],{"class":561}," '",[555,1083,1084],{"class":584},"acme-cli",[555,1086,1087],{"class":561},"'",[555,1089,590],{"class":561},[555,1091,1092,1095,1097,1099,1102,1104],{"class":557,"line":593},[555,1093,1094],{"class":1075},"  version",[555,1096,578],{"class":561},[555,1098,1081],{"class":561},[555,1100,1101],{"class":584},"2.1.0",[555,1103,1087],{"class":561},[555,1105,590],{"class":561},[555,1107,1108,1111,1113,1115,1118,1120],{"class":557,"line":614},[555,1109,1110],{"class":1075},"  endpoint",[555,1112,578],{"class":561},[555,1114,1081],{"class":561},[555,1116,1117],{"class":584},"https:\u002F\u002Ftelemetry.acme.dev\u002Fapi\u002Fingest",[555,1119,1087],{"class":561},[555,1121,590],{"class":561},[555,1123,1124,1127,1129],{"class":557,"line":632},[555,1125,1126],{"class":1075},"  collect",[555,1128,578],{"class":561},[555,1130,759],{"class":561},[555,1132,1133,1136,1138],{"class":557,"line":653},[555,1134,1135],{"class":1075},"    flags",[555,1137,578],{"class":561},[555,1139,759],{"class":561},[555,1141,1142,1145,1147,1150,1152,1155,1157,1159,1161,1164,1166,1168,1170,1172,1174,1177],{"class":557,"line":696},[555,1143,1144],{"class":1075},"      format",[555,1146,578],{"class":561},[555,1148,1149],{"class":1065}," [",[555,1151,1087],{"class":561},[555,1153,1154],{"class":584},"json",[555,1156,1087],{"class":561},[555,1158,726],{"class":561},[555,1160,1081],{"class":561},[555,1162,1163],{"class":584},"yaml",[555,1165,1087],{"class":561},[555,1167,726],{"class":561},[555,1169,1081],{"class":561},[555,1171,941],{"class":584},[555,1173,1087],{"class":561},[555,1175,1176],{"class":1065},"]",[555,1178,590],{"class":561},[555,1180,1181,1184,1186,1188,1190,1193,1195,1197,1199,1202,1204,1206],{"class":557,"line":747},[555,1182,1183],{"class":1075},"      target",[555,1185,578],{"class":561},[555,1187,1149],{"class":1065},[555,1189,1087],{"class":561},[555,1191,1192],{"class":584},"staging",[555,1194,1087],{"class":561},[555,1196,726],{"class":561},[555,1198,1081],{"class":561},[555,1200,1201],{"class":584},"production",[555,1203,1087],{"class":561},[555,1205,1176],{"class":1065},[555,1207,590],{"class":561},[555,1209,1210],{"class":557,"line":762},[555,1211,1212],{"class":561},"    },\n",[555,1214,1215,1218,1220],{"class":557,"line":784},[555,1216,1217],{"class":1075},"    fields",[555,1219,578],{"class":561},[555,1221,759],{"class":561},[555,1223,1224,1227,1229,1231,1233,1236,1238,1240,1242,1245,1247,1249,1251,1254,1256,1258],{"class":557,"line":799},[555,1225,1226],{"class":1075},"      product",[555,1228,578],{"class":561},[555,1230,1149],{"class":1065},[555,1232,1087],{"class":561},[555,1234,1235],{"class":584},"cli",[555,1237,1087],{"class":561},[555,1239,726],{"class":561},[555,1241,1081],{"class":561},[555,1243,1244],{"class":584},"action",[555,1246,1087],{"class":561},[555,1248,726],{"class":561},[555,1250,1081],{"class":561},[555,1252,1253],{"class":584},"migrator",[555,1255,1087],{"class":561},[555,1257,1176],{"class":1065},[555,1259,590],{"class":561},[555,1261,1262,1265,1267,1269,1271,1274,1276,1278,1280,1283,1285,1287,1289,1292,1294,1296],{"class":557,"line":814},[555,1263,1264],{"class":1075},"      plan",[555,1266,578],{"class":561},[555,1268,1149],{"class":1065},[555,1270,1087],{"class":561},[555,1272,1273],{"class":584},"free",[555,1275,1087],{"class":561},[555,1277,726],{"class":561},[555,1279,1081],{"class":561},[555,1281,1282],{"class":584},"pro",[555,1284,1087],{"class":561},[555,1286,726],{"class":561},[555,1288,1081],{"class":561},[555,1290,1291],{"class":584},"enterprise",[555,1293,1087],{"class":561},[555,1295,1176],{"class":1065},[555,1297,590],{"class":561},[555,1299,1300,1303,1305,1307,1309,1312,1314,1316,1318,1321,1323,1325,1327,1330,1332,1334],{"class":557,"line":829},[555,1301,1302],{"class":1075},"      framework",[555,1304,578],{"class":561},[555,1306,1149],{"class":1065},[555,1308,1087],{"class":561},[555,1310,1311],{"class":584},"nuxt",[555,1313,1087],{"class":561},[555,1315,726],{"class":561},[555,1317,1081],{"class":561},[555,1319,1320],{"class":584},"next",[555,1322,1087],{"class":561},[555,1324,726],{"class":561},[555,1326,1081],{"class":561},[555,1328,1329],{"class":584},"remix",[555,1331,1087],{"class":561},[555,1333,1176],{"class":1065},[555,1335,590],{"class":561},[555,1337,1338],{"class":557,"line":852},[555,1339,1212],{"class":561},[555,1341,1342],{"class":557,"line":858},[555,1343,855],{"class":561},[555,1345,1346,1349],{"class":557,"line":882},[555,1347,1348],{"class":561},"}",[555,1350,1351],{"class":1065},")\n",[541,1353,1354],{},"Inside handlers, add counters and dimensions:",[545,1356,1359],{"className":1051,"code":1357,"filename":1358,"language":1054,"meta":550,"style":550},"await t.run('deploy', async () => {\n  const result = await deployServices()\n  telemetry.set({\n    servicesDeployed: result.count,   \u002F\u002F number — always allowed\n    rollbackUsed: false,              \u002F\u002F boolean — always allowed\n    framework: 'nuxt',                \u002F\u002F string — allowed (in collect.fields)\n    schemaVersion: 2,                 \u002F\u002F number — version your custom shape\n  })\n})\n","src\u002Fcommands\u002Fdeploy.ts",[552,1360,1361,1397,1417,1431,1450,1466,1484,1499,1506],{"__ignoreMap":550},[555,1362,1363,1367,1370,1372,1374,1377,1379,1382,1384,1386,1389,1392,1395],{"class":557,"line":558},[555,1364,1366],{"class":1365},"s7zQu","await",[555,1368,1369],{"class":1065}," t",[555,1371,936],{"class":561},[555,1373,585],{"class":1061},[555,1375,1376],{"class":1065},"(",[555,1378,1087],{"class":561},[555,1380,1381],{"class":584},"deploy",[555,1383,1087],{"class":561},[555,1385,726],{"class":561},[555,1387,1388],{"class":571}," async",[555,1390,1391],{"class":561}," ()",[555,1393,1394],{"class":571}," =>",[555,1396,759],{"class":561},[555,1398,1399,1402,1405,1408,1411,1414],{"class":557,"line":565},[555,1400,1401],{"class":571},"  const",[555,1403,1404],{"class":1065}," result",[555,1406,1407],{"class":561}," =",[555,1409,1410],{"class":1365}," await",[555,1412,1413],{"class":1061}," deployServices",[555,1415,1416],{"class":1075},"()\n",[555,1418,1419,1422,1424,1427,1429],{"class":557,"line":593},[555,1420,1421],{"class":1065},"  telemetry",[555,1423,936],{"class":561},[555,1425,1426],{"class":1061},"set",[555,1428,1376],{"class":1075},[555,1430,562],{"class":561},[555,1432,1433,1436,1438,1440,1442,1445,1447],{"class":557,"line":614},[555,1434,1435],{"class":1075},"    servicesDeployed",[555,1437,578],{"class":561},[555,1439,1404],{"class":1065},[555,1441,936],{"class":561},[555,1443,1444],{"class":1065},"count",[555,1446,726],{"class":561},[555,1448,1449],{"class":848},"   \u002F\u002F number — always allowed\n",[555,1451,1452,1455,1457,1461,1463],{"class":557,"line":632},[555,1453,1454],{"class":1075},"    rollbackUsed",[555,1456,578],{"class":561},[555,1458,1460],{"class":1459},"sfNiH"," false",[555,1462,726],{"class":561},[555,1464,1465],{"class":848},"              \u002F\u002F boolean — always allowed\n",[555,1467,1468,1471,1473,1475,1477,1479,1481],{"class":557,"line":653},[555,1469,1470],{"class":1075},"    framework",[555,1472,578],{"class":561},[555,1474,1081],{"class":561},[555,1476,1311],{"class":584},[555,1478,1087],{"class":561},[555,1480,726],{"class":561},[555,1482,1483],{"class":848},"                \u002F\u002F string — allowed (in collect.fields)\n",[555,1485,1486,1489,1491,1494,1496],{"class":557,"line":696},[555,1487,1488],{"class":1075},"    schemaVersion",[555,1490,578],{"class":561},[555,1492,1493],{"class":626}," 2",[555,1495,726],{"class":561},[555,1497,1498],{"class":848},"                 \u002F\u002F number — version your custom shape\n",[555,1500,1501,1504],{"class":557,"line":747},[555,1502,1503],{"class":561},"  }",[555,1505,1351],{"class":1075},[555,1507,1508,1510],{"class":557,"line":762},[555,1509,1348],{"class":561},[555,1511,1351],{"class":1065},[541,1513,1514,1515,1518,1519,936],{},"Undeclared strings are ",[923,1516,1517],{},"dropped at runtime",", never thrown. That is the privacy guarantee — no accidental paths, tokens, or free-form PII in ",[552,1520,887],{},[1522,1523,1524,1527,1528,1531,1532,1534,1535,1537,1538,1540],"note",{},[923,1525,1526],{},"Typing:"," ",[552,1529,1530],{},"TelemetryHandle.set()"," autocomplete covers declared ",[552,1533,993],{}," keys. Use the ambient ",[552,1536,989],{}," for extra numeric\u002Fboolean counters in the same run — both merge into ",[552,1539,887],{}," before the event is recorded.",[1034,1542,1544],{"id":1543},"mirror-on-the-server","Mirror on the server",[541,1546,1547],{},"Your ingest handler is the second gate. Pass the same tool name and custom keys you declared on the CLI:",[545,1549,1552],{"className":1051,"code":1550,"filename":1551,"language":1054,"meta":550,"style":550},"import { parseIngestBody } from '@evlog\u002Ftelemetry\u002Fingest'\n\nconst ALLOWED_CUSTOM = [\n  'servicesDeployed', 'rollbackUsed', 'framework',\n  'product', 'plan', 'schemaVersion',\n  'ghaAction', 'ghaEvent',\n] as const\n\nexport async function POST(req: Request) {\n  const raw = await req.text()\n  const events = parseIngestBody(raw, {\n    allowedTools: ['acme-cli'],\n    allowedCustomKeys: { 'acme-cli': ALLOWED_CUSTOM },\n  })\n  \u002F\u002F dedupe on idempotencyKey, then persist\n}\n","app\u002Fapi\u002Ftelemetry\u002Fingest\u002Froute.ts",[552,1553,1554,1578,1584,1598,1628,1657,1677,1688,1692,1721,1742,1762,1781,1803,1809,1814],{"__ignoreMap":550},[555,1555,1556,1559,1561,1564,1567,1570,1572,1575],{"class":557,"line":558},[555,1557,1558],{"class":1365},"import",[555,1560,665],{"class":561},[555,1562,1563],{"class":1065}," parseIngestBody",[555,1565,1566],{"class":561}," }",[555,1568,1569],{"class":1365}," from",[555,1571,1081],{"class":561},[555,1573,1574],{"class":584},"@evlog\u002Ftelemetry\u002Fingest",[555,1576,1577],{"class":561},"'\n",[555,1579,1580],{"class":557,"line":565},[555,1581,1583],{"emptyLinePlaceholder":1582},true,"\n",[555,1585,1586,1589,1592,1595],{"class":557,"line":593},[555,1587,1588],{"class":571},"const",[555,1590,1591],{"class":1065}," ALLOWED_CUSTOM ",[555,1593,1594],{"class":561},"=",[555,1596,1597],{"class":1065}," [\n",[555,1599,1600,1603,1606,1608,1610,1612,1615,1617,1619,1621,1624,1626],{"class":557,"line":614},[555,1601,1602],{"class":561},"  '",[555,1604,1605],{"class":584},"servicesDeployed",[555,1607,1087],{"class":561},[555,1609,726],{"class":561},[555,1611,1081],{"class":561},[555,1613,1614],{"class":584},"rollbackUsed",[555,1616,1087],{"class":561},[555,1618,726],{"class":561},[555,1620,1081],{"class":561},[555,1622,1623],{"class":584},"framework",[555,1625,1087],{"class":561},[555,1627,590],{"class":561},[555,1629,1630,1632,1635,1637,1639,1641,1644,1646,1648,1650,1653,1655],{"class":557,"line":632},[555,1631,1602],{"class":561},[555,1633,1634],{"class":584},"product",[555,1636,1087],{"class":561},[555,1638,726],{"class":561},[555,1640,1081],{"class":561},[555,1642,1643],{"class":584},"plan",[555,1645,1087],{"class":561},[555,1647,726],{"class":561},[555,1649,1081],{"class":561},[555,1651,1652],{"class":584},"schemaVersion",[555,1654,1087],{"class":561},[555,1656,590],{"class":561},[555,1658,1659,1661,1664,1666,1668,1670,1673,1675],{"class":557,"line":653},[555,1660,1602],{"class":561},[555,1662,1663],{"class":584},"ghaAction",[555,1665,1087],{"class":561},[555,1667,726],{"class":561},[555,1669,1081],{"class":561},[555,1671,1672],{"class":584},"ghaEvent",[555,1674,1087],{"class":561},[555,1676,590],{"class":561},[555,1678,1679,1682,1685],{"class":557,"line":696},[555,1680,1681],{"class":1065},"] ",[555,1683,1684],{"class":1365},"as",[555,1686,1687],{"class":571}," const\n",[555,1689,1690],{"class":557,"line":747},[555,1691,1583],{"emptyLinePlaceholder":1582},[555,1693,1694,1697,1699,1702,1705,1707,1711,1713,1716,1719],{"class":557,"line":762},[555,1695,1696],{"class":1365},"export",[555,1698,1388],{"class":571},[555,1700,1701],{"class":571}," function",[555,1703,1704],{"class":1061}," POST",[555,1706,1376],{"class":561},[555,1708,1710],{"class":1709},"sHdIc","req",[555,1712,578],{"class":561},[555,1714,1715],{"class":670}," Request",[555,1717,1718],{"class":561},")",[555,1720,759],{"class":561},[555,1722,1723,1725,1728,1730,1732,1735,1737,1740],{"class":557,"line":784},[555,1724,1401],{"class":571},[555,1726,1727],{"class":1065}," raw",[555,1729,1407],{"class":561},[555,1731,1410],{"class":1365},[555,1733,1734],{"class":1065}," req",[555,1736,936],{"class":561},[555,1738,1739],{"class":1061},"text",[555,1741,1416],{"class":1075},[555,1743,1744,1746,1749,1751,1753,1755,1758,1760],{"class":557,"line":799},[555,1745,1401],{"class":571},[555,1747,1748],{"class":1065}," events",[555,1750,1407],{"class":561},[555,1752,1563],{"class":1061},[555,1754,1376],{"class":1075},[555,1756,1757],{"class":1065},"raw",[555,1759,726],{"class":561},[555,1761,759],{"class":561},[555,1763,1764,1767,1769,1771,1773,1775,1777,1779],{"class":557,"line":814},[555,1765,1766],{"class":1075},"    allowedTools",[555,1768,578],{"class":561},[555,1770,1149],{"class":1075},[555,1772,1087],{"class":561},[555,1774,1084],{"class":584},[555,1776,1087],{"class":561},[555,1778,1176],{"class":1075},[555,1780,590],{"class":561},[555,1782,1783,1786,1788,1790,1792,1794,1796,1798,1801],{"class":557,"line":829},[555,1784,1785],{"class":1075},"    allowedCustomKeys",[555,1787,578],{"class":561},[555,1789,665],{"class":561},[555,1791,1081],{"class":561},[555,1793,1084],{"class":1075},[555,1795,1087],{"class":561},[555,1797,578],{"class":561},[555,1799,1800],{"class":1065}," ALLOWED_CUSTOM",[555,1802,693],{"class":561},[555,1804,1805,1807],{"class":557,"line":852},[555,1806,1503],{"class":561},[555,1808,1351],{"class":1075},[555,1810,1811],{"class":557,"line":858},[555,1812,1813],{"class":848},"  \u002F\u002F dedupe on idempotencyKey, then persist\n",[555,1815,1816],{"class":557,"line":882},[555,1817,914],{"class":561},[541,1819,1820,1822,1823,1825],{},[552,1821,929],{}," strips any ",[552,1824,887],{}," key you did not list — even if a client somehow sent it.",[1034,1827,1829],{"id":1828},"map-to-your-warehouse-schema","Map to your warehouse schema",[541,1831,1832,1833,1836],{},"After validation, shape the event for ",[923,1834,1835],{},"your"," database. The evlog envelope is the wire format; your tables are your choice:",[545,1838,1841],{"className":1051,"code":1839,"filename":1840,"language":1054,"meta":550,"style":550},"function toRow(event: RunEvent) {\n  return {\n    command: event.command,\n    duration_ms: event.durationMs,\n    outcome: event.outcome,\n    tool_version: event.tool.version,\n    format: event.flags.format,\n    target: event.flags.target,\n    services_deployed: event.custom.servicesDeployed,\n    framework: event.custom.framework,\n    plan: event.custom.plan,\n    schema_version: event.custom.schemaVersion ?? 1,\n    is_ci: event.env.ci,\n    node: event.env.node,\n    received_at: new Date(),\n  }\n}\n","lib\u002Ftelemetry-store.ts",[552,1842,1843,1864,1871,1887,1902,1917,1936,1956,1976,1995,2013,2032,2057,2076,2095,2113,2118],{"__ignoreMap":550},[555,1844,1845,1848,1851,1853,1855,1857,1860,1862],{"class":557,"line":558},[555,1846,1847],{"class":571},"function",[555,1849,1850],{"class":1061}," toRow",[555,1852,1376],{"class":561},[555,1854,572],{"class":1709},[555,1856,578],{"class":561},[555,1858,1859],{"class":670}," RunEvent",[555,1861,1718],{"class":561},[555,1863,759],{"class":561},[555,1865,1866,1869],{"class":557,"line":565},[555,1867,1868],{"class":1365},"  return",[555,1870,759],{"class":561},[555,1872,1873,1876,1878,1881,1883,1885],{"class":557,"line":593},[555,1874,1875],{"class":1075},"    command",[555,1877,578],{"class":561},[555,1879,1880],{"class":1065}," event",[555,1882,936],{"class":561},[555,1884,598],{"class":1065},[555,1886,590],{"class":561},[555,1888,1889,1892,1894,1896,1898,1900],{"class":557,"line":614},[555,1890,1891],{"class":1075},"    duration_ms",[555,1893,578],{"class":561},[555,1895,1880],{"class":1065},[555,1897,936],{"class":561},[555,1899,619],{"class":1065},[555,1901,590],{"class":561},[555,1903,1904,1907,1909,1911,1913,1915],{"class":557,"line":632},[555,1905,1906],{"class":1075},"    outcome",[555,1908,578],{"class":561},[555,1910,1880],{"class":1065},[555,1912,936],{"class":561},[555,1914,637],{"class":1065},[555,1916,590],{"class":561},[555,1918,1919,1922,1924,1926,1928,1930,1932,1934],{"class":557,"line":653},[555,1920,1921],{"class":1075},"    tool_version",[555,1923,578],{"class":561},[555,1925,1880],{"class":1065},[555,1927,936],{"class":561},[555,1929,701],{"class":1065},[555,1931,936],{"class":561},[555,1933,731],{"class":1065},[555,1935,590],{"class":561},[555,1937,1938,1941,1943,1945,1947,1949,1951,1954],{"class":557,"line":696},[555,1939,1940],{"class":1075},"    format",[555,1942,578],{"class":561},[555,1944,1880],{"class":1065},[555,1946,936],{"class":561},[555,1948,658],{"class":1065},[555,1950,936],{"class":561},[555,1952,1953],{"class":1065},"format",[555,1955,590],{"class":561},[555,1957,1958,1961,1963,1965,1967,1969,1971,1974],{"class":557,"line":747},[555,1959,1960],{"class":1075},"    target",[555,1962,578],{"class":561},[555,1964,1880],{"class":1065},[555,1966,936],{"class":561},[555,1968,658],{"class":1065},[555,1970,936],{"class":561},[555,1972,1973],{"class":1065},"target",[555,1975,590],{"class":561},[555,1977,1978,1981,1983,1985,1987,1989,1991,1993],{"class":557,"line":762},[555,1979,1980],{"class":1075},"    services_deployed",[555,1982,578],{"class":561},[555,1984,1880],{"class":1065},[555,1986,936],{"class":561},[555,1988,887],{"class":1065},[555,1990,936],{"class":561},[555,1992,1605],{"class":1065},[555,1994,590],{"class":561},[555,1996,1997,1999,2001,2003,2005,2007,2009,2011],{"class":557,"line":784},[555,1998,1470],{"class":1075},[555,2000,578],{"class":561},[555,2002,1880],{"class":1065},[555,2004,936],{"class":561},[555,2006,887],{"class":1065},[555,2008,936],{"class":561},[555,2010,1623],{"class":1065},[555,2012,590],{"class":561},[555,2014,2015,2018,2020,2022,2024,2026,2028,2030],{"class":557,"line":799},[555,2016,2017],{"class":1075},"    plan",[555,2019,578],{"class":561},[555,2021,1880],{"class":1065},[555,2023,936],{"class":561},[555,2025,887],{"class":1065},[555,2027,936],{"class":561},[555,2029,1643],{"class":1065},[555,2031,590],{"class":561},[555,2033,2034,2037,2039,2041,2043,2045,2047,2049,2052,2055],{"class":557,"line":814},[555,2035,2036],{"class":1075},"    schema_version",[555,2038,578],{"class":561},[555,2040,1880],{"class":1065},[555,2042,936],{"class":561},[555,2044,887],{"class":1065},[555,2046,936],{"class":561},[555,2048,1652],{"class":1065},[555,2050,2051],{"class":561}," ??",[555,2053,2054],{"class":626}," 1",[555,2056,590],{"class":561},[555,2058,2059,2062,2064,2066,2068,2070,2072,2074],{"class":557,"line":829},[555,2060,2061],{"class":1075},"    is_ci",[555,2063,578],{"class":561},[555,2065,1880],{"class":1065},[555,2067,936],{"class":561},[555,2069,752],{"class":1065},[555,2071,936],{"class":561},[555,2073,789],{"class":1065},[555,2075,590],{"class":561},[555,2077,2078,2081,2083,2085,2087,2089,2091,2093],{"class":557,"line":852},[555,2079,2080],{"class":1075},"    node",[555,2082,578],{"class":561},[555,2084,1880],{"class":1065},[555,2086,936],{"class":561},[555,2088,752],{"class":1065},[555,2090,936],{"class":561},[555,2092,768],{"class":1065},[555,2094,590],{"class":561},[555,2096,2097,2100,2102,2105,2108,2111],{"class":557,"line":858},[555,2098,2099],{"class":1075},"    received_at",[555,2101,578],{"class":561},[555,2103,2104],{"class":561}," new",[555,2106,2107],{"class":1061}," Date",[555,2109,2110],{"class":1075},"()",[555,2112,590],{"class":561},[555,2114,2115],{"class":557,"line":882},[555,2116,2117],{"class":561},"  }\n",[555,2119,2120],{"class":557,"line":911},[555,2121,914],{"class":561},[541,2123,2124,2125,2127,2128,2130],{},"This is where a company \"modifies the schema\" in practice — not by changing ",[552,2126,1012],{},", but by defining how ",[552,2129,887],{}," maps into internal analytics tables.",[1034,2132,2134,2135],{"id":2133},"version-breaking-changes-in-custom","Version breaking changes in ",[552,2136,887],{},[541,2138,2139,2140,2142,2143,2145],{},"When your product counters evolve, bump a numeric ",[552,2141,1652],{}," in ",[552,2144,887],{}," (no allowlist needed) and branch in the ingest mapper:",[545,2147,2149],{"className":1051,"code":2148,"language":1054,"meta":550,"style":550},"const version = (event.custom.schemaVersion as number | undefined) ?? 1\nif (version === 1) return mapV1(event)\nreturn mapV2(event)\n",[552,2150,2151,2192,2216],{"__ignoreMap":550},[555,2152,2153,2155,2158,2160,2163,2165,2167,2169,2172,2174,2177,2180,2183,2186,2189],{"class":557,"line":558},[555,2154,1588],{"class":571},[555,2156,2157],{"class":1065}," version ",[555,2159,1594],{"class":561},[555,2161,2162],{"class":1065}," (event",[555,2164,936],{"class":561},[555,2166,887],{"class":1065},[555,2168,936],{"class":561},[555,2170,2171],{"class":1065},"schemaVersion ",[555,2173,1684],{"class":1365},[555,2175,2176],{"class":670}," number",[555,2178,2179],{"class":561}," |",[555,2181,2182],{"class":670}," undefined",[555,2184,2185],{"class":1065},") ",[555,2187,2188],{"class":561},"??",[555,2190,2191],{"class":626}," 1\n",[555,2193,2194,2197,2200,2203,2205,2207,2210,2213],{"class":557,"line":565},[555,2195,2196],{"class":1365},"if",[555,2198,2199],{"class":1065}," (version ",[555,2201,2202],{"class":561},"===",[555,2204,2054],{"class":626},[555,2206,2185],{"class":1065},[555,2208,2209],{"class":1365},"return",[555,2211,2212],{"class":1061}," mapV1",[555,2214,2215],{"class":1065},"(event)\n",[555,2217,2218,2220,2223],{"class":557,"line":593},[555,2219,2209],{"class":1365},[555,2221,2222],{"class":1061}," mapV2",[555,2224,2215],{"class":1065},[541,2226,2227,2228,2231,2232,2234],{},"Commit an updated ",[552,2229,2230],{},"TELEMETRY.md"," whenever ",[552,2233,1031],{}," changes so disclosure stays aligned with releases.",[1034,2236,2238],{"id":2237},"multiple-tools-one-endpoint","Multiple tools, one endpoint",[541,2240,2241,2242,578],{},"If several CLIs POST to the same ingest URL, namespace custom keys or rely on ",[552,2243,2244],{},"tool.name",[545,2246,2248],{"className":1051,"code":2247,"language":1054,"meta":550,"style":550},"\u002F\u002F Option A — prefix keys per product line\ntelemetry.set({ acme_product: 'cli', deployCount: 3 })\n\n\u002F\u002F Option B — separate allowedCustomKeys per tool.name in parseIngestBody\nallowedCustomKeys: {\n  'acme-cli': ['deployCount', 'framework'],\n  'acme-action': ['jobDuration', 'ghaAction', 'ghaEvent'],\n}\n",[552,2249,2250,2255,2293,2297,2302,2311,2341,2379],{"__ignoreMap":550},[555,2251,2252],{"class":557,"line":558},[555,2253,2254],{"class":848},"\u002F\u002F Option A — prefix keys per product line\n",[555,2256,2257,2259,2261,2263,2265,2268,2271,2273,2275,2277,2279,2281,2284,2286,2289,2291],{"class":557,"line":565},[555,2258,119],{"class":1065},[555,2260,936],{"class":561},[555,2262,1426],{"class":1061},[555,2264,1376],{"class":1065},[555,2266,2267],{"class":561},"{",[555,2269,2270],{"class":1075}," acme_product",[555,2272,578],{"class":561},[555,2274,1081],{"class":561},[555,2276,1235],{"class":584},[555,2278,1087],{"class":561},[555,2280,726],{"class":561},[555,2282,2283],{"class":1075}," deployCount",[555,2285,578],{"class":561},[555,2287,2288],{"class":626}," 3",[555,2290,1566],{"class":561},[555,2292,1351],{"class":1065},[555,2294,2295],{"class":557,"line":593},[555,2296,1583],{"emptyLinePlaceholder":1582},[555,2298,2299],{"class":557,"line":614},[555,2300,2301],{"class":848},"\u002F\u002F Option B — separate allowedCustomKeys per tool.name in parseIngestBody\n",[555,2303,2304,2307,2309],{"class":557,"line":632},[555,2305,2306],{"class":670},"allowedCustomKeys",[555,2308,578],{"class":561},[555,2310,759],{"class":561},[555,2312,2313,2315,2317,2319,2322,2324,2327,2329,2331,2333,2335,2337,2339],{"class":557,"line":653},[555,2314,1602],{"class":561},[555,2316,1084],{"class":584},[555,2318,1087],{"class":561},[555,2320,2321],{"class":1075},": [",[555,2323,1087],{"class":561},[555,2325,2326],{"class":584},"deployCount",[555,2328,1087],{"class":561},[555,2330,726],{"class":561},[555,2332,1081],{"class":561},[555,2334,1623],{"class":584},[555,2336,1087],{"class":561},[555,2338,1176],{"class":1075},[555,2340,590],{"class":561},[555,2342,2343,2345,2348,2350,2352,2354,2357,2359,2361,2363,2365,2367,2369,2371,2373,2375,2377],{"class":557,"line":696},[555,2344,1602],{"class":561},[555,2346,2347],{"class":584},"acme-action",[555,2349,1087],{"class":561},[555,2351,2321],{"class":1075},[555,2353,1087],{"class":561},[555,2355,2356],{"class":584},"jobDuration",[555,2358,1087],{"class":561},[555,2360,726],{"class":561},[555,2362,1081],{"class":561},[555,2364,1663],{"class":584},[555,2366,1087],{"class":561},[555,2368,726],{"class":561},[555,2370,1081],{"class":561},[555,2372,1672],{"class":584},[555,2374,1087],{"class":561},[555,2376,1176],{"class":1075},[555,2378,590],{"class":561},[555,2380,2381],{"class":557,"line":747},[555,2382,914],{"class":561},[1034,2384,2386],{"id":2385},"what-v1-does-not-support","What v1 does not support",[941,2388,2389,2402],{},[944,2390,2391],{},[947,2392,2393,2396,2399],{},[950,2394,2395],{},"Need",[950,2397,2398],{},"v1 answer",[950,2400,2401],{},"Workaround",[960,2403,2404,2423,2443,2460,2471],{},[947,2405,2406,2412,2415],{},[965,2407,2408,2409,1718],{},"New top-level field (",[552,2410,2411],{},"tenantId",[965,2413,2414],{},"Not on the wire",[965,2416,2417,2418,2420,2421],{},"Flat key in ",[552,2419,887],{}," + allowlist, or map server-side from ",[552,2422,863],{},[947,2424,2425,2431,2434],{},[965,2426,2427,2428,1718],{},"Nested objects (",[552,2429,2430],{},"custom.user.plan",[965,2432,2433],{},"Flat records only",[965,2435,2436,2437,2440,2441],{},"Flatten: ",[552,2438,2439],{},"userPlan: 'pro'"," with ",[552,2442,993],{},[947,2444,2445,2448,2451],{},[965,2446,2447],{},"Free-form strings (paths, emails)",[965,2449,2450],{},"Blocked by design",[965,2452,2453,2454,2457,2458],{},"Presence-only on flags (",[552,2455,2456],{},"output: true",") or hash before ",[552,2459,989],{},[947,2461,2462,2465,2468],{},[965,2463,2464],{},"Different schema per command",[965,2466,2467],{},"One envelope per run",[965,2469,2470],{},"Convention: only set relevant keys per command",[947,2472,2473,2476,2479],{},[965,2474,2475],{},"Transform before outbox",[965,2477,2478],{},"No hook yet",[965,2480,2481],{},"Map on the server (recommended) or see planned v2 below",[2483,2484,2485,2488,2489,2491,2492,990,2494,2496],"tip",{},[923,2486,2487],{},"Rule of thumb:"," if it is safe to print in ",[552,2490,2230],{}," and fits a closed set or a number, it belongs in ",[552,2493,1031],{},[552,2495,887],{},". Everything else stays server-side.",[1034,2498,2500],{"id":2499},"planned-v2-extensions","Planned v2 extensions",[541,2502,2503],{},"Not shipped yet — design targets for when the v1 extension zones are not enough:",[541,2505,2506,2512],{},[923,2507,2508,2511],{},[552,2509,2510],{},"enrich"," hook"," — run after sanitization, before the outbox append. Lets you inject computed fields without forking the package:",[545,2514,2516],{"className":1051,"code":2515,"language":1054,"meta":550,"style":550},"\u002F\u002F Planned API — not available in v1\ncreateTelemetry({\n  name: 'acme-cli',\n  version: '3.0.0',\n  collect: { fields: { product: ['cli', 'action'] } },\n  enrich(event) {\n    return {\n      ...event,\n      custom: {\n        ...event.custom,\n        schemaVersion: 2,\n      },\n    }\n  },\n})\n",[552,2517,2518,2523,2532,2546,2561,2603,2616,2623,2632,2641,2654,2665,2670,2675,2679],{"__ignoreMap":550},[555,2519,2520],{"class":557,"line":558},[555,2521,2522],{"class":848},"\u002F\u002F Planned API — not available in v1\n",[555,2524,2525,2528,2530],{"class":557,"line":565},[555,2526,2527],{"class":1061},"createTelemetry",[555,2529,1376],{"class":1065},[555,2531,562],{"class":561},[555,2533,2534,2536,2538,2540,2542,2544],{"class":557,"line":593},[555,2535,1076],{"class":1075},[555,2537,578],{"class":561},[555,2539,1081],{"class":561},[555,2541,1084],{"class":584},[555,2543,1087],{"class":561},[555,2545,590],{"class":561},[555,2547,2548,2550,2552,2554,2557,2559],{"class":557,"line":614},[555,2549,1094],{"class":1075},[555,2551,578],{"class":561},[555,2553,1081],{"class":561},[555,2555,2556],{"class":584},"3.0.0",[555,2558,1087],{"class":561},[555,2560,590],{"class":561},[555,2562,2563,2565,2567,2569,2572,2574,2576,2579,2581,2583,2585,2587,2589,2591,2593,2595,2597,2599,2601],{"class":557,"line":632},[555,2564,1126],{"class":1075},[555,2566,578],{"class":561},[555,2568,665],{"class":561},[555,2570,2571],{"class":1075}," fields",[555,2573,578],{"class":561},[555,2575,665],{"class":561},[555,2577,2578],{"class":1075}," product",[555,2580,578],{"class":561},[555,2582,1149],{"class":1065},[555,2584,1087],{"class":561},[555,2586,1235],{"class":584},[555,2588,1087],{"class":561},[555,2590,726],{"class":561},[555,2592,1081],{"class":561},[555,2594,1244],{"class":584},[555,2596,1087],{"class":561},[555,2598,1681],{"class":1065},[555,2600,1348],{"class":561},[555,2602,693],{"class":561},[555,2604,2605,2608,2610,2612,2614],{"class":557,"line":653},[555,2606,2607],{"class":1075},"  enrich",[555,2609,1376],{"class":561},[555,2611,572],{"class":1709},[555,2613,1718],{"class":561},[555,2615,759],{"class":561},[555,2617,2618,2621],{"class":557,"line":696},[555,2619,2620],{"class":1365},"    return",[555,2622,759],{"class":561},[555,2624,2625,2628,2630],{"class":557,"line":747},[555,2626,2627],{"class":561},"      ...",[555,2629,572],{"class":1065},[555,2631,590],{"class":561},[555,2633,2634,2637,2639],{"class":557,"line":762},[555,2635,2636],{"class":1075},"      custom",[555,2638,578],{"class":561},[555,2640,759],{"class":561},[555,2642,2643,2646,2648,2650,2652],{"class":557,"line":784},[555,2644,2645],{"class":561},"        ...",[555,2647,572],{"class":1065},[555,2649,936],{"class":561},[555,2651,887],{"class":1065},[555,2653,590],{"class":561},[555,2655,2656,2659,2661,2663],{"class":557,"line":799},[555,2657,2658],{"class":1075},"        schemaVersion",[555,2660,578],{"class":561},[555,2662,1493],{"class":626},[555,2664,590],{"class":561},[555,2666,2667],{"class":557,"line":814},[555,2668,2669],{"class":561},"      },\n",[555,2671,2672],{"class":557,"line":829},[555,2673,2674],{"class":561},"    }\n",[555,2676,2677],{"class":557,"line":852},[555,2678,855],{"class":561},[555,2680,2681,2683],{"class":557,"line":858},[555,2682,1348],{"class":561},[555,2684,1351],{"class":1065},[541,2686,2687,2688,2690,2691,2693],{},"The hook cannot bypass sanitization rules — strings still require ",[552,2689,993],{},". Server-side ",[552,2692,2306],{}," stays the source of truth.",[541,2695,2696,2699,2700,2703,2704,936],{},[923,2697,2698],{},"Namespaced keys"," — optional ",[552,2701,2702],{},"acme.product"," convention for multi-tool endpoints without prefix collisions. Would be documented in disclosure as ",[552,2705,2706],{},"acme.product: cli | action",[541,2708,2709,2710,2712],{},"If you need one of these before v2 lands, open a discussion on the repo — the v1 path (",[552,2711,887],{}," + server mapping) covers most product analytics needs.",[536,2714,2716],{"id":2715},"privacy","Privacy",[541,2718,2719,2720,2723,2724,2727],{},"Raw ",[552,2721,2722],{},"argv"," is never read. Sanitization applies to ",[923,2725,2726],{},"citty-parsed"," flags only:",[1001,2729,2730,2743,2754],{},[1004,2731,2732,2735,2736,2739,2740,1718],{},[923,2733,2734],{},"Booleans \u002F numbers"," → value stored (",[552,2737,2738],{},"json: true",", ",[552,2741,2742],{},"limit: 50",[1004,2744,2745,2748,2749,2751,2752],{},[923,2746,2747],{},"Strings"," → presence only (",[552,2750,2456],{},") unless allowlisted in ",[552,2753,974],{},[1004,2755,2756,2760,2761,2763],{},[923,2757,2758],{},[552,2759,989],{}," → numbers and booleans always; strings only via ",[552,2762,993],{}," (undeclared values are dropped at runtime, never thrown)",[545,2765,2767],{"className":1051,"code":2766,"filename":1053,"language":1054,"meta":550,"style":550},"collect: {\n  flags: { format: ['json', 'csv'] },           \u002F\u002F --format json → \"json\"; --format yaml → true\n  fields: { framework: ['nuxt', 'next'] },      \u002F\u002F telemetry.set({ framework: 'nuxt' }) ok\n}\n",[552,2768,2769,2777,2816,2853],{"__ignoreMap":550},[555,2770,2771,2773,2775],{"class":557,"line":558},[555,2772,1031],{"class":670},[555,2774,578],{"class":561},[555,2776,759],{"class":561},[555,2778,2779,2782,2784,2786,2789,2791,2793,2795,2797,2799,2801,2803,2806,2808,2810,2813],{"class":557,"line":565},[555,2780,2781],{"class":670},"  flags",[555,2783,578],{"class":561},[555,2785,665],{"class":561},[555,2787,2788],{"class":670}," format",[555,2790,578],{"class":561},[555,2792,1149],{"class":1075},[555,2794,1087],{"class":561},[555,2796,1154],{"class":584},[555,2798,1087],{"class":561},[555,2800,726],{"class":561},[555,2802,1081],{"class":561},[555,2804,2805],{"class":584},"csv",[555,2807,1087],{"class":561},[555,2809,1681],{"class":1075},[555,2811,2812],{"class":561},"},",[555,2814,2815],{"class":848},"           \u002F\u002F --format json → \"json\"; --format yaml → true\n",[555,2817,2818,2821,2823,2825,2828,2830,2832,2834,2836,2838,2840,2842,2844,2846,2848,2850],{"class":557,"line":593},[555,2819,2820],{"class":670},"  fields",[555,2822,578],{"class":561},[555,2824,665],{"class":561},[555,2826,2827],{"class":670}," framework",[555,2829,578],{"class":561},[555,2831,1149],{"class":1075},[555,2833,1087],{"class":561},[555,2835,1311],{"class":584},[555,2837,1087],{"class":561},[555,2839,726],{"class":561},[555,2841,1081],{"class":561},[555,2843,1320],{"class":584},[555,2845,1087],{"class":561},[555,2847,1681],{"class":1075},[555,2849,2812],{"class":561},[555,2851,2852],{"class":848},"      \u002F\u002F telemetry.set({ framework: 'nuxt' }) ok\n",[555,2854,2855],{"class":557,"line":614},[555,2856,914],{"class":561},[541,2858,2859,2860,1044,2862,2864,2865,2867],{},"Declare allowlists in the same ",[552,2861,1043],{},[552,2863,1047],{}," call as ",[552,2866,1031],{}," — no separate config file.",[536,2869,2871],{"id":2870},"disclosure","Disclosure",[541,2873,2874,2877,2878,2880,2881,2883],{},[552,2875,2876],{},"generateDisclosure()"," produces markdown + JSON from the standard envelope plus your ",[552,2879,1031],{}," extensions. Commit the output (e.g. ",[552,2882,2230],{},") so it stays in sync with releases:",[545,2885,2888],{"className":1051,"code":2886,"filename":2887,"language":1054,"meta":550,"style":550},"import { writeFile } from 'node:fs\u002Fpromises'\nimport { generateDisclosure } from '@evlog\u002Ftelemetry'\n\nconst { markdown } = generateDisclosure('my-tool', {\n  flags: { format: ['json', 'csv'] },\n})\n\nawait writeFile('TELEMETRY.md', markdown)\n","scripts\u002Fgenerate-disclosure.ts",[552,2889,2890,2910,2929,2933,2960,2993,2999,3003],{"__ignoreMap":550},[555,2891,2892,2894,2896,2899,2901,2903,2905,2908],{"class":557,"line":558},[555,2893,1558],{"class":1365},[555,2895,665],{"class":561},[555,2897,2898],{"class":1065}," writeFile",[555,2900,1566],{"class":561},[555,2902,1569],{"class":1365},[555,2904,1081],{"class":561},[555,2906,2907],{"class":584},"node:fs\u002Fpromises",[555,2909,1577],{"class":561},[555,2911,2912,2914,2916,2919,2921,2923,2925,2927],{"class":557,"line":565},[555,2913,1558],{"class":1365},[555,2915,665],{"class":561},[555,2917,2918],{"class":1065}," generateDisclosure",[555,2920,1566],{"class":561},[555,2922,1569],{"class":1365},[555,2924,1081],{"class":561},[555,2926,1016],{"class":584},[555,2928,1577],{"class":561},[555,2930,2931],{"class":557,"line":593},[555,2932,1583],{"emptyLinePlaceholder":1582},[555,2934,2935,2937,2939,2942,2944,2946,2948,2950,2952,2954,2956,2958],{"class":557,"line":614},[555,2936,1588],{"class":571},[555,2938,665],{"class":561},[555,2940,2941],{"class":1065}," markdown ",[555,2943,1348],{"class":561},[555,2945,1407],{"class":561},[555,2947,2918],{"class":1061},[555,2949,1376],{"class":1065},[555,2951,1087],{"class":561},[555,2953,721],{"class":584},[555,2955,1087],{"class":561},[555,2957,726],{"class":561},[555,2959,759],{"class":561},[555,2961,2962,2964,2966,2968,2970,2972,2974,2976,2978,2980,2982,2984,2986,2988,2990],{"class":557,"line":632},[555,2963,2781],{"class":1075},[555,2965,578],{"class":561},[555,2967,665],{"class":561},[555,2969,2788],{"class":1075},[555,2971,578],{"class":561},[555,2973,1149],{"class":1065},[555,2975,1087],{"class":561},[555,2977,1154],{"class":584},[555,2979,1087],{"class":561},[555,2981,726],{"class":561},[555,2983,1081],{"class":561},[555,2985,2805],{"class":584},[555,2987,1087],{"class":561},[555,2989,1681],{"class":1065},[555,2991,2992],{"class":561},"},\n",[555,2994,2995,2997],{"class":557,"line":653},[555,2996,1348],{"class":561},[555,2998,1351],{"class":1065},[555,3000,3001],{"class":557,"line":696},[555,3002,1583],{"emptyLinePlaceholder":1582},[555,3004,3005,3007,3009,3011,3013,3015,3017,3019],{"class":557,"line":747},[555,3006,1366],{"class":1365},[555,3008,2898],{"class":1061},[555,3010,1376],{"class":1065},[555,3012,1087],{"class":561},[555,3014,2230],{"class":584},[555,3016,1087],{"class":561},[555,3018,726],{"class":561},[555,3020,3021],{"class":1065}," markdown)\n",[541,3023,3024,3025,3028,3029,936],{},"Users can also read it at runtime via ",[552,3026,3027],{},"my-tool telemetry status"," when you wire ",[552,3030,3031],{},"defineTelemetryCommands()",[536,3033,3035],{"id":3034},"consent-and-reliability","Consent and reliability",[541,3037,3038,1527,3041,3044,3045,3048,3049,1044,3052,3055],{},[923,3039,3040],{},"Opt-out priority:",[552,3042,3043],{},"DO_NOT_TRACK=1"," → ",[552,3046,3047],{},"EVLOG_TELEMETRY=0"," → persisted preference (",[552,3050,3051],{},"disableTelemetry()",[552,3053,3054],{},"telemetry disable","). Opt-out purges the undelivered outbox.",[541,3057,3058,3061,3062,3065],{},[923,3059,3060],{},"Never harms the host:"," telemetry never throws, never blocks exit; ",[552,3063,3064],{},"flush()"," has a 500ms hard cap.",[541,3067,3068,3071,3072,936],{},[923,3069,3070],{},"Outbox:"," events append locally before any network attempt. Offline machines and CI matrix jobs drain the backlog on the next invocation once your ingestion endpoint returns ",[552,3073,3074],{},"2xx",[541,3076,3077,1527,3080,3083,3084,3087],{},[923,3078,3079],{},"Endpoint:",[552,3081,3082],{},"EVLOG_TELEMETRY_ENDPOINT"," env → ",[552,3085,3086],{},"endpoint"," option baked into the CLI. Omit both during local development; ship the URL when your ingest handler is live.",[3089,3090,3091],"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 .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 .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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":550,"searchDepth":565,"depth":565,"links":3093},[3094,3095,3105,3106,3107],{"id":538,"depth":565,"text":539},{"id":917,"depth":565,"text":918,"children":3096},[3097,3098,3099,3100,3102,3103,3104],{"id":1036,"depth":593,"text":1037},{"id":1543,"depth":593,"text":1544},{"id":1828,"depth":593,"text":1829},{"id":2133,"depth":593,"text":3101},"Version breaking changes in custom",{"id":2237,"depth":593,"text":2238},{"id":2385,"depth":593,"text":2386},{"id":2499,"depth":593,"text":2500},{"id":2715,"depth":565,"text":2716},{"id":2870,"depth":565,"text":2871},{"id":3034,"depth":565,"text":3035},"RunEvent envelope, extending the schema with collect and custom fields, privacy rules, TELEMETRY.md disclosure, and consent \u002F outbox reliability.","md",[3111,3114,3115],{"label":36,"icon":39,"to":414,"color":3112,"variant":3113},"neutral","subtle",{"label":417,"icon":420,"to":418,"color":3112,"variant":3113},{"label":422,"icon":425,"to":423,"color":3112,"variant":3113},{},{"title":427,"icon":79},{"title":531,"description":3108},"A-AYHsGkiOxEVVutjiOOgVDuldgWeEIaX69sHHg5OmA",[3121,3123],{"title":422,"path":423,"stem":424,"description":3122,"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.",{"title":431,"path":432,"stem":433,"description":3124,"icon":434,"children":-1},"Add derived context to every wide event automatically — user agent, geo, request size, and trace context. Built-in enrichers from evlog\u002Fenrichers, plus how to compose them with your own.",1785882655059]