用途：resolve 是 doc-sentinel 工作流中处理文档漂移队列的步骤，处理由该工具累积在 .doc-sentinel-drift.json 中的警告，判断每条警告是否为真实漂移并相应修复或驳回误报。
主要能力：按文档文件对警告去重分组，便于同一次处理完成一致更新；对每组进行三分类处理，先读取当前文档与被改动源文件，再判断漂移类型（路径移动、API 变更、配置变更、结构变更、行为变更或误报），真实漂移则更新文档，误报则从队列移除；修复完成后仅暂存被修改的文档文件并提交，最后删除漂移文件。
使用方式：读取队列使用 cat .doc-sentinel-drift.json 2>/dev/null || echo "No drift warnings pending"，队列为空或缺失时报告无待处理警告并退出。修复后提交使用 git add <fixed-doc-files> 与 git commit -m "docs: resolve documentation drift from recent changes..."，须使用 docs: 前缀以避免提交后钩子再次触发。完成后用 rm -f .doc-sentinel-drift.json 清空队列，并输出已修复、已驳回与需人工复核的汇总。
限制与规则：改动前必须同时阅读文档与源码；保持原有写作风格、细节层级与格式；不得整段删除文档，只能更新；无法确定意图时添加 <!-- TODO: verify --> 注释而非猜测；单个提交对同一文档产生超过 5 条警告时应考虑整体重写或派发 drift-resolver 智能体；即使存在被驳回的警告也要删除队列文件；若同时安装 doc-sync 或 inkwell，不要重复其内容生成工作，sentinel 只负责引用与准确性。未能自动解决的警告归入 Needs Review 并列出具体问题。