soloforge 1.2.19 → 1.3.0

package/dist/engine/logger.js

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

package/dist/engine/logger.js.map

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

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

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

package/dist/engine/main_path_integration_contract.js

@@ -151,11 +151,11 @@ export function hasProductionImport(contract) {
 export function orphanGate(contract, capabilityKind) {
     const findings = [];
     const path = contract.module_path;
-    console.error(`[soloForge] 主链路接入: 开始孤岛门禁检查 — ${path}`);
+    debug("主链路接入", `开始孤岛门禁检查 — ${path}`);
     // 豁免文件始终允许
     const exempt = isExemptFile(path);
     if (exempt.exempt) {
-        console.error("[soloForge] 主链路接入: 孤岛门禁 — 豁免文件 " + path + " (" + exempt.reason + ")");
+        debug("主链路接入", "孤岛门禁 — 豁免文件 " + path + " (" + exempt.reason + ")");
         findings.push({
             severity: "allow",
             module_path: path,
@@ -166,7 +166,7 @@ export function orphanGate(contract, capabilityKind) {
     }
     // 规则 1: 只被测试导入 → hard_fail
     if (contract.production_imports.length === 0 && contract.integration_tests.length > 0) {
-        console.error("[soloForge] 主链路接入: 孤岛门禁 — 规则1命中: " + path + " 只被测试导入");
+        debug("主链路接入", "孤岛门禁 — 规则1命中: " + path + " 只被测试导入");
         findings.push({
             severity: "hard_fail",
             module_path: path,
@@ -176,7 +176,7 @@ export function orphanGate(contract, capabilityKind) {
     }
     // 规则 1b: 被导入但从未被调用（仅导入）→ hard_fail
     if (contract.production_imports.length === 0 && contract.status === "implemented_not_integrated") {
-        console.error("[soloForge] 主链路接入: 孤岛门禁 — 规则1b命中: " + path + " 被导入但从未被调用");
+        debug("主链路接入", "孤岛门禁 — 规则1b命中: " + path + " 被导入但从未被调用");
         findings.push({
             severity: "hard_fail",
             module_path: path,
@@ -186,7 +186,7 @@ export function orphanGate(contract, capabilityKind) {
     }
     // 规则 2: enforced 能力无入口链路 → hard_fail
     if (contract.status === "implemented_not_integrated" && !hasEntryTrace(contract)) {
-        console.error("[soloForge] 主链路接入: 孤岛门禁 — 规则2命中: " + path + " 无入口链路");
+        debug("主链路接入", "孤岛门禁 — 规则2命中: " + path + " 无入口链路");
         findings.push({
             severity: "hard_fail",
             module_path: path,
@@ -198,7 +198,7 @@ export function orphanGate(contract, capabilityKind) {
     if (capabilityKind &&
         (capabilityKind === "guard" || capabilityKind === "verifier" || capabilityKind === "contract") &&
         !hasProductionImport(contract)) {
-        console.error("[soloForge] 主链路接入: 孤岛门禁 — 规则3命中: " + capabilityKind + " " + path + " 只被测试调用");
+        debug("主链路接入", "孤岛门禁 — 规则3命中: " + capabilityKind + " " + path + " 只被测试调用");
         findings.push({
             severity: "hard_fail",
             module_path: path,
@@ -219,7 +219,7 @@ export function orphanGate(contract, capabilityKind) {
     }
     // 规则 5: 无集成测试 → hard_fail (experimental_isolated 降级 warning)
     if (!hasIntegrationTest(contract) && contract.status !== "experimental_isolated") {
-        console.error("[soloForge] 主链路接入: 孤岛门禁 — 规则5命中: " + path + " 缺少集成测试");
+        debug("主链路接入", "孤岛门禁 — 规则5命中: " + path + " 缺少集成测试");
         findings.push({
             severity: "hard_fail",
             module_path: path,
@@ -245,7 +245,7 @@ export function orphanGate(contract, capabilityKind) {
             recommended_action: "retire_dead_code",
         });
     }
-    console.error("[soloForge] 主链路接入: 孤岛门禁完成 — " + path + " 发现 " + findings.length + " 个问题");
+    debug("主链路接入", "孤岛门禁完成 — " + path + " 发现 " + findings.length + " 个问题");
     return findings;
 }
 // ── 集成审计 ──
@@ -257,7 +257,7 @@ export function orphanGate(contract, capabilityKind) {
  * @returns 集成审计报告
  */
 export function auditIntegration(contracts, capabilityKinds) {
-    console.error(`[soloForge] 主链路接入: 开始集成审计 — 共 ${contracts.length} 个契约`);
+    debug("主链路接入", `开始集成审计 — 共 ${contracts.length} 个契约`);
     const report = {
         orphan_modules: [],
         registry_only_modules: [],
@@ -301,7 +301,7 @@ export function auditIntegration(contracts, capabilityKinds) {
             });
         }
     }
-    console.error("[soloForge] 主链路接入: 集成审计完成 — 孤岛 " + report.orphan_modules.length + ", 注册表 " + report.registry_only_modules.length + ", 仅测试 " + report.test_only_modules.length + ", 不可达 " + report.unreachable_capabilities.length);
+    debug("主链路接入", "集成审计完成 — 孤岛 " + report.orphan_modules.length + ", 注册表 " + report.registry_only_modules.length + ", 仅测试 " + report.test_only_modules.length + ", 不可达 " + report.unreachable_capabilities.length);
     return report;
 }
 // ── 工厂函数 ──
@@ -469,7 +469,7 @@ export function buildIntegrationFeedback(contract) {
  */
 export function validateMainPathIntegration(options) {
     const findings = [];
-    console.error(`[soloForge] 主链路接入: 开始治理验证 — 共 ${options.contracts.length} 个契约`);
+    debug("主链路接入", `开始治理验证 — 共 ${options.contracts.length} 个契约`);
     for (const c of options.contracts) {
         const kind = options.capabilityKinds?.get(c.module_path);
         // 规则 1: 新增 src/** 生产代码只被测试导入 → hard_fail
@@ -573,7 +573,7 @@ export function validateMainPathIntegration(options) {
             });
         }
     }
-    console.error(`[soloForge] 主链路接入: 治理验证完成 — 发现 ${findings.length} 个问题`);
+    debug("主链路接入", `治理验证完成 — 发现 ${findings.length} 个问题`);
     return findings;
 }
 // ═══════════════════════════════════════════════════════════════
@@ -581,6 +581,7 @@ export function validateMainPathIntegration(options) {
 // ═══════════════════════════════════════════════════════════════
 import fs from "node:fs";
 import fspath from "node:path";
+import { debug } from "./logger.js";
 /** 生产源码扩展名 */
 const PRODUCTION_EXTENSIONS = new Set([".ts", ".tsx", ".js", ".jsx", ".java", ".kt", ".go", ".py"]);
 /** 表示非生产文件的匹配模式 */
@@ -658,10 +659,10 @@ function isInScope(normalizedPath, config) {
  * @returns 文件路径列表
  */
 export function walkDir(dir) {
-    console.error("[soloForge] 主链路接入: 遍历目录 — " + dir);
+    debug("主链路接入", "遍历目录 — " + dir);
     const results = [];
     if (!fs.existsSync(dir)) {
-        console.error("[soloForge] 主链路接入: 遍历目录 — 目录不存在: " + dir);
+        debug("主链路接入", "遍历目录 — 目录不存在: " + dir);
         return results;
     }
     try {
@@ -674,9 +675,9 @@ export function walkDir(dir) {
         }
     }
     catch (e) {
-        console.error("[soloForge] 主链路接入: 遍历目录异常 — " + dir + ": " + (e instanceof Error ? e.message : String(e)));
+        debug("主链路接入", "遍历目录异常 — " + dir + ": " + (e instanceof Error ? e.message : String(e)));
     }
-    console.error("[soloForge] 主链路接入: 遍历目录完成 — " + dir + " 共 " + results.length + " 个文件");
+    debug("主链路接入", "遍历目录完成 — " + dir + " 共 " + results.length + " 个文件");
     return results;
 }
 // ── 调用证据检测 ──
@@ -804,7 +805,7 @@ function detectGoCallEvidence(content, names) {
  * @returns 导入路径列表
  */
 export function extractImportPaths(content, filePath) {
-    console.error("[soloForge] 主链路接入: 提取导入路径 — " + filePath);
+    debug("主链路接入", "提取导入路径 — " + filePath);
     const paths = [];
     const ext = fspath.extname(filePath);
     if (ext === ".java" || ext === ".kt") {
@@ -847,7 +848,7 @@ export function extractImportPaths(content, filePath) {
         while ((m = reqRe.exec(content)) !== null)
             paths.push(m[1]);
     }
-    console.error("[soloForge] 主链路接入: 提取导入路径完成 — " + filePath + " 共 " + paths.length + " 条");
+    debug("主链路接入", "提取导入路径完成 — " + filePath + " 共 " + paths.length + " 条");
     return paths;
 }
 /**
@@ -863,7 +864,7 @@ export function extractImportPaths(content, filePath) {
 export function resolveImportPath(importSpecifier, fromFileRel, projectPath) {
     if (!importSpecifier.startsWith("."))
         return null;
-    console.error("[soloForge] 主链路接入: 解析导入路径 — " + importSpecifier + " (from " + fromFileRel + ")");
+    debug("主链路接入", "解析导入路径 — " + importSpecifier + " (from " + fromFileRel + ")");
     let spec = importSpecifier;
     // 去除 .js/.jsx 扩展名 — 实际文件可能是 .ts 或 .tsx
     const hasExt = /\.(ts|tsx|js|jsx)$/.test(spec);
@@ -905,28 +906,28 @@ function normalizeModulePath(p) {
  * @returns 全限定名
  */
 export function computeJavaFqn(filePath, projectPath) {
-    console.error("[soloForge] 主链路接入: 计算Java全限定名 — " + filePath);
+    debug("主链路接入", "计算Java全限定名 — " + filePath);
     let content;
     try {
         content = fs.readFileSync(fspath.join(projectPath, filePath), "utf-8");
     }
     catch (e) {
-        console.error("[soloForge] 主链路接入: 计算Java全限定名失败 — " + filePath + ": " + (e instanceof Error ? e.message : String(e)));
+        debug("主链路接入", "计算Java全限定名失败 — " + filePath + ": " + (e instanceof Error ? e.message : String(e)));
         return null;
     }
     const pkgMatch = content.match(/package\s+([\w.]+)\s*;?/);
     if (!pkgMatch) {
-        console.error("[soloForge] 主链路接入: 计算Java全限定名 — 未找到 package 声明: " + filePath);
+        debug("主链路接入", "计算Java全限定名 — 未找到 package 声明: " + filePath);
         return null;
     }
     const pkg = pkgMatch[1];
     const classMatch = content.match(/(?:public\s+)?(?:class|interface|enum|record)\s+(\w+)/);
     if (!classMatch) {
-        console.error("[soloForge] 主链路接入: 计算Java全限定名 — 未找到类声明: " + filePath);
+        debug("主链路接入", "计算Java全限定名 — 未找到类声明: " + filePath);
         return null;
     }
     const fqn = `${pkg}.${classMatch[1]}`;
-    console.error("[soloForge] 主链路接入: 计算Java全限定名完成 — " + fqn);
+    debug("主链路接入", "计算Java全限定名完成 — " + fqn);
     return fqn;
 }
 /**
@@ -975,7 +976,7 @@ function computeGoPkgPath(filePath) {
  * @returns 导入者扫描结果
  */
 export function scanModuleImporters(projectPath, moduleRelPath) {
-    console.error("[soloForge] 主链路接入: 扫描模块导入者 — " + moduleRelPath);
+    debug("主链路接入", "扫描模块导入者 — " + moduleRelPath);
     const result = {
         production_imports: [],
         production_calls: [],
@@ -1105,7 +1106,7 @@ export function scanModuleImporters(projectPath, moduleRelPath) {
             result.import_only.push(rel);
         }
     }
-    console.error("[soloForge] 主链路接入: 扫描模块导入者完成 — " + moduleRelPath + " 生产导入 " + result.production_imports.length + " 测试导入 " + result.test_imports.length + " 调用证据 " + result.production_calls.length);
+    debug("主链路接入", "扫描模块导入者完成 — " + moduleRelPath + " 生产导入 " + result.production_imports.length + " 测试导入 " + result.test_imports.length + " 调用证据 " + result.production_calls.length);
     return result;
 }
 /** Check if a file only re-exports the module (barrel export) */
@@ -1161,7 +1162,7 @@ function isRegistryOnlyImport(content, targetNorm, ext) {
  * @returns 入口点追踪列表
  */
 export function identifyProjectEntryPoints(projectPath) {
-    console.error("[soloForge] 主链路接入: 识别项目入口点 — " + projectPath);
+    debug("主链路接入", "识别项目入口点 — " + projectPath);
     const eps = [];
     const allFiles = walkDir(projectPath);
     const patterns = [
@@ -1201,7 +1202,7 @@ export function identifyProjectEntryPoints(projectPath) {
             }
         }
     }
-    console.error("[soloForge] 主链路接入: 识别项目入口点完成 — 共 " + eps.length + " 个入口");
+    debug("主链路接入", "识别项目入口点完成 — 共 " + eps.length + " 个入口");
     return eps;
 }
 /**
@@ -1217,7 +1218,7 @@ export function identifyProjectEntryPoints(projectPath) {
  * @returns 可达的入口点列表
  */
 export function traceModuleReachability(projectPath, moduleRelPath, entryPoints) {
-    console.error("[soloForge] 主链路接入: 追踪模块可达性 — " + moduleRelPath + " 从 " + entryPoints.length + " 个入口");
+    debug("主链路接入", "追踪模块可达性 — " + moduleRelPath + " 从 " + entryPoints.length + " 个入口");
     const targetNorm = normalizeModulePath(moduleRelPath);
     const moduleExt = fspath.extname(moduleRelPath);
     const reachable = [];
@@ -1246,7 +1247,7 @@ export function traceModuleReachability(projectPath, moduleRelPath, entryPoints)
             });
         }
     }
-    console.error("[soloForge] 主链路接入: 追踪模块可达性完成 — " + moduleRelPath + " 可达 " + reachable.length + " 个入口");
+    debug("主链路接入", "追踪模块可达性完成 — " + moduleRelPath + " 可达 " + reachable.length + " 个入口");
     return reachable;
 }
 function dfsTrace(currentFile, targetNorm, projectPath, visited, chain, targetJavaFqn, targetPyModule, targetGoPkg, depth = 0) {
@@ -1334,7 +1335,7 @@ function dfsTrace(currentFile, targetNorm, projectPath, visited, chain, targetJa
  * @returns 可观测性引用列表
  */
 export function collectModuleObservability(projectPath, moduleRelPath) {
-    console.error("[soloForge] 主链路接入: 收集模块可观测性 — " + moduleRelPath);
+    debug("主链路接入", "收集模块可观测性 — " + moduleRelPath);
     const refs = [];
     const fullPath = fspath.join(projectPath, moduleRelPath);
     let content;
@@ -1342,7 +1343,7 @@ export function collectModuleObservability(projectPath, moduleRelPath) {
         content = fs.readFileSync(fullPath, "utf-8");
     }
     catch (e) {
-        console.error("[soloForge] 主链路接入: 收集模块可观测性失败 — " + moduleRelPath + ": " + (e instanceof Error ? e.message : String(e)));
+        debug("主链路接入", "收集模块可观测性失败 — " + moduleRelPath + ": " + (e instanceof Error ? e.message : String(e)));
         return refs;
     }
     const patterns = [
@@ -1373,7 +1374,7 @@ export function collectModuleObservability(projectPath, moduleRelPath) {
             continue;
         }
     }
-    console.error("[soloForge] 主链路接入: 收集模块可观测性完成 — " + moduleRelPath + " 共 " + refs.length + " 条证据");
+    debug("主链路接入", "收集模块可观测性完成 — " + moduleRelPath + " 共 " + refs.length + " 条证据");
     return refs;
 }
 /**
@@ -1399,7 +1400,7 @@ function stripComments(source) {
  * @returns 集成测试文件路径列表
  */
 export function findIntegrationTests(projectPath, moduleRelPath) {
-    console.error("[soloForge] 主链路接入: 查找集成测试 — " + moduleRelPath);
+    debug("主链路接入", "查找集成测试 — " + moduleRelPath);
     const tests = [];
     const allFiles = walkDir(projectPath);
     const moduleExt = fspath.extname(moduleRelPath);
@@ -1476,7 +1477,7 @@ export function findIntegrationTests(projectPath, moduleRelPath) {
                 tests.push(rel);
         }
     }
-    console.error("[soloForge] 主链路接入: 查找集成测试完成 — " + moduleRelPath + " 共 " + tests.length + " 个测试");
+    debug("主链路接入", "查找集成测试完成 — " + moduleRelPath + " 共 " + tests.length + " 个测试");
     return tests;
 }
 /**
@@ -1495,17 +1496,17 @@ export function findIntegrationTests(projectPath, moduleRelPath) {
  */
 export function buildMainPathIntegrationContracts(projectPath, changedFiles, config) {
     const contracts = [];
-    console.error(`[soloForge] 主链路接入: 开始扫描变更文件 — 共 ${changedFiles.length} 个文件`);
+    debug("主链路接入", `开始扫描变更文件 — 共 ${changedFiles.length} 个文件`);
     const entryPoints = identifyProjectEntryPoints(projectPath);
     for (const filePath of changedFiles) {
         const normalized = filePath.replace(/\\/g, "/");
         const prodCheck = isProductionFile(normalized, config);
         if (!prodCheck.isProd)
             continue;
-        console.error("[soloForge] 主链路接入: 扫描生产文件 — " + normalized);
+        debug("主链路接入", "扫描生产文件 — " + normalized);
         const fullPath = fspath.join(projectPath, normalized);
         if (!fs.existsSync(fullPath)) {
-            console.error("[soloForge] 主链路接入: 文件不存在 — " + normalized);
+            debug("主链路接入", "文件不存在 — " + normalized);
             continue;
         }
         // 步骤 1: Scan who imports this module
@@ -1537,7 +1538,7 @@ export function buildMainPathIntegrationContracts(projectPath, changedFiles, con
         else {
             status = "implemented_not_integrated";
         }
-        console.error("[soloForge] 主链路接入: 状态判定 — " + normalized + " → " + status);
+        debug("主链路接入", "状态判定 — " + normalized + " → " + status);
         // 步骤 4: Collect observability evidence
         const observabilityRefs = collectModuleObservability(projectPath, normalized);
         // 步骤 5: Find integration tests
@@ -1552,7 +1553,7 @@ export function buildMainPathIntegrationContracts(projectPath, changedFiles, con
             owner: "",
         });
     }
-    console.error("[soloForge] 主链路接入: 扫描变更文件完成 — 共 " + contracts.length + " 个契约");
+    debug("主链路接入", "扫描变更文件完成 — 共 " + contracts.length + " 个契约");
     return contracts;
 }
 /**
@@ -1565,7 +1566,7 @@ export function buildMainPathIntegrationContracts(projectPath, changedFiles, con
  * @returns 生产文件路径列表
  */
 export function collectAllProductionFiles(projectPath, config) {
-    console.error("[soloForge] 主链路接入: 收集所有生产文件 — " + projectPath);
+    debug("主链路接入", "收集所有生产文件 — " + projectPath);
     const files = [];
     const allFiles = walkDir(projectPath);
     for (const file of allFiles) {
@@ -1575,7 +1576,7 @@ export function collectAllProductionFiles(projectPath, config) {
             files.push(rel);
         }
     }
-    console.error("[soloForge] 主链路接入: 收集所有生产文件完成 — 共 " + files.length + " 个文件");
+    debug("主链路接入", "收集所有生产文件完成 — 共 " + files.length + " 个文件");
     return files;
 }
 //# sourceMappingURL=main_path_integration_contract.js.map