helloagents 3.0.37 → 3.0.38

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.37",
+  "version": "3.0.38",
   "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.38",
   "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.38-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.
 
 `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,14 +200,16 @@ 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.
+`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, and legacy root-level `.helloagents/artifacts/*.log` files are cleaned up automatically instead of growing as a second history system.
 
 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
 
@@ -682,7 +685,7 @@ The current suite covers:
 - 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.38-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 桥接，并优先复用已映射的会话目录，而不是继续分裂出重复目录。
 
 `STATE.md` 只记录当前工作流做到哪里，不承担所有对话的统一记忆。Codex `/goal` 也不替代 `state_path`、`turn-state` 或本地证据文件；它只负责 Codex 侧的长程续跑。
 
@@ -200,14 +200,16 @@ 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` 只保留给人看的恢复快照。`runtime.json` 只给机器用，只保存极少量运行态。`artifacts/*.json` 只保留结构化收据。`events.jsonl` 仍是可选 trace 输出，默认不写。
 项目本地 `STATE.md` 现在会更晚创建；旧版残留的项目根 `.helloagents/artifacts/*.log` 也会自动清理，不再继续充当第二套历史系统。
 
 标准运行态证据和临时运行态现在默认 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`，而不是只停留在用户级临时运行态。
 
 ### 知识创建规则
 
@@ -686,7 +689,7 @@ npm test
 - 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.38",
   "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.38",
   "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/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 })
@@ -38,9 +36,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 +64,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) {
@@ -157,28 +155,28 @@ export function cleanupProjectSessions(cwd, { now = Date.now(), minIntervalMs =
   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 {

package/scripts/runtime-scope.mjs

@@ -4,17 +4,24 @@ import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync,
 import { dirname, join, normalize, resolve } from 'node:path'
 import { homedir } from 'node:os'
 
-import { resolveProjectSessionToken, resolveSessionToken } from './session-token.mjs'
+import {
+  resolveProjectSessionAliasToken,
+  resolveProjectSessionToken,
+  resolveSessionToken,
+} from './session-token.mjs'
 import { USER_RUNTIME_MAX_AGE_MS } from './runtime-ttl.mjs'
 import { cleanupUserRuntimeRoot, getUserRuntimeRoot } from './runtime-user-cleanup.mjs'
 import { FULL_CARRIER_PROFILE_MARKER } from './cli-utils.mjs'
+import { readStateDocument, writeStateDocument } from './state-document.mjs'
 
 export const PROJECT_DIR_NAME = '.helloagents'
 export const PROJECT_SESSIONS_DIR_NAME = 'sessions'
 export const PROJECT_ARTIFACTS_DIR_NAME = 'artifacts'
 export const EVENTS_FILE_NAME = 'events.jsonl'
 export const ACTIVE_SESSION_FILE_NAME = 'active.json'
+export const PROJECT_RUNTIME_FILE_NAME = 'runtime.json'
 export const DEFAULT_STATE_SESSION_TOKEN = 'default'
+export const LEGACY_SESSION_POINTERS_FILE_NAME = 'session-pointers.json'
 export const USER_RUNTIME_DIR_NAME = 'runtime'
 export { cleanupUserRuntimeRoot, getUserRuntimeRoot, USER_RUNTIME_MAX_AGE_MS }
 
@@ -260,6 +267,38 @@ function buildInitialStateSnapshot({
   ].join('\n')
 }
 
+function normalizeProjectSessionState(scope) {
+  if (!scope?.statePath) return
+
+  const currentDocument = readStateDocument(scope.statePath)
+  if (currentDocument.hasMetadata) {
+    if (currentDocument.metadata && typeof currentDocument.metadata === 'object' && !existsSync(scope.runtimePath)) {
+      writeJsonFileAtomic(scope.runtimePath, currentDocument.metadata)
+    }
+    writeStateDocument(scope.statePath, {
+      body: currentDocument.body,
+    })
+  }
+
+  const workspaceStatePath = scope.workspaceDir ? join(scope.workspaceDir, 'STATE.md') : ''
+  if (!workspaceStatePath || samePath(workspaceStatePath, scope.statePath) || !existsSync(workspaceStatePath)) return
+
+  const legacyDocument = readStateDocument(workspaceStatePath)
+  if (!existsSync(scope.statePath) && legacyDocument.body.trim()) {
+    writeStateDocument(scope.statePath, {
+      body: legacyDocument.body,
+    })
+  }
+  if (legacyDocument.metadata && typeof legacyDocument.metadata === 'object' && !existsSync(scope.runtimePath)) {
+    writeJsonFileAtomic(scope.runtimePath, legacyDocument.metadata)
+  }
+  if (legacyDocument.hasMetadata) {
+    writeStateDocument(workspaceStatePath, {
+      body: legacyDocument.body,
+    })
+  }
+}
+
 export function ensureProjectLocalRuntime(cwd, options = {}) {
   const normalizedCwd = normalizePath(cwd || process.cwd())
   const localDir = getProjectLocalDir(normalizedCwd)
@@ -271,6 +310,7 @@ export function ensureProjectLocalRuntime(cwd, options = {}) {
   if (!existsSync(scope.statePath)) {
     writeFileSync(scope.statePath, `${buildInitialStateSnapshot(options.stateSeed || {})}\n`, 'utf-8')
   }
+  normalizeProjectSessionState(scope)
 
   return scope
 }
@@ -333,6 +373,10 @@ function resolveEnvSessionToken(env = process.env) {
   return resolveProjectSessionToken({ payload: {}, env })
 }
 
+function resolveEnvSessionAliasToken(env = process.env) {
+  return resolveProjectSessionAliasToken({ env })
+}
+
 function resolveTransientSessionToken({ payload = {}, env = process.env, ppid = process.ppid } = {}) {
   return resolveSessionToken({
     payload,
@@ -342,10 +386,24 @@ function resolveTransientSessionToken({ payload = {}, env = process.env, ppid =
   })
 }
 
+function buildScopedSessionToken(kind = '', raw = '') {
+  const normalizedKind = sanitizeRuntimeSegment(kind, 'session')
+  const value = sanitizeRuntimeSegment(String(raw || '').trim(), '')
+  if (!value) return ''
+  return `${normalizedKind}-${value}`
+}
+
 function getActiveSessionPath(activationDir) {
   return join(activationDir, PROJECT_SESSIONS_DIR_NAME, ACTIVE_SESSION_FILE_NAME)
 }
 
+function removeLegacySessionPointersFile(activationDir) {
+  if (!activationDir) return
+  try {
+    rmSync(join(activationDir, PROJECT_SESSIONS_DIR_NAME, LEGACY_SESSION_POINTERS_FILE_NAME), { force: true })
+  } catch {}
+}
+
 function resolveActiveSessionToken({ activationDir, projectRoot, workspace, now = Date.now() } = {}) {
   const active = readJsonFile(getActiveSessionPath(activationDir), null)
   if (!active || typeof active !== 'object') return ''
@@ -377,14 +435,15 @@ function resolveActiveAliasSession({ activationDir, projectRoot, workspace, alia
 }
 
 export function writeActiveProjectSession(scope, { host = '', source = '', env = process.env } = {}) {
-  if (!scope?.active || !scope.activationDir || !scope.session) return ''
+  if (!scope?.active || !scope.activationDir || !scope.workspace) return ''
 
   const activePath = getActiveSessionPath(scope.activationDir)
   const current = readJsonFile(activePath, null) || {}
   const aliases = current.aliases && typeof current.aliases === 'object' ? current.aliases : {}
   const envToken = sanitizeRuntimeSegment(resolveEnvSessionToken(env), '')
   if (envToken && envToken !== scope.session) aliases[envToken] = scope.session
-
+  const aliasToken = sanitizeRuntimeSegment(resolveEnvSessionAliasToken(env), '')
+  if (aliasToken && aliasToken !== scope.session) aliases[aliasToken] = scope.session
   writeJsonFileAtomic(activePath, {
     version: 1,
     cwd: scope.cwd,
@@ -402,9 +461,14 @@ export function writeActiveProjectSession(scope, { host = '', source = '', env =
 
 function chooseProjectSession({ payload, env, activationDir, projectRoot, workspace }) {
   const payloadToken = sanitizeRuntimeSegment(resolvePayloadSessionToken(payload), '')
-  if (payloadToken) return { session: payloadToken, sessionMode: 'host-session' }
-
   const payloadAlias = sanitizeRuntimeSegment(payload?._helloagentsSessionAlias, '')
+  if (payloadToken) {
+    return {
+      session: buildScopedSessionToken('host', payloadToken),
+      sessionMode: 'host-session',
+    }
+  }
+
   const payloadAliasToken = resolveActiveAliasSession({
     activationDir,
     projectRoot,
@@ -412,8 +476,15 @@ function chooseProjectSession({ payload, env, activationDir, projectRoot, worksp
     alias: payloadAlias,
   })
   if (payloadAliasToken) return { session: payloadAliasToken, sessionMode: 'active-session' }
+  if (payloadAlias) {
+    return {
+      session: buildScopedSessionToken('alias', payloadAlias),
+      sessionMode: 'alias-session',
+    }
+  }
 
   const envToken = sanitizeRuntimeSegment(resolveEnvSessionToken(env), '')
+  const envAliasToken = sanitizeRuntimeSegment(resolveEnvSessionAliasToken(env), '')
   const aliasToken = resolveActiveAliasSession({
     activationDir,
     projectRoot,
@@ -422,12 +493,28 @@ function chooseProjectSession({ payload, env, activationDir, projectRoot, worksp
   })
   if (aliasToken) return { session: aliasToken, sessionMode: 'active-session' }
 
-  if (envToken) return { session: envToken, sessionMode: 'host-session' }
+  if (envToken) {
+    return {
+      session: buildScopedSessionToken('host', envToken),
+      sessionMode: 'host-session',
+    }
+  }
 
-  const activeToken = resolveActiveSessionToken({ activationDir, projectRoot, workspace })
-  if (activeToken) return { session: activeToken, sessionMode: 'active-session' }
+  if (envAliasToken) {
+    const activeAliasToken = resolveActiveAliasSession({
+      activationDir,
+      projectRoot,
+      workspace,
+      alias: envAliasToken,
+    })
+    if (activeAliasToken) return { session: activeAliasToken, sessionMode: 'active-session' }
+    return {
+      session: buildScopedSessionToken('alias', envAliasToken),
+      sessionMode: 'alias-session',
+    }
+  }
 
-  return { session: DEFAULT_STATE_SESSION_TOKEN, sessionMode: 'default' }
+  return { session: '', sessionMode: 'unidentified' }
 }
 
 function removeLegacyProjectArtifacts(activationDir) {
@@ -445,6 +532,7 @@ export function getProjectSessionScope(cwd, options = {}) {
   const { payload = {}, env = process.env } = normalizeRuntimeOptions(options)
   const activationDir = getProjectActivationDir(projectRoot)
   removeLegacyProjectArtifacts(activationDir)
+  removeLegacySessionPointersFile(activationDir)
   const workspace = resolveWorkspaceName(projectRoot)
   const { session, sessionMode } = chooseProjectSession({
     payload,
@@ -453,7 +541,8 @@ export function getProjectSessionScope(cwd, options = {}) {
     projectRoot,
     workspace,
   })
-  const sessionDir = join(activationDir, PROJECT_SESSIONS_DIR_NAME, workspace, session)
+  const workspaceDir = join(activationDir, PROJECT_SESSIONS_DIR_NAME, workspace)
+  const sessionDir = session ? join(workspaceDir, session) : join(workspaceDir, DEFAULT_STATE_SESSION_TOKEN)
 
   return {
     cwd: projectRoot,
@@ -464,10 +553,12 @@ export function getProjectSessionScope(cwd, options = {}) {
     sessionMode,
     activationDir,
     sessionDir,
+    workspaceDir,
     statePath: join(sessionDir, 'STATE.md'),
     eventsPath: join(sessionDir, EVENTS_FILE_NAME),
     artifactsDir: join(sessionDir, PROJECT_ARTIFACTS_DIR_NAME),
-    key: `${projectRoot}::${workspace}::${session}`,
+    runtimePath: join(sessionDir, PROJECT_RUNTIME_FILE_NAME),
+    key: `${projectRoot}::${workspace}::${session || DEFAULT_STATE_SESSION_TOKEN}`,
   }
 }
 
@@ -497,6 +588,7 @@ function buildTransientRuntimeDir(cwd, options = {}) {
     statePath: join(getUserRuntimeRoot(), hash, 'STATE.md'),
     eventsPath: join(getUserRuntimeRoot(), hash, EVENTS_FILE_NAME),
     artifactsDir: join(getUserRuntimeRoot(), hash, PROJECT_ARTIFACTS_DIR_NAME),
+    runtimePath: join(getUserRuntimeRoot(), hash, PROJECT_RUNTIME_FILE_NAME),
     key: `${normalizedCwd}::transient::${token}`,
   }
 }

package/scripts/session-capsule.mjs

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs'
 import { basename, dirname, join } from 'node:path'
 
 import {
@@ -31,6 +31,79 @@ function buildEmptyCapsule(scope) {
   }
 }
 
+function readRuntimeDocument(filePath) {
+  const payload = readJsonFile(filePath, null)
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+    return null
+  }
+  return payload
+}
+
+function writeRuntimeDocument(filePath, payload) {
+  writeJsonFileAtomic(filePath, payload)
+}
+
+function isSamePath(left = '', right = '') {
+  if (process.platform === 'win32') {
+    return left.toLowerCase() === right.toLowerCase()
+  }
+  return left === right
+}
+
+function isSeedOnlyState(body = '') {
+  return String(body || '').includes('由运行时自动创建；后续按实际任务重写')
+}
+
+function looksLikeLegacyFlattenedSessionDir(entryName = '') {
+  return /^[a-z0-9]{8}$/i.test(String(entryName || '').trim())
+}
+
+function migrateLegacyProjectScope(scope) {
+  if (scope.scope !== 'project-session') return
+  const workspaceDir = scope.workspaceDir || join(scope.activationDir, 'sessions', scope.workspace || scope.branch)
+  const legacyStatePath = join(workspaceDir, 'STATE.md')
+  const legacyRuntimePath = join(workspaceDir, 'runtime.json')
+  if (isSamePath(workspaceDir, scope.sessionDir)) return
+
+  const currentDocument = readStateDocument(scope.statePath)
+  const currentCapsule = currentDocument.metadata && typeof currentDocument.metadata === 'object'
+    ? currentDocument.metadata
+    : null
+  const legacyDocument = readStateDocument(legacyStatePath)
+  const legacyCapsule = readRuntimeDocument(legacyRuntimePath)
+  const shouldNormalizeCurrentBody = currentDocument.hasMetadata
+  const shouldWriteBody = (!currentDocument.body.trim() && legacyDocument.body.trim()) || shouldNormalizeCurrentBody
+  const shouldWriteRuntime = (legacyCapsule || currentCapsule) && !readRuntimeDocument(scope.runtimePath)
+
+  if (shouldWriteBody) {
+    writeStateDocument(scope.statePath, {
+      body: currentDocument.body.trim() ? currentDocument.body : legacyDocument.body,
+    })
+  }
+  if (shouldWriteRuntime) {
+    writeRuntimeDocument(scope.runtimePath, legacyCapsule || currentCapsule)
+  }
+
+  if (existsSync(legacyStatePath) && shouldWriteBody) {
+    const legacyCurrent = readStateDocument(legacyStatePath)
+    if (legacyCurrent.hasMetadata) {
+      writeStateDocument(legacyStatePath, {
+        body: legacyCurrent.body,
+      })
+    }
+  }
+  if (existsSync(legacyRuntimePath) && shouldWriteRuntime) {
+    rmSync(legacyRuntimePath, { force: true })
+  }
+  if (existsSync(workspaceDir)) {
+    for (const entry of readdirSync(workspaceDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue
+      if (!looksLikeLegacyFlattenedSessionDir(entry.name)) continue
+      rmSync(join(workspaceDir, entry.name), { recursive: true, force: true })
+    }
+  }
+}
+
 function normalizeOptions(options = {}) {
   if (!options || typeof options !== 'object') return {}
   if (options.payload && typeof options.payload === 'object') return options
@@ -84,7 +157,7 @@ function shouldMaterializeSessionState(options = {}) {
 }
 
 export function getSessionCapsulePath(cwd = process.cwd(), options = {}) {
-  return getScope(cwd, options).statePath
+  return getScope(cwd, options).runtimePath
 }
 
 export function getSessionEventsPath(cwd = process.cwd(), options = {}) {
@@ -102,15 +175,15 @@ export function getSessionArtifactPath(cwd, fileName, options = {}) {
 export function getSessionArtifactRelativePath(cwd, fileName, options = {}) {
   const scope = getScope(cwd, options)
   if (scope.scope === 'project-session') {
-    return `.helloagents/sessions/${scope.workspace || scope.branch}/${scope.session}/artifacts/${fileName}`
+    return `.helloagents/sessions/${scope.workspace || scope.branch}/${scope.session || 'default'}/artifacts/${fileName}`
   }
   return `~/.helloagents/runtime/${basename(scope.sessionDir)}/artifacts/${fileName}`
 }
 
 export function readSessionCapsule(cwd = process.cwd(), options = {}) {
   const scope = getScope(cwd, options)
-  const { metadata } = readStateDocument(scope.statePath)
-  const capsule = metadata && typeof metadata === 'object' ? metadata : null
+  migrateLegacyProjectScope(scope)
+  const capsule = readRuntimeDocument(scope.runtimePath)
   if (!capsule || Array.isArray(capsule)) return buildEmptyCapsule(scope)
   return {
     ...buildEmptyCapsule(scope),
@@ -128,6 +201,7 @@ export function readSessionCapsule(cwd = process.cwd(), options = {}) {
 export function writeSessionCapsule(cwd, capsule, options = {}) {
   const normalizedOptions = normalizeOptions(options)
   const scope = getScope(cwd, normalizedOptions)
+  migrateLegacyProjectScope(scope)
   const shouldMaterialize = shouldMaterializeSessionState(normalizedOptions)
   const currentDocument = readStateDocument(scope.statePath)
   const hasBody = Boolean(currentDocument.body && currentDocument.body.trim())
@@ -165,10 +239,12 @@ export function writeSessionCapsule(cwd, capsule, options = {}) {
     sessionMode: scope.sessionMode,
     updatedAt: new Date().toISOString(),
   }
-  writeStateDocument(scope.statePath, {
-    metadata: nextCapsule,
-    body: currentDocument.body,
-  })
+  writeRuntimeDocument(scope.runtimePath, nextCapsule)
+  if (hasBody) {
+    writeStateDocument(scope.statePath, {
+      body: currentDocument.body,
+    })
+  }
   writeActiveProjectSession(scope, {
     env: normalizedOptions.env,
   })
@@ -197,8 +273,8 @@ export function writeCapsuleSection(cwd, section, value, options = {}) {
 }
 
 export function clearCapsuleSection(cwd, section, options = {}) {
-  const statePath = getSessionCapsulePath(cwd, options)
-  if (!existsSync(statePath)) return false
+  const runtimePath = getSessionCapsulePath(cwd, options)
+  if (!existsSync(runtimePath)) return false
 
   const capsule = readSessionCapsule(cwd, options)
   if (!Object.prototype.hasOwnProperty.call(capsule, section)) return false
@@ -289,7 +365,11 @@ export function clearSessionArtifact(cwd, fileName, options = {}) {
 }
 
 export function removeSessionCapsule(cwd, options = {}) {
-  removeRuntimeFile(getSessionCapsulePath(cwd, options))
+  const scope = getScope(cwd, options)
+  removeRuntimeFile(scope.runtimePath)
+  if (scope.scope !== 'project-session') {
+    removeRuntimeFile(scope.statePath)
+  }
 }
 
 function shouldRecordSessionEvents(options = {}) {

package/scripts/session-token.mjs

@@ -45,6 +45,17 @@ const PROJECT_ENV_SESSION_KEYS = [
   'HELLOAGENTS_NOTIFY_SESSION_ID',
 ]
 
+const PROJECT_ALIAS_ENV_SESSION_KEYS = [
+  'HELLOAGENTS_NOTIFY_SESSION_ID',
+  'WT_SESSION',
+  'TERM_SESSION_ID',
+  'KITTY_WINDOW_ID',
+  'ALACRITTY_WINDOW_ID',
+  'WINDOWID',
+  'WEZTERM_PANE',
+  'TAB_ID',
+]
+
 function readStringCandidate(input, key) {
   if (!input || typeof input !== 'object') return ''
   const value = input[key]
@@ -99,9 +110,16 @@ export function resolveProjectSessionToken({
   return resolveTokenFromKeys(env, PROJECT_ENV_SESSION_KEYS)
 }
 
+export function resolveProjectSessionAliasToken({
+  env = process.env,
+} = {}) {
+  return resolveTokenFromKeys(env, PROJECT_ALIAS_ENV_SESSION_KEYS)
+}
+
 export {
   ENV_SESSION_KEYS,
   PAYLOAD_SESSION_KEYS,
+  PROJECT_ALIAS_ENV_SESSION_KEYS,
   PROJECT_ENV_SESSION_KEYS,
   PROJECT_PAYLOAD_SESSION_KEYS,
 }

package/scripts/state-document.mjs

@@ -3,6 +3,7 @@ import { dirname } from 'node:path'
 
 const STATE_META_BEGIN = '<!-- HELLOAGENTS_STATE_META'
 const STATE_META_END = 'HELLOAGENTS_STATE_META -->'
+export const AUTO_CREATED_STATE_MARKER = '由运行时自动创建；后续按实际任务重写'
 
 function normalizeText(content = '') {
   return String(content || '').replace(/^\uFEFF/, '')
@@ -62,13 +63,11 @@ export function readStateDocument(filePath) {
 
 export function composeStateDocument({ metadata = {}, body = '' } = {}) {
   const normalizedBody = normalizeText(body).replace(/^\n+/, '')
-  return [
-    STATE_META_BEGIN,
-    JSON.stringify(metadata, null, 2),
-    STATE_META_END,
-    '',
-    normalizedBody,
-  ].join('\n').replace(/\n+$/, '\n')
+  return normalizedBody ? `${normalizedBody.replace(/\n+$/, '')}\n` : ''
+}
+
+export function looksLikeAutoCreatedState(body = '') {
+  return normalizeText(body).includes(AUTO_CREATED_STATE_MARKER)
 }
 
 export function writeStateDocument(filePath, { metadata = {}, body = '' } = {}) {

package/scripts/turn-state.mjs

@@ -5,7 +5,6 @@ import { fileURLToPath } from 'node:url'
 import {
   appendSessionEvent,
   clearCapsuleSection,
-  getSessionCapsulePath,
   getRuntimeScope,
   readCapsuleSection,
   writeCapsuleSection,
@@ -108,7 +107,7 @@ export function readTurnState(cwd = process.cwd(), { now = Date.now(), ...option
   return {
     cwd: normalizePath(entry.cwd),
     key: entry.key || '',
-    path: getSessionCapsulePath(cwd, options),
+    path: getRuntimeScope(cwd, options).statePath,
     updatedAt: entry.updatedAt,
     ...normalized,
   }
@@ -288,7 +287,7 @@ function main() {
     const payload = writeTurnState(cwd, input)
     process.stdout.write(JSON.stringify({
       suppressOutput: true,
-      path: getSessionCapsulePath(cwd, input),
+      path: getRuntimeScope(cwd, input).statePath,
       payload,
     }))
     return

package/scripts/workflow-core.mjs

@@ -15,10 +15,7 @@ export function getTargetPlans(snapshot) {
 }
 
 function describeStateLabel(state) {
-  if (state.stateSessionMode === 'default') {
-    return '当前工作区默认位置的状态文件'
-  }
-  return '当前会话的状态文件'
+  return '当前工作区状态文件'
 }
 
 export function classifyPlan(plan) {

package/scripts/workflow-plan-files.mjs

@@ -188,7 +188,7 @@ export function readStateSnapshot(cwd, options = {}) {
     stateSessionToken: stateScope.stateSessionToken,
     stateSessionMode: stateScope.stateSessionMode,
     stateWorkspace: stateScope.stateWorkspace,
-    sessionScoped: stateScope.stateScope === 'session',
+    sessionScoped: true,
     exists,
     content,
     sections,