fix(cli): correct three descriptions the CLI publishes, and restore --no-recursive

[waleedlatif1]

Summary

Follow-ups from reviewing the v0.8.12 release PR (#7090). Three of its comments land on files the CLI audit (#7083) touched; these are the two that were real, plus a regression that audit introduced on the same flag.

• credentialId described an operation it cannot perform. PATCH and DELETE shared one params schema, so the disconnect reference read "Credential to update or disconnect." Split into two schemas — the OpenAPI document already publishes them as two components (UpdateCredentialParams, DeleteCredentialParams), so this only makes the prose match what the spec already claims.
• Bare boolean flags advertised a value list they never print. A boolean query param documents the spellings an HTTP caller may send and closes by calling them the whole accepted set. The CLI renders those fields as bare flags taking no value, so the sentence pointed at nothing in both --help and the generated reference. Stripped at the CLI layer only — the contract prose and the OpenAPI specs still document the spellings, which REST callers can act on.
• files list --recursive lost its false spelling. The audit made it a bare switch, which dropped --recursive false. The API turns recursive on by itself as soon as --search is set, so a folder search always descended into subfolders with no way to stop it. The --no-recursive twin is back, declared per flag so one-way toggles (--async, --select-all, the folder deletes) don't grow a negation that only restates their default.

The third review comment — that dropping organizationId from the audit-log cursor scope lets an org-A cursor be replayed against org B — does not apply; reasoning posted on the thread. member carries uniqueIndex('member_user_id_unique'), and resolveEnterpriseAuditAccess refuses any organization the caller is not a member of, so one caller can never authorize two organizations.

Type of Change

• Bug fix

Testing

• New tests for all three, each verified to fail against the unfixed code. One asserts the ordering that keeps Commander from giving --no-recursive an implicit true default, which would otherwise have made every unqualified files list override the API's own conditional default.
• Full suites green: apps/sim 33,272 tests, sim-cli 607 tests.
• bun run lint, all 33 audits (check:audits), and type-check in both workspaces pass. All generated artifacts regenerated canonically (generate:cli-api, generate:cli-docs, generate:openapi).

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Building	Preview	Aug 26, 2026 2:24am

[greptile-apps]

Greptile Summary

The PR corrects operation-specific credential descriptions and restores explicit recursive control for folder searches.

• Splits update and delete credential parameter schemas so generated OpenAPI and CLI documentation describe each operation accurately.
• Adds per-flag negation support and enables --no-recursive for files list without changing the API-controlled default when neither spelling is supplied.
• Removes HTTP boolean-vocabulary prose from bare CLI flags while retaining it in API contracts.
• Regenerates the CLI reference, resource specification, and generated API projection, with focused option-parsing and request-building tests.

Confidence Score: 5/5

The PR appears safe to merge, with the restored negated flag, request serialization, generated interfaces, and documentation remaining aligned.

The positive and negative recursive flags resolve to the intended booleans, omission preserves the API’s conditional default, and the credential schema split changes only operation-specific descriptions.

Important Files Changed

Filename	Overview
packages/sim-cli/src/runtime/options.ts	Adds targeted boolean-help normalization and opt-in negated options while preserving required-valued boolean handling.
packages/sim-cli/src/contract/commands.ts	Marks only the files-list recursive flag as negatable, restoring explicit false behavior without affecting one-way toggles.
packages/sim-cli/src/contract/types.ts	Extends flag metadata with an optional negatable marker and documents its intended narrow use.
apps/sim/lib/api/contracts/v2/credentials.ts	Separates update and delete path schemas so operation-specific descriptions propagate correctly.
packages/sim-cli/src/runtime/options.test.ts	Covers help-text cleanup, both recursive flag spellings, and omission when neither flag is present.
packages/sim-cli/src/runtime/request.test.ts	Verifies explicit true and false recursive values survive request construction.
packages/sim-cli/src/generated/v2-api.ts	Regenerated projection remains aligned with the updated credential contracts.
apps/docs/content/docs/en/cli/reference.mdx	Regenerated reference accurately publishes credential argument descriptions and both recursive flag spellings.

_{Reviews (1): Last reviewed commit: "fix(cli): correct three descriptions the..." | Re-trigger Greptile}