From baf2bc6dc3260ccd76c884dd05433658da51be6f Mon Sep 17 00:00:00 2001 From: Turtle Date: Wed, 12 Aug 2026 15:41:53 +0800 Subject: [PATCH] docs: clarify missing artifact failures --- .../2026-08-12-separate-source-launch-from-build.i18n.yaml | 4 ++-- .../2026-08-12-separate-source-launch-from-build.md | 2 +- .../2026-08-12-separate-source-launch-from-build.zh.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.i18n.yaml b/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.i18n.yaml index d3d7a7f7b4..6920712a45 100644 --- a/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.i18n.yaml +++ b/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.i18n.yaml @@ -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 diff --git a/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.md b/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.md index 2562ee2b0c..d3f2d21c9b 100644 --- a/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.md +++ b/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.md @@ -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. diff --git a/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.zh.md b/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.zh.md index ea33c3815f..2cc2decd0a 100644 --- a/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.zh.md +++ b/.agents/notes/implemented/simplification/2026-08-12-separate-source-launch-from-build.zh.md @@ -29,7 +29,7 @@ TypeRT Host 产物缺失时，profile 启动会因不含构建指引的模块解 ## 影响 - 重复的源码启动无需等待完整的仓库构建，构建输出也不会与 CLI 输出混在一起。 -- 源码用户负责产物新鲜度。产物缺失时会响亮失败；已有的过期前端与 Client plugin 组合包可能静默提供旧版浏览器代码。 +- 源码用户负责产物新鲜度。产物缺失会阻止启动，但只有前端与 Client plugin 产物缺失的错误会指示用户运行 `pnpm run build`；已有的过期前端与 Client plugin 组合包可能静默提供旧版浏览器代码。 - TUI、Web 与无头模式选择、参数转发、环境继承，以及 tsx ESM 启动方式保持不变。 - 根目录上手指南与 CLI 参考将构建和启动列为独立命令，并说明过期产物行为。