pi-shepherd 0.1.1 → 0.2.0

package/shepherd/compaction.ts

@@ -0,0 +1,76 @@
+/**
+ * session_compact hook 处理逻辑
+ *
+ * pi 会话压缩完成后（manual /compact、threshold 阈值、overflow 溢出恢复），
+ * 按 `hook: "session_compact"` 规则注入提醒（典型用途：技能正文已随压缩
+ * 挥发，提示 AI 需要时重读 SKILL.md）。
+ *
+ * 注入走 ephemeral 管线（pushWarning → 缓冲区 → before_provider_request
+ * drainHints 消费即焚）。不 sendMessage(triggerTurn)：三种 reason 的压缩
+ * 之后均必然存在下一个 provider request（overflow→willRetry 自动重试；
+ * manual/threshold→用户下一条消息）。
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { pushWarning } from "./ephemeral.js";
+import {
+	isSubagent,
+	type LoadRulesOptions,
+	loadRules,
+	ruleMatches,
+} from "./rules.js";
+import type { ToolState } from "./tool-hooks.js";
+import { toolsAvailable } from "./tool-hooks.js";
+
+/**
+ * 注册 session_compact 事件处理。
+ *
+ * 触发语义：一次压缩事件 = 一次真实挥发 = 一次提醒（不做每会话一次的
+ * _fired 去重——与 message_end 的"每轮一次"语义刻意不同）。
+ */
+export function registerSessionCompact(
+	pi: ExtensionAPI,
+	state: ToolState,
+	rulesDir?: string,
+	rulesOptions?: LoadRulesOptions,
+): void {
+	pi.on("session_compact", async (event, _ctx) => {
+		const rules = loadRules(rulesDir, rulesOptions).filter(
+			(r) => r.hook === "session_compact",
+		);
+		if (rules.length === 0) return;
+
+		// 匹配目标：reason 为压缩触发源（manual/threshold/overflow）
+		const reason: string = event.reason ?? "";
+		const targets = {
+			text: "",
+			path: "",
+			command: "",
+			glob: "",
+			result: "",
+			reason,
+		};
+
+		for (const rule of rules) {
+			// 跳过禁用规则
+			if (rule.enabled === false) continue;
+			// 子代理控制：默认跳过，显式 subagent: true 才在子代理触发
+			if (isSubagent() && rule.subagent !== true) continue;
+			// 工具依赖检查
+			if (!toolsAvailable(rule, pi, state)) continue;
+
+			// 条件匹配：conditions 模式（field 可为 reason 等）；
+			// 单条件 pattern 模式匹配 reason（向后兼容风格）；
+			// 都没有 = 无条件触发
+			if (rule.conditions && rule.conditions.length > 0) {
+				if (!ruleMatches(rule, targets, undefined)) continue;
+			} else if (rule.pattern) {
+				const re = rule._compiled ?? new RegExp(rule.pattern, rule.flags || "");
+				if (!re.test(reason)) continue;
+			}
+
+			// steer/notify 统一走 pushWarning（即焚注入）
+			pushWarning(rule.reason, rule.comment);
+		}
+	});
+}

package/shepherd/conditions.ts

