soloforge 1.1.2 → 1.1.31

package/dist/engine/dependency_scanner.js

@@ -1,16 +1,18 @@
+import { debug } from "./core/logger.js";
+import { safeJsonParse } from "./core/helpers.js";
 /**
  * 依赖漏洞扫描器 — 解析 package.json/pom.xml/build.gradle，基于内置漏洞规则库
  * 检测已知漏洞和未锁定版本。纯规则驱动，零 AI 依赖，不调用外部 API。
  */
 /** 内置漏洞规则库: 各语言生态的已知高风险依赖版本（包名 → 最低安全版本 → 漏洞描述） */
-// ── 漏洞数据库 (硬编码规则库，零 AI 依赖) ──
+// ── 漏洞数据库（硬编码规则库，零 AI 依赖） ──
 const VULN_DB = [
-    // Java
+    // Java 生态
     { package: "log4j-core", minSafe: "2.17.0", severity: "critical", issue: "Log4Shell RCE (CVE-2021-44228)" },
     { package: "fastjson", minSafe: "1.2.83", severity: "critical", issue: "反序列化远程代码执行" },
     { package: "jackson-databind", minSafe: "2.13.0", severity: "critical", issue: "反序列化漏洞" },
     { package: "shiro-core", minSafe: "1.10.0", severity: "high", issue: "认证绕过漏洞" },
-    // Node.js
+    // Node.js 生态
     { package: "lodash", minSafe: "4.17.21", severity: "high", issue: "原型污染 (CVE-2021-23337)" },
     { package: "express", minSafe: "4.18.0", severity: "medium", issue: "开放重定向" },
     { package: "axios", minSafe: "0.21.1", severity: "high", issue: "SSRF 漏洞" },
@@ -26,7 +28,7 @@ const VULN_DB = [
 ];
 /** 未锁定版本的正则匹配模式 — 匹配 "*"、"x"、"X" 或空字符串等无精确版本号的情况 */
 // ── 未锁定版本标识 ──
-const UNSCOPED_PATTERN = /^\s*[\*xX]?\s*$/;
+const UNSCOPED_PATTERN = /^\s*[*xX]?\s*$/;
 // ── 版本比较 ──
 /**
  * 比较两个 semver 风格的版本号，判断 a 是否大于 b。
@@ -123,21 +125,18 @@ function checkVulnerability(pkgName, version) {
 /** 解析 package.json — 提取 dependencies 和 devDependencies 中的包名和版本 */
 function parsePackageJson(content) {
     const deps = [];
-    try {
-        const pkg = JSON.parse(content);
-        const extract = (obj, isDev) => {
-            if (!obj)
-                return;
-            for (const [name, ver] of Object.entries(obj)) {
-                deps.push({ name, version: ver, isDev });
-            }
-        };
-        extract(pkg.dependencies, false);
-        extract(pkg.devDependencies, true);
-    }
-    catch {
-        // Invalid JSON — return empty
-    }
+    const pkg = safeJsonParse(content);
+    if (!pkg)
+        return deps;
+    const extract = (obj, isDev) => {
+        if (!obj)
+            return;
+        for (const [name, ver] of Object.entries(obj)) {
+            deps.push({ name, version: ver, isDev });
+        }
+    };
+    extract(pkg.dependencies, false);
+    extract(pkg.devDependencies, true);
     return deps;
 }
 /** 解析 pom.xml — 匹配 groupId/artifactId/version 三元组，支持多行格式 */
@@ -158,7 +157,7 @@ function parsePomXml(content) {
 /** 解析 build.gradle — 匹配 group:artifact:version 格式（如 'org.apache:log4j-core:2.14.1'） */
 function parseBuildGradle(content) {
     const deps = [];
-    // Match group:artifact:version format, e.g. 'org.apache.logging.log4j:log4j-core:2.14.1'
+    // 匹配 group:artifact:version 格式（如 'org.apache.logging.log4j:log4j-core:2.14.1'）
     const depPattern = /['"]([\w.-]+):([\w.-]+):([\d.]+(?:-[a-zA-Z][\w.-]*)?)['"]/g;
     let match;
     while ((match = depPattern.exec(content)) !== null) {
@@ -211,9 +210,11 @@ function buildSummary(total, vulnerabilities, unscoped) {
  * @returns 扫描结果，包含漏洞列表、未锁定版本和中文摘要
  */
 export function scanDependencies(content, filename) {
+    debug("依赖扫描", `开始扫描 ${filename}`);
     const baseName = filename.split("/").pop()?.toLowerCase() ?? "";
-    // ── package.json ──
+    // ── 解析 package.json ──
     if (baseName === "package.json") {
+        debug("依赖扫描", "检测到 package.json，使用 Node.js 解析器");
         const parsed = parsePackageJson(content);
         const vulnerabilities = [];
         const unscoped_versions = [];
@@ -221,7 +222,7 @@ export function scanDependencies(content, filename) {
         for (const dep of parsed) {
             const extracted = extractVersion(dep.version);
             if (extracted === null)
-                continue; // URL / git ref — skip
+                continue; // URL / git 引用，跳过
             scannedCount++;
             if (isUnscoped(extracted)) {
                 unscoped_versions.push(`${dep.name}: ${dep.version}`);
@@ -240,8 +241,9 @@ export function scanDependencies(content, filename) {
             summary: buildSummary(scannedCount, vulnerabilities, unscoped_versions),
         };
     }
-    // ── pom.xml ──
+    // ── 解析 pom.xml ──
     if (baseName === "pom.xml") {
+        debug("依赖扫描", "检测到 pom.xml，使用 Maven 解析器");
         const parsed = parsePomXml(content);
         const vulnerabilities = [];
         let scannedCount = 0;
@@ -260,8 +262,9 @@ export function scanDependencies(content, filename) {
             summary: buildSummary(scannedCount, vulnerabilities, []),
         };
     }
-    // ── build.gradle ──
+    // ── 解析 build.gradle ──
     if (baseName === "build.gradle" || baseName === "build.gradle.kts") {
+        debug("依赖扫描", "检测到 build.gradle，使用 Gradle 解析器");
         const parsed = parseBuildGradle(content);
         const vulnerabilities = [];
         let scannedCount = 0;
@@ -281,6 +284,7 @@ export function scanDependencies(content, filename) {
         };
     }
     // ── 不支持的文件格式，返回空结果 ──
+    debug("依赖扫描", `不支持的文件格式 ${filename}`);
     return {
         file: filename,
         dependencies_scanned: 0,

package/dist/engine/dependency_scanner.js.map

@@ -1 +1 @@
-{"version":3,"file":"dependency_scanner.js","sourceRoot":"","sources":["../../src/engine/dependency_scanner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dependency_scanner.js","sourceRoot":"","sources":["../../src/engine/dependency_scanner.ts"],"names":[],"mappings":"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"}

package/dist/engine/exploration.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectConfig, ClassifyResult } from "../types.js";
+import type { ProjectConfig, ClassifyResult } from "../types/index.js";
 import type { KnowledgeIndexManager } from "../knowledge/index_manager.js";
 /**
  * 自主技术选型与方案证伪引擎 — 当人类陷入"不知道用什么"时，
@@ -77,6 +77,73 @@ export interface ExplorationResult {
     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 {

package/dist/engine/exploration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exploration.d.ts","sourceRoot":"","sources":["../../src/engine/exploration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;;;;;;;;;GAUG;AAIH,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;IAC/C,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,WAAW;AACX,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,WAAW;AACX,MAAM,WAAW,mBAAmB;IAClC,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,aAAa;IACb,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY;IACZ,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,eAAe;AACf,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,WAAW;AACX,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,aAAa;IACb,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,YAAY;IACZ,wBAAwB,EAAE,uBAAuB,CAAC;IAClD,WAAW;IACX,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,eAAe;IACf,gBAAgB,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACnD,eAAe;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,WAAW;AACX,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB;IACjB,IAAI,EAAE,KAAK,CAAC;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,YAAY;AACZ,MAAM,WAAW,uBAAuB;IACtC,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,yBAAyB,EAAE,MAAM,CAAC;IAClC,sBAAsB;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAqOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC,GAAG,iBAAiB,CAgCpB"}
+{"version":3,"file":"exploration.d.ts","sourceRoot":"","sources":["../../src/engine/exploration.ts"],"names":[],"mappings":"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"}

package/dist/engine/exploration.js

@@ -1,3 +1,4 @@
+import { debug } from "./core/logger.js";
 const INDUSTRY_BENCHMARKS = [
     {
         keywords: ["分布式锁", "锁", "并发控制", "distributed lock", "互斥"],
@@ -217,13 +218,19 @@ const INDUSTRY_BENCHMARKS = [
  * @returns 探索结果，包含行业基准、对比矩阵、推荐方案、证伪报告和 A/B 决策
  */
 export function exploreSolutions(params) {
+    debug("探索模块", `开始探索领域「${params.domain_query}」`);
     const { domain_query, projectConfig, knowledgeIndex } = params;
     // 1. 检索行业基准 + 知识库匹配
     const benchmarks = retrieveBenchmarks(domain_query, knowledgeIndex);
+    debug("探索模块", `检索到 ${benchmarks.length} 个候选方案`);
+    if (benchmarks.length === 0) {
+        throw new Error(`探索模块: 未找到「${domain_query}」领域的候选方案，至少需要 1 个基准`);
+    }
     // 2. 构建对比矩阵
     const matrix = buildComparisonMatrix(benchmarks);
     // 3. 最优解宣誓
     const recommendation = declareArchitectRecommendation(benchmarks, projectConfig);
+    debug("探索模块", `架构师推荐方案「${recommendation.recommended}」`);
     // 4. 证伪循环
     const falsifications = benchmarks.map((b) => performFalsification(b));
     // 5. A/B 决策诱导
@@ -232,6 +239,31 @@ export function exploreSolutions(params) {
     const boundarySummary = falsifications
         .map((f) => `【${f.solution_name}】${f.boundary_declaration}`)
         .join("\n");
+    // 时效性标注
+    const timeliness = computeTimeliness(benchmarks);
+    if (timeliness.stale_warning) {
+        debug("探索模块", `${timeliness.message}`);
+    }
+    // 环境感知提示
+    const envHints = computeEnvironmentHints(projectConfig, benchmarks);
+    // 契约字段: local_constraints
+    const localConstraints = buildLocalConstraints(projectConfig);
+    // 契约字段: evidence_sources
+    const evidenceSources = buildEvidenceSources(benchmarks, knowledgeIndex);
+    // 契约字段: rejected_options
+    const rejectedOptions = buildRejectedOptions(benchmarks, recommendation);
+    // 契约字段: freshness_risk
+    const freshnessRisk = buildFreshnessRisk(timeliness, benchmarks);
+    // 契约字段: adoption_risk
+    const adoptionRisk = buildAdoptionRisk(recommendation, benchmarks);
+    // 契约字段: validation_plan
+    const validationPlan = buildValidationPlan(recommendation, benchmarks);
+    // 契约字段: decision_expiry
+    const decisionExpiry = buildDecisionExpiry(timeliness);
+    // 默认决策输出契约
+    const recommendedSolution = benchmarks.find((b) => b.name === recommendation.recommended) ?? benchmarks[0];
+    const recommendedFalsification = falsifications.find((f) => f.solution_name === recommendation.recommended);
+    debug("探索模块", `探索完成，推荐「${recommendation.recommended}」`);
     return {
         domain: benchmarks[0]?.name || domain_query,
         benchmarks,
@@ -239,13 +271,35 @@ export function exploreSolutions(params) {
         architect_recommendation: recommendation,
         falsification_report: falsifications,
         decision_options: decisionOptions,
-        boundary_summary: boundarySummary,
+        boundary_summary: boundarySummary + (envHints ? "\n" + envHints : ""),
+        timeliness,
+        local_constraints: localConstraints,
+        evidence_sources: evidenceSources,
+        rejected_options: rejectedOptions,
+        freshness_risk: freshnessRisk,
+        adoption_risk: adoptionRisk,
+        validation_plan: validationPlan,
+        decision_expiry: decisionExpiry,
+        // 默认决策契约 10 字段
+        recommended_option: recommendation.recommended,
+        why_this: recommendation.reason + "；规避了: " + recommendation.fatal_weakness_mitigation,
+        rejected_decision_options: rejectedOptions.map((r) => `${r.name}: ${r.reason}`),
+        steelman_alternatives: rejectedOptions.map((r) => r.steelman).join("；"),
+        attack_recommended_option: recommendedFalsification?.self_destruct_scenarios.join("；") ?? "无已知自毁场景",
+        falsification_tests: recommendedFalsification?.ceiling_description ?? "未设置天花板测试",
+        execution_plan: decisionOptions[0].reason + "；" + decisionOptions[0].suitable_for,
+        verification_plan: validationPlan,
+        rollback_plan: `移除「${recommendedSolution.name}」相关代码和配置即可恢复原状`,
+        human_confirmation_required: recommendedSolution.source === "heuristic",
     };
 }
 // ── 行业基准检索 ──
 /**
  * 检索行业基准方案。优先匹配内置行业库，辅以知识库查询。
  * 禁止凭空捏造 — 必须返回至少 1 个有据可查的标准方案。
+ * @param domainQuery - 领域查询关键词
+ * @param knowledgeIndex - 可选的知识索引管理器
+ * @returns 候选方案列表
  */
 function retrieveBenchmarks(domainQuery, knowledgeIndex) {
     const solutions = [];
@@ -307,12 +361,18 @@ function retrieveBenchmarks(domainQuery, knowledgeIndex) {
             best_for: "明确的高并发/高可用需求",
             worst_for: "时间紧迫、需求不确定",
         });
+        debug("探索模块", "未匹配到行业基准，使用启发式兜底方案");
     }
     return solutions;
 }
 // ── 对比矩阵 ──
 const DIMENSIONS = ["开发成本", "运行性能", "扩展上限", "维护性"];
 const RATING_KEYS = ["dev_cost", "performance", "scalability", "maintainability"];
+/**
+ * 构建选型权重对比矩阵。
+ * @param solutions - 候选方案列表
+ * @returns 对比矩阵，包含维度、各方案得分和总分
+ */
 function buildComparisonMatrix(solutions) {
     return {
         dimensions: DIMENSIONS,
@@ -324,7 +384,16 @@ function buildComparisonMatrix(solutions) {
     };
 }
 // ── 最优解宣誓 ──
+/**
+ * 基于项目上下文和方案评分，生成架构师推荐。
+ * @param solutions - 候选方案列表
+ * @param config - 项目配置
+ * @returns 架构师推荐结果
+ */
 function declareArchitectRecommendation(solutions, config) {
+    if (solutions.length === 0) {
+        throw new Error("declareArchitectRecommendation: 至少需要 1 个候选方案");
+    }
     // 按总分排序
     const sorted = [...solutions].sort((a, b) => RATING_KEYS.reduce((s, k) => s + b.ratings[k], 0) -
         RATING_KEYS.reduce((s, k) => s + a.ratings[k], 0));
@@ -346,13 +415,11 @@ function declareArchitectRecommendation(solutions, config) {
     };
 }
 // ── 方案证伪 ──
-const SELF_DESTRUCT_PATTERNS = [
-    { condition: "网络分区", template: "网络分区发生时，{solution} 的锁/状态可能分裂，导致数据不一致" },
-    { condition: "高并发热点", template: "单点 QPS 超过 10 万时，{solution} 可能成为瓶颈" },
-    { condition: "数据量级激增", template: "数据量从 GB 级跃迁到 TB 级时，{solution} 的性能可能断崖式下降" },
-    { condition: "依赖服务宕机", template: "{solution} 依赖的核心服务（如 Redis/DB）宕机时，整个功能不可用" },
-    { condition: "多活部署", template: "跨数据中心/多活部署时，{solution} 的一致性保障可能失效" },
-];
+/**
+ * 对单个方案执行证伪分析，生成自毁场景和边界声明。
+ * @param solution - 待证伪的技术方案
+ * @returns 证伪结果
+ */
 function performFalsification(solution) {
     // 根据方案特性筛选相关的自毁场景
     const scenarios = [];
@@ -390,7 +457,17 @@ function performFalsification(solution) {
     };
 }
 // ── A/B 决策诱导 ──
+/**
+ * 基于推荐方案和候选方案生成 A/B 决策选项。
+ * 方案 A 为架构师推荐（平衡性最优），方案 B 为有差异化优势的备选。
+ * @param solutions - 候选方案列表
+ * @param recommendation - 架构师推荐结果
+ * @returns 两个决策选项
+ */
 function generateDecisionOptions(solutions, recommendation) {
+    if (solutions.length === 0) {
+        throw new Error("generateDecisionOptions: 至少需要 1 个候选方案");
+    }
     // 方案 A: 架构师推荐（平衡性最优）
     const recommended = solutions.find((s) => s.name === recommendation.recommended) || solutions[0];
     // 方案 B: 另选一个有差异化优势的方案
@@ -411,4 +488,212 @@ function generateDecisionOptions(solutions, recommendation) {
         },
     ];
 }
+// ── 时效性检查 ──
+/** 基准数据最后审核日期 */
+const BENCHMARK_REVIEW_DATE = "2025-05-17";
+/**
+ * 计算基准数据的时效性信息。
+ * @param benchmarks - 候选方案列表
+ * @returns 时效性信息
+ */
+function computeTimeliness(benchmarks) {
+    const reviewDate = new Date(BENCHMARK_REVIEW_DATE);
+    const now = new Date();
+    const daysSince = Math.floor((now.getTime() - reviewDate.getTime()) / (1000 * 60 * 60 * 24));
+    const stale = daysSince > 180;
+    const industryCount = benchmarks.filter((b) => b.source === "industry").length;
+    let message;
+    if (stale) {
+        message = `⚠ 基准数据已 ${daysSince} 天未更新（上次审核: ${BENCHMARK_REVIEW_DATE}）。行业方案可能已有新版本或替代品，建议人工复核`;
+    }
+    else if (daysSince > 90) {
+        message = `基准数据审核于 ${daysSince} 天前。方案仍然有效，但建议关注相关技术的新版本发布`;
+    }
+    else {
+        message = `基准数据较新（${daysSince} 天前审核），${industryCount} 个行业标准方案可用`;
+    }
+    return {
+        last_reviewed: BENCHMARK_REVIEW_DATE,
+        days_since_review: daysSince,
+        stale_warning: stale,
+        message,
+    };
+}
+// ── 环境感知 ──
+/**
+ * 基于项目技术栈和方案特性，生成环境兼容性提示。
+ * @param config - 项目配置
+ * @param benchmarks - 候选方案列表
+ * @returns 环境提示文本，无兼容性问题时返回 null
+ */
+function computeEnvironmentHints(config, benchmarks) {
+    const hints = [];
+    const backend = config.tech_stack.backend;
+    const frontend = config.tech_stack.frontend;
+    // 检查方案是否与当前技术栈兼容
+    for (const sol of benchmarks) {
+        if (sol.source !== "industry")
+            continue;
+        // Java 后端相关提示
+        if (/Spring|Java|JVM/.test(sol.description) && backend.lang !== "java") {
+            hints.push(`「${sol.name}」需要 Java/JVM 环境，当前后端为 ${backend.lang || backend.framework}，需评估兼容性`);
+        }
+        // React 前端相关提示
+        if (/React|Next\.?js|Zustand|Formily/.test(sol.description) && frontend.framework !== "react") {
+            hints.push(`「${sol.name}」依赖 React 生态，当前前端为 ${frontend.framework}，需评估适配成本`);
+        }
+        // Redis 依赖提示
+        if (/Redis|redis/i.test(sol.description) && !hints.some((h) => h.includes("Redis"))) {
+            hints.push(`「${sol.name}」依赖 Redis，请确认部署环境已包含 Redis 服务`);
+        }
+    }
+    if (hints.length > 0) {
+        const lines = hints.map((h) => "- " + h).join("\n");
+        return "\n## 环境感知提示\n" + lines;
+    }
+    return null;
+}
+// ── 契约字段构建 ──
+/**
+ * 构建本地约束描述。
+ * @param config - 项目配置
+ * @returns 约束描述文本
+ */
+function buildLocalConstraints(config) {
+    const b = config.tech_stack.backend;
+    const f = config.tech_stack.frontend;
+    const parts = [];
+    if (b.framework && b.framework !== "unknown") {
+        parts.push(`后端: ${b.lang}/${b.framework} ${b.version}`);
+    }
+    if (f.framework && f.framework !== "unknown") {
+        parts.push(`前端: ${f.lang}/${f.framework} ${f.version}`);
+    }
+    if (config.scope?.backend?.length) {
+        parts.push(`后端 scope: ${config.scope.backend.join(", ")}`);
+    }
+    if (config.scope?.frontend?.length) {
+        parts.push(`前端 scope: ${config.scope.frontend.join(", ")}`);
+    }
+    return parts.length > 0 ? parts.join("；") : "未检测到技术栈约束";
+}
+/**
+ * 构建证据来源列表。
+ * @param benchmarks - 候选方案列表
+ * @param _knowledgeIndex - 知识索引管理器（未直接使用，预留参数）
+ * @returns 证据来源列表
+ */
+function buildEvidenceSources(benchmarks, _knowledgeIndex) {
+    const sources = [];
+    sources.push({
+        name: "项目配置",
+        tier: "local_code",
+        credibility: "high",
+        description: "当前项目的技术栈、scope 和构建命令配置",
+    });
+    for (const b of benchmarks) {
+        if (b.source === "industry") {
+            sources.push({
+                name: b.name,
+                tier: "community_practice",
+                credibility: "medium",
+                description: `行业基准方案: ${b.description}`,
+            });
+        }
+    }
+    if (_knowledgeIndex) {
+        sources.push({
+            name: "项目知识库",
+            tier: "local_code",
+            credibility: "high",
+            description: "项目积累的知识模板和决策规则",
+        });
+    }
+    return sources;
+}
+/**
+ * 构建被拒绝方案列表及拒绝原因。
+ * @param benchmarks - 候选方案列表
+ * @param recommendation - 架构师推荐结果
+ * @returns 被拒绝方案列表
+ */
+function buildRejectedOptions(benchmarks, recommendation) {
+    const rejected = benchmarks.filter((b) => b.name !== recommendation.recommended);
+    return rejected.map((b) => ({
+        name: b.name,
+        reason: `致命缺点: ${b.fatal_weakness}`,
+        steelman: `适用场景: ${b.best_for}（评分: ${RATING_KEYS.reduce((s, k) => s + b.ratings[k], 0)}/20）`,
+    }));
+}
+/**
+ * 构建知识新鲜度风险描述。
+ * @param timeliness - 时效性信息
+ * @param benchmarks - 候选方案列表
+ * @returns 新鲜度风险描述文本
+ */
+function buildFreshnessRisk(timeliness, benchmarks) {
+    const parts = [];
+    if (timeliness.stale_warning) {
+        parts.push(`基准数据已 ${timeliness.days_since_review} 天未更新，行业方案可能已有新版本`);
+    }
+    const industryCount = benchmarks.filter((b) => b.source === "industry").length;
+    if (industryCount === 0) {
+        parts.push("未匹配到行业标准方案，使用启发式兜底");
+    }
+    if (timeliness.days_since_review > 90 && !timeliness.stale_warning) {
+        parts.push(`基准数据 ${timeliness.days_since_review} 天未更新，建议关注新版本发布`);
+    }
+    return parts.length > 0 ? parts.join("；") : "基准数据较新，知识过时风险低";
+}
+/**
+ * 构建方案采用风险描述。
+ * @param recommendation - 架构师推荐结果
+ * @param benchmarks - 候选方案列表
+ * @returns 采用风险描述文本
+ */
+function buildAdoptionRisk(recommendation, benchmarks) {
+    const recommended = benchmarks.find((b) => b.name === recommendation.recommended);
+    if (!recommended)
+        return "无法评估采用风险";
+    const parts = [];
+    parts.push(`推荐方案「${recommended.name}」最差场景: ${recommended.worst_for}`);
+    if (recommended.fatal_weakness) {
+        parts.push(`致命弱点: ${recommended.fatal_weakness}`);
+    }
+    if (recommendation.prerequisites.length > 0) {
+        parts.push(`前提条件: ${recommendation.prerequisites.join("；")}`);
+    }
+    return parts.join("；");
+}
+/**
+ * 构建方案验证计划。
+ * @param recommendation - 架构师推荐结果
+ * @param benchmarks - 候选方案列表
+ * @returns 验证计划文本
+ */
+function buildValidationPlan(recommendation, benchmarks) {
+    const recommended = benchmarks.find((b) => b.name === recommendation.recommended);
+    const parts = [];
+    parts.push("1. 确认项目环境满足推荐方案的前提条件");
+    if (recommended) {
+        parts.push(`2. 在非关键路径上做最小 spike 验证「${recommended.name}」`);
+        parts.push(`3. 验证推荐方案不触发致命弱点: ${recommended?.fatal_weakness ?? "无"}`);
+    }
+    parts.push("4. 执行构建和测试验证");
+    parts.push("5. 回滚路径: 移除新增代码和配置即可恢复原状");
+    return parts.join("\n");
+}
+/**
+ * 构建决策有效期描述。
+ * @param timeliness - 时效性信息
+ * @returns 决策有效期描述文本
+ */
+function buildDecisionExpiry(timeliness) {
+    const days = timeliness.days_since_review;
+    if (days > 180)
+        return "基准数据已过期，决策结论需立即重新验证";
+    if (days > 90)
+        return `建议 ${180 - days} 天内重新验证（基准数据 ${days} 天前审核）`;
+    return `决策结论有效期至 ${new Date(Date.now() + (180 - days) * 86400000).toISOString().slice(0, 10)}`;
+}
 //# sourceMappingURL=exploration.js.map