@roarpeng/graphflow 1.4.4 → 1.7.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (227) hide show
  1. package/AGENTS.md +1 -1
  2. package/CHANGELOG.md +72 -0
  3. package/CLAUDE.md +1 -1
  4. package/README.md +76 -50
  5. package/dist/agents/atp-schema.d.ts +59 -0
  6. package/dist/agents/atp-schema.d.ts.map +1 -0
  7. package/dist/agents/atp-schema.js +3 -0
  8. package/dist/agents/atp-schema.js.map +1 -0
  9. package/dist/agents/decision-engine.d.ts +55 -0
  10. package/dist/agents/decision-engine.d.ts.map +1 -0
  11. package/dist/agents/decision-engine.js +338 -0
  12. package/dist/agents/decision-engine.js.map +1 -0
  13. package/dist/agents/insight.d.ts +69 -2
  14. package/dist/agents/insight.d.ts.map +1 -1
  15. package/dist/agents/insight.js +420 -27
  16. package/dist/agents/insight.js.map +1 -1
  17. package/dist/agents/task-profile.d.ts +19 -0
  18. package/dist/agents/task-profile.d.ts.map +1 -0
  19. package/dist/agents/task-profile.js +64 -0
  20. package/dist/agents/task-profile.js.map +1 -0
  21. package/dist/agents/validator.js +1 -1
  22. package/dist/agents/validator.js.map +1 -1
  23. package/dist/config/defaults.d.ts.map +1 -1
  24. package/dist/config/defaults.js +4 -3
  25. package/dist/config/defaults.js.map +1 -1
  26. package/dist/config/discover-workspace.d.ts.map +1 -1
  27. package/dist/config/discover-workspace.js +13 -2
  28. package/dist/config/discover-workspace.js.map +1 -1
  29. package/dist/config/embedding-factory.d.ts.map +1 -1
  30. package/dist/config/embedding-factory.js +87 -8
  31. package/dist/config/embedding-factory.js.map +1 -1
  32. package/dist/config/loader.d.ts.map +1 -1
  33. package/dist/config/loader.js +10 -4
  34. package/dist/config/loader.js.map +1 -1
  35. package/dist/config/provider-env.d.ts +32 -0
  36. package/dist/config/provider-env.d.ts.map +1 -0
  37. package/dist/config/provider-env.js +51 -0
  38. package/dist/config/provider-env.js.map +1 -0
  39. package/dist/config/resolve.d.ts.map +1 -1
  40. package/dist/config/resolve.js +7 -2
  41. package/dist/config/resolve.js.map +1 -1
  42. package/dist/config/schema.d.ts +17 -3
  43. package/dist/config/schema.d.ts.map +1 -1
  44. package/dist/config/workspace-root.d.ts +0 -12
  45. package/dist/config/workspace-root.d.ts.map +1 -1
  46. package/dist/config/workspace-root.js +21 -5
  47. package/dist/config/workspace-root.js.map +1 -1
  48. package/dist/core/agent-delegation.d.ts +8 -1
  49. package/dist/core/agent-delegation.d.ts.map +1 -1
  50. package/dist/core/agent-delegation.js +233 -38
  51. package/dist/core/agent-delegation.js.map +1 -1
  52. package/dist/core/cancellation.d.ts +57 -0
  53. package/dist/core/cancellation.d.ts.map +1 -0
  54. package/dist/core/cancellation.js +195 -0
  55. package/dist/core/cancellation.js.map +1 -0
  56. package/dist/core/dag-engine.d.ts +6 -1
  57. package/dist/core/dag-engine.d.ts.map +1 -1
  58. package/dist/core/dag-engine.js +67 -9
  59. package/dist/core/dag-engine.js.map +1 -1
  60. package/dist/core/orchestrator-context.d.ts.map +1 -1
  61. package/dist/core/orchestrator-context.js +28 -3
  62. package/dist/core/orchestrator-context.js.map +1 -1
  63. package/dist/core/orchestrator-route.d.ts +1 -1
  64. package/dist/core/orchestrator-route.d.ts.map +1 -1
  65. package/dist/core/orchestrator-route.js.map +1 -1
  66. package/dist/core/orchestrator.js +6 -1
  67. package/dist/core/orchestrator.js.map +1 -1
  68. package/dist/core/runtime-controller.d.ts +19 -0
  69. package/dist/core/runtime-controller.d.ts.map +1 -0
  70. package/dist/core/runtime-controller.js +89 -0
  71. package/dist/core/runtime-controller.js.map +1 -0
  72. package/dist/core/types.d.ts +17 -0
  73. package/dist/core/types.d.ts.map +1 -1
  74. package/dist/graph/context-slicer-types.d.ts +2 -4
  75. package/dist/graph/context-slicer-types.d.ts.map +1 -1
  76. package/dist/graph/context-slicer-types.js.map +1 -1
  77. package/dist/graph/context-slicer.d.ts +1 -0
  78. package/dist/graph/context-slicer.d.ts.map +1 -1
  79. package/dist/graph/context-slicer.js +54 -18
  80. package/dist/graph/context-slicer.js.map +1 -1
  81. package/dist/graph/file-indexer-walker.d.ts +3 -0
  82. package/dist/graph/file-indexer-walker.d.ts.map +1 -1
  83. package/dist/graph/file-indexer-walker.js.map +1 -1
  84. package/dist/graph/file-indexer.d.ts +1 -0
  85. package/dist/graph/file-indexer.d.ts.map +1 -1
  86. package/dist/graph/file-indexer.js +14 -18
  87. package/dist/graph/file-indexer.js.map +1 -1
  88. package/dist/graph/file-watcher.d.ts.map +1 -1
  89. package/dist/graph/file-watcher.js +9 -2
  90. package/dist/graph/file-watcher.js.map +1 -1
  91. package/dist/graph/graph-utils.d.ts +6 -1
  92. package/dist/graph/graph-utils.d.ts.map +1 -1
  93. package/dist/graph/graph-utils.js +116 -2
  94. package/dist/graph/graph-utils.js.map +1 -1
  95. package/dist/graph/graphify-file-client.d.ts.map +1 -1
  96. package/dist/graph/graphify-file-client.js +2 -1
  97. package/dist/graph/graphify-file-client.js.map +1 -1
  98. package/dist/graph/hit-diversify.d.ts +31 -0
  99. package/dist/graph/hit-diversify.d.ts.map +1 -0
  100. package/dist/graph/hit-diversify.js +270 -0
  101. package/dist/graph/hit-diversify.js.map +1 -0
  102. package/dist/graph/language-indexers/go.d.ts.map +1 -1
  103. package/dist/graph/language-indexers/go.js +2 -3
  104. package/dist/graph/language-indexers/go.js.map +1 -1
  105. package/dist/graph/language-indexers/incremental-parse.d.ts +9 -0
  106. package/dist/graph/language-indexers/incremental-parse.d.ts.map +1 -0
  107. package/dist/graph/language-indexers/incremental-parse.js +114 -0
  108. package/dist/graph/language-indexers/incremental-parse.js.map +1 -0
  109. package/dist/graph/language-indexers/python.d.ts.map +1 -1
  110. package/dist/graph/language-indexers/python.js +2 -3
  111. package/dist/graph/language-indexers/python.js.map +1 -1
  112. package/dist/graph/language-indexers/rust.d.ts.map +1 -1
  113. package/dist/graph/language-indexers/rust.js +2 -3
  114. package/dist/graph/language-indexers/rust.js.map +1 -1
  115. package/dist/graph/language-indexers/tree-sitter-loader.d.ts +19 -3
  116. package/dist/graph/language-indexers/tree-sitter-loader.d.ts.map +1 -1
  117. package/dist/graph/language-indexers/tree-sitter-loader.js +24 -4
  118. package/dist/graph/language-indexers/tree-sitter-loader.js.map +1 -1
  119. package/dist/graph/query-expand.d.ts.map +1 -1
  120. package/dist/graph/query-expand.js +2 -0
  121. package/dist/graph/query-expand.js.map +1 -1
  122. package/dist/index.d.ts +1 -1
  123. package/dist/index.d.ts.map +1 -1
  124. package/dist/index.js +2 -1
  125. package/dist/index.js.map +1 -1
  126. package/dist/integrations/agent-mcp-installer.d.ts +39 -0
  127. package/dist/integrations/agent-mcp-installer.d.ts.map +1 -1
  128. package/dist/integrations/agent-mcp-installer.js +220 -14
  129. package/dist/integrations/agent-mcp-installer.js.map +1 -1
  130. package/dist/learning/embedding-quality.d.ts +46 -0
  131. package/dist/learning/embedding-quality.d.ts.map +1 -0
  132. package/dist/learning/embedding-quality.js +131 -0
  133. package/dist/learning/embedding-quality.js.map +1 -0
  134. package/dist/learning/embeddings.d.ts +46 -3
  135. package/dist/learning/embeddings.d.ts.map +1 -1
  136. package/dist/learning/embeddings.js +186 -26
  137. package/dist/learning/embeddings.js.map +1 -1
  138. package/dist/learning/hnsw-index.d.ts +9 -35
  139. package/dist/learning/hnsw-index.d.ts.map +1 -1
  140. package/dist/learning/hnsw-index.js +8 -154
  141. package/dist/learning/hnsw-index.js.map +1 -1
  142. package/dist/learning/skill-flywheel.d.ts +1 -1
  143. package/dist/learning/skill-flywheel.d.ts.map +1 -1
  144. package/dist/learning/skill-flywheel.js +10 -3
  145. package/dist/learning/skill-flywheel.js.map +1 -1
  146. package/dist/routing/deepseek-tools.d.ts +7 -0
  147. package/dist/routing/deepseek-tools.d.ts.map +1 -0
  148. package/dist/routing/deepseek-tools.js +154 -0
  149. package/dist/routing/deepseek-tools.js.map +1 -0
  150. package/dist/routing/model-router.d.ts +1 -1
  151. package/dist/routing/model-router.d.ts.map +1 -1
  152. package/dist/routing/model-router.js +5 -1
  153. package/dist/routing/model-router.js.map +1 -1
  154. package/dist/routing/provider-adapters/anthropic.d.ts.map +1 -1
  155. package/dist/routing/provider-adapters/anthropic.js +7 -4
  156. package/dist/routing/provider-adapters/anthropic.js.map +1 -1
  157. package/dist/routing/provider-adapters/bailian.d.ts.map +1 -1
  158. package/dist/routing/provider-adapters/bailian.js +7 -4
  159. package/dist/routing/provider-adapters/bailian.js.map +1 -1
  160. package/dist/routing/provider-adapters/deepseek.d.ts +5 -0
  161. package/dist/routing/provider-adapters/deepseek.d.ts.map +1 -0
  162. package/dist/routing/provider-adapters/deepseek.js +109 -0
  163. package/dist/routing/provider-adapters/deepseek.js.map +1 -0
  164. package/dist/routing/provider-adapters/doubao.d.ts.map +1 -1
  165. package/dist/routing/provider-adapters/doubao.js +7 -4
  166. package/dist/routing/provider-adapters/doubao.js.map +1 -1
  167. package/dist/routing/provider-adapters/openai.d.ts +2 -4
  168. package/dist/routing/provider-adapters/openai.d.ts.map +1 -1
  169. package/dist/routing/provider-adapters/openai.js +23 -32
  170. package/dist/routing/provider-adapters/openai.js.map +1 -1
  171. package/dist/routing/provider-adapters/types.d.ts +61 -0
  172. package/dist/routing/provider-adapters/types.d.ts.map +1 -0
  173. package/dist/routing/provider-adapters/types.js +56 -0
  174. package/dist/routing/provider-adapters/types.js.map +1 -0
  175. package/dist/routing/provider-executor.d.ts +6 -1
  176. package/dist/routing/provider-executor.d.ts.map +1 -1
  177. package/dist/routing/provider-executor.js +70 -39
  178. package/dist/routing/provider-executor.js.map +1 -1
  179. package/dist/routing/provider-health.d.ts.map +1 -1
  180. package/dist/routing/provider-health.js +7 -1
  181. package/dist/routing/provider-health.js.map +1 -1
  182. package/dist/routing/role-capabilities.d.ts +11 -0
  183. package/dist/routing/role-capabilities.d.ts.map +1 -0
  184. package/dist/routing/role-capabilities.js +94 -0
  185. package/dist/routing/role-capabilities.js.map +1 -0
  186. package/dist/surfaces/antigravity-rules/graphflow.md +8 -8
  187. package/dist/surfaces/cli/runtime/env.d.ts.map +1 -1
  188. package/dist/surfaces/cli/runtime/env.js +3 -0
  189. package/dist/surfaces/cli/runtime/env.js.map +1 -1
  190. package/dist/surfaces/cli/runtime/facade.d.ts +2 -1
  191. package/dist/surfaces/cli/runtime/facade.d.ts.map +1 -1
  192. package/dist/surfaces/cli/runtime/facade.js +1 -0
  193. package/dist/surfaces/cli/runtime/facade.js.map +1 -1
  194. package/dist/surfaces/cli/runtime/graph.d.ts.map +1 -1
  195. package/dist/surfaces/cli/runtime/graph.js +7 -1
  196. package/dist/surfaces/cli/runtime/graph.js.map +1 -1
  197. package/dist/surfaces/cli/runtime/routing.d.ts +3 -0
  198. package/dist/surfaces/cli/runtime/routing.d.ts.map +1 -1
  199. package/dist/surfaces/cli/runtime/routing.js +31 -4
  200. package/dist/surfaces/cli/runtime/routing.js.map +1 -1
  201. package/dist/surfaces/cli/runtime/settings.d.ts.map +1 -1
  202. package/dist/surfaces/cli/runtime/settings.js +0 -5
  203. package/dist/surfaces/cli/runtime/settings.js.map +1 -1
  204. package/dist/surfaces/cli/runtime/types.d.ts +23 -9
  205. package/dist/surfaces/cli/runtime/types.d.ts.map +1 -1
  206. package/dist/surfaces/cli/runtime.d.ts +1 -1
  207. package/dist/surfaces/cli/runtime.d.ts.map +1 -1
  208. package/dist/surfaces/cli/runtime.js +2 -1
  209. package/dist/surfaces/cli/runtime.js.map +1 -1
  210. package/dist/surfaces/copilot-instructions/graphflow.md +6 -6
  211. package/dist/surfaces/cursor-rules/graphflow.mdc +20 -27
  212. package/dist/surfaces/mcp/server.js +17 -6
  213. package/dist/surfaces/mcp/server.js.map +1 -1
  214. package/dist/surfaces/mcp/tool-definitions.d.ts.map +1 -1
  215. package/dist/surfaces/mcp/tool-definitions.js +31 -124
  216. package/dist/surfaces/mcp/tool-definitions.js.map +1 -1
  217. package/dist/surfaces/mcp/tool-handlers.d.ts.map +1 -1
  218. package/dist/surfaces/mcp/tool-handlers.js +80 -42
  219. package/dist/surfaces/mcp/tool-handlers.js.map +1 -1
  220. package/dist/surfaces/trae-rules/graphflow.md +9 -9
  221. package/dist/surfaces/trae-skill/graphflow/SKILL.md +68 -75
  222. package/package.json +2 -2
  223. package/src/surfaces/antigravity-rules/graphflow.md +8 -8
  224. package/src/surfaces/copilot-instructions/graphflow.md +6 -6
  225. package/src/surfaces/cursor-rules/graphflow.mdc +20 -27
  226. package/src/surfaces/trae-rules/graphflow.md +9 -9
  227. package/src/surfaces/trae-skill/graphflow/SKILL.md +68 -75
