Skip to content

fix(app-shell): re-point saveAdvisoryToast's TranslateFn at its one authority - #8205

Merged
os-justin merged 1 commit into
mainfrom
claude/issue-8165-translatefn-one-authority
Sep 7, 2026
Merged

os-justin merged 1 commit into
mainfrom
claude/issue-8165-translatefn-one-authority

Conversation

@os-justin

Copy link
Copy Markdown
Collaborator

Part of #8165 — deliberately not a closing keyword: this lands two of the three sites and leaves the third open, for the reason measured below. #8165 stays open for re-triage.

What changed

  • packages/app-shell/src/providers/saveAdvisoryToast.ts — the local export type TranslateFn = … is gone; the module now import types it from ./writeWarningToast.js for its own two uses and re-exports it, so an import from ./saveAdvisoryToast.js still resolves to the same type. Same shape as the two worked examples already in the tree (orgRoleLabel.ts re-exporting OrgTranslate, resolveBulkActions.ts re-exporting NamedActionDef) and as metadataReadWarningToast.ts, which took this exact route in fix(data-objectstack): discriminate a refused mapping read from a served zero, on a channel #8152.
  • scripts/__tests__/one-authority-per-exported-name-6273.test.ts — the TranslateFn KNOWN_COLLISIONS entry loses that site. Three files to two. ⛔ No line added; the baseline is SHRINK-ONLY by its own text.
  • .changeset/8165-translatefn-one-authority.md — empty frontmatter (declares no release), see below.

⚠️ The measurement that had to come first

The card's own caution is the load-bearing one: the gate counts declarations, not shapes, so a re-export of a type that had quietly diverged would silently change two call sites' contracts with nothing noticing. Re-measured on 158d75bb3 before touching anything — the three declarations are byte-identical:

sha256 29f2f334f47b8ac55bd05fc5dcf7f0d769c303f0e2deb1c79aff6a9cd46e3762   (all three)
86 bytes each, identical `od -c` dumps
  packages/app-shell/src/providers/writeWarningToast.ts:26
  packages/app-shell/src/providers/saveAdvisoryToast.ts:43
  packages/fields/src/widgets/file-size-guard.ts:26

No shape to reconcile, so the re-point is safe on the two sites it touches.

The authority did not need choosing either: AdapterProvider is the single caller of all three emitters and already imported TranslateFn from ./writeWarningToast.js, passing that one value into each of them (:17, :81, :94, :107).

⛔ Why the third site is NOT re-pointed — the card's remedy is dependency-illegal there

The card prescribed export type { TranslateFn } from '<writeWarningToast>' for both of the other two. That is not available in packages/fields:

  • @object-ui/app-shell DEPENDS ON @object-ui/fields (packages/app-shell/package.json, dependencies), and packages/fields has zero real imports of @object-ui/app-shell. Pointing fields at app-shell is a package cycle.
  • TranslateFn is on neither package's published face, so there is nothing to import either — see the next section.

⇒ retiring that copy means moving the authority DOWN into a package both depend on — the route the baseline's own KanbanSchema note records. That publishes a new name from a shared package and is a decision nobody has made, so this PR stops rather than guessing. Measured: all the packages carrying a copy of this shape depend on @object-ui/i18n; not all depend on @object-ui/types.

Clause ② — is any of the three on a published face?

No, so this is not a public-face change and does not want needs:contract-review. Checked for star re-exports, not only the literal name:

  • packages/app-shell/src/index.ts — 83 export statements, zero export * anywhere in the file, and no literal TranslateFn. The package's only entry is . (plus ./styles.css).
  • packages/fields has no src/index.ts — its entry is src/index.tsx, which does star 50 widget modules, but not ./widgets/file-size-guard.js, and none of that file's three importers (FileField, ImageField, LocationField) re-exports the name.
  • Decisive on the built artefact: packages/fields/dist/index.d.ts has 0 occurrences of TranslateFn, against a control (FileField, a name known to be starred) at 2.

The gate's own verdict lines, before and after

