soloforge 1.1.2 → 1.1.30

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

@@ -0,0 +1,167 @@
+/**
+ * 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;
+    /** 估算 Token 数 */
+    estimated_tokens: number;
+    /** 调用时间戳 */
+    timestamp: string;
+    /** 是否被熔断拦截 */
+    blocked: boolean;
+    /** 关联的任务 ID */
+    task_id?: string;
+}
+/** 网关状态快照 */
+export interface GatewayStatus {
+    /** Token 总预算 */
+    budget_total: number;
+    /** 已使用 Token 数 */
+    budget_used: number;
+    /** 剩余 Token 数 */
+    budget_remaining: number;
+    /** 使用比例 */
+    usage_ratio: number;
+    /** 熔断器是否开启 */
+    circuit_open: boolean;
+    /** 总调用次数 */
+    call_count: number;
+    /** 被拦截次数 */
+    blocked_count: number;
+    /** 当前任务已用 Token */
+    task_tokens_used: number;
+    /** 审计日志 */
+    audit_log: GatewayAuditEntry[];
+}
+/** 心跳进度回调 */
+export type HeartbeatCallback = (progress: {
+    elapsed_ms: number;
+    tokens_used: number;
+    operation: AIOperationType;
+    message: string;
+}) => void;
+/**
+ * LLM 统一网关 — 管理 Token 预算、熔断和调用审计。
+ */
+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;
+    /**
+     * 创建 LLM 网关实例。
+     * @param budget - 可选，Token 总预算，默认从配置读取
+     * @param taskBudget - 可选，单任务 Token 预算，默认从配置读取
+     */
+    constructor(budget?: number, taskBudget?: number);
+    /** 设置心跳回调（用于 stdio 输出进度） */
+    setHeartbeatCallback(cb: HeartbeatCallback): void;
+    /**
+     * 开始新任务的 Token 计量。
+     * @param taskId - 任务 ID
+     */
+    beginTask(taskId: string): void;
+    /** 结束任务计量，停止心跳 */
+    endTask(): void;
+    /**
+     * 请求 AI 操作许可 — 检查 Token 预算和熔断状态。
+     * 被拦截时返回原因说明。
+     *
+     * @param operation - AI 操作类型
+     * @param taskId - 可选的任务 ID
+     * @returns 许可结果，包含是否允许、剩余预算和拦截原因
+     */
+    request(operation: AIOperationType, taskId?: string): {
+        allowed: boolean;
+        estimated_tokens: number;
+        remaining_budget: number;
+        remaining_task_budget: number;
+        reason?: string;
+    };
+    /**
+     * 置信度闸口: 低于阈值禁止执行代码，必须调用 sf_brainstorm。
+     * @param confidence - 当前置信度
+     * @returns 闸口结果，包含是否允许和阈值
+     */
+    confidenceGate(confidence: number): {
+        allowed: boolean;
+        threshold: number;
+        reason?: string;
+    };
+    /** 标记操作完成，停止心跳 */
+    completeOperation(): void;
+    /**
+     * 报告实际 Token 用量 — 根据估算与实际的差值调整预算计数。
+     * 差值为正时增加消耗，为负时回退多计部分。熔断器根据实际消耗重新评估。
+     * @param operation - 操作类型
+     * @param actualTokens - 实际消耗的 Token 数
+     */
+    reportActualUsage(operation: AIOperationType, actualTokens: number): void;
+    /**
+     * 获取网关当前状态快照。
+     * @returns 网关状态，包含预算、调用统计和审计日志
+     */
+    getStatus(): GatewayStatus;
+    /**
+     * 重置网关状态 — 清零所有计数器、审计日志和熔断器。
+     * @param budget - 可选的新 Token 总预算
+     */
+    reset(budget?: number): void;
+    /**
+     * 判断操作是否为本地操作（不需要 LLM 算力）。
+     * @param op - 操作名称
+     * @returns 是否为本地操作
+     */
+    static isLocalOperation(op: string): boolean;
+    /**
+     * 判断操作是否为 AI 操作。
+     * @param op - 操作类型
+     * @returns 是否为 AI 操作
+     */
+    static isAIOperation(op: AIOperationType): boolean;
+    /**
+     * 获取操作类型的配置信息。
+     * @param op - 操作类型
+     * @returns 操作配置（级别、Token 估算、描述）
+     */
+    static getProfile(op: AIOperationType): OperationProfile;
+    /**
+     * 启动流式心跳 — 重型操作期间定期发送进度报告，防止客户端超时断连。
+     * @param operation - 当前 AI 操作类型
+     */
+    private startHeartbeat;
+    /** 停止流式心跳计时器 */
+    private stopHeartbeat;
+}
+export {};
+//# sourceMappingURL=llm_gateway.d.ts.map

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

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

