@roarpeng/graphflow 1.9.4 → 1.9.12

package/dist/integrations/claude-code-hooks.js

@@ -0,0 +1,321 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLAUDE_HOME_ENV = exports.SESSION_HOOK_SCRIPT = void 0;
+exports.shellQuote = shellQuote;
+exports.resolveClaudeHome = resolveClaudeHome;
+exports.settingsReferenceHookScript = settingsReferenceHookScript;
+exports.getClaudeCodeHooksStatus = getClaudeCodeHooksStatus;
+exports.buildSessionHookScript = buildSessionHookScript;
+exports.buildClaudeCodeHooksConfig = buildClaudeCodeHooksConfig;
+exports.installClaudeCodeHooks = installClaudeCodeHooks;
+exports.uninstallClaudeCodeHooks = uninstallClaudeCodeHooks;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+/**
+ * claude-code-hooks.ts — Claude Code hooks 配置生成器（P0-2）
+ *
+ * 生成 ~/.claude/settings.json 风格的 hooks 片段（SessionStart / SessionEnd / Stop），
+ * 自动调用 graphflow CLI 记录 outcome/episode，让学习飞轮无需宿主 agent 主动调用
+ * graphflow_report_outcome 也能自动闭环（配套的 auto-capture 默认开启，
+ * 可通过 GRAPHFLOW_AUTO_CAPTURE=0 显式关闭）：
+ *
+ * 1. SessionStart → 初始化会话日志目录（不写图）。
+ * 2. SessionEnd / Stop → 读取 src/hooks/auto-capture.ts 写入的最新 pending episode
+ *    日志条目，调用 `graphflow outcome report <episodeId> <success>` 回填真实结局
+ *    （回填后触发 updateEpisodeOutcome + applySkillLearning，与手动 report_outcome 等价）。
+ *
+ * 安全：所有嵌入脚本的路径/命令均做 shell 转义（单引号包裹 + 双引号内 fallback 转义），
+ * 由 installClaudeCodeHooks 写盘；合并 settings.json 时绝不覆盖用户已有 hooks 配置。
+ */
+exports.SESSION_HOOK_SCRIPT = "session.sh";
+const JOURNAL_RELATIVE = ".graphflow/session-journal.jsonl";
+/** Test/override: when set, treat this directory as Claude Code home (`~/.claude`). */
+exports.CLAUDE_HOME_ENV = "GRAPHFLOW_CLAUDE_HOME";
+/** 单引号包裹的 shell 安全参数：路径/命令可含空格、单引号等字符。 */
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+/** 双引号赋值内 fallback 值的转义：\\ $ ` " 需反斜杠转义。 */
+function shellFallback(value) {
+    return value.replace(/([\\$`"])/g, "\\$1");
+}
+/** Resolve Claude Code home (`~/.claude`), honoring GRAPHFLOW_CLAUDE_HOME for tests. */
+function resolveClaudeHome(env = process.env) {
+    const override = env[exports.CLAUDE_HOME_ENV]?.trim();
+    if (override)
+        return override;
+    return (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude");
+}
+/** Normalize path separators for cross-platform substring checks. */
+function normalizePathForMatch(value) {
+    return value.replace(/\\/g, "/").toLowerCase();
+}
+/**
+ * True when settings.json references our session hook script.
+ * Parses JSON when possible so Windows paths survive JSON backslash escaping
+ * (`C:\\Users\\...` in file vs `C:\Users\...` in path.join).
+ */
+function settingsReferenceHookScript(raw, scriptPath) {
+    const needle = normalizePathForMatch(scriptPath);
+    if (!needle)
+        return false;
+    try {
+        const parsed = JSON.parse(raw);
+        const hooks = parsed.hooks;
+        if (hooks && typeof hooks === "object") {
+            for (const entries of Object.values(hooks)) {
+                if (!Array.isArray(entries))
+                    continue;
+                for (const entry of entries) {
+                    const command = entry && typeof entry === "object" && typeof entry.command === "string"
+                        ? entry.command
+                        : "";
+                    if (command && normalizePathForMatch(command).includes(needle)) {
+                        return true;
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // Fall through to raw substring checks for partially written files.
+    }
+    const quoted = shellQuote(scriptPath);
+    const jsonEscaped = scriptPath.replace(/\\/g, "\\\\");
+    return (raw.includes(scriptPath) ||
+        raw.includes(quoted) ||
+        raw.includes(jsonEscaped) ||
+        raw.includes(shellQuote(jsonEscaped)) ||
+        normalizePathForMatch(raw).includes(needle));
+}
+function defaultHooksDir(claudeHome) {
+    return (0, node_path_1.join)(claudeHome ?? resolveClaudeHome(), "graphflow-hooks");
+}
+function defaultSettingsPath(claudeHome) {
+    return (0, node_path_1.join)(claudeHome ?? resolveClaudeHome(), "settings.json");
+}
+/**
+ * Doctor/install status for Claude Code flywheel hooks.
+ * Detected when Claude Code home exists; installed when settings.json references
+ * our session script and the script file is on disk.
+ */
+function getClaudeCodeHooksStatus(options = {}) {
+    const claudeHome = options.claudeHome ?? resolveClaudeHome();
+    const settingsPath = options.settingsPath ?? defaultSettingsPath(claudeHome);
+    const hooksDir = options.hooksDir ?? defaultHooksDir(claudeHome);
+    const scriptPath = (0, node_path_1.join)(hooksDir, exports.SESSION_HOOK_SCRIPT);
+    const detected = (0, node_fs_1.existsSync)(claudeHome);
+    let installed = false;
+    if (detected && (0, node_fs_1.existsSync)(scriptPath) && (0, node_fs_1.existsSync)(settingsPath)) {
+        try {
+            const raw = (0, node_fs_1.readFileSync)(settingsPath, "utf8");
+            installed = settingsReferenceHookScript(raw, scriptPath);
+        }
+        catch {
+            installed = false;
+        }
+    }
+    return {
+        agent: "Claude Code hooks",
+        claudeHome,
+        settingsPath,
+        hooksDir,
+        scriptPath,
+        detected,
+        installed,
+    };
+}
+/**
+ * 生成会话 hook 脚本内容（bash）。`start` 仅准备目录；`end` 解析会话日志中
+ * 最新一条 pending episode 并调用 graphflow CLI 回填（成功默认 true，可传参数覆盖）。
+ * 所有嵌入路径均做 shell 转义；失败静默（exit 0），绝不阻塞 Claude Code 会话。
+ */
+function buildSessionHookScript(options = {}) {
+    const journal = options.journalPath ?? `\${CLAUDE_PROJECT_DIR:-.}/${JOURNAL_RELATIVE}`;
+    const bin = options.graphflowBin ?? "graphflow";
+    const config = options.configPath ?? "";
+    const successDefault = (options.defaultSuccess ?? true) ? "true" : "false";
+    const lines = [
+        "#!/usr/bin/env bash",
+        "# GraphFlow auto-capture session hook (generated by graphflow, do not edit).",
+        "# Resolves the most recent pending episode (src/hooks/auto-capture.ts) at",
+        "# SessionEnd/Stop by calling: graphflow outcome report <episodeId> <success>",
+        "# Runtime overrides: GRAPHFLOW_HOOK_JOURNAL / GRAPHFLOW_HOOK_BIN / GRAPHFLOW_HOOK_CONFIG.",
+        "set -u",
+        'ACTION="${1:-end}"',
+        `SUCCESS="\${2:-${successDefault}}"`,
+        `JOURNAL="\${GRAPHFLOW_HOOK_JOURNAL:-${shellFallback(journal)}}"`,
+        `GF_BIN="\${GRAPHFLOW_HOOK_BIN:-${shellFallback(bin)}}"`,
+        `GF_CONFIG="\${GRAPHFLOW_HOOK_CONFIG:-${shellFallback(config)}}"`,
+        "",
+        'case "$ACTION" in',
+        "  start)",
+        '    mkdir -p "$(dirname "$JOURNAL")" 2>/dev/null || true',
+        "    exit 0",
+        "    ;;",
+        "esac",
+        "",
+        "# end/stop: resolve the most recent pending episode recorded by auto-capture.",
+        '[ -f "$JOURNAL" ] || exit 0',
+        'LINE="$(tail -n 1 "$JOURNAL" 2>/dev/null)" || exit 0',
+        '[ -n "$LINE" ] || exit 0',
+        'EPID="$(printf "%s" "$LINE" | sed -n \'s/.*"episodeId":[[:space:]]*"\\([^"]*\\)".*/\\1/p\')"',
+        '[ -n "$EPID" ] || exit 0',
+        "",
+        'ARGS=(outcome report "$EPID" "$SUCCESS")',
+        '[ -n "$GF_CONFIG" ] && ARGS+=(--config "$GF_CONFIG")',
+        '"$GF_BIN" "${ARGS[@]}" >/dev/null 2>&1 || true',
+        "exit 0",
+        "",
+    ];
+    return lines.join("\n");
+}
+/**
+ * 生成 settings.json 风格 hooks 配置片段。命令参数均经 shellQuote 转义，
+ * 可直接合并进 ~/.claude/settings.json 的 "hooks" 字段。
+ */
+function buildClaudeCodeHooksConfig(options = {}) {
+    const hooksDir = options.hooksDir ?? defaultHooksDir(resolveClaudeHome());
+    const scriptPath = (0, node_path_1.join)(hooksDir, exports.SESSION_HOOK_SCRIPT);
+    const quotedScript = shellQuote(scriptPath);
+    const startCommand = `bash ${quotedScript} start`;
+    const endCommand = `bash ${quotedScript} end`;
+    const timeout = options.timeoutSec ?? 30;
+    return {
+        hooks: {
+            SessionStart: [{ type: "command", command: startCommand, timeout }],
+            SessionEnd: [{ type: "command", command: endCommand, timeout }],
+            Stop: [{ type: "command", command: endCommand, timeout }],
+        },
+    };
+}
+/** 合并 hooks 配置到 settings.json（保留用户已有 hooks，append 幂等）。 */
+function installClaudeCodeHooks(options = {}) {
+    const claudeHome = resolveClaudeHome();
+    const hooksDir = options.hooksDir ?? defaultHooksDir(claudeHome);
+    const settingsPath = options.settingsPath ?? defaultSettingsPath(claudeHome);
+    const scriptPath = (0, node_path_1.join)(hooksDir, exports.SESSION_HOOK_SCRIPT);
+    // 1) 安装会话脚本（内容一致则跳过）
+    try {
+        (0, node_fs_1.mkdirSync)(hooksDir, { recursive: true });
+        const script = buildSessionHookScript(options);
+        if (!(0, node_fs_1.existsSync)(scriptPath) || (0, node_fs_1.readFileSync)(scriptPath, "utf8") !== script) {
+            (0, node_fs_1.writeFileSync)(scriptPath, script, { mode: 0o755 });
+        }
+    }
+    catch (error) {
+        return {
+            status: "error",
+            filePath: scriptPath,
+            message: `hook script install failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    // 2) 合并 settings.json
+    try {
+        return mergeSettingsHooks(settingsPath, buildClaudeCodeHooksConfig(options));
+    }
+    catch (error) {
+        return {
+            status: "error",
+            filePath: settingsPath,
+            message: `settings merge failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+/**
+ * 合并 hooks 片段进 settings.json。文件不存在 → created；已存在且 JSON 损坏 → error
+ * （绝不覆盖用户配置）；内容无变化 → skipped。
+ */
+function mergeSettingsHooks(settingsPath, config) {
+    const existed = (0, node_fs_1.existsSync)(settingsPath);
+    let settings;
+    if (existed) {
+        const raw = (0, node_fs_1.readFileSync)(settingsPath, "utf8");
+        try {
+            settings = JSON.parse(raw);
+        }
+        catch {
+            return {
+                status: "error",
+                filePath: settingsPath,
+                message: "existing settings.json is not valid JSON; refusing to overwrite",
+            };
+        }
+    }
+    else {
+        settings = {};
+    }
+    const existingHooks = settings.hooks && typeof settings.hooks === "object"
+        ? settings.hooks
+        : {};
+    const mergedHooks = { ...existingHooks };
+    for (const [event, entries] of Object.entries(config.hooks)) {
+        const existing = Array.isArray(existingHooks[event]) ? existingHooks[event] : [];
+        const existingCommands = new Set(existing.map((entry) => entry.command));
+        const added = (entries ?? []).filter((entry) => !existingCommands.has(entry.command));
+        mergedHooks[event] = [...existing, ...added];
+    }
+    const next = { ...settings, hooks: mergedHooks };
+    const payload = `${JSON.stringify(next, null, 2)}\n`;
+    if (existed && (0, node_fs_1.readFileSync)(settingsPath, "utf8") === payload) {
+        return { status: "skipped", filePath: settingsPath, message: "already up to date" };
+    }
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(settingsPath), { recursive: true });
+    (0, node_fs_1.writeFileSync)(settingsPath, payload, "utf8");
+    return {
+        status: existed ? "updated" : "created",
+        filePath: settingsPath,
+        message: `hooks installed (${Object.keys(config.hooks).join(", ")})`,
+    };
+}
+/** 卸载：从 settings.json 移除本生成器写入的 hook 条目并删除会话脚本。 */
+function uninstallClaudeCodeHooks(settingsPath, hooksDir) {
+    const claudeHome = resolveClaudeHome();
+    const target = settingsPath ?? defaultSettingsPath(claudeHome);
+    const scriptPath = (0, node_path_1.join)(hooksDir ?? defaultHooksDir(claudeHome), exports.SESSION_HOOK_SCRIPT);
+    if (!(0, node_fs_1.existsSync)(target)) {
+        return { status: "skipped", filePath: target, message: "settings.json not found" };
+    }
+    let settings;
+    try {
+        settings = JSON.parse((0, node_fs_1.readFileSync)(target, "utf8"));
+    }
+    catch {
+        return { status: "error", filePath: target, message: "settings.json is not valid JSON" };
+    }
+    const hooks = settings.hooks && typeof settings.hooks === "object"
+        ? settings.hooks
+        : {};
+    const ourScript = shellQuote(scriptPath);
+    let removedAny = false;
+    for (const event of ["SessionStart", "SessionEnd", "Stop"]) {
+        const entries = Array.isArray(hooks[event]) ? hooks[event] : [];
+        const kept = entries.filter((entry) => !entry.command.includes(ourScript));
+        if (kept.length !== entries.length) {
+            removedAny = true;
+        }
+        if (kept.length > 0) {
+            hooks[event] = kept;
+        }
+        else if (hooks[event] !== undefined) {
+            delete hooks[event];
+        }
+    }
+    const next = { ...settings, hooks };
+    (0, node_fs_1.writeFileSync)(target, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+    if ((0, node_fs_1.existsSync)(scriptPath)) {
+        try {
+            (0, node_fs_1.rmSync)(scriptPath, { force: true });
+        }
+        catch {
+            // 删除脚本失败不阻断
+        }
+    }
+    return {
+        status: removedAny ? "updated" : "skipped",
+        filePath: target,
+        message: removedAny ? "hooks removed" : "no graphflow hooks present",
+    };
+}
+//# sourceMappingURL=claude-code-hooks.js.map

package/dist/integrations/claude-code-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-hooks.js","sourceRoot":"","sources":["../../src/integrations/claude-code-hooks.ts"],"names":[],"mappings":"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"}

package/dist/integrations/ensure-anydoc.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Ensure optional @firecrawl/anydoc is available for Office/PDF → Markdown.
+ *
+ * VSIX does not ship native anydoc binaries. The VS Code/Cursor extension
+ * (and optionally CLI) downloads the current-platform package into
+ * ~/.graphflow/optional-deps via npm, then sets GRAPHFLOW_ANYDOC_NODE_MODULES.
+ */
+/** Keep in sync with package.json optionalDependencies[@firecrawl/anydoc]. */
+export declare const ANYDOC_NPM_PACKAGE = "@firecrawl/anydoc";
+export declare const ANYDOC_PINNED_VERSION = "0.1.7";
+export type EnsureAnydocStatus = "already" | "installed" | "skipped" | "failed";
+export interface EnsureAnydocResult {
+    status: EnsureAnydocStatus;
+    message: string;
+    nodeModules?: string;
+    version?: string;
+}
+export declare function resolveAnydocOptionalDepsRoot(home?: string): string;
+export declare function resolveAnydocNodeModules(home?: string): string;
+export declare function readInstalledAnydocVersion(depsRoot?: string): string | undefined;
+export declare function isAnydocPresent(nodeModules?: string): boolean;
+/**
+ * Point Node resolution at the optional-deps node_modules (extension + MCP child).
+ */
+export declare function applyAnydocRequireEnv(nodeModules?: string): boolean;
+/** Try loading anydoc from env path or default resolution. */
+export declare function tryRequireAnydoc(): unknown | null;
+/**
+ * Ensure platform anydoc binary is installed under ~/.graphflow/optional-deps.
+ * No-op when disabled, already present at the pinned version, or already require-able.
+ */
+export declare function ensureAnydocInstalled(options?: {
+    enabled?: boolean;
+    version?: string;
+    timeoutMs?: number;
+    home?: string;
+    /** Inject install for tests. */
+    installFn?: (depsRoot: string, version: string) => Promise<void>;
+    logger?: (message: string) => void;
+}): Promise<EnsureAnydocResult>;
+//# sourceMappingURL=ensure-anydoc.d.ts.map

package/dist/integrations/ensure-anydoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-anydoc.d.ts","sourceRoot":"","sources":["../../src/integrations/ensure-anydoc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AACtD,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,SAAY,GAAG,MAAM,CAEtE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,SAAY,GAAG,MAAM,CAEjE;AAMD,wBAAgB,0BAA0B,CAAC,QAAQ,SAAkC,GAAG,MAAM,GAAG,SAAS,CAgBzG;AAED,wBAAgB,eAAe,CAAC,WAAW,SAA6B,GAAG,OAAO,CAEjF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,SAA6B,GAAG,OAAO,CAqBvF;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,IAAI,OAAO,GAAG,IAAI,CA2BjD;AA+CD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2E9B"}

package/dist/integrations/ensure-anydoc.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Ensure optional @firecrawl/anydoc is available for Office/PDF → Markdown.
+ *
+ * VSIX does not ship native anydoc binaries. The VS Code/Cursor extension
+ * (and optionally CLI) downloads the current-platform package into
+ * ~/.graphflow/optional-deps via npm, then sets GRAPHFLOW_ANYDOC_NODE_MODULES.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANYDOC_PINNED_VERSION = exports.ANYDOC_NPM_PACKAGE = void 0;
+exports.resolveAnydocOptionalDepsRoot = resolveAnydocOptionalDepsRoot;
+exports.resolveAnydocNodeModules = resolveAnydocNodeModules;
+exports.readInstalledAnydocVersion = readInstalledAnydocVersion;
+exports.isAnydocPresent = isAnydocPresent;
+exports.applyAnydocRequireEnv = applyAnydocRequireEnv;
+exports.tryRequireAnydoc = tryRequireAnydoc;
+exports.ensureAnydocInstalled = ensureAnydocInstalled;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_module_1 = require("node:module");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+/** Keep in sync with package.json optionalDependencies[@firecrawl/anydoc]. */
+exports.ANYDOC_NPM_PACKAGE = "@firecrawl/anydoc";
+exports.ANYDOC_PINNED_VERSION = "0.1.7";
+function resolveAnydocOptionalDepsRoot(home = (0, node_os_1.homedir)()) {
+    return (0, node_path_1.join)(home, ".graphflow", "optional-deps");
+}
+function resolveAnydocNodeModules(home = (0, node_os_1.homedir)()) {
+    return (0, node_path_1.join)(resolveAnydocOptionalDepsRoot(home), "node_modules");
+}
+function versionMarkerPath(depsRoot) {
+    return (0, node_path_1.join)(depsRoot, ".anydoc-version");
+}
+function readInstalledAnydocVersion(depsRoot = resolveAnydocOptionalDepsRoot()) {
+    try {
+        const marker = (0, node_fs_1.readFileSync)(versionMarkerPath(depsRoot), "utf8").trim();
+        if (marker) {
+            return marker;
+        }
+    }
+    catch {
+        // fall through
+    }
+    try {
+        const pkgPath = (0, node_path_1.join)(depsRoot, "node_modules", "@firecrawl", "anydoc", "package.json");
+        const pkg = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, "utf8"));
+        return pkg.version;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isAnydocPresent(nodeModules = resolveAnydocNodeModules()) {
+    return (0, node_fs_1.existsSync)((0, node_path_1.join)(nodeModules, "@firecrawl", "anydoc", "package.json"));
+}
+/**
+ * Point Node resolution at the optional-deps node_modules (extension + MCP child).
+ */
+function applyAnydocRequireEnv(nodeModules = resolveAnydocNodeModules()) {
+    if (!(0, node_fs_1.existsSync)(nodeModules)) {
+        return false;
+    }
+    process.env.GRAPHFLOW_ANYDOC_NODE_MODULES = nodeModules;
+    const parts = (process.env.NODE_PATH ?? "")
+        .split(node_path_1.delimiter)
+        .map((p) => p.trim())
+        .filter(Boolean);
+    if (!parts.includes(nodeModules)) {
+        process.env.NODE_PATH = parts.length > 0 ? `${nodeModules}${node_path_1.delimiter}${parts.join(node_path_1.delimiter)}` : nodeModules;
+    }
+    try {
+        // Refresh Node's module search paths after NODE_PATH mutation.
+        const Module = require("node:module");
+        Module._initPaths?.();
+    }
+    catch {
+        // ignore — createRequire(path) still works for document-convert
+    }
+    return true;
+}
+/** Try loading anydoc from env path or default resolution. */
+function tryRequireAnydoc() {
+    const existing = process.env.GRAPHFLOW_ANYDOC_NODE_MODULES?.trim();
+    if (existing && (0, node_fs_1.existsSync)((0, node_path_1.join)(existing, "@firecrawl", "anydoc", "package.json"))) {
+        try {
+            const req = (0, node_module_1.createRequire)((0, node_path_1.join)(existing, "@firecrawl", "anydoc", "package.json"));
+            return req(exports.ANYDOC_NPM_PACKAGE);
+        }
+        catch {
+            // fall through to default home path
+        }
+    }
+    applyAnydocRequireEnv(resolveAnydocNodeModules());
+    const fromEnv = process.env.GRAPHFLOW_ANYDOC_NODE_MODULES?.trim();
+    if (fromEnv) {
+        try {
+            const req = (0, node_module_1.createRequire)((0, node_path_1.join)(fromEnv, "@firecrawl", "anydoc", "package.json"));
+            return req(exports.ANYDOC_NPM_PACKAGE);
+        }
+        catch {
+            // fall through
+        }
+    }
+    try {
+        const req = (0, node_module_1.createRequire)(__filename);
+        return req(exports.ANYDOC_NPM_PACKAGE);
+    }
+    catch {
+        return null;
+    }
+}
+function resolveNpmCommand() {
+    if (process.env.GRAPHFLOW_NPM?.trim()) {
+        return process.env.GRAPHFLOW_NPM.trim();
+    }
+    return process.platform === "win32" ? "npm.cmd" : "npm";
+}
+function runNpmInstall(depsRoot, version, timeoutMs) {
+    const npm = resolveNpmCommand();
+    const spec = `${exports.ANYDOC_NPM_PACKAGE}@${version}`;
+    return new Promise((resolve, reject) => {
+        const child = (0, node_child_process_1.spawn)(npm, ["install", "--ignore-scripts", "--no-save", "--no-package-lock", spec], {
+            cwd: depsRoot,
+            env: process.env,
+            stdio: ["ignore", "pipe", "pipe"],
+            windowsHide: true,
+            shell: process.platform === "win32",
+        });
+        let stderr = "";
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        const timer = setTimeout(() => {
+            child.kill("SIGTERM");
+            reject(new Error(`npm install ${spec} timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`npm install ${spec} exited ${code}: ${stderr.slice(0, 500)}`));
+        });
+    });
+}
+/**
+ * Ensure platform anydoc binary is installed under ~/.graphflow/optional-deps.
+ * No-op when disabled, already present at the pinned version, or already require-able.
+ */
+async function ensureAnydocInstalled(options) {
+    const enabled = options?.enabled ?? true;
+    const version = options?.version ?? exports.ANYDOC_PINNED_VERSION;
+    const timeoutMs = options?.timeoutMs ?? 180_000;
+    const home = options?.home ?? (0, node_os_1.homedir)();
+    const log = options?.logger ?? (() => undefined);
+    if (!enabled) {
+        return { status: "skipped", message: "anydoc auto-download disabled" };
+    }
+    const depsRoot = resolveAnydocOptionalDepsRoot(home);
+    const nodeModules = resolveAnydocNodeModules(home);
+    if (tryRequireAnydoc()) {
+        const nm = isAnydocPresent(nodeModules) ? nodeModules : process.env.GRAPHFLOW_ANYDOC_NODE_MODULES;
+        return {
+            status: "already",
+            message: "anydoc already resolvable",
+            ...(nm ? { nodeModules: nm } : {}),
+            version: readInstalledAnydocVersion(depsRoot) ?? version,
+        };
+    }
+    if (isAnydocPresent(nodeModules) && readInstalledAnydocVersion(depsRoot) === version) {
+        applyAnydocRequireEnv(nodeModules);
+        if (tryRequireAnydoc()) {
+            return {
+                status: "already",
+                message: `anydoc ${version} already installed in ${nodeModules}`,
+                nodeModules,
+                version,
+            };
+        }
+    }
+    try {
+        (0, node_fs_1.mkdirSync)(depsRoot, { recursive: true });
+        // Minimal package.json so npm install --prefix-like cwd works cleanly
+        const pkgJson = (0, node_path_1.join)(depsRoot, "package.json");
+        if (!(0, node_fs_1.existsSync)(pkgJson)) {
+            (0, node_fs_1.writeFileSync)(pkgJson, JSON.stringify({ name: "graphflow-optional-deps", private: true, version: "0.0.0" }, null, 2), "utf8");
+        }
+        log(`[GraphFlow] Downloading ${exports.ANYDOC_NPM_PACKAGE}@${version} into ${depsRoot} …`);
+        const install = options?.installFn ?? ((root, ver) => runNpmInstall(root, ver, timeoutMs));
+        await install(depsRoot, version);
+        (0, node_fs_1.writeFileSync)(versionMarkerPath(depsRoot), `${version}\n`, "utf8");
+        applyAnydocRequireEnv(nodeModules);
+        if (!tryRequireAnydoc()) {
+            return {
+                status: "failed",
+                message: `installed files under ${nodeModules} but require(@firecrawl/anydoc) still failed`,
+                nodeModules,
+                version,
+            };
+        }
+        log(`[GraphFlow] anydoc ${version} ready`);
+        return {
+            status: "installed",
+            message: `installed ${exports.ANYDOC_NPM_PACKAGE}@${version}`,
+            nodeModules,
+            version,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        log(`[GraphFlow] anydoc download failed: ${message}`);
+        return { status: "failed", message };
+    }
+}
+//# sourceMappingURL=ensure-anydoc.js.map

package/dist/integrations/ensure-anydoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-anydoc.js","sourceRoot":"","sources":["../../src/integrations/ensure-anydoc.ts"],"names":[],"mappings":"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"}

package/dist/integrations/skill-installer.d.ts

@@ -31,9 +31,9 @@ export interface AgentInstructionStatus {
 /**
  * 解析 Trae Skill 源文件路径。
  * 支持以下候选路径（按优先级排序）：
- * 1. vendorRuntimeRoot（VS Code 扩展打包后 vendor/graphflow 路径）
- * 2. 标准的 dist/surfaces/ 路径
- * 3. src/surfaces/ 源码路径
+ * 1. Agent Plugins 1.0 `skills/graphflow/`（规范源）
+ * 2. vendorRuntimeRoot（VS Code 扩展打包后 vendor/graphflow 路径）
+ * 3. 兼容副本：dist/surfaces/trae-skill、src/surfaces/trae-skill
  */
 export declare function resolveSkillSourcePath(vendorRuntimeRoot?: string): string | undefined;
 /**
@@ -145,4 +145,27 @@ export declare function installAllSkills(vendorRuntimeRoot?: string, log?: (mess
 export declare function removeManagedBlock(filePath: string): boolean;
 /** 移除指定 agent 的 GraphFlow Skill 目录 */
 export declare function removeAgentSkill(skillsRoot: string, skillName?: string): boolean;
+/** True when content looks like a GraphFlow-owned install (not a lightly annotated user file). */
+export declare function looksLikeGraphFlowOwnedContent(content: string): boolean;
+/**
+ * Remove a GraphFlow-owned file:
+ * - `graphflow.md` / `graphflow.mdc` → delete
+ * - managed-marker files → strip block
+ * - known instruction filenames that are wholly GraphFlow content → delete
+ */
+export declare function removeGraphFlowOwnedFile(filePath: string): boolean;
+export interface SkillUninstallResult {
+    target: string;
+    path: string;
+    removed: boolean;
+    message?: string;
+}
+/**
+ * Uninstall all GraphFlow Skills, Rules, and managed instruction blocks
+ * written by `graphflow install` / `installAllSkills`.
+ *
+ * Call this together with MCP uninstall so Agent Plugin / IDE uninstall
+ * leftovers cannot keep guiding agents toward GraphFlow tools.
+ */
+export declare function uninstallAllSkillsAndRules(workspaceRoot?: string): SkillUninstallResult[];
 //# sourceMappingURL=skill-installer.d.ts.map