@michaelxwb/code-flow 0.5.1

package/src/adapters/opencode/commands/cf-validate.md

@@ -0,0 +1,77 @@
+---
+description: 根据变更文件自动匹配并执行验证规则
+---
+
+# cf-validate
+
+根据变更文件自动匹配并执行验证规则（测试、类型检查、lint），失败时自动尝试修复。
+
+## 输入
+
+- `/project:cf-validate` — 基于 git diff 自动获取变更文件
+- `/project:cf-validate src/Foo.tsx` — 验证指定文件
+- `/project:cf-validate --files=src/a.ts,src/b.ts` — 验证多个文件
+
+## 执行步骤
+
+### 1. 获取变更文件列表
+
+用 Bash 执行：
+
+```bash
+git diff --name-only HEAD
+```
+
+如果用户指定了文件路径，使用用户指定的文件。如果无变更文件，输出"无变更需要验证"。
+
+### 2. 读取验证规则
+
+用 Read 读取 `.code-flow/validation.yml`。如果不存在，尝试读取 `package.json` 中的 `scripts.test` 和 `scripts.lint` 作为回退。
+
+validation.yml 格式：
+
+```yaml
+validators:
+  - name: "验证器名称"
+    trigger: "**/*.{ts,tsx}"
+    command: "npx tsc --noEmit"
+    timeout: 30000
+    on_fail: "修复建议"
+```
+
+### 3. 匹配并执行验证
+
+对每条验证规则：
+- 将 `trigger` glob 与变更文件列表做匹配
+- 匹配到 → 用 Bash 执行 `command`
+  - 如果 command 包含 `{files}` → 替换为匹配到的文件路径列表，**每个路径用单引号包裹**（如 `'src/foo.ts' 'src/bar.ts'`）
+  - 如果 command 不含 `{files}` → 直接执行原命令（如 `npx tsc --noEmit` 本身就检查全局）
+- 未匹配 → 跳过该规则
+
+每条命令使用对应的 `timeout` 值（毫秒）。
+
+### 4. 汇总结果
+
+- **全部通过** → 输出确认信息
+- **有失败** → 展示每个失败项的：
+  - 验证器名称
+  - 执行的命令
+  - 错误输出（截取关键部分）
+  - `on_fail` 修复建议
+
+### 5. 自动修复
+
+对于失败的验证项，根据错误输出分析问题根因，自动尝试修复代码。修复后提示用户再次运行 `/project:cf-validate` 确认。
+
+## 安全设计
+
+- 对 `{files}` 中的每个文件路径用单引号包裹，防止 shell 注入
+- 仅接受 `git diff` 输出的文件路径或用户显式指定的路径
+- 用户指定的路径必须位于项目根目录内
+
+## 异常处理
+
+- validation.yml 不存在 → 尝试检测 package.json scripts 中的 test/lint 命令
+- 命令执行超时 → 输出超时提示，建议增大 timeout 或缩小验证范围
+- 命令不存在 → 提示安装依赖（如 `pip install mypy`）
+- 无变更文件 → 输出"无变更需要验证"

package/src/adapters/opencode/opencode.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [".opencode/plugins/code-flow"]
+}

package/src/adapters/opencode/plugins/code-flow/index.js

@@ -0,0 +1,132 @@
+import { spawnSync } from "child_process";
+import { join } from "path";
+import { appendFileSync, mkdirSync } from "fs";
+
+const SCRIPT_DIR = ".code-flow/scripts";
+
+// Per-session cache of spec context to inject into system prompt
+const sessionContext = new Map();
+
+function debugLog(projectRoot, msg) {
+  if (process.env.CF_DEBUG !== "1") return;
+  try {
+    const dir = join(projectRoot, ".code-flow");
+    mkdirSync(dir, { recursive: true });
+    const ts = new Date().toISOString().replace("T", " ").slice(0, 19);
+    appendFileSync(join(dir, ".debug.log"), `${ts} [opencode] ${msg}\n`);
+  } catch {}
+}
+
+function pythonPath(projectRoot, script) {
+  return join(projectRoot, SCRIPT_DIR, script);
+}
+
+function callHook(projectRoot, script, input) {
+  try {
+    const proc = spawnSync("python3", [pythonPath(projectRoot, script)], {
+      cwd: projectRoot,
+      input: JSON.stringify(input),
+      encoding: "utf-8",
+      timeout: 5000,
+      maxBuffer: 1024 * 1024,
+    });
+    if (proc.error || proc.status !== 0) {
+      debugLog(projectRoot, `callHook ${script} failed: ${proc.error || proc.stderr}`);
+      return null;
+    }
+    const stdout = (proc.stdout || "").trim();
+    if (!stdout) return null;
+    return JSON.parse(stdout);
+  } catch (e) {
+    debugLog(projectRoot, `callHook ${script} exception: ${e.message}`);
+    return null;
+  }
+}
+
+function extractPromptText(output) {
+  if (!output.parts) return "";
+  return output.parts
+    .filter((p) => p.type === "text" && !p.synthetic && !p.ignored)
+    .map((p) => p.text)
+    .join("\n");
+}
+
+export const CodeFlow = async (ctx) => {
+  const projectRoot = ctx.directory;
+
+  return {
+    event: async (input) => {
+      if (input.event?.type === "session.created") {
+        const sid = input.event?.properties?.info?.id || "";
+        debugLog(projectRoot, `session.created sid=${sid}`);
+        if (sid) sessionContext.delete(sid);
+        callHook(projectRoot, "cf_session_hook.py", { session_id: sid });
+      }
+      if (input.event?.type === "session.idle") {
+        const sid =
+          input.event?.properties?.sessionID ||
+          input.event?.properties?.info?.id || "";
+        const result = callHook(projectRoot, "cf_stop_hook.py", { session_id: sid });
+        if (result?.reason) {
+          // idle 无法阻断，校验失败排队到下一轮 system prompt
+          const pending = sessionContext.get(sid);
+          sessionContext.set(sid, pending ? pending + "\n\n" + result.reason : result.reason);
+          debugLog(projectRoot, `stop-check feedback queued`);
+        }
+      }
+    },
+
+    "chat.message": async (input, output) => {
+      const promptText = extractPromptText(output);
+      if (!promptText) return;
+
+      debugLog(projectRoot, `chat.message sid=${input.sessionID} prompt_len=${promptText.length}`);
+
+      const result = callHook(projectRoot, "cf_user_prompt_hook.py", {
+        prompt: promptText,
+        session_id: input.sessionID,
+      });
+
+      if (result?.hookSpecificOutput?.additionalContext) {
+        const ctxLen = result.hookSpecificOutput.additionalContext.length;
+        debugLog(projectRoot, `hook matched — context ${ctxLen} chars cached`);
+        sessionContext.set(
+          input.sessionID,
+          result.hookSpecificOutput.additionalContext
+        );
+      } else {
+        debugLog(projectRoot, `hook returned no context`);
+      }
+    },
+
+    "tool.execute.after": async (input, output) => {
+      const tool = String(input?.tool || "").toLowerCase();
+      if (!["edit", "write", "multiedit", "patch"].includes(tool)) return;
+      const args = output?.args || input?.args || {};
+      const filePath = args.filePath || args.file_path || args.path;
+      if (!filePath) return;
+      const result = callHook(projectRoot, "cf_post_hook.py", {
+        tool_name: tool === "write" ? "Write" : "Edit",
+        tool_input: { file_path: filePath },
+        session_id: input?.sessionID || "",
+      });
+      const ctx = result?.hookSpecificOutput?.additionalContext;
+      if (ctx) {
+        // 反馈排队，下一轮 system.transform 注入（opencode 无法当轮插话）
+        const sid = input?.sessionID || "";
+        const pending = sessionContext.get(sid);
+        sessionContext.set(sid, pending ? pending + "\n\n" + ctx : ctx);
+        debugLog(projectRoot, `post-check feedback queued ${ctx.length} chars`);
+      }
+    },
+
+    "experimental.chat.system.transform": async (input, output) => {
+      const ctx = sessionContext.get(input.sessionID);
+      if (ctx) {
+        output.system.push(ctx);
+        debugLog(projectRoot, `system.transform — injected ${ctx.length} chars, system now ${output.system.length} parts`);
+        sessionContext.delete(input.sessionID);
+      }
+    },
+  };
+};

package/src/adapters/opencode/plugins/code-flow/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "code-flow-opencode",
+  "type": "module",
+  "main": "index.js",
+  "description": "code-flow spec injection plugin for OpenCode"
+}