feat(sheets): add +get-revision shortcut

[zhengzhijiej-tech]

What

Adds a read-only +get-revision shortcut that returns a spreadsheet's current document revision (version number).

Why

There is no lightweight way to fetch just the current revision. The existing options either return a full payload (+workbook-info lists every sub-sheet's metadata) or require reading cell data with a range (+cells-get / +csv-get). +get-revision hands callers the single number directly.

How

It is a thin read-only derivative over the existing get_workbook_structure read — the lightest read (token only, no range) — and projects the response down to the single revision field. No new backend capability is required; the revision is already present on read responses.

• lark_sheet_get_revision.go — shortcut + projectRevision helper
• lark_sheet_get_revision_test.go — unit test for the projection
• shortcuts.go — registration
• data/flag-defs.json + flag_defs_gen.go — flag definitions (mirrors +workbook-info: --url / --spreadsheet-token XOR)

Testing

• go build ./... and go test ./shortcuts/... pass, including the flag-defs drift and registration-contract tests.
• Manual: --dry-run renders the expected invoke_read / get_workbook_structure call; execute returns {"revision": N} matching +workbook-info; the --url and --token alias forms and the missing-locator error all behave as expected.

[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: 4cab37d5-4f80-459a-9b50-c9777eff619b

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
• Commit unit tests in branch feat/get-revision-shortcut

---

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.}