maestro-flow 0.5.31 → 0.5.33

package/dashboard/dist-server/src/graph/kg/db/types.js

@@ -0,0 +1,75 @@
+// src/graph/kg/db/types.ts — MaestroGraph 统一类型系统
+// 参考: guide/plan-maestrograph.md Gap 修补 2 + D8.4 Node ID 命名空间
+// ---------------------------------------------------------------------------
+// NodeKind — 完整复用 CodeGraph 22 种 + 新增 7 种知识类型
+// ---------------------------------------------------------------------------
+export const CODE_NODE_KINDS = [
+    'file', // CodeGraph 原有
+    'module',
+    'class',
+    'struct',
+    'interface',
+    'trait',
+    'protocol', // Swift 协议, callback-synthesizer 依赖
+    'function',
+    'method',
+    'property',
+    'field',
+    'variable',
+    'constant',
+    'enum',
+    'enum_member',
+    'type_alias',
+    'namespace',
+    'parameter',
+    'import',
+    'export',
+    'route',
+    'component',
+];
+export const KNOWLEDGE_NODE_KINDS = [
+    'domain_term', // Domain glossary term
+    'spec_entry', // Spec constraint/rule
+    'knowhow_entry', // Wiki knowhow document
+    'codebase_section', // Codebase doc section
+    'issue', // Issue tracker entry
+    'decision', // Architecture decision record
+    'requirement', // Requirement from context-package
+];
+export const UNIFIED_NODE_KINDS = [...CODE_NODE_KINDS, ...KNOWLEDGE_NODE_KINDS];
+// ---------------------------------------------------------------------------
+// Language — 完整复用 CodeGraph 28+ 种
+// ---------------------------------------------------------------------------
+export const LANGUAGES = [
+    'typescript', 'javascript', 'tsx', 'jsx',
+    'python', 'go', 'rust', 'java',
+    'c', 'cpp', 'csharp', 'php', 'ruby',
+    'swift', 'kotlin', 'dart',
+    'svelte', 'vue', 'liquid',
+    'pascal', 'scala', 'lua', 'luau', 'objc',
+    'yaml', 'twig', 'xml', 'properties',
+    'unknown',
+];
+// ---------------------------------------------------------------------------
+// Source Type — 知识节点来源分类
+// ---------------------------------------------------------------------------
+export const SOURCE_TYPES = [
+    'codegraph', 'domain', 'spec', 'knowhow', 'codebase', 'issue',
+];
+export function makeNodeId(prefix, ...parts) {
+    return `${prefix}:${parts.join(':')}`;
+}
+export function validateNodeId(id) {
+    const VALID_PREFIXES = new Set(['code', 'domain', 'spec', 'knowhow', 'codebase', 'issue']);
+    const colonIdx = id.indexOf(':');
+    return colonIdx > 0 && VALID_PREFIXES.has(id.slice(0, colonIdx));
+}
+export function getNodePrefix(id) {
+    const colonIdx = id.indexOf(':');
+    if (colonIdx <= 0)
+        return null;
+    const prefix = id.slice(0, colonIdx);
+    const VALID_PREFIXES = new Set(['code', 'domain', 'spec', 'knowhow', 'codebase', 'issue']);
+    return VALID_PREFIXES.has(prefix) ? prefix : null;
+}
+//# sourceMappingURL=types.js.map

