import type { ProjectConfig, ResolvedConfig } from "../types/index.js";
/**
 * 配置验证错误条目。
 */
export interface ConfigValidationError {
    /** 错误字段路径（如 "tech_stack.backend.lang"） */
    path: string;
    /** 错误描述信息 */
    message: string;
}
/**
 * 验证原始配置数据。
 * @description 使用 Zod Schema 进行严格校验。支持旧格式（project.name 嵌套）的兼容处理。
 *              校验失败时返回部分解析结果（用默认值填充缺失字段）以及错误列表。
 * @param raw - 原始配置数据（通常为 YAML 解析后的对象）
 * @returns 包含验证后的配置对象和错误列表的结果
 */
export declare function validateConfig(raw: unknown): {
    config: ProjectConfig;
    errors: ConfigValidationError[];
};
/**
 * 加载项目配置文件。
 * @description 从 .soloforge/config.yaml 读取 YAML 配置，执行校验。
 *              若未显式设置 product_profile，会根据 product_mapping 和项目路径自动检测。
 *              配置文件不存在或解析失败时，使用默认空配置并输出警告。
 * @param projectPath - 项目根目录路径
 * @returns 加载并校验后的项目配置对象
 */
export declare function loadProjectConfig(projectPath: string): Promise<ProjectConfig>;
/**
 * 解析项目配置，支持无 config.yaml 的零配置回退。
 * @description 优先读取 .soloforge/config.yaml；若不存在，则通过指纹探测自动推断配置。
 * @param projectPath - 项目根目录路径
 * @returns 包含配置对象和来源信息的结果
 */
export declare function resolveProjectConfig(projectPath: string, options?: {
    quiet?: boolean;
}): Promise<ResolvedConfig>;
/**
 * 获取项目知识目录路径。
 * @description 返回 {projectPath}/.soloforge/knowledge 目录的绝对路径。
 * @param config - 项目配置对象
 * @returns 项目知识目录的绝对路径
 */
export declare function getProjectKnowledgeDir(config: ProjectConfig): string;
/**
 * 获取全局模式目录路径。
 * @description 返回 ~/.soloforge/patterns 目录路径，存放跨项目共享的知识模式。
 * @returns 全局模式目录的绝对路径
 */
export declare function getGlobalPatternsDir(): string;
//# sourceMappingURL=loader.d.ts.map