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