soloforge 1.2.1 → 1.2.3

package/dist/engine/workspace_resumer.js

@@ -1,7 +1,9 @@
 import fs from "node:fs/promises";
+import fss from "node:fs";
 import path from "node:path";
-/** 活跃状态集合 */
+/** 活跃状态集合（classifying 纳入扫描但标记为不可恢复） */
 const ACTIVE_STATUSES = [
+    "classifying",
     "expanding",
     "executing",
     "verifying",
@@ -11,10 +13,18 @@ const ACTIVE_STATUSES = [
 ];
 /**
  * 扫描工作区状态目录，恢复最后活跃的工单。
+ *
+ * 增强能力:
+ * - recoverable: 标识任务是否实际可恢复（classifying / corrupt → 不可恢复）
+ * - needs_human_confirm: 多个活跃工单时返回 true，附带候选列表
+ * - orphan_leases_cleaned: 清理无对应任务文件的孤儿租约
+ *
  * @param taskContext - 任务上下文管理器
  * @returns 唤醒结果
  */
 export async function scanAndResume(taskContext) {
+    // 清理孤儿租约
+    const orphanCleaned = cleanupOrphanLeases(taskContext);
     const recent = await taskContext.listRecent(100);
     const activeTasks = recent.filter((t) => ACTIVE_STATUSES.includes(t.status));
     if (activeTasks.length === 0) {
@@ -23,21 +33,70 @@ export async function scanAndResume(taskContext) {
             broadcast: "工作区干净，无中断工单。可以开始新任务",
             total_tasks: recent.length,
             active_tasks: 0,
+            needs_human_confirm: false,
+            orphan_leases_cleaned: orphanCleaned,
         };
     }
-    // 找到最近创建的活跃工单
+    // 多个活跃工单 → 需要人工选择
+    if (activeTasks.length > 1) {
+        const candidates = [];
+        for (const t of activeTasks) {
+            const ctx = await taskContext.load(t.task_id);
+            const phaseHint = ctx ? taskContext.getResumeHint(ctx) : "未知状态";
+            candidates.push({
+                task_id: t.task_id,
+                intent: t.intent,
+                status: t.status,
+                created_at: t.created_at,
+                phase_hint: phaseHint,
+            });
+        }
+        return {
+            resumed: false,
+            broadcast: `发现 ${activeTasks.length} 个活跃工单，请选择要恢复的工单:\n` +
+                candidates.map((c, i) => `  ${i + 1}. [${c.task_id}] ${c.intent} (${c.status})`).join("\n"),
+            total_tasks: recent.length,
+            active_tasks: activeTasks.length,
+            needs_human_confirm: true,
+            active_candidates: candidates,
+            orphan_leases_cleaned: orphanCleaned,
+        };
+    }
+    // 单个活跃工单 → 自动恢复
     const latestActive = activeTasks[0];
     const ctx = await taskContext.load(latestActive.task_id);
     if (!ctx) {
         return {
             resumed: false,
-            broadcast: `发现 ${activeTasks.length} 个活跃工单，但无法加载 ${latestActive.task_id}`,
+            broadcast: `发现活跃工单 ${latestActive.task_id}，但无法加载（可能文件损坏）`,
             total_tasks: recent.length,
             active_tasks: activeTasks.length,
+            needs_human_confirm: false,
+            orphan_leases_cleaned: orphanCleaned,
         };
     }
-    // 生成阶段提示
+    // 检查可恢复性
+    const { recoverable, reason } = checkRecoverable(ctx);
     const phaseHint = taskContext.getResumeHint(ctx);
+    if (!recoverable) {
+        return {
+            resumed: false,
+            task: {
+                task_id: ctx.task_id,
+                intent: ctx.intent,
+                status: ctx.status,
+                created_at: ctx.created_at,
+                phase_hint: phaseHint,
+                recoverable: false,
+                unrecoverable_reason: reason,
+            },
+            broadcast: `工单 ${ctx.task_id} (${ctx.intent}) 状态为 ${ctx.status}，不可自动恢复 (${reason})。建议取消后重新创建。`,
+            total_tasks: recent.length,
+            active_tasks: activeTasks.length,
+            needs_human_confirm: false,
+            orphan_leases_cleaned: orphanCleaned,
+        };
+    }
     // 构造播报消息
     const changedFiles = ctx.execution?.changed_files?.length ?? 0;
     const attemptCount = ctx.execution?.attempt_count ?? 0;
@@ -73,10 +132,66 @@ export async function scanAndResume(taskContext) {
             status: ctx.status,
             created_at: ctx.created_at,
             phase_hint: phaseHint,
+            recoverable: true,
         },
         broadcast,
         total_tasks: recent.length,
         active_tasks: activeTasks.length,
+        needs_human_confirm: false,
+        orphan_leases_cleaned: orphanCleaned,
     };
 }
+/**
+ * 清理超期活跃任务 — advisory 报告，不自动 fail。
+ * @param taskContext - 任务上下文管理器
+ * @param maxAgeMs - 最大存活时间（毫秒），默认 7 天
+ * @returns 清理报告（不执行任何状态变更）
+ */
+export async function cleanupStaleTasks(taskContext, maxAgeMs = 7 * 24 * 60 * 60 * 1000) {
+    const recent = await taskContext.listRecent(100);
+    const now = Date.now();
+    const stale = [];
+    for (const t of recent) {
+        if (!ACTIVE_STATUSES.includes(t.status))
+            continue;
+        const age = now - new Date(t.created_at).getTime();
+        if (age > maxAgeMs) {
+            stale.push({
+                task_id: t.task_id,
+                intent: t.intent,
+                status: t.status,
+                created_at: t.created_at,
+                age_ms: age,
+                advisory: `task ${t.task_id} (${t.intent}) has been active for ${Math.round(age / 3600000)}h, exceeds threshold ${Math.round(maxAgeMs / 3600000)}h`,
+            });
+        }
+    }
+    return {
+        stale_tasks: stale,
+        stale_count: stale.length,
+        recommendation: stale.length > 0
+            ? `发现 ${stale.length} 个超期活跃工单，建议人工审查后取消或完成。不自动执行任何状态变更。`
+            : "无超期活跃工单",
+    };
+}
+function checkRecoverable(ctx) {
+    if (ctx.status === "classifying") {
+        return { recoverable: false, reason: "classifying" };
+    }
+    return { recoverable: true };
+}
+function cleanupOrphanLeases(taskContext) {
+    const stateDir = taskContext.getStateDir();
+    const leaseStore = taskContext.getScopeLease();
+    const activeLeases = leaseStore.getActiveLeases();
+    let cleaned = 0;
+    for (const lease of activeLeases) {
+        const taskFile = path.join(stateDir, `${lease.task_id}.json`);
+        if (!fss.existsSync(taskFile)) {
+            leaseStore.release(lease.task_id);
+            cleaned++;
+        }
+    }
+    return cleaned;
+}
 //# sourceMappingURL=workspace_resumer.js.map

package/dist/engine/workspace_resumer.js.map

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

package/dist/engine/zero_config_init.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Zero-Config Init — 确定性 fingerprint 探测 + config 草案生成。
+ *
+ * 职责:
+ * - detectFingerprint: 探测项目技术栈、目录结构、验证命令，生成确定性指纹
+ * - generateConfigDraft: 基于 fingerprint 生成 config 草案
+ * - LLM advisory: 解释配置建议，不直接生成最终配置
+ *
+ * 原则: 确定性探测优先，LLM 只做 advisory 解释。
+ */
+export interface ProjectFingerprint {
+    project_root: string;
+    detected_at: string;
+    hash: string;
+    backend: {
+        lang: string;
+        framework: string;
+        version: string;
+        detected_from: string;
+    } | null;
+    frontend: {
+        lang: string;
+        framework: string;
+        version: string;
+        detected_from: string;
+    } | null;
+    package_managers: string[];
+    build_tools: string[];
+    test_frameworks: string[];
+    directories: string[];
+    config_files: string[];
+    advisory: string[];
+}
+export interface ConfigDraft {
+    name: string;
+    tech_stack: {
+        backend: {
+            lang: string;
+            framework: string;
+            version: string;
+        };
+        frontend: {
+            lang: string;
+            framework: string;
+            version: string;
+        };
+    };
+    product_profile: string;
+    build_commands: {
+        backend: {
+            build: string;
+            test: string;
+            full: string;
+        };
+        frontend: {
+            build: string;
+            test: string;
+            full: string;
+        };
+    };
+    scope: {
+        backend: string[];
+        frontend: string[];
+    };
+    advisory_notes: string[];
+    confidence: "high" | "medium" | "low";
+}
+/**
+ * 探测项目指纹 — 纯确定性，无 LLM 参与。
+ */
+export declare function detectFingerprint(projectRoot: string): Promise<ProjectFingerprint>;
+/**
+ * 基于指纹生成配置草案 — 确定性 + advisory 解释。
+ * LLM 不直接生成配置，只做 advisory 解释。
+ */
+export declare function generateConfigDraft(fingerprint: ProjectFingerprint): ConfigDraft;
+export interface ConfigValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * 校验 config 草案结构完整性 — advisory, 不 hard block。
+ * 确保核心字段存在且格式正确。缺失字段标记为 warning。
+ */
+export declare function validateConfigDraft(draft: ConfigDraft): ConfigValidationResult;
+//# sourceMappingURL=zero_config_init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zero_config_init.d.ts","sourceRoot":"","sources":["../../src/engine/zero_config_init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,IAAI,CAAC;IACT,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,IAAI,CAAC;IACT,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9D,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAChE,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE;QACd,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACvD,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KACzD,CAAC;IACF,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAqGD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6DxF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,kBAAkB,GAAG,WAAW,CAmDhF;AA0MD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,sBAAsB,CA6B9E"}