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