feat(types,core,app-shell)!: follow the `managedBy: 'system'` → `'system-data'` retirement (objectstack#3355) by os-zhuang · Pull Request #3214 · objectstack-ai/objectui

os-zhuang · 2026-08-02T15:13:04Z

UI 侧配套 PR，对应 framework 的 objectstack-ai/objectstack#3355 / objectstack-ai/objectstack#4660。两边需要一起合：ManagedByBucket 是 framework 枚举的镜像，单独合任何一边都会让联合类型与 spec 失配。

背景

ADR-0103 在 v16 加法式拆分了被重载的 managedBy: 'system'：引擎自有对象迁到显式的 engine-owned，admin/user 可写的 8 个留在 system。于是幸存的那个值恰好在描述已经搬走的那一半。protocol 17 把残留改名 system-data（schema 归平台，data 归 admin/用户），退役裸 system。

这个 PR 真正删掉的是一层"推导"

因为 v16 的 system 同时兼任引擎自有默认值和可写集合，UI 有三处必须在渲染时从 userActions反推语义。桶名现在自己说清楚了，三处都改为直接读值：

位置	v16（推导）	v17（直读）
`isSystemWritable()`	探测 `userActions` 里是否有任一 opted-in 写入	`managedBy === 'system-data'`
`ManagedByBadge`	派生一个合成的 `'system-writable'` variant key	variant map 与桶联合 1:1
`resolveManagedByEmptyState()`	用解析后的 `create` affordance 判断该显示"自动产生条目"还是 New 按钮	`system-data` 按定义落到通用空状态；`engine-owned` 保留自动产生的文案

badge 那一条附带一个结构性收益：variant map 重新与联合类型一一对应，新增桶变成编译错误而不是静默 fallthrough——这正是 objectui#2712 当初关闭联合类型想要的性质，v16 的合成 key 把它撕开了一个口子。

i18n 键刻意不动（system、systemWritable），所以没有任何语言包需要改。engine-owned 继续复用 system 这个键（不是退役的桶值），文案一字未改。

Breaking（UI API）

ManagedByBadge 的 userActions prop 与导出的 ManagedByUserActions 接口移除。

桶名现在独自决定 variant，这个 prop 已经变成没有任何读者的元数据——正是 framework 那边这次改动要消灭的缺陷。把它保留成"接受但忽略"的 prop，等于在上一层原样复制一遍同一个缺陷，所以直接删。仓内 3 个调用点已同步（RecordDetailView、ObjectView、RecordFormPage），下游只需删掉这个 prop，无其他改动。

MANAGED_BY_BUCKETS / ManagedByBucket 不再包含 'system'。

关于跨仓时序

objectui 依赖已发布的 @objectstack/spec ^17.0.0-rc.1，其中还没有 system-data。这不影响运行时正确性：resolveCrudAffordances 委派给 spec，未知桶回落到 platform 默认行 {create,import,edit,delete,exportCsv: true}，与新的 system-data 行逐位相同。等 framework 发版后回落路径消失，结果不变。

验证

pnpm turbo run build --filter=@object-ui/app-shell... --filter=@object-ui/plugin-detail...
Tasks: 29 successful, 29 total
npx vitest run packages/app-shell packages/core packages/types packages/plugin-detail
Test Files 375 passed (375)
Tests 4263 passed | 1 skipped (4264)

🤖 Generated with Claude Code

https://claude.ai/code/session_012C2cd7tL8QDoZ2QKN3djJ5

Generated by Claude Code

…tem-data'` retirement (objectstack#3355) The UI half of the framework's protocol-17 retirement, landing with it so the closed `ManagedByBucket` union stays a mirror rather than a fork. What this deletes is a derivation. v16's `system` doubled as both the engine-owned default and the writable set, so three surfaces had to RECOVER the distinction from `userActions` at render time — `isSystemWritable`, the badge's synthetic `'system-writable'` variant key, and the empty-state resolver's `create`-affordance probe. The bucket now states it, so all three read the value instead of inferring it, and the badge's variant map is 1:1 with the union again (a new bucket becomes a compile error, not a fallthrough). i18n keys are deliberately unchanged (`system`, `systemWritable`), so no locale bundle moves. BREAKING: `ManagedByBadge`'s `userActions` prop and the `ManagedByUserActions` export are removed — the bucket selects the variant now, and keeping an accepted -but-ignored prop would reproduce, one layer up, the dead-metadata defect this change exists to remove. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012C2cd7tL8QDoZ2QKN3djJ5

vercel · 2026-08-02T15:13:10Z

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectui	Ignored		Aug 2, 2026 3:13pm

github-actions · 2026-08-02T15:16:47Z

✅ Console Performance Budget

Metric	Value	Budget
Main entry (gzip)	28.1 KB	350 KB
Entry file	`index-Cpmi7KSF.js`	—
Status	PASS	—

📦 Bundle Size Report

Package	Size	Gzipped
app-shell (index.js)	8.47KB	3.09KB
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.12KB	3.41KB
auth (LoginForm.js)	17.86KB	5.29KB
auth (PreviewBanner.js)	0.90KB	0.50KB
auth (RegisterForm.js)	6.43KB	2.09KB
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)	18.38KB	4.49KB
collaboration (LiveCursors.js)	3.17KB	1.27KB
collaboration (PresenceAvatars.js)	3.65KB	1.42KB
collaboration (PresenceProvider.js)	2.79KB	1.13KB
collaboration (index.js)	1.25KB	0.53KB
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)	476.12KB	104.47KB
core (index.js)	2.25KB	0.80KB
create-plugin (index.js)	9.28KB	2.98KB
data-objectstack (index.js)	136.20KB	34.74KB
fields (index.js)	223.45KB	54.66KB
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.46KB	0.96KB
i18n (pickLocalized.js)	1.70KB	0.83KB
i18n (provider.js)	5.37KB	1.72KB
i18n (useObjectLabel.js)	26.14KB	6.07KB
i18n (useSafeTranslation.js)	3.26KB	1.44KB
layout (index.js)	38.47KB	10.67KB
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.05KB	1.53KB
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)	44.90KB	12.35KB
plugin-charts (index.js)	60.53KB	17.12KB
plugin-chatbot (index.js)	180.09KB	42.72KB
plugin-dashboard (index.js)	111.87KB	28.82KB
plugin-designer (index.js)	210.51KB	42.50KB
plugin-detail (index.js)	230.17KB	56.73KB
plugin-editor (index.js)	2.46KB	1.10KB
plugin-form (index.js)	111.39KB	26.93KB
plugin-gantt (index.js)	162.26KB	39.53KB
plugin-grid (index.js)	185.10KB	49.04KB
plugin-kanban (index.js)	47.82KB	13.18KB
plugin-list (index.js)	104.88KB	25.32KB
plugin-map (index.js)	16.80KB	5.24KB
plugin-markdown (index.js)	13.65KB	4.67KB
plugin-report (index.js)	40.48KB	10.57KB
plugin-timeline (index.js)	25.76KB	7.32KB
plugin-tree (index.js)	8.34KB	2.82KB
plugin-view (index.js)	83.54KB	20.39KB
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)	19.28KB	6.38KB
react (data-invalidation.js)	5.05KB	2.08KB
react (index.js)	1.02KB	0.55KB
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.46KB	1.21KB
types (layout.js)	0.20KB	0.18KB
types (managed-by.js)	0.19KB	0.18KB
types (mobile.js)	0.20KB	0.18KB
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

