soloforge 1.3.2 → 1.3.4

package/dist/engine/ood_solid_contract.js

@@ -0,0 +1,115 @@
+/**
+ * OOD 与 SOLID 实现契约。
+ *
+ * 复杂业务编码在执行前必须给出对象职责与依赖边界；审查和交付阶段
+ * 使用同一套 finding 口径阻断典型的 SOLID 违规。
+ */
+const COMPLEX_OOD_KEYWORDS = /领域|业务规则|状态流转|策略模式|计费策略|订单流转|支付编排|结算规则|工作流编排|重构架构|模块设计|服务设计|领域服务|应用服务设计|domain|aggregate|solid|面向对象|职责拆分|接口抽象|依赖倒置/i;
+const LOW_RISK_KEYWORDS = /错别字|拼写|文案|注释|样式|css|颜色|README|日志文案|配置值|测试数据|fixture/i;
+export function requiresOodSolidContract(intent, route, changedFiles = []) {
+    const text = `${intent} ${changedFiles.join(" ")}`;
+    if (LOW_RISK_KEYWORDS.test(text) && !COMPLEX_OOD_KEYWORDS.test(text))
+        return false;
+    const codeRoute = !route || ["code_change", "artifact_generation", "operation", "multi_stage_plan"].includes(route);
+    return codeRoute && COMPLEX_OOD_KEYWORDS.test(text);
+}
+export function createOodDesignSummary(taskId, intent) {
+    return {
+        task_id: taskId,
+        status: "required",
+        applicability_reason_zh: `该任务涉及复杂对象职责或依赖边界，编码前需补齐 OOD/SOLID 摘要: ${intent}`,
+        objects: [],
+        interfaces: [],
+        dependency_direction: [],
+        change_points: [],
+        solid_risks: [],
+    };
+}
+function hasCompleteDesignSummary(summary) {
+    return !!summary
+        && summary.objects.length > 0
+        && summary.objects.every((item) => item.name.trim().length > 0 && item.responsibility.trim().length > 0)
+        && summary.interfaces.length > 0
+        && summary.dependency_direction.length > 0
+        && summary.change_points.length > 0
+        && summary.solid_risks.length > 0;
+}
+export function evaluateOodDesignGate(input) {
+    if (!requiresOodSolidContract(input.intent, input.route, input.changed_files)) {
+        return {
+            applicable: false,
+            allowed: true,
+            status: "not_applicable",
+            reason_zh: "低风险或非对象设计任务，无需引入 OOD/SOLID 工作包",
+            findings: [],
+        };
+    }
+    if (!hasCompleteDesignSummary(input.summary)) {
+        return {
+            applicable: true,
+            allowed: false,
+            status: "blocked",
+            reason_zh: "复杂编码任务缺少完整 OOD/SOLID 设计摘要，不得开始实现",
+            required_summary: input.summary ?? createOodDesignSummary(input.task_id, input.intent),
+            findings: [],
+        };
+    }
+    return {
+        applicable: true,
+        allowed: true,
+        status: "satisfied",
+        reason_zh: "OOD/SOLID 设计摘要已具备，可进入实现并在审查阶段复验",
+        required_summary: { ...input.summary, status: "satisfied" },
+        findings: [],
+    };
+}
+function addFinding(findings, principle, severity, file, evidence, suggestion_zh) {
+    findings.push({ principle, severity, file, evidence, suggestion_zh });
+}
+export function reviewSolidCode(fileContents) {
+    const findings = [];
+    for (const [file, content] of Object.entries(fileContents)) {
+        const lowered = file.toLowerCase();
+        if (/controller/.test(lowered)
+            && /(?:repository\.|mapper\.|entitymanager|save\s*\(|@Transactional|calculate|compute)/i.test(content)) {
+            addFinding(findings, "SRP", "hard_fail", file, "Controller 同时出现持久化、事务或业务计算职责", "将业务规则与持久化移入应用服务，Controller 仅处理协议适配、校验和响应映射。");
+        }
+        if (/(?:service|usecase|application)/.test(lowered)
+            && /new\s+(?:RestTemplate|WebClient|HttpClient|Stripe|S3|OpenAI|Twilio|Axios|.*Repository)\s*\(/i.test(content)) {
+            addFinding(findings, "DIP", "hard_fail", file, "业务服务直接构造外部依赖或仓储实现", "通过端口接口与依赖注入隔离基础设施实现。");
+        }
+        if (/interface\s+\w+[\s\S]{0,800}(?:upload|export|notify|delete|approve)[\s\S]{0,800}(?:upload|export|notify|delete|approve)/i.test(content)
+            && /(?:UnsupportedOperationException|throw new Error\(['\"]not implemented)/i.test(content)) {
+            addFinding(findings, "ISP", "hard_fail", file, "实现被迫抛出未支持操作，接口职责过宽", "拆分为客户端真正需要的细粒度接口。");
+        }
+        if (/(?:extends|implements)\s+\w+[\s\S]{0,500}(?:UnsupportedOperationException|throw new Error\(['\"]unsupported)/i.test(content)) {
+            addFinding(findings, "LSP", "hard_fail", file, "子类型拒绝父契约操作", "重构抽象层级，确保替换后仍满足原契约。");
+        }
+        const branching = (content.match(/\b(?:if|else if|switch)\s*\([^)]*(?:type|status|kind|strategy)/gi) ?? []).length;
+        if (branching >= 3) {
+            addFinding(findings, "OCP", "warning", file, "同一变化维度出现多处分支扩展点", "用策略/处理器注册方式隔离新增类型，减少修改既有分支。");
+        }
+        if (/(?:component|page|\.tsx$|\.vue$)/.test(lowered)
+            && /(?:fetch\(|axios\.|apiClient|request\()/i.test(content)
+            && /(?:useState|useEffect|computed\(|ref\(|watch\()/i.test(content)
+            && /(?:if\s*\(|switch\s*\()/i.test(content)) {
+            addFinding(findings, "SRP", "hard_fail", file, "复杂 UI 组件混合远程调用、状态编排与业务判断", "拆分展示组件、状态 hook/composable 与 API client/业务服务。");
+        }
+    }
+    return findings;
+}
+export function hasBlockingSolidFindings(findings) {
+    return findings.some((finding) => finding.severity === "hard_fail");
+}
+export function evaluateOverdesignRisk(intent, summary) {
+    if (!LOW_RISK_KEYWORDS.test(intent) || !summary || summary.objects.length < 4)
+        return [];
+    return [{
+            principle: "OVERDESIGN",
+            severity: "warning",
+            file: "OOD设计摘要",
+            evidence: "低风险修改引入多个对象与抽象边界",
+            suggestion_zh: "保持最小实现，不为简单修改提前引入复杂对象结构。",
+        }];
+}
+//# sourceMappingURL=ood_solid_contract.js.map

package/dist/engine/ood_solid_contract.js.map

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

package/dist/engine/project_stage_detector.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 项目阶段检测器 — 问题六十五。
+ *
+ * 综合项目状态（配置、知识、设计产物、任务）判断当前项目生命周期阶段。
+ * 不只看一个字段，综合 config、knowledge、design、task 多维信号。
+ */
+import type { ProjectStage, StageExplanation } from "./workflow_navigation_contract.js";
+/**
+ * 检测项目当前所处阶段。
+ * 综合判断: config 存在性/确认状态、knowledge 可用性、设计产物状态、任务执行状态。
+ */
+export declare function detectProjectStage(projectPath: string): Promise<ProjectStage>;
+/**
+ * 获取项目阶段的中文解释。
+ */
+export declare function explainProjectStage(stage: ProjectStage): StageExplanation;
+//# sourceMappingURL=project_stage_detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project_stage_detector.d.ts","sourceRoot":"","sources":["../../src/engine/project_stage_detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAIxF;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA8HnF;AAsDD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CASzE"}

package/dist/engine/project_stage_detector.js

@@ -0,0 +1,185 @@
+/**
+ * 项目阶段检测器 — 问题六十五。
+ *
+ * 综合项目状态（配置、知识、设计产物、任务）判断当前项目生命周期阶段。
+ * 不只看一个字段，综合 config、knowledge、design、task 多维信号。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { resolveProjectConfig, getProjectKnowledgeDir } from "../knowledge/loader.js";
+import { debug } from "./logger.js";
+/**
+ * 检测项目当前所处阶段。
+ * 综合判断: config 存在性/确认状态、knowledge 可用性、设计产物状态、任务执行状态。
+ */
+export async function detectProjectStage(projectPath) {
+    debug("项目阶段检测", "开始检测", projectPath);
+    const soloforgeDir = path.join(projectPath, ".soloforge");
+    const configPath = path.join(soloforgeDir, "config.yaml");
+    // 1. 未初始化
+    if (!fs.existsSync(soloforgeDir)) {
+        return "uninitialized";
+    }
+    // 2. 已初始化但未持久化配置，不能重复建议 init
+    if (!fs.existsSync(configPath)) {
+        return "configuration_pending";
+    }
+    // 3. 配置未确认
+    const evidencePath = path.join(soloforgeDir, "config.evidence.json");
+    if (!fs.existsSync(evidencePath)) {
+        return "configuration_pending";
+    }
+    try {
+        const evidenceRaw = JSON.parse(fs.readFileSync(evidencePath, "utf-8"));
+        const confirmedFields = Object.values(evidenceRaw.fields ?? {});
+        const allConfirmed = confirmedFields.length > 0
+            && confirmedFields.every((f) => f.confidence === "high"
+                && (f.confidence_source === "confirmed" || f.confidence_source === "detected"));
+        if (!allConfirmed) {
+            return "configuration_pending";
+        }
+    }
+    catch {
+        return "configuration_pending";
+    }
+    // 3. 知识就绪检查
+    let config;
+    try {
+        const resolved = await resolveProjectConfig(projectPath);
+        config = resolved.config;
+    }
+    catch {
+        return "configuration_pending";
+    }
+    const knowledgeDir = getProjectKnowledgeDir(config);
+    const hasKnowledge = fs.existsSync(knowledgeDir);
+    if (!hasKnowledge) {
+        return "knowledge_ready";
+    }
+    // 4-6. 检查任务状态和设计产物
+    const stateDir = path.join(soloforgeDir, "state");
+    let hasDesignInProgress = false;
+    let hasDesignReady = false;
+    let hasExecutingTask = false;
+    let hasVerifiedDeliveryReady = false;
+    let hasDelivered = false;
+    if (fs.existsSync(stateDir)) {
+        const taskFiles = fs.readdirSync(stateDir).filter((f) => f.startsWith("task-") && f.endsWith(".json"));
+        for (const tf of taskFiles) {
+            try {
+                const task = JSON.parse(fs.readFileSync(path.join(stateDir, tf), "utf-8"));
+                // 设计产物检查
+                const designPack = task.design_artifact_pack;
+                if (designPack) {
+                    if (designPack.status === "implementation_ready" || designPack.status === "confirmed") {
+                        hasDesignReady = true;
+                    }
+                    else if (designPack.status && designPack.status !== "superseded") {
+                        hasDesignInProgress = true;
+                    }
+                }
+                // 任务执行状态
+                const status = task.status;
+                if (["executing", "verifying", "learning"].includes(status)) {
+                    hasExecutingTask = true;
+                }
+                // 交付就绪
+                if (status === "done" && task.verification?.status === "passed") {
+                    if (task.delivery?.delivery_executed) {
+                        hasDelivered = true;
+                    }
+                    else {
+                        hasVerifiedDeliveryReady = true;
+                    }
+                }
+            }
+            catch {
+                // 忽略损坏的任务文件
+            }
+        }
+    }
+    // 8. 已发布
+    if (hasDelivered) {
+        return "released";
+    }
+    // 7. 交付就绪
+    if (hasVerifiedDeliveryReady) {
+        return "delivery_ready";
+    }
+    // 6. 开发中
+    if (hasExecutingTask) {
+        return "development_in_progress";
+    }
+    // 5. 实现就绪（设计通过审计）
+    if (hasDesignReady) {
+        return "implementation_ready";
+    }
+    // 4. 设计进行中
+    if (hasDesignInProgress) {
+        return "design_in_progress";
+    }
+    // 3. 知识就绪（默认）
+    return "knowledge_ready";
+}
+/** 项目阶段中文标签映射 */
+const PROJECT_STAGE_LABELS = {
+    uninitialized: "未初始化",
+    configuration_pending: "配置待确认",
+    knowledge_ready: "知识就绪",
+    design_in_progress: "设计进行中",
+    implementation_ready: "实现就绪",
+    development_in_progress: "开发进行中",
+    delivery_ready: "交付就绪",
+    released: "已发布",
+    post_release_observation: "发布后观察",
+};
+/** 项目阶段中文描述 */
+const PROJECT_STAGE_DESCRIPTIONS = {
+    uninitialized: "项目尚未运行 soloforge init，缺少 .soloforge/ 目录或配置文件",
+    configuration_pending: "配置文件存在但字段尚未确认，建议运行 soloforge config confirm 确认关键字段",
+    knowledge_ready: "配置已确认、知识库已就绪，可以开始接收开发任务",
+    design_in_progress: "架构/数据库/API 设计产物正在进行中，尚未通过审计",
+    implementation_ready: "设计产物已通过审计复验，可以开始编码实现",
+    development_in_progress: "已有任务在编码/验证阶段",
+    delivery_ready: "任务已通过验证，准备交付",
+    released: "已发布上线",
+    post_release_observation: "发布后观察期，建议验证、监控、收集反馈",
+};
+/** 项目阶段必要证据 */
+const PROJECT_STAGE_EVIDENCE = {
+    uninitialized: [],
+    configuration_pending: [".soloforge/config.yaml 存在"],
+    knowledge_ready: ["config 已确认", "knowledge 目录存在"],
+    design_in_progress: ["design_artifact_pack 状态非 implementation_ready"],
+    implementation_ready: ["design_artifact_pack.status === implementation_ready"],
+    development_in_progress: ["存在 executing/verifying/learning 状态任务"],
+    delivery_ready: ["任务验证通过", "delivery readiness 评估通过"],
+    released: ["delivery 已执行"],
+    post_release_observation: ["已发布"],
+};
+/** 项目阶段可能的下一阶段 */
+const PROJECT_STAGE_NEXT = {
+    uninitialized: ["configuration_pending"],
+    configuration_pending: ["knowledge_ready", "uninitialized"],
+    knowledge_ready: ["design_in_progress", "development_in_progress"],
+    design_in_progress: ["implementation_ready"],
+    implementation_ready: ["development_in_progress"],
+    development_in_progress: ["delivery_ready"],
+    delivery_ready: ["released"],
+    released: ["post_release_observation"],
+    post_release_observation: [],
+};
+/**
+ * 获取项目阶段的中文解释。
+ */
+export function explainProjectStage(stage) {
+    return {
+        stage,
+        level: "project",
+        label_zh: PROJECT_STAGE_LABELS[stage],
+        description_zh: PROJECT_STAGE_DESCRIPTIONS[stage],
+        required_evidence: PROJECT_STAGE_EVIDENCE[stage],
+        next_possible_stages: PROJECT_STAGE_NEXT[stage],
+    };
+}
+//# sourceMappingURL=project_stage_detector.js.map

package/dist/engine/project_stage_detector.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"release_issue_scenario_registry.d.ts","sourceRoot":"","sources":["../../src/engine/release_issue_scenario_registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,gBAAgB,CAAC,EAAE;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,wBAAwB,CAAC,EAAE,OAAO,CAAC;QACnC,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe;IACf,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAChD;AAyzCD,eAAe;AACf,wBAAgB,wBAAwB,IAAI,aAAa,EAAE,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IAAC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAAC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAqCzL;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAavF"}
+{"version":3,"file":"release_issue_scenario_registry.d.ts","sourceRoot":"","sources":["../../src/engine/release_issue_scenario_registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,gBAAgB,CAAC,EAAE;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,wBAAwB,CAAC,EAAE,OAAO,CAAC;QACnC,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe;IACf,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAChD;AA+hDD,eAAe;AACf,wBAAgB,wBAAwB,IAAI,aAAa,EAAE,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IAAC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAAC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAqCzL;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAavF"}

package/dist/engine/release_issue_scenario_registry.js

@@ -396,7 +396,20 @@ const RELEASE_ISSUE_SCENARIOS = [
                         task_id: taskId,
                         decision_workshop: genericWorkshop,
                     });
-                    harness.parseResult(exp2Raw);
+                    const exp2 = harness.parseResult(exp2Raw);
+                    if (exp2.diagnostic_code === "SF-OOD-6601") {
+                        const summary = exp2.ood_solid_summary;
+                        summary.objects = [{ name: "ReleaseValidationService", responsibility: "编排发布验证和回滚策略" }];
+                        summary.interfaces = ["ReleaseVerifier", "RollbackExecutor"];
+                        summary.dependency_direction = ["ReleaseValidationService -> ReleaseVerifier"];
+                        summary.change_points = ["验证策略", "回滚策略"];
+                        summary.solid_risks = ["DIP: 执行器通过接口注入", "SRP: 发布编排不承担部署细节"];
+                        await harness.callTool("sf_expand", {
+                            task_id: taskId,
+                            decision_workshop: genericWorkshop,
+                            ood_solid_summary: summary,
+                        });
+                    }
                 }
                 await harness.setupPlanGate(taskId);
                 // 验证前置: sf_verify → sf_record_verification_execution
@@ -1282,6 +1295,222 @@ const RELEASE_ISSUE_SCENARIOS = [
             }
         },
     },
+    // ── 问题六十八: 代码可维护性与可观测性契约 ──
+    {
+        scenario_id: "release-scenario-code-observability-payment-status-no-log",
+        covering_problem: "problem-68",
+        test_files: ["tests/engine/code_maintainability_observability_contract.test.ts"],
+        production_entrypoint: "sf_expand → CodeObservabilityGate → sf_review → reviewMissingLogs → sf_deliver → evaluateDeliveryBlock",
+        expected_outcome: "支付/账单状态更新缺少业务日志 → hard_fail 阻断交付",
+        runner: async () => {
+            const mod = await import("./code_maintainability_observability_contract.js");
+            const findings = mod.reviewMissingLogs({
+                "PaymentService.java": `public void refund(String orderId, BigDecimal amount) {
+  orderRepository.save(order);
+  paymentGateway.refund(orderId, amount);
+}`,
+            });
+            const blocked = mod.hasBlockingObservabilityFindings(findings);
+            return {
+                scenario_id: "release-scenario-code-observability-payment-status-no-log",
+                status: blocked ? "pass" : "fail",
+                evidence: blocked ? "hard_fail: 支付写操作无日志被检测到" : "未检测到支付写操作无日志",
+                production_trace: { tool_entrypoint: "reviewMissingLogs", diagnostic_codes: [blocked ? "hard_fail" : "missed"], gates_consumed: ["sf_review"] },
+            };
+        },
+    },
+    {
+        scenario_id: "release-scenario-code-observability-permission-denied-no-log",
+        covering_problem: "problem-68",
+        test_files: ["tests/engine/code_maintainability_observability_contract.test.ts"],
+        production_entrypoint: "sf_expand → CodeObservabilityGate → sf_review → reviewMissingLogs → sf_deliver → evaluateDeliveryBlock",
+        expected_outcome: "权限拒绝无安全日志 → hard_fail 阻断",
+        runner: async () => {
+            const mod = await import("./code_maintainability_observability_contract.js");
+            const findings = mod.reviewMissingLogs({
+                "AuthController.java": `public void checkPermission(String userId, String resource) {
+  if (!roleService.hasAccess(userId, resource)) {
+    throw new AccessDeniedException("forbidden");
+  }
+}`,
+            });
+            const blocked = mod.hasBlockingObservabilityFindings(findings);
+            return {
+                scenario_id: "release-scenario-code-observability-permission-denied-no-log",
+                status: blocked ? "pass" : "fail",
+                evidence: blocked ? "hard_fail: 权限拒绝无日志被检测到" : "未检测到权限拒绝无日志",
+                production_trace: { tool_entrypoint: "reviewMissingLogs", diagnostic_codes: [blocked ? "hard_fail" : "missed"], gates_consumed: ["sf_review"] },
+            };
+        },
+    },
+    {
+        scenario_id: "release-scenario-code-observability-catch-swallow",
+        covering_problem: "problem-68",
+        test_files: ["tests/engine/code_maintainability_observability_contract.test.ts"],
+        production_entrypoint: "sf_expand → CodeObservabilityGate → sf_review → reviewMissingLogs → sf_deliver → evaluateDeliveryBlock",
+        expected_outcome: "catch 后吞异常无日志 → hard_fail 阻断",
+        runner: async () => {
+            const mod = await import("./code_maintainability_observability_contract.js");
+            const findings = mod.reviewMissingLogs({
+                "OrderService.ts": `async processOrder(orderId: string) {
+  try {
+    await this.client.submit(orderId);
+  } catch (e) {
+    return false;
+  }
+}`,
+            });
+            const blocked = mod.hasBlockingObservabilityFindings(findings);
+            return {
+                scenario_id: "release-scenario-code-observability-catch-swallow",
+                status: blocked ? "pass" : "fail",
+                evidence: blocked ? "hard_fail: catch 吞异常被检测到" : "未检测到 catch 吞异常",
+                production_trace: { tool_entrypoint: "reviewMissingLogs", diagnostic_codes: [blocked ? "hard_fail" : "missed"], gates_consumed: ["sf_review"] },
+            };
+        },
+    },
+    {
+        scenario_id: "release-scenario-code-observability-sensitive-log",
+        covering_problem: "problem-68",
+        test_files: ["tests/engine/code_maintainability_observability_contract.test.ts"],
+        production_entrypoint: "sf_expand → CodeObservabilityGate → sf_review → detectSensitiveLogs → sf_deliver → evaluateDeliveryBlock",
+        expected_outcome: "日志输出 token/password/手机号全量 → hard_fail 阻断",
+        runner: async () => {
+            const mod = await import("./code_maintainability_observability_contract.js");
+            const findings = mod.detectSensitiveLogs({
+                "UserService.ts": `function login(user) {
+  logger.info("user login", { token: "eyJhbGciOiJIUzI1NiJ9.xxxxx", password: user.password, phone: "13812345678" });
+}`,
+            });
+            const blocked = mod.hasBlockingObservabilityFindings(findings);
+            return {
+                scenario_id: "release-scenario-code-observability-sensitive-log",
+                status: blocked ? "pass" : "fail",
+                evidence: blocked ? `hard_fail: 敏感信息泄漏被检测到 (${findings.length} findings)` : "未检测到敏感信息泄漏",
+                production_trace: { tool_entrypoint: "detectSensitiveLogs", diagnostic_codes: [blocked ? "hard_fail" : "missed"], gates_consumed: ["sf_review"] },
+            };
+        },
+    },
+    {
+        scenario_id: "release-scenario-code-observability-complex-rule-no-comment",
+        covering_problem: "problem-68",
+        test_files: ["tests/engine/code_maintainability_observability_contract.test.ts"],
+        production_entrypoint: "sf_expand → CodeObservabilityGate → sf_review → reviewCommentQuality → sf_deliver",
+        expected_outcome: "复杂金额计算无注释 → warning",
+        runner: async () => {
+            const mod = await import("./code_maintainability_observability_contract.js");
+            const findings = mod.reviewCommentQuality({
+                "BillingService.java": `// 金额计算逻辑
+public BigDecimal calculateSubsidy(Order order) {
+  BigDecimal base = order.getAmount().multiply(new BigDecimal("0.8"));
+  BigDecimal discount = base.subtract(order.getDeducted());
+  return discount.max(BigDecimal.ZERO);
+}`,
+            });
+            const hasCommentWarning = findings.some(f => f.category === "missing_comment_complex");
+            // 上面有注释不会触发缺失检测；下面测试无注释的负例：
+            const findingsNoComment = mod.reviewCommentQuality({
+                "金额计算/BillingService.java": `public BigDecimal calculateSubsidy(Order order) {
+  BigDecimal base = order.getAmount().multiply(new BigDecimal("0.8"));
+  BigDecimal discount = base.subtract(order.getDeducted());
+  return discount.max(BigDecimal.ZERO);
+}`,
+            });
+            const detected = findingsNoComment.some(f => f.category === "missing_comment_complex");
+            return {
+                scenario_id: "release-scenario-code-observability-complex-rule-no-comment",
+                status: detected ? "pass" : "fail",
+                evidence: detected ? "warning: 无注释复杂逻辑被检测到" : "未检测到无注释复杂逻辑",
+                production_trace: { tool_entrypoint: "reviewCommentQuality", diagnostic_codes: [detected ? "warning" : "missed"], gates_consumed: ["sf_review"] },
+            };
+        },
+    },
+    {
+        scenario_id: "release-scenario-code-observability-low-risk-skip",
+        covering_problem: "problem-68",
+        test_files: ["tests/engine/code_maintainability_observability_contract.test.ts"],
+        production_entrypoint: "sf_classify → sf_expand (低风险) → 不触发可观测性门禁",
+        expected_outcome: "简单文案修改不触发代码可维护性/可观测性契约",
+        runner: async () => {
+            const { createToolHarness } = await import("./release_tool_harness.js");
+            const harness = await createToolHarness();
+            try {
+                const intent = "修复 README 文案错别字";
+                const clsRaw = await harness.callTool("sf_classify", { intent });
+                const cls = harness.parseResult(clsRaw);
+                const taskId = cls.task_id;
+                if (!taskId)
+                    return { scenario_id: "release-scenario-code-observability-low-risk-skip", status: "fail", error: "sf_classify 未返回 task_id" };
+                const expRaw = await harness.callTool("sf_expand", { task_id: taskId });
+                const exp = harness.parseResult(expRaw);
+                // 低风险任务不应触发 SF-OBS-6801 诊断码
+                const notBlocked = exp.diagnostic_code !== "SF-OBS-6801";
+                return {
+                    scenario_id: "release-scenario-code-observability-low-risk-skip",
+                    status: notBlocked ? "pass" : "fail",
+                    evidence: notBlocked ? "低风险任务正确跳过可观测性门禁" : "低风险任务被错误触发可观测性门禁",
+                    production_trace: { tool_entrypoint: "sf_classify+sf_expand", diagnostic_codes: [exp.status ?? "ok", exp.diagnostic_code ?? "none"], gates_consumed: ["sf_classify", "sf_expand"] },
+                };
+            }
+            catch (e) {
+                return { scenario_id: "release-scenario-code-observability-low-risk-skip", status: "fail", error: e.message };
+            }
+            finally {
+                await harness.cleanup();
+            }
+        },
+    },
+    {
+        scenario_id: "release-scenario-code-observability-project-logger-detected",
+        covering_problem: "problem-68",
+        test_files: ["tests/engine/code_maintainability_observability_contract.test.ts"],
+        production_entrypoint: "sf_expand → CodeObservabilityGate → detectProjectLogger",
+        expected_outcome: "Java/Spring/Node/NestJS 项目能正确检测 logger 类型",
+        runner: async () => {
+            const mod = await import("./code_maintainability_observability_contract.js");
+            const javaLogger = mod.detectProjectLogger({
+                "Application.java": "import org.slf4j.LoggerFactory; private static final Logger log = LoggerFactory.getLogger(App.class);",
+            });
+            const pinoLogger = mod.detectProjectLogger({
+                "index.ts": "import pino from 'pino'; const logger = pino();",
+            });
+            const nestjsLogger = mod.detectProjectLogger({
+                "app.service.ts": "import { Logger } from '@nestjs/common';",
+            });
+            const ok = javaLogger.type === "slf4j" && pinoLogger.type === "pino" && nestjsLogger.type === "nestjs_logger";
+            return {
+                scenario_id: "release-scenario-code-observability-project-logger-detected",
+                status: ok ? "pass" : "fail",
+                evidence: ok ? `检测: ${javaLogger.type}, ${pinoLogger.type}, ${nestjsLogger.type}` : `检测失败: ${javaLogger.type}, ${pinoLogger.type}, ${nestjsLogger.type}`,
+                production_trace: { tool_entrypoint: "detectProjectLogger", diagnostic_codes: [javaLogger.type, pinoLogger.type, nestjsLogger.type], gates_consumed: ["sf_expand"] },
+            };
+        },
+    },
+    {
+        scenario_id: "release-scenario-code-observability-migration-audit-log",
+        covering_problem: "problem-68",
+        test_files: ["tests/engine/code_maintainability_observability_contract.test.ts"],
+        production_entrypoint: "sf_expand → CodeObservabilityGate → sf_review → reviewMissingLogs → sf_deliver",
+        expected_outcome: "迁移脚本/数据修复无审计日志 → hard_fail",
+        runner: async () => {
+            const mod = await import("./code_maintainability_observability_contract.js");
+            const findings = mod.reviewMissingLogs({
+                "scripts/data_fix_order_status.ts": `async function migrateOrderStatus() {
+  const orders = await db.query("SELECT * FROM orders WHERE status IS NULL");
+  for (const order of orders) {
+    await db.update("UPDATE orders SET status = 'pending' WHERE id = ?", [order.id]);
+  }
+}`,
+            });
+            const blocked = mod.hasBlockingObservabilityFindings(findings);
+            return {
+                scenario_id: "release-scenario-code-observability-migration-audit-log",
+                status: blocked ? "pass" : "fail",
+                evidence: blocked ? "hard_fail: 迁移脚本无审计日志被检测到" : "未检测到迁移脚本无审计日志",
+                production_trace: { tool_entrypoint: "reviewMissingLogs", diagnostic_codes: [blocked ? "hard_fail" : "missed"], gates_consumed: ["sf_review"] },
+            };
+        },
+    },
 ];
 /** 获取全量场景定义 */
 export function getReleaseIssueScenarios() {