sinapse-ai 5.0.8 → 6.0.0

package/docs/zh/architecture/module-system.md

@@ -1,382 +0,0 @@
-<!-- 翻译: ZH-CN | 原文: /docs/en/architecture/module-system.md | 同步时间: 2026-01-26 -->
-
-# SINAPSE 模块系统架构
-
-> 🌐 [EN](../../architecture/module-system.md) | [PT](../../pt/architecture/module-system.md) | [ES](../../es/architecture/module-system.md) | **ZH-CN**
-
----
-
-> SINAPSE v4.2 模块化架构完整指南。
-
-**版本:** 2.1.0
-**上次更新:** 2025-12-01
-
----
-
-## 概览
-
-### 为什么要模块化架构？
-
-v4.2 模块化架构解决了 v2.0 扁平结构的几个挑战：
-
-| 挑战 | v2.0 问题 | v4.2 解决方案 |
-| --- | --- | --- |
-| **发现** | 200+ 文件混乱在目录中 | 按责任组织 |
-| **维护** | 所有权不清楚 | 模块边界定义所有权 |
-| **依赖** | 隐含的、循环的 | 显式的、单向的 |
-| **可扩展性** | 总是加载所有文件 | 按模块延迟加载 |
-| **测试** | 仅完整系统测试 | 模块级隔离 |
-
-### 设计原则
-
-1. **单一职责** - 每个模块有明确的目的
-2. **显式依赖** - 模块声明所需内容
-3. **松耦合** - 一个模块的变化不会传播
-4. **高内聚** - 相关功能保持在一起
-5. **延迟加载** - 仅加载必要内容
-
----
-
-## 模块结构
-
-SINAPSE 将 `.sinapse-ai/` 目录组织为四个主要模块：
-
-```
-.sinapse-ai/
-├── core/              # 框架基础
-├── development/       # 开发制品
-├── product/           # 用户导向模板
-└── infrastructure/    # 系统配置
-```
-
-### 模块图
-
-```mermaid
-graph TB
-    subgraph "SINAPSE v4 框架"
-        CLI[CLI / 工具]
-
-        subgraph "产品模块"
-            Templates[模板]
-            Checklists[检查表]
-            Data[PM 数据]
-        end
-
-        subgraph "开发模块"
-            Agents[代理]
-            Tasks[任务]
-            Workflows[工作流]
-            Scripts[开发脚本]
-        end
-
-        subgraph "核心模块"
-            Registry[服务注册表]
-            Config[配置系统]
-            Elicit[询问]
-            Session[会话管理]
-            QG[质量门槛]
-            MCP[MCP 系统]
-        end
-
-        subgraph "基础设施模块"
-            InfraScripts[基础设施脚本]
-            Tools[工具配置]
-            PM[PM 适配器]
-        end
-    end
-
-    CLI --> Agents
-    CLI --> Registry
-    Agents --> Tasks
-    Agents --> Templates
-    Tasks --> Workflows
-    Development --> Core
-    Product --> Core
-    Infrastructure --> Core
-
-    style Core fill:#e1f5fe
-    style Development fill:#e8f5e9
-    style Product fill:#fff3e0
-    style Infrastructure fill:#f3e5f5
-```
-
----
-
-## 核心模块
-
-**路径:** `.sinapse-ai/core/`
-**目的:** 框架基础 - 配置、会话、询问和本质运行时组件。
-
-### 内容
-
-| 目录 | 内容 | 描述 |
-| --- | --- | --- |
-| `config/` | `config-cache.js`、`config-loader.js` | 带 TTL 缓存的配置管理 |
-| `data/` | `sinapse-kb.md`、`workflow-patterns.yaml` | 框架知识库 |
-| `docs/` | 内部文档 | 组件指南、故障排除 |
-| `elicitation/` | `elicitation-engine.js`、`session-manager.js` | 交互式提示系统 |
-| `session/` | `context-detector.js`、`context-loader.js` | 会话上下文管理 |
-| `utils/` | `output-formatter.js`、`yaml-validator.js` | 常用实用程序 |
-| `registry/` | `service-registry.json`、`registry-loader.js` | 服务发现系统 |
-| `quality-gates/` | `quality-gate-manager.js`、层配置 | 3 层质量门槛系统 |
-| `mcp/` | `global-config-manager.js`、`os-detector.js` | 全局 MCP 配置 |
-| `manifest/` | `manifest-generator.js`、`manifest-validator.js` | 项目清单系统 |
-| `migration/` | `migration-config.yaml`、`module-mapping.yaml` | 迁移配置 |
-
-### 主要 API
-
-```javascript
-// 配置
-const { loadAgentConfig, globalConfigCache } = require('./.sinapse-ai/core');
-
-// 会话
-const { ContextDetector, SessionContextLoader } = require('./.sinapse-ai/core');
-
-// 询问
-const { ElicitationEngine, ElicitationSessionManager } = require('./.sinapse-ai/core');
-
-// 注册表
-const { getRegistry, loadRegistry } = require('./.sinapse-ai/core/registry/registry-loader');
-
-// 质量门槛
-const QualityGateManager = require('./.sinapse-ai/core/quality-gates/quality-gate-manager');
-```
-
-### 依赖项
-
-- **外部:** `js-yaml`、`fs-extra`
-- **内部:** 无（基础模块）
-
----
-
-## 开发模块
-
-**路径:** `.sinapse-ai/development/`
-**目的:** 代理相关资产 - 代理定义、任务、工作流和开发脚本。
-
-### 内容
-
-| 目录 | 内容 | 描述 |
-| --- | --- | --- |
-| `agents/` | 11 个代理定义 | `dev.md`、`qa.md`、`architect.md` 等 |
-| `agent-teams/` | 5 个团队配置 | 预定义代理组 |
-| `tasks/` | 115+ 任务定义 | 可执行任务工作流 |
-| `workflows/` | 7 个工作流定义 | 多步开发工作流 |
-| `scripts/` | 24 个脚本 | 代理支持实用程序 |
-
-### 代理
-
-| 代理 | ID | 责任 |
-| --- | --- | --- |
-| SINAPSE 主代理 | `sinapse-master` | 框架编排 |
-| 开发者 | `dev` | 代码实现 |
-| QA | `qa` | 质量保证 |
-| 架构师 | `architect` | 技术架构 |
-| 产品经理 | `po` | 产品待办 |
-| 产品经理 | `pm` | 产品策略 |
-| Scrum 主管 | `sm` | 过程协调 |
-| 分析师 | `analyst` | 业务分析 |
-| 数据工程师 | `data-engineer` | 数据工程 |
-| DevOps | `devops` | CI/CD 和操作 |
-| UX 专家 | `ux-design-expert` | 用户体验 |
-
-### 代理团队
-
-| 团队 | 代理 | 用例 |
-| --- | --- | --- |
-| `team-all` | 全部 11 个代理 | 完整开发团队 |
-| `team-fullstack` | dev、qa、architect、devops | 全栈项目 |
-| `team-ide-minimal` | dev、qa | 最小 IDE 设置 |
-| `team-no-ui` | dev、architect、devops、data-engineer | 后端/API 项目 |
-| `team-qa-focused` | qa、dev、architect | 质量关注工作 |
-
-### 依赖项
-
-- **内部:** `core/`（配置、会话、询问）
-
----
-
-## 产品模块
-
-**路径:** `.sinapse-ai/product/`
-**目的:** PM/PO 资产 - 模板、检查表和文档生成参考数据。
-
-### 内容
-
-| 目录 | 内容 | 描述 |
-| --- | --- | --- |
-| `templates/` | 52+ 模板 | PRD、故事、架构、IDE 规则 |
-| `checklists/` | 11 个检查表 | 质量验证检查表 |
-| `data/` | 6 个数据文件 | PM 知识库和参考 |
-
-### 主要模板
-
-| 模板 | 目的 |
-| --- | --- |
-| `story-tmpl.yaml` | v2.0 故事模板 |
-| `prd-tmpl.yaml` | 产品需求文档 |
-| `architecture-tmpl.yaml` | 架构文档 |
-| `qa-gate-tmpl.yaml` | 质量门槛模板 |
-| `ide-rules/` | 9 个 IDE 特定规则文件 |
-
-### 检查表
-
-- `architect-checklist.md` - 架构审查
-- `pm-checklist.md` - PM 验证
-- `po-master-checklist.md` - 主 PO 验证
-- `story-dod-checklist.md` - 故事完成定义
-- `pre-push-checklist.md` - 推送前验证
-- `release-checklist.md` - 发布验证
-
-### 依赖项
-
-- **内部:** `core/`（模板引擎、验证器）
-- **外部:** 无（静态资产）
-
----
-
-## 基础设施模块
-
-**路径:** `.sinapse-ai/infrastructure/`
-**目的:** 系统配置 - 脚本、工具和外部集成。
-
-### 内容
-
-| 目录 | 内容 | 描述 |
-| --- | --- | --- |
-| `scripts/` | 55+ 脚本 | 基础设施实用程序 |
-| `tools/` | 工具配置 | CLI、MCP、本地工具配置 |
-| `integrations/` | PM 适配器 | ClickUp、Jira、GitHub 适配器 |
-| `tests/` | 模块测试 | 基础设施验证 |
-
-### 主要脚本
-
-| 脚本 | 目的 |
-| --- | --- |
-| `git-wrapper.js` | Git 操作包装器 |
-| `backup-manager.js` | 备份/恢复系统 |
-| `template-engine.js` | 模板处理 |
-| `security-checker.js` | 安全验证 |
-| `performance-analyzer.js` | 性能分析 |
-
-### 工具配置
-
-```
-tools/
-├── cli/           # CLI 工具配置 (gh, railway, supabase)
-├── mcp/           # MCP 服务器配置
-└── local/         # 本地工具配置
-```
-
-### 依赖项
-
-- **内部:** `core/`（配置、实用程序）
-- **外部:** 多个工具 API
-
----
-
-## 模块边界
-
-### 依赖规则
-
-```mermaid
-graph LR
-    CLI[CLI/工具] --> D[开发]
-    CLI --> P[产品]
-    CLI --> I[基础设施]
-
-    D --> C[核心]
-    P --> C
-    I --> C
-
-    style C fill:#e1f5fe
-    style D fill:#e8f5e9
-    style P fill:#fff3e0
-    style I fill:#f3e5f5
-```
-
-**规则:**
-
-1. `core/` 没有内部依赖项
-2. `development/`、`product/`、`infrastructure/` 仅依赖于 `core/`
-3. 禁止循环依赖
-4. CLI/工具可以访问任何模块
-
-### 模块间通信
-
-模块通过以下方式通信：
-
-1. **服务注册表** - 发现可用的工作者和服务
-2. **配置系统** - 共享设置和首选项
-3. **事件系统** - 发布/订阅实现松耦合
-4. **文件系统** - 共享数据目录
-
-### 模块边界检查表
-
-添加新功能时：
-
-- [ ] 属于现有模块？
-- [ ] 引入新依赖项？
-- [ ] 维持单向依赖流？
-- [ ] 与模块目的相聚合？
-- [ ] 可以独立测试？
-
----
-
-## 文件组织
-
-### 命名约定
-
-| 类型 | 约定 | 示例 |
-| --- | --- | --- |
-| 脚本 | `kebab-case.js` | `config-loader.js` |
-| 代理 | `agent-id.md` | `dev.md`、`qa.md` |
-| 任务 | `agent-prefix-task-name.md` | `dev-develop-story.md` |
-| 模板 | `name-tmpl.yaml` | `story-tmpl.yaml` |
-| 检查表 | `name-checklist.md` | `pre-push-checklist.md` |
-
-### 添加新文件
-
-| 文件类型 | 位置 | 模块 |
-| --- | --- | --- |
-| 代理定义 | `development/agents/` | 开发 |
-| 任务定义 | `development/tasks/` | 开发 |
-| 工作流 | `development/workflows/` | 开发 |
-| 模板 | `product/templates/` | 产品 |
-| 检查表 | `product/checklists/` | 产品 |
-| 实用脚本 | `infrastructure/scripts/` | 基础设施 |
-| 配置加载器 | `core/config/` | 核心 |
-| 注册表 | `core/registry/` | 核心 |
-
----
-
-## 从 v2.0 迁移
-
-对于从扁平 v2.0 结构升级的项目：
-
-```bash
-# 预演显示变化
-sinapse migrate --dry-run
-
-# 执行迁移
-sinapse migrate --from=2.0 --to=2.1
-
-# 验证迁移
-sinapse migrate --validate
-```
-
-详见 [迁移指南](../../migration/migration-guide.md) 了解详细说明。
-
----
-
-## 相关文档
-
-- [服务发现指南](../guides/service-discovery.md)
-- [质量门槛指南](../guides/quality-gates.md)
-- [全局 MCP 设置指南](../guides/mcp-global-setup.md)
-- [迁移指南](../../migration/migration-guide.md)
-- [ADR-002: 迁移地图](../../architecture/adr/ADR-002-migration-map.md)
-
----
-
-_SINAPSE v4 模块系统架构_

