fix(docs): 头注措辞避开行首 import —— 生成器按行成段,MDX 把该行当 ESM 解析(Build Docs 红)

build-docs.ts 把 docblock 按行拆成独立段落,`system/environment-artifact.zod.ts`
头注中断行后有一行以 `import ` 开头,MDX/acorn 将其解析为 ESM import 语句,
`content/docs/references/system/environment-artifact.mdx` SyntaxError。改写措辞
(「so the chosen entry point can never change the shape a consumer gets」),
重生成后两个 environment-artifact.mdx 均无行首 `import `/`export `(代码围栏内
的 TypeScript Usage 示例不受影响),`pnpm --filter @objectstack/docs build`
exit 0,`check:docs` 248 文件同步。

生成器坑本体(docblock 行成段 + 行首 import 炸 MDX,#4696 家族)记入 PR 顺带
发现,不在本 PR 修生成器。

Claude-Session: https://claude.ai/code/session_0176qgxgCXTJCUv4YFLtusP9

Co-authored-by: Claude <noreply@anthropic.com>

Author: claude

content/docs/references/system/environment-artifact.mdx

@@ -11,11 +11,11 @@ THE single declaration of the environment artifact envelope (#4740,
 
 #4535 C10 — maintainer route A′). `@objectstack/spec/cloud` re-exports
 
-this file; both entry points resolve to these exact symbols, so which
+this file; both entry points resolve to these exact symbols, so the
 
-import path a consumer picks can never change the shape it gets
+chosen entry point can never change the shape a consumer gets (the
 
-(the #4411 dual-source trap, closed for this name).
+#4411 dual-source trap, closed for this name).
 
 Describes the response shape of
 

packages/spec/src/system/environment-artifact.zod.ts

@@ -10,9 +10,9 @@ import { ObjectStackDefinitionSchema } from '../stack.zod';
  *
  * THE single declaration of the environment artifact envelope (#4740,
  * #4535 C10 — maintainer route A′). `@objectstack/spec/cloud` re-exports
- * this file; both entry points resolve to these exact symbols, so which
- * import path a consumer picks can never change the shape it gets
- * (the #4411 dual-source trap, closed for this name).
+ * this file; both entry points resolve to these exact symbols, so the
+ * chosen entry point can never change the shape a consumer gets (the
+ * #4411 dual-source trap, closed for this name).
  *
  * Describes the response shape of
  * `GET /api/v1/cloud/environments/:environmentId/artifact` — the assembled