@riconext/hermes-repo 0.13.2 → 0.14.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 0.14.0
+
+### Minor Changes
+
+- e91087e: Add a local release workflow that versions with Changesets, updates the changelog, creates a matching git tag, and pushes the branch and tag for npm publishing.
+
+## 0.13.2
+
+### Patch Changes
+
+- 当前发布基线。后续版本由 Changesets 维护版本号与 changelog。

package/README.md

@@ -58,7 +58,7 @@ npm：`@riconext/hermes-repo` · 灵感来自 [Hermes Agent](https://github.com/
 
 - **个人开发者**：单仓库长期使用同一套 AI 助手，希望「项目记忆」跟着 repo 走
 - **小团队**：约定、流程经 PR 审查后进入 `topics/` / `skills/`，新人 AI 也能对齐
-- **多助手用户**：同一套 `.memory/` 可同时接入 Claude Code、Cursor、CodeBuddy（见下表）
+- **多助手用户**：同一套 `.memory/` 可同时接入 Claude Code、Cursor、CodeBuddy、Codex（见下表）
 
 ---
 
@@ -70,7 +70,7 @@ hermes-repo 是挂在**你的 Git 项目**上的记忆层：不改变你平时
 用户跑: npx @riconext/hermes-repo init
                 │
                 ▼
-        交互：checkbox 多选编程助手（claude-code / cursor / codebuddy）
+        交互：checkbox 多选编程助手（claude-code / cursor / codebuddy / codex）
         非交互：init -y [--tools id1,id2]  默认 assistants: [claude-code]
                 │  init -y --scan  可选冷启动：扫描仓库生成首批 semantic 捕获 + flush
                 ▼
@@ -94,10 +94,11 @@ hermes-repo 是挂在**你的 Git 项目**上的记忆层：不改变你平时
         │   ├── skill-usage.json    # [个人] 技能引用统计（gitignore）
         │   └── MEMORY.md           # [团队] Level 0 摘要（≤约 2.2K 字符，inject 用）
         ├── AGENTS.md               # 通用助手指令（init 合并 hermes 标记块）
-        └── 按 config.assistants[] 写入 hooks（统一调用 CLI，内部路由）:
+        └── 按 config.assistants[] 写入助手配置:
             .claude/settings.local.json    # claude-code: SessionStart→inject, Stop→capture
             .cursor/hooks.json             # cursor: sessionStart→inject, stop→capture
             .codebuddy/settings.local.json # codebuddy: SessionStart→inject, Stop→capture
+            .codex/config.toml             # codex: AGENTS.md 项目指令锚点
 
 ────────────────── 运行时闭环（单仓库）──────────────────
 
@@ -315,7 +316,7 @@ npx @riconext/hermes-repo capture-llm --flush
 | **Claude Code** | 已支持 | Stop / SessionStart hooks |
 | **Cursor** | 已支持 | `hooks.json` 集成 |
 | **CodeBuddy** | 已支持 | Stop / SessionStart hooks |
-| OpenAI Codex | 规划中 | — |
+| **OpenAI Codex** | 已支持 | `AGENTS.md` + `.codex/config.toml` 项目级引导 |
 | VS Code Copilot / Copilot CLI | 规划中 | AGENTS.md 可先手写引导 |
 
 ---
@@ -331,6 +332,8 @@ npx @riconext/hermes-repo capture-llm --flush
 | `stats` | 查看记忆健康度 |
 | `ref` | 记录「这条记忆有用」（反馈） |
 | `promote --pr` / `--apply` | 将个人捕获晋升到团队层（需评审） |
+| `bun run changeset` | 记录下一次发布的变更说明 |
+| `bun run changeset:version` | 生成版本号与 `CHANGELOG.md` |
 
 Hook 场景下还会用到 `capture`、`inject`（一般由助手自动调用，无需手敲）。
 
@@ -356,6 +359,22 @@ npx @riconext/hermes-repo flush
 
 ---
 
+## 发布流程
+
+本仓库使用 Changesets 管理版本与 `CHANGELOG.md`。本地 `release` 脚本负责生成版本、创建 tag 并推送；GitHub Actions 只监听 `v*` tag 发布 npm 包。
+
+```bash
+# 有用户可见改动时，随代码提交 changeset
+bun run changeset
+
+# 发版：生成 CHANGELOG/version，提交，创建 tag，并推送分支与 tag
+bun run release
+```
+
+发布前需在 GitHub Actions secrets 中配置 `NPM_TOKEN`。详细说明见 [.changeset/README.md](.changeset/README.md)，npm 发布 workflow 见 [.github/workflows/publish-npm.yml](.github/workflows/publish-npm.yml)。
+
+---
+
 ## 路线图
 
 | 阶段 | 内容 |