soloforge 1.1.2 → 1.1.31

package/dist/engine/pipeline/intent_expander/uncertainty_circuit.d.ts

@@ -0,0 +1,33 @@
+/**
+ * intent_expander — uncertainty triggers and circuit breaker.
+ *
+ * The uncertainty protocol identifies risky patterns in intent text and
+ * generates decision triggers. The circuit breaker evaluates overall
+ * confidence and can produce a brainstorm output when confidence is low.
+ */
+import type { ClassifyResult, KnowledgeEntry, UncertaintyTrigger } from "../../../types/index.js";
+import type { CircuitBreakerResult } from "./types.js";
+export declare const UNCERTAINTY_PATTERNS: Array<{
+    pattern: RegExp;
+    trigger_type: string;
+    description: string;
+    options: Array<{
+        label: string;
+        tradeoff: string;
+    }>;
+    recommendation: string;
+}>;
+export declare function buildUncertaintyTriggers(classification: ClassifyResult, intent: string): UncertaintyTrigger[];
+export declare const CONFIDENCE_THRESHOLD = 0.95;
+/**
+ * 意图熔断器 — 评估意图理解置信度，低于阈值时触发熔断并生成头脑风暴辅助决策。
+ * @param params - 熔断器参数，包含意图、分类结果、匹配知识条目和降级标记
+ * @returns 熔断结果，包含是否触发、置信度、原因和头脑风暴输出
+ */
+export declare function checkCircuitBreaker(params: {
+    intent: string;
+    classification: ClassifyResult;
+    matchedEntries: KnowledgeEntry[];
+    degraded: boolean;
+}): CircuitBreakerResult;
+//# sourceMappingURL=uncertainty_circuit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uncertainty_circuit.d.ts","sourceRoot":"","sources":["../../../../src/engine/pipeline/intent_expander/uncertainty_circuit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,cAAc,EAAE,MAAM,CAAC;CACxB,CAiFA,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA2B7G;AAID,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,oBAAoB,CAsCvB"}

package/dist/engine/pipeline/intent_expander/uncertainty_circuit.js

@@ -0,0 +1,187 @@
+/**
+ * intent_expander — uncertainty triggers and circuit breaker.
+ *
+ * The uncertainty protocol identifies risky patterns in intent text and
+ * generates decision triggers. The circuit breaker evaluates overall
+ * confidence and can produce a brainstorm output when confidence is low.
+ */
+import { extractKeywords } from "./helpers.js";
+// ── 能力 4: 不确定性协议 ──
+export 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: "传输+存储均加密",
+    },
+];
+export 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;
+}
+// ── 机制 1: 意图熔断器 ──
+export const CONFIDENCE_THRESHOLD = 0.95;
+/**
+ * 意图熔断器 — 评估意图理解置信度，低于阈值时触发熔断并生成头脑风暴辅助决策。
+ * @param params - 熔断器参数，包含意图、分类结果、匹配知识条目和降级标记
+ * @returns 熔断结果，包含是否触发、置信度、原因和头脑风暴输出
+ */
+export function checkCircuitBreaker(params) {
+    const { intent, classification, matchedEntries, degraded } = params;
+    let confidence = 1.0;
+    if (degraded || matchedEntries.length === 0) {
+        confidence -= 0.35;
+    }
+    else if (matchedEntries.length < 2) {
+        confidence -= 0.15;
+    }
+    if (classification.ambiguity === "high") {
+        confidence -= 0.35;
+    }
+    else if (classification.ambiguity === "medium") {
+        confidence -= 0.15;
+    }
+    const keywords = extractKeywords(intent);
+    if (keywords.length < 2) {
+        confidence -= 0.20;
+    }
+    else if (keywords.length < 3) {
+        confidence -= 0.10;
+    }
+    // degraded 已在上方扣除 -0.35，此处不重复扣分
+    confidence = Math.max(0, Math.min(1, confidence));
+    if (confidence < CONFIDENCE_THRESHOLD) {
+        return {
+            tripped: true,
+            confidence,
+            reason: `意图置信度 ${confidence.toFixed(2)} 低于阈值 ${CONFIDENCE_THRESHOLD}`,
+            brainstorm: generateBrainstorm(intent, classification, matchedEntries),
+        };
+    }
+    return { tripped: false, confidence };
+}
+function generateBrainstorm(_intent, classification, _matchedEntries) {
+    const taskLabel = classification.task_type === "feature" ? "新功能" :
+        classification.task_type === "bugfix" ? "缺陷修复" :
+            classification.task_type === "refactor" ? "重构" : "任务";
+    return {
+        blind_spots: [
+            `【${taskLabel}】是否存在未声明的隐性依赖？`,
+            `执行后是否有副作用波及非目标模块？`,
+            `极端场景（空数据/并发/超量）是否有防护？`,
+        ],
+        evolution_tracks: {
+            minimal: "极简验证路径: 最小可运行实现 + 核心断言验证",
+            industrial: "工业级标准路径: 完整实现 + 边界测试 + 异常处理 + 日志埋点",
+            radical: "激进重构路径: 重新审视现有架构，考虑是否需结构级调整",
+        },
+        decision_questions: [
+            {
+                question: "优先交付速度还是健壮性？",
+                option_a: "极简路径 — 快速验证核心逻辑",
+                option_b: "工业级路径 — 含完整边界和异常处理",
+            },
+            {
+                question: "实现范围是否需要扩大？",
+                option_a: "限定当前声明范围，后续迭代补充",
+                option_b: "现在就处理关联模块，避免技术债积累",
+            },
+        ],
+    };
+}
+//# sourceMappingURL=uncertainty_circuit.js.map

package/dist/engine/pipeline/intent_expander/uncertainty_circuit.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * 重导出桶文件 — 保持原始导入路径
+ * `from "../pipeline/intent_expander.js"` 对所有消费者可用。
+ */
+export { expand } from "./intent_expander/expand.js";
+export type { ExpandInput, PlanContext, CircuitBreakerResult, BrainstormOutput, BlockedResultOptions } from "./intent_expander/types.js";
+export { checkCircuitBreaker } from "./intent_expander/uncertainty_circuit.js";
+export { inferScopeFromIntentAndConfig } from "./intent_expander/helpers.js";
+export { queryKnowledgeForRoute, loadBuiltinByPipeline } from "./intent_expander/knowledge.js";
+//# sourceMappingURL=intent_expander.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent_expander.d.ts","sourceRoot":"","sources":["../../../src/engine/pipeline/intent_expander.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAGrD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGzI,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAG/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAG7E,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/engine/pipeline/intent_expander.js

@@ -0,0 +1,13 @@
+/**
+ * 重导出桶文件 — 保持原始导入路径
+ * `from "../pipeline/intent_expander.js"` 对所有消费者可用。
+ */
+// ── 主函数 ──
+export { expand } from "./intent_expander/expand.js";
+// ── 熔断器 ──
+export { checkCircuitBreaker } from "./intent_expander/uncertainty_circuit.js";
+// ── 范围推断 ──
+export { inferScopeFromIntentAndConfig } from "./intent_expander/helpers.js";
+// ── 知识查询 ──
+export { queryKnowledgeForRoute, loadBuiltinByPipeline } from "./intent_expander/knowledge.js";
+//# sourceMappingURL=intent_expander.js.map

package/dist/engine/pipeline/intent_expander.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent_expander.js","sourceRoot":"","sources":["../../../src/engine/pipeline/intent_expander.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAKrD,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAE/E,aAAa;AACb,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAE7E,aAAa;AACb,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/engine/pipeline/intent_route_scorer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 意图路由评分器 — 根据结构化信号和材料打分，确定路由。
+ *
+ * 不再依赖单条整句正则，而是通过信号提取 → 归一化 → 打分 → 冲突仲裁。
+ * 支持乱序表达、路径不在句首、中文标点、换行、多空格。
+ */
+import type { ArtifactKind } from "../contracts/artifact_contract_registry.js";
+import type { MaterialExtractionResult } from "./input_material_extractor.js";
+import type { IntentSignals } from "./intent_signal_extractor.js";
+export type { IntentRoute, ExecutionShape } from "./route_types.js";
+import type { IntentRoute, ExecutionShape } from "./route_types.js";
+export interface RouteScore {
+    route: IntentRoute;
+    execution_shape: ExecutionShape;
+    mutation_allowed: boolean;
+    confidence: number;
+    reason: string;
+    evidence: string[];
+}
+export interface ScoredRouteResult {
+    route: IntentRoute;
+    execution_shape: ExecutionShape;
+    mutation_allowed: boolean;
+    confidence: number;
+    needs_clarification: boolean;
+    route_reason: string;
+    signal_evidence: string[];
+    skip_reason?: string;
+    /** 评分明细 */
+    score_breakdown: Array<{
+        route: IntentRoute;
+        score: number;
+        reasons: string[];
+    }>;
+    /** 输出产物 */
+    artifact?: {
+        kind: ArtifactKind | "unknown";
+        defaultName: string;
+        template?: string;
+    };
+    /** 流水线提示 */
+    pipeline_hint?: string;
+}
+export declare function scoreRoute(intent: string, signals: IntentSignals, materials: MaterialExtractionResult, taskId?: string): ScoredRouteResult;
+//# sourceMappingURL=intent_route_scorer.d.ts.map

package/dist/engine/pipeline/intent_route_scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent_route_scorer.d.ts","sourceRoot":"","sources":["../../../src/engine/pipeline/intent_route_scorer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,8BAA8B,CAAC;AAKlF,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,eAAe,EAAE,cAAc,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,eAAe,EAAE,cAAc,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,eAAe,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACjF,WAAW;IACX,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;QAC/B,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA8DD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,wBAAwB,EACnC,MAAM,CAAC,EAAE,MAAM,GACd,iBAAiB,CA8SnB"}

package/dist/engine/pipeline/intent_route_scorer.js

@@ -0,0 +1,341 @@
+/**
+ * 意图路由评分器 — 根据结构化信号和材料打分，确定路由。
+ *
+ * 不再依赖单条整句正则，而是通过信号提取 → 归一化 → 打分 → 冲突仲裁。
+ * 支持乱序表达、路径不在句首、中文标点、换行、多空格。
+ */
+import { findArtifactAlias, getArtifactAliases } from "./intent_signal_extractor.js";
+// ── 路由 → 分数映射 ──
+function hasAction(signals, cat) {
+    return signals.actions.some((a) => a.category === cat);
+}
+function hasArtifactKind(signals) {
+    return signals.artifacts.length > 0;
+}
+function hasNegation(signals, target) {
+    return signals.negations.some((n) => n.negates === target);
+}
+function hasConstraint(signals, type) {
+    return signals.constraints.some((c) => c.type === type);
+}
+function detectArtifactFromSignals(signals) {
+    for (const sig of signals.artifacts) {
+        const alias = findArtifactAlias(sig.kind);
+        if (alias) {
+            return { kind: alias.kind, defaultName: alias.defaultName, template: alias.template };
+        }
+    }
+    return undefined;
+}
+function detectGenericArtifact(intent, _taskId) {
+    for (const alias of getArtifactAliases()) {
+        if (alias.patterns.some((p) => p.test(intent))) {
+            return { kind: alias.kind, defaultName: alias.defaultName, template: alias.template };
+        }
+    }
+    if (/(?:文档|方案|规约|计划|清单|报告|说明文档)$/.test(intent)) {
+        const match = intent.match(/([一-龥]+(?:文档|方案|规约|计划|清单|报告|说明文档))$/);
+        const name = match ? match[1] : "产物";
+        return { kind: "unknown", defaultName: name };
+    }
+    return undefined;
+}
+function inferPipelineHint(intent, artifactKind) {
+    if (/源码.*原型|原型.*源码|源码包.*原型|prototype/i.test(intent)) {
+        return "source-prototype-to-delivery:step-1";
+    }
+    if (/从.*(?:设计|需求|原型).*到.*(?:交付|完成)/.test(intent)) {
+        return "source-prototype-to-delivery";
+    }
+    switch (artifactKind) {
+        case "prototype_spec": return "source-prototype-to-delivery:step-1";
+        case "api_spec": return "source-prototype-to-delivery:step-4";
+        case "design_doc": return "source-prototype-to-delivery:step-3";
+        case "test_plan": return "source-prototype-to-delivery:step-5";
+        default: return undefined;
+    }
+}
+// ── 主评分函数 ──
+export function scoreRoute(intent, signals, materials, taskId) {
+    const scores = [];
+    const evidence = [];
+    const hasPaths = materials.materials.length > 0;
+    // ── 1. 跳过评分 ──
+    if (signals.is_skip) {
+        scores.push({ route: "skip_chat", score: 100, reasons: [`skip_detected:${signals.skip_reason}`] });
+        evidence.push(`skip:${signals.skip_reason}`);
+    }
+    // ── 2. 通用问答 ──
+    if (signals.is_general_qa) {
+        scores.push({ route: "direct_answer", score: 90, reasons: ["general_qa_pattern"] });
+        evidence.push("general_qa");
+    }
+    // ── 3. 源码提取评分 ──
+    const hasSourceMaterial = signals.source_material_kinds.length > 0;
+    const hasExtractAction = hasAction(signals, "extract");
+    const hasExtractionVerb = signals.has_extraction_structure;
+    const hasSourceSignal = hasSourceMaterial || (hasExtractionVerb && (hasPaths || /源码/.test(intent)));
+    const hasArtifactVerb = hasAction(signals, "generate") || hasExtractAction;
+    const artifactFromSignals = detectArtifactFromSignals(signals);
+    const artifactGeneric = detectGenericArtifact(intent, taskId);
+    const artifact = artifactFromSignals ?? artifactGeneric;
+    const hasArtifactNoun = hasArtifactKind(signals) || !!artifactGeneric;
+    const hasArtifactVerbAndNoun = hasArtifactVerb && hasArtifactNoun;
+    if (hasSourceSignal && (hasArtifactVerbAndNoun || artifact)) {
+        const mutationBlocked = hasNegation(signals, "mutation") || hasConstraint(signals, "no_mutation");
+        const s = mutationBlocked ? 95 : 85;
+        scores.push({
+            route: "source_extraction",
+            score: s,
+            reasons: [
+                hasSourceMaterial ? `source_material:${signals.source_material_kinds.join(",")}` : "extraction_structure",
+                hasExtractAction ? "extract_action" : "extraction_verb",
+                artifact ? `artifact:${artifact.kind}` : "no_artifact",
+                mutationBlocked ? "mutation_blocked" : "",
+            ].filter(Boolean),
+        });
+        evidence.push(`source_extraction:${hasSourceMaterial ? "material" : "structure"}`);
+    }
+    // ── 4. 规划评分 ──
+    if (hasAction(signals, "plan")) {
+        const pipelineBlocked = hasNegation(signals, "pipeline") || hasConstraint(signals, "no_pipeline");
+        if (signals.has_full_pipeline && !pipelineBlocked) {
+            scores.push({ route: "planning", score: 88, reasons: ["plan_action", "full_pipeline"] });
+            evidence.push("planning:multi_stage");
+        }
+        else {
+            scores.push({ route: "planning", score: 82, reasons: ["plan_action"] });
+            evidence.push("planning:single");
+        }
+    }
+    // ── 5. 操作评分 ──
+    if (hasAction(signals, "operate")) {
+        scores.push({ route: "operation", score: 82, reasons: ["operate_action"] });
+        evidence.push("operation");
+    }
+    // ── 6. 分析评分 ──
+    if (hasAction(signals, "analyze") && !hasArtifactVerb) {
+        scores.push({ route: "analysis", score: 80, reasons: ["analyze_action", "no_artifact_verb"] });
+        evidence.push("analysis");
+    }
+    // ── 7. 产物生成评分 ──
+    if (hasArtifactVerbAndNoun || (hasArtifactVerb && artifact && !signals.is_pure_explain)) {
+        if (!hasSourceSignal) {
+            scores.push({
+                route: "artifact_generation",
+                score: 80,
+                reasons: ["artifact_verb+noun", artifact ? `artifact:${artifact.kind}` : ""].filter(Boolean),
+            });
+            evidence.push("artifact_generation");
+        }
+    }
+    // ── 8. 代码修改评分 ──
+    if (hasAction(signals, "code_change")) {
+        scores.push({ route: "code_change", score: 85, reasons: ["code_change_action"] });
+        evidence.push("code_change");
+    }
+    // ── 9. 审查评分 ──
+    if (hasAction(signals, "review")) {
+        scores.push({ route: "review", score: 85, reasons: ["review_action"] });
+        evidence.push("review");
+    }
+    // ── 10. 验收/就绪检查评分 ──
+    if (hasAction(signals, "acceptance")) {
+        const hasImplementationVerb = /修复|实现|开发|新增|添加|修改|变更|重构|删除|移除|替换|补(?:单元)?测试|写测试|编码/.test(intent);
+        if (!hasImplementationVerb && !hasArtifactVerb) {
+            scores.push({ route: "acceptance", score: 92, reasons: ["acceptance_action", "read_only_readiness"] });
+            evidence.push("acceptance");
+        }
+        else {
+            scores.push({ route: "acceptance", score: 65, reasons: ["acceptance_action", "implementation_or_artifact_present"] });
+        }
+    }
+    // ── 11. 通用分析（低优先） ──
+    if (hasAction(signals, "analyze")) {
+        const alreadyScored = scores.some((s) => s.route === "analysis");
+        if (!alreadyScored) {
+            scores.push({ route: "analysis", score: 70, reasons: ["analyze_action_fallback"] });
+            evidence.push("analysis:fallback");
+        }
+    }
+    // ── 12. 灰区 ──
+    if (signals.gray_zone === "organize" && !hasArtifactNoun) {
+        scores.push({ route: "direct_answer", score: 60, reasons: ["gray_zone:organize_no_artifact"] });
+        evidence.push("gray:organize");
+    }
+    if (signals.gray_zone === "look") {
+        if (/风险|问题|有没有/.test(intent)) {
+            scores.push({ route: "review", score: 70, reasons: ["gray_zone:look+risk"] });
+            evidence.push("gray:review");
+        }
+        else {
+            scores.push({ route: "direct_answer", score: 55, reasons: ["gray_zone:look"] });
+            evidence.push("gray:look");
+        }
+    }
+    // ── 13. 纯解释 ──
+    if (signals.is_pure_explain) {
+        if (/(?:这个|这|项目里|项目中的|当前|现有)/.test(intent)) {
+            scores.push({ route: "analysis", score: 70, reasons: ["pure_explain+context"] });
+            evidence.push("explain:analysis");
+        }
+        else {
+            scores.push({ route: "direct_answer", score: 85, reasons: ["pure_explain"] });
+            evidence.push("explain:direct");
+        }
+    }
+    // ── 选择最高分路由 ──
+    scores.sort((a, b) => b.score - a.score);
+    const winner = scores[0];
+    // ── 兜底 ──
+    if (!winner) {
+        return {
+            route: "direct_answer",
+            execution_shape: "none",
+            mutation_allowed: false,
+            confidence: 0.3,
+            needs_clarification: false,
+            route_reason: "no_matching_signal",
+            signal_evidence: [],
+            score_breakdown: [],
+        };
+    }
+    // ── 确定执行形态 ──
+    let executionShape;
+    let mutationAllowed;
+    let needsClarification = false;
+    const routeReason = winner.reasons.join(", ");
+    switch (winner.route) {
+        case "skip_chat":
+        case "direct_answer":
+            executionShape = "none";
+            mutationAllowed = false;
+            break;
+        case "source_extraction":
+            executionShape = "single_artifact";
+            mutationAllowed = false; // source_extraction 永远不允许 mutation
+            break;
+        case "artifact_generation":
+            executionShape = "single_artifact";
+            mutationAllowed = false;
+            break;
+        case "code_change":
+            executionShape = "code_execution";
+            mutationAllowed = hasNegation(signals, "mutation") ? false : true;
+            break;
+        case "analysis":
+            executionShape = "read_only_analysis";
+            mutationAllowed = false;
+            break;
+        case "review":
+            executionShape = "read_only_analysis";
+            mutationAllowed = false;
+            break;
+        case "acceptance":
+            executionShape = "read_only_analysis";
+            mutationAllowed = false;
+            break;
+        case "planning":
+            executionShape = signals.has_full_pipeline && !hasNegation(signals, "pipeline") ? "multi_stage_plan" : "single_artifact";
+            mutationAllowed = false;
+            break;
+        case "operation":
+            executionShape = "verification_only";
+            mutationAllowed = false;
+            break;
+        default:
+            executionShape = "none";
+            mutationAllowed = false;
+    }
+    // ── 低置信策略：有材料+动作但不 skip ──
+    const lowConfidenceButHasMaterial = (hasPaths || materials.inferred.length > 0) && hasArtifactVerb;
+    if (winner.route === "direct_answer" && lowConfidenceButHasMaterial && !signals.is_skip && !signals.is_pure_explain && !signals.is_general_qa) {
+        // 升级到 source_extraction 或 artifact_generation 而非 skip
+        if (hasPaths) {
+            return {
+                route: "source_extraction",
+                execution_shape: "single_artifact",
+                mutation_allowed: false,
+                confidence: 0.6,
+                needs_clarification: true,
+                route_reason: "upgraded_from_low_confidence_with_material",
+                signal_evidence: evidence,
+                score_breakdown: scores,
+                skip_reason: undefined,
+                artifact: artifact ?? { kind: "custom", defaultName: "提取产物" },
+                pipeline_hint: inferPipelineHint(intent, artifact?.kind),
+            };
+        }
+    }
+    // ── 缺路径 clarification ──
+    if ((winner.route === "source_extraction" || winner.route === "artifact_generation") && !hasPaths) {
+        needsClarification = true;
+    }
+    // ── 根据 PRD/需求 引用补充 missing ──
+    if (winner.route === "artifact_generation" && !hasPaths) {
+        if (/根据\s*(?:PRD|需求文档|原型|接口文档|设计文档|源码)/i.test(intent)) {
+            needsClarification = true;
+        }
+    }
+    // ── 冲突仲裁："从源码包提取原型说明，不要修改代码" ──
+    // source_extraction + code_change 动作 → source_extraction, mutation=false
+    if (hasSourceSignal && hasAction(signals, "code_change") && hasNegation(signals, "mutation")) {
+        if (winner.route !== "source_extraction") {
+            // 强制降级为 source_extraction
+            const seScore = scores.find((s) => s.route === "source_extraction");
+            if (seScore) {
+                return {
+                    route: "source_extraction",
+                    execution_shape: "single_artifact",
+                    mutation_allowed: false,
+                    confidence: seScore.score / 100,
+                    needs_clarification: needsClarification,
+                    route_reason: "conflict_arbitration:source_extraction_over_code_change",
+                    signal_evidence: evidence,
+                    score_breakdown: scores,
+                    skip_reason: undefined,
+                    artifact,
+                    pipeline_hint: inferPipelineHint(intent, artifact?.kind),
+                };
+            }
+        }
+    }
+    // ── 冲突仲裁："从 UserService 提取公共方法" 无外部材料 → code_change ──
+    if (hasExtractionVerb && !hasSourceSignal && !hasPaths && hasAction(signals, "code_change")) {
+        if (winner.route === "source_extraction") {
+            // 降级为 code_change
+            const ccScore = scores.find((s) => s.route === "code_change");
+            if (ccScore) {
+                return {
+                    route: "code_change",
+                    execution_shape: "code_execution",
+                    mutation_allowed: true,
+                    confidence: ccScore.score / 100,
+                    needs_clarification: false,
+                    route_reason: "conflict_arbitration:code_change_over_extraction_no_material",
+                    signal_evidence: evidence,
+                    score_breakdown: scores,
+                    skip_reason: undefined,
+                    artifact: undefined,
+                    pipeline_hint: undefined,
+                };
+            }
+        }
+    }
+    return {
+        route: winner.route,
+        execution_shape: executionShape,
+        mutation_allowed: mutationAllowed,
+        confidence: winner.score / 100,
+        needs_clarification: needsClarification,
+        route_reason: routeReason,
+        signal_evidence: evidence,
+        score_breakdown: scores,
+        skip_reason: winner.route === "skip_chat" ? signals.skip_reason : undefined,
+        artifact,
+        pipeline_hint: ["source_extraction", "artifact_generation", "planning"].includes(winner.route)
+            ? inferPipelineHint(intent, artifact?.kind)
+            : undefined,
+    };
+}
+//# sourceMappingURL=intent_route_scorer.js.map