Skip to content

fix(console): the Flow Runs picker reads a flattened flow item's label (objectui#12783) - #12828

Merged
objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-12783-flow-runs-picker-label
Oct 17, 2026
Merged

objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-12783-flow-runs-picker-label

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #12783
Clause-②: no

The developer Flow Runs page's flow picker lists every flow by its API name against a real server. objectstack's getMetaItems answers meta.getItems('flow') with flattened items: each flow's name and label sit on the item itself, with no spec member. The page's item normalization in loadFlows (FlowRunsPage.tsx) read the name as it?.spec?.name ?? it?.name but the label as it?.spec?.label alone, so the label was always undefined and the option fell back to the bare name.

The label is now read the way the name is, spec first and then the item itself:

name: it?.spec?.name ?? it?.name,
label: it?.spec?.label ?? it?.label,

The picker therefore shows the page's own label (name) form for a labelled flow, and a flow with no label still shows its bare name. Nothing else on the page changes: no export, prop, type member or i18n key.

Reproduction, before and after (browser)

Backend: objectstack 66d456d01, examples/app-showcase, objectstack dev --seed-admin --fresh on a private port, used as a backend only. Console: this worktree's apps/console Vite dev server pointed at it. The probe signs in, opens /apps/showcase_app/component/developer/flow-runs, records the raw GET /api/v1/meta/flow answer the page receives, and reads every option of the picker.

The raw answer the page receives (identical in both runs): envelope keys type, items, registrations; 32 items; 0 items carry a spec member; 32 carry a top-level label. showcase_batch_reminders is served as name: showcase_batch_reminders, label: Batch Task Reminders (Loop), no spec.

Reading unchanged main 33ee9de this branch d841908
options listed 32 32
options in label (name) form 0 32
showcase_batch_reminders option text showcase_batch_reminders Batch Task Reminders (Loop) (showcase_batch_reminders)
trigger on load showcase_task_completed Notify on Task Completed (showcase_task_completed)

On the branch, picking that flow shows the trigger Batch Task Reminders (Loop) (showcase_batch_reminders), and the Test Run panel lists its input variable tasks with type list: the runner reads the flow body from spec: it?.spec ?? it, which already fell back to the flat item.

Pins

New file apps/console/src/pages/developer/FlowRunsPage.flattenedLabel-12783.test.tsx, three cases, each reading the opened picker's option texts:

  1. a flattened answer shaped as the served list ({ type, items }, item flat, no spec): Batch Task Reminders (Loop) (showcase_batch_reminders), then nightly_sync;
  2. a spec-wrapped answer: the same two texts;
  3. an unlabelled flat flow: nightly_sync alone.

Direction, measured on unchanged main (fix absent, pins present): Tests 1 failed | 2 passed (3). Case 1 is red with - "Batch Task Reminders (Loop) (showcase_batch_reminders)" / + "showcase_batch_reminders". Cases 2 and 3 are green there by design: they guard the forms the fix must not disturb. With the fix: Tests 3 passed (3).

Ablations (one per pin, fix committed first)

Each leg went through ablation-replace.mjs in wrap mode: the literal anchor label: it?.spec?.label ?? it?.label, hit once, the mutation was verified on disk (anchor count 1 to 0, blob changed), the pin file ran, and the file was restored from HEAD. Restore was proven per leg by the blob hash equal to the HEAD blob (5147dc4b438b) and git diff HEAD empty. The subject is imported from source (./FlowRunsPage), so no build sits between the mutation and the run.

Leg Mutation Result
A1 drop the flat arm: label: it?.spec?.label, case 1 red, 2 and 3 green (1 failed, 2 passed)
A2 drop the spec arm: label: it?.label, case 2 red, 1 and 3 green (1 failed, 2 passed)
A3 let the name stand in for a missing label: ... ?? it?.spec?.name ?? it?.name, all three red (3 failed): every case lists the unlabelled nightly_sync, received as nightly_sync (nightly_sync)

Hypothesis 1: other reads on this page that assume spec

None that changes what a user sees. The page reads no flow description and no flow type. The only other spec read is spec: it?.spec ?? it, which already falls back to the flat item; the Test Run panel's input variables come from it and are live on the served list (the tasks reading above). Nothing outside the claimed lines was changed.

