soloforge 1.2.18 → 1.2.20

package/dist/engine/mechanism_contract_registry.js

@@ -1,13 +1,12 @@
 /**
- * Mechanism Contract Registry — P0 self-governance contracts.
+ * Mechanism Contract Registry — P0 自治理契约。
  *
- * Every P0 mechanism on the main pipeline is registered here with
- * precise inputs, outputs, failure modes, and test anchors so that
- * validateMechanismContracts() can enforce structural invariants.
+ * 主管线上的每个 P0 机制都在此注册，包含精确的输入、输出、
+ * 失败模式和测试锚点，以便 validateMechanismContracts() 强制执行结构不变量。
  */
 import fs from "node:fs";
 import path from "node:path";
-// ── P0 Contracts ──
+// ── P0 契约 ──
 /** P0 级机制契约列表 */
 export const P0_MECHANISM_CONTRACTS = [
     // ── 1. intent_router ──
@@ -248,7 +247,7 @@ export const P0_MECHANISM_CONTRACTS = [
         tests: ["tests/engine/core_engineering_principles.test.ts"],
         lifecycle_tests: ["tests/engine/core_engineering_principles.test.ts", "tests/engine/dual_layer_mechanism_registry.test.ts"],
     },
-    // ── delivery ──
+    // ── 交付 ──
     {
         id: "mc-delivery",
         name: "Delivery",
@@ -371,7 +370,7 @@ export const P0_MECHANISM_CONTRACTS = [
         lifecycle_tests: ["tests/engine/config_precedence_contract.test.ts"],
     },
 ];
-// ── Query functions ──
+// ── 查询函数 ──
 /**
  * 执行 listMechanismContracts 操作
  */
@@ -395,7 +394,7 @@ export function listMechanismContractsByStatus(status) {
     console.error("[soloForge] 机制契约: listMechanismContractsByStatus() 按状态筛选, status=%s", status);
     return P0_MECHANISM_CONTRACTS.filter((c) => c.status === status);
 }
-// ── Governance validation ──
+// ── 治理验证 ──
 /**
  * 校验机制契约的结构完整性和一致性。
  * @param contracts - 待校验的契约列表，默认使用内置 P0 契约
@@ -407,16 +406,16 @@ export function validateMechanismContracts(contracts = P0_MECHANISM_CONTRACTS, r
     const findings = [];
     const seenIds = new Set();
     for (const c of contracts) {
-        // duplicate id
+        // 重复 id
         if (seenIds.has(c.id)) {
             findings.push({ severity: "hard_fail", contract_id: c.id, field: "id", message: `Duplicate id: ${c.id}` });
         }
         seenIds.add(c.id);
-        // owner_module exists
+        // owner_module 文件存在性
         if (!fs.existsSync(path.join(rootDir, c.owner_module))) {
             findings.push({ severity: "hard_fail", contract_id: c.id, field: "owner_module", message: `Module not found: ${c.owner_module}` });
         }
-        // owner_exports validation: each export must exist in the module file
+        // owner_exports 验证：每个导出必须在模块文件中存在
         if (c.owner_exports?.length && fs.existsSync(path.join(rootDir, c.owner_module))) {
             const moduleContent = fs.readFileSync(path.join(rootDir, c.owner_module), "utf-8");
             for (const exp of c.owner_exports) {
@@ -425,56 +424,56 @@ export function validateMechanismContracts(contracts = P0_MECHANISM_CONTRACTS, r
                 }
             }
         }
-        // enforced must have lifecycle_tests
+        // enforced 状态必须有 lifecycle_tests
         if (c.status === "enforced" && c.lifecycle_tests.length === 0) {
             findings.push({ severity: "hard_fail", contract_id: c.id, field: "lifecycle_tests", message: "Enforced mechanism must have lifecycle_tests" });
         }
-        // tests files exist
+        // 测试文件存在性
         for (const t of c.tests) {
             if (!fs.existsSync(path.join(rootDir, t))) {
                 findings.push({ severity: "hard_fail", contract_id: c.id, field: "tests", message: `Test file not found: ${t}` });
             }
         }
-        // lifecycle_tests files exist
+        // lifecycle_tests 文件存在性
         for (const t of c.lifecycle_tests) {
             if (!fs.existsSync(path.join(rootDir, t))) {
                 findings.push({ severity: "hard_fail", contract_id: c.id, field: "lifecycle_tests", message: `Lifecycle test file not found: ${t}` });
             }
         }
-        // required_inputs non-empty
+        // required_inputs 非空
         if (c.required_inputs.length === 0) {
             findings.push({ severity: "hard_fail", contract_id: c.id, field: "required_inputs", message: "required_inputs must not be empty" });
         }
-        // outputs non-empty
+        // outputs 非空
         if (c.outputs.length === 0) {
             findings.push({ severity: "hard_fail", contract_id: c.id, field: "outputs", message: "outputs must not be empty" });
         }
-        // downstream_consumers non-empty
+        // downstream_consumers 非空
         if (c.downstream_consumers.length === 0) {
             findings.push({ severity: "hard_fail", contract_id: c.id, field: "downstream_consumers", message: "downstream_consumers must not be empty" });
         }
-        // state_lifecycle must have state_transitions
+        // state_lifecycle 必须有 state_transitions
         if (c.mechanism_type === "state_lifecycle" && (!c.state_transitions || c.state_transitions.length === 0)) {
             findings.push({ severity: "hard_fail", contract_id: c.id, field: "state_transitions", message: "state_lifecycle mechanism must have state_transitions" });
         }
-        // 清理_hooks without lifecycle_tests
+        // 有 cleanup_hooks 但无 lifecycle_tests
         if (c.cleanup_hooks && c.cleanup_hooks.length > 0 && c.lifecycle_tests.length === 0) {
             findings.push({ severity: "hard_fail", contract_id: c.id, field: "lifecycle_tests", message: "Mechanism with cleanup_hooks must have lifecycle_tests" });
         }
-        // ── Advisory checks ──
-        // failure_modes empty
+        // ── 建议性检查 ──
+        // failure_modes 为空
         if (c.failure_modes.length === 0) {
             findings.push({ severity: "advisory", contract_id: c.id, field: "failure_modes", message: "failure_modes is empty" });
         }
-        // degradation_behavior empty or too short
+        // degradation_behavior 为空或过短
         if (!c.degradation_behavior || c.degradation_behavior.length < 10) {
             findings.push({ severity: "advisory", contract_id: c.id, field: "degradation_behavior", message: "degradation_behavior is empty or too short" });
         }
-        // generic downstream_consumers
+        // 通用 downstream_consumers
         if (c.downstream_consumers.includes("unknown")) {
             findings.push({ severity: "advisory", contract_id: c.id, field: "downstream_consumers", message: "downstream_consumers contains generic 'unknown'" });
         }
-        // 已废弃 without notes
+        // 已废弃但无 notes
         if (c.status === "deprecated" && !c.notes) {
             findings.push({ severity: "advisory", contract_id: c.id, field: "notes", message: "Deprecated mechanism must have notes explaining removal" });
         }

package/dist/engine/mechanism_contract_registry.js.map

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

package/dist/engine/mechanism_family_registry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 机制族实现映射 — 问题十五 (Mechanism Family Implementation Map)。
+ *
+ * 核心规则:
+ * - 每个设计机制族必须有 MechanismFamilyImplementation
+ * - enforced 必须有 tests 和 lifecycle tests
+ * - 机制族状态与真实实现不一致必须报告
+ */
+export type ImplementationState = "implemented" | "partial" | "scaffolded" | "planned" | "deprecated";
+export interface MechanismFamilyImplementation {
+    mechanism_id: string;
+    name: string;
+    design_section: string;
+    implementation_state: ImplementationState;
+    owner_module: string;
+    contract_id: string;
+    workflow_ids: string[];
+    guard_ids: string[];
+    verification_ids: string[];
+    failure_ids: string[];
+    degradation_ids: string[];
+    test_files: string[];
+    lifecycle_test_files: string[];
+    known_gaps: string[];
+    hard_fail_boundary: string[];
+}
+export interface MechanismFamilyGovernanceFinding {
+    mechanism_id: string;
+    severity: "hard_fail" | "warning" | "advisory";
+    rule: string;
+    message_zh: string;
+}
+/** 列出所有机制族 */
+export declare function listAllMechanisms(): MechanismFamilyImplementation[];
+/** 按 ID 获取 */
+export declare function getMechanismById(id: string): MechanismFamilyImplementation | undefined;
+/** 注册新机制族 */
+export declare function registerMechanism(m: MechanismFamilyImplementation): {
+    success: boolean;
+    error?: string;
+};
+/**
+ * 验证机制族实现一致性。
+ */
+export declare function validateMechanismFamilies(): MechanismFamilyGovernanceFinding[];
+/** 重置注册表（测试用） */
+export declare function resetMechanismRegistry(): void;
+//# sourceMappingURL=mechanism_family_registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mechanism_family_registry.d.ts","sourceRoot":"","sources":["../../src/engine/mechanism_family_registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;AAEtG,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,mBAAmB,CAAC;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gCAAgC;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAwID,cAAc;AACd,wBAAgB,iBAAiB,IAAI,6BAA6B,EAAE,CAEnE;AAED,cAAc;AACd,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,6BAA6B,GAAG,SAAS,CAEtF;AAED,aAAa;AACb,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,6BAA6B,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAOxG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,gCAAgC,EAAE,CAoC9E;AAED,iBAAiB;AACjB,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/engine/mechanism_family_registry.js

@@ -0,0 +1,197 @@
+/**
+ * 机制族实现映射 — 问题十五 (Mechanism Family Implementation Map)。
+ *
+ * 核心规则:
+ * - 每个设计机制族必须有 MechanismFamilyImplementation
+ * - enforced 必须有 tests 和 lifecycle tests
+ * - 机制族状态与真实实现不一致必须报告
+ */
+const BUILTIN_MECHANISMS = [
+    {
+        mechanism_id: "mf-intent-router",
+        name: "意图路由",
+        design_section: "第三部分",
+        implementation_state: "implemented",
+        owner_module: "engine/intent_router",
+        contract_id: "route_decision_contract",
+        workflow_ids: ["workflow_contract"],
+        guard_ids: [],
+        verification_ids: ["contract_governance"],
+        failure_ids: ["failure_recovery_contract"],
+        degradation_ids: [],
+        test_files: ["tests/engine/intent_router.test.ts"],
+        lifecycle_test_files: ["tests/engine/route_decision_contract.test.ts"],
+        known_gaps: [],
+        hard_fail_boundary: ["路由决策必须与设计结论一致"],
+    },
+    {
+        mechanism_id: "mf-workflow-engine",
+        name: "工作流引擎",
+        design_section: "第四部分",
+        implementation_state: "implemented",
+        owner_module: "engine/workflow_contract_registry",
+        contract_id: "workflow_contract",
+        workflow_ids: [],
+        guard_ids: ["guard-write-readonly"],
+        verification_ids: ["contract_governance"],
+        failure_ids: ["failure_recovery_contract"],
+        degradation_ids: [],
+        test_files: ["tests/engine/workflow_contract_registry.test.ts"],
+        lifecycle_test_files: ["tests/engine/workflow_contract_registry.test.ts"],
+        known_gaps: [],
+        hard_fail_boundary: ["workflow 必须与设计结论一致"],
+    },
+    {
+        mechanism_id: "mf-enforcement-guard",
+        name: "强制护栏",
+        design_section: "第四部分",
+        implementation_state: "implemented",
+        owner_module: "engine/enforcement_guard",
+        contract_id: "command_execution_contract",
+        workflow_ids: ["workflow_contract"],
+        guard_ids: ["guard-write-readonly", "guard-write-scope"],
+        verification_ids: [],
+        failure_ids: ["failure_recovery_contract"],
+        degradation_ids: ["degradation_contract"],
+        test_files: ["tests/engine/enforcement_guard.test.ts"],
+        lifecycle_test_files: [],
+        known_gaps: ["lifecycle tests 待补充"],
+        hard_fail_boundary: ["只读路由写入必须阻断"],
+    },
+    {
+        mechanism_id: "mf-verification",
+        name: "验证机制",
+        design_section: "第四部分",
+        implementation_state: "implemented",
+        owner_module: "engine/verifier",
+        contract_id: "main_path_integration_contract",
+        workflow_ids: [],
+        guard_ids: [],
+        verification_ids: ["verification_contract"],
+        failure_ids: [],
+        degradation_ids: [],
+        test_files: ["tests/engine/verifier.test.ts"],
+        lifecycle_test_files: [],
+        known_gaps: [],
+        hard_fail_boundary: [],
+    },
+    {
+        mechanism_id: "mf-failure-recovery",
+        name: "失败恢复",
+        design_section: "第四部分",
+        implementation_state: "implemented",
+        owner_module: "engine/failure_classifier",
+        contract_id: "failure_recovery_contract",
+        workflow_ids: [],
+        guard_ids: [],
+        verification_ids: [],
+        failure_ids: ["failure_recovery_contract"],
+        degradation_ids: [],
+        test_files: ["tests/engine/failure_classifier.test.ts"],
+        lifecycle_test_files: [],
+        known_gaps: [],
+        hard_fail_boundary: ["deterministic 不得无限重试"],
+    },
+    {
+        mechanism_id: "mf-knowledge-injection",
+        name: "知识注入",
+        design_section: "第五部分",
+        implementation_state: "implemented",
+        owner_module: "engine/knowledge_injection_boundary",
+        contract_id: "knowledge_injection_contract",
+        workflow_ids: [],
+        guard_ids: ["guard-knowledge-injectable"],
+        verification_ids: [],
+        failure_ids: [],
+        degradation_ids: [],
+        test_files: ["tests/engine/knowledge_injection_boundary.test.ts"],
+        lifecycle_test_files: [],
+        known_gaps: [],
+        hard_fail_boundary: [],
+    },
+    {
+        mechanism_id: "mf-contract-registry",
+        name: "统一契约注册表",
+        design_section: "第七节",
+        implementation_state: "implemented",
+        owner_module: "engine/contract_registry",
+        contract_id: "contract_governance",
+        workflow_ids: [],
+        guard_ids: [],
+        verification_ids: ["contract_governance"],
+        failure_ids: [],
+        degradation_ids: [],
+        test_files: ["tests/engine/contract_registry.test.ts"],
+        lifecycle_test_files: ["tests/engine/contract_registry.test.ts"],
+        known_gaps: [],
+        hard_fail_boundary: ["未登记契约不得 hard fail"],
+    },
+];
+let runtimeMechanisms = null;
+function getRegistry() {
+    if (!runtimeMechanisms) {
+        runtimeMechanisms = new Map();
+        for (const m of BUILTIN_MECHANISMS) {
+            runtimeMechanisms.set(m.mechanism_id, { ...m, test_files: [...m.test_files], lifecycle_test_files: [...m.lifecycle_test_files] });
+        }
+    }
+    return runtimeMechanisms;
+}
+/** 列出所有机制族 */
+export function listAllMechanisms() {
+    return [...getRegistry().values()];
+}
+/** 按 ID 获取 */
+export function getMechanismById(id) {
+    return getRegistry().get(id);
+}
+/** 注册新机制族 */
+export function registerMechanism(m) {
+    const reg = getRegistry();
+    if (reg.has(m.mechanism_id)) {
+        return { success: false, error: `机制族 ${m.mechanism_id} 已存在` };
+    }
+    reg.set(m.mechanism_id, { ...m, test_files: [...m.test_files], lifecycle_test_files: [...m.lifecycle_test_files] });
+    return { success: true };
+}
+/**
+ * 验证机制族实现一致性。
+ */
+export function validateMechanismFamilies() {
+    const findings = [];
+    for (const m of getRegistry().values()) {
+        // enforced 但无 lifecycle tests
+        if (m.implementation_state === "implemented" && m.lifecycle_test_files.length === 0 && m.hard_fail_boundary.length > 0) {
+            findings.push({
+                mechanism_id: m.mechanism_id,
+                severity: "warning",
+                rule: "implemented_needs_lifecycle_tests",
+                message_zh: `机制族 ${m.name} 已实现且有 hard_fail_boundary 但无 lifecycle tests`,
+            });
+        }
+        // 设计文档有机制族但没有 owner module
+        if (!m.owner_module) {
+            findings.push({
+                mechanism_id: m.mechanism_id,
+                severity: "hard_fail",
+                rule: "mechanism_needs_owner",
+                message_zh: `机制族 ${m.name} 缺少 owner_module`,
+            });
+        }
+        // 无测试
+        if (m.test_files.length === 0) {
+            findings.push({
+                mechanism_id: m.mechanism_id,
+                severity: "warning",
+                rule: "mechanism_needs_tests",
+                message_zh: `机制族 ${m.name} 无测试文件`,
+            });
+        }
+    }
+    return findings;
+}
+/** 重置注册表（测试用） */
+export function resetMechanismRegistry() {
+    runtimeMechanisms = null;
+}
+//# sourceMappingURL=mechanism_family_registry.js.map

package/dist/engine/mechanism_family_registry.js.map

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

package/dist/engine/onboarding.js

@@ -32,7 +32,7 @@ const STEP_DESCRIPTIONS = {
     knowledge_review: "知识库复习",
     first_task: "首次任务",
 };
-// ── Main function ──
+// ── 主函数 ──
 /**
  * 执行新人引导流程的内部主函数。
  * @description 根据已完成步骤自动推进到下一个未完成的引导阶段，执行对应逻辑并更新进度。
@@ -73,7 +73,7 @@ export async function runOnboarding(input) {
         completed_steps: [...completedSteps],
         next_action_hint: "",
     };
-    // Execute current step
+    // 执行当前步骤
     switch (currentStep) {
         case "project_overview":
             console.error("[soloForge] 引导模块: 执行步骤 — 项目概览");
@@ -111,7 +111,7 @@ export async function runOnboarding(input) {
     });
     return result;
 }
-// ── Public entry point for MCP tool (sf_onboard) ──
+// ── MCP 工具公共入口 (sf_onboard) ──
 /**
  * MCP 工具层（sf_onboard）的公共入口。
  * @description 处理会话恢复逻辑：若非重置模式，先尝试加载已持久化的引导进度；
@@ -139,7 +139,7 @@ export async function onboard(input) {
     }
     return runOnboarding({ config, projectPath, gitOps, knowledgeIndex, currentStep, completedSteps });
 }
-// ── Step: project_overview ──
+// ── 步骤: project_overview ──
 /**
  * 构建项目概览（引导第一步：project_overview）。
  * @description 汇总项目名称、技术栈、仓库信息和编码惯例，为新人提供项目全貌。
@@ -178,7 +178,7 @@ async function buildProjectOverview(config, projectPath) {
         conventions,
     };
 }
-// ── Step: code_tour ──
+// ── 步骤: code_tour ──
 /**
  * 构建代码导览（引导第二步：code_tour）。
  * @description 扫描配置的作用域目录，识别关键模块和入口文件；结合 Git 提交记录发现近期活跃区域。
@@ -190,9 +190,9 @@ async function buildProjectOverview(config, projectPath) {
 async function buildCodeTour(config, projectPath, gitOps) {
     const keyModules = [];
     const allScopePaths = [...config.scope.backend, ...config.scope.frontend];
-    // Walk scope paths for key directories
+    // 遍历作用域路径以查找关键目录
     for (const scopeGlob of allScopePaths) {
-        // Extract directory prefix from glob patterns like "src/**", "web/pages/*"
+        // 从 glob 模式中提取目录前缀（如 "src/**"、"web/pages/*"）
         const dirPrefix = scopeGlob.replace(/\/\*\*?$/, "").replace(/\/\*$/, "");
         const absDir = path.resolve(projectPath, dirPrefix);
         try {
@@ -210,7 +210,7 @@ async function buildCodeTour(config, projectPath, gitOps) {
             /* directory not found or unreadable */
         }
     }
-    // Use git log to find most active areas
+    // 使用 git log 查找最近活跃区域
     try {
         const log = await gitOps.getLog(projectPath, { maxCount: 5 });
         const touchedFiles = new Set();
@@ -242,7 +242,7 @@ async function buildCodeTour(config, projectPath, gitOps) {
     catch {
         /* git log may fail */
     }
-    // Find entry points in scope root directories
+    // 在作用域根目录中查找入口文件
     const entryPoints = [];
     for (const scopeGlob of allScopePaths) {
         const dirPrefix = scopeGlob.replace(/\/\*\*?$/, "").replace(/\/\*$/, "");
@@ -267,7 +267,7 @@ async function buildCodeTour(config, projectPath, gitOps) {
         entry_points: entryPoints,
     };
 }
-// ── Step: knowledge_review ──
+// ── 步骤: knowledge_review ──
 /**
  * 构建知识库摘要（引导第三步：knowledge_review）。
  * @description 从知识索引中统计活跃条目的总数、模式数、流程数，并提取最多 10 个关键主题。
@@ -319,7 +319,7 @@ function buildKnowledgeSummary(knowledgeIndex) {
         };
     }
 }
-// ── Step: first_task ──
+// ── 步骤: first_task ──
 /**
  * 生成首个任务建议（引导第四步：first_task）。
  * @description 基于工作区状态和近期提交历史，智能推荐适合新人执行的第一个任务。
@@ -330,7 +330,7 @@ function buildKnowledgeSummary(knowledgeIndex) {
  */
 async function buildFirstTaskSuggestion(projectPath, gitOps) {
     const suggestions = [];
-    // Check for uncommitted changes
+    // 检查未提交变更
     try {
         const status = await gitOps.getStatus(projectPath);
         if (status.length > 0) {
@@ -344,11 +344,11 @@ async function buildFirstTaskSuggestion(projectPath, gitOps) {
     catch {
         /* status may fail */
     }
-    // Analyze recent commit history for task ideas
+    // 分析最近提交历史以获取任务建议
     try {
         const log = await gitOps.getLog(projectPath, { maxCount: 10 });
         const recentMessages = log.map((e) => e.message.toLowerCase());
-        // Check if tests are mentioned
+        // 检查是否有测试相关提交
         const hasTestMentions = recentMessages.some((m) => m.includes("test"));
         if (!hasTestMentions) {
             suggestions.push({
@@ -357,7 +357,7 @@ async function buildFirstTaskSuggestion(projectPath, gitOps) {
                 difficulty: "low",
             });
         }
-        // Check for docs
+        // 检查是否有文档相关提交
         const hasDocMentions = recentMessages.some((m) => m.includes("doc") || m.includes("readme"));
         if (!hasDocMentions) {
             suggestions.push({
@@ -366,7 +366,7 @@ async function buildFirstTaskSuggestion(projectPath, gitOps) {
                 difficulty: "low",
             });
         }
-        // Check for lint/fix
+        // 检查是否有 lint/格式修复提交
         const hasLintFixes = recentMessages.some((m) => m.includes("lint") || m.includes("style") || m.includes("format"));
         if (!hasLintFixes) {
             suggestions.push({
@@ -375,7 +375,7 @@ async function buildFirstTaskSuggestion(projectPath, gitOps) {
                 difficulty: "low",
             });
         }
-        // If there are recent commits, suggest reviewing them
+        // 如果有最近提交，建议阅读它们
         if (log.length > 0) {
             suggestions.push({
                 intent: "阅读近期提交，熟悉代码风格",
@@ -387,7 +387,7 @@ async function buildFirstTaskSuggestion(projectPath, gitOps) {
     catch {
         /* git log may fail */
     }
-    // Default suggestion if nothing else
+    // 无其他建议时的默认选项
     if (suggestions.length === 0) {
         suggestions.push({
             intent: "阅读项目配置和入口文件",
@@ -395,7 +395,7 @@ async function buildFirstTaskSuggestion(projectPath, gitOps) {
             difficulty: "low",
         });
     }
-    // Return the first suggestion
+    // 返回第一个建议
     return suggestions[0];
 }
 /**
@@ -418,7 +418,7 @@ async function deleteSessionFile(projectPath) {
 async function persistSession(projectPath, currentStep, completedSteps) {
     const stateDir = path.join(projectPath, ".soloforge", "state");
     const sessionFile = path.join(stateDir, "onboarding-session.json");
-    // Ensure directory exists
+    // 确保目录存在
     await fs.mkdir(stateDir, { recursive: true });
     const session = {
         current_step: currentStep,