oma-coding-agent 1.2.0 → 1.2.3

package/examples/extensions/README.md

@@ -50,6 +50,7 @@ cp permission-gate.ts ~/.omp/agent/extensions/
 | ------------------------ | ------------------------------------------------------------------------- |
 | `git-checkpoint.ts`      | Creates git stash checkpoints at each turn for code restoration on branch |
 | `auto-commit-on-exit.ts` | Auto-commits on exit using last assistant message for commit message      |
+| `handoff-doc.ts`         | Auto code review on commit + handoff doc on push via tool_result           |
 
 ### System Prompt & Compaction
 

package/examples/extensions/git-workflow.ts

@@ -0,0 +1,69 @@
+/**
+ * Git Workflow Extension
+ *
+ * 在 git commit/push 成功后，自动注入代码审查和交接文档指令。
+ * 通过 tool_result 事件拦截 bash 工具的输出，追加上下文指令。
+ *
+ * - git commit 成功 → 追加代码审查指令
+ * - git push 成功 → 追加交接文档指令
+ *
+ * Usage:
+ *   omp --extension examples/extensions/git-workflow.ts
+ */
+import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	pi.on("tool_result", async (event) => {
+		if (event.toolName !== "bash") return;
+		if (event.isError) return;
+
+		// 从 input 中获取原始命令
+		const command = (event.input as { command?: string }).command;
+		if (!command) return;
+
+		// 获取当前输出文本
+		const outputText = event.content
+			.filter((c): c is { type: "text"; text: string } => c.type === "text")
+			.map((c) => c.text)
+			.join("");
+
+		// git commit 成功 → 追加代码审查指令
+		if (/^git\s+commit\b/.test(command) && outputText.includes("[main")) {
+			return {
+				content: [
+					...event.content,
+					{
+						type: "text" as const,
+						text: [
+							"",
+							"---",
+							"📋 代码审查提醒：请在 push 前审查本次 commit 的变更。",
+							"使用 git diff HEAD~1 查看变更，确认无问题后再 push。",
+							"如有交接文档需求，请在 push 后自动完成。",
+						].join("\n"),
+					},
+				],
+			};
+		}
+
+		// git push 成功 → 追加交接文档指令
+		if (/^git\s+push\b/.test(command) && outputText.includes("..")) {
+			return {
+				content: [
+					...event.content,
+					{
+						type: "text" as const,
+						text: [
+							"",
+							"---",
+							"📝 交接文档提醒：请写交接文档到 OpenSpec/handoffs/ 目录下。",
+							"文件名格式：handoff-YYYY-MM-DD.md",
+							"内容包含：本次完成的工作内容、修改/创建的文件列表、关键技术决策、未完成的工作、下次继续时需要的上下文。",
+							"使用 write 工具直接写入文件。",
+						].join("\n"),
+					},
+				],
+			};
+		}
+	});
+}

package/examples/extensions/handoff-doc.ts

@@ -0,0 +1,103 @@
+/**
+ * Handoff Document Extension (Git-triggered)
+ *
+ * 通过 git 操作触发代码审查和交接文档生成：
+ * - git commit → 每次新 commit block 要求审查；LLM 重试时放行；成功后重置
+ * - git push   → 成功后追加交接文档提示（仅首次）
+ *
+ * 状态机：
+ *   新 commit → block(reviewJustDone=true) → LLM 重试 → 放行(clear) →
+ *   新 commit → block(reviewJustDone=true) → LLM 重试 → 放行(clear) → ...
+ *
+ * Usage:
+ *   omp --extension examples/extensions/handoff-doc.ts
+ */
+import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
+
+const HANDOFF_PROMPT_ADDED = "[handoff-doc:prompt-added]";
+
+export default function (pi: ExtensionAPI) {
+	// commit 审查状态：刚完成审查时允许下一个 commit 通过
+	let reviewJustDone = false;
+
+	pi.on("tool_call", async event => {
+		if (event.toolName !== "bash") return;
+
+		const input = event.input;
+		if (!input || typeof input !== "object" || !("command" in input)) return;
+		const command = String(input.command);
+
+		if (!/^git\s+commit\b/.test(command)) return;
+
+		// 审查后重试 → 放行，然后重置（下次新 commit 需要重新审查）
+		if (reviewJustDone) {
+			reviewJustDone = false;
+			return;
+		}
+
+		// 新 commit → block 要求审查
+		reviewJustDone = true;
+		return {
+			block: true,
+			reason: [
+				"请先审查本次暂存区的变更，确认无问题后再 commit。",
+				"运行 git diff --cached 查看变更内容。",
+			].join("\n"),
+		};
+	});
+
+	// commit 成功后重置审查状态（确保下次新 commit 重新审查）
+	// push 后写交接文档（仅首次）
+	let pushHandoffTriggered = false;
+
+	pi.on("tool_result", async event => {
+		if (event.toolName !== "bash") return;
+
+		const input = event.input;
+		if (!input || typeof input !== "object" || !("command" in input)) return;
+		const command = String(input.command);
+
+		const existingText = event.content
+			.filter((c): c is { type: "text"; text: string } => c.type === "text")
+			.map(c => c.text)
+			.join("\n");
+
+		if (existingText.includes(HANDOFF_PROMPT_ADDED)) return;
+
+		if (event.isError) return;
+		const { details } = event;
+		if (details?.exitCode !== undefined && details.exitCode !== 0) return;
+
+		// commit 成功 → 重置审查状态
+		if (/^git\s+commit\b/.test(command)) {
+			reviewJustDone = false;
+		}
+
+		// push 成功 → 提示写交接文档（仅首次）
+		if (/^git\s+push\b/.test(command) && !pushHandoffTriggered) {
+			pushHandoffTriggered = true;
+			return {
+				content: [
+					...event.content,
+					{
+						type: "text" as const,
+						text: [
+							HANDOFF_PROMPT_ADDED,
+							"",
+							"代码已推送成功。请将本次工作的交接文档写到 OpenSpec/handoffs/ 目录下，文件名格式 handoff-YYYY-MM-DD.md。",
+							"",
+							"交接文档应包含：",
+							"1. 本次完成的工作内容",
+							"2. 修改/创建的文件列表",
+							"3. 关键技术决策",
+							"4. 未完成的工作",
+							"5. 下次继续时需要的上下文",
+							"",
+							"使用 write 工具直接写入文件。",
+						].join("\n"),
+					},
+				],
+			};
+		}
+	});
+}

package/examples/hooks/README.md

@@ -28,7 +28,6 @@ cp permission-gate.ts ~/.omp/agent/hooks/
 | `snake.ts`               | Snake game with custom UI, keyboard handling, and session persistence          |
 | `status-line.ts`         | Shows turn progress in footer via `ctx.ui.setStatus()` with themed colors      |
 | `handoff.ts`             | Transfer context to a new focused session via `/handoff <goal>`                |
-
 ## Writing Hooks
 
 See [docs/hooks.md](../../docs/hooks.md) for full documentation.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "oma-coding-agent",
-	"version": "1.2.0",
+	"version": "1.2.3",
 	"description": "AI coding agent optimized for low-end models (MiMo, DeepSeek, GLM, Qwen, Kimi)",
 	"homepage": "https://github.com/wangneal/my-agent",
 	"author": "wangneal",