[skills-path 人工合并] docs(skill): dogfood §2 — a drifted console dist now refuses to boot (#7752)

[huangyiirene]

Part of #7752 — runner-doc companion to #7783. Not Fixes: the issue closes with the guard, not with this note.

Why it is its own PR

.claude/skills/** and skills/** changes are ADR-level and merge through the human channel (maintainer ruling, 2026-08-11). Carrying this nine-line note inside #7783 would hold the entire guard — code, tests, changeset — behind that channel. Split so each moves at its own speed. Diff is one file, nine added lines, no code.

What it says, and why it is needed

#7783 makes os dev refuse to mount /_console when packages/console/dist/.objectui-sha provably differs from the repo's .objectui-sha pin, so a stale bundle is unreachable rather than silently authoritative.

That changes what a runner sees: /_console/ 404s, / stops redirecting to it, and the banner advertises no Console URL. Without this note it reads as a product bug. The skill's §2 already warns that the vendored console may be stale — what it could not say, until now, is that the 404 is the guard talking. So §2 gains:

• what the refusal looks like, and that it is a precondition to fix, not a defect;
• the fix — pnpm objectui:build (rebuild at the pinned SHA), with objectui:refresh named as the wrong turn, since it re-bumps the pin to the local ../objectui HEAD;
• pnpm check:console-sha for the same comparison without booting;
• OS_ALLOW_CONSOLE_DRIFT=1 for a deliberate stale boot — with the consequence stated, that every console observation then describes a commit the repo does not pin.

The RUNNER.md trap-table row saying the same thing from the checklist side stays in #7783 (docs/qa/** is not on the human-merge path).

Sequencing

This note describes behaviour that only exists once #7783 lands, so it reads as a promise until then. Landing it after #7783 keeps the skill honest; landing it before is harmless — the drift condition it describes is rare and the remediation it names is correct either way.

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Aug 11, 2026 7:39pm

[os-zhuang]

Review (skills seat): content verified — awaiting a human merge (#7548)

• Provenance: transferred into this seat's human-merge channel by the devx seat's cross-seat notice on [PM seat] skills — 🟢 os-zhuang #7623 (2026-08-11 19:52Z); the devx seat holds no further writes here.
• Diff: exactly one file, .claude/skills/dogfood-verification/SKILL.md, +9 lines, no code.
• Content verified against fix(cli): refuse to serve a drifted vendored console under os dev (#7752) #7783's MERGED diff, not this PR's own claims: the remediation (pnpm objectui:build), the labelled wrong turn (objectui:refresh re-bumps the pin to local ../objectui HEAD), pnpm check:console-sha as the boot-free comparison, and the OS_ALLOW_CONSOLE_DRIFT=1 escape hatch all match the merged implementation (decideConsoleMount / formatConsoleShaDriftRefusal in packages/cli/src/utils/console.ts). The described symptoms (/_console/ 404s, root stops redirecting, banner advertises no console URL) match fix(cli): refuse to serve a drifted vendored console under os dev (#7752) #7783's end-to-end verification table.
• No duplication: fix(cli): refuse to serve a drifted vendored console under os dev (#7752) #7783's merged file list contains no .claude/skills/** path — the split held; the RUNNER.md trap-table row landed there, and this §2 note is the only home of the skill-side text.
• Sequencing satisfied: fix(cli): refuse to serve a drifted vendored console under os dev (#7752) #7783 merged 2026-08-11 20:07Z, so the note now describes live behavior — the body's "reads as a promise until then" caveat is moot.
• CI: ESLint and TypeScript Type Check conclusions = success. The single red (Check Changeset) was the expected .claude/-only shape — skip-changeset applied (read back, survived Auto Label) and the failed job re-queued.

Terminal state per #7548: skills-root PR — stays draft, visibly hanging; the maintainer reviews and merges by hand. This seat's round reports carry it on the "awaiting a human merge" line until then.

---

Generated by Claude Code

[os-zhuang]

同意合并