feishu-user-plugin 1.3.5 → 1.3.7

package/scripts/test-all-tools.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+// scripts/test-all-tools.js — semi-automated tool regression.
+//
+// Spawns the MCP server (src/index.js) as a stdio child, sends `initialize` +
+// `tools/list`, then calls a curated set of READ tools to verify each domain
+// is wired up. Writes a per-tool pass/fail summary to stdout.
+//
+// Read-only by design: this script does NOT create / modify / delete any
+// Feishu resources. For write-tool regression, see docs/TESTING-METHODOLOGY.md
+// "Live regression checklist".
+//
+// Usage:
+//   node scripts/test-all-tools.js
+//   node scripts/test-all-tools.js --user-id <open_id>   # to also test list_user_okrs
+//   node scripts/test-all-tools.js --json                # machine-readable output
+//
+// Exit code: 0 if all calls succeed, 1 if any failed.
+
+const { spawn } = require('child_process');
+const path = require('path');
+const { readCredentials } = require('../src/config');
+
+const SERVER_PATH = path.join(__dirname, '..', 'src', 'index.js');
+
+function jsonrpc(id, method, params) {
+  return JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n';
+}
+
+function waitFor(fn, timeoutMs) {
+  return new Promise((resolve, reject) => {
+    const start = Date.now();
+    const tick = () => {
+      if (fn()) return resolve();
+      if (Date.now() - start > timeoutMs) return reject(new Error(`timeout after ${timeoutMs}ms`));
+      setTimeout(tick, 50);
+    };
+    tick();
+  });
+}
+
+async function runRegression() {
+  const cliArgs = process.argv.slice(2);
+  const wantJson = cliArgs.includes('--json');
+  const userIdIdx = cliArgs.indexOf('--user-id');
+  const userId = userIdIdx >= 0 ? cliArgs[userIdIdx + 1] : null;
+
+  const creds = readCredentials() || {};
+  const childEnv = { ...process.env };
+  for (const k of ['LARK_COOKIE', 'LARK_APP_ID', 'LARK_APP_SECRET', 'LARK_USER_ACCESS_TOKEN', 'LARK_USER_REFRESH_TOKEN', 'LARK_PROFILES_JSON']) {
+    if (creds[k] && !childEnv[k]) childEnv[k] = creds[k];
+  }
+
+  const child = spawn('node', [SERVER_PATH], {
+    stdio: ['pipe', 'pipe', 'pipe'],
+    env: childEnv,
+  });
+  let buf = '';
+  const responses = new Map();
+  child.stdout.on('data', (d) => {
+    buf += d.toString();
+    const lines = buf.split('\n');
+    buf = lines.pop();
+    for (const line of lines) {
+      if (!line.trim()) continue;
+      try {
+        const msg = JSON.parse(line);
+        if (msg.id != null) responses.set(msg.id, msg);
+      } catch {}
+    }
+  });
+  child.stderr.on('data', () => {});
+
+  let nextId = 1;
+  function call(method, params, timeoutMs = 15000) {
+    const id = nextId++;
+    child.stdin.write(jsonrpc(id, method, params));
+    return waitFor(() => responses.has(id), timeoutMs).then(() => responses.get(id));
+  }
+
+  const init = await call('initialize', {
+    protocolVersion: '2024-11-05',
+    capabilities: {},
+    clientInfo: { name: 'test-all-tools', version: '0' },
+  });
+  if (init.error) throw new Error(`initialize failed: ${JSON.stringify(init.error)}`);
+
+  const toolsResp = await call('tools/list', {});
+  const allTools = (toolsResp.result?.tools || []).map((t) => t.name).sort();
+
+  // Curated read-only suite. Each entry: [name, args, optional notes].
+  const SUITE = [
+    ['get_login_status', {}],
+    ['list_profiles', {}],
+    ['list_chats', { page_size: 5 }],
+    ['search_contacts', { query: 'feishu' }],
+    ['list_calendars', { page_size: 50 }],
+    ['list_okr_periods', {}],
+    ['list_wiki_spaces', {}],
+    ['search_docs', { query: 'README' }],
+    ['list_files', {}],
+  ];
+  if (userId) SUITE.push(['list_user_okrs', { user_id: userId, limit: 1 }]);
+  // list_tasks (v1.3.7) is safe but only meaningful if Tasks scope is granted.
+  if (allTools.includes('list_tasks')) SUITE.push(['list_tasks', { page_size: 1 }]);
+
+  const results = [];
+  for (const [name, args] of SUITE) {
+    if (!allTools.includes(name)) {
+      results.push({ tool: name, ok: false, skipped: true, reason: 'tool not registered' });
+      continue;
+    }
+    const t0 = Date.now();
+    try {
+      const r = await call('tools/call', { name, arguments: args }, 30000);
+      const ms = Date.now() - t0;
+      if (r.error) {
+        results.push({ tool: name, ok: false, ms, error: r.error.message });
+      } else {
+        const isError = r.result?.isError === true;
+        results.push({ tool: name, ok: !isError, ms, summary: summarize(r.result) });
+      }
+    } catch (e) {
+      results.push({ tool: name, ok: false, ms: Date.now() - t0, error: e.message });
+    }
+  }
+
+  child.kill('SIGTERM');
+
+  if (wantJson) {
+    process.stdout.write(JSON.stringify({ allTools: allTools.length, results }, null, 2) + '\n');
+  } else {
+    const okCount = results.filter((r) => r.ok).length;
+    const failCount = results.filter((r) => !r.ok && !r.skipped).length;
+    const skipCount = results.filter((r) => r.skipped).length;
+    console.log(`Tool registry size: ${allTools.length}`);
+    console.log(`Suite: ${okCount} ok, ${failCount} fail, ${skipCount} skipped (out of ${results.length} planned)\n`);
+    for (const r of results) {
+      const status = r.skipped ? 'SKIP' : (r.ok ? ' OK ' : 'FAIL');
+      const ms = r.ms !== undefined ? ` ${r.ms}ms` : '';
+      const tail = r.error ? ` — ${r.error}` : (r.reason ? ` — ${r.reason}` : (r.summary ? ` — ${r.summary}` : ''));
+      console.log(`  [${status}]${ms.padStart(8)} ${r.tool}${tail}`);
+    }
+    if (failCount > 0) process.exit(1);
+  }
+}
+
+function summarize(result) {
+  const txt = result?.content?.[0]?.text;
+  if (!txt) return '';
+  // Crop multi-line summaries to the first line + length.
+  const firstLine = txt.split('\n', 1)[0];
+  return firstLine.length > 80 ? firstLine.slice(0, 77) + '…' : firstLine;
+}
+
+runRegression().catch((e) => {
+  console.error('Regression failed:', e.message);
+  process.exit(2);
+});

package/skills/feishu-user-plugin/SKILL.md

@@ -1,15 +1,15 @@
 ---
 name: feishu-user-plugin
-version: "1.3.5"
-description: "All-in-one Feishu plugin — send messages as yourself, read group/P2P chats (auto-expands merge_forward), manage docs/tables/wiki (with wiki-node + URL transparent resolution), OKR, calendar, docx image read/write. v1.3.5: cross-process UAT refresh lock, fallback warning, download_file for chat attachments."
-allowed-tools: send_to_user, send_to_group, send_as_user, send_image_as_user, send_file_as_user, send_post_as_user, send_sticker_as_user, send_audio_as_user, search_contacts, create_p2p_chat, get_chat_info, get_user_info, get_login_status, read_p2p_messages, list_user_chats, list_chats, read_messages, reply_message, forward_message, search_docs, read_doc, create_doc, list_bitable_tables, list_bitable_fields, search_bitable_records, create_bitable_record, update_bitable_record, list_wiki_spaces, search_wiki, list_wiki_nodes, get_wiki_node, list_files, create_folder, find_user, download_image, download_file, list_user_okrs, get_okrs, list_okr_periods, list_calendars, list_calendar_events, get_calendar_event
+version: "1.3.7"
+description: "All-in-one Feishu plugin — send messages as yourself (incl. batch_send), read group/P2P chats (auto-expands merge_forward), manage docs/tables/wiki (full CRUD)/drive, OKR (with progress writes), calendar (read+write), Tasks v2, multi-profile. v1.3.7: tool consolidation (82→80), wiki write, OKR progress writes, calendar write, Tasks v2, oc_xxx auto-resolver for cookie sends."
+allowed-tools: send_to_user, send_to_group, send_as_user, send_image_as_user, send_file_as_user, send_post_as_user, batch_send, send_card_as_user, search_contacts, create_p2p_chat, get_chat_info, get_user_info, get_login_status, list_profiles, switch_profile, read_p2p_messages, list_user_chats, list_chats, read_messages, send_message_as_bot, reply_message, forward_message, delete_message, update_message, add_reaction, delete_reaction, pin_message, create_group, update_group, list_members, manage_members, search_docs, read_doc, get_doc_blocks, create_doc, manage_doc_block, manage_bitable_app, manage_bitable_table, manage_bitable_field, manage_bitable_view, manage_bitable_record, upload_bitable_attachment, list_wiki_spaces, search_wiki, list_wiki_nodes, get_wiki_node, create_wiki_node, update_wiki_node, move_wiki_node, copy_wiki_node, delete_wiki_node, list_files, create_folder, upload_drive_file, manage_drive_file, upload_image, upload_file, download_message_resource, download_doc_image, list_user_okrs, get_okrs, list_okr_periods, create_okr_progress_record, list_okr_progress_records, delete_okr_progress_record, list_calendars, list_calendar_events, get_calendar_event, create_calendar_event, update_calendar_event, delete_calendar_event, respond_calendar_event, get_freebusy, list_tasks, get_task, create_task, update_task, complete_task, delete_task, manage_task_members
 user_invocable: true
 ---
 
 # Feishu User Plugin
 
 All-in-one Feishu plugin for Claude Code with three auth layers:
-- **User Identity** (cookie auth): Send messages as yourself — text, image, file, rich text, sticker, audio
+- **User Identity** (cookie auth): Send messages as yourself — text, image, file, rich text (post)
 - **Official API** (app credentials): Read group messages, docs, tables, wiki, drive, contacts
 - **User OAuth** (user_access_token): Read P2P (direct message) chat history
 
@@ -43,7 +43,7 @@ Search users and groups by name, display results grouped by type.
 Search (search_docs), read (read_doc), create (create_doc) — three in one.
 
 ### /table — Bitable operations
-Query (list tables → list fields → search records), create records, update records.
+Query (`manage_bitable_table(action=list)` → `manage_bitable_field(action=list)` → `manage_bitable_record(action=search)`), create / update / delete records via `manage_bitable_record(action=create|update|delete)`.
 
 ### /wiki — Wiki management
 List spaces (list_wiki_spaces), search content (search_wiki), browse nodes (list_wiki_nodes).