…eryDataset (objectstack-ai#3813) (objectstack-ai#3824) The runtime half of the hand-picked-envelope family objectstack-ai#3613/objectstack-ai#3752 fixed on the type face. queryDataset rebuilds its result by picking keys off the REST payload one by one, and drillRanges was never in the list — so the analytics service's objectstack-ai#1752 date-range drill sidecar was dropped by the only real adapter in this repo, while five consumer sites were already reading it (DatasetWidget.tsx:471/:593, DatasetReportRenderer.tsx:316/:431/:855). The effect was a MISSING drill, not a degraded one. A dateGranularity dimension groups a span of records into one bucket, which equality filters cannot express, so service-analytics excludes date dims from dimensionFields/drillRawRows and sends a half-open [gte, lt) range per row instead (analytics-service.ts:807+). For a chart or report grouped only by time, drillRanges is therefore the only thing that can make canDrill = !!object && (drillDims.length > 0 || !!drillRanges?.length) true — dropped, the whole drill entry point disappeared. A mixed date + non-date grouping kept its drill but lost the time bound, so clicking June's bar opened every month (a superset). Neither side's tests could see it: the dashboard/report suites mock their own data source and feed drillRanges in directly, and the adapter's suite never asserted the key. The new tests mock the envelope the SERVER actually sends — bare (res.json, no success/data wrapper), carrying sql, and for a date-only grouping carrying object + drillRanges and NO dimensionFields/drillRawRows — then assert the key arrives verbatim and row-aligned, that the consumers' own canDrill predicate is true, and that the shared buildDatasetDrillFilter scopes the list to the clicked bucket (both halves for a mixed grouping). The entry type is @object-ui/core's DatasetDrillRange BY REFERENCE, not a local { field, gte, lt } copy: it is the single in-repo declaration of the shape (what buildDatasetDrillFilter accepts and what both renderers type their state with) and @objectstack/spec does not own it yet, so a restatement would be a third dialect. drillRawTotals (objectstack-ai#3214) is deliberately NOT added: zero consumers in this repo, so passing it through would add a declared-but-unexercised key with no user-facing effect. Filed separately as a finding. Claude-Session: https://claude.ai/code/session_01GTRjn8xBqp75dk7kFupVRt Co-authored-by: Claude <noreply@anthropic.com>

github-actionsBot added package: core package: types plugin tests labels Aug 2, 2026

os-zhuang mentioned this pull request Aug 2, 2026
feat(spec)!: retire the overloaded managedBy: 'system' bucket → system-data (#3355) objectstack-ai/objectstack#4660
Merged

os-zhuang marked this pull request as ready for review August 2, 2026 16:10

os-zhuang added this pull request to the merge queue Aug 2, 2026

Merged via the queue into main with commit 444457cAug 2, 2026
16 checks passed

os-zhuang deleted the claude/issue-3355-retire-managedby-system branch August 2, 2026 16:10

os-zhuang mentioned this pull request Aug 2, 2026
refactor(data-objectstack,plugin-chatbot,plugin-list)!: 台账燃尽批次 6 —— 12 个符号不再顶着 spec 的名字 (#3160) #3220
Merged

yinlianghui mentioned this pull request Aug 8, 2026
ObjectStackAdapter.queryDataset 丢掉服务端的 drillRanges,日期分桶钻取(#1752)经真实 adapter 永不可用 #3813
Closed

Navigation Menu

Uh oh!

feat(types,core,app-shell)!: follow the `managedBy: 'system'` → `'system-data'` retirement (objectstack#3355) - #3214

feat(types,core,app-shell)!: follow the `managedBy: 'system'` → `'system-data'` retirement (objectstack#3355)#3214
os-zhuang merged 1 commit into
mainfrom
claude/issue-3355-retire-managedby-system

os-zhuang commented Aug 2, 2026

Uh oh!

vercelBot commented Aug 2, 2026

Uh oh!

github-actionsBot commented Aug 2, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

os-zhuang commented Aug 2, 2026

背景

这个 PR 真正删掉的是一层"推导"

Breaking（UI API）

关于跨仓时序

验证

Uh oh!

vercelBot commented Aug 2, 2026

Uh oh!

github-actionsBot commented Aug 2, 2026

✅ Console Performance Budget

📦 Bundle Size Report

Size Limits

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants