Skip to content

Commit 8bcd054

Browse files
claude[bot]claude
andauthored
docs(qa): retire the resolved codemod row in FOLLOW-UPS §7b (#11656)
The row listed the `objectstack codemod v2-to-v3` prescription as outstanding work and named `os migrate meta` as "the real path". PR #10882 landed the opposite reading on the record: nothing registered auto-fixes these patterns, so the hint now prescribes no command at all, and the repoint was argued down in a comment at doctor.ts:2258-2282 with a test pinning the refusal. The row is amended in place, matching how D1 was retired in this same file (e1e7629): the claim is rewritten to the resolved state, the resolution is stamped with the landing PR and date, and the prescription that a landed change specifically refused is removed rather than carried forward. Also stale: the doctor.ts:2149 anchor (now an unrelated advisory block) and the "carries the expected-fail probe until then" clause, whose premise is that the string was still unfixed. The backward-compatibility.mdx:134 citation is retained but re-framed: the text still reads as quoted and is now consistent with the tool, so it is correct as written and deliberately not edited. Claude-Session: https://claude.ai/code/session_015ahemw8RcTgqtxrj15PEZx Co-authored-by: Claude <noreply@anthropic.com>
1 parent 266436a commit 8bcd054

1 file changed

Lines changed: 19 additions & 5 deletions

File tree

docs/qa/platform-checklist/FOLLOW-UPS.md

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -208,11 +208,25 @@ to the authorable-surface rows.
208208
docs should say plainly the platform performs no upload-time content inspection; the new
209209
`attachments-storage.field-accept-maxsize-server-enforced` item records the same boundary
210210
on the QA side.
211-
- **Dead remediation prescription in a live command**`doctor.ts:2149` prints "Run
212-
`objectstack codemod v2-to-v3` to auto-fix"; no `codemod` command exists (the real path
213-
is `os migrate meta`), and `content/docs/protocol/backward-compatibility.mdx:134` admits
214-
it. Fix the string; the new `cli.doctor-deprecation-scan` item carries the expected-fail
215-
probe until then.
211+
- **Dead remediation prescription in a live command — FIXED in #10882 (closing #10680),
212+
2026-08-21.** `doctor.ts` used to print "Run `objectstack codemod v2-to-v3` to auto-fix";
213+
no `codemod` command has ever been registered. At head the print site
214+
(`doctor.ts:2283-2288`) prescribes **no** command — it says no automated codemod ships
215+
with the CLI and routes the operator to the `→ replacement` already computed per finding,
216+
and `packages/cli/src/commands/doctor-deprecation-hint-commands.test.ts` pins the class so
217+
a future phantom prescription fails there rather than shipping. **A repoint at
218+
`os migrate meta` was considered and REFUSED**: its subject is an authored stack config,
219+
its header declines the AST rewrite as "unsafe and lossy", both its writes are `--out`
220+
JSON snapshots, and three of the eight `DEPRECATED_PATTERNS` are not metadata at all —
221+
reasoning at `doctor.ts:2258-2282`, refusal pinned at that test's `:199`. An earlier
222+
wording of this row prescribed that repoint; it is retracted, and it is what seeded the
223+
same suggestion in #10680 for #10882 to argue down — do not re-derive it.
224+
`content/docs/protocol/backward-compatibility.mdx:134` still records the codemod as "not
225+
yet available", but at head that is **consistent** with the tool rather than the
226+
contradiction this row cited it for: correct as written, deliberately not edited (#11420,
227+
and again here). The interim probe this row pointed at
228+
(`cli.doctor-deprecation-scan`'s expected-fail clause) is refreshed to a positive
229+
assertion in #11638.
216230
- **`metadata-service.mdx:188`** presents `eager` bootstrap as "Scans filesystem … at
217231
boot (default)"; no shipped boot path scans (`watch` defaults false, `os dev` disables it
218232
explicitly). Stop advertising the scan as default behavior.

0 commit comments

Comments
 (0)