@michaelxwb/code-flow 0.6.5 → 1.0.0

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

@@ -1,79 +0,0 @@
----
-description: 根据变更文件自动匹配并执行验证规则
----
-
-# cf-validate
-
-根据变更文件自动匹配并执行验证规则（测试、类型检查、lint），失败时自动尝试修复。
-
-## 输入
-
-- `/project:cf-validate` — 自动获取任务基线或 Git 全部变更文件
-- `/project:cf-validate src/Foo.tsx` — 验证指定文件
-- `/project:cf-validate --files=src/a.ts,src/b.ts` — 验证多个文件
-
-## 执行步骤
-
-### 1. 获取变更文件列表
-
-用 Bash 执行：
-
-```bash
-python3 .code-flow/scripts/cf_validation.py --root "$PWD" --scope-only --json
-```
-
-有 active TASK 时使用冻结基线以来的全部任务变更（含已提交文件）；无 active TASK 时包含暂存、未暂存和未跟踪文件。用户指定路径时用 `--files "src/a.py" "src/b.py"` 原样传递；若结果确实为空才输出“无变更需要验证”。
-
-### 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
-    heavy: false          # true = Stop 每轮跳过，finish 与 /cf-validate 执行
-    on_fail: "修复建议"
-```
-
-全量测试 / e2e 等慢命令标 `heavy: true`：Stop 每轮跳过，**任务 finish 自动执行一次**，也可显式运行 `/cf-validate`（或 CI），避免拖慢每个任务。
-
-### 3. 匹配并执行验证
-
-执行统一验证入口：
-
-```bash
-python3 .code-flow/scripts/cf_validation.py --root "$PWD" --json
-```
-
-显式范围追加 `--files "src/a.py" "src/b.py"`。程序匹配 trigger、解析 argv 并展开 `{files}`，不拼接 shell 命令；同一运行内相同 argv/cwd/timeout 去重，跨运行不复用。删除文件仍触发全局测试，但不传给文件级编译器。每条 timeout 仍按配置的毫秒值生效，总预算耗尽返回 incomplete/block。
-
-### 4. 汇总结果
-
-- **全部通过** → 输出确认信息
-- **有失败** → 展示每个失败项的：
-  - 验证器名称
-  - 执行的命令
-  - 错误输出（截取关键部分）
-  - `on_fail` 修复建议
-
-### 5. 自动修复
-
-对于失败的验证项，根据错误输出分析问题根因，自动尝试修复代码。修复后提示用户再次运行 `/project:cf-validate` 确认。
-
-## 安全设计
-
-- `{files}` 直接展开为 argv 参数；带空格、引号的路径仍是一个参数，不手工拼接引号或执行 shell
-- 范围来自任务基线、Git 状态（包括 untracked）或用户显式指定的路径
-- 用户指定的路径必须位于项目根目录内
-
-## 异常处理
-
-- validation.yml 不存在 → 尝试检测 package.json scripts 中的 test/lint 命令
-- 命令执行超时 → 输出超时提示，建议增大 timeout 或缩小验证范围
-- 命令不存在或配置无效 → 返回 block 并提示所缺依赖，不当作验证通过
-- 无变更文件 → 输出"无变更需要验证"

package/src/adapters/opencode/opencode.json

@@ -1,3 +0,0 @@
-{
-  "$schema": "https://opencode.ai/config.json"
-}

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

@@ -1,213 +0,0 @@
-import { execFile } from "child_process";
-import { join } from "path";
-import { appendFileSync, mkdirSync } from "fs";
-
-// Note: intentionally no `import { Plugin } from "@opencode/plugin"`.
-// The server does not auto-provide that package for local plugins, and
-// `Plugin.define` is only an identity wrapper — a plain default export
-// with `id` + `setup` satisfies the v2 plugin schema dependency-free,
-// so `code-flow init` works offline without npm install.
-
-const SCRIPT_DIR = ".code-flow/scripts";
-const STOP_CHECK_TIMEOUT = 35000;
-const HOOK_TIMEOUT = 5000;
-
-// Per-session queued feedback. Single map, append-only: idle/stop-check and
-// post-check feedback accumulate here and are consumed by the next context
-// hook. Never overwrite — a prompt hook arriving between idle and context
-// must not drop queued stop-check feedback.
-const sessionContext = new Map();
-
-export function mergePending(existing, incoming) {
-  if (!existing) return incoming;
-  if (!incoming) return existing;
-  return existing + "\n\n" + incoming;
-}
-
-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, timeout = HOOK_TIMEOUT) {
-  // Async child process: never block the plugin event thread. opencode's
-  // idle event cannot interrupt a turn, so stop-check failures queue into
-  // sessionContext for the next context hook (documented platform gap
-  // vs. blocking Stop hooks).
-  return new Promise((resolve) => {
-    const child = execFile(
-      "python3",
-      [pythonPath(projectRoot, script)],
-      { cwd: projectRoot, timeout, maxBuffer: 1024 * 1024 },
-      (error, stdout, stderr) => {
-        if (error) {
-          debugLog(projectRoot, `callHook ${script} failed: ${error.message || stderr}`);
-          resolve(null);
-          return;
-        }
-        const text = (stdout || "").trim();
-        if (!text) {
-          resolve(null);
-          return;
-        }
-        try {
-          resolve(JSON.parse(text));
-        } catch (e) {
-          debugLog(projectRoot, `callHook ${script} bad JSON: ${e.message}`);
-          resolve(null);
-        }
-      }
-    );
-    if (input !== undefined && child.stdin) {
-      child.stdin.write(JSON.stringify(input));
-      child.stdin.end();
-    }
-  });
-}
-
-function queueFeedback(sessionID, text) {
-  if (!sessionID || !text) return;
-  sessionContext.set(sessionID, mergePending(sessionContext.get(sessionID), text));
-}
-
-function consumeFeedback(sessionID) {
-  const pending = sessionContext.get(sessionID);
-  if (pending) sessionContext.delete(sessionID);
-  return pending;
-}
-
-function toolInputFilePath(input) {
-  if (!input || typeof input !== "object") return "";
-  const args = input;
-  return args.filePath || args.file_path || args.path || "";
-}
-
-async function runStopCheck(projectRoot, sessionID) {
-  const result = await callHook(projectRoot, "cf_stop_hook.py", { session_id: sessionID }, STOP_CHECK_TIMEOUT);
-  if (result?.reason) {
-    // idle 无法阻断，校验失败排队到下一轮 context hook
-    queueFeedback(sessionID, result.reason);
-    debugLog(projectRoot, `stop-check feedback queued`);
-  }
-}
-
-async function registerPromptHook(ctx, projectRoot) {
-  await ctx.session.hook("prompt", async (event) => {
-    const promptText = event.prompt?.text || "";
-    if (!promptText) return;
-    debugLog(projectRoot, `prompt sid=${event.sessionID} prompt_len=${promptText.length}`);
-    const result = await callHook(projectRoot, "cf_user_prompt_hook.py", {
-      prompt: promptText,
-      session_id: event.sessionID,
-    });
-    const additional = result?.hookSpecificOutput?.additionalContext;
-    if (additional) {
-      // Append, never overwrite: queued stop-check feedback survives.
-      queueFeedback(event.sessionID, additional);
-      debugLog(projectRoot, `hook matched — context ${additional.length} chars cached`);
-    } else {
-      debugLog(projectRoot, `hook returned no context`);
-    }
-  });
-}
-
-async function registerToolHook(ctx, projectRoot) {
-  await ctx.tool.hook("execute.after", async (event) => {
-    const tool = String(event.tool || "").toLowerCase();
-    if (!["edit", "write", "multiedit", "patch"].includes(tool)) return;
-    const filePath = toolInputFilePath(event.input);
-    if (!filePath) return;
-    const result = await callHook(projectRoot, "cf_post_hook.py", {
-      tool_name: tool === "write" ? "Write" : "Edit",
-      tool_input: { file_path: filePath },
-      session_id: event.sessionID || "",
-    });
-    const additional = result?.hookSpecificOutput?.additionalContext;
-    if (additional) {
-      // 反馈排队，下一轮 context hook 注入（opencode 无法当轮插话）
-      queueFeedback(event.sessionID, additional);
-      debugLog(projectRoot, `post-check feedback queued ${additional.length} chars`);
-    }
-  });
-}
-
-async function registerContextHook(ctx) {
-  await ctx.session.hook("context", (event) => {
-    const pending = consumeFeedback(event.sessionID);
-    if (pending) {
-      event.system.push({ type: "text", text: pending });
-      debugLog(ctx.location.directory, `context — injected ${pending.length} chars`);
-    }
-  });
-}
-
-// 子会话（子 agent / worktree 并行任务）的 idle 不得触发主工作区 stop-check：
-// 子会话的编辑发生在自己的工作区，主区既无 active marker 也没有对应文件，
-// 触发只会重复执行主区 validators（全量测试）。用 session.created.parentID 标记子会话。
-export function createSessionRegistry() {
-  const children = new Set();
-  return {
-    observe(event) {
-      if (!event || typeof event.type !== "string") return null;
-      const sid = event.data?.sessionID || "";
-      if (!sid) return null;
-      if (event.type === "session.created") {
-        if (event.data?.parentID) children.add(sid);
-        return { type: "created", sid };
-      }
-      if (event.type === "session.idle") {
-        return { type: "idle", sid, child: children.has(sid) };
-      }
-      return null;
-    },
-  };
-}
-
-function startEventSubscription(ctx, projectRoot) {
-  const controller = new AbortController();
-  const registry = createSessionRegistry();
-  void (async () => {
-    try {
-      for await (const event of ctx.event.subscribe({ signal: controller.signal })) {
-        const observed = registry.observe(event);
-        if (!observed) continue;
-        if (observed.type === "created") {
-          debugLog(projectRoot, `session.created sid=${observed.sid}`);
-          sessionContext.delete(observed.sid);
-        } else if (observed.child) {
-          debugLog(projectRoot, `session.idle sid=${observed.sid} (child) — stop-check skipped`);
-        } else {
-          await runStopCheck(projectRoot, observed.sid);
-        }
-      }
-    } catch (err) {
-      if (err?.name !== "AbortError") {
-        debugLog(projectRoot, `event subscription ended: ${err?.message || err}`);
-      }
-    }
-  })();
-  return () => controller.abort();
-}
-
-const CodeFlowPlugin = {
-  id: "code-flow",
-  async setup(ctx) {
-    const projectRoot = ctx.location.directory;
-    await registerPromptHook(ctx, projectRoot);
-    await registerToolHook(ctx, projectRoot);
-    await registerContextHook(ctx);
-    const stopSubscription = startEventSubscription(ctx, projectRoot);
-    return () => stopSubscription();
-  },
-};
-
-export default CodeFlowPlugin;

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

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