@@ -6,6 +6,7 @@ exports.readRequiredString = readRequiredString;
6
6
  exports.isRecord = isRecord;
7
7
  exports.readProgressToken = readProgressToken;
8
8
  const runtime_1 = require("../cli/runtime");
9
+ const cancellation_1 = require("../../core/cancellation");
9
10
  const node_fs_1 = require("node:fs");
10
11
  const node_path_1 = require("node:path");
11
12
  exports.MAX_STRING_FIELD_LENGTH = 100_000;
@@ -21,41 +22,79 @@ async function executeToolCall(call, _server, _hooks) {
21
22
  : [];
22
23
  return textResponse(await (0, runtime_1.reportOutcome)(readRequiredString(args.episodeId, "episodeId"), typeof args.success === "boolean" ? args.success : false, lessons, readOptionalString(args.configPath)));
23
24
  }
24
- case "graphflow_submit_insight":
25
- return textResponse(await (0, runtime_1.submitAgentInsightResult)(readRequiredString(args.task, "task"), readRequiredString(args.workItemId, "workItemId"), readRequiredString(args.response, "response"), readOptionalString(args.configPath), readOptionalString(args.episodeId), readOptionalString(args.rootDir)));
26
- case "graphflow_merge_insight":
27
- return textResponse(await (0, runtime_1.mergeAgentInsightResult)(readRequiredString(args.task, "task"), readOptionalString(args.configPath), readOptionalString(args.rootDir)));
28
- case "graphflow_plan":
29
- return textResponse((0, runtime_1.planAndBrainstormResult)(readRequiredString(args.task, "task")));
30
- case "graphflow_plan_insight":
31
- return textResponse(await (0, runtime_1.planInsightResult)(readRequiredString(args.task, "task"), readOptionalString(args.configPath)));
32
- case "graphflow_preview_context":
33
- return textResponse(await (0, runtime_1.previewContext)(readRequiredString(args.query, "query"), readOptionalString(args.configPath), readOptionalString(args.rootDir), readOptionalString(args.englishQuery)));
34
- case "graphflow_expand_anchor":
35
- return textResponse(await (0, runtime_1.expandAnchor)(readRequiredString(args.anchorId, "anchorId"), readOptionalString(args.configPath), readOptionalString(args.rootDir)));
36
- case "graphflow_index":
25
+ case "graphflow_context": {
26
+ const query = readOptionalString(args.query);
27
+ const anchorId = readOptionalString(args.anchorId);
28
+ if (anchorId && !query) {
29
+ return textResponse(await (0, runtime_1.expandAnchor)(anchorId, readOptionalString(args.configPath), readOptionalString(args.rootDir)));
30
+ }
31
+ if (query && !anchorId) {
32
+ return textResponse(await (0, runtime_1.previewContext)(query, readOptionalString(args.configPath), readOptionalString(args.rootDir), readOptionalString(args.englishQuery)));
33
+ }
34
+ if (query && anchorId) {
35
+ // Both provided: default to preview behavior for backward compatibility
36
+ return textResponse(await (0, runtime_1.previewContext)(query, readOptionalString(args.configPath), readOptionalString(args.rootDir), readOptionalString(args.englishQuery)));
37
+ }
38
+ throw new Error("Either 'query' or 'anchorId' must be provided for graphflow_context.");
39
+ }
40
+ case "graphflow_plan": {
41
+ const mode = readOptionalString(args.mode) || "simple";
42
+ const task = readRequiredString(args.task, "task");
43
+ if (mode === "insight") {
44
+ return textResponse(await (0, runtime_1.planInsightResult)(task, readOptionalString(args.configPath)));
45
+ }
46
+ return textResponse((0, runtime_1.planAndBrainstormResult)(task));
47
+ }
48
+ case "graphflow_index": {
49
+ const filePath = readOptionalString(args.filePath);
50
+ const mode = readOptionalString(args.mode) || "incremental";
51
+ if (filePath) {
52
+ return textResponse(await (0, runtime_1.indexFile)(filePath, readOptionalString(args.configPath)));
53
+ }
54
+ if (mode === "full") {
55
+ return textResponse(await (0, runtime_1.rebuildGraph)(readOptionalString(args.rootDir), readOptionalString(args.configPath)));
56
+ }
37
57
  return textResponse(await (0, runtime_1.indexGraph)(readOptionalString(args.rootDir), readOptionalString(args.configPath)));
38
- case "graphflow_index_file":
39
- return textResponse(await (0, runtime_1.indexFile)(readRequiredString(args.filePath, "filePath"), readOptionalString(args.configPath)));
40
- case "graphflow_rebuild":
41
- return textResponse(await (0, runtime_1.rebuildGraph)(readOptionalString(args.rootDir), readOptionalString(args.configPath)));
42
- case "graphflow_inspect_graph":
43
- return textResponse(await (0, runtime_1.inspectGraph)(readOptionalString(args.configPath), buildInspectOptions(args)));
58
+ }
59
+ case "graphflow_insight": {
60
+ const mode = readRequiredString(args.mode, "mode");
61
+ const task = readRequiredString(args.task, "task");
62
+ if (mode === "submit") {
63
+ return textResponse(await (0, runtime_1.submitAgentInsightResult)(task, readRequiredString(args.workItemId, "workItemId"), readRequiredString(args.response, "response"), readOptionalString(args.configPath), readOptionalString(args.episodeId), readOptionalString(args.rootDir)));
64
+ }
65
+ if (mode === "merge") {
66
+ return textResponse(await (0, runtime_1.mergeAgentInsightResult)(task, readOptionalString(args.configPath), readOptionalString(args.rootDir)));
67
+ }
68
+ throw new Error(`Invalid mode '${mode}' for graphflow_insight. Use 'submit' or 'merge'.`);
69
+ }
44
70
  case "graphflow_skill_insights":
