/**
 * 用户承诺契约 — 问题三十 (CLI / README User Promise)。
 *
 * 管理 CLI 命令行为矩阵、README 命令漂移检测和用户心智边界。
 * - CliCommandContract 必须反映真实能力状态
 * - README 命令漂移必须检测
 * - 文档承诺不得超出真实能力
 */
import type { CliCommandContract } from "../knowledge/knowledge_template_contracts.js";
export type { CliCommandContract };
/** README 命令漂移检测结果 */
export interface ReadmeDriftResult {
    has_drift: boolean;
    drift_items: ReadmeDriftItem[];
}
/** 单个漂移项 */
export interface ReadmeDriftItem {
    command: string;
    drift_type: "missing_in_cli" | "missing_in_readme" | "behavior_mismatch" | "mode_mismatch";
    readme_description?: string;
    cli_contract?: CliCommandContract;
    message_zh: string;
}
/** 用户承诺验证结果 */
export interface UserPromiseValidation {
    valid: boolean;
    findings: UserPromiseFinding[];
}
/** 用户承诺发现 */
export interface UserPromiseFinding {
    severity: "hard_fail" | "warning" | "info";
    rule: string;
    command?: string;
    message_zh: string;
}
/**
 * 获取所有内置 CLI 命令契约。
 */
export declare function getCliCommandContracts(): CliCommandContract[];
/**
 * 按命令名查找契约。
 */
export declare function findCliCommandContract(command: string): CliCommandContract | undefined;
/**
 * 检测 README 命令漂移。
 * 硬规则：README 命令必须映射到真实 CliCommandContract。
 */
export declare function detectReadmeDrift(readmeCommands: string[], cliContracts: CliCommandContract[]): ReadmeDriftResult;
/**
 * 验证用户承诺一致性。
 * 硬规则：
 * - README 不得出现未实现命令
 * - advisory 能力不得写成 enforced
 * - removed/deprecated 命令不得写成可用
 * - dry-run 命令不得写成 apply
 */
export declare function validateUserPromise(readmeCommands: string[], cliContracts: CliCommandContract[]): UserPromiseValidation;
/**
 * 验证 CLI 命令默认行为安全性。
 * 硬规则：
 * - sync-templates 默认 dry_run
 * - migrate 默认 dry_run
 * - sync-adapters 默认 dry_run
 * - init 不得覆盖已有知识
 */
export declare function validateCommandDefaults(contracts: CliCommandContract[]): UserPromiseFinding[];
//# sourceMappingURL=user_promise.d.ts.map