feihong-code 0.2.3 → 0.5.1

package/CODE_OF_CONDUCT.md

@@ -1,56 +1,56 @@
-# 行为准则
-
-## 我们的承诺
-
-为了营造一个开放和友好的环境，我们作为贡献者和维护者承诺：
-
-- 不受性别、种族、民族、性取向、性别认同、残疾、外貌、体型、年龄、宗教或国籍的影响
-- 以尊重和包容的态度对待每一位参与者
-- 致力于创造一个无骚扰的环境
-
-## 我们的标准
-
-**促进积极互动的行为：**
-- 使用友好和包容的语言
-- 尊重不同的观点和经历
-- 虚心接受建设性反馈
-- 关注社区的整体利益
-- 对同类表现出同理心
-
-**不可接受的行为：**
-- 使用性化的语言或图像，以及任何形式的性关注或挑逗
-- 恶意的评论、侮辱性的贬低攻击或个人/政治攻击
-- 公开或私下的骚扰
-- 未经明确许可发布他人的私人信息，如物理或电子邮件地址
-- 其他在专业场所被认为不恰当的行为
-
-## 执行责任
-
-社区领导者负责澄清和执行我们接受的行为标准，并将根据以下原则采取适当和公平的纠正措施：
-
-1. 以建设性的方式提供纠正性反馈
-2. 移除、编辑或不接受违反本行为准则的评论、提交、代码、问题和其他贡献
-3. 暂时或永久禁止任何被视为不合适、威胁、冒犯或有害的行为
-
-## 范围
-
-本行为准则适用于：
-- 项目空间和公共空间，当个人正式代表项目或其社区时
-- 代表项目的官方电子邮件、社交媒体账户或在线活动中
-
-## 报告
-
-如目睹或遭受不法行为，请通过以下方式联系项目负责人：
-
-- **GitHub Issues**: https://github.com/wch887292/feihong-code/issues
-- **邮件**: wch887292@gmail.com
-
-所有投诉将被认真、及时地审查和调查。
-
-##  attribution
-
-本行为准则改编自 [Contributor Covenant](https://www.contributor-covenant.org)，版本 2.1。
-
----
-
-**晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹**
+# 行为准则
+
+## 我们的承诺
+
+为了营造一个开放和友好的环境，我们作为贡献者和维护者承诺：
+
+- 不受性别、种族、民族、性取向、性别认同、残疾、外貌、体型、年龄、宗教或国籍的影响
+- 以尊重和包容的态度对待每一位参与者
+- 致力于创造一个无骚扰的环境
+
+## 我们的标准
+
+**促进积极互动的行为：**
+- 使用友好和包容的语言
+- 尊重不同的观点和经历
+- 虚心接受建设性反馈
+- 关注社区的整体利益
+- 对同类表现出同理心
+
+**不可接受的行为：**
+- 使用性化的语言或图像，以及任何形式的性关注或挑逗
+- 恶意的评论、侮辱性的贬低攻击或个人/政治攻击
+- 公开或私下的骚扰
+- 未经明确许可发布他人的私人信息，如物理或电子邮件地址
+- 其他在专业场所被认为不恰当的行为
+
+## 执行责任
+
+社区领导者负责澄清和执行我们接受的行为标准，并将根据以下原则采取适当和公平的纠正措施：
+
+1. 以建设性的方式提供纠正性反馈
+2. 移除、编辑或不接受违反本行为准则的评论、提交、代码、问题和其他贡献
+3. 暂时或永久禁止任何被视为不合适、威胁、冒犯或有害的行为
+
+## 范围
+
+本行为准则适用于：
+- 项目空间和公共空间，当个人正式代表项目或其社区时
+- 代表项目的官方电子邮件、社交媒体账户或在线活动中
+
+## 报告
+
+如目睹或遭受不法行为，请通过以下方式联系项目负责人：
+
+- **GitHub Issues**: https://github.com/wch887292/feihong-code/issues
+- **邮件**: wch887292@gmail.com
+
+所有投诉将被认真、及时地审查和调查。
+
+##  attribution
+
+本行为准则改编自 [Contributor Covenant](https://www.contributor-covenant.org)，版本 2.1。
+
+---
+
+**晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹**

package/CONTRIBUTING.md

@@ -1,68 +1,68 @@
-# 贡献指南（CONTRIBUTING）
-
-感谢关注 **飞虹 Code（Muse Code 参照复刻）**。本文件约定开发协作规范，请提交前阅读。
-
-## 一、项目署名（强制）
-
-所有开发产出（源码注释头部、README、LICENSE、文档、页脚、about）必须标注：
-
-- 公司：**晋江市飞虹智科技企业管理有限公司**
-- 中心：**飞扬企源研发中心**
-- 负责人：**吴赐虹**
-
-源码文件头部统一使用：
-
-```ts
-/**
- * 飞虹 Code (Muse Code 参照复刻)
- * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
- */
-```
-
-## 二、架构约定（feature-first 分层）
-
-```
-src/
-  cli/        入口、参数解析、REPL、运行时装配
-  shared/     配置、错误、日志、共享类型（基础设施）
-  agent/      Orchestrator / Planner / Prompts
-  tools/      工具实现（file / shell / search / verify）+ registry
-  models/     模型路由 + providers（openai-compatible / ollama / mock）
-  runtime/    事件日志、会话状态（单一可信源）
-  skills/     高级技能（/plan /grill /goal）
-```
-
-铁律：
-
-1. **边界必须校验**：所有外部输入（CLI 参数、模型响应、工具入参）用 zod 校验。
-2. **集中配置**：配置只在 `shared/config.ts` 读取，启动即校验（fail-fast），懒加载不影响 `--version`。
-3. **类型化错误**：抛出 `AppError` 子类（`ConfigError`/`ModelError`/`ToolError`/`ApprovalRequiredError`/`SecurityError`），禁止裸 `throw`。
-4. **结构化日志**：通过 `shared/logger` 输出 JSON 日志，密钥自动脱敏；每次运行带 `runId`。
-5. **单一可信源**：Agent 行为以 `runtime/event-log` 的 append-only JSONL 为准，支持审计与恢复。
-
-## 三、安全底线
-
-- 文件工具限制在项目根沙箱内（防 `../` 穿越）。
-- shell 工具走白名单 + 危险命令拦截 + 审批（`ApprovalRequiredError`）。
-- 日志/响应中任何密钥字段自动转 `[REDACTED]`。
-- 禁止在代码、日志、提交信息中泄露真实凭证。
-
-## 四、提交规范
-
-- 提交信息用中文，句式「动词 + 内容」，如：`feat: 新增 ollama provider`、`fix: 修复 zod v4 record 校验`。
-- 不提交 `node_modules/`、`dist/`、`.env`、日志与本地 demo 产物（见 `.gitignore`）。
-- 大改动先建分支，描述清楚动机与验证方式。
-
-## 五、本地开发
-
-```bash
-npm install
-npm run build      # tsc 编译到 dist/
-npm run dev        # tsx 直接跑源码
-node dist/cli/index.js --version
-node dist/cli/index.js "<需求>"   # 未配 FH_PROVIDERS 自动离线 Mock 闭环
-```
-
----
-
-© 2026 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+# 贡献指南（CONTRIBUTING）
+
+感谢关注 **飞虹 Code（Muse Code 参照复刻）**。本文件约定开发协作规范，请提交前阅读。
+
+## 一、项目署名（强制）
+
+所有开发产出（源码注释头部、README、LICENSE、文档、页脚、about）必须标注：
+
+- 公司：**晋江市飞虹智科技企业管理有限公司**
+- 中心：**飞扬企源研发中心**
+- 负责人：**吴赐虹**
+
+源码文件头部统一使用：
+
+```ts
+/**
+ * 飞虹 Code (Muse Code 参照复刻)
+ * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+ */
+```
+
+## 二、架构约定（feature-first 分层）
+
+```
+src/
+  cli/        入口、参数解析、REPL、运行时装配
+  shared/     配置、错误、日志、共享类型（基础设施）
+  agent/      Orchestrator / Planner / Prompts
+  tools/      工具实现（file / shell / search / verify）+ registry
+  models/     模型路由 + providers（openai-compatible / ollama / mock）
+  runtime/    事件日志、会话状态（单一可信源）
+  skills/     高级技能（/plan /grill /goal）
+```
+
+铁律：
+
+1. **边界必须校验**：所有外部输入（CLI 参数、模型响应、工具入参）用 zod 校验。
+2. **集中配置**：配置只在 `shared/config.ts` 读取，启动即校验（fail-fast），懒加载不影响 `--version`。
+3. **类型化错误**：抛出 `AppError` 子类（`ConfigError`/`ModelError`/`ToolError`/`ApprovalRequiredError`/`SecurityError`），禁止裸 `throw`。
+4. **结构化日志**：通过 `shared/logger` 输出 JSON 日志，密钥自动脱敏；每次运行带 `runId`。
+5. **单一可信源**：Agent 行为以 `runtime/event-log` 的 append-only JSONL 为准，支持审计与恢复。
+
+## 三、安全底线
+
+- 文件工具限制在项目根沙箱内（防 `../` 穿越）。
+- shell 工具走白名单 + 危险命令拦截 + 审批（`ApprovalRequiredError`）。
+- 日志/响应中任何密钥字段自动转 `[REDACTED]`。
+- 禁止在代码、日志、提交信息中泄露真实凭证。
+
+## 四、提交规范
+
+- 提交信息用中文，句式「动词 + 内容」，如：`feat: 新增 ollama provider`、`fix: 修复 zod v4 record 校验`。
+- 不提交 `node_modules/`、`dist/`、`.env`、日志与本地 demo 产物（见 `.gitignore`）。
+- 大改动先建分支，描述清楚动机与验证方式。
+
+## 五、本地开发
+
+```bash
+npm install
+npm run build      # tsc 编译到 dist/
+npm run dev        # tsx 直接跑源码
+node dist/cli/index.js --version
+node dist/cli/index.js "<需求>"   # 未配 FH_PROVIDERS 自动离线 Mock 闭环
+```
+
+---
+
+© 2026 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹

package/LICENSE

@@ -1,22 +1,22 @@
-MIT License
-
-Copyright (c) 2026 晋江市飞虹智科技企业管理有限公司
-飞扬企源研发中心 · 负责人：吴赐虹
-
-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.
+MIT License
+
+Copyright (c) 2026 晋江市飞虹智科技企业管理有限公司
+飞扬企源研发中心 · 负责人：吴赐虹
+
+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.