@carboncode/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reasonix Contributors
+
+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/LICENSES/DeepSeek-Reasonix-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reasonix Contributors
+
+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/README.md

@@ -0,0 +1,109 @@
+# Carbon Code
+
+Chinese-first, DeepSeek-powered terminal coding agent derived from
+DeepSeek-Reasonix.
+
+Carbon Code is aimed at personal developer workflows: open a repository, let the
+agent read and search the codebase, review planned edits, approve shell commands,
+run validation, and keep a concise session trail.
+
+## Install
+
+Requires Node.js 22 or newer.
+
+```bash
+npm install -g @carboncode/cli
+cd path/to/project
+carboncode
+```
+
+Short command:
+
+```bash
+ccode
+```
+
+One-off usage without a global install:
+
+```bash
+npx @carboncode/cli
+```
+
+## Commands
+
+| Command | Purpose |
+| --- | --- |
+| `carboncode` / `carboncode code [dir]` | Coding agent rooted at the current project. |
+| `carboncode chat` | Chat without filesystem or shell tools. |
+| `carboncode run "task"` | Non-interactive one-shot task. |
+| `carboncode doctor` | Local health check. |
+| `carboncode update` | Check and install the latest CLI package. |
+
+Carbon Code also installs `ccode`. It intentionally does not install `cc`,
+because that name commonly points to the system C compiler.
+
+## Configuration
+
+Carbon Code stores user configuration in:
+
+```text
+~/.carboncode/config.json
+```
+
+Set a DeepSeek API key with the first-run setup wizard, or export it directly:
+
+```bash
+export DEEPSEEK_API_KEY=sk-...
+```
+
+Project rules should live in `AGENTS.md` or `CARBON.md` in the repository.
+
+Model presets use the current DeepSeek V4 API IDs: `flash` maps to
+`deepseek-v4-flash`, `pro` maps to `deepseek-v4-pro`, and `auto` starts on Flash
+with one-turn Pro escalation for harder turns.
+
+## Release
+
+The first npm publish is a one-time bootstrap because npm trusted publishing can
+only be configured after the package exists:
+
+```bash
+npm whoami
+npm publish --dry-run --access public
+npm publish --access public
+npm install -g npm@^11.10.0
+npm trust github @carboncode/cli --repo Yapie0/carboncode --file publish.yml --env npm
+```
+
+After trusted publishing is configured, releases are tag-driven through GitHub
+Actions. Update `package.json`, commit the release, then push a matching semver
+tag:
+
+```bash
+git tag v0.1.0
+git push origin main --tags
+```
+
+The `Publish npm package` workflow verifies the package, checks that the tag
+matches `package.json`, and runs `npm publish --access public --provenance`. If
+the exact version already exists with the same `gitHead`, the workflow treats the
+tag as an idempotent release marker and skips the publish step.
+
+## Current Scope
+
+This repository currently imports the Reasonix main codebase and productizes it
+as Carbon Code. The first productization pass covers package identity, command
+names, Carbon config paths, update/install commands, Chinese-first CLI copy, npm
+publishing, and license attribution.
+
+## License And Attribution
+
+Carbon Code is MIT licensed. It is derived from DeepSeek-Reasonix, which is also
+MIT licensed.
+
+The upstream notice is preserved in:
+
+- `THIRD_PARTY_NOTICES.md`
+- `LICENSES/DeepSeek-Reasonix-MIT.txt`
+
+Do not remove upstream copyright or MIT notices from derived files.

package/README.zh-CN.md

@@ -0,0 +1,91 @@
+# Carbon Code
+
+中文优先、DeepSeek 驱动的终端代码智能体，基于 DeepSeek-Reasonix 主体进行
+Carbon Code 产品化。
+
+Carbon Code 面向个人开发者工作流：进入一个仓库，让智能体读取和搜索代码、规划
+修改、展示 diff、在执行 shell 命令前请求确认、按需运行验证，并输出简洁结果。
+
+## 安装
+
+要求 Node.js 22 或更新版本。
+
+```bash
+npm install -g @carboncode/cli
+cd path/to/project
+carboncode
+```
+
+短命令：
+
+```bash
+ccode
+```
+
+不全局安装也可以临时运行：
+
+```bash
+npx @carboncode/cli
+```
+
+## 常用命令
+
+| 命令 | 用途 |
+| --- | --- |
+| `carboncode` / `carboncode code [dir]` | 以当前项目为根目录的编码智能体。 |
+| `carboncode chat` | 不带文件系统和 shell 工具的纯聊天。 |
+| `carboncode run "task"` | 非交互式执行一次任务。 |
+| `carboncode doctor` | 本地环境健康检查。 |
+| `carboncode update` | 检查并安装最新 CLI 包。 |
+
+Carbon Code 也安装 `ccode`。默认不会安装 `cc`，因为这个名字通常是系统 C 编译器。
+
+## 配置
+
+用户配置文件位置：
+
+```text
+~/.carboncode/config.json
+```
+
+可以通过首次运行向导配置 DeepSeek API Key，也可以直接导出环境变量：
+
+```bash
+export DEEPSEEK_API_KEY=sk-...
+```
+
+项目规则建议写在仓库里的 `AGENTS.md` 或 `CARBON.md`。
+
+模型预设使用当前 DeepSeek V4 API ID：`flash` 对应 `deepseek-v4-flash`，
+`pro` 对应 `deepseek-v4-pro`，`auto` 默认从 Flash 开始，并在困难回合一次性升级
+到 Pro。
+
+## 发布
+
+npm 发布由 GitHub Actions 的 tag 流程触发。先更新 `package.json`，提交发布版本，
+再推送匹配的 semver tag：
+
+```bash
+git tag v0.1.0
+git push origin main --tags
+```
+
+`Publish npm package` workflow 会先验证包、检查 tag 是否与 `package.json` 版本一致，
+然后执行 `npm publish --access public --provenance`。
+
+## 当前范围
+
+当前策略是“导入 Reasonix 主体，然后做 Carbon Code 产品化”。第一轮产品化覆盖
+包名、命令名、Carbon 配置目录、更新/安装命令、中文优先 CLI 文案、npm 发布流程
+和开源许可归因。
+
+## 许可与归因
+
+Carbon Code 使用 MIT 许可证。项目基于 MIT 许可的 DeepSeek-Reasonix 派生。
+
+上游声明保留在：
+
+- `THIRD_PARTY_NOTICES.md`
+- `LICENSES/DeepSeek-Reasonix-MIT.txt`
+
+不要移除派生源码中的上游 copyright 或 MIT notice。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,14 @@
+# Third Party Notices
+
+Carbon Code imports the DeepSeek-Reasonix repository body and productizes it as
+Carbon Code. The CLI/TUI, agent loop, tooling, session, memory, MCP, transcript,
+dashboard, repair, and validation subsystems are derived from DeepSeek-Reasonix.
+
+## DeepSeek-Reasonix
+
+- Upstream: https://github.com/esengine/DeepSeek-Reasonix
+- License: MIT
+- Notice file: `LICENSES/DeepSeek-Reasonix-MIT.txt`
+
+The upstream MIT license text is preserved in this repository and is included in
+the npm package through the `files` list in `package.json`.