@emqo/claudebridge 0.5.3 → 0.6.1

package/dist/adapters/discord.js

@@ -304,7 +304,12 @@ export class DiscordAdapter {
         };
         const lines = recent.map(task => {
             const chain = task.parent_id ? ` (chain #${task.parent_id})` : "";
-            return `${statusEmoji[task.status] || "[?]"} #${task.id} [${task.status}] ${task.description.slice(0, 60)}${chain}`;
+            let schedInfo = "";
+            if (task.status === "auto" && task.scheduled_at && task.scheduled_at > Date.now()) {
+                const mins = Math.ceil((task.scheduled_at - Date.now()) / 60000);
+                schedInfo = ` [in ${mins}min]`;
+            }
+            return `${statusEmoji[task.status] || "[?]"} #${task.id} [${task.status}]${schedInfo} ${task.description.slice(0, 60)}${chain}`;
         });
         const stats = this.store.getAutoTaskStats();
         const summary = stats.map(s => `${s.status}: ${s.count}`).join(" | ");

package/dist/adapters/telegram.js

@@ -515,7 +515,12 @@ export class TelegramAdapter {
         };
         const lines = recent.map(task => {
             const chain = task.parent_id ? ` (chain #${task.parent_id})` : "";
-            return `${statusEmoji[task.status] || "[?]"} #${task.id} [${task.status}] ${task.description.slice(0, 60)}${chain}`;
+            let schedInfo = "";
+            if (task.status === "auto" && task.scheduled_at && task.scheduled_at > Date.now()) {
+                const mins = Math.ceil((task.scheduled_at - Date.now()) / 60000);
+                schedInfo = ` [in ${mins}min]`;
+            }
+            return `${statusEmoji[task.status] || "[?]"} #${task.id} [${task.status}]${schedInfo} ${task.description.slice(0, 60)}${chain}`;
         });
         const stats = this.store.getAutoTaskStats();
         const summary = stats.map(s => `${s.status}: ${s.count}`).join(" | ");

package/dist/core/i18n.js

