autosnippet 3.2.6 → 3.2.7

package/README.md

@@ -45,7 +45,7 @@ That's it. After you approve some candidates, they become **Recipes** — struct
 
 ```
 ┌────────────┐    ┌────────────┐    ┌────────────┐    ┌────────────┐    ┌────────────┐
-│  ① Setup   │──→ │ ② Cold    │──→ │ ③ Target  │──→ │ ④ Revie    │──→ │ ⑤ IDE      │
+│  ① Setup   │──→ │ ② Cold    │──→ │ ③ Target  │──→ │ ④ Review   │──→ │ ⑤ IDE      │
 │  asd setup │    │   Start    │    │   Scan     │    │  Dashboard │    │  Delivery  │
 └────────────┘    └────────────┘    └────────────┘    └────────────┘    └─────┬──────┘
                                                                               │
@@ -115,6 +115,7 @@ Access via CLI `asd task`, MCP tool `autosnippet_task`, or `#asd` in VS Code Age
 | **Claude Code** | MCP + CLAUDE.md | `CLAUDE.md` + MCP tools; supports hooks |
 | **Trae / Qoder** | MCP | Auto-generated by `asd setup` |
 | **Xcode** | File watcher | `asd watch` + file directives + snippet sync |
+| **Lark (Feishu)** | Bot + WebSocket | Send commands from phone → IDE executes via Copilot Agent Mode |
 
 All configs generated by `asd setup`. Run `asd upgrade` to refresh after updates.
 
@@ -167,6 +168,20 @@ your-project/
 
 Recipes are Markdown files. SQLite is a read cache. If the DB breaks, `asd sync` rebuilds it.
 
+## Remote Programming via Lark
+
+Code from your phone. Send messages in Lark (Feishu) → they get injected into VS Code Copilot Agent Mode → results sent back to Lark. Task notifications with IDE screenshots are pushed back automatically.
+
+```
+Phone (Lark)  →  Feishu Cloud (WSS)  →  Local API Server  →  VS Code  →  Copilot Agent Mode
+     ↑                                                                         |
+     └─────────────────────── Result notification + Screenshot ────────────────┘
+```
+
+System commands: `/help` `/status` `/queue` `/cancel` `/clear` `/ping` `/screen`
+
+See [Lark Integration Guide](docs/lark-integration.en.md) for setup instructions.
+
 ## Configuration
 
 Put a `.env` in your project root, or use Dashboard → LLM Config:

package/lib/external/mcp/handlers/task.js

@@ -19,27 +19,35 @@ import { envelope } from '../envelope.js';
 export async function taskHandler(ctx, args) {
   const taskService = ctx.container.get('taskGraphService');
 
+  let result;
   switch (args.operation) {
     // ── Session ──
     case 'prime':
       return _prime(taskService, args);
     // ── Task CRUD ──
     case 'create':
-      return _create(taskService, args);
+      result = await _create(taskService, args);
+      break;
     case 'ready':
       return _ready(taskService, args);
     case 'claim':
-      return _claim(taskService, args);
+      result = await _claim(taskService, args);
+      break;
     case 'close':
-      return _close(ctx, taskService, args);
+      result = await _close(ctx, taskService, args);
+      break;
     case 'fail':
-      return _fail(taskService, args);
+      result = await _fail(taskService, args);
+      break;
     case 'defer':
-      return _defer(taskService, args);
+      result = await _defer(taskService, args);
+      break;
     case 'progress':
-      return _progress(taskService, args);
+      result = await _progress(taskService, args);
+      break;
     case 'decompose':
-      return _decompose(taskService, args);
+      result = await _decompose(taskService, args);
+      break;
     case 'show':
       return _show(taskService, args);
     case 'list':
@@ -54,11 +62,14 @@ export async function taskHandler(ctx, args) {
       return _stats(taskService);
     // ── Decisions ──
     case 'record_decision':
-      return _recordDecision(taskService, args);
+      result = await _recordDecision(taskService, args);
+      break;
     case 'revise_decision':
-      return _reviseDecision(taskService, args);
+      result = await _reviseDecision(taskService, args);
+      break;
     case 'unpin_decision':
-      return _unpinDecision(taskService, args);
+      result = await _unpinDecision(taskService, args);
+      break;
     case 'list_decisions':
       return _listDecisions(taskService);
     default:
@@ -68,6 +79,13 @@ export async function taskHandler(ctx, args) {
         meta: { tool: 'autosnippet_task' },
       });
   }
+
+  // ── 飞书任务进度通知（异步非阻塞）──
+  _notifyTaskProgress(args.operation, args, result).catch((err) => {
+    process.stderr.write(`[MCP/Task] Notify error: ${err?.message}\n`);
+  });
+
+  return result;
 }
 
 // ── create ──
@@ -455,3 +473,157 @@ async function _listDecisions(svc) {
     meta: { tool: 'autosnippet_task' },
   });
 }
