Skip to content

fix(app-shell): a refused package publish names each refused item with the server's reason (objectui#11922) - #11983

Merged
objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-11922-publish-refusal-reason
Oct 8, 2026
Merged

objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-11922-publish-refusal-reason

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #11922

Clause-②: no

What changes

A refused POST /packages/:id/publish-drafts batch now names each refused item with the server's reason at the two doors outside Studio.

  • The package sheet (PackagesPage, publishDrafts). failed[] is read before the batch's own success === false. A rolled-back batch keeps the publishDraftsRolledBack row and names its causal item. A refusal with no BATCH_ABORTED element (the runtime's pre-flight checks) keeps the publishDraftsPartial row and names every refused item after it. The envelope ladder (readEnvelopeFailureText, then "Action failed") now runs only when failed[] is empty.
  • Home's Publish all and the draft-preview bar (usePublishAllDrafts). A non-empty failed[] throws the refused items' text before the success === false check, so the toast reads "Publish failed: object/lead: REASON" instead of "Publish failed: publish-drafts did not publish this package".
  • One module-private helper for both, packages/app-shell/src/preview/publishRefusal.ts (refusedItemsText), not exported from the package entry. It names every element that is not a BATCH_ABORTED sibling as type/name: error, joined with ; . If every element is aborted, it names the first one.

No export, prop, type member, spec key or language-pack key is added. The wording is the existing rows plus the server's own error text.

The producer's shape (H1), read at objectstack 51290bca

In packages/metadata-protocol/src/protocol.ts, publishPackageDrafts, quoted by content:

  • Pre-flight refusal return: success: false, outcome: 'refused', publishedCount: 0, and failed: preflightViolations.map((v) => ({ type: v.type, name: v.name, error: v.error, code: v.code })). The codes are NAMESPACE_PREFIX and STORED_TYPE_NOT_CANONICAL, and no element is BATCH_ABORTED.
  • ADR-0067 D2 rollback return: success: false and outcome: failedOut.length > 0 ? 'refused' : 'nothing_to_publish'. The causal item carries error: clientFacingFailureText(e, 'publish failed'), plus its code and issues when the cause has them. Every sibling carries code: 'BATCH_ABORTED' and an error that names the causal item.
  • No error key on either return. That is why the old ordering fell to the ladder's last rung, "Action failed".

packages/runtime/src/domains/packages.ts answers the route with deps.success(result), so the wire is { success: true, data: BATCH } on a 200. MetadataClient.publishPackageDrafts unwraps data, so both doors read the batch's own success. The spec states the invariant on PublishPackageDraftsResponseSchema.outcome: "refused if and only if failed.length > 0".

Why not formatPublishFailures

The seat's call was to reuse formatPublishFailures and PublishFailure from studio-design/metadataError.ts, unless measurement showed new eager bytes or a shape that does not fit. Measured: the shape does not fit.

  • A scratch run (not committed) fed formatPublishFailures the producer's rollback shape: a causal object/lead and two BATCH_ABORTED siblings. It printed three parallel lines (the causal item, then each sibling's "not published — the batch is all-or-nothing …") and no rolled-back banner.
  • The cause: it compares f.code === BATCH_ABORTED_CODE, and BATCH_ABORTED_CODE is 'batch_aborted', the pre-ADR-0112 spelling.
  • Its banner is also English-only, while the package sheet answers in its localized rows.

The helper here uses errorCodeIs, which matches both spellings. The eager-bytes half was not measured locally, because no full console build was run. The budget bot's reading on this PR is that measurement.

metadataError.ts is not edited, because another seat's work touches it. Its casing defect is listed under Acceptance notes.

Tests (HEAD 6226e589d)

  • New tests. PackagesPage.publishRefusal-11922.test.tsx (4 cases) and preview/__tests__/usePublishAllDrafts.refusal-11922.test.tsx (3 cases). Each drives the real useMetadataClient and client. Only fetch is stubbed, plus sonner for the hook.

  • Targeted vitest run. One repo-root pnpm exec vitest run covered:

    • the 2 new files;
    • the 18 existing test files that import PackagesPage or usePublishAllDrafts;
    • useMetadataClient.advisorySink.test.tsx;
    • perm-home-namespace-3546.test.tsx, which reads usePublishAllDrafts.ts's source;
    • StudioDesignSurface.publishCount-11807.test.tsx and metadataError.test.ts;
    • column-identity.ratchet.test.ts.

    Result: Test Files 26 passed (26), Tests 214 passed (214). The 26 includes the uncommitted scratch measurement file.

  • Type-check. pnpm --filter @object-ui/app-shell type-check: exit 0. The dependency closure came from the turbo cache. tsc -p tsconfig.test.json --listFilesOnly lists both new test files and the helper.

  • scripts/__tests__/one-authority-per-exported-name-6273.test.ts, under the lock: Tests 11 passed (11). The helper exports one function, refusedItemsText, and no other module exports that name. Its parameter type stays unexported.

  • ESLint on the five touched files: 0 errors. All 20 warnings sit on lines this PR does not touch.

  • Gates, all exit 0: node scripts/check-changeset-presence.mjs, node scripts/check-changeset-no-major.mjs, pnpm check:new-line-citations (0 new citations), check:control-bytes, check:i18n-keys, check:vi-mock-specifiers, check:vi-mock-inherit, check:vi-mock-override-shape, check:test-path-roots, check:unreferenced-sources, check:changeset-claims and check:pending-changeset-literals.

