@devflow-tools/context-engine 0.8.10 → 0.8.11

package/README.md

@@ -1,6 +1,6 @@
 # @devflow-tools/context-engine
 
-Context engine for DevFlow — intelligently retrieves the most relevant code snippets for natural language queries.
+DevFlow 上下文引擎 — 智能代码检索，支持通用上下文、Onboarding Pack 和任务级上下文构建。
 
 ## Installation
 
@@ -14,24 +14,32 @@ npm install @devflow-tools/context-engine
 import { ContextEngine } from '@devflow-tools/context-engine';
 
 const engine = new ContextEngine({ projectRoot: '/path/to/project' });
+
+// 构建通用上下文
 const context = await engine.buildContext('user authentication flow');
 console.log(context.files);
+
+// 构建任务级上下文（含风险提示、下一步行动）
+const taskContext = await engine.buildTaskContext('fix the login bug');
 ```
 
 ## Features
 
-- **Intent parsing** — extract keywords from natural language queries
-- **Fuzzy search** — find relevant symbols even with partial matches
-- **Multi-dimensional ranking** — combines dependency graph, memory, and knowledge signals
-- **Token budget control** — compress results to fit context windows (fast/deep modes)
+- **通用上下文** — 自然语言查询 → 最相关代码片段，结合依赖图、记忆、知识库多维度排序
+- **Onboarding Pack** — 项目新手包自动生成（统计、分层、关键模块/文件/符号、推荐插件/工作流）
+- **Task Context** — 任务类型识别（debug/feature/understand/review/refactor），文件分组（required/optional），风险提示和下一步行动推荐
+- **Token 预算控制** — fast/deep 模式自动压缩结果拟合 context window
+- **Intent 解析** — 从自然语言提取关键词和意图
+- **反馈系统** — 支持 hit/partial/miss 反馈，持续优化排序
 
 ## API
 
-- `createEngines(projectRoot)` — initialize all engines (indexer, graph, context)
-- `ContextEngine` — context building engine
-- `parseIntent(query)` — parse user query into structured intent
-- `fuzzySearch(query, symbols)` — fuzzy symbol search
-- `compressToTokenLimit(text, limit)` — compress context to token budget
+- `new ContextEngine({ projectRoot })` — 构造函数
+- `.buildContext(query, options?)` — 通用上下文检索
+- `.buildTaskContext(query, options?)` — 任务级上下文（含风险提示、下一步行动）
+- `.onboard()` — 生成 Onboarding Pack
+- `.submitFeedback(contextId, rating)` — 提交上下文反馈
+- `.getFeedbackSummary()` — 反馈汇总
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/context-engine",
-  "version": "0.8.10",
+  "version": "0.8.11",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,10 +18,10 @@
   },
   "dependencies": {
     "@colbymchenry/codegraph": "^1.1.1",
-    "@devflow-tools/knowledge-engine": "^0.8.10",
-    "@devflow-tools/memory-engine": "^0.8.10",
-    "@devflow-tools/sdk": "^0.8.10",
-    "@devflow-tools/telemetry": "^0.8.10"
+    "@devflow-tools/knowledge-engine": "^0.8.11",
+    "@devflow-tools/memory-engine": "^0.8.11",
+    "@devflow-tools/sdk": "^0.8.11",
+    "@devflow-tools/telemetry": "^0.8.11"
   },
   "devDependencies": {
     "typescript": "^5.5.0",
@@ -30,5 +30,5 @@
   "files": [
     "dist"
   ],
-  "gitHead": "ac4f93d6a52fa40b4126b514e899eee581f8f46e"
+  "gitHead": "a0a0b61377aa88ebbd380f50a5d532f63175ef45"
 }