csep 1.0.0__tar.gz

csep-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 T0UGH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

csep-1.0.0/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include tests/fixtures *.json

csep-1.0.0/PKG-INFO

@@ -0,0 +1,272 @@
+Metadata-Version: 2.4
+Name: csep
+Version: 1.0.0
+Summary: Self-evolution loop for OpenAI Codex: session reflection, session recall, and reflection-generated skills with zero runtime dependencies.
+Author: T0UGH
+License: MIT License
+        
+        Copyright (c) 2026 T0UGH
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/T0UGH/codex-self-evolution-plugin
+Project-URL: Repository, https://github.com/T0UGH/codex-self-evolution-plugin
+Project-URL: Issues, https://github.com/T0UGH/codex-self-evolution-plugin/issues
+Project-URL: Documentation, https://github.com/T0UGH/codex-self-evolution-plugin/blob/main/docs/getting-started.md
+Project-URL: Architecture, https://github.com/T0UGH/codex-self-evolution-plugin/blob/main/docs/architecture.md
+Keywords: codex,openai,llm,memory,recall,hooks,plugin,self-evolution
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Dynamic: license-file
+
+# Codex Self-Evolution Plugin
+
+[![tests](https://github.com/T0UGH/codex-self-evolution-plugin/actions/workflows/test.yml/badge.svg)](https://github.com/T0UGH/codex-self-evolution-plugin/actions/workflows/test.yml)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![python: 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/)
+
+中文 | [English](README_en.md)
+
+让 Codex 把每次协作变成下一次的进步。
+
+> 用 Codex 5.3 Spark 的空闲额度，帮你的 Codex 在后台攒经验。
+
+如果你一天开好几个 Codex session，很快会发现一个很烦的问题：它这次能把活干完，但下次还是像第一次进仓库一样。测试命令要重讲，项目边界要重讲，你刚纠正过的写法和偏好也要重讲。
+
+当然可以自己搭一套 harness，把 prompt、脚本、知识库和日志都管起来。只是这件事太费劲了。`csep` 不要求你自己维护一整套外部流程，它直接接进 Codex 的生命周期，让 Codex 在真实使用里慢慢攒经验。
+
+Codex Self-Evolution Plugin，简称 `csep`。它在 `SessionStart` 时把稳定背景注入 Codex 上下文；在 `Stop` 时归档 transcript；遇到值得沉淀的 session，再开一个后台 reflection worker，把经验写成 memory 或 `csep-reflect-*` skill。历史 session 会进本地 SQLite/FTS，之后可以用 `csep recall` 找回来。
+
+它不是聊天记录备份工具。备份只能让你回看过去；`csep` 更关心下一次 Codex 能不能少问两句，少猜一点，少重复犯同一个错。
+
+![Codex Self-Evolution data flow](docs/assets/readme-csep-data-flow.png)
+
+图里只有三条线：`SessionStart` 读 memory，`Stop` 归档 session，触发后再由 reflection worker 写 memory 和 skill。
+
+## 为什么需要它
+
+用了几天 Codex 后，真正消耗人的往往不是大问题，而是这些重复的小事：
+
+- 这个仓库该怎么跑测试。
+- 这个用户不喜欢什么风格。
+- 哪些文件不能碰。
+- 上次已经验证过什么方案。
+- 某类任务应该用哪个工具、哪条命令。
+- 哪些纠正值得变成长期规则或 skill。
+
+`csep` 把这些经验留在本机。下次 Codex session 开始时，它们会先进入上下文；需要查旧 session 时，再用 `csep recall` 翻出来。
+
+## 它做什么
+
+| 能力 | 写入时机 | 下一次如何使用 |
+| --- | --- | --- |
+| Stable Memory | 达到 trigger 条件后，由 session reflection 写入 `USER.md` / `MEMORY.md` | `SessionStart` 自动注入 Codex 上下文 |
+| Session Recall | `Stop` hook 把 transcript 归档到本地 SQLite/FTS | `csep recall "..."` 按当前 repo 或全局检索历史片段 |
+| Reflection Skills | reflection worker 写入 `~/.codex/skills/csep-reflect-*` | Codex 原生 skills loader 自动加载 |
+| Runtime Status | hooks、配置、日志、reflection job、recall DB 都可只读检查 | `csep status` 排查当前运行状态 |
+
+每次 `Stop` 都会归档 session，但 reflection 只在计数或高信号命中后运行。
+
+## 设计原则
+
+- 状态默认放在 `~/.codex-self-evolution/`，不写进业务仓库。
+- `SessionStart` / `Stop` hook 失败时尽量放行，不拖垮 Codex 正常工作。
+- 每次 `Stop` 都会归档 session，但 reflection 不是每次都跑；只有计数或高信号命中后才 fork worker。
+- reflection worker 写完必须留下 `receipt.json`，父进程会校验路径、hash 和 skill 命名空间。
+- memory 写在当前 repo bucket；生成 skill 只允许落到 `csep-reflect-*`，不碰用户已有 skill。
+- 核心包只用 Python stdlib，尽量减少安装、升级和 hook 执行时的变量。
+
+## 安装和启用
+
+需要本机已经有 Codex CLI，并且 Codex 支持 `plugins` / `hooks` / `plugin_hooks`。
+
+推荐路径：
+
+```bash
+uvx csep setup
+```
+
+这条命令会安装 `csep` CLI，把本仓库注册为 Codex plugin marketplace，并打开 `~/.codex/config.toml` 里的插件开关。装完后新开一个 Codex session，插件就会跟着生命周期 hook 运行。
+
+没有 `uv` 的话，先装 `uv`，再跑同一条 setup：
+
+```bash
+brew install uv
+uvx csep setup
+```
+
+也可以直接跑安装脚本：
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/T0UGH/codex-self-evolution-plugin/main/scripts/setup.sh | bash
+```
+
+检查当前状态：
+
+```bash
+csep status | python3 -m json.tool
+```
+
+重点看 `plugin_hooks.manifest_exists`、`plugin_hooks.session_start_declared`、`plugin_hooks.stop_declared` 是否为 `true`。之后每次 `SessionStart` 会注入 memory，每次 `Stop` 会归档 transcript；reflection 只在触发条件满足时后台运行。
+
+想确认 recall 已经有数据，可以跑：
+
+```bash
+csep recall --recent
+```
+
+安装、验证和排障细节见 [docs/getting-started.md](docs/getting-started.md)。
+
+## 常用命令
+
+日常使用基本只会碰到这几条：
+
+| 命令 | 用途 |
+| --- | --- |
+| `csep setup` | 安装 CLI、注册 Codex plugin marketplace、启用 plugin hooks |
+| `csep status` | 看插件、hook、reflection、recall 当前是否正常 |
+| `csep config path` / `show` / `validate` | 查看配置路径、当前配置和校验结果 |
+| `csep recall "..."` | 在当前 repo 的历史 session 里找上下文 |
+| `csep recall --recent` | 看当前 repo 最近归档了哪些 session |
+| `csep session-reflect --status` | reflection 没按预期运行时再看 |
+
+`session-start`、`session-stop`、`session-archive`、`session-ingest` 主要给 hook、排障和历史回填使用。完整列表见 [docs/getting-started.md](docs/getting-started.md)。
+
+## 性能和运行方式
+
+`SessionStart` / `Stop` 前台只做轻量文件读写、归档触发和状态判断；模型 reflection 在后台运行，不阻塞 Codex 正常退出。
+
+这台机器 2026-05-15 的本地日志里，最近 100 次以内的前台 hook 大致是这个量级：
+
+| 路径 | median | p95 |
+| --- | --- | --- |
+| `session-start` | 26ms | 51ms |
+| `session-stop` | 15ms | 33ms |
+
+`session-reflect` 是后台模型任务，耗时通常按几十秒到几分钟看，不在 Codex Stop 前台等待。
+
+## 运行时目录
+
+默认状态目录：
+
+```text
+~/.codex-self-evolution/
+├── .env.provider
+├── config.toml
+├── logs/
+├── session_reflection/
+│   ├── jobs/
+│   ├── runs/
+│   ├── child_threads/
+│   ├── triggers/
+│   ├── locks/
+│   └── latest.json
+├── session_recall/
+│   └── state.db
+└── projects/
+    └── -Users-you-code-repo/
+        └── memory/
+            ├── USER.md
+            └── MEMORY.md
+```
+
+每个 repo 会按绝对路径分配独立 bucket。业务仓库保持干净，运行时状态留在用户 home 目录。
+
+## 安全边界
+
+`csep` 会让后台 reflection worker 读取当前 session，并写入本机文件。这里的边界要说清楚：
+
+- provider secret 不进仓库，密钥放在 `~/.codex-self-evolution/.env.provider`。
+- runtime state 不写进业务仓库。
+- `csep-reflect-*` 之外的 skill 不会被当作有效产物。
+- child thread 的口头声明不算数，父进程只认 `receipt.json` 和校验结果。
+- hook 前台不做长耗时工作，避免影响 Codex 正常退出。
+
+## 边界 / 不做什么
+
+- 不是云端记忆服务。
+- 不是团队知识库。
+- 不是通用 agent framework。
+- 不是旧的 reviewer / compiler / scheduler pipeline。
+
+它只做一件事：让你本机上的 Codex session 形成可验证、可召回、能继续积累的学习闭环。
+
+## 当前状态
+
+能用的部分：
+
+- Codex 启动时自动注入历史背景。
+- Codex 停止时自动归档当前 session。
+- 达到触发条件后，后台 reflection 会评估是否写入 memory 或 skill。
+- memory 写入有 `receipt.json` 和父进程边界校验。
+- 生成 skill 只允许使用 `csep-reflect-*` 前缀。
+- `csep recall` 可以查回当前 repo 的历史 session。
+- 同一仓库的多个 worktree 会尽量共享同一份 repo 记忆。
+- `csep status` / `csep config` 提供只读排障入口。
+
+还在打磨：
+
+- first-run onboarding
+- reflection 质量评估
+- README 图示和演示素材
+- Claude Code / Cursor 等其他客户端适配
+
+## 开发
+
+```bash
+python3 -m venv .venv
+.venv/bin/pip install -e '.[dev]'
+.venv/bin/python -m pytest -q
+```
+
+也可以使用当前仓库的 `uv` 环境：
+
+```bash
+uv run pytest -q
+uv run python -m build
+uv run twine check dist/*
+```
+
+## 文档
+
+| 文档 | 内容 |
+| --- | --- |
+| [docs/getting-started.md](docs/getting-started.md) | 本机安装、启用、验证和排障 |
+| [docs/architecture.md](docs/architecture.md) | 当前 Memory / Reflection Skills / Session Recall 总架构 |
+| [docs/session-reflection.md](docs/session-reflection.md) | session reflection worker、trigger policy 和写入边界 |
+| [docs/session-recall.md](docs/session-recall.md) | SQLite/FTS session recall 的写入、检索和边界 |
+
+## License
+
+MIT

csep-1.0.0/README.md

@@ -0,0 +1,220 @@
+# Codex Self-Evolution Plugin
+
+[![tests](https://github.com/T0UGH/codex-self-evolution-plugin/actions/workflows/test.yml/badge.svg)](https://github.com/T0UGH/codex-self-evolution-plugin/actions/workflows/test.yml)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![python: 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/)
+
+中文 | [English](README_en.md)
+
+让 Codex 把每次协作变成下一次的进步。
+
+> 用 Codex 5.3 Spark 的空闲额度，帮你的 Codex 在后台攒经验。
+
+如果你一天开好几个 Codex session，很快会发现一个很烦的问题：它这次能把活干完，但下次还是像第一次进仓库一样。测试命令要重讲，项目边界要重讲，你刚纠正过的写法和偏好也要重讲。
+
+当然可以自己搭一套 harness，把 prompt、脚本、知识库和日志都管起来。只是这件事太费劲了。`csep` 不要求你自己维护一整套外部流程，它直接接进 Codex 的生命周期，让 Codex 在真实使用里慢慢攒经验。
+
+Codex Self-Evolution Plugin，简称 `csep`。它在 `SessionStart` 时把稳定背景注入 Codex 上下文；在 `Stop` 时归档 transcript；遇到值得沉淀的 session，再开一个后台 reflection worker，把经验写成 memory 或 `csep-reflect-*` skill。历史 session 会进本地 SQLite/FTS，之后可以用 `csep recall` 找回来。
+
+它不是聊天记录备份工具。备份只能让你回看过去；`csep` 更关心下一次 Codex 能不能少问两句，少猜一点，少重复犯同一个错。
+
+![Codex Self-Evolution data flow](docs/assets/readme-csep-data-flow.png)
+
+图里只有三条线：`SessionStart` 读 memory，`Stop` 归档 session，触发后再由 reflection worker 写 memory 和 skill。
+
+## 为什么需要它
+
+用了几天 Codex 后，真正消耗人的往往不是大问题，而是这些重复的小事：
+
+- 这个仓库该怎么跑测试。
+- 这个用户不喜欢什么风格。
+- 哪些文件不能碰。
+- 上次已经验证过什么方案。
+- 某类任务应该用哪个工具、哪条命令。
+- 哪些纠正值得变成长期规则或 skill。
+
+`csep` 把这些经验留在本机。下次 Codex session 开始时，它们会先进入上下文；需要查旧 session 时，再用 `csep recall` 翻出来。
+
+## 它做什么
+
+| 能力 | 写入时机 | 下一次如何使用 |
+| --- | --- | --- |
+| Stable Memory | 达到 trigger 条件后，由 session reflection 写入 `USER.md` / `MEMORY.md` | `SessionStart` 自动注入 Codex 上下文 |
+| Session Recall | `Stop` hook 把 transcript 归档到本地 SQLite/FTS | `csep recall "..."` 按当前 repo 或全局检索历史片段 |
+| Reflection Skills | reflection worker 写入 `~/.codex/skills/csep-reflect-*` | Codex 原生 skills loader 自动加载 |
+| Runtime Status | hooks、配置、日志、reflection job、recall DB 都可只读检查 | `csep status` 排查当前运行状态 |
+
+每次 `Stop` 都会归档 session，但 reflection 只在计数或高信号命中后运行。
+
+## 设计原则
+
+- 状态默认放在 `~/.codex-self-evolution/`，不写进业务仓库。
+- `SessionStart` / `Stop` hook 失败时尽量放行，不拖垮 Codex 正常工作。
+- 每次 `Stop` 都会归档 session，但 reflection 不是每次都跑；只有计数或高信号命中后才 fork worker。
+- reflection worker 写完必须留下 `receipt.json`，父进程会校验路径、hash 和 skill 命名空间。
+- memory 写在当前 repo bucket；生成 skill 只允许落到 `csep-reflect-*`，不碰用户已有 skill。
+- 核心包只用 Python stdlib，尽量减少安装、升级和 hook 执行时的变量。
+
+## 安装和启用
+
+需要本机已经有 Codex CLI，并且 Codex 支持 `plugins` / `hooks` / `plugin_hooks`。
+
+推荐路径：
+
+```bash
+uvx csep setup
+```
+
+这条命令会安装 `csep` CLI，把本仓库注册为 Codex plugin marketplace，并打开 `~/.codex/config.toml` 里的插件开关。装完后新开一个 Codex session，插件就会跟着生命周期 hook 运行。
+
+没有 `uv` 的话，先装 `uv`，再跑同一条 setup：
+
+```bash
+brew install uv
+uvx csep setup
+```
+
+也可以直接跑安装脚本：
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/T0UGH/codex-self-evolution-plugin/main/scripts/setup.sh | bash
+```
+
+检查当前状态：
+
+```bash
+csep status | python3 -m json.tool
+```
+
+重点看 `plugin_hooks.manifest_exists`、`plugin_hooks.session_start_declared`、`plugin_hooks.stop_declared` 是否为 `true`。之后每次 `SessionStart` 会注入 memory，每次 `Stop` 会归档 transcript；reflection 只在触发条件满足时后台运行。
+
+想确认 recall 已经有数据，可以跑：
+
+```bash
+csep recall --recent
+```
+
+安装、验证和排障细节见 [docs/getting-started.md](docs/getting-started.md)。
+
+## 常用命令
+
+日常使用基本只会碰到这几条：
+
+| 命令 | 用途 |
+| --- | --- |
+| `csep setup` | 安装 CLI、注册 Codex plugin marketplace、启用 plugin hooks |
+| `csep status` | 看插件、hook、reflection、recall 当前是否正常 |
+| `csep config path` / `show` / `validate` | 查看配置路径、当前配置和校验结果 |
+| `csep recall "..."` | 在当前 repo 的历史 session 里找上下文 |
+| `csep recall --recent` | 看当前 repo 最近归档了哪些 session |
+| `csep session-reflect --status` | reflection 没按预期运行时再看 |
+
+`session-start`、`session-stop`、`session-archive`、`session-ingest` 主要给 hook、排障和历史回填使用。完整列表见 [docs/getting-started.md](docs/getting-started.md)。
+
+## 性能和运行方式
+
+`SessionStart` / `Stop` 前台只做轻量文件读写、归档触发和状态判断；模型 reflection 在后台运行，不阻塞 Codex 正常退出。
+
+这台机器 2026-05-15 的本地日志里，最近 100 次以内的前台 hook 大致是这个量级：
+
+| 路径 | median | p95 |
+| --- | --- | --- |
+| `session-start` | 26ms | 51ms |
+| `session-stop` | 15ms | 33ms |
+
+`session-reflect` 是后台模型任务，耗时通常按几十秒到几分钟看，不在 Codex Stop 前台等待。
+
+## 运行时目录
+
+默认状态目录：
+
+```text
+~/.codex-self-evolution/
+├── .env.provider
+├── config.toml
+├── logs/
+├── session_reflection/
+│   ├── jobs/
+│   ├── runs/
+│   ├── child_threads/
+│   ├── triggers/
+│   ├── locks/
+│   └── latest.json
+├── session_recall/
+│   └── state.db
+└── projects/
+    └── -Users-you-code-repo/
+        └── memory/
+            ├── USER.md
+            └── MEMORY.md
+```
+
+每个 repo 会按绝对路径分配独立 bucket。业务仓库保持干净，运行时状态留在用户 home 目录。
+
+## 安全边界
+
+`csep` 会让后台 reflection worker 读取当前 session，并写入本机文件。这里的边界要说清楚：
+
+- provider secret 不进仓库，密钥放在 `~/.codex-self-evolution/.env.provider`。
+- runtime state 不写进业务仓库。
+- `csep-reflect-*` 之外的 skill 不会被当作有效产物。
+- child thread 的口头声明不算数，父进程只认 `receipt.json` 和校验结果。
+- hook 前台不做长耗时工作，避免影响 Codex 正常退出。
+
+## 边界 / 不做什么
+
+- 不是云端记忆服务。
+- 不是团队知识库。
+- 不是通用 agent framework。
+- 不是旧的 reviewer / compiler / scheduler pipeline。
+
+它只做一件事：让你本机上的 Codex session 形成可验证、可召回、能继续积累的学习闭环。
+
+## 当前状态
+
+能用的部分：
+
+- Codex 启动时自动注入历史背景。
+- Codex 停止时自动归档当前 session。
+- 达到触发条件后，后台 reflection 会评估是否写入 memory 或 skill。
+- memory 写入有 `receipt.json` 和父进程边界校验。
+- 生成 skill 只允许使用 `csep-reflect-*` 前缀。
+- `csep recall` 可以查回当前 repo 的历史 session。
+- 同一仓库的多个 worktree 会尽量共享同一份 repo 记忆。
+- `csep status` / `csep config` 提供只读排障入口。
+
+还在打磨：
+
+- first-run onboarding
+- reflection 质量评估
+- README 图示和演示素材
+- Claude Code / Cursor 等其他客户端适配
+
+## 开发
+
+```bash
+python3 -m venv .venv
+.venv/bin/pip install -e '.[dev]'
+.venv/bin/python -m pytest -q
+```
+
+也可以使用当前仓库的 `uv` 环境：
+
+```bash
+uv run pytest -q
+uv run python -m build
+uv run twine check dist/*
+```
+
+## 文档
+
+| 文档 | 内容 |
+| --- | --- |
+| [docs/getting-started.md](docs/getting-started.md) | 本机安装、启用、验证和排障 |
+| [docs/architecture.md](docs/architecture.md) | 当前 Memory / Reflection Skills / Session Recall 总架构 |
+| [docs/session-reflection.md](docs/session-reflection.md) | session reflection worker、trigger policy 和写入边界 |
+| [docs/session-recall.md](docs/session-recall.md) | SQLite/FTS session recall 的写入、检索和边界 |
+
+## License
+
+MIT

csep-1.0.0/pyproject.toml

@@ -0,0 +1,76 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "csep"
+version = "1.0.0"
+description = "Self-evolution loop for OpenAI Codex: session reflection, session recall, and reflection-generated skills with zero runtime dependencies."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { file = "LICENSE" }
+authors = [
+    { name = "T0UGH" },
+]
+keywords = [
+    "codex",
+    "openai",
+    "llm",
+    "memory",
+    "recall",
+    "hooks",
+    "plugin",
+    "self-evolution",
+]
+# Keep runtime deps empty — the plugin only uses stdlib. If you ever add a real
+# dep, also update the "zero runtime dependencies" wording in the description
+# above and in README.
+dependencies = []
+
+# Classifiers drive PyPI search + the project page sidebar. Keep the list
+# narrow: only things that are actually true of this package.
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Quality Assurance",
+]
+
+[project.urls]
+Homepage = "https://github.com/T0UGH/codex-self-evolution-plugin"
+Repository = "https://github.com/T0UGH/codex-self-evolution-plugin"
+Issues = "https://github.com/T0UGH/codex-self-evolution-plugin/issues"
+Documentation = "https://github.com/T0UGH/codex-self-evolution-plugin/blob/main/docs/getting-started.md"
+Architecture = "https://github.com/T0UGH/codex-self-evolution-plugin/blob/main/docs/architecture.md"
+
+[project.optional-dependencies]
+# `pip install csep[dev]` for contributors.
+dev = ["pytest>=7", "build>=1.0", "twine>=5"]
+
+[project.scripts]
+codex-self-evolution = "codex_self_evolution.cli:main"
+csep = "codex_self_evolution.csep:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.package-data]
+codex_self_evolution = [
+    "session_recall/policy.md",
+    "session_recall/session_recall.md",
+    "plugin_bundle/.codex-plugin/plugin.json",
+    "plugin_bundle/.codex-plugin/hooks.json",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

csep-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

csep-1.0.0/src/codex_self_evolution/__init__.py

@@ -0,0 +1,3 @@
+__all__ = ["__version__"]
+
+__version__ = "1.0.0"