Ablation (HEAD 6226e589d, fix committed first)

The old ordering was put back with ablation-replace.mjs. Each anchor hit once and went from 1 to 0, and each blob changed.

  • The Packages page condition went back to if ((r as { success?: boolean }).success === false) {.
  • The hook's failed[] throw was deleted.

Result: Tests 4 failed | 4 passed (8).

  • Red: all four new pins. The Packages page pre-flight and rollback cases never reached the expected row. The hook's refused and rolled-back cases got Received: "home.pendingDrafts.publishFailed: publish-drafts did not publish this package".
  • Green: the three controls, plus the scratch file:
    • a published batch shows publishDraftsOk;
    • an envelope error with an empty failed[] shows the envelope's text;
    • the hook's published batch records its health and publishes the package-less flow.
  • Direction note. H2 listed "the rolled-back wording keeps naming its causal item" as a control, but it turns red. On the producer's shape every rollback answers success: false, so the old ordering never reached the publishDraftsRolledBack row. It is a new pin, not a control.
  • Restore. ablation-replace.mjs --restore ran on both paths. Each blob equals its HEAD blob (ade4d2874, b84739516), and git diff HEAD is empty.

Acceptance notes

  • Out-of-scope finding (class a), not fixed here. formatPublishFailures in studio-design/metadataError.ts tells a rolled-back sibling apart by 'batch_aborted' compared with ===, but the producer emits BATCH_ABORTED.
    • On a rollback, Studio's publish (StudioDesignSurface, after objectui#11916) and AiChatPage therefore list every aborted sibling as a parallel error and never show the rolled-back banner (measured above).
    • Its own test fixture uses the lowercase spelling, which is why it stays green.
    • Seam: spec:PublishPackageDraftsResponseSchema.failed[].code (SCREAMING_SNAKE) → renderer:formatPublishFailures. Handed to the seat for filing.
  • Noted, not filed. Both doors here still read outcome: 'nothing_to_publish' (success: false, empty failed[]) as a failure, where Studio says "nothing to publish" (objectui#11807). Reaching it needs drafts that were listed but are no longer pending at publish time, and that was not measured at either door. This PR keeps that path unchanged; it is the H2 envelope control.
  • Noted, not measured. A comment in DraftChangesPanel says the metadata-admin string table is not on the console's eager graph. services/builtinComponents.tsx imports PackagesPage statically, and PackagesPage imports that table. This was read from source only; the budget bot is the measurement.

Generated by Claude Code

…h the server's reason

The package sheet's publishDrafts and usePublishAllDrafts (Home's Publish all,
the draft-preview bar) read the batch's own success === false before failed[].
A refusal carries both, so the author read "Action failed" or "publish-drafts
did not publish this package". Both now read failed[] first and name the
refused items (the causal item on a rollback, every item on a pre-flight
refusal) through one module-private helper, preview/publishRefusal.ts.

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

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 337 chunks) 3311.2 KB 3312.0 KB
Main entry chunk (gzip) 71.4 KB 350 KB
Entry file index-IhhFBZ9Q.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) 18.33KB 6.73KB
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) 18.15KB 5.40KB
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.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
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.11KB 7.97KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.28KB 2.60KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
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) 587.49KB 141.58KB
core (index.js) 10.00KB 3.96KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 240.39KB 67.09KB
fields (index.js) 268.74KB 68.04KB
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.50KB 11.82KB
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) 13.86KB 5.00KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.52KB 2.26KB
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) 53.43KB 15.54KB
plugin-charts (index.js) 84.71KB 23.25KB
plugin-chatbot (index.js) 199.63KB 47.46KB
plugin-dashboard (index.js) 144.20KB 38.95KB
plugin-designer (index.js) 231.46KB 48.87KB
plugin-detail (index.js) 248.57KB 65.47KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 177.11KB 45.88KB
plugin-gantt (index.js) 179.17KB 45.07KB
plugin-grid (index.js) 248.22KB 68.84KB
plugin-kanban (index.js) 52.22KB 16.38KB
plugin-list (index.js) 117.68KB 29.40KB
plugin-map (index.js) 27.24KB 9.03KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 44.12KB 12.29KB
plugin-timeline (index.js) 39.10KB 11.81KB
plugin-tree (index.js) 15.07KB 5.33KB
plugin-view (index.js) 91.09KB 22.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) 11.81KB 3.58KB
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.80KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.28KB 0.23KB
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-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 (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.25KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.11KB 3.32KB
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 8, 2026 15:26
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 8, 2026 15:26
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 8, 2026
Merged via the queue into main with commit c6e1b8c Oct 8, 2026
45 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-11922-publish-refusal-reason branch October 8, 2026 15:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants