npm install

npm run dev

MCP Server (stdio): coordinator
Listening on stdio (pid 12345)
Database initialized: data.db
Available tools: 77
Available resources: 3

{
  "mcpServers": {
    "coordinator": {
      "command": "node",
      "args": ["/path/to/nexus/dist/server.js"],
      "env": {}
    }
  }
}

npx tsx scripts/demo-devflow.ts

┌─────────────────────────────────────────────────────────┐
│                     MCP Server                          │
│  ┌───────────┐  ┌───────────┐  ┌──────────┐           │
│  │ Session   │  │ Message   │  │ Task     │           │
│  │ Manager   │  │ Queue     │  │ Scheduler│           │
│  └───────────┘  └───────────┘  └──────────┘           │
│                                                         │
│  ┌───────────┐  ┌───────────┐  ┌──────────┐           │
│  │ Defect    │  │ Approval  │  │ Release  │           │
│  │ Aggregate │  │ Gate      │  │ Pipeline │           │
│  └───────────┘  └───────────┘  └──────────┘           │
│                                                         │
│  ┌───────────────────────────────────────────┐         │
│  │ Retro + Knowledge (Lightweight RAG)       │         │
│  └───────────────────────────────────────────┘         │
│                                                         │
│              SQLite (WAL mode)                          │
└─────────────────────────────────────────────────────────┘
         ↑                    ↑
         │                    │
    Claude Code            Codex
     (Manager)            (Worker)

缺陷录入 → 去重合并 → 分诊定级 → RCA 任务 → 修复任务 → 代码审查
                                                          ↓
知识沉淀 ← 复盘报告 ← 回滚恢复 ← 发布失败 ← 审批通过 ← 人工审批

npx tsx scripts/demo-devflow.ts

# 安装依赖
npm install

# 开发模式（自动重启）
npm run dev

# 构建生产版本
npm run build

# 运行生产版本
npm start

# 类型检查
npx tsc --noEmit

# 运行测试（watch 模式）
npx vitest

# 运行测试（单次）
npx vitest run

src/
├── server.ts          # MCP server 入口，注册所有 tools/resources
├── db.ts              # SQLite 数据库初始化和迁移（含并发安全修复）
├── session.ts         # 会话管理 (register, heartbeat, status)
├── message.ts         # 消息传递 (send, get, ack, wait_for_work)
├── task.ts            # 任务管理 (create, claim, update, list)
├── defects.ts         # 缺陷聚合与去重（Jaccard 相似度，事务保护）
├── approvals.ts       # 审批域（强制回滚计划 + 人工审批，原子更新）
├── releases.ts        # 发布与回滚（审批门禁 + 版本唯一性 + 幂等保护）
├── retros.ts          # 复盘与知识沉淀（轻量 RAG 检索，事务保护）
└── types.ts           # 共享类型定义

.claude/skills/
├── coordinator/       # 通用多会话协调 Skill（4 角色）
└── devflow/           # 软件研发全流程协同 Skill（6 角色 + 8 步闭环）
    ├── SKILL.md       # 入口：角色选择
    ├── workflows.md   # 8 步闭环工作流
    └── agents/        # 每个角色的 SKILL.md（9 要素完整）

.agents/skills/        # Codex 适配入口

tests/                 # 单元测试（vitest）
├── session.test.ts
├── message.test.ts
├── task.test.ts
├── defects.test.ts
└── ...

scripts/
└── demo-devflow.ts    # 8 步闭环冒烟脚本（输出运行轨迹）