opencode-supertask 0.1.17 → 0.1.19

package/README.md

@@ -9,20 +9,9 @@ AI-powered task queue for [OpenCode](https://opencode.ai) agents — schedule, r
 
 ## Installation
 
-### Let an LLM do it
+### Quick Install
 
-Paste this into any LLM agent (Claude Code, OpenCode, Cursor, etc.):
-
-```
-Install the opencode-supertask plugin by following: https://raw.githubusercontent.com/vbgate/opencode-supertask/main/README.md
-```
-
-<details>
-<summary><b>Instructions for LLM agents</b></summary>
-
-To install this plugin, perform these steps:
-
-1. Add `"opencode-supertask"` to the `plugin` array in `~/.config/opencode/opencode.json`:
+Add the plugin to `~/.config/opencode/opencode.json`:
 
 ```json
 {
@@ -30,26 +19,31 @@ To install this plugin, perform these steps:
 }
 ```
 
-2. Tell the user to restart OpenCode.
+Restart OpenCode. That's it.
 
-After restart, the plugin auto-injects:
+The plugin auto-starts a Gateway process (via pm2) and injects:
 - 10 MCP tools (`supertask_add`, `supertask_next`, `supertask_start`, `supertask_done`, `supertask_fail`, `supertask_get`, `supertask_list`, `supertask_status`, `supertask_retry`, `supertask_schedule`)
 - A `supertask-runner` agent (used internally by the Gateway)
-- Usage instructions in the system prompt
+- A Web Dashboard at http://localhost:4680
 
-</details>
+### Uninstall
 
-### Manual Installation
+1. Run `supertask uninstall` to stop the Gateway and remove it from pm2
+2. Remove `"opencode-supertask"` from `~/.config/opencode/opencode.json`
+3. Restart OpenCode
 
-1. Add the plugin to your `~/.config/opencode/opencode.json`:
+To clean up all data, delete the database:
 
-```json
-{
-  "plugin": ["opencode-supertask"]
-}
+```bash
+rm ~/.local/share/opencode/tasks.db
 ```
 
-2. Restart OpenCode
+### CLI Install / Uninstall
+
+```bash
+supertask install     # Install Gateway as pm2 service (auto-start, crash recovery)
+supertask uninstall   # Stop and remove Gateway from pm2
+```
 
 ### From Source
 
@@ -70,39 +64,27 @@ Then add the local path to your config:
 
 ## Quick Start
 
-```bash
-# Install globally for CLI + Gateway
-bun install -g opencode-supertask
-
-# Initialize (create config + run migrations)
-supertask init
-
-# Start Gateway (foreground)
-supertask gateway
+After installation, the Gateway starts automatically. Use the MCP tools in OpenCode:
 
-# Start Web Dashboard
-supertask ui          # → http://localhost:3000
+```
+Create a task: "帮我生成项目的 README" with agent "explore"
 ```
 
-### Background Running
+Or open the Web Dashboard:
 
 ```bash
-# pm2 (recommended)
-pm2 start "supertask gateway" --name supertask-gateway
-
-# systemd
-cp deploy/supertask-gateway.service ~/.config/systemd/user/
-systemctl --user enable --now supertask-gateway
+supertask ui          # Opens http://localhost:4680 in browser
 ```
 
 ## CLI Reference
 
 ```bash
-supertask init                          # init config + db
-supertask migrate                       # run migrations
-supertask gateway                       # start gateway (foreground)
-supertask ui                            # start web dashboard
-supertask config                        # show current config
+# Gateway management
+supertask install                      # install Gateway as pm2 service
+supertask uninstall                    # stop and remove from pm2
+supertask gateway                      # start Gateway in foreground
+supertask ui                           # open Web Dashboard in browser
+supertask config                       # show current config
 
 # Task management
 supertask add -n "Task" -a "agent" -p "prompt" --importance 5
@@ -112,33 +94,54 @@ supertask status
 supertask cancel --id 1
 supertask retry --id 1
 
-# Scheduled templates
+# Scheduled templates (friendly duration format)
 supertask template add --name "Daily" --agent "gen" \
   --prompt "..." --type cron --cron "0 9 * * *"
+supertask template add --name "Delayed" --agent "gen" \
+  --prompt "..." --type delayed --delay "30min"
+supertask template add --name "Hourly" --agent "gen" \
+  --prompt "..." --type recurring --interval "1h"
 supertask template list
 supertask template enable --id 1
 ```
 
+### Duration Format
+
+Schedule supports friendly duration strings:
+
+| Format | Examples |
+|--------|----------|
+| Seconds | `30s`, `5sec` |
+| Minutes | `5min`, `30minutes` |
+| Hours | `1h`, `2hours` |
+| Days | `1d`, `3days` |
+| Weeks | `1w`, `2weeks` |
+| ISO 8601 | `PT30M`, `PT1H30M` |
+
 ## Architecture
 
 ```
-Gateway (supertask gateway)
-├── Worker     → claim tasks, spawn supertask-runner via opencode
+Gateway (auto-started by pm2)
+├── Worker     → claim tasks, spawn supertask-runner via opencode run
 ├── Scheduler  → clone tasks from templates (cron / delayed / recurring)
-└── Watchdog   → heartbeat timeout, auto-retry, data cleanup
+├── Watchdog   → heartbeat timeout, auto-retry, data cleanup
+└── Dashboard  → Web UI on port 4680 (Hono SSR)
 ```
 
 Config file: `~/.config/opencode/supertask.json`
 
 ```json
 {
-  "worker": { "maxConcurrency": 2, "defaultModel": "zhipuai-coding-plan/glm-4.7" },
+  "worker": { "maxConcurrency": 2 },
   "scheduler": { "enabled": true, "catchUp": "next" },
-  "watchdog": { "heartbeatTimeoutMs": 600000, "retentionDays": 30 }
+  "watchdog": { "heartbeatTimeoutMs": 600000, "retentionDays": 30 },
+  "dashboard": { "enabled": true, "port": 4680 }
 }
 ```
 
 Key mechanisms:
+- **Auto-start** — Plugin auto-installs pm2 and starts Gateway on first use
+- **Auto-upgrade** — Plugin detects version changes and auto-reloads Gateway
 - **Process lock** — SQLite `BEGIN IMMEDIATE` ensures single instance
 - **Heartbeat** — Worker updates every 30s; Watchdog kills stale processes
 - **Exponential backoff** — 30s × 2^n, capped at 30min
@@ -148,14 +151,14 @@ Key mechanisms:
 
 ## Web Dashboard
 
-`supertask ui` starts a dashboard at http://localhost:3000 with 4 pages:
+http://localhost:4680 — 4 pages:
 
 | Page | Features |
 |------|----------|
 | Task Queue | Filter by status, retry, delete |
 | Scheduled Tasks | Template CRUD, enable/disable, manual trigger |
-| Execution Logs | task_runs history, log viewer |
-| System Status | Config editor, concurrency monitor, stats |
+| Execution Logs | task_runs history with session tracking |
+| System Status | Config editor, concurrency monitor, clear database |
 
 ## Data
 
@@ -181,16 +184,6 @@ SuperTask 是一个基于 SQLite 的 AI Agent 任务调度系统，专为 [OpenC
 
 ### 安装
 
-#### 让 AI 帮你装
-
-把这段话粘贴到任意 LLM agent（Claude Code、OpenCode、Cursor 等）：
-
-```
-安装 opencode-supertask 插件，参照：https://raw.githubusercontent.com/vbgate/opencode-supertask/main/README.md
-```
-
-#### 手动安装
-
 在 `~/.config/opencode/opencode.json` 中添加：
 
 ```json
@@ -199,24 +192,42 @@ SuperTask 是一个基于 SQLite 的 AI Agent 任务调度系统，专为 [OpenC
 }
 ```
 
-重启 OpenCode 即可。插件会自动注入 10 个 MCP 工具、supertask-runner Agent 和使用说明。
+重启 OpenCode 即可。插件会自动：
+- 安装 pm2 并启动 Gateway 常驻进程
+- 注入 10 个 MCP 工具和 supertask-runner Agent
+- 启动 Web 控制台（http://localhost:4680）
+
+### 卸载
+
+1. 运行 `supertask uninstall` 停止 Gateway
+2. 从 `~/.config/opencode/opencode.json` 中移除 `"opencode-supertask"`
+3. 重启 OpenCode
 
-### 快速开始
+清理所有数据：`rm ~/.local/share/opencode/tasks.db`
+
+### 定时任务
+
+支持友好的时间格式：
 
 ```bash
-bun install -g opencode-supertask
-supertask init        # 初始化
-supertask gateway     # 启动 Gateway
-supertask ui          # Web 控制台
+# 30秒后执行
+supertask template add --type delayed --delay "30s" ...
+
+# 每5分钟循环
+supertask template add --type recurring --interval "5min" ...
+
+# 每天上午9点（cron）
+supertask template add --type cron --cron "0 9 * * *" ...
 ```
 
 ### 核心功能
 
 - **任务队列** — 优先级调度、批次隔离、依赖管理
-- **Gateway 常驻进程** — Worker + Scheduler + Watchdog，自动重试 + 指数退避
-- **定时任务** — 支持 cron / delayed / recurring 三种调度类型
-- **Web 控制台** — 任务监控、执行日志、在线配置
-- **CLI 工具** — 完整的命令行管理
+- **自动启动** — 插件首次加载时自动安装 pm2 并启动 Gateway
+- **自动升级** — 插件更新后自动检测版本变化并 reload Gateway
+- **定时任务** — cron / delayed / recurring，支持友好时间格式
+- **Web 控制台** — 任务监控、执行日志、在线配置、清空数据库
+- **Session 追踪** — 自动从 opencode run 输出中捕获 session ID
 
 ### 数据位置
 

package/dist/cli/index.js

@@ -9400,7 +9400,7 @@ import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 function getMigrationsFolder() {
   const __dirname2 = dirname(fileURLToPath(import.meta.url));
-  return join(__dirname2, "../../drizzle");
+  return join(__dirname2, "../../../drizzle");
 }
 function initDb() {
   const dataDir = dirname(DB_FILE_PATH);
@@ -9424,7 +9424,9 @@ function initDb() {
     try {
       migrate(_db, { migrationsFolder: getMigrationsFolder() });
     } catch (err) {
-      console.error("[supertask] migration failed:", err instanceof Error ? err.message : String(err));
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`[supertask] migration failed: ${msg}`);
+      throw new Error(`[supertask] DB migration failed: ${msg}`);
     }
   }
   return _db;
@@ -9444,14 +9446,15 @@ function closeDb() {
     _db = null;
   }
 }
-var DB_FILE_PATH, _sqlite, _db, _migrationRan, db, sqlite;
+var DEFAULT_DB_PATH, DB_FILE_PATH, _sqlite, _db, _migrationRan, db, sqlite;
 var init_db2 = __esm({
   "src/core/db/index.ts"() {
     "use strict";
     init_bun_sqlite();
     init_migrator2();
     init_schema();
-    DB_FILE_PATH = join(homedir(), ".local/share/opencode/tasks.db");
+    DEFAULT_DB_PATH = join(homedir(), ".local/share/opencode/tasks.db");
+    DB_FILE_PATH = process.env.SUPERTASK_DB_PATH || DEFAULT_DB_PATH;
     _sqlite = null;
     _db = null;
     _migrationRan = false;
@@ -19306,10 +19309,13 @@ var init_worker = __esm({
               status: "running"
             });
             const modelToUse = this.resolveModel(task.model);
-            const modelArg = modelToUse ? ` -m "${modelToUse}"` : "";
-            const cmd = `opencode run --agent supertask-runner${modelArg} --format json "\u6267\u884C\u4EFB\u52A1 ID: ${task.id}${modelToUse ? ` OVERRIDE_MODEL=${modelToUse}` : ""}"`;
+            const args = ["run", "--agent", "supertask-runner", "--format", "json"];
+            if (modelToUse) {
+              args.push("-m", modelToUse);
+            }
+            args.push(`\u6267\u884C\u4EFB\u52A1 ID: ${task.id}${modelToUse ? ` OVERRIDE_MODEL=${modelToUse}` : ""}`);
             const cwd = task.cwd || process.cwd();
-            const child = spawn("sh", ["-c", cmd], { cwd, stdio: ["ignore", "pipe", "pipe"] });
+            const child = spawn("opencode", args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
             await TaskRunService.updatePid(run.id, process.pid, child.pid ?? 0);
             let output = "";
             const handleData = (data) => {
@@ -22102,6 +22108,10 @@ function formatDate(ts) {
   const d = ts instanceof Date ? ts : new Date(ts);
   return d.toLocaleString("zh-CN", { month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" });
 }
+function esc(s) {
+  if (!s) return "";
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
 function readCurrentConfig() {
   if (!existsSync3(CONFIG_PATH)) return {};
   try {
@@ -22122,6 +22132,7 @@ async function retryTask(id){if(!confirm('\u786E\u5B9A\u91CD\u8BD5\u4EFB\u52A1 #
 async function deleteTask(id){if(!confirm('\u786E\u5B9A\u5220\u9664\u4EFB\u52A1 #'+id+'?'))return;await fetch('/api/tasks/'+id,{method:'DELETE'});location.reload();}
 async function showDetail(id){try{const r=await fetch('/api/tasks/'+id);const t=await r.json();document.getElementById('dc').textContent=JSON.stringify(t,null,2);document.getElementById('dd').showModal();}catch(e){alert('\u83B7\u53D6\u8BE6\u60C5\u5931\u8D25');}}
 async function showRunDetail(id){try{const r=await fetch('/api/runs/'+id);const t=await r.json();document.getElementById('dc').textContent=JSON.stringify(t,null,2);document.getElementById('dd').showModal();}catch(e){alert('\u83B7\u53D6\u8BE6\u60C5\u5931\u8D25');}}
+async function showTemplateDetail(id){try{const r=await fetch('/api/templates/'+id);const t=await r.json();document.getElementById('dc').textContent=JSON.stringify(t,null,2);document.getElementById('dd').showModal();}catch(e){alert('\u83B7\u53D6\u8BE6\u60C5\u5931\u8D25');}}
 async function enableTmpl(id){await fetch('/api/templates/'+id+'/enable',{method:'POST'});location.reload();}
 async function disableTmpl(id){if(!confirm('\u786E\u5B9A\u7981\u7528\u6B64\u6A21\u677F?'))return;await fetch('/api/templates/'+id+'/disable',{method:'POST'});location.reload();}
 async function deleteTmpl(id){if(!confirm('\u786E\u5B9A\u5220\u9664\u6B64\u6A21\u677F? \u6B64\u64CD\u4F5C\u4E0D\u53EF\u6062\u590D!'))return;await fetch('/api/templates/'+id,{method:'DELETE'});location.reload();}
@@ -22306,8 +22317,8 @@ var init_web = __esm({
         const st = (task.status ?? "").toUpperCase();
         rows += `<tr>
           <td class="mu">#${task.id}</td>
-          <td><div style="font-weight:500">${task.name}</div><div class="mu sm el">${task.prompt.substring(0, 120)}</div></td>
-          <td><span class="tag">${task.agent}</span></td>
+          <td><div style="font-weight:500">${esc(task.name)}</div><div class="mu sm el">${esc(task.prompt.substring(0, 120))}</div></td>
+          <td><span class="tag">${esc(task.agent)}</span></td>
           <td><span class="badge b-${task.status}">${st}</span></td>
           <td class="sm ${task.status === "running" ? "" : "mu"}">${formatDuration(task.startedAt, task.finishedAt)}</td>
           <td class="mu sm">${(task.retryCount ?? 0) > 0 ? task.retryCount : "-"}</td>
@@ -22363,15 +22374,15 @@ var init_web = __esm({
         const toggleBtn = t.enabled ? `<button class="btn btn-sm btn-warn" onclick="disableTmpl(${t.id})">\u7981\u7528</button>` : `<button class="btn btn-sm" onclick="enableTmpl(${t.id})">\u542F\u7528</button>`;
         rows += `<tr>
           <td class="mu">#${t.id}</td>
-          <td><div style="font-weight:500">${t.name}</div><div class="mu sm el">${t.prompt.substring(0, 100)}</div>
-            <div class="sm" style="margin-top:2px"><span class="tag">${t.agent}</span>${t.model && t.model !== "default" ? ` <span class="tag">${t.model}</span>` : ""}</div></td>
+          <td><div style="font-weight:500">${esc(t.name)}</div><div class="mu sm el">${esc(t.prompt.substring(0, 100))}</div>
+            <div class="sm" style="margin-top:2px"><span class="tag">${esc(t.agent)}</span>${t.model && t.model !== "default" ? ` <span class="tag">${esc(t.model)}</span>` : ""}</div></td>
           <td><span class="${typeClass}">${typeLabel}</span></td>
           <td class="m sm">${rule}</td>
           <td>${statusBadge}</td>
           <td class="sm">${t.lastRunAt ? timeAgo(t.lastRunAt) : "-"}</td>
           <td class="sm">${t.nextRunAt ? timeUntil(t.nextRunAt) : "-"}</td>
           <td>
-            <button class="btn btn-sm" onclick="showDetail(${t.id})">\u8BE6\u60C5</button>
+            <button class="btn btn-sm" onclick="showTemplateDetail(${t.id})">\u8BE6\u60C5</button>
             <button class="btn btn-sm btn-primary" onclick="triggerTmpl(${t.id})">\u89E6\u53D1</button>
             ${toggleBtn}
             <button class="btn btn-sm btn-danger" onclick="deleteTmpl(${t.id})">\u5220\u9664</button>
@@ -22423,9 +22434,9 @@ var init_web = __esm({
         const logBtn = run.log ? `<button class="btn btn-sm" onclick="toggleLog(${run.id})">\u65E5\u5FD7</button>` : "";
         rows += `<tr>
           <td class="mu">#${run.id}</td>
-          <td><div style="font-weight:500">${run.taskName} <span class="mu">(#${run.taskId})</span></div>
-            ${run.model ? `<div class="sm"><span class="tag">${run.model}</span></div>` : ""}</td>
-          <td><span class="tag">${run.taskAgent}</span></td>
+          <td><div style="font-weight:500">${esc(run.taskName)} <span class="mu">(#${run.taskId})</span></div>
+            ${run.model ? `<div class="sm"><span class="tag">${esc(run.model)}</span></div>` : ""}</td>
+          <td><span class="tag">${esc(run.taskAgent)}</span></td>
           <td><span class="badge b-${run.status}">${(run.status ?? "").toUpperCase()}</span></td>
           <td class="sm">${formatDuration(run.startedAt, run.finishedAt)}</td>
           <td class="sm mu">${run.heartbeatAt ? timeAgo(run.heartbeatAt) : "-"}</td>
@@ -22471,7 +22482,7 @@ var init_web = __esm({
           runRows += `<tr>
               <td class="mu">#${run.id}</td><td>#${run.taskId}</td>
               <td class="m sm">${shortS}</td>
-              <td class="sm">${run.model || "-"}</td>
+              <td class="sm">${esc(run.model) || "-"}</td>
               <td class="sm">${formatDate(run.startedAt)}</td>
               <td class="sm">${run.heartbeatAt ? timeAgo(run.heartbeatAt) : "-"}</td>
               <td class="m sm">W:${run.workerPid ?? "-"} C:${run.childPid ?? "-"}</td>
@@ -22560,6 +22571,12 @@ var init_web = __esm({
       if (!run) return c.json({ error: "not found" }, 404);
       return c.json(run);
     });
+    app.get("/api/templates/:id", async (c) => {
+      const id = Number(c.req.param("id"));
+      const tmpl = await TaskTemplateService.getById(id);
+      if (!tmpl) return c.json({ error: "not found" }, 404);
+      return c.json(tmpl);
+    });
     app.post("/api/tasks/:id/retry", async (c) => {
       await TaskService.retry(Number(c.req.param("id")));
       return c.json({ success: true });
@@ -22709,7 +22726,16 @@ async function main() {
   await scheduler.start();
   if (cfg.dashboard.enabled) {
     const { dashboardApp: dashboardApp2 } = await Promise.resolve().then(() => (init_web(), web_exports));
-    Bun.serve({ port: cfg.dashboard.port, fetch: dashboardApp2.fetch });
+    Bun.serve({
+      port: cfg.dashboard.port,
+      fetch(req) {
+        const url = new URL(req.url);
+        if (url.hostname !== "localhost" && url.hostname !== "127.0.0.1" && url.hostname !== "::1") {
+          return new Response("Forbidden", { status: 403 });
+        }
+        return dashboardApp2.fetch(req);
+      }
+    });
     console.log(JSON.stringify({
       ts: (/* @__PURE__ */ new Date()).toISOString(),
       level: "info",
@@ -22751,9 +22777,11 @@ async function main() {
   process.on("SIGINT", () => shutdown("SIGINT"));
   process.on("uncaughtException", (err) => {
     console.error(JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), level: "fatal", msg: "uncaughtException", error: err.message, stack: err.stack }));
+    process.exit(1);
   });
   process.on("unhandledRejection", (reason) => {
     console.error(JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), level: "fatal", msg: "unhandledRejection", reason: String(reason) }));
+    process.exit(1);
   });
 }
 var STALE_THRESHOLD_MS;
@@ -23279,7 +23307,7 @@ program2.command("init").description("Initialize SuperTask (create config + run
     const dir = dirname4(CONFIG_PATH2);
     if (!existsSync5(dir)) mkdirSync3(dir, { recursive: true });
     writeFileSync3(CONFIG_PATH2, JSON.stringify({
-      worker: { maxConcurrency: 2, defaultModel: "zhipuai-coding-plan/glm-4.7" },
+      worker: { maxConcurrency: 2 },
       scheduler: { enabled: true }
     }, null, 2) + "\n");
     console.log(JSON.stringify({ created: CONFIG_PATH2 }));
@@ -23342,13 +23370,31 @@ program2.command("uninstall").description("Stop and remove Gateway pm2 service")
     process.exit(1);
   }
 });
-program2.command("upgrade").description("Restart Gateway with current plugin version").action(async () => {
+program2.command("upgrade").description("Update npm package and restart Gateway").action(async () => {
+  const { execSync: execSync2 } = await import("child_process");
+  const { homedir: homedir4 } = await import("os");
+  const { join: join4 } = await import("path");
+  const configDir = join4(homedir4(), ".config/opencode");
+  console.log("Updating opencode-supertask...");
+  try {
+    execSync2("npm install opencode-supertask@latest", {
+      cwd: configDir,
+      stdio: "inherit",
+      timeout: 6e4
+    });
+  } catch (err) {
+    console.error("npm install failed:", err instanceof Error ? err.message : String(err));
+    console.error("Try manually: cd ~/.config/opencode && npm install opencode-supertask@latest");
+    process.exit(1);
+  }
   try {
     const { upgrade: pm2Upgrade } = await Promise.resolve().then(() => (init_pm2(), pm2_exports));
     const result = pm2Upgrade();
-    console.log(JSON.stringify({ before: result.before, after: result.after, restarted: result.restarted }));
+    console.log(`
+SuperTask upgraded: ${result.before ?? "unknown"} \u2192 ${result.after}`);
+    console.log("Gateway restarted. Please restart opencode to load the new plugin.");
   } catch (err) {
-    console.error(err instanceof Error ? err.message : String(err));
+    console.error("Gateway restart failed:", err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
 });