Skip to content

fix(data-objectstack): deleteView removes every home the view has — draft-only, published, and pairs (#4479) - #4562

Merged
yinlianghui merged 1 commit into
mainfrom
claude/issue-4479-delete-view-both-homes
Aug 13, 2026
Merged

fix(data-objectstack): deleteView removes every home the view has — draft-only, published, and pairs (#4479)#4562
yinlianghui merged 1 commit into
mainfrom
claude/issue-4479-delete-view-both-homes

Conversation

@yinlianghui

Copy link
Copy Markdown
Collaborator

Fixes #4479

The defect

A saved view has two possible homes — the pending per-item draft (DELETE /api/v1/meta/view/:name?state=draft) and the published overlay (DELETE /api/v1/meta/view/:name). deleteView addressed only the second, unqualified. Deleting a draft-only view therefore fired the delete at the published overlay, the server answered

200 {"success":true,"reset":false,"message":"No view '…' found — nothing to delete."}

the draft survived untouched, the tab was still present after reload, and the receipt reported { deleted: false } with nothing surfacing the refusal.

Premise re-verified on current origin/main before implementing: still valid, unchanged.

Why the mirror of #4139 is not mechanical

updateView probes the draft first and writes back to whichever home the read resolved. Copying that here would be wrong on a published + pending draft pair: a draft-first-only delete discards the draft and leaves the published row still serving the view. That is not Delete view, it is Discard draft — a deliberately different operation that already exists (discardRuntimeDraft, documented as "the published overlay is untouched"). persistRuntimeMetadata stages every runtime edit as a draft, so "publish a view, then edit it" makes pairs routine.

The asymmetry, stated cleanly: for an update, one home is the right home; for a delete, "remove this view" is satisfied only when no home is left serving it.

The four ruling points, as implemented

1. Delete BOTH homes. Both are deleted on every call.

2. Draft first; receipt widened additively. Draft first because a fault between the two calls then leaves the published overlay intact — the view is still served and the delete is cleanly retryable. The reverse order would strand a draft-only view, which is this card's original bug shape. The receipt gains optional draft / published outcomes alongside the existing deleted; deleted is true only when no home is left serving the view and at least one actually held a row (a view that existed in neither home still answers false, unchanged). Error propagation matches updateView's measured convention — surface the fault, never degrade — so a published-half failure after the draft was discarded throws, carrying the partial state on the error's outcome. "Draft gone, overlay left" is exactly what the old { deleted: boolean } could not express, and it is never rounded up to true.

3. No-row answers pinned first, then blind chosen. Measured verbatim from the framework's deleteMetaItem (packages/metadata-protocol/src/protocol.ts, read-only sibling), and pinned as test fixtures:

call row present answer
DELETE ?state=draft no 200 {"success":true,"reset":false,"message":"No pending draft for view/x."}
DELETE (active) no 200 {"success":true,"reset":false,"message":"No view 'x' found — nothing to delete."}
DELETE ?state=draft yes 200 {"success":true,"reset":true,"seq":N,"message":"Draft discarded — view/x. [seq=N]"}
DELETE (active) yes 200 {"success":true,"reset":true,"seq":N,"message":"Deleted view 'x' — it no longer exists. [seq=N]"}

Both no-row answers are a 200 carrying reset:false, never a 404 — benign. So the ruling's condition for blind-two-calls is met and no probe is added. updateView needs its probe for a different reason (its read must resolve the row the merge writes back to), which has no counterpart for a delete.

4. One transport, one error contract — measurement pointed at the metadataClient. MetadataClient.reset(type, name) with no state issues DELETE {baseUrl}/api/v1/meta/view/:name, the byte-identical request client.meta.deleteItem was issuing; this adapter configures no environmentId, so no header or scoping diverges. Both halves therefore route through MetadataClient, and cross-transport normalization is unnecessary. metadata-client.ts needed no change — the published-state delete path already existed. One residual difference is recorded honestly in the report: the SDK honours a discovery-supplied metadata route while MetadataClient hardcodes /api/v1/meta. That divergence is pre-existing and repo-wide (updateView's draft half and listViews already rely on the hardcoded prefix); this change does not widen it.

Red-first evidence

Predicted split written down before running against unfixed code, then confirmed exactly: 11 red, 4 green. The 4 that stayed green are precisely the must-not-change assertions.

table row assertion predicted actual
draft-only receipt.deleted is true RED RED — AssertionError: expected false to be true
draft-only draft home addressed RED RED — expected [ 'published' ] to include 'draft'
draft-only per-home outcomes present RED RED — expected undefined to be true
published-only still deletes, still reports deleted GREEN GREEN (never broken)
published-only both homes addressed RED RED — expected [ 'published' ] to deeply equal [ 'draft', 'published' ]
pair published home still deleted GREEN GREEN (the accidentally-correct row, preserved)
pair invalidates both keys exactly once GREEN GREEN
pair orphan draft also discarded RED RED
neither home deleted is false GREEN GREEN (unchanged)
draft strictly before published RED RED
published-half failure carries partial outcome RED RED — promise resolved "{ deleted: true }" instead of rejecting
Discard draft stays distinct RED RED

Reverse-verified by taking the fix out (git diff to a patch + git checkout origin/main -- …, never git stash) and re-running: Tests 11 failed | 474 passed (485), all 11 in the new file, everything else green. Restored and confirmed byte-identical by sha256sum -c. Note that viewCacheInvalidation.pin.test.ts passes under both the fixed and unfixed code, which is what proves the harness extension there did not change what that pin asserts.

Must-not-change pins held

Verification

  • pnpm exec vitest run --maxWorkers=2 packages/data-objectstack/35 files, 485 tests passed
  • pnpm --filter '@object-ui/data-objectstack' type-check — clean
  • Downstream consumer sweep, prefix direction (--filter '...@object-ui/data-objectstack' = consumers, not dependencies) — 32 packages green, including app-shell, console, plugin-view, plugin-designer
  • .d.ts diff measured on a clean rebuild (dist/ and tsconfig.tsbuildinfo removed between builds) — additive only: two new exported types, and deleteView's return widens from an inline { deleted: boolean } to DeleteViewResult, which still carries deleted: boolean. Type reverse-verified both ways against the rebuilt declaration: reading receipt.draft?.removed compiles, and a typo of it is rejected with TS2551.
  • ESLint — 0 errors (379 warnings, all pre-existing no-explicit-any; --max-warnings is deliberately unset repo-wide per lint.yml)
  • check:control-bytes OK, check:phantom-deps OK, plus a manual control-byte self-scan of every touched file

Consumer census

One real call site: packages/app-shell/src/views/ObjectView.tsx handleDeleteView, which awaits deleteView and does not read the receipt (it catches and toasts on failure). packages/types/src/data.ts declares deleteView? returning the narrow { deleted: boolean }; the adapter's wider return is assignable to it, so the canary did not demand an edit and none was made — noted in the report as an observation, since a consumer reaching the adapter through that interface still sees only deleted.

Surface

packages/data-objectstack/src/index.ts, packages/data-objectstack/src/deleteView.homes.test.ts (new), packages/data-objectstack/src/viewCacheInvalidation.pin.test.ts (harness models DELETE; assertions verbatim), one changeset. No consumer edits, nothing in #4527-phase-2's write set, nothing in plugin-gantt / CelPredicateField / plugin-designer / plugin-grid / plugin-kanban / content/docs/releases/.

Changeset: @object-ui/data-objectstack minor — entry-reachable receipt widening plus a published-behavior move, the same grading objectui#4271's get() unwrap and objectui#4495's find() resolve to reject took.


Generated by Claude Code

)

A view has two homes -- the pending per-item draft
(DELETE /api/v1/meta/view/:name?state=draft) and the published overlay
(DELETE /api/v1/meta/view/:name). deleteView addressed only the second,
unqualified, so deleting a draft-only view fired at the published overlay,
the server answered 200 reset:false "nothing to delete", the draft survived
and the tab was back after reload.

Not the mechanical mirror of #4139: a draft-first-ONLY delete would discard
just the draft on a published+draft pair, silently downgrading Delete view
into Discard draft (an operation that already exists, discardRuntimeDraft).
persistRuntimeMetadata stages every runtime edit as a draft, so pairs are
routine. Both homes are now deleted, draft first, so a mid-operation fault
leaves the published overlay intact and the delete cleanly retryable.

Two blind calls, no probe: measured against the framework's deleteMetaItem,
a missing home answers 200 reset:false, never 404. One transport: both
halves go through MetadataClient.reset, which issues the byte-identical
request for the published half and collapses two error shapes into one.

Receipt widened additively with optional per-home outcomes; deleted is true
only when no home remains and at least one held a row. A published-half
failure after the draft was discarded throws with the partial state on the
error's outcome rather than rounding to true. invalidateViewKeys moves into
a finally so it fires once on every outcome including the throw.

Red-first: 11 new pins red against unfixed code, 4 must-not-change
assertions green throughout; reverse-verified by restoring the unqualified
delete.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Qqyix2QcnpUC9XeYVDzx3
@vercel

vercel Bot commented Aug 13, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectui Ignored Ignored Aug 13, 2026 9:19am

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Main entry (gzip) 24.7 KB 350 KB
Entry file index-CTC6Gid-.js
Status PASS

📦 Bundle Size Report

Package Size Gzipped
app-shell (index.js) 9.56KB 3.59KB
app-shell (runtime-config.js) 7.42KB 2.32KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 8.92KB 3.41KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 1.17KB 0.53KB
auth (AuthProvider.js) 25.13KB 5.40KB
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) 38.46KB 10.17KB
auth (createAuthenticatedFetch.js) 6.34KB 2.43KB
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) 5.02KB 0.88KB
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) 489.32KB 108.45KB
core (index.js) 3.37KB 1.34KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 163.56KB 44.83KB
fields (index.js) 230.18KB 57.13KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (currency.js) 1.22KB 0.64KB
i18n (i18n.js) 4.32KB 1.77KB
i18n (index.js) 3.35KB 1.38KB
i18n (pickLocalized.js) 3.69KB 1.73KB
i18n (provider.js) 23.12KB 7.62KB
i18n (useDisplayLocale.js) 2.84KB 1.45KB
i18n (useObjectLabel.js) 27.59KB 6.63KB
i18n (useSafeTranslation.js) 7.77KB 3.13KB
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.75KB 3.80KB
plugin-calendar (index.js) 46.86KB 12.91KB
plugin-charts (index.js) 62.10KB 17.67KB
plugin-chatbot (index.js) 181.21KB 43.14KB
plugin-dashboard (index.js) 120.95KB 31.53KB
plugin-designer (index.js) 212.58KB 42.83KB
plugin-detail (index.js) 239.88KB 59.99KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 114.58KB 27.68KB
plugin-gantt (index.js) 164.28KB 40.02KB
plugin-grid (index.js) 189.36KB 50.33KB
plugin-kanban (index.js) 52.74KB 14.53KB
plugin-list (index.js) 111.13KB 27.12KB
plugin-map (index.js) 18.16KB 5.81KB
plugin-markdown (index.js) 13.72KB 4.69KB
plugin-report (index.js) 41.16KB 10.96KB
plugin-timeline (index.js) 26.68KB 7.66KB
plugin-tree (index.js) 8.50KB 2.88KB
plugin-view (index.js) 84.08KB 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.73KB 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 (dashboard-filter-alias.js) 6.23KB 2.74KB
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) 3.05KB 1.52KB
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

