import { type DataAuditResult } from '@sofagent/core';
export interface UpdateEntityArgs {
    /** 现有 entity 名称（不含 .md 后缀，定位目标文件） */
    name: string;
    /** 可选：改名（新名称，不含 .md 后缀；省略 = 不改名） */
    newName?: string;
    /** 可选：改业务域归属 */
    domain?: string;
    /** 可选：改 entity 简述 */
    description?: string;
    /** 可选：JSON 格式关联关系（belongs_to / has_many），整体替换 relations */
    relations?: string;
    /** 可选：正文内容（Markdown body，不含 frontmatter；省略 = 保留原正文） */
    content?: string;
}
export interface UpdateEntityResult {
    /** 首行必须 [sofagent] 前缀 */
    text: string;
    /** 结构化数据 */
    data: {
        action: 'updated' | 'renamed';
        path: string;
        renamedFrom?: string;
        warnings?: DataAuditResult['violations'];
        auditVerdict: 'PASS' | 'WARN' | 'FAIL';
        isError: boolean;
    };
}
/**
 * 字段级更新 entity（v1.3.1 交付 5）
 *
 * 只改传入字段（domain/description/relations/content/newName），
 * 其余 frontmatter 与正文保留；updated_at 一律刷新。
 *
 * @param args 更新参数（name 必填；其余字段可选）
 * @returns 结构化结果（text + data）
 */
export declare function updateEntity(args: UpdateEntityArgs): UpdateEntityResult;
//# sourceMappingURL=update-entity.d.ts.map