BEFORE (base 158d75bb3, unmodified)
  Test Files  1 passed (1)
       Tests  11 passed (11)
  os-verify-lock: VERDICT command-exit 0

AFTER (this branch)
  Test Files  1 passed (1)
       Tests  11 passed (11)
  os-verify-lock: VERDICT command-exit 0

Ablation — the gate still fails, in both directions

Both legs mutated on disk (proved by anchored fixed-string counts before and after), restored with git checkout HEAD -- <abs path>, and the restore proved by state (git hash-object == git rev-parse HEAD:PATH, empty git diff HEAD) rather than by an exit code. Run at aa1114558.

Leg A — re-add a local declaration in saveAdvisoryToast.ts (decl count 0 to 1, re-export 1 to 0). Gate exit 1:

× declares no name twice outside the named, shrinking baseline
  TranslateFn — a NEW site for a known collision
      packages/app-shell/src/providers/saveAdvisoryToast.ts:72 — type declaration
  ⛔ KNOWN_COLLISIONS is SHRINK-ONLY: adding a line is not a supported way to make this pass

Leg B — put the three-site baseline entry back while keeping the re-point (entry3 count 0 to 1, entry2 1 to 0). Gate exit 1, which is the proof the baseline edit was owed, not optional:

× declares no name twice outside the named, shrinking baseline
  KNOWN_COLLISIONS lists collisions that no longer exist …
  TranslateFn — no longer collides at:
      packages/app-shell/src/providers/saveAdvisoryToast.ts

Restore, both legs and final state:

RESTORE-PROOF OK  packages/app-shell/src/providers/saveAdvisoryToast.ts  disk=e7d158be2… == HEAD=e7d158be2…
RESTORE-PROOF OK  scripts/__tests__/one-authority-per-exported-name-6273.test.ts  disk=e6ddbd54b… == HEAD=e6ddbd54b…
git diff HEAD  →  empty

Tests and gates run locally (all at aa1114558 unless noted)

run result
pnpm exec turbo run build --filter=@object-ui/app-shell^... --concurrency=2 28/28 successful — the dependency closure, without which type-check reports a wall of unrelated TS2307
pnpm --filter @object-ui/app-shell type-check (tsc --noEmit && tsc -p tsconfig.test.json) VERDICT command-exit 0, zero error TS
pnpm exec vitest run packages/app-shell/src/providers/ packages/app-shell/src/services/MetadataService.saveAdvisories.test.ts scripts/__tests__/one-authority-per-exported-name-6273.test.ts 20 files, 153 tests, all passed
node scripts/check-changeset-presence.mjs exit 0 — "declared as releasing nothing, which is the explicit exemption and a complete answer to this gate"
node scripts/check-control-bytes.mjs exit 0 (6534 tracked text files)
node scripts/check-governed-queue-guard.mjs --test <the 3 paths> exit 0 — "NOT GOVERNED — 3 path(s) checked against 5 governed surface(s); none matched"
eslint --no-inline-config --format json on the two changed source files 2 files linted, 0 errors, 0 warnings

Declared narrowings, so the omissions are visible rather than implied:

  • The test run is scoped to packages/app-shell/src/providers/ plus the one consumer suite that imports the type, not the whole 281-file package. The change is type-level and erases at build, so it has no runtime reach; the full package run is CI's.
  • Lint was run on the two changed files rather than the repository. That is a measurement, not a skip: eslint's own config carries no type-aware linting (no projectService, no project in eslint.config.js, 337 lines, control grep on the same file fires), so this diff cannot move the verdict on any file it does not touch. Repo-wide pnpm lint is CI's.

Changeset — why empty frontmatter

