npm - sinapse-ai - Versions diffs - 5.0.7 → 6.0.0 - Mend

sinapse-ai 5.0.7 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (660) hide show

package/docs/zh/architecture/hcs-self-healing-spec.md DELETED Viewed

@@ -1,148 +0,0 @@
-<!-- 翻译: ZH-CN | 原始: /docs/en/architecture/hcs-self-healing-spec.md | 同步: 2026-02-22 -->
-# HCS 自动恢复规范
-> 🌐 [EN](../../architecture/hcs-self-healing-spec.md) | [PT](../../pt/architecture/hcs-self-healing-spec.md) | **ZH**
----
-**版本:** 1.0
-**状态:** 提议
-**创建:** 2025-12-30
-**故事:** HCS-1 调查
-**作者:** @architect (Aria) via @dev (Dex)
----
-## 执行摘要
-本文档指定了 SINAPSE 健康检查系统 (HCS) 的自动恢复能力。自动恢复允许系统自动纠正某些问题,同时保持安全性和用户控制。
-### 基本原则
-1. **安全第一:** 永远不修改可能导致数据丢失或安全问题的文件
-2. **透明性:** 所有操作都被记录和可逆的
-3. **用户控制:** 关键修复需要显式确认
-4. **增量式:** 从安全修复开始,在复杂情况下向用户升级
----
-## 自动恢复哲学
-### 应用的行业模式
-| 系统        | 自动恢复方法                       | HCS 教训                              |
-| ----------- | ---------------------------------- | ------------------------------------- |
-| **Kubernetes** | 在 liveness 失败时重启容器        | 已知安全操作的自动恢复              |
-| **VS Code**    | 自动更新扩展,阻止恶意扩展        | 静默更新、显式阻止                  |
-| **Terraform**  | 仅在 `plan` 批准后 `apply`        | 分离检测和补救                      |
-| **npm/yarn**   | `--update-checksums` 修复完整性  | 用户启动的恢复命令                  |
-| **Git**        | `reflog` 恢复                     | 始终保留历史/备份                    |
----
-## 级别定义
-### 级别 1: 静默自动纠正
-**定义:** 安全且可逆的操作,不需要用户确认。
-**特性:**
-- 零数据丢失风险
-- 完全可逆
-- 无用户代码/配置更改
-- 仅框架/系统文件
-- 始终创建备份
-**操作:**
-| 操作                | 描述                                      | 备份 |
-| ------------------- | ----------------------------------------- | ---- |
-| `recreate_config`   | 从模板重新创建缺失的 `.sinapse/config.yaml` | 是   |
-| `clear_cache`       | 清除 `.sinapse/cache/` 中的过期缓存文件     | 是   |
-| `create_dirs`       | 创建缺失的框架目录                        | 否   |
-| `fix_permissions`   | 修复框架文件权限                          | 是   |
-| `regenerate_lockfile` | 再生成包锁文件完整性                     | 是   |
-| `restart_mcp`       | 重启无响应的 MCP 服务器                   | 否   |
-| `reset_project_status` | 重置损坏的项目状态文件                   | 是   |
----
-### 级别 2: 带确认的自动纠正
-**定义:** 中等风险操作,执行前需要用户确认。
-**特性:**
-- 可能修改与用户相邻的文件(非用户代码)
-- 带备份可逆
-- 可能暂时影响工作流
-- 需要用户显式"是"
-**操作:**
-| 操作                 | 描述                         | 备份 | 用户提示                    |
-| -------------------- | ---------------------------- | ---- | --------------------------- |
-| `update_deps`        | 更新过期的依赖               | 是   | "更新 X 个包?"             |
-| `fix_symlinks`       | 修复断裂的符号链接           | 是   | "修复 N 个断裂的链接?"     |
-| `regenerate_files`   | 从模板再生文件               | 是   | "从模板再生?"               |
-| `fix_ide_config`     | 修复 IDE 配置                | 是   | "修复 VS Code 设置?"       |
-| `migrate_config`     | 迁移配置到新版本             | 是   | "迁移 config v1→v2?"       |
-| `create_missing_docs` | 创建缺失的文档文件          | 否   | "创建 coding-standards.md?" |
----
-### 级别 3: 手动指南
-**定义:** 无法安全自动纠正的高风险或复杂问题。提供解决的指导。
-**特性:**
-- 数据丢失或损坏风险
-- 涉及用户代码/配置
-- 需要人的判断
-- 安全敏感的操作
-- 破坏兼容性的更改
----
-## 安全规则
-### 永不自动纠正(黑名单)
-以下文件/操作**永不**自动纠正:
-```yaml
-neverAutoFix:
-  files:
-    - '**/*.{js,ts,jsx,tsx,py,go,rs}' # 源代码
-    - '**/*.{json,yaml,yml}' # 用户配置(out of .sinapse/)
-    - '.env*' # 环境文件
-    - '**/secrets/**' # 密钥
-    - '**/credentials*' # 凭证
-    - '.git/**' # Git 内部
-    - 'package.json' # 用户依赖
-    - 'tsconfig.json' # 用户配置
-    - '.eslintrc*' # 用户 linting 规则
-  operations:
-    - delete_user_files # 永不删除用户文件
-    - modify_git_history # 永不重写 git 历史
-    - change_remote_urls # 永不修改远程
-    - push_to_remote # 永不自动推送
-    - modify_ci_secrets # 永不触及 CI 密钥
-    - change_permissions_recursive # 永不 chmod -R
-```
----
-## 相关文档
-- [ADR: HCS 架构](./adr/adr-hcs-health-check-system.md)
-- [HCS 执行模式](./hcs-execution-modes.md)
-- [HCS 检查规范](./hcs-check-specifications.md)
----
-_文档作为 Story HCS-1 调查的一部分创建_

