helloagents 3.0.37 → 3.0.39

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.37",
+  "version": "3.0.39",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, unified QA gates, safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.37",
+  "version": "3.0.39",
   "description": "HelloAGENTS — Quality-driven orchestration kernel for AI CLIs with intelligent routing, unified QA gates, 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.37-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.39-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)
@@ -184,12 +184,12 @@ 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/<workspace>/<session>/STATE.md`
-- without a stable session id: `.helloagents/sessions/<workspace>/default/STATE.md`
+- with a stable or reusable session id: `.helloagents/sessions/<workspace>/<session>/STATE.md`
+- before a reusable session id is available: `.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.
+`<workspace>` is the current Git branch, `detached-<sha>` for a detached HEAD, or `workspace` for non-Git projects. `<session>` is the current project-local session token. `.helloagents/sessions/active.json` only keeps the latest active workspace/session mapping plus alias bridges, so the same CLI session stays in one directory and `/resume` can reuse it.
 
-For project-local sessions, HelloAGENTS now only uses stable host identifiers such as `sessionId`, `conversationId`, `threadId`, or `HELLOAGENTS_NOTIFY_SESSION_ID`. It no longer uses terminal/window ids such as `WT_SESSION`, `TERM_SESSION_ID`, or `WINDOWID` to create extra project session directories.
+For project-local sessions, HelloAGENTS first uses stable host identifiers such as `sessionId`, `conversationId`, `threadId`, or `HELLOAGENTS_NOTIFY_SESSION_ID`. If the host only exposes a window or terminal id such as `WT_SESSION`, `TERM_SESSION_ID`, or `WINDOWID`, HelloAGENTS uses it only as a lightweight alias bridge and reuses the mapped session first instead of fanning out duplicate directories. If a session starts before a stable host identifier is available, HelloAGENTS can begin in `default` and keep reusing that same active directory after the same CLI session later exposes a stable identifier, instead of splitting into a second session directory.
 
 `STATE.md` records where the current workflow stopped. It is not a universal memory file for every conversation. Codex `/goal` does not replace `state_path`, `turn-state`, or local evidence files; it only handles long-running continuation on the Codex side.
 
@@ -200,15 +200,17 @@ HelloAGENTS does not treat “tests passed” and “task complete” as the sam
 Runtime state now stays intentionally small:
 
 - `.helloagents/sessions/<workspace>/<session>/STATE.md`
+- `.helloagents/sessions/<workspace>/<session>/runtime.json`
 - `.helloagents/sessions/active.json`
 - `.helloagents/sessions/<workspace>/<session>/artifacts/qa-review.json`
 - `.helloagents/sessions/<workspace>/<session>/artifacts/advisor.json`
 - `.helloagents/sessions/<workspace>/<session>/artifacts/visual.json`
 - `.helloagents/sessions/<workspace>/<session>/artifacts/closeout.json`
+- optional `.helloagents/sessions/<workspace>/<session>/events.jsonl`
 - `~/.codex/.helloagents/notify-state.json` for Codex-native closeout de-duplication only
 
-`turn-state`, route context, and the artifact index are stored inside `STATE.md` metadata instead of a separate `capsule.json`. `events.jsonl` is opt-in trace output, not a default runtime file.
-Project-local `STATE.md` is now materialized more lazily, and legacy root-level `.helloagents/artifacts/*.log` files are cleaned up automatically instead of growing as a second history system.
+`STATE.md` only keeps the human-readable recovery snapshot. `runtime.json` is machine-only and keeps the minimal runtime state. `artifacts/*.json` stays limited to structured receipts. `events.jsonl` remains opt-in trace output and stays off by default.
+Project-local `STATE.md` is now materialized more lazily.
 
 Standard runtime evidence and transient runtime state now expire after 72 hours. Long-running Codex goal flows still keep their 720-hour upper bound where the workflow explicitly needs it.
 
@@ -507,6 +509,7 @@ Runtime state and evidence remain local to the working project:
 
 - `state_path`
 - `.helloagents/sessions/active.json`
+- `.helloagents/sessions/<workspace>/<session>/runtime.json`
 - `.helloagents/sessions/<workspace>/<session>/artifacts/*.json`
 
 ### Temporary sessions outside project-local storage