packages/app-shell/src/** changed, so a changeset is owed. It declares no release: the removed declaration was byte-identical to the one it now re-exports, export type { X } from '…' erases at build, and the name is on no package's published face, so nothing a consumer of @object-ui/app-shell can observe changed. skip-changeset is deliberately not applied — in this repository the changeset declaration is the mechanism and that label exempts nothing.

Out-of-scope finding, filed not fixed

#8203 records what turned up while measuring this one: the same narrowed-t shape is declared 11 times across 6 packages under 9 different names, and 8 of those are structurally invisible to this gate, which matches on NAME and counts exported declarations only. Filed with the finding class label and no grading. ⛔ Nothing in packages/fields other than the untouched file-size-guard.ts was read or changed here, per the #8194 fence.

⛔ Left as draft on purpose — the PM lands it.


🤖 Generated with Claude Code

https://claude.ai/code/session_01YBWFb5YgMU5dw8p2VKj16S


Generated by Claude Code

…uthority

`TranslateFn` had three declarations, and `KNOWN_COLLISIONS` in
`scripts/__tests__/one-authority-per-exported-name-6273.test.ts` carried all
three as accepted debt. That baseline is SHRINK-ONLY by its own text, and
nothing owned shrinking it.

Re-measured first, because the card's own caution is the one that matters: a
re-export of a type that had quietly diverged would silently change two call
sites' contracts, and the gate counts declarations, not shapes. All three
declarations are byte-identical on this base — 86 bytes each, one sha256
(29f2f334f47b8ac55bd05fc5dcf7f0d769c303f0e2deb1c79aff6a9cd46e3762) across the
three, identical `od -c` dumps. So there is no shape to reconcile.

The authority did not need choosing either: `AdapterProvider` is the single
caller of all three emitters and already imports `TranslateFn` from
`./writeWarningToast.js`, passing that one value into each of them.
`saveAdvisoryToast.ts` now re-exports it, which the gate explicitly does not
count as a declaration, and the baseline entry loses that site in the same
change.

The `packages/fields/src/widgets/file-size-guard.ts` site is deliberately NOT
re-pointed and stays on the baseline. `@object-ui/app-shell` DEPENDS ON
`@object-ui/fields`, so a re-export in that direction is a package cycle, and
`TranslateFn` is on neither package's published face, so there is nothing to
import either. Retiring the last copy means moving the authority DOWN into a
package both depend on, which publishes a new name and is a decision nobody has
made.

Type-level only, on a name no package publishes, so the changeset declares an
empty frontmatter: no package is released by this change.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YBWFb5YgMU5dw8p2VKj16S
@github-actions

github-actions Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 50 chunks) 3189.7 KB 3191.4 KB
Main entry chunk (gzip) 143.9 KB 350 KB
Entry file index-hEe9Dmno.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) 15.67KB 5.75KB
app-shell (runtime-config.js) 20.68KB 7.36KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 25.05KB 9.16KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.18KB 10.59KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.41KB 1.23KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.46KB 3.43KB
auth (index.js) 3.19KB 1.44KB
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) 5.13KB 2.35KB
collaboration (CommentThread.js) 26.08KB 7.56KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 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) 498.00KB 113.91KB
core (index.js) 6.96KB 2.79KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 187.85KB 52.13KB
fields (index.js) 243.04KB 61.36KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 1.22KB 0.64KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 6.57KB 2.76KB
i18n (index.js) 3.65KB 1.47KB
i18n (pickLocalized.js) 7.62KB 3.26KB
i18n (provider.js) 26.89KB 9.04KB
i18n (useDisplayLocale.js) 2.85KB 1.45KB
i18n (useObjectLabel.js) 34.34KB 9.17KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 38.84KB 10.94KB
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) 2.53KB 0.85KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 4.39KB 1.66KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 11.71KB 4.29KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 5.12KB 1.74KB
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) 15.16KB 3.68KB
plugin-calendar (index.js) 47.67KB 13.25KB
plugin-charts (index.js) 70.62KB 19.71KB
plugin-chatbot (index.js) 193.54KB 46.04KB
plugin-dashboard (index.js) 131.41KB 34.43KB
plugin-designer (index.js) 211.51KB 43.01KB
plugin-detail (index.js) 247.68KB 63.49KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 131.01KB 32.32KB
plugin-gantt (index.js) 167.16KB 40.99KB
plugin-grid (index.js) 208.58KB 56.63KB
plugin-kanban (index.js) 52.83KB 14.63KB
plugin-list (index.js) 113.35KB 27.73KB
plugin-map (index.js) 20.49KB 6.83KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 43.42KB 11.92KB
plugin-timeline (index.js) 30.10KB 8.74KB
plugin-tree (index.js) 9.33KB 3.25KB
plugin-view (index.js) 84.46KB 20.80KB
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.66KB 3.50KB
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) 81.07KB 26.86KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.63KB 2.18KB
react (schema-input.js) 2.32KB 1.24KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 6.58KB 2.74KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 5.55KB 2.45KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 20.57KB 5.88KB
sdui-parser (provenance.js) 3.66KB 1.82KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 13.64KB 4.59KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 1.00KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 2.74KB 1.41KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
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) 0.20KB 0.18KB
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) 4.74KB 2.25KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 4.73KB 2.28KB
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 (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
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

@os-justin
os-justin marked this pull request as ready for review September 7, 2026 01:12
@os-justin
os-justin added this pull request to the merge queue Sep 7, 2026
Merged via the queue into main with commit ecf8e72 Sep 7, 2026
33 of 34 checks passed
@os-justin
os-justin deleted the claude/issue-8165-translatefn-one-authority branch September 7, 2026 01:26
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 28, 2026
…ields re-export it (objectui#8261) (objectstack-ai#10703)

Fixes objectstack-ai#8261
Clause-②: yes — `@object-ui/i18n` publishes a new name, `TranslateFn`

Executes the maintainer's ruling on objectui#8165 (comment 5565867673,
decision batch objectstack-ai#72, option A): the narrowed i18next `t` gets ONE
authority, exported from `@object-ui/i18n`, and the two remaining
declarations become type re-exports of it. Round 1 was verified at
`367e586e4`. Round 2 (`b235ae53d`) applies the contract review's prose
ruling and re-points the last local copy; its checks are listed
separately below.

Spelling note: GitHub strips tag-shaped fragments from bodies, so the
options parameter's type is written `Record(string, unknown)` here; the
source spells it with angle brackets.

## What changed

- `packages/i18n/src/translateFn.ts` (new): `export type TranslateFn =
(key: string, options?: Record(string, unknown)) => string;` with a
docblock naming it the one authority.
- `packages/i18n/src/index.ts`: `export type { TranslateFn } from
'./translateFn.js';`, next to the existing `SafeTranslate` export.
- `packages/app-shell/src/providers/writeWarningToast.ts` and
`packages/fields/src/widgets/file-size-guard.ts`: the local declaration
is gone. Each now does `import type { TranslateFn } from
'@object-ui/i18n'` for its own uses and `export type { TranslateFn }
from '@object-ui/i18n'`, so every existing import of the name from these
two modules still resolves. From `writeWarningToast` that is
`AdapterProvider`; from `file-size-guard` it is `FileField`,
`ImageField`, `LocationField` and `numberBadInput`. None of their import
paths change.
- `packages/app-shell/src/providers/saveAdvisoryToast.ts` and
`metadataReadWarningToast.ts` now re-export from `@object-ui/i18n`
directly, not through `writeWarningToast`. Their docblocks said
`writeWarningToast` was the owner, which this change makes false, so
they had to be rewritten anyway. Pointing them at the real owner means
an import resolves in one hop and no module in the chain claims
ownership it lacks.
- `packages/app-shell/src/preview/usePublishAllDrafts.ts` and
`packages/app-shell/src/utils/managedByEmptyState.ts`: each local,
unexported `type TranslateFn` is replaced by `import type { TranslateFn
} from '@object-ui/i18n'` (see H1). `managedByEmptyState.ts` was added
in round 2, when the seat widened the file surface by this one file.
- `scripts/__tests__/one-authority-per-exported-name-6273.test.ts`: the
`TranslateFn` row is removed from `KNOWN_COLLISIONS`. Its comment block
is replaced by a "sat here" note in the form the other retired rows use.
No line was added.
- `.changeset/8261-translatefn-i18n-authority.md`: `'@object-ui/i18n':
minor` (a newly published name), `'@object-ui/app-shell': patch`,
`'@object-ui/fields': patch`. No `major`.
- `.changeset/8165-translatefn-one-authority.md`: prose reconciled with
a dated note (H6). The frontmatter is byte-identical.
- `packages/i18n/README.md`: a short `TranslateFn` subsection (H6).

After this change, `git grep` over `packages/*/src` finds exactly **1**
declaration of `TranslateFn` (exported or local, `type` or `interface`):
`packages/i18n/src/translateFn.ts`. The same pattern finds 4 on the base
`c659439b4`, which is the control.

## H1: census on the base (`c659439b4`)

`TranslateFn` declarations:

| site | exported? | seen by the one-authority gate? |
| :-- | :-- | :-- |
| `packages/app-shell/src/providers/writeWarningToast.ts` | yes | yes
(the gate's row) |
| `packages/fields/src/widgets/file-size-guard.ts` | yes | yes (the
gate's row) |
| `packages/app-shell/src/preview/usePublishAllDrafts.ts` | no | no |
| `packages/app-shell/src/utils/managedByEmptyState.ts` | no | no |

`saveAdvisoryToast.ts` and `metadataReadWarningToast.ts` re-exported the
name from `writeWarningToast`, as the order stated.

Neither local declaration is visible to the gate. Its `DECLARATION`
pattern needs a leading `export`, and it counts exported type-level
names only (bound 1 in its header). Both local declarations are rows in
objectui#8203's table.

- **`usePublishAllDrafts.ts` is re-pointed.** It is in this order's file
surface. The order also asked whether it is identical in shape. It is
identical in type, but not byte-identical: the parameter is spelled
`opts`. TypeScript does not compare parameter names when it checks a
function type, so the signature of `usePublishAllDrafts(t: TranslateFn)`
is unchanged.
`packages/i18n/src/__tests__/perm-home-namespace-3546.test.tsx` pins the
text `export function usePublishAllDrafts(t: TranslateFn)`, which is
kept.
- **`managedByEmptyState.ts` is re-pointed (round 2).** Round 1 left it
alone because it was outside the file surface. The contract review then
found that it made two published sentences false, and the seat widened
the surface by this file. Before re-pointing, its declaration was
checked against the authority with the `export` prefix set aside. Both
are `type TranslateFn = (key: string, options?: Record(string, unknown))
=> string;`, 79 bytes with the newline, sha256
`083c3a40d29b6f256a603bb907f3e4de032a4dfe5abcca6c199220172d9dea24`. It
is byte-identical, so no signature moves.

The same shape under other names on the base: `TranslationFn`
(AiChatPage), `TFn` (CloudAiModelStatus), `OrgTranslate` (exported),
`Translate` (`packages/core/src/actions/recordDelete.ts`),
`InboxTranslate` (exported), `ActivityTranslate`, `CommentsTranslate`,
`SummaryTranslate` and `TimelineTranslate` (exported). Some spell the
second parameter `vars` or `params`. These are objectui#8203's
population. objectui#8203 is closed `not_planned` and is not addressed
here.

## H2: byte-identity, re-measured before re-pointing

On `c659439b4`, the two exported declarations are the same line:

```
export type TranslateFn = (key: string, options?: Record(string, unknown)) => string;
sha256 29f2f334f47b8ac55bd05fc5dcf7f0d769c303f0e2deb1c79aff6a9cd46e3762  (both lines, trailing newline included: 86 bytes)
sha256 1a7e8e9dd0c69e6cfb4e6ccff472df17d878277ef4eafb907fbb018d6600e2b2  (both, without the newline: 85 bytes)
cmp exit 0; identical od -c dumps
```

This matches the card's `29f2f334…`, 86 bytes on `158d75bb3`, so nothing
has drifted. The new declaration in `@object-ui/i18n` is the same line,
so re-pointing changes no call site's contract.

## H3: the home

- `@object-ui/i18n`'s `package.json` declares `types` and
`exports['.'].types` as `./dist/index.d.ts`. `tsconfig.json` sets
`rootDir: src`, so the entry file is `packages/i18n/src/index.ts`. The
package has no stale second entry.
- `@object-ui/app-shell` and `@object-ui/fields` both already list
`@object-ui/i18n: workspace:*` in `dependencies`. `@object-ui/i18n`'s
only workspace dependency is `@object-ui/core`, which depends only on
`@object-ui/types`, so there is no cycle. **No `package.json` changed.**
- Built declaration, after `turbo run build
--filter='@object-ui/app-shell^...'` (28/28 successful):

| file | `TranslateFn` | control |
| :-- | --: | :-- |
| `packages/i18n/dist/index.d.ts` | 1: `export type { TranslateFn } from
'./translateFn.js';` | `SafeTranslate` 2 |
| `packages/i18n/dist/translateFn.d.ts` | 3 (the declaration plus two
docblock mentions) | n/a |
| `packages/fields/dist/index.d.ts` | **0**: the name is not on
`@object-ui/fields`' face | `FileField` 2 |

## H5: the gate, before and after, plus ablation

| run | tree | result |
| :-- | :-- | :-- |
| gate BEFORE | detached worktree at `c659439b4` (`TranslateFn` rows: 1)
| Test Files 1 passed (1), Tests 11 passed (11) |
| gate AFTER | head `367e586e4` (`TranslateFn` rows: 0) | Test Files 1
passed (1), Tests 11 passed (11) |

Ablation was run at `367e586e4` after the commit. Every leg went through
`scripts/ablation-replace.mjs` (objectstack) in wrap mode: the anchor
had to hit exactly once, the blob change was checked on disk, and the
file was restored from `HEAD`. The gate reads source from disk, so no
build or `dist` is involved in legs A and B.

- **Leg A: a local declaration put back in `file-size-guard.ts`.** The
re-export line was replaced by the old declaration: anchor x1 to x0,
replacement x0 to x1, blob `ca873659cf07` to `6e625184bee3`. Gate exit 1
(Tests 1 failed, 10 passed). The collision is named:
  ```
  TranslateFn — a NEW colliding name
      packages/fields/src/widgets/file-size-guard.ts — type declaration
      packages/i18n/src/translateFn.ts — type declaration