package/docs/zh/architecture/high-level-architecture.md DELETED Viewed

@@ -1,355 +0,0 @@
-<!-- 翻译: ZH-CN | 原文: /docs/en/architecture/high-level-architecture.md | 同步时间: 2026-01-26 -->
-# SINAPSE v4 高级架构
-> 🌐 [EN](../../architecture/high-level-architecture.md) | [PT](../../pt/architecture/high-level-architecture.md) | [ES](../../es/architecture/high-level-architecture.md) | **ZH-CN**
----
-**版本:** 2.1.0
-**上次更新:** 2025-12-09
-**状态:** 官方架构文档
----
-## 目录
-- [概览](#概览)
-- [架构图](#架构图)
-- [模块化架构](#模块化架构)
-- [多仓库策略](#多仓库策略)
-- [技术栈](#技术栈)
-- [目录结构](#目录结构)
-- [主要组件](#主要组件)
-- [质量门槛](#质量门槛)
----
-## 概览
-**SINAPSE（AI 操作系统）** 是用于 AI 代理、工作者和人类在复杂软件开发工作流中进行编排的精巧框架。v2.1 版本引入了具有 4 个模块的模块化架构、多仓库策略和 3 层质量门槛。
-### v4.2 主要功能
-| 功能 | 描述 |
-| ---- | ---- |
-| **11 个专业代理** | 开发、QA、架构师、PM、PO、SM、分析师、数据工程师、DevOps、UX、主代理 |
-| **115+ 可执行任务** | 创建故事、代码生成、测试、部署、文档 |
-| **52+ 模板** | PRD、故事、架构文档、IDE 规则、质量门槛 |
-| **4 模块架构** | 核心、开发、产品、基础设施 |
-| **3 层质量门槛** | 提交前、PR 自动化、人工审查 |
-| **多仓库策略** | 3 个公开仓库 + 2 个私有仓库 |
-| **Squad 系统** | AI 代理的模块化团队 (ETL, Creator, MMOS) |
----
-## 架构图
-### 4 模块架构
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                     SINAPSE v4 框架                                       │
-│                     ═══════════════                                     │
-│                                                                         │
-│   ┌─────────────────────────────────────────────────────────────────┐   │
-│   │                        CLI / 工具                              │   │
-│   │  (sinapse agents, sinapse tasks, sinapse squads, sinapse workflow)          │   │
-│   └─────────────────────────────────────────────────────────────────┘   │
-│                                │                                        │
-│          ┌────────────────────┼────────────────────┐                   │
-│          │                    │                    │                   │
-│          ▼                    ▼                    ▼                   │
-│   ┌──────────────┐   ┌──────────────┐   ┌─────────────────┐           │
-│   │  开发模块    │   │  产品模块    │   │  基础设施模块   │           │
-│   │  ────────   │   │  ────────   │   │  ──────────   │           │
-│   │ • 11 个代理 │   │ • 52+ 模板  │   │ • 55+ 脚本     │           │
-│   │ • 115+ 任务 │   │ • 11 检查表 │   │ • 配置工具     │           │
-│   │ • 7 个工作流 │   │ • PM 数据   │   │ • 集成         │           │
-│   │ • 开发脚本  │   │             │   │ • PM 适配器    │           │
-│   └──────┬───────┘   └──────┬───────┘   └────────┬────────┘           │
-│          │                  │                    │                     │
-│          └──────────────────┼────────────────────┘                     │
-│                             │                                          │
-│                             ▼                                          │
-│   ┌─────────────────────────────────────────────────────────────────┐   │
-│   │                      核心模块                                  │   │
-│   │                      ═══════                                  │   │
-│   │                                                                  │   │
-│   │   ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │   │
-│   │   │   配置      │  │   注册表    │  │    质量门槛             │ │   │
-│   │   │   系统      │  │   (服务     │  │    (3 层)               │ │   │
-│   │   │             │  │   发现)     │  │                         │ │   │
-│   │   └─────────────┘  └─────────────┘  └─────────────────────────┘ │   │
-│   │                                                                  │   │
-│   │   ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │   │
-│   │   │    MCP      │  │   会话      │  │     询问                │ │   │
-│   │   │   系统      │  │   管理器    │  │     引擎                │ │   │
-│   │   │             │  │             │  │                         │ │   │
-│   │   └─────────────┘  └─────────────┘  └─────────────────────────┘ │   │
-│   │                                                                  │   │
-│   │   无内部依赖项（基础层）                                         │   │
-│   └─────────────────────────────────────────────────────────────────┘   │
-│                                                                         │
-└─────────────────────────────────────────────────────────────────────────┘
-```
-### 模块间关系
-```
-┌────────────────────────────────────────────────────────────────────────┐
-│                    模块依赖流                                          │
-│                                                                         │
-│                         ┌──────────────┐                                │
-│                         │  CLI/工具    │                                │
-│                         └──────┬───────┘                                │
-│                                │                                        │
-│              ┌─────────────────┼─────────────────┐                      │
-│              │                 │                 │                      │
-│              ▼                 ▼                 ▼                      │
-│     ┌────────────────┐ ┌────────────────┐ ┌────────────────┐           │
-│     │  development/  │ │    product/    │ │infrastructure/ │           │
-│     │                │ │                │ │                │           │
-│     │  • 代理        │ │  • 模板        │ │  • 脚本        │           │
-│     │  • 任务        │ │  • 检查表      │ │  • 工具        │           │
-│     │  • 工作流      │ │  • PM 数据     │ │  • 集成        │           │
-│     └───────┬────────┘ └───────┬────────┘ └───────┬────────┘           │
-│             │                  │                  │                     │
-│             │         仅依赖于                   │                     │
-│             └──────────────────┼──────────────────┘                     │
-│                                │                                        │
-│                                ▼                                        │
-│                      ┌────────────────┐                                 │
-│                      │     core/      │                                 │
-│                      │                │                                 │
-│                      │   无依赖项     │                                 │
-│                      └────────────────┘                                 │
-│                                                                         │
-│   规则:                                                                │
-│   • core/ 没有内部依赖项                                               │
-│   • development/, product/, infrastructure/ 仅依赖于 core/            │
-│   • 禁止循环依赖                                                      │
-│   • CLI/工具可以访问任何模块                                          │
-│                                                                         │
-└────────────────────────────────────────────────────────────────────────┘
-```
----
-## 多仓库策略
-### 仓库结构
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                    SINAPSE 组织                                          │
-│                                                                         │
-│   公开仓库                                                             │
-│   ═════════                                                           │
-│                                                                         │
-│   ┌────────────────────┐     ┌────────────────────┐                    │
-│   │  SinapseAI/         │     │  SinapseAI/         │                    │
-│   │  sinapse-ai         │     │  sinapse-squads       │                    │
-│   │  (MIT)  │◄────│  (MIT)             │                    │
-│   │                    │     │                    │                    │
-│   │  • 核心框架        │     │  • ETL Squad       │                    │
-│   │  • 11 个基础代理   │     │  • Creator Squad   │                    │
-│   │  • 质量门槛        │     │  • MMOS Squad      │                    │
-│   │  • 讨论中心        │     │                    │                    │
-│   └────────────────────┘     └────────────────────┘                    │
-│            │                                                            │
-│            │ 可选依赖                                                   │
-│            ▼                                                            │
-│   ┌────────────────────┐                                               │
-│   │  SinapseAI/         │                                               │
-│   │  mcp-ecosystem     │                                               │
-│   │  (Apache 2.0)      │                                               │
-│   │                    │                                               │
-│   │  • Docker MCP      │                                               │
-│   │  • IDE 配置        │                                               │
-│   │  • MCP 预设        │                                               │
-│   └────────────────────┘                                               │
-│                                                                         │
-│   私有仓库                                                             │
-│   ═════════════                                                       │
-│                                                                         │
-│   ┌────────────────────┐     ┌────────────────────┐                    │
-│   │  SinapseAI/mmos     │     │  SinapseAI/         │                    │
-│   │  (专有+NDA)        │     │  certified-partners│                    │
-│   │                    │     │  (专有)            │                    │
-│   │  • MMOS Minds      │     │  • 高级 Squads     │                    │
-│   │  • DNA Mental™     │     │  • 合作伙伴门户    │                    │
-│   └────────────────────┘     └────────────────────┘                    │
-│                                                                         │
-└─────────────────────────────────────────────────────────────────────────┘
-```
-### npm 包范围
-| 包 | 注册表 | 许可证 |
-| --- | --- | --- |
-| `@sinapse/core` | npm 公开 | MIT |
-| `@sinapse/squad-etl` | npm 公开 | MIT |
-| `@sinapse/squad-creator` | npm 公开 | MIT |
-| `@sinapse/squad-mmos` | npm 公开 | MIT |
-| `@sinapse/mcp-presets` | npm 公开 | Apache 2.0 |
----
-## 技术栈
-| 类别 | 技术 | 版本 | 注释 |
-| --- | --- | --- | --- |
-| 运行时 | Node.js | ≥18.0.0 | 所有脚本的平台 |
-| 语言 | TypeScript/JavaScript | ES2022 | 主要开发 |
-| 定义 | Markdown + YAML | N/A | 代理、任务、模板 |
-| 包管理器 | npm | ≥9.0.0 | 依赖项管理 |
-| 质量门槛 | Husky + lint-staged | 最新版 | 提交前钩子 |
-| 代码审查 | CodeRabbit | 最新版 | AI 审查 |
-| CI/CD | GitHub Actions | N/A | 自动化工作流 |
----
-## 目录结构
-### 当前结构 (v4)
-```
-@sinapse/sinapse-ai/
-├── .sinapse-ai/                    # 框架层
-│   ├── core/                      # 核心模块（基础）
-│   │   ├── config/                # 配置管理
-│   │   ├── registry/              # 服务发现
-│   │   ├── quality-gates/         # 3 层 QG 系统
-│   │   ├── mcp/                   # 全局 MCP 配置
-│   │   └── session/               # 会话管理
-│   │
-│   ├── development/               # 开发模块
-│   │   ├── agents/                # 11 个代理定义
-│   │   ├── tasks/                 # 115+ 任务定义
-│   │   ├── workflows/             # 7 个工作流定义
-│   │   └── scripts/               # 开发脚本
-│   │
-│   ├── product/                   # 产品模块
-│   │   ├── templates/             # 52+ 模板
-│   │   ├── checklists/            # 11 个检查表
-│   │   └── data/                  # PM 知识库
-│   │
-│   ├── infrastructure/            # 基础设施模块
-│   │   ├── scripts/               # 55+ 基础设施脚本
-│   │   ├── tools/                 # CLI、MCP、本地配置
-│   │   └── integrations/          # PM 适配器
-│   │
-│   └── docs/                      # 框架文档
-│       └── standards/             # 标准文档
-│
-├── docs/                          # 项目文档
-│   ├── stories/                   # 开发故事
-│   ├── architecture/              # 架构文档
-│   └── epics/                     # 史诗规划
-│
-├── squads/                        # Squad 实现
-│   ├── etl/                       # ETL Squad
-│   ├── creator/                   # Creator Squad
-│   └── mmos-mapper/               # MMOS Squad
-│
-├── .github/                       # GitHub 自动化
-│   ├── workflows/                 # CI/CD 工作流
-│   ├── ISSUE_TEMPLATE/            # 问题模板
-│   └── CODEOWNERS                 # 代码所有权
-│
-└── .husky/                        # Git 钩子 (QG 第 1 层)
-```
----
-## 主要组件
-### 模块概览
-| 模块 | 路径 | 目的 | 主要内容 |
-| --- | --- | --- | --- |
-| **核心** | `.sinapse-ai/core/` | 框架基础 | 配置、注册表、QG、MCP、会话 |
-| **开发** | `.sinapse-ai/development/` | 开发制品 | 代理、任务、工作流、脚本 |
-| **产品** | `.sinapse-ai/product/` | PM 制品 | 模板、检查表、数据 |
-| **基础设施** | `.sinapse-ai/infrastructure/` | 系统配置 | 脚本、工具、集成 |
-### 代理系统
-| 代理 | ID | 原型 | 责任 |
-| --- | --- | --- | --- |
-| Dex | `dev` | 构建者 | 代码实现 |
-| Quinn | `qa` | 守护者 | 质量保证 |
-| Aria | `architect` | 架构师 | 技术架构 |
-| Nova | `po` | 远见者 | 产品待办 |
-| Kai | `pm` | 平衡者 | 产品策略 |
-| River | `sm` | 协调者 | 过程协调 |
-| Zara | `analyst` | 探索者 | 业务分析 |
-| Dara | `data-engineer` | 架构师 | 数据工程 |
-| Felix | `devops` | 优化者 | CI/CD 和操作 |
-| Uma | `ux-expert` | 创造者 | 用户体验 |
-| Pax | `sinapse-master` | 编排者 | 框架编排 |
----
-## 质量门槛
-### 3 层质量门槛系统
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                     3 层质量门槛                                         │
-│                                                                         │
-│   ┌───────────────────────────────────────────────────────────────────┐ │
-│   │ 第 1 层: 提交前（本地）                                            │ │
-│   │ ═════════════════════                                            │ │
-│   │ • ESLint、Prettier、TypeScript                                    │ │
-│   │ • 单元测试（快速）                                                │ │
-│   │ • 工具: Husky + lint-staged                                       │ │
-│   │ • 强制: 失败无法提交                                              │ │
-│   │ • 捕获问题: 30%                                                   │ │
-│   └───────────────────────────────────────────────────────────────────┘ │
-│                                │                                        │
-│                                ▼                                        │
-│   ┌───────────────────────────────────────────────────────────────────┐ │
-│   │ 第 2 层: PR 自动化（CI/CD）                                       │ │
-│   │ ═══════════════════════════                                      │ │
-│   │ • AI CodeRabbit 审查                                              │ │
-│   │ • 集成测试、覆盖率分析                                            │ │
-│   │ • 安全扫描、性能基准                                              │ │
-│   │ • 工具: GitHub Actions + CodeRabbit                               │ │
-│   │ • 强制: 检查必须通过才能合并                                      │ │
-│   │ • 捕获问题: +50% 额外（总计 80%）                                 │ │
-│   └───────────────────────────────────────────────────────────────────┘ │
-│                                │                                        │
-│                                ▼                                        │
-│   ┌───────────────────────────────────────────────────────────────────┐ │
-│   │ 第 3 层: 人工审查（战略）                                         │ │
-│   │ ═════════════════════════                                        │ │
-│   │ • 架构对齐                                                        │ │
-│   │ • 业务逻辑正确性                                                  │ │
-│   │ • 边界情况、文档质量                                              │ │
-│   │ • 工具: 人工专业知识                                              │ │
-│   │ • 强制: 需要最终批准                                              │ │
-│   │ • 捕获问题: 最后 20%（总计 100%）                                 │ │
-│   └───────────────────────────────────────────────────────────────────┘ │
-│                                                                         │
-│   结果: 80% 的问题自动捕获                                            │
-│        人工审查时间: 30 分钟/PR（vs v2.0 中的 2-4 小时）              │
-│                                                                         │
-└─────────────────────────────────────────────────────────────────────────┘
-```
----
-## 相关文档
-- [模块系统](./module-system.md) - 模块详细架构
-- [ARCHITECTURE-INDEX.md](./ARCHITECTURE-INDEX.md) - 完整文档索引
-- [SINAPSE-LIVRO-DE-OURO-V2.1-COMPLETE.md](../../../.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO-V2.1-COMPLETE.md) - 框架完整指南
----
-**上次更新:** 2025-12-09
-**版本:** 2.1.0
-**维护者:** @architect (Aria)

package/docs/zh/architecture/introduction.md DELETED Viewed

@@ -1,21 +0,0 @@
-<!-- 翻译: ZH-CN | 原文: /docs/en/architecture/introduction.md | 同步时间: 2026-01-26 -->
-# 介绍
-> 🌐 [EN](../../architecture/introduction.md) | [PT](../../pt/architecture/introduction.md) | [ES](../../es/architecture/introduction.md) | **ZH-CN**
----
-本文档记录了 **SINAPSE** 代码库的当前状态，作为 **SINAPSE 第 1 阶段（MVP 至 FR4）** 的参考架构。它描述了将在其上构建新功能的现有模式、组件和技术。
-## 文档范围
-SINAPSE 框架的综合文档，作为 SINAPSE MVP 的基线，包括：品牌重塑、IDE 设置工作流、使用 LlamaIndex 的内存层和元代理 `sinapse-developer`。
-## 更新日志
-| 日期 | 版本 | 描述 | 作者 |
-| :--- | :--- | :--- | :--- |
-| 2025-07-24 | 1.0 | 基础架构初始生成。 | Winston |
-| 2025-07-24 | 2.0 | 基于用户输入修正目录结构。 | Winston |
-| 2025-07-24 | 3.0 | 添加 MVP 新组件。 | Winston |