package/dashboard/dist-server/src/graph/kg/db/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/graph/kg/db/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,8DAA8D;AAE9D,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAY,eAAe;IACjC,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,WAAW;IACX,OAAO;IACP,UAAU,EAAQ,oCAAoC;IACtD,UAAU;IACV,QAAQ;IACR,UAAU;IACV,OAAO;IACP,UAAU;IACV,UAAU;IACV,MAAM;IACN,aAAa;IACb,YAAY;IACZ,WAAW;IACX,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,WAAW;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa,EAAO,uBAAuB;IAC3C,YAAY,EAAQ,uBAAuB;IAC3C,eAAe,EAAK,wBAAwB;IAC5C,kBAAkB,EAAE,uBAAuB;IAC3C,OAAO,EAAa,sBAAsB;IAC1C,UAAU,EAAU,+BAA+B;IACnD,aAAa,EAAO,mCAAmC;CAC/C,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,oBAAoB,CAAU,CAAC;AA4BzF,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK;IACxC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM;IAC9B,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM;IACnC,OAAO,EAAE,QAAQ,EAAE,MAAM;IACzB,QAAQ,EAAE,KAAK,EAAE,QAAQ;IACzB,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IACxC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY;IACnC,SAAS;CACD,CAAC;AAIX,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO;CACrD,CAAC;AA2BX,MAAM,UAAU,UAAU,CAAC,MAAoB,EAAE,GAAG,KAAe;IACjE,OAAO,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACzG,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,QAAQ,GAAG,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAiB,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrC,MAAM,cAAc,GAAgB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACxG,OAAO,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAsB,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC"}

package/dashboard/dist-server/src/graph/kg/engine.d.ts

@@ -0,0 +1,86 @@
+import { KgDatabaseConnection, KgQueryBuilder } from './db/index.js';
+import type { UnifiedNode, UnifiedEdge, UnifiedGraphStats, SyncResult, ResolutionResult, ExtractionResult, SourceType } from './db/types.js';
+import type { KnowledgeResolutionResult } from './resolution/knowledge-resolver.js';
+import type { TraversalResult, NodeContext, NodeMetrics, PathStep } from './query/traversal.js';
+import type { UnifiedSearchOutput } from './query/search.js';
+import type { BuiltContext } from './query/context-builder.js';
+export declare class MaestroGraph {
+    private conn;
+    private queries;
+    private projectRoot;
+    constructor(projectRoot: string);
+    static init(projectRoot: string): Promise<MaestroGraph>;
+    static open(projectRoot: string): Promise<MaestroGraph>;
+    static isInitialized(projectRoot: string): boolean;
+    static openSync(projectRoot: string): MaestroGraph | null;
+    get rawDb(): import('better-sqlite3').Database;
+    close(): void;
+    indexAll(options?: {
+        sources?: SourceType[];
+    }): Promise<SyncResult[]>;
+    indexKnowledge(options?: {
+        sources?: SourceType[];
+    }): Promise<SyncResult[]>;
+    sync(): Promise<SyncResult[]>;
+    resolveReferences(): ResolutionResult;
+    resolveKnowledgeEdges(): KnowledgeResolutionResult;
+    searchUnified(query: string, options?: {
+        sourceTypes?: SourceType[];
+        kinds?: string[];
+        limit?: number;
+    }): UnifiedSearchOutput;
+    searchCode(query: string, options?: {
+        kinds?: string[];
+        languages?: string[];
+        limit?: number;
+    }): UnifiedNode[];
+    searchKnowledge(query: string, options?: {
+        sourceTypes?: SourceType[];
+        limit?: number;
+    }): UnifiedNode[];
+    getNode(id: string): UnifiedNode | null;
+    getStats(): UnifiedGraphStats;
+    getDetectedFrameworks(): string[];
+    getCallers(nodeId: string, depth?: number): Array<{
+        node: UnifiedNode;
+        edge: UnifiedEdge;
+    }>;
+    getCallees(nodeId: string, depth?: number): Array<{
+        node: UnifiedNode;
+        edge: UnifiedEdge;
+    }>;
+    getImpact(nodeId: string, depth?: number): TraversalResult;
+    traverse(startId: string, options?: {
+        maxDepth?: number;
+        edgeKinds?: string[];
+        direction?: 'outgoing' | 'incoming' | 'both';
+    }): TraversalResult;
+    traverseDFS(startId: string, options?: {
+        maxDepth?: number;
+        edgeKinds?: string[];
+        direction?: 'outgoing' | 'incoming' | 'both';
+    }): TraversalResult;
+    getTypeHierarchy(nodeId: string): TraversalResult;
+    findUsages(nodeId: string): Array<{
+        node: UnifiedNode;
+        edge: UnifiedEdge;
+    }>;
+    getAncestors(nodeId: string): UnifiedNode[];
+    getChildren(nodeId: string): UnifiedNode[];
+    getCallGraph(nodeId: string, depth?: number): TraversalResult;
+    getNodeContext(nodeId: string): NodeContext | null;
+    getFileDependencies(filePath: string): string[];
+    getFileDependents(filePath: string): string[];
+    findDeadCode(options?: {
+        kinds?: string[];
+    }): UnifiedNode[];
+    getNodeMetrics(nodeId: string): NodeMetrics | null;
+    findShortestPath(fromId: string, toId: string, maxDepth?: number): PathStep[] | null;
+    buildContext(query: string, options?: {
+        expandDepth?: number;
+        agentType?: string;
+    }): BuiltContext;
+    getQueryBuilder(): KgQueryBuilder;
+    getConnection(): KgDatabaseConnection;
+    insertExtractionResults(result: ExtractionResult): void;
+}