45
71
  return textResponse(await (0, runtime_1.getSkillInsights)(readOptionalString(args.configPath), readOptionalNumber(args.limit), readOptionalString(args.rootDir)));
46
- case "graphflow_diagnose":
47
- return textResponse((0, runtime_1.diagnoseRoutingResult)(readOptionalString(args.configPath)));
48
- case "graphflow_export_artifact": {
49
- const compressionRaw = readOptionalString(args.compression);
50
- const compression = compressionRaw === "none" || compressionRaw === "gzip"
51
- ? compressionRaw
52
- : undefined;
53
- return textResponse(await (0, runtime_1.exportArtifact)(readOptionalString(args.configPath), readOptionalString(args.outputPath), undefined, compression ? { compression } : undefined));
72
+ case "graphflow_diagnose": {
73
+ const configPath = readOptionalString(args.configPath);
74
+ const health = (0, runtime_1.diagnoseRoutingResult)(configPath);
75
+ const graph = await (0, runtime_1.inspectGraph)(configPath, buildInspectOptions(args));
76
+ const stats = (0, runtime_1.getTokenSavingsStats)(configPath, readOptionalString(args.rootDir));
77
+ return textResponse({
78
+ health,
79
+ graph,
80
+ stats,
81
+ runtimeTimeline: (0, cancellation_1.getRuntimeTimelineSummary)(),
82
+ });
83
+ }
84
+ case "graphflow_artifact": {
85
+ const mode = readRequiredString(args.mode, "mode");
86
+ if (mode === "export") {
87
+ const compressionRaw = readOptionalString(args.compression);
88
+ const compression = compressionRaw === "none" || compressionRaw === "gzip"
89
+ ? compressionRaw
90
+ : undefined;
91
+ return textResponse(await (0, runtime_1.exportArtifact)(readOptionalString(args.configPath), readOptionalString(args.outputPath), undefined, compression ? { compression } : undefined));
92
+ }
93
+ if (mode === "import") {
94
+ return textResponse(await (0, runtime_1.importArtifact)(readOptionalString(args.configPath), readOptionalString(args.inputPath)));
95
+ }
96
+ throw new Error(`Invalid mode '${mode}' for graphflow_artifact. Use 'export' or 'import'.`);
54
97
  }
55
- case "graphflow_import_artifact":
56
- return textResponse(await (0, runtime_1.importArtifact)(readOptionalString(args.configPath), readOptionalString(args.inputPath)));
57
- case "graphflow_stats":
58
- return textResponse((0, runtime_1.getTokenSavingsStats)(readOptionalString(args.configPath), readOptionalString(args.rootDir)));
59
98
  case "graphflow_skill_guide": {
60
99
  const section = readOptionalString(args.section) || "all";
61
100
  const skillGuide = getSkillGuide(section);
@@ -129,7 +168,7 @@ function getBuiltInSkillGuide() {
129
168
  return `## GraphFlow Quick Skill Guide
130
169
 
131
170
  ### Core Workflow: Context First
132
- ALWAYS call \`graphflow_preview_context(query)\` BEFORE:
171
+ ALWAYS call \`graphflow_context(query)\` BEFORE:
133
172
  - Multi-step edits, refactors, or architecture changes
134
173
  - Large codebase-wide questions or exploration
135
174
  - Debugging across multiple files
@@ -138,25 +177,24 @@ ALWAYS call \`graphflow_preview_context(query)\` BEFORE:
138
177
  ### Key Tools
139
178
  | Tool | Purpose |
140
179
  |------|---------|
141
- | \`graphflow_preview_context\` | Compress task context with token budget (90% of tasks start here) |
142
- | \`graphflow_expand_anchor\` | Expand a single anchor to full content |
180
+ | \`graphflow_context\` | Preview compressed context or expand an anchor |
143
181
  | \`graphflow_plan\` | Multi-step task decomposition & DAG |
144
- | \`graphflow_index\` | Incremental workspace re-index |
145
- | \`graphflow_inspect_graph\` | Check graph health |
182
+ | \`graphflow_index\` | Incremental workspace re-index or full rebuild |
183
+ | \`graphflow_diagnose\` | Check provider health, graph stats, and token savings |
146
184
 
147
185
  ### Best Practices
148
- 1. Start EVERY task with \`graphflow_preview_context\`
186
+ 1. Start EVERY task with \`graphflow_context\`
149
187
  2. Only read full files when compressed context is insufficient
150
188
  3. Use \`graphflow_plan\` for tasks beyond 2-3 files
151
189
  4. Call \`graphflow_index\` after significant changes
152
190
  5. Always report token savings to the user
153
191
 
154
192
  ### Tool Selection Decision Tree
155
- - Code question/exploration? \`graphflow_preview_context\`
156
- - Need more detail? \`graphflow_expand_anchor\`
157
- - Multi-step coding task? \`graphflow_preview_context\` \`graphflow_plan\` implement
158
- - File changes made? \`graphflow_index_file\` (single) or \`graphflow_index\` (multiple)
159
- - Graph giving bad results? \`graphflow_inspect_graph\` \`graphflow_index\` \`graphflow_rebuild\`
193
+ - Code question/exploration? -> \`graphflow_context\`
194
+ - Need more detail? -> \`graphflow_context\` with anchorId
195
+ - Multi-step coding task? -> \`graphflow_context\` -> \`graphflow_plan\` -> implement
196
+ - File changes made? -> \`graphflow_index\` (single file via filePath, or incremental)
197
+ - Graph giving bad results? -> \`graphflow_diagnose\` -> \`graphflow_index\` with mode='full'
160
198
 
161
199
  Call \`graphflow_skill_guide(section: "all")\` for the complete guide.`;
162
200
  }
@@ -1 +1 @@
1
- {"version":3,"file":"tool-handlers.js","sourceRoot":"","sources":["../../../src/surfaces/mcp/tool-handlers.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tool-handlers.js","sourceRoot":"","sources":["../../../src/surfaces/mcp/tool-handlers.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: GraphFlow token-first — always call graphflow_preview_context before code exploration, debugging, or edits.
2
+ description: GraphFlow token-first — always call graphflow_context before code exploration, debugging, or edits.
3
3
  alwaysApply: true
4
4
  globs:
5
5
  - "**/*"
@@ -13,11 +13,11 @@ GraphFlow is a graph-based context and planning MCP service. **You MUST use it b
13
13
 
14
14
  Before code exploration, implementation, debugging, review, planning, or architecture questions:
15
15
 
16
- 1. Call MCP tool **`graphflow_preview_context`** with the user's task/query and **`rootDir`** set to the current project absolute path.
16
+ 1. Call MCP tool **`graphflow_context`** with the user's task/query and **`rootDir`** set to the current project absolute path.
17
17
  2. Use returned `summary`, `anchors`, `refillPreview`, and `tokenBudget` as the primary context.
18
18
  3. Read full files only when anchors point there, compressed context is insufficient, or exact edits require the file body.
19
19
  4. For multi-step or ambiguous work, call **`graphflow_plan`** before implementation.
20
- 5. After major file changes, call **`graphflow_index`** or **`graphflow_index_file`**.
20
+ 5. After major file changes, call **`graphflow_index`** (or pass `filePath` for single-file index).
21
21
 
22
22
  **Do NOT** recursively grep the whole repository or read large files before GraphFlow preview.
23
23
 
@@ -26,11 +26,12 @@ Before code exploration, implementation, debugging, review, planning, or archite
26
26
  Code symbols are mostly English. For Chinese user questions:
27
27
 
28
28
  1. **Proactive:** Translate intent to English **file/class/component names** and pass **`englishQuery`** (e.g. `PoseDetectionPage`, `BattlePage`, `shieldEffect`). Avoid generic `exercise` when the user means UI/camera.
29
- 2. **Reactive:** If preview returns `agentWorkItems` with `query-translate-en`, answer the JSON prompt, then retry with `englishQuery`.
30
- 3. Keep `query` as the original Chinese text.
29
+ 2. **Module families (store/slices):** Prefer file stems (`useGameStore companionSlice dailySlice`), not bare domain words like `monster` (often hits `data/monsters` instead of `monsterSlice`).
30
+ 3. **Reactive:** If preview returns `agentWorkItems` with `query-translate-en`, answer the JSON prompt, then retry with `englishQuery`.
31
+ 4. Keep `query` as the original Chinese text.
31
32
 
32
33
  ```typescript
33
- graphflow_preview_context({
34
+ graphflow_context({
34
35
  query: "摄像头锻炼人物角色选择",
35
36
  englishQuery: "PoseDetectionPage avatarMode poseService",
36
37
  rootDir: "/absolute/path/to/project"
@@ -41,12 +42,11 @@ graphflow_preview_context({
41
42
 
42
43
  | Tool | When |
43
44
  |------|------|
44
- | `graphflow_preview_context` | **Always first** for code questions |
45
- | `graphflow_expand_anchor` | Need full content of one anchor |
45
+ | `graphflow_context` | **Always first** for code questions (use `query`); need full content of one anchor (use `anchorId`) |
46
46
  | `graphflow_plan` | Multi-step tasks |
47
47
  | `graphflow_index` | After significant edits |
48
48
 
49
- For the full 18-tool reference and workflows, use Skill **`#graphflow`** or `@skills/graphflow/SKILL.md`.
49
+ For the full 10-tool reference and workflows, use Skill **`#graphflow`** or `@skills/graphflow/SKILL.md`.
50
50
 
51
51
  ## Bridge mode
52
52