helloagents 3.0.19 → 3.0.21-beta.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.19",
+  "version": "3.0.21-beta.1",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.19",
+  "version": "3.0.21-beta.1",
   "description": "HelloAGENTS — Quality-driven orchestration kernel for AI CLIs with intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/README.md

@@ -8,7 +8,7 @@
 
 **A workflow layer for AI coding CLIs: skills, project knowledge, delivery checks, safer config writes, and resumable execution.**
 
-[![Version](https://img.shields.io/badge/version-3.0.19-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.21-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](./package.json)
 [![Skills](https://img.shields.io/badge/skills-14-6366f1.svg)](./skills)
@@ -116,7 +116,7 @@ Commands run inside the AI CLI chat with a `~` prefix. The command skill is read
 | `~prd` | Modern product requirements document through guided dimension-by-dimension exploration |
 | `~loop` | Iterative improvement with metric, guard command, keep/revert decisions |
 | `~wiki` | Create or sync only the project knowledge base |
-| `~init` | Full project bootstrap: knowledge base plus project-level rule files and package-root links |
+| `~init` | Full project setup: knowledge base plus project-level rule files and package-root links |
 | `~test` | Write tests for a target module or recent change |
 | `~verify` | Review, run verification commands, fix failures, and close out |
 | `~commit` | Generate a conventional commit message and sync knowledge |
@@ -187,8 +187,10 @@ Long tasks need a small recovery snapshot, but one shared state file is not safe
 
 HelloAGENTS now resolves the current state file from `state_path`:
 
-- with a stable session id: `.helloagents/sessions/<branch>/<session>/STATE.md`
-- without a stable session id: `.helloagents/sessions/<branch>/default/STATE.md`
+- with a stable session id: `.helloagents/sessions/<workspace>/<session>/STATE.md`
+- without a stable session id: `.helloagents/sessions/<workspace>/default/STATE.md`
+
+`<workspace>` is the current Git branch, `detached-<sha>` for a detached HEAD, or `workspace` for non-Git projects. `.helloagents/sessions/active.json` only records the active session index.
 
 `STATE.md` records where the current workflow stopped. It is not a universal memory file for every conversation.
 
@@ -198,13 +200,16 @@ HelloAGENTS does not treat “tests passed” and “task complete” as the sam
 
 Runtime evidence files include:
 
-- `.helloagents/sessions/<branch>/<session>/capsule.json`
-- `.helloagents/sessions/<branch>/<session>/events.jsonl`
-- `.helloagents/sessions/<branch>/<session>/artifacts/review.json`
-- `.helloagents/sessions/<branch>/<session>/artifacts/advisor.json`
-- `.helloagents/sessions/<branch>/<session>/artifacts/visual.json`
-- `.helloagents/sessions/<branch>/<session>/artifacts/closeout.json`
-- `.helloagents/sessions/<branch>/<session>/artifacts/loop-results.tsv`
+- `.helloagents/sessions/<workspace>/<session>/capsule.json`
+- `.helloagents/sessions/<workspace>/<session>/events.jsonl`
+- `.helloagents/sessions/active.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/review.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/advisor.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/visual.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/closeout.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/loop-results.tsv`
+
+Delivery gate, guard, and loop messages use action-oriented wording such as processing path, closeout action, and visual validation action, so blocked flows show what to do next without turning executable steps into optional suggestions.
 
 ### 7) Safer install, update, cleanup, and diagnostics
 
@@ -268,7 +273,7 @@ For knowledge base only:
 ~wiki
 ```
 
-For full project bootstrap:
+For full project setup:
 
 ```text
 ~init
@@ -496,10 +501,11 @@ When `project_store_mode = "repo-shared"`:
 Runtime state and evidence remain local to the working project:
 
 - `state_path`
-- `.helloagents/sessions/<branch>/<session>/capsule.json`
-- `.helloagents/sessions/<branch>/<session>/events.jsonl`
-- `.helloagents/sessions/<branch>/<session>/artifacts/*.json`
-- `.helloagents/sessions/<branch>/<session>/artifacts/loop-results.tsv`
+- `.helloagents/sessions/<workspace>/<session>/capsule.json`
+- `.helloagents/sessions/<workspace>/<session>/events.jsonl`
+- `.helloagents/sessions/active.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/*.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/loop-results.tsv`
 
 ### Unactivated or temporary sessions
 
@@ -638,7 +644,7 @@ Codex is rules-file driven by default.
 - standby writes silent Codex hooks to `~/.codex/hooks.json`
 - standby creates `~/.codex/helloagents -> ~/.helloagents/helloagents`
 - global mode installs the native local-plugin chain and also loads silent hooks from `~/.codex/hooks.json`
-- Codex hooks only synchronize runtime state and enforce Stop gates; they do not inject bootstrap or route text through hook output
+- Codex hooks only synchronize runtime state and enforce Stop gates; they do not inject HelloAGENTS rules or route text through hook output
 - `/goal` remains Codex-native. Enable it explicitly with `helloagents codex goals enable` when long-running plan execution is needed
 - Goal-aware commands resume from `tasks.md`, `contract.json`, and `state_path`; they do not create goals automatically or mark them complete before HelloAGENTS verification and closeout
 
@@ -666,14 +672,14 @@ The current test suite covers:
 
 ### What is the role of `docs/`?
 
-`docs/` is reference material for users and AI agents. It may lag behind implementation; runtime behavior is defined by source code, bootstrap files, skills, templates, and tests.
+`docs/` is reference material for users and AI agents. It may lag behind implementation; runtime behavior is defined by source code, rule templates, skills, templates, and tests.
 
 ### Is this a CLI tool or a prompt framework?
 
 Both.
 
 - `cli.mjs` handles install, update, cleanup, diagnostics, and host config
-- `bootstrap.md` and `bootstrap-lite.md` define workflow rules
+- rule templates define the loaded workflow rules
 - `skills/` defines task-specific behavior
 - `scripts/` provides runtime helpers for routing, guard, notify, verification, state, and evidence
 
@@ -691,7 +697,7 @@ Use `~init` when you also want project-level rule files and project-level HelloA
 
 ### Do Codex hooks show injected content?
 
-No bootstrap or route text is injected through hooks. HelloAGENTS Codex hooks only write runtime state and enforce Stop gates; successful hooks stay quiet, while blocked or failed hooks show the necessary reason.
+No HelloAGENTS rule or route text is injected through hooks. HelloAGENTS Codex hooks only write runtime state and enforce Stop gates; successful hooks stay quiet, while blocked or failed hooks show the necessary reason.
 
 ### Can I turn off notifications or guard checks?
 

package/README_CN.md

@@ -8,7 +8,7 @@
 
 **面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
-[![Version](https://img.shields.io/badge/version-3.0.19-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.21-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](./package.json)
 [![Skills](https://img.shields.io/badge/skills-14-6366f1.svg)](./skills)
@@ -187,8 +187,10 @@ HelloAGENTS 可以在 `.helloagents/` 下创建和维护项目知识库。
 
 HelloAGENTS 现在只从 `state_path` 解析当前状态文件：
 
-- 宿主提供稳定会话标识时：`.helloagents/sessions/<branch>/<session>/STATE.md`
-- 宿主未提供稳定会话标识时：`.helloagents/sessions/<branch>/default/STATE.md`
+- 宿主提供稳定会话标识时：`.helloagents/sessions/<workspace>/<session>/STATE.md`
+- 宿主未提供稳定会话标识时：`.helloagents/sessions/<workspace>/default/STATE.md`
+
+`<workspace>` 是当前 Git 分支、detached HEAD 的 `detached-<sha>`，或非 Git 项目的 `workspace`。`.helloagents/sessions/active.json` 只记录当前活跃会话索引。
 
 `STATE.md` 只记录当前工作流做到哪里，不承担所有对话的统一记忆。
 
@@ -198,13 +200,16 @@ HelloAGENTS 不把“命令通过”和“任务完成”简单画等号。交
 
 运行态证据文件包括：
 
-- `.helloagents/sessions/<branch>/<session>/capsule.json`
-- `.helloagents/sessions/<branch>/<session>/events.jsonl`
-- `.helloagents/sessions/<branch>/<session>/artifacts/review.json`
-- `.helloagents/sessions/<branch>/<session>/artifacts/advisor.json`
-- `.helloagents/sessions/<branch>/<session>/artifacts/visual.json`
-- `.helloagents/sessions/<branch>/<session>/artifacts/closeout.json`
-- `.helloagents/sessions/<branch>/<session>/artifacts/loop-results.tsv`
+- `.helloagents/sessions/<workspace>/<session>/capsule.json`
+- `.helloagents/sessions/<workspace>/<session>/events.jsonl`
+- `.helloagents/sessions/active.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/review.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/advisor.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/visual.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/closeout.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/loop-results.tsv`
+
+交付门控、守卫和循环提示使用执行性表述，例如处理路径、收尾动作和视觉验收动作。阻塞流程会说明下一步要做什么，而不是把可执行步骤写成泛化建议。
 
 ### 7）更安全的安装、更新、清理和诊断
 
@@ -498,10 +503,11 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 运行态文件仍保留在当前项目本地：
 
 - `state_path`
-- `.helloagents/sessions/<branch>/<session>/capsule.json`
-- `.helloagents/sessions/<branch>/<session>/events.jsonl`
-- `.helloagents/sessions/<branch>/<session>/artifacts/*.json`
-- `.helloagents/sessions/<branch>/<session>/artifacts/loop-results.tsv`
+- `.helloagents/sessions/<workspace>/<session>/capsule.json`
+- `.helloagents/sessions/<workspace>/<session>/events.jsonl`
+- `.helloagents/sessions/active.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/*.json`
+- `.helloagents/sessions/<workspace>/<session>/artifacts/loop-results.tsv`
 
 ### 未激活或临时会话
 
@@ -640,7 +646,7 @@ Codex 默认走规则文件驱动。
 - 标准模式把静默 Codex hooks 写入 `~/.codex/hooks.json`
 - 标准模式创建 `~/.codex/helloagents -> ~/.helloagents/helloagents`
 - 全局模式安装原生本地插件流程，并同样用 `~/.codex/hooks.json` 加载静默 hooks
-- Codex hooks 只做静默运行态同步和 Stop 门禁，不通过 hook 注入 bootstrap 或路由说明
+- Codex hooks 只做静默运行态同步和 Stop 门禁，不通过 hook 注入 HelloAGENTS 规则或路由说明
 - `/goal` 保持 Codex 原生能力；需要长程执行时，用 `helloagents codex goals enable` 显式启用
 - 感知 goal 的命令从 `tasks.md`、`contract.json` 和 `state_path` 恢复；不会自动创建 goal，也不会在 HelloAGENTS 验证和收尾前标记完成
 
@@ -668,14 +674,14 @@ npm test
 
 ### `docs/` 的作用是什么？
 
-`docs/` 只作为用户和 AI 理解项目的参考材料，可能滞后于实现。运行时行为以源码、bootstrap 文件、skills、templates 和测试为准。
+`docs/` 只作为用户和 AI 理解项目的参考材料，可能滞后于实现。运行时行为以源码、规则模板、skills、templates 和测试为准。
 
 ### 这是 CLI 工具还是提示词框架？
 
 两者都是。
 
 - `cli.mjs` 负责安装、更新、清理、诊断和宿主配置
-- `bootstrap.md` 与 `bootstrap-lite.md` 定义工作流规则
+- 规则模板定义运行时加载的工作流规则
 - `skills/` 定义任务类型相关行为
 - `scripts/` 提供选路、Guard、通知、验证、状态和证据等运行时辅助能力
 
@@ -693,7 +699,7 @@ npm test
 
 ### Codex hooks 会显示注入内容吗？
 
-不会显示 bootstrap 或路由说明。HelloAGENTS 的 Codex hooks 只写运行态和执行 Stop 门禁，成功路径返回静默结果；只有阻塞或错误时显示必要原因。
+不会显示 HelloAGENTS 规则或路由说明。HelloAGENTS 的 Codex hooks 只写运行态和执行 Stop 门禁，成功路径返回静默结果；只有阻塞或错误时显示必要原因。
 
 ### 可以关闭通知或 Guard 吗？
 

package/bootstrap-lite.md

@@ -33,6 +33,7 @@
 - 不写黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
 - 不写无执行价值的客套、邀约、重复确认、能力陈述或空泛建议
 - 同一概念前后用语保持一致；先给结论再给细节，避免同义反复、重复解释和堆砌近义句
+- 优化既有约束或文案时，优先在原条目内收敛表达；只有边界独立且原条目无法承载时才新增条目，并同步删除重复表述
 
 ### 完整交付（强制）
 - 一次做完：用户需求明确且已获得执行授权时，必须持续执行到完成；只有符合下文“阻塞判定”的情况，才可中途停下
@@ -207,8 +208,9 @@
 所有文件的创建和更新必须按 templates/ 目录中对应模板的格式执行，不可自由发挥格式。
 说明：
 - `.helloagents/` 表示项目级存储路径，也是标准模式的项目激活信号
-- `state_path` 指向的状态文件、当前会话 `capsule.json`、`events.jsonl`、`artifacts/*.json`、`artifacts/loop-results.tsv` 等运行态文件始终保留在项目本地 `.helloagents/sessions/{branch}/{session}/`
-- `state_path` 是状态文件的唯一位置。宿主提供会话标识时，写入 `.helloagents/sessions/{branch}/{session}/STATE.md`；没有稳定会话标识时，写入 `.helloagents/sessions/{branch}/default/STATE.md`
+- `state_path` 指向的状态文件、当前会话 `capsule.json`、`events.jsonl`、`artifacts/*.json`、`artifacts/loop-results.tsv` 等运行态文件始终保留在项目本地 `.helloagents/sessions/{workspace}/{session}/`
+- `state_path` 是状态文件的唯一位置。宿主提供会话标识时，写入 `.helloagents/sessions/{workspace}/{session}/STATE.md`；没有稳定会话标识时，写入 `.helloagents/sessions/{workspace}/default/STATE.md`
+- `{workspace}` 为当前 Git 分支、`detached-{sha}` 或非 Git 项目的 `workspace`；`.helloagents/sessions/active.json` 只记录当前活跃会话索引，避免同一会话被拆成多个目录
 - 若 helloagents.json 中 `project_store_mode = "repo-shared"`，`context.md`、`guidelines.md`、`CHANGELOG.md`、`verify.yaml`、`DESIGN.md`、`modules/`、`plans/`、`archive/` 改按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析；未注入具体路径时，按当前存储模式自行解析，不要假定这些文件一定实际位于当前工作树中
 templates/ 查找路径（按优先级；首次确定模板根目录后，本轮复用）：
 按上文 `~command` 路由中的相同技能根目录规则确定；确定根目录后读取其中的 `templates/`。

package/bootstrap.md

@@ -33,6 +33,7 @@
 - 不写黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
 - 不写无执行价值的客套、邀约、重复确认、能力陈述或空泛建议
 - 同一概念前后用语保持一致；先给结论再给细节，避免同义反复、重复解释和堆砌近义句
+- 优化既有约束或文案时，优先在原条目内收敛表达；只有边界独立且原条目无法承载时才新增条目，并同步删除重复表述
 
 ### 完整交付（强制）
 - 一次做完：用户需求明确且已获得执行授权时，必须持续执行到完成；只有符合下文“阻塞判定”的情况，才可中途停下
@@ -273,8 +274,9 @@ hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.m
 所有文件的创建和更新必须按 templates/ 目录中对应模板的格式执行，不可自由发挥格式。
 说明：
 - `.helloagents/` 表示项目级存储路径，也是标准模式的项目激活信号
-- `state_path` 指向的状态文件、当前会话 `capsule.json`、`events.jsonl`、`artifacts/*.json`、`artifacts/loop-results.tsv` 等运行态文件始终保留在项目本地 `.helloagents/sessions/{branch}/{session}/`
-- `state_path` 是状态文件的唯一位置。宿主提供会话标识时，写入 `.helloagents/sessions/{branch}/{session}/STATE.md`；没有稳定会话标识时，写入 `.helloagents/sessions/{branch}/default/STATE.md`
+- `state_path` 指向的状态文件、当前会话 `capsule.json`、`events.jsonl`、`artifacts/*.json`、`artifacts/loop-results.tsv` 等运行态文件始终保留在项目本地 `.helloagents/sessions/{workspace}/{session}/`
+- `state_path` 是状态文件的唯一位置。宿主提供会话标识时，写入 `.helloagents/sessions/{workspace}/{session}/STATE.md`；没有稳定会话标识时，写入 `.helloagents/sessions/{workspace}/default/STATE.md`
+- `{workspace}` 为当前 Git 分支、`detached-{sha}` 或非 Git 项目的 `workspace`；`.helloagents/sessions/active.json` 只记录当前活跃会话索引，避免同一会话被拆成多个目录
 - 若 helloagents.json 中 `project_store_mode = "repo-shared"`，`context.md`、`guidelines.md`、`CHANGELOG.md`、`verify.yaml`、`DESIGN.md`、`modules/`、`plans/`、`archive/` 改按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析；未注入具体路径时，按当前存储模式自行解析，不要假定这些文件一定实际位于当前工作树中
 templates/ 查找路径（按优先级；首次确定模板根目录后，本轮复用）：
 按上文相同的技能根目录规则确定；确定根目录后读取其中的 `templates/`。

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.19",
+  "version": "3.0.21-beta.1",
   "description": "Quality-driven orchestration kernel for AI CLIs",
   "contextFileName": "bootstrap.md",
   "author": "HelloWind",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.19",
+  "version": "3.0.21-beta.1",
   "type": "module",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": "HelloWind",

package/scripts/cli-doctor-codex.mjs

@@ -92,7 +92,7 @@ function suggestCodexDoctorFix(status, trackedMode) {
 
 function appendCodexStandbyIssues(runtime, issues, checks) {
   if (!checks.carrierMarker) issues.push(buildDoctorIssue(runtime, 'standby-carrier-missing', 'standby `~/.codex/AGENTS.md` 缺少 HelloAGENTS 标记', 'Standby `~/.codex/AGENTS.md` is missing the HELLOAGENTS marker'))
-  if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue(runtime, 'standby-carrier-drift', 'standby `~/.codex/AGENTS.md` 与当前 bootstrap-lite.md 不一致', 'Standby `~/.codex/AGENTS.md` differs from the current bootstrap-lite.md'))
+  if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue(runtime, 'standby-carrier-drift', 'standby `~/.codex/AGENTS.md` 与当前标准模式规则不一致', 'Standby `~/.codex/AGENTS.md` differs from the current standby rules'))
   if (!checks.homeLink) issues.push(buildDoctorIssue(runtime, 'standby-link-missing', 'standby `~/.codex/helloagents` 链接缺失或未指向稳定运行根目录', 'Standby `~/.codex/helloagents` link is missing or points to a different runtime root'))
   if (!checks.modelInstructionsFile) issues.push(buildDoctorIssue(runtime, 'standby-model-instructions-missing', 'standby config 缺少受管 model_instructions_file', 'Standby config is missing the managed model_instructions_file'))
   if (checks.modelInstructionsFile && !checks.modelInstructionsPathMatch) issues.push(buildDoctorIssue(runtime, 'standby-model-instructions-drift', 'standby model_instructions_file 未指向受管 `~/.codex/AGENTS.md`', 'Standby model_instructions_file does not point to the managed `~/.codex/AGENTS.md`'))
@@ -108,12 +108,12 @@ function appendCodexStandbyIssues(runtime, issues, checks) {
 
 function appendCodexGlobalIssues(runtime, issues, checks, pluginVersion, cacheVersion) {
   if (!checks.carrierMarker) issues.push(buildDoctorIssue(runtime, 'global-home-carrier-missing', 'global `~/.codex/AGENTS.md` 缺少 HelloAGENTS 规则内容', 'Global `~/.codex/AGENTS.md` is missing the HelloAGENTS carrier'))
-  if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue(runtime, 'global-home-carrier-drift', 'global `~/.codex/AGENTS.md` 与当前 bootstrap.md 不一致', 'Global `~/.codex/AGENTS.md` differs from the current bootstrap.md'))
+  if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue(runtime, 'global-home-carrier-drift', 'global `~/.codex/AGENTS.md` 与当前全局模式规则不一致', 'Global `~/.codex/AGENTS.md` differs from the current global rules'))
   if (!checks.globalHomeLink) issues.push(buildDoctorIssue(runtime, 'global-read-root-link-missing', 'global `~/.codex/helloagents` 链接缺失或未指向当前插件根目录', 'Global `~/.codex/helloagents` link is missing or does not point to the current plugin root'))
   if (!checks.pluginRoot) issues.push(buildDoctorIssue(runtime, 'global-plugin-root-missing', 'global 插件根目录缺失', 'Global plugin root is missing'))
   if (!checks.pluginCache) issues.push(buildDoctorIssue(runtime, 'global-plugin-cache-missing', 'global 插件缓存目录缺失', 'Global plugin cache directory is missing'))
-  if (checks.pluginRoot && !checks.pluginCarrierMatch) issues.push(buildDoctorIssue(runtime, 'global-plugin-carrier-drift', 'global 插件根目录中的 AGENTS.md 与当前 bootstrap.md 不一致', 'Global plugin AGENTS.md differs from the current bootstrap.md'))
-  if (checks.pluginCache && !checks.pluginCacheCarrierMatch) issues.push(buildDoctorIssue(runtime, 'global-plugin-cache-carrier-drift', 'global 插件缓存中的 AGENTS.md 与当前 bootstrap.md 不一致', 'Global plugin cache AGENTS.md differs from the current bootstrap.md'))
+  if (checks.pluginRoot && !checks.pluginCarrierMatch) issues.push(buildDoctorIssue(runtime, 'global-plugin-carrier-drift', 'global 插件根目录中的 AGENTS.md 与当前全局模式规则不一致', 'Global plugin AGENTS.md differs from the current global rules'))
+  if (checks.pluginCache && !checks.pluginCacheCarrierMatch) issues.push(buildDoctorIssue(runtime, 'global-plugin-cache-carrier-drift', 'global 插件缓存中的 AGENTS.md 与当前全局模式规则不一致', 'Global plugin cache AGENTS.md differs from the current global rules'))
   if (!checks.marketplaceEntry) issues.push(buildDoctorIssue(runtime, 'global-marketplace-missing', 'global marketplace 条目缺失', 'Global marketplace entry is missing'))
   if (!checks.pluginEnabled) issues.push(buildDoctorIssue(runtime, 'global-plugin-disabled', 'global config 中缺少插件启用段', 'Global plugin enablement block is missing from config'))
   if (!checks.modelInstructionsFile) issues.push(buildDoctorIssue(runtime, 'global-model-instructions-missing', 'global config 缺少受管 model_instructions_file', 'Global config is missing the managed model_instructions_file'))
@@ -201,7 +201,7 @@ export function inspectCodexDoctor(runtime, settings) {
   if (!checks.pluginVersionMatch && !pluginVersion && detectedMode === 'global') notes.push(runtime.msg('未读到 global 插件根目录版本信息', 'Global plugin root version was not readable'))
   if (!checks.pluginCacheVersionMatch && !cacheVersion && detectedMode === 'global') notes.push(runtime.msg('未读到 global 插件缓存版本信息', 'Global plugin cache version was not readable'))
   if (detectedMode !== 'none' && !checks.codexGoalsFeature) notes.push(runtime.msg('Codex /goal 未启用；如需长程执行，可运行 `helloagents codex goals enable`。', 'Codex /goal is not enabled; run `helloagents codex goals enable` if you need long-running goals.'))
-  if (detectedMode !== 'none' && checks.legacyCodexHooksFeature) notes.push(runtime.msg('检测到旧版 `codex_hooks`；HelloAGENTS 只兼容 Codex 最新版，建议移除旧 key。', 'Legacy `codex_hooks` was detected; HelloAGENTS targets latest Codex only, so remove the old key.'))
+  if (detectedMode !== 'none' && checks.legacyCodexHooksFeature) notes.push(runtime.msg('检测到旧版 `codex_hooks`；HelloAGENTS 只兼容 Codex 最新版，请移除旧 key。', 'Legacy `codex_hooks` was detected; HelloAGENTS targets latest Codex only, so remove the old key.'))
 
   const status = summarizeDoctorStatus(issues, { trackedMode, detectedMode })
   return { host, label: runtime.getHostLabel(host), trackedMode, detectedMode, status, checks, issues, notes, suggestedFix: suggestCodexDoctorFix(status, trackedMode) }

package/scripts/cli-doctor-render.mjs

@@ -24,7 +24,7 @@ export function printDoctorText(runtime, report) {
       console.log(`  issue[${issue.code}]: ${issue.message}`)
     }
     if (entry.suggestedFix) {
-      console.log(`  suggested_fix: ${entry.suggestedFix}`)
+      console.log(`  fix: ${entry.suggestedFix}`)
     }
   }
 

package/scripts/cli-doctor.mjs

@@ -145,7 +145,7 @@ function inspectClaudeDoctor(settings) {
   }
   if (detectedMode === 'standby') {
     if (!checks.carrierMarker) issues.push(buildDoctorIssue('standby-carrier-missing', 'standby 规则文件缺少 HELLOAGENTS 标记', 'Standby carrier is missing the HELLOAGENTS marker'))
-    if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue('standby-carrier-drift', 'standby 规则文件内容与当前 bootstrap-lite.md 不一致', 'Standby carrier content differs from the current bootstrap-lite.md'))
+    if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue('standby-carrier-drift', 'standby 规则文件内容与当前标准模式规则不一致', 'Standby carrier content differs from the current standby rules'))
     if (!checks.homeLink) issues.push(buildDoctorIssue('standby-link-missing', 'standby home 链接缺失或未指向稳定运行根目录', 'Standby home link is missing or points to a different runtime root'))
     if (!checks.settingsHooks) issues.push(buildDoctorIssue('standby-hooks-missing', 'standby settings hooks 缺失', 'Standby settings hooks are missing'))
     if (checks.settingsHooks && !checks.settingsHooksMatch) issues.push(buildDoctorIssue('standby-hooks-drift', 'standby settings hooks 与当前 hooks 配置不一致', 'Standby settings hooks differ from the current hook configuration'))
@@ -194,7 +194,7 @@ function inspectGeminiDoctor(settings) {
   }
   if (detectedMode === 'standby') {
     if (!checks.carrierMarker) issues.push(buildDoctorIssue('standby-carrier-missing', 'standby 规则文件缺少 HELLOAGENTS 标记', 'Standby carrier is missing the HELLOAGENTS marker'))
-    if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue('standby-carrier-drift', 'standby 规则文件内容与当前 bootstrap-lite.md 不一致', 'Standby carrier content differs from the current bootstrap-lite.md'))
+    if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue('standby-carrier-drift', 'standby 规则文件内容与当前标准模式规则不一致', 'Standby carrier content differs from the current standby rules'))
     if (!checks.homeLink) issues.push(buildDoctorIssue('standby-link-missing', 'standby home 链接缺失或未指向稳定运行根目录', 'Standby home link is missing or points to a different runtime root'))
     if (!checks.settingsHooks) issues.push(buildDoctorIssue('standby-hooks-missing', 'standby settings hooks 缺失', 'Standby settings hooks are missing'))
     if (checks.settingsHooks && !checks.settingsHooksMatch) issues.push(buildDoctorIssue('standby-hooks-drift', 'standby settings hooks 与当前 hooks 配置不一致', 'Standby settings hooks differ from the current hook configuration'))

package/scripts/cli-messages.mjs

@@ -29,8 +29,8 @@ function pluginCommands() {
 
 function removeHint(msg) {
   return msg(
-    '如已安装 Claude Code 插件，建议手动移除: /plugin remove helloagents\n  如已安装 Gemini CLI 扩展，建议手动移除: gemini extensions uninstall helloagents',
-    'If Claude Code plugin installed, consider removing: /plugin remove helloagents\n  If Gemini CLI extension installed, consider removing: gemini extensions uninstall helloagents',
+    '如已安装 Claude Code 插件，可手动移除: /plugin remove helloagents\n  如已安装 Gemini CLI 扩展，可手动移除: gemini extensions uninstall helloagents',
+    'If the Claude Code plugin is installed, you can remove it: /plugin remove helloagents\n  If the Gemini CLI extension is installed, you can remove it: gemini extensions uninstall helloagents',
   )
 }
 
@@ -66,7 +66,7 @@ function renderInstallMessage(context, mode, state) {
   if (install) {
     return msg(
       `\n  ✅ HelloAGENTS 已安装（standby 模式）！\n\n    Claude Code:  已自动配置（~/.claude/CLAUDE.md + hooks）\n    Gemini CLI:   已自动配置（~/.gemini/GEMINI.md）\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  standby 模式下，hello-* 技能不会自动触发。\n  在项目中使用 ~wiki 仅创建/同步知识库，或用 ~init 完整初始化项目；也可用 ~command 按需调用。\n\n  切换模式：\n    helloagents --global    全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）`,
-      `\n  ✅ HelloAGENTS installed (standby mode)!\n\n    Claude Code:  Auto-configured (~/.claude/CLAUDE.md + hooks)\n    Gemini CLI:   Auto-configured (~/.gemini/GEMINI.md)\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  In standby mode, hello-* skills won't auto-trigger.\n  Use ~wiki to create or sync the KB only, or ~init for the full project bootstrap; ~command stays available on demand.\n\n  Switch modes:\n    helloagents --global    Global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)`,
+      `\n  ✅ HelloAGENTS installed (standby mode)!\n\n    Claude Code:  Auto-configured (~/.claude/CLAUDE.md + hooks)\n    Gemini CLI:   Auto-configured (~/.gemini/GEMINI.md)\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  In standby mode, hello-* skills won't auto-trigger.\n  Use ~wiki to create or sync the KB only, or ~init for the full project setup; ~command stays available on demand.\n\n  Switch modes:\n    helloagents --global    Global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)`,
     )
   }
 
@@ -76,7 +76,7 @@ function renderInstallMessage(context, mode, state) {
       : `  项目可通过 ~wiki 创建/同步知识库，或通过 ~init 完整初始化；未激活项目仅注入通用规则。\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
     refresh
       ? `  Standby mode refreshed; injected files and links were synchronized.\n  ${restartHint(msg)}\n  ${removeHint(msg)}`
-      : `  Projects can use ~wiki for KB-only activation or ~init for the full bootstrap. Unactivated projects get lite rules only.\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
+      : `  Projects can use ~wiki for KB-only activation or ~init for the full project setup. Unactivated projects get lite rules only.\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
   )
 }
 
@@ -118,7 +118,7 @@ ${msg('Codex /goal', 'Codex /goal')}:
   ${msg('仅显式管理 Codex 最新版 [features].goals，不替代 /goal', 'Explicitly manages only latest Codex [features].goals; does not replace /goal')}
 
 ${msg('卸载', 'Uninstall')}:
-  helloagents cleanup      ${msg('（推荐先执行，显式清理所有 CLI 注入/链接）', '(recommended first, explicitly cleans CLI injections/links)')}
+  helloagents cleanup      ${msg('（先清理所有 CLI 注入/链接）', '(cleans all CLI injections/links first)')}
   npm uninstall -g helloagents
   ${msg('如宿主命令不可用，另需手动移除：', 'If host commands are unavailable, also remove manually:')}
     Claude Code:  /plugin remove helloagents

package/scripts/delivery-gate-messages.mjs

@@ -54,17 +54,17 @@ export function buildDeliveryBlockReason(issues, recommendation, gateHint) {
 
   lines.push('')
   if (recommendation?.nextPath) {
-    lines.push(`建议路径：${recommendation.nextPath}`)
+    lines.push(`处理路径：${recommendation.nextPath}`)
   }
   if (issues.some((issue) => issue.type === 'missing-closeout-evidence')) {
-    lines.push('下一步收尾：先写入当前会话 `artifacts/closeout.json`，记录 `requirementsCoverage` 和 `deliveryChecklist`，再报告完成。')
+    lines.push('收尾动作：先写入当前会话 `artifacts/closeout.json`，记录 `requirementsCoverage` 和 `deliveryChecklist`，再报告完成。')
   }
   if (issues.some((issue) => issue.type === 'missing-visual-evidence')) {
-    lines.push('下一步视觉验收：先写入当前会话 `artifacts/visual.json`，记录 `tooling`、`screensChecked`、`statesChecked`、`status` 和 `summary`，再报告完成。')
+    lines.push('视觉验收动作：先写入当前会话 `artifacts/visual.json`，记录 `tooling`、`screensChecked`、`statesChecked`、`status` 和 `summary`，再报告完成。')
   }
   if (gateHint) {
     lines.push(gateHint)
   }
-  lines.push('暂不要报告完成。先完成剩余任务、明确关闭任务，或修复方案包，使其成为可信的交付记录。')
+  lines.push('暂不要报告完成。先完成剩余任务、补齐收尾证据，或修复方案包，使其成为可信的交付记录。')
   return lines.join('\n')
 }

package/scripts/guard-rules.mjs

@@ -81,13 +81,13 @@ export function scanShellSafetyWarnings(command = '') {
       .map((entry) => entry.trim())
       .filter(Boolean)
     if (logicalLines.length > 3) {
-      warnings.push('PowerShell 内联脚本超过 3 个逻辑行，建议改用临时 .ps1 文件')
+      warnings.push('PowerShell 内联脚本超过 3 个逻辑行，请改用临时 .ps1 文件')
     }
   }
 
   const fileOps = normalized.match(/\b(remove-item|move-item|copy-item|new-item|set-content|add-content|out-file|mkdir|md|touch|cp|copy|mv|move|ren|rename|del|erase|rm|rmdir)\b/ig) || []
   if (fileOps.length > 1 && /[;\r\n]/.test(normalized)) {
-    warnings.push('单条 shell 命令串联了多个文件操作，建议拆成独立命令')
+    warnings.push('单条 shell 命令串联了多个文件操作，请拆成独立命令')
   }
 
   return warnings

package/scripts/guard.mjs

@@ -76,12 +76,12 @@ function buildHighRiskGate(matches, cwd, payload = {}) {
   if (!recommendation) return null
   if (matches.some((match) => match.gate === 'post-verify')) {
     return {
-      reason: `[HelloAGENTS Guard] 已阻止 T3 命令：当前工作流尚未进入 VERIFY / CONSOLIDATE。\n当前工作流：${recommendation.summary}\n建议路径：${recommendation.nextPath}\n${recommendation.guidance}`,
+      reason: `[HelloAGENTS Guard] 已阻止 T3 命令：当前工作流尚未进入 VERIFY / CONSOLIDATE。\n当前工作流：${recommendation.summary}\n处理路径：${recommendation.nextPath}\n${recommendation.guidance}`,
     }
   }
   if (matches.some((match) => match.gate === 'plan-first') && recommendation.nextCommand === 'plan') {
     return {
-      reason: `[HelloAGENTS Guard] 已阻止 T3 命令：高风险 schema 变更前仍需先完成 ~plan。\n当前工作流：${recommendation.summary}\n建议路径：${recommendation.nextPath}\n${recommendation.guidance}`,
+      reason: `[HelloAGENTS Guard] 已阻止 T3 命令：高风险 schema 变更前仍需先完成 ~plan。\n当前工作流：${recommendation.summary}\n处理路径：${recommendation.nextPath}\n${recommendation.guidance}`,
     }
   }
   return null
@@ -207,7 +207,7 @@ function emitShellWarnings(data, command, highRiskWarnings, shellSafetyWarnings)
     sections.push(`⚠️ [HelloAGENTS 高风险操作提醒] 检测到高风险命令:\n${highRiskWarnings.map((warning) => `  - ${warning}`).join('\n')}\n请确认已完成相应规划/审查并获得必要授权。`)
   }
   if (shellSafetyWarnings.length > 0) {
-    sections.push(`⚠️ [HelloAGENTS Shell 安全提醒] 检测到建议调整的命令写法:\n${shellSafetyWarnings.map((warning) => `  - ${warning}`).join('\n')}\n当前仅提示，不中断执行。`)
+    sections.push(`⚠️ [HelloAGENTS Shell 安全提醒] 检测到需要关注的命令写法:\n${shellSafetyWarnings.map((warning) => `  - ${warning}`).join('\n')}\n当前仅提示，不中断执行。`)
   }
   if (sections.length === 0) return
 

package/scripts/notify-context.mjs

@@ -76,7 +76,7 @@ export function buildCompactionContext({ payload, pkgRoot, settings, bootstrapFi
   } catch {}
   if (bootstrap) {
     summaryParts.push('');
-    summaryParts.push('## 核心规则（从 bootstrap 重新注入）');
+    summaryParts.push('## 核心 HelloAGENTS 规则（重新注入）');
     summaryParts.push(bootstrap);
   }
 

package/scripts/notify.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// notify.mjs — Unified notification & bootstrap injection for HelloAGENTS
+// notify.mjs — Unified notification and rule injection for HelloAGENTS
 // Zero external dependencies, ES module, cross-platform
 
 import { join, dirname } from 'node:path';
@@ -12,6 +12,7 @@ import { buildCompactionContext, buildInjectContext, buildRouteInstruction, buil
 import { resolveNotifyHost, shouldIgnoreCodexNotifyClient } from './notify-events.mjs';
 import { runGateScript } from './notify-gates.mjs';
 import { normalizeNotifyPayload } from './notify-payload.mjs';
+import { cleanupProjectSessions } from './project-session-cleanup.mjs';
 import { handleRouteCommand, resolveBootstrapFile } from './notify-route.mjs';
 import { readSettings, readStdinJson, output, suppressedOutput, emptySuppress } from './notify-shared.mjs';
 import { clearRouteContext, getApplicableRouteContext, writeRouteContext } from './runtime-context.mjs';
@@ -248,6 +249,7 @@ function cmdInject() {
   });
   clearRouteContext({ cwd, payload });
   clearTurnState(cwd, { payload });
+  cleanupProjectSessions(cwd);
   if (IS_SILENT) {
     emptySuppress();
     return;

package/scripts/project-session-cleanup.mjs

@@ -0,0 +1,106 @@
+import { existsSync, readdirSync, rmSync } from 'node:fs'
+import { join } from 'node:path'
+
+import {
+  ACTIVE_SESSION_FILE_NAME,
+  CAPSULE_FILE_NAME,
+  EVENTS_FILE_NAME,
+  PROJECT_ARTIFACTS_DIR_NAME,
+  PROJECT_SESSIONS_DIR_NAME,
+  getProjectActivationDir,
+  getProjectRoot,
+  readJsonFile,
+} from './runtime-scope.mjs'
+
+function removePath(filePath, result, bucket) {
+  try {
+    rmSync(filePath, { recursive: true, force: true })
+    result[bucket].push(filePath)
+  } catch (error) {
+    result.errors.push(`${filePath}: ${error.message}`)
+  }
+}
+
+function isDirectoryEmptyRecursive(dirPath) {
+  const entries = readdirSync(dirPath, { withFileTypes: true })
+  if (entries.length === 0) return true
+  return entries.every((entry) => {
+    const entryPath = join(dirPath, entry.name)
+    return entry.isDirectory() && isDirectoryEmptyRecursive(entryPath)
+  })
+}
+
+function listFilesRecursive(dirPath) {
+  const entries = readdirSync(dirPath, { withFileTypes: true })
+  return entries.flatMap((entry) => {
+    const entryPath = join(dirPath, entry.name)
+    if (entry.isDirectory()) {
+      return listFilesRecursive(entryPath).map((child) => `${entry.name}/${child}`)
+    }
+    return entry.isFile() ? [entry.name] : []
+  })
+}
+
+function isRouteOnlySessionDir(sessionDir) {
+  if (existsSync(join(sessionDir, 'STATE.md'))) return false
+  const files = listFilesRecursive(sessionDir).map((file) => file.replace(/\\/g, '/'))
+  if (files.length === 0) return false
+  if (!files.includes(`${PROJECT_ARTIFACTS_DIR_NAME}/codex-native-stop.json`)) return false
+  return files.every((file) => [
+    CAPSULE_FILE_NAME,
+    EVENTS_FILE_NAME,
+    `${PROJECT_ARTIFACTS_DIR_NAME}/codex-native-stop.json`,
+  ].includes(file))
+}
+
+function shouldKeepSession(active, workspace, session) {
+  const activeWorkspace = active.workspace || active.branch || ''
+  return activeWorkspace === workspace && active.session === session
+}
+
+export function cleanupProjectSessions(cwd) {
+  const projectRoot = getProjectRoot(cwd)
+  const activationDir = getProjectActivationDir(projectRoot)
+  const sessionsDir = join(activationDir, PROJECT_SESSIONS_DIR_NAME)
+  const activePath = join(sessionsDir, ACTIVE_SESSION_FILE_NAME)
+  const active = readJsonFile(activePath, null) || {}
+  const result = {
+    sessionsDir,
+    removedEmptyDirs: [],
+    removedRouteOnlyDirs: [],
+    errors: [],
+  }
+
+  if (!existsSync(sessionsDir)) return result
+
+  for (const workspaceEntry of readdirSync(sessionsDir, { withFileTypes: true })) {
+    if (!workspaceEntry.isDirectory()) continue
+    const workspaceDir = join(sessionsDir, workspaceEntry.name)
+
+    for (const sessionEntry of readdirSync(workspaceDir, { withFileTypes: true })) {
+      if (!sessionEntry.isDirectory()) continue
+      const sessionDir = join(workspaceDir, sessionEntry.name)
+      if (shouldKeepSession(active, workspaceEntry.name, sessionEntry.name)) continue
+
+      try {
+        if (isDirectoryEmptyRecursive(sessionDir)) {
+          removePath(sessionDir, result, 'removedEmptyDirs')
+        } else if (isRouteOnlySessionDir(sessionDir)) {
+          removePath(sessionDir, result, 'removedRouteOnlyDirs')
+        }
+      } catch (error) {
+        result.errors.push(`${sessionDir}: ${error.message}`)
+      }
+    }
+
+    try {
+      if (isDirectoryEmptyRecursive(workspaceDir)) {
+        removePath(workspaceDir, result, 'removedEmptyDirs')
+      }
+    } catch (error) {
+      result.errors.push(`${workspaceDir}: ${error.message}`)
+    }
+  }
+
+  return result
+}