KernLab.Tier.Contracts —— 契约总览
Contracts = 全家族共享契约与常量的零依赖汇点(无实现、无 IO、无引擎依赖): 逻辑地址/布局常量/生命周期接口/Meta 策略/结构族最小协议/事务参与面。 依赖链最底层:
KernLab.Loom.*(编译期)→ KernLab.Tier.Contracts → KernLab.Tier.Core → …—— 任何家族程序集都可引用,Contracts 不反向引用任何家族程序集。
分册索引
| 分册 | 覆盖 |
|---|---|
| 存储地址与引擎契约 | LogicalAddress 16B / IStorageEngine / EngineRecoveryHints / 读向/压缩/快照枚举 |
| 记录布局与 CRC | RecordMagic 登记表 / RecordFlags 位表 / Crc32·Crc64 Footer / [BinaryLayout] 消费契约 |
| 生命周期契约 | ILifecycle / IRecovery / RecoveryState·Phase·Progress / EmptyHints |
| Meta 策略契约 | MetaPolicyKind 四档 / IMetaPolicy·IMetaLayout·IMetaTransport / MetaPolicyFactory |
| 结构族与事务契约 | IIndex / IKeyResolver / 扫描游标 / Transfer 族 / ITransactionLog·Participant / IAsyncOperation |
边界红线(什么进 Contracts,什么不进)
- 进:跨程序集共享的接口、枚举、struct 常量、魔数登记表、旗标位表——"多家族都要认"的词汇表。
- 不进:任何实现(引擎/介质/传输)、任何对 Core/Runtime/Products 的类型引用、可变状态。
- 判据:如果类型只在一个家族程序集内部使用,它属于那个程序集——Contracts 只收"被两个以上 程序集消费的公共词汇"。
[BinaryLayout]标注在 Contracts 的记录结构上合法且常规(标注触发 Loom 布局生成器; 契约结构体定长自描述)。
与协调文档的关系
装配/流程/协作叙事见 COORDINATION.md (协调文档);本区是契约成员的参考手册——每个分册 = 成员表 + 语义 + 反模式。