@bolloon/bolloon-agent 0.4.28 → 0.4.30

package/dist/electron-build/web/server-storage.js

@@ -0,0 +1,390 @@
+"use strict";
+/**
+ * server-storage.ts — server.ts 拆出的持久化层
+ *
+ * 包含:
+ *   - loadChannels / saveChannels + 去重 + 写盘保护
+ *   - loadSession / saveSession + 50MB 内存保护
+ *   - loadTheme / saveTheme
+ *   - 任务队列 (loadTaskQueue / saveTaskQueue / executeTask)
+ *
+ * 从 src/web/server.ts 抽出 (2026-07-06).
+ * Channel / Session / Task / SessionMessage / SessionSummary type 来自 ./server-types.ts.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLastChannelsWriteAt = getLastChannelsWriteAt;
+exports.updateChannels = updateChannels;
+exports.loadChannels = loadChannels;
+exports.saveChannels = saveChannels;
+exports.loadSession = loadSession;
+exports.saveSession = saveSession;
+exports.loadTheme = loadTheme;
+exports.saveTheme = saveTheme;
+exports.isTaskExecuting = isTaskExecuting;
+exports.getExecutingTaskId = getExecutingTaskId;
+exports.markTaskOrbitReady = markTaskOrbitReady;
+exports.disableTaskOrbitStore = disableTaskOrbitStore;
+exports.loadTaskQueue = loadTaskQueue;
+exports.saveTaskQueue = saveTaskQueue;
+exports.claimTtlSeconds = claimTtlSeconds;
+exports.claimTaskForExecution = claimTaskForExecution;
+exports.claimNextPendingTask = claimNextPendingTask;
+exports.heartbeatTaskExecution = heartbeatTaskExecution;
+exports.releaseStaleClaims = releaseStaleClaims;
+exports.startTaskExecution = startTaskExecution;
+exports.endTaskExecution = endTaskExecution;
+const fs = __importStar(require("fs/promises"));
+const server_types_js_1 = require("./server-types.js");
+const session_window_js_1 = require("../bootstrap/session-window.js");
+const task_deps_js_1 = require("./task-deps.js");
+// 写盘去重: 上次写盘内容, 用于跳过幂等调用
+let lastChannelsJson = '';
+// 写盘保护: 任何调用 saveChannels 后更新
+let lastChannelsWriteAt = 0;
+// 2026-07-24: 简单的互斥锁, 防止并发 loadChannels→modify→saveChannels 的经典 read-modify-write 竞争
+let channelsLock = Promise.resolve();
+function getLastChannelsWriteAt() {
+    return lastChannelsWriteAt;
+}
+/** 对 channels 执行原子化的 read-modify-write, 自带互斥锁 */
+async function updateChannels(fn) {
+    const run = channelsLock.then(async () => {
+        const chs = await rawLoadChannels();
+        const result = fn(chs);
+        await rawSaveChannels(result);
+        return result;
+    });
+    // 2026-08-02 fix: 失败不毒化锁链 — 之前 channelsLock = channelsLock.then(...),
+    //   某次 fn 抛错 → 整个链变 rejected → 之后所有 updateChannels 直接 reject,
+    //   fn 不再执行 → UI 创建 channel 偶发"不落盘" (静默丢失).
+    channelsLock = run.catch((e) => {
+        console.error('[updateChannels] 失败 (已隔离, 不影响后续操作):', e?.message || e);
+        return undefined;
+    });
+    return run;
+}
+async function rawLoadChannels() {
+    try {
+        const data = await fs.readFile(server_types_js_1.CHANNELS_PATH, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch (readErr) {
+        // 2026-07-24: 主文件损坏时尝试从 .tmp 恢复
+        if (readErr?.code !== 'ENOENT') {
+            console.warn('[loadChannels] channels.json 解析失败, 尝试从 .tmp 恢复:', readErr?.message?.slice(0, 80));
+            try {
+                const tmpData = await fs.readFile(server_types_js_1.CHANNELS_PATH + '.tmp', 'utf-8');
+                const recovered = JSON.parse(tmpData);
+                console.log(`[loadChannels] 从 .tmp 恢复成功: ${recovered.length} 个 channel`);
+                // 立即把恢复的内容写回主文件
+                await fs.writeFile(server_types_js_1.CHANNELS_PATH, tmpData, 'utf-8');
+                return recovered;
+            }
+            catch (tmpErr) {
+                console.warn('[loadChannels] .tmp 恢复也失败:', tmpErr?.message?.slice(0, 80));
+            }
+        }
+        return [];
+    }
+}
+async function rawSaveChannels(channels) {
+    const sanitized = channels.map(ch => {
+        const { didDocument: _omit, ...rest } = ch;
+        return rest;
+    });
+    const jsonStr = JSON.stringify(sanitized, null, 2);
+    if (jsonStr === lastChannelsJson)
+        return;
+    lastChannelsJson = jsonStr;
+    console.log('[saveChannels] 保存频道数据, 数量:', sanitized.length);
+    // 2026-07-24: 原子写入 — 先写 .tmp 再 rename, 防止崩溃导致 channels.json 损坏
+    const tmpPath = server_types_js_1.CHANNELS_PATH + '.tmp';
+    await fs.writeFile(tmpPath, jsonStr, 'utf-8');
+    await fs.rename(tmpPath, server_types_js_1.CHANNELS_PATH);
+    lastChannelsWriteAt = Date.now();
+}
+async function loadChannels() {
+    return rawLoadChannels();
+}
+async function saveChannels(channels) {
+    return rawSaveChannels(channels);
+}
+/**
+ * loadSession 加 L0 window fallback 链 (2026-07-07 P0-B):
+ *   1) full session.json (主路径)
+ *   2) full 超 50MB 拒加载 → 读 <key>.window.json
+ *   3) window 也没有 → 返回 null (前端 fallback "你好! 我是 Bolloon Agent")
+ */
+async function loadSession(channelId, sessionId) {
+    const key = sessionId ? `${channelId}:${sessionId}` : channelId;
+    const sessionPath = `${server_types_js_1.SESSION_CACHE_PATH}/${key}.json`;
+    const sid = sessionId || 'default';
+    try {
+        // 内存保护: 拒绝加载过大的 session 文件 (> 50MB 视为异常, 避免 OOM)
+        const stat = await fs.stat(sessionPath);
+        if (stat.size > 50 * 1024 * 1024) {
+            console.warn(`[loadSession] session 过大 (${stat.size} bytes): ${key}, fallback to window`);
+            return await loadSessionWindowFallback(channelId, sid);
+        }
+        const data = await fs.readFile(sessionPath, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        // 文件不存在 → 仍尝试 window (可能上次 session 删了, window 还在)
+        return await loadSessionWindowFallback(channelId, sid);
+    }
+}
+/** window-only fallback: 窗口消息填入 Session.messages, 其他字段填占位 */
+async function loadSessionWindowFallback(channelId, sessionId) {
+    const win = await (0, session_window_js_1.loadWindow)(channelId, sessionId);
+    if (!win || win.messages.length === 0)
+        return null;
+    console.log(`[loadSession] window fallback for ${channelId}: ${sessionId}, ${win.messages.length} msgs (${win.totalBehind} behind)`);
+    // WindowEntry → SessionMessage 映射 (id/timestamp 缺失时补占位)
+    const messages = win.messages.map((m, idx) => ({
+        id: m.id || `win-${win.lastUpdated}-${idx}`,
+        type: (m.type === 'user' || m.type === 'ai' ? m.type : 'user'),
+        content: m.content,
+        timestamp: m.timestamp || win.lastUpdated,
+        metadata: m.metadata,
+    }));
+    return {
+        channelId,
+        sessionId,
+        messages,
+        lastUpdated: win.lastUpdated,
+        _windowOnly: true,
+        _totalBehind: win.totalBehind,
+    };
+}
+async function saveSession(session) {
+    const key = session.sessionId ? `${session.channelId}:${session.sessionId}` : session.channelId;
+    const sessionPath = `${server_types_js_1.SESSION_CACHE_PATH}/${key}.json`;
+    await fs.writeFile(sessionPath, JSON.stringify(session, null, 2));
+    // L0 窗口联动 (2026-07-07): 同步写最近 30 条到 <key>.window.json
+    // 失败静默 — 不阻塞主对话流
+    try {
+        await (0, session_window_js_1.saveWindow)(session.channelId, session.sessionId || 'default', session.messages || [], { windowSize: 30 });
+    }
+    catch (e) {
+        console.warn(`[saveSession] window write failed for ${key}: ${e?.message || e}`);
+    }
+}
+async function loadTheme() {
+    try {
+        const data = await fs.readFile(server_types_js_1.THEME_PATH, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return { theme: 'light', agentId: '' };
+    }
+}
+async function saveTheme(theme, agentId) {
+    await fs.writeFile(server_types_js_1.THEME_PATH, JSON.stringify({ theme, agentId }, null, 2));
+}
+// ==================== Task Queue & Workflow System ====================
+let isExecutingTask = false;
+let executionTaskId = null;
+function isTaskExecuting() {
+    return isExecutingTask;
+}
+function getExecutingTaskId() {
+    return executionTaskId;
+}
+// ==================== 任务队列 ====================
+// 2026-08-12 (Task6): 任务队列以 OrbitDB 为主存储 (去中心化/跨设备同步), 本地文件作 fallback.
+//   orbit 由 server 启动时 warmTaskOrbitStore() 预热成功后调 markTaskOrbitReady() 置位;
+//   未置位 (测试/离线) 自动回退本地文件.
+let _taskOrbitReady = false;
+/** server 启动 warm 成功后调用, 启用 orbitdb 主存储 (测试可调用 disableTaskOrbitStore 关闭) */
+function markTaskOrbitReady() { _taskOrbitReady = true; }
+/** 禁用 orbitdb 任务存储 (测试隔离用) */
+function disableTaskOrbitStore() { _taskOrbitReady = false; }
+function taskOrbitReady() { return _taskOrbitReady; }
+async function loadTaskQueue() {
+    // OrbitDB 主存储优先
+    if (taskOrbitReady()) {
+        try {
+            const { getTaskOrbitStore } = await Promise.resolve().then(() => __importStar(require('../orbitdb/task-store.js')));
+            const tasks = await getTaskOrbitStore().loadTasks();
+            if (Array.isArray(tasks))
+                return tasks;
+        }
+        catch { /* orbit 读失败 → fallback 本地 */ }
+    }
+    try {
+        const data = await fs.readFile(server_types_js_1.TASK_QUEUE_PATH, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return [];
+    }
+}
+async function saveTaskQueue(tasks) {
+    // 本地双写 (备份 + fallback 源)
+    await fs.writeFile(server_types_js_1.TASK_QUEUE_PATH, JSON.stringify(tasks, null, 2));
+    // OrbitDB 主存储同步 (尽力而为)
+    if (taskOrbitReady()) {
+        try {
+            const { getTaskOrbitStore } = await Promise.resolve().then(() => __importStar(require('../orbitdb/task-store.js')));
+            await getTaskOrbitStore().saveTasks(tasks);
+        }
+        catch { /* orbit 写失败静默, 本地已备份 */ }
+    }
+}
+// ==================== 任务认领 CAS (2026-08-11, Hermes kanban 模式) ====================
+// kanban_db.py: "WAL + BEGIN IMMEDIATE + compare-and-swap on tasks.status/claim_lock —
+//   至多一个 worker 能认领任务, 输家看到 0 行受影响就退出, 无重试循环, 无分布式锁."
+// Bolloon 对应: 任务队列是 JSON 文件, 用进程内互斥链 (withTaskQueueLock) 序列化
+//   load→CAS(status==='pending'→'running')→save, 输家返回 null/not-pending, 不重试.
+let taskQueueLock = Promise.resolve();
+function withTaskQueueLock(fn) {
+    const run = taskQueueLock.then(fn);
+    taskQueueLock = run.then(() => undefined, () => undefined);
+    return run;
+}
+/** 认领 TTL 默认 15min (BOLLOON_CLAIM_TTL_SECONDS 可调) — Hermes DEFAULT_CLAIM_TTL_SECONDS=15*60 */
+function claimTtlSeconds() {
+    const v = Number(process.env.BOLLOON_CLAIM_TTL_SECONDS || '');
+    return v > 0 ? v : 15 * 60;
+}
+/**
+ * CAS 认领指定任务: 只有 status==='pending' 才能认领成功 (原子翻成 running).
+ * 认领点强制父依赖不变式 (Hermes kanban): 任一父未 completed/cancelled → 不认领, 返回 'parents-undone'.
+ * 认领写 claim_expires (TTL) — 崩溃/卡死后由 releaseStaleClaims 释放, 锁不泄漏.
+ */
+async function claimTaskForExecution(taskId) {
+    if (isExecutingTask)
+        return 'busy';
+    return withTaskQueueLock(async () => {
+        if (isExecutingTask)
+            return 'busy';
+        const tasks = await loadTaskQueue();
+        const t = tasks.find((x) => x.id === taskId);
+        if (!t || t.status !== 'pending')
+            return 'not-pending';
+        // 父依赖不变式: 父未完成 → 拒绝认领 (依赖悬空时任务不可执行)
+        if (!(0, task_deps_js_1.parentsSatisfied)(t, tasks))
+            return 'parents-undone';
+        t.status = 'running';
+        t.claimExpires = Date.now() + claimTtlSeconds() * 1000;
+        t.updatedAt = new Date().toISOString();
+        await saveTaskQueue(tasks);
+        isExecutingTask = true;
+        executionTaskId = taskId;
+        return 'claimed';
+    });
+}
+/**
+ * CAS 认领下一个 pending 任务; 无任务/已被认领 → null (输家不重试).
+ * 只认领父依赖满足的 pending — 父未完成的任务跳过 (等父 done 后可被认领), 不阻塞队列.
+ */
+async function claimNextPendingTask() {
+    if (isExecutingTask)
+        return null;
+    return withTaskQueueLock(async () => {
+        if (isExecutingTask)
+            return null;
+        const tasks = await loadTaskQueue();
+        const t = tasks.find((x) => x.status === 'pending' && (0, task_deps_js_1.parentsSatisfied)(x, tasks));
+        if (!t)
+            return null;
+        t.status = 'running';
+        t.claimExpires = Date.now() + claimTtlSeconds() * 1000;
+        t.updatedAt = new Date().toISOString();
+        await saveTaskQueue(tasks);
+        isExecutingTask = true;
+        executionTaskId = t.id;
+        return t;
+    });
+}
+/**
+ * 心跳续期 (Hermes kanban_heartbeat): 执行中有实质进展时调用, 把 claim_expires 推到 now+TTL.
+ * CAS: 只续期当前执行中的任务 (executionTaskId 匹配 + status==='running').
+ */
+async function heartbeatTaskExecution(taskId) {
+    return withTaskQueueLock(async () => {
+        if (executionTaskId !== taskId)
+            return false;
+        const tasks = await loadTaskQueue();
+        const t = tasks.find((x) => x.id === taskId);
+        if (!t || t.status !== 'running')
+            return false;
+        t.claimExpires = Date.now() + claimTtlSeconds() * 1000;
+        t.updatedAt = new Date().toISOString();
+        await saveTaskQueue(tasks);
+        return true;
+    });
+}
+/**
+ * 释放过期认领 (Hermes release_stale_claims): 扫所有 running 且 claim_expires 已过期的任务
+ * → 释放 in-memory 锁 + 任务回 pending (可重新认领执行). 防 executeTask 卡死/崩溃后锁泄漏.
+ * 返回释放数量. 安全可频繁调用.
+ */
+async function releaseStaleClaims() {
+    return withTaskQueueLock(async () => {
+        const now = Date.now();
+        const tasks = await loadTaskQueue();
+        const stale = tasks.filter((t) => t.status === 'running' && t.claimExpires !== undefined && t.claimExpires < now);
+        if (stale.length === 0)
+            return 0;
+        for (const t of stale) {
+            t.status = 'pending';
+            t.claimExpires = undefined;
+            t.updatedAt = new Date().toISOString();
+        }
+        await saveTaskQueue(tasks);
+        // 当前执行锁指向过期任务 → 一并释放 (卡死的 executeTask 其锁也失效)
+        if (executionTaskId && stale.some((t) => t.id === executionTaskId)) {
+            isExecutingTask = false;
+            executionTaskId = null;
+        }
+        return stale.length;
+    });
+}
+/** 执行 task 的 helper 标记 (server.ts 内部 still 持有 lock) */
+function startTaskExecution(taskId) {
+    if (isExecutingTask)
+        return false;
+    isExecutingTask = true;
+    executionTaskId = taskId;
+    return true;
+}
+function endTaskExecution() {
+    isExecutingTask = false;
+    executionTaskId = null;
+}
+//# sourceMappingURL=server-storage.js.map

package/dist/electron-build/web/server-storage.js.map

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

package/dist/electron-build/web/server-types.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * server-types.ts — server.ts 拆出的纯类型 + 常量 + 路径
+ *
+ * 从 src/web/server.ts 抽出 (2026-07-06).
+ * 0 副作用, 0 模块级 state, 只放 type / interface / const 路径.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REMOTE_CACHE_FILE = exports.IPFS_ENDPOINT = exports.TASK_QUEUE_PATH = exports.THEME_PATH = exports.CHANNELS_PATH = exports.SESSION_CACHE_PATH = exports.SHARED_SESSION_PATH = void 0;
+const path = __importStar(require("path"));
+const HOME = process.env.HOME || process.env.USERPROFILE || '/tmp';
+exports.SHARED_SESSION_PATH = path.join(HOME, '.bolloon', 'sessions');
+exports.SESSION_CACHE_PATH = path.join(exports.SHARED_SESSION_PATH, 'cache');
+exports.CHANNELS_PATH = path.join(exports.SHARED_SESSION_PATH, 'channels.json');
+exports.THEME_PATH = path.join(exports.SHARED_SESSION_PATH, 'theme.json');
+exports.TASK_QUEUE_PATH = path.join(exports.SHARED_SESSION_PATH, 'task-queue.json');
+exports.IPFS_ENDPOINT = 'http://127.0.0.1:5001';
+exports.REMOTE_CACHE_FILE = path.join(HOME, '.bolloon', 'remote-channels-cache.json');
+//# sourceMappingURL=server-types.js.map

package/dist/electron-build/web/server-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-types.js","sourceRoot":"","sources":["../../../src/web/server-types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,MAAY,IAAI,iCAAa;AAE7B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;AAEtD,QAAA,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAC9D,QAAA,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,QAAA,mBAAmB,EAAE,OAAO,CAAC,CAAC;AAC7D,QAAA,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,QAAA,mBAAmB,EAAE,eAAe,CAAC,CAAC;AAChE,QAAA,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAA,mBAAmB,EAAE,YAAY,CAAC,CAAC;AAC1D,QAAA,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,QAAA,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;AACpE,QAAA,aAAa,GAAG,uBAAuB,CAAC;AACxC,QAAA,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,4BAA4B,CAAC,CAAC"}

package/dist/electron-build/web/task-deps.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * task-deps.ts — 任务父依赖校验 (借鉴 Hermes kanban 认领点父依赖不变式:
+ *   claim 时强制检查所有父任务 done/archived, 否则 demote 回 todo)
+ *
+ * 纯函数。bolloon 终态语义: completed/cancelled 视为父已结束 (依赖解除);
+ * failed 视为父未成功 (子任务不满足前提, 阻塞等人工决策)。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parentsSatisfied = parentsSatisfied;
+exports.unsatisfiedParents = unsatisfiedParents;
+const PARENT_DONE_STATUSES = new Set(['completed', 'cancelled']);
+/** 父依赖是否满足: 无父 / 父全部 completed|cancelled → true; 父 missing/failed/running/pending → false */
+function parentsSatisfied(task, allTasks) {
+    const parentIds = task?.parentIds;
+    if (!parentIds || parentIds.length === 0)
+        return true;
+    for (const pid of parentIds) {
+        const parent = allTasks.find((t) => t.id === pid);
+        // 父不存在 → 保守阻塞 (依赖悬空, 等人工修复)
+        if (!parent)
+            return false;
+        if (!PARENT_DONE_STATUSES.has(parent.status))
+            return false;
+    }
+    return true;
+}
+/** 列出未满足的父任务 id (诊断用) */
+function unsatisfiedParents(task, allTasks) {
+    const parentIds = task?.parentIds;
+    if (!parentIds || parentIds.length === 0)
+        return [];
+    const out = [];
+    for (const pid of parentIds) {
+        const parent = allTasks.find((t) => t.id === pid);
+        if (!parent || !PARENT_DONE_STATUSES.has(parent.status))
+            out.push(pid);
+    }
+    return out;
+}
+//# sourceMappingURL=task-deps.js.map

package/dist/electron-build/web/task-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-deps.js","sourceRoot":"","sources":["../../../src/web/task-deps.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;AAYH,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAEtF,6FAA6F;AAC7F,0BACE,IAA0C,EAC1C,QAA+C;IAE/C,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;IAClC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;QAClD,4BAA4B;QAC5B,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yBAAyB;AACzB,4BACE,IAA0C,EAC1C,QAA+C;IAE/C,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;IAClC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.js

@@ -2278,6 +2278,36 @@ async function processInputInner(input, comm) {
         catch { /* 静默 */ }
         return;
     }
+    // /contacts — 联系方式与持久授权统一入口 (2026-09-19, Phase 10)
+    //   /contacts · /contacts authorize [once|long|full] · /contacts revoke all|<id> · pause|resume · bind|verify
+    if (cmd === '/contacts' || cmd.startsWith('/contacts ')) {
+        try {
+            const { ContactChain } = await import('./agents/contacts/chain.js');
+            const { contactsCli } = await import('./agents/contacts/cli.js');
+            let ownerDid = globalThis.__bolloonUserDid || 'did:bolln:local';
+            try {
+                const fsmod = await import('fs');
+                const osmod = await import('os');
+                const pmod = await import('path');
+                const uf = pmod.join(process.env.HOME || osmod.homedir(), '.bolloon', 'identity', 'user.json');
+                const j = JSON.parse(fsmod.readFileSync(uf, 'utf8'));
+                if (j?.did)
+                    ownerDid = String(j.did);
+            }
+            catch { /* 还没有用户身份 → 本地占位 */ }
+            const chain = new ContactChain({ ownerDid, displayName: '本机用户' });
+            const rest = cmd.startsWith('/contacts ') ? cmd.slice('/contacts '.length).trim() : '';
+            const r = await contactsCli(chain, rest);
+            for (const line of r.lines)
+                appendLine(line);
+            if (!r.ok)
+                appendLine(`${C_WARN}命令没成功, 上面是原因${RESET}`);
+        }
+        catch (e) {
+            appendLine(`${C_ERROR}/contacts 失败: ${String(e?.message || e).slice(0, 160)}${RESET}`);
+        }
+        return;
+    }
     // /skills [名] — 查看正式技能 (2026-08-12 Task5): 无参列全部, 带名看详情. 运行时开始前的技能 view.
     if (cmd === '/skills' || cmd.startsWith('/skills ')) {
         try {
@@ -3616,32 +3646,33 @@ async function runToolCommand(tool, args, outputJson, comm, model, prompt) {
             }
             // ==================== Update Commands ====================
             case 'update-check': {
-                const { checkForUpdates } = await import('./utils/auto-update.js');
-                const info = await checkForUpdates();
-                if (info && info.outdated) {
-                    response = `📦 发现更新可用:\n\n` +
-                        `当前版本: ${info.version}\n` +
-                        `最新版本: ${info.latest}\n\n` +
-                        `待更新包:\n${info.packages.map(p => `  - ${p.name}: ${p.current} → ${p.latest}`).join('\n')}\n\n` +
-                        `运行 --update-now 进行更新`;
-                }
-                else {
-                    response = `✅ 已是最新版本 (${info?.version || 'unknown'})`;
-                }
+                // 2026-09-19: 统一走 Update Manager (唯一检查逻辑), 不再自己拼字符串结论
+                const { checkForUpdate } = await import('./utils/update-manager.js');
+                const r = await checkForUpdate({ force: true });
+                const head = r.status === 'up_to_date' ? '✅ 已是最新版本'
+                    : r.status === 'update_available' ? '📦 发现更新可用'
+                        : r.status === 'offline' || r.status === 'registry_unavailable' ? '⚠ 无法检查更新 (这不代表是最新版)'
+                            : r.status === 'local_version_unknown' ? '⚠ 读不到本地版本 (不判断是否有更新)'
+                                : r.status === 'unsupported_installation' ? '⚠ 当前安装方式不支持自动更新'
+                                    : 'ℹ 使用缓存结论';
+                response = `${head}\n\n当前版本: ${r.currentVersion}\n最新版本: ${r.latestVersion || '未知'}\n安装方式: ${r.installMethod}\n结论: ${r.status}${r.reason ? `\n说明: ${r.reason}` : ''}`;
+                if (r.status === 'update_available')
+                    response += `\n\n运行 bolloon update plan 看计划, bolloon update now 执行更新`;
+                if (r.status === 'offline' || r.status === 'registry_unavailable' || r.status === 'local_version_unknown')
+                    error = response;
                 break;
             }
             case 'update-now': {
-                const { performUpdate } = await import('./utils/auto-update.js');
-                const packages = args.length > 0 ? args : undefined;
-                const result = await performUpdate(packages);
-                if (result.success) {
-                    response = `✅ 更新成功${result.updatedPackages ? `: ${result.updatedPackages.join(', ')}` : ''}`;
-                    if (result.updated) {
-                        response += `\n\n${YELLOW}请重新启动应用以使用新版本${RESET}`;
-                    }
+                // 2026-09-19: 统一走同一条 applyUpdate 流水线 (计划 + 锁 + 校验 + 回滚)
+                const { applyUpdate } = await import('./utils/update-manager.js');
+                const res = await applyUpdate({ strategy: 'now' });
+                if (res.ok) {
+                    response = `✅ 更新成功: ${res.from} → ${res.to}\n\n${YELLOW}请重新启动应用以使用新版本${RESET}`;
                 }
                 else {
-                    response = `❌ 更新失败: ${result.error}`;
+                    response = res.stage === 'blocked'
+                        ? `⚠ 更新被阻塞: ${res.reason}`
+                        : `❌ 更新失败 (${res.stage}): ${res.reason}\n旧版本仍在: ${res.from} — 可继续使用`;
                     error = response;
                 }
                 break;
@@ -4471,12 +4502,12 @@ async function main() {
             printHelp();
             process.exit(0);
         }
-        // 启动自动更新检查（后台执行，不阻塞主流程）。
-        // 检测到新版本会自动安装；安装成功后自动重启以应用新版本。
-        // 可用 --no-update / BOLLOON_SKIP_UPDATE 关闭，
-        // 或用 config.json 的 autoUpdate:false / autoRestart:false / BOLLOON_AUTO_UPDATE=1 控制。
-        // 手动检查: bolloon --update-check
-        // 手动更新: bolloon --update-now [package]
+        // 启动时后台检查更新 (不阻塞主流程)。
+        // 2026-09-19 行为变更: **默认只通知, 不自动安装** —— 发现新版本会打印一行提示 +
+        //   "bolloon update plan / now"。要恢复自动安装需显式 config.json `autoInstall: true`
+        //   (+ `autoRestart: true` 才自动重启)。
+        // 关闭本次检查: --no-update / BOLLOON_SKIP_UPDATE=1; 临时开自动装: BOLLOON_AUTO_UPDATE=1
+        // 手动检查: bolloon update / bolloon update plan / bolloon doctor
         if (!args.updateCheck && !args.updateNow) {
             void (async () => {
                 try {

package/dist/llm/system-prompt/registry.js

@@ -12,10 +12,13 @@
  */
 import * as fs from 'fs/promises';
 import * as path from 'path';
-import { fileURLToPath } from 'url';
 import { stripHibsml } from './strip-hibsml.js';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const LAYERS_DIR = path.join(__dirname, 'layers');
+import { firstExisting, packageDirCandidates } from '../../utils/module-context.js';
+// 2026-09-19: 原先是 path.dirname(fileURLToPath(import.meta.url)) + 'layers'.
+//   electron 构建是 CommonJS, 用 import.meta 直接 TS1343 (发布门过不去);
+//   而且 electron 产物的同级目录里没有 .md, 光靠 __dirname 也读不到。
+//   现在按 CJS同级 → dist/llm/system-prompt → src/llm/system-prompt 依次探测。
+const LAYERS_DIR = firstExisting(packageDirCandidates(path.join('llm', 'system-prompt', 'layers')));
 // 2026-06-17: VERBOSE 开关 — BOLLOON_VERBOSE=1 时打 layer 读失败诊断
 // 默认静默 (每次 chat 跑 25 次 fs.readFile, 失败 spam 会污染终端)
 const VERBOSE = process.env.BOLLOON_VERBOSE === '1';