package/dist/engine/core/llm_gateway.js

@@ -0,0 +1,292 @@
+import { loadKnowledgeConfig, extractNumberRule } from "./knowledge_config_loader.js";
+import { debug } from "./logger.js";
+debug("llm_gateway", "LLM 统一网关模块已加载");
+// ── 操作配置表 ──
+/** 各 AI 操作类型的 Token 估算和级别配置 */
+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: "排障推理" },
+};
+/**
+ * 从知识库 决策网关.md 读取阈值，文件不存在时使用硬编码兜底。
+ * @param projectPath - 可选的项目路径
+ * @returns 网关配置参数
+ */
+function loadGatewayConfig(projectPath) {
+    const config = loadKnowledgeConfig("patterns/core/决策网关.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();
+// ── 网关核心 ──
+/**
+ * LLM 统一网关 — 管理 Token 预算、熔断和调用审计。
+ */
+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;
+    /**
+     * 创建 LLM 网关实例。
+     * @param budget - 可选，Token 总预算，默认从配置读取
+     * @param taskBudget - 可选，单任务 Token 预算，默认从配置读取
+     */
+    constructor(budget, taskBudget) {
+        this.budgetTotal = budget ?? this.config.budget_total;
+        this.taskBudget = taskBudget ?? this.config.task_budget;
+    }
+    /** 设置心跳回调（用于 stdio 输出进度） */
+    setHeartbeatCallback(cb) {
+        this.heartbeatCallback = cb;
+    }
+    /**
+     * 开始新任务的 Token 计量。
+     * @param taskId - 任务 ID
+     */
+    beginTask(taskId) {
+        this.currentTaskId = taskId;
+        this.taskTokensUsed = 0;
+        debug("llm_gateway", `任务 ${taskId} 开始，Token 计量已重置`);
+    }
+    /** 结束任务计量，停止心跳 */
+    endTask() {
+        this.currentTaskId = null;
+        this.taskTokensUsed = 0;
+        this.stopHeartbeat();
+    }
+    /**
+     * 请求 AI 操作许可 — 检查 Token 预算和熔断状态。
+     * 被拦截时返回原因说明。
+     *
+     * @param operation - AI 操作类型
+     * @param taskId - 可选的任务 ID
+     * @returns 许可结果，包含是否允许、剩余预算和拦截原因
+     */
+    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);
+            debug("llm_gateway", `单任务 Token 阈值触发 — ${profile.description} 被拦截`);
+            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);
+            debug("llm_gateway", `全局熔断器已开启 — ${profile.description} 被拦截`);
+            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);
+            debug("llm_gateway", `Token 预算不足 — ${profile.description} 被拦截`);
+            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);
+        }
+        debug("llm_gateway", `${profile.description} 已放行（预估 ${profile.estimated_tokens} Token）`);
+        return {
+            allowed: true,
+            estimated_tokens: profile.estimated_tokens,
+            remaining_budget: this.budgetTotal - this.budgetUsed,
+            remaining_task_budget: this.taskBudget - this.taskTokensUsed,
+        };
+    }
+    /**
+     * 置信度闸口: 低于阈值禁止执行代码，必须调用 sf_brainstorm。
+     * @param confidence - 当前置信度
+     * @returns 闸口结果，包含是否允许和阈值
+     */
+    confidenceGate(confidence) {
+        const threshold = this.config.confidence_threshold;
+        if (confidence < threshold) {
+            debug("llm_gateway", `置信度 ${confidence.toFixed(2)} 低于阈值 ${threshold}，禁止直接执行`);
+            return {
+                allowed: false,
+                threshold,
+                reason: `置信度 ${confidence.toFixed(2)} 低于阈值 ${threshold}，禁止直接输出执行代码，必须调用 sf_brainstorm 展示三轨方案`,
+            };
+        }
+        return { allowed: true, threshold };
+    }
+    /** 标记操作完成，停止心跳 */
+    completeOperation() {
+        this.stopHeartbeat();
+        this.currentOperation = null;
+    }
+    /**
+     * 报告实际 Token 用量 — 根据估算与实际的差值调整预算计数。
+     * 差值为正时增加消耗，为负时回退多计部分。熔断器根据实际消耗重新评估。
+     * @param operation - 操作类型
+     * @param actualTokens - 实际消耗的 Token 数
+     */
+    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;
+                debug("llm_gateway", `实际用量超阈值，熔断器已开启`);
+            }
+        }
+        else {
+            this.budgetUsed = Math.max(0, this.budgetUsed + diff);
+            this.taskTokensUsed = Math.max(0, this.taskTokensUsed + diff);
+        }
+    }
+    /**
+     * 获取网关当前状态快照。
+     * @returns 网关状态，包含预算、调用统计和审计日志
+     */
+    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],
+        };
+    }
+    /**
+     * 重置网关状态 — 清零所有计数器、审计日志和熔断器。
+     * @param budget - 可选的新 Token 总预算
+     */
+    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();
+        debug("llm_gateway", "网关状态已重置");
+    }
+    /**
+     * 判断操作是否为本地操作（不需要 LLM 算力）。
+     * @param op - 操作名称
+     * @returns 是否为本地操作
+     */
+    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);
+    }
+    /**
+     * 判断操作是否为 AI 操作。
+     * @param op - 操作类型
+     * @returns 是否为 AI 操作
+     */
+    static isAIOperation(op) {
+        return op in OPERATION_PROFILES;
+    }
+    /**
+     * 获取操作类型的配置信息。
+     * @param op - 操作类型
+     * @returns 操作配置（级别、Token 估算、描述）
+     */
+    static getProfile(op) {
+        return OPERATION_PROFILES[op];
+    }
+    // ── 流式心跳 ──
+    /**
+     * 启动流式心跳 — 重型操作期间定期发送进度报告，防止客户端超时断连。
+     * @param operation - 当前 AI 操作类型
+     */
+    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/core/llm_gateway.js.map

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

