feat: accept plural orgs/users as canonical --for values

[kylemac]

Summary

• Switches the canonical --for values on clerk enable billing and clerk disable billing from singular (org/user) to plural (orgs/users), since the plural forms read more naturally.
• Keeps the singular forms accepted as backward-compatible aliases so existing scripts and docs keep working.
• Updates help text, examples, error messages, tab-completion hints, READMEs, and the cross-reference in clerk disable orgs warnings, plus tests that cover both canonical and alias inputs.

Test plan

• bun run test packages/cli-core/src/commands/billing/index.test.ts
• bun run typecheck
• bun run lint
• Manually verify clerk enable billing --for orgs and --for org both still work

[changeset-bot]

🦋 Changeset detected

Latest commit: 39352f2

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
clerk	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: f34d006f-2e85-497b-bf83-e16c722b14b0

📥 Commits

Reviewing files that changed from the base of the PR and between a5ad43b and 39352f2.

📒 Files selected for processing (1)

• packages/cli-core/src/cli-program.ts

Disabled knowledge base sources:

• Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.

---

📝 Walkthrough

Walkthrough

This PR updates the Clerk CLI billing command to use plural forms (orgs, users) as canonical values for the --for flag while maintaining backward compatibility with singular forms (org, user) as aliases. The core change introduces target alias mapping that canonicalizes inputs, updates enable/disable logic to conditionally trigger organization cascading and field toggling based on pluralized targets, and synchronizes CLI help text, command documentation, shell completion, and inline error messages across billing and related orgs commands.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• clerk/cli#274: The main PR and the retrieved PR make the same code-level change: they canonicalize the billing --for values to plural orgs/users (keeping singular aliases) and update the same CLI help, parsing, tests, completion, and docs accordingly.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'feat: accept plural orgs/users as canonical --for values' accurately and concisely describes the main change, which is switching the primary --for flag values from singular to plural forms.
Description check	✅ Passed	The description clearly explains the changeset: switching canonical --for values to plural forms while maintaining backward compatibility with singular aliases, with a comprehensive list of affected areas and testing requirements.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

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