⛔ KNOWN_COLLISIONS is SHRINK-ONLY: adding a line is not a supported way
…
  ```
- **Leg B: the removed row put back, re-points kept.** This is the
stale-row direction, modelled on objectstack-ai#8205's leg B. The mutation was 0 rows
to 1, blob `600bed9be040` to `38991d28dc31`. Gate exit 1 (Tests 1
failed, 10 passed), which proves the row removal was owed:
  ```
  KNOWN_COLLISIONS lists collisions that no longer exist …
    TranslateFn — no longer collides at:
        packages/app-shell/src/providers/writeWarningToast.ts
        packages/fields/src/widgets/file-size-guard.ts
  ```
- **Leg C: type reverse-verification of the rebuilt `.d.ts`.** A probe
`export const typeProbe8261: TranslateFn = (key: number) =>
String(key);` was planted in `file-size-guard.ts`, then `pnpm --filter
@object-ui/fields exec tsc --noEmit` was run. Exit 1 with exactly one
error, `error TS2322: Type '(key: number) => string' is not assignable
to type 'TranslateFn'.` This shows that the type `fields` resolves from
`@object-ui/i18n` is the real narrowed shape, not an `any` from an
unresolved or stale declaration.
- **Restore, proven by state.** Both paths ended with disk blob equal to
the `HEAD` blob: `ca873659cf07…` for `file-size-guard.ts` and
`600bed9be040…` for the gate. `git diff HEAD` was empty. After the run:
declarations 0, re-export 1, rows 0.

## H6: published prose

- **`packages/i18n/README.md`** did not list the package's exported
types; its API section documents functions. Per AGENTS.md commandment
objectstack-ai#2, it gains a short `### TranslateFn — typing a t you are handed`
subsection with one `ts` snippet.
- The section says the package is "the one authority for that type". It
deliberately does not say "the one place that type is declared", because
the same shape still exists under other names, such as core's
`Translate`.
- `check:readme-exports` judges `TranslateFn` as `real` from
`@object-ui/i18n`.
- The snippet was also compiled standalone with `tsc --strict` against
the built `packages/i18n/dist/index.d.ts`: exit 0. A negative control
changing `t('common.save')` to `t(42)` gave exit 2 with TS2345.
- **Pending changesets.** `git grep -l TranslateFn c659439 --
.changeset` finds one file,
`.changeset/8165-translatefn-one-authority.md`. This change makes two of
its sentences false: that `writeWarningToast` is the one authority, and
that the name is on no package's published face. Following the
objectui#10533 form:
  - both sentences are now scoped "at this change";