package/dist/engine/core/log_governance.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 日志治理与用户可见输出检查。
+ *
+ * 面向 SoloForge 自身输出路径，补足统一 logger 之外的行为级约束。
+ */
+export interface LogGovernanceFinding {
+    severity: "hard_fail" | "warning";
+    kind: "raw_noise" | "format_violation" | "console_residue" | "internal_leak";
+    message_zh: string;
+    evidence?: string;
+}
+export interface LogGovernanceReport {
+    passed: boolean;
+    findings: LogGovernanceFinding[];
+}
+export declare function classifyOutputVisibility(content: string): "user_visible" | "internal_noise" | "json";
+export declare function assessOutputNoise(outputs: string[]): LogGovernanceReport;
+export declare function validateLogFormat(entry: unknown): LogGovernanceReport;
+export declare function enforceLogGovernance(output: string | string[]): LogGovernanceReport;
+export declare function evaluateFeedbackOutputQuality(params: {
+    output: string;
+    json_mode?: boolean;
+    critical_failure_hidden?: boolean;
+}): LogGovernanceReport;
+//# sourceMappingURL=log_governance.d.ts.map

package/dist/engine/core/log_governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log_governance.d.ts","sourceRoot":"","sources":["../../../src/engine/core/log_governance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC;IAClC,IAAI,EAAE,WAAW,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,eAAe,CAAC;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAQD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,gBAAgB,GAAG,MAAM,CAYpG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAaxE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAgBrE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,mBAAmB,CAGnF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,GAAG,mBAAmB,CAatB"}

package/dist/engine/core/log_governance.js

@@ -0,0 +1,76 @@
+/**
+ * 日志治理与用户可见输出检查。
+ *
+ * 面向 SoloForge 自身输出路径，补足统一 logger 之外的行为级约束。
+ */
+const INTERNAL_NOISE_PATTERNS = [
+    /\[soloForge\].*(debug|trace|internal)/i,
+    /validate-release|BATCH\d/i,
+    /raw_prompt|authorization_token|sk-[A-Za-z0-9_-]{8,}/i,
+];
+export function classifyOutputVisibility(content) {
+    const trimmed = content.trim();
+    if (!trimmed)
+        return "user_visible";
+    if ((trimmed.startsWith("{") && trimmed.endsWith("}")) || (trimmed.startsWith("[") && trimmed.endsWith("]"))) {
+        try {
+            JSON.parse(trimmed);
+            return "json";
+        }
+        catch {
+            return "user_visible";
+        }
+    }
+    return INTERNAL_NOISE_PATTERNS.some((p) => p.test(content)) ? "internal_noise" : "user_visible";
+}
+export function assessOutputNoise(outputs) {
+    const findings = [];
+    for (const output of outputs) {
+        if (classifyOutputVisibility(output) === "internal_noise") {
+            findings.push({
+                severity: "hard_fail",
+                kind: "raw_noise",
+                message_zh: "用户可见输出包含内部治理噪音或敏感信息",
+                evidence: output.slice(0, 160),
+            });
+        }
+    }
+    return { passed: findings.length === 0, findings };
+}
+export function validateLogFormat(entry) {
+    const findings = [];
+    if (typeof entry === "string") {
+        if (classifyOutputVisibility(entry) === "internal_noise") {
+            findings.push({ severity: "hard_fail", kind: "internal_leak", message_zh: "日志字符串包含内部噪音", evidence: entry });
+        }
+        return { passed: findings.length === 0, findings };
+    }
+    if (!entry || typeof entry !== "object") {
+        return { passed: false, findings: [{ severity: "hard_fail", kind: "format_violation", message_zh: "日志条目必须是字符串或对象" }] };
+    }
+    const obj = entry;
+    if (!obj.level || !obj.message) {
+        findings.push({ severity: "warning", kind: "format_violation", message_zh: "结构化日志缺少 level 或 message 字段" });
+    }
+    return { passed: findings.every((f) => f.severity !== "hard_fail"), findings };
+}
+export function enforceLogGovernance(output) {
+    const outputs = Array.isArray(output) ? output : [output];
+    return assessOutputNoise(outputs);
+}
+export function evaluateFeedbackOutputQuality(params) {
+    const findings = [...assessOutputNoise([params.output]).findings];
+    if (params.json_mode) {
+        try {
+            JSON.parse(params.output);
+        }
+        catch {
+            findings.push({ severity: "hard_fail", kind: "format_violation", message_zh: "--json 模式 stdout 必须是纯 JSON" });
+        }
+    }
+    if (params.critical_failure_hidden) {
+        findings.push({ severity: "hard_fail", kind: "internal_leak", message_zh: "用户反馈隐藏了关键失败" });
+    }
+    return { passed: findings.every((f) => f.severity !== "hard_fail"), findings };
+}
+//# sourceMappingURL=log_governance.js.map

