soloforge 1.1.38 → 1.1.40

package/dist/bin/commands/reasoning.js

@@ -0,0 +1,158 @@
+import { debug, userInfo } from "../../engine/core/logger.js";
+import { resolveProjectPath, args } from "../args.js";
+/**
+ * soloforge 头脑风暴 [主题]
+ * soloforge 第一性原理 [主题]
+ * soloforge 推理记录 [--stage <阶段>] [--limit <数量>]
+ *
+ * 跨阶段通用 CLI 入口 — 场景 C（无 MCP 兜底）。
+ */
+/** 头脑风暴 CLI 命令 */
+export async function cmdBrainstorm() {
+    debug("CLI", "执行 cmdBrainstorm");
+    const projectPath = resolveProjectPath();
+    const topic = args.filter((a) => !a.startsWith("--")).join(" ") || "未指定主题";
+    userInfo("╔══════════════════════════════════════════════════╗");
+    userInfo("║         头脑风暴模式（不确定时决策辅助）          ║");
+    userInfo("╚══════════════════════════════════════════════════╝");
+    userInfo("");
+    userInfo(`主题: ${topic}`);
+    userInfo(`项目: ${projectPath}`);
+    userInfo("");
+    // 加载头脑风暴流程模板
+    try {
+        const fs = await import("node:fs/promises");
+        const path = await import("node:path");
+        const templatePath = path.join(projectPath, ".soloforge", "templates", "procedures", "不确定时头脑风暴流程.md");
+        const templateExists = await fs.access(templatePath).then(() => true).catch(() => false);
+        if (templateExists) {
+            userInfo("📋 流程指引: .soloforge/templates/procedures/不确定时头脑风暴流程.md");
+        }
+        else {
+            userInfo("📋 流程指引: templates/procedures/不确定时头脑风暴流程.md（源模板）");
+        }
+    }
+    catch {
+        // 忽略文件系统错误
+    }
+    userInfo("");
+    userInfo("六步流程:");
+    userInfo("  1. 识别不确定类型（需求不明确 / 技术选型开放 / 方案冲突 / AI 自检不确定）");
+    userInfo("  2. 列举候选方案（≥ 3 个，每个含优势/劣势/适用场景）");
+    userInfo("  3. 标注 AI 偏好（推荐/可选/不推荐 + 理由）");
+    userInfo("  4. 以对比表格呈现给用户");
+    userInfo("  5. 用户明确选择一个方案");
+    userInfo("  6. 将选择记录到对应阶段产物");
+    userInfo("");
+    // 检查是否需要先触发 FP-01
+    const hasFundamentalNeed = args.includes("--has-fundamental-need");
+    if (!hasFundamentalNeed) {
+        userInfo("⚠️  若 fundamental_need 未声明，须先执行: soloforge 第一性原理 <主题>");
+    }
+}
+/** 第一性原理 CLI 命令 */
+export async function cmdFirstPrinciples() {
+    debug("CLI", "执行 cmdFirstPrinciples");
+    const projectPath = resolveProjectPath();
+    const topic = args.filter((a) => !a.startsWith("--")).join(" ") || "未指定主题";
+    userInfo("╔══════════════════════════════════════════════════╗");
+    userInfo("║         第一性原理推理模式                        ║");
+    userInfo("╚══════════════════════════════════════════════════╝");
+    userInfo("");
+    userInfo(`主题: ${topic}`);
+    userInfo(`项目: ${projectPath}`);
+    userInfo("");
+    // 执行 FP 规则检查
+    try {
+        const { checkFirstPrinciples } = await import("../../engine/contracts/first_principles.js");
+        // 从命令行参数构建检查上下文
+        const stage = args.includes("--stage") ? args[args.indexOf("--stage") + 1] : "需求分析";
+        const ctx = {
+            stage,
+            fundamental_need: args.includes("--fundamental-need") ? args[args.indexOf("--fundamental-need") + 1] : undefined,
+            reasoning_chain: args.includes("--reasoning-chain") ? [args[args.indexOf("--reasoning-chain") + 1]] : undefined,
+            fix_history: [],
+            old_terms: [],
+            new_terms: [],
+        };
+        const results = checkFirstPrinciples(ctx);
+        userInfo("FP 规则检查结果:");
+        for (const r of results) {
+            const icon = r.passed ? "✅" : (r.severity === "error" ? "🔴" : "🟡");
+            userInfo(`  ${icon} ${r.rule_id}: ${r.message}`);
+        }
+        userInfo("");
+    }
+    catch (err) {
+        debug("CLI", `FP 检查失败: ${err instanceof Error ? err.message : String(err)}`);
+        // 降级：仅展示指引
+        userInfo("FP-01~04 检查清单:");
+        userInfo("  FP-01 [error]:   fundamental_need 是否声明？（不得以解决方案开头）");
+        userInfo("  FP-02 [error]:   推理链是否至少 3 步？（目标→约束→可选方案→选定方案）");
+        userInfo("  FP-03 [warning]: 同模块是否反复修复？（≥ 3 次触发根因分析）");
+        userInfo("  FP-04 [warning]: 术语替换是否伴随语义变更？（不能仅换词不换逻辑）");
+        userInfo("");
+    }
+    userInfo("参考: templates/rules/shared/第一性原理推理规则.md");
+}
+/** 推理记录 CLI 命令 */
+export async function cmdReasoningLog() {
+    debug("CLI", "执行 cmdReasoningLog");
+    const projectPath = resolveProjectPath();
+    const stage = args.includes("--stage") ? args[args.indexOf("--stage") + 1] : undefined;
+    const limit = args.includes("--limit") ? (parseInt(args[args.indexOf("--limit") + 1], 10) || 10) : 10;
+    userInfo("╔══════════════════════════════════════════════════╗");
+    userInfo("║         推理记录查看                             ║");
+    userInfo("╚══════════════════════════════════════════════════╝");
+    userInfo("");
+    userInfo(`项目: ${projectPath}`);
+    if (stage)
+        userInfo(`阶段: ${stage}`);
+    userInfo(`限制: ${limit} 条`);
+    userInfo("");
+    // 尝试读取管线状态中的审计日志
+    try {
+        const fs = await import("node:fs/promises");
+        const path = await import("node:path");
+        // 查找管线状态文件
+        const stateDir = path.join(projectPath, ".soloforge", "state");
+        const files = await fs.readdir(stateDir).catch(() => []);
+        const pipelineFiles = files.filter((f) => f.startsWith("pipeline-") && f.endsWith(".yaml"));
+        if (pipelineFiles.length === 0) {
+            userInfo("未找到管线状态文件。请先执行 soloforge init 初始化项目。");
+            return;
+        }
+        // 读取最新管线文件
+        let count = 0;
+        for (const pf of pipelineFiles) {
+            const content = await fs.readFile(path.join(stateDir, pf), "utf-8");
+            const lines = content.split("\n");
+            userInfo(`管线: ${pf}`);
+            userInfo("─".repeat(50));
+            for (const line of lines) {
+                if (count >= limit)
+                    break;
+                // 查找与 FP 规则 / 头脑风暴 / 第一性原理相关的审计记录
+                if (line.includes("FP-0") || line.includes("brainstorm") || line.includes("first_principles") ||
+                    line.includes("头脑风暴") || line.includes("第一性原理") || line.includes("fundamental_need")) {
+                    userInfo(`  ${line.trim()}`);
+                    count++;
+                }
+            }
+            if (stage) {
+                userInfo(`  (筛选阶段: ${stage})`);
+            }
+        }
+        if (count === 0) {
+            userInfo("未找到与 FP 规则/头脑风暴相关的推理记录。");
+        }
+        else {
+            userInfo(`\n共 ${count} 条记录。`);
+        }
+    }
+    catch (err) {
+        userInfo(`无法读取管线状态: ${err instanceof Error ? err.message : String(err)}`);
+        userInfo("请确保项目已初始化（soloforge init）且存在管线状态。");
+    }
+}
+//# sourceMappingURL=reasoning.js.map

package/dist/bin/commands/reasoning.js.map

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

package/dist/bin/commands/review.d.ts

@@ -0,0 +1,7 @@
+/**
+ * soloforge review <产物路径>
+ *
+ * 脱离管线审查产物。自动读取 companion_rules 中的 :review 规则。
+ */
+export declare function cmdReview(): Promise<void>;
+//# sourceMappingURL=review.d.ts.map

package/dist/bin/commands/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/review.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA8E/C"}

package/dist/bin/commands/review.js

@@ -0,0 +1,79 @@
+import fs from "node:fs";
+import path from "node:path";
+import { debug, userInfo, userError } from "../../engine/core/logger.js";
+import { resolveProjectPath, args } from "../args.js";
+/**
+ * soloforge review <产物路径>
+ *
+ * 脱离管线审查产物。自动读取 companion_rules 中的 :review 规则。
+ */
+export async function cmdReview() {
+    debug("CLI", "执行 cmdReview");
+    const projectPath = resolveProjectPath();
+    const positional = args.filter((a) => !a.startsWith("--"));
+    const isJson = args.includes("--json");
+    if (positional.length === 0) {
+        userError("用法: soloforge review <产物路径> [--json]");
+        process.exit(1);
+    }
+    const productPath = path.resolve(projectPath, positional[0]);
+    if (!fs.existsSync(productPath)) {
+        userError(`文件不存在: ${productPath}`);
+        process.exit(1);
+    }
+    try {
+        const { parseCompanionRules } = await import("../../engine/context_engine/companion_injector.js");
+        const content = fs.readFileSync(productPath, "utf-8");
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        const appliedRules = [];
+        if (fmMatch) {
+            const fm = fmMatch[1];
+            const rulesField = fm.match(/companion_rules:\s*\[([^\]]*)\]/);
+            if (rulesField) {
+                const rawRules = rulesField[1].split(",").map((s) => s.trim().replace(/['"]/g, ""));
+                const rules = parseCompanionRules(rawRules);
+                const reviewRules = rules.filter((r) => r.usage === "review");
+                appliedRules.push(...reviewRules.map((r) => r.fileName));
+            }
+        }
+        // 基本结构检查
+        const findings = [];
+        const body = content.replace(/^---\n[\s\S]*?\n---\n*/, "");
+        if (body.trim().length === 0) {
+            findings.push({ dimension: "structure", status: "fail", detail: "产物正文为空" });
+        }
+        // 检查空洞章节
+        const sectionRegex = /^## .+$/gm;
+        const sections = body.match(sectionRegex) || [];
+        for (const section of sections) {
+            const sectionTitle = section.replace(/^## /, "");
+            const sectionStart = body.indexOf(section);
+            const nextSection = body.indexOf("\n## ", sectionStart + 1);
+            const sectionBody = body.substring(sectionStart + section.length, nextSection > 0 ? nextSection : body.length);
+            if (sectionBody.trim().length === 0) {
+                findings.push({ dimension: "completeness", status: "warning", detail: `空洞章节: ${sectionTitle}` });
+            }
+        }
+        const hasFail = findings.some((f) => f.status === "fail");
+        const overall = hasFail ? "fail" : findings.length > 0 ? "warning" : "pass";
+        const result = { overall, findings, applied_rules: appliedRules };
+        if (isJson) {
+            process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+        }
+        else {
+            const icon = overall === "pass" ? "✅" : overall === "warning" ? "⚠️" : "❌";
+            userInfo(`${icon} 审查结论: ${overall}`);
+            if (appliedRules.length > 0) {
+                userInfo(`已应用 review 规则: ${appliedRules.join(", ")}`);
+            }
+            for (const f of findings) {
+                userInfo(`  [${f.status}] ${f.dimension}: ${f.detail}`);
+            }
+        }
+    }
+    catch (err) {
+        userError(`审查失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/bin/commands/review.js.map

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

package/dist/bin/commands/status.d.ts

@@ -1,9 +1,10 @@
-import type { ConfigEvidence, ConfigDraft } from "../../engine/config/zero_config_init.js";
+import type { ResolvedConfig } from "../../engine/config/resolver.js";
 export declare function cmdStatus(): Promise<void>;
-export declare function interactiveConfig(projectPath: string): Promise<{
-    draft: ConfigDraft;
-    evidence: ConfigEvidence;
-} | undefined>;
+/**
+ * 交互式配置收集 — 返回 ResolvedConfig 供 writeConfigAsIntent 写入。
+ * 替代旧 { draft: ConfigDraft; evidence: ConfigEvidence } 返回结构。
+ */
+export declare function interactiveConfig(projectPath: string): Promise<ResolvedConfig | undefined>;
 export declare function cmdVersion(): void;
 export declare function cmdNext(): Promise<void>;
 export declare function cmdStage(): Promise<void>;

package/dist/bin/commands/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/status.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAsG3F,wBAAsB,SAAS,kBA2E9B;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,GAAG,SAAS,CAAC,CAiDlI;AAED,wBAAgB,UAAU,SAkBzB;AAED,wBAAsB,OAAO,kBAgM5B;AAED,wBAAsB,QAAQ,kBAuD7B;AAED,wBAAsB,UAAU,kBAwK/B"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/status.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAuEtE,wBAAsB,SAAS,kBA6E9B;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAgChG;AAED,wBAAgB,UAAU,SAkBzB;AAED,wBAAsB,OAAO,kBAgM5B;AAED,wBAAsB,QAAQ,kBAuD7B;AAED,wBAAsB,UAAU,kBAwK/B"}

package/dist/bin/commands/status.js

@@ -2,87 +2,45 @@ import fss from "node:fs";
 import path from "node:path";
 import { resolveProjectConfig, getProjectKnowledgeDir } from "../../knowledge/loader.js";
 import { debug, userInfo, userError, } from "../../engine/core/logger.js";
-import { resolveCurrentProjectConfigReports, validateConfigPrecedence, } from "../../engine/config/config_precedence_contract.js";
-import { loadConfigEvidenceEntries, } from "../config_commands.js";
-import YAML from "yaml";
+import { resolveConfig, checkConfigReadiness } from "../../engine/config/resolver.js";
+import { detectConflicts, detectRedundancies } from "../../engine/config/conflicts.js";
 import { resolveProjectPath, args } from "../args.js";
 import { errorMessage, safeJsonParse } from "../../engine/core/helpers.js";
-function getConfigFieldValue(config, key) {
-    const parts = key.split(".");
-    let obj = config;
-    for (const part of parts) {
-        if (obj === null || typeof obj !== "object")
-            return undefined;
-        obj = obj[part];
-    }
-    return obj;
-}
-async function checkEvidenceWarnings(projectPath) {
-    debug("CLI", "执行 checkEvidenceWarnings —", projectPath);
+/**
+ * 配置冲突与冗余检查 — 替代旧 evidence + precedence 验证。
+ * 使用三层配置解析器的 detectConflicts/detectRedundancies。
+ */
+async function checkConfigConflicts(projectPath) {
+    debug("CLI", "执行 checkConfigConflicts —", projectPath);
     const warnings = [];
-    const configPath = path.join(projectPath, ".soloforge", "config.yaml");
-    const evidencePath = path.join(projectPath, ".soloforge", "config.evidence.json");
-    if (!fss.existsSync(configPath))
-        return warnings;
-    if (!fss.existsSync(evidencePath)) {
-        warnings.push("config.yaml 存在但 config.evidence.json 缺失 — 来源追溯性丢失");
-        return warnings;
-    }
-    // 检查 mtime 过期
-    try {
-        const configStat = fss.statSync(configPath);
-        const evidenceStat = fss.statSync(evidencePath);
-        if (configStat.mtimeMs > evidenceStat.mtimeMs) {
-            warnings.push("config.evidence.json 已过期（config.yaml 在 evidence 生成后被修改）");
-        }
-    }
-    catch {
-        debug("status", "文件 mtime 过期检查失败，跳过");
-    }
-    // 旧版字段一致性检查（schema v1 evidence）
     try {
-        const evidenceRaw = safeJsonParse(fss.readFileSync(evidencePath, "utf-8"));
-        if (!evidenceRaw)
-            throw new Error("无法解析 config evidence");
-        const configContent = fss.readFileSync(configPath, "utf-8");
-        const config = YAML.parse(configContent);
-        for (const [key, field] of Object.entries(evidenceRaw.fields)) {
-            const actualValue = getConfigFieldValue(config, key);
-            if (actualValue !== undefined && JSON.stringify(field.value) !== JSON.stringify(actualValue)) {
-                warnings.push(`evidence 字段 '${key}' 的值与 config.yaml 不匹配`);
+        const config = await resolveConfig(projectPath);
+        // 就绪检查
+        const readiness = checkConfigReadiness(config);
+        if (!readiness.ready) {
+            warnings.push(`配置不完整，缺失: ${readiness.missing.join(", ")}`);
+        }
+        // 冲突检测（intent 声明 vs 探测结果）
+        if (config._intent && config._fingerprint) {
+            const conflicts = detectConflicts(config._intent, config._fingerprint);
+            for (const c of conflicts) {
+                warnings.push(`冲突 ${c.field}: intent=${c.intent_value}, 探测=${c.detected_value} — ${c.suggestion}`);
             }
-        }
-    }
-    catch {
-        debug("status", "旧版字段一致性检查失败，跳过");
-    }
-    // 使用 schema v2 条目验证配置优先级
-    try {
-        const entries = loadConfigEvidenceEntries(projectPath);
-        // 检查 C 类字段自动写入违规
-        for (const e of entries) {
-            if (e.source === "cli_flag" || e.source === "mcp_param") {
-                if (e.lifetime === "project_persistent") {
-                    warnings.push(`CLI/MCP 参数（${e.source}）已持久化到 config — 字段: ${e.field_path}`);
-                }
+            // 冗余检测
+            const redundancies = detectRedundancies(config._intent, config._fingerprint);
+            for (const r of redundancies) {
+                warnings.push(`冗余 ${r.field} = ${r.value} — ${r.suggestion}`);
             }
         }
-        // 运行实时解析的配置优先级验证
-        try {
-            const { reports } = await resolveCurrentProjectConfigReports(projectPath);
-            const findings = validateConfigPrecedence(reports, entries);
-            for (const f of findings) {
-                if (f.severity === "hard_fail") {
-                    warnings.push(`[${f.rule}] ${f.message}`);
-                }
+        // _hints 冲突（resolver 内部已检测）
+        if (config._hints?.conflicts && config._hints.conflicts.length > 0) {
+            for (const c of config._hints.conflicts) {
+                warnings.push(`resolver 冲突 ${c.field}: intent=${c.intent_value}, 探测=${c.detected_value}`);
             }
         }
-        catch {
-            debug("status", "配置优先级实时验证失败，跳过");
-        }
     }
-    catch {
-        debug("status", "schema v2 条目验证失败，跳过");
+    catch (e) {
+        debug("status", "配置冲突检查失败，跳过 —", e);
     }
     return warnings;
 }
@@ -114,39 +72,36 @@ export async function cmdStatus() {
     userInfo(`  产品: ${config.product_profile}`);
     userInfo(`  后端: ${config.tech_stack.backend.framework || "未配置"}`);
     userInfo(`  前端: ${config.tech_stack.frontend.framework || "未配置"}`);
-    // 逐字段配置优先级状态
+    // 三层配置解析状态
     try {
-        const { resolutions, entries } = await resolveCurrentProjectConfigReports(projectPath);
-        if (resolutions.length > 0) {
-            userInfo("");
-            userInfo("  字段解析状态:");
-            for (const r of resolutions) {
-                const stale = r.stale_warning ? " ⚠️ stale" : "";
-                const conflict = r.conflict_report ? " ⚠️ conflict" : "";
-                userInfo(`    ${r.field_path}: ${JSON.stringify(r.resolved_value)} (${r.source}${stale}${conflict})`);
-            }
-        }
-        const schemaPath = path.join(projectPath, ".soloforge", "config.evidence.json");
-        if (fss.existsSync(schemaPath)) {
-            try {
-                const raw = safeJsonParse(fss.readFileSync(schemaPath, "utf-8"));
-                userInfo(`  evidence: schema_version=${raw?.schema_version ?? 1}, ${entries.length} 条`);
+        const resolved = await resolveConfig(projectPath);
+        const readiness = checkConfigReadiness(resolved);
+        userInfo(`  配置就绪: ${readiness.ready ? "✅" : "❌ 缺失 " + readiness.missing.join(", ")}`);
+        // 冲突/冗余展示
+        if (resolved._intent && resolved._fingerprint) {
+            const conflicts = detectConflicts(resolved._intent, resolved._fingerprint);
+            const redundancies = detectRedundancies(resolved._intent, resolved._fingerprint);
+            if (conflicts.length > 0) {
+                userInfo(`  冲突: ⚠️ ${conflicts.length} 项`);
+                for (const c of conflicts) {
+                    userInfo(`    - ${c.field}: intent=${c.intent_value}, 探测=${c.detected_value}`);
+                }
             }
-            catch (e) {
-                userInfo("  evidence: 无法解析: " + String(e));
+            if (redundancies.length > 0) {
+                userInfo(`  冗余: ${redundancies.length} 项可清理`);
+                for (const r of redundancies) {
+                    userInfo(`    - ${r.field} = ${r.value} (与探测一致)`);
+                }
             }
         }
-        else if (source === "config_file") {
-            userInfo("  evidence: ⚠️ config.evidence.json 缺失");
-        }
     }
-    catch {
-        debug("status", "字段解析状态获取失败，跳过");
+    catch (e) {
+        debug("status", "配置解析状态获取失败，跳过 —", e);
     }
-    // Evidence 警告
-    const evidenceWarnings = await checkEvidenceWarnings(projectPath);
-    for (const w of evidenceWarnings) {
-        userInfo(`  ⚠️  evidence: ${w}`);
+    // 配置冲突检查（替代旧 evidence 警告）
+    const conflictWarnings = await checkConfigConflicts(projectPath);
+    for (const w of conflictWarnings) {
+        userInfo(`  ⚠️  ${w}`);
     }
     const knowledgeDir = getProjectKnowledgeDir(config);
     if (fss.existsSync(knowledgeDir)) {
@@ -184,6 +139,10 @@ export async function cmdStatus() {
         userInfo(`  ⚠ 导航摘要异常: ${errorMessage(e)}`);
     }
 }
+/**
+ * 交互式配置收集 — 返回 ResolvedConfig 供 writeConfigAsIntent 写入。
+ * 替代旧 { draft: ConfigDraft; evidence: ConfigEvidence } 返回结构。
+ */
 export async function interactiveConfig(projectPath) {
     debug("CLI", "执行 interactiveConfig");
     if (!process.stdin.isTTY)
@@ -196,7 +155,7 @@ export async function interactiveConfig(projectPath) {
     const backendFramework = await ask("后端框架 (spring-boot): ") || "spring-boot";
     const frontendFramework = await ask("前端框架 (react): ") || "react";
     rl.close();
-    const draft = {
+    const resolved = {
         name,
         tech_stack: {
             backend: { lang: backendFramework === "go" ? "go" : "java", framework: backendFramework, version: "" },
@@ -208,27 +167,11 @@ export async function interactiveConfig(projectPath) {
             frontend: blueprintFrontendCommands(frontendFramework),
         },
         scope: { backend: [], frontend: [] },
-        advisory_notes: [],
-        confidence: "high",
-    };
-    const src = "confirmed";
-    const evidence = {
-        schema_version: 1,
-        generated_at: new Date().toISOString(),
-        mode: "interactive",
-        project_root: projectPath,
-        fields: {
-            "name": { value: name, confidence: "high", confidence_source: src, evidence: ["--interactive input"] },
-            "tech_stack.backend": { value: draft.tech_stack.backend, confidence: "high", confidence_source: src, evidence: ["--interactive input"] },
-            "tech_stack.frontend": { value: draft.tech_stack.frontend, confidence: "high", confidence_source: src, evidence: ["--interactive input"] },
-            "build_commands.backend": { value: draft.build_commands.backend, confidence: "high", confidence_source: src, evidence: ["--interactive input"] },
-            "build_commands.frontend": { value: draft.build_commands.frontend, confidence: "high", confidence_source: src, evidence: ["--interactive input"] },
-            "product_profile": { value: product, confidence: "high", confidence_source: src, evidence: ["--interactive input"] },
-            "scope.backend": { value: draft.scope.backend, confidence: "low", confidence_source: "default", evidence: ["黑名单模式：scope 为空，仅受内置安全黑名单约束"] },
-            "scope.frontend": { value: draft.scope.frontend, confidence: "low", confidence_source: "default", evidence: ["黑名单模式：scope 为空，仅受内置安全黑名单约束"] },
-        },
+        delivery: { auto_push: false, auto_pr: false },
+        repos: [],
+        _projectPath: projectPath,
     };
-    return { draft, evidence };
+    return resolved;
 }
 export function cmdVersion() {
     debug("CLI", "执行 cmdVersion");
@@ -504,7 +447,7 @@ export async function cmdCleanup() {
     debug("CLI", "执行 cmdCleanup");
     const dryRun = !args.includes("--apply");
     const staleOnly = args.includes("--stale");
-    const projectPath = process.cwd();
+    const projectPath = resolveProjectPath();
     const stateDir = path.join(projectPath, ".soloforge", "state");
     let hasError = false;
     userInfo(`SoloForge 清理: ${projectPath}`);