@@ -517,9 +520,9 @@ For read-only work with no local output, if neither the current directory nor it
 ~/.helloagents/runtime/<scope-key>/
 ```
 
-This only stores short-lived `STATE.md` and `artifacts/`. Optional `events.jsonl` trace files are only written when trace mode is enabled. It is not project knowledge. Expired transient sessions are removed by TTL cleanup.
+This only stores short-lived `STATE.md`, `runtime.json`, and `artifacts/`. Optional `events.jsonl` trace files are only written when trace mode is enabled. It is not project knowledge. Expired transient sessions are removed by TTL cleanup.
 
-Once the task creates or modifies local files, or otherwise leaves local output in the current project, HelloAGENTS creates the project-local `.helloagents/sessions/.../STATE.md` automatically instead of keeping that task only in the user-level transient runtime.
+Once the task creates or modifies local files, or otherwise leaves local output in the current project, HelloAGENTS creates the project-local `.helloagents/sessions/<workspace>/<session>/STATE.md` automatically instead of keeping that task only in the user-level transient runtime.
 
 ### Knowledge creation rules
 
@@ -657,7 +660,7 @@ Codex is rules-file driven by default.
 - standby creates `~/.codex/helloagents -> ~/.helloagents/helloagents`
 - global mode installs the native local-plugin chain, but keeps `~/.helloagents/helloagents` as the single managed runtime source by linking plugin roots, plugin cache, and `~/.codex/helloagents` back to it
 - for Codex app/plugin discovery, `global` is the native path; `standby` remains the lighter default for explicit project work
-- cleanup removes only the HelloAGENTS-managed hook trust entries and legacy managed notify residues, while keeping user-owned hook state untouched
+- cleanup removes only the HelloAGENTS-managed hook trust entries, while keeping user-owned hook state untouched
 - Codex hooks only synchronize runtime state and enforce Stop gates; they do not inject HelloAGENTS rules or route text through hook output
 - Codex closeout de-duplicates Stop hooks and native `codex-notify`, so one turn does not notify twice, and clientless delegated child-completion events stay silent when the managed Stop hook is active
 - `/goal` remains Codex-native. Enable it explicitly with `helloagents codex goals enable` when long-running plan execution is needed
@@ -678,11 +681,11 @@ The current suite covers:
 - one-shot shell and PowerShell lifecycle dispatch, plus wrapper env cleanup and mode-routing rules for install, update, cleanup, uninstall, and branch switching
 - Claude, Gemini, and Codex host integration behavior, including global-to-standby cleanup and failed native cleanup tracking
 - Codex managed `model_instructions_file`, `notify`, `hooks.json`, hook trust state, local plugin, marketplace, and cache behavior
-- Codex cleanup of legacy managed notify variants on Windows and canonical managed notify restoration rules
+- Codex cleanup and canonical managed notify restoration rules
 - Codex `/goal` feature toggles, long-running route context, and goal-aware command contracts
 - `helloagents doctor`
 - project storage and `repo-shared` behavior
-- session-scoped `state_path`, runtime signals, and evidence
+- workspace-session scoped `state_path`, runtime signals, and evidence
 - runtime injection, routing, guard, verification, visual evidence, delivery gates, closeout de-duplication, sub-agent wrapper and notification suppression, and successful-mode tracking after native install failures
 - README and skill contract alignment
 

package/README_CN.md

@@ -8,7 +8,7 @@
 
 **面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
-[![Version](https://img.shields.io/badge/version-3.0.37-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.39-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)
@@ -184,12 +184,12 @@ HelloAGENTS 可以在 `.helloagents/` 下创建和维护项目知识库。
 
 HelloAGENTS 现在只从 `state_path` 解析当前状态文件：
 
-- 宿主提供稳定会话标识时：`.helloagents/sessions/<workspace>/<session>/STATE.md`
-- 宿主未提供稳定会话标识时：`.helloagents/sessions/<workspace>/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` 只记录当前活跃会话索引。
+`<workspace>` 是当前 Git 分支、detached HEAD 的 `detached-<sha>`，或非 Git 项目的 `workspace`。`<session>` 是当前项目本地会话标识。`.helloagents/sessions/active.json` 只保留最近一次活跃的工作区/会话映射和 alias 桥接，这样同一个 CLI 会话会稳定落在同一个目录里，`/resume` 也能复用它。
 
-对于项目本地会话目录，HelloAGENTS 现在只使用稳定宿主标识，如 `sessionId`、`conversationId`、`threadId` 或 `HELLOAGENTS_NOTIFY_SESSION_ID`。它不再使用 `WT_SESSION`、`TERM_SESSION_ID`、`WINDOWID` 这类终端或窗口标识去额外生成项目会话目录。
+对于项目本地会话目录，HelloAGENTS 会优先使用稳定宿主标识，如 `sessionId`、`conversationId`、`threadId` 或 `HELLOAGENTS_NOTIFY_SESSION_ID`。如果宿主只能提供 `WT_SESSION`、`TERM_SESSION_ID`、`WINDOWID` 这类窗口或终端标识，HelloAGENTS 只把它们当作轻量 alias 桥接，并优先复用已映射的会话目录，而不是继续分裂出重复目录。如果一个会话启动时还拿不到稳定宿主标识，HelloAGENTS 可以先落到 `default`，等同一个 CLI 会话后续拿到稳定标识时，仍继续复用这个活动目录，而不是再拆出第二个会话目录。
 
 `STATE.md` 只记录当前工作流做到哪里，不承担所有对话的统一记忆。Codex `/goal` 也不替代 `state_path`、`turn-state` 或本地证据文件；它只负责 Codex 侧的长程续跑。
 
@@ -200,15 +200,17 @@ HelloAGENTS 不把“命令通过”和“任务完成”简单画等号。交
 运行态现在尽量收敛，只保留真正有用的文件：
 
 - `.helloagents/sessions/<workspace>/<session>/STATE.md`
+- `.helloagents/sessions/<workspace>/<session>/runtime.json`
 - `.helloagents/sessions/active.json`
 - `.helloagents/sessions/<workspace>/<session>/artifacts/qa-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>/events.jsonl`
 - 仅用于 Codex 原生收尾去重的 `~/.codex/.helloagents/notify-state.json`
 
-`turn-state`、路由上下文和 artifact 索引都写进 `STATE.md` 的元数据，不再单独生成 `capsule.json`。`events.jsonl` 改为可选 trace 输出，默认不写。
-项目本地 `STATE.md` 现在会更晚创建；旧版残留的项目根 `.helloagents/artifacts/*.log` 也会自动清理，不再继续充当第二套历史系统。
+`STATE.md` 只保留给人看的恢复快照。`runtime.json` 只给机器用，只保存极少量运行态。`artifacts/*.json` 只保留结构化收据。`events.jsonl` 仍是可选 trace 输出，默认不写。
+项目本地 `STATE.md` 现在会更晚创建。
 
 标准运行态证据和临时运行态现在默认 72 小时过期。只有工作流明确需要的长程 Codex goal 链路，才继续保留 720 小时上限。
 
@@ -511,6 +513,7 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 
 - `state_path`
 - `.helloagents/sessions/active.json`
+- `.helloagents/sessions/<workspace>/<session>/runtime.json`
 - `.helloagents/sessions/<workspace>/<session>/artifacts/*.json`
 
 ### 项目本地存储之外的临时会话
@@ -521,9 +524,9 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 ~/.helloagents/runtime/<scope-key>/
 ```
 
-这里仅保存短期的 `STATE.md` 和 `artifacts/`。`events.jsonl` 只有在启用 trace 时才会写入，不作为默认运行态文件。它也不属于项目知识库。过期临时会话会按 TTL 清理。
+这里仅保存短期的 `STATE.md`、`runtime.json` 和 `artifacts/`。`events.jsonl` 只有在启用 trace 时才会写入，不作为默认运行态文件。它也不属于项目知识库。过期临时会话会按 TTL 清理。
 
-一旦任务会创建或修改本地文件，或会在当前项目留下本地输出，HelloAGENTS 就会自动创建项目本地 `.helloagents/sessions/.../STATE.md`，而不是只停留在用户级临时运行态。
+一旦任务会创建或修改本地文件，或会在当前项目留下本地输出，HelloAGENTS 就会自动创建项目本地 `.helloagents/sessions/<workspace>/<session>/STATE.md`，而不是只停留在用户级临时运行态。
 
 ### 知识创建规则
 
@@ -661,7 +664,7 @@ Codex 默认走规则文件驱动。
 - 标准模式创建 `~/.codex/helloagents -> ~/.helloagents/helloagents`
 - 全局模式安装原生本地插件流程，但仍把 `~/.helloagents/helloagents` 作为唯一受管运行时源；插件根目录、插件缓存和 `~/.codex/helloagents` 都会回链到它
 - 如果你主要看重 Codex app / 插件发现链路，优先使用 `global`；如果你主要看重更轻量、更显式的项目工作流，保留 `standby`
-- 清理时只删除 HelloAGENTS 自己写入的 hook trust 条目和旧式受管 notify 残留，不影响用户已有的 hook 状态
+- 清理时只删除 HelloAGENTS 自己写入的 hook trust 条目，不影响用户已有的 hook 状态
 - Codex hooks 只做静默运行态同步和 Stop 门禁，不通过 hook 注入 HelloAGENTS 规则或路由说明
 - Codex 收尾会对 Stop hook 和原生 `codex-notify` 去重，避免同一轮重复通知；受管 Stop hook 生效时，client 为空的委派子任务完成事件也会保持静默
 - `/goal` 保持 Codex 原生能力；需要长程执行时，用 `helloagents codex goals enable` 显式启用
@@ -682,11 +685,11 @@ npm test
 - shell 与 PowerShell 一键脚本分发链路，以及包装脚本在安装、更新、清理、卸载和分支切换中的环境清理与模式传递规则
 - Claude、Gemini、Codex 的宿主集成行为，包括全局切回标准模式的清理和原生清理失败时的模式保留
 - Codex 受管 `model_instructions_file`、`notify`、`hooks.json`、hook trust 状态、本地插件、marketplace 和缓存行为
-- Windows 下 Codex 旧式受管 notify 变体的清理，以及受管 notify 恢复规则
+- Codex 清理链路，以及受管 notify 恢复规则
 - Codex `/goal` 功能开关、长程路由上下文和 goal 感知命令契约
 - `helloagents doctor`
 - 项目存储和 `repo-shared`
-- 会话级 `state_path`、运行态信号和证据
+- 工作区+会话级 `state_path`、运行态信号和证据
 - 运行时注入、选路、Guard、验证、视觉证据、交付门控、收尾去重、子代理外层格式与通知静默保护，以及原生安装失败后的模式记录
 - README 与 skill 契约一致性
 

package/bootstrap-lite.md

@@ -221,9 +221,9 @@
 路径: {CWD}/.helloagents/
 所有文件的创建和更新必须按 templates/ 目录中对应模板的格式执行，不可自由发挥格式。
 - `.helloagents/` 表示项目本地存储路径，负责知识、方案、状态与运行态；它不再作为项目是否已初始化的判定信号
-- `state_path` 指向的状态文件始终保留在项目本地 `.helloagents/sessions/{workspace}/{session}/STATE.md`；当前会话的 `turn-state`、路由上下文和 artifact 索引写入这个文件的元数据，`artifacts/*.json` 仅在需要结构化证据时按需生成，`events.jsonl` 仅在显式 trace 模式下写入
-- `state_path` 是状态文件的唯一位置。宿主提供会话标识时，写入 `.helloagents/sessions/{workspace}/{session}/STATE.md`；没有稳定会话标识时，写入 `.helloagents/sessions/{workspace}/default/STATE.md`
-- `{workspace}` 为当前 Git 分支、`detached-{sha}` 或非 Git 项目的 `workspace`；`.helloagents/sessions/active.json` 只记录当前活跃会话索引，避免同一会话被拆成多个目录
+- `state_path` 指向的状态文件始终保留在项目本地 `.helloagents/sessions/{workspace}/{session}/STATE.md`；当前会话的 `turn-state`、路由上下文和 artifact 索引写入同目录 `runtime.json`，`artifacts/*.json` 仅在需要结构化证据时按需生成，`events.jsonl` 仅在显式 trace 模式下写入
+- `state_path` 是状态文件的唯一位置。宿主提供稳定会话标识时，写入 `.helloagents/sessions/{workspace}/{session}/STATE.md`；没有稳定或可复用会话标识时，写入 `.helloagents/sessions/{workspace}/default/STATE.md`
+- `{workspace}` 为当前 Git 分支、`detached-{sha}` 或非 Git 项目的 `workspace`；`.helloagents/sessions/active.json` 只记录最近一次活跃的工作区/会话映射与 alias 桥接，避免同一 CLI 会话被拆成多个目录
 - 若 helloagents.json 中 `project_store_mode = "repo-shared"`，`context.md`、`guidelines.md`、`CHANGELOG.md`、`verify.yaml`、`DESIGN.md`、`modules/`、`plans/`、`archive/` 改按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析；未注入具体路径时，按当前存储模式自行解析，不要假定这些文件一定实际位于当前工作树中
 templates/ 查找路径（按优先级；首次确定模板根目录后，本会话复用）：
 按上文 `~command` 路由中的相同技能根目录规则确定；确定根目录后读取其中的 `templates/`。
@@ -292,4 +292,3 @@ Tier 3 — 深入特定模块时读取：
 
 ### 项目文件
 根据知识库中的架构描述和模块索引，结合当前任务需求，按需读取相关的项目源码、配置和资源文件。不要一次性读取整个项目，先通过知识库了解项目结构，再有针对性地读取需要的文件。不要把项目级规则文件（`AGENTS.md`、`CLAUDE.md`、`.gemini/GEMINI.md`）当作普通项目文件重复读取。
-

package/bootstrap.md

@@ -290,9 +290,9 @@ hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.m
 路径: {CWD}/.helloagents/
 所有文件的创建和更新必须按 templates/ 目录中对应模板的格式执行，不可自由发挥格式。
 - `.helloagents/` 表示项目本地存储路径，负责知识、方案、状态与运行态；它不再作为项目是否已初始化的判定信号
-- `state_path` 指向的状态文件始终保留在项目本地 `.helloagents/sessions/{workspace}/{session}/STATE.md`；当前会话的 `turn-state`、路由上下文和 artifact 索引写入这个文件的元数据，`artifacts/*.json` 仅在需要结构化证据时按需生成，`events.jsonl` 仅在显式 trace 模式下写入
-- `state_path` 是状态文件的唯一位置。宿主提供会话标识时，写入 `.helloagents/sessions/{workspace}/{session}/STATE.md`；没有稳定会话标识时，写入 `.helloagents/sessions/{workspace}/default/STATE.md`
-- `{workspace}` 为当前 Git 分支、`detached-{sha}` 或非 Git 项目的 `workspace`；`.helloagents/sessions/active.json` 只记录当前活跃会话索引，避免同一会话被拆成多个目录
+- `state_path` 指向的状态文件始终保留在项目本地 `.helloagents/sessions/{workspace}/{session}/STATE.md`；当前会话的 `turn-state`、路由上下文和 artifact 索引写入同目录 `runtime.json`，`artifacts/*.json` 仅在需要结构化证据时按需生成，`events.jsonl` 仅在显式 trace 模式下写入
+- `state_path` 是状态文件的唯一位置。宿主提供稳定会话标识时，写入 `.helloagents/sessions/{workspace}/{session}/STATE.md`；没有稳定或可复用会话标识时，写入 `.helloagents/sessions/{workspace}/default/STATE.md`
+- `{workspace}` 为当前 Git 分支、`detached-{sha}` 或非 Git 项目的 `workspace`；`.helloagents/sessions/active.json` 只记录最近一次活跃的工作区/会话映射与 alias 桥接，避免同一 CLI 会话被拆成多个目录
 - 若 helloagents.json 中 `project_store_mode = "repo-shared"`，`context.md`、`guidelines.md`、`CHANGELOG.md`、`verify.yaml`、`DESIGN.md`、`modules/`、`plans/`、`archive/` 改按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析；未注入具体路径时，按当前存储模式自行解析，不要假定这些文件一定实际位于当前工作树中
 templates/ 查找路径（按优先级；首次确定模板根目录后，本会话复用）：
 按上文相同的技能根目录规则确定；确定根目录后读取其中的 `templates/`。
@@ -361,4 +361,3 @@ Tier 3 — 深入特定模块时读取：
 
 ### 项目文件
 根据知识库中的架构描述和模块索引，结合当前任务需求，按需读取相关的项目源码、配置和资源文件。不要一次性读取整个项目，先通过知识库了解项目结构，再有针对性地读取需要的文件。不要把项目级规则文件（`AGENTS.md`、`CLAUDE.md`、`.gemini/GEMINI.md`）当作普通项目文件重复读取。
-

package/gemini-extension.json

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

package/install.ps1

@@ -124,7 +124,9 @@ switch ($Action) {
                 Invoke-Npm -NpmArgs @("install", "-g", "helloagents")
             }
         }
-        Sync-Hosts
+        if ($HasExplicitTarget) {
+            Sync-Hosts
+        }
     }
     "cleanup" {
         Cleanup-Hosts

package/install.sh

@@ -144,7 +144,9 @@ case "$ACTION" in
     else
       npm update -g helloagents || npm install -g helloagents
     fi
-    sync_hosts
+    if [ "$HAS_EXPLICIT_TARGET" -eq 1 ]; then
+      sync_hosts
+    fi
     ;;
   cleanup)
     cleanup_hosts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.37",
+  "version": "3.0.39",
   "type": "module",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, unified QA gates, safety guards, and notifications.",
   "author": "HelloWind",

package/scripts/cli-codex-config.mjs

@@ -13,13 +13,8 @@ export const CODEX_MANAGED_TOML_COMMENT = '# helloagents-managed'
 export const CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH = '~/.codex/AGENTS.md'
 export const CODEX_MANAGED_NOTIFY_COMMAND = 'helloagents-js'
 export const CODEX_MANAGED_NOTIFY_VALUE = `["${CODEX_MANAGED_NOTIFY_COMMAND}", "codex-notify"]`
-const CODEX_MANAGED_NOTIFY_LEGACY_VALUES = [
-  `["${CODEX_MANAGED_NOTIFY_COMMAND}.cmd", "codex-notify"]`,
-  `["${CODEX_MANAGED_NOTIFY_COMMAND}.exe", "codex-notify"]`,
-]
 export const CODEX_MANAGED_TUI_NOTIFICATIONS_VALUE = '["plan-mode-prompt"]'
 export const CODEX_HOOKS_FEATURE_KEY = 'hooks'
-export const CODEX_LEGACY_HOOKS_FEATURE_KEY = 'codex_hooks'
 export const CODEX_GOALS_FEATURE_KEY = 'goals'
 export const CODEX_MANAGED_GOALS_FEATURE_LINE = `${CODEX_GOALS_FEATURE_KEY} = true ${CODEX_MANAGED_TOML_COMMENT}`
 export const CODEX_MANAGED_GOALS_DISABLED_LINE = `${CODEX_GOALS_FEATURE_KEY} = false ${CODEX_MANAGED_TOML_COMMENT}`
@@ -105,10 +100,6 @@ export function readCodexHooksFeatureLine(text) {
   return readCodexFeatureLine(text, CODEX_HOOKS_FEATURE_KEY)
 }
 
-export function readLegacyCodexHooksFeatureLine(text) {
-  return readCodexFeatureLine(text, CODEX_LEGACY_HOOKS_FEATURE_KEY)
-}
-
 export function readCodexGoalsFeatureLine(text) {
   return readCodexFeatureLine(text, CODEX_GOALS_FEATURE_KEY)
 }
@@ -146,15 +137,6 @@ export function removeCodexGoalsFeatureConfig(text) {
   )
 }
 
-export function removeLegacyManagedCodexHooksFeatureConfig(text) {
-  return removeTomlSectionLine(
-    text,
-    CODEX_FEATURES_HEADER,
-    CODEX_LEGACY_HOOKS_FEATURE_KEY,
-    isManagedLegacyCodexHooksFeature,
-  )
-}
-
 export function restoreCodexGoalsFeatureConfig(text, { codexGoalsLine = '' } = {}) {
   if (!codexGoalsLine) return normalizeToml(text)
   return upsertTomlSectionLine(
@@ -173,10 +155,7 @@ export function isManagedCodexModelInstruction(line = '') {
 export function isManagedCodexNotify(line = '') {
   const value = String(line || '').replace(/\\/g, '/')
   return value.includes(CODEX_MANAGED_TOML_COMMENT)
-    && (
-      value.includes(CODEX_MANAGED_NOTIFY_VALUE)
-      || CODEX_MANAGED_NOTIFY_LEGACY_VALUES.some((entry) => value.includes(entry))
-    )
+    && value.includes(CODEX_MANAGED_NOTIFY_VALUE)
 }
 
 export function isManagedCodexTuiNotifications(line = '') {
@@ -193,10 +172,6 @@ export function isManagedCodexHooksFeature(line = '') {
   return isManagedFeatureLine(line, CODEX_HOOKS_FEATURE_KEY)
 }
 
-export function isManagedLegacyCodexHooksFeature(line = '') {
-  return isManagedFeatureLine(line, CODEX_LEGACY_HOOKS_FEATURE_KEY)
-}
-
 export function isManagedCodexGoalsFeature(line = '') {
   return isManagedFeatureLine(line, CODEX_GOALS_FEATURE_KEY)
 }

package/scripts/cli-codex.mjs

@@ -17,12 +17,9 @@ import {
   isManagedCodexGoalsFeature,
   isManagedCodexModelInstruction,
   isManagedCodexNotify,
-  isManagedLegacyCodexHooksFeature,
   readCodexGoalsFeatureLine,
-  readLegacyCodexHooksFeatureLine,
   removeCodexGoalsFeatureConfig,
   removeCodexManagedTuiConfig,
-  removeLegacyManagedCodexHooksFeatureConfig,
   removeCodexPluginConfig,
   restoreCodexGoalsFeatureConfig,
   restoreCodexTopLevelConfig,
@@ -156,12 +153,10 @@ function cleanupCodexManagedConfig(configPath, { removePluginConfig = false } =
   const currentModelInstructions = readTopLevelTomlLine(toml, 'model_instructions_file');
   const currentNotify = readTopLevelTomlBlock(toml, 'notify');
   const currentCodexGoalsFeature = readCodexGoalsFeatureLine(toml);
-  const currentLegacyCodexHooksFeature = readLegacyCodexHooksFeatureLine(toml);
 
   const shouldRestoreModelInstructions = isManagedCodexModelInstruction(currentModelInstructions);
   const shouldRestoreNotify = isManagedCodexNotify(currentNotify);
   const shouldRestoreCodexGoalsFeature = isManagedCodexGoalsFeature(currentCodexGoalsFeature);
-  const shouldRemoveLegacyCodexHooksFeature = isManagedLegacyCodexHooksFeature(currentLegacyCodexHooksFeature);
 
   if (removePluginConfig) {
     toml = removeCodexPluginConfig(toml);
@@ -170,9 +165,6 @@ function cleanupCodexManagedConfig(configPath, { removePluginConfig = false } =
     toml = removeCodexGoalsFeatureConfig(toml);
   }
   toml = removeCodexManagedTuiConfig(toml);
-  if (shouldRemoveLegacyCodexHooksFeature) {
-    toml = removeLegacyManagedCodexHooksFeatureConfig(toml);
-  }
   if (shouldRestoreModelInstructions) {
     toml = removeTopLevelTomlLines(toml, (line) =>
       line.startsWith('model_instructions_file =') && isManagedCodexModelInstruction(line)).text;
@@ -220,7 +212,6 @@ export function installCodexStandby(home, pkgRoot) {
     modelInstructionsPath: CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH,
   });
   toml = installCodexManagedTuiConfig(toml);
-  toml = removeLegacyManagedCodexHooksFeatureConfig(toml);
   safeWrite(configPath, toml);
   installCodexStandaloneHooks(home, pkgRoot);
 
@@ -312,7 +303,6 @@ export function installCodexGlobal(home, pkgRoot) {
     modelInstructionsPath: CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH,
   });
   toml = installCodexManagedTuiConfig(toml);
-  toml = removeLegacyManagedCodexHooksFeatureConfig(toml);
   toml = upsertCodexPluginConfig(toml);
   safeWrite(configPath, toml);
   installCodexStandaloneHooks(home, pkgRoot);

package/scripts/cli-doctor-codex.mjs

@@ -9,7 +9,6 @@ import {
   CODEX_MANAGED_NOTIFY_VALUE,
   readCodexGoalsFeatureLine,
   readCodexHooksFeatureLine,
-  readLegacyCodexHooksFeatureLine,
 } from './cli-codex-config.mjs'
 import {
   buildManagedCodexHookTrustEntries,
@@ -301,8 +300,6 @@ function buildCodexChecks(runtime, settings, trackedMode, detectedMode) {
   )
   const hooksFeatureLine = readCodexHooksFeatureLine(codexConfig)
   const goalsFeatureLine = readCodexGoalsFeatureLine(codexConfig)
-  const legacyHooksFeatureLine = readLegacyCodexHooksFeatureLine(codexConfig)
-
   return {
     checks: {
       carrierMarker: (safeRead(join(codexDir, 'AGENTS.md')) || '').includes('HELLOAGENTS_START'),
@@ -319,10 +316,8 @@ function buildCodexChecks(runtime, settings, trackedMode, detectedMode) {
       modelInstructionsPathMatch: !!modelInstructionsLine && normalizePath(modelInstructionsLine).includes(`"${CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH}"`),
       codexNotify: codexConfig.includes('codex-notify'),
       notifyPathMatch: codexConfig.includes(CODEX_MANAGED_NOTIFY_VALUE),
-      codexHooksFeature: !/^\s*hooks\s*=\s*false\b/.test(hooksFeatureLine)
-        && !/^\s*codex_hooks\s*=\s*false\b/.test(legacyHooksFeatureLine),
+      codexHooksFeature: !/^\s*hooks\s*=\s*false\b/.test(hooksFeatureLine),
       codexGoalsFeature: /^\s*goals\s*=\s*true\b/.test(goalsFeatureLine),
-      legacyCodexHooksFeature: Boolean(legacyHooksFeatureLine),
       standaloneHooks: JSON.stringify(codexHooks.hooks || {}).includes('helloagents'),
       standaloneHooksMatch: managedHooksMatch(codexHooks.hooks || {}, expectedHooks),
       managedHookTrust: expectedHookTrust.every((entry) => managedHookTrust.has(entry.key)),
@@ -369,7 +364,6 @@ 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 (!nativeDoctor.available) notes.push(runtime.msg('未检测到原生 `codex doctor`；当前仅检查 HelloAGENTS 受管覆盖层。', 'Native `codex doctor` was not available; only the HelloAGENTS managed overlay was checked.'))
 
   const status = summarizeDoctorStatus(issues, { trackedMode, detectedMode })

package/scripts/notify.mjs

@@ -349,6 +349,10 @@ function attachTurnSession(payload = {}, cwd = payload.cwd || process.cwd()) {
     allowPpidFallback: !isProjectRuntimeActive(cwd),
   });
   if (!sessionId || payload.sessionId) return payload;
+  const aliasSource = String(process.env.HELLOAGENTS_NOTIFY_SESSION_ID || process.env.WT_SESSION || process.env.TERM_SESSION_ID || process.env.WINDOWID || '').trim();
+  if (aliasSource) {
+    return { ...payload, sessionId, _helloagentsSessionAlias: aliasSource };
+  }
   return { ...payload, sessionId };
 }
 

package/scripts/project-session-cleanup.mjs

@@ -10,12 +10,10 @@ import {
   writeJsonFileAtomic,
 } from './runtime-scope.mjs'
 import { LONG_RUNNING_TTL_MS } from './runtime-ttl.mjs'
-import { readStateDocument } from './state-document.mjs'
+import { looksLikeAutoCreatedState, readStateDocument } from './state-document.mjs'
 
 export const PROJECT_SESSION_CLEANUP_COOLDOWN_MS = 10 * 60 * 1000
 export const PROJECT_SESSION_MAX_AGE_MS = LONG_RUNNING_TTL_MS
-const AUTO_CREATED_STATE_MARKER = '由运行时自动创建；后续按实际任务重写'
-
 function removePath(filePath, result, bucket) {
   try {
     rmSync(filePath, { recursive: true, force: true })
@@ -25,10 +23,6 @@ function removePath(filePath, result, bucket) {
   }
 }
 
-function isDebugLog(entryName = '') {
-  return /\.log$/i.test(entryName)
-}
-
 function isDirectoryEmptyRecursive(dirPath) {
   const entries = readdirSync(dirPath, { withFileTypes: true })
   if (entries.length === 0) return true
@@ -38,9 +32,10 @@ function isDirectoryEmptyRecursive(dirPath) {
   })
 }
 
-function shouldKeepSession(active, workspace, session) {
+function shouldKeepNestedSession(active, workspace, sessionName) {
   const activeWorkspace = active.workspace || active.branch || ''
-  return activeWorkspace === workspace && active.session === session
+  const activeSession = active.session || ''
+  return activeWorkspace === workspace && activeSession === sessionName
 }
 
 function readCleanupCheckedAt(active) {
@@ -65,9 +60,8 @@ function isAutoCreatedSeedSession(sessionDir) {
   const statePath = join(sessionDir, 'STATE.md')
   if (!existsSync(statePath)) return false
 
-  const { metadata, body } = readStateDocument(statePath)
-  if (metadata && typeof metadata === 'object' && Object.keys(metadata).length > 0) return false
-  return String(body || '').includes(AUTO_CREATED_STATE_MARKER)
+  const { body } = readStateDocument(statePath)
+  return looksLikeAutoCreatedState(body)
 }
 
 function readSessionStateMtimeMs(sessionDir) {
@@ -94,32 +88,6 @@ function cleanupTransientSessionTemps(sessionsDir, result) {
   }
 }
 
-function cleanupLegacyProjectArtifacts(activationDir, result) {
-  const artifactsDir = join(activationDir, 'artifacts')
-  if (!existsSync(artifactsDir)) return
-
-  let removableEntries = []
-  try {
-    removableEntries = readdirSync(artifactsDir, { withFileTypes: true })
-  } catch (error) {
-    result.errors.push(`${artifactsDir}: ${error.message}`)
-    return
-  }
-
-  for (const entry of removableEntries) {
-    if (!entry.isFile() || !isDebugLog(entry.name)) continue
-    removePath(join(artifactsDir, entry.name), result, 'removedLegacyArtifacts')
-  }
-
-  try {
-    if (isDirectoryEmptyRecursive(artifactsDir)) {
-      removePath(artifactsDir, result, 'removedLegacyArtifacts')
-    }
-  } catch (error) {
-    result.errors.push(`${artifactsDir}: ${error.message}`)
-  }
-}
-
 export function cleanupProjectSessions(cwd, { now = Date.now(), minIntervalMs = 0, maxAgeMs = PROJECT_SESSION_MAX_AGE_MS } = {}) {
   const projectRoot = getProjectRoot(cwd)
   const activationDir = getProjectActivationDir(projectRoot)
@@ -133,7 +101,6 @@ export function cleanupProjectSessions(cwd, { now = Date.now(), minIntervalMs =
     removedNoStateDirs: [],
     removedSeedDirs: [],
     removedTempFiles: [],
-    removedLegacyArtifacts: [],
     errors: [],
     skipped: false,
   }
@@ -152,33 +119,32 @@ export function cleanupProjectSessions(cwd, { now = Date.now(), minIntervalMs =
   } catch (error) {
     result.errors.push(`${sessionsDir}: ${error.message}`)
   }
-  cleanupLegacyProjectArtifacts(activationDir, 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 {
+    try {
+      const nestedEntries = readdirSync(workspaceDir, { withFileTypes: true }).filter((entry) => entry.isDirectory())
+      for (const nestedEntry of nestedEntries) {
+        const sessionDir = join(workspaceDir, nestedEntry.name)
+        if (shouldKeepNestedSession(active, workspaceEntry.name, nestedEntry.name)) continue
         if (isDirectoryEmptyRecursive(sessionDir)) {
           removePath(sessionDir, result, 'removedEmptyDirs')
-        } else if (!hasStateSnapshot(sessionDir)) {
+          continue
+        }
+        if (!hasStateSnapshot(sessionDir)) {
           removePath(sessionDir, result, 'removedNoStateDirs')
-        } else if (isAutoCreatedSeedSession(sessionDir)) {
+          continue
+        }
+        if (isAutoCreatedSeedSession(sessionDir)) {
           removePath(sessionDir, result, 'removedSeedDirs')
-        } else if (isStaleStateSession(sessionDir, now, maxAgeMs)) {
+          continue
+        }
+        if (isStaleStateSession(sessionDir, now, maxAgeMs)) {
           removePath(sessionDir, result, 'removedInactiveDirs')
         }
-      } catch (error) {
-        result.errors.push(`${sessionDir}: ${error.message}`)
       }
-    }
 
-    try {
       if (isDirectoryEmptyRecursive(workspaceDir)) {
         removePath(workspaceDir, result, 'removedEmptyDirs')
       }

package/scripts/project-storage.mjs

@@ -114,8 +114,8 @@ export function getProjectSessionStateScope(cwd, options = {}) {
   const scope = getProjectSessionScope(cwd, normalizeRuntimeOptions(options))
 
   return {
-    stateScope: 'session',
-    stateSessionToken: scope.session,
+    stateScope: 'workspace-session',
+    stateSessionToken: scope.session || '',
     stateSessionMode: scope.sessionMode,
     stateWorkspace: scope.workspace || scope.branch,
     sessionDir: scope.sessionDir,
@@ -246,9 +246,6 @@ export function buildProjectStorageHint(cwd, options = {}) {
   const summary = getProjectStoreSummary(cwd, options)
   const hints = []
   hints.push(`当前状态文件写入 \`${summary.promptStatePath}\``)
-  if (summary.stateSessionMode === 'default') {
-    hints.push(`当前宿主未提供稳定会话标识，因此使用工作区默认位置 \`${summary.stateSessionToken}\``)
-  }
   if (summary.usesSharedStore) {
     hints.push(`项目存储：\`project_store_mode=repo-shared\`；项目本地存储/会话运行态目录仍是 \`${summary.promptActivationDir}\`，知识库/方案目录改为 \`${summary.promptStoreDir}\``)
   }
@@ -277,9 +274,6 @@ export function buildProjectStorageBlock(cwd, options = {}) {
 
   const explanations = []
   explanations.push('说明：状态文件只使用 `state_path`。')
-  if (summary.stateSessionMode === 'default') {
-    explanations.push('说明：当前宿主未提供稳定会话标识，因此使用工作区默认位置。')
-  }
   if (summary.usesSharedStore) {
     explanations.push('说明：状态文件与会话产物写项目本地存储目录；`context.md`、`guidelines.md`、`DESIGN.md`、`verify.yaml`、`modules/`、`plans/`、`archive/` 写知识库/方案目录。')
   } else {