helloagents 3.0.18-beta.1 → 3.0.19-beta.1

package/.claude-plugin/plugin.json

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

package/.codex-plugin/plugin.json

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

package/README.md

@@ -8,7 +8,7 @@
 
 **A workflow layer for AI coding CLIs: skills, project knowledge, delivery checks, safer config writes, and resumable execution.**
 
-[![Version](https://img.shields.io/badge/version-3.0.18-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.19-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)
@@ -179,6 +179,8 @@ For `~prd`, HelloAGENTS also creates PRD files such as:
 
 `contract.json` is used by the workflow to decide verification scope, reviewer/tester focus, optional advisor checks, and optional visual validation.
 
+`tasks.md` also includes a Codex `/goal` entry. For long-running Codex work, use that prepared entry instead of giving `/goal` a raw product document. HelloAGENTS keeps `/goal` as Codex-native continuation and budget control, while plan files, task boundaries, verification, and closeout remain controlled by HelloAGENTS.
+
 ### 5) State and recovery
 
 Long tasks need a small recovery snapshot, but one shared state file is not safe enough for concurrent work.
@@ -288,6 +290,8 @@ helloagents switch-branch beta
 helloagents switch-branch beta claude --global
 helloagents doctor
 helloagents doctor codex --json
+helloagents codex goals status
+helloagents codex goals enable
 ```
 
 Supported targets:
@@ -303,7 +307,7 @@ If you omit `--standby` or `--global`, HelloAGENTS first reuses the tracked/dete
 
 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`.
 
-Host configs use the stable `helloagents-js.cmd` entrypoint and runtime root `~/.helloagents/helloagents`, so Node global package paths can change without breaking managed hooks or Codex `notify`. The same managed `config.toml` works across Windows, macOS, and Linux.
+Host configs use the stable `helloagents-js.cmd` 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`.
 
 #### npm commands
 
@@ -421,7 +425,7 @@ npm uninstall -g helloagents
 |-----|--------------------------|------------------|
 | Claude Code | `~/.claude/CLAUDE.md`, `~/.claude/settings.json`, `~/.claude/helloagents -> ~/.helloagents/helloagents` | removes managed marker block, HelloAGENTS hooks/permissions, and symlink |
 | Gemini CLI | `~/.gemini/GEMINI.md`, `~/.gemini/settings.json`, `~/.gemini/helloagents -> ~/.helloagents/helloagents` | removes managed marker block, HelloAGENTS hooks, and symlink |
-| Codex CLI | `~/.codex/AGENTS.md`, `~/.codex/config.toml`, `~/.codex/helloagents -> ~/.helloagents/helloagents`, managed backups | removes managed marker block, managed config keys, symlink, and the latest managed backup |
+| Codex CLI | `~/.codex/AGENTS.md`, `~/.codex/config.toml`, `~/.codex/hooks.json`, `~/.codex/helloagents -> ~/.helloagents/helloagents`, managed backups | removes managed marker block, managed config keys, managed hooks, symlink, and the latest managed backup |
 
 ### Global mode files
 
@@ -429,7 +433,7 @@ npm uninstall -g helloagents
 |-----|----------------|----------------|
 | Claude Code | native plugin install | managed by Claude Code plugin system |
 | Gemini CLI | native extension install | managed by Gemini extension system |
-| Codex CLI | native local-plugin chain | `~/.agents/plugins/marketplace.json`, `~/plugins/helloagents/`, `~/.codex/plugins/cache/local-plugins/helloagents/local/`, `~/.codex/config.toml`, `~/.codex/helloagents -> ~/plugins/helloagents` |
+| Codex CLI | native local-plugin chain | `~/.agents/plugins/marketplace.json`, `~/plugins/helloagents/`, `~/.codex/plugins/cache/local-plugins/helloagents/local/`, `~/.codex/config.toml`, `~/.codex/hooks.json`, `~/.codex/helloagents -> ~/plugins/helloagents` |
 
 In global mode, HelloAGENTS now attempts the host-native install commands automatically. If a host command is unavailable, run the same commands manually:
 
@@ -631,9 +635,12 @@ 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 managed `notify = ["helloagents-js.cmd", "codex-notify"]` command for closeout notification
+- standby writes silent Codex hooks to `~/.codex/hooks.json`
 - standby creates `~/.codex/helloagents -> ~/.helloagents/helloagents`
-- global mode installs the native local-plugin chain
-- HelloAGENTS does not enable Codex hooks by default
+- global mode installs the native local-plugin chain and also loads silent hooks from `~/.codex/hooks.json`
+- Codex hooks only synchronize runtime state and enforce Stop gates; they do not inject bootstrap or route text through hook output
+- `/goal` remains Codex-native. Enable it explicitly with `helloagents codex goals enable` when long-running plan execution is needed
+- Goal-aware commands resume from `tasks.md`, `contract.json`, and `state_path`; they do not create goals automatically or mark them complete before HelloAGENTS verification and closeout
 
 ## Verification
 
@@ -647,7 +654,8 @@ The current test suite covers:
 
 - install, update, uninstall, cleanup, and mode switching
 - Claude, Gemini, and Codex config merge and restore behavior
-- Codex managed `model_instructions_file`, `notify`, local plugin, marketplace, and cache behavior
+- Codex managed `model_instructions_file`, `notify`, `hooks.json`, local plugin, marketplace, and cache behavior
+- 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
@@ -681,9 +689,9 @@ Use `~init` when you also want project-level rule files and project-level HelloA
 
 `global` applies full rules broadly. Claude and Gemini use native plugin/extension installs. Codex uses the local-plugin path.
 
-### Why does Codex not use hooks by default?
+### Do Codex hooks show injected content?
 
-The current Codex integration is more predictable with managed rules files, `model_instructions_file`, `notify`, and local plugins. Hooks can still show output in the TUI, so HelloAGENTS does not enable Codex hooks by default.
+No bootstrap or route text is injected through hooks. HelloAGENTS Codex hooks only write runtime state and enforce Stop gates; successful hooks stay quiet, while blocked or failed hooks show the necessary reason.
 
 ### Can I turn off notifications or guard checks?
 

package/README_CN.md

@@ -8,7 +8,7 @@
 
 **面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
-[![Version](https://img.shields.io/badge/version-3.0.18-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.19-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)
@@ -179,6 +179,8 @@ HelloAGENTS 可以在 `.helloagents/` 下创建和维护项目知识库。
 
 `contract.json` 会影响验证范围、reviewer/tester 关注点、可选 advisor 检查和可选视觉验收。
 
+`tasks.md` 还会保留 Codex `/goal` 执行入口。长程 Codex 任务应使用这个已拆分入口，不要把原始产品文档直接交给 `/goal`。HelloAGENTS 保持 `/goal` 的 Codex 原生定位，只把它作为续跑和预算控制；方案文件、任务边界、验证与收尾仍由 HelloAGENTS 负责。
+
 ### 5）状态与恢复
 
 长任务需要一个小型恢复快照，但多个对话共用一个状态文件并不安全。
@@ -288,6 +290,8 @@ helloagents switch-branch beta
 helloagents switch-branch beta claude --global
 helloagents doctor
 helloagents doctor codex --json
+helloagents codex goals status
+helloagents codex goals enable
 ```
 
 支持的目标：
@@ -303,7 +307,7 @@ helloagents doctor codex --json
 
 当你不想依赖更新过程中的 `helloagents` 可执行文件时，用 npm 或一键脚本。`HELLOAGENTS=目标[:模式]` 中，目标支持 `all`、`claude`、`gemini`、`codex`；模式支持 `standby`、`global`，省略时默认 `standby`。
 
-宿主配置使用稳定的 `helloagents-js.cmd` 入口和运行根目录 `~/.helloagents/helloagents`，Node 全局包路径变化不会破坏受管 hooks 或 Codex `notify`。同一份受管 `config.toml` 可在 Windows、macOS 和 Linux 之间同步。
+宿主配置使用稳定的 `helloagents-js.cmd` 入口和运行根目录 `~/.helloagents/helloagents`，Node 全局包路径变化不会破坏受管 hooks 或 Codex `notify`。Codex hooks 使用独立 `~/.codex/hooks.json`，不把大段配置写入 `config.toml`。
 
 #### npm 命令
 
@@ -421,7 +425,7 @@ npm uninstall -g helloagents
 |-----|------------------|----------|
 | Claude Code | `~/.claude/CLAUDE.md`、`~/.claude/settings.json`、`~/.claude/helloagents -> ~/.helloagents/helloagents` | 删除受管标记块、HelloAGENTS hooks / 权限和符号链接 |
 | Gemini CLI | `~/.gemini/GEMINI.md`、`~/.gemini/settings.json`、`~/.gemini/helloagents -> ~/.helloagents/helloagents` | 删除受管标记块、HelloAGENTS hooks 和符号链接 |
-| Codex CLI | `~/.codex/AGENTS.md`、`~/.codex/config.toml`、`~/.codex/helloagents -> ~/.helloagents/helloagents`、受管备份 | 删除受管标记块、受管配置键、符号链接和最近一次受管备份 |
+| Codex CLI | `~/.codex/AGENTS.md`、`~/.codex/config.toml`、`~/.codex/hooks.json`、`~/.codex/helloagents -> ~/.helloagents/helloagents`、受管备份 | 删除受管标记块、受管配置键、受管 hooks、符号链接和最近一次受管备份 |
 
 ### 全局模式文件
 
@@ -429,7 +433,7 @@ npm uninstall -g helloagents
 |-----|----------|----------|
 | Claude Code | 原生插件安装 | 由 Claude Code 插件系统管理 |
 | Gemini CLI | 原生扩展安装 | 由 Gemini 扩展系统管理 |
-| Codex CLI | 原生本地插件流程 | `~/.agents/plugins/marketplace.json`、`~/plugins/helloagents/`、`~/.codex/plugins/cache/local-plugins/helloagents/local/`、`~/.codex/config.toml`、`~/.codex/helloagents -> ~/plugins/helloagents` |
+| Codex CLI | 原生本地插件流程 | `~/.agents/plugins/marketplace.json`、`~/plugins/helloagents/`、`~/.codex/plugins/cache/local-plugins/helloagents/local/`、`~/.codex/config.toml`、`~/.codex/hooks.json`、`~/.codex/helloagents -> ~/plugins/helloagents` |
 
 全局模式下，HelloAGENTS 会自动尝试宿主原生命令。若宿主命令不可用，再手动执行：
 
@@ -633,9 +637,12 @@ Codex 默认走规则文件驱动。
 - 标准模式写入 `~/.codex/AGENTS.md`
 - 标准模式写入受管 `model_instructions_file = "~/.codex/AGENTS.md"`
 - 标准模式写入受管 `notify = ["helloagents-js.cmd", "codex-notify"]` 命令用于收尾通知
+- 标准模式把静默 Codex hooks 写入 `~/.codex/hooks.json`
 - 标准模式创建 `~/.codex/helloagents -> ~/.helloagents/helloagents`
-- 全局模式安装原生本地插件流程
-- HelloAGENTS 默认不启用 Codex hooks
+- 全局模式安装原生本地插件流程，并同样用 `~/.codex/hooks.json` 加载静默 hooks
+- Codex hooks 只做静默运行态同步和 Stop 门禁，不通过 hook 注入 bootstrap 或路由说明
+- `/goal` 保持 Codex 原生能力；需要长程执行时，用 `helloagents codex goals enable` 显式启用
+- 感知 goal 的命令从 `tasks.md`、`contract.json` 和 `state_path` 恢复；不会自动创建 goal，也不会在 HelloAGENTS 验证和收尾前标记完成
 
 ## 验证
 
@@ -649,7 +656,8 @@ npm test
 
 - 安装、更新、卸载、清理和模式切换
 - Claude、Gemini、Codex 的配置合并与恢复
-- Codex 受管 `model_instructions_file`、`notify`、本地插件、marketplace 和缓存行为
+- Codex 受管 `model_instructions_file`、`notify`、`hooks.json`、本地插件、marketplace 和缓存行为
+- Codex `/goal` 功能开关、长程路由上下文和 goal 感知命令契约
 - `helloagents doctor`
 - 项目存储和 `repo-shared`
 - 会话级 `state_path`、运行态信号和证据
@@ -683,9 +691,9 @@ npm test
 
 `global` 默认更广泛地启用完整规则。Claude 和 Gemini 使用原生插件 / 扩展；Codex 使用本地插件路径。
 
-### 为什么 Codex 默认不用 hooks？
+### Codex hooks 会显示注入内容吗？
 
-当前 Codex 集成使用规则文件、`model_instructions_file`、`notify` 和本地插件更稳定。hooks 输出仍可能显示在 TUI 中，因此 HelloAGENTS 默认不启用 Codex hooks。
+不会显示 bootstrap 或路由说明。HelloAGENTS 的 Codex hooks 只写运行态和执行 Stop 门禁，成功路径返回静默结果；只有阻塞或错误时显示必要原因。
 
 ### 可以关闭通知或 Guard 吗？
 

package/bootstrap-lite.md

@@ -35,9 +35,8 @@
 - 同一概念前后用语保持一致；先给结论再给细节，避免同义反复、重复解释和堆砌近义句
 
 ### 完整交付（强制）
-- 一次做完：用户需求明确且已获得执行授权时，必须一次性完成所有步骤再回复。只有符合下文“阻塞判定”的情况，才可中途停下
-- 授权优先执行：用户已明确同意当前方案、修改方向或继续执行时，直接继续。不得把已授权的后续动作改写为建议、可选项或等待确认
-- 直接推进：可直接继续执行时直接继续，不用“下一步建议”代替实际执行
+- 一次做完：用户需求明确且已获得执行授权时，必须持续执行到完成；只有符合下文“阻塞判定”的情况，才可中途停下
+- 直接推进：用户已明确同意方案、修改方向或继续执行时，直接执行；不得把可执行动作改写为建议、可选项、等待确认，也不用“下一步建议”代替实际执行
 
 ### 技术选型原则（全阶段生效）
 选择技术栈时，遵循以下思维框架而非固定方案：
@@ -116,8 +115,8 @@
 图标：💡直接响应 | ⚡快速执行 | 🔵规划流程 | ✅完成 | ❓等待输入 | ⚠️警告 | ❌错误
 
 使用约束：
-- 首行必须保留 `【HelloAGENTS】` 和连字符 `-`，不得省略；状态图标与收尾内容必须一致。正文仍在等待用户输入、确认、授权或补充信息（含确认是否执行已给出的方案）时，只能使用 `❓等待输入`；仅在本轮执行已完成且不存在待确认动作时，才能使用 `✅完成`。
-- `🔄 下一步` 必须写真实下一步，不改写成条件式能力表述或空泛询问。若正在等待确认，写清待确认动作；若存在自然后续动作，直接给出明确引导；若当前任务已完整结束且确无合理后续，可填写“当前任务已完成；无后续动作。”
+- 首行必须保留 `【HelloAGENTS】` 和连字符 `-`，不得省略；状态图标与收尾内容必须一致。正文仍在等待用户输入、确认、授权或补充信息（含确认是否执行已给出的方案或修改）时，只能使用 `❓等待输入`；仅在本轮执行已完成且不存在待确认动作时，才能使用 `✅完成`。
+- `🔄 下一步` 必须写真正的下一步动作，不写单纯当前状态或条件式能力表述。若正在等待确认，写清待确认动作；若仍有已授权且可继续执行的动作，不得收尾，必须继续执行；若当前任务已完整结束且确无合理后续，可填写“当前任务已完成；无后续动作。”
 
 ### 收尾状态信号
 - `turn-state` 只在运行时必须识别本轮“完成 / 等待输入 / 阻塞”时写入；普通问候、普通问答、T0 只读分析和一次性解释不调用
@@ -127,7 +126,7 @@
 - 因阻塞判定等待用户输入、确认、授权或补充信息（含未授权的外部副作用确认） → 写 `kind=waiting`、`role=main`，并同时写 `reasonCategory` 与 `reason`
 - 因错误、缺少前置条件或外部依赖而本轮停下 → 写 `kind=blocked`、`role=main`，并同时写 `reasonCategory` 与 `reason`
 - `reasonCategory` 只允许：`ambiguity`、`missing-input`、`missing-file`、`missing-credential`、`unauthorized-side-effect`、`high-risk-confirmation`、`external-dependency`、`error`
-- 显式 `~auto` / `~loop` 下，`waiting` / `blocked` 还必须写入 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`；阶段汇报、单轮 probe 完成、内部路线调整或“下一步建议”不构成停下理由
+- 显式 `~auto` / `~loop` 下，`waiting` / `blocked` 还必须写入 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`；阶段汇报、单轮探测完成、路线调整或“下一步建议”不构成停下理由
 - 子代理不得写 turn-state；子代理结束只直接返回结果，不为主代理代写完成态
 
 ## 交互规则
@@ -135,7 +134,7 @@
 ### 选择确认
 需要用户选择或确认时：
 - 确认必须对应当前阻塞执行的唯一决策，不得用确认替代本可直接执行的步骤
-- 用户已明确同意当前方案、修改方向或继续执行时，直接继续，不再追加确认环节
+- 已获得明确同意时，不再追加确认环节
 - 每次只问一个问题，偏好选择题，根据用户回答动态决定下一个问题
 - 需要同时确认多个相关类别时，用"— "前缀标题标明类别，编号从 1 开始连续不重置
 - 推荐选项标注（推荐）并给出理由
@@ -167,7 +166,7 @@
 - 缺少继续执行所必需的信息、文件、路径或凭据
 - 将产生外部副作用，但本轮尚未获得对应授权（含等待确认是否实施已给方案）
 - 操作属于高风险或不可逆，按安全规则必须确认
-除上述情况外，默认继续执行，不以“建议下一步”替代实际推进。
+除上述情况外，默认继续执行。
 
 ### 结构化输出
 以下内容使用结构化格式并逐项换行显示，不压缩为一行或一段：
@@ -180,14 +179,15 @@
 
 ## 交付分层（Delivery Tier）
 - `T0` — 只读分析、创意探索、方案比较 → 自然响应或 `~idea`
-- `T1` — 低风险小改动、明确实现、显式验证 → 直接执行或 `~build` / `~verify`
-- `T2` — 多文件功能、新项目、需要结构化产物 → `~plan` 或 `~auto`
+- `T1` — 低风险小改动、明确实现、显式验证、单文件或局部改动 → 直接执行或 `~build` / `~verify`
+- `T2` — 新项目、从零构建、3+ 文件新功能、架构级变更或需要结构化产物 → `~plan` 或 `~auto`
 - `T3` — 高风险或不可逆操作（权限、安全、支付、数据库、生产发布等）→ 先 `~plan` / `~prd`，再 `~build` / `~verify`
 
 ## 完成约束
 - 未激活项目且未进入方案包 / `contract.json` / 证据文件时，声称完成前必须完成与任务类型匹配的必要检查；无法执行的检查必须明确说明，不得直接宣称完成
 - 当前项目已激活，或已存在方案包 / `contract.json` / 证据文件时，以完整流程、对应 skill 与运行时交付约束为准，不得降级为本节
 - 只读分析、创意探索、方案比较、中间进度和阻塞汇报不适用本节
+- Codex `/goal` 只作为外层长程续跑与预算控制；HelloAGENTS 仍负责方案、执行、验证和收尾。若 active goal 的目标已全部完成，先完成 HelloAGENTS 验证、delivery gate 与本地版本检查点，再调用 `update_goal` 标记 complete；不得因预算接近耗尽、单轮结束或准备停下而标记 complete
 - 本地版本检查点：非只读任务完成验证且产生工作区变更时，最终收尾前自动执行本地提交。先检查 `git status --short`；若不是 git 仓库或无变更则跳过。若发现 `.env`、密钥、凭据、明显不应提交的大文件或二进制产物，停止提交并说明风险；否则执行 `git add -A`，使用当前回复语言生成简洁 conventional commit message 后执行 `git commit`。不自动远程 `git push`，除非用户明确要求
 
 ## 路由
@@ -200,7 +200,7 @@
   - 宿主固定链接（Codex `~/.codex/helloagents`、Claude `~/.claude/helloagents`、Gemini `~/.gemini/helloagents`）只作为兼容别名，不作为优先探测路径
   - 仍无法确定时，明确说明缺少 HelloAGENTS 读取根目录；不要递归扫描 `$HOME`、`Downloads`、项目目录或旧版本目录
   确定根目录后读取其中的 `skills/commands/{name}/SKILL.md`；标准模式下即使项目目录存在本地 HelloAGENTS skills，也不要读取项目路径。不要扫描整个目录，也不要对同一命令重复探测多个路径。
-包内脚本优先使用稳定命令入口；需要写收尾状态时优先调用 `helloagents-turn-state write --kind complete --role main`，不要拼接 `turn-state.mjs` 路径。
+包内脚本优先使用稳定命令入口；涉及 turn-state 时按“收尾状态信号”执行。
 
 ## .helloagents/ 目录
 路径: {CWD}/.helloagents/

package/bootstrap.md

@@ -35,9 +35,8 @@
 - 同一概念前后用语保持一致；先给结论再给细节，避免同义反复、重复解释和堆砌近义句
 
 ### 完整交付（强制）
-- 一次做完：用户需求明确且已获得执行授权时，必须一次性完成所有步骤再回复。只有符合下文“阻塞判定”的情况，才可中途停下
-- 授权优先执行：用户已明确同意当前方案、修改方向或继续执行时，直接继续。不得把已授权的后续动作改写为建议、可选项或等待确认
-- 直接推进：可直接继续执行时直接继续，不用“下一步建议”代替实际执行
+- 一次做完：用户需求明确且已获得执行授权时，必须持续执行到完成；只有符合下文“阻塞判定”的情况，才可中途停下
+- 直接推进：用户已明确同意方案、修改方向或继续执行时，直接执行；不得把可执行动作改写为建议、可选项、等待确认，也不用“下一步建议”代替实际执行
 
 ### 技术选型原则（全阶段生效）
 选择技术栈时，遵循以下思维框架而非固定方案：
@@ -116,8 +115,8 @@
 图标：💡直接响应 | ⚡快速执行 | 🔵规划流程 | ✅完成 | ❓等待输入 | ⚠️警告 | ❌错误
 
 使用约束：
-- 首行必须保留 `【HelloAGENTS】` 和连字符 `-`，不得省略；状态图标与收尾内容必须一致。正文仍在等待用户输入、确认、授权或补充信息（含确认是否执行已给出的方案）时，只能使用 `❓等待输入`；仅在本轮执行已完成且不存在待确认动作时，才能使用 `✅完成`。
-- `🔄 下一步` 必须写真实下一步，不改写成条件式能力表述或空泛询问。若正在等待确认，写清待确认动作；若存在自然后续动作，直接给出明确引导；若当前任务已完整结束且确无合理后续，可填写“当前任务已完成；无后续动作。”
+- 首行必须保留 `【HelloAGENTS】` 和连字符 `-`，不得省略；状态图标与收尾内容必须一致。正文仍在等待用户输入、确认、授权或补充信息（含确认是否执行已给出的方案或修改）时，只能使用 `❓等待输入`；仅在本轮执行已完成且不存在待确认动作时，才能使用 `✅完成`。
+- `🔄 下一步` 必须写真正的下一步动作，不写单纯当前状态或条件式能力表述。若正在等待确认，写清待确认动作；若仍有已授权且可继续执行的动作，不得收尾，必须继续执行；若当前任务已完整结束且确无合理后续，可填写“当前任务已完成；无后续动作。”
 
 ### 收尾状态信号
 - `turn-state` 只在运行时必须识别本轮“完成 / 等待输入 / 阻塞”时写入；普通问候、普通问答、T0 只读分析和一次性解释不调用
@@ -127,7 +126,7 @@
 - 因阻塞判定等待用户输入、确认、授权或补充信息（含未授权的外部副作用确认） → 写 `kind=waiting`、`role=main`，并同时写 `reasonCategory` 与 `reason`
 - 因错误、缺少前置条件或外部依赖而本轮停下 → 写 `kind=blocked`、`role=main`，并同时写 `reasonCategory` 与 `reason`
 - `reasonCategory` 只允许：`ambiguity`、`missing-input`、`missing-file`、`missing-credential`、`unauthorized-side-effect`、`high-risk-confirmation`、`external-dependency`、`error`
-- 显式 `~auto` / `~loop` 下，`waiting` / `blocked` 还必须写入 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`；阶段汇报、单轮 probe 完成、内部路线调整或“下一步建议”不构成停下理由
+- 显式 `~auto` / `~loop` 下，`waiting` / `blocked` 还必须写入 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`；阶段汇报、单轮探测完成、路线调整或“下一步建议”不构成停下理由
 - 子代理不得写 turn-state；子代理结束只直接返回结果，不为主代理代写完成态
 
 ## 交互规则
@@ -135,7 +134,7 @@
 ### 选择确认
 需要用户选择或确认时：
 - 确认必须对应当前阻塞执行的唯一决策，不得用确认替代本可直接执行的步骤
-- 用户已明确同意当前方案、修改方向或继续执行时，直接继续，不再追加确认环节
+- 已获得明确同意时，不再追加确认环节
 - 每次只问一个问题，偏好选择题，根据用户回答动态决定下一个问题
 - 需要同时确认多个相关类别时，用"— "前缀标题标明类别，编号从 1 开始连续不重置
 - 推荐选项标注（推荐）并给出理由
@@ -167,7 +166,7 @@
 - 缺少继续执行所必需的信息、文件、路径或凭据
 - 将产生外部副作用，但本轮尚未获得对应授权（含等待确认是否实施已给方案）
 - 操作属于高风险或不可逆，按安全规则必须确认
-除上述情况外，默认继续执行，不以“建议下一步”替代实际推进。
+除上述情况外，默认继续执行。
 
 ### 结构化输出
 以下内容使用结构化格式并逐项换行显示，不压缩为一行或一段：
@@ -184,8 +183,8 @@
 先判断任务类型、风险等级、是否需要结构化产物，再决定进入哪条路径：
 - 交付分层（Delivery Tier）：
   - `T0` — 只读分析、创意探索、方案比较 → 自然响应或 `~idea`
-  - `T1` — 低风险小改动、明确实现、显式验证 → 直接执行或 `~build` / `~verify`
-  - `T2` — 多文件功能、新项目、需要结构化产物 → `~plan` 或 `~auto`
+  - `T1` — 低风险小改动、明确实现、显式验证、单文件或局部改动 → 直接执行或 `~build` / `~verify`
+  - `T2` — 新项目、从零构建、3+ 文件新功能、架构级变更或需要结构化产物 → `~plan` 或 `~auto`
   - `T3` — 高风险或不可逆操作（权限、安全、支付、数据库、生产发布等）→ 先 `~plan` / `~prd`，再 `~build` / `~verify`，必要时单独确认
 - 创意探索 / 方案比较 → `~idea`
 - 明确实现 / 小范围修复 → `~build`
@@ -216,7 +215,7 @@
 - 已激活项目或全局模式下，技能是否需要使用由当前已加载 AGENTS 规则决定；不要因此额外探测项目目录里的 HelloAGENTS skills 路径
 路径确定一次即可，不预读、不扫描整个目录，也不重复探测同一路径。
 hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.md`
-包内脚本优先使用稳定命令入口；需要写收尾状态时优先调用 `helloagents-turn-state write --kind complete --role main`，不要拼接 `turn-state.mjs` 路径。
+包内脚本优先使用稳定命令入口；涉及 turn-state 时按“收尾状态信号”执行。
 
 命令职责：
 - `~plan` 生成 `requirements.md`、`plan.md`、`tasks.md`、`contract.json`
@@ -235,7 +234,7 @@ hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.m
 - 每次编辑后主动跑确定性检查（lint / typecheck），不等到最后
 - 遵循已读取技能的实现规范
 
-遇到阻塞（依赖缺失、指令不清、验证反复失败）→ 立即停下询问用户，不猜测不强行推进。
+遇到符合“阻塞判定”且无法自行解除的问题（依赖缺失、关键指令不清、验证反复失败等）时才停下；能继续定位或修复时继续推进。
 
 ### 5. VERIFY — 审查与验证
 编码任务：
@@ -262,12 +261,10 @@ hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.m
 - 未进入 VERIFY / CONSOLIDATE 的路径，声称完成前必须完成与任务类型匹配的必要检查；无法执行的检查必须明确说明，不得直接宣称完成
 - 已激活 `hello-*` 技能或存在方案包 / `contract.json` / 证据文件时，以对应 skill、方案包契约与 VERIFY / CONSOLIDATE 为准，不得降级为本节
 - 只读分析、创意探索、方案比较、中间进度和阻塞汇报不适用本节
+- Codex `/goal` 只作为外层长程续跑与预算控制；HelloAGENTS 仍负责方案、执行、验证和收尾。若 active goal 的目标已全部完成，先完成 HelloAGENTS 验证、delivery gate 与本地版本检查点，再调用 `update_goal` 标记 complete；不得因预算接近耗尽、单轮结束或准备停下而标记 complete
 
 ## 路由
 - 默认按上文“统一执行流程 / ROUTE / TIER”选路；除显式 `~command` 外，不另起独立路由规则
-- 简单任务（单文件修改/明确修复/小调整/已有代码的局部改动）→ 直接执行（⚡）
-- 必须进入规划（不可跳过）：新项目 / 新应用 / 从零构建 / 涉及 3+ 文件的新功能 / 架构级变更
-- 创意探索、显式验证/审查、完整规格等其他分流，均按 ROUTE / TIER 的命令映射执行
 - `~do` 是 `~build` 的兼容别名；`~design` 是 `~plan` 的兼容别名；`~review` 是 `~verify` 的兼容别名
 - `~command` 路由：用户输入 `~xxx` 时，立即读取对应的 SKILL.md 并按其流程执行，不要自行探索或猜测。若当前上下文已解析出具体命令技能文件路径，直接使用它；否则按上文相同的技能根目录规则确定，确定根目录后读取其中的 `skills/commands/{name}/SKILL.md`。不要额外探测项目目录里的 HelloAGENTS skills 路径，也不要扫描整个目录或对同一命令重复探测多个路径。
 

package/cli.mjs

@@ -176,6 +176,8 @@ if (cmd === 'codex-notify') {
   runRuntimeScript('guard.mjs', argv.slice(1))
 } else if (cmd === 'ralph-loop') {
   runRuntimeScript('ralph-loop.mjs', argv.slice(1))
+} else if (cmd === 'codex' && argv[1] === 'goals') {
+  runRuntimeScript('cli-codex-goals.mjs', argv.slice(2))
 } else if (cmd === 'postinstall') {
   printPostinstallMessage()
   if (shouldDeployFromEnv()) {

package/gemini-extension.json

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

package/hooks/hooks-codex.json

@@ -0,0 +1,40 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${PLUGIN_ROOT}/scripts/notify.mjs\" inject --codex --silent",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${PLUGIN_ROOT}/scripts/notify.mjs\" route --codex --silent",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${PLUGIN_ROOT}/scripts/notify.mjs\" stop --codex",
+            "timeout": 120
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

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

package/scripts/cli-codex-config.mjs

@@ -1,19 +1,89 @@
 import {
+  isTomlTableHeader,
+  normalizeToml,
   prependTopLevelTomlBlocks,
   removeTopLevelTomlBlock,
   stripTomlSection,
 } from './cli-toml.mjs'
 
 export const CODEX_PLUGIN_CONFIG_HEADER = '[plugins."helloagents@local-plugins"]'
+export const CODEX_FEATURES_HEADER = '[features]'
 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.cmd'
 export const CODEX_MANAGED_NOTIFY_VALUE = `["${CODEX_MANAGED_NOTIFY_COMMAND}", "codex-notify"]`
+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}`
 
 function normalizePath(value = '') {
   return String(value || '').replace(/\\/g, '/')
 }
 
+function splitTomlLines(text = '') {
+  return String(text || '').replace(/\r\n/g, '\n').split('\n')
+}
+
+function findSectionBounds(lines, headerLine) {
+  const start = lines.findIndex((line) => line.trim() === headerLine)
+  if (start < 0) return { start: -1, end: -1 }
+
+  let end = lines.length
+  for (let index = start + 1; index < lines.length; index += 1) {
+    if (isTomlTableHeader(lines[index])) {
+      end = index
+      break
+    }
+  }
+  return { start, end }
+}
+
+function findSectionKeyIndex(lines, bounds, key) {
+  if (bounds.start < 0) return -1
+  for (let index = bounds.start + 1; index < bounds.end; index += 1) {
+    if (lines[index].trim().startsWith(`${key} =`)) return index
+  }
+  return -1
+}
+
+function upsertTomlSectionLine(text, headerLine, key, line) {
+  const lines = splitTomlLines(text)
+  const bounds = findSectionBounds(lines, headerLine)
+  if (bounds.start < 0) {
+    const base = String(text || '').trimEnd()
+    const block = `${headerLine}\n${line}`
+    return normalizeToml(base ? `${base}\n\n${block}` : block)
+  }
+
+  const keyIndex = findSectionKeyIndex(lines, bounds, key)
+  if (keyIndex >= 0) lines[keyIndex] = line
+  else {
+    let insertIndex = bounds.end
+    while (insertIndex > bounds.start + 1 && !lines[insertIndex - 1].trim()) insertIndex -= 1
+    lines.splice(insertIndex, 0, line)
+  }
+  return normalizeToml(lines.join('\n'))
+}
+
+function removeTomlSectionLine(text, headerLine, key, shouldRemove) {
+  const lines = splitTomlLines(text)
+  const bounds = findSectionBounds(lines, headerLine)
+  const keyIndex = findSectionKeyIndex(lines, bounds, key)
+  if (keyIndex < 0 || !shouldRemove(lines[keyIndex].trim())) return normalizeToml(text)
+
+  lines.splice(keyIndex, 1)
+  const nextBounds = findSectionBounds(lines, headerLine)
+  const sectionLines = nextBounds.start < 0
+    ? []
+    : lines.slice(nextBounds.start + 1, nextBounds.end).filter((entry) => entry.trim())
+  if (nextBounds.start >= 0 && sectionLines.length === 0) {
+    lines.splice(nextBounds.start, 1)
+  }
+  return normalizeToml(lines.join('\n'))
+}
+
 export function upsertCodexPluginConfig(text) {
   const stripped = stripTomlSection(text, CODEX_PLUGIN_CONFIG_HEADER).text.trimEnd()
   const block = `${CODEX_PLUGIN_CONFIG_HEADER}\nenabled = true`
@@ -24,6 +94,62 @@ export function removeCodexPluginConfig(text) {
   return stripTomlSection(text, CODEX_PLUGIN_CONFIG_HEADER).text
 }
 
+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)
+}
+
+export function readCodexFeatureLine(text, key) {
+  const lines = splitTomlLines(text)
+  const bounds = findSectionBounds(lines, CODEX_FEATURES_HEADER)
+  const keyIndex = findSectionKeyIndex(lines, bounds, key)
+  return keyIndex >= 0 ? lines[keyIndex].trim() : ''
+}
+
+export function setCodexGoalsFeatureConfig(text, enabled = true) {
+  return upsertTomlSectionLine(
+    text,
+    CODEX_FEATURES_HEADER,
+    CODEX_GOALS_FEATURE_KEY,
+    enabled ? CODEX_MANAGED_GOALS_FEATURE_LINE : CODEX_MANAGED_GOALS_DISABLED_LINE,
+  )
+}
+
+export function removeCodexGoalsFeatureConfig(text) {
+  return removeTomlSectionLine(
+    text,
+    CODEX_FEATURES_HEADER,
+    CODEX_GOALS_FEATURE_KEY,
+    isManagedCodexGoalsFeature,
+  )
+}
+
+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(
+    text,
+    CODEX_FEATURES_HEADER,
+    CODEX_GOALS_FEATURE_KEY,
+    codexGoalsLine,
+  )
+}
+
 export function isManagedCodexModelInstruction(line = '') {
   return line.includes('model_instructions_file')
     && line.includes(CODEX_MANAGED_TOML_COMMENT)
@@ -34,6 +160,23 @@ export function isManagedCodexNotify(line = '') {
   return value.includes(CODEX_MANAGED_NOTIFY_VALUE)
 }
 
+function isManagedFeatureLine(line = '', key = '') {
+  return new RegExp(`^\\s*${key}\\s*=`).test(String(line || ''))
+    && String(line || '').includes(CODEX_MANAGED_TOML_COMMENT)
+}
+
+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)
+}
+
 export function isManagedCodexBackupInstruction(line = '') {
   return line.includes(CODEX_MANAGED_TOML_COMMENT)
 }