- a `⚠️ **Dated note, 2026-09-25 — the one authority has since moved to
@object-ui/i18n — objectui#8261.**` paragraph follows them;
- the frontmatter is unchanged: lines 1–2 have md5
`2ee28f1e1b449ccc2dd97fdcc6c2bc1f` before and after.
- **This change's own changeset** says "`writeWarningToast`, which its
sibling toast modules re-export", because on the base, among app-shell's
toast modules, only `writeWarningToast` declared the name;
`saveAdvisoryToast` and `metadataReadWarningToast` re-exported it from
there. It also keeps "the name now has one declaration", which the count
above re-derives. Its frontmatter (lines 1–5) has md5
`014eca5f59a0b36c1901fefa5467f47c` at both `367e586e4` and `b235ae53d`.
- `check:changeset-claims` lists three other pending bodies that name a
file this change touches: `6349-types-internal-name-collisions-batch-1`,
`8632-malformed-picklist-option-loud` and `9615-locale-count-ten`. I
read all three and none is falsified. Each describes its own change, and
the README heading `8632` cites still exists.

## Round 2 checks (at `b235ae53d`)

| run | result |
| :-- | :-- |
| `turbo run build --filter='@object-ui/app-shell^...' --concurrency=2`
| 28 successful, 28 total |
| `pnpm --filter @object-ui/fields type-check` (`tsc --noEmit && tsc -p
tsconfig.test.json`) | exit 0, zero `error TS` |
| `pnpm --filter @object-ui/app-shell type-check` (same pair) | exit 0,
zero `error TS` |
| `vitest run` over the one-authority gate and
`packages/app-shell/src/utils/` | the gate file has 11 of 11 tests
passed, including `declares no name twice outside the named, shrinking
baseline`. The whole run shows Test Files 35 passed, 1 skipped (36) and
Tests 559 passed, 8 skipped (567); the lock run printed `VERDICT
command-exit 0`. The skipped file is
`auditHistoryDisplay.dateOnlyZone-10183.test.ts`, which is
timezone-conditional and unrelated to this change |
| `node scripts/check-control-bytes.mjs` | OK (8784 tracked text files)
|
| `pnpm check:new-line-citations` | `VERDICT
new-cross-file-line-citations: 0 new citation(s)` |
| `node scripts/check-changeset-presence.mjs` | exit 0: 8 source files
of 3 released packages changed, 1 changeset added |
| `git merge-tree --write-tree HEAD 56b7fb4` (fresh `main`) | clean.
None of main's 151 moved paths is among this branch's 12, and main's
diff has 0 `TranslateFn` lines, so no merge was made |

