@roarpeng/graphflow 1.4.4 → 1.7.0
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.
- package/AGENTS.md +1 -1
- package/CHANGELOG.md +25 -0
- package/CLAUDE.md +1 -1
- package/README.md +69 -47
- package/dist/agents/atp-schema.d.ts +59 -0
- package/dist/agents/atp-schema.d.ts.map +1 -0
- package/dist/agents/atp-schema.js +3 -0
- package/dist/agents/atp-schema.js.map +1 -0
- package/dist/agents/decision-engine.d.ts +55 -0
- package/dist/agents/decision-engine.d.ts.map +1 -0
- package/dist/agents/decision-engine.js +338 -0
- package/dist/agents/decision-engine.js.map +1 -0
- package/dist/agents/insight.d.ts +57 -1
- package/dist/agents/insight.d.ts.map +1 -1
- package/dist/agents/insight.js +365 -2
- package/dist/agents/insight.js.map +1 -1
- package/dist/config/defaults.d.ts.map +1 -1
- package/dist/config/defaults.js +1 -2
- package/dist/config/defaults.js.map +1 -1
- package/dist/config/discover-workspace.d.ts.map +1 -1
- package/dist/config/discover-workspace.js +4 -0
- package/dist/config/discover-workspace.js.map +1 -1
- package/dist/config/embedding-factory.js +6 -6
- package/dist/config/embedding-factory.js.map +1 -1
- package/dist/config/loader.d.ts.map +1 -1
- package/dist/config/loader.js +1 -2
- package/dist/config/loader.js.map +1 -1
- package/dist/config/schema.d.ts +1 -2
- package/dist/config/schema.d.ts.map +1 -1
- package/dist/core/agent-delegation.d.ts +3 -1
- package/dist/core/agent-delegation.d.ts.map +1 -1
- package/dist/core/agent-delegation.js +121 -0
- package/dist/core/agent-delegation.js.map +1 -1
- package/dist/core/orchestrator-context.d.ts.map +1 -1
- package/dist/core/orchestrator-context.js +25 -3
- package/dist/core/orchestrator-context.js.map +1 -1
- package/dist/core/types.d.ts +12 -0
- package/dist/core/types.d.ts.map +1 -1
- package/dist/graph/context-slicer-types.d.ts +0 -4
- package/dist/graph/context-slicer-types.d.ts.map +1 -1
- package/dist/graph/context-slicer-types.js.map +1 -1
- package/dist/graph/context-slicer.d.ts.map +1 -1
- package/dist/graph/context-slicer.js +5 -15
- package/dist/graph/context-slicer.js.map +1 -1
- package/dist/graph/file-indexer-walker.d.ts +3 -0
- package/dist/graph/file-indexer-walker.d.ts.map +1 -1
- package/dist/graph/file-indexer-walker.js.map +1 -1
- package/dist/graph/file-indexer.d.ts +1 -0
- package/dist/graph/file-indexer.d.ts.map +1 -1
- package/dist/graph/file-indexer.js +14 -18
- package/dist/graph/file-indexer.js.map +1 -1
- package/dist/learning/embeddings.d.ts +2 -3
- package/dist/learning/embeddings.d.ts.map +1 -1
- package/dist/learning/embeddings.js +18 -33
- package/dist/learning/embeddings.js.map +1 -1
- package/dist/learning/hnsw-index.d.ts +9 -35
- package/dist/learning/hnsw-index.d.ts.map +1 -1
- package/dist/learning/hnsw-index.js +8 -154
- package/dist/learning/hnsw-index.js.map +1 -1
- package/dist/surfaces/antigravity-rules/graphflow.md +5 -6
- package/dist/surfaces/cli/runtime/graph.d.ts.map +1 -1
- package/dist/surfaces/cli/runtime/graph.js +0 -1
- package/dist/surfaces/cli/runtime/graph.js.map +1 -1
- package/dist/surfaces/cli/runtime/settings.d.ts.map +1 -1
- package/dist/surfaces/cli/runtime/settings.js +0 -5
- package/dist/surfaces/cli/runtime/settings.js.map +1 -1
- package/dist/surfaces/cli/runtime/types.d.ts +0 -8
- package/dist/surfaces/cli/runtime/types.d.ts.map +1 -1
- package/dist/surfaces/copilot-instructions/graphflow.md +3 -4
- package/dist/surfaces/cursor-rules/graphflow.mdc +17 -25
- package/dist/surfaces/mcp/tool-definitions.d.ts.map +1 -1
- package/dist/surfaces/mcp/tool-definitions.js +31 -124
- package/dist/surfaces/mcp/tool-definitions.js.map +1 -1
- package/dist/surfaces/mcp/tool-handlers.d.ts.map +1 -1
- package/dist/surfaces/mcp/tool-handlers.js +78 -42
- package/dist/surfaces/mcp/tool-handlers.js.map +1 -1
- package/dist/surfaces/trae-rules/graphflow.md +6 -7
- package/dist/surfaces/trae-skill/graphflow/SKILL.md +66 -75
- package/package.json +2 -2
- package/src/surfaces/antigravity-rules/graphflow.md +5 -6
- package/src/surfaces/copilot-instructions/graphflow.md +3 -4
- package/src/surfaces/cursor-rules/graphflow.mdc +17 -25
- package/src/surfaces/trae-rules/graphflow.md +6 -7
- package/src/surfaces/trae-skill/graphflow/SKILL.md +66 -75
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool-definitions.js","sourceRoot":"","sources":["../../../src/surfaces/mcp/tool-definitions.ts"],"names":[],"mappings":";;AAWA,
|
|
1
|
+
{"version":3,"file":"tool-definitions.js","sourceRoot":"","sources":["../../../src/surfaces/mcp/tool-definitions.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool-handlers.d.ts","sourceRoot":"","sources":["../../../src/surfaces/mcp/tool-handlers.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,cAAc;CAC9B;AAED,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAE/C,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,SAAS,EACnB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,CAAC,
|
|
1
|
+
{"version":3,"file":"tool-handlers.d.ts","sourceRoot":"","sources":["../../../src/surfaces/mcp/tool-handlers.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,cAAc;CAC9B;AAED,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAE/C,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,SAAS,EACnB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAgK3B;AAoHD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAWxE;AA0BD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAW9F"}
|
|
@@ -21,41 +21,78 @@ async function executeToolCall(call, _server, _hooks) {
|
|
|
21
21
|
: [];
|
|
22
22
|
return textResponse(await (0, runtime_1.reportOutcome)(readRequiredString(args.episodeId, "episodeId"), typeof args.success === "boolean" ? args.success : false, lessons, readOptionalString(args.configPath)));
|
|
23
23
|
}
|
|
24
|
-
case "
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
24
|
+
case "graphflow_context": {
|
|
25
|
+
const query = readOptionalString(args.query);
|
|
26
|
+
const anchorId = readOptionalString(args.anchorId);
|
|
27
|
+
if (anchorId && !query) {
|
|
28
|
+
return textResponse(await (0, runtime_1.expandAnchor)(anchorId, readOptionalString(args.configPath), readOptionalString(args.rootDir)));
|
|
29
|
+
}
|
|
30
|
+
if (query && !anchorId) {
|
|
31
|
+
return textResponse(await (0, runtime_1.previewContext)(query, readOptionalString(args.configPath), readOptionalString(args.rootDir), readOptionalString(args.englishQuery)));
|
|
32
|
+
}
|
|
33
|
+
if (query && anchorId) {
|
|
34
|
+
// Both provided: default to preview behavior for backward compatibility
|
|
35
|
+
return textResponse(await (0, runtime_1.previewContext)(query, readOptionalString(args.configPath), readOptionalString(args.rootDir), readOptionalString(args.englishQuery)));
|
|
36
|
+
}
|
|
37
|
+
throw new Error("Either 'query' or 'anchorId' must be provided for graphflow_context.");
|
|
38
|
+
}
|
|
39
|
+
case "graphflow_plan": {
|
|
40
|
+
const mode = readOptionalString(args.mode) || "simple";
|
|
41
|
+
const task = readRequiredString(args.task, "task");
|
|
42
|
+
if (mode === "insight") {
|
|
43
|
+
return textResponse(await (0, runtime_1.planInsightResult)(task, readOptionalString(args.configPath)));
|
|
44
|
+
}
|
|
45
|
+
return textResponse((0, runtime_1.planAndBrainstormResult)(task));
|
|
46
|
+
}
|
|
47
|
+
case "graphflow_index": {
|
|
48
|
+
const filePath = readOptionalString(args.filePath);
|
|
49
|
+
const mode = readOptionalString(args.mode) || "incremental";
|
|
50
|
+
if (filePath) {
|
|
51
|
+
return textResponse(await (0, runtime_1.indexFile)(filePath, readOptionalString(args.configPath)));
|
|
52
|
+
}
|
|
53
|
+
if (mode === "full") {
|
|
54
|
+
return textResponse(await (0, runtime_1.rebuildGraph)(readOptionalString(args.rootDir), readOptionalString(args.configPath)));
|
|
55
|
+
}
|
|
37
56
|
return textResponse(await (0, runtime_1.indexGraph)(readOptionalString(args.rootDir), readOptionalString(args.configPath)));
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
57
|
+
}
|
|
58
|
+
case "graphflow_insight": {
|
|
59
|
+
const mode = readRequiredString(args.mode, "mode");
|
|
60
|
+
const task = readRequiredString(args.task, "task");
|
|
61
|
+
if (mode === "submit") {
|
|
62
|
+
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)));
|
|
63
|
+
}
|
|
64
|
+
if (mode === "merge") {
|
|
65
|
+
return textResponse(await (0, runtime_1.mergeAgentInsightResult)(task, readOptionalString(args.configPath), readOptionalString(args.rootDir)));
|
|
66
|
+
}
|
|
67
|
+
throw new Error(`Invalid mode '${mode}' for graphflow_insight. Use 'submit' or 'merge'.`);
|
|
68
|
+
}
|
|
44
69
|
case "graphflow_skill_insights":
|
|
45
70
|
return textResponse(await (0, runtime_1.getSkillInsights)(readOptionalString(args.configPath), readOptionalNumber(args.limit), readOptionalString(args.rootDir)));
|
|
46
|
-
case "graphflow_diagnose":
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
const
|
|
50
|
-
const
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
71
|
+
case "graphflow_diagnose": {
|
|
72
|
+
const configPath = readOptionalString(args.configPath);
|
|
73
|
+
const health = (0, runtime_1.diagnoseRoutingResult)(configPath);
|
|
74
|
+
const graph = await (0, runtime_1.inspectGraph)(configPath, buildInspectOptions(args));
|
|
75
|
+
const stats = (0, runtime_1.getTokenSavingsStats)(configPath, readOptionalString(args.rootDir));
|
|
76
|
+
return textResponse({
|
|
77
|
+
health,
|
|
78
|
+
graph,
|
|
79
|
+
stats,
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
case "graphflow_artifact": {
|
|
83
|
+
const mode = readRequiredString(args.mode, "mode");
|
|
84
|
+
if (mode === "export") {
|
|
85
|
+
const compressionRaw = readOptionalString(args.compression);
|
|
86
|
+
const compression = compressionRaw === "none" || compressionRaw === "gzip"
|
|
87
|
+
? compressionRaw
|
|
88
|
+
: undefined;
|
|
89
|
+
return textResponse(await (0, runtime_1.exportArtifact)(readOptionalString(args.configPath), readOptionalString(args.outputPath), undefined, compression ? { compression } : undefined));
|
|
90
|
+
}
|
|
91
|
+
if (mode === "import") {
|
|
92
|
+
return textResponse(await (0, runtime_1.importArtifact)(readOptionalString(args.configPath), readOptionalString(args.inputPath)));
|
|
93
|
+
}
|
|
94
|
+
throw new Error(`Invalid mode '${mode}' for graphflow_artifact. Use 'export' or 'import'.`);
|
|
54
95
|
}
|
|
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
96
|
case "graphflow_skill_guide": {
|
|
60
97
|
const section = readOptionalString(args.section) || "all";
|
|
61
98
|
const skillGuide = getSkillGuide(section);
|
|
@@ -129,7 +166,7 @@ function getBuiltInSkillGuide() {
|
|
|
129
166
|
return `## GraphFlow Quick Skill Guide
|
|
130
167
|
|
|
131
168
|
### Core Workflow: Context First
|
|
132
|
-
ALWAYS call \`
|
|
169
|
+
ALWAYS call \`graphflow_context(query)\` BEFORE:
|
|
133
170
|
- Multi-step edits, refactors, or architecture changes
|
|
134
171
|
- Large codebase-wide questions or exploration
|
|
135
172
|
- Debugging across multiple files
|
|
@@ -138,25 +175,24 @@ ALWAYS call \`graphflow_preview_context(query)\` BEFORE:
|
|
|
138
175
|
### Key Tools
|
|
139
176
|
| Tool | Purpose |
|
|
140
177
|
|------|---------|
|
|
141
|
-
| \`
|
|
142
|
-
| \`graphflow_expand_anchor\` | Expand a single anchor to full content |
|
|
178
|
+
| \`graphflow_context\` | Preview compressed context or expand an anchor |
|
|
143
179
|
| \`graphflow_plan\` | Multi-step task decomposition & DAG |
|
|
144
|
-
| \`graphflow_index\` | Incremental workspace re-index |
|
|
145
|
-
| \`
|
|
180
|
+
| \`graphflow_index\` | Incremental workspace re-index or full rebuild |
|
|
181
|
+
| \`graphflow_diagnose\` | Check provider health, graph stats, and token savings |
|
|
146
182
|
|
|
147
183
|
### Best Practices
|
|
148
|
-
1. Start EVERY task with \`
|
|
184
|
+
1. Start EVERY task with \`graphflow_context\`
|
|
149
185
|
2. Only read full files when compressed context is insufficient
|
|
150
186
|
3. Use \`graphflow_plan\` for tasks beyond 2-3 files
|
|
151
187
|
4. Call \`graphflow_index\` after significant changes
|
|
152
188
|
5. Always report token savings to the user
|
|
153
189
|
|
|
154
190
|
### Tool Selection Decision Tree
|
|
155
|
-
- Code question/exploration?
|
|
156
|
-
- Need more detail?
|
|
157
|
-
- Multi-step coding task?
|
|
158
|
-
- File changes made?
|
|
159
|
-
- Graph giving bad results?
|
|
191
|
+
- Code question/exploration? -> \`graphflow_context\`
|
|
192
|
+
- Need more detail? -> \`graphflow_context\` with anchorId
|
|
193
|
+
- Multi-step coding task? -> \`graphflow_context\` -> \`graphflow_plan\` -> implement
|
|
194
|
+
- File changes made? -> \`graphflow_index\` (single file via filePath, or incremental)
|
|
195
|
+
- Graph giving bad results? -> \`graphflow_diagnose\` -> \`graphflow_index\` with mode='full'
|
|
160
196
|
|
|
161
197
|
Call \`graphflow_skill_guide(section: "all")\` for the complete guide.`;
|
|
162
198
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool-handlers.js","sourceRoot":"","sources":["../../../src/surfaces/mcp/tool-handlers.ts"],"names":[],"mappings":";;;AAwCA,
|
|
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
|
|
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 **`
|
|
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
|
|
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
|
|
|
@@ -30,7 +30,7 @@ Code symbols are mostly English. For Chinese user questions:
|
|
|
30
30
|
3. Keep `query` as the original Chinese text.
|
|
31
31
|
|
|
32
32
|
```typescript
|
|
33
|
-
|
|
33
|
+
graphflow_context({
|
|
34
34
|
query: "摄像头锻炼人物角色选择",
|
|
35
35
|
englishQuery: "PoseDetectionPage avatarMode poseService",
|
|
36
36
|
rootDir: "/absolute/path/to/project"
|
|
@@ -41,12 +41,11 @@ graphflow_preview_context({
|
|
|
41
41
|
|
|
42
42
|
| Tool | When |
|
|
43
43
|
|------|------|
|
|
44
|
-
| `
|
|
45
|
-
| `graphflow_expand_anchor` | Need full content of one anchor |
|
|
44
|
+
| `graphflow_context` | **Always first** for code questions (use `query`); need full content of one anchor (use `anchorId`) |
|
|
46
45
|
| `graphflow_plan` | Multi-step tasks |
|
|
47
46
|
| `graphflow_index` | After significant edits |
|
|
48
47
|
|
|
49
|
-
For the full
|
|
48
|
+
For the full 10-tool reference and workflows, use Skill **`#graphflow`** or `@skills/graphflow/SKILL.md`.
|
|
50
49
|
|
|
51
50
|
## Bridge mode
|
|
52
51
|
|