Skip to content

fix(spec): warn loudly on view-key collisions in expandViewContainer - #2556

Merged
os-zhuang merged 1 commit into
mainfrom
fix/view-expand-collision-warning
Jul 4, 2026
Merged

fix(spec): warn loudly on view-key collisions in expandViewContainer#2556
os-zhuang merged 1 commit into
mainfrom
fix/view-expand-collision-warning

Conversation

@baozhoutao

Copy link
Copy Markdown
Contributor

Closes#2554

问题

expandViewContainer 中 list/form 视图共享同一个 <object>.<key> 命名空间。key 冲突时(典型:formViews.default 撞上主 list 隐式占用的 default),uniqueViewName 把后注册者静默改名<key>_2 — 零告警。所有引用原名的地方(form action 的 target、导航 viewName)会解析到另一个视图

showcase 实锤链路(P0-8/19/20):showcase_log_time action target: 'showcase_task.default' 意图打开 form,但 showcase_task.default 实际是 list 视图(form 被改名成 default_2)→ FormPage 渲染 list 视图配置 → 零字段黑屏 + 提交误报成功。

修复

保持改名行为不变(向后兼容),但让冲突可见:

  • spec (view.zod.ts):ExpandedViewItem 增加可选 _diagnostics 字段(复用 MetadataValidationResult{valid, warnings:[{path,message}]} 形状);四个注册点在发生改名时打上 warning,消息点名两个视图名和影响面。
  • objectql (engine.ts) / metadata (plugin.ts):两个展平 loader 在启动时把 _diagnostics.warnings 写进日志。
  • examples/app-showcase:formViews.defaultedit,showcase_log_time.targetshowcase_task.edit,注释说明冲突原因。

测试

  • packages/metadata/src/view-expand.test.ts 新增 3 个用例:form/list 冲突带 warning、formViews 撞 listViews key、无冲突不打 _diagnostics
  • @objectstack/spec 6669 tests pass;@objectstack/objectql 737 pass;@objectstack/metadata 257 pass。

Co-Authored-By: Claude noreply@anthropic.com

@vercel

vercelBot commented Jul 4, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentJul 4, 2026 3:12am

Request Review

@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation tests protocol:ui tooling size/m labels Jul 4, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📓 Docs Drift Check

This PR changes 3 package(s): @objectstack/metadata, @objectstack/objectql, @objectstack/spec.