package/docs/zh/architecture/multi-repo-strategy.md

@@ -1,237 +0,0 @@
-# 多仓库策略
-
-> **ZH** | [EN](../architecture/multi-repo-strategy.md) | [PT](../pt/architecture/multi-repo-strategy.md)
-
----
-
-**版本:** 2.1.0
-**最后更新:** 2026-01-28
-**状态:** 官方架构文档
-
----
-
-## 目录
-
-- [概览](#概览)
-- [仓库结构](#仓库结构)
-- [主要仓库 (sinapse-ai)](#主要仓库-sinapse-ai)
-- [Squad 仓库](#squad-仓库)
-- [MCP 生态系统仓库](#mcp-生态系统仓库)
-- [私有仓库](#私有仓库)
-- [同步机制](#同步机制)
-- [包分发](#包分发)
-- [最佳实践](#最佳实践)
-
----
-
-## 概览
-
-SINAPSE v4 采用**多仓库策略**以实现模块化开发、社区贡献和核心框架、扩展(squads)和专有组件之间的清晰分离。
-
-### 设计目标
-
-| 目标                | 描述                                  |
-| ------------------- | ------------------------------------- |
-| **模块化**          | Squad 可独立开发和版本化               |
-| **社区**            | 开源 Squad 鼓励社区贡献               |
-| **IP 保护**         | 专有组件保留在私有仓库中               |
-| **可扩展性**        | 团队可在单独仓库中工作而无冲突        |
-| **许可灵活性**      | 不同组件可有不同许可证                |
-
----
-
-## 仓库结构
-
-```
-SinapseAI 组织
-├── 公共仓库
-│   ├── sinapse-ai          # 主框架 (MIT)
-│   ├── sinapse-squads        # 社区 Squad (MIT)
-│   └── mcp-ecosystem      # MCP 配置 (Apache 2.0)
-│
-└── 私有仓库
-    ├── mmos               # 专有 MMOS (NDA)
-    └── certified-partners # 合作伙伴资源(专有)
-```
-
----
-
-## 主要仓库 (sinapse-ai)
-
-### 目的
-
-主仓库包含所有项目依赖的基础 SINAPSE 框架。
-
-### 内容
-
-| 目录                       | 描述                                    |
-| -------------------------- | --------------------------------------- |
-| `.sinapse-ai/core/`         | 框架基础(配置、注册表、质量门)          |
-| `.sinapse-ai/development/`  | 代理、任务、工作流定义                  |
-| `.sinapse-ai/product/`      | 模板、检查表、PM 数据                   |
-| `.sinapse-ai/infrastructure/` | 脚本、工具、集成                      |
-| `docs/`                    | 框架文档                                |
-
-### 许可证
-
-**MIT** - 宽松许可证用于核心的使用、修改和分发。
-
-### npm 包
-
-```bash
-npm install @sinapse/core
-```
-
----
-
-## Squad 仓库
-
-### 概览
-
-Squad 是模块化扩展,为 SINAPSE 添加专门功能。
-
-### sinapse-squads 仓库
-
-```
-sinapse-squads/
-├── etl/                    # ETL 处理 Squad
-├── creator/                # 内容创建 Squad
-├── mmos/                   # MMOS 集成 Squad
-└── templates/              # Squad 创建模板
-```
-
-### 许可证
-
-**MIT** - 社区贡献的完全开源自由。
-
-### npm 包
-
-```bash
-npm install @sinapse/squad-etl
-npm install @sinapse/squad-creator
-npm install @sinapse/squad-mmos
-```
-
----
-
-## MCP 生态系统仓库
-
-### 目的
-
-各种 IDE 和环境的集中 MCP(模型上下文协议)配置。
-
-### 许可证
-
-**Apache 2.0** - 最大采用的宽松许可证。
-
-### npm 包
-
-```bash
-npm install @sinapse/mcp-presets
-```
-
----
-
-## 私有仓库
-
-### SinapseAI/mmos(专有+NDA)
-
-包含专有 MMOS(心智操作系统)组件:
-
-- MMOS Minds 定义
-- 心智 DNA 算法
-- 专有训练数据
-- 合作伙伴特定定制
-
-**访问:** 需要 NDA 和许可协议。
-
-### SinapseAI/certified-partners(专有)
-
-SINAPSE 认证合作伙伴的资源:
-
-- 高级 Squad 实现
-- 合作伙伴门户访问
-- 企业支持工具
-- 白标配置
-
-**访问:** 需要认证合作伙伴状态。
-
----
-
-## 同步机制
-
-### 仓库间的依赖
-
-```
-sinapse-squads → 依赖于 → sinapse-ai
-```
-
-### 版本兼容性
-
-| sinapse-ai | sinapse-squads | mcp-ecosystem |
-| --------- | ----------- | ------------- |
-| ^2.1.0    | ^1.0.0      | ^1.0.0        |
-| ^3.0.0    | ^2.0.0      | ^1.x.x        |
-
-### npm 依赖(推荐)
-
-```json
-{
-  "dependencies": {
-    "@sinapse/core": "^2.1.0",
-    "@sinapse/squad-etl": "^1.0.0",
-    "@sinapse/mcp-presets": "^1.0.0"
-  }
-}
-```
-
----
-
-## 包分发
-
-### npm 包范围
-
-| 包                   | 注册表 | 许可证     | 仓库        |
-| -------------------- | ------ | ---------- | ----------- |
-| `@sinapse/core`         | npm    | MIT        | sinapse-ai   |
-| `@sinapse/squad-etl`    | npm    | MIT        | sinapse-squads |
-| `@sinapse/squad-creator`| npm    | MIT        | sinapse-squads |
-| `@sinapse/squad-mmos`   | npm    | MIT        | sinapse-squads |
-| `@sinapse/mcp-presets`  | npm    | Apache 2.0 | mcp-ecosystem |
-
----
-
-## 最佳实践
-
-### 对于核心贡献者
-
-1. **原子变更** - 保持 PR 专注于单个功能或修复
-2. **向后兼容性** - 避免次要版本中的破坏性变更
-3. **文档** - 在同一 PR 中更新代码的文档
-4. **跨仓库测试** - 针对依赖仓库测试变更
-
-### 对于 Squad 开发者
-
-1. **清单优先** - 在实现前定义 squad.yaml
-2. **对等依赖** - 指定精确的 sinapse-ai 版本要求
-3. **独立测试** - Squad 应有自己的测试套件
-4. **README 标准** - 包含使用示例和要求
-
-### 对于项目消费者
-
-1. **锁定版本** - 在生产中使用精确版本
-2. **测试更新** - 更新依赖后运行完整测试套件
-3. **监控发布** - 订阅发布通知
-4. **报告问题** - 在正确的仓库中注册问题
-
----
-
-## 相关文档
-
-- [高级架构](./high-level-architecture.md)
-- [模块系统](./module-system.md)
-- [Squad 指南](../guides/squads-guide.md)
-
----
-
-_最后更新: 2026-01-28 | SINAPSE 框架团队_