Skip to content

fix(console): Flow Runs reads the served flat flow item only, and its fixtures feed that shape - #12876

Merged
objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/issue-12829-flow-runs-flat-items
Oct 17, 2026
Merged

objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/issue-12829-flow-runs-flat-items

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #12829
Clause-②: no

What changed

The Flow Runs page's loadFlows normalization now reads the served flat meta.getItems('flow') item only: name: it?.name, label: it?.label, spec: it (the item IS the flow definition the test runner reads variables from). The it?.spec?.X ?? it?.X arm is gone, and so is the updatedAt ?? updated_at read into a FlowItem member the page never renders (the member is dropped from the type too). How the page names a flow for users is unchanged: label (name), or the bare name (PR #12828's behaviour).

Every fixture that fed the spec-wrapped shape now feeds the served one, in this same change:

  • FlowRunsPage.test.tsx
  • FlowRunsPage.sharedSelect-11865.test.tsx
  • developerMetadataEnvelope.contractEnvelope-6917.test.tsx (its FLOW constant only)
  • consoleFaces.displayLocale-9909.test.tsx (a fifth site the card did not list; see Acceptance notes)
  • PR fix(console): the Flow Runs picker reads a flattened flow item's label (objectui#12783) #12828's pin FlowRunsPage.flattenedLabel-12783.test.tsx: its wrapped case becomes the arm-gone pin, "a spec-wrapped item is not read: it lists no flow (objectui#12829)".

A .changeset with an empty frontmatter declares that nothing is released: no served shape reaches different behaviour.

Producer census (run before any edit)

No server the console talks to serves a spec-wrapped flow item. The readings, by symbol, on objectstack origin/main at eda6f14b7b:

  • objectstack runtime, GET /api/v1/meta/flow. RestServer's list route calls protocol.getMetaItems, then metaReadGate.createMetaListAnswer (no reshaping of items). getMetaItems in packages/metadata-protocol/src/protocol.ts is readFlattenedMetaItems(..., 'served'). Its items come from registry.listItems (the registered definitions themselves), the sys_metadata overlay rows (convertStoredItem of the row's metadata body) and metadataService.list, merged by mergePackageAwareOverlay. The answer is { type, items: decorateMetadataItems(type, governed), registrations }. decorateMetadataItem only redacts and adds _diagnostics. Nowhere is an item wrapped in spec.
  • The runtime dispatcher's /meta list branch (packages/runtime/src/domains/meta.ts) calls the same protocol.getMetaItems and answerMetaList.
  • ?preview=draft (ADR-0033). Same body with previewDrafts: draft rows are parsed from their metadata body and merged flat, tagged _draft: true.
  • @objectstack/client meta.getItems fetches /meta/:type and unwrapResponses it, with no item mapping.
  • Cloud runtime. Its code is not reachable from this container, so it is NOT MEASURED. It serves through the same objectstack protocol package.
  • objectui fixture/MSW servers. The console runs no MSW server (@objectstack/plugin-msw / MSWPlugin appear in no objectui source outside docs and evals). No non-test objectui source reads it.spec.name or it.spec.label. The only spec-wrapped flow items in the tree were the five test fixtures above.
  • Contract (A1). In the installed @objectstack/spec@18.0.0-next.2, GetMetaItemsResponseSchema declares items: z.ZodArray(z.ZodUnknown). safeParse({ type: 'flow', items: [{ spec: { name: 'x' } }, { name: 'y' }, 42] }) returns true, so no declared contract asks for spec.

Tests (at head 3b75d796ee)

  • pnpm exec vitest run --maxWorkers=1 apps/console/src/pages/developer/ apps/console/src/pages/consoleFaces.displayLocale-9909.test.tsx packages/app-shell/src/console/__tests__/openPathObjectReaders-12811.test.ts: Test Files 19 passed (19), Tests 154 passed (154). That covers every test that names FlowRunsPage; the 12811 suite reads the page's source.
  • pnpm --filter @object-ui/console run type-check after turbo run build --filter='@object-ui/console^...': both exit 0. The console tsconfig includes src with no test exclusion, so the edited tests are type-checked.
  • Ablation (one-off, not kept). Done with ablation-replace.mjs after the fix commit. The name/label lines were put back to it?.spec?.X ?? it?.X (anchor 1 to 0, blob 0b2baeeb1ae9 to baade6ee57d6, grep -c on the injected text read 1). Result: × a spec-wrapped item is not read: it lists no flow (objectui#12829), Tests 1 failed | 2 passed (3). The restore was proved by blob hash: the file is back to 0b2baeeb1ae9, the HEAD blob, and git diff HEAD is empty.

NOT MEASURED: the whole apps/console package directory under --maxWorkers=1. I stopped it after about 29 minutes holding the shared lock, with no file finished. CI's pnpm test runs it.

Gates (exit codes)

All of these exit 0:

  • check:phantom-deps, check:self-import, check:unreferenced-sources, check:doc-example-readers, check:handler-key-reads, check:side-effects-array, check:element-data-source-declaration
  • check:spec-symbols, check:action-forward-parity, check:designer-field-key-parity, check:icon-record-names
  • check:i18n-keys, check:i18n-drift, check:i18n-designer-parity, check:control-bytes, check:new-line-citations
  • check-hand-rolled-comment-mask.mjs
  • check-changeset-fixed.mjs, check-changeset-presence.mjs, check-changeset-claims.mjs, check-changeset-no-major.mjs, check-changeset-overwrite.mjs, check-pending-changeset-literals.mjs

Lint, narrowed and proved. The run was eslint --no-inline-config --format json over the 6 changed .ts/.tsx files. The JSON reports 6 files, 0 errors and 20 warnings, all no-explicit-any / set-state-in-effect in the page's existing code. The root eslint.config.js declares no parserOptions.project, so type-aware linting is not enabled, and this diff cannot move any untouched file's verdict. The repo-wide pnpm lint is CI's run.

Acceptance notes

  • Out-of-surface fixture, fixed in place. consoleFaces.displayLocale-9909.test.tsx is outside the claim's file surface. It renders FlowRunsPage with a { spec: { name: 'sync_flow', label: 'Sync' } } fixture, so removing the arm would have left its runs-table case with no flow. It is the same defect class (a fixture in the unserved shape). The fix is the same one-line mechanical move, no other claim holds the file, and the same gate family covers it. The claim's file surface should name it.

  • Changeset. The claim said no changeset. check-changeset-presence demands one for any apps/console/src change, because @object-ui/console is in the fixed group. Following the gate's message, it is the empty-frontmatter declaration.

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


Generated by Claude Code

… fixtures feed that shape (objectui#12829)

The flow list's `loadFlows` normalization read `name` and `label` as
`it.spec.X ?? it.X` and kept `spec: it.spec ?? it`. No server of
`meta.getItems('flow')` wraps an item in `spec`: objectstack's
`readFlattenedMetaItems` serves the definitions themselves (the
`?preview=draft` path included), and the spec types `items` as unknown.
The arm goes, with the `updatedAt ?? updated_at` read nothing renders,
and every fixture that fed the wrapped shape now feeds the served one.
The objectui#12783 pin's wrapped case now pins that a wrapped item is
not read.

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

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 76 chunks) 3140.3 KB 3744.1 KB
Main entry chunk (gzip) 80.1 KB 350 KB
Entry file index-Cdlfn3f0.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.42KB 7.85KB
app-shell (runtime-config.js) 23.60KB 8.19KB
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) 45.59KB 12.03KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 20.67KB 6.12KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.72KB 2.24KB
auth (SocialSignInButtons.js) 9.74KB 3.94KB
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) 42.84KB 11.66KB
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) 606.28KB 146.84KB
core (index.js) 10.18KB 4.04KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 248.83KB 69.44KB
fields (index.js) 291.19KB 74.38KB
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) 41.33KB 11.96KB
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) 210.60KB 49.94KB
plugin-dashboard (index.js) 146.23KB 39.59KB
plugin-designer (index.js) 233.95KB 50.08KB
plugin-detail (index.js) 264.38KB 69.99KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 180.22KB 46.59KB
plugin-gantt (index.js) 178.36KB 45.08KB
plugin-grid (index.js) 272.78KB 75.66KB
plugin-kanban (index.js) 62.30KB 19.27KB
plugin-list (index.js) 139.05KB 35.78KB
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.27KB 5.40KB
plugin-view (index.js) 94.68KB 24.36KB
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.23KB 39.46KB
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
objectstack-fleet Bot marked this pull request as ready for review October 17, 2026 10:42
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 17, 2026 10:42
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 17, 2026
Merged via the queue into main with commit 1fe0a8d Oct 17, 2026
37 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-12829-flow-runs-flat-items branch October 17, 2026 10:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants