fix(sheets): allow +pivot-create to omit both sheet selectors

[zhengzhijiej-tech]

Summary

manage_pivot_table_object treats sheet_id / sheet_name as the placement target — when both are absent, handleCreate() auto-creates a new sub-sheet to host the pivot table. The CLI's flag schema didn't reflect that:

• A third flag --target-sheet-id duplicated the same wire field as --sheet-id, leaving callers unsure which one to use.
• --sheet-id / --sheet-name had "XOR with the other" descriptions that read like "operation context", so callers (especially LLM tool callers) felt obligated to set one. Frequently that ended up being the source sheet, which silently disabled the backend's auto-create guardrail and dropped the pivot at A1 — overlapping the source data with #REF!.

This PR aligns the CLI to the backend's actual contract.

Changes

Wire schema (synced from sheet-skill-spec companion change):

• Drop the duplicate --target-sheet-id flag from +pivot-create.
• Rewrite --sheet-id / --sheet-name descriptions to make placement-target semantics explicit, and call out that omitting both is the recommended path.

Implementation:

• helpers.go: new optionalSheetSelector ("at most one" — both empty allowed; both set still rejected). requireSheetSelector is untouched, so every existing caller keeps the exactly-one contract.
• lark_sheet_object_crud.go: objectCRUDSpec gains allowEmptySheetSelectorOnCreate; objectCreateInput dispatches to optionalSheetSelector when set. Only pivotSpec opts in; chart / cond-format / sparkline / filter-view / float-image continue to require a sheet selector.
• DryRun/Execute switch to direct flag extraction (same pattern Validate already used) so the XOR check happens in exactly one place — the input builder.
• pivotSpec.enhanceCreateInput: remove the branch that read the now-removed --target-sheet-id flag.

Test plan

• TestPivotCreate_SheetSelectorSemantics covers both-empty (accepted), both-set (rejected with "mutually exclusive"), and single-set (accepted) paths.
• TestObjectCreate_RequiresSheetSelector regresses chart / cond-format / sparkline / filter-view to confirm the relaxation is scoped to pivot only.
• Existing TestObjectCRUDShortcuts_DryRun updated: removed --target-sheet-id from the pivot case, added a both-empty case asserting the input has no sheet_id / sheet_name.
• go build ./... && go test ./shortcuts/sheets/... pass.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: fd43c8e3-b476-480b-896b-fab6ae014269

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}