dsh-hooks 0.4.0 → 0.6.0

package/lib/server.js

@@ -1,7 +1,10 @@
 import { createRequire } from 'node:module';
-import { describeHook, evaluateHooks, mockContext } from './dry-run.js';
+import { describeHook, evaluateHooks, mockContext, patchFilePath } from './dry-run.js';
 import { createHookRunner } from './runner.js';
-import { fireNotify } from './notify.js';
+import { fireNotify, summarizeContext } from './notify.js';
+import { FEISHU_SETUP_BUSY } from './feishu-session.js';
+import { deleteFeishuConfig, readFeishuSummary, runFeishuTest, updateFeishuResultMaxChars } from './feishu.js';
+import { removeScriptHooks, writeHooksConfig } from './patch-config.js';
 /** Plugin version, read from package.json (this package ships its own). */
 export function pluginVersion() {
     const require = createRequire(import.meta.url);
@@ -44,10 +47,35 @@ async function readJsonBody(req) {
         return null;
     }
 }
+/** Sanitized per-hook description for the settings panel (regex sources, no RegExp objects). */
+export function describeHooks(hooks) {
+    return hooks.map((hook, i) => ({
+        index: i + 1,
+        on: hook.on,
+        when: hook.when,
+        match: hook.match === undefined
+            ? undefined
+            : Object.fromEntries(Object.entries(hook.match).map(([field, re]) => [field, re.source])),
+        run: hook.run,
+        notify: hook.notify === undefined || hook.notify === null
+            ? undefined
+            : { channel: hook.notify.channel, url: hook.notify.url, slack: hook.notify.slack },
+        input: hook.input,
+        timeoutMs: hook.timeoutMs,
+        retries: hook.retries,
+        retryDelayMs: hook.retryDelayMs,
+    }));
+}
+const FAILED_OUTCOMES = new Set(['exit-nonzero', 'timeout', 'spawn-failed', 'send-failed']);
 /** Create the /dsh-hooks route handler (exported for tests). */
 export function createHookHandler(options) {
     const { hooks, history } = options;
     const version = options.version ?? pluginVersion();
+    const feishu = options.feishu;
+    const runFeishuTestCard = feishu?.runTest ?? runFeishuTest;
+    const feishuConfigPath = feishu?.configPath;
+    const runnerStats = options.runner?.stats ?? (() => ({ inFlight: 0, pendingRetries: 0 }));
+    const resolvePatch = options.resolvePatchFile ?? patchFilePath;
     return async (req, res) => {
         if (!isLoopbackRequest(req)) {
             json(res, FAIL('forbidden', 'loopback-only'), 403);
@@ -56,13 +84,26 @@ export function createHookHandler(options) {
         const url = new URL(req.url ?? '/', 'http://x');
         const pathname = url.pathname;
         if (req.method === 'GET' && pathname === '/dsh-hooks/status') {
-            json(res, OK({ name: 'dsh-hooks', version, hookCount: hooks.length, historyCount: history.recent().length }));
+            // Pull in disk records (pre-restart and other-process appends) so the
+            // badge reflects the durable log, not just this process's memory.
+            history.sync();
+            const records = history.recent();
+            const recentFailures = records.filter((record) => FAILED_OUTCOMES.has(record.outcome)).length;
+            json(res, OK({
+                name: 'dsh-hooks',
+                version,
+                hookCount: hooks.length,
+                historyCount: records.length,
+                hooks: describeHooks(hooks),
+                stats: { ...runnerStats(), recentFailures },
+            }));
             return;
         }
         if (req.method === 'GET' && pathname === '/dsh-hooks/history') {
             const raw = url.searchParams.get('n');
             const parsed = raw === null ? 50 : Number(raw);
             const n = Number.isFinite(parsed) && parsed > 0 ? Math.min(500, Math.floor(parsed)) : 50;
+            history.sync();
             const records = history.recent();
             json(res, OK(records.slice(Math.max(0, records.length - n))));
             return;
@@ -119,6 +160,188 @@ export function createHookHandler(options) {
             }));
             return;
         }
+        if (feishu !== undefined && req.method === 'GET' && pathname === '/dsh-hooks/feishu/status') {
+            const summary = readFeishuSummary(feishuConfigPath);
+            json(res, OK({ ...summary, setup: feishu.manager.status() }));
+            return;
+        }
+        if (feishu !== undefined && req.method === 'POST' && pathname === '/dsh-hooks/feishu/setup') {
+            const contentType = req.headers['content-type'] ?? '';
+            if (!contentType.toLowerCase().startsWith('application/json')) {
+                json(res, FAIL('bad-request', 'POST 需要 application/json'), 415);
+                return;
+            }
+            const payload = await readJsonBody(req);
+            if (typeof payload !== 'object' || payload === null) {
+                json(res, FAIL('bad-request', 'malformed JSON body'), 400);
+                return;
+            }
+            const body = payload;
+            const profile = typeof body.profile === 'string' && body.profile.trim() !== '' ? body.profile.trim() : 'web';
+            const resultMaxChars = typeof body.resultMaxChars === 'number' && Number.isFinite(body.resultMaxChars)
+                ? body.resultMaxChars
+                : undefined;
+            try {
+                const setup = resultMaxChars === undefined
+                    ? await feishu.manager.start(profile)
+                    : await feishu.manager.start(profile, { resultMaxChars });
+                json(res, OK({ setup }));
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                json(res, FAIL('pending', message), message === FEISHU_SETUP_BUSY ? 409 : 500);
+            }
+            return;
+        }
+        if (feishu !== undefined && req.method === 'POST' && pathname === '/dsh-hooks/feishu/config') {
+            const contentType = req.headers['content-type'] ?? '';
+            if (!contentType.toLowerCase().startsWith('application/json')) {
+                json(res, FAIL('bad-request', 'POST 需要 application/json'), 415);
+                return;
+            }
+            const payload = await readJsonBody(req);
+            if (typeof payload !== 'object' || payload === null) {
+                json(res, FAIL('bad-request', 'malformed JSON body'), 400);
+                return;
+            }
+            const value = payload.resultMaxChars;
+            if (typeof value !== 'number') {
+                json(res, FAIL('bad-request', '缺少数字字段 resultMaxChars'), 400);
+                return;
+            }
+            try {
+                const resultMaxChars = updateFeishuResultMaxChars(feishuConfigPath, value);
+                json(res, OK({ resultMaxChars }));
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                json(res, FAIL('bad-request', message), 400);
+            }
+            return;
+        }
+        if (feishu !== undefined && req.method === 'POST' && pathname === '/dsh-hooks/feishu/cancel') {
+            const contentType = req.headers['content-type'] ?? '';
+            if (!contentType.toLowerCase().startsWith('application/json')) {
+                json(res, FAIL('bad-request', 'POST 需要 application/json'), 415);
+                return;
+            }
+            json(res, OK({ cancelled: feishu.manager.cancel() }));
+            return;
+        }
+        if (feishu !== undefined && req.method === 'POST' && pathname === '/dsh-hooks/feishu/test') {
+            const contentType = req.headers['content-type'] ?? '';
+            if (!contentType.toLowerCase().startsWith('application/json')) {
+                json(res, FAIL('bad-request', 'POST 需要 application/json'), 415);
+                return;
+            }
+            try {
+                const message = await runFeishuTestCard();
+                json(res, OK({ message }));
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                json(res, FAIL('send-failed', message), 500);
+            }
+            return;
+        }
+        if (req.method === 'POST' && pathname === '/dsh-hooks/notify/test') {
+            const contentType = req.headers['content-type'] ?? '';
+            if (!contentType.toLowerCase().startsWith('application/json')) {
+                json(res, FAIL('bad-request', 'POST 需要 application/json'), 415);
+                return;
+            }
+            const payload = await readJsonBody(req);
+            if (typeof payload !== 'object' || payload === null) {
+                json(res, FAIL('bad-request', 'malformed JSON body'), 400);
+                return;
+            }
+            const body = payload;
+            const channel = body.channel;
+            if (channel !== 'webhook' && channel !== 'desktop') {
+                json(res, FAIL('bad-request', '缺少字段 channel（webhook 或 desktop）'), 400);
+                return;
+            }
+            const ctx = {
+                event: 'user/message',
+                sessionId: 'notify-test',
+                sessionName: '通知测试',
+                source: 'plugin',
+                content: '这是一条 dsh-hooks 测试通知：如果收到这条消息，说明该渠道配置正常。',
+                timestamp: new Date().toISOString(),
+            };
+            const result = await fireNotify({
+                channel,
+                url: typeof body.url === 'string' && body.url !== '' ? body.url : undefined,
+                slack: body.slack === true,
+            }, ctx, (record) => history.record(record));
+            if (!result.ok) {
+                json(res, FAIL('send-failed', result.error ?? '发送失败'), 500);
+                return;
+            }
+            json(res, OK({ message: '✅ 测试通知已发送', preview: summarizeContext(ctx) }));
+            return;
+        }
+        if (req.method === 'POST' && pathname === '/dsh-hooks/hooks/save') {
+            const contentType = req.headers['content-type'] ?? '';
+            if (!contentType.toLowerCase().startsWith('application/json')) {
+                json(res, FAIL('bad-request', 'POST 需要 application/json'), 415);
+                return;
+            }
+            const payload = await readJsonBody(req);
+            if (typeof payload !== 'object' || payload === null) {
+                json(res, FAIL('bad-request', 'malformed JSON body'), 400);
+                return;
+            }
+            const body = payload;
+            const profile = typeof body.profile === 'string' && body.profile.trim() !== '' ? body.profile.trim() : 'web';
+            const wireHooks = body.hooks;
+            if (!Array.isArray(wireHooks)) {
+                json(res, FAIL('bad-request', '缺少数组字段 hooks'), 400);
+                return;
+            }
+            const patchFile = resolvePatch(profile);
+            try {
+                const result = writeHooksConfig(patchFile, wireHooks);
+                json(res, OK({
+                    profile,
+                    hookCount: result.hookCount,
+                    patchFile: result.patchFile,
+                    backupPath: result.backupPath,
+                    message: `✅ 已保存 ${result.hookCount} 个 hook 到 ${profile} profile（已备份原文件）。若未立即生效请重启 dsh web。`,
+                }));
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                json(res, FAIL('save-failed', message), 400);
+            }
+            return;
+        }
+        if (feishu !== undefined && req.method === 'POST' && pathname === '/dsh-hooks/feishu/disconnect') {
+            const contentType = req.headers['content-type'] ?? '';
+            if (!contentType.toLowerCase().startsWith('application/json')) {
+                json(res, FAIL('bad-request', 'POST 需要 application/json'), 415);
+                return;
+            }
+            const payload = await readJsonBody(req);
+            const body = (typeof payload === 'object' && payload !== null ? payload : {});
+            const profile = typeof body.profile === 'string' && body.profile.trim() !== '' ? body.profile.trim() : 'web';
+            const removeHooks = body.removeHooks === true;
+            // Abort any in-flight scan session first.
+            feishu.manager.cancel();
+            const existed = deleteFeishuConfig(feishuConfigPath);
+            if (removeHooks) {
+                try {
+                    removeScriptHooks(resolvePatch(profile), 'notify-feishu.mjs');
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    json(res, FAIL('save-failed', message), 400);
+                    return;
+                }
+            }
+            json(res, OK({ disconnected: true, existed, removedHooks: removeHooks, message: '✅ 已断开飞书连接' }));
+            return;
+        }
         json(res, FAIL('not-found', `unknown route ${pathname}`), 404);
     };
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-hooks",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "packageManager": "pnpm@11.21.0",
-  "description": "Config-driven lifecycle hooks plugin for DeepSeek Harness: declare event -> command hooks in cordis.patch.yml, no plugin code required. Includes a Hooks section in the Web GUI settings (history timeline + manual tester).",
+  "description": "Config-driven lifecycle hooks plugin for DeepSeek Harness: declare event -> command hooks in cordis.patch.yml, no plugin code required. Includes a Hooks section in the Web GUI settings (history timeline + manual tester + notify tests + hook editor + Feishu connect).",
   "author": "PeterBon",
   "license": "MIT",
   "repository": {