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