feat(activity): add activity reset --clear-heartbeat-details

[ks-temporal]

What changed?

Resurrects the --reset-heartbeats flag removed from activity reset
in PR #1092, as a new flag --clear-heartbeat-details. It controls the
existing reset_heartbeat field on both the single-activity request and
the batch operation, and the proto field is unchanged as ResetHeartbeat.

💥 #1092 also hardcoded reset_heartbeat: true on the batch path,
so batch resets via --query always cleared the heartbeat details, while the
single-activity did not, as the default is to not clear the details. This change
in behavior was triggered in that PR, and now this new PR reverts the
default behavior to what was before that PR.
Both paths are now controlled by this flag.

Rename #reset-heartbeats anchor to #clear-heartbeat-details
for consistency.

Tests cover the flag on both single activity and batch paths.

Checklist

Stability

• Breaking changes are marked with 💥 in the PR title and release notes

Design

• New flags are named after the API concept, not the implementation mechanism (good: --search-attribute, bad: --index-field)
• New flags don't duplicate an existing flag that serves the same purpose
• New flags do not have short aliases without strong justification

Help text (see style guide at the top of commands.yaml)

• All flags shown in help text and examples are implemented and functional

Tests

• Added functional test(s) (SharedServerSuite)

[Copilot]

🟡 Changes recommended

The breaking batch-default change is not marked with 💥 in the PR title as required.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Adds activity reset --clear-heartbeat-details, consistently controlling heartbeat clearing for single and batch resets.

Changes:

• Adds and documents the new flag.
• Maps it to ResetHeartbeat for both reset paths.
• Adds request-level and functional tests.

File summaries

File	Description
internal/temporalcli/commands.yaml	Defines flag and help text.
internal/temporalcli/commands.gen.go	Updates generated command wiring.
internal/temporalcli/commands.activity.go	Applies flag to reset requests.
internal/temporalcli/commands.activity_test.go	Tests defaults, mapping, and behavior.

Review details

• Files reviewed: 4/4 changed files
• Comments generated: 1
• Review effort level: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.