@roarpeng/graphflow 1.4.1 → 1.4.2
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/CHANGELOG.md +13 -0
- package/README.md +3 -3
- package/dist/core/agent-delegation.d.ts +1 -1
- package/dist/core/agent-delegation.d.ts.map +1 -1
- package/dist/graph/context-slicer-types.d.ts +4 -0
- 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 +4 -3
- package/dist/graph/context-slicer.js.map +1 -1
- package/dist/graph/file-indexer-nodes.d.ts.map +1 -1
- package/dist/graph/file-indexer-nodes.js +4 -1
- package/dist/graph/file-indexer-nodes.js.map +1 -1
- package/dist/graph/graph-utils.d.ts +12 -0
- package/dist/graph/graph-utils.d.ts.map +1 -1
- package/dist/graph/graph-utils.js +132 -7
- package/dist/graph/graph-utils.js.map +1 -1
- package/dist/graph/graphify-client.d.ts +0 -2
- package/dist/graph/graphify-client.d.ts.map +1 -1
- package/dist/graph/graphify-client.js +4 -5
- package/dist/graph/graphify-client.js.map +1 -1
- package/dist/graph/graphify-file-client.d.ts.map +1 -1
- package/dist/graph/graphify-file-client.js +2 -3
- package/dist/graph/graphify-file-client.js.map +1 -1
- package/dist/graph/query-expand.d.ts +8 -0
- package/dist/graph/query-expand.d.ts.map +1 -0
- package/dist/graph/query-expand.js +23 -0
- package/dist/graph/query-expand.js.map +1 -0
- package/dist/graph/query-translate.d.ts +7 -0
- package/dist/graph/query-translate.d.ts.map +1 -0
- package/dist/graph/query-translate.js +61 -0
- package/dist/graph/query-translate.js.map +1 -0
- package/dist/graph/sqlite-client.d.ts.map +1 -1
- package/dist/graph/sqlite-client.js +5 -5
- package/dist/graph/sqlite-client.js.map +1 -1
- package/dist/surfaces/cli/runtime/graph.d.ts +1 -1
- package/dist/surfaces/cli/runtime/graph.d.ts.map +1 -1
- package/dist/surfaces/cli/runtime/graph.js +34 -4
- package/dist/surfaces/cli/runtime/graph.js.map +1 -1
- package/dist/surfaces/cli/runtime/types.d.ts +12 -0
- package/dist/surfaces/cli/runtime/types.d.ts.map +1 -1
- package/dist/surfaces/cursor-rules/graphflow.mdc +16 -0
- package/dist/surfaces/mcp/tool-definitions.d.ts.map +1 -1
- package/dist/surfaces/mcp/tool-definitions.js +5 -1
- 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 +1 -1
- package/dist/surfaces/mcp/tool-handlers.js.map +1 -1
- package/dist/surfaces/trae-skill/graphflow/SKILL.md +35 -24
- package/package.json +1 -1
- package/src/surfaces/cursor-rules/graphflow.mdc +16 -0
- package/src/surfaces/trae-skill/graphflow/SKILL.md +35 -24
|
@@ -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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"}
|
|
@@ -113,9 +113,10 @@ Step 4: Read full files only when exact edits required
|
|
|
113
113
|
**Input - preview_context:**
|
|
114
114
|
```typescript
|
|
115
115
|
{
|
|
116
|
-
query: string; // Required -
|
|
117
|
-
|
|
118
|
-
|
|
116
|
+
query: string; // Required - user question (Chinese OK)
|
|
117
|
+
englishQuery?: string; // Agent-translated English code search terms (recommended for CJK)
|
|
118
|
+
configPath?: string;
|
|
119
|
+
rootDir?: string;
|
|
119
120
|
}
|
|
120
121
|
```
|
|
121
122
|
|
|
@@ -123,35 +124,44 @@ Step 4: Read full files only when exact edits required
|
|
|
123
124
|
```typescript
|
|
124
125
|
{
|
|
125
126
|
anchorId: string; // Required - anchor id from preview_context
|
|
126
|
-
configPath?: string;
|
|
127
|
-
rootDir?: string;
|
|
127
|
+
configPath?: string;
|
|
128
|
+
rootDir?: string;
|
|
128
129
|
}
|
|
129
130
|
```
|
|
130
131
|
|
|
131
132
|
**Output structure (preview_context):**
|
|
132
133
|
```typescript
|
|
133
134
|
{
|
|
134
|
-
summary: string[];
|
|
135
|
-
anchors: Array<{
|
|
136
|
-
id: string;
|
|
137
|
-
type: "Module" | "File" | "Symbol";
|
|
138
|
-
layer: "L1" | "L2" | "L3";
|
|
139
|
-
}>;
|
|
135
|
+
summary: string[];
|
|
136
|
+
anchors: Array<{ id: string; type: string; layer: "L1" | "L2" | "L3" }>;
|
|
140
137
|
tokenBudget: {
|
|
141
|
-
maxContextTokens: number;
|
|
142
|
-
estimatedRawTokens: number;
|
|
143
|
-
compressedTokens: number;
|
|
144
|
-
estimatedSavingsPercent: number;
|
|
145
|
-
budgetUsedPercent: number;
|
|
138
|
+
maxContextTokens: number;
|
|
139
|
+
estimatedRawTokens: number;
|
|
140
|
+
compressedTokens: number;
|
|
141
|
+
estimatedSavingsPercent: number;
|
|
142
|
+
budgetUsedPercent: number;
|
|
146
143
|
};
|
|
147
|
-
|
|
144
|
+
agentWorkItems?: Array<{ id: string; kind: string; prompt: string }>; // CJK low-match delegation
|
|
145
|
+
englishQuery?: string;
|
|
148
146
|
}
|
|
149
147
|
```
|
|
150
148
|
|
|
151
|
-
**Always report to user:**
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
149
|
+
**Always report to user:** token savings %, anchor count, key summary findings
|
|
150
|
+
|
|
151
|
+
### Workflow 1b: Chinese / CJK queries (agent translates → English search)
|
|
152
|
+
|
|
153
|
+
**Use when:** User asks in Chinese but the codebase uses English symbols
|
|
154
|
+
|
|
155
|
+
GraphFlow tokenizes CJK and expands workspace path hints. When that is not enough, **YOU must translate** to English code keywords.
|
|
156
|
+
|
|
157
|
+
**Preferred (proactive):**
|
|
158
|
+
```
|
|
159
|
+
Step 1: Translate user intent to English file/symbol terms with YOUR model
|
|
160
|
+
Step 2: graphflow_preview_context({ query: "<Chinese>", englishQuery: "battle combat ...", rootDir })
|
|
161
|
+
Step 3: Use summary + anchors
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
**Fallback:** If `anchorCount < 3` and `agentWorkItems` includes `query-translate-en`, answer JSON prompt and retry with `englishQuery`.
|
|
155
165
|
|
|
156
166
|
---
|
|
157
167
|
|
|
@@ -439,9 +449,10 @@ Always pay attention to `tokenBudget`:
|
|
|
439
449
|
## Troubleshooting
|
|
440
450
|
|
|
441
451
|
### "0 anchors found" or empty results
|
|
442
|
-
1.
|
|
443
|
-
2.
|
|
444
|
-
3. If
|
|
452
|
+
1. **Chinese/CJK:** translate to English keywords; pass `englishQuery` or answer `agentWorkItems` id `query-translate-en`
|
|
453
|
+
2. Check if graph exists: `graphflow_inspect_graph`
|
|
454
|
+
3. If empty: run `graphflow_index`
|
|
455
|
+
4. If still empty: verify `rootDir` points to correct project
|
|
445
456
|
|
|
446
457
|
### Results seem stale
|
|
447
458
|
1. Run `graphflow_index` (incremental, fast)
|
package/package.json
CHANGED
|
@@ -27,6 +27,22 @@ Before broad code exploration, implementation, debugging, review, planning, or a
|
|
|
27
27
|
|
|
28
28
|
Do not scan the whole repository, recursively inspect many files, or read large files before trying GraphFlow context.
|
|
29
29
|
|
|
30
|
+
## Chinese / CJK queries (agent must translate)
|
|
31
|
+
|
|
32
|
+
Code symbols are mostly English. For Chinese user questions:
|
|
33
|
+
|
|
34
|
+
1. **Proactive:** Before or with `graphflow_preview_context`, translate intent to English file/symbol keywords and pass `englishQuery`.
|
|
35
|
+
2. **Reactive:** If preview returns `agentWorkItems` with `query-translate-en` (low `anchorCount`), answer the JSON prompt with your model, then retry preview with `englishQuery`.
|
|
36
|
+
3. Keep `query` as the original Chinese text; use `englishQuery` for search terms only.
|
|
37
|
+
|
|
38
|
+
```typescript
|
|
39
|
+
graphflow_preview_context({
|
|
40
|
+
query: "游戏战斗系统怎么实现的",
|
|
41
|
+
englishQuery: "battle combat fight damage scene system",
|
|
42
|
+
rootDir: "/absolute/path/to/project"
|
|
43
|
+
})
|
|
44
|
+
```
|
|
45
|
+
|
|
30
46
|
## Tool Inventory (18 MCP Tools)
|
|
31
47
|
|
|
32
48
|
### Core Context Tools (Highest Frequency)
|
|
@@ -113,9 +113,10 @@ Step 4: Read full files only when exact edits required
|
|
|
113
113
|
**Input - preview_context:**
|
|
114
114
|
```typescript
|
|
115
115
|
{
|
|
116
|
-
query: string; // Required -
|
|
117
|
-
|
|
118
|
-
|
|
116
|
+
query: string; // Required - user question (Chinese OK)
|
|
117
|
+
englishQuery?: string; // Agent-translated English code search terms (recommended for CJK)
|
|
118
|
+
configPath?: string;
|
|
119
|
+
rootDir?: string;
|
|
119
120
|
}
|
|
120
121
|
```
|
|
121
122
|
|
|
@@ -123,35 +124,44 @@ Step 4: Read full files only when exact edits required
|
|
|
123
124
|
```typescript
|
|
124
125
|
{
|
|
125
126
|
anchorId: string; // Required - anchor id from preview_context
|
|
126
|
-
configPath?: string;
|
|
127
|
-
rootDir?: string;
|
|
127
|
+
configPath?: string;
|
|
128
|
+
rootDir?: string;
|
|
128
129
|
}
|
|
129
130
|
```
|
|
130
131
|
|
|
131
132
|
**Output structure (preview_context):**
|
|
132
133
|
```typescript
|
|
133
134
|
{
|
|
134
|
-
summary: string[];
|
|
135
|
-
anchors: Array<{
|
|
136
|
-
id: string;
|
|
137
|
-
type: "Module" | "File" | "Symbol";
|
|
138
|
-
layer: "L1" | "L2" | "L3";
|
|
139
|
-
}>;
|
|
135
|
+
summary: string[];
|
|
136
|
+
anchors: Array<{ id: string; type: string; layer: "L1" | "L2" | "L3" }>;
|
|
140
137
|
tokenBudget: {
|
|
141
|
-
maxContextTokens: number;
|
|
142
|
-
estimatedRawTokens: number;
|
|
143
|
-
compressedTokens: number;
|
|
144
|
-
estimatedSavingsPercent: number;
|
|
145
|
-
budgetUsedPercent: number;
|
|
138
|
+
maxContextTokens: number;
|
|
139
|
+
estimatedRawTokens: number;
|
|
140
|
+
compressedTokens: number;
|
|
141
|
+
estimatedSavingsPercent: number;
|
|
142
|
+
budgetUsedPercent: number;
|
|
146
143
|
};
|
|
147
|
-
|
|
144
|
+
agentWorkItems?: Array<{ id: string; kind: string; prompt: string }>; // CJK low-match delegation
|
|
145
|
+
englishQuery?: string;
|
|
148
146
|
}
|
|
149
147
|
```
|
|
150
148
|
|
|
151
|
-
**Always report to user:**
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
149
|
+
**Always report to user:** token savings %, anchor count, key summary findings
|
|
150
|
+
|
|
151
|
+
### Workflow 1b: Chinese / CJK queries (agent translates → English search)
|
|
152
|
+
|
|
153
|
+
**Use when:** User asks in Chinese but the codebase uses English symbols
|
|
154
|
+
|
|
155
|
+
GraphFlow tokenizes CJK and expands workspace path hints. When that is not enough, **YOU must translate** to English code keywords.
|
|
156
|
+
|
|
157
|
+
**Preferred (proactive):**
|
|
158
|
+
```
|
|
159
|
+
Step 1: Translate user intent to English file/symbol terms with YOUR model
|
|
160
|
+
Step 2: graphflow_preview_context({ query: "<Chinese>", englishQuery: "battle combat ...", rootDir })
|
|
161
|
+
Step 3: Use summary + anchors
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
**Fallback:** If `anchorCount < 3` and `agentWorkItems` includes `query-translate-en`, answer JSON prompt and retry with `englishQuery`.
|
|
155
165
|
|
|
156
166
|
---
|
|
157
167
|
|
|
@@ -439,9 +449,10 @@ Always pay attention to `tokenBudget`:
|
|
|
439
449
|
## Troubleshooting
|
|
440
450
|
|
|
441
451
|
### "0 anchors found" or empty results
|
|
442
|
-
1.
|
|
443
|
-
2.
|
|
444
|
-
3. If
|
|
452
|
+
1. **Chinese/CJK:** translate to English keywords; pass `englishQuery` or answer `agentWorkItems` id `query-translate-en`
|
|
453
|
+
2. Check if graph exists: `graphflow_inspect_graph`
|
|
454
|
+
3. If empty: run `graphflow_index`
|
|
455
|
+
4. If still empty: verify `rootDir` points to correct project
|
|
445
456
|
|
|
446
457
|
### Results seem stale
|
|
447
458
|
1. Run `graphflow_index` (incremental, fast)
|