## Round 1 tests and gates (all at `367e586e4`)

Heavy runs went through `os-verify-lock.sh`, and the verdicts are its
own `VERDICT` lines. Timings are shared-box seconds.

| run | result |
| :-- | :-- |
| `turbo run build --filter='@object-ui/app-shell^...' --concurrency=2`
| 28 successful, 28 total; `VERDICT command-exit 0` |
| `pnpm --filter @object-ui/i18n type-check` | exit 0, zero `error TS` |
| `pnpm --filter @object-ui/fields type-check` | exit 0, zero `error TS`
|
| `pnpm --filter @object-ui/app-shell type-check` | exit 0, zero `error
TS` |
| `pnpm type-check:scripts` (covers the gate file) | exit 0, zero `error
TS` |
| `pnpm exec vitest run` over the gate, `packages/i18n/`, app-shell
`providers/`, `preview/`, `console/home/__tests__/`,
`MetadataService.saveAdvisories`, `useMetadataClient.advisorySink`, and
the 28 fields test files naming a `file-size-guard` consumer | **Test
Files 149 passed (149), Tests 2616 passed (2616)**; `VERDICT
command-exit 0` |
| `node scripts/check-changeset-presence.mjs` | exit 0: 7 source files
of 3 released packages changed, 1 changeset added |
| `check-changeset-no-major` / `check-changeset-fixed` | exit 0 / exit 0
|
| `check-changeset-overwrite` | exit 0. Report-only; it reports the
`8165` edit as its case 2 ("correcting … on purpose"), and both sides
declare nothing |
| `pnpm check:new-line-citations` | `VERDICT
new-cross-file-line-citations: 0 new citation(s)` |
| `pnpm check:control-bytes` | OK (8784 tracked text files) |
| `check:doc-fences` / `docs:check-links` / `check:readme-exports` |
exit 0 / exit 0 / exit 0 |
| `check:phantom-deps` / `check:unused-deps` /
`check:unreferenced-sources` | exit 0 / exit 0 / exit 0 |
| `check:pending-changeset-literals` / `check:i18n-keys` /
`check:esm-specifiers` | exit 0 / exit 0 / exit 0 |
| `check-governed-queue-guard --test` on the 11 changed paths | NOT
GOVERNED |
| `eslint --no-inline-config --format json` on the 8 changed source
files | 8 files, 0 errors, 3 warnings. All 3 are pre-existing
`no-explicit-any` in `usePublishAllDrafts.ts`; the base file has the
same 3 |

