# meta_growth.py — 元成长回路设计

## 核心逻辑

每次修复型 commit 后，分析变更模式 → 自动生成/扩展检测规则 → 注入 Tier1/2/3 检测管线。

```
git log (merge commit diff)
  → 提取 fix 类型 (根据文件路径 + 变更内容)
  → 匹配规则模板
  → 生成规则 JSON
  → 写入 grow_rules/ 目录
  → checklist_audit.py / health_checks 读取规则并执行
```

## 修复类型分类

| 类型 | 触发模式 | 生成的规则 |
|------|----------|-----------|
| `port_misconfig` | 变更涉及端口号、health endpoint 路径 | 新增 port_check 规则 |
| `path_error` | 变更涉及文件路径、`os.path.join`、`Path()` | 新增 file_exists 检查 |
| `env_var` | 变更涉及 `os.environ.get`、环境变量 | 新增 env_var 检查 |
| `cmd_arg` | 变更涉及 subprocess 参数、命令行参数 | 新增 cmd_availability 检查 |
| `timeout` | 变更涉及 timeout 值、重试逻辑 | 新增 timeout_threshold 规则 |
| `import_fix` | 变更涉及 import 语句 | 新增 dependency_check 规则 |
| `permission` | 变更涉及权限、文件模式 | 新增 permission_check 规则 |

## 规则存储格式

```json
{
  "rule_id": "meta-growth-001",
  "source_commit": "abc1234",
  "source_msg": "fix: xmpp_bot health check timeout",
  "category": "timeout",
  "check_type": "http_timeout",
  "target": {"port": 5802, "endpoint": "/health", "timeout": 5},
  "confidence": 0.7,
  "stage": 1,
  "created": "2026-07-14T15:00:00",
  "active": false
}
```

`active: false` 表示 Stage 1（安全模式）——人工确认后才激活。

## Stage 控制

| Stage | 条件 | 行为 |
|-------|------|------|
| 1 | 默认 | 规则生成但不激活，写入 `grow_rules/` + 日志 |
| 2 | 连续 3 次同类修复无退回 | 规则自动激活，注入 Tier1 检测 |
| 3 | 连续 5 次泛化无退回 | 规则自动扩展到同类组件 |

## 输出消费方

- `grow_rules/*.json` → `checklist_audit.py` 读取 → K 测试中显示"元生长规则"子项
- 激活的规则 → `agents_health_check.py` 提取 → 加入 Tier1 检测

## 文件结构

```
gateway/scripts/
├── meta_growth.py        # 主逻辑
├── grow_rules/           # 规则输出目录（自动创建）
│   └── growth_meta.json  # 累计规则清单
└── pattern_templates/    # 规则模板定义（手写）
    └── templates.json
```