dsh-hooks 0.9.1 → 0.10.0

package/README.md

@@ -90,6 +90,7 @@ Every hook field:
 | `agent/disposed` | An agent leaves the registry | session id |
 | `agent/error` | The agent loop reports an error | error text |
 | `agent/status` | Agent status transition | status |
+| `hook/failed` | A hook fails consecutively past `failedAlertThreshold` (default 3; synthetic, emitted from the outcome stream) | failing hook summary, consecutive failure count |
 
 The `when` filter for `turn/end` matches the `reason.kind` value (`completed`, `error`, …). Hooks for other events run unconditionally.
 
@@ -131,9 +132,22 @@ The `when` filter for `turn/end` matches the `reason.kind` value (`completed`, `
 | `DSH_HOOK_APPROVAL_OUTCOME` | approval decision outcome (`approval/decided`) |
 | `DSH_HOOK_TOTAL_SUBAGENTS` | total subagents in the settled tree (`tree/settled`) |
 | `DSH_HOOK_TREE_DURATION_MS` | parent turn/end → tree settle duration, ms (`tree/settled`) |
+| `DSH_HOOK_FAILED_HOOK` | identity summary of the hook that failed consecutively (`hook/failed`) |
+| `DSH_HOOK_FAILURES` | consecutive failure count when the alert fired (`hook/failed`) |
 | `DSH_HOOK_TIMESTAMP` | ISO timestamp |
 
 - `{{var}}` placeholders inside `run` are substituted from the same context, e.g. `run: 'echo {{DSH_HOOK_SESSION_ID}} >> log.txt'`.
+- Failure alerts: fire-and-forget hooks fail silently by design, so the plugin also watches the outcome stream. When one hook fails `failedAlertThreshold` consecutive times (`spawn-failed` / `exit-nonzero` / `timeout` / `send-failed`; one logical run's final outcome counts once, internal retries don't add extra counts), the synthetic `hook/failed` event fires once per streak — a success resets both the counter and the dedup. Alert with a normal hook:
+
+```yaml
+config:
+  failedAlertThreshold: 3   # optional, default 3
+  hooks:
+    - on: 'hook/failed'
+      notify: { channel: 'desktop' }
+    - on: 'turn/end'
+      run: 'node my-hook.mjs'
+```
 - `turn/end` hooks are dispatched after the running-subagent count resolves, i.e. one async hop later than other events — an immediately following event from the same session (e.g. the next `turn/start`) may dispatch first.
 
 A common use for `DSH_HOOK_RUNNING_SUBAGENTS` is suppressing the end-of-turn notification while background subagents are still working and only notifying once a turn settles with nothing left running. Note the parent session emits `turn/end` exactly once (with the count > 0); the "everything settled" signal arrives as `turn/end` on the last child session, whose count is `0`:

package/README.zh.md

@@ -90,6 +90,7 @@ dsh plugin --profile web add github:PeterBon/dsh-hooks
 | `agent/disposed` | Agent 离开注册表 | 会话 id |
 | `agent/error` | Agent 循环报错 | 错误文本 |
 | `agent/status` | Agent 状态切换 | 状态 |
+| `hook/failed` | 同一 hook 连续失败达到 `failedAlertThreshold`（默认 3；合成事件，从结果流发射） | 失败 hook 摘要、连续失败次数 |
 
 `turn/end` 的 `when` 匹配结束原因（`completed`、`error`…）；其他事件的 hook 无条件执行。
 
@@ -131,9 +132,23 @@ dsh plugin --profile web add github:PeterBon/dsh-hooks
 | `DSH_HOOK_APPROVAL_OUTCOME` | 审批结果 outcome（`approval/decided`） |
 | `DSH_HOOK_TOTAL_SUBAGENTS` | 已落定树中的子代理总数（`tree/settled`） |
 | `DSH_HOOK_TREE_DURATION_MS` | 父回合结束 → 树落定的耗时（毫秒，`tree/settled`） |
+| `DSH_HOOK_FAILED_HOOK` | 连续失败的 hook 身份摘要（`hook/failed`） |
+| `DSH_HOOK_FAILURES` | 告警触发时的连续失败次数（`hook/failed`） |
 | `DSH_HOOK_TIMESTAMP` | ISO 时间戳 |
 
 - `run` 里的 `{{变量}}` 占位符会从同一上下文替换，例如 `run: 'echo {{DSH_HOOK_SESSION_ID}} >> log.txt'`。
+- 失败告警：fire-and-forget 的 hook 失败本来就是静默的，插件因此同时监视结果流——同一 hook 连续失败 `failedAlertThreshold` 次（`spawn-failed` / `exit-nonzero` / `timeout` / `send-failed`；一次逻辑执行的最终结果计一次，内部重试不另计）后发射合成事件 `hook/failed`，每条失败链只发一次；成功会清零计数并解除去抖。用普通 hook 接告警即可：
+
+```yaml
+config:
+  failedAlertThreshold: 3   # 可选，默认 3
+  hooks:
+    - on: 'hook/failed'
+      notify: { channel: 'desktop' }
+    - on: 'turn/end'
+      run: 'node my-hook.mjs'
+```
+
 - `turn/end` 的 hook 在运行中子代理计数解析完成后才派发，比其他事件晚一个异步跳——同会话紧随其后的事件（如下一轮 `turn/start`）可能先执行。
 
 `DSH_HOOK_RUNNING_SUBAGENTS` 的典型用法：后台子代理还在运行时抑制回合结束通知，只在本会话回合真正落定时才通知。注意父会话只会收到一次 `turn/end`（此时计数 > 0）；「全部落定」的信号由最后一个子会话自己的 `turn/end`（计数为 `0`）送达：

package/lib/config.d.ts

@@ -1,5 +1,5 @@
 /** Hookable event kinds. v1 is emit-only: no waterfall/interception events. */
-export declare const HOOK_EVENTS: readonly ['turn/start', 'turn/end', 'tree/settled', 'step/end', 'tool/call', 'tool/result', 'user/message', 'approval/asked', 'approval/decided', 'session/title', 'session/created', 'session/disposed', 'agent/created', 'agent/disposed', 'agent/error', 'agent/status'];
+export declare const HOOK_EVENTS: readonly ['turn/start', 'turn/end', 'tree/settled', 'step/end', 'tool/call', 'tool/result', 'user/message', 'approval/asked', 'approval/decided', 'session/title', 'session/created', 'session/disposed', 'agent/created', 'agent/disposed', 'agent/error', 'agent/status', 'hook/failed'];
 export type HookEvent = (typeof HOOK_EVENTS)[number];
 /** `turn/end` reason kinds (from @deepseek-ai/dsh-session TurnEndReasonMap). */
 export declare const TURN_END_REASONS: readonly ['completed', 'error', 'aborted', 'blocked', 'max-tokens', 'interrupted'];
@@ -68,6 +68,13 @@ export interface HistoryConfig {
 export interface Config {
     hooks?: HookSpec[];
     history?: HistoryConfig | null;
+    /**
+     * Consecutive failure count (spawn-failed / exit-nonzero / timeout /
+     * send-failed; one logical run counts once, internal retries included)
+     * that emits the synthetic `hook/failed` event. Defaults to 3; values
+     * below 1 are clamped to 1.
+     */
+    failedAlertThreshold?: number;
 }
 export declare const Config: {
     (data?: Config | null): Config;

package/lib/config.js

@@ -17,6 +17,7 @@ export const HOOK_EVENTS = [
     'agent/disposed',
     'agent/error',
     'agent/status',
+    'hook/failed',
 ];
 /** `turn/end` reason kinds (from @deepseek-ai/dsh-session TurnEndReasonMap). */
 export const TURN_END_REASONS = [
@@ -33,7 +34,7 @@ export const TURN_END_REASONS = [
 // declaration self-contained.
 export const Config = Schema.object({
     hooks: Schema.array(Schema.object({
-        on: Schema.union([...HOOK_EVENTS]).description('触发事件：turn/start | turn/end | tree/settled | step/end | tool/call | tool/result | user/message | approval/asked | approval/decided | session/title | session/created | session/disposed | agent/created | agent/disposed | agent/error | agent/status'),
+        on: Schema.union([...HOOK_EVENTS]).description('触发事件：turn/start | turn/end | tree/settled | step/end | tool/call | tool/result | user/message | approval/asked | approval/decided | session/title | session/created | session/disposed | agent/created | agent/disposed | agent/error | agent/status | hook/failed'),
         when: Schema.union([...TURN_END_REASONS]).description('可选过滤：对 turn/end 匹配结束原因（completed/error/aborted/blocked/max-tokens/interrupted）；其他事件忽略该字段'),
         match: Schema.dict(Schema.regExp()).description('可选通用过滤：字段 → 正则，全部匹配才触发。字段为上下文键（tool/sessionName/sessionId/error/source/cwd/content/reason/…），上下文中不存在的字段视为不匹配'),
         run: Schema.string().description('触发时通过系统 shell 执行的命令（与 notify 二选一）'),
@@ -68,4 +69,7 @@ export const Config = Schema.object({
     ])
         .default(null)
         .description('hook 执行历史：内存环形缓冲 + 可选 JSONL 持久化日志（供 UI/调试使用，严格 best-effort）'),
+    failedAlertThreshold: Schema.natural()
+        .default(3)
+        .description('同一 hook 连续失败达到该次数时发射 hook/failed 合成事件（spawn-failed/exit-nonzero/timeout/send-failed 计失败；一次逻辑执行的最终结果计一次，内部重试不另计；成功清零，触发后去抖）'),
 }).description('dsh-hooks 配置：声明式生命周期 hooks');

package/lib/context.d.ts

@@ -60,6 +60,10 @@ export interface HookContext {
     totalSubagents?: number;
     /** Parent turn/end → tree settle duration, ms (tree/settled). */
     treeDurationMs?: number;
+    /** Identity summary of the hook that failed consecutively (hook/failed). */
+    hookFailedHook?: string;
+    /** Consecutive failure count when the alert fired (hook/failed). */
+    hookFailures?: number;
     timestamp: string;
 }
 export declare function toEnv(ctx: HookContext): Record<string, string>;

package/lib/context.js

@@ -65,6 +65,10 @@ export function toEnv(ctx) {
         env.DSH_HOOK_TOTAL_SUBAGENTS = String(ctx.totalSubagents);
     if (ctx.treeDurationMs !== undefined)
         env.DSH_HOOK_TREE_DURATION_MS = String(ctx.treeDurationMs);
+    if (ctx.hookFailedHook !== undefined)
+        env.DSH_HOOK_FAILED_HOOK = ctx.hookFailedHook;
+    if (ctx.hookFailures !== undefined)
+        env.DSH_HOOK_FAILURES = String(ctx.hookFailures);
     return env;
 }
 /** Render `{{DSH_HOOK_*}}` placeholders from the context map. */

package/lib/events.d.ts

@@ -119,6 +119,13 @@ export declare function approvalDecidedContext(session: Session, data: ApprovalD
  * off. Emitted by index.ts, not classified from a session log event.
  */
 export declare function treeSettledContext(session: Session, totalSubagents: number, treeDurationMs: number): HookContext;
+/**
+ * Synthetic `hook/failed` context: one hook failed consecutively past the
+ * alert threshold. Emitted by index.ts from the runner/history outcome
+ * stream, not classified from a session log event; `origin` supplies the
+ * session identity of the event that triggered the failing hook.
+ */
+export declare function hookFailedContext(origin: HookContext, hookFailedHook: string, hookFailures: number): HookContext;
 export declare function agentCreatedContext(agent: AgentLike): HookContext;
 export declare function agentDisposedContext(agent: AgentLike): HookContext;
 export declare function agentErrorContext(agent: AgentLike, turn: number | undefined, error: unknown): HookContext;

package/lib/events.js

@@ -329,6 +329,23 @@ export function treeSettledContext(session, totalSubagents, treeDurationMs) {
         treeDurationMs,
     };
 }
+/**
+ * Synthetic `hook/failed` context: one hook failed consecutively past the
+ * alert threshold. Emitted by index.ts from the runner/history outcome
+ * stream, not classified from a session log event; `origin` supplies the
+ * session identity of the event that triggered the failing hook.
+ */
+export function hookFailedContext(origin, hookFailedHook, hookFailures) {
+    return {
+        event: 'hook/failed',
+        sessionId: origin.sessionId,
+        sessionName: origin.sessionName,
+        cwd: origin.cwd,
+        hookFailedHook,
+        hookFailures,
+        timestamp: new Date().toISOString(),
+    };
+}
 export function agentCreatedContext(agent) {
     return {
         event: 'agent/created',

package/lib/index.d.ts

@@ -59,7 +59,7 @@ export { createHistorySink } from './history.js';
  * Model-facing announcement, installed only when the system-prompt service
  * exists (web profile). Tells agents the plugin exists and how to cooperate.
  */
-export declare const DSH_HOOKS_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-hooks \u63D2\u4EF6\uFF08DeepSeek Harness \u914D\u7F6E\u9A71\u52A8\u751F\u547D\u5468\u671F hooks\uFF09\uFF1A\u53EF\u5728 profile \u7684 cordis.patch.yml \u58F0\u660E\u300C\u4E8B\u4EF6 \u2192 \u547D\u4EE4/\u901A\u77E5\u300D\u7684 hook\uFF08turn/start\u3001turn/end\u3001tree/settled\u3001step/end\u3001tool/call\u3001tool/result\u3001user/message\u3001approval/asked\u3001approval/decided\u3001session/title\u3001session/created\u3001session/disposed\u3001agent/created\u3001agent/disposed\u3001agent/error\u3001agent/status \u5171 16 \u7C7B\u4E8B\u4EF6\uFF09\uFF0C\u652F\u6301 when \u539F\u56E0\u8FC7\u6EE4\u3001match \u5B57\u6BB5\u6B63\u5219\u8FC7\u6EE4\u3001stdin JSON \u8F93\u5165\u3001opt-in \u91CD\u8BD5\u3001\u5185\u7F6E webhook/desktop \u901A\u77E5\u6E20\u9053\uFF1B\u6267\u884C\u5386\u53F2\u8BB0\u5F55\u4E8E ~/.dsh/dsh-hooks/history.jsonl\uFF1B`dsh-hooks dry-run <event>` \u53EF\u6A21\u62DF\u4E8B\u4EF6\u9A8C\u8BC1\u914D\u7F6E\u3002\u7528\u6237\u63D0\u5230\u300Chooks / \u94A9\u5B50 / \u751F\u547D\u5468\u671F / \u901A\u77E5\u914D\u7F6E\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
+export declare const DSH_HOOKS_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-hooks \u63D2\u4EF6\uFF08DeepSeek Harness \u914D\u7F6E\u9A71\u52A8\u751F\u547D\u5468\u671F hooks\uFF09\uFF1A\u53EF\u5728 profile \u7684 cordis.patch.yml \u58F0\u660E\u300C\u4E8B\u4EF6 \u2192 \u547D\u4EE4/\u901A\u77E5\u300D\u7684 hook\uFF08turn/start\u3001turn/end\u3001tree/settled\u3001step/end\u3001tool/call\u3001tool/result\u3001user/message\u3001approval/asked\u3001approval/decided\u3001session/title\u3001session/created\u3001session/disposed\u3001agent/created\u3001agent/disposed\u3001agent/error\u3001agent/status\u3001hook/failed \u5171 17 \u7C7B\u4E8B\u4EF6\uFF09\uFF0C\u652F\u6301 when \u539F\u56E0\u8FC7\u6EE4\u3001match \u5B57\u6BB5\u6B63\u5219\u8FC7\u6EE4\u3001stdin JSON \u8F93\u5165\u3001opt-in \u91CD\u8BD5\u3001\u5185\u7F6E webhook/desktop \u901A\u77E5\u6E20\u9053\uFF1B\u6267\u884C\u5386\u53F2\u8BB0\u5F55\u4E8E ~/.dsh/dsh-hooks/history.jsonl\uFF1B`dsh-hooks dry-run <event>` \u53EF\u6A21\u62DF\u4E8B\u4EF6\u9A8C\u8BC1\u914D\u7F6E\u3002\u7528\u6237\u63D0\u5230\u300Chooks / \u94A9\u5B50 / \u751F\u547D\u5468\u671F / \u901A\u77E5\u914D\u7F6E\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
 export declare function apply(ctx: Context, config?: Config): void;
 export declare const _internals: {
     clearTurnTracking: typeof clearTurnTracking;

package/lib/index.js

@@ -1,6 +1,6 @@
 import './types.js';
 import { Config } from './config.js';
-import { agentCreatedContext, agentDisposedContext, agentErrorContext, agentStatusContext, classifySessionEvent, clearTurnTracking, hookMatches, matchFilters, sessionCreatedContext, sessionDisposedContext, treeSettledContext, } from './events.js';
+import { agentCreatedContext, agentDisposedContext, agentErrorContext, agentStatusContext, classifySessionEvent, clearTurnTracking, hookFailedContext, hookMatches, matchFilters, sessionCreatedContext, sessionDisposedContext, treeSettledContext, } from './events.js';
 import { eventLabel } from './context.js';
 import { createHookRunner } from './runner.js';
 import { fireNotify } from './notify.js';
@@ -73,7 +73,7 @@ export { createHistorySink } from './history.js';
  * Model-facing announcement, installed only when the system-prompt service
  * exists (web profile). Tells agents the plugin exists and how to cooperate.
  */
-export const DSH_HOOKS_GUIDANCE = '本机已安装 dsh-hooks 插件（DeepSeek Harness 配置驱动生命周期 hooks）：可在 profile 的 cordis.patch.yml 声明「事件 → 命令/通知」的 hook（turn/start、turn/end、tree/settled、step/end、tool/call、tool/result、user/message、approval/asked、approval/decided、session/title、session/created、session/disposed、agent/created、agent/disposed、agent/error、agent/status 共 16 类事件），支持 when 原因过滤、match 字段正则过滤、stdin JSON 输入、opt-in 重试、内置 webhook/desktop 通知渠道；执行历史记录于 ~/.dsh/dsh-hooks/history.jsonl；`dsh-hooks dry-run <event>` 可模拟事件验证配置。用户提到「hooks / 钩子 / 生命周期 / 通知配置」时即指本插件，请据此协作。';
+export const DSH_HOOKS_GUIDANCE = '本机已安装 dsh-hooks 插件（DeepSeek Harness 配置驱动生命周期 hooks）：可在 profile 的 cordis.patch.yml 声明「事件 → 命令/通知」的 hook（turn/start、turn/end、tree/settled、step/end、tool/call、tool/result、user/message、approval/asked、approval/decided、session/title、session/created、session/disposed、agent/created、agent/disposed、agent/error、agent/status、hook/failed 共 17 类事件），支持 when 原因过滤、match 字段正则过滤、stdin JSON 输入、opt-in 重试、内置 webhook/desktop 通知渠道；执行历史记录于 ~/.dsh/dsh-hooks/history.jsonl；`dsh-hooks dry-run <event>` 可模拟事件验证配置。用户提到「hooks / 钩子 / 生命周期 / 通知配置」时即指本插件，请据此协作。';
 export function apply(ctx, config = {}) {
     const hooks = config.hooks ?? [];
     const history = createHistorySink(config.history ?? undefined);
@@ -97,22 +97,57 @@ export function apply(ctx, config = {}) {
     if (systemPrompt !== undefined) {
         ctx.effect(() => systemPrompt.section({ name: 'plugin:dsh-hooks', order: 200, text: DSH_HOOKS_GUIDANCE }), 'dsh-hooks: prompt section');
     }
+    // Consecutive failure tracking for the synthetic hook/failed alert: a hook
+    // that keeps failing is dead automation, and fire-and-forget dispatch would
+    // otherwise let it rot silently. Counters are keyed by hook index, reset on
+    // success, and the alert fires once per streak (dedup until a success).
+    const failureThreshold = Math.max(1, config.failedAlertThreshold ?? 3);
+    const failures = new Map();
+    const alerted = new Set();
+    /** One-line identity of a hook for failure alerts. */
+    function hookFailureSummary(hook) {
+        const when = hook.when ? `/${hook.when}` : '';
+        const action = hook.run ? hook.run : hook.notify ? `notify:${hook.notify.channel}` : '(既无 run 也无 notify)';
+        return `${hook.on}${when}: ${action}`.slice(0, 200);
+    }
     const runMatching = (ctxValue, reasonKind) => {
-        for (const hook of hooks) {
+        hooks.forEach((hook, index) => {
             if (!hookMatches(hook, ctxValue.event, reasonKind))
-                continue;
+                return;
             if (!matchFilters(hook.match, ctxValue))
-                continue;
+                return;
+            // Attribute every outcome record to this hook identity so the failure
+            // streak below sees the full run/notify lifecycle (retries included).
+            const track = (record) => {
+                history.record(record);
+                const failed = record.outcome === 'spawn-failed' ||
+                    record.outcome === 'exit-nonzero' ||
+                    record.outcome === 'timeout' ||
+                    record.outcome === 'send-failed';
+                if (failed) {
+                    const count = (failures.get(index) ?? 0) + 1;
+                    failures.set(index, count);
+                    if (count >= failureThreshold && !alerted.has(index)) {
+                        alerted.add(index);
+                        runMatching(hookFailedContext(ctxValue, hookFailureSummary(hook), count));
+                    }
+                    return;
+                }
+                if (record.outcome === 'exit-0' || record.outcome === 'sent') {
+                    failures.delete(index);
+                    alerted.delete(index);
+                }
+            };
             if (hook.notify) {
-                void fireNotify(hook.notify, ctxValue, (record) => history.record(record));
-                continue;
+                void fireNotify(hook.notify, ctxValue, track);
+                return;
             }
             if (hook.run) {
-                runner.run(hook, ctxValue);
-                continue;
+                runner.run(hook, ctxValue, track);
+                return;
             }
             console.warn(`[dsh-hooks] hook 既没有 run 也没有 notify，已跳过：${eventLabel(ctxValue)}`);
-        }
+        });
     };
     // turn/end: fill the live running-subagent count before dispatching hooks,
     // so a hook can tell "work handed off to still-running subagents" apart from

package/lib/runner.d.ts

@@ -9,7 +9,7 @@ export interface RunOutcome {
 }
 /** Track in-flight hook runs so a missing parent never outlives teardown. */
 export interface HookRunner {
-    run(spec: HookSpec, ctx: HookContext): RunOutcome;
+    run(spec: HookSpec, ctx: HookContext, recordOverride?: RunRecord): RunOutcome;
     /** Live counters for the web-panel diagnostics. */
     stats(): HookRunnerStats;
     dispose(): void;

package/lib/runner.js

@@ -38,9 +38,12 @@ export function terminate(child) {
 export function createHookRunner(log = console.log, record) {
     const children = new Set();
     const pendingRetries = new Set();
-    function spawnOnce(spec, ctx, attempt) {
+    function spawnOnce(spec, ctx, attempt, recordOverride) {
         if (!spec.run)
             return { ok: false, reason: 'skipped', detail: 'no run command' };
+        // Per-run override replaces the shared sink for this logical run so
+        // callers can attribute outcomes (incl. retries) to one hook identity.
+        const rec = recordOverride ?? record;
         const timeoutMs = spec.timeoutMs ?? DEFAULT_TIMEOUT_MS;
         const retries = spec.retries ?? 0;
         const retryDelayMs = spec.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
@@ -66,18 +69,18 @@ export function createHookRunner(log = console.log, record) {
         catch (error) {
             const detail = error instanceof Error ? error.message : String(error);
             console.warn(`[dsh-hooks] spawn 失败 (${eventLabel(ctx)}): ${detail}`);
-            record?.({ ...base, outcome: 'spawn-failed', error: detail });
+            rec?.({ ...base, outcome: 'spawn-failed', error: detail });
             return { ok: false, reason: 'spawn-failed', detail };
         }
         const startedAt = Date.now();
-        record?.({ ...base, outcome: 'spawned' });
+        rec?.({ ...base, outcome: 'spawned' });
         children.add(child);
         let timedOut = false;
         const timer = setTimeout(() => {
             timedOut = true;
             terminate(child);
             console.warn(`[dsh-hooks] 超时（${timeoutMs}ms），已终止：${eventLabel(ctx)}`);
-            record?.({ ...base, outcome: 'timeout', durationMs: Date.now() - startedAt });
+            rec?.({ ...base, outcome: 'timeout', durationMs: Date.now() - startedAt });
         }, timeoutMs);
         // Never hold the process open for a hook.
         child.unref();
@@ -107,7 +110,7 @@ export function createHookRunner(log = console.log, record) {
             // that actually ran and exited non-zero does.
             if (timedOut || code === null || code === 0) {
                 if (!timedOut && code !== null) {
-                    record?.({ ...base, outcome: 'exit-0', exitCode: 0, durationMs: Date.now() - startedAt });
+                    rec?.({ ...base, outcome: 'exit-0', exitCode: 0, durationMs: Date.now() - startedAt });
                 }
                 return;
             }
@@ -116,7 +119,7 @@ export function createHookRunner(log = console.log, record) {
                 log(`[dsh-hooks] hook 退出码 ${code}，${delay}ms 后重试（${attempt + 1}/${retries}）：${eventLabel(ctx)}`);
                 const retryTimer = setTimeout(() => {
                     pendingRetries.delete(retryTimer);
-                    spawnOnce(spec, ctx, attempt + 1);
+                    spawnOnce(spec, ctx, attempt + 1, recordOverride);
                 }, delay);
                 retryTimer.unref?.();
                 pendingRetries.add(retryTimer);
@@ -125,14 +128,14 @@ export function createHookRunner(log = console.log, record) {
             const tail = captured.err.trim();
             const detail = tail === '' ? '' : `，stderr：${tail.slice(-400)}`;
             console.warn(`[dsh-hooks] hook 退出码 ${code} (${eventLabel(ctx)})${detail}`);
-            record?.({ ...base, outcome: 'exit-nonzero', exitCode: code, durationMs: Date.now() - startedAt, error: tail.slice(-400) || undefined });
+            rec?.({ ...base, outcome: 'exit-nonzero', exitCode: code, durationMs: Date.now() - startedAt, error: tail.slice(-400) || undefined });
         });
         return { ok: true, reason: 'ran' };
     }
-    function run(spec, ctx) {
+    function run(spec, ctx, recordOverride) {
         if (!spec.run)
             return { ok: false, reason: 'skipped', detail: 'no run command' };
-        return spawnOnce(spec, ctx, 0);
+        return spawnOnce(spec, ctx, 0, recordOverride);
     }
     function dispose() {
         for (const timer of pendingRetries)

package/lib/server.d.ts

@@ -48,7 +48,7 @@ export interface HookRoutesOptions {
 /** Sanitized per-hook description for the settings panel (regex sources, no RegExp objects). */
 export declare function describeHooks(hooks: readonly HookSpec[]): {
     index: number;
-    on: "agent/created" | "agent/disposed" | "agent/error" | "agent/status" | "approval/asked" | "approval/decided" | "session/created" | "session/disposed" | "session/title" | "step/end" | "tool/call" | "tool/result" | "tree/settled" | "turn/end" | "turn/start" | "user/message";
+    on: "agent/created" | "agent/disposed" | "agent/error" | "agent/status" | "approval/asked" | "approval/decided" | "hook/failed" | "session/created" | "session/disposed" | "session/title" | "step/end" | "tool/call" | "tool/result" | "tree/settled" | "turn/end" | "turn/start" | "user/message";
     when: "aborted" | "blocked" | "completed" | "error" | "interrupted" | "max-tokens" | undefined;
     match: {
         [k: string]: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-hooks",
-  "version": "0.9.1",
+  "version": "0.10.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 + notify tests + hook editor + Feishu connect).",
   "author": "PeterBon",