**Declared narrowings**, so what was left out is visible:

- **Tests are targeted, not whole packages.** The change is type-only
(`import type` / `export type` erase at build). The full app-shell and
fields suites are CI's.
- **Lint ran on the 8 changed files, not the repository.** The file
count comes from eslint's own JSON. `eslint.config.js` has no type-aware
linting: no `projectService`, no `parserOptions.project`, and a control
grep for `typescript-eslint` in the same file fires. So this diff cannot
move the verdict on any untouched file. Repo-wide `pnpm lint` is CI's.
- **`check:doc-snippets` was NOT MEASURED locally.** It needs almost the
whole workspace built. The README snippet was instead compiled
standalone against the built `.d.ts`, with a negative control, as shown
under H6.
- **`check:readme-exports` saw 8 packages unbuilt.** Their rows are
unjudged locally. The `@object-ui/i18n` rows, including `TranslateFn`,
were judged.
- **Main at round 1 was `69a6fc1ce`.** The merge-tree was clean with
zero overlapping paths. Round 2's fresh-main reading is in the table
above.

## Acceptance notes

- **For whoever takes up objectui#8203's population:**
`packages/core/src/actions/recordDelete.ts` `Translate` can never point
at `@object-ui/i18n`, because `@object-ui/i18n` depends on
`@object-ui/core`.
- **Labels:** the card says the landing PR carries
`needs:contract-review`. This dispatch allowed no label write beyond the
PR assignee, so the seat applied it; the seat removes it at landing,
after a contract review PASS.
- objectui#8165: its `fields` half is done by construction here. The
ruling comment says that card closes on the gate's reading of the
`KNOWN_COLLISIONS` entry, so objectui#8165 remains open for the seat to
close.

⛔ Left as **draft** on purpose: the seat flips it after review.

---

_Generated by [Claude
Code](https://claude.ai/code/session_014mXUNuFomfj24w7s1pZzhN)_

---------

Co-authored-by: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants