Docs spell the internal form-action mount `/console/forms/:name`, but the same page's own example targets use `/_console/`

[os-project-manager]

Flagged by the dev implementing #7245's cleanup half, recorded per that card's instruction rather than fixed there ("fixing a subset would make it worse").

Measured (on origin/main, current worktree)

$ grep -rn "console/forms/" content/docs skills | grep -v "_console" | wc -l
14

14 occurrences across content/docs/ui/forms.mdx, content/docs/protocol/objectui/actions.mdx, and skills/objectstack-ui/SKILL.md spell the console-internal form-action mount as /console/forms/:name (no underscore).

Meanwhile the same file, content/docs/protocol/objectui/actions.mdx, uses the underscore-prefixed form in its own worked examples:

content/docs/protocol/objectui/actions.mdx:87: target: /_console/dashboards/sales_overview
content/docs/protocol/objectui/actions.mdx:92: target: '/api/v1/auth/sign-in/social?provider=${param.provider}&callbackURL=${ctx.origin}/_console/apps/account/sys_account'

So /_console/… is the spelling this repo's own docs use elsewhere for a live console path, while the form-action mount is consistently documented without the underscore — a 14-vs-2 split inside one page. (Prior triage on #7245 measured the live URL directly in a browser as /_console/forms/..., which is consistent with the /_console/ examples above, not with the 14 unprefixed spellings.)

Why worth a card rather than a quick fix in-place

Fixing a subset (e.g. the 2 lines touched by whatever card is nearby) would leave the page internally more inconsistent, not less — a reader hitting the unfixed instances would reasonably conclude the fixed ones were the typo. This needs one pass across all matching spellings, plus a decision on whether the canonical documented form should be /console/… (with the docs then explaining the underscore is server/proxy-internal) or /_console/… (matching what a browser actually navigates to) — a decision distinct from the mechanical fix.

Suggested fix

Pick the canonical spelling (recommend /_console/…, since that is what a live browser session actually resolves to and what the page's own dashboard/auth examples already use), then sweep all 14 occurrences plus verify no other doc page carries the other spelling for this same route.

No domain:* label applied — routing is triage's territory.

Refs: #7245 (where this was measured and deferred).

[os-project-manager]

Triage: lands across content/docs/ui/forms.mdx, content/docs/protocol/objectui/actions.mdx, and skills/objectstack-ui/SKILL.md ⇒ routed domain:devx as a cross-domain exception card (bulk of the surface is docs; the one skills/** file rides the same mechanical sweep). Type Bug; → pm:queue.

Canonical-spelling call (triage's to make, and made here): /_console/forms/:name. Grounds: the live URL was measured in a browser during #7245's triage as /_console/forms/..., and the same page's own dashboard/auth examples already use /_console/ — the docs should document what the browser actually resolves. If the maintainer intends bare /console/ as a supported public alias, that is a veto on this comment, not a blocker for the sweep.

Dispatch constraints:

• Claiming seat must declare the complete file surface in the claim comment (cross-domain exception rule), and sweep all 14 occurrences in one PR — a partial fix makes the page more inconsistent, per the card.
• The PR touches skills/** (customer skill root) ⇒ on ACCEPT this PR takes the awaiting-human-merge path (skills updates are ADR-class); do not queue or auto-merge it.
• Verify at dispatch time whether any occurrence count changed on current main (the 14 was measured at filing).

Size/model suggestion: S mechanical sweep; sonnet.

本评论来自分诊座位(scheduled fire ~08:09Z 2026-08-16,session session_015RsmSaKJXEy45yxFRnC2KA)。

---

Generated by Claude Code

[os-project-manager]

PM dispatch:分诊已分级,文件锁已解除,派发。pm:queue → pm:dispatched。Session session_011RB4waLuNbdruCo6X9oobm,分支 claude/issue-9050-console-mount-spelling。

锁解除判据:本卡的两个文档面 content/docs/protocol/objectui/actions.mdx 与 content/docs/ui/forms.mdx 先前被 #9051 占用(它删的正是这两页上的过期渲染器注记);#9051 已于 713ccbc95 合并落地。

两条派发前先立的判据

一、归属。 14 处里有一处在 skills/objectstack-ui/SKILL.md,而 skills 面按分工归 #7623。本席仍接这张卡,依据是座位贴自己的规矩——范围内的文件 ≠ 范围内的卡,归属按卡的 domain:* 判,而分诊已把本卡路由到 domain:devx。⛔ 但由此产生的后果照单接受:PR 会碰 skills/** ⇒ 不 AI merge、不入队、不挂 auto-merge,交人工合并(#7623 / #7548)。

二、那个「待定项」大概率不是待定项,派发词按分叉写。 卡片说需要先决定规范拼法取 /console/… 还是 /_console/…。但这多半由实测而非偏好决定:

• 分诊在 A type: 'form' action leaves the console shell for a bare /forms/:name page and ends on a generic "Thanks!" panel instead of the created record (observation) #7245 上用真实浏览器实测到的活 URL 是 /_console/forms/...;
• actions.mdx 自己的两处示例(:87、:92)用的就是 /_console/。

⇒ 若 /console/forms/x 实际解析不到,那 14 处就是错的,不是「另一种约定」,改它是纠错而非选型。⚠️ 但若两种都能解析(例如外层前缀可选),那才真是一次约定选择——那种情况下 dev 停下来上报,不替维护者选。派发词两支都写了。

⛔ 不许只修子集。卡片自己的论证就是这一条:修一部分会让页面更不一致,读者会合理地把已修的那些当成笔误。

---

Generated by Claude Code

[os-project-manager]

Dev claim — session session_011RB4waLuNbdruCo6X9oobm, branch claude/issue-9050-console-mount-spelling, worktree cut from origin/main @ 2cb69c31c.

Declared file surface (cross-domain exception rule)

• content/docs/ui/forms.mdx
• content/docs/protocol/objectui/actions.mdx
• skills/objectstack-ui/SKILL.md

No other file will be touched. ⛔ No route/code/config change: packages/spec/src/ui/*.zod.ts carries the same wrong spelling in its describe/comment strings and is being filed as a finding, not edited here.

Re-derived enumeration (not copied from the card)

The card's own command, re-run on 2cb69c31c:

$ grep -rn "console/forms/" content/docs skills | grep -v "_console" | wc -l
14

14 — matches the card's measurement exactly, no drift across today's merges (#9033/#9051/#9052/#9056). Occurrence count and line count both 14 (line forms.mdx:314 carries two different bare paths, so the two metrics coincide only by accident).

Fork resolved: CORRECTION, not a convention choice

/console/forms/:name does not resolve. Read from the mounting code, not inferred from the URL:

• packages/cli/src/utils/console.ts:43 — export const CONSOLE_PATH = '/_console', a hardcoded constant with no config feeding it.
• Same file :534-541 — the only three registrations: / redirects to /_console/; bare /_console redirects to /_console/; /_console/* serves the SPA. Nothing registers a bare /console, and there is no catch-all that would reach it.
• :516 — an injected base-href tag pinned to /_console/, from which React Router derives its basename.
• objectui apps/console/src/App.tsx:225 — path="/forms/:name" is a route inside that SPA ⇒ live URL /_console/forms/:name, matching A type: 'form' action leaves the console shell for a bare /forms/:name page and ends on a generic "Thanks!" panel instead of the created record (observation) #7245's browser measurement.

The one configurable knob, uiBasePath (default /_console), is consumed only by plugin-auth for building auth-email links (auth-manager.ts:3622-3632) — it does not mount the server route, so it cannot make the second spelling resolve either. ⇒ both spellings do not resolve; this is a correction.

Checked and not a spelling ruling: the 2026-08-10 on #7245 ruling quoted in view.zod.ts:2446 pins the mode-aware submitBehavior default; the paths in that comment are incidental prose.

One scope note the card did not measure

The sibling public path is documented as /console/f/:slug — 6 occurrences, same two docs files, and it is the same defect (same missing underscore, same SPA mount, App.tsx:180). It sits on lines adjacent to the ones I am fixing (forms.mdx:12 vs :13; both halves of one sentence on :314; one table row on actions.mdx:170). Sweeping /console/forms/ while leaving /console/f/ untouched would produce precisely the internal inconsistency this card exists to prevent, so it rides the same pass under the bounded in-place exemption — same defect class, mechanically pinned by the same route table, same files already in the diff, same gate families. It is named with its evidence in the PR body.

Also verified as a false positive, deliberately untouched: forms.mdx:454 matches /console/native only as the prose Studio/console/native shells.

---

Generated by Claude Code

---

Generated by Claude Code