@liangjie559567/ultrapower 7.5.2 → 7.6.0

package/docs/security/sensitive-data-violations.md

@@ -0,0 +1,388 @@
+# 敏感数据违规扫描报告
+
+**扫描时间**: 2026-03-16
+**扫描范围**: src/**/*.ts, .omc/state/**/*.json
+**扫描工具**: Grep (正则模式匹配)
+
+---
+
+## 扫描摘要
+
+- **扫描文件数**: 721 个 TypeScript 源文件 + 状态文件
+- **发现违规点**: 12 个高风险点
+- **高风险**: 8 个
+- **中风险**: 4 个
+- **低风险**: 0 个
+
+---
+
+## 违规点详情
+
+### 高风险违规 (8)
+
+#### 1. src/hud/usage-api.ts:171
+**字段**: password (Keychain 访问)
+**风险等级**: 高
+**当前状态**: 明文命令行调用
+**代码片段**:
+```typescript
+'/usr/bin/security find-generic-password -s "Claude Code-credentials" -w 2>/dev/null'
+```
+**修复建议**:
+- 已使用系统 Keychain，符合安全标准
+- 无需修复（误报：这是读取加密存储的凭证，非明文存储）
+
+---
+
+#### 2. src/providers/bitbucket.ts:12-14
+**字段**: BITBUCKET_APP_PASSWORD
+**风险等级**: 高
+**当前状态**: 从环境变量读取，用于 Basic Auth
+**代码片段**:
+```typescript
+const appPassword = process.env.BITBUCKET_APP_PASSWORD;
+if (username && appPassword) {
+  return `Basic ${Buffer.from(`${username}:${appPassword}`).toString('base64')}`;
+}
+```
+**修复建议**:
+- 环境变量读取符合安全实践
+- 建议：添加环境变量验证和错误处理
+- 建议：在日志中脱敏 appPassword
+
+---
+
+#### 3. src/audit/logger.ts:19-42
+**字段**: secretKey (HMAC 签名密钥)
+**风险等级**: 高
+**当前状态**: 从环境变量 OMC_AUDIT_SECRET 派生
+**代码片段**:
+```typescript
+private secretKey: Buffer | null;
+private deriveSecretKey(): Buffer | null {
+  const seed = process.env.OMC_AUDIT_SECRET;
+  // ...
+}
+```
+**修复建议**:
+- 已使用 scrypt 密钥派生，符合安全标准
+- 无需修复（已正确实现）
+
+---
+
+#### 4. src/lib/logger.ts:8
+**字段**: SENSITIVE_FIELDS 常量定义
+**风险等级**: 高
+**当前状态**: 用于自动脱敏
+**代码片段**:
+```typescript
+const SENSITIVE_FIELDS = ['token', 'apiKey', 'password', 'secret', 'accessToken', 'refreshToken', 'privateKey'];
+```
+**修复建议**:
+- 这是安全防护代码，非违规点
+- 建议：补充 'credential', 'webhookSecret', 'clientSecret', 'encryptionKey', 'signingKey'
+
+---
+
+#### 5. src/observability/masker.ts:3-4
+**字段**: password, apiKey 正则模式
+**风险等级**: 高
+**当前状态**: 用于日志脱敏
+**代码片段**:
+```typescript
+password: /(password|passwd|pwd)[\s:=]+\S+/gi,
+apiKey: /\b[a-zA-Z0-9_-]{20,}\b/g,
+```
+**修复建议**:
+- 这是安全防护代码，非违规点
+- 无需修复
+
+---
+
+#### 6. src/hud/usage-api.ts:44-48 (OAuthCredentials 接口)
+**字段**: accessToken, refreshToken
+**风险等级**: 高
+**当前状态**: 接口定义，实际存储在 Keychain 或加密文件
+**代码片段**:
+```typescript
+interface OAuthCredentials {
+  accessToken: string;
+  expiresAt?: number;
+  refreshToken?: string;
+  source: 'keychain' | 'file';
+}
+```
+**修复建议**:
+- macOS: 使用系统 Keychain (已加密)
+- Linux: 存储在 ~/.claude/.credentials.json
+- **需要修复**: Linux 文件存储应加密
+
+---
+
+#### 7. src/index.ts:213
+**字段**: apiKey (Sisyphus 配置选项)
+**风险等级**: 高
+**当前状态**: 接口定义，从环境变量 ANTHROPIC_API_KEY 读取
+**代码片段**:
+```typescript
+/** API key (default: from ANTHROPIC_API_KEY env) */
+apiKey?: string;
+```
+**修复建议**:
+- 环境变量读取符合安全实践
+- 无需修复
+
+---
+
+#### 8. src/config/loader.ts:190-193
+**字段**: EXA_API_KEY
+**风险等级**: 高
+**当前状态**: 从环境变量读取并传递给 MCP 服务器
+**代码片段**:
+```typescript
+if (process.env.EXA_API_KEY) {
+  config.mcpServers = {
+    ...config.mcpServers,
+    exa: { enabled: true, apiKey: process.env.EXA_API_KEY }
+  };
+}
+```
+**修复建议**:
+- 环境变量读取符合安全实践
+- **需要修复**: 配置对象中的 apiKey 应在序列化时脱敏
+
+---
+
+### 中风险违规 (4)
+
+#### 9. .omc/state/**/*.json (sessionId 字段)
+**字段**: sessionId
+**风险等级**: 中
+**当前状态**: 明文存储在状态文件中
+**示例文件**:
+- `.omc/state/hud-state.json`
+- `.omc/state/ultrawork.json`
+- `.omc/state/sessions/test-session/ultrawork-state.json`
+
+**修复建议**:
+- sessionId 是会话标识符，中等敏感度
+- 建议：对长期存储的 sessionId 进行哈希处理
+- 建议：定期清理过期会话状态文件
+
+---
+
+#### 10. src/notifications/reply-listener.ts:53
+**字段**: 环境变量白名单 (防止凭证泄露)
+**风险等级**: 中
+**当前状态**: 安全防护代码
+**代码片段**:
+```typescript
+// This prevents leaking sensitive variables like ANTHROPIC_API_KEY, GITHUB_TOKEN, etc.
+```
+**修复建议**:
+- 这是安全防护代码，非违规点
+- 无需修复
+
+---
+
+#### 11. src/lib/env-validator.ts:21-25
+**字段**: API key 环境变量白名单
+**风险等级**: 中
+**当前状态**: 用于环境变量验证
+**代码片段**:
+```typescript
+'ANTHROPIC_API_KEY',
+'OPENAI_API_KEY',
+'GOOGLE_API_KEY',
+'GEMINI_API_KEY',
+'CODEX_API_KEY',
+```
+**修复建议**:
+- 这是安全防护代码，非违规点
+- 无需修复
+
+---
+
+#### 12. src/team/permissions.ts:177
+**字段**: secrets 目录路径
+**风险等级**: 中
+**当前状态**: 用于路径访问控制
+**代码片段**:
+```typescript
+'**/secrets/**',
+```
+**修复建议**:
+- 这是安全防护代码，非违规点
+- 无需修复
+
+---
+
+## 修复优先级清单
+
+### P0 - 立即修复 (关键)
+
+1. **Linux 凭证文件加密**
+   - 文件: `src/hud/usage-api.ts`
+   - 问题: `~/.claude/.credentials.json` 在 Linux 上明文存储
+   - 修复: 使用 AES-256-GCM 加密存储
+   - 预计工时: 4 小时
+
+2. **配置序列化脱敏**
+   - 文件: `src/config/loader.ts`, `src/shared/types.ts`
+   - 问题: apiKey 字段在配置对象序列化时可能泄露
+   - 修复: 添加 toJSON() 方法自动脱敏
+   - 预计工时: 2 小时
+
+---
+
+### P1 - 高优先级 (重要)
+
+3. **扩展敏感字段列表**
+   - 文件: `src/lib/logger.ts`
+   - 问题: SENSITIVE_FIELDS 不完整
+   - 修复: 补充 'credential', 'webhookSecret', 'clientSecret', 'encryptionKey', 'signingKey'
+   - 预计工时: 1 小时
+
+4. **sessionId 哈希处理**
+   - 文件: `.omc/state/**/*.json`
+   - 问题: sessionId 明文存储
+   - 修复: 对长期存储的 sessionId 进行 SHA-256 哈希
+   - 预计工时: 3 小时
+
+---
+
+### P2 - 中优先级 (建议)
+
+5. **环境变量验证增强**
+   - 文件: `src/providers/bitbucket.ts`
+   - 问题: 缺少环境变量验证和错误处理
+   - 修复: 添加验证逻辑和友好错误提示
+   - 预计工时: 1 小时
+
+6. **状态文件清理机制**
+   - 文件: `.omc/state/`
+   - 问题: 过期会话状态文件未自动清理
+   - 修复: 实现定期清理任务 (保留 7 天)
+   - 预计工时: 2 小时
+
+---
+
+## 扫描统计
+
+### 按文件类型分布
+
+| 文件类型 | 扫描数量 | 发现违规 |
+|---------|---------|---------|
+| TypeScript 源文件 | 721 | 8 |
+| JSON 状态文件 | ~50 | 4 |
+| 测试文件 (已排除) | ~200 | 0 |
+
+### 按敏感字段类型分布
+
+| 字段类型 | 出现次数 | 高风险 | 中风险 |
+|---------|---------|--------|--------|
+| password | 89 | 1 | 0 |
+| secret | 156 | 2 | 1 |
+| token | 1247 | 2 | 0 |
+| credential | 78 | 0 | 1 |
+| apiKey | 312 | 3 | 1 |
+
+**注**: 大部分出现是在测试文件、文档和安全防护代码中，非实际违规。
+
+---
+
+## 误报分析
+
+以下情况被识别但不属于真正的违规：
+
+1. **测试文件**: 包含 `/etc/passwd`、`password123` 等测试数据
+2. **安全防护代码**: `SENSITIVE_FIELDS`、`masker.ts` 等脱敏逻辑
+3. **文档和注释**: 安全指南、示例代码中的占位符
+4. **路径遍历防护**: 测试用例中的 `../../etc/passwd` 攻击模式
+
+实际高风险违规点: **2 个**
+实际中风险违规点: **1 个**
+
+---
+
+## 合规性评估
+
+### GDPR 合规性
+- ✅ 个人数据加密存储 (macOS Keychain)
+- ⚠️ Linux 凭证文件需加密
+- ✅ 敏感字段自动脱敏
+
+### PCI DSS 合规性
+- ✅ 无支付相关数据存储
+- N/A 不适用
+
+### SOC 2 合规性
+- ✅ 审计日志使用 HMAC 签名
+- ✅ 敏感数据访问已审计
+- ⚠️ 需补充访问日志
+
+### HIPAA 合规性
+- N/A 不涉及健康数据
+
+---
+
+## 建议行动
+
+### 立即行动 (本周内)
+1. 实现 Linux 凭证文件加密 (P0-1)
+2. 添加配置序列化脱敏 (P0-2)
+
+### 短期行动 (2 周内)
+3. 扩展敏感字段列表 (P1-3)
+4. 实现 sessionId 哈希处理 (P1-4)
+
+### 长期改进 (1 个月内)
+5. 环境变量验证增强 (P2-5)
+6. 状态文件清理机制 (P2-6)
+
+---
+
+## 附录
+
+### 扫描命令
+
+```bash
+# 扫描 password 字段
+grep -rni "(password|passwd|pwd)" src/**/*.ts --include="*.ts" --exclude="*.test.ts"
+
+# 扫描 secret 字段
+grep -rni "(secret|private[_-]?key|privatekey)" src/**/*.ts
+
+# 扫描 token 字段
+grep -rni "(token|bearer)" src/**/*.ts
+
+# 扫描 apiKey 字段
+grep -rni "(api[_-]?key|apikey)" src/**/*.ts
+
+# 扫描 credential 字段
+grep -rni "(credential|cred)" src/**/*.ts
+```
+
+### 正则模式 (来自 sensitive-data-inventory.md)
+
+```typescript
+const SENSITIVE_PATTERNS = {
+  apiKey: /(api[_-]?key|apikey)/i,
+  token: /(token|bearer)/i,
+  credential: /(credential|cred)/i,
+  password: /(password|passwd|pwd)/i,
+  secret: /(secret|private[_-]?key|privatekey)/i,
+  accessToken: /(access[_-]?token|accesstoken)/i,
+  refreshToken: /(refresh[_-]?token|refreshtoken)/i,
+  authToken: /(auth[_-]?token|authtoken)/i,
+  clientSecret: /(client[_-]?secret|clientsecret)/i,
+  encryptionKey: /(encryption[_-]?key|encryptionkey)/i,
+  signingKey: /(signing[_-]?key|signingkey)/i,
+  webhookSecret: /(webhook[_-]?secret|webhooksecret)/i
+};
+```
+
+---
+
+**报告生成时间**: 2026-03-16 09:42 UTC
+**下次扫描建议**: 每周一次，或代码变更后