package/dist/engine/core/log_governance.js.map

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

package/dist/engine/core/logger.d.ts

@@ -0,0 +1,64 @@
+/**
+ * SoloForge 统一日志模块
+ *
+ * 替代散落在 src 中的 console.log / console.error / console.warn。
+ * 区分用户可见输出、调试日志、错误日志，支持 --json 模式和测试静默。
+ */
+export type LogLevel = "debug" | "internal" | "info" | "warn" | "error";
+/**
+ * 初始化日志器状态。
+ * 在 CLI 入口和测试 setup 中调用。
+ */
+export declare function initLogger(opts?: {
+    json?: boolean;
+    silent?: boolean;
+    debug?: boolean;
+}): void;
+/**
+ * 从环境变量初始化（兼容 SOLOFORGE_DEBUG）。
+ */
+export declare function initLoggerFromEnv(): void;
+/**
+ * 重置日志器状态（测试 teardown 用）。
+ */
+export declare function resetLogger(): void;
+/**
+ * 用户可见信息。输出到 stdout。
+ * CLI 的 --json 模式由调用方自行判断是否输出。
+ */
+export declare function userInfo(...args: unknown[]): void;
+/**
+ * 用户可见警告。输出到 stderr，--json 模式下也输出（不污染 stdout）。
+ */
+export declare function userWarn(...args: unknown[]): void;
+/**
+ * 用户可见错误。输出到 stderr，--json 模式下也输出。
+ */
+export declare function userError(...args: unknown[]): void;
+/**
+ * 用户可见输出（强制 stdout，仅用于 --json 的 JSON.stringify 结果）。
+ * 调用方需确保只传 JSON 字符串。
+ */
+export declare function userJson(payload: string): void;
+/**
+ * 调试日志。仅 SOLOFORGE_DEBUG=1 时输出到 stderr。
+ * 所有引擎内部 trace 应使用此函数。
+ */
+export declare function debug(module: string, ...args: unknown[]): void;
+/**
+ * 内部警告：非用户直接可见，但运维/诊断需要。
+ * 始终输出到 stderr（除非静默模式）。
+ */
+export declare function internalWarn(module: string, ...args: unknown[]): void;
+/**
+ * JSON 安全错误：在 --json 模式下，将错误写入 stderr 而非 stdout。
+ */
+export declare function jsonSafeError(...args: unknown[]): void;
+export declare function isJsonMode(): boolean;
+export declare function isSilenced(): boolean;
+export declare function isDebugEnabled(): boolean;
+/**
+ * 向后兼容旧 debugLog()。新代码应使用 debug()。
+ */
+export declare function debugLog(...args: unknown[]): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/engine/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/engine/core/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAQxE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,QAItF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,SAGhC;AAED;;GAEG;AACH,wBAAgB,WAAW,SAI1B;AAgBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE1C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE1C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE3C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,QAEvC;AAID;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,QAGvD;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,QAG9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAE/C;AAID,wBAAgB,UAAU,YAAwB;AAClD,wBAAgB,UAAU,YAAwB;AAClD,wBAAgB,cAAc,YAA4B;AAI1D;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAGjD"}