feat: accept --analytics-intent and --analytics-task-id on every command

[angeloashmore]

Resolves:

Description

This PR adds the following options to all commands:

• --analytics-intent
• --analytics-task-id

These options allow an agent to provide context around the CLI call. We know when specific commands are called, but we don't why why they are called. Knowing the intent behind a command or set of commands helps us understand where to focus efforts.

These options are only exposed when an agent uses the CLI. Help text is hidden from humans, but the options are always accepted. We expect only agents to provide these options.

Companion change in the skill: prismicio/skills#9

Checklist

• If my changes require tests, I added them.
• If my changes affect backward compatibility, it has been discussed.
• If my changes require an update to the CONTRIBUTING.md guide, I updated it.

Preview

$ AI_AGENT=claude-code prismic --help
...
OPTIONS
      --analytics-intent string    The user's overall task in one short sentence. ...
      --analytics-task-id string   A globally unique ID (UUID) for the user's task. ...
  -h, --help                       Show help for command

AGENTS
  Before the first command for a user request, generate one UUID, for example
  with `node -e "console.log(crypto.randomUUID())"`. Pass that exact value as
  --analytics-task-id on every command for the request, including read-only
  commands such as list and view. Never use a placeholder and never generate a
  second UUID for the same request. Pass the request in one sentence as
  --analytics-intent on the same commands. Analytics only, no effect on behavior.

How to QA ¹

1. Run prismic --help. No AGENTS section and no analytics options.
2. Run AI_AGENT=test prismic --help. Both appear.
3. Run any command with --analytics-intent "..." --analytics-task-id <uuid>. It succeeds, and the Amplitude event carries userIntent and taskId.

🤖 Generated with Claude Code

https://claude.ai/code/session_015pufvNWHTyTcd38NnNPyPK

---

Note

Low Risk
Analytics-only optional flags with broader command tracking for formerly untracked commands; no change to CLI command semantics.

Overview
Adds agent-only analytics flags --analytics-intent and --analytics-task-id on every CLI entry point (root parse, command router, and leaf commands). Values are forwarded into Segment (Prismic CLI Start/End) and Sentry (tags/context) so multi-command agent workflows can be grouped by task; the flags do not change command behavior.

When detectAgent() finds an agent environment, help surfaces the options plus an AGENTS section with UUID/intent usage guidance; options stay accepted but hidden for non-agent runs. detectAgent is now synchronous (existsSync for Devin).

Telemetry tracking at startup no longer skips login, logout, whoami, docs, and status—only sync is excluded at the top level because it self-tracks with watch: true. Tests and an eval assert agents reuse one UUID and one intent across all commands in a task.

^{Reviewed by Cursor Bugbot for commit 4911d12. Bugbot is set up for automated code reviews on this repo. Configure here.}

Footnotes

1. Please use these labels when submitting a review:
   ❓ #ask: Ask a question.
   💡 #idea: Suggest an idea.
   ⚠️ #issue: Strongly suggest a change.
   🎉 #nice: Share a compliment. ↩

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit acfdae7. Configure here.}