Method run

src/core/hooks.ts:146–175

* Run every command hook that matches `event`, in parallel, and fold their * outputs into a single result. `fields` carries the event-specific input * (tool_name, prompt, trigger, …); base fields are added automatically. * Never throws — a misbehaving hook surfaces as a non-blocking message.

(event: HookEvent, fields: Record<string, unknown> = {})

	 * Never throws — a misbehaving hook surfaces as a non-blocking message.
	 */
	async run(event: HookEvent, fields: Record<string, unknown> = {}): Promise<AggregatedHookResult> {
		const matchers = this.ctx.config?.[event]
		if (!matchers || matchers.length === 0) return EMPTY_RESULT

		const query = getMatchQuery(event, fields)
		const selected: HookCommand[] = []
		for (const m of matchers) {
			if (!m || !Array.isArray(m.hooks)) continue
			if (!matcherMatches(m.matcher, query)) continue
			for (const h of m.hooks) {
				if (h && h.type === "command" && typeof h.command === "string" && h.command.trim()) {
					selected.push(h)
				}
			}
		}
		if (selected.length === 0) return EMPTY_RESULT

		const input =
			JSON.stringify({
				session_id: this.ctx.sessionId,
				transcript_path: this.ctx.transcriptPath,
				cwd: this.ctx.cwd,
				hook_event_name: event,
				...fields,
			}) + "\n"
		const env = buildHookEnv(this.ctx.cwd)

		const results = await Promise.all(selected.map((h) => this.runOne(event, h, input, env)))
		return aggregate(results)
	}

	private surface(message: string, isError: boolean): void {
		this.ctx.onSystemMessage?.(message, isError)