---
name: registry-infrastructure
scope:
  - '*'
products:
  - '*'
id: ka-hard-rule-注册表基础设施规则
asset_kind: governance_rule
lifecycle_status: active
authority: canonical
owner_mechanism_id: mc-registry-infrastructure
routes: ['*']
primary_triggers:
  - 注册表基础设施规则
secondary_triggers: []
negative_triggers: []
priority: P0
specificity: 5
consumes:
  - mc-all-mechanisms
hard_blocks:
  - contract未登记
  - policy无映射
fallback: manual_required
required_evidence:
  - contract_registry
  - mechanism_layer_map
version: 1.1.0
last_reviewed: '2026-06-01'
type: governance_rule
when: 注册表基础设施规则
stages: ["*"]
---

# 注册表基础设施规则

## 核心原则

注册表是 SoloForge 契约体系的基础设施层。所有机制必须通过注册表发现、验证和追踪其契约和资产。

## 规则

1. **注册完整性**: 每个机制必须在 MechanismContractRegistry 注册，包含 id、status、priority
2. **资产可发现**: 所有可消费模版资产必须在 ConsumableAssetRegistry 注册，包含 path、consumption_mode、owner_mechanism_id
3. **生命周期测试**: 每个注册表条目必须有对应的生命周期测试，验证注册/查询/状态变更
4. **跨注册表一致性**: owner_mechanism_id 必须在 DualLayerMechanismRegistry 中存在对应条目
5. **注册表健康检查**: validate-mechanisms 和 audit-template-mechanisms 必须能检测注册表不一致

## 失败模式

- 注册表条目无对应测试 → 应补充 lifecycle test
- owner_mechanism_id 指向不存在的机制 → 应修复引用
- 模版文件存在但未注册 → 应在 ConsumableAssetRegistry 登记

## 验收标准

- [ ] 所有机制契约在 registry 中可查询
- [ ] 所有模版资产有 owner_mechanism_id
- [ ] 注册表查询函数返回非空结果
- [ ] validate-mechanisms 不报告注册表缺失