Local gates (final commit d841908)

  • closure build: pnpm --workspace-concurrency=2 --filter '@object-ui/console^...' build through the verify lock: VERDICT command-exit 0.
  • pnpm exec vitest run --maxWorkers=2 apps/console/src/pages/developer/ (repo-root form, every suite under the directory, the new file included): Test Files 17 passed (17), Tests 139 passed (139), exit 0.
  • pnpm --filter @object-ui/console type-check (script name echoed: tsc --noEmit && tsc -b tsconfig.node.json --force): exit 0. tsc --noEmit --listFiles in apps/console lists all 17 test files under the directory, the new one included.
  • eslint on the two changed source files with the repo config and --no-inline-config: exit 0, 0 errors; every warning sits on a line this diff does not touch.
  • node scripts/check-changeset-presence.mjs: exit 0, one changeset declared (@object-ui/console patch).
  • pnpm check:new-line-citations: exit 0, 0 new citation(s).
  • also run: pnpm check:changeset-claims and pnpm check:pending-changeset-literals, both exit 0.

The rest of the farm is CI's.

Acceptance notes

  • The spec arm has no measured producer. On the showcase server 0 of 32 listed items carry spec, and the spec's GetMetaItemsResponseSchema types items as unknown. The page's other suites (FlowRunsPage.test.tsx, FlowRunsPage.sharedSelect-11865.test.tsx, developerMetadataEnvelope.contractEnvelope-6917.test.tsx) feed only spec-wrapped items, which is why none of them saw this. This change keeps the spec arm for the label exactly as the name already had it, as the claim pinned; whether both arms should be retired in favour of the flat item alone is a separate question, raised in the dev report.
  • Long labels truncate in the trigger. With labels shown, the longest showcase option, Nested Fan-out Reminders (Loop of Parallel) (showcase_nested_fan_out_reminders), is clipped in the closed trigger to Nested Fan-out Reminders (Loop of Parallel)..., and the clipped line is centred. That comes from the shared Shadcn SelectTrigger (its line-clamp-1 on the value span inside a button). The open list shows every option in full. Not filed: it is the primitive's generic behaviour, not this page's.
  • FlowItem.updatedAt is normalized from updatedAt or updated_at but is never rendered. Left as is.

The work was done in session https://claude.ai/code/session_01Vk15bz8xHtKGUfXfCm16h4.


Generated by Claude Code

…l (objectui#12783)

objectstack's getMetaItems serves meta.getItems('flow') as flattened
items: name and label sit on the item, with no spec member. The page read
the name from either form but the label from spec.label only, so on a real
server the picker listed every flow by its API name. The label is now read
the way the name is, spec first and then the item itself.

Pins: a flattened answer shows `label (name)`; a spec-wrapped answer shows
the same text; an unlabelled flow shows its bare name.

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

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 75 chunks) 3131.7 KB 3744.1 KB
Main entry chunk (gzip) 75.7 KB 350 KB
Entry file index-_QVqz8aR.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) 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) 41.15KB 10.86KB
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) 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) 606.28KB 146.84KB
core (index.js) 10.18KB 4.04KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 248.96KB 69.45KB
fields (index.js) 291.36KB 74.46KB
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.79KB 11.90KB
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.23KB 39.59KB
plugin-designer (index.js) 233.95KB 50.08KB
plugin-detail (index.js) 263.70KB 69.73KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 180.28KB 46.60KB
plugin-gantt (index.js) 178.36KB 45.08KB
plugin-grid (index.js) 271.78KB 75.39KB
plugin-kanban (index.js) 59.42KB 18.48KB
plugin-list (index.js) 138.78KB 35.68KB
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) 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

Copy link
Copy Markdown
Contributor Author

席位核对 — ACCEPT · domain:ui seat 3 · session_01Vk15bz8xHtKGUfXfCm16h4 · 2026-10-17T00:05Z

Head reviewed: d841908f4298bc4d46832bf4b861b416eabcbd19, one round.

  • Card objectui#12783; claim 6226635834, Clause-②: no.
  • The seat's answer to the report's open question is 6226979445: A for this card; the retirement of the spec arm is objectui#12829.
  • No export, prop or type changes, and no contract face. The gates are CI plus the seat's own read.

Implemented-by: claude/issue-12783-flow-runs-picker-label
Reviewed-by: session_01Vk15bz8xHtKGUfXfCm16h4

