Table of Contents

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 (协调文档);本区是契约成员的参考手册——每个分册 = 成员表 + 语义 + 反模式。