缺陷:Setup 导航缺「Packaged automation」入口 —— objectui 页面已合并,framework nav contribution 从未落地(ADR-0126 §7.4,验收卡 A1 必失败)

[baozhoutao]

现象

ADR-0126 的 Setup「打包自动化」页面在 objectui 侧已完整合并,但 objectstack 侧没有任何 nav contribution 指向它。stock 启动下 Setup 侧边栏不出现该页面,唯一可达方式是手输 URL:

/apps/setup/component/automation/packaged

验收卡 #12438 的 A1(入口)因此必然失败;文档 content/docs/build-without-code.mdx:37 已公开承诺「a dedicated packaged automation page here lets you switch it off and clone your own」—— 文档先于可达表面发布,正是 ADR-0126 §8.5 要求避免的顺序。

证据(objectstack @ af56546 · objectui @ f7c52e2)

objectui 半边已就绪:

• 页面组件:packages/app-shell/src/views/setup/PackagedAutomationPage.tsx(+ PackagedActionsSection.tsx),经 objectui fix(lint): validateFormLayout 走视图容器阶梯,两条规则不再对真实 app 全盘报绿 (#6251) #6382 / fix(metadata): sys_view_definition 的「活跃行唯一」补运行时 partial UNIQUE 迁移 (#5839) #6415 合并
• 组件注册:packages/app-shell/src/services/builtinComponents.tsx:64-69,ref = automation:packaged,由 ComponentNavView 解析
• 其 nav 测试自述契约:「app navigation names a REGISTRY KEY … ⛔ No bespoke <Route> is added for this page」(PackagedAutomationPage.navContribution.test.tsx)—— 该测试只能钉住 objectui 半边,看不到 framework 半边缺失

objectstack 半边缺失:

• packages/platform-objects/src/apps/setup-nav.contributions.ts:32-171 声明 25 个 nav_* 项,无一与 automation 相关;全仓 grep automation:packaged 零命中(Setup 中唯一的 componentRef 是 :51 的 developer:packages)

不是在途工作: Epic #12150 的 L5(objectui#6301,页面)与 L6-UI(objectui#6412,动作区)均已关闭 —— nav contribution 这半边被遗漏,而非待办。

预期

GET /api/v1/meta/app?id=setup 的合并导航中存在一个 type:'component'、componentRef:'automation:packaged' 的条目;管理员从 Setup 侧边栏点击可达「Packaged automation / 打包自动化」页面。

修复方向(一处小改)

在 packages/platform-objects/src/apps/setup-nav.contributions.ts 为 Setup 增加一条 nav contribution,指向 automation:packaged(归属分组由维护者定,自动化/开发者区均可);随后 platform-core.builtin-apps-nav-render 的全目的地遍历会自动把该页纳入走查。

关联

• 验收卡 验收测试:包内元数据定制(ADR-0126)——流程/动作的停用+克隆 全链路人工确认 #12438(A1)· Epic Epic: packaged-metadata customization (ADR-0126) — flows first, v17 line #12150 · ADR-0126 §7.4 / §8.5
• 测试清单侧已有持久断言:automation.setup-packaged-automation-board 的 nav-reachability 子句(expected-fail,手输 URL 通过不得计为 pass);登记于 docs/qa/platform-checklist/FOLLOW-UPS.md §8a D16

[baozhoutao]

🔒 Claim — 维护者指示,本 session 直接开发此修复并安排 UI 测试。

• Session: session_01SKUXt6sKgAeCEtjiuwNuhq
• Branch: claude/new-session-3qgti9
• 计划:在 setup-nav.contributions.ts 增加指向 automation:packaged 的 nav 项 + 单测钉住;浏览器实测 Setup 侧边栏可达该页面。

---

Generated by Claude Code

[baozhoutao]

✅ 修复已落地并完成 UI 验证(分支 claude/new-session-3qgti9,commit 763adcde)。

改动

• SETUP_NAV_CONTRIBUTIONS 新增 nav_packaged_automation(type:'component', componentRef:'automation:packaged'),落在 group_apps 紧邻 Packages(ADR-0084 包管理属 Operate;ADR-0126 §7.4「Studio 管编辑,Setup 管运行态」)。刻意不带 requiresService:'automation'(动作开关在无自动化服务的组合上也工作,Ledger convergence: registration home + one store implementation (ADR-0126 §4/§8, maintainer-ruled) #12419)、不带 requiredPermissions(与 nav_packages 一致;写门在服务端由 manage_metadata/§5 operator gate 把守)。
• 四语言 label + source-hash 记录;setup-packaged-automation-nav.test.ts 钉住跨仓契约的 framework 半边(objectui 的 PackagedAutomationPage.navContribution.test.tsx 钉另一半);changeset(@objectstack/platform-objects patch)。

验证

• 单测:platform-objects 全套绿(含 i18n parity / tombstone / source-hash,204 tests);check:app-nav-i18n 绿(54 个合并 setup nav id × 4 locale)。
• 服务端权威:showcase 启动后 GET /api/v1/meta/app?id=setup 的合并导航含该条目(group_apps)。
• 浏览器实测(objectui main HMR console → 本服务器):管理员登录 → Setup 侧边栏出现「Packaged Automation」→ 从侧边栏点击(非手输 URL)落到 /component/automation/packaged → 页面渲染 29 条打包流程(开关 + Clone)+ 打包动作区 143 行,无 "Component not registered"。

⚠️ 一个仍开着的半边,留给维护者定夺:仓库昨天(#12347)引入的 .objectui-sha pin 种子是 190fbd01(objectui #5714),早于该页面合并(#6382/#6415)。stock 启动若挂载按此 pin 构建的 vendored console,automation:packaged 在 bundle 里不存在 —— 入口会落到 "Component not registered"。所以本修复在 objectui ≥ 9602dc8 的 console 上完整可达(已实测),而 stock 全链路还需要把 .objectui-sha bump 到 ≥ 9602dc8 并重建 console bundle(pnpm objectui:build)—— pin bump 牵动约 700 个 objectui PR 的 console 差异,不适合作为本 issue 的搭车改动,请维护者裁定 bump 时机。

---

Generated by Claude Code

[os-trump]

Triage: routed domain:engine (fix lands in packages/platform-objects/src/apps/setup-nav.contributions.ts — platform-objects is engine-lane per the lane table; the symptom being UI-visible does not move the routing), type Bug (ADR-0126 §7.4 promises the surface and content/docs/build-without-code.mdx:37 published it — declared ≠ reachable). State label pm:dispatched recorded to match the facts on the card: claimed and implemented under the maintainer direct-dispatch channel (claim comment above carries the session ID, branch claude/new-session-3qgti9, and the maintainer's instruction as provenance; commit 763adcde pushed and browser-verified). ⛔ Not a PM dispatch — no seat should re-claim or re-queue this.

For the record on the open rider: the .objectui-sha half (stock vendored console at pin 190fbd01 predates the page, so the new entry hits "Component not registered" until the pin reaches ≥ 9602dc8) is a maintainer timing decision, already put to the maintainer in the implementation report above; no separate bump card filed this round — the pin was deliberately re-seeded only yesterday (#12347), no open bump card exists to refresh, and the standing window-level backstop (pin behind + objectui queue empty) does not fire. It is flagged in the round report instead.

---

Generated by Claude Code