@@ -0,0 +1,98 @@
+import { hasGitUntracked, isGitDirty } from "./git";
+
+/** 内置条件类型：不依赖正则，直接检查环境状态 */
+export type ConditionBuiltin =
+	| "git_dirty" // git 有已跟踪文件的未提交改动（M/A/D/R）
+	| "git_untracked" // git 有未跟踪文件（??）
+	| "git_uncommitted" // 旧 check 字段迁移兼容：dirty || untracked
+	| "has_edits" // 本轮调用过 edit/write
+	| "not_question_ending" // AI 最后一条消息不以问句结尾（用于抑制"等待回复"场景的 agent_end 提醒）
+	| "always"; // 始终匹配
+
+/** 内置条件匹配上下文 */
+export interface BuiltinContext {
+	hasEdits?: boolean;
+	gitDirty?: boolean;
+	gitUntracked?: boolean;
+	lastAssistantText?: string;
+}
+
+/**
+ * 宽松检测 AI 消息是否包含问句/确认模式（等待用户回复）
+ *
+ * 策略：全文搜索，只要出现任何问句模式就返回 true（宁可多跳，不误打扰用户）
+ * 排除代码块和引用块内的内容，避免误判技术文本中的 ? 运算符等
+ */
+export function isQuestionEnding(text: string): boolean {
+	if (!text) return false;
+
+	// 去除代码块（```...```），避免 ?. 可选链、?: 三元等误判
+	const noCodeBlocks = text.replace(/```[\s\S]*?```/g, "");
+	// 去除行内代码（`...`）
+	const noInlineCode = noCodeBlocks.replace(/`[^`]+`/g, "");
+	// 宽松方案：保留所有行（含引用块），不做过滤
+	const prose = noInlineCode;
+
+	if (!prose.trim()) return false;
+
+	// 1. 中英文问号出现在行末或句末（后面可能跟空格/换行/标点）
+	if (/[？?][\s]*(?:[\n]|$|[。.!,，、；;:：)）\]])/m.test(prose)) return true;
+	// 独立问号结尾
+	if (/[？?]\s*$/m.test(prose)) return true;
+
+	// 2. 中文疑问语气词结尾（非代码上下文）
+	// "呢/吗/吧/嘛/么/啦/呗" 出现在句末
+	if (/(?:呢|吗|吧|嘛|么|啦|呗)\s*[？?。.!！,，、；;:\s]*$/m.test(prose)) return true;
+
+	// 3. 选择/确认类句式（全文搜索）
+	const confirmPatterns = [
+		/要不要/,
+		/你觉得/,
+		/你想/,
+		/确认(?:一下)?/,
+		/可以吗/,
+		/行不行/,
+		/好不好/,
+		/是不是/,
+		/还是说/,
+		/还是先/,
+		/先(?:讨论|确认|看看)/,
+		/等(?:你|你(?:的)?回复)/,
+		/你(?:还)?(?:有|有没有)/,
+		/(?:你|您)(?:觉得|想|希望|倾向|偏好)/,
+		/请(?:确认|回复|告诉)/,
+		/你来(?:决定|选|定)/,
+		/直接改还是/,
+	];
+	for (const p of confirmPatterns) {
+		if (p.test(prose)) return true;
+	}
+
+	return false;
+}
+
+/** 判断单个内置条件是否满足 */
+export function matchBuiltinCondition(
+	builtin: ConditionBuiltin,
+	ctx: BuiltinContext,
+): boolean {
+	switch (builtin) {
+		case "always":
+			return true;
+		case "has_edits":
+			return !!ctx.hasEdits;
+		case "git_dirty":
+			return (ctx.gitDirty ?? isGitDirty()) === true;
+		case "git_untracked":
+			return (ctx.gitUntracked ?? hasGitUntracked()) === true;
+		case "git_uncommitted": {
+			// 旧 check 字段迁移兼容：git_uncommitted = dirty || untracked
+			const dirty = ctx.gitDirty !== undefined ? ctx.gitDirty : isGitDirty();
+			const untracked =
+				ctx.gitUntracked !== undefined ? ctx.gitUntracked : hasGitUntracked();
+			return dirty || untracked;
+		}
+		case "not_question_ending":
+			return !isQuestionEnding(ctx.lastAssistantText ?? "");
+	}
+}

package/shepherd/ephemeral.ts

@@ -1,52 +1,55 @@
-/**
- * Shepherd 专用提示缓冲区
- *
- * shepherd 规则触发的 steer/notify 提示通过 pushWarning 推入，
- * 由共享的 ephemeral 注入机制在 before_provider_request 时发送。
- * 提示只对当前请求生效，不写入 session 历史。
- */
-
-/** 替换 ${ENV_VAR} 格式的环境变量 */
-function expandEnvVars(text: string): string {
-	return text.replace(/\$\{(\w+)\}/g, (_match, name: string) => process.env[name] ?? `\${${name}}`);
-}
-
-/** 推入一条 shepherd 提示（自动加 ⚠️ shepherd: 前缀） */
-export function pushWarning(reason: string, label?: string): void {
-	// shepherd 前缀用于通知气泡识别，注入时由 injectHints 统一处理
-	pushShepherdHint(expandEnvVars(reason), label);
-}
-
-/** 生成通知气泡用的摘要（优先用规则名列表，fallback 截断 reason） */
-export function notifySummary(text: string, labels?: string[]): string {
-	// 优先使用规则名（comment）列表
-	if (labels && labels.length > 0) {
-		const joined = labels.join("、");
-		return joined.length > 120 ? joined.slice(0, 117) + "..." : joined;
-	}
-	// fallback：截取第一个 --- 之前的内容
-	const idx = text.indexOf("\n---");
-	if (idx > 0) return text.slice(0, idx);
-	if (text.length > 120) return text.slice(0, 117) + "...";
-	return text;
-}
-
-// ── 内部：shepherd 前缀推入共享缓冲区 ──
-
-import { pushHint as _pushShared, hasHints } from "./ephemeral-shared.js";
-
-const SHEPHERD_PREFIX = "⚠️ shepherd: ";
-
-function pushShepherdHint(reason: string, label?: string): void {
-	_pushShared(`${SHEPHERD_PREFIX}${reason}`, label);
-}
-
-/** 推入规则格式错误提示（加 ❌ 前缀区别于普通 warning） */
-export function pushRuleError(msg: string): void {
-	_pushShared(`❌ shepherd 规则格式错误: ${msg}`);
-}
-
-/** shepherd 是否有待发送的提示 */
-export function hasWarnings(): boolean {
-	return hasHints();
-}
+/**
+ * Shepherd 专用提示缓冲区
+ *
+ * shepherd 规则触发的 steer/notify 提示通过 pushWarning 推入，
+ * 由共享的 ephemeral 注入机制在 before_provider_request 时发送。
+ * 提示只对当前请求生效，不写入 session 历史。
+ */
+
+/** 替换 ${ENV_VAR} 格式的环境变量 */
+function expandEnvVars(text: string): string {
+	return text.replace(
+		/\$\{(\w+)\}/g,
+		(_match, name: string) => process.env[name] ?? `\${${name}}`,
+	);
+}
+
+/** 推入一条 shepherd 提示（自动加 ⚠️ shepherd: 前缀） */
+export function pushWarning(reason: string, label?: string): void {
+	// shepherd 前缀用于通知气泡识别，注入时由 injectHints 统一处理
+	pushShepherdHint(expandEnvVars(reason), label);
+}
+
+/** 生成通知气泡用的摘要（优先用规则名列表，fallback 截断 reason） */
+export function notifySummary(text: string, labels?: string[]): string {
+	// 优先使用规则名（comment）列表
+	if (labels && labels.length > 0) {
+		const joined = labels.join("、");
+		return joined.length > 120 ? `${joined.slice(0, 117)}...` : joined;
+	}
+	// fallback：截取第一个 --- 之前的内容
+	const idx = text.indexOf("\n---");
+	if (idx > 0) return text.slice(0, idx);
+	if (text.length > 120) return `${text.slice(0, 117)}...`;
+	return text;
+}
+
+// ── 内部：shepherd 前缀推入共享缓冲区 ──
+
+import { pushHint as _pushShared, hasHints } from "./ephemeral-shared.js";
+
+const SHEPHERD_PREFIX = "⚠️ shepherd: ";
+
+function pushShepherdHint(reason: string, label?: string): void {
+	_pushShared(`${SHEPHERD_PREFIX}${reason}`, label);
+}
+
+/** 推入规则格式错误提示（加 ❌ 前缀区别于普通 warning） */
+export function pushRuleError(msg: string): void {
+	_pushShared(`❌ shepherd 规则格式错误: ${msg}`);
+}
+
+/** shepherd 是否有待发送的提示 */
+export function hasWarnings(): boolean {
+	return hasHints();
+}

package/shepherd/git.ts

@@ -0,0 +1,64 @@
+import { execSync } from "node:child_process";
+
+function parseGitStatus(): { dirty: string[]; untracked: string[] } {
+	const result = { dirty: [] as string[], untracked: [] as string[] };
+	try {
+		const status = execSync("git status --porcelain", {
+			timeout: 5000,
+			stdio: ["pipe", "pipe", "pipe"],
+			cwd: process.cwd(),
+		})
+			.toString()
+			.trim();
+		if (!status) return result;
+		for (const line of status.split("\n")) {
+			if (!line) continue;
+			if (line.startsWith("??")) {
+				result.untracked.push(line);
+			} else {
+				result.dirty.push(line);
+			}
+		}
+	} catch {
+		/* not a git repo or git not available */
+	}
+	return result;
+}
+
+/** 检测 git 工作区是否有已跟踪文件的未提交改动（M/A/D/R） */
+export function isGitDirty(): boolean {
+	return parseGitStatus().dirty.length > 0;
+}
+
+/** 检测 git 工作区是否有未跟踪文件（??） */
+export function hasGitUntracked(): boolean {
+	return parseGitStatus().untracked.length > 0;
+}
+
+/** 检测 git 工作区是否有已跟踪改动或未跟踪文件 */
+export function isGitDirtyOrUntracked(): boolean {
+	const { dirty, untracked } = parseGitStatus();
+	return dirty.length > 0 || untracked.length > 0;
+}
+
+/** 向后兼容：原 hasGitUncommittedChanges 只看已跟踪文件 */
+export function hasGitUncommittedChanges(): boolean {
+	return isGitDirty();
+}
+
+/** 当前是否在 worktree 中 */
+export function isInWorktree(): boolean {
+	try {
+		const cwd = process.cwd();
+		if (/\/\.worktrees\/[^/]+/.test(cwd)) return true;
+		const gitDir = execSync("git rev-parse --git-dir", {
+			timeout: 5000,
+			stdio: ["pipe", "pipe", "pipe"],
+		})
+			.toString()
+			.trim();
+		return gitDir !== ".git";
+	} catch {
+		return false;
+	}
+}

package/shepherd/index.ts

@@ -3,6 +3,7 @@
  */
 
 export { hasWarnings, notifySummary, pushWarning } from "./ephemeral";
+export { registerSessionCompact } from "./compaction";
 export {
 	drainHints,
 	hasHints,
@@ -12,17 +13,29 @@ export {
 } from "./ephemeral-shared";
 export { checkLineCount } from "./line-count";
 export {
+	extractAssistantText,
+	registerMessageEnd,
+	resetMessageEndState,
+} from "./message-end";
+export {
+	type BuiltinContext,
 	CODE_EXT_RE,
 	type Condition,
+	type ConditionBuiltin,
 	compileRules,
 	getMatchTargets,
 	hasGitUncommittedChanges,
+	hasGitUntracked,
+	isGitDirty,
+	isGitDirtyOrUntracked,
 	isInWorktree,
 	isSubagent,
 	loadRules,
 	loadRulesFromFile,
+	matchBuiltinCondition,
 	type Rule,
 	ruleMatches,
+	toolMatches,
 } from "./rules";
 export {
 	type ResettableRule,
@@ -37,3 +50,4 @@ export {
 	toolsAvailable,
 } from "./tool-hooks";
 export { checkWorktrees } from "./worktree-check";
+export type { ToolEvent } from "./tool-event-types";

package/shepherd/line-count.ts

@@ -1,86 +1,86 @@
-/**
- * 文件行数检查
- * edit/write 后自动检测文件行数，超阈值时注入 ephemeral 提醒
- */
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { pushWarning } from "./ephemeral.js";
-
-// ── 代码文件阈值 ─────────────────────────────────────────────
-const LINE_WARN = 200;
-const LINE_MUST = 300;
-const LINE_BAN = 500;
-
-// ── 记忆文件阈值 ─────────────────────────────────────────────
-const MEMORY_LINE_LIMIT = 200;
-
-const CHECKED_EXTENSIONS = new Set([".ts", ".tsx", ".js", ".py", ".rs", ".go"]);
-
-/** 判断路径是否为记忆文件（memory/ 或 .pi/memory/ 下的 .md，排除索引文件 MEMORY.md） */
-function isMemoryFile(filePath: string): boolean {
-	if (!filePath.endsWith(".md")) return false;
-	const name = path.basename(filePath);
-	if (name === "MEMORY.md") return false;
-	const normalized = filePath.replace(/\\/g, "/");
-	return /\/memory\//.test(normalized);
-}
-
-export function checkLineCount(filePath: string): void {
-	const ext = path.extname(filePath);
-
-	// 记忆文件检查
-	if (isMemoryFile(filePath)) {
-		checkMemoryFile(filePath);
-		return;
-	}
-
-	// 代码文件检查
-	if (!CHECKED_EXTENSIONS.has(ext)) return;
-
-	let lines: number;
-	try {
-		const content = fs.readFileSync(filePath, "utf-8");
-		lines = content.split("\n").length;
-	} catch {
-		return;
-	}
-
-	const name = path.basename(filePath);
-
-	if (lines >= LINE_BAN) {
-		pushWarning(
-			`❌ 严禁: ${name} 已有 ${lines} 行（阈值 ${LINE_BAN} 行）。\n` +
-				`拆分建议：提取公共函数/工具类到独立文件，目标每个文件 ≤ 200 行。`,
-		);
-	} else if (lines >= LINE_MUST) {
-		pushWarning(
-			`🔴 必须拆分: ${name} 已有 ${lines} 行（阈值 ${LINE_MUST} 行）。\n` +
-				`拆分建议：提取公共函数/工具类到独立文件，目标每个文件 ≤ 200 行。`,
-		);
-	} else if (lines >= LINE_WARN) {
-		pushWarning(
-			`⚠️ 应主动检查: ${name} 已有 ${lines} 行（阈值 ${LINE_WARN} 行）。\n` +
-				`拆分建议：提取公共函数/工具类到独立文件，目标每个文件 ≤ 200 行。`,
-		);
-	}
-}
-
-/** 记忆文件行数检查：超过 200 行必须拆分 */
-function checkMemoryFile(filePath: string): void {
-	let lines: number;
-	try {
-		const content = fs.readFileSync(filePath, "utf-8");
-		lines = content.split("\n").length;
-	} catch {
-		return;
-	}
-
-	if (lines >= MEMORY_LINE_LIMIT) {
-		const name = path.basename(filePath);
-		pushWarning(
-			`📝 记忆文件过长: ${name} 已有 ${lines} 行（上限 ${MEMORY_LINE_LIMIT} 行）。\n` +
-				`必须拆分：每个记忆文件一个主题，拆分后用 memory_update 或手动更新 MEMORY.md 索引。`,
-		);
-	}
-}
+/**
+ * 文件行数检查
+ * edit/write 后自动检测文件行数，超阈值时注入 ephemeral 提醒
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { pushWarning } from "./ephemeral.js";
+
+// ── 代码文件阈值 ─────────────────────────────────────────────
+const LINE_WARN = 200;
+const LINE_MUST = 300;
+const LINE_BAN = 500;
+
+// ── 记忆文件阈值 ─────────────────────────────────────────────
+const MEMORY_LINE_LIMIT = 200;
+
+const CHECKED_EXTENSIONS = new Set([".ts", ".tsx", ".js", ".py", ".rs", ".go"]);
+
+/** 判断路径是否为记忆文件（memory/ 或 .pi/memory/ 下的 .md，排除索引文件 MEMORY.md） */
+function isMemoryFile(filePath: string): boolean {
+	if (!filePath.endsWith(".md")) return false;
+	const name = path.basename(filePath);
+	if (name === "MEMORY.md") return false;
+	const normalized = filePath.replace(/\\/g, "/");
+	return /\/memory\//.test(normalized);
+}
+
+export function checkLineCount(filePath: string): void {
+	const ext = path.extname(filePath);
+
+	// 记忆文件检查
+	if (isMemoryFile(filePath)) {
+		checkMemoryFile(filePath);
+		return;
+	}
+
+	// 代码文件检查
+	if (!CHECKED_EXTENSIONS.has(ext)) return;
+
+	let lines: number;
+	try {
+		const content = fs.readFileSync(filePath, "utf-8");
+		lines = content.split("\n").length;
+	} catch {
+		return;
+	}
+
+	const name = path.basename(filePath);
+
+	if (lines >= LINE_BAN) {
+		pushWarning(
+			`❌ 严禁: ${name} 已有 ${lines} 行（阈值 ${LINE_BAN} 行）。\n` +
+				`拆分建议：提取公共函数/工具类到独立文件，目标每个文件 ≤ 200 行。`,
+		);
+	} else if (lines >= LINE_MUST) {
+		pushWarning(
+			`🔴 必须拆分: ${name} 已有 ${lines} 行（阈值 ${LINE_MUST} 行）。\n` +
+				`拆分建议：提取公共函数/工具类到独立文件，目标每个文件 ≤ 200 行。`,
+		);
+	} else if (lines >= LINE_WARN) {
+		pushWarning(
+			`⚠️ 应主动检查: ${name} 已有 ${lines} 行（阈值 ${LINE_WARN} 行）。\n` +
+				`拆分建议：提取公共函数/工具类到独立文件，目标每个文件 ≤ 200 行。`,
+		);
+	}
+}
+
+/** 记忆文件行数检查：超过 200 行必须拆分 */
+function checkMemoryFile(filePath: string): void {
+	let lines: number;
+	try {
+		const content = fs.readFileSync(filePath, "utf-8");
+		lines = content.split("\n").length;
+	} catch {
+		return;
+	}
+
+	if (lines >= MEMORY_LINE_LIMIT) {
+		const name = path.basename(filePath);
+		pushWarning(
+			`📝 记忆文件过长: ${name} 已有 ${lines} 行（上限 ${MEMORY_LINE_LIMIT} 行）。\n` +
+				`必须拆分：每个记忆文件一个主题，拆分后用 memory_update 或手动更新 MEMORY.md 索引。`,
+		);
+	}
+}

package/shepherd/message-end.ts

@@ -0,0 +1,120 @@
+/**
+ * message_end hook 处理逻辑
+ *
+ * 在 AI 助手回复完成后，对回复文本进行正则匹配，
+ * 触发 notify（弹通知）或 steer（注入下一轮）。
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { pushWarning } from "./ephemeral.js";
+import {
+	isSubagent,
+	type LoadRulesOptions,
+	loadRules,
+	ruleMatches,
+} from "./rules.js";
+import type { ToolState } from "./tool-hooks.js";
+import { toolsAvailable } from "./tool-hooks.js";
+
+// ── 文本提取 ──────────────────────────────────────────────────
+
+/** assistant 消息中的 content block 类型 */
+interface TextBlock {
+	type: "text";
+	text: string;
+}
+
+/**
+ * 从 assistant 消息中提取所有文本 content blocks 并拼接。
+ * 安全处理 null/undefined/非数组 content。
+ */
+export function extractAssistantText(
+	message: { role: string; content?: unknown } | null | undefined,
+): string {
+	if (!message?.content || !Array.isArray(message.content)) return "";
+	return (message.content as Array<unknown>)
+		.filter(
+			(block): block is TextBlock =>
+				!!block &&
+				typeof block === "object" &&
+				(block as any).type === "text" &&
+				typeof (block as any).text === "string",
+		)
+		.map((block) => block.text)
+		.join("\n");
+}
+
+// ── message_end hook 注册 ─────────────────────────────────────
+
+/** 防重复触发的 rule comment 集合 */
+const _messageEndFired = new Set<string>();
+
+/** 重置防重复标记（agent_start 时调用） */
+export function resetMessageEndState(): void {
+	_messageEndFired.clear();
+}
+
+/** 注册 message_end hook */
+export function registerMessageEnd(
+	pi: ExtensionAPI,
+	state: ToolState,
+	rulesDir?: string,
+	rulesOptions?: LoadRulesOptions,
+): void {
+	pi.on("message_end", async (event, _ctx) => {
+		// 只处理 assistant 消息
+		const message = event.message;
+		if (!message || (message as any).role !== "assistant") return;
+
+		const rules = loadRules(rulesDir, rulesOptions).filter(
+			(r) => r.hook === "message_end",
+		);
+		if (rules.length === 0) return;
+
+		// 提取 AI 回复的纯文本
+		const text = extractAssistantText(message as any);
+		if (!text) return;
+
+		// 构造匹配目标：只有 text 字段
+		const targets = { text, path: "", command: "", glob: "" };
+
+		for (const rule of rules) {
+			// 跳过禁用规则
+			if (rule.enabled === false) continue;
+			// 子代理控制
+			if (isSubagent() && rule.subagent === false) continue;
+			// 工具依赖检查
+			if (!toolsAvailable(rule, pi, state)) continue;
+			// 防重复触发
+			if (_messageEndFired.has(rule.comment)) continue;
+
+			// 条件匹配
+			if (rule.conditions && rule.conditions.length > 0) {
+				if (!ruleMatches(rule, targets, undefined, "")) continue;
+			} else if (rule.pattern) {
+				// 单条件模式：pattern 匹配 text
+				const re = rule._compiled ?? new RegExp(rule.pattern, rule.flags || "");
+				if (!re.test(text)) continue;
+			} else {
+				// 无条件：无条件匹配（总是触发）
+			}
+
+			// 标记已触发
+			_messageEndFired.add(rule.comment);
+
+			// 执行 action
+			if (rule.action === "steer") {
+				pushWarning(rule.reason, rule.comment);
+			} else if (rule.action === "notify" || !rule.action) {
+				pushWarning(rule.reason, rule.comment);
+			}
+		}
+
+		// 不再在此处发送 sendMessage(triggerTurn)。
+		// agent_end 会统一检查 hasWarnings() 并发送唯一的 triggerTurn，
+		// 避免 message_end 和 agent_end 各发一个 sendMessage 导致第二个 drainHints 空 → 空回复。
+		//
+		// 时序：message_end → turn_end → agent_end
+		// message_end 推入的 warning 会在 agent_end 的 sendMessage 触发后被 drainHints 消费。
+	});
+}