@roarpeng/graphflow 1.4.1 → 1.4.3
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 +30 -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 +21 -1
- package/dist/graph/graph-utils.d.ts.map +1 -1
- package/dist/graph/graph-utils.js +207 -10
- 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 +29 -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 +63 -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 +16 -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 +37 -24
- package/package.json +1 -1
- package/src/surfaces/cursor-rules/graphflow.mdc +16 -0
- package/src/surfaces/trae-skill/graphflow/SKILL.md +37 -24
|
@@ -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/class/component names** (e.g. `PoseDetectionPage`, `BattlePage`, `shieldEffect`) and pass `englishQuery`. Avoid generic terms like `exercise` when the user means UI/camera — they often match data/types layers.
|
|
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)
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool-definitions.d.ts","sourceRoot":"","sources":["../../../src/surfaces/mcp/tool-definitions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;CACH;AAED,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,
|
|
1
|
+
{"version":3,"file":"tool-definitions.d.ts","sourceRoot":"","sources":["../../../src/surfaces/mcp/tool-definitions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;CACH;AAED,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAsPrD"}
|
|
@@ -80,11 +80,15 @@ function getToolDefinitions() {
|
|
|
80
80
|
},
|
|
81
81
|
{
|
|
82
82
|
name: "graphflow_preview_context",
|
|
83
|
-
description: "[Core] Preview GraphFlow near-lossless context packaging for a query. ALWAYS CALL THIS FIRST for code exploration, multi-step edits, refactors, debugging, or codebase-wide questions. Returns compressed context with anchors (Symbol/File/Module pointers) and token budget showing 70-95% savings.
|
|
83
|
+
description: "[Core] Preview GraphFlow near-lossless context packaging for a query. ALWAYS CALL THIS FIRST for code exploration, multi-step edits, refactors, debugging, or codebase-wide questions. Returns compressed context with anchors (Symbol/File/Module pointers) and token budget showing 70-95% savings. For Chinese/CJK queries, pass englishQuery (agent-translated English code keywords) or answer agentWorkItems when anchorCount is low.",
|
|
84
84
|
inputSchema: {
|
|
85
85
|
type: "object",
|
|
86
86
|
properties: {
|
|
87
87
|
query: { type: "string", description: "Query to preview. Be specific about what you need to understand." },
|
|
88
|
+
englishQuery: {
|
|
89
|
+
type: "string",
|
|
90
|
+
description: "Optional English code-search keywords when query is Chinese/CJK. The connected agent should translate user intent to English file/symbol terms before or after the first preview call.",
|
|
91
|
+
},
|
|
88
92
|
configPath: { type: "string", description: "Optional path to graphflow.config.json." },
|
|
89
93
|
rootDir: { type: "string", description: "Optional workspace root override." },
|
|
90
94
|
},
|
|
@@ -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,CAwH3B;AAqHD,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"}
|
|
@@ -30,7 +30,7 @@ async function executeToolCall(call, _server, _hooks) {
|
|
|
30
30
|
case "graphflow_plan_insight":
|
|
31
31
|
return textResponse(await (0, runtime_1.planInsightResult)(readRequiredString(args.task, "task"), readOptionalString(args.configPath)));
|
|
32
32
|
case "graphflow_preview_context":
|
|
33
|
-
return textResponse(await (0, runtime_1.previewContext)(readRequiredString(args.query, "query"), readOptionalString(args.configPath), readOptionalString(args.rootDir)));
|
|
33
|
+
return textResponse(await (0, runtime_1.previewContext)(readRequiredString(args.query, "query"), readOptionalString(args.configPath), readOptionalString(args.rootDir), readOptionalString(args.englishQuery)));
|
|
34
34
|
case "graphflow_expand_anchor":
|
|
35
35
|
return textResponse(await (0, runtime_1.expandAnchor)(readRequiredString(args.anchorId, "anchorId"), readOptionalString(args.configPath), readOptionalString(args.rootDir)));
|
|
36
36
|
case "graphflow_index":
|
|
@@ -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,46 @@ 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: "PoseDetectionPage avatarMode BattlePage shieldEffect", rootDir })
|
|
161
|
+
Step 3: Use summary + anchors
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
Use **exact file/class/component names** (PascalCase stems). Avoid generic words like `exercise` when the user means camera/pose UI — that word often hits data/types layers instead of pages.
|
|
165
|
+
|
|
166
|
+
**Fallback:** If `anchorCount < 3` and `agentWorkItems` includes `query-translate-en`, answer JSON prompt and retry with `englishQuery`.
|
|
155
167
|
|
|
156
168
|
---
|
|
157
169
|
|
|
@@ -439,9 +451,10 @@ Always pay attention to `tokenBudget`:
|
|
|
439
451
|
## Troubleshooting
|
|
440
452
|
|
|
441
453
|
### "0 anchors found" or empty results
|
|
442
|
-
1.
|
|
443
|
-
2.
|
|
444
|
-
3. If
|
|
454
|
+
1. **Chinese/CJK:** translate to English keywords; pass `englishQuery` or answer `agentWorkItems` id `query-translate-en`
|
|
455
|
+
2. Check if graph exists: `graphflow_inspect_graph`
|
|
456
|
+
3. If empty: run `graphflow_index`
|
|
457
|
+
4. If still empty: verify `rootDir` points to correct project
|
|
445
458
|
|
|
446
459
|
### Results seem stale
|
|
447
460
|
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/class/component names** (e.g. `PoseDetectionPage`, `BattlePage`, `shieldEffect`) and pass `englishQuery`. Avoid generic terms like `exercise` when the user means UI/camera — they often match data/types layers.
|
|
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,46 @@ 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: "PoseDetectionPage avatarMode BattlePage shieldEffect", rootDir })
|
|
161
|
+
Step 3: Use summary + anchors
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
Use **exact file/class/component names** (PascalCase stems). Avoid generic words like `exercise` when the user means camera/pose UI — that word often hits data/types layers instead of pages.
|
|
165
|
+
|
|
166
|
+
**Fallback:** If `anchorCount < 3` and `agentWorkItems` includes `query-translate-en`, answer JSON prompt and retry with `englishQuery`.
|
|
155
167
|
|
|
156
168
|
---
|
|
157
169
|
|
|
@@ -439,9 +451,10 @@ Always pay attention to `tokenBudget`:
|
|
|
439
451
|
## Troubleshooting
|
|
440
452
|
|
|
441
453
|
### "0 anchors found" or empty results
|
|
442
|
-
1.
|
|
443
|
-
2.
|
|
444
|
-
3. If
|
|
454
|
+
1. **Chinese/CJK:** translate to English keywords; pass `englishQuery` or answer `agentWorkItems` id `query-translate-en`
|
|
455
|
+
2. Check if graph exists: `graphflow_inspect_graph`
|
|
456
|
+
3. If empty: run `graphflow_index`
|
|
457
|
+
4. If still empty: verify `rootDir` points to correct project
|
|
445
458
|
|
|
446
459
|
### Results seem stale
|
|
447
460
|
1. Run `graphflow_index` (incremental, fast)
|