helloagents 3.0.25 → 3.0.26

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.25",
+  "version": "3.0.26",
   "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.25",
+  "version": "3.0.26",
   "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.25-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.26-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)
@@ -311,7 +311,7 @@ If you omit `--standby` or `--global`, HelloAGENTS first reuses the tracked/dete
 
 ### npm and one-shot script entries
 
-Use these when you do not want to depend on the `helloagents` binary being available during package updates. In `HELLOAGENTS=target[:mode]`, target can be `all`, `claude`, `gemini`, or `codex`; mode can be `standby` or `global`, and defaults to `standby`.
+Use these when you do not want to depend on the `helloagents` binary being available during package updates. In `HELLOAGENTS=target[:mode]`, target can be `all`, `claude`, `gemini`, or `codex`; mode can be `standby` or `global`. For install, an omitted mode is treated as `standby`. For update, cleanup, uninstall, and branch switching, an omitted mode is forwarded unchanged so HelloAGENTS can reuse the tracked or detected mode for that CLI first.
 
 Host configs use the stable `helloagents-js` entrypoint and runtime root `~/.helloagents/helloagents`, so Node global package paths can change without breaking managed hooks or Codex `notify`. Codex hooks use standalone `~/.codex/hooks.json` instead of adding large hook blocks to `config.toml`, and Codex global plugin roots plus plugin cache now link back to that same stable runtime root.
 
@@ -642,11 +642,12 @@ Default shape:
 Codex is rules-file driven by default.
 
 - standby writes `~/.codex/AGENTS.md`
-- standby writes a managed `model_instructions_file = "~/.codex/AGENTS.md"`
+- standby writes a portable managed `model_instructions_file = "~/.codex/AGENTS.md"`
 - standby writes a managed `notify = ["helloagents-js", "codex-notify"]` command for closeout notification
 - standby writes silent Codex hooks to `~/.codex/hooks.json`
 - Codex `SessionStart` stays silent and reads the current `~/.helloagents/helloagents.json` at runtime instead of baking a config snapshot into `config.toml`, so first-turn and post-compaction settings stay current
 - install and update also sync HelloAGENTS-managed Codex hook trust state in `~/.codex/config.toml`, so Codex 0.129.0+ does not re-prompt for the managed hooks
+- that hook trust state is machine-local generated metadata derived from the current absolute `~/.codex/hooks.json` path; unlike `model_instructions_file = "~/.codex/AGENTS.md"`, it is not portable config and should be regenerated on each machine
 - 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
 - cleanup removes only the HelloAGENTS-managed hook trust entries and legacy managed notify residues, while keeping user-owned hook state untouched
@@ -663,10 +664,10 @@ Run all tests:
 npm test
 ```
 
-The current suite includes 116 tests and covers:
+The current suite includes 118 tests and covers:
 
 - install, update, uninstall, cleanup, and mode switching
-- one-shot PowerShell lifecycle dispatch for install, update, cleanup, uninstall, and branch switching
+- one-shot PowerShell lifecycle dispatch plus shell-wrapper mode-routing rules for install, update, cleanup, uninstall, and branch switching
 - Claude, Gemini, and Codex config merge and restore behavior
 - 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

package/README_CN.md

@@ -8,7 +8,7 @@
 
 **面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
-[![Version](https://img.shields.io/badge/version-3.0.25-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.26-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)
@@ -311,7 +311,7 @@ helloagents codex goals enable
 
 ### npm 和一键脚本入口
 
-当你不想依赖更新过程中的 `helloagents` 可执行文件时，用 npm 或一键脚本。`HELLOAGENTS=目标[:模式]` 中，目标支持 `all`、`claude`、`gemini`、`codex`；模式支持 `standby`、`global`，省略时默认 `standby`。
+当你不想依赖更新过程中的 `helloagents` 可执行文件时，用 npm 或一键脚本。`HELLOAGENTS=目标[:模式]` 中，目标支持 `all`、`claude`、`gemini`、`codex`；模式支持 `standby`、`global`。用于安装时，省略模式按 `standby` 处理；用于更新、清理、卸载和切换分支时，省略模式会原样下传，让 HelloAGENTS 先复用该 CLI 已记录或检测到的模式。
 
 宿主配置使用稳定的 `helloagents-js` 入口和运行根目录 `~/.helloagents/helloagents`，Node 全局包路径变化不会破坏受管 hooks 或 Codex `notify`。Codex hooks 使用独立 `~/.codex/hooks.json`，不把大段配置写入 `config.toml`；Codex 全局插件根目录和插件缓存也会回链到这个稳定运行根目录。
 
@@ -644,11 +644,12 @@ UI 任务遵循以下优先级：
 Codex 默认走规则文件驱动。
 
 - 标准模式写入 `~/.codex/AGENTS.md`
-- 标准模式写入受管 `model_instructions_file = "~/.codex/AGENTS.md"`
+- 标准模式写入可移植的受管 `model_instructions_file = "~/.codex/AGENTS.md"`
 - 标准模式写入受管 `notify = ["helloagents-js", "codex-notify"]` 命令用于收尾通知
 - 标准模式把静默 Codex hooks 写入 `~/.codex/hooks.json`
 - Codex 的 `SessionStart` 保持静默，并在运行时读取当前 `~/.helloagents/helloagents.json`，不会把配置快照固化进 `config.toml`，因此首次对话和上下文压缩后的设置都能保持最新
 - 安装和更新还会把 HelloAGENTS 受管的 Codex hook trust 状态同步到 `~/.codex/config.toml`，因此 Codex 0.129.0+ 不会再对这些受管 hooks 反复提示确认
+- 这些 hook trust 状态是基于当前机器 `~/.codex/hooks.json` 真实绝对路径生成的本机状态；它不同于 `model_instructions_file = "~/.codex/AGENTS.md"` 这类可移植配置，应在每台机器上重新生成
 - 标准模式创建 `~/.codex/helloagents -> ~/.helloagents/helloagents`
 - 全局模式安装原生本地插件流程，但仍把 `~/.helloagents/helloagents` 作为唯一受管运行时源；插件根目录、插件缓存和 `~/.codex/helloagents` 都会回链到它
 - 清理时只删除 HelloAGENTS 自己写入的 hook trust 条目和旧式受管 notify 残留，不影响用户已有的 hook 状态
@@ -665,10 +666,10 @@ Codex 默认走规则文件驱动。
 npm test
 ```
 
-当前测试共 116 项，覆盖：
+当前测试共 118 项，覆盖：
 
 - 安装、更新、卸载、清理和模式切换
-- PowerShell 一键脚本的安装、更新、清理、卸载和分支切换分发链路
+- PowerShell 一键脚本分发链路，以及 shell 包装脚本在安装、更新、清理、卸载和分支切换中的模式传递规则
 - Claude、Gemini、Codex 的配置合并与恢复
 - Codex 受管 `model_instructions_file`、`notify`、`hooks.json`、hook trust 状态、本地插件、marketplace 和缓存行为
 - Windows 下 Codex 旧式受管 notify 变体的清理，以及受管 notify 恢复规则

package/bootstrap-lite.md

@@ -30,8 +30,8 @@
 ### 语言与表述（强制）
 - 所有用户可见文本，包括回复、生成文件、CLI 输出、运行时提示、模板内容、文档与说明，都必须遵守：简洁、自然、准确、合理、不赘述、不冗余、不过度精简
 - 准确优先于压缩：不得为了更短而省略必要的条件、边界、风险、状态、路径、验证结论或下一步动作
-- 不写黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
-- 不写无执行价值的客套、邀约、重复确认、能力陈述或空泛建议
+- 不输出黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
+- 不输出客套内容、邀约式表述、重复确认、能力陈述或空泛建议
 - 同一概念前后用语保持一致；先给结论再给细节，避免同义反复、重复解释和堆砌近义句
 - 优化既有约束或文案时，优先在原条目内收敛表达；只有边界独立且原条目无法承载时才新增条目，并同步删除重复表述
 

package/bootstrap.md

@@ -30,8 +30,8 @@
 ### 语言与表述（强制）
 - 所有用户可见文本，包括回复、生成文件、CLI 输出、运行时提示、模板内容、文档与说明，都必须遵守：简洁、自然、准确、合理、不赘述、不冗余、不过度精简
 - 准确优先于压缩：不得为了更短而省略必要的条件、边界、风险、状态、路径、验证结论或下一步动作