Copy link
Copy Markdown
Collaborator Author

PM step-7 复核 — ACCEPT (session_017Qqyix2QcnpUC9XeYVDzx3)

Auto-merge armed (squash) — landing verified per the merge-queue discipline.


Generated by Claude Code


Generated by Claude Code

@yinlianghui
yinlianghui marked this pull request as ready for review August 13, 2026 09:39
@yinlianghui
yinlianghui added this pull request to the merge queue Aug 13, 2026
Merged via the queue into main with commit 537a0d1 Aug 13, 2026
21 checks passed
@yinlianghui
yinlianghui deleted the claude/issue-4479-delete-view-both-homes branch August 13, 2026 09:39
github-merge-queue Bot pushed a commit that referenced this pull request Aug 13, 2026
…comes (#4564) (#4569)

PR #4562 (#4479) widened the ObjectStack adapter's deleteView to return
DeleteViewResult { deleted, draft?, published? }, but the shared interface still
declared the narrow Promise of { deleted: boolean }. Nothing failed to compile —
a wider return is assignable to a narrower declaration — so the adapter satisfied
the interface while every consumer reaching it THROUGH DataSource was handed a
type with the per-home outcomes already discarded.

DeleteViewResult and ViewHomeDeleteOutcome move to packages/types/src/data.ts
beside the interface that returns them, and deleteView?'s declared return widens
to Promise of DeleteViewResult (optionality and parameters unchanged).
data-objectstack imports them for its own use and re-exports both names, so every
existing importer keeps compiling and now resolves to the same declaration the
shared contract speaks. Census before the move: zero importers of either name
outside the declaring file, PR #4562's own suite included.

Pinned by deleteViewContract.types.test.ts. The pins are compile-time because the
defect is: vitest erases types, so the consumer read below was green against the
narrow declaration too — measured, 7/7 green with the fix reverted, while
tsc returned 14 diagnostics. A live NarrowLegacyResult control keeps the
discrimination honest. Note that `satisfies` and `extends` assertions are green in
BOTH worlds for the same assignability reason the gap exploited; only the type
IDENTITY assertions discriminate.


Claude-Session: https://claude.ai/code/session_017Qqyix2QcnpUC9XeYVDzx3

Co-authored-by: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants