retire(data): remove the phantom CloudOperations surface

[yinlianghui]

Fixes #4152

Executes the maintainer ruling of 2026-08-11 (four-lens review) recorded on the card: the CloudOperations surface is removed, not repaired; fabricated success is banned; the false module header goes with it.

Premise re-measured on this tip, at rc.6

The card was filed against @objectstack/client@17.0.0-rc.5. The dependency has since moved to ^17.0.0-rc.6, so the premise was re-probed against the installed package before deleting anything — if rc.6 had added a cloud namespace, the ruling would have been made against a fact that expired.

It has not. The module's runtime export list is exactly seven names:

FilterBuilder, ObjectStackClient, QueryBuilder, RealtimeAPI,
ScopedProjectClient, createFilter, createQuery

and a constructed client's .cloud is undefined. The instance carries actions, ai, analytics, approvals, auth, automation, data, datasources, email, i18n, keys, meta, notifications, oauth, organizations, packages, projects, reports, search, security, shareLinks, shares, storage — note that the two nearest real surfaces, projects (which owns /api/v1/cloud/environments) and packages (which owns marketplace installs), are not what these methods reached for. client.cloud?.deploy, client.cloud?.getDeployment and client.cloud?.marketplace resolve undefined exactly as the card measured, so every method returned its fallback literal — deploy() handing back a well-formed deploymentId for work that never left the process.

Consumer measurement, and the stub-vs-delete verdict

The ruling permits a compile-compatibility stub throwing loud NotImplemented, but only where a compile need is demonstrated. Measured repo-wide (all .ts / .tsx / .md / .mdx / .json, excluding node_modules), the importers of CloudOperations and the three types were:

