Uh oh!
There was an error while loading. Please reload this page.
docs(cli): drop phantom os codemod v2-to-v3 and stale projects/ tree node - #10929
Conversation
…node Fixes#10881 Remove the "Code Transforms" table row and the codemod/v2-to-v3.ts source-tree node, neither of which has ever been registered (probed against the built binary: exit 2 "command codemod:v2-to-v3 not found"). Rename the projects/ tree node to environments/, matching the v5.0 project -> environment rename (ADR-0006). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019bmVFqoQPq63zhKrxdYG1r
📓 Docs Drift CheckNothing in this diff resolved to a documentable surface (no symbol, route or SDK anchor derived from 1 changed package(s)), so this run has no opinion about the docs. What this run could not see
Coarse fallback — 23 page(s) merely mention a changed package (the pre-#9192 predicate, kept for the deliberately-wide backstop): |
Uh oh!
There was an error while loading. Please reload this page.
⛔ merge queue 构建失败 — 先分诊,再决定要不要重排队列构建 32514159360 红了。队列跑的是全量套件(PR 侧 CI 只跑 affected 子集), 失败的 job(日志抽取,best effort):
跨 PR 相同签名(24h,按失败测试文件聚合):
历史信号:
分诊清单:
Generated by Claude Code · merge-queue-triage workflow (#4859) |
Fixes#10881
What changed
packages/cli/README.mdis this package's published README, and it carried two false claims in the same block.1. The phantom
os codemod v2-to-v3command. Removed the whole### Code Transformstable (its one row) and the matchingcodemod/v2-to-v3.tsnode from the Architecture source-tree listing. Neither the command nor the file has ever existed:packages/cli/src/commands/has nocodemod/directory, and probed against the built binary:Chose removal over "not yet available" — the one judgement call the card left open, and I want to be explicit about why: the only concrete plan in this space is #9591 (
os migrate meta --write,pm:on-hold, targeting v18), and it is a differently-named, differently-scoped command over the mechanical retired-key set, not a "v2 config to v3 format" transform. So there is no accurate future command to point a kept row at — a row that plainly said "not available yet" would still misdescribe what eventually ships. The "not yet available" information already lives incontent/docs/protocol/backward-compatibility.mdx:134anddocs/DX_ROADMAP.md:127, so nothing is lost by dropping it here; this brings the package README in line with the tool itself, which lost the same false prescription in #10882.2. Stale
projects/tree node. The same tree listing showed aprojects/directory undersrc/commands/withlist.ts/show.ts/create.ts/switch.ts/bind.ts. Renamed toenvironments/, matching the v5.0project→environmentrename (ADR-0006, no aliases) and the real directory — the subcommand file list itself was already accurate and is unchanged.Changeset
.changeset/cli-readme-drop-phantom-codemod.md—@objectstack/clipatch. Precedent for a README-only doc fix getting a patch changeset:.changeset/published-readme-relative-target-existence.md,.changeset/hono-server-readme-kernel-bootstrap.md.Out of scope (filed separately)
While sanity-checking the tree listing against the real directory, found three more
os projectsmentions in this same README outside the tree listing (:75alias claim,:98"legacy path" claim,:278Typical Workflow step) — none backed by a registered oclif alias. Filed as #10927 rather than swept into this PR, per the card's fence against expanding into a full listing audit.Tests
Docs-only; no
packages/cli/src/**touched. Gate set re-derived withnode scripts/pm/dispatch-gates.mjs(no path args) against this diff — commands and pass/fail evidence in the PR-report comment on #10881.Generated by Claude Code
Generated by Claude Code