+
+// ═══ 飞书任务进度通知（通过 API Server 中转）═══════════════
+//
+// MCP Server 与 API Server 是独立进程。
+// 飞书 WSClient 连接在 API Server 中，因此通知需 HTTP 中转。
+// ═══════════════════════════════════════════════════════════
+
+const PRIORITY_LABELS = ['P0 紧急', 'P1 高', 'P2 中', 'P3 低', 'P4 微'];
+
+/**
+ * 通过 API Server 的 /api/v1/remote/notify 发送飞书通知
+ * @param {string} text
+ * @returns {Promise<boolean>}
+ */
+async function _sendLarkViaApi(text) {
+  try {
+    const port = process.env.PORT || 3000;
+    const resp = await fetch(`http://localhost:${port}/api/v1/remote/notify`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ text }),
+      signal: AbortSignal.timeout(5000),
+    });
+    if (!resp.ok) {
+      process.stderr.write(`[MCP/Task] Lark notify HTTP ${resp.status}\n`);
+      return false;
+    }
+    const body = await resp.json();
+    return body.success === true;
+  } catch (err) {
+    process.stderr.write(`[MCP/Task] Lark notify failed: ${err?.message}\n`);
+    return false;
+  }
+}
+
+/**
+ * 通过 API Server 截取 IDE 窗口截图并发送到飞书
+ * @param {string} [caption] — 可选文字说明
+ * @returns {Promise<boolean>}
+ */
+async function _sendScreenshotViaApi(caption = '') {
+  try {
+    const port = process.env.PORT || 3000;
+    const resp = await fetch(`http://localhost:${port}/api/v1/remote/screenshot`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ caption }),
+      signal: AbortSignal.timeout(15000),
+    });
+    if (!resp.ok) {
+      process.stderr.write(`[MCP/Task] Screenshot HTTP ${resp.status}\n`);
+      return false;
+    }
+    const body = await resp.json();
+    return body.success === true;
+  } catch (err) {
+    process.stderr.write(`[MCP/Task] Screenshot failed: ${err?.message}\n`);
+    return false;
+  }
+}
+
+/**
+ * 根据任务操作向飞书发送进度通知（异步非阻塞）
+ * result 是 envelope() 返回的 { success, data, message, meta }
+ */
+async function _notifyTaskProgress(operation, args, result) {
+  if (!result || result.success === false) return;
+
+  const data = result.data;
+  let text = '';
+
+  switch (operation) {
+    case 'create': {
+      const title = data?.title || args.title || '';
+      const id = data?.id || '';
+      const type = data?.taskType || args.taskType || 'task';
+      const pri = PRIORITY_LABELS[data?.priority ?? args.priority ?? 2] || 'P2';
+      const dup = result.message?.includes('Duplicate') || result.message?.startsWith('⚠') ? ' (重复)' : '';
+      text = `📋 新任务${dup}: ${id}\n${title}\n类型: ${type} | ${pri}`;
+      break;
+    }
+    case 'claim': {
+      const id = data?.id || args.id;
+      const title = data?.title || '';
+      text = `🔨 开始执行: ${id}\n${title}`;
+      break;
+    }
+    case 'close': {
+      const closed = data?.closed || data;
+      const title = closed?.title || '';
+      const id = closed?.id || args.id;
+      const reason = closed?.closeReason || args.reason || '';
+      const readyCount = data?.newlyReady?.length || 0;
+      const readyInfo = readyCount > 0 ? `\n→ ${readyCount} 个任务新就绪` : '';
+      text = `✅ 完成: ${id}\n${title}\n原因: ${reason}${readyInfo}`;
+      break;
+    }
+    case 'fail': {
+      const title = data?.title || '';
+      const id = data?.id || args.id;
+      const reason = data?.lastFailReason || args.reason || '未知';
+      const count = data?.failCount || 0;
+      text = `❌ 失败: ${id}\n${title}\n原因: ${reason}${count > 1 ? ` (第${count}次)` : ''}`;
+      break;
+    }
+    case 'defer': {
+      const id = data?.id || args.id;
+      const title = data?.title || '';
+      text = `⏸️ 暂缓: ${id} — ${title}`;
+      break;
+    }
+    case 'progress': {
+      const id = data?.id || args.id;
+      const note = args.reason || args.description || '';
+      text = note
+        ? `📝 进度: ${id}\n${note.slice(0, 200)}`
+        : `📝 进度: ${id}`;
+      break;
+    }
+    case 'decompose': {
+      const epicId = args.id;
+      const count = Array.isArray(data) ? data.length : 0;
+      const subTitles = Array.isArray(data)
+        ? data.slice(0, 5).map((t, i) => `  ${i + 1}. ${t.title || t.id}`).join('\n')
+        : '';
+      text = `📂 拆解: ${epicId} → ${count} 个子任务${subTitles ? '\n' + subTitles : ''}`;
+      break;
+    }
+    case 'record_decision': {
+      const title = data?.title || args.title || '';
+      text = `📌 决策: ${title}`;
+      break;
+    }
+    case 'revise_decision': {
+      const oldId = data?.superseded || args.id;
+      const newTitle = data?.newDecision?.title || args.title;
+      text = `🔄 决策更新: ${oldId} → ${newTitle}`;
+      break;
+    }
+    case 'unpin_decision': {
+      const id = data?.id || args.id;
+      text = `🔓 决策取消: ${id}`;
+      break;
+    }
+    default:
+      return;
+  }
+
+  if (text) {
+    await _sendLarkViaApi(text);
+    // 发送文字通知后，附带 IDE 窗口截图
+    await _sendScreenshotViaApi();
+  }
+}

package/lib/http/HttpServer.js

@@ -38,6 +38,7 @@ import skillsRouter from './routes/skills.js';
 import snippetRouter from './routes/snippets.js';
 import spmRouter from './routes/spm.js';
 import taskRouter from './routes/task.js';
+import remoteRouter from './routes/remote.js';
 import violationsRouter from './routes/violations.js';
 import wikiRouter from './routes/wiki.js';
 
@@ -302,6 +303,9 @@ export class HttpServer {
     // Wiki 路由
     this.app.use(`${apiPrefix}/wiki`, wikiRouter);
 
+    // Remote 路由（飞书 Bot → IDE 远程指令桥接）
+    this.app.use(`${apiPrefix}/remote`, remoteRouter);
+
     // 根路径 — 返回 API 元信息（避免外部探测产生无意义 404）
     this.app.all('/', (req, res) => {
       res.json({