用途:ddd-drift 用于检测证据、文档与代码之间随时间产生的漂移,避免未察觉的合规失效。适用于定时漂移检查(CI cron、pre-commit 或按需)、外部文档更新后、DDD 范围外的重大代码变更后、排查异常行为时,以及发布新 Book 版本前。不应用于替代合规验证(应使用 ddd-verify),也不用于单次变更的一致性检查。
主要能力:扫描七个漂移维度——证据(源内容摘要变化、新鲜度过期、URL 失效)、文档(代码变更但 ADR/CONTEXT.md/Book 引用未更新)、决策(实现偏离已接受的 ADR)、控制(编译后的控制不再捕获违规、适配器变更)、代码(祖传代码未经 DDD 范围修改、新构造缺少护照)、项目上下文(依赖变化但 project-context.yaml 未更新)、缓存(缓存文件未内容寻址、条目缺失、摘要不匹配)。机器 API 为 drift_check() → drift_report[]。
报告格式包含 id、type、lock_entry、expected_digest、actual_digest、severity、description、recommended_action。严重级别分 critical(T3 声明的证据漂移)、high(T2 声明证据漂移或文档与代码显著不符)、medium(新鲜度过期、轻微文档不匹配、未编译义务)、low(外观漂移、祖传代码轻微变更)。
CI 集成:漂移检查应按计划运行(每日或每周),发布 Book 前必须运行,critical 发现应阻止发布,漂移摘要存储在 .ddd/reports/。
限制:资料未提供安装命令、具体调用方式、收费与价格信息。漂移检测后仅影响依赖失效证据的变更,无关变更不受干扰。