@alan512/experienceengine 0.1.3 → 0.2.1

package/README.zh-CN.md

@@ -1,108 +1,207 @@
 # ExperienceEngine
 
-[English README](./README.md)
+[English README](./README.md) | 简体中文
 
-ExperienceEngine 是一个面向编程 Agent 的本地经验介入层。
+ExperienceEngine 是一个面向编程 Agent 的治理层。它复用真实执行经验，但不会把 memory 变成噪声堆积。它只会在相关时注入简短、任务相关的 guidance，并持续记录这次介入到底是帮到了还是干扰了结果。
 
-它会从真实编码任务中学习简短、任务相关的经验，在后续相似任务中决定是否注入这些经验，并记录这次介入到底是帮到了还是干扰了结果。
+**Memory 做加法，ExperienceEngine 做治理。**
+
+当前支持的宿主：`OpenClaw`、`Claude Code`、`Codex`
+
+## 10 秒理解
+
+没有 ExperienceEngine：
+- agent 会在相似仓库里重复犯同样的 SQLite migration 错误
+- 它会先打开数据库、再补 migration，然后在错误方向上浪费几轮
+
+有 ExperienceEngine：
+- 它会在真正调用工具之前注入一条很短的约束，例如：`先执行 migration，再打开数据库连接`
+- 宿主 agent 会直接避开上次已经踩过的错路，而不是重新试错
+- 任务结束后，ExperienceEngine 通常会根据真实结果自动更新这条 guidance
+- 如果这条 guidance 后面开始伤害相似任务，ExperienceEngine 会把它降温、隔离或退役
+
+任务流：`任务信号 -> 提炼经验 -> 检索 -> 短提示注入 -> 反馈 -> 治理`
+
+<details>
+<summary>宿主里的示例对话</summary>
+
+用户：修一下这个仓库里的 SQLite 启动失败问题。
+
+宿主 agent：ExperienceEngine 在这个仓库里找到了一个之前成功过的修复模式：`先执行 migration，再打开数据库连接。` 我会先补 migration，然后再重试启动。
+
+用户：为什么这条 ExperienceEngine 提示会命中？
+
+宿主 agent：它匹配到了这个仓库里过去一次相同的 SQLite 启动失败，以及当时成功的 migration-first 修复路径。
+
+用户：所以 ExperienceEngine 的作用，是提前把我从同样的错路上拉回来？
+
+宿主 agent：对。它在下一次工具调用前复用了这个仓库里的成功路径，而且这次任务结束后通常会自动判断这条经验到底帮到了还是干扰了结果。
+
+</details>
+
+![`ee inspect --last --verbose` 示例输出](./docs/assets/readme/inspect-last-example.svg)
+
+## 快速开始
+
+最快的宿主安装路径：
 
-当前支持的宿主：
 - `OpenClaw`
-- `Claude Code`
+  - `openclaw plugins install @alan512/experienceengine`
+  - `openclaw gateway restart`
+  - `ee init`
 - `Codex`
+  - `ee install codex`
+  - `ee init`
+- `Claude Code`
+  - `/plugin marketplace add https://github.com/Alan-512/ExperienceEngine.git`
+  - `/plugin install experienceengine@experienceengine`
+  - `ee init`
 
-OpenClaw 兼容要求：
-- 需要本机已经有可正常工作的 OpenClaw，并且支持原生插件安装
-- 下面的 OpenClaw 安装路径默认要求 `openclaw plugins install` 和 `openclaw gateway restart` 可用
-- 发布包要求 Node.js `>=20`
+`ee init` 用于在宿主安装完成后初始化共享的 ExperienceEngine 状态。
+
+如果你需要更详细的宿主安装说明、fallback 路径、ready 状态说明或 operator 工作流，跳转到 [完整安装与运维说明](#完整安装与运维说明)。
+
+## 适合谁用
+
+以下情况适合使用 ExperienceEngine：
+- 你会在相似仓库或相似工作流里反复使用 coding agent
+- 你想要的是**短小、介入式 guidance**，而不是泛化的 memory recall
+- 你关心历史经验到底是**帮到了还是害了**
+- 你希望过时 guidance 能自动降温或退役，而不是越积越多
 
-## 它解决的问题
+以下情况不适合：
+- 你只想要一个个人笔记型 memory
+- 你想要通用文档 RAG
+- 你的工作流几乎不重复
+- 你希望系统默认记住所有东西
 
-Coding agent 会重复踩同类坑，通常不是因为模型不够聪明，而是因为它缺少**可治理的经验积累机制**。
+## 宿主支持矩阵
 
-常见问题是：
-- 上一轮任务的教训，在新会话里直接丢失
-- memory 会一直加，但通常不会主动退役低价值内容
-- 记住的东西越来越多，context 越来越重，agent 的注意力反而被稀释
+| 宿主 | 安装路径 | 日常交互 | 成熟度 |
+|---|---|---|---|
+| `OpenClaw` | 原生插件安装 | 宿主原生 | 当前最完整 |
+| `Claude Code` | marketplace 插件，保留 `ee install claude-code` fallback | MCP + plugin hooks | 已支持 |
+| `Codex` | `ee install codex`，保留原生 MCP fallback | MCP 原生 | 已支持 |
 
-ExperienceEngine 处理的正是这一层问题。它不试图记住一切，而是专门治理：
-- 什么时候该让历史经验介入
-- 该注入哪条 `strategy` 或 `warning`
-- 这次介入到底有没有帮到任务
-- 这条经验是否应该继续保留、降温或退役
+## 为什么要做这个
 
-**Memory 做加法，EE 做治理。**
+Coding agent 会重复犯同类错误，通常不是因为模型不够聪明，而是因为之前的执行经验没有被**以可治理的方式**复用。
 
-## 它和 Memory 的区别
+ExperienceEngine 的目标不是通用 memory 累积，而是**介入治理**。
+
+## 为什么不是 Memory / RAG
 
 | 问题 | Memory 系统 | ExperienceEngine |
 |---|---|---|
-| 跨会话保留事实和偏好 | ✅ | 不是核心目标 |
-| 记录失败 → 修复 → 成功的经验路径 | 部分解决，通常依赖手工记录 | ✅ 来自真实任务信号 |
-| 知道某次注入到底有没有帮助 | ❌ 通常没有 | ✅ 有 helped / harmed 追踪 |
-| 自动退役过时或有害经验 | ❌ 通常没有 | ✅ 有 cooling / retired 生命周期 |
-| 把注入控制在短小、任务相关的 guidance | 不是核心目标 | ✅ 是核心设计 |
+| 跨会话保存事实和偏好 | 可以 | 不是核心目标 |
+| 捕获失败 -> 修复 -> 成功的经验路径 | 部分支持，通常依赖人工 | 可以，来自真实任务信号 |
+| 知道一条回忆到底有没有帮助 | 通常不行 | 可以，逐次记录 |
+| 自动退役过时或有害 guidance | 通常不行 | 可以，内建 cooling / retired 生命周期 |
+| 保持提示短小、任务相关 | 不是核心目标 | 是 |
+| 通用文档检索 | 常见适用场景 | 不是核心目标 |
+
+## 为什么它不是另一层记忆
+
+ExperienceEngine 不是想比宿主“记住更多东西”。它的核心价值，是持续治理一条已经学到的 guidance 还应不应该继续影响后续任务。
+
+- 大部分学习动作发生在任务之后，所以当前任务不需要等待整条经验处理链路跑完
+- 每条经验节点都会经历 `candidate`、`active`、`cooling`、`retired` 这样的生命周期
+- “存下来” 和 “还能不能继续上线” 是分开的，所以有害 guidance 可以被降温、隔离，或者退出正常注入路径
+- 任务结束后的审查会继续判断这条 hint 到底是帮到了、伤害了，还是仍然不确定
+- 即使这次没有注入 hint，delivery decision 也会被记录下来，所以之后仍然能解释为什么跳过
+- 同仓库高匹配经验在成功复用后可以从保守投放提升到正常投放；跨仓库复用默认仍保持保守，除非后续证据更强
+- 这个产品追求的是“生产安全的经验复用”，不是“尽量多记、尽量多召回”
 
 ## 它在 Agent Loop 里的位置
 
-```text
-用户任务
-  -> before_prompt_build：检索并注入匹配经验
-  -> agent 推理 + 工具调用：捕获失败、重试、纠正和结果
-  -> task finalize：把候选信号提炼成可复用经验
-  -> helped / harmed：提升、降温或退役节点
-```
+从高层看，ExperienceEngine 围绕 agent loop 的位置是这样的：
 
-ExperienceEngine 工作在 context 层，不会去修改宿主模型权重。
+- `用户任务`
+- `before_prompt_build`：检索并注入匹配经验
+- `agent 推理 + 工具调用`：捕获失败、重试、修正和结果
+- `task finalize`：把候选信号提炼成可复用经验
+- `helped / harmed`：提升、降温或退役节点
+
+ExperienceEngine 工作在 context 层，不会修改宿主模型权重。
 
 ## 经验生命周期
 
-```text
-任务信号
-  -> candidate
-  -> active
-  -> cooling
-  -> retired
-```
+`任务信号 -> candidate -> active -> cooling -> retired`
+
+每条经验都根据真实任务结果演化，而不是按时间粗暴清理。帮到任务的经验会被强化，反复有害的经验会被降温或退役。
+
+## 现在能做什么
 
-每条经验都依赖真实任务结果来演化，而不是简单按时间清理。帮到任务的经验会被强化，反复有害的经验会被降温或退役。
+- 在相似编码任务里复用短 guidance
+- 查看某条 hint 为什么命中，或者为什么这次没有注入
+- 让 ExperienceEngine 根据真实任务结果自动强化、降温、隔离或退役 guidance
+- 当自动判断不准时，手动把最近一次介入标记为 helpful 或 harmful
+- 查看 active、cooling、quarantined、retired 等生命周期状态
+- 在 `OpenClaw`、`Claude Code`、`Codex` 三个宿主中使用
 
-## 当前已经能用什么
+### 底层实现
 
-当前仓库已经实现并可用：
-- `OpenClaw`、`Claude Code`、`Codex` 三个宿主接入
-- MCP 原生交互面，以及 CLI / 运维 fallback
-- API-first 语义检索与平滑回退：
-  - OpenAI `text-embedding-3-small`
-  - Gemini `gemini-embedding-001`
-  - Jina `jina-embeddings-v3`
-  - 受管本地 embedding fallback
-  - legacy hash-based fallback
-- 通过宿主 agent 直接查看和反馈经验，并保留 CLI fallback：
-  - `ee inspect --last`
-  - `ee helped`
-  - `ee harmed`
+- MCP 原生交互面，加上 CLI / operator fallback
+- 支持 API 与本地回退的语义检索
+- 确定性的 match scorecard，用来区分同仓库高置信匹配和更宽泛的跨仓库复用
+- 宿主 agent 内可直接查看和反馈经验，CLI fallback 包括 `ee inspect --last`、`ee helped`、`ee harmed`
 
-如果你想看更细的 ExperienceNode 结构和治理字段，见：
+如果你想看 ExperienceNode 结构和治理字段，见：
 
 - [Experience Model Overview](./docs/development/experience-model.md)
 
-## 快速开始
+## 当前状态
+
+- Stable：核心经验生命周期、inspect/helped/harmed loop、宿主集成、CLI/operator fallback
+- 当前最顺滑的路径：`OpenClaw` 原生插件安装
+- 仍在演进：retrieval 调优、provider 策略、更高级的宿主 UX
+- 如果你想最快拿到第一份顺滑体验，建议先从 `OpenClaw` 开始
+
+## 什么叫第一次真正成功
+
+安装并初始化后，第一次真正体现价值的信号通常是：
+
+- 一类重复任务不再重走之前已经犯过的错路
+- ExperienceEngine 只注入一条很短、和当前仓库直接相关的约束，而不是把上下文塞满
+- 宿主能解释为什么这条 hint 会命中，或者为什么这次没有注入
+- 任务结果通常会自动影响以后是否继续投放这条经验
+- `ee inspect --last` 能看到最近的介入和相关节点状态
+
+## 前置条件
+
+安装宿主前，请先确认对应宿主 CLI 已能在当前机器正常工作：
+
+- `openclaw`
+- `claude`
+- `codex`
+
+**ExperienceEngine 不会替你安装这些宿主 CLI。** 它只会接入一个已经可用的宿主环境。
+
+OpenClaw 说明：
+- 需要本机已有可正常工作的 OpenClaw，且支持原生插件安装
+- 下面的 OpenClaw 路径默认要求 `openclaw plugins install` 和 `openclaw gateway restart` 可用
+
+通用包要求：
+- 发布包要求 Node.js `>=20`
+
+## 完整安装与运维说明
 
-ExperienceEngine 现在采用**宿主侧安装优先**。
+### 按宿主安装
 
-也就是说，第一步安装命令属于你要使用的宿主，而不是 `ee` CLI。
+ExperienceEngine 现在不再把 `ee` CLI 当成适用于所有宿主的统一首要安装入口。
+
+请先从宿主自己的安装路径接入：
 
 - `OpenClaw`
   - 宿主原生插件安装：
     - `openclaw plugins install @alan512/experienceengine`
-  - 安装后先重启 OpenClaw gateway，再开始真实任务：
+  - 安装后，在开始真实任务前先重启 gateway：
     - `openclaw gateway restart`
 - `Codex`
   - EE 托管安装：
     - `ee install codex`
   - 原生 / 手工 fallback：
-    - `codex mcp add experienceengine --env EXPERIENCE_ENGINE_HOME=$HOME/.experienceengine -- npx -y @alan512/experienceengine codex-mcp-server`
+    - 如果你需要直接 MCP wiring，可参考后面的高级示例
   - 无论走哪条路径，首次接入后都建议在仓库里开启一个新的 Codex 会话，让 MCP 配置和 `AGENTS.md` 指令块生效
 - `Claude Code`
   - 宿主原生 marketplace 安装：
@@ -110,82 +209,106 @@ ExperienceEngine 现在采用**宿主侧安装优先**。
     - `/plugin marketplace add https://github.com/Alan-512/ExperienceEngine.git`
   - 再安装插件：
     - `/plugin install experienceengine@experienceengine`
-  - 如果你需要显式 hooks + MCP wiring，仍可用：
+  - 如果你需要显式 hooks + MCP wiring，仍可使用：
     - `ee install claude-code`
   - 安装后建议开启一个新的 Claude Code 会话，让插件 hooks 和 bundled MCP 配置生效
 
-宿主安装完成后，普通用户应继续直接和宿主 agent 交互。
+无论哪个宿主，整体流程都是一样的：
 
-例如你可以直接问宿主 agent：
+1. 通过宿主路径安装 ExperienceEngine
+2. 执行一次 `ee init` 初始化共享状态
+3. 重启或新开宿主会话，直到仓库变成 `Ready`
+4. 日常检查和反馈优先留在宿主内部完成
+5. 需要验证、修复或深度排障时，再退回 `ee` CLI
 
-- “ExperienceEngine 刚刚注入了什么？”
-- “显示最近一次 ExperienceEngine 介入。”
-- “把刚才那次 ExperienceEngine 提示标记为 helpful。”
+### 共享初始化
 
-只有在需要显式运维、排障或高级调试时，再使用：
+`ee init` 属于 ExperienceEngine 的共享初始化，不是某个宿主自己的安装步骤。
 
-```bash
-ee init
-ee doctor <openclaw|claude-code|codex>
-ee status
-ee maintenance embedding-smoke
-```
-
-这里的 `ee init` 属于 ExperienceEngine 的**共享初始化**，不是某个宿主自己的安装步骤。
-
-- 第一次把 EE 接到任意一个宿主后，做一次初始化即可。它会统一引导你配置：
+- 第一次接入任意宿主后执行一次，用来配置：
   - distillation provider / model / auth
   - embedding 模式 / provider
   - 共享 provider secret
-- 之后再安装新的宿主，会复用同一个 EE 数据目录、配置和共享 secret。
+- 后续再接入其他宿主，会复用同一个 ExperienceEngine home、配置和共享 secret
+
+安装完成后，ExperienceEngine 应该把用户引导到下一步状态：
+
+- 如果宿主 wiring 已完成，产品至少是 `Installed`
+- 执行完 `ee init` 后，进入 `Initialized`
+- 宿主或仓库完成 reload 并能开始真实任务后，进入 `Ready`
 
 最小共享初始化示例：
 
-```bash
-ee init distillation --provider openai --model gpt-4.1-mini --auth-mode api_key
-ee init secret OPENAI_API_KEY <your-api-key>
-ee init embedding --mode api --api-provider openai --model text-embedding-3-small
-ee init show
-```
+1. `ee init distillation --provider openai --model gpt-4.1-mini --auth-mode api_key`
+2. `ee init secret OPENAI_API_KEY <your-api-key>`
+3. `ee init embedding --mode api --api-provider openai --model text-embedding-3-small`
+4. `ee init show`
 
 如果你更想用 Gemini 或 Jina 做 embedding，可以沿用同样的 `ee init embedding` 流程，只替换 provider 和 model。
 
-## 前置条件
+### 日常使用与 Operator 使用
 
-在安装任一宿主前，请先确认对应宿主 CLI 已经能在当前机器正常工作：
+日常使用时，优先直接问宿主 agent 当前的 ExperienceEngine 状态。默认主路径是自动结果归因；手动 feedback 主要用于你觉得自动判断不准时的纠偏。
 
-- `openclaw`
-- `claude`
-- `codex`
+例如：
 
-ExperienceEngine 不会替你安装这些宿主 CLI。它只负责把自己接入一个已经可用的宿主环境。
+- “ExperienceEngine 刚刚注入了什么？”
+- “为什么那条 ExperienceEngine 提示会命中？”
+- “为什么这次 ExperienceEngine 没有注入？”
+- “把刚才那次 ExperienceEngine 介入标记为 helpful 或 harmful。”
 
-## 安装模型
+正常使用里，你不应该需要手动给每次介入都打分。ExperienceEngine 的默认路径是根据真实任务结果自动学习；只有当自动判断明显不对时，你再手动纠偏。
+
+OpenClaw 还支持这些 readiness / silence 问题：
+
+- “ExperienceEngine 这里 ready 了吗？”
+- “这个仓库里的 ExperienceEngine 还在 warming up 吗？”
+- “刚才为什么 ExperienceEngine 没有注入？”
+
+对于 `OpenClaw`、`Codex`、`Claude Code`，常规 review / feedback 路径都应优先留在宿主内部完成。
+只有宿主侧路径不可用，或者你需要显式 operator 控制时，再退回 CLI。
+
+当你需要显式运维、验证或排障时，可以用：
+
+```bash
+ee init
+ee doctor <openclaw|claude-code|codex>
+ee status
+ee maintenance embedding-smoke
+```
 
-ExperienceEngine 现在把“安装”和“运维”明确分开：
+### Ready 与 Value 状态
 
-- 安装属于宿主
-- 验证、修复、状态查看属于 `ee`
+ExperienceEngine 把 onboarding 和 value 拆成两层：
 
-这意味着：
+- `Setup state`
+  - `Installed`
+  - `Initialized`
+  - `Ready`
+- `Value state`
+  - `Warming up`
+  - `First value reached`
 
-- `Codex` 走共享 ExperienceEngine MCP 服务，首次接入优先使用 `ee install codex`
-- `Claude Code` 走 Claude 原生插件资产与 marketplace 分发
-- `OpenClaw` 走 plugin/runtime 集成
+这不是一条严格线性阶梯。一个仓库可以已经 `Ready`，但还处于 `Warming up`。
+
+`First value reached` 只应该在真实任务里已经出现可见价值时才成立。仅仅显示 onboarding 文案或 warm-up 提示，不算 first value。
+
+## 安装模型
 
-一旦安装完成，宿主 agent 仍然是主交互面。
+ExperienceEngine 明确拆分：
+- 宿主安装
+- 共享初始化
+- operator 工作流
 
-`ee` CLI 主要负责：
+宿主仍然是主交互面。
+`ee` 仍然是显式的 operator 面，用于 setup、验证、修复、状态查看和维护。
+对于 Codex，`ee status` 和 `ee doctor codex` 还会显示 `ee` CLI fallback 是否在 `PATH` 上可用。Codex 的 MCP 接入在 CLI fallback 缺失时仍可能正常工作，但 `ee inspect --last` 这类命令需要 PATH 里有 `ee`，或者使用显式的包调用方式。
 
-- 共享 provider/model 初始化
-- 健康检查
-- 修复建议
-- 状态查看
-- 学习与介入反馈
+## 高级按宿主命令（仅限 Operator / 开发者）
 
-## 高级按宿主命令
+大多数用户可以跳过这一节，直接使用上面的宿主安装路径。
 
-如果你是运维者、开发者，或者想显式控制某个宿主，仍然可以使用：
+如果你是运维者、开发者，或者确实想显式控制某个宿主，仍可使用：
 
 ```bash
 ee install openclaw
@@ -193,12 +316,23 @@ ee install claude-code
 ee install codex
 ```
 
-这些命令仍然有效，但它们更适合作为：
-- 运维 fallback
-- 显式修复
-- 产品开发期调试
+<details>
+<summary>Codex 原生 / 手工 MCP fallback 示例</summary>
+
+```bash
+codex mcp add experienceengine --env EXPERIENCE_ENGINE_HOME=$HOME/.experienceengine -- npx -y @alan512/experienceengine codex-mcp-server
+```
+
+</details>
+
+说明：
+- `OpenClaw` 走 plugin/runtime integration，而不是 `src/adapters/`
+- `Claude Code` 会安装 hooks 和共享 ExperienceEngine MCP 服务
+- `Codex` 会安装共享 ExperienceEngine MCP 服务
+- `ee install ...` 与 `ee doctor ...` 会在 `npm` / `pnpm` 使用非官方 registry 时给出提示，因为受管模型下载在 `https://registry.npmjs.org` 下最稳定
+- 成功执行 `ee install ...` 后，也会提醒冷启动预期：capture 会立刻开始，但 formal experience 一般需要在同一仓库里出现几次相似任务后才会形成
 
-而不是默认公开安装路径。
+这些命令属于 operator fallback，不是默认公开安装路径。
 
 ## 数据目录
 
@@ -220,10 +354,7 @@ ee install codex
 当前默认行为：
 
 - `embeddingProvider = "api"`
-- provider 优先级：
-  - 设置了 `OPENAI_API_KEY` 时优先 OpenAI
-  - 设置了 `GEMINI_API_KEY` 时使用 Gemini
-  - 设置了 `JINA_API_KEY` 时使用 Jina
+- provider 优先级：OpenAI -> Gemini -> Jina
 - 如果没有任何 API provider 可用，会自动回退到受管本地 embedding
 
 常用环境变量：

package/dist/adapters/claude-code/session-store.d.ts

@@ -12,4 +12,5 @@ export declare const loadClaudeSession: (sessionId: string, options?: SessionSto
 export declare const rememberClaudePromptContext: (context: HostPromptContext, options?: SessionStoreOptions) => void;
 export declare const appendClaudeToolResult: (result: HostToolResult, options?: SessionStoreOptions) => void;
 export declare const clearClaudeSession: (sessionId: string, options?: SessionStoreOptions) => void;
+export declare const findClaudeSessionByCwd: (cwd: string, options?: SessionStoreOptions) => ClaudeStoredSession | null;
 export {};

package/dist/adapters/claude-code/session-store.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { resolveExperienceEnginePaths, resolveProductStateDir } from "../../config/path-resolver.js";
 const sanitizeSessionId = (sessionId) => sessionId.replace(/[^a-zA-Z0-9_.-]+/g, "_");
@@ -11,6 +11,15 @@ const resolveSessionDir = (options = {}) => {
     return join(resolveProductStateDir(paths), "sessions");
 };
 const resolveSessionPath = (sessionId, options = {}) => join(resolveSessionDir(options), `${sanitizeSessionId(sessionId)}.json`);
+const listClaudeSessionPaths = (options = {}) => {
+    const dir = resolveSessionDir(options);
+    if (!existsSync(dir)) {
+        return [];
+    }
+    return readdirSync(dir)
+        .filter((entry) => entry.endsWith(".json"))
+        .map((entry) => join(dir, entry));
+};
 export const loadClaudeSession = (sessionId, options = {}) => {
     const filePath = resolveSessionPath(sessionId, options);
     if (!existsSync(filePath)) {
@@ -53,4 +62,18 @@ export const clearClaudeSession = (sessionId, options = {}) => {
     const filePath = resolveSessionPath(sessionId, options);
     rmSync(filePath, { force: true });
 };
+export const findClaudeSessionByCwd = (cwd, options = {}) => {
+    const matches = listClaudeSessionPaths(options)
+        .map((filePath) => ({
+        filePath,
+        mtimeMs: statSync(filePath).mtimeMs,
+        session: JSON.parse(readFileSync(filePath, "utf8"))
+    }))
+        .filter((entry) => entry.session.promptContext?.cwd === cwd)
+        .sort((left, right) => right.mtimeMs - left.mtimeMs);
+    if (matches.length !== 1) {
+        return null;
+    }
+    return matches[0]?.session ?? null;
+};
 //# sourceMappingURL=session-store.js.map

package/dist/adapters/claude-code/session-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../../src/adapters/claude-code/session-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../../src/adapters/claude-code/session-store.ts"],"names":[],"mappings":"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"}

package/dist/adapters/codex/action-registry.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import type { ExperienceNodeType, ExperienceState } from "../../types/domain.js";
+export type CodexActionCategory = "inspect" | "state" | "admin" | "maintenance";
+export type CodexActionRiskLevel = "low" | "medium" | "high";
+export type CodexActionDefinition = {
+    id: string;
+    title: string;
+    summary: string;
+    category: CodexActionCategory;
+    riskLevel: CodexActionRiskLevel;
+    requiresConfirmation: boolean;
+    inputSchema?: z.ZodTypeAny;
+    examplePayload?: Record<string, unknown>;
+    handler: (args: Record<string, unknown>) => Promise<unknown>;
+};
+type RegistryDeps = {
+    interactionSurface: {
+        inspectRecent: (args?: {
+            mode?: "all" | "injected";
+            limit?: number;
+        }) => Promise<unknown>;
+        inspectNode: (args: {
+            nodeId: string;
+        }) => Promise<unknown>;
+        listNodesByState: (args: {
+            state: ExperienceState;
+        }) => Promise<unknown>;
+        listNodesByType: (args: {
+            nodeType: ExperienceNodeType;
+        }) => Promise<unknown>;
+        inspectLearningSummary: () => Promise<unknown>;
+        coolNode: (args: {
+            nodeId: string;
+        }) => Promise<unknown>;
+        retireNode: (args: {
+            nodeId: string;
+        }) => Promise<unknown>;
+        feedbackNode: (args: {
+            nodeId: string;
+            feedback: "helped" | "harmed";
+        }) => Promise<unknown>;
+        disableScope: (args?: {
+            cwd?: string;
+        }) => Promise<unknown>;
+        enableScope: (args?: {
+            cwd?: string;
+        }) => Promise<unknown>;
+    };
+    operationalSurface: {
+        checkUpdate: (adapter: "openclaw" | "claude-code" | "codex") => Promise<unknown>;
+    };
+    operationalActions: {
+        planOperation: (args: {
+            adapter: "openclaw" | "claude-code" | "codex";
+            operation: "install" | "repair" | "upgrade";
+        }) => unknown;
+        executePlannedOperation: (args: {
+            planId: string;
+            confirmationToken: string;
+        }) => unknown;
+    };
+    stateArtifacts: {
+        listBackups: () => unknown;
+        planOperation: (args: {
+            operation: "backup" | "export";
+        } | {
+            operation: "import";
+            importPath: string;
+        } | {
+            operation: "rollback";
+            backupId: string;
+        }) => unknown;
+        executePlannedOperation: (args: {
+            planId: string;
+            confirmationToken: string;
+        }) => unknown;
+    };
+};
+export type CodexActionRegistry = ReturnType<typeof createCodexActionRegistry>;
+export declare const createCodexActionRegistry: (deps: RegistryDeps) => {
+    list: () => CodexActionDefinition[];
+    get: (id: string) => CodexActionDefinition | undefined;
+};
+export {};