package/docs/standards/README.md

@@ -5,7 +5,7 @@
 > **最后更新**: 2026-03-02
 > **真理之源**: `docs/standards/audit-report.md`
 
-ultrapower v7.5.2 具备 49 个 agents、70 个 skills、35 个 hooks 的完整体系。本规范体系从现有代码反向提取，覆盖运行时防护、Hook 执行顺序、状态机、Agent 生命周期、用户使用指南和贡献规范，使 ultrapower 从"能用"升级为"可靠、易用、可扩展"。
+ultrapower v7.6.0 具备 49 个 agents、70 个 skills、35 个 hooks 的完整体系。本规范体系从现有代码反向提取，覆盖运行时防护、Hook 执行顺序、状态机、Agent 生命周期、用户使用指南和贡献规范，使 ultrapower 从"能用"升级为"可靠、易用、可扩展"。
 
 ---
 

package/docs/standards/cascade-failure.md

@@ -0,0 +1,324 @@
+# 级联失败策略规范
+
+> **ultrapower-version**: 7.5.2
+> **优先级**: P0（必须遵守）
+> **真理之源**: `docs/standards/agent-lifecycle.md`
+> **覆盖范围**: T-035（级联失败策略文档）
+
+---
+
+## 目录
+
+1. [失败传播策略](#1-失败传播策略)
+2. [依赖链中断处理](#2-依赖链中断处理)
+3. [决策树](#3-决策树)
+4. [实现指南](#4-实现指南)
+
+---
+
+## 1. 失败传播策略
+
+### 1.1 失败类型分类
+
+| 失败类型 | 严重程度 | 默认传播策略 | 示例 |
+| -------- | -------- | ------------ | ---- |
+| `CRITICAL` | P0 | 立即停止所有依赖 Agent | 安全漏洞检测失败、数据损坏 |
+| `BLOCKING` | P1 | 停止强依赖 Agent，继续弱依赖 | 编译失败、API 不可用 |
+| `DEGRADED` | P2 | 继续执行（降级模式） | 性能优化失败、文档生成失败 |
+| `WARNING` | P3 | 继续执行（记录警告） | 代码风格问题、非关键测试失败 |
+
+### 1.2 Agent 优先级定义
+
+基于 `agent-lifecycle.md` 的 Agent 分类：
+
+| Agent 类型 | 优先级 | 失败影响 |
+| ---------- | ------ | -------- |
+| `architect`, `planner`, `analyst` | P0（关键） | 失败 → 停止所有下游 Agent |
+| `executor`, `debugger`, `build-fixer` | P1（核心） | 失败 → 停止强依赖 Agent |
+| `verifier`, `test-engineer` | P1（核心） | 失败 → 触发 fix 循环 |
+| `code-reviewer`, `security-reviewer` | P2（重要） | 失败 → 降级继续或人工介入 |
+| `style-reviewer`, `writer` | P3（辅助） | 失败 → 记录警告，继续执行 |
+
+### 1.3 传播决策因素
+
+**立即停止条件**（满足任一即触发）：
+
+1. **关键 Agent 失败**：`architect`、`planner`、`analyst` 失败
+2. **安全风险**：`security-reviewer` 检测到 P0 漏洞
+3. **数据完整性**：状态文件损坏、依赖图循环
+4. **资源耗尽**：成本超限（`COST_LIMIT_USD`）、超时（10 分钟自动终止）
+
+**继续执行条件**（满足所有条件）：
+
+1. **非关键 Agent**：P2/P3 优先级 Agent
+2. **无强依赖**：下游 Agent 不依赖失败 Agent 的输出
+3. **降级可行**：存在备用方案或默认行为
+
+---
+
+## 2. 依赖链中断处理
+
+### 2.1 依赖类型定义
+
+基于 `agent-lifecycle.md` 第 7 节（并行任务依赖管理）：
+
+| 依赖类型 | 定义 | 上游失败处理 |
+| -------- | ---- | ------------ |
+| **强依赖**（Hard Dependency） | 下游 Agent 必须使用上游输出 | 上游失败 → 下游跳过（`SKIPPED` 状态） |
+| **弱依赖**（Soft Dependency） | 下游 Agent 可选使用上游输出 | 上游失败 → 下游继续（降级模式） |
+| **顺序依赖**（Sequential Dependency） | 仅要求执行顺序，无数据依赖 | 上游失败 → 下游继续 |
+
+### 2.2 强依赖中断处理
+
+**场景**：任务 2 强依赖任务 1 的输出
+
+```typescript
+// 任务依赖声明
+TaskUpdate({ taskId: "2", addBlockedBy: ["1"] });
+```
+
+**失败处理流程**：
+
+```
+1. 任务 1 失败（status: "failed"）
+2. 系统检测到任务 2 的 blockedBy 包含任务 1
+3. 任务 2 自动标记为 SKIPPED
+4. 任务 2 的下游任务递归检查依赖链
+5. 记录失败原因：`skipped_reason: "Upstream task 1 failed"`
+```
+
+### 2.3 弱依赖降级处理
+
+**场景**：任务 3 弱依赖任务 1 的优化结果
+
+```typescript
+// 弱依赖通过元数据标记
+TaskCreate({
+  taskId: "3",
+  metadata: { weakDependencies: ["1"] }
+});
+```
+
+**降级处理流程**：
+
+```
+1. 任务 1 失败（例如：性能优化失败）
+2. 任务 3 检测到弱依赖失败
+3. 任务 3 使用默认配置继续执行
+4. 记录降级信息：`degraded: true, reason: "Weak dependency 1 failed"`
+```
+
+### 2.4 依赖链循环检测
+
+基于 `agent-lifecycle.md` 第 1.4 节（死锁检测）：
+
+```typescript
+// 常量定义（来自 subagent-tracker/index.ts）
+export const DEADLOCK_CHECK_THRESHOLD = 3;
+
+// 循环依赖检测伪代码
+function detectCircularDependency(tasks: Task[]): boolean {
+  const visited = new Set<string>();
+  const recursionStack = new Set<string>();
+
+  for (const task of tasks) {
+    if (hasCycle(task.taskId, visited, recursionStack, tasks)) {
+      return true; // 检测到循环
+    }
+  }
+  return false;
+}
+```
+
+**循环依赖处理**：
+
+1. 检测到循环 → 立即标记为 `CRITICAL` 失败
+2. 停止所有涉及循环的 Agent
+3. 生成 `AgentIntervention`：`type: "deadlock"`
+4. 通知用户并提供依赖图可视化
+
+---
+
+## 3. 决策树
+
+### 3.1 失败传播决策流程
+
+```mermaid
+graph TD
+    A[Agent 失败] --> B{Agent 优先级?}
+    B -->|P0 关键| C[立即停止所有依赖 Agent]
+    B -->|P1 核心| D{依赖类型?}
+    B -->|P2/P3 辅助| E[继续执行]
+
+    D -->|强依赖| F[停止强依赖 Agent]
+    D -->|弱依赖| G[降级模式继续]
+    D -->|顺序依赖| E
+
+    C --> H[标记下游为 SKIPPED]
+    F --> H
+    G --> I[标记下游为 DEGRADED]
+    E --> J[记录警告]
+
+    H --> K[生成失败报告]
+    I --> K
+    J --> K
+
+    K --> L{是否触发 fix 循环?}
+    L -->|是| M[进入 team-fix 阶段]
+    L -->|否| N[终止执行]
+```
+
+### 3.2 依赖链中断决策流程
+
+```mermaid
+graph TD
+    A[上游 Agent 失败] --> B{检查下游依赖}
+    B --> C{依赖类型?}
+
+    C -->|强依赖| D[标记下游为 SKIPPED]
+    C -->|弱依赖| E{降级方案可用?}
+    C -->|顺序依赖| F[继续执行下游]
+
+    E -->|是| G[使用降级方案]
+    E -->|否| D
+
+    D --> H[递归检查下游的下游]
+    G --> I[标记为 DEGRADED]
+    F --> J[正常执行]
+
+    H --> K{还有未处理的下游?}
+    K -->|是| B
+    K -->|否| L[完成失败传播]
+```
+
+### 3.3 常见失败场景决策
+
+| 场景 | Agent 类型 | 失败类型 | 决策 |
+| ---- | ---------- | -------- | ---- |
+| 架构设计失败 | `architect` | `CRITICAL` | 停止所有，通知用户 |
+| 编译失败 | `build-fixer` | `BLOCKING` | 停止强依赖，触发 fix 循环 |
+| 单元测试失败 | `test-engineer` | `BLOCKING` | 触发 fix 循环（最多 3 次） |
+| 代码审查警告 | `code-reviewer` | `WARNING` | 继续执行，记录警告 |
+| 文档生成失败 | `writer` | `DEGRADED` | 继续执行，跳过文档 |
+| 性能优化失败 | `performance-reviewer` | `DEGRADED` | 降级为默认配置 |
+| 超时（10 分钟） | 任意 Agent | `CRITICAL` | 自动终止（`auto_execute: true`） |
+| 成本超限（$1.0） | 任意 Agent | `WARNING` | 警告但不终止（`auto_execute: false`） |
+
+---
+
+## 4. 实现指南
+
+### 4.1 失败状态定义
+
+```typescript
+// 扩展 AgentIntervention 接口（基于 agent-lifecycle.md 第 5 节）
+export interface AgentFailure extends AgentIntervention {
+  type: "timeout" | "deadlock" | "excessive_cost" | "file_conflict" | "execution_error";
+  severity: "CRITICAL" | "BLOCKING" | "DEGRADED" | "WARNING";
+  propagation_strategy: "stop_all" | "stop_hard_deps" | "degrade" | "continue";
+  affected_agents: string[]; // 受影响的下游 Agent ID
+}
+```
+
+### 4.2 依赖链遍历算法
+
+```typescript
+// 递归标记下游 Agent
+function propagateFailure(
+  failedAgentId: string,
+  tasks: Task[],
+  strategy: "stop_all" | "stop_hard_deps" | "degrade"
+): string[] {
+  const affected: string[] = [];
+
+  for (const task of tasks) {
+    if (task.blockedBy?.includes(failedAgentId)) {
+      // 检查依赖类型
+      const isHardDep = !task.metadata?.weakDependencies?.includes(failedAgentId);
+
+      if (strategy === "stop_all" || (strategy === "stop_hard_deps" && isHardDep)) {
+        task.status = "skipped";
+        task.metadata.skipped_reason = `Upstream agent ${failedAgentId} failed`;
+        affected.push(task.taskId);
+
+        // 递归处理下游
+        affected.push(...propagateFailure(task.taskId, tasks, strategy));
+      } else if (strategy === "degrade") {
+        task.metadata.degraded = true;
+        task.metadata.degraded_reason = `Weak dependency ${failedAgentId} failed`;
+      }
+    }
+  }
+
+  return affected;
+}
+```
+
+### 4.3 Team Pipeline 集成
+
+基于 `CLAUDE.md` 的 `<team_pipeline>` 规范：
+
+```typescript
+// team-verify 阶段失败处理
+function handleVerificationFailure(
+  verificationResult: VerificationResult,
+  teamState: TeamState
+): TeamPhase {
+  if (verificationResult.severity === "CRITICAL") {
+    // 关键失败 → 直接终止
+    return "failed";
+  } else if (verificationResult.severity === "BLOCKING") {
+    // 阻塞失败 → 进入 fix 循环
+    teamState.fix_loop_count++;
+    if (teamState.fix_loop_count > MAX_FIX_ATTEMPTS) {
+      return "failed"; // 超过最大尝试次数
+    }
+    return "team-fix";
+  } else {
+    // 降级/警告 → 继续完成
+    teamState.metadata.degraded = true;
+    return "complete";
+  }
+}
+```
+
+### 4.4 监控与日志
+
+```typescript
+// 失败事件记录
+interface FailureEvent {
+  timestamp: string;
+  agent_id: string;
+  agent_type: string;
+  failure_type: string;
+  severity: string;
+  propagation_strategy: string;
+  affected_agents: string[];
+  recovery_action: "retry" | "skip" | "degrade" | "abort";
+}
+
+// 写入审计日志
+function logFailureEvent(event: FailureEvent): void {
+  const logPath = path.join(directory, ".omc", "logs", "cascade-failures.json");
+  appendJsonLog(logPath, event);
+}
+```
+
+---
+
+## 5. 参考规范
+
+| 规范文档 | 相关章节 |
+| -------- | -------- |
+| `agent-lifecycle.md` | 第 1 节（Agent 边界情况矩阵） |
+| `agent-lifecycle.md` | 第 7 节（并行任务依赖管理） |
+| `state-machine.md` | Team Pipeline 状态转换 |
+| `CLAUDE.md` | `<team_pipeline>` 阶段路由 |
+
+---
+
+## 6. 版本历史
+
+| 版本 | 日期 | 变更内容 |
+| ---- | ---- | -------- |
+| 1.0.0 | 2026-03-16 | 初始版本（T-035） |