import type { ProjectConfig, ClassifyResult } from "../types/index.js";
import type { KnowledgeIndexManager } from "../knowledge/index_manager.js";
/**
 * 自主技术选型与方案证伪引擎 — 当人类陷入"不知道用什么"时，
 * 以首席架构师身份主导决策，禁止"复读机"或"模糊脑暴"。
 *
 * 核心能力:
 * 1. 行业基准检索: 从知识库 + 内置行业方案库中检索 3 个标准方案
 * 2. 选型权重矩阵: [开发成本/运行性能/扩展上限/维护复杂度] 四维对比
 * 3. 最优解宣誓: 基于项目上下文给出架构师推荐 + 规避致命缺点说明
 * 4. 方案证伪循环: 逻辑自毁测试 + 方案边界声明
 * 5. A/B 决策诱导: 禁止开放式提问，输出两个精确选项
 */
/** 技术方案条目 */
export interface TechSolution {
    /** 方案名称 */
    name: string;
    /** 方案来源: industry=行业标准, knowledge=知识库, heuristic=启发式 */
    source: "industry" | "knowledge" | "heuristic";
    /** 一句话描述 */
    description: string;
    /** 四维评分 (1-5, 5=最优) */
    ratings: SolutionRatings;
    /** 致命缺点 */
    fatal_weakness: string;
    /** 适用场景 */
    best_for: string;
    /** 不适用场景 */
    worst_for: string;
}
/** 四维评分 */
export interface SolutionRatings {
    /** 开发成本 (5=低成本, 1=高成本) */
    dev_cost: number;
    /** 运行性能 (5=高性能, 1=低性能) */
    performance: number;
    /** 扩展上限 (5=高扩展, 1=低扩展) */
    scalability: number;
    /** 维护复杂度 (5=易维护, 1=难维护) */
    maintainability: number;
}
/** 证伪结果 */
export interface FalsificationResult {
    /** 方案名称 */
    solution_name: string;
    /** 自毁场景列表 */
    self_destruct_scenarios: string[];
    /** 方案边界声明 */
    boundary_declaration: string;
    /** 天花板描述 */
    ceiling_description: string;
}
/** A/B 决策选项 */
export interface DecisionOption {
    /** 标签 (方案 A/B) */
    label: string;
    /** 方案名称 */
    solution_name: string;
    /** 理由 */
    reason: string;
    /** 适合场景 */
    suitable_for: string;
}
/** 探索输出 */
export interface ExplorationResult {
    /** 探索领域 */
    domain: string;
    /** 行业基准方案列表 (≥3) */
    benchmarks: TechSolution[];
    /** 选型权重矩阵 */
    comparison_matrix: ComparisonMatrix;
    /** 最优解宣誓 */
    architect_recommendation: ArchitectRecommendation;
    /** 证伪报告 */
    falsification_report: FalsificationResult[];
    /** A/B 决策选项 */
    decision_options: [DecisionOption, DecisionOption];
    /** 方案边界声明汇总 */
    boundary_summary: string;
    /** 时效性信息 */
    timeliness?: TimelinessInfo;
    /** 契约字段: 当前项目约束和已有栈 */
    local_constraints: string;
    /** 契约字段: 分层证据列表 */
    evidence_sources: EvidenceSource[];
    /** 契约字段: 被拒绝方案及原因 */
    rejected_options: RejectedOption[];
    /** 契约字段: 知识过时/新方案不稳定风险 */
    freshness_risk: string;
    /** 契约字段: 维护/安全/许可证/迁移退出成本 */
    adoption_risk: string;
    /** 契约字段: spike/测试/兼容性验证/回滚路径 */
    validation_plan: string;
    /** 契约字段: 结论何时需重新验证 */
    decision_expiry: string;
    /** 默认推荐方案，可直接执行 */
    recommended_option: string;
    /** 为什么选它，结合代码库和约束 */
    why_this: string;
    /** 被放弃的方案及放弃原因 */
    rejected_decision_options: string[];
    /** 对备选方案公平强化 */
    steelman_alternatives: string;
    /** 主动攻击推荐方案，列出失败条件 */
    attack_recommended_option: string;
    /** 如何证明推荐方案不成立 */
    falsification_tests: string;
    /** 执行步骤 */
    execution_plan: string;
    /** 验证命令和成功标准 */
    verification_plan: string;
    /** 失败后如何撤回 */
    rollback_plan: string;
    /** 是否需要人工确认 */
    human_confirmation_required: boolean;
}
/** 时效性信息 */
export interface TimelinessInfo {
    /** 基准数据最后审核日期 */
    last_reviewed: string;
    /** 距今天数 */
    days_since_review: number;
    /** 是否需要人工复核（>180 天） */
    stale_warning: boolean;
    /** 提示信息 */
    message: string;
}
/** 证据来源条目 */
export interface EvidenceSource {
    /** 来源名称 */
    name: string;
    /** 证据分层: local_code / official_docs / standards / maintainer_sources / community_practice / trend_signal */
    tier: "local_code" | "official_docs" | "standards" | "maintainer_sources" | "community_practice" | "trend_signal";
    /** 可信度: high / medium / low */
    credibility: "high" | "medium" | "low";
    /** 来源描述 */
    description: string;
}
/** 被拒绝方案 */
export interface RejectedOption {
    /** 方案名称 */
    name: string;
    /** 拒绝原因 */
    reason: string;
    /** steelman: 公平强化该方案的优点 */
    steelman: string;
}
/** 对比矩阵 */
export interface ComparisonMatrix {
    /** 维度列表 */
    dimensions: string[];
    /** 各方案在各维度的得分 */
    rows: Array<{
        solution_name: string;
        scores: number[];
        total: number;
    }>;
}
/** 架构师推荐 */
export interface ArchitectRecommendation {
    /** 推荐方案 */
    recommended: string;
    /** 推荐理由 */
    reason: string;
    /** 如何规避其他方案的致命缺点 */
    fatal_weakness_mitigation: string;
    /** 前提条件（推荐方案生效的前提） */
    prerequisites: string[];
}
/**
 * 执行自主技术选型与方案证伪。
 * @param params - 输入参数
 * @returns 探索结果，包含行业基准、对比矩阵、推荐方案、证伪报告和 A/B 决策
 */
export declare function exploreSolutions(params: {
    domain_query: string;
    projectConfig: ProjectConfig;
    classification?: ClassifyResult;
    knowledgeIndex?: KnowledgeIndexManager;
}): ExplorationResult;
//# sourceMappingURL=exploration.d.ts.map