soloforge 1.0.0

package/dist/engine/impact_analyzer.js

@@ -0,0 +1,171 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export async function analyzeImpact(input) {
+    const { intent, classification, expansion, config, projectPath } = input;
+    // 提取业务实体名
+    const entities = extractEntities(intent);
+    if (entities.length === 0) {
+        return {
+            task_id: "",
+            intent,
+            affected_files: [],
+            declared_scope: expansion.scope.allowed_paths,
+            out_of_scope_files: [],
+            scope_sufficient: true,
+            recommendation: "proceed",
+            summary: "未识别到明确的业务实体，无法进行影响分析",
+        };
+    }
+    // 在受影响仓库中搜索相关文件
+    const affectedFiles = await searchAffectedFiles(entities, classification.affected_repos, config, projectPath);
+    // 对比声明范围
+    const declaredScope = expansion.scope.allowed_paths;
+    const outOfScope = affectedFiles.filter((f) => !isPathInScope(f.path, declaredScope));
+    const scopeSufficient = outOfScope.length === 0;
+    const recommendation = deriveRecommendation(outOfScope);
+    const expandSuggestion = recommendation === "expand_scope"
+        ? deduplicatePaths(outOfScope.map((f) => path.dirname(f.path)))
+        : undefined;
+    return {
+        task_id: "",
+        intent,
+        affected_files: affectedFiles,
+        declared_scope: declaredScope,
+        out_of_scope_files: outOfScope,
+        scope_sufficient: scopeSufficient,
+        recommendation,
+        summary: formatSummary(affectedFiles.length, outOfScope.length, recommendation),
+        expand_suggestion: expandSuggestion,
+    };
+}
+function extractEntities(intent) {
+    // 从意图中提取业务实体（中文词组或英文驼峰词）
+    const entities = [];
+    // 中文实体提取: 常见业务名词
+    const businessTerms = [
+        "订单", "商品", "用户", "支付", "权限", "角色", "菜单",
+        "导出", "导入", "报表", "配置", "日志", "通知", "消息",
+        "库存", "购物车", "退款", "发票", "地址", "评论",
+    ];
+    for (const term of businessTerms) {
+        if (intent.includes(term) && !entities.includes(term)) {
+            entities.push(term);
+        }
+    }
+    // 英文实体提取: PascalCase 词
+    const pascalMatches = intent.match(/[A-Z][a-z]+(?:[A-Z][a-z]+)*/g);
+    if (pascalMatches) {
+        for (const m of pascalMatches) {
+            if (!entities.includes(m))
+                entities.push(m);
+        }
+    }
+    return entities;
+}
+async function searchAffectedFiles(entities, affectedRepos, config, projectPath) {
+    const results = [];
+    for (const repo of affectedRepos) {
+        const repoConfig = config.repos.find((r) => r.name === repo);
+        if (!repoConfig)
+            continue;
+        const repoPath = path.resolve(projectPath, repoConfig.path);
+        let files;
+        try {
+            files = await listFilesRecursive(repoPath);
+        }
+        catch {
+            continue;
+        }
+        for (const filePath of files) {
+            const relativePath = path.relative(projectPath, filePath);
+            const matchInfo = matchEntityInPath(relativePath, entities);
+            if (matchInfo) {
+                results.push({
+                    path: relativePath,
+                    reason: matchInfo.reason,
+                    confidence: matchInfo.confidence,
+                });
+            }
+        }
+    }
+    return results;
+}
+async function listFilesRecursive(dir, maxDepth = 6, depth = 0) {
+    if (depth > maxDepth)
+        return [];
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        // 跳过隐藏目录和常见忽略目录
+        if (entry.name.startsWith(".") || ["node_modules", "target", "build", "dist", ".git"].includes(entry.name)) {
+            continue;
+        }
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...await listFilesRecursive(fullPath, maxDepth, depth + 1));
+        }
+        else {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+function matchEntityInPath(filePath, entities) {
+    const basename = path.basename(filePath, path.extname(filePath));
+    const lowerPath = filePath.toLowerCase();
+    for (const entity of entities) {
+        const entityLower = entity.toLowerCase();
+        // 高置信度: 文件名直接包含实体名（Entity/DO/DTO）
+        if (basename.toLowerCase().includes(entityLower)) {
+            if (/Entity|DO|DTO|VO|PO|Model/.test(basename)) {
+                return { reason: `${basename} 直接对应实体 ${entity}`, confidence: "high" };
+            }
+            if (/Service|Controller|Mapper|Repository|Component/.test(basename)) {
+                return { reason: `${basename} 操作实体 ${entity}`, confidence: "medium" };
+            }
+            if (/test|spec/i.test(basename)) {
+                return { reason: `${basename} 测试实体 ${entity}`, confidence: "medium" };
+            }
+            return { reason: `${basename} 可能涉及实体 ${entity}`, confidence: "low" };
+        }
+        // 路径中包含实体名
+        if (lowerPath.includes(entityLower)) {
+            return { reason: `路径包含 ${entity}`, confidence: "low" };
+        }
+    }
+    return null;
+}
+function isPathInScope(filePath, allowedPaths) {
+    return allowedPaths.some((allowed) => {
+        let normalized = allowed.replace(/\*\*/g, "").replace(/\/$/, "");
+        if (!filePath.startsWith(normalized))
+            return false;
+        // 目录边界检查：匹配后的下一个字符必须是 / 或已到末尾
+        if (filePath.length === normalized.length)
+            return true;
+        return filePath[normalized.length] === "/";
+    });
+}
+function deriveRecommendation(outOfScope) {
+    if (outOfScope.length === 0)
+        return "proceed";
+    const hasHighConfidence = outOfScope.some((f) => f.confidence === "high");
+    const hasMediumConfidence = outOfScope.some((f) => f.confidence === "medium");
+    if (hasHighConfidence || hasMediumConfidence)
+        return "expand_scope";
+    return "confirm";
+}
+function deduplicatePaths(dirs) {
+    return [...new Set(dirs)];
+}
+function formatSummary(affected, outOfScope, recommendation) {
+    if (recommendation === "proceed") {
+        return `影响范围分析完成: ${affected} 个相关文件，全部在声明范围内`;
+    }
+    const labels = {
+        expand_scope: `影响范围超出声明范围: ${outOfScope} 个文件不在当前 scope 内，建议扩大作用域`,
+        confirm: `影响范围可能超出: ${outOfScope} 个低置信度文件不在 scope 内，建议确认`,
+    };
+    return labels[recommendation] ?? "分析完成";
+}
+//# sourceMappingURL=impact_analyzer.js.map

package/dist/engine/impact_analyzer.js.map

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

package/dist/engine/intent_expander.d.ts

@@ -0,0 +1,17 @@
+import type { ProjectConfig, ClassifyResult, ExpandResult, SubTask } from "../types.js";
+import type { KnowledgeIndexManager } from "../knowledge/index_manager.js";
+export interface PlanContext {
+    current_step: SubTask;
+    previous_outputs: Record<string, string>;
+}
+export interface ExpandInput {
+    intent: string;
+    classification: ClassifyResult;
+    projectPath: string;
+    config: ProjectConfig;
+    knowledgeIndex: KnowledgeIndexManager;
+    clarificationAnswers?: string[];
+    plan_context?: PlanContext;
+}
+export declare function expand(input: ExpandInput): Promise<ExpandResult>;
+//# sourceMappingURL=intent_expander.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent_expander.d.ts","sourceRoot":"","sources":["../../src/engine/intent_expander.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAsE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC5J,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AA6D3E,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAED,wBAAsB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAqGtE"}

package/dist/engine/intent_expander.js

@@ -0,0 +1,447 @@
+import Handlebars from "handlebars";
+import { detectConventions } from "./convention_detector.js";
+const PROMPT_TEMPLATE = Handlebars.compile(`## 任务
+{{intent}}
+
+## 项目上下文
+- 技术栈: {{tech_stack}}
+- 产品类型: {{product_profile}}
+- 涉及仓库: {{affected_repos}}
+
+{{#if matched_knowledge}}
+## 适用知识
+{{#each matched_knowledge}}
+### {{this.name}}
+{{this.content}}
+
+{{/each}}
+{{/if}}
+
+{{#if relevant_files}}
+## 相关文件
+{{#each relevant_files}}
+- {{this.path}} ({{this.reason}})
+{{/each}}
+{{/if}}
+
+{{#if is_legacy_code}}
+## 遗留代码注意事项
+以下文件存在与标准模式不一致的惯例，修改时请遵循现有风格:
+{{#each legacy_conventions}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## 约束
+- 只允许修改以下路径: {{scope.allowed_paths}}
+{{#unless scope.new_files_allowed}}
+- 不允许新建文件
+{{/unless}}
+{{#if scope.new_file_patterns}}
+- 新建文件必须匹配: {{scope.new_file_patterns}}
+{{/if}}
+
+## 验收标准
+### 自动验证（系统检查）
+{{#each acceptance.automated}}
+- [{{this.id}}] {{this.description}}
+{{/each}}
+{{#if acceptance.manual}}
+### 人工验证（需你确认）
+{{#each acceptance.manual}}
+- [{{this.id}}] {{this.description}}
+{{/each}}
+{{/if}}
+
+{{#if degraded}}
+**注意**: 当前无领域知识匹配，请保守操作，只修改必要文件。
+{{/if}}
+`);
+export async function expand(input) {
+    const { intent, classification, projectPath, config, knowledgeIndex } = input;
+    // 1. 查询知识库
+    const scopeFilters = classification.affected_repos.length > 0
+        ? classification.affected_repos
+        : ["shared"];
+    const matchedEntries = knowledgeIndex.query({
+        scope: scopeFilters,
+        products: [config.product_profile],
+        keywords: extractKeywords(intent),
+        limit: 5,
+    });
+    // 记录知识使用
+    if (matchedEntries.length > 0) {
+        knowledgeIndex.markUsed(matchedEntries.map((e) => e.id));
+    }
+    const degraded = matchedEntries.length === 0;
+    // 2. 检测遗留惯例
+    const legacyConventions = [];
+    let isLegacyCode = false;
+    if (!degraded && classification.affected_repos.length > 0) {
+        try {
+            const repoDirs = classification.affected_repos
+                .map((r) => config.repos.find((repo) => repo.name === r)?.path)
+                .filter(Boolean);
+            // 检查仓库中第一个已存在文件的惯例
+            const conventions = await detectConventions(repoDirs.map((d) => `${d}/src`).slice(0, 3), projectPath, config.conventions_file);
+            if (conventions.length > 0) {
+                isLegacyCode = true;
+                legacyConventions.push(...conventions.map((c) => c.convention));
+            }
+        }
+        catch {
+            // 惯例检测为尽力而为
+        }
+    }
+    // 3. 确定 scope
+    const scope = resolveScope(config, classification, degraded);
+    // 4. 生成验收标准
+    const acceptance = generateAcceptance(intent, classification, matchedEntries, config, degraded);
+    // 5. 组装 prompt
+    const techStack = buildTechStackLabel(config);
+    let prompt = PROMPT_TEMPLATE({
+        intent,
+        tech_stack: techStack,
+        product_profile: config.product_profile,
+        affected_repos: classification.affected_repos.join(", "),
+        matched_knowledge: matchedEntries.map((e) => ({
+            name: e.name,
+            content: e.body || e.when,
+        })),
+        relevant_files: scope.allowed_paths.slice(0, 10).map((p) => ({ path: p, reason: "scope 允许路径" })),
+        is_legacy_code: isLegacyCode,
+        legacy_conventions: legacyConventions,
+        scope: {
+            allowed_paths: scope.allowed_paths.join(", "),
+            new_files_allowed: scope.new_files_allowed,
+            new_file_patterns: scope.new_file_patterns?.join(", "),
+        },
+        acceptance,
+        degraded,
+    });
+    // 5.1 注入计划阶段上下文（P1: AI 唯一执行者, P2: 模板是护栏, P3: 产物系统）
+    if (input.plan_context) {
+        prompt = injectPlanContext(prompt, input.plan_context, knowledgeIndex);
+    }
+    // 6. 使用计数已通过 markUsed 更新（步骤 89-91），无需重复递增
+    // 7. 生成执行契约（能力 1）
+    const contract = buildExecutionContract(intent, classification, scope, acceptance);
+    // 8. 生成不确定性触发条件（能力 4）
+    const uncertaintyTriggers = buildUncertaintyTriggers(classification, intent);
+    return {
+        task_id: "", // 由调用方填充
+        prompt,
+        scope,
+        acceptance,
+        matched_patterns: matchedEntries.map((e) => e.name),
+        matched_knowledge: matchedEntries.map((e) => e.name),
+        is_legacy_code: isLegacyCode,
+        legacy_conventions: legacyConventions.length > 0 ? legacyConventions : undefined,
+        degraded,
+        contract,
+        uncertainty_triggers: uncertaintyTriggers.length > 0 ? uncertaintyTriggers : undefined,
+    };
+}
+/**
+ * P2（做什么/怎么做分离）+ P3（产物系统）：
+ * 将当前计划步骤的上下文注入到 expansion prompt 中。
+ * 包括：上一步产出文件内容、输出格式模板、建议工具。
+ * AI 自主决定执行方式（P4: 评估结果不评估路径）。
+ */
+function injectPlanContext(prompt, planContext, knowledgeIndex) {
+    const { current_step, previous_outputs } = planContext;
+    const sections = [];
+    // 上一步产出（P3: 产物系统，通过文件传递上下文）
+    const prevEntries = Object.entries(previous_outputs);
+    if (prevEntries.length > 0) {
+        sections.push("## 前序阶段产出");
+        for (const [stepId, content] of prevEntries) {
+            if (content) {
+                sections.push(`### ${stepId}\n${content.slice(0, 3000)}`);
+            }
+        }
+    }
+    // 输出格式模板（P2: 模板是护栏不是笼子）
+    if (current_step.output_template) {
+        const templateEntries = knowledgeIndex.query({
+            type: "acceptance_template",
+            keywords: [],
+        });
+        const matched = templateEntries.find((e) => e.name === current_step.output_template);
+        if (matched?.body) {
+            sections.push(`## 输出格式参考（模板: ${current_step.output_template}）\n${matched.body}`);
+        }
+    }
+    // 输出路径（P3: 产出保存位置）
+    if (current_step.output_path) {
+        sections.push(`## 产出保存\n将本阶段产出写入: ${current_step.output_path}`);
+    }
+    // 建议工具（P2: AI 自主决定是否使用）
+    if (current_step.suggested_tools && current_step.suggested_tools.length > 0) {
+        sections.push(`## 建议工具（可选）\n${current_step.suggested_tools.map((t) => `- ${t}`).join("\n")}`);
+    }
+    if (sections.length === 0)
+        return prompt;
+    return `${prompt}\n\n---\n\n## 当前计划阶段\n正在执行: **${current_step.title}**\n${current_step.description}\n\n${sections.join("\n\n")}`;
+}
+function extractKeywords(intent) {
+    // 简单关键词提取: 按常见分隔符拆分，过滤短词
+    return intent
+        .replace(/[的了吗呢把被在从对和与或是]/g, " ")
+        .split(/[\s,，、；;]+/)
+        .filter((w) => w.length >= 2);
+}
+function resolveScope(config, classification, degraded) {
+    const allowedPaths = [];
+    for (const repoName of classification.affected_repos) {
+        const repo = config.repos.find((r) => r.name === repoName);
+        if (repo) {
+            allowedPaths.push(...repo.scope);
+        }
+    }
+    // 无匹配仓库或降级时回退到默认 scope
+    if (allowedPaths.length === 0) {
+        allowedPaths.push(...(config.scope.backend || []));
+        allowedPaths.push(...(config.scope.frontend || []));
+    }
+    // 计算 readonly_paths: 不在受影响仓库 scope 内但属于项目的路径
+    const readonlyPaths = [];
+    for (const repo of config.repos) {
+        if (!classification.affected_repos.includes(repo.name)) {
+            readonlyPaths.push(...repo.scope);
+        }
+    }
+    return {
+        allowed_paths: allowedPaths,
+        readonly_paths: readonlyPaths,
+        new_files_allowed: !degraded,
+        new_file_patterns: !degraded && classification.strategy === "full_pipeline"
+            ? ["**/*"] // full_pipeline 模式下允许新建任意文件
+            : undefined,
+    };
+}
+function generateAcceptance(intent, classification, matchedEntries, _config, degraded) {
+    const automated = [];
+    const manual = [];
+    if (degraded) {
+        // 降级模式: 仅基本验收（sf_verify 独立生成 build/test 命令，此处仅声明验收项）
+        automated.push({
+            id: "A-build",
+            description: "编译通过，无类型错误",
+            type: "automated",
+        });
+        automated.push({
+            id: "A-test",
+            description: "测试通过",
+            type: "automated",
+        });
+        return { automated, manual };
+    }
+    // 完整模式: 构建 + 模式特定 + 任务类型验收
+    automated.push({
+        id: "A-build",
+        description: "编译通过，无类型错误",
+        type: "automated",
+    });
+    // 模式特定验收: 从知识正文中解析 ## 验收项
+    for (const entry of matchedEntries) {
+        if (entry.body) {
+            const items = parseAcceptanceItems(entry.body);
+            automated.push(...items);
+        }
+    }
+    // 任务类型特定的人工验收项
+    if (classification.task_type === "feature") {
+        manual.push({
+            id: "M-ux",
+            description: "新增功能的交互是否符合设计规范",
+            type: "manual",
+        });
+    }
+    if (classification.task_type === "bugfix") {
+        manual.push({
+            id: "M-root",
+            description: "修复是否针对了根本原因而非症状",
+            type: "manual",
+        });
+    }
+    return { automated, manual };
+}
+function parseAcceptanceItems(body) {
+    const items = [];
+    if (!body.includes("## 验收项"))
+        return items;
+    const lines = body.split("\n");
+    let inSection = false;
+    for (const line of lines) {
+        if (line.startsWith("## 验收项")) {
+            inSection = true;
+            continue;
+        }
+        if (inSection && line.startsWith("## "))
+            break;
+        if (inSection) {
+            // 支持 (check: ...) 提取 check_command
+            const match = line.match(/- \[([A-Z]+-\d+)\]\s*(.+?)(?:\s*\(check:\s*(.+)\))?$/);
+            if (match) {
+                const item = { id: match[1], description: match[2].trim(), type: "automated" };
+                if (match[3])
+                    item.check_command = match[3].trim();
+                items.push(item);
+            }
+        }
+    }
+    return items;
+}
+function buildTechStackLabel(config) {
+    const parts = [];
+    if (config.tech_stack.backend.framework) {
+        parts.push(`${config.tech_stack.backend.framework} ${config.tech_stack.backend.version}`);
+    }
+    if (config.tech_stack.frontend.framework) {
+        parts.push(`${config.tech_stack.frontend.framework} ${config.tech_stack.frontend.version}`);
+    }
+    return parts.join(" + ") || "未知";
+}
+// ── 能力 1: 执行契约 ──
+function buildExecutionContract(intent, classification, scope, acceptance) {
+    const constraints = [];
+    const stopConditions = [];
+    // 按 risk 级别收紧约束
+    if (classification.risk === "high") {
+        constraints.push("高风险任务：每个变更文件必须有明确来源（任务卡/缺陷/设计锚点）");
+        constraints.push("禁止顺手重构或范围外变更");
+        constraints.push("修复循环上限 3 轮，超过必须升级");
+        stopConditions.push("修复循环超过 3 轮");
+        stopConditions.push("变更文件超出 scope.allowed_paths 范围");
+    }
+    else if (classification.risk === "medium") {
+        constraints.push("中等风险：核心逻辑变更需有回归测试");
+        stopConditions.push("编译失败 2 次以上");
+    }
+    else {
+        constraints.push("低风险：标准变更流程");
+    }
+    if (classification.complexity === "high") {
+        constraints.push("高复杂度：必须先定位根因再编码，禁止试错");
+        constraints.push("一次只修一个问题，禁止跨层大重构");
+    }
+    return {
+        goal: intent.slice(0, 200),
+        scope: scope.allowed_paths,
+        constraints,
+        verification: acceptance.automated.map((a) => `[${a.id}] ${a.description}`),
+        stop_conditions: stopConditions,
+    };
+}
+// ── 能力 4: 不确定性协议 ──
+const UNCERTAINTY_PATTERNS = [
+    {
+        pattern: /(?:表结构|DDL|加字段|删字段|改字段|索引|migration)/i,
+        trigger_type: "ddl_change",
+        description: "涉及数据库结构变更，可能影响现有数据",
+        options: [
+            { label: "向前兼容变更", tradeoff: "需额外兼容逻辑，但可平滑迁移" },
+            { label: "破坏性变更（需迁移脚本）", tradeoff: "直接但需停机或分步迁移" },
+        ],
+        recommendation: "优先向前兼容方案",
+    },
+    {
+        pattern: /(?:权限|角色|授权|鉴权|permission|auth)/i,
+        trigger_type: "permission_change",
+        description: "涉及权限/角色变更，影响用户访问控制",
+        options: [
+            { label: "收紧权限", tradeoff: "安全但可能阻断合法用户" },
+            { label: "放宽权限", tradeoff: "便利但增加安全风险" },
+        ],
+        recommendation: "默认收紧，逐案放开",
+    },
+    {
+        pattern: /(?:金额|价格|费用|支付|退款|计算|结算)/i,
+        trigger_type: "amount_logic",
+        description: "涉及金额计算逻辑，需要精确性验证",
+        options: [
+            { label: "复用现有计算逻辑", tradeoff: "安全但可能不适用新场景" },
+            { label: "新建计算逻辑", tradeoff: "灵活但需全面测试（含边界值/精度/并发）" },
+        ],
+        recommendation: "复用现有逻辑优先",
+    },
+    {
+        pattern: /(?:跨系统|外部接口|第三方|回调|同步|推送)/i,
+        trigger_type: "cross_system",
+        description: "涉及跨系统交互，需要幂等和补偿机制",
+        options: [
+            { label: "同步调用", tradeoff: "简单但强耦合" },
+            { label: "异步+补偿", tradeoff: "解耦但复杂度高" },
+        ],
+        recommendation: "异步+补偿优先",
+    },
+    {
+        pattern: /(?:状态机|状态流转|审批|审核|工作流)/i,
+        trigger_type: "state_transition",
+        description: "涉及状态流转逻辑，需要完整的守卫条件",
+        options: [
+            { label: "扩展现有状态机", tradeoff: "一致但需理解现有流转" },
+            { label: "新建独立流程", tradeoff: "独立但可能重复" },
+        ],
+        recommendation: "扩展现有状态机优先",
+    },
+    {
+        pattern: /(?:删除|清理|归档|批量操作)/i,
+        trigger_type: "destructive_operation",
+        description: "涉及破坏性操作，需要可恢复机制",
+        options: [
+            { label: "软删除（可恢复）", tradeoff: "安全但占存储" },
+            { label: "硬删除+备份", tradeoff: "干净但恢复成本高" },
+        ],
+        recommendation: "优先软删除",
+    },
+    {
+        pattern: /(?:并发|锁|竞争|原子|分布式事务)/i,
+        trigger_type: "concurrency",
+        description: "涉及并发控制，需要确定并发策略",
+        options: [
+            { label: "乐观锁", tradeoff: "高性能但需冲突重试" },
+            { label: "悲观锁", tradeoff: "安全但降低吞吐" },
+        ],
+        recommendation: "乐观锁优先",
+    },
+    {
+        pattern: /(?:敏感信息|加密|解密|脱敏|密码|token)/i,
+        trigger_type: "sensitive_data",
+        description: "涉及敏感数据处理，需要安全策略",
+        options: [
+            { label: "传输+存储加密", tradeoff: "安全但性能有开销" },
+            { label: "仅传输加密", tradeoff: "轻量但存储风险" },
+        ],
+        recommendation: "传输+存储均加密",
+    },
+];
+function buildUncertaintyTriggers(classification, intent) {
+    const triggers = [];
+    for (const pattern of UNCERTAINTY_PATTERNS) {
+        if (pattern.pattern.test(intent)) {
+            triggers.push({
+                trigger_type: pattern.trigger_type,
+                description: pattern.description,
+                options: pattern.options,
+                recommendation: pattern.recommendation,
+            });
+        }
+    }
+    // 高风险 + 高歧义 = 额外确认
+    if (classification.risk === "high" && classification.ambiguity === "high") {
+        triggers.push({
+            trigger_type: "high_risk_high_ambiguity",
+            description: "高风险 + 高歧义任务，意图可能存在多种解读",
+            options: [
+                { label: "按最保守方案执行", tradeoff: "安全但可能不满足全部需求" },
+                { label: "先澄清再执行", tradeoff: "准确但增加前置时间" },
+            ],
+            recommendation: "先澄清再执行",
+        });
+    }
+    return triggers;
+}
+// ── 执行分层 ──
+//# sourceMappingURL=intent_expander.js.map