soloforge 1.3.2 → 1.3.4

package/dist/engine/code_maintainability_observability_contract.js

@@ -0,0 +1,473 @@
+/**
+ * 用户项目代码可维护性与可观测性契约。
+ *
+ * 治理对象是用户项目代码，不是 SoloForge 自身。
+ * 覆盖必要注释、结构化日志、错误日志、审计日志、
+ * 敏感信息脱敏和低风险跳过。
+ */
+/* ── 关键词 ─────────────────────────────────────── */
+const OBSERVABILITY_KEYWORDS = /业务|支付|金额|账单|合同|入住|权限|登录|安全|通知|异步|状态机|审批|补贴|核销|外部系统|webhook|回调|异常处理|重试|补偿|事务|幂等|并发|数据修复|批处理|迁移|Controller|Service|UseCase|Domain|Repository|payment|billing|invoice|contract|permission|auth|security|state|workflow|migration|refund|charge|order/i;
+const LOW_RISK_KEYWORDS = /错别字|拼写|文案|样式|css|颜色|README|配置值|测试数据|fixture|getter|setter|简单类型|类型定义|interface\s+\w+\s*\{|type\s+\w+\s*=/i;
+const CRITICAL_LOG_KEYWORDS = /支付|账单|金额|退款|核销|补贴|缴费|payment|billing|refund|charge|invoice/i;
+const SECURITY_LOG_KEYWORDS = /权限|登录|认证|越权|安全|role|auth|permission|security|access.?denied|forbidden/i;
+const STATE_CHANGE_KEYWORDS = /状态|流转|status|state|transition|pending|approved|rejected|cancelled/i;
+const EXTERNAL_CALL_KEYWORDS = /外部|第三方|API|调用|HTTP|RPC|webhook|callback|RestTemplate|WebClient|fetch|axios/i;
+const MIGRATION_KEYWORDS = /迁移|修复|批处理|migration|batch|data.?fix|script/i;
+const COMPLEX_RULE_KEYWORDS = /金额计算|计算逻辑|领域不变量|状态机|幂等|并发控制|分布式锁|算法|formula|invariant|idempoten|concurr/i;
+const SENSITIVE_PATTERNS = [
+    { pattern: /(?:password|passwd|pwd|secret|token|api[_-]?key|access[_-]?key|private[_-]?key)\s*[:=]\s*["'][^"']{4,}/i, name_zh: "明文密钥/令牌" },
+    { pattern: /(?:cookie|session[_-]?id|set[_-]?cookie)\s*[:=]\s*["'][^"']{8,}/i, name_zh: "Cookie/会话" },
+    { pattern: /(?:手机号|phone|mobile|cell)\s*[:=]\s*["']?\d{11}/i, name_zh: "手机号全量" },
+    { pattern: /(?:身份证|id[_-]?card|id[_-]?number)\s*[:=]\s*["']?\d{15,18}/i, name_zh: "身份证全量" },
+    { pattern: /(?:银行卡|bank[_-]?card|card[_-]?number|pan)\s*[:=]\s*["']?\d{13,19}/i, name_zh: "银行卡全量" },
+    { pattern: /(?:健康|病历|诊断|处方|health|medical|diagnosis|prescription)/i, name_zh: "健康隐私" },
+];
+// 日志输出中的敏感信息 — 区分声明与输出
+const LOG_OUTPUT_SENSITIVE_PATTERNS = [
+    // logger.info({ token }) / console 输出含 password 字段的对象
+    { pattern: /(?:log|logger|LOG|console)\.(?:info|warn|error|debug|log|INFO|WARN|ERROR|DEBUG)\s*\(\s*\{[^}]*(?:password|passwd|pwd|secret|token|api[_-]?key|access[_-]?key|private[_-]?key|cookie|session[_-]?id)\b/i, name_zh: "日志对象含敏感字段" },
+    // console dot log 输出 user.password / log.info(data.secret)
+    { pattern: /(?:log|logger|LOG|console)\.(?:info|warn|error|debug|log|INFO|WARN|ERROR|DEBUG)\s*\([^)]*\b\w+\.(?:password|passwd|pwd|secret|token|api[_-]?key|access[_-]?key|private[_-]?key|cookie|session[_-]?id)\b/i, name_zh: "日志输出敏感属性值" },
+    // logger.info("token={}", token) / log.info("password=" + pwd) / log.info("token: %s", t)
+    { pattern: /(?:log|logger|LOG|console)\.(?:info|warn|error|debug|log|INFO|WARN|ERROR|DEBUG)\s*\(\s*["'][^"']*\b(?:password|passwd|pwd|secret|token|api[_-]?key|access[_-]?key|private[_-]?key|cookie|session[_-]?id)\s*[=：:]\s*(?:["']?\s*\+|\{?\}|%[sd])/i, name_zh: "日志拼接/格式化敏感值" },
+];
+/* ── 触发判断 ─────────────────────────────────── */
+export function requiresCodeObservabilityContract(intent, route, changedFiles = []) {
+    const text = `${intent} ${changedFiles.join(" ")}`;
+    if (LOW_RISK_KEYWORDS.test(text) && !OBSERVABILITY_KEYWORDS.test(text))
+        return false;
+    const relevantRoute = !route
+        || ["code_change", "artifact_generation", "operation", "multi_stage_plan"].includes(route);
+    if (!relevantRoute)
+        return false;
+    if (!OBSERVABILITY_KEYWORDS.test(text))
+        return false;
+    // 简单修复/调试/查询不触发完整契约
+    if (/^(?:修复|调试|排查|查看|分析|解释|为什么|查一下|帮我看看|debug|fix\s+(?:a\s+)?(?:typo|lint|import|build))/i.test(intent.trim()))
+        return false;
+    return true;
+}
+/* ── 项目 logger 检测 ──────────────────────────── */
+export function detectProjectLogger(fileContents) {
+    const allContent = Object.values(fileContents).join("\n");
+    if (/import\s+.*(?:LoggerFactory|@Slf4j|log\s*=.*Logger)/.test(allContent) || /log\.(info|warn|error|debug)\s*\(/.test(allContent)) {
+        return { type: "slf4j", import_pattern: "LoggerFactory.getLogger", call_pattern: "log.info/warn/error", confidence: "high" };
+    }
+    if (/import\s+.*(?:pino|from\s+['"]pino['"])/.test(allContent) || /(?:const|let)\s+\w*(?:logger|log)\s*=\s*pino/.test(allContent)) {
+        return { type: "pino", import_pattern: "import pino", call_pattern: "logger.info/warn/error", confidence: "high" };
+    }
+    if (/import\s+.*(?:winston|from\s+['"]winston['"])/.test(allContent) || /createLogger\s*\(/.test(allContent)) {
+        return { type: "winston", import_pattern: "import winston", call_pattern: "logger.info/warn/error", confidence: "high" };
+    }
+    if (/import\s+.*(?:@nestjs|NestJS|Logger\s*}\s*from\s+['"]@nestjs)/.test(allContent)) {
+        return { type: "nestjs_logger", import_pattern: "import { Logger } from '@nestjs/common'", call_pattern: "this.logger.log/warn/error", confidence: "high" };
+    }
+    const fileKeys = Object.keys(fileContents).join(" ");
+    const hasFrontendExt = /\.(?:vue|tsx|jsx|svelte)\b/.test(fileKeys);
+    const hasFrontendImport = /\.vue\s*['"]|\.tsx\s*['"]|\.jsx\s*['"]|react['"]|vue['"]/.test(allContent);
+    if (hasFrontendExt || hasFrontendImport) {
+        if (/(?:const|let)\s+\w*(?:logger|Logger)\s*=/.test(allContent)) {
+            return { type: "custom_logger", import_pattern: "项目封装 logger", call_pattern: "logger.info/warn/error", confidence: "medium" };
+        }
+        return { type: "frontend_project", import_pattern: "前端项目", call_pattern: "生产环境禁止 console", confidence: "medium" };
+    }
+    if (/(?:const|let)\s+\w*(?:logger|Logger)\s*=/.test(allContent)) {
+        return { type: "custom_logger", import_pattern: "项目封装 logger", call_pattern: "logger.info/warn/error", confidence: "medium" };
+    }
+    return { type: "none_detected", import_pattern: "无", call_pattern: "console.log", confidence: "low" };
+}
+/* ── 工作包创建 ───────────────────────────────── */
+export function createCodeObservabilityWorkPackage(taskId, intent, loggerInfo) {
+    const text = intent;
+    const requiredLogs = [];
+    const sensitiveFields = [];
+    const requiredComments = [];
+    if (CRITICAL_LOG_KEYWORDS.test(text)) {
+        requiredLogs.push("支付/金额/退款/核销状态变更必须有业务日志，含对象 ID、操作人、前后状态");
+        sensitiveFields.push("payment_amount", "card_number", "bank_account");
+    }
+    if (SECURITY_LOG_KEYWORDS.test(text)) {
+        requiredLogs.push("权限拒绝/越权访问必须有安全日志，含操作人、目标资源、拒绝原因");
+    }
+    if (STATE_CHANGE_KEYWORDS.test(text)) {
+        requiredLogs.push("关键状态流转必须有日志，含流转前后状态和触发原因");
+    }
+    if (EXTERNAL_CALL_KEYWORDS.test(text)) {
+        requiredLogs.push("外部调用失败/超时/重试必须有日志，含目标、响应码/错误、重试次数");
+    }
+    if (MIGRATION_KEYWORDS.test(text)) {
+        requiredLogs.push("数据修复/迁移脚本必须有审计日志，含修复前值、修复后值、影响行数");
+    }
+    if (COMPLEX_RULE_KEYWORDS.test(text)) {
+        requiredComments.push("复杂业务规则必须有注释说明原因（为什么），不得只复述代码行为（做什么）");
+    }
+    if (/事务|幂等|并发|分布式锁/i.test(text)) {
+        requiredComments.push("事务边界、幂等策略、并发控制必须有注释说明设计意图");
+    }
+    return {
+        task_id: taskId,
+        status: "required",
+        applicability_reason_zh: `该任务涉及业务编码，需确认代码可维护性与可观测性约束: ${intent}`,
+        required_logs: requiredLogs,
+        required_comments: requiredComments,
+        sensitive_fields: sensitiveFields,
+        detected_logger: loggerInfo,
+    };
+}
+function workPackageSatisfied(wp) {
+    return !!wp && wp.status === "satisfied";
+}
+/* ── Gate ─────────────────────────────────────── */
+export function evaluateCodeObservabilityGate(input) {
+    if (!requiresCodeObservabilityContract(input.intent, input.route, input.changed_files)) {
+        return {
+            applicable: false,
+            allowed: true,
+            status: "not_applicable",
+            reason_zh: "低风险或非业务编码任务，不触发代码可维护性/可观测性工作包",
+            findings: [],
+        };
+    }
+    const loggerInfo = input.project_files
+        ? detectProjectLogger(input.project_files)
+        : undefined;
+    const wp = input.work_package ?? createCodeObservabilityWorkPackage(input.task_id, input.intent, loggerInfo);
+    if (!workPackageSatisfied(wp)) {
+        return {
+            applicable: true,
+            allowed: false,
+            status: "blocked",
+            reason_zh: "业务编码任务缺少代码可维护性/可观测性工作包，不得开始实现",
+            work_package: { ...wp, detected_logger: loggerInfo },
+            findings: [],
+        };
+    }
+    return {
+        applicable: true,
+        allowed: true,
+        status: "satisfied",
+        reason_zh: "代码可维护性/可观测性工作包已具备，可进入实现",
+        work_package: { ...wp, detected_logger: loggerInfo },
+        findings: [],
+    };
+}
+/* ── Review: 敏感信息检测 ─────────────────────── */
+export function detectSensitiveLogs(fileContents) {
+    const findings = [];
+    for (const [file, content] of Object.entries(fileContents)) {
+        if (/\.(?:test|spec)\./.test(file))
+            continue;
+        for (const { pattern, name_zh } of SENSITIVE_PATTERNS) {
+            if (pattern.test(content)) {
+                findings.push({
+                    category: "sensitive_log_leak",
+                    severity: "hard_fail",
+                    file,
+                    evidence: `日志或输出可能包含敏感信息: ${name_zh}`,
+                    suggestion_zh: `对 ${name_zh} 字段脱敏后再输出（如仅显示末四位或哈希值）。`,
+                });
+            }
+        }
+        for (const { pattern, name_zh } of LOG_OUTPUT_SENSITIVE_PATTERNS) {
+            if (pattern.test(content)) {
+                findings.push({
+                    category: "sensitive_log_leak",
+                    severity: "hard_fail",
+                    file,
+                    evidence: `日志输出包含敏感信息: ${name_zh}`,
+                    suggestion_zh: `禁止在日志中输出敏感字段值，仅记录脱敏值或哈希。`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+/* ── Review: 缺失日志检测 ─────────────────────── */
+export function reviewMissingLogs(fileContents) {
+    const findings = [];
+    for (const [file, content] of Object.entries(fileContents)) {
+        if (/\.(?:test|spec)\./.test(file))
+            continue;
+        const lowered = file.toLowerCase();
+        const hasLog = /(?:log\.(info|warn|error|debug)|logger\.(info|warn|error|debug|log)|LOG\.(INFO|WARN|ERROR)|console\.(log|error|warn))\s*\(/i.test(content);
+        if (CRITICAL_LOG_KEYWORDS.test(`${file} ${content}`)) {
+            const hasWriteOp = /\.(?:save|insert|update|delete|create|refund|charge|pay)\s*\(/i.test(content);
+            if (hasWriteOp && !/(?:log\.|logger\.|LOG\.)/i.test(content)) {
+                findings.push({
+                    category: "missing_log_critical",
+                    severity: "hard_fail",
+                    file,
+                    evidence: "支付/金额相关写操作缺少业务日志",
+                    suggestion_zh: "补充包含对象 ID、操作人、金额前后值和操作结果的结构化日志。",
+                });
+            }
+            // 有日志但不可定位 — 支付/金额写操作的日志必须含对象ID或前后状态
+            // 事件词（退款/支付/changed/updated）不是可定位字段
+            if (hasWriteOp && /(?:log\.|logger\.|LOG\.)/i.test(content)) {
+                const logStmts = content.match(/(?:log\.|logger\.|LOG\.|console\.)\s*(?:info|warn|error|debug|log|INFO|WARN|ERROR|DEBUG)\s*\([^)]*\)/gi) ?? [];
+                const hasLocatableField = logStmts.some((stmt) => /\w+(?:Id|_id|ID|No|Number|Code)\b/i.test(stmt)
+                    || /\bid\s*[=：:]/i.test(stmt)
+                    || /(?:before|after|prev|old|new|from|to)\s*[=：:]/i.test(stmt)
+                    || /(?:操作人|操作者|operator|userId|user_id|adminId|staffId)\b/i.test(stmt)
+                    || /(?:resourceId|target|resource)\s*[=：:]/i.test(stmt));
+                if (!hasLocatableField) {
+                    findings.push({
+                        category: "unlocatable_log",
+                        severity: "hard_fail",
+                        file,
+                        evidence: "支付/金额写操作日志缺少可定位字段（对象ID、前后状态、操作人/目标资源）",
+                        suggestion_zh: "日志必须包含对象 ID、前后状态或操作人+目标资源，事件词不是可定位字段。",
+                    });
+                }
+            }
+        }
+        if (SECURITY_LOG_KEYWORDS.test(`${file} ${content}`)) {
+            const hasPermissionCheck = /(?:permission|auth|role|check|deny|reject|forbidden|authorize)/i.test(content);
+            if (hasPermissionCheck && !/(?:log\.|logger\.|LOG\.)/i.test(content)) {
+                findings.push({
+                    category: "missing_log_critical",
+                    severity: "hard_fail",
+                    file,
+                    evidence: "权限校验逻辑缺少安全日志",
+                    suggestion_zh: "补充包含操作人、目标资源和拒绝原因的安全日志。",
+                });
+            }
+        }
+        const catchBlocks = content.match(/catch\s*\([^)]*\)\s*\{[^}]*\}/g) ?? [];
+        for (const block of catchBlocks) {
+            const hasLogInBlock = /(?:log\.|logger\.|LOG\.|console\.(error|warn))/i.test(block);
+            const onlyReturnOrRethrow = /^(?:\s*(?:return\s+(?:false|null|undefined|""|-1|0|[])|;?\s*\})+\s*$)/i.test(block.replace(/\s+/g, " ").trim());
+            if (!hasLogInBlock && (onlyReturnOrRethrow || /return\s+(?:false|null|""|-1|0)/i.test(block))) {
+                findings.push({
+                    category: "catch_swallow",
+                    severity: "hard_fail",
+                    file,
+                    evidence: `catch 块吞异常且无日志: ${block.slice(0, 80).replace(/\n/g, " ")}`,
+                    suggestion_zh: "至少记录异常类型、消息和影响上下文，不得静默忽略。",
+                });
+            }
+        }
+        if (STATE_CHANGE_KEYWORDS.test(`${file} ${content}`)) {
+            const hasStateUpdate = /(?:status|state)\s*(?:=|\.set|\.update|transition|change)\s*/i.test(content);
+            if (hasStateUpdate && !/(?:log\.|logger\.|LOG\.)/i.test(content)) {
+                findings.push({
+                    category: "missing_log_state_change",
+                    severity: "warning",
+                    file,
+                    evidence: "状态变更逻辑缺少流转日志",
+                    suggestion_zh: "补充状态流转日志，记录变更前后状态和触发原因。",
+                });
+            }
+        }
+        if (EXTERNAL_CALL_KEYWORDS.test(`${file} ${content}`)) {
+            const hasExternalCall = /(?:fetch|axios|RestTemplate|WebClient|Feign|http\.request|rpc|grpc)/i.test(content);
+            if (hasExternalCall && !/(?:log\.|logger\.|LOG\.)/i.test(content)) {
+                findings.push({
+                    category: "missing_log_external",
+                    severity: "warning",
+                    file,
+                    evidence: "外部调用缺少失败/超时日志",
+                    suggestion_zh: "补充外部调用失败日志，含目标、响应码和重试信息。",
+                });
+            }
+        }
+        if (MIGRATION_KEYWORDS.test(`${file} ${content}`)) {
+            const hasDataModification = /(?:UPDATE|INSERT|DELETE|update\(|save\(|delete\(|remove\()/i.test(content);
+            if (hasDataModification && !/(?:log\.|logger\.|LOG\.|audit|审计)/i.test(content)) {
+                findings.push({
+                    category: "missing_audit_log",
+                    severity: "hard_fail",
+                    file,
+                    evidence: "数据修复/迁移脚本缺少审计日志",
+                    suggestion_zh: "补充审计日志，记录修复前值、后值和影响行数。",
+                });
+            }
+        }
+        if (hasLog && /console\.(log|debug|info)\s*\(/i.test(content) && !/\.(?:test|spec)\./.test(file)) {
+            const isFrontendProd = /\.(?:vue|tsx|jsx|svelte)\b/.test(lowered);
+            findings.push({
+                category: "raw_console_log",
+                severity: isFrontendProd ? "hard_fail" : "warning",
+                file,
+                evidence: "生产代码使用裸 console.log/debug/info",
+                suggestion_zh: isFrontendProd
+                    ? "前端生产代码禁止裸 console 输出，使用项目封装 logger 或移除。"
+                    : "使用项目 logger 替代 console.log，确保日志可追踪和可过滤。",
+            });
+        }
+        if (hasLog) {
+            const logLines = content.match(/(?:log\.info|logger\.info|LOG\.INFO|console\.log)\s*\(\s*["'](?:error|failed|success|done|ok|ok|完成|失败|错误)["']/gi) ?? [];
+            for (const _line of logLines) {
+                findings.push({
+                    category: "unlocatable_log",
+                    severity: "warning",
+                    file,
+                    evidence: "日志仅含通用状态词，无业务对象标识",
+                    suggestion_zh: "日志必须包含事件名、业务对象 ID 和操作上下文，确保可定位。",
+                });
+            }
+        }
+        const loopLogPattern = /(?:for|while|forEach|map|flatMap|reduce)\s*\([^)]*\)\s*\{[^}]*(?:log\.|logger\.|console\.)/i;
+        if (loopLogPattern.test(content) && !/(?:batch|批量|each|every|per.?item)/i.test(content)) {
+            findings.push({
+                category: "noisy_log",
+                severity: "advisory",
+                file,
+                evidence: "循环内可能产生刷屏日志",
+                suggestion_zh: "在循环内使用 DEBUG 级别，或汇总后以单条日志输出。",
+            });
+        }
+    }
+    return findings;
+}
+/* ── Review: 注释质量检测 ─────────────────────── */
+export function reviewCommentQuality(fileContents) {
+    const findings = [];
+    for (const [file, content] of Object.entries(fileContents)) {
+        if (/\.(?:test|spec)\./.test(file))
+            continue;
+        if (COMPLEX_RULE_KEYWORDS.test(`${file} ${content}`)) {
+            const hasFunction = /(?:function\s+\w+|(?:const|let)\s+\w+\s*=\s*(?:async\s+)?\(|(?:public|private|protected)\s+(?:\w+\s+)+\w+\s*\(|def\s+\w+\s*\(|class\s+\w+)/i.test(content);
+            const hasComment = /(?:\/\/|\/\*|\*|<!--)/.test(content);
+            if (hasFunction && !hasComment) {
+                findings.push({
+                    category: "missing_comment_complex",
+                    severity: "warning",
+                    file,
+                    evidence: "复杂业务规则缺少注释",
+                    suggestion_zh: "添加注释说明设计意图（为什么），不得只复述代码行为。",
+                });
+            }
+        }
+        const commentMatches = content.matchAll(/\/\/\s*(.+)|\/\*\s*([\s\S]*?)\s*\*\//g);
+        for (const match of commentMatches) {
+            const commentText = (match[1] ?? match[2] ?? "").trim();
+            if (!commentText)
+                continue;
+            const lineStart = match.index ?? 0;
+            const afterComment = content.slice(lineStart + match[0].length, lineStart + match[0].length + 200);
+            const nextCodeLine = afterComment.split("\n").find((l) => l.trim().length > 0 && !l.trim().startsWith("//") && !l.trim().startsWith("*"));
+            if (nextCodeLine) {
+                const codeStripped = nextCodeLine.replace(/[{}()\[\];,.]/g, "").trim();
+                const commentStripped = commentText.replace(/[{}()\[\];,.]/g, "").trim();
+                const codeLower = codeStripped.toLowerCase();
+                const commentLower = commentStripped.toLowerCase();
+                if (codeLower.length > 10 && commentLower.length > 10) {
+                    const codeWords = new Set(codeLower.split(/\s+/));
+                    const commentWords = new Set(commentLower.split(/\s+/));
+                    let overlap = 0;
+                    const total = Math.max(codeWords.size, commentWords.size);
+                    for (const w of codeWords) {
+                        if (commentWords.has(w) && w.length > 3)
+                            overlap++;
+                    }
+                    if (total > 0 && overlap / total > 0.7) {
+                        findings.push({
+                            category: "verbose_comment",
+                            severity: "advisory",
+                            file,
+                            evidence: `注释仅复述代码: "${commentText.slice(0, 60)}"`,
+                            suggestion_zh: "删除废话注释；如需保留，改为说明设计意图或业务背景。",
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return findings;
+}
+/* ── Review: 项目 logger 使用检查 ─────────────── */
+export function reviewLoggerUsage(fileContents, loggerInfo) {
+    const findings = [];
+    if (loggerInfo.type === "frontend_project" || loggerInfo.type === "none_detected")
+        return findings;
+    for (const [file, content] of Object.entries(fileContents)) {
+        if (/\.(?:test|spec|d\.ts|\.types\.ts)\./.test(file))
+            continue;
+        const hasAnyLog = /(?:log\.|logger\.|LOG\.|console\.)/i.test(content);
+        if (!hasAnyLog)
+            continue;
+        const usesProjectLogger = new RegExp(loggerInfo.call_pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/\\\./g, "\\."), "i").test(content);
+        const usesConsoleDirectly = /console\.(log|debug|info|warn|error)\s*\(/i.test(content);
+        if (usesConsoleDirectly && !usesProjectLogger && loggerInfo.confidence === "high") {
+            findings.push({
+                category: "wrong_logger",
+                severity: "warning",
+                file,
+                evidence: `使用裸 console 而非项目 logger (${loggerInfo.type})`,
+                suggestion_zh: `使用项目 ${loggerInfo.type} logger 确保日志可追踪和可过滤。`,
+            });
+        }
+    }
+    return findings;
+}
+/* ── 综合审查入口 ─────────────────────────────── */
+export function reviewCodeObservability(fileContents, loggerInfo) {
+    const findings = [];
+    findings.push(...detectSensitiveLogs(fileContents));
+    findings.push(...reviewMissingLogs(fileContents));
+    findings.push(...reviewCommentQuality(fileContents));
+    const resolvedLogger = loggerInfo ?? detectProjectLogger(fileContents);
+    findings.push(...reviewLoggerUsage(fileContents, resolvedLogger));
+    return findings;
+}
+/* ── 低风险跳过判断 ───────────────────────────── */
+export function isLowRiskChange(intent, changedFiles = []) {
+    const text = `${intent} ${changedFiles.join(" ")}`;
+    if (/^(?:fix\s+)?(?:typo|错别字|拼写|文案|README|注释样式|格式化|lint|import\s*排序)/i.test(text.trim())) {
+        return { low_risk: true, reason_zh: "纯文案或格式修改，跳过可维护性/可观测性检查" };
+    }
+    if (/^(?:get|set|is|has|can)\w*\s*[\({]/i.test(text.trim()) && changedFiles.length <= 1) {
+        return { low_risk: true, reason_zh: "简单 getter/setter，跳过可维护性/可观测性检查" };
+    }
+    const allStyle = changedFiles.length > 0 && changedFiles.every((f) => /\.(?:css|scss|less|styl|style)$/i.test(f));
+    if (allStyle) {
+        return { low_risk: true, reason_zh: "纯样式修改，跳过可维护性/可观测性检查" };
+    }
+    const allTest = changedFiles.length > 0 && changedFiles.every((f) => /\.(?:test|spec)\./i.test(f));
+    if (allTest && !OBSERVABILITY_KEYWORDS.test(text)) {
+        return { low_risk: true, reason_zh: "纯测试文件修改，跳过可维护性/可观测性检查" };
+    }
+    return { low_risk: false, reason_zh: "" };
+}
+/* ── 阻断判断 ─────────────────────────────────── */
+export function hasBlockingObservabilityFindings(findings) {
+    return findings.some((f) => f.severity === "hard_fail");
+}
+export function hasP1OrAboveFindings(findings) {
+    return findings.some((f) => f.severity === "hard_fail" || f.severity === "warning");
+}
+/* ── sf_verify changed_files 校验 ─────────────── */
+export function verifyChangedFilesObservability(input) {
+    const filtered = {};
+    for (const [file, content] of Object.entries(input.file_contents)) {
+        if (/\.(?:test|spec|d\.ts|\.types\.ts|\.md|\.json|\.yaml|\.yml|\.lock|\.map)$/i.test(file))
+            continue;
+        if (input.changed_files.length > 0 && !input.changed_files.some((cf) => file.endsWith(cf) || cf.endsWith(file)))
+            continue;
+        filtered[file] = content;
+    }
+    if (Object.keys(filtered).length === 0) {
+        return [];
+    }
+    const lowRisk = isLowRiskChange(input.intent, input.changed_files);
+    if (lowRisk.low_risk) {
+        return [{ category: "low_risk_skip", severity: "info", file: "", evidence: lowRisk.reason_zh, suggestion_zh: "" }];
+    }
+    return reviewCodeObservability(filtered);
+}
+/* ── sf_deliver 交付阻断 ──────────────────────── */
+export function evaluateDeliveryBlock(findings) {
+    const blocking = findings.filter((f) => f.severity === "hard_fail"
+        || (f.severity === "warning" && f.category === "missing_comment_complex"));
+    if (blocking.length > 0) {
+        const reasons = blocking.map((f) => `[${f.category}] ${f.file}: ${f.evidence}`).join("\n");
+        return {
+            blocked: true,
+            reason_zh: `代码可维护性/可观测性存在 ${blocking.length} 项阻断:\n${reasons}`,
+            blocking_findings: blocking,
+        };
+    }
+    return { blocked: false, reason_zh: "", blocking_findings: [] };
+}
+//# sourceMappingURL=code_maintainability_observability_contract.js.map

package/dist/engine/code_maintainability_observability_contract.js.map

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

package/dist/engine/config_write_boundary.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 配置落盘边界。
+ *
+ * 区分空项目、已有项目和运行时推断，防止自动推断结果在未确认时写入用户工程。
+ */
+export type ConfigWriteContextKind = "greenfield" | "existing_project" | "runtime_inference";
+export interface ConfigWriteContext {
+    kind: ConfigWriteContextKind;
+    project_path: string;
+    evidence: string[];
+    confirmed: boolean;
+}
+export interface ConfigWriteDecision {
+    allowed: boolean;
+    reason_zh: string;
+    requires_confirmation: boolean;
+}
+export interface WriteBoundaryViolation {
+    target_path: string;
+    reason_zh: string;
+}
+export declare function classifyConfigContext(projectDir: string, opts?: {
+    runtime_inference?: boolean;
+    confirmed?: boolean;
+}): ConfigWriteContext;
+export declare function isWriteAllowed(context: ConfigWriteContext, targetPath: string): ConfigWriteDecision;
+export declare function getWriteConfirmationPrompt(context: ConfigWriteContext, targetPath: string): string;
+export declare function validateWriteBoundary(context: ConfigWriteContext, writes: string[]): WriteBoundaryViolation[];
+//# sourceMappingURL=config_write_boundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config_write_boundary.d.ts","sourceRoot":"","sources":["../../src/engine/config_write_boundary.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE7F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAaD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,kBAAkB,CAYzI;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAsBnG;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIlG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAS7G"}

package/dist/engine/config_write_boundary.js

@@ -0,0 +1,69 @@
+/**
+ * 配置落盘边界。
+ *
+ * 区分空项目、已有项目和运行时推断，防止自动推断结果在未确认时写入用户工程。
+ */
+import fs from "node:fs";
+import path from "node:path";
+const PROJECT_MARKERS = [
+    "package.json",
+    "pom.xml",
+    "build.gradle",
+    "settings.gradle",
+    "pyproject.toml",
+    "go.mod",
+    "Cargo.toml",
+    "src",
+];
+export function classifyConfigContext(projectDir, opts) {
+    if (opts?.runtime_inference) {
+        return { kind: "runtime_inference", project_path: projectDir, evidence: ["runtime_inference"], confirmed: opts.confirmed === true };
+    }
+    const evidence = PROJECT_MARKERS.filter((m) => fs.existsSync(path.join(projectDir, m)));
+    const hasSoloforgeState = fs.existsSync(path.join(projectDir, ".soloforge"))
+        || fs.existsSync(path.join(projectDir, ".mcp.json"))
+        || fs.existsSync(path.join(projectDir, "CLAUDE.md"));
+    if (evidence.length === 0 && !hasSoloforgeState) {
+        return { kind: "greenfield", project_path: projectDir, evidence: ["empty_project"], confirmed: opts?.confirmed === true };
+    }
+    return { kind: "existing_project", project_path: projectDir, evidence, confirmed: opts?.confirmed === true };
+}
+export function isWriteAllowed(context, targetPath) {
+    const normalized = targetPath.replace(/\\/g, "/");
+    const isSoloforgeManaged = normalized.includes(".soloforge/")
+        || normalized.endsWith(".mcp.json")
+        || normalized.endsWith("CLAUDE.md")
+        || normalized.includes(".claude/");
+    if (context.kind === "runtime_inference") {
+        return {
+            allowed: false,
+            reason_zh: "运行时推断结果不得自动落盘，请使用 init --auto 或明确确认后写入。",
+            requires_confirmation: true,
+        };
+    }
+    if (context.kind === "existing_project" && isSoloforgeManaged && !context.confirmed) {
+        return {
+            allowed: false,
+            reason_zh: "已有项目写入 SoloForge 管理文件需要用户确认。",
+            requires_confirmation: true,
+        };
+    }
+    return { allowed: true, reason_zh: "写入边界允许", requires_confirmation: false };
+}
+export function getWriteConfirmationPrompt(context, targetPath) {
+    const decision = isWriteAllowed(context, targetPath);
+    if (decision.allowed)
+        return "无需额外确认。";
+    return `即将向 ${context.kind} 项目写入 ${targetPath}。${decision.reason_zh}`;
+}
+export function validateWriteBoundary(context, writes) {
+    const violations = [];
+    for (const target of writes) {
+        const decision = isWriteAllowed(context, target);
+        if (!decision.allowed) {
+            violations.push({ target_path: target, reason_zh: decision.reason_zh });
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=config_write_boundary.js.map

package/dist/engine/config_write_boundary.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"consumable_asset_registry.d.ts","sourceRoot":"","sources":["../../src/engine/consumable_asset_registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,YAAY,GACZ,UAAU,GACV,kBAAkB,GAClB,WAAW,GACX,eAAe,GACf,YAAY,CAAC;AAEjB,MAAM,MAAM,SAAS,GACjB,qBAAqB,GACrB,oBAAoB,GACpB,mBAAmB,GACnB,0BAA0B,GAC1B,aAAa,GACb,gBAAgB,GAChB,aAAa,GACb,WAAW,GACX,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,2BAA2B,GAC3B,yBAAyB,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,eAAe,CAAC;IAClC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmJD,eAAO,MAAM,yBAAyB,EAAE,kBAAkB,EAo+BzD,CAAC;AAIF;;;GAGG;AACH;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEjF;AAED,wBAAgB,2BAA2B,IAAI,kBAAkB,EAAE,CAElE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAErF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,EAAE,CAEtF"}
+{"version":3,"file":"consumable_asset_registry.d.ts","sourceRoot":"","sources":["../../src/engine/consumable_asset_registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,YAAY,GACZ,UAAU,GACV,kBAAkB,GAClB,WAAW,GACX,eAAe,GACf,YAAY,CAAC;AAEjB,MAAM,MAAM,SAAS,GACjB,qBAAqB,GACrB,oBAAoB,GACpB,mBAAmB,GACnB,0BAA0B,GAC1B,aAAa,GACb,gBAAgB,GAChB,aAAa,GACb,WAAW,GACX,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,2BAA2B,GAC3B,yBAAyB,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,eAAe,CAAC;IAClC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmJD,eAAO,MAAM,yBAAyB,EAAE,kBAAkB,EA0pCzD,CAAC;AAIF;;;GAGG;AACH;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEjF;AAED,wBAAgB,2BAA2B,IAAI,kBAAkB,EAAE,CAElE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAErF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,EAAE,CAEtF"}