docs: clarify missing artifact failures

2026-08-12 15:41:53 +08:00
parent e6d2a97645
commit baf2bc6dc3
3 changed files with 4 additions and 4 deletions
@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write .agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.md
-2026-08-12-separate-source-launch-from-build.md: 2562ee2b0c91c9eb805f409c8d2da0c6dcb8253b
-2026-08-12-separate-source-launch-from-build.zh.md: ea33c3815fc4cf02047e09bf9590d3aa6b35da09
+2026-08-12-separate-source-launch-from-build.md: d3f2d21c9bf74c699c1468f99074d88ab2138cb4
+2026-08-12-separate-source-launch-from-build.zh.md: 2cc2decd0a46bd1c30bd7113a665740dcf359947
@@ -29,7 +29,7 @@ This decision owns build scheduling only. The [tsx ESM source-launch decision](.
 ## Consequences

 - Repeated source launches do not wait for a complete repository build, and build output is not mixed with CLI output.
- Source users own artifact freshness. Missing artifacts fail loudly; existing stale frontend and client-plugin bundles can silently serve older browser code.
+- Source users own artifact freshness. Missing artifacts stop startup, but only frontend and client-plugin failures direct users to `pnpm run build`; existing stale frontend and client-plugin bundles can silently serve older browser code.
 - TUI, Web, and headless selection, argument forwarding, environment inheritance, and the tsx ESM launch vector remain unchanged.
 - The root onboarding and CLI reference show build and launch as separate commands and document the stale-artifact behavior.

@@ -29,7 +29,7 @@ TypeRT Host 产物缺失时，profile 启动会因不含构建指引的模块解
 ## 影响

 - 重复的源码启动无需等待完整的仓库构建，构建输出也不会与 CLI 输出混在一起。
- 源码用户负责产物新鲜度。产物缺失时会响亮失败；已有的过期前端与 Client plugin 组合包可能静默提供旧版浏览器代码。
+- 源码用户负责产物新鲜度。产物缺失会阻止启动，但只有前端与 Client plugin 产物缺失的错误会指示用户运行 `pnpm run build`；已有的过期前端与 Client plugin 组合包可能静默提供旧版浏览器代码。
 - TUI、Web 与无头模式选择、参数转发、环境继承，以及 tsx ESM 启动方式保持不变。
 - 根目录上手指南与 CLI 参考将构建和启动列为独立命令，并说明过期产物行为。