refactor(i18n)!: retire the dead Packaged automation flows and Manage Objects keys - #29359

📓 Docs Drift Check

This PR changes 1 package(s): @objectstack/service-automation, touching 1 documentable anchor(s).

2 hand-written doc(s) NAME something this change touched and may need an implementation-accuracy re-verification:

• content/docs/automation/connectors.mdx (via /api/v1/automation/connectors/credential-refs (route, a path literal in a comment on a changed line))
• content/docs/kernel/cluster.mdx (via /api/v1/automation/connectors/credential-refs (route, a path literal in a comment on a changed line))

# while this PR is open — GitHub drops the merge commit once it closes
git fetch origin 24da27e0016effe8cff59cb78a3df940d57dcde5 && git checkout 24da27e0016effe8cff59cb78a3df940d57dcde5
# afterwards, rebuild it from the two parents, which stay fetchable
git fetch origin 57cde8cb3da5970f2c3f6512569cacdb9b2b06a8 ac6202e4f5ddc09d7460df964952ef4f5c4f6b51 && git checkout -B drift-repro 57cde8cb3da5970f2c3f6512569cacdb9b2b06a8 && git merge --no-ff ac6202e4f5ddc09d7460df964952ef4f5c4f6b51

node scripts/docs-audit/affected-docs.mjs --json 57cde8cb3da5970f2c3f6512569cacdb9b2b06a8

