docs: zombiectl telemetry — supabase-aligned envs + default-ON + AI tool attribution

[indykish]

Summary

Companion docs for usezombie/usezombie#332 (M74_001 Effect-TS substrate migration + supabase telemetry alignment).

• cli/configuration.mdx — env-var table grows by 5 rows (telemetry knobs) + new Telemetry section explains the on-by-default posture, the two opt-out signals (ZOMBIE_TELEMETRY_DISABLED=1 and DO_NOT_TRACK=1), the persistent ~/.config/zombiectl/telemetry.json path, and what is and isn't collected.
• changelog.mdx — May 19 entry tagged Breaking / CLI flags the env-var renames + default flip + new ai_tool event property. Upgrading section is explicit about each rename.

Test plan

• mintlify dev renders cli/configuration.mdx without broken links
• Changelog block parses cleanly under existing imports
• No broken refs to the renamed DISABLE_TELEMETRY / ZOMBIE_POSTHOG_* names elsewhere in the docs tree (rg -n 'DISABLE_TELEMETRY|ZOMBIE_POSTHOG_(KEY|HOST)' --type mdx returns zero)

🤖 Generated with Claude Code

Greptile Summary

This PR adds companion documentation for the zombiectl telemetry overhaul: a new Telemetry section and six env-var rows in cli/configuration.mdx, and a Breaking / CLI changelog entry for May 18 2026.

• cli/configuration.mdx gains ZOMBIE_STATE_DIR + five telemetry knobs (ZOMBIE_TELEMETRY_DISABLED, DO_NOT_TRACK, ZOMBIE_TELEMETRY_POSTHOG_KEY, ZOMBIE_TELEMETRY_POSTHOG_HOST, ZOMBIE_TELEMETRY_DEBUG) in the env-var table, plus a Telemetry prose section with per-command, per-shell, and persistent opt-out examples.
• changelog.mdx adds an upgrade guide covering the renamed vars, the default-ON flip, ai_tool event attribution, and the newly documented ZOMBIE_STATE_DIR; section order follows the AGENTS.md convention (Upgrading → What's new → CLI).
• All three issues from the previous review round (Supabase capitalisation, missing ZOMBIE_STATE_DIR changelog entry, hardcoded ~/.config/zombiectl path) are resolved in the current commit.

Confidence Score: 5/5

Documentation-only change; no executable code is modified.

Both files add or update documentation prose and a changelog entry. The env-var names, opt-out semantics, and file paths are internally consistent across the table, the Telemetry section, and the changelog. All three issues flagged in the previous review round have been addressed in subsequent commits.

No files require special attention.

Important Files Changed

Filename	Overview
cli/configuration.mdx	Adds ZOMBIE_STATE_DIR + five telemetry env-var rows and a new Telemetry section; all three issues flagged in the previous review round have been addressed.
changelog.mdx	New Breaking/CLI Update block for May 18 2026; section order follows AGENTS.md convention; env-var renames are accurately described and the ZOMBIE_STATE_DIR callout is present.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[zombiectl invoked] --> B{Env vars checked}
    B --> C{ZOMBIE_TELEMETRY_DISABLED=1\nor DO_NOT_TRACK=1?}
    C -- Yes --> D[consent = denied\nno telemetry sent]
    C -- No --> E{Read $ZOMBIE_STATE_DIR/telemetry.json}
    E --> F{consent value?}
    F -- granted --> G[Send telemetry event]
    F -- denied --> D
    F -- missing/first run --> H[Bootstrap file\nconsent = granted]
    H --> G
    G --> I[Attach ai_tool property\nvia @vercel/detect-agent]
    I --> J[PostHog ingest\nZOMBIE_TELEMETRY_POSTHOG_HOST]

Loading

_{Reviews (4): Last reviewed commit: "Merge branch 'main' of github.com:usezom..." | Re-trigger Greptile}