site	what it did
packages/data-objectstack/src/index.ts	the re-exports themselves
packages/data-objectstack/src/v3-compat.test.ts	three cases constructing it against a client stub of {}
packages/data-objectstack/src/cloud-environment-vocabulary.pin.test.ts	imported CloudDeploymentConfig as a type (objectui#3720's pin)
.changeset/cloud-deploy-environment-vocabulary-3720.md	prose, not code

No app, no other package, no doc page, no README. content/docs/ and the package README were swept for CloudOperations / cloud-namespace claims and returned zero hits, so there was no published documentation to correct.

Verdict: delete outright. With no consumer that must keep compiling, a stub would be a second phantom surface guarding the first. This is confirmed downstream rather than assumed — see the consumer sweep below.

objectui#3720's pin retires with its subject

cloud-environment-vocabulary.pin.test.ts pinned the doc comment on CloudDeploymentConfig.environment: the deliberate three-member deploy-target vocabulary, and the trap that staging is not a DiscoveryEnvironment member. Its subject is deleted here, so the pin retires with it rather than being re-pointed.

Checked before deciding: every fact it held was a claim about that comment, and its two spec-side assertions (the DiscoveryEnvironmentSchema and EnvironmentTypeSchema member lists) existed only to keep those claims honest. Grepped repo-wide, that pin was the only in-repo reader of either schema — with the comment gone they would pin an upstream library's enums on behalf of no local reader, which is the same phantom shape this card closes.

#3720's own conclusion is unaffected and now moot: it found no producer-side deploy-target type to converge onto because the producer did not exist, and this PR removes the consumer that was waiting for one. Its pending changeset (cloud-deploy-environment-vocabulary-3720.md) is removed too — it never released, and it announced a deliberate vocabulary on a type this same release deletes.

What replaces the retired tests

v3-compat.test.ts's three cloud cases asserted only that the results had the right keys, which is how the emptiness stayed green for as long as it did. They are replaced by a negative pin, src/cloud-surface-retired-4152.pin.test.ts, which fails if any of the four names returns. It reads both surfaces, and the two halves are not redundant:

• the runtime half enumerates the package entry's bindings — catches the class, structurally blind to the types, since export type erases;
• the source-text half reads index.ts for the names and for a re-export of ./cloud — the only instrument that can see a returning type.

Reverse verification

Prediction stated before running: restoring cloud.ts and the re-exports from origin/main turns the pin red, and the three type names must stay green in the runtime half while being caught only by the source-text half.

Confirmed — git checkout origin/main -- cloud.ts index.ts, re-run, restore:

Tests  8 failed | 4 passed (12)
x `CloudOperations` is not a runtime binding of the package entry
v `CloudDeploymentConfig` is not a runtime binding of the package entry   (erased - the documented blind spot)
v `CloudHostingConfig` is not a runtime binding of the package entry      (erased)
v `CloudMarketplaceEntry` is not a runtime binding of the package entry   (erased)
x exports no other `Cloud`-prefixed binding either  -> expected [ 'CloudOperations' ] to deeply equal []
x index.ts re-exports nothing from `./cloud`
x index.ts does not name `CloudOperations` / `CloudDeploymentConfig` / `CloudHostingConfig` / `CloudMarketplaceEntry`   (4 cases)
x the cloud.ts module itself is gone

The three erased types passing the runtime half and failing only the source-text half is the measured justification for keeping both halves — drop either one and half the retired surface can come back green. (Honest correction: the direction was predicted correctly, but the count stated up front was "7 red"; the enumeration it was drawn from adds to 8. Actual is 8 red / 4 green.)

Gates

• vitest run --project unit packages/data-objectstack/ — 27 files, 388 tests passed, both before the reverse verification and after restoring.
• The new pin verbosely: 12 passed.
• Build closure, then a full turbo run build (43/43 successful) — needed because the consumer sweep type-checks against built dist/*.d.ts, and a stale tree reports a removal as "cannot find module".
• Freshly built public surface checked directly: dist/index.d.ts and dist/index.js contain zero occurrences of the four retired names.
• Consumer sweep, prefix / downstream direction (pnpm --filter '...@object-ui/data-objectstack' type-check) — 34 of 46 workspace projects, all Done, including @object-ui/react, app-shell, apps/console, every plugin-*, runner, cli and the examples. Nothing downstream was using the removed surface, which is what turns the delete-vs-stub verdict from a presumption into a measurement.
• pnpm --filter '@object-ui/data-objectstack' lint — 0 errors (355 pre-existing any warnings in index.ts / userState.ts, none in the changed files).
• check:control-bytes OK; check-changeset-no-major OK; check-changeset-presence OK (1 changeset for 4 changed source files of 1 released package).

Changeset is minor per the repo's version policy and the retirement precedent (#4145): objectui's own breaking changes never declare major. The removed names are spelled out FROM → TO in its body.

---

Generated by Claude Code

[vercel]

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectui	Ignored		Aug 11, 2026 5:53am

[github-actions]

✅ Console Performance Budget

Metric	Value	Budget
Main entry (gzip)	28.3 KB	350 KB
Entry file	index-C9XWHY8c.js	—
Status	PASS	—

---

📦 Bundle Size Report

Package	Size	Gzipped
app-shell (index.js)	8.88KB	3.25KB
app-shell (runtime-config.js)	7.42KB	2.32KB
app-shell (types.js)	0.01KB	0.04KB
app-shell (urlParams.js)	7.57KB	2.97KB
auth (AuthContext.js)	0.31KB	0.24KB
auth (AuthGuard.js)	1.17KB	0.53KB
auth (AuthProvider.js)	22.10KB	4.37KB
auth (AuthShell.js)	3.49KB	1.40KB
auth (ForgotPasswordForm.js)	12.21KB	3.45KB
auth (LoginForm.js)	18.13KB	5.39KB
auth (PreviewBanner.js)	0.90KB	0.50KB
auth (RegisterForm.js)	6.64KB	2.21KB
auth (SocialSignInButtons.js)	9.60KB	3.89KB
auth (UserMenu.js)	3.40KB	1.22KB
auth (auth-gate-events.js)	1.29KB	0.66KB
auth (authStyles.js)	5.04KB	1.72KB
auth (createAuthClient.js)	35.76KB	9.11KB
auth (createAuthenticatedFetch.js)	4.37KB	1.69KB
auth (index.js)	2.35KB	1.07KB
auth (org-roles.js)	6.66KB	2.78KB
auth (phone-identifier.js)	1.11KB	0.66KB
auth (types.js)	0.59KB	0.35KB
auth (useAuth.js)	4.91KB	0.87KB
auth (useIsWorkspaceAdmin.js)	1.61KB	0.85KB
collaboration (CommentThread.js)	26.07KB	7.56KB
collaboration (LiveCursors.js)	3.17KB	1.27KB
collaboration (PresenceAvatars.js)	6.49KB	2.64KB
collaboration (PresenceProvider.js)	2.79KB	1.13KB
collaboration (index.js)	1.65KB	0.73KB
collaboration (useCollaborationTranslation.js)	6.05KB	2.52KB
collaboration (useCommentSearch.js)	1.98KB	0.88KB
collaboration (useConflictResolution.js)	7.75KB	1.86KB
collaboration (useMentionNotifications.js)	1.81KB	0.68KB
collaboration (usePresence.js)	6.33KB	1.84KB
collaboration (useRealtimeSubscription.js)	7.91KB	2.01KB
components (index.js)	488.60KB	108.25KB
core (index.js)	3.04KB	1.15KB
create-plugin (index.js)	10.08KB	3.26KB
data-objectstack (index.js)	144.34KB	37.61KB
fields (index.js)	228.33KB	56.58KB
i18n (LocalizationContext.js)	1.76KB	0.96KB
i18n (currency.js)	1.22KB	0.64KB
i18n (i18n.js)	4.32KB	1.77KB
i18n (index.js)	2.65KB	1.06KB
i18n (pickLocalized.js)	1.70KB	0.83KB
i18n (provider.js)	9.48KB	3.27KB
i18n (useObjectLabel.js)	27.59KB	6.63KB
i18n (useSafeTranslation.js)	4.52KB	1.96KB
layout (index.js)	38.98KB	10.85KB
mobile (MobileProvider.js)	0.92KB	0.49KB
mobile (ResponsiveContainer.js)	0.94KB	0.38KB
mobile (breakpoints.js)	1.51KB	0.70KB
mobile (createOfflineDataSource.js)	5.61KB	1.74KB
mobile (index.js)	1.50KB	0.62KB
mobile (offlineQueue.js)	3.91KB	1.35KB
mobile (pwa.js)	0.97KB	0.49KB
mobile (serviceWorker.js)	1.48KB	0.62KB
mobile (serviceWorkerSource.js)	3.41KB	1.48KB
mobile (useBreakpoint.js)	1.54KB	0.65KB
mobile (useGesture.js)	6.96KB	1.98KB
mobile (useOfflineSync.js)	1.99KB	0.72KB
mobile (usePullToRefresh.js)	2.53KB	0.85KB
mobile (useResponsive.js)	0.71KB	0.42KB
mobile (useResponsiveConfig.js)	1.36KB	0.63KB
mobile (useSpecGesture.js)	4.32KB	1.64KB
mobile (useTouchTarget.js)	1.01KB	0.54KB
permissions (MePermissionsProvider.js)	8.75KB	3.06KB
permissions (PermissionContext.js)	0.31KB	0.25KB
permissions (PermissionGuard.js)	0.89KB	0.45KB
permissions (PermissionProvider.js)	3.67KB	1.12KB
permissions (evaluator.js)	4.41KB	1.44KB
permissions (index.js)	0.91KB	0.41KB
permissions (store.js)	0.91KB	0.42KB
permissions (useFieldPermissions.js)	1.28KB	0.52KB
permissions (usePermissions.js)	1.55KB	0.71KB
plugin-ai (index.js)	15.71KB	3.79KB
plugin-calendar (index.js)	45.23KB	12.45KB
plugin-charts (index.js)	61.52KB	17.49KB
plugin-chatbot (index.js)	180.33KB	42.79KB
plugin-dashboard (index.js)	118.58KB	30.71KB
plugin-designer (index.js)	210.85KB	42.64KB
plugin-detail (index.js)	238.53KB	59.65KB
plugin-editor (index.js)	2.46KB	1.10KB
plugin-form (index.js)	114.58KB	27.68KB
plugin-gantt (index.js)	164.14KB	39.98KB
plugin-grid (index.js)	187.97KB	49.90KB
plugin-kanban (index.js)	48.60KB	13.41KB
plugin-list (index.js)	110.31KB	26.76KB
plugin-map (index.js)	17.00KB	5.32KB
plugin-markdown (index.js)	13.72KB	4.69KB
plugin-report (index.js)	40.58KB	10.58KB
plugin-timeline (index.js)	26.21KB	7.52KB
plugin-tree (index.js)	8.50KB	2.88KB
plugin-view (index.js)	84.03KB	20.55KB
providers (DataSourceProvider.js)	0.75KB	0.39KB
providers (MetadataProvider.js)	1.37KB	0.59KB
providers (ThemeProvider.js)	1.90KB	0.85KB
providers (UploadProvider.js)	11.71KB	3.53KB
providers (index.js)	0.44KB	0.22KB
providers (types.js)	0.01KB	0.04KB
react-runtime (index.js)	5.67KB	2.37KB
react (LazyPluginLoader.js)	3.77KB	1.33KB
react (SchemaRenderer.js)	23.71KB	7.96KB
react (data-invalidation.js)	5.05KB	2.08KB
react (index.js)	1.23KB	0.66KB
react (spec-input.js)	0.20KB	0.18KB
sdui-parser (codegen.js)	4.09KB	1.74KB
sdui-parser (index.js)	4.47KB	2.03KB
sdui-parser (parse.js)	10.04KB	2.82KB
sdui-parser (types.js)	0.29KB	0.24KB
sdui-parser (validate.js)	4.69KB	1.48KB
types (ai.js)	0.20KB	0.17KB
types (api-types.js)	0.20KB	0.18KB
types (app.js)	2.87KB	0.99KB
types (base.js)	0.20KB	0.18KB
types (blocks.js)	0.20KB	0.18KB
types (complex.js)	0.20KB	0.18KB
types (crud.js)	0.20KB	0.18KB
types (data-display.js)	0.20KB	0.18KB
types (data-protocol.js)	0.20KB	0.19KB
types (data.js)	0.20KB	0.18KB
types (designer.js)	1.87KB	0.85KB
types (disclosure.js)	0.20KB	0.18KB
types (error-code.js)	1.54KB	0.88KB
types (feedback.js)	0.20KB	0.18KB
types (field-types.js)	0.20KB	0.18KB
types (form.js)	0.20KB	0.18KB
types (http-retry.js)	4.32KB	2.02KB
types (index.js)	2.71KB	1.34KB
types (layout.js)	0.20KB	0.18KB
types (managed-by.js)	0.19KB	0.18KB
types (mobile.js)	2.59KB	1.31KB
types (navigation.js)	0.20KB	0.18KB
types (objectql.js)	0.20KB	0.18KB
types (overlay.js)	0.20KB	0.18KB
types (permissions.js)	0.20KB	0.18KB
types (plugin-scope.js)	0.20KB	0.18KB
types (record-components.js)	0.20KB	0.19KB
types (record-semantics.js)	1.28KB	0.67KB
types (registry.js)	0.20KB	0.18KB
types (reports.js)	0.20KB	0.18KB
types (spec-report.js)	5.05KB	1.93KB
types (system-fields.js)	3.33KB	1.54KB
types (theme.js)	0.20KB	0.18KB
types (ui-action.js)	3.40KB	1.71KB
types (views.js)	0.20KB	0.18KB
types (widget.js)	0.20KB	0.18KB

Size Limits

• ✅ Core packages should be < 50KB gzipped
• ✅ Component packages should be < 100KB gzipped
• ⚠️ Plugin packages should be < 150KB gzipped