-- 不写黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
-- 不写无执行价值的客套、邀约、重复确认、能力陈述或空泛建议
+- 不输出黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
+- 不输出客套内容、邀约式表述、重复确认、能力陈述或空泛建议
 - 同一概念前后用语保持一致；先给结论再给细节，避免同义反复、重复解释和堆砌近义句
 - 优化既有约束或文案时，优先在原条目内收敛表达；只有边界独立且原条目无法承载时才新增条目，并同步删除重复表述
 

package/gemini-extension.json

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

package/install.ps1

@@ -26,15 +26,14 @@ if ($env:HELLOAGENTS) {
 }
 
 if (-not $Target) { $Target = "all" }
-if (-not $Mode) { $Mode = "standby" }
 $Target = $Target.ToLowerInvariant()
-$Mode = $Mode.ToLowerInvariant()
+if ($Mode) { $Mode = $Mode.ToLowerInvariant() }
 
 if (@("all", "claude", "gemini", "codex") -notcontains $Target) {
     throw "Unsupported HELLOAGENTS target: $Target"
 }
 
-if (@("standby", "global") -notcontains $Mode) {
+if ($Mode -and @("standby", "global") -notcontains $Mode) {
     throw "Unsupported HELLOAGENTS mode: $Mode"
 }
 
@@ -57,16 +56,23 @@ function Invoke-Npm {
 function Enable-PostinstallDeploy {
     $env:HELLOAGENTS_DEPLOY = "1"
     $env:HELLOAGENTS_TARGET = $Target
-    $env:HELLOAGENTS_MODE = $Mode
+    if ($Mode) {
+        $env:HELLOAGENTS_MODE = $Mode
+    } else {
+        $env:HELLOAGENTS_MODE = "standby"
+    }
 }
 
 function Invoke-HostScript {
     param([string]$ScriptName)
+    $scriptArgs = @("explore", "-g", "helloagents", "--", "npm", "run", $ScriptName, "--")
     if ($Target -eq "all") {
-        Invoke-Npm -NpmArgs @("explore", "-g", "helloagents", "--", "npm", "run", $ScriptName, "--", "--all", "--$Mode")
+        $scriptArgs += "--all"
     } else {
-        Invoke-Npm -NpmArgs @("explore", "-g", "helloagents", "--", "npm", "run", $ScriptName, "--", $Target, "--$Mode")
+        $scriptArgs += $Target
     }
+    if ($Mode) { $scriptArgs += "--$Mode" }
+    Invoke-Npm -NpmArgs $scriptArgs
 }
 
 function Sync-Hosts {

package/install.sh

@@ -32,7 +32,6 @@ if [ -n "${HELLOAGENTS:-}" ]; then
 fi
 
 TARGET="${TARGET:-all}"
-MODE="${MODE:-standby}"
 TARGET="$(printf '%s' "$TARGET" | tr '[:upper:]' '[:lower:]')"
 MODE="$(printf '%s' "$MODE" | tr '[:upper:]' '[:lower:]')"
 
@@ -41,10 +40,12 @@ case "$TARGET" in
   *) echo "Unsupported HELLOAGENTS target: $TARGET" >&2; exit 1 ;;
 esac
 
-case "$MODE" in
-  standby|global) ;;
-  *) echo "Unsupported HELLOAGENTS mode: $MODE" >&2; exit 1 ;;
-esac
+if [ -n "$MODE" ]; then
+  case "$MODE" in
+    standby|global) ;;
+    *) echo "Unsupported HELLOAGENTS mode: $MODE" >&2; exit 1 ;;
+  esac
+fi
 
 if [ -z "$PACKAGE" ]; then
   if [ -n "$BRANCH" ]; then
