Skip to content

docs(user-guide): clarify backfill-my-metrics --yes scope - #55

Open
audip wants to merge 1 commit into
datadog-labs:mainfrom
audip:docs/clarify-backfill-yes-scope
Open

docs(user-guide): clarify backfill-my-metrics --yes scope#55
audip wants to merge 1 commit into
datadog-labs:mainfrom
audip:docs/clarify-backfill-yes-scope

Conversation

@audip

@audip audip commented Aug 16, 2026

Copy link
Copy Markdown

Fixes #53

--my-usage and --task-metrics weren't documented anywhere in USER-GUIDE.md or METRICS-REFERENCE.md as being dry-run-only presets with no real-execution path of their own. This led to reading the -dry-run flag's help text ("use --my-usage --yes or --task-metrics --yes for an authorized historical repair") as implying a real publish path for non-Codex clients, when in practice --yes always executes either the Codex-source cost repair or a --campaign-gated managed replay, regardless of which preset flag is passed.

This adds a short clarifying note right after the existing Codex-repair example in USER-GUIDE.md, stating that plainly.

Docs-only change; no code/test impact.

--my-usage/--task-metrics only shape the dry-run preview; --yes alone
only executes a Codex-source cost repair or a --campaign-gated managed
replay. Users on other clients (e.g. Claude Code) were misreading the
--dry-run help text as implying a real publish path that doesn't exist.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@audip
audip requested a review from mr-lee as a code owner August 16, 2026 14:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

backfill-my-metrics: --yes silently no-ops for non-Codex clients despite --my-usage/--task-metrics, and reports complete=true

1 participant