opclawtm 1.4.0

package/dist/core/services/dept.service.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Department (Team) Service
+ */
+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.deptService = exports.DeptService = void 0;
+const fs = __importStar(require("fs"));
+const dept_repo_1 = require("../../db/repositories/dept.repo");
+const agent_repo_1 = require("../../db/repositories/agent.repo");
+const utils_1 = require("../utils");
+const openclaw_helper_1 = require("../utils/openclaw-helper");
+const configTracker = __importStar(require("./config-tracker.service"));
+class DeptService {
+    /**
+     * Create department (team)
+     */
+    create(data) {
+        try {
+            const deptId = data.id || (0, utils_1.generateDeptId)();
+            const department = dept_repo_1.departmentRepository.create(deptId, data.name);
+            // 记录配置变更
+            configTracker.recordConfigChange({
+                change_type: 'department_create',
+                action: 'add',
+                target_path: `departments/${deptId}`,
+                target_type: 'departments',
+                new_value: JSON.stringify({ id: deptId, name: data.name })
+            });
+            return { success: true, department, message: '团队创建成功' };
+        }
+        catch (error) {
+            return { success: false, message: `创建失败: ${error instanceof Error ? error.message : String(error)}` };
+        }
+    }
+    /**
+     * Get department by ID
+     */
+    getById(id) {
+        return dept_repo_1.departmentRepository.findById(id);
+    }
+    /**
+     * List all departments (teams)
+     */
+    listAll() {
+        return dept_repo_1.departmentRepository.findAll();
+    }
+    /**
+     * Update department (team)
+     */
+    update(id, data) {
+        dept_repo_1.departmentRepository.updateDept(id, data);
+    }
+    /**
+     * Delete department (team)
+     * Note: Must delete all agents in the department first
+     *
+     * @returns success, message, and restartReminder if Gateway restart is needed
+     */
+    delete(id) {
+        // Check if there are agents
+        const agents = agent_repo_1.agentRepository.findByDepartment(id);
+        if (agents.length > 0) {
+            return {
+                success: false,
+                message: `无法删除：团队下还有 ${agents.length} 个Agent，请先删除这些Agent`
+            };
+        }
+        // Get department info for cleaning up feishu group binding
+        const dept = dept_repo_1.departmentRepository.findById(id);
+        // Clean up feishu group binding (if any)
+        if (dept?.feishu_group_id) {
+            this.removeFeishuGroupBinding(dept.feishu_group_id);
+        }
+        // Record department deletion (for reset to restore)
+        if (dept) {
+            configTracker.recordConfigChange({
+                change_type: 'department_delete',
+                action: 'remove',
+                target_path: `departments/${id}`,
+                target_type: 'departments',
+                old_value: JSON.stringify({ id, name: dept.name, feishu_group_id: dept.feishu_group_id }),
+                related_id: id,
+                description: `删除团队: ${dept.name}`
+            });
+        }
+        dept_repo_1.departmentRepository.deleteDept(id);
+        // Return success with restart reminder (Gateway restart is needed to disconnect Feishu WebSocket)
+        return {
+            success: true,
+            message: '团队已删除',
+            restartReminder: (0, openclaw_helper_1.getGatewayRestartReminder)()
+        };
+    }
+    /**
+     * Remove feishu group binding from openclaw.json
+     *
+     * Cleans up:
+     * 1. bindings - remove group bindings for this groupId
+     * 2. channels.feishu.groupAllowFrom - remove groupId from whitelist
+     * 3. channels.feishu.groups[groupId] - remove group-specific config
+     *
+     * This is user-initiated operation, delete binding directly without recording to config_changes
+     * Reset will not restore user-deleted content
+     */
+    removeFeishuGroupBinding(groupId) {
+        try {
+            const configPath = (0, utils_1.getOpenClawJsonPath)();
+            if (!fs.existsSync(configPath))
+                return;
+            const content = fs.readFileSync(configPath, 'utf-8');
+            const config = JSON.parse(content);
+            let configChanged = false;
+            // 1. Remove bindings for this group
+            if (config.bindings && Array.isArray(config.bindings)) {
+                const originalLength = config.bindings.length;
+                config.bindings = config.bindings.filter((b) => {
+                    const match = b.match;
+                    return !(match?.channel === 'feishu' &&
+                        match?.peer?.kind === 'group' &&
+                        match?.peer?.id === groupId);
+                });
+                if (config.bindings.length < originalLength) {
+                    configChanged = true;
+                    console.log(`[飞书群解绑] 已移除 ${originalLength - config.bindings.length} 个绑定记录`);
+                }
+            }
+            // 2. Remove groupId from groupAllowFrom whitelist
+            const channels = config.channels;
+            const feishuConfig = channels?.feishu;
+            if (feishuConfig?.groupAllowFrom && Array.isArray(feishuConfig.groupAllowFrom)) {
+                const groupAllowFrom = feishuConfig.groupAllowFrom;
+                const originalLength = groupAllowFrom.length;
+                feishuConfig.groupAllowFrom = groupAllowFrom.filter((id) => id !== groupId);
+                if (feishuConfig.groupAllowFrom.length < originalLength) {
+                    configChanged = true;
+                    console.log(`[飞书群解绑] 已从白名单移除群: ${groupId}`);
+                }
+            }
+            // 3. Remove group-specific config (requireMention, etc.)
+            if (feishuConfig?.groups && typeof feishuConfig.groups === 'object') {
+                const groups = feishuConfig.groups;
+                if (groups[groupId]) {
+                    delete groups[groupId];
+                    configChanged = true;
+                    console.log(`[飞书群解绑] 已移除群配置: ${groupId}`);
+                }
+            }
+            // Save config if any changes were made
+            if (configChanged) {
+                fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+            }
+        }
+        catch (error) {
+            console.warn(`警告：移除飞书群绑定失败: ${error}`);
+        }
+    }
+    /**
+     * Bind feishu group
+     */
+    bindFeishuGroup(id, groupId) {
+        dept_repo_1.departmentRepository.updateDept(id, { feishu_group_id: groupId });
+    }
+    /**
+     * Unbind feishu group (user-initiated operation)
+     *
+     * @returns success, message, and restartReminder if Gateway restart is needed
+     */
+    unbindFeishuGroup(id) {
+        const dept = dept_repo_1.departmentRepository.findById(id);
+        const oldGroupId = dept?.feishu_group_id;
+        if (oldGroupId) {
+            // Record the unbinding for reset to potentially restore
+            configTracker.recordFeishuGroupUnbind(id, dept?.name || id, oldGroupId);
+            // Clean up openclaw.json bindings and group config
+            this.removeFeishuGroupBinding(oldGroupId);
+        }
+        dept_repo_1.departmentRepository.updateDept(id, { feishu_group_id: null });
+        // Return success with restart reminder (Gateway restart is needed to disconnect Feishu WebSocket)
+        return {
+            success: true,
+            message: '飞书群已解绑',
+            restartReminder: (0, openclaw_helper_1.getGatewayRestartReminder)()
+        };
+    }
+    /**
+     * Get feishu group binding (v1.1.1)
+     * Returns the feishu group ID and binding status for a department
+     */
+    getFeishuBinding(id) {
+        const dept = dept_repo_1.departmentRepository.findById(id);
+        if (!dept) {
+            return {
+                success: false,
+                department_id: id,
+                department_name: '',
+                group_id: null,
+                is_bound: false,
+                message: '事业部不存在'
+            };
+        }
+        return {
+            success: true,
+            department_id: id,
+            department_name: dept.name,
+            group_id: dept.feishu_group_id,
+            is_bound: !!dept.feishu_group_id,
+            message: dept.feishu_group_id
+                ? `已绑定飞书群: ${dept.feishu_group_id}`
+                : '未绑定飞书群'
+        };
+    }
+    /**
+     * Get department statistics
+     */
+    getStats(id) {
+        const agents = agent_repo_1.agentRepository.findByDepartment(id);
+        return {
+            agent_count: agents.length,
+            manager_count: agents.filter(a => a.role === 'manager').length,
+            executor_count: agents.filter(a => a.role === 'executor').length,
+            reviewer_count: agents.filter(a => a.role === 'reviewer').length
+        };
+    }
+}
+exports.DeptService = DeptService;
+exports.deptService = new DeptService();
+//# sourceMappingURL=dept.service.js.map

package/dist/core/services/dept.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dept.service.js","sourceRoot":"","sources":["../../../src/core/services/dept.service.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,+DAAuE;AACvE,iEAAmE;AAEnE,oCAA+D;AAC/D,8DAAqE;AACrE,wEAA0D;AAE1D,MAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,IAAmC;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,IAAI,IAAA,sBAAc,GAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,gCAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAElE,SAAS;YACT,aAAa,CAAC,kBAAkB,CAAC;gBAC/B,WAAW,EAAE,mBAAmB;gBAChC,MAAM,EAAE,KAAK;gBACb,WAAW,EAAE,eAAe,MAAM,EAAE;gBACpC,WAAW,EAAE,aAAa;gBAC1B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;aAC3D,CAAC,CAAC;YAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACxG,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAU;QAChB,OAAO,gCAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,gCAAoB,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,IAAiD;QAClE,gCAAoB,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,EAAU;QACf,4BAA4B;QAC5B,MAAM,MAAM,GAAG,4BAAe,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,cAAc,MAAM,CAAC,MAAM,qBAAqB;aAC1D,CAAC;QACJ,CAAC;QAED,2DAA2D;QAC3D,MAAM,IAAI,GAAG,gCAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAE/C,yCAAyC;QACzC,IAAI,IAAI,EAAE,eAAe,EAAE,CAAC;YAC1B,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACtD,CAAC;QAED,oDAAoD;QACpD,IAAI,IAAI,EAAE,CAAC;YACT,aAAa,CAAC,kBAAkB,CAAC;gBAC/B,WAAW,EAAE,mBAAmB;gBAChC,MAAM,EAAE,QAAQ;gBAChB,WAAW,EAAE,eAAe,EAAE,EAAE;gBAChC,WAAW,EAAE,aAAa;gBAC1B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzF,UAAU,EAAE,EAAE;gBACd,WAAW,EAAE,SAAS,IAAI,CAAC,IAAI,EAAE;aAClC,CAAC,CAAC;QACL,CAAC;QAED,gCAAoB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAEpC,kGAAkG;QAClG,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO;YAChB,eAAe,EAAE,IAAA,2CAAyB,GAAE;SAC7C,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACK,wBAAwB,CAAC,OAAe;QAC9C,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAA,2BAAmB,GAAE,CAAC;YACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,OAAO;YAEvC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,IAAI,aAAa,GAAG,KAAK,CAAC;YAE1B,oCAAoC;YACpC,IAAI,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtD,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC9C,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CACtC,CAAC,CAA0E,EAAE,EAAE;oBAC7E,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;oBACtB,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ;wBAC3B,KAAK,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO;wBAC7B,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,OAAO,CAAC,CAAC;gBACxC,CAAC,CACF,CAAC;gBAEF,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;oBAC5C,aAAa,GAAG,IAAI,CAAC;oBACrB,OAAO,CAAC,GAAG,CAAC,eAAe,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;YAED,kDAAkD;YAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAA+C,CAAC;YACxE,MAAM,YAAY,GAAG,QAAQ,EAAE,MAA6C,CAAC;YAE7E,IAAI,YAAY,EAAE,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC/E,MAAM,cAAc,GAAG,YAAY,CAAC,cAA0B,CAAC;gBAC/D,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC;gBAC7C,YAAY,CAAC,cAAc,GAAG,cAAc,CAAC,MAAM,CACjD,CAAC,EAAU,EAAE,EAAE,CAAC,EAAE,KAAK,OAAO,CAC/B,CAAC;gBAEF,IAAK,YAAY,CAAC,cAA2B,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;oBACtE,aAAa,GAAG,IAAI,CAAC;oBACrB,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;YAED,yDAAyD;YACzD,IAAI,YAAY,EAAE,MAAM,IAAI,OAAO,YAAY,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACpE,MAAM,MAAM,GAAG,YAAY,CAAC,MAAiC,CAAC;gBAC9D,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;oBACpB,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;oBACvB,aAAa,GAAG,IAAI,CAAC;oBACrB,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YAED,uCAAuC;YACvC,IAAI,aAAa,EAAE,CAAC;gBAClB,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,EAAU,EAAE,OAAe;QACzC,gCAAoB,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,EAAU;QAC1B,MAAM,IAAI,GAAG,gCAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,EAAE,eAAe,CAAC;QAEzC,IAAI,UAAU,EAAE,CAAC;YACf,wDAAwD;YACxD,aAAa,CAAC,uBAAuB,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;YAExE,mDAAmD;YACnD,IAAI,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;QAED,gCAAoB,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,kGAAkG;QAClG,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,QAAQ;YACjB,eAAe,EAAE,IAAA,2CAAyB,GAAE;SAC7C,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,EAAU;QAQzB,MAAM,IAAI,GAAG,gCAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,aAAa,EAAE,EAAE;gBACjB,eAAe,EAAE,EAAE;gBACnB,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,QAAQ;aAClB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,EAAE;YACjB,eAAe,EAAE,IAAI,CAAC,IAAI;YAC1B,QAAQ,EAAE,IAAI,CAAC,eAAe;YAC9B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe;YAChC,OAAO,EAAE,IAAI,CAAC,eAAe;gBAC3B,CAAC,CAAC,WAAW,IAAI,CAAC,eAAe,EAAE;gBACnC,CAAC,CAAC,QAAQ;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,EAAU;QAMjB,MAAM,MAAM,GAAG,4BAAe,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,MAAM;YAC9D,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,MAAM;YAChE,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,MAAM;SACjE,CAAC;IACJ,CAAC;CACF;AA7PD,kCA6PC;AAEY,QAAA,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/core/services/document.service.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Document Service
+ *
+ * v1.1.5 更新：
+ * - 实现级联存储结构：增量任务存储在主任务的 increments/ 目录下
+ * - 路径格式：tasks/{main_task_id}/increments/{increment_seq}/
+ *
+ * v1.1.1 更新：
+ * - 修正存储路径，使用 OpenClaw 标准目录结构
+ * - 按任务→节点层级组织成果物
+ */
+import { Document, DocumentType, CreateDocOptions, GetDocOptions } from '../models/types';
+export declare class DocumentService {
+    /**
+     * Get tasks storage root directory
+     * Path: {openclaw_root}/tasks/
+     */
+    private getTasksRoot;
+    /**
+     * Get task directory (v1.1.5 级联结构)
+     *
+     * 主任务: {openclaw_root}/tasks/{task_id}/
+     * 增量任务: {openclaw_root}/tasks/{main_task_id}/increments/{seq}/
+     *
+     * 例如：
+     * - 主任务 task_20260321_xxx -> tasks/task_20260321_xxx/
+     * - 增量任务 task_20260321_xxx_001 -> tasks/task_20260321_xxx/increments/001/
+     */
+    private getTaskDirectory;
+    /**
+     * 判断是否是增量任务
+     */
+    private isIncrementTask;
+    /**
+     * 获取增量任务的序号
+     */
+    private getIncrementSequence;
+    /**
+     * 获取增量任务的主任务ID
+     */
+    getMainTaskId(taskId: string): string;
+    /**
+     * Generate increment task ID
+     * Format: {main_task_id}_{seq}
+     */
+    generateIncrementTaskId(mainTaskId: string, sequence: number): string;
+    /**
+     * Get next increment sequence for a main task
+     */
+    getNextIncrementSequence(mainTaskId: string): number;
+    /**
+     * Get document directory by type (v1.1.5)
+     */
+    private getDocDirectory;
+    /**
+     * Get document file name
+     */
+    private getDocFileName;
+    /**
+     * Ensure directory exists
+     */
+    private ensureDirectory;
+    /**
+     * Create document (v1.1.5 级联存储)
+     *
+     * Storage paths:
+     * - 主任务 requirement: tasks/{task_id}/requirement/requirement.md
+     * - 主任务 plan: tasks/{task_id}/plan/plan.md
+     * - 主任务 output: tasks/{task_id}/nodes/{node_id}/output.md
+     * - 增量任务 requirement: tasks/{main_task_id}/increments/{seq}/requirement/requirement.md
+     * - 增量任务 output: tasks/{main_task_id}/increments/{seq}/nodes/{node_id}/output.md
+     */
+    create(options: CreateDocOptions): {
+        success: boolean;
+        document?: Document;
+        message: string;
+    };
+    /**
+     * Get document(s)
+     */
+    get(options: GetDocOptions): Document | Document[] | null;
+    /**
+     * Get document by ID
+     */
+    getById(id: string): Document | undefined;
+    /**
+     * List documents by task
+     */
+    listByTask(taskId: string, type?: DocumentType): Document[];
+    /**
+     * Read document content
+     */
+    readContent(id: string): string | null;
+    /**
+     * Read document content by path
+     */
+    readContentByPath(filePath: string): string | null;
+    /**
+     * Update document status
+     */
+    updateStatus(id: string, status: string): {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Delete document
+     */
+    delete(id: string): {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Get task output directory
+     * Used by agents to know where to store artifacts
+     */
+    getTaskOutputDirectory(taskId: string, nodeId?: string): string;
+    /**
+     * Get task plan directory
+     */
+    getTaskPlanDirectory(taskId: string): string;
+    /**
+     * Get task reviews directory
+     */
+    getTaskReviewsDirectory(taskId: string): string;
+    /**
+     * List all output files for a task
+     */
+    listTaskOutputs(taskId: string): string[];
+}
+export declare const documentService: DocumentService;
+//# sourceMappingURL=document.service.d.ts.map

package/dist/core/services/document.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/document.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG1F,qBAAa,eAAe;IAK1B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAKrC;;;OAGG;IACH,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIrE;;OAEG;IACH,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAmBpD;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;;;;;;;;OASG;IACH,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAqC7F;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,QAAQ,EAAE,GAAG,IAAI;IAYzD;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIzC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,EAAE;IAO3D;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IActC;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAWlD;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAY/E;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IA0BzD;;;OAGG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAI/D;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI5C;;OAEG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI/C;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;CAwB1C;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}