Skip to content

feat(app-shell): Studio retires the two delegated-admin switches the spec retired (objectui#12406) - #12659

Merged
objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-12406-retire-admin-switches
Oct 16, 2026
Merged

objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-12406-retire-admin-switches

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #12406
Clause-②: no

  • Adds no product-specific widget, dialog, hook or string (see AGENTS.md › Product-neutral renderer)

What changes

Studio's permission-set editor stops offering the two delegated-admin switches that @objectstack/spec 18 retired. This is item 4 of the maintainer's letter A on objectstack-ai/objectstack#23488 (comment 6181988435): "objectui: Studio's two switches, the help strings, the i18n keys and the pin test retire".

  • PermissionAdvancedFacets.tsx. The "Manage bindings" and "Author env sets" switch rows are gone. "Manage assignments" stays as the control and now writes its key by name, setScopeDetail({ manageAssignments: !!v }), instead of through the tuple list's cast to the partial AdminScope type. The header docblock names the four live keys. The AdminScope docblock now says why the editor strips neither retired key from a loaded scope (the H3 decision below). Two docblock counts ("the six keys", "the other five carry defaults") are corrected, because two of those keys are now tombstones.
  • i18n.ts. The four strings go: perm.admin.manageBindings and perm.admin.authorEnvironmentSets, in English and Chinese. perm.admin.help no longer offers to "manage bindings", in either language. I read the ruling's "help strings" as this text, the only Studio help string that names a retired right.
  • PermissionAdvancedFacets.adminScopeAnchor.test.tsx. The inert-switch case now covers the one remaining manage switch. A new describe block pins the retirement (see Tests).
  • .changeset/12406-retire-admin-switches.md. @object-ui/app-shell patch, with the Clause-② reading in words.

Clause-②: no. PermissionAdvancedFacets and the metadata-admin dictionary are not on @object-ui/app-shell's published entry (exports has . and ./styles.css; src/index.ts exports neither). The change removes two controls that wrote keys the spec already refuses. No published type, prop or export changes.

Measurements

  • Installable surface, measured with the spec installed here (18.0.0-next.2). AdminScopeSchema refuses each retired key with invalid_type at its own path, for both true and false. CONTROL: a scope with the four live keys parses.
  • H1 holds. The three switches were drawn from a tuple list. The two retired rows are gone, and manageAssignments stays.
  • H2 holds. Outside CHANGELOG.md, the workspace has these four strings only in i18n.ts and the anchor pin's caption list. The control manageAssignments is found in the same files. No other locale pack or reader exists.
  • H4: next.2 tombstones the keys and keeps them. Both keys stay on the AdminScope type, typed as the retired mark: an object whose one key is '[REMOVED] Key retired: run os validate for its migration.' with type never. The old tuple-list write compiled only because of its cast. The new by-name write lets that type do the refusing. Reverse check: setScopeDetail({ manageBindings: !!v }) was written at the switch, and tsc --noEmit turned red with TS2322: Type 'boolean' is not assignable to type that retired mark. The file was then restored by ablation-replace.mjs, and its blob equals HEAD.
  • H3: the facet round-trips the stored scope verbatim. Measured with a throwaway mount of the facet (not committed). The draft was {"businessUnit":"east","manageAssignments":true,"manageBindings":true,"authorEnvironmentSets":false}. After one "Include subtree" flip it reads {…, "manageBindings":true, "authorEnvironmentSets":false, "includeSubtree":true}. setScope spreads the stored object, and the host's whole-record Save sends draft.adminScope whether or not the facet was touched.
  • H3, the server side. Read on objectstack 0af559e: the metadata protocol's layered read (the overlay row) and its draft read both pass the stored row through convertStoredItem, then applyConversionsToStoredItem (retired entries included), whose conversion permission-admin-scope-binding-authoring-removed drops both keys. The spec half was measured here with the installed spec: applyConversionsToStoredItem('permission', …) turns that same stored scope into {"businessUnit":"east","manageAssignments":true} and emits two notices from that conversion. The raw stored set fails PermissionSetSchema; the rehydrated one passes. The save door validates strictly and replays no conversion, so a body that still carried either key would be answered 422 INVALID_METADATA at the key.

H3 decision: Studio does not strip the two keys

Two options. A: mirror this file's RLS priority precedent and strip both keys in the facet's write path. B: strip nothing, and leave the server's stored-row conversion as the one place they are dropped. Chosen: B. Reasons, axis by axis:

  • Real business need (measured). After this PR nothing in Studio authors either key. The only way one could reach Save is a loaded draft that carries it. The server's overlay and draft reads already drop both keys before the body reaches Studio, and a built artifact is either converted forward at the artifact door or refused at boot. On an 18 server, a strip in the facet has no input to act on.
  • Long-term soundness. A would be a second, client-side copy of the spec's retirement list, which every future retirement would also have to edit by hand. B keeps the one seam the spec registered (ADR-0087 D2, registered). A strip in the facet would also only cover facet edits: the host's whole-record Save sends the scope untouched, so A could not deliver "saves without them" from inside this file.
  • Preventing AI errors. B keeps the refusal loud. Any body that still carries either key, from any producer, is answered with a 422 that names the key and points at os validate. A would silently drop it on the client, which is the consumer-side tolerance the frame ranks below a strict contract.
  • No scope spread at the startup stage. B adds no code and no gate, and the retirement is immediate. A adds a strip and a pin for a path with no pull.

A's case rests on this file's RLS priority strip. That strip was written when Studio's own Add button seeded the retired key into new policies, so this editor was the producer. Here the producer was the switches, and they are gone.

Tests

The new describe is PermissionAdvancedFacets · the retired delegated-admin keys (objectui#12406), mounted as the Access pillar mounts the facet (only="admin"). Switches are found by role, not by caption:

  • CONTROL. The installed spec refuses each retired key at its own path, false included.
  • Draws the manage-assignments switch and neither retired switch. The captions of the switches in the section are exactly Include subtree and Manage assignments.
  • Flipping every switch it draws writes a scope the spec accepts, carrying neither retired key. It checks the key set, a safeParse success, and the exact written object.

Ablation (wrap mode, ablation-replace.mjs from objectstack). The two retired rows were put back exactly as they were on main (tuple list, cast included). The run read Tests 2 failed | 10 passed (12): the two new pins went red (expected [ 'perm.admin.includeSubtree', …(3) ] and expected [ 'manageBindings', …(1) ] to deeply equal []). Restore was proven: blob after restore equals blob at HEAD, and git diff HEAD is empty. The test imports the component from source, so no build sits between the mutation and the run.

All of the following ran on head 165e820, the final commit. Every exit code was captured before any pipe.

  • pnpm exec vitest run packages/app-shell/src/views/metadata-admin/: exit 0, Test Files 509 passed (509), Tests 5742 passed | 1 skipped (5743). It held the shared verify lock for 940s on a shared 4-core box.
  • pnpm exec turbo run build --filter='@object-ui/app-shell^...' --concurrency=2: exit 0, Tasks: 28 successful, 28 total.
  • pnpm --filter @object-ui/app-shell type-check: exit 0. The output echoes tsc --noEmit && tsc -p tsconfig.test.json. The test project includes src/**/*.test.tsx, so the new cases are type-checked.
  • pnpm check:changeset-claims 0 · pnpm changeset:check 0 · pnpm check:test-path-roots 0 · pnpm check:spec-symbols 0 · node scripts/check-changeset-presence.mjs 0 · pnpm check:new-line-citations 0 · node scripts/check-governed-queue-guard.mjs --test over the 4 paths: 0, NOT GOVERNED.
  • eslint on the three changed source files: exit 0, with 0 errors and 3 warnings. All 3 warnings are on lines this diff does not touch (the setDraft prop's any, and a setErrorMap call inside an effect).
  • Not run locally: the whole packages/app-shell/ suite and the repo-wide lint. Both are left to CI, as the dispatch said.

Acceptance notes

  • docs/adr/0056-permission-editing-studio.md still names manageBindings and authorEnvironmentSets in the AdminScopeSchema bullet ("the exact target shape for the admin_scope editor"). It is governed text, so it is not edited here (Tier S/H). Carrier: none in objectui. The ruling's item 5 Tier H docs PR covers ADR-0090 and ADR-0086 in objectstack, not this ADR.
  • packages/app-shell/src/__tests__/spec-symbol-parity.test.ts has a comment, "…and the other five are defaulted". Two of those five are now tombstones. It is a comment, not an assertion, and the assertions still hold. It is outside this card's file surface and is noted only.
  • The host's whole-record Save (PermissionMatrixEditor) sends draft.adminScope as loaded. That is safe only because the server's reads drop the two keys (H3). It is recorded here as the boundary of the H3 decision, not as a defect.

The session is https://claude.ai/code/session_011K9g23W67dy2zwnyzaoB6o.


Generated by Claude Code

…spec retired

The permission-set editor's Delegated Admin Scope facet no longer draws the
"Manage bindings" and "Author env sets" switches. `@objectstack/spec` 18
retired `adminScope.manageBindings` and `adminScope.authorEnvironmentSets`
as tombstones that refuse any value, so flipping either made the set
unsaveable. Their four i18n strings go, the help text stops offering to
manage bindings, and the remaining manage-assignments switch writes its key
by name, without the cast that let a tombstoned key compile.

The anchor pin now covers the one remaining manage switch, and three new
cases pin that the facet draws neither retired switch and that flipping
every switch it draws writes a scope the spec accepts.

Claude-Session: https://claude.ai/code/session_011K9g23W67dy2zwnyzaoB6o
Co-authored-by: Claude <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 70 chunks) 3118.0 KB 3119.4 KB
Main entry chunk (gzip) 65.9 KB 350 KB
Entry file index-D-fC287V.js —
Status PASS —

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 21.19KB 7.76KB
app-shell (runtime-config.js) 22.59KB 7.89KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.11KB 3.87KB
auth (ActiveOrganizationStorage.js) 27.95KB 10.04KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.22KB 10.61KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 20.39KB 6.02KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.72KB 2.24KB
auth (SocialSignInButtons.js) 9.70KB 3.93KB
auth (UserMenu.js) 3.39KB 1.21KB
auth (auth-gate-events.js) 1.62KB 0.83KB
auth (authStyles.js) 5.27KB 1.86KB
auth (createAuthClient.js) 41.19KB 11.12KB
auth (createAuthenticatedFetch.js) 8.54KB 3.46KB
auth (index.js) 3.63KB 1.64KB
auth (invitation-status.js) 1.22KB 0.70KB
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.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 11.08KB 4.58KB
collaboration (CommentThread.js) 27.26KB 8.03KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.28KB 2.60KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (commentAuthorship.js) 1.39KB 0.78KB
collaboration (index.js) 1.93KB 0.85KB
collaboration (useCollaborationTranslation.js) 6.50KB 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) 597.83KB 144.29KB
core (index.js) 10.18KB 4.04KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 248.20KB 69.22KB
fields (index.js) 290.12KB 74.14KB
i18n (LocalizationContext.js) 2.92KB 1.42KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 2.59KB 1.22KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 8.87KB 3.64KB
i18n (index.js) 5.52KB 2.39KB
i18n (pickLocalized.js) 9.86KB 3.95KB
i18n (provider.js) 39.35KB 12.88KB
i18n (translateFn.js) 0.20KB 0.18KB
i18n (useDisplayLocale.js) 3.52KB 1.76KB
i18n (useObjectLabel.js) 36.87KB 9.88KB
i18n (useSafeTranslation.js) 7.14KB 2.92KB
layout (index.js) 40.67KB 11.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.75KB
mobile (index.js) 1.99KB 0.87KB
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) 6.62KB 2.45KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 5.52KB 2.10KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 15.35KB 5.51KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.82KB 2.38KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 8.33KB 3.07KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 16.04KB 3.92KB
plugin-calendar (index.js) 54.94KB 16.05KB
plugin-charts (index.js) 84.97KB 23.36KB
plugin-chatbot (index.js) 201.89KB 48.13KB
plugin-dashboard (index.js) 146.15KB 39.55KB
plugin-designer (index.js) 233.95KB 50.08KB
plugin-detail (index.js) 262.91KB 69.49KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 180.92KB 46.73KB
plugin-gantt (index.js) 178.36KB 45.08KB
plugin-grid (index.js) 270.08KB 74.80KB
plugin-kanban (index.js) 59.42KB 18.48KB
plugin-list (index.js) 131.40KB 33.50KB
plugin-map (index.js) 27.07KB 8.96KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 46.66KB 13.13KB
plugin-timeline (index.js) 39.21KB 11.85KB
plugin-tree (index.js) 15.07KB 5.33KB
plugin-view (index.js) 93.43KB 23.94KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 12.07KB 3.68KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 120.63KB 39.56KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.50KB 2.06KB
react (schema-input.js) 4.31KB 2.07KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (body-dialect.js) 4.50KB 1.99KB
sdui-parser (codegen.js) 9.45KB 3.76KB
sdui-parser (dashboard-widget-options.js) 3.07KB 1.30KB
sdui-parser (index.js) 7.30KB 3.12KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 25.28KB 7.81KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.29KB 0.24KB
sdui-parser (validate.js) 23.87KB 7.83KB
types (ai.js) 4.39KB 2.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 4.12KB 1.61KB
types (authoring-nodes.js) 0.20KB 0.19KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (cloud.js) 0.20KB 0.18KB
types (complex.js) 4.44KB 2.07KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (dashboard-widget-layout.js) 2.06KB 0.96KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (expression.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 1.13KB 0.65KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 5.78KB 2.70KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 5.00KB 2.39KB
types (navigation.js) 0.20KB 0.18KB
types (node-slots.js) 7.18KB 2.34KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 2.52KB 1.31KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-approval-decision.js) 0.20KB 0.20KB
types (record-components.js) 0.20KB 0.19KB
types (record-panels.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 (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 4.99KB 1.96KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (strict-authoring-face.js) 19.93KB 7.26KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.48KB 3.50KB
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

@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

席位核对 · ACCEPT · domain:ui seat 1 · session_011K9g23W67dy2zwnyzaoB6o · 2026-10-16T12:41Z

What was reviewed:

  1. Shape.
    • Fixes #12406 is the first line and the only closing keyword. Clause-②: no starts a line, and the assignee is os-tesla.
    • 4 files, all inside the claim: PermissionAdvancedFacets.tsx, its anchor test, metadata-admin/i18n.ts and one changeset. The surface is NOT governed, at 153 changed lines.
    • The changeset was checked sentence by sentence against the diff.
  2. Premises measured.
    • The Delegated Admin Scope facet draws includeSubtree and manageAssignments only. The two retired switches, their four captions, and the help text's "manage bindings" are gone.
    • manageAssignments now writes its key by name with no cast. The dev's reverse check shows that a manageBindings write no longer compiles against next.2's tombstone type (TS2322).
    • Neither the facet nor the dictionary is exported from the package entry, so no published surface moves.
  3. Gates (check-runs pinned to this head).
    • 32 success and 3 skipped by design, including Lint, Repo Gates, Type Check, Test (shard 1–16/16), Build & E2E and Bundle Analysis (eager closure 3118.0 KB of 3119.4 KB).
    • Live E2E (informational) dies before any spec runs, on the cold-cache npm crash that main's own bump PR deps(v18): resolve @objectstack/* 18.0.0-next.2 and follow its contract (objectui#12626) #12648 hit. objectui#12649 tracks it; it is not this PR's.
    • The ablation (both retired rows restored as on main) turns both new pins red; restore proven by blob == HEAD.
  4. The judgment call (H3), accepted: B.
    • Studio strips neither key on save. The dev measured that the objectstack server's stored-row conversion drops both keys before Studio reads a row (permission-admin-scope-binding-authoring-removed), so a second client-side copy of the spec's retirement list would only add code. A key that reached Studio anyway is refused loudly by the spec at save, rather than tolerated silently.
  5. Out of scope.
    • ADR-0056's AdminScopeSchema bullet still lists both keys. It is governed text, filed by the seat as objectui#12660.
    • A comment in packages/app-shell/src/__tests__/spec-symbol-parity.test.ts ("the other five are defaulted") is now loose, because two of the five are tombstones. It is a comment only; the assertions still hold.
  6. Landing.
    • Ready, then auto-merge into the merge queue.
    • After the merge: verify by content, close the card through Fixes, and strip pm:dispatched.

Generated by Claude Code

@objectstack-fleet
objectstack-fleet Bot marked this pull request as ready for review October 16, 2026 12:43
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 16, 2026 12:43
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 16, 2026
Merged via the queue into main with commit a98a23c Oct 16, 2026
36 of 37 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-12406-retire-admin-switches branch October 16, 2026 12:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Studio: retire the permission set's two delegated-admin switches (manageBindings, authorEnvironmentSets) that objectstack#23488 retires from the spec

2 participants