98 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

  • content/docs/concepts/architecture.mdx(via @objectstack/spec)
  • content/docs/concepts/cloud-artifact-api.mdx(via packages/spec)
  • content/docs/concepts/cluster-semantics.mdx(via packages/metadata, @objectstack/spec)
  • content/docs/concepts/core/services.mdx(via @objectstack/objectql)
  • content/docs/concepts/design-principles.mdx(via packages/spec)
  • content/docs/concepts/implementation-status.mdx(via @objectstack/objectql, @objectstack/spec)
  • content/docs/concepts/index.mdx(via @objectstack/spec)
  • content/docs/concepts/metadata-driven.mdx(via @objectstack/spec)
  • content/docs/concepts/metadata-lifecycle.mdx(via @objectstack/metadata, @objectstack/objectql, packages/spec)
  • content/docs/concepts/north-star.mdx(via packages/spec)
  • content/docs/concepts/packages.mdx(via @objectstack/metadata, @objectstack/objectql, @objectstack/spec)
  • content/docs/concepts/setup-app.mdx(via @objectstack/spec)
  • content/docs/concepts/skills.mdx(via @objectstack/spec)
  • content/docs/concepts/webhook-delivery.mdx(via @objectstack/spec)
  • content/docs/getting-started/architecture.mdx(via @objectstack/spec)
  • content/docs/getting-started/cli.mdx(via @objectstack/spec)
  • content/docs/getting-started/core-concepts.mdx(via @objectstack/spec)
  • content/docs/getting-started/examples.mdx(via @objectstack/spec)
  • content/docs/getting-started/quick-start.mdx(via @objectstack/spec)
  • content/docs/guides/adding-a-metadata-type.mdx(via @objectstack/spec)
  • content/docs/guides/ai-capabilities.mdx(via @objectstack/spec)
  • content/docs/guides/airtable-dashboard-analysis.mdx(via @objectstack/spec)
  • content/docs/guides/analytics-datasets.mdx(via @objectstack/spec)
  • content/docs/guides/api-reference.mdx(via @objectstack/spec)
  • content/docs/guides/authentication.mdx(via @objectstack/objectql)
  • content/docs/guides/business-logic.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/backward-compatibility.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/error-catalog.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/field-type-gallery.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/field-validation-rules.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/permissions-matrix.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/protocol-diagram.mdx(via packages/spec)
  • content/docs/guides/cheatsheets/query-cheat-sheet.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/quick-reference.mdx(via @objectstack/spec)
  • content/docs/guides/client-sdk.mdx(via @objectstack/spec)
  • content/docs/guides/common-patterns.mdx(via @objectstack/spec)
  • content/docs/guides/contracts/auth-service.mdx(via packages/spec)
  • content/docs/guides/contracts/cache-service.mdx(via packages/spec)
  • content/docs/guides/contracts/data-engine.mdx(via @objectstack/spec)
  • content/docs/guides/contracts/index.mdx(via @objectstack/spec)
  • content/docs/guides/contracts/metadata-service.mdx(via packages/spec)
  • content/docs/guides/contracts/storage-service.mdx(via packages/spec)
  • content/docs/guides/data-modeling.mdx(via @objectstack/spec)
  • content/docs/guides/deployment-vercel.mdx(via @objectstack/objectql)
  • content/docs/guides/driver-configuration.mdx(via @objectstack/spec)
  • content/docs/guides/error-handling-client.mdx(via @objectstack/spec)
  • content/docs/guides/error-handling-server.mdx(via @objectstack/spec)
  • content/docs/guides/external-datasources.mdx(via @objectstack/spec)
  • content/docs/guides/formula.mdx(via packages/objectql, @objectstack/spec)
  • content/docs/guides/hook-bodies.mdx(via packages/spec)
  • content/docs/guides/kernel-services.mdx(via @objectstack/objectql, @objectstack/spec)
  • content/docs/guides/metadata/dashboard.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/field.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/flow.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/index.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/object.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/validation.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/workflow.mdx(via @objectstack/spec)
  • content/docs/guides/objectql-migration.mdx(via @objectstack/objectql)
  • content/docs/guides/packages.mdx(via @objectstack/metadata, @objectstack/objectql, @objectstack/spec)
  • content/docs/guides/plugin-development.mdx(via @objectstack/spec)
  • content/docs/guides/plugins.mdx(via @objectstack/objectql, @objectstack/spec)
  • content/docs/guides/project-scoping.mdx(via @objectstack/spec)
  • content/docs/guides/public-forms.mdx(via @objectstack/spec)
  • content/docs/guides/runtime-services/email-service.mdx(via packages/spec)
  • content/docs/guides/runtime-services/index.mdx(via packages/spec)
  • content/docs/guides/runtime-services/queue-service.mdx(via packages/spec)
  • content/docs/guides/runtime-services/sharing-service.mdx(via packages/spec)
  • content/docs/guides/runtime-services/storage-service.mdx(via packages/spec)
  • content/docs/guides/security.mdx(via @objectstack/spec)
  • content/docs/guides/seed-data.mdx(via @objectstack/spec)
  • content/docs/guides/skills.mdx(via @objectstack/spec)
  • content/docs/guides/solutions/approval-workflow.mdx(via packages/spec)
  • content/docs/guides/solutions/create-vs-edit-form.mdx(via @objectstack/spec)
  • content/docs/guides/standards.mdx(via @objectstack/spec)
  • content/docs/guides/troubleshooting.mdx(via @objectstack/spec)
  • content/docs/guides/validating-metadata.mdx(via @objectstack/spec)
  • content/docs/protocol/knowledge.mdx(via @objectstack/spec)
  • content/docs/protocol/objectos/config-resolution.mdx(via @objectstack/spec)
  • content/docs/protocol/objectos/i18n-standard.mdx(via @objectstack/spec)
  • content/docs/protocol/objectos/index.mdx(via @objectstack/objectql)
  • content/docs/protocol/objectos/lifecycle.mdx(via @objectstack/spec)
  • content/docs/protocol/objectos/metadata-service.mdx(via @objectstack/metadata)
  • content/docs/protocol/objectos/plugin-spec.mdx(via @objectstack/spec)
  • content/docs/protocol/objectos/runtime-capabilities.mdx(via @objectstack/spec)
  • content/docs/protocol/objectql/index.mdx(via packages/spec)
  • content/docs/protocol/objectql/query-syntax.mdx(via @objectstack/spec)
  • content/docs/protocol/objectql/schema.mdx(via @objectstack/spec)
  • content/docs/protocol/objectql/security.mdx(via packages/spec)
  • content/docs/protocol/objectql/state-machine.mdx(via @objectstack/objectql, @objectstack/spec)
  • content/docs/protocol/objectui/actions.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/concept.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/index.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/layout-dsl.mdx(via packages/spec)
  • content/docs/protocol/objectui/record-alert.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/widget-contract.mdx(via @objectstack/spec)
  • content/docs/releases/index.mdx(via @objectstack/spec)
  • content/docs/releases/v9.mdx(via @objectstack/objectql, @objectstack/spec)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.

@os-zhuang
os-zhuang merged commit 9860de4 into mainJul 4, 2026
17 checks passed
@os-zhuang
os-zhuang deleted the fix/view-expand-collision-warning branch July 4, 2026 12:07
os-zhuang added a commit that referenced this pull request Jul 4, 2026
…nostics)
#2556 (view-key collision boot warnings) landed on main while this branch was
open. Reconciled by keeping BOTH: the merged `expandViewContainerWithDiagnostics`
now pushes `collisions[]` (consumed by the new build-time `lint-view-refs`) AND
stamps per-item `_diagnostics` (consumed by the boot loaders) at the same
detection points. view-expand keeps both test suites (17 pass); showcase view/
action conflicts merged; .objectui-sha takes main's pin; api-surface unchanged;
full turbo build 71/71.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
list/form views share one <object>.<key> namespace during container
expansion; a colliding key (e.g. formViews.default vs the implicit
default list) was silently renamed to <key>_2, so action targets and
navigation viewNames referencing the requested name resolved to the
OTHER view — the root cause of the showcase "Log Time" form action
opening the list view and rendering a black/empty form.
- spec: ExpandedViewItem gains optional _diagnostics; uniqueViewName
renames now stamp a warning naming both views and the blast radius.
- objectql engine + metadata plugin: log expansion warnings at boot.
- app-showcase: rename formViews.default -> edit and point
showcase_log_time's target at showcase_task.edit (with comments
documenting the collision).
- tests: 3 new cases covering collision warnings and the clean path.
Closes#2554
Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationprotocol:uisize/mteststooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

expandViewContainer silently renames colliding form view keys (formViews.default → default_2) — form action targets break

2 participants

@baozhoutao@os-zhuang