@roarpeng/graphflow 1.1.0 → 1.3.0

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

@@ -0,0 +1,80 @@
+export interface SkillInstallResult {
+    /** 安装目标名称（如 "Trae"、"Cursor"） */
+    target: string;
+    /** 安装结果状态 */
+    status: "created" | "updated" | "skipped" | "error";
+    /** 可选的附加信息 */
+    message?: string | undefined;
+}
+export interface SkillInstallSummary {
+    traeSkills: SkillInstallResult[];
+    cursorRules: SkillInstallResult[];
+    claudeMd: SkillInstallResult[];
+    /** Agent instruction files (Windsurf / Codex / Gemini global rules, etc.). */
+    agentInstructions: SkillInstallResult[];
+    /** Real Agent Skill folders (Cursor / Claude Code / Codex `skills/<name>/SKILL.md`). */
+    agentSkills: SkillInstallResult[];
+}
+/** Status of a GraphFlow instruction block in a per-agent rules/memory file. */
+export interface AgentInstructionStatus {
+    /** Display name of the agent. */
+    agent: string;
+    /** Absolute path to the instruction file. */
+    configPath: string;
+    /** Whether the agent appears installed on this machine (marker present). */
+    detected: boolean;
+    /** Whether the GraphFlow managed block is present in the file. */
+    installed: boolean;
+}
+/**
+ * 解析 Trae Skill 源文件路径。
+ * 支持以下候选路径（按优先级排序）：
+ * 1. vendorRuntimeRoot（VS Code 扩展打包后 vendor/graphflow 路径）
+ * 2. 标准的 dist/surfaces/ 路径
+ * 3. src/surfaces/ 源码路径
+ */
+export declare function resolveSkillSourcePath(vendorRuntimeRoot?: string): string | undefined;
+/**
+ * 解析 Cursor Rules 源文件路径。
+ */
+export declare function resolveCursorRulesSourcePath(vendorRuntimeRoot?: string): string | undefined;
+/**
+ * 解析 Claude Code CLAUDE.md 源文件路径。
+ */
+export declare function resolveClaudeMdSourcePath(vendorRuntimeRoot?: string): string | undefined;
+/**
+ * 将 GraphFlow 指令块安全写入所有检测到的 agent 的全局规则/记忆文件。
+ * 使用 append-with-markers，绝不覆盖用户已有内容。
+ */
+export declare function installAgentInstructions(): SkillInstallResult[];
+/** 检查每个 agent 的全局指令文件是否含 GraphFlow 受管块（用于 doctor 自检）。 */
+export declare function getAgentInstructionStatus(): AgentInstructionStatus[];
+/**
+ * 将 GraphFlow 的 SKILL.md 安装为各检测到的 agent 的"真正的 Skill"
+ * （Cursor / Claude Code / Codex 的 `skills/graphflow/SKILL.md`）。
+ * SKILL.md 已带合法的 `name: graphflow` frontmatter，可被 Cursor 直接识别。
+ */
+export declare function installAgentSkills(vendorRuntimeRoot?: string): SkillInstallResult[];
+/** 检查每个 agent 的 Skill 文件是否已安装（用于 doctor 自检）。 */
+export declare function getAgentSkillStatus(): AgentInstructionStatus[];
+/**
+ * 安装 Trae Skill（SKILL.md）到所有检测到的 Trae 用户目录。
+ */
+export declare function installTraeSkills(vendorRuntimeRoot?: string): SkillInstallResult[];
+/**
+ * 安装 Cursor Rules（graphflow.mdc）到所有检测到的 Cursor 用户目录。
+ */
+export declare function installCursorRules(vendorRuntimeRoot?: string): SkillInstallResult[];
+/**
+ * 安装 Claude Code CLAUDE.md 到检测到的 Claude Code 用户目录。
+ */
+export declare function installClaudeCodeMd(vendorRuntimeRoot?: string): SkillInstallResult[];
+/**
+ * 一键安装所有 Skill / Rules / CLAUDE.md。
+ * 所有失败静默处理（catch + 返回 error 状态），不会抛出异常。
+ *
+ * @param vendorRuntimeRoot 可选的 vendor 运行时根目录（VS Code 扩展中使用）
+ * @param log 可选的日志回调，用于输出安装信息
+ */
+export declare function installAllSkills(vendorRuntimeRoot?: string, log?: (message: string) => void): SkillInstallSummary;
+//# sourceMappingURL=skill-installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-installer.d.ts","sourceRoot":"","sources":["../../src/integrations/skill-installer.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACpD,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,8EAA8E;IAC9E,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;IACxC,wFAAwF;IACxF,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;CACpB;AAiHD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqBrF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqB3F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBxF;AAgJD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,EAAE,CAgB/D;AAED,yDAAyD;AACzD,wBAAgB,yBAAyB,IAAI,sBAAsB,EAAE,CAUpE;AAuCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAyCnF;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,IAAI,sBAAsB,EAAE,CAM9D;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAwClF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAuCnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAqCpF;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,iBAAiB,CAAC,EAAE,MAAM,EAC1B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC9B,mBAAmB,CAyErB"}