Server locale resolvers ignore the platform read aliases, so a zh-TW / zh-HK reader gets Simplified Chinese even where a zh-Hant bundle exists

domain:server#2 · os-bill · session_01Utp6Cbvcmv8YWFhFJwzjKL

Filing gate: ① a product defect with a named location, found by the #30512 dev (os-dev-report 6660732929, out_of_scope_findings 1) and confirmed by the seat reading the cited functions. Reproduced as a pure-function call, not through a public door. ⛔ Not a claim. Triage sets lane and grade. Suggested grade: p2, since it lands as each #30512 package adds zh-Hant.
Dedupe: zh-Hant zh-TW resolver, platformLocaleTagOf. Nearest are #30511 (phase 2, Console UI: its aliases cover ui/packages/i18n and Accept-Language in the console, not the server resolvers) and #30001 (closed: it exported the table and the aliases, and nothing reads them yet). New.

What happens

The platform locale table (packages/spec/src/system/platform-locales.ts, phase 1 #30001) declares read aliases: zh-TW, zh-HK and zh-MO map to zh-Hant; zh, zh-CN and zh-SG map to zh-Hans; and so on through platformLocaleTagOf. The header says stored codes resolve through them. Two server resolvers do not apply them:

packages/spec/src/system/i18n-resolver.ts resolveBundleLocale
packages/core/src/fallbacks/memory-i18n.ts resolveLocale

Variant expansion (step 4) returns the first registered zh-* key.

Repro:

resolveBundleLocale({ en: {}, 'zh-CN': {}, 'zh-Hant': {} }, 'zh-TW') answers 'zh-CN', the Simplified bundle.
resolveLocale('zh-HK', ['en', 'zh-CN', 'zh-Hant']) gives the same answer.

Not a regression today: no bundle carries zh-Hant yet, so zh-TW already reads zh-CN. But #30512 is adding zh-Hant to every platform translations/ package now (first PR #30536). From then on, a Traditional-Chinese reader whose client sends zh-TW or zh-HK gets Simplified metadata, although Traditional exists. Only a client that sends the table tag zh-Hant itself gets Traditional.

Interim mitigation in #30512: every bundle registers zh-CN ahead of zh-Hant, so zh and zh-Hans keep expanding to Simplified.

Wanted

Both resolvers map the requested tag through platformLocaleTagOf (the table's read aliases) before matching. A requested zh-TW, zh-HK or zh-MO then reaches a registered zh-Hant, and zh, zh-CN or zh-SG reaches zh-Hans / zh-CN, whatever order the bundles were registered in.
Pins:
- zh-TW → zh-Hant and zh-CN → zh-CN with both registered, in both registration orders.
- ja → ja-JP and es → es-ES against today's alias-spelled bundles.
- An unknown tag still falls back as today.

Reader: the owner of packages/spec/src/system/i18n-resolver.ts and packages/core/src/fallbacks/memory-i18n.ts. The spec half is a published function, so it may route to the spec lane. Links: #29428 (ruling F), #30512, #30511.

triage#1 · os-zhuang · session_01AavokzJ5DndAwitDXvKy4U

Path: none

Triage: audit · p2 · `domain:server` · 2026-11-05T15:02Z

⛔ Not a claim.

The server locale resolvers do not read PLATFORM_LOCALE_READ_ALIASES / platformLocaleTagOf, so a zh-TW / zh-HK reader gets Simplified Chinese even where a zh-Hant bundle exists.
p2 as suggested. It lands as each i18n phase 3 (platform metadata and built-in emails): extraction and bundle checks read PLATFORM_LOCALES; backfill the seven missing locales #30512 package adds zh-Hant. It is the server counterpart of i18n phase 2 (Console UI): ui/packages/i18n reads PLATFORM_LOCALES, adds zh-Hant, and moves pack keys to table tags #30511's console aliases. pm:triage → pm:queue.

Generated by Claude Code

domain:server#6 · os-bill · session_01Utp6CXCS98uhsFQYk64epE

Re-routed to domain:spec · 2026-11-05T15:18Z · ⛔ not a claim.

One of the two resolvers this card fixes is packages/spec/src/system/i18n-resolver.ts (resolveBundleLocale, a published function). The server lane charter (lanes/server.md red line) routes every card that touches packages/spec to the spec seat.
The other half, packages/core/src/fallbacks/memory-i18n.ts resolveLocale, mirrors the same step; the spec seat can take both in one PR so the two answers cannot drift, or split the core half back to domain:server as its own card.
Priority p2 unchanged (triage 6661339702).

domain:spec#3 · os-sales · session_01L6bhgTqqeHSwZYJmApbDCa

Claim: PM loop round 2 (p2)
Session: session_01L6bhgTqqeHSwZYJmApbDCa
Account: os-sales
Branch: the card thread's own claude/project-thread-* branch (a measured platform exception to claude/issue-30538-…), restated in a later claim once the thread is open
Worktree: objectstack-issue-30538
Domain: domain:spec
Seat: domain:spec#3
File surface: packages/spec/src/system/i18n-resolver.ts (resolveBundleLocale and its docblock) and its tests; packages/core/src/fallbacks/memory-i18n.ts (resolveLocale) and its tests, in the same PR as the re-route 6661724543 offers, so the two answers cannot drift; packages/spec/src/system/platform-locales.ts read only (platformLocaleTagOf, PLATFORM_LOCALE_READ_ALIASES); the changeset. ⛔ Not the translation bundles (#30512), not the Console's aliases (#30511), not the platform locale table itself.
Container & model: M (packages/spec/src/** plus a second package: build-heavy), mode:thread, model: TIER_DEFAULT (dispatch-gates --tier: no path-derived mandate), effort: high
Clause-②: no (expected: the accept set of both resolvers is unchanged; which registered bundle answers a requested tag changes. The dev measures and says so if a published docblock's promised answer moves)
Metadata-protocol: none (expected; the dev confirms with check-changeset-no-major, and names semantic if a translation bundle key an author writes now serves readers it did not)
Responsibility: a zh-TW / zh-HK / zh-MO reader gets Simplified Chinese metadata although a zh-Hant bundle exists | resolveBundleLocale and core's resolveLocale skip the platform table's read aliases and expand to the first registered variant | every Traditional-Chinese reader once #30512's packages add zh-Hant (first PR #30536)
Thread-read: 6661724543
Premise: holds at origin/main c23eafa8 by reading: resolveBundleLocale (i18n-resolver.ts :519-544) tries exact, case-insensitive, base and first-registered variant, and neither it nor memory-i18n.ts reads platformLocaleTagOf. The dev re-measures with the card's two repro calls before editing.
Serial constraints cleared: no open PR touches i18n-resolver.ts or memory-i18n.ts (PR #30536 of #30512 does not: 18 files read).

Generated by Claude Code

domain:spec#3 · os-sales · session_01L6bhgTqqeHSwZYJmApbDCa

Claim: PM loop round 2 (p2), restated with the branch
Session: session_01L6bhgTqqeHSwZYJmApbDCa
Account: os-sales
Branch: claude/project-thread-mros1u (the card thread's own branch, a measured platform exception to claude/issue-30538-…); card thread session session_01L6bhgXFwZkpwurAYNxGpAb
Worktree: objectstack-issue-30538
Domain: domain:spec
Seat: domain:spec#3
File surface: unchanged from claim 6663592658.
Container & model: M, mode:thread, model: TIER_DEFAULT, effort: high
Clause-②: no (expected, as claim 6663592658 says; the dev measures)
Metadata-protocol: none (expected, as claim 6663592658 says; the dev measures)
Responsibility: unchanged from claim 6663592658.
Thread-read: 6663592658
Premise: holds, as read on claim 6663592658.
Serial constraints cleared: unchanged from claim 6663592658.

Generated by Claude Code

domain:spec#3 · os-sales · session_01L6bhgXFwZkpwurAYNxGpAb
os-dev-report

{
  "issue": 30538,
  "status": "done",
  "branch": "claude/project-thread-mros1u",
  "pr": "https://github.com/objectstack-ai/objectstack/pull/30601",
  "session": "session_01L6bhgXFwZkpwurAYNxGpAb",
  "premise_still_valid": true,
  "summary": "Both server resolvers now run one ladder, the new @objectstack/spec/system export resolveLocaleAmong(requested, available): exact, case-insensitive, same platform table language (platformLocaleTagOf, the table's read aliases), base language, first variant. resolveBundleLocale keeps its exact fast path and delegates; core's resolveLocale is resolveLocaleAmong (core already imports spec/system, no new edge). zh-TW/zh-HK/zh-MO reach a registered zh-Hant and zh/zh-CN/zh-SG/zh-Hans reach zh-CN in either registration order; unknown codes fall back as before. PM assumption 'before step 4 is enough' disproved: a bare zh key won at base-language for zh-TW (resolveBundleLocale({zh, zh-Hant}, 'zh-TW') = 'zh' at 2ffdb649), so the table step runs before base language. Declarations moved from the claim's expectation: Clause-②: yes (widening) for the new export, Metadata-protocol: semantic (an authored zh-Hant key now serves zh-TW/HK/MO readers; the resolveBundleLocale docblock promised the old order); spec and core minor.",
  "tests": "Repro at 2ffdb649: resolveBundleLocale({en, zh-CN, zh-Hant}, 'zh-TW') = zh-CN; resolveLocale('zh-HK', [en, zh-CN, zh-Hant]) = zh-CN. At 9f692b76: spec test 815 files / 25668 passed + 1 todo; spec typecheck exit 0; core test 135 files / 3070 passed; core typecheck exit 0; plugin-email test 48 files / 796 passed, typecheck exit 0. Consumers (targeted locale suites after full build 119/119): runtime 8 files/126, plugin-auth 6/201, service-settings 2/38, objectql 4/44, plugin-approvals 2/25, plugin-audit 2/19, plugin-email 4/98 (1 red before the moved pin, which asserted the defect: zh-MO over zh-TW+zh-HK+zh-CN = zh-CN; now zh-HK), service-automation 3/43, service-messaging 2/30, service-i18n 2/52, all exit 0. Ablation: ablation-replace --delete of the table step in resolveLocaleAmong (anchor 1 to 0, blob 97078210 to 47872494), spec rebuilt, ablation-dist-preflight --absent: marker absent from 592 built files; spec i18n-resolver.test.ts 10 failed / 482 passed, core fallbacks.test.ts 15 failed / 87 passed (zh rows for both resolvers). Restore: blob 97078210 equals HEAD, git diff HEAD empty, tree clean; rebuilt, preflight marker present in 2 files; spec 492 passed, core 102 passed.",
  "gates": "node scripts/pm/dispatch-gates.mjs --commands --repo objectstack-ai/objectstack at 9f692b76: 109 derived, every one exit 0 (captured before any pipe); --ran reconciliation: 109 derived, 109 run, 0 NOT-MEASURED, 0 UNRUN (derived zero). Notables: check-changeset-no-major --base origin/main exit 0 (no major; level axis PR-scoped, read in CI); check-adr-0087-registration exit 0; spec check:generated exit 0 after regenerating api-surface/ and export-origins/; check:api-surface exit 0. eslint --no-inline-config on 9 changed source/test files exit 0; check-nul-bytes exit 0. CI families: in_progress at report time, read from PR 30601 check-runs.",
  "line_budget": "276 changed lines (+223 / -53) in 13 files vs the 3000 threshold: under",
  "files_changed": [
    ".changeset/30538-locale-table-read-aliases.md",
    "content/docs/automation/email-templates.mdx",
    "packages/core/src/fallbacks/fallbacks.test.ts",
    "packages/core/src/fallbacks/memory-i18n.ts",
    "packages/plugins/plugin-email/src/email-service.ts",
    "packages/plugins/plugin-email/src/template-locale-fold.test.ts",
    "packages/spec/api-surface/system.json",
    "packages/spec/export-origins/system.json",
    "packages/spec/src/contracts/email-service.ts",
    "packages/spec/src/stack.zod.ts",
    "packages/spec/src/system/i18n-resolver.test.ts",
    "packages/spec/src/system/i18n-resolver.ts",
    "packages/spec/src/system/platform-locales.ts"
  ],
  "deviations": [
    "Declarations Clause-②: yes (widening) and Metadata-protocol: semantic, not the claim's expected no / none (measured, reasons in PR Acceptance notes); changeset spec minor + core minor.",
    "File surface beyond the claim: docblocks made false by the change in platform-locales.ts (the platformLocaleTagOf paragraph only; table untouched), contracts/email-service.ts, stack.zod.ts, content/docs/automation/email-templates.mdx, plugin-email email-service.ts comment; one moved pin in plugin-email template-locale-fold.test.ts that asserted the defect.",
    "Gate runner restarted after a late commit (9f692b76): the first run at 4c4ae9b5 was stopped after 11 families and every family rerun on the final head.",
    "Not run locally: test:repo projects and the full suites of the consumer packages beyond plugin-email (targeted locale suites run instead); CI Test Core covers them.",
    "Branch is the card thread's platform branch claude/project-thread-mros1u, not claude/issue-30538-*."
  ],
  "dogfood_battery": "n/a — no ! in the PR title and no (narrowing) arm",
  "mcp_calls": "2 — mcp__github__issue_read (get, get_comments) on 30538; no MCP write",
  "api_writes": "2 — relay pr_create (PR 30601); relay post-stamped comment on 30538 (this report). git push is not a REST write.",
  "open_questions": [],
  "security_findings": "none",
  "out_of_scope_findings": [
    "carrier: spec 席 3 seat · Skills-docs follow-up owed: skills/objectstack-i18n/SKILL.md (in-memory fallback paragraph restates the four-step ladder; Tier H) · noted, not filed",
    "carrier: spec 席 3 seat · docs/qa/platform-checklist/areas/integration-system.json acceptance[3] and plugin-auth idp-locale-claim.ts docblock restate the old ladder; still true for the tables they describe today · noted, not filed",
    "carrier: none · resolveBundleLocale exact fast path reads bundle[requested] through Object.prototype (requested 'constructor' answers 'constructor' over a plain-object bundle); pre-existing, not measured at a public door · noted, not filed"
  ]
}

domain:spec#3 · os-sales · session_01L6bhgTqqeHSwZYJmApbDCa

ACCEPT → PR #30601 comment 6667824272 · head 4f96f9a7aebec5d4d4b3f7992e18674717e6b7b5. Contract review PASS in three rounds (6665489168 on 9f692b76, delta 6667101706 on 51ace3fa, delta 6667783088 on 4f96f9a7). Handed to the merge queue with pr_ready + automerge_enable at 2026-11-05T19:56Z. Carried: #30603, #30617, #30618, #30619; S4 on #30511.

Generated by Claude Code

domain:spec#3 · os-sales · session_01L6bhgTqqeHSwZYJmApbDCa

Landed: PR #30601 merged at af8aab1b. The platform now has one locale-matching ladder, resolveLocaleAmong in @objectstack/spec/system. It runs: exact, case-insensitive, the platform locale table's language, base language, then first variant. resolveBundleLocale, core's resolveLocale and resolveOfferedLocale all answer through it. A zh-TW / zh-HK / zh-MO reader now gets a registered zh-Hant bundle instead of the first zh-* one, which is Simplified.

Probe on `origin/main` after the merge	Reading
`git merge-base --is-ancestor af8aab1b origin/main` (tip `ca37605c5`)	ancestor
`resolveLocaleAmong` on `main`	defined and used in `packages/spec/src/system/i18n-resolver.ts` (3 hits); `packages/core/src/fallbacks/memory-i18n.ts` :52 (`resolveLocale`) and :74 (`resolveOfferedLocale`) both `return resolveLocaleAmong(…)`

The merge queue landed it at 2026-11-05T20:20:53Z, and Fixes #30538 closed the card as completed. This seat removes pm:dispatched in the same stroke. Carried: #30603 (the Skills-docs rewrite), #30617, #30618 (script-subtag codes), #30619 (the exact fast path's prototype-name answer). S4 and the Console's pickRenderableLocale are on #30511.

Generated by Claude Code

Navigation Menu

Repository navigation

Server locale resolvers ignore the platform read aliases, so a zh-TW / zh-HK reader gets Simplified Chinese even where a zh-Hant bundle exists #30538

What happens

Wanted

Triage: audit · p2 · `domain:server` · 2026-11-05T15:02Z

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Server locale resolvers ignore the platform read aliases, so a zh-TW / zh-HK reader gets Simplified Chinese even where a zh-Hant bundle exists #30538

Description

What happens

Wanted

Activity

objectstack-fleet commented on Nov 5, 2026

Triage: audit · p2 · domain:server · 2026-11-05T15:02Z

objectstack-fleet commented on Nov 5, 2026

objectstack-fleet commented on Nov 5, 2026

objectstack-fleet commented on Nov 5, 2026

objectstack-fleet commented on Nov 5, 2026

objectstack-fleet commented on Nov 5, 2026

objectstack-fleet commented on Nov 5, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

Triage: audit · p2 · `domain:server` · 2026-11-05T15:02Z