@@ -11,6 +11,7 @@ const messages = {
         upload_failed: "Upload failed: ",
         reminder_notify: "Reminder: {desc}",
         auto_starting: "Auto task #{id} starting:\n{desc}",
+        auto_scheduled: "Auto task #{id} scheduled (executes in {minutes} min):\n{desc}",
         auto_done: "Auto task #{id} done (cost: ${cost}):",
         auto_failed: "Auto task #{id} failed: {err}",
         page_expired: "Page expired. Please resend your question.",
@@ -34,6 +35,7 @@ const messages = {
         upload_failed: "上传失败：",
         reminder_notify: "提醒：{desc}",
         auto_starting: "自动任务 #{id} 开始执行：\n{desc}",
+        auto_scheduled: "自动任务 #{id} 已排程（{minutes} 分钟后执行）：\n{desc}",
         auto_done: "自动任务 #{id} 完成（花费：${cost}）：",
         auto_failed: "自动任务 #{id} 失败：{err}",
         page_expired: "页面已过期，请重新发送问题。",

package/dist/core/store.d.ts

@@ -30,7 +30,7 @@ export declare class Store {
     }[];
     clearMemories(userId: string): void;
     trimMemories(userId: string, max: number): void;
-    addTask(userId: string, platform: string, chatId: string, description: string, remindAt?: number, auto?: boolean, parentId?: number): number;
+    addTask(userId: string, platform: string, chatId: string, description: string, remindAt?: number, auto?: boolean, parentId?: number, scheduledAt?: number): number;
     getTasks(userId: string): {
         id: number;
         description: string;
@@ -60,9 +60,10 @@ export declare class Store {
         id: number;
         description: string;
         status: string;
+        scheduled_at: number | null;
         created_at: number;
     }[];
-    addApprovalTask(userId: string, platform: string, chatId: string, description: string, parentId?: number): number;
+    addApprovalTask(userId: string, platform: string, chatId: string, description: string, parentId?: number, scheduledAt?: number): number;
     getPendingApprovals(platform: string): {
         id: number;
         user_id: string;
@@ -104,6 +105,7 @@ export declare class Store {
         description: string;
         status: string;
         parent_id: number | null;
+        scheduled_at: number | null;
         created_at: number;
     }[];
 }

package/dist/core/store.js

@@ -55,7 +55,7 @@ export class Store {
       CREATE INDEX IF NOT EXISTS idx_memories_user ON memories(user_id);
       CREATE INDEX IF NOT EXISTS idx_tasks_user ON tasks(user_id, status);
     `);
-        // Schema migration: add parent_id and result columns
+        // Schema migration: add parent_id, result, and scheduled_at columns
         try {
             this.db.exec("ALTER TABLE tasks ADD COLUMN parent_id INTEGER");
         }
@@ -64,7 +64,16 @@ export class Store {
             this.db.exec("ALTER TABLE tasks ADD COLUMN result TEXT");
         }
         catch { }
+        try {
+            this.db.exec("ALTER TABLE tasks ADD COLUMN scheduled_at INTEGER");
+        }
+        catch { }
         this.db.exec("CREATE INDEX IF NOT EXISTS idx_tasks_parent ON tasks(parent_id)");
+        // Startup recovery: reset orphaned 'running' tasks back to 'auto' so they get re-executed
+        const recovered = this.db.prepare("UPDATE tasks SET status = 'auto' WHERE status = 'running'").run();
+        if (recovered.changes > 0) {
+            console.log(`[store] recovered ${recovered.changes} orphaned running task(s) back to auto queue`);
+        }
     }
     // --- sessions ---
     getSession(userId) {
@@ -130,8 +139,8 @@ export class Store {
         this.db.prepare("DELETE FROM memories WHERE user_id = ? AND id NOT IN (SELECT id FROM memories WHERE user_id = ? ORDER BY created_at DESC LIMIT ?)").run(userId, userId, max);
     }
     // --- tasks ---
-    addTask(userId, platform, chatId, description, remindAt, auto = false, parentId) {
-        const r = this.db.prepare("INSERT INTO tasks (user_id, platform, chat_id, description, status, remind_at, parent_id, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)").run(userId, platform, chatId, description, auto ? "auto" : "pending", remindAt ?? null, parentId ?? null, Date.now());
+    addTask(userId, platform, chatId, description, remindAt, auto = false, parentId, scheduledAt) {
+        const r = this.db.prepare("INSERT INTO tasks (user_id, platform, chat_id, description, status, remind_at, parent_id, scheduled_at, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)").run(userId, platform, chatId, description, auto ? "auto" : "pending", remindAt ?? null, parentId ?? null, scheduledAt ?? null, Date.now());
         return Number(r.lastInsertRowid);
     }
     getTasks(userId) {
@@ -148,10 +157,11 @@ export class Store {
         this.db.prepare("UPDATE tasks SET reminder_sent = 1 WHERE id = ?").run(taskId);
     }
     getNextAutoTask(platform) {
+        const now = Date.now();
         if (platform) {
-            return this.db.prepare("SELECT id, user_id, platform, chat_id, description FROM tasks WHERE status = 'auto' AND platform = ? ORDER BY created_at ASC LIMIT 1").get(platform) ?? null;
+            return this.db.prepare("SELECT id, user_id, platform, chat_id, description FROM tasks WHERE status = 'auto' AND platform = ? AND (scheduled_at IS NULL OR scheduled_at <= ?) ORDER BY created_at ASC LIMIT 1").get(platform, now) ?? null;
         }
-        return this.db.prepare("SELECT id, user_id, platform, chat_id, description FROM tasks WHERE status = 'auto' ORDER BY created_at ASC LIMIT 1").get() ?? null;
+        return this.db.prepare("SELECT id, user_id, platform, chat_id, description FROM tasks WHERE status = 'auto' AND (scheduled_at IS NULL OR scheduled_at <= ?) ORDER BY created_at ASC LIMIT 1").get(now) ?? null;
     }
     markTaskRunning(taskId) {
         this.db.prepare("UPDATE tasks SET status = 'running' WHERE id = ?").run(taskId);
@@ -160,11 +170,11 @@ export class Store {
         this.db.prepare("UPDATE tasks SET status = ? WHERE id = ?").run(status, taskId);
     }
     getAutoTasks(userId) {
-        return this.db.prepare("SELECT id, description, status, created_at FROM tasks WHERE user_id = ? AND status IN ('auto','running') ORDER BY created_at DESC").all(userId);
+        return this.db.prepare("SELECT id, description, status, scheduled_at, created_at FROM tasks WHERE user_id = ? AND status IN ('auto','running') ORDER BY created_at DESC").all(userId);
     }
     // --- HITL (Human-in-the-Loop) ---
-    addApprovalTask(userId, platform, chatId, description, parentId) {
-        const r = this.db.prepare("INSERT INTO tasks (user_id, platform, chat_id, description, status, parent_id, created_at) VALUES (?, ?, ?, ?, 'approval_pending', ?, ?)").run(userId, platform, chatId, description, parentId ?? null, Date.now());
+    addApprovalTask(userId, platform, chatId, description, parentId, scheduledAt) {
+        const r = this.db.prepare("INSERT INTO tasks (user_id, platform, chat_id, description, status, parent_id, scheduled_at, created_at) VALUES (?, ?, ?, ?, 'approval_pending', ?, ?, ?)").run(userId, platform, chatId, description, parentId ?? null, scheduledAt ?? null, Date.now());
         return Number(r.lastInsertRowid);
     }
     getPendingApprovals(platform) {
@@ -187,7 +197,7 @@ export class Store {
     }
     // --- Parallel ---
     getNextAutoTasks(platform, limit) {
-        return this.db.prepare("SELECT id, user_id, platform, chat_id, description, parent_id FROM tasks WHERE status = 'auto' AND platform = ? ORDER BY created_at ASC LIMIT ?").all(platform, limit);
+        return this.db.prepare("SELECT id, user_id, platform, chat_id, description, parent_id FROM tasks WHERE status = 'auto' AND platform = ? AND (scheduled_at IS NULL OR scheduled_at <= ?) ORDER BY created_at ASC LIMIT ?").all(platform, Date.now(), limit);
     }
     // --- Observability ---
     getAutoTaskStats(userId) {
@@ -211,6 +221,6 @@ export class Store {
         return result;
     }
     getRecentAutoTasks(platform, limit) {
-        return this.db.prepare("SELECT id, user_id, description, status, parent_id, created_at FROM tasks WHERE platform = ? AND status IN ('auto','running','done','failed','approval_pending','cancelled') ORDER BY created_at DESC LIMIT ?").all(platform, limit);
+        return this.db.prepare("SELECT id, user_id, description, status, parent_id, scheduled_at, created_at FROM tasks WHERE platform = ? AND status IN ('auto','running','done','failed','approval_pending','cancelled') ORDER BY created_at DESC LIMIT ?").all(platform, limit);
     }
 }

package/dist/ctl.js

@@ -109,23 +109,39 @@ else if (category === "auto") {
             parentId = parseInt(descParts[parentIdx + 1]);
             descParts.splice(parentIdx, 2);
         }
+        // Parse optional --delay flag
+        let scheduledAt = null;
+        const delayIdx = descParts.indexOf("--delay");
+        if (delayIdx !== -1 && descParts[delayIdx + 1]) {
+            const delayMin = parseInt(descParts[delayIdx + 1]);
+            scheduledAt = Date.now() + delayMin * 60000;
+            descParts.splice(delayIdx, 2);
+        }
         const desc = descParts.join(" ");
-        const r = db.prepare("INSERT INTO tasks (user_id, platform, chat_id, description, status, parent_id, created_at) VALUES (?, ?, ?, ?, 'auto', ?, ?)").run(userId, platform, chatId, desc, parentId, Date.now());
-        output({ ok: true, id: Number(r.lastInsertRowid), message: "Auto task queued" });
+        const r = db.prepare("INSERT INTO tasks (user_id, platform, chat_id, description, status, parent_id, scheduled_at, created_at) VALUES (?, ?, ?, ?, 'auto', ?, ?, ?)").run(userId, platform, chatId, desc, parentId, scheduledAt, Date.now());
+        output({ ok: true, id: Number(r.lastInsertRowid), scheduled_at: scheduledAt, message: scheduledAt ? `Auto task scheduled (in ${Math.ceil((scheduledAt - Date.now()) / 60000)} min)` : "Auto task queued" });
     }
     else if (action === "add-approval") {
         const [userId, platform, chatId, ...descParts] = rest;
         if (!userId || !platform || !chatId || !descParts.length)
-            fail("Usage: auto add-approval <user_id> <platform> <chat_id> <description> [--parent <id>]");
+            fail("Usage: auto add-approval <user_id> <platform> <chat_id> <description> [--parent <id>] [--delay <minutes>]");
         let parentId = null;
         const parentIdx = descParts.indexOf("--parent");
         if (parentIdx !== -1 && descParts[parentIdx + 1]) {
             parentId = parseInt(descParts[parentIdx + 1]);
             descParts.splice(parentIdx, 2);
         }
+        // Parse optional --delay flag
+        let scheduledAt = null;
+        const delayIdx = descParts.indexOf("--delay");
+        if (delayIdx !== -1 && descParts[delayIdx + 1]) {
+            const delayMin = parseInt(descParts[delayIdx + 1]);
+            scheduledAt = Date.now() + delayMin * 60000;
+            descParts.splice(delayIdx, 2);
+        }
         const desc = descParts.join(" ");
-        const r = db.prepare("INSERT INTO tasks (user_id, platform, chat_id, description, status, parent_id, created_at) VALUES (?, ?, ?, ?, 'approval_pending', ?, ?)").run(userId, platform, chatId, desc, parentId, Date.now());
-        output({ ok: true, id: Number(r.lastInsertRowid), message: "Auto task queued for approval" });
+        const r = db.prepare("INSERT INTO tasks (user_id, platform, chat_id, description, status, parent_id, scheduled_at, created_at) VALUES (?, ?, ?, ?, 'approval_pending', ?, ?, ?)").run(userId, platform, chatId, desc, parentId, scheduledAt, Date.now());
+        output({ ok: true, id: Number(r.lastInsertRowid), scheduled_at: scheduledAt, message: scheduledAt ? `Auto task queued for approval (scheduled in ${Math.ceil((scheduledAt - Date.now()) / 60000)} min)` : "Auto task queued for approval" });
     }
     else if (action === "result") {
         const [taskId, ...resultParts] = rest;
@@ -139,7 +155,7 @@ else if (category === "auto") {
         const [userId] = rest;
         if (!userId)
             fail("Usage: auto list <user_id>");
-        const rows = db.prepare("SELECT id, description, status, created_at FROM tasks WHERE user_id = ? AND status IN ('auto','running') ORDER BY created_at DESC").all(userId);
+        const rows = db.prepare("SELECT id, description, status, scheduled_at, created_at FROM tasks WHERE user_id = ? AND status IN ('auto','running') ORDER BY created_at DESC").all(userId);
         output({ ok: true, tasks: rows });
     }
     else if (action === "cancel") {

package/dist/skills/bridge.js

@@ -30,6 +30,7 @@ export function generateSkillDoc(ctx) {
             ``,
             `### 自动任务`,
             `- 创建自动任务: \`${ctl} auto add ${ctx.userId} ${ctx.platform} ${ctx.chatId} "任务描述"\``,
+            `- 创建定时自动任务: \`${ctl} auto add ${ctx.userId} ${ctx.platform} ${ctx.chatId} "任务描述" --delay <分钟数>\``,
             `- 查看自动任务: \`${ctl} auto list ${ctx.userId}\``,
             `- 取消自动任务: \`${ctl} auto cancel <任务ID>\``,
             ``,
@@ -75,6 +76,42 @@ export function generateSkillDoc(ctx) {
             `  2. 任务#2: "修复N+1查询" (--parent 1)`,
             `  3. 任务#3: "添加缓存层" (--parent 1)`,
             `  4. 任务#4: "运行基准测试" (--parent 1)`,
+            ``,
+            `### 定时自动任务`,
+            `- 用 --delay <分钟数> 安排延迟执行: \`${ctl} auto add ${ctx.userId} ${ctx.platform} ${ctx.chatId} "任务描述" --delay 30\``,
+            `- 任务创建后不会立即执行，等到延迟时间到达后才进入执行队列`,
+            `- 适用场景：需要等待、验证、或时间间隔的任务`,
+            `- 可与 --parent 组合使用: \`${ctl} auto add ${ctx.userId} ${ctx.platform} ${ctx.chatId} "验证部署" --delay 15 --parent 42\``,
+            `- 审批任务也支持延迟: \`${ctl} auto add-approval ${ctx.userId} ${ctx.platform} ${ctx.chatId} "描述" --delay 60\``,
+            ``,
+            `### 自主项目管理模式`,
+            `当用户委托你全程管理一个项目时，使用以下模式：`,
+            ``,
+            `**模式1：部署验证**`,
+            `- 任务1: "部署代码到staging"`,
+            `- 任务2 (--delay 15): "检查staging健康状态：访问/health端点，查看最近日志是否有错误"`,
+            `- 任务3 (--delay 30): "如果staging正常则部署到生产环境，否则回滚并报告"`,
+            ``,
+            `**模式2：迭代开发**`,
+            `- 任务1: "分析项目，识别所有需要修改的点，保存到记忆"`,
+            `- 任务2 (--delay 2): "读取记忆，执行第一批修改，运行测试"`,
+            `- 任务3 (--delay 5): "检查测试结果，修复失败用例"`,
+            `- 任务4 (--delay 3): "运行完整集成测试，生成报告"`,
+            ``,
+            `**模式3：监控巡检**`,
+            `- 任务1: "检查应用状态：CPU、内存、错误率"`,
+            `- 任务2 (--delay 60): "再次检查应用状态，与上次对比，如有恶化则创建告警任务"`,
+            ``,
+            `**模式4：数据库迁移**`,
+            `- 任务1: "执行数据库迁移脚本"`,
+            `- 任务2 (--delay 30): "验证数据完整性：检查行数、约束、索引"`,
+            ``,
+            `**关键原则：**`,
+            `- 需要等待验证的步骤必须用 --delay，不要立即执行`,
+            `- 每个任务描述必须完整自包含（全新会话执行）`,
+            `- 用 memory add 传递上下文，用 --parent 关联链路`,
+            `- 用 add-approval 保护破坏性操作（删除、部署、迁移）`,
+            `- 任务描述中加入"先用 memory list 读取前序任务结论"确保上下文`,
         ].join("\n");
     }
     return [
@@ -101,6 +138,7 @@ export function generateSkillDoc(ctx) {
         ``,
         `### Auto Tasks`,
         `- Queue an auto task: \`${ctl} auto add ${ctx.userId} ${ctx.platform} ${ctx.chatId} "description"\``,
+        `- Schedule a delayed auto task: \`${ctl} auto add ${ctx.userId} ${ctx.platform} ${ctx.chatId} "description" --delay <minutes>\``,
         `- List auto tasks: \`${ctl} auto list ${ctx.userId}\``,
         `- Cancel an auto task: \`${ctl} auto cancel <task_id>\``,
         ``,
@@ -146,5 +184,41 @@ export function generateSkillDoc(ctx) {
         `  2. Task #2: "Fix N+1 queries" (--parent 1)`,
         `  3. Task #3: "Add caching layer" (--parent 1)`,
         `  4. Task #4: "Run benchmarks" (--parent 1)`,
+        ``,
+        `### Scheduled Auto Tasks`,
+        `- Use --delay <minutes> to schedule delayed execution: \`${ctl} auto add ${ctx.userId} ${ctx.platform} ${ctx.chatId} "description" --delay 30\``,
+        `- The task won't execute immediately -- it enters the queue only after the delay expires`,
+        `- Use cases: tasks that need waiting, verification, or time gaps between steps`,
+        `- Can combine with --parent: \`${ctl} auto add ${ctx.userId} ${ctx.platform} ${ctx.chatId} "verify deploy" --delay 15 --parent 42\``,
+        `- Approval tasks also support delay: \`${ctl} auto add-approval ${ctx.userId} ${ctx.platform} ${ctx.chatId} "desc" --delay 60\``,
+        ``,
+        `### Autonomous Project Management Patterns`,
+        `When the user delegates full project management to you, use these patterns:`,
+        ``,
+        `**Pattern 1: Deploy & Verify**`,
+        `- Task 1: "Deploy code to staging"`,
+        `- Task 2 (--delay 15): "Check staging health: hit /health endpoint, review recent logs for errors"`,
+        `- Task 3 (--delay 30): "If staging is healthy, deploy to production. Otherwise rollback and report."`,
+        ``,
+        `**Pattern 2: Iterative Development**`,
+        `- Task 1: "Analyze project, identify all changes needed, save findings to memory"`,
+        `- Task 2 (--delay 2): "Read memory, execute first batch of changes, run tests"`,
+        `- Task 3 (--delay 5): "Check test results, fix any failures"`,
+        `- Task 4 (--delay 3): "Run full integration tests, generate report"`,
+        ``,
+        `**Pattern 3: Monitoring / Health Check**`,
+        `- Task 1: "Check application status: CPU, memory, error rates"`,
+        `- Task 2 (--delay 60): "Re-check application status, compare with previous check, create alert tasks if degraded"`,
+        ``,
+        `**Pattern 4: Database Migration**`,
+        `- Task 1: "Run database migration script"`,
+        `- Task 2 (--delay 30): "Verify data integrity: check row counts, constraints, indexes"`,
+        ``,
+        `**Key principles:**`,
+        `- Steps that need wait/verification MUST use --delay, don't execute immediately`,
+        `- Each task description must be self-contained (runs in a fresh session)`,
+        `- Use memory add to pass context, use --parent to link chains`,
+        `- Use add-approval for destructive operations (delete, deploy, migrate)`,
+        `- Include "first run memory list to review prior task conclusions" in descriptions`,
     ].join("\n");
 }

package/dist/webhook.js

@@ -60,13 +60,14 @@ export class WebhookServer {
                     return;
                 }
                 let id;
+                const scheduledAt = data.delay_minutes ? Date.now() + data.delay_minutes * 60000 : undefined;
                 if (data.approval) {
-                    id = this.store.addApprovalTask(data.user_id, data.platform, data.chat_id, data.description, data.parent_id);
+                    id = this.store.addApprovalTask(data.user_id, data.platform, data.chat_id, data.description, data.parent_id, scheduledAt);
                 }
                 else {
-                    id = this.store.addTask(data.user_id, data.platform, data.chat_id, data.description, undefined, true, data.parent_id);
+                    id = this.store.addTask(data.user_id, data.platform, data.chat_id, data.description, undefined, true, data.parent_id, scheduledAt);
                 }
-                this.json(res, 201, { ok: true, id, status: data.approval ? "approval_pending" : "auto" });
+                this.json(res, 201, { ok: true, id, status: data.approval ? "approval_pending" : "auto", scheduled_at: scheduledAt || null });
             }
             catch (e) {
                 this.json(res, 400, { error: e.message || "Invalid JSON" });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@emqo/claudebridge",
-  "version": "0.5.3",
-  "description": "Bridge claude CLI to chat platforms (Telegram, Discord) with HITL approval, conditional branching, webhook triggers, parallel execution, and observability",
+  "version": "0.6.1",
+  "description": "Bridge claude CLI to chat platforms (Telegram, Discord) with scheduled auto-tasks, autonomous project management, HITL approval, conditional branching, webhook triggers, parallel execution, and observability",
   "main": "dist/index.js",
   "bin": {
     "claudebridge": "dist/cli.js",