maestro-flow 0.5.2 → 0.5.31

package/dist/src/graph/kg/extraction/orchestrator.js

@@ -0,0 +1,220 @@
+// src/graph/kg/extraction/orchestrator.ts — 统一编排: code + knowledge → 同一 DB
+// 参考: plan-maestrograph.md 第三节 Unified Extraction Pipeline
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { MaestroGraph } from '../engine.js';
+import { extractDomain } from './knowledge/domain-extractor.js';
+import { extractSpec } from './knowledge/spec-extractor.js';
+import { extractWiki } from './knowledge/wiki-extractor.js';
+import { extractCodebase } from './knowledge/codebase-extractor.js';
+import { extractIssues } from './knowledge/issue-extractor.js';
+import { extractCode } from './code/code-extractor.js';
+import { resolveKnowledgeEdges } from '../resolution/knowledge-resolver.js';
+export async function syncKnowledgeGraph(projectPath, options) {
+    const workflowRoot = resolve(projectPath, '.workflow');
+    const results = [];
+    // 初始化或打开 DB
+    let mg;
+    const dbPath = resolve(workflowRoot, 'kg', 'maestro.db');
+    if (existsSync(dbPath)) {
+        mg = await MaestroGraph.open(projectPath);
+    }
+    else {
+        mg = await MaestroGraph.init(projectPath);
+    }
+    try {
+        const shouldSync = (source) => {
+            if (!options?.sources)
+                return true;
+            return options.sources.includes(source);
+        };
+        // ── Knowledge sources (优先同步) ───────────────────────────────
+        // 同步前清理旧节点（ON DELETE CASCADE 会级联删除关联 edges）
+        const queries = mg.getQueryBuilder();
+        if (shouldSync('domain')) {
+            const startMs = Date.now();
+            const domainResult = extractDomain(resolve(workflowRoot, 'domain', 'glossary.json'), workflowRoot);
+            const removed = mg.getConnection().transaction(() => {
+                const n = queries.deleteNodesBySourceType('domain');
+                if (domainResult.nodes.length > 0) {
+                    mg.insertExtractionResults(domainResult);
+                }
+                return n;
+            });
+            results.push({
+                source: 'domain',
+                nodesAdded: domainResult.nodes.length,
+                nodesUpdated: 0,
+                nodesRemoved: removed,
+                edgesAdded: domainResult.edges.length,
+                edgesRemoved: 0,
+                durationMs: Date.now() - startMs,
+            });
+        }
+        if (shouldSync('spec')) {
+            const startMs = Date.now();
+            const specDir = resolve(workflowRoot, 'specs');
+            const specResult = extractSpec(specDir, workflowRoot);
+            const removed = mg.getConnection().transaction(() => {
+                const n = queries.deleteNodesBySourceType('spec');
+                if (specResult.nodes.length > 0) {
+                    mg.insertExtractionResults(specResult);
+                }
+                return n;
+            });
+            results.push({
+                source: 'spec',
+                nodesAdded: specResult.nodes.length,
+                nodesUpdated: 0,
+                nodesRemoved: removed,
+                edgesAdded: specResult.edges.length,
+                edgesRemoved: 0,
+                durationMs: Date.now() - startMs,
+            });
+        }
+        if (shouldSync('knowhow')) {
+            const startMs = Date.now();
+            const knowhowDir = resolve(workflowRoot, 'knowhow');
+            const wikiResult = extractWiki(knowhowDir, workflowRoot);
+            const removed = mg.getConnection().transaction(() => {
+                const n = queries.deleteNodesBySourceType('knowhow');
+                if (wikiResult.nodes.length > 0) {
+                    mg.insertExtractionResults(wikiResult);
+                }
+                return n;
+            });
+            results.push({
+                source: 'knowhow',
+                nodesAdded: wikiResult.nodes.length,
+                nodesUpdated: 0,
+                nodesRemoved: removed,
+                edgesAdded: wikiResult.edges.length,
+                edgesRemoved: 0,
+                durationMs: Date.now() - startMs,
+            });
+        }
+        if (shouldSync('codebase')) {
+            const startMs = Date.now();
+            const codebaseDir = resolve(workflowRoot, 'codebase');
+            const codebaseResult = extractCodebase(codebaseDir, workflowRoot);
+            const removed = mg.getConnection().transaction(() => {
+                const n = queries.deleteNodesBySourceType('codebase');
+                if (codebaseResult.nodes.length > 0) {
+                    mg.insertExtractionResults(codebaseResult);
+                }
+                return n;
+            });
+            results.push({
+                source: 'codebase',
+                nodesAdded: codebaseResult.nodes.length,
+                nodesUpdated: 0,
+                nodesRemoved: removed,
+                edgesAdded: codebaseResult.edges.length,
+                edgesRemoved: 0,
+                durationMs: Date.now() - startMs,
+            });
+        }
+        if (shouldSync('issue')) {
+            const startMs = Date.now();
+            const issuesPath = resolve(workflowRoot, 'issues', 'issues.jsonl');
+            const issueResult = extractIssues(issuesPath, workflowRoot);
+            const removed = mg.getConnection().transaction(() => {
+                const n = queries.deleteNodesBySourceType('issue');
+                if (issueResult.nodes.length > 0) {
+                    mg.insertExtractionResults(issueResult);
+                }
+                return n;
+            });
+            results.push({
+                source: 'issue',
+                nodesAdded: issueResult.nodes.length,
+                nodesUpdated: 0,
+                nodesRemoved: removed,
+                edgesAdded: issueResult.edges.length,
+                edgesRemoved: 0,
+                durationMs: Date.now() - startMs,
+            });
+        }
+        // ── Code extraction (R3) ───────────────────────────────────────
+        if (shouldSync('codegraph')) {
+            const startMs = Date.now();
+            const removedCode = queries.deleteNodesBySourceType('codegraph');
+            const preferredDirs = ['src', 'lib', 'app', 'packages', 'apps', 'dashboard/src'];
+            const srcDirs = preferredDirs
+                .map(d => resolve(projectPath, d))
+                .filter(d => existsSync(d));
+            if (srcDirs.length === 0) {
+                srcDirs.push(projectPath);
+            }
+            let totalNodes = 0;
+            let totalEdges = 0;
+            for (const srcDir of srcDirs) {
+                if (!existsSync(srcDir))
+                    continue;
+                const codeResult = await extractCode({
+                    srcDir,
+                    projectRoot: projectPath,
+                    includeTests: false,
+                    maxFileSize: 500 * 1024,
+                });
+                for (const result of codeResult.results) {
+                    if (result.nodes.length > 0) {
+                        try {
+                            mg.insertExtractionResults(result);
+                        }
+                        catch {
+                            // FK or unique constraint — insert nodes only, skip edges
+                            try {
+                                mg.getQueryBuilder().insertNodes(result.nodes);
+                                mg.getQueryBuilder().upsertFile(result.fileRecord);
+                            }
+                            catch { /* skip this file entirely */ }
+                        }
+                    }
+                }
+                totalNodes += codeResult.stats.nodesCreated;
+                totalEdges += codeResult.stats.edgesCreated;
+            }
+            results.push({
+                source: 'codegraph',
+                nodesAdded: totalNodes,
+                nodesUpdated: 0,
+                nodesRemoved: removedCode,
+                edgesAdded: totalEdges,
+                edgesRemoved: 0,
+                durationMs: Date.now() - startMs,
+            });
+        }
+        // ── Cross-source edge resolution ────────────────────────────────
+        const resolveStartMs = Date.now();
+        const resolveResult = resolveKnowledgeEdges(mg.getConnection().raw, { projectPath });
+        results.push({
+            source: 'knowledge-resolution',
+            nodesAdded: 0,
+            nodesUpdated: 0,
+            nodesRemoved: 0,
+            edgesAdded: resolveResult.totalEdgesCreated,
+            edgesRemoved: 0,
+            durationMs: resolveResult.durationMs,
+        });
+        // ── Credibility hash sync (incremental) ────────────────────────
+        try {
+            const { CredibilityStore, contentHash } = await import('../credibility.js');
+            const store = new CredibilityStore(mg.getConnection().raw);
+            const knowledgeSources = ['domain', 'spec', 'knowhow', 'codebase', 'issue'];
+            const knowledgeNodes = mg.getConnection().raw.prepare(`SELECT id, body FROM nodes WHERE source_type IN (${knowledgeSources.map(() => '?').join(',')}) AND body IS NOT NULL AND body != ''`).all(...knowledgeSources);
+            const nowMs = Date.now();
+            for (const node of knowledgeNodes) {
+                store.upsert(node.id, contentHash(node.body), nowMs);
+            }
+        }
+        catch {
+            // Credibility sync is best-effort — never fail the extraction pipeline
+        }
+        return results;
+    }
+    finally {
+        mg.close();
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/src/graph/kg/extraction/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../../../../src/graph/kg/extraction/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/src/graph/kg/index.d.ts

@@ -0,0 +1,29 @@
+export { MaestroGraph } from './engine.js';
+export { KgDatabaseConnection, KgQueryBuilder, getKgDatabasePath, sanitizeFtsQuery, makeNodeId, validateNodeId } from './db/index.js';
+export type { UnifiedNode, UnifiedEdge, FileRecord, ExtractionResult, ResolutionResult, SyncResult, UnifiedSearchResult, UnifiedGraphStats, UnifiedNodeKind, UnifiedEdgeKind, CodeNodeKind, KnowledgeNodeKind, CodeEdgeKind, KnowledgeEdgeKind, Language, SourceType, EdgeProvenance, NodeIdPrefix, Visibility, UNIFIED_NODE_KINDS, CODE_NODE_KINDS, KNOWLEDGE_NODE_KINDS, LANGUAGES, SOURCE_TYPES, } from './db/types.js';
+export { extractCode } from './extraction/code/code-extractor.js';
+export { syncKnowledgeGraph } from './extraction/orchestrator.js';
+export { extractDomain } from './extraction/knowledge/domain-extractor.js';
+export { extractSpec } from './extraction/knowledge/spec-extractor.js';
+export { extractWiki } from './extraction/knowledge/wiki-extractor.js';
+export { extractCodebase } from './extraction/knowledge/codebase-extractor.js';
+export { extractIssues } from './extraction/knowledge/issue-extractor.js';
+export { TreeSitterEngine, isTreeSitterAvailable, getTreeSitterEngine } from './extraction/code/tree-sitter.js';
+export { isGeneratedFile, isTestFile, shouldDegradeInSearch } from './extraction/code/generated-detection.js';
+export { ensureWasmStability, cleanupWasmStability } from './extraction/code/wasm-stability.js';
+export { getExtractor, getSupportedLanguages, detectLanguageFromPath } from './extraction/code/languages/index.js';
+export { resolveKnowledgeEdges, expandRelated } from './resolution/index.js';
+export { matchReference, tokenize } from './resolution/name-matcher.js';
+export { ImportResolver } from './resolution/import-resolver.js';
+export { runCallbackSynthesis } from './resolution/callback-synthesizer.js';
+export { getRegisteredFrameworks, detectFrameworks } from './resolution/frameworks/index.js';
+export { searchUnified, searchCodeOnly, searchKnowledgeOnly, parseQuery } from './query/search.js';
+export { bfs, traceCallChain, getCallers, getCallees, getImpactRadius, findShortestPath } from './query/traversal.js';
+export { buildContext, getAgentCategories } from './query/context-builder.js';
+export { computeScore, kindBonus, scorePathRelevance, nameMatchBonus } from './query/scoring.js';
+export { FileLock, runIncrementalSync, computeFileHash, hasFileChanged } from './sync/incremental-sync.js';
+export { isWSL2, isOnDrvFs, decideWatchStrategy, areGitHooksInstalled } from './sync/watch-policy.js';
+export { registerKgCommands } from './surface/cli.js';
+export { KG_MCP_TOOLS, handleMcpTool, precheckKg } from './surface/mcp-tools.js';
+export { evaluateUnifiedInjection, isUnifiedInjectorActive } from './surface/hook-injector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/graph/kg/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/graph/kg/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACtI,YAAY,EACV,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EACtD,gBAAgB,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EACpE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EACjE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EACrE,YAAY,EAAE,UAAU,EACxB,kBAAkB,EAAE,eAAe,EAAE,oBAAoB,EACzD,SAAS,EAAE,YAAY,GACxB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAChH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAC9G,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAGnH,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAG7F,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGjG,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC3G,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGtG,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/graph/kg/index.js

@@ -0,0 +1,35 @@
+// src/graph/kg/index.ts — MaestroGraph 模块导出
+export { MaestroGraph } from './engine.js';
+export { KgDatabaseConnection, KgQueryBuilder, getKgDatabasePath, sanitizeFtsQuery, makeNodeId, validateNodeId } from './db/index.js';
+// Extraction
+export { extractCode } from './extraction/code/code-extractor.js';
+export { syncKnowledgeGraph } from './extraction/orchestrator.js';
+export { extractDomain } from './extraction/knowledge/domain-extractor.js';
+export { extractSpec } from './extraction/knowledge/spec-extractor.js';
+export { extractWiki } from './extraction/knowledge/wiki-extractor.js';
+export { extractCodebase } from './extraction/knowledge/codebase-extractor.js';
+export { extractIssues } from './extraction/knowledge/issue-extractor.js';
+// Code extraction
+export { TreeSitterEngine, isTreeSitterAvailable, getTreeSitterEngine } from './extraction/code/tree-sitter.js';
+export { isGeneratedFile, isTestFile, shouldDegradeInSearch } from './extraction/code/generated-detection.js';
+export { ensureWasmStability, cleanupWasmStability } from './extraction/code/wasm-stability.js';
+export { getExtractor, getSupportedLanguages, detectLanguageFromPath } from './extraction/code/languages/index.js';
+// Resolution
+export { resolveKnowledgeEdges, expandRelated } from './resolution/index.js';
+export { matchReference, tokenize } from './resolution/name-matcher.js';
+export { ImportResolver } from './resolution/import-resolver.js';
+export { runCallbackSynthesis } from './resolution/callback-synthesizer.js';
+export { getRegisteredFrameworks, detectFrameworks } from './resolution/frameworks/index.js';
+// Query
+export { searchUnified, searchCodeOnly, searchKnowledgeOnly, parseQuery } from './query/search.js';
+export { bfs, traceCallChain, getCallers, getCallees, getImpactRadius, findShortestPath } from './query/traversal.js';
+export { buildContext, getAgentCategories } from './query/context-builder.js';
+export { computeScore, kindBonus, scorePathRelevance, nameMatchBonus } from './query/scoring.js';
+// Sync
+export { FileLock, runIncrementalSync, computeFileHash, hasFileChanged } from './sync/incremental-sync.js';
+export { isWSL2, isOnDrvFs, decideWatchStrategy, areGitHooksInstalled } from './sync/watch-policy.js';
+// Surface
+export { registerKgCommands } from './surface/cli.js';
+export { KG_MCP_TOOLS, handleMcpTool, precheckKg } from './surface/mcp-tools.js';
+export { evaluateUnifiedInjection, isUnifiedInjectorActive } from './surface/hook-injector.js';
+//# sourceMappingURL=index.js.map

package/dist/src/graph/kg/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/graph/kg/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAWtI,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE1E,kBAAkB;AAClB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAChH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAC9G,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAEnH,aAAa;AACb,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEjG,OAAO;AACP,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC3G,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEtG,UAAU;AACV,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/graph/kg/query/context-builder.d.ts

@@ -0,0 +1,38 @@
+import type { KgQueryBuilder } from '../db/queries.js';
+import type { SourceType } from '../db/types.js';
+export interface ContextSection {
+    label: string;
+    lines: string[];
+    sourceType: SourceType;
+    relevance: number;
+}
+export interface ContextBudget {
+    maxTotalChars: number;
+    maxSections: number;
+    maxCharsPerSection: number;
+}
+export interface BuiltContext {
+    sections: ContextSection[];
+    totalChars: number;
+    summary: {
+        codeSymbols: number;
+        domainTerms: number;
+        specRules: number;
+        knowhowDocs: number;
+    };
+}
+/**
+ * 从查询结果构建 agent 上下文
+ *
+ * 1. FTS5 搜索 → 直接命中
+ * 2. 图遍历 → 1-hop 关联
+ * 3. 按 source_type 分组组装 sections
+ * 4. Context budget 管控
+ */
+export declare function buildContext(queries: KgQueryBuilder, prompt: string, options?: {
+    budget?: Partial<ContextBudget>;
+    expandDepth?: number;
+    agentType?: string;
+}): BuiltContext;
+export declare function getAgentCategories(agentType: string): string[];
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/src/graph/kg/query/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../../src/graph/kg/query/context-builder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAA4B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAQ3E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAYD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,YAAY,CA8Hd;AA2DD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9D"}

package/dist/src/graph/kg/query/context-builder.js

@@ -0,0 +1,184 @@
+// src/graph/kg/query/context-builder.ts — 上下文组装 (for hook inject)
+// 参考: plan-maestrograph.md 统一 Hook Injector 设计
+import { searchUnified } from './search.js';
+import { bfs } from './traversal.js';
+const DEFAULT_BUDGET = {
+    maxTotalChars: 8000,
+    maxSections: 10,
+    maxCharsPerSection: 2000,
+};
+/**
+ * 从查询结果构建 agent 上下文
+ *
+ * 1. FTS5 搜索 → 直接命中
+ * 2. 图遍历 → 1-hop 关联
+ * 3. 按 source_type 分组组装 sections
+ * 4. Context budget 管控
+ */
+export function buildContext(queries, prompt, options) {
+    const budget = { ...DEFAULT_BUDGET, ...options?.budget };
+    const expandDepth = options?.expandDepth ?? 1;
+    // Step 1: FTS5 搜索
+    const { directMatches, summary } = searchUnified(queries, prompt, {
+        limit: 15,
+        includeCode: true,
+        includeKnowledge: true,
+    });
+    // Step 2: 图遍历 — 从命中节点扩展 1 hop
+    const relatedNodes = new Map();
+    const seedIds = directMatches.map(m => m.node.id);
+    if (expandDepth > 0 && seedIds.length > 0) {
+        for (const seedId of seedIds.slice(0, 5)) { // 限制种子数避免爆炸
+            const traversal = bfs(queries, seedId, {
+                maxDepth: expandDepth,
+                maxNodes: 10,
+            });
+            for (const [id, node] of traversal.nodes) {
+                if (!seedIds.includes(id)) {
+                    relatedNodes.set(id, node);
+                }
+            }
+        }
+    }
+    // Step 3: 按 source_type 分组
+    const sections = [];
+    const allNodes = new Map();
+    for (const m of directMatches)
+        allNodes.set(m.node.id, m.node);
+    for (const [id, node] of relatedNodes)
+        allNodes.set(id, node);
+    // Domain terms
+    const domainNodes = [...allNodes.values()].filter(n => n.sourceType === 'domain');
+    if (domainNodes.length > 0) {
+        sections.push({
+            label: `domain[${domainNodes.map(n => n.name).join(',')}]`,
+            lines: formatDomainNodes(domainNodes),
+            sourceType: 'domain',
+            relevance: domainNodes.length * 3,
+        });
+    }
+    // Spec entries
+    const specNodes = [...allNodes.values()].filter(n => n.sourceType === 'spec');
+    if (specNodes.length > 0) {
+        sections.push({
+            label: `spec[${specNodes.map(n => n.category).join(',')}]`,
+            lines: formatSpecNodes(specNodes),
+            sourceType: 'spec',
+            relevance: specNodes.length * 2,
+        });
+    }
+    // Knowhow docs
+    const knowhowNodes = [...allNodes.values()].filter(n => n.sourceType === 'knowhow');
+    if (knowhowNodes.length > 0) {
+        sections.push({
+            label: `knowhow[${knowhowNodes.map(n => n.name).join(',')}]`,
+            lines: formatKnowhowNodes(knowhowNodes),
+            sourceType: 'knowhow',
+            relevance: knowhowNodes.length * 2,
+        });
+    }
+    // Code symbols
+    const codeNodes = [...allNodes.values()].filter(n => n.sourceType === 'codegraph');
+    if (codeNodes.length > 0) {
+        sections.push({
+            label: `code[${codeNodes.map(n => n.name).join(',')}]`,
+            lines: formatCodeNodes(codeNodes),
+            sourceType: 'codegraph',
+            relevance: codeNodes.length,
+        });
+    }
+    // Codebase docs
+    const codebaseNodes = [...allNodes.values()].filter(n => n.sourceType === 'codebase');
+    if (codebaseNodes.length > 0) {
+        sections.push({
+            label: `codebase[${codebaseNodes.map(n => n.name).join(',')}]`,
+            lines: formatCodebaseNodes(codebaseNodes),
+            sourceType: 'codebase',
+            relevance: codebaseNodes.length,
+        });
+    }
+    // Issues
+    const issueNodes = [...allNodes.values()].filter(n => n.sourceType === 'issue');
+    if (issueNodes.length > 0) {
+        sections.push({
+            label: `issues[${issueNodes.map(n => n.name).join(',')}]`,
+            lines: formatIssueNodes(issueNodes),
+            sourceType: 'issue',
+            relevance: issueNodes.length,
+        });
+    }
+    // Step 4: Context budget 管控
+    const prioritized = sections.sort((a, b) => b.relevance - a.relevance);
+    const selected = [];
+    let totalChars = 0;
+    for (const section of prioritized) {
+        if (selected.length >= budget.maxSections)
+            break;
+        const sectionText = section.lines.join('\n');
+        if (sectionText.length > budget.maxCharsPerSection) {
+            section.lines = section.lines.slice(0, Math.floor(budget.maxCharsPerSection / 80));
+        }
+        const sectionChars = section.lines.join('\n').length;
+        if (totalChars + sectionChars > budget.maxTotalChars)
+            break;
+        selected.push(section);
+        totalChars += sectionChars;
+    }
+    return {
+        sections: selected,
+        totalChars,
+        summary,
+    };
+}
+// ---------------------------------------------------------------------------
+// 格式化函数 — 将节点转为可读文本
+// ---------------------------------------------------------------------------
+function formatDomainNodes(nodes) {
+    return nodes.map(n => {
+        const aliases = n.aliases.length > 0 ? ` (别名: ${n.aliases.join(', ')})` : '';
+        return `[domain] ${n.name}${aliases}: ${n.definition}`;
+    });
+}
+function formatSpecNodes(nodes) {
+    return nodes.map(n => {
+        const roles = n.roles.length > 0 ? ` [${n.roles.join(',')}]` : '';
+        return `[spec:${n.category}] ${n.name}${roles}: ${n.definition.substring(0, 200)}`;
+    });
+}
+function formatKnowhowNodes(nodes) {
+    return nodes.map(n => {
+        const tags = n.keywords.length > 0 ? ` #${n.keywords.slice(0, 3).join(' #')}` : '';
+        return `[knowhow:${n.metadata.type ?? ''}] ${n.name}${tags}: ${n.definition.substring(0, 200)}`;
+    });
+}
+function formatCodeNodes(nodes) {
+    return nodes.map(n => {
+        const sig = n.signature ? ` ${n.signature}` : '';
+        const file = n.filePath ? ` (${n.filePath}:${n.startLine})` : '';
+        return `[${n.kind}] ${n.name}${sig}${file}`;
+    });
+}
+function formatCodebaseNodes(nodes) {
+    return nodes.map(n => `[codebase] ${n.name}: ${n.definition.substring(0, 200)}`);
+}
+function formatIssueNodes(nodes) {
+    return nodes.map(n => {
+        const sev = n.category ? ` [${n.category}]` : '';
+        return `[issue] ${n.name}${sev}: ${n.definition.substring(0, 200)}`;
+    });
+}
+// ---------------------------------------------------------------------------
+// Agent-type 特化 — PreToolUse 时加载 role-based spec
+// ---------------------------------------------------------------------------
+const AGENT_CATEGORY_MAP = {
+    'implement': ['coding', 'arch'],
+    'review': ['review', 'coding'],
+    'debug': ['debug', 'learning'],
+    'plan': ['arch', 'coding'],
+    'test': ['test', 'coding'],
+    'analyze': ['arch', 'learning'],
+};
+export function getAgentCategories(agentType) {
+    return AGENT_CATEGORY_MAP[agentType] ?? [];
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/src/graph/kg/query/context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../../../../../src/graph/kg/query/context-builder.ts"],"names":[],"mappings":"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"}

package/dist/src/graph/kg/query/index.d.ts

@@ -0,0 +1,8 @@
+export { searchUnified, searchCodeOnly, searchKnowledgeOnly, parseQuery } from './search.js';
+export type { SearchOptions, UnifiedSearchOutput, ParsedQuery } from './search.js';
+export { bfs, traceCallChain, getCallers, getCallees, getImpactRadius, findShortestPath } from './traversal.js';
+export type { TraversalResult, TraversalOptions } from './traversal.js';
+export { buildContext, getAgentCategories } from './context-builder.js';
+export type { ContextSection, ContextBudget, BuiltContext } from './context-builder.js';
+export { computeScore, kindBonus, scorePathRelevance, nameMatchBonus, extractSearchTerms, getStemVariants, removeStopWords } from './scoring.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/graph/kg/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/graph/kg/query/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7F,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChH,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/graph/kg/query/index.js

@@ -0,0 +1,6 @@
+// src/graph/kg/query/index.ts — 查询层导出
+export { searchUnified, searchCodeOnly, searchKnowledgeOnly, parseQuery } from './search.js';
+export { bfs, traceCallChain, getCallers, getCallees, getImpactRadius, findShortestPath } from './traversal.js';
+export { buildContext, getAgentCategories } from './context-builder.js';
+export { computeScore, kindBonus, scorePathRelevance, nameMatchBonus, extractSearchTerms, getStemVariants, removeStopWords } from './scoring.js';
+//# sourceMappingURL=index.js.map

package/dist/src/graph/kg/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/kg/query/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG7F,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGhH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/graph/kg/query/scoring.d.ts

@@ -0,0 +1,19 @@
+import type { UnifiedNodeKind } from '../db/types.js';
+export declare function removeStopWords(tokens: string[]): string[];
+export declare function getStemVariants(term: string): string[];
+export declare function extractSearchTerms(query: string): string[];
+export declare function kindBonus(kind: UnifiedNodeKind): number;
+export declare function scorePathRelevance(filePath: string, query: string): number;
+export declare function nameMatchBonus(name: string, query: string): number;
+export interface ScoredResult {
+    id: string;
+    score: number;
+}
+export declare function computeScore(node: {
+    id: string;
+    kind: UnifiedNodeKind;
+    name: string;
+    filePath: string;
+    _bm25Score?: number;
+}, query: string, credibilityFactor?: number): number;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/src/graph/kg/query/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../../../src/graph/kg/query/scoring.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAmBtD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE1D;AAMD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBtD;AAMD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAmB1D;AAMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAgBvD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAwB1E;AAWD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAwBlE;AAMD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAChG,KAAK,EAAE,MAAM,EACb,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,CAiBR"}