@lark-project/cli/lib/utils/check-local-config-drift.d.ts

飞书项目插件开发工具

/**
 * `lpm local-config set` 成功后调用：从磁盘 point.config.local.json 读一次最终落盘内容、
 * 算 canonical hash 写到 .lpm-cache/config/last-set.json，作为后续 drift 检测的基线。
 *
 * **必须从磁盘读、不能传内存对象**：writeJSONSync 写磁盘时会过滤 undefined 字段，
 * 内存对象与磁盘读出来的 hash 可能不一致——若拿内存对象算 baseline，set 完
 * 立刻跑 start 会误报 drift，反向训练 AI 忽略 stderr 信号。
 *
 * 写入失败静默——drift 检查只是辅助信号，不能拖累 set 的主流程。
 */
export declare function writeLocalConfigLastSet(): void;
/**
 * Stage Config plan → apply 边界守护：检测 point.config.local.json 是否
 * 在上次 `lpm local-config set` 之后被改动过、还没同步到 backend。
 *
 * 触发条件：本地配置文件存在 + last-set sentinel 存在 + canonical hash 不匹配
 * → 输出一行 stderr hint。**不阻断主流程**——挂在 start / build / diff 前
 * 是为了把"agent 改完文件就停"的信号显式化，而非强制 gate。
 *
 * 设计 fail-safe：所有 IO / parse 异常静默吞掉——drift 检查只是辅助提示，
 * 不能让它把 start / build / diff 弄挂。永不调 process.exit()。
 */
export declare function checkLocalConfigDrift(): void;