@@ -56,32 +57,56 @@ fi
 
 sync_hosts() {
   if [ "$TARGET" = "all" ]; then
-    npm explore -g helloagents -- npm run sync-hosts -- --all "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run sync-hosts -- --all "--$MODE"
+    else
+      npm explore -g helloagents -- npm run sync-hosts -- --all
+    fi
   else
-    npm explore -g helloagents -- npm run sync-hosts -- "$TARGET" "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run sync-hosts -- "$TARGET" "--$MODE"
+    else
+      npm explore -g helloagents -- npm run sync-hosts -- "$TARGET"
+    fi
   fi
 }
 
 cleanup_hosts() {
   if [ "$TARGET" = "all" ]; then
-    npm explore -g helloagents -- npm run cleanup-hosts -- --all "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run cleanup-hosts -- --all "--$MODE"
+    else
+      npm explore -g helloagents -- npm run cleanup-hosts -- --all
+    fi
   else
-    npm explore -g helloagents -- npm run cleanup-hosts -- "$TARGET" "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run cleanup-hosts -- "$TARGET" "--$MODE"
+    else
+      npm explore -g helloagents -- npm run cleanup-hosts -- "$TARGET"
+    fi
   fi
 }
 
 uninstall_hosts() {
   if [ "$TARGET" = "all" ]; then
-    npm explore -g helloagents -- npm run uninstall -- --all "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run uninstall -- --all "--$MODE"
+    else
+      npm explore -g helloagents -- npm run uninstall -- --all
+    fi
   else
-    npm explore -g helloagents -- npm run uninstall -- "$TARGET" "--$MODE"
+    if [ -n "$MODE" ]; then
+      npm explore -g helloagents -- npm run uninstall -- "$TARGET" "--$MODE"
+    else
+      npm explore -g helloagents -- npm run uninstall -- "$TARGET"
+    fi
   fi
 }
 
 enable_postinstall_deploy() {
   export HELLOAGENTS_DEPLOY=1
   export HELLOAGENTS_TARGET="$TARGET"
-  export HELLOAGENTS_MODE="$MODE"
+  export HELLOAGENTS_MODE="${MODE:-standby}"
 }
 
 case "$ACTION" in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.25",
+  "version": "3.0.26",
   "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-codex-hooks-state.mjs

@@ -25,6 +25,13 @@ const EVENTS_WITH_MATCHER = new Set([
   'SessionStart',
 ])
 