Advisory only, and a precision-first one (#9192): a page is listed because it names a
symbol, wire route or SDK method this diff touched — not because it mentions a changed
package. Each row says which anchor put it there, so a wrong row is reportable rather than
merely annoying. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs 57cde8cb3da5970f2c3f6512569cacdb9b2b06a8 → pass the list as
args.docs, on the commit named under Which tree this was computed on.

director#1 · zhuangjianguo · session_01QsR2jV5sBSzCYNEDgpYLJw

Contract-review-claim: session_01QsR2jV5sBSzCYNEDgpYLJw · head ac6202e · 2026-11-02T13:00Z

Generated by Claude Code

director#1 · zhuangjianguo · session_01QsR2jV5sBSzCYNEDgpYLJw

Contract review

Served-tier: CONTRACT_REVIEW_TIER
Head-sha: ac6202e4f5ddc09d7460df964952ef4f5c4f6b51
Local-runs: none
Scope: ui/packages/i18n/src/locales/{ar,de,en,es,fr,ja,ko,pt,ru,zh}.ts (the published TranslationKeys = typeof en, en.ts last line, re-exported by ui/packages/i18n/src/index.ts), .changeset/28789-i18n-retire-packaged-flows-keys.md, ui/packages/i18n/src/tests/dead-key-batch-retired-4730.test.ts, ui/packages/i18n/src/tests/de-quote-pairing-3876.test.ts, packages/services/service-automation/src/connector-credentials-ui.ts + every packagedAutomation.* / home.quickActions.manageObjects* / layout.systemNav.objectManager reader on main (a git grep over ui/, packages/, apps/, examples/, content/ excluding the packs and CHANGELOGs), ui/scripts/check-i18n-dead-keys.mjs (the CONFIRMED / NEEDS-REVIEW tiers), card #28789, claim 6575621235 and amendment 6575664582, AGENTS.md declaration-line and level rule

Read-only review of the committed tree (origin/main merged at 153869d7). Check-runs on the head at claim time: 10 success, 8 skipped, 41 in progress (Test Core and Test UI shards); the seat lands only on a green head, and this record is pinned to this sha.

① Derived judgments

• The narrowing is exactly the 28 keys, and none has a reader. The en.ts hunks remove 25 packagedAutomation.* leaves (12 flows-list, 13 clone-dialog), home.quickActions.manageObjects, home.quickActions.manageObjectsDesc and layout.systemNav.objectManager; the other nine packs remove the same leaves (−28 each; zh −32/+4 is the same 28 plus a rewritten group comment). My own grep on main for every removed full key finds no t() or typed reader anywhere: the only occurrences are the two pin tests this PR amends, two history comments in de-quote-pairing-3876, CHANGELOG text and the pending changeset 27378-… (a historical "new key" sentence). The bare-leaf collisions (title, subtitle, colActions, emptyTitle, loadFailed, clone) are other namespaces (ApprovalsInboxPage's tr() helper and non-i18n code), not these keys. Right.
• Every key still read survives. The leaves main reads under packagedAutomation. are the 20 of the Packaged actions page (actionsHeading, actionsSubtitle, actionsEmptyTitle/Body, actionsLoadFailed, actionToggleLabel, actionOff*, colAction, colObject, colActivation, switchedOn/Off, toggleFailed(Http), refresh, on, off, cancel); all 20 are present in en.ts at the head. The surviving set equals the read set, with nothing read removed and nothing dead kept under the prefixes. Right.
• Public surface: @object-ui/i18n's exported TranslationKeys loses 28 nested keys. A string-typed t('…') keeps compiling and echoes the key; a typed index (TranslationKeys['packagedAutomation']['cloneCreated']) fails with TS2339, which the dev measured on a rebuilt dist. That is the declared (narrowing); the runtime contract (fallback to key) is unchanged. Right.
• namespaces/studio carries none of these keys, so no second pack moves. Right. No security-relevant finding; nothing withheld from this record.

② Semver level

• Changeset: @object-ui/i18n patch, refactor(i18n)!:, BREAKING banner, Clause-②: yes (narrowing) and Metadata-protocol: none at line start in the changeset and the PR body. Under the repo's level rule (a non-protocol change, widening or breaking, ships patch with its BREAKING banner), patch is the required grade. Right.
• The migration the rule demands for a removed export is present: the FROM → TO table lists all 28 keys, each with "none" and the one-line fix (delete the reference), and the surviving set is named. Right.
• ADR-0087 disposition: not-required (runtime-interface-only ui/packages/i18n/src/locales/en.ts#TranslationKeys) with the reason (no Zod schema, no spec declaration, no stored metadata reads the key type; the compiler is the channel). Correct class: no authorable spec key or stored document names these keys, so no D2 conversion or D3 entry is owed. Right.

③ Boundary flags

• Tier S, no governed path; the seat's ACCEPT lands it after a green head and this record. The 维护者速读 says the maintainer owes nothing, which is right for Tier S.
• Option A (retire the 7 NEEDS-REVIEW keys with the 21 CONFIRMED ones) — the seat's amendment 6575664582. Verified above: each of the seven's footprint is history text or a pin, never a reader. Taking them now avoids a second narrowing later. Accepted.
• Pending changeset 27378-packaged-automation-not-running-switch.md still says "new key packagedAutomation.notRunningDeploymentPolicy". It describes that PR's own change truthfully and ships in the same release as this removal; editing a pending changeset one did not add would trip check-empty-changeset, and this one is not false. Observation only; no action.
• Dev deviations: the main merge brought other key additions and touched none of the 28 (dead-key count under the prefixes still 0 at the head); the reverse TS2339 probe was deleted and the tree left clean. No open questions.

④ Design judgment

ui/packages/i18n/src/locales/en.ts (and the nine sibling packs) — judged against the readers on main and the dead-keys gate.

• The cut is along the retired screens' boundary, not along a prefix: packagedAutomation keeps the actions half intact and the shared keys (refresh, cancel, on, off, toggleFailed(Http)) that the actions page reads, so the group's reader set is unchanged. Break attempt: remove the whole group — the Packaged actions page would lose 20 live keys; the diff does not do that. Holds.
• The group comment is rewritten to describe what remains (actions page; flows half retired into Studio's Automations pillar, ADR-0146 D11) and drops the "both sections" and clone sentences that would now be false; the ADR-0126 §9 no-drift-wording rule and the *Failed* fallback note are kept. zh carries the same rewrite; the other eight packs' translator notes are untouched, which is right (they are terminology notes, not structure). Holds.
• Pack parity: the all-locales-key-parity and en-zh-key-parity pins hold the ten packs to one key set, so a pack that missed a removal would red; −28 in each of nine packs matches en. Holds.

The two amended pins — judged against what they pin.

• dead-key-batch-retired-4730: the two rows leave SURVIVING because the keys no longer exist; the pin's remaining rows are unchanged, so it still proves the fix(convention): 持久性降级记 error 而非 warn —— 把 #4460 定成规则,并给规则装上机械检查 (#4632) #4730 batch's survivors. de-quote-pairing-3876: 104 → 103 with a history line in both assertions, because cloneCreated's German value held one „{{name}}“ pair; the durable identity close === open + rdq is untouched. Both are pins on the removed keys, not on behaviour. Holds.

connector-credentials-ui.ts — comment only; the new wording names the entry and component ref that exist on main (automation:packaged-actions). Holds.

No must-fix found. No should-fix.

Implemented-by: claude/project-thread-o2wykx
Reviewed-by: session_01QsR2jV5sBSzCYNEDgpYLJw

VERDICT: PASS

Generated by Claude Code

domain:ui#5 · zhuangjianguo · session_01QsR2jQjvWkZ7is6GXbC6DB

席位核对 — ACCEPT · domain:ui#5 · head ac6202e4 · 2026-11-02T13:16Z

• 形态: draft PR on main, titled with !. The body has Fixes #28789 on its own line and no other card number next to a closing keyword. 14 files, +45/−327, Tier S: check-governed-merges --pr 29359 finds no governed path and 372 lines, under the 3000 limit. The body carries 维护者速读 and both declaration lines (Clause-②: yes (narrowing), Metadata-protocol: none), matching claim 6575621235.
• 前提实测: at origin/main 39951d2a, check-i18n-dead-keys named 28 keys under the card's three prefixes, and both parent PRs (feat(setup): retire Packaged automation's flows half; Packaged actions is its own Setup entry #28785, feat(setup): Setup's metadata pages open Studio's All metadata area; the catalog's Active switch moves to each item's page #28818) had merged (seat read, claim; os-dev measurement on the card). At the head none remain: 345→317 candidates, exactly −21 CONFIRMED and −7 NEEDS-REVIEW. A reverse probe on the rebuilt dist gets TS2339 on a removed key, while a surviving key compiles.
• diff read: each of the ten packs loses exactly the 28 keys. en/zh keep the Packaged actions page's own leaves (refresh, actionsHeading, colActivation, on/off, toggleFailed*, actions*/switched*/actionOff*), and their group comments now describe that page. Two pins follow under amendment 6575664582: 4730 loses two SURVIVING rows, and the de-quote census goes from 104 to 103 with a history line. The connector-credentials-ui.ts change is comment only. The changeset is a BREAKING patch with the removed-key table and ADR-0087 not-required (runtime-interface-only … TranslationKeys).
• 门禁 check-runs (pinned to head ac6202e4f5ddc09d7460df964952ef4f5c4f6b51): 55 success, 8 skipped, 0 failed, 0 pending. mergeable_state clean. Dev local gates: 63 derived, all exit 0; --ran 0 NOT-MEASURED. Dogfood battery for the ! title: 391 files passed, 0 failed.
• Contract review: director CONTRACT_REVIEW_TIER review, VERDICT PASS, comment 6577754517 on this head (claim 6577706974). It has no must-fix and no should-fix, and it independently confirms that no reader of the 28 keys exists on main and that all 20 surviving leaves remain.
• 接受的偏差: the comment edit spans lines 11–12 (one sentence). The director noted that the pending changeset 27378-… still names packagedAutomation.notRunningDeploymentPolicy as new. It is truthful about its own PR and ships in the same release, so it stays.
• 范围外去向: none reported.
• 落地条款: narrowing with a same-head PASS. Locale packs are shared with in-flight PRs, and the queue serialises them. Land by pr_ready + automerge_enable.