soloforge 1.1.2 → 1.2.1

package/dist/engine/llm_gateway.d.ts

@@ -0,0 +1,96 @@
+/**
+ * LLM 统一网关 — 控制流零 AI 依赖，决策节点强 AI 依赖。
+ *
+ * 职责:
+ * 1. 定义 AI 依赖边界: 明确哪些操作需要 LLM 算力，哪些可以本地完成
+ * 2. Token 消耗监控: 按 operation_type 估算和追踪 Token 用量
+ * 3. 硬熔断: 超过 Token 预算上限时拦截后续 AI 调用
+ * 4. 调用审计: 记录每次 AI 调用的类型、Token 估算和耗时
+ * 5. 单任务阈值: 单次任务 Token 支出超过阈值时强制熔断
+ * 6. 流式心跳: 重型推演(>10s)期间每5秒发送进度，防止客户端超时断连
+ */
+/** AI 操作类型分级 */
+export type AIOperationTier = "light" | "medium" | "heavy";
+/** AI 依赖的操作类型 */
+export type AIOperationType = "intent_refinement" | "solution_brainstorm" | "verification_reasoning" | "code_generation" | "test_generation" | "review_deep_analysis" | "debug_analysis";
+/** 操作类型配置: 级别 + Token 估算 */
+interface OperationProfile {
+    tier: AIOperationTier;
+    estimated_tokens: number;
+    description: string;
+}
+/** 调用审计记录 */
+export interface GatewayAuditEntry {
+    operation: AIOperationType;
+    estimated_tokens: number;
+    timestamp: string;
+    blocked: boolean;
+    task_id?: string;
+}
+/** 网关状态快照 */
+export interface GatewayStatus {
+    budget_total: number;
+    budget_used: number;
+    budget_remaining: number;
+    usage_ratio: number;
+    circuit_open: boolean;
+    call_count: number;
+    blocked_count: number;
+    task_tokens_used: number;
+    audit_log: GatewayAuditEntry[];
+}
+/** 心跳进度回调 */
+export type HeartbeatCallback = (progress: {
+    elapsed_ms: number;
+    tokens_used: number;
+    operation: AIOperationType;
+    message: string;
+}) => void;
+export declare class LLMGateway {
+    private budgetTotal;
+    private budgetUsed;
+    private taskBudget;
+    private taskTokensUsed;
+    private currentTaskId;
+    private callCount;
+    private blockedCount;
+    private auditLog;
+    private circuitOpen;
+    private heartbeatTimer;
+    private heartbeatCallback;
+    private operationStart;
+    private currentOperation;
+    private config;
+    constructor(budget?: number, taskBudget?: number);
+    /** 设置心跳回调（用于 stdio 输出进度） */
+    setHeartbeatCallback(cb: HeartbeatCallback): void;
+    /** 开始新任务的 Token 计量 */
+    beginTask(taskId: string): void;
+    /** 结束任务计量 */
+    endTask(): void;
+    request(operation: AIOperationType, taskId?: string): {
+        allowed: boolean;
+        estimated_tokens: number;
+        remaining_budget: number;
+        remaining_task_budget: number;
+        reason?: string;
+    };
+    /** 置信度闸口: 低于阈值禁止执行代码，必须调用 sf_brainstorm */
+    confidenceGate(confidence: number): {
+        allowed: boolean;
+        threshold: number;
+        reason?: string;
+    };
+    /** 标记操作完成，停止心跳 */
+    completeOperation(): void;
+    reportActualUsage(operation: AIOperationType, actualTokens: number): void;
+    getStatus(): GatewayStatus;
+    reset(budget?: number): void;
+    static isLocalOperation(op: string): boolean;
+    static isAIOperation(op: AIOperationType): boolean;
+    static getProfile(op: AIOperationType): OperationProfile;
+    private startHeartbeat;
+    private stopHeartbeat;
+}
+export {};
+//# sourceMappingURL=llm_gateway.d.ts.map

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

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

package/dist/engine/llm_gateway.js

@@ -0,0 +1,220 @@
+import { loadKnowledgeConfig, extractNumberRule } from "./knowledge_config_loader.js";
+// ── 操作配置表 ──
+const OPERATION_PROFILES = {
+    intent_refinement: { tier: "medium", estimated_tokens: 2000, description: "意图理解深化" },
+    solution_brainstorm: { tier: "heavy", estimated_tokens: 4000, description: "方案脑暴推演" },
+    verification_reasoning: { tier: "heavy", estimated_tokens: 3000, description: "复杂验证推理" },
+    code_generation: { tier: "heavy", estimated_tokens: 5000, description: "代码生成" },
+    test_generation: { tier: "medium", estimated_tokens: 3000, description: "测试用例生成" },
+    review_deep_analysis: { tier: "heavy", estimated_tokens: 4000, description: "深度审查分析" },
+    debug_analysis: { tier: "medium", estimated_tokens: 2500, description: "排障推理" },
+};
+/** 从知识库 decision_gateway.md 读取阈值，文件不存在时使用硬编码兜底 */
+function loadGatewayConfig(projectPath) {
+    const config = loadKnowledgeConfig("patterns/core/decision_gateway.md", projectPath);
+    const body = config?.body ?? "";
+    return {
+        budget_total: extractNumberRule(body, "Budget_Total") ?? 100_000,
+        task_budget: extractNumberRule(body, "Task_Budget") ?? 30_000,
+        circuit_breaker_ratio: extractNumberRule(body, "Circuit_Breaker_Ratio") ?? 0.9,
+        heartbeat_interval: extractNumberRule(body, "Heartbeat_Interval") ?? 5000,
+        confidence_threshold: extractNumberRule(body, "Confidence_Threshold") ?? 0.95,
+    };
+}
+const DEFAULT_CONFIG = loadGatewayConfig();
+// ── 网关核心 ──
+export class LLMGateway {
+    budgetTotal;
+    budgetUsed = 0;
+    taskBudget;
+    taskTokensUsed = 0;
+    currentTaskId = null;
+    callCount = 0;
+    blockedCount = 0;
+    auditLog = [];
+    circuitOpen = false;
+    heartbeatTimer = null;
+    heartbeatCallback = null;
+    operationStart = 0;
+    currentOperation = null;
+    config = DEFAULT_CONFIG;
+    constructor(budget, taskBudget) {
+        this.budgetTotal = budget ?? this.config.budget_total;
+        this.taskBudget = taskBudget ?? this.config.task_budget;
+    }
+    /** 设置心跳回调（用于 stdio 输出进度） */
+    setHeartbeatCallback(cb) {
+        this.heartbeatCallback = cb;
+    }
+    /** 开始新任务的 Token 计量 */
+    beginTask(taskId) {
+        this.currentTaskId = taskId;
+        this.taskTokensUsed = 0;
+    }
+    /** 结束任务计量 */
+    endTask() {
+        this.currentTaskId = null;
+        this.taskTokensUsed = 0;
+        this.stopHeartbeat();
+    }
+    request(operation, taskId) {
+        const profile = OPERATION_PROFILES[operation];
+        const tid = taskId ?? this.currentTaskId ?? undefined;
+        const entry = {
+            operation,
+            estimated_tokens: profile.estimated_tokens,
+            timestamp: new Date().toISOString(),
+            blocked: false,
+            task_id: tid,
+        };
+        // 单任务阈值检查
+        if (this.taskTokensUsed + profile.estimated_tokens > this.taskBudget) {
+            this.blockedCount++;
+            entry.blocked = true;
+            this.auditLog.push(entry);
+            return {
+                allowed: false,
+                estimated_tokens: profile.estimated_tokens,
+                remaining_budget: this.budgetTotal - this.budgetUsed,
+                remaining_task_budget: this.taskBudget - this.taskTokensUsed,
+                reason: `单任务 Token 阈值触发: 当前任务已使用 ${this.taskTokensUsed}/${this.taskBudget}，${profile.description} 需要 ~${profile.estimated_tokens}。建议拆分任务或减少范围`,
+            };
+        }
+        // 全局熔断检查
+        if (this.circuitOpen || (this.budgetUsed / this.budgetTotal) >= this.config.circuit_breaker_ratio) {
+            this.circuitOpen = true;
+            this.blockedCount++;
+            entry.blocked = true;
+            this.auditLog.push(entry);
+            return {
+                allowed: false,
+                estimated_tokens: profile.estimated_tokens,
+                remaining_budget: this.budgetTotal - this.budgetUsed,
+                remaining_task_budget: this.taskBudget - this.taskTokensUsed,
+                reason: `Token 预告警: 已使用 ${this.budgetUsed}/${this.budgetTotal}（${((this.budgetUsed / this.budgetTotal) * 100).toFixed(0)}%）。${profile.description} 需要 ~${profile.estimated_tokens} Token，超出安全阈值`,
+            };
+        }
+        if (this.budgetUsed + profile.estimated_tokens > this.budgetTotal) {
+            this.blockedCount++;
+            entry.blocked = true;
+            this.auditLog.push(entry);
+            return {
+                allowed: false,
+                estimated_tokens: profile.estimated_tokens,
+                remaining_budget: this.budgetTotal - this.budgetUsed,
+                remaining_task_budget: this.taskBudget - this.taskTokensUsed,
+                reason: `Token 预算不足: 剩余 ${this.budgetTotal - this.budgetUsed}，需要 ~${profile.estimated_tokens}`,
+            };
+        }
+        this.budgetUsed += profile.estimated_tokens;
+        this.taskTokensUsed += profile.estimated_tokens;
+        this.callCount++;
+        this.auditLog.push(entry);
+        // 重型操作启动心跳
+        if (profile.tier === "heavy") {
+            this.startHeartbeat(operation);
+        }
+        return {
+            allowed: true,
+            estimated_tokens: profile.estimated_tokens,
+            remaining_budget: this.budgetTotal - this.budgetUsed,
+            remaining_task_budget: this.taskBudget - this.taskTokensUsed,
+        };
+    }
+    /** 置信度闸口: 低于阈值禁止执行代码，必须调用 sf_brainstorm */
+    confidenceGate(confidence) {
+        const threshold = this.config.confidence_threshold;
+        if (confidence < threshold) {
+            return {
+                allowed: false,
+                threshold,
+                reason: `置信度 ${confidence.toFixed(2)} 低于阈值 ${threshold}，禁止直接输出执行代码，必须调用 sf_brainstorm 展示三轨方案`,
+            };
+        }
+        return { allowed: true, threshold };
+    }
+    /** 标记操作完成，停止心跳 */
+    completeOperation() {
+        this.stopHeartbeat();
+        this.currentOperation = null;
+    }
+    reportActualUsage(operation, actualTokens) {
+        const profile = OPERATION_PROFILES[operation];
+        const diff = actualTokens - profile.estimated_tokens;
+        if (diff > 0) {
+            this.budgetUsed += diff;
+            this.taskTokensUsed += diff;
+            if ((this.budgetUsed / this.budgetTotal) >= this.config.circuit_breaker_ratio) {
+                this.circuitOpen = true;
+            }
+        }
+        else {
+            this.budgetUsed = Math.max(0, this.budgetUsed + diff);
+            this.taskTokensUsed = Math.max(0, this.taskTokensUsed + diff);
+        }
+    }
+    getStatus() {
+        return {
+            budget_total: this.budgetTotal,
+            budget_used: this.budgetUsed,
+            budget_remaining: this.budgetTotal - this.budgetUsed,
+            usage_ratio: this.budgetUsed / this.budgetTotal,
+            circuit_open: this.circuitOpen,
+            call_count: this.callCount,
+            blocked_count: this.blockedCount,
+            task_tokens_used: this.taskTokensUsed,
+            audit_log: [...this.auditLog],
+        };
+    }
+    reset(budget) {
+        this.budgetTotal = budget ?? this.config.budget_total;
+        this.budgetUsed = 0;
+        this.callCount = 0;
+        this.blockedCount = 0;
+        this.auditLog = [];
+        this.circuitOpen = false;
+        this.taskTokensUsed = 0;
+        this.stopHeartbeat();
+    }
+    static isLocalOperation(op) {
+        const LOCAL_OPS = [
+            "classify", "scope_resolve", "knowledge_match", "pattern_extract",
+            "drift_detect", "mutation_test", "coverage_scan", "dependency_scan",
+            "migration_check", "contract_check", "debt_scan", "build_run",
+        ];
+        return LOCAL_OPS.includes(op);
+    }
+    static isAIOperation(op) {
+        return op in OPERATION_PROFILES;
+    }
+    static getProfile(op) {
+        return OPERATION_PROFILES[op];
+    }
+    // ── 流式心跳 ──
+    startHeartbeat(operation) {
+        this.stopHeartbeat();
+        this.operationStart = Date.now();
+        this.currentOperation = operation;
+        if (!this.heartbeatCallback)
+            return;
+        this.heartbeatTimer = setInterval(() => {
+            if (!this.heartbeatCallback || !this.currentOperation)
+                return;
+            const elapsed = Date.now() - this.operationStart;
+            const profile = OPERATION_PROFILES[this.currentOperation];
+            this.heartbeatCallback({
+                elapsed_ms: elapsed,
+                tokens_used: this.taskTokensUsed,
+                operation: this.currentOperation,
+                message: `[SoloForge Heartbeat] ${profile.description} 执行中... 已耗时 ${(elapsed / 1000).toFixed(0)}s，当前任务已用 ${this.taskTokensUsed}/${this.taskBudget} Token`,
+            });
+        }, this.config.heartbeat_interval);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=llm_gateway.js.map

package/dist/engine/llm_gateway.js.map

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

package/dist/engine/test_quality.d.ts

@@ -12,5 +12,19 @@ import type { TestQualityReport } from "../types.js";
  * @param sourceContent - 可选的被测源码内容（用于变异测试）
  * @returns 测试质量报告，包含总分(0-100)、各项检查结果和改进建议列表
  */
-export declare function analyzeTestQuality(testContent: string, filename: string, sourceContent?: string): TestQualityReport;
+export declare function analyzeTestQuality(testContent: string, filename: string, sourceContent?: string, coverageMap?: CoverageMap, sourceFilePath?: string): TestQualityReport;
+/** lcov 报告解析结果: 文件路径 → 已覆盖行号集合 */
+export type CoverageMap = Map<string, Set<number>>;
+/**
+ * 解析 lcov.info 报告，提取每个文件的已覆盖行号。
+ * lcov 格式:
+ *   SF:path/to/file.ts
+ *   DA:10,1
+ *   DA:25,0
+ *   end_of_record
+ * DA 行中第二个字段 > 0 表示该行被执行过（已覆盖）。
+ * @param lcovContent - lcov.info 文件内容
+ * @returns 覆盖率映射（文件路径 → 已覆盖行号集合）
+ */
+export declare function parseLcov(lcovContent: string): CoverageMap;
 //# sourceMappingURL=test_quality.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"test_quality.d.ts","sourceRoot":"","sources":["../../src/engine/test_quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAqEnB"}
+{"version":3,"file":"test_quality.d.ts","sourceRoot":"","sources":["../../src/engine/test_quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGvE;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,WAAW,EACzB,cAAc,CAAC,EAAE,MAAM,GACtB,iBAAiB,CAuEnB;AAidD,kCAAkC;AAClC,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAyB1D"}