maestro-flow 0.5.2 → 0.5.31

package/dist/src/graph/kg/extraction/knowledge/issue-extractor.js

@@ -0,0 +1,84 @@
+// src/graph/kg/extraction/knowledge/issue-extractor.ts
+// 从 .workflow/issues/issues.jsonl 提取 issue nodes + resolves edges
+import { readFileSync, existsSync } from 'node:fs';
+import { makeNodeId } from '../../db/connection.js';
+export function extractIssues(issuesPath, workflowRoot) {
+    const nodes = [];
+    const edges = [];
+    const now = Date.now();
+    if (!existsSync(issuesPath)) {
+        return { nodes, edges, fileRecord: createEmptyFileRecord(issuesPath) };
+    }
+    const content = readFileSync(issuesPath, 'utf-8');
+    const lines = content.split('\n').filter(l => l.trim());
+    for (const line of lines) {
+        try {
+            const issue = JSON.parse(line);
+            const nodeId = makeNodeId('issue', issue.id);
+            nodes.push({
+                id: nodeId,
+                kind: 'issue',
+                name: issue.title,
+                qualifiedName: `issue:${issue.id}`,
+                filePath: issuesPath,
+                language: 'unknown',
+                startLine: 0,
+                endLine: 0,
+                startColumn: 0,
+                endColumn: 0,
+                docstring: '',
+                signature: '',
+                visibility: '',
+                isExported: false,
+                isAsync: false,
+                isStatic: false,
+                isAbstract: false,
+                decorators: [],
+                typeParameters: [],
+                sourceType: 'issue',
+                definition: issue.description,
+                aliases: [],
+                keywords: issue.labels ?? [],
+                category: issue.severity ?? '',
+                roles: [],
+                priority: issue.severity === 'critical' ? 'must' : issue.severity === 'high' ? 'should' : 'may',
+                status: issue.status ?? 'open',
+                body: issue.description,
+                metadata: {
+                    severity: issue.severity ?? '',
+                    fixDirection: issue.fix_direction ?? '',
+                    resolution: issue.resolution ?? '',
+                },
+                updatedAt: now,
+            });
+            // resolves edges 由 knowledge-resolver 负责建立
+            // 不在提取阶段创建 pending edges（FK 约束要求 target 必须是有效 nodeId）
+        }
+        catch {
+            // 解析失败的行跳过
+        }
+    }
+    return {
+        nodes,
+        edges,
+        fileRecord: {
+            path: issuesPath,
+            contentHash: '',
+            language: 'unknown',
+            size: 0,
+            modifiedAt: now,
+            indexedAt: now,
+            nodeCount: nodes.length,
+            errors: [],
+            sourceType: 'issue',
+        },
+    };
+}
+function createEmptyFileRecord(path) {
+    return {
+        path, contentHash: '', language: 'unknown',
+        size: 0, modifiedAt: 0, indexedAt: 0, nodeCount: 0,
+        errors: [], sourceType: 'issue',
+    };
+}
+//# sourceMappingURL=issue-extractor.js.map

package/dist/src/graph/kg/extraction/knowledge/issue-extractor.js.map

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

package/dist/src/graph/kg/extraction/knowledge/spec-extractor.d.ts

@@ -0,0 +1,3 @@
+import type { ExtractionResult } from '../../db/types.js';
+export declare function extractSpec(specsDir: string, workflowRoot: string): ExtractionResult;
+//# sourceMappingURL=spec-extractor.d.ts.map

package/dist/src/graph/kg/extraction/knowledge/spec-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-extractor.d.ts","sourceRoot":"","sources":["../../../../../../src/graph/kg/extraction/knowledge/spec-extractor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAC4B,gBAAgB,EAEvD,MAAM,mBAAmB,CAAC;AAe3B,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAgFlB"}

package/dist/src/graph/kg/extraction/knowledge/spec-extractor.js

@@ -0,0 +1,173 @@
+// src/graph/kg/extraction/knowledge/spec-extractor.ts
+// 从 .workflow/specs/*.md 提取 spec_entry nodes + constrains edges + derived_from edges
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { resolve, extname } from 'node:path';
+import { makeNodeId } from '../../db/connection.js';
+export function extractSpec(specsDir, workflowRoot) {
+    const nodes = [];
+    const edges = [];
+    const now = Date.now();
+    if (!existsSync(specsDir)) {
+        return { nodes, edges, fileRecord: createEmptyFileRecord(specsDir) };
+    }
+    const specFiles = readdirSync(specsDir)
+        .filter(f => extname(f) === '.md')
+        .map(f => resolve(specsDir, f));
+    for (const specFilePath of specFiles) {
+        const content = readFileSync(specFilePath, 'utf-8');
+        const entries = parseSpecFile(content, specFilePath);
+        for (const entry of entries) {
+            const nodeId = makeNodeId('spec', specFilePath, String(entry.lineStart));
+            nodes.push({
+                id: nodeId,
+                kind: 'spec_entry',
+                name: entry.title,
+                qualifiedName: `spec:${entry.title}`,
+                filePath: specFilePath,
+                language: 'markdown',
+                startLine: entry.lineStart,
+                endLine: entry.lineEnd,
+                startColumn: 0,
+                endColumn: 0,
+                docstring: '',
+                signature: '',
+                visibility: '',
+                isExported: false,
+                isAsync: false,
+                isStatic: false,
+                isAbstract: false,
+                decorators: [],
+                typeParameters: [],
+                sourceType: 'spec',
+                definition: entry.content,
+                aliases: [],
+                keywords: entry.keywords,
+                category: entry.category,
+                roles: entry.roles,
+                priority: entry.priority ?? '',
+                status: entry.status ?? 'active',
+                body: entry.content,
+                metadata: {},
+                updatedAt: now,
+            });
+            // 如果有 domain 属性，创建 derived_from edge (spec→domain)
+            if (entry.domain) {
+                edges.push({
+                    source: nodeId,
+                    target: makeNodeId('domain', entry.domain),
+                    kind: 'derived_from',
+                    provenance: 'spec',
+                });
+            }
+        }
+    }
+    return {
+        nodes,
+        edges,
+        fileRecord: {
+            path: specsDir,
+            contentHash: '',
+            language: 'markdown',
+            size: 0,
+            modifiedAt: now,
+            indexedAt: now,
+            nodeCount: nodes.length,
+            errors: [],
+            sourceType: 'spec',
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Spec 文件解析 — frontmatter + 规则提取
+// ---------------------------------------------------------------------------
+function parseSpecFile(content, filePath) {
+    const entries = [];
+    const lines = content.split('\n');
+    // 解析 frontmatter
+    let lineOffset = 0;
+    let frontmatter = {};
+    if (lines[0]?.trim() === '---') {
+        const endIdx = lines.findIndex((l, i) => i > 0 && l.trim() === '---');
+        if (endIdx > 0) {
+            const fmLines = lines.slice(1, endIdx);
+            frontmatter = parseFrontmatter(fmLines.join('\n'));
+            lineOffset = endIdx + 1;
+        }
+    }
+    // 提取 spec 条目 — 每个二级标题 (# 或 ##) 为一个条目
+    let currentEntry = null;
+    for (let i = lineOffset; i < lines.length; i++) {
+        const line = lines[i];
+        const headingMatch = line.match(/^#{1,2}\s+(.+)/);
+        if (headingMatch) {
+            if (currentEntry) {
+                currentEntry.lineEnd = i - 1;
+                entries.push(currentEntry);
+            }
+            const title = headingMatch[1].trim();
+            currentEntry = {
+                title,
+                content: '',
+                lineStart: i + 1,
+                lineEnd: lines.length,
+                keywords: (frontmatter.keywords ?? []),
+                category: (frontmatter.category ?? ''),
+                roles: (frontmatter.roles ?? []),
+                domain: frontmatter.domain,
+                priority: frontmatter.priority,
+                status: frontmatter.status,
+            };
+        }
+        else if (currentEntry) {
+            currentEntry.content += line + '\n';
+        }
+    }
+    if (currentEntry) {
+        currentEntry.lineEnd = lines.length;
+        entries.push(currentEntry);
+    }
+    // 如果没有任何标题但有 frontmatter，创建整体条目
+    if (entries.length === 0 && Object.keys(frontmatter).length > 0) {
+        entries.push({
+            title: (frontmatter.title ?? filePath.replace(/\.md$/, '')),
+            content: content,
+            lineStart: 1,
+            lineEnd: lines.length,
+            keywords: (frontmatter.keywords ?? []),
+            category: (frontmatter.category ?? ''),
+            roles: (frontmatter.roles ?? []),
+            domain: frontmatter.domain,
+            priority: frontmatter.priority,
+            status: frontmatter.status,
+        });
+    }
+    return entries;
+}
+function parseFrontmatter(fmContent) {
+    const result = {};
+    for (const line of fmContent.split('\n')) {
+        const match = line.match(/^(\w+):\s*(.+)$/);
+        if (match) {
+            const key = match[1];
+            let value = match[2].trim();
+            // 尝试解析 JSON 数组/对象
+            const strValue = value;
+            if (strValue.startsWith('[') || strValue.startsWith('{')) {
+                try {
+                    value = JSON.parse(strValue);
+                }
+                catch { /* keep as string */ }
+            }
+            result[key] = value;
+        }
+    }
+    return result;
+}
+function createEmptyFileRecord(path) {
+    return {
+        path, contentHash: '', language: 'markdown',
+        size: 0, modifiedAt: 0, indexedAt: 0, nodeCount: 0,
+        errors: [], sourceType: 'spec',
+    };
+}
+//# sourceMappingURL=spec-extractor.js.map

package/dist/src/graph/kg/extraction/knowledge/spec-extractor.js.map

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

package/dist/src/graph/kg/extraction/knowledge/wiki-extractor.d.ts

@@ -0,0 +1,3 @@
+import type { ExtractionResult } from '../../db/types.js';
+export declare function extractWiki(knowhowDir: string, workflowRoot: string): ExtractionResult;
+//# sourceMappingURL=wiki-extractor.d.ts.map

package/dist/src/graph/kg/extraction/knowledge/wiki-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-extractor.d.ts","sourceRoot":"","sources":["../../../../../../src/graph/kg/extraction/knowledge/wiki-extractor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAC4B,gBAAgB,EAEvD,MAAM,mBAAmB,CAAC;AAe3B,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CA8ElB"}

package/dist/src/graph/kg/extraction/knowledge/wiki-extractor.js

@@ -0,0 +1,165 @@
+// src/graph/kg/extraction/knowledge/wiki-extractor.ts
+// 从 .workflow/knowhow/*.md 提取 knowhow_entry nodes + documents edges
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { resolve, extname, basename } from 'node:path';
+import { makeNodeId } from '../../db/connection.js';
+export function extractWiki(knowhowDir, workflowRoot) {
+    const nodes = [];
+    const edges = [];
+    const now = Date.now();
+    if (!existsSync(knowhowDir)) {
+        return { nodes, edges, fileRecord: createEmptyFileRecord(knowhowDir) };
+    }
+    const mdFiles = readdirSync(knowhowDir)
+        .filter(f => extname(f) === '.md')
+        .map(f => resolve(knowhowDir, f));
+    for (const filePath of mdFiles) {
+        const content = readFileSync(filePath, 'utf-8');
+        const fm = parseKnowhowFrontmatter(content);
+        const slug = basename(filePath, '.md');
+        const nodeId = makeNodeId('knowhow', slug);
+        // 解析 body (去掉 frontmatter)
+        const body = extractBody(content);
+        nodes.push({
+            id: nodeId,
+            kind: 'knowhow_entry',
+            name: fm.title ?? slug,
+            qualifiedName: `knowhow:${slug}`,
+            filePath: filePath,
+            language: 'unknown',
+            startLine: 0,
+            endLine: 0,
+            startColumn: 0,
+            endColumn: 0,
+            docstring: '',
+            signature: '',
+            visibility: '',
+            isExported: false,
+            isAsync: false,
+            isStatic: false,
+            isAbstract: false,
+            decorators: [],
+            typeParameters: [],
+            sourceType: 'knowhow',
+            definition: fm.description ?? '',
+            aliases: [],
+            keywords: fm.keywords ?? fm.tags ?? [],
+            category: fm.specCategory ?? fm.category ?? fm.type ?? '',
+            roles: [],
+            priority: '',
+            status: fm.status ?? 'active',
+            body: body,
+            metadata: {
+                type: fm.type ?? '',
+                lang: fm.lang ?? '',
+                source: fm.source ?? '',
+            },
+            updatedAt: now,
+        });
+        // documents edges 由 knowledge-resolver 的 resolveDocumentsEdges 负责建立
+        // 不在提取阶段创建 pending edges（FK 约束要求 target 必须是有效 nodeId）
+    }
+    return {
+        nodes,
+        edges,
+        fileRecord: {
+            path: knowhowDir,
+            contentHash: '',
+            language: 'unknown',
+            size: 0,
+            modifiedAt: now,
+            indexedAt: now,
+            nodeCount: nodes.length,
+            errors: [],
+            sourceType: 'knowhow',
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Frontmatter 解析
+// ---------------------------------------------------------------------------
+function parseKnowhowFrontmatter(content) {
+    const lines = content.split('\n');
+    if (lines[0]?.trim() !== '---')
+        return {};
+    const endIdx = lines.findIndex((l, i) => i > 0 && l.trim() === '---');
+    if (endIdx <= 0)
+        return {};
+    const fmLines = lines.slice(1, endIdx);
+    const result = {};
+    for (const line of fmLines) {
+        const match = line.match(/^(\w+):\s*(.+)$/);
+        if (match) {
+            const key = match[1];
+            let value = match[2].trim();
+            // 尝试解析 JSON 数组/对象
+            if (typeof value === 'string') {
+                const str = value;
+                if (str.startsWith('[') || str.startsWith('{')) {
+                    try {
+                        value = JSON.parse(str);
+                    }
+                    catch { /* keep as string */ }
+                }
+                // 处理 YAML 风格的数组 ["a", "b"]
+                else if (str.startsWith('[')) {
+                    try {
+                        value = JSON.parse(str);
+                    }
+                    catch { /* keep */ }
+                }
+            }
+            // 映射到 KnowhowFrontmatter 字段
+            switch (key) {
+                case 'type':
+                    result.type = value;
+                    break;
+                case 'title':
+                    result.title = value;
+                    break;
+                case 'description':
+                    result.description = value;
+                    break;
+                case 'tags':
+                    result.tags = Array.isArray(value) ? value : [value];
+                    break;
+                case 'specCategory':
+                    result.specCategory = value;
+                    break;
+                case 'category':
+                    result.category = value;
+                    break;
+                case 'status':
+                    result.status = value;
+                    break;
+                case 'lang':
+                    result.lang = value;
+                    break;
+                case 'source':
+                    result.source = value;
+                    break;
+                case 'keywords':
+                    result.keywords = Array.isArray(value) ? value : [value];
+                    break;
+            }
+        }
+    }
+    return result;
+}
+function extractBody(content) {
+    const lines = content.split('\n');
+    if (lines[0]?.trim() !== '---')
+        return content;
+    const endIdx = lines.findIndex((l, i) => i > 0 && l.trim() === '---');
+    if (endIdx <= 0)
+        return content;
+    return lines.slice(endIdx + 1).join('\n');
+}
+function createEmptyFileRecord(path) {
+    return {
+        path, contentHash: '', language: 'unknown',
+        size: 0, modifiedAt: 0, indexedAt: 0, nodeCount: 0,
+        errors: [], sourceType: 'knowhow',
+    };
+}
+//# sourceMappingURL=wiki-extractor.js.map

package/dist/src/graph/kg/extraction/knowledge/wiki-extractor.js.map

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

package/dist/src/graph/kg/extraction/orchestrator.d.ts

@@ -0,0 +1,6 @@
+import type { SyncResult, SourceType } from '../db/types.js';
+export declare function syncKnowledgeGraph(projectPath: string, options?: {
+    full?: boolean;
+    sources?: SourceType[];
+}): Promise<SyncResult[]>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/src/graph/kg/extraction/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../../../src/graph/kg/extraction/orchestrator.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;CAAE,GACnD,OAAO,CAAC,UAAU,EAAE,CAAC,CA+NvB"}