@hunyed15/codecgc 0.1.11 → 0.2.0

package/INSTALLATION.md

@@ -1,211 +0,0 @@
-# CodeCGC 安装指南
-
-本文说明如何从 npm 安装 CodeCGC，并把它接入到具体项目中。
-
-## 环境要求
-
-- Node.js >= 20
-- npm >= 9
-- Python >= 3.10
-- 可选：Claude Code、Codex CLI、Gemini CLI
-
-CodeCGC 的 npm 包提供 `cgc*` 命令；Python 运行时负责 MCP 编排器、执行器桥接、路由策略检查和工作流脚本。
-
-## 1. 全局安装 CLI
-
-```bash
-npm install -g @hunyed15/codecgc --registry=https://registry.npmjs.org/
-```
-
-全局安装只注册命令，不会默认写入 `~/.claude`。这是当前主线设计：每个业务项目通过项目级安装生成自己的 `.mcp.json`、`.claude/` 和 `model-routing.yaml`。
-
-验证命令：
-
-```bash
-cgc --help
-cgc-install --help
-cgc-doctor --help
-```
-
-## 2. 在目标项目执行项目级安装
-
-进入你要使用 CodeCGC 的项目根目录：
-
-```bash
-cd your-project
-cgc-install
-```
-
-默认安装模式是项目级安装，等价于：
-
-```bash
-cgc-install --mode local --workspace .
-```
-
-安装会创建或同步：
-
-```text
-.mcp.json
-model-routing.yaml
-.claude/
-  settings.local.json
-  hooks/
-    route-edit.ps1
-  commands/
-    cgc*.md
-.codex/
-  codecgcrc.json
-.gemini/
-  policies/
-    codecgc-policy.toml
-codecgc/
-  START_HERE.md
-  features/
-  issues/
-  execution/
-  requirements/
-  architecture/
-  roadmap/
-  compound/
-  docs/
-  reference/
-  fixtures/
-```
-
-这些文件属于目标项目的 CodeCGC 集成面。不同电脑、不同项目的安装路径可能不同，因此应由 `cgc-install` 在本机生成，不应从 CodeCGC 源码仓库复制固定路径。
-
-## 3. 首次启动和自检
-
-安装后执行：
-
-```bash
-cgc-start
-cgc-status
-cgc-doctor
-```
-
-在 Claude 中也可以使用：
-
-```text
-/cgc-start
-/cgc-status
-/cgc-doctor
-```
-
-`cgc-start` 是只读的新手入口，会提示当前项目的最短使用路径。`cgc-status` 检查项目级集成文件是否齐全。`cgc-doctor` 检查 Python、MCP 运行时、执行器导入和项目集成状态。
-
-## 4. 日常使用
-
-推荐从一个入口开始：
-
-```text
-/cgc 新增一个登录页，放在 src/components/LoginForm.tsx
-```
-
-命令行回退路径：
-
-```bash
-cgc "新增一个登录页，放在 src/components/LoginForm.tsx"
-```
-
-CodeCGC 会根据工作流状态决定下一步是规划、执行、审核、继续还是收尾。只有在你明确知道当前阶段时，才需要直接使用子命令：
-
-```bash
-cgc-plan ...
-cgc-build ...
-cgc-fix ...
-cgc-test ...
-cgc-review ...
-cgc-route ...
-cgc-history ...
-```
-
-## 5. 角色与写入边界
-
-CodeCGC 的默认协作边界是：
-
-- Claude：需求、规划、设计、文档、审核、验收和工作流状态。
-- Codex：后端代码和后端测试。
-- Gemini：前端代码和前端测试。
-
-`model-routing.yaml` 是项目内路由策略的唯一来源。Claude 的 hook 不承载业务规则，只把 `Edit`、`Write`、`MultiEdit` 写入请求交给同一套策略检查器，从而避免 Claude 绕过路由边界直接修改代码。
-
-## 6. 用户级安装
-
-用户级安装不是默认路径。只有在你明确希望同步 `~/.claude` 时才使用：
-
-```bash
-cgc-install --mode user-dry-run
-cgc-install --mode user
-```
-
-建议先使用 `user-dry-run` 预览变更。普通项目接入场景应使用默认项目级安装。
-
-## 7. 发布包维护者检查
-
-维护 CodeCGC 包时，建议在源码仓库运行：
-
-```bash
-python -m pytest tests --basetemp D:\tmp\codecgc-pytest
-python -m compileall -q scripts codecgcmcp\src codexmcp\src geminimcp\src
-python scripts\audit_codecgc_package_runtime.py --format json
-python scripts\audit_codecgc_release_readiness.py --format json
-npm pack --dry-run --json
-```
-
-如果默认临时目录受限，可以指定发布探针目录：
-
-```bash
-set CODECGC_RELEASE_PROBE_ROOT=D:\tmp
-python scripts\audit_codecgc_release_readiness.py --format json
-```
-
-## 8. 常见问题
-
-### `cgc` 命令找不到
-
-确认 npm 全局 bin 目录已经加入 `PATH`：
-
-```bash
-npm config get prefix
-```
-
-然后检查对应系统的全局 bin 路径是否在环境变量中。
-
-### `cgc-doctor` 提示 Python 或 MCP 依赖缺失
-
-先确认 Python 可用：
-
-```bash
-python --version
-```
-
-再安装核心依赖：
-
-```bash
-python -m pip install -r requirements.txt
-```
-
-如果是在源码开发环境中，可以按 `cgc-doctor` 输出的建议执行 editable install。
-
-### 项目级集成缺失或过期
-
-在目标项目根目录重新执行：
-
-```bash
-cgc-install
-cgc-status
-```
-
-### 写入被 hook 拦截
-
-检查 `model-routing.yaml`。如果目标路径属于 unknown 或 shared，应该先明确文件归属或拆分任务，而不是绕过 hook。
-
-## 参考
-
-- `README.md`
-- `codecgc/reference/quickstart.md`
-- `codecgc/reference/onboarding.md`
-- `codecgc/reference/project-structure.md`
-- `codecgc/reference/policy-routing.md`
-- `codecgc/reference/troubleshooting.md`

package/codexmcp/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 guda.studio
-
-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.

package/codexmcp/README.md

@@ -1,294 +0,0 @@
-![这是图片](./images/title.png)
-
-<div align="center">
-
-
-**让 Claude Code 与 Codex 无缝协作** 
-
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![Python Version](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/) [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)[![Share](https://img.shields.io/badge/share-000000?logo=x&logoColor=white)](https://x.com/intent/tweet?text=CodexMCP：让%20Claude%20Code%20与%20Codex%20无缝协作%20https://github.com/GuDaStudio/codexmcp%20%23AI%20%23Coding%20%23MCP) [![Share](https://img.shields.io/badge/share-1877F2?logo=facebook&logoColor=white)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/GuDaStudio/codexmcp) [![Share](https://img.shields.io/badge/share-FF4500?logo=reddit&logoColor=white)](https://www.reddit.com/submit?title=CodexMCP：让%20Claude%20Code%20与%20Codex%20无缝协作&url=https://github.com/GuDaStudio/codexmcp) [![Share](https://img.shields.io/badge/share-0088CC?logo=telegram&logoColor=white)](https://t.me/share/url?url=https://github.com/GuDaStudio/codexmcp&text=CodexMCP：让%20Claude%20Code%20与%20Codex%20无缝协作)
-
-
-⭐ 在GitHub上给我们点星~您的支持对我们意义重大！ 🙏😊
-
-[English](./docs/README_EN.md) | 简体中文
-
-</div>
-
----
-
-## 一、项目简介 
-
-在当前 AI 辅助编程生态中，**Claude Code** 擅长架构设计与全局思考，而 **Codex** 在代码生成与细节优化上表现卓越。**CodexMCP** 作为两者之间的桥梁，通过 MCP 协议让它们优势互补：
-
-- **Claude Code**：负责需求分析、架构规划、代码重构
-- **Codex**：负责算法实现、bug 定位、代码审查
-- **CodexMCP**：管理会话上下文，支持多轮对话与并行任务
-
-相比官方 Codex MCP 实现，CodexMCP 引入了**会话持久化**、**并行执行**和**推理追踪**等企业级特性，让 AI 编程助手之间的协作更加智能高效。CodexMCP 与官方 Codex MCP 区别一览：
-
-
-| 特性 | 官方版 | CodexMCP |
-|------|--------|----------|
-| 基本 Codex 调用 | √ | √ |
-| 多轮对话 | × | √ |
-| 推理详情追踪 | × | √ |
-| 并行任务支持 | ×  | √  |
-| 错误处理 | ×  | √  |
-
-
----
-
-## 二、快速开始
-
-### 0. 前置要求
-
-请确保您已成功**安装**和**配置**claude code与codex两个编程工具。
-- [Claude Code 安装指南](https://docs.claude.com/docs/claude-code)
-- [Codex CLI 安装指南](https://developers.openai.com/codex/quickstart)
-
-> [!IMPORTANT]
-> 请确保您的claude code版本在v2.0.56以上；codex cli版本在v0.61.0以上！
-
-请确保您已成功安装[uv工具](https://docs.astral.sh/uv/getting-started/installation/)：
-
-- Windows
-  在Powershell中运行以下命令：
-  ```
-  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
-  ```
-
-- Linux/macOS
-  使用curl/wget下载并安装:
-  ```
-  curl -LsSf https://astral.sh/uv/install.sh | sh #使用curl
-
-  wget -qO- https://astral.sh/uv/install.sh | sh #使用wget
-  ```
-
-**注意，我们极力推荐Windows用户在WSL中运行本项目！**
-
-<!-- 如果您正在为订阅和配置而忧愁，我们非常欢迎您[积极联系我们](https://cc.guda.studio)。 -->
-
-### 1. 安装步骤
-
-**1.1** 移除官方 Codex MCP（如果已安装）。
-
-```bash
-claude mcp remove codex
-```
-
-**1.2** 安装 CodexMCP。
-
-```bash
-claude mcp add codex -s user --transport stdio -- uvx --from git+https://github.com/GuDaStudio/codexmcp.git codexmcp
-```
-
-**1.3** 验证安装。在 **终端** 中运行：
-
-```
-claude mcp list
-```
-
-> [!IMPORTANT]
-> 如果看到如下描述，说明安装成功！
->  `codex: uvx --from git+https://github.com/GuDaStudio/codexmcp.git codexmcp - ✓ Connected` 
-
-**1.4** 可选择默认允许claude code自动与codex交互，在`~/.claude/settings.json`添加 `mcp__codex__codex` allow项
-![](images/image.png)
-
-### 2. 配置claude code提示词（可选）
-
-为使claude code更好完成与codex的协同工作，我们**极力推荐您在 `~/.claude/CLAUDE.md`中添加以下内容**
-
-<details>
-<summary>展开查看prompt</summary>
-
-
-```
-## Core Instruction for CodeX MCP
-
-在任何时刻，你必须思考当前过程可以如何与codex进行协作，如何调用Codex 为你提供的MCP工具作为你客观全面分析的保障。
-其中你**务必执行**以下几个步骤：
-**1** 在你对用户需求形成初步分析后，将用户需求、初始思路告知codex，并要求其完善需求分析和实施计划。
-**2** 在实施具体编码任务前，**必须向codex索要代码实现原型（要求codex仅给出unified diff patch，严禁对代码做任何真实修改）**。在获取代码原型后，你**只能以此为逻辑参考，再次对代码修改进行重写**，形成企业生产级别、可读性极高、可维护性极高的代码后，才能实施具体编程修改任务。
-**3** 无论何时，只要完成切实编码行为后，**必须立即使用codex review代码改动和对应需求完成程度**。
-**4** codex只能给出参考，你**必须有自己的思考，甚至需要对codex的回答提出置疑**。尽信书则不如无书，你与codex的最终使命都是达成统一、全面、精准的意见，所以你们必须不断争辩已找到通向真理的唯一途径。
-
-
-## Codex Tool Invocation Specification
-
- 1. 工具概述
-
-  codex MCP 提供了一个工具 `codex`，用于执行 AI 辅助的编码任务。该工具**通过 MCP 协议调用**，无需使用命令行。
-
-  2. 工具参数
-
-  **必选**参数：
-  - PROMPT (string): 发送给 codex 的任务指令
-  - cd (Path): codex 执行任务的工作目录根路径
-
-  可选参数：
-  - sandbox (string): 沙箱策略，可选值：
-    - "read-only" (默认): 只读模式，最安全
-    - "workspace-write": 允许在工作区写入
-    - "danger-full-access": 完全访问权限
-  - SESSION_ID (UUID | null): 用于继续之前的会话以与codex进行多轮交互，默认为 None（开启新会话）
-  - skip_git_repo_check (boolean): 是否允许在非 Git 仓库中运行，默认 False
-  - return_all_messages (boolean): 是否返回所有消息（包括推理、工具调用等），默认 False
-  - image (List[Path] | null): 附加一个或多个图片文件到初始提示词，默认为 None
-  - model (string | null): 指定使用的模型，默认为 None（使用用户默认配置）
-  - yolo (boolean | null): 无需审批运行所有命令（跳过沙箱），默认 False
-  - profile (string | null): 从 `~/.codex/config.toml` 加载的配置文件名称，默认为 None（使用用户默认配置）
-
-  返回值：
-  {
-    "success": true,
-    "SESSION_ID": "uuid-string",
-    "agent_messages": "agent回复的文本内容",
-    "all_messages": []  // 仅当 return_all_messages=True 时包含
-  }
-  或失败时：
-  {
-    "success": false,
-    "error": "错误信息"
-  }
-
-  3. 使用方式
-
-  开启新对话：
-  - 不传 SESSION_ID 参数（或传 None）
-  - 工具会返回新的 SESSION_ID 用于后续对话
-
-  继续之前的对话：
-  - 将之前返回的 SESSION_ID 作为参数传入
-  - 同一会话的上下文会被保留
-
-  4. 调用规范
-
-  **必须遵守**：
-  - 每次调用 codex 工具时，必须保存返回的 SESSION_ID，以便后续继续对话
-  - cd 参数必须指向存在的目录，否则工具会静默失败
-  - 严禁codex对代码进行实际修改，使用 sandbox="read-only" 以避免意外，并要求codex仅给出unified diff patch即可
-
-  推荐用法：
-  - 如需详细追踪 codex 的推理过程和工具调用，设置 return_all_messages=True
-  - 对于精准定位、debug、代码原型快速编写等任务，优先使用 codex 工具
-
-  5. 注意事项
-
-  - 会话管理：始终追踪 SESSION_ID，避免会话混乱
-  - 工作目录：确保 cd 参数指向正确且存在的目录
-  - 错误处理：检查返回值的 success 字段，处理可能的错误
-
-```
-
-</details>
-
-
-
----
-
-## 三、工具说明
-
-<details>
-<summary>点击查看codex工具参数说明</summary>
-
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|------|------|------|--------|------|
-| `PROMPT` | `str` | ✅ | - | 发送给 Codex 的任务指令 |
-| `cd` | `Path` | ✅ | - | Codex 工作目录根路径 |
-| `sandbox` | `Literal` | ❌ | `"read-only"` | 沙箱策略：`read-only` / `workspace-write` / `danger-full-access` |
-| `SESSION_ID` | `UUID \| None` | ❌ | `None` | 会话 ID（None 则开启新会话） |
-| `skip_git_repo_check` | `bool` | ❌ | `False` | 是否允许在非 Git 仓库运行 |
-| `return_all_messages` | `bool` | ❌ | `False` | 是否返回完整推理信息 |
-| `image` | `List[Path] \| None` | ❌ | `None` | 附加图片文件到初始提示词 |
-| `model` | `str \| None` | ❌ | `None` | 指定使用的模型（默认使用用户配置） |
-| `yolo` | `bool \| None` | ❌ | `False` | 无需审批运行所有命令（跳过沙箱） |
-| `profile` | `str \| None` | ❌ | `None` | 从 `~/.codex/config.toml` 加载的配置文件名称 |
-
-</details>
-
-<details>
-<summary>点击查看codex工具返回值结构</summary>
-
-**成功时：**
-```json
-{
-  "success": true,
-  "SESSION_ID": "550e8400-e29b-41d4-a716-446655440000",
-  "agent_messages": "Codex 的回复内容...",
-  "all_messages": [...]  // 仅当 return_all_messages=True 时包含
-}
-```
-
-**失败时：**
-```json
-{
-  "success": false,
-  "error": "错误信息描述"
-}
-```
-
-</details>
-
----
-
-## 四、FAQ
-
-<details>
-<summary>Q1: 是否需要额外付费？</summary>
-
- **CodexMCP 本身完全免费开源，无需任何额外付费！** 
-
-</details>
-
-<details>
-<summary>Q2: 并行调用会冲突吗？</summary>
-
-不会。每个调用使用独立的 `SESSION_ID`，完全隔离。
-
-</details>
-
-
----
-
-## 🤝 贡献指南
-
-<details>
-<summary>我们欢迎所有形式的贡献！</summary>
-
-### 开发环境配置
-
-```bash
-# 克隆仓库
-git clone https://github.com/GuDaStudio/codexmcp.git
-cd codexmcp
-
-# 安装依赖
-uv sync
-```
-
-### 提交规范
-
-- 遵循 [Conventional Commits](https://www.conventionalcommits.org/)
-- 提交测试用例
-- 更新文档
-
-</details>
-
-
-
----
-
-## 📄 许可证
-
-本项目采用 [MIT License](LICENSE) 开源协议。
-Copyright (c) 2025 [guda.studio](mailto:gudaclaude@gmail.com)
-
----
-<div align="center">
-
-## 用 🌟 为本项目助力~
-[![Star History Chart](https://api.star-history.com/svg?repos=GuDaStudio/codexmcp&type=date&legend=top-left)](https://www.star-history.com/#GuDaStudio/codexmcp&type=date&legend=top-left)
-
-</div>

package/codexmcp/pyproject.toml

@@ -1,37 +0,0 @@
-[build-system]
-requires = ["hatchling>=1.25"]
-build-backend = "hatchling.build"
-
-[project]
-name = "codexmcp"
-version = "0.7.4"
-description = "FastMCP server wrapping the Codex CLI."
-readme = "README.md"
-requires-python = ">=3.12"
-dependencies = [
-    "mcp[cli]>=1.20.0",
-    "pydantic>=2.0",
-]
-authors = [
-    { name = "guda.studio", email = "gudaclaude@gmail.com" },
-]
-license = { text = "MIT" }
-keywords = ["mcp", "fastmcp", "codex"]
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.12",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-]
-
-[project.urls]
-Homepage = "https://github.com/GuDaStudio/codexmcp"
-
-[project.scripts]
-codexmcp = "codexmcp.cli:main"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/codexmcp"]
-
-[tool.hatch.build.targets.sdist]
-include = ["src/codexmcp", "README.md", "LICENSE"]