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