+// Codex persists hook trust under `[hooks.state."<key>"]`, where the key is
+// derived from the discovered hooks.json absolute path plus event/group/handler
+// indexes. That makes hook trust machine-local materialized state rather than a
+// portable config value. Keep portable config such as
+// `model_instructions_file = "~/.codex/AGENTS.md"` separate from this generated
+// trust metadata and regenerate it on each machine during install/update.
+
 const HOOK_STATE_HEADER_RE = /^\[hooks\.state\."((?:\\.|[^"])*)"\](?:\s*#.*)?$/
 
 function normalizeLineEndings(text = '') {

package/scripts/cli-doctor-codex.mjs

@@ -106,8 +106,8 @@ function appendCodexStandbyIssues(runtime, issues, checks) {
   if (!checks.codexHooksFeature) issues.push(buildDoctorIssue(runtime, 'codex-hooks-feature-disabled', 'Codex hooks 功能被显式关闭', 'Codex hooks feature is explicitly disabled'))
   if (!checks.standaloneHooks) issues.push(buildDoctorIssue(runtime, 'standby-hooks-missing', 'standby `~/.codex/hooks.json` 缺少 HelloAGENTS hooks', 'Standby `~/.codex/hooks.json` is missing HelloAGENTS hooks'))
   if (checks.standaloneHooks && !checks.standaloneHooksMatch) issues.push(buildDoctorIssue(runtime, 'standby-hooks-drift', 'standby `~/.codex/hooks.json` 与当前 hooks-codex.json 不一致', 'Standby `~/.codex/hooks.json` differs from the current hooks-codex.json'))
-  if (checks.standaloneHooks && !checks.managedHookTrust) issues.push(buildDoctorIssue(runtime, 'standby-hook-trust-missing', 'standby `config.toml` 缺少 HelloAGENTS hooks trust', 'Standby `config.toml` is missing HelloAGENTS hook trust metadata'))
-  if (checks.standaloneHooks && checks.managedHookTrust && !checks.managedHookTrustMatch) issues.push(buildDoctorIssue(runtime, 'standby-hook-trust-drift', 'standby hooks trust 与当前 hooks 定义不一致', 'Standby hook trust metadata differs from the current hooks definition'))
+  if (checks.standaloneHooks && !checks.managedHookTrust) issues.push(buildDoctorIssue(runtime, 'standby-hook-trust-missing', 'standby `config.toml` 缺少 HelloAGENTS hooks trust 本机状态', 'Standby `config.toml` is missing HelloAGENTS machine-local hook trust metadata'))
+  if (checks.standaloneHooks && checks.managedHookTrust && !checks.managedHookTrustMatch) issues.push(buildDoctorIssue(runtime, 'standby-hook-trust-drift', 'standby hooks trust 本机状态与当前 hooks 定义或本机路径不一致', 'Standby machine-local hook trust metadata differs from the current hooks definition or local path'))
   if (checks.pluginRoot || checks.pluginCache || checks.marketplaceEntry || checks.pluginEnabled) {
     issues.push(buildDoctorIssue(runtime, 'standby-global-residue', 'standby 模式下仍残留 global 插件文件或配置', 'Global plugin artifacts still remain while Codex is in standby mode'))
   }
@@ -132,8 +132,8 @@ function appendCodexGlobalIssues(runtime, issues, checks, pluginVersion, cacheVe
   if (!checks.codexHooksFeature) issues.push(buildDoctorIssue(runtime, 'codex-hooks-feature-disabled', 'Codex hooks 功能被显式关闭', 'Codex hooks feature is explicitly disabled'))
   if (!checks.standaloneHooks) issues.push(buildDoctorIssue(runtime, 'global-hooks-missing', 'global `~/.codex/hooks.json` 缺少 HelloAGENTS hooks', 'Global `~/.codex/hooks.json` is missing HelloAGENTS hooks'))
   if (checks.standaloneHooks && !checks.standaloneHooksMatch) issues.push(buildDoctorIssue(runtime, 'global-hooks-drift', 'global `~/.codex/hooks.json` 与当前 hooks-codex.json 不一致', 'Global `~/.codex/hooks.json` differs from the current hooks-codex.json'))
-  if (checks.standaloneHooks && !checks.managedHookTrust) issues.push(buildDoctorIssue(runtime, 'global-hook-trust-missing', 'global `config.toml` 缺少 HelloAGENTS hooks trust', 'Global `config.toml` is missing HelloAGENTS hook trust metadata'))
-  if (checks.standaloneHooks && checks.managedHookTrust && !checks.managedHookTrustMatch) issues.push(buildDoctorIssue(runtime, 'global-hook-trust-drift', 'global hooks trust 与当前 hooks 定义不一致', 'Global hook trust metadata differs from the current hooks definition'))
+  if (checks.standaloneHooks && !checks.managedHookTrust) issues.push(buildDoctorIssue(runtime, 'global-hook-trust-missing', 'global `config.toml` 缺少 HelloAGENTS hooks trust 本机状态', 'Global `config.toml` is missing HelloAGENTS machine-local hook trust metadata'))
+  if (checks.standaloneHooks && checks.managedHookTrust && !checks.managedHookTrustMatch) issues.push(buildDoctorIssue(runtime, 'global-hook-trust-drift', 'global hooks trust 本机状态与当前 hooks 定义或本机路径不一致', 'Global machine-local hook trust metadata differs from the current hooks definition or local path'))
   if (pluginVersion && !checks.pluginVersionMatch) issues.push(buildDoctorIssue(runtime, 'global-plugin-version-drift', 'global 插件根目录版本与当前包版本不一致', 'Global plugin root version does not match the current package version'))
   if (cacheVersion && !checks.pluginCacheVersionMatch) issues.push(buildDoctorIssue(runtime, 'global-plugin-cache-version-drift', 'global 插件缓存版本与当前包版本不一致', 'Global plugin cache version does not match the current package version'))
 }

package/scripts/cli-messages.mjs

@@ -110,7 +110,7 @@ ${msg('分支切换', 'Branch switching')}:
 ${msg('诊断', 'Diagnostics')}:
   helloagents doctor
   helloagents doctor codex --json
-  ${msg('检查 carrier、链接、hooks、配置注入、Codex 插件安装、受管 model_instructions_file 指向与版本漂移', 'Checks carriers, links, hooks, config injections, Codex plugin installation, managed model_instructions_file targeting, and version drift')}
+  ${msg('检查 carrier、链接、hooks、配置注入、Codex 插件安装、受管 model_instructions_file 指向、Codex hook trust 本机状态与版本漂移', 'Checks carriers, links, hooks, config injections, Codex plugin installation, managed model_instructions_file targeting, machine-local Codex hook trust state, and version drift')}
 
 ${msg('Codex /goal', 'Codex /goal')}:
   helloagents codex goals status