{"_id":"@auroraflow/code-darwin-arm64","_rev":"6-627eb306aca83eafc960f6268878a13c","name":"@auroraflow/code-darwin-arm64","dist-tags":{"latest":"0.0.6"},"versions":{"0.0.1":{"name":"@auroraflow/code-darwin-arm64","version":"0.0.1","license":"Apache-2.0","_id":"@auroraflow/code-darwin-arm64@0.0.1","maintainers":[{"name":"auroraflow","email":"auroraflow_intl@outlook.com"}],"homepage":"https://github.com/auroraflowintl/code#readme","bugs":{"url":"https://github.com/auroraflowintl/code/issues"},"os":["darwin"],"cpu":["arm64"],"dist":{"shasum":"65701ef8f1e311db09e57e7f23840ff566a4a596","tarball":"https://registry.npmjs.org/@auroraflow/code-darwin-arm64/-/code-darwin-arm64-0.0.1.tgz","fileCount":3,"integrity":"sha512-xQ7qrM/DGUzqJYJkNjz9MqlsaEanDh6u2UyQI3b1/01ApCvY3umptLFUK6HCs5A4wtZmhbzVvTJabMR/iXKNIw==","signatures":[{"sig":"MEYCIQDIMLVTePVGgsXDp1sQpMIOq0dlxjcw3ffOzAuiD5o0YwIhAJ4qUQAU+DOuDfoPfMHe7/GOx1+yIB3jrPJ2Pz29klxj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":186935170},"_from":"file:/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.1.tgz","engines":{"node":">=16"},"_npmUser":{"name":"auroraflow","email":"auroraflow_intl@outlook.com"},"_resolved":"/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.1.tgz","_integrity":"sha512-xQ7qrM/DGUzqJYJkNjz9MqlsaEanDh6u2UyQI3b1/01ApCvY3umptLFUK6HCs5A4wtZmhbzVvTJabMR/iXKNIw==","repository":{"url":"git+https://github.com/auroraflowintl/code.git","type":"git","directory":"codex-cli"},"_npmVersion":"11.13.0","description":"Aurora 编程 Agent 是基于 OpenAI Codex CLI 二开的 Aurora 自有编程代理。它的目标是提供类似 Codex 的本地编程体验，但身份、模型目录、API Key 与运行时路由都接入 Aurora 体系。","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"packageManager":"pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319","_npmOperationalInternal":{"tmp":"tmp/code-darwin-arm64_0.0.1_1780436022023_0.7279922723497052","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@auroraflow/code-darwin-arm64","version":"0.0.2","license":"Apache-2.0","_id":"@auroraflow/code-darwin-arm64@0.0.2","maintainers":[{"name":"auroraflow","email":"auroraflow_intl@outlook.com"}],"homepage":"https://github.com/auroraflowintl/code#readme","bugs":{"url":"https://github.com/auroraflowintl/code/issues"},"os":["darwin"],"cpu":["arm64"],"dist":{"shasum":"15038bee14aa19675eba2b6b64d4372e8ae2b711","tarball":"https://registry.npmjs.org/@auroraflow/code-darwin-arm64/-/code-darwin-arm64-0.0.2.tgz","fileCount":3,"integrity":"sha512-0CTW0VcX5AkgZkjTRPp04zXoRLZm3Ny4J/p3rkaayUfO/MZeN0b1MaKGHN3OgzxQyOnd+kJ2mk7v/f4PcqZfZQ==","signatures":[{"sig":"MEYCIQDPfPru5PWNhT2sNWWWQSOxjye4xlbD4NgMRyoP0nN+fQIhAMjH9T7FAvl28tC2F6dAthcBAIyn8orywHR9vkekCahd","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":186984891},"_from":"file:/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.2.tgz","engines":{"node":">=16"},"_npmUser":{"name":"auroraflow","email":"auroraflow_intl@outlook.com"},"_resolved":"/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.2.tgz","_integrity":"sha512-0CTW0VcX5AkgZkjTRPp04zXoRLZm3Ny4J/p3rkaayUfO/MZeN0b1MaKGHN3OgzxQyOnd+kJ2mk7v/f4PcqZfZQ==","repository":{"url":"git+https://github.com/auroraflowintl/code.git","type":"git","directory":"codex-cli"},"_npmVersion":"11.13.0","description":"Aurora 编程 Agent 是基于 OpenAI Codex CLI 二开的 Aurora 自有编程代理。它的目标是提供类似 Codex 的本地编程体验，但身份、模型目录、API Key 与运行时路由都接入 Aurora 体系。","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"packageManager":"pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319","_npmOperationalInternal":{"tmp":"tmp/code-darwin-arm64_0.0.2_1780463454170_0.16720414748141388","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@auroraflow/code-darwin-arm64","version":"0.0.3","license":"Apache-2.0","_id":"@auroraflow/code-darwin-arm64@0.0.3","maintainers":[{"name":"auroraflow","email":"auroraflow_intl@outlook.com"}],"homepage":"https://github.com/auroraflowintl/code#readme","bugs":{"url":"https://github.com/auroraflowintl/code/issues"},"os":["darwin"],"cpu":["arm64"],"dist":{"shasum":"2140c5d203542e311e562943c797feb65e78e3a8","tarball":"https://registry.npmjs.org/@auroraflow/code-darwin-arm64/-/code-darwin-arm64-0.0.3.tgz","fileCount":3,"integrity":"sha512-g+I51v+RIQuHIFJXonUabwu/OXYfojgcSiKqObGeLzonuHpQGmVHxk+prjNSfW3Rx3d473EChBTl/WOllzugaw==","signatures":[{"sig":"MEUCIQDiRJjbti4NAOVQXV78UVSapV/l2fFCQI+tq6OE8Re5ZAIgMfpvu/KrQn3593re9oEKlTl1y/d1eoFcrEFYZY1TVQ4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":186968347},"_from":"file:dist/aurora-code/code-darwin-arm64-0.0.3.tgz","engines":{"node":">=16"},"_npmUser":{"name":"auroraflow","email":"auroraflow_intl@outlook.com"},"_resolved":"/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.3.tgz","_integrity":"sha512-g+I51v+RIQuHIFJXonUabwu/OXYfojgcSiKqObGeLzonuHpQGmVHxk+prjNSfW3Rx3d473EChBTl/WOllzugaw==","repository":{"url":"git+https://github.com/auroraflowintl/code.git","type":"git","directory":"codex-cli"},"_npmVersion":"11.13.0","description":"Aurora 编程 Agent 是基于 OpenAI Codex CLI 二开的 Aurora 自有编程代理。它的目标是提供类似 Codex 的本地编程体验，但身份、模型目录、API Key 与运行时路由都接入 Aurora 体系。","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"packageManager":"pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319","_npmOperationalInternal":{"tmp":"tmp/code-darwin-arm64_0.0.3_1780501900001_0.46094715844585865","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@auroraflow/code-darwin-arm64","version":"0.0.4","license":"Apache-2.0","_id":"@auroraflow/code-darwin-arm64@0.0.4","maintainers":[{"name":"auroraflow","email":"auroraflow_intl@outlook.com"}],"homepage":"https://github.com/auroraflowintl/code#readme","bugs":{"url":"https://github.com/auroraflowintl/code/issues"},"os":["darwin"],"cpu":["arm64"],"dist":{"shasum":"f1c9fe21174ba3230df46cd2ea4fca4ffd643fd6","tarball":"https://registry.npmjs.org/@auroraflow/code-darwin-arm64/-/code-darwin-arm64-0.0.4.tgz","fileCount":3,"integrity":"sha512-pZQWx4k9gBCV+tePRyW/jl14jGzThfxMwA2O4XqKHU1lLd93+JG9H6WhbVDWKY/5q0I6Z7FhBkPzl4VCIlnljg==","signatures":[{"sig":"MEYCIQCujfNa47DtwnZ6YqZT42NLV9Elb/G/2KpFEofjwHoXlQIhAJXq5WjiDaIIU+GcABSSAFnbu0K5KA2IyC6IR/xmWPek","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":186951755},"_from":"file:/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.4.tgz","engines":{"node":">=16"},"_npmUser":{"name":"auroraflow","email":"auroraflow_intl@outlook.com"},"_resolved":"/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.4.tgz","_integrity":"sha512-pZQWx4k9gBCV+tePRyW/jl14jGzThfxMwA2O4XqKHU1lLd93+JG9H6WhbVDWKY/5q0I6Z7FhBkPzl4VCIlnljg==","repository":{"url":"git+https://github.com/auroraflowintl/code.git","type":"git","directory":"codex-cli"},"_npmVersion":"11.13.0","description":"Aurora 编程 Agent 是基于 OpenAI Codex CLI 二开的 Aurora 自有编程代理。它的目标是提供类似 Codex 的本地编程体验，但身份、模型目录、API Key 与运行时路由都接入 Aurora 体系。","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"packageManager":"pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319","_npmOperationalInternal":{"tmp":"tmp/code-darwin-arm64_0.0.4_1780553548296_0.8729260548428404","host":"s3://npm-registry-packages-npm-production"}},"0.0.5":{"name":"@auroraflow/code-darwin-arm64","version":"0.0.5","license":"Apache-2.0","_id":"@auroraflow/code-darwin-arm64@0.0.5","maintainers":[{"name":"auroraflow","email":"auroraflow_intl@outlook.com"}],"homepage":"https://github.com/auroraflowintl/code#readme","bugs":{"url":"https://github.com/auroraflowintl/code/issues"},"os":["darwin"],"cpu":["arm64"],"dist":{"shasum":"530f80f0f8b8e7bea263d5020783018d9fa4f7d6","tarball":"https://registry.npmjs.org/@auroraflow/code-darwin-arm64/-/code-darwin-arm64-0.0.5.tgz","fileCount":3,"integrity":"sha512-iVqo7+Gud4yhV5yV9oD37eoHidzEYUaFdCHXdqRZSqXSMIxv+7fLQjQwYyjsYmMjSirmJl/UHBuRIj4+/5ueMQ==","signatures":[{"sig":"MEYCIQDouo4hkmJuP4fchb3u8x6xbUVvHz0UoU5zeLjdOwBgpQIhAPLb9puiGFOtNgU/zrqhPJsr63LjD3gof8yjmawAe8jD","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":186951755},"_from":"file:/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.5.tgz","engines":{"node":">=16"},"_npmUser":{"name":"auroraflow","email":"auroraflow_intl@outlook.com"},"_resolved":"/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.5.tgz","_integrity":"sha512-iVqo7+Gud4yhV5yV9oD37eoHidzEYUaFdCHXdqRZSqXSMIxv+7fLQjQwYyjsYmMjSirmJl/UHBuRIj4+/5ueMQ==","repository":{"url":"git+https://github.com/auroraflowintl/code.git","type":"git","directory":"codex-cli"},"_npmVersion":"11.13.0","description":"Aurora 编程 Agent 是基于 OpenAI Codex CLI 二开的 Aurora 自有编程代理。它的目标是提供类似 Codex 的本地编程体验，但身份、模型目录、API Key 与运行时路由都接入 Aurora 体系。","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"packageManager":"pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319","_npmOperationalInternal":{"tmp":"tmp/code-darwin-arm64_0.0.5_1780578920757_0.7421356991157133","host":"s3://npm-registry-packages-npm-production"}},"0.0.6":{"name":"@auroraflow/code-darwin-arm64","version":"0.0.6","license":"Apache-2.0","os":["darwin"],"cpu":["arm64"],"repository":{"type":"git","url":"git+https://github.com/auroraflowintl/code.git","directory":"codex-cli"},"engines":{"node":">=16"},"packageManager":"pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319","_id":"@auroraflow/code-darwin-arm64@0.0.6","description":"Aurora 编程 Agent 是基于 OpenAI Codex CLI 二开的 Aurora 自有编程代理。它的目标是提供类似 Codex 的本地编程体验，但身份、模型目录、API Key 与运行时路由都接入 Aurora 体系。","bugs":{"url":"https://github.com/auroraflowintl/code/issues"},"homepage":"https://github.com/auroraflowintl/code#readme","_integrity":"sha512-vTSuUqdIhB8riYhWxAbE+pN0NmXSIJPCq8BBZsQ2qy1BLdToDZMmwSEykyNC+2tlHpinSl2uFfHt5z46wv5V0g==","_resolved":"/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.6.tgz","_from":"file:/Users/theodorelau/Desktop/AURORAMOS.COM/aurora-code/dist/aurora-code/code-darwin-arm64-0.0.6.tgz","_nodeVersion":"24.16.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-vTSuUqdIhB8riYhWxAbE+pN0NmXSIJPCq8BBZsQ2qy1BLdToDZMmwSEykyNC+2tlHpinSl2uFfHt5z46wv5V0g==","shasum":"78bd58345f52201f8ca2cd848ed9c49e94a578e3","tarball":"https://registry.npmjs.org/@auroraflow/code-darwin-arm64/-/code-darwin-arm64-0.0.6.tgz","fileCount":3,"unpackedSize":186968395,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIByGHcCVvcGbukW7ZiJMqvgaQwTHsOh+FDYBbRqudsRIAiBzGR9JrYZfCHP46e6FEHKwUcKf9eyVyiodTN/REwGQSw=="}]},"_npmUser":{"name":"auroraflow","email":"auroraflow_intl@outlook.com"},"directories":{},"maintainers":[{"name":"auroraflow","email":"auroraflow_intl@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/code-darwin-arm64_0.0.6_1780611294043_0.043233031710624203"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-02T21:33:41.803Z","modified":"2026-06-04T22:14:55.267Z","0.0.1":"2026-06-02T21:33:43.248Z","0.0.2":"2026-06-03T05:10:55.457Z","0.0.3":"2026-06-03T15:51:41.176Z","0.0.4":"2026-06-04T06:12:29.406Z","0.0.5":"2026-06-04T13:15:22.125Z","0.0.6":"2026-06-04T22:14:55.159Z"},"bugs":{"url":"https://github.com/auroraflowintl/code/issues"},"license":"Apache-2.0","homepage":"https://github.com/auroraflowintl/code#readme","repository":{"type":"git","url":"git+https://github.com/auroraflowintl/code.git","directory":"codex-cli"},"description":"Aurora 编程 Agent 是基于 OpenAI Codex CLI 二开的 Aurora 自有编程代理。它的目标是提供类似 Codex 的本地编程体验，但身份、模型目录、API Key 与运行时路由都接入 Aurora 体系。","maintainers":[{"name":"auroraflow","email":"auroraflow_intl@outlook.com"}],"readme":"# Aurora 编程 Agent\n\nAurora 编程 Agent 是基于 OpenAI Codex CLI 二开的 Aurora 自有编程代理。它的目标是提供类似 Codex 的本地编程体验，但身份、模型目录、API Key 与运行时路由都接入 Aurora 体系。\n\n这个仓库不是一次性改造项目，而是一个需要长期跟随上游 Codex 演进的下游 fork。实现时应尽量保留 Codex 的核心代码结构，把 Aurora 专属逻辑收敛到小而清晰的适配层，降低后续合并上游更新时的冲突成本。\n\n## 文档语言\n\n本项目的文档系统主要使用中文。\n\n- 面向产品、架构、运行规则、二开策略、发布流程的文档应优先使用中文。\n- 代码中的协议字段、第三方接口名、命令、错误码、包名和配置键保持其原始英文形式。\n- 引用上游 Codex、OpenAI API、Rust/Node 生态文档时，可以保留英文专有名词，必要时补充中文解释。\n- 面向国际化发布的用户文案可以单独维护英文版本，但中文文档是项目内部事实源。\n\n## 文档入口\n\nAurora 专属维护文档位于 [`aurora-docs/`](aurora-docs/README.md)。\n\n- [`aurora-docs/BOUNDARIES.md`](aurora-docs/BOUNDARIES.md) — 长期二开边界。\n- [`aurora-docs/DECISIONS.md`](aurora-docs/DECISIONS.md) — 架构与产品决策记录。\n- [`aurora-docs/CHANGES.md`](aurora-docs/CHANGES.md) — Aurora patch 变更记录。\n- [`aurora-docs/UPSTREAM.md`](aurora-docs/UPSTREAM.md) — 跟随上游 Codex 的合并流程。\n- [`aurora-docs/UPSTREAM_CLEANUP.md`](aurora-docs/UPSTREAM_CLEANUP.md) — 上游遗留文件与口径的清理矩阵。\n\n上游 Codex 原 README 已保存在 [`README.codex.md`](README.codex.md)。上游 `docs/` 目录尽量保持接近 upstream，避免承载 Aurora 专属产品文档。\n\n## 项目定位\n\nAurora 编程 Agent 面向希望使用 Aurora 基础设施完成本地编程工作的开发者：\n\n- 使用 Aurora 账号体系替换 Codex/OpenAI 登录授权。\n- 使用 Aurora 模型目录替换 Codex 原模型选择器。\n- 使用 Aurora API Key 选择器决定请求进入哪个运行时资源池。\n- 尽量继续继承 Codex 的核心 agent 能力、TUI 工作流、工具调用、MCP、沙箱和执行能力。\n\n## 首期范围\n\n第一阶段聚焦三个替换面。\n\n### 1. 身份体系\n\n替换 Codex 原有登录与鉴权存储，改为 Aurora 账号登录。CLI 应通过 Aurora control-plane endpoint 完成认证，并只保存后续 Aurora 请求所需的凭证。\n\n### 2. 模型选择\n\n替换 Codex 原来的扁平模型选择器，改为 Aurora 两级选择器：\n\n1. 先选择 provider 分类。\n2. 再选择该 provider 下的具体模型。\n3. 运行时请求发送 Aurora 后端要求的 alias / model id。\n\n### 3. Aurora Key 选择\n\n新增 Aurora API Key 选择器：\n\n1. 先选择 key 类型：`personal`、`platform`、`org`、`market`。\n2. 再选择或创建具体 key。\n3. 持久化已选 key 的必要元数据，供后续运行时请求使用。\n\n## 上游跟随策略\n\n本项目应持续跟随 [`openai/codex`](https://github.com/openai/codex)，把它作为核心 agent 能力的上游来源。\n\n推荐规则：\n\n- 尽量保留上游 Codex 的文件布局和 crate/module 名称，除非包分发确实需要改名。\n- 避免在核心代码里做大范围品牌替换。\n- Aurora 专属逻辑放到清晰命名的 adapter / integration 模块。\n- 保持 Aurora patch 小、集中、可 review，便于上游更新后重新合并。\n- 模型目录和 key 选择使用结构化字段，不把 Aurora 元数据塞进展示文本再解析。\n\n## 长期二开边界\n\n本项目的长期维护基线是：\n\n> Codex core + Aurora identity/model/key/runtime adapter + Aurora distribution。\n\n也就是说，本仓库不是“全仓改名版 Codex”，而是在尽量保留 Codex 核心结构的前提下，把 Aurora 必须拥有的产品接入面替换掉。\n\n### 必须二开的范围\n\n以下范围属于 Aurora 产品边界，应由本项目长期维护。\n\n1. 品牌与分发层\n\n   - CLI 命令名：`aurora`。\n   - npm / Python / 其他发布包名。\n   - 安装脚本、平台二进制包、release artifact 命名。\n   - 面向用户的 Aurora 产品文案。\n\n2. 登录与身份体系\n\n   - Aurora 账号登录。\n   - Aurora session / token 存储。\n   - Aurora API key reveal / create / select。\n   - 移除默认 Codex/OpenAI 登录入口；除非明确设定兼容期，不保留旧登录路径并行支持。\n\n3. Aurora Key 选择\n\n   - 先选择 key 类型：`personal`、`platform`、`org`、`market`。\n   - 再选择或创建具体 key。\n   - 持久化运行时请求所需的 key 元数据。\n   - 客户端只做交互所需判断，资源池和权限判定以 Aurora 后端为准。\n\n4. Aurora 模型目录与模型选择器\n\n   - 使用 Aurora 模型目录接口。\n   - 模型选择器采用 provider -> model 两级选择。\n   - 运行时请求发送 Aurora 后端要求的 alias / model id。\n   - 模型元数据必须是结构化字段，不通过解析展示文本获得业务字段。\n\n5. Aurora runtime 接入\n\n   - 运行时请求走 Aurora endpoint。\n   - 长期优先使用 `POST /v1/responses` 作为标准请求入口。\n   - 鉴权使用已选 Aurora key。\n   - Codex core 产生的请求语义应通过 Aurora adapter 转换，不在 core 里散落 Aurora 特例。\n\n### 尽量不动的范围\n\n以下范围主要承接上游 Codex 能力，应尽量保持接近 upstream，只有 Aurora 接入必须触及时才改。\n\n1. Agent 核心循环\n\n   - session / turn orchestration\n   - context 构建与压缩\n   - tool call 生命周期\n   - rollout / resume / history 机制\n\n2. 通用工具与执行能力\n\n   - shell / exec / sandbox\n   - apply_patch\n   - MCP server / MCP client\n   - skills / plugins\n   - file search / file watcher\n\n3. 通用协议模型\n\n   - Codex 内部 protocol 基础类型。\n   - OpenAI Responses / ChatGPT 相关结构在仍被上游 core 使用时不做无意义改名。\n   - 只在 Aurora 后端契约确实不同的时候新增 adapter 或结构化扩展。\n\n4. TUI 通用交互\n\n   - 聊天主界面。\n   - 底部输入框。\n   - 历史、diff、审批、工具展示。\n   - 只替换登录、模型选择、key 选择等 Aurora 产品面。\n\n5. 上游测试、CI 和构建基础设施\n\n   - 除发布包名、安装路径、artifact 命名外，不主动重写 CI 结构。\n   - 继续使用上游测试习惯和格式化规则。\n\n### 每次改动的边界判断\n\n每个 PR 或开发任务开始前，先判断改动属于哪一类：\n\n- 属于 Aurora 账号、模型、key、runtime endpoint、包分发：可以进入 Aurora patch。\n- 属于 agent 推理循环、通用工具、MCP、sandbox、TUI 通用能力：优先保持 upstream；必须修改时先收敛为小 adapter。\n- 属于纯品牌替换但会扩大 diff：默认不做。\n- 属于上游 bug 或通用能力改进：优先评估是否应该以 upstream-compatible 的方式实现，避免 Aurora 私有分叉扩大。\n\n长期目标是让 Aurora patch 面积稳定、可解释、可重放。每次合并上游 Codex 时，应优先解决这些明确边界内的冲突，避免把临时兼容逻辑扩散到 core。\n\n## Aurora 接入面\n\n预期依赖的 Aurora 后端接口：\n\n- `POST /api/v1/auth/login`\n- `GET /api/v1/aurora-cli/api-keys`\n- `POST /api/v1/aurora-cli/api-keys`\n- `POST /api/v1/aurora-cli/api-keys/{id}/reveal`\n- `GET /v1/aurora-cli/models`\n\n模型目录接口应返回结构化的 `provider`、`model_id`、`alias` 等字段，客户端不应通过解析展示文本获取业务字段。\n\n## 非目标\n\n- 不重写 Codex 核心 agent 行为。\n- Aurora auth 接入后，不保留旧 Codex/OpenAI 登录流程的兼容分支，除非明确需要兼容期。\n- 不为了品牌统一而全仓重命名内部符号，如果这会显著增加上游合并成本。\n- 不在客户端重复实现 Aurora 后端 domain 规则；客户端只保留交互所需的最小判断。\n\n## 当前状态\n\n当前仓库已经导入最新 Codex `main` 作为基线。下一步是在不扩大 core diff 的前提下，依次叠加 Aurora 命令入口、身份、模型选择和 key 选择适配层。\n","readmeFilename":"README.md"}