helloagents 3.0.19 → 3.0.20-beta.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.19",
+  "version": "3.0.20-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.20-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.20-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,14 @@ 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`
 
 ### 7) Safer install, update, cleanup, and diagnostics
 
@@ -268,7 +271,7 @@ For knowledge base only:
 ~wiki
 ```
 
-For full project bootstrap:
+For full project setup:
 
 ```text
 ~init
@@ -496,10 +499,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 +642,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 +670,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 +695,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.20-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,14 @@ 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 +501,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 +644,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 +672,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 +697,7 @@ npm test
 
 ### Codex hooks 会显示注入内容吗？
 
-不会显示 bootstrap 或路由说明。HelloAGENTS 的 Codex hooks 只写运行态和执行 Stop 门禁，成功路径返回静默结果；只有阻塞或错误时显示必要原因。
+不会显示 HelloAGENTS 规则或路由说明。HelloAGENTS 的 Codex hooks 只写运行态和执行 Stop 门禁，成功路径返回静默结果；只有阻塞或错误时显示必要原因。
 
 ### 可以关闭通知或 Guard 吗？
 

package/bootstrap-lite.md

@@ -207,8 +207,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

@@ -273,8 +273,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.20-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.20-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'))

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

@@ -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)}`,
   )
 }
 

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
+}

package/scripts/project-storage.mjs

@@ -117,7 +117,7 @@ export function getProjectSessionStateScope(cwd, options = {}) {
     stateScope: 'session',
     stateSessionToken: scope.session,
     stateSessionMode: scope.sessionMode,
-    stateBranch: scope.branch,
+    stateWorkspace: scope.workspace || scope.branch,
     sessionDir: scope.sessionDir,
     statePath: scope.statePath,
   }
@@ -168,7 +168,7 @@ export function getProjectStoreSummary(cwd, options = {}) {
     stateScope: stateScope.stateScope,
     stateSessionToken: stateScope.stateSessionToken,
     stateSessionMode: stateScope.stateSessionMode,
-    stateBranch: stateScope.stateBranch,
+    stateWorkspace: stateScope.stateWorkspace,
     sessionStateDir: stateScope.sessionDir,
     artifactsDir,
     usesSharedStore: projectStoreMode === 'repo-shared',
@@ -247,7 +247,7 @@ export function buildProjectStorageHint(cwd, options = {}) {
   const hints = []
   hints.push(`当前状态文件写入 \`${summary.promptStatePath}\``)
   if (summary.stateSessionMode === 'default') {
-    hints.push(`当前宿主未提供稳定会话标识，因此使用分支默认位置 \`${summary.stateSessionToken}\``)
+    hints.push(`当前宿主未提供稳定会话标识，因此使用工作区默认位置 \`${summary.stateSessionToken}\``)
   }
   if (summary.usesSharedStore) {
     hints.push(`项目存储：\`project_store_mode=repo-shared\`；本地激活/会话运行态目录仍是 \`${summary.promptActivationDir}\`，知识库/方案目录改为 \`${summary.promptStoreDir}\``)
@@ -266,7 +266,7 @@ export function buildProjectStorageBlock(cwd, options = {}) {
     activation_dir: summary.promptActivationDir,
     state_scope: summary.stateScope,
     state_path: summary.promptStatePath,
-    state_branch: summary.stateBranch,
+    state_workspace: summary.stateWorkspace,
     state_session_token: summary.stateSessionToken,
     state_session_mode: summary.stateSessionMode,
     session_state_dir: summary.promptSessionStateDir,
@@ -278,7 +278,7 @@ export function buildProjectStorageBlock(cwd, options = {}) {
   const explanations = []
   explanations.push('说明：状态文件只使用 `state_path`。')
   if (summary.stateSessionMode === 'default') {
-    explanations.push('说明：当前宿主未提供稳定会话标识，因此使用分支默认位置。')
+    explanations.push('说明：当前宿主未提供稳定会话标识，因此使用工作区默认位置。')
   }
   if (summary.usesSharedStore) {
     explanations.push('说明：状态文件与会话产物写本地激活目录；`context.md`、`guidelines.md`、`DESIGN.md`、`verify.yaml`、`modules/`、`plans/`、`archive/` 写知识库/方案目录。')