1. Shape.

  • Draft PR against main. The body's first line is Fixes #12783, and the body has no other closing keyword (scanned in full).
  • 3 files, +137/−1, all inside the claim's surface:
    • apps/console/src/pages/developer/FlowRunsPage.tsx (+5/−1): label is read as it?.spec?.label ?? it?.label, the same shape and order as the name read beside it, under a four-line comment;
    • one new pin file, FlowRunsPage.flattenedLabel-12783.test.tsx (3 cases);
    • changeset .changeset/12783-flow-runs-picker-label.md: @object-ui/console: patch.
  • Nothing else on the page changes. The dev read the page's other spec reads: there is no description or type read, and spec: it?.spec ?? it already falls back.
  • No content/docs/releases/.

2. Premises measured (the dev's browser readings, audited by the seat in the run's transcript).

  • Setup: objectstack 66d456d01 examples/app-showcase --fresh as the backend, the console from the worktree, Chromium.
  • GET /api/v1/meta/flow is the {type, items, registrations} envelope with 32 items: 0 carry a spec member, and all 32 carry a top-level label.
reading main 33ee9de this PR (d841908)
picker options in label (name) form 0 of 32 (showcase_task_completed, showcase_batch_reminders, …) 32 of 32 ("Batch Task Reminders (Loop) (showcase_batch_reminders)", …)
trigger after a pick the bare name "Notify on Task Completed (showcase_task_completed)"

3. Gates (check-runs pinned to this head).

  • 36 runs: 33 success, 3 skipped (Test (coverage), its matrix row, dependabot), 0 red.
  • Among the successes: Lint, Type Check, Repo Gates, Test, Test (shard 1/16) … (16/16), Test (dist pins), Build & E2E, Build Docs, Bundle Analysis (PASS, 6226923098: eager closure 3131.7 KB of 3744.1 KB), Live E2E (informational), the changeset checks, Line Citation Gate and Governed Surface Queue Guard.
  • The dev's local subset at d841908:
    • 17 files / 139 tests, every suite under apps/console/src/pages/developer/;
    • the closure build and the console type-check (--listFiles includes the new pin);
    • eslint, with 0 errors and none of the 20 existing warnings on a changed line;
    • changeset presence, check:changeset-claims and new-line citations.
  • Red first on unchanged main: 1 failed / 2 passed. The flattened case received showcase_batch_reminders. The spec-wrapped and unlabelled cases are guards, green by design.
  • Three ablations, each restored and proven:
    • the flat arm dropped: case 1 red only;
    • the spec arm dropped: case 2 red only;
    • the name standing in for a missing label: all 3 red.

4. Accepted deviations.

  • The spec arm stays, as the claim pinned. Its retirement waits on a producer census, and the seat's answer A records it as objectui#12829.
  • Prose checked against the diff:
    • the changeset's "objectstack's metadata list answers meta.getItems('flow') with flattened items";
    • "Nothing else on the page changes";
    • the comment above the normalization.

5. Out of scope (where each went).

  • The page's spec-wrapped read has no measured producer, and its fixtures feed only that shape, which is how this defect stayed green. → filed objectui#12829, with the census as its first step.
  • With labels shown, the longest option is clipped in the closed picker trigger by the shared SelectTrigger's line-clamp-1 (the packages/components/src/ui/ No-Touch zone). The open list shows every option in full. → Acceptance notes.
  • The normalization reads updatedAt ?? updated_at into a field the page never renders. → Acceptance notes, and named in objectui#12829.

6. Landing.

  • Not governed: check-governed-merges.mjs --root objectui --test over the 3 paths reads NOT governed (0 of 3 paths hit the register).
  • 138 lines changed, under the 3000-line threshold.
  • Clause-②: no. Every check is green or an expected skip.
  • ⇒ The seat lands it: relay pr_ready + automerge_enable, through the merge queue.
  • On MERGED, Fixes closes objectui#12783.

Generated by Claude Code

@objectstack-fleet
objectstack-fleet Bot marked this pull request as ready for review October 17, 2026 00:07
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 17, 2026 00:07
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 17, 2026
Merged via the queue into main with commit b524150 Oct 17, 2026
37 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-12783-flow-runs-picker-label branch October 17, 2026 00:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants