feihong-code 0.2.3 → 0.6.0

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.