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