package/dashboard/dist-server/src/graph/kg/engine.js

@@ -0,0 +1,247 @@
+// src/graph/kg/engine.ts — MaestroGraph 主入口类
+// 参考: plan-maestrograph.md Gap C8 — CodeGraph Public Lifecycle API
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { KgDatabaseConnection, KgQueryBuilder, getKgDatabasePath, applyMigrations } from './db/index.js';
+import { resolveKnowledgeEdges as resolveKnowledgeEdgesImpl } from './resolution/knowledge-resolver.js';
+import { bfs, dfs as dfsImpl, getCallers as getCallersImpl, getCallees as getCalleesImpl, getImpactRadius, getCallGraph as getCallGraphImpl, getTypeHierarchy as getTypeHierarchyImpl, findUsages as findUsagesImpl, getAncestors as getAncestorsImpl, getChildren as getChildrenImpl, getNodeContext as getNodeContextImpl, getFileDependencies as getFileDependenciesImpl, getFileDependents as getFileDependentsImpl, findDeadCode as findDeadCodeImpl, getNodeMetrics as getNodeMetricsImpl, findShortestPath as findShortestPathImpl, } from './query/traversal.js';
+import { searchUnified as searchUnifiedImpl } from './query/search.js';
+import { buildContext as buildContextImpl } from './query/context-builder.js';
+export class MaestroGraph {
+    conn = null;
+    queries = null;
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = resolve(projectRoot);
+    }
+    // ── Lifecycle ──────────────────────────────────────────────────────
+    static async init(projectRoot) {
+        const mg = new MaestroGraph(projectRoot);
+        const dbPath = getKgDatabasePath(projectRoot);
+        mg.conn = new KgDatabaseConnection();
+        mg.conn.initialize(dbPath);
+        mg.queries = new KgQueryBuilder(mg.conn);
+        return mg;
+    }
+    static async open(projectRoot) {
+        const mg = new MaestroGraph(projectRoot);
+        const dbPath = getKgDatabasePath(projectRoot);
+        if (!existsSync(dbPath)) {
+            throw new Error(`MaestroGraph not initialized. Run "maestro kg init" first. Expected: ${dbPath}`);
+        }
+        mg.conn = new KgDatabaseConnection();
+        mg.conn.open(dbPath);
+        try {
+            applyMigrations(mg.conn);
+        }
+        catch { /* best-effort migration on open */ }
+        mg.queries = new KgQueryBuilder(mg.conn);
+        return mg;
+    }
+    static isInitialized(projectRoot) {
+        return existsSync(getKgDatabasePath(projectRoot));
+    }
+    static openSync(projectRoot) {
+        try {
+            const dbPath = getKgDatabasePath(resolve(projectRoot));
+            if (!existsSync(dbPath))
+                return null;
+            const mg = new MaestroGraph(projectRoot);
+            mg.conn = new KgDatabaseConnection();
+            mg.conn.open(dbPath);
+            try {
+                applyMigrations(mg.conn);
+            }
+            catch { /* best-effort */ }
+            mg.queries = new KgQueryBuilder(mg.conn);
+            return mg;
+        }
+        catch {
+            return null;
+        }
+    }
+    get rawDb() {
+        if (!this.conn)
+            throw new Error('MaestroGraph not open');
+        return this.conn.raw;
+    }
+    close() {
+        this.conn?.close();
+        this.conn = null;
+        this.queries = null;
+    }
+    // ── Indexing ──────────────────────────────────────────────────────
+    async indexAll(options) {
+        const { syncKnowledgeGraph } = await import('./extraction/orchestrator.js');
+        return syncKnowledgeGraph(this.projectRoot, { sources: options?.sources });
+    }
+    async indexKnowledge(options) {
+        const knowledgeSources = options?.sources
+            ?? ['domain', 'spec', 'knowhow', 'codebase', 'issue'];
+        const { syncKnowledgeGraph } = await import('./extraction/orchestrator.js');
+        return syncKnowledgeGraph(this.projectRoot, { sources: knowledgeSources });
+    }
+    async sync() {
+        const { syncKnowledgeGraph } = await import('./extraction/orchestrator.js');
+        return syncKnowledgeGraph(this.projectRoot);
+    }
+    resolveReferences() {
+        if (!this.conn)
+            throw new Error('MaestroGraph not open');
+        return { edgesCreated: 0, edges: [], durationMs: 0 };
+    }
+    resolveKnowledgeEdges() {
+        if (!this.conn)
+            throw new Error('MaestroGraph not open');
+        return resolveKnowledgeEdgesImpl(this.conn.raw, { projectPath: this.projectRoot });
+    }
+    // ── Query ─────────────────────────────────────────────────────────
+    searchUnified(query, options) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return searchUnifiedImpl(this.queries, query, {
+            sourceTypes: options?.sourceTypes,
+            kinds: options?.kinds,
+            limit: options?.limit ?? 20,
+        });
+    }
+    searchCode(query, options) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return this.queries.searchCodeFTS(query, {
+            kinds: options?.kinds,
+            languages: options?.languages,
+            limit: options?.limit ?? 20,
+        });
+    }
+    searchKnowledge(query, options) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return this.queries.searchKnowledgeFTS(query, {
+            sourceTypes: options?.sourceTypes,
+            limit: options?.limit ?? 20,
+        });
+    }
+    getNode(id) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return this.queries.getNode(id);
+    }
+    getStats() {
+        if (!this.queries || !this.conn)
+            throw new Error('MaestroGraph not open');
+        return this.queries.getStats(this.conn.getSize());
+    }
+    getDetectedFrameworks() {
+        return this.getStats().detectedFrameworks;
+    }
+    // ── Traversal (C8 API) ────────────────────────────────────────────
+    getCallers(nodeId, depth = 1) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getCallersImpl(this.queries, nodeId, depth);
+    }
+    getCallees(nodeId, depth = 1) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getCalleesImpl(this.queries, nodeId, depth);
+    }
+    getImpact(nodeId, depth = 3) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getImpactRadius(this.queries, nodeId, depth);
+    }
+    traverse(startId, options) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return bfs(this.queries, startId, options);
+    }
+    traverseDFS(startId, options) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return dfsImpl(this.queries, startId, options);
+    }
+    getTypeHierarchy(nodeId) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getTypeHierarchyImpl(this.queries, nodeId);
+    }
+    findUsages(nodeId) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return findUsagesImpl(this.queries, nodeId);
+    }
+    getAncestors(nodeId) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getAncestorsImpl(this.queries, nodeId);
+    }
+    getChildren(nodeId) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getChildrenImpl(this.queries, nodeId);
+    }
+    getCallGraph(nodeId, depth) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getCallGraphImpl(this.queries, nodeId, depth);
+    }
+    getNodeContext(nodeId) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getNodeContextImpl(this.queries, nodeId);
+    }
+    getFileDependencies(filePath) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getFileDependenciesImpl(this.queries, filePath);
+    }
+    getFileDependents(filePath) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getFileDependentsImpl(this.queries, filePath);
+    }
+    findDeadCode(options) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return findDeadCodeImpl(this.queries, options);
+    }
+    getNodeMetrics(nodeId) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return getNodeMetricsImpl(this.queries, nodeId);
+    }
+    findShortestPath(fromId, toId, maxDepth) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return findShortestPathImpl(this.queries, fromId, toId, maxDepth);
+    }
+    // ── Context (C8 API) ──────────────────────────────────────────────
+    buildContext(query, options) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return buildContextImpl(this.queries, query, options);
+    }
+    // ── Internal Access (供 CLI/MCP 消费) ──────────────────────────────
+    getQueryBuilder() {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        return this.queries;
+    }
+    getConnection() {
+        if (!this.conn)
+            throw new Error('MaestroGraph not open');
+        return this.conn;
+    }
+    // ── Insertion (供 extractor 使用) ──────────────────────────────────
+    insertExtractionResults(result) {
+        if (!this.queries)
+            throw new Error('MaestroGraph not open');
+        this.conn.transaction(() => {
+            this.queries.insertNodes(result.nodes);
+            this.queries.insertEdges(result.edges);
+            this.queries.upsertFile(result.fileRecord);
+        });
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dashboard/dist-server/src/graph/kg/engine.js.map

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

package/dashboard/dist-server/src/graph/kg/extraction/code/code-extractor.d.ts

@@ -0,0 +1,49 @@
+import type { ExtractionResult } from '../../db/types.js';
+export interface ScanOptions {
+    /** 源码根目录 */
+    srcDir: string;
+    /** 项目根目录，用于插件加载和解析 .gitignore/.maestroignore */
+    projectRoot?: string;
+    /** 排除的目录模式 */
+    excludeDirs?: string[];
+    /** 排除的文件模式 (glob) */
+    excludeFiles?: string[];
+    /** 是否在缺失时创建 .maestroignore */
+    createMaestroIgnore?: boolean;
+    /** 允许执行 .workflow/kg/extractors/*.mjs 脚本插件 */
+    allowExtractorScripts?: boolean;
+    /** 是否包含测试文件 */
+    includeTests?: boolean;
+    /** 最大文件大小 (bytes) */
+    maxFileSize?: number;
+    /** 进度回调 */
+    onProgress?: (file: string, count: number, total: number) => void;
+}
+export interface CodeExtractionStats {
+    filesScanned: number;
+    filesExtracted: number;
+    filesSkipped: number;
+    nodesCreated: number;
+    edgesCreated: number;
+    referencesCollected: number;
+    errors: Array<{
+        filePath: string;
+        message: string;
+    }>;
+    durationMs: number;
+}
+export type CodeExtractionResultHandler = (result: ExtractionResult) => void | Promise<void>;
+/**
+ * 批量代码提取 — 扫描目录 → tree-sitter 解析 → nodes + edges
+ *
+ * 设计: 逐文件提取, 汇总后返回结果；大仓库写库请使用 forEachCodeExtractionResult()
+ * 支持: 自定义提取器 (vue/svelte/liquid/mybatis/dfm) 优先于通用 tree-sitter
+ */
+export declare function extractCode(options: ScanOptions): Promise<{
+    results: ExtractionResult[];
+    stats: CodeExtractionStats;
+}>;
+/**
+ * 流式代码提取 — 每个文件提取完成后立即回调，避免在内存中累积全量结果。
+ */
+export declare function forEachCodeExtractionResult(options: ScanOptions, onResult: CodeExtractionResultHandler): Promise<CodeExtractionStats>;