pi-harness-runtime 0.10.26 → 0.10.27

package/packages/knowledge-graph/dist/provenance-linker.js

@@ -0,0 +1,92 @@
+/**
+ * Knowledge Graph - RFC-0106
+ *
+ * Provenance linking between skills, RFCs, and implementations.
+ */
+/**
+ * Build provenance edges based on metadata
+ */
+export function buildProvenanceEdges(graph) {
+    const edges = [];
+    const nodeMap = new Map(graph.nodes.map((n) => [n.id, n]));
+    for (const node of graph.nodes) {
+        if (node.type === "skill" && node.data.tags.includes("implements")) {
+            // Link to RFCs found in tags
+            const rfcTag = node.data.tags.find((t) => t.startsWith("rfc-"));
+            if (rfcTag) {
+                edges.push({
+                    from: node.id,
+                    to: `rfc:${rfcTag.toUpperCase()}`,
+                    type: "implements",
+                    metadata: { source: "tag:implements" },
+                });
+            }
+        }
+        // Implementation -> documents -> RFC
+        if (node.type === "implementation") {
+            const rfcMatch = node.id.match(/implementation:RFC-(\d+)/i);
+            if (rfcMatch) {
+                edges.push({
+                    from: node.id,
+                    to: `rfc:RFC-${rfcMatch[1].padStart(4, "0")}`,
+                    type: "documents",
+                    metadata: { source: "id:parsing" },
+                });
+            }
+        }
+    }
+    return edges;
+}
+/**
+ * Infer additional edges from content analysis
+ */
+export function inferRelationships(graph) {
+    const edges = [];
+    // Group skills by shared tags
+    const tagGroups = new Map();
+    for (const node of graph.nodes) {
+        if (node.type !== "skill")
+            continue;
+        for (const tag of node.data.tags) {
+            if (!tagGroups.has(tag)) {
+                tagGroups.set(tag, []);
+            }
+            tagGroups.get(tag).push(node);
+        }
+    }
+    // Skills sharing 3+ tags are related
+    for (const [, nodes] of tagGroups) {
+        if (nodes.length < 2)
+            continue;
+        for (let i = 0; i < nodes.length; i++) {
+            for (let j = i + 1; j < nodes.length; j++) {
+                const sharedTags = nodes[i].data.tags.filter((t) => nodes[j].data.tags.includes(t));
+                if (sharedTags.length >= 3) {
+                    edges.push({
+                        from: nodes[i].id,
+                        to: nodes[j].id,
+                        type: "related_to",
+                        metadata: {
+                            source: "inferred:shared-tags",
+                            confidence: sharedTags.length /
+                                Math.max(nodes[i].data.tags.length, nodes[j].data.tags.length),
+                        },
+                    });
+                }
+            }
+        }
+    }
+    return edges;
+}
+/**
+ * Complete graph with all provenance links
+ */
+export function completeGraph(graph) {
+    const provenanceEdges = buildProvenanceEdges(graph);
+    const inferredEdges = inferRelationships(graph);
+    return {
+        nodes: graph.nodes,
+        edges: [...graph.edges, ...provenanceEdges, ...inferredEdges],
+    };
+}
+//# sourceMappingURL=provenance-linker.js.map

package/packages/knowledge-graph/dist/provenance-linker.js.map

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

package/packages/knowledge-graph/dist/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Knowledge Graph - RFC-0106
+ *
+ * Typed definitions for knowledge graph nodes and edges.
+ */
+export type KnowledgeNodeType = "skill" | "rfc" | "implementation" | "concept" | "api" | "cli" | "pattern" | "workflow";
+export interface KnowledgeNode {
+    id: string;
+    type: KnowledgeNodeType;
+    data: {
+        title: string;
+        description?: string;
+        tags: string[];
+        source?: string;
+        url?: string;
+    };
+}
+export type KnowledgeEdgeType = "implements" | "depends_on" | "supersedes" | "related_to" | "authored_by" | "documents" | "references";
+export interface KnowledgeEdge {
+    from: string;
+    to: string;
+    type: KnowledgeEdgeType;
+    metadata?: {
+        confidence?: number;
+        source?: string;
+    };
+}
+export interface KnowledgeGraph {
+    nodes: KnowledgeNode[];
+    edges: KnowledgeEdge[];
+}
+export interface ProvenanceData {
+    implements?: string;
+    related_implementation?: string;
+    author?: string;
+    version?: string;
+}
+export interface SearchResult {
+    node: KnowledgeNode;
+    score: number;
+    highlights?: string[];
+}
+export interface SearchOptions {
+    limit?: number;
+    type?: KnowledgeNodeType;
+    tags?: string[];
+}
+export interface TencentDBConfig {
+    knowledgeUrl: string;
+    userKey: string;
+    serviceId: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/knowledge-graph/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,iBAAiB,GAC1B,OAAO,GACP,KAAK,GACL,gBAAgB,GAChB,SAAS,GACT,KAAK,GACL,KAAK,GACL,SAAS,GACT,UAAU,CAAC;AAEd,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;CACF;AAID,MAAM,MAAM,iBAAiB,GAC1B,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,WAAW,GACX,YAAY,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACF;AAID,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,aAAa,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAID,MAAM,WAAW,eAAe;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CAClB"}

package/packages/knowledge-graph/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Knowledge Graph - RFC-0106
+ *
+ * Typed definitions for knowledge graph nodes and edges.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/knowledge-graph/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/packages/knowledge-graph/src/graph-extractor.ts

@@ -0,0 +1,355 @@
+/**
+ * Knowledge Graph - RFC-0106
+ *
+ * Extract nodes and edges from SKILL.md files.
+ */
+
+import type {
+	KnowledgeNode,
+	KnowledgeEdge,
+	KnowledgeGraph,
+	ProvenanceData,
+} from "./types.js";
+
+// Parse frontmatter manually (simplified - full OKF parser in okf-indexer)
+interface OKFDocument {
+	title?: string;
+	sections: { title?: string; content: string }[];
+}
+
+interface SKILLSection {
+	title?: string;
+	content: string;
+}
+
+function parseSKILL(content: string): OKFDocument {
+	const sections: OKFDocument["sections"] = [];
+	const lines = content.split("\n");
+	let currentSection: SKILLSection = { content: "" };
+	let inFrontmatter = false;
+
+	for (const line of lines) {
+		if (line.trim() === "---") {
+			inFrontmatter = !inFrontmatter;
+			continue;
+		}
+		if (inFrontmatter) continue;
+
+		if (line.startsWith("## ")) {
+			if (currentSection.content) {
+				sections.push(currentSection);
+			}
+			currentSection = { title: line.slice(3), content: "" };
+		} else {
+			currentSection.content += (currentSection.content ? "\n" : "") + line;
+		}
+	}
+	if (currentSection.content) {
+		sections.push(currentSection);
+	}
+
+	const titleMatch = content.match(/^#\s+(.+)$/m);
+	return { title: titleMatch?.[1], sections };
+}
+
+/**
+ * Extract RFC references from content
+ */
+function extractRFCRefs(content: string): string[] {
+	const rfcPattern = /RFC[- ]?(\d{4})/gi;
+	const matches = content.match(rfcPattern) || [];
+	return [
+		...new Set(
+			matches.map((m) => {
+				const num = m.replace(/[^0-9]/g, "");
+				return `RFC-${num.padStart(4, "0")}`;
+			}),
+		),
+	];
+}
+
+/**
+ * Extract wiki links from content (e.g., [[skill:xxx]])
+ */
+function extractWikiLinks(content: string): string[] {
+	const linkPattern = /\[\[([^\]]+)\]\]/g;
+	const matches = content.match(linkPattern) || [];
+	return matches.map((m) => m.slice(2, -2).trim());
+}
+
+/**
+ * Extract skill ID from file path
+ */
+function extractSkillId(filePath: string): string {
+	// Path: .../skills/{skill-id}/SKILL.md
+	const match = filePath.match(/skills\/([^/]+)\/SKILL\.md$/i);
+	return match
+		? match[1]
+		: filePath.split("/").pop()?.replace(".md", "") || "unknown";
+}
+
+/**
+ * Parse provenance from frontmatter
+ */
+function parseProvenance(frontmatter: Record<string, unknown>): ProvenanceData {
+	return {
+		implements: (frontmatter.provenance as string) || undefined,
+		related_implementation:
+			(frontmatter.related_implementation as string) || undefined,
+		author: (frontmatter.author as string) || undefined,
+		version: (frontmatter.version as string) || undefined,
+	};
+}
+
+/**
+ * Extract a knowledge node from a SKILL.md file
+ */
+export function extractSkillNode(
+	filePath: string,
+	content: string,
+	frontmatter: Record<string, unknown>,
+): KnowledgeNode {
+	const skillId = extractSkillId(filePath);
+	const provenance = parseProvenance(frontmatter);
+	const okf = parseSKILL(content);
+
+	return {
+		id: `skill:${skillId}`,
+		type: "skill",
+		data: {
+			title: (frontmatter.title as string) || okf.title || skillId,
+			description: okf.sections[0]?.content.slice(0, 200) || undefined,
+			tags: (frontmatter.tags as string[]) || [],
+			source: filePath,
+		},
+	};
+}
+
+/**
+ * Extract edges from a SKILL.md file
+ */
+export function extractSkillEdges(
+	filePath: string,
+	content: string,
+	frontmatter: Record<string, unknown>,
+): KnowledgeEdge[] {
+	const skillId = extractSkillId(filePath);
+	const provenance = parseProvenance(frontmatter);
+	const edges: KnowledgeEdge[] = [];
+
+	// Provenance: implements RFC
+	if (provenance.implements) {
+		const rfcNum = provenance.implements
+			.replace(/RFC[- ]?/i, "")
+			.padStart(4, "0");
+		edges.push({
+			from: `skill:${skillId}`,
+			to: `rfc:RFC-${rfcNum}`,
+			type: "implements",
+			metadata: { source: "frontmatter:provenance.implements" },
+		});
+	}
+
+	// Provenance: documents implementation
+	if (provenance.related_implementation) {
+		edges.push({
+			from: `skill:${skillId}`,
+			to: `implementation:${provenance.related_implementation}`,
+			type: "documents",
+			metadata: { source: "frontmatter:related_implementation" },
+		});
+	}
+
+	// Content: RFC references
+	const rfcRefs = extractRFCRefs(content);
+	for (const rfc of rfcRefs) {
+		if (rfc !== provenance.implements) {
+			// Don't duplicate
+			edges.push({
+				from: `skill:${skillId}`,
+				to: rfc,
+				type: "references",
+				metadata: { source: "content:regex" },
+			});
+		}
+	}
+
+	// Content: wiki links
+	const wikiLinks = extractWikiLinks(content);
+	for (const link of wikiLinks) {
+		if (link.startsWith("skill:")) {
+			edges.push({
+				from: `skill:${skillId}`,
+				to: link,
+				type: "related_to",
+				metadata: { source: "content:wiki-link" },
+			});
+		}
+	}
+
+	return edges;
+}
+
+/**
+ * Extract RFC nodes from RFC markdown files
+ */
+export function extractRFCNode(
+	filePath: string,
+	content: string,
+	title: string,
+): KnowledgeNode {
+	// Extract RFC number from filename: RFC-0106_KNOWLEDGE_GRAPH_PROVENANCE.md
+	const match = filePath.match(/RFC[- ]?(\d{4})/i);
+	const rfcNum = match ? match[1].padStart(4, "0") : "0000";
+
+	// Extract summary from first paragraph
+	const summaryMatch = content.match(/## Summary\n+([^\n]+)/i);
+	const summary = summaryMatch ? summaryMatch[1].slice(0, 200) : undefined;
+
+	// Extract tags from content
+	const tagMatches = content.match(/tag[s]?:?\s*\[([^\]]+)\]/i);
+	const tags = tagMatches
+		? tagMatches[1].split(",").map((t) => t.trim().toLowerCase())
+		: [];
+
+	return {
+		id: `rfc:RFC-${rfcNum}`,
+		type: "rfc",
+		data: {
+			title,
+			description: summary,
+			tags,
+			source: filePath,
+			url: `https://github.com/ManotLuijiu/pi-harness-runtime/blob/main/${filePath}`,
+		},
+	};
+}
+
+/**
+ * Extract edges between RFCs
+ */
+export function extractRFCEdges(
+	filePath: string,
+	content: string,
+): KnowledgeEdge[] {
+	const edges: KnowledgeEdge[] = [];
+
+	// RFC references other RFCs
+	const rfcRefs = extractRFCRefs(content);
+	const match = filePath.match(/RFC[- ]?(\d{4})/i);
+	const rfcNum = match ? `RFC-${match[1].padStart(4, "0")}` : "rfc:unknown";
+
+	for (const ref of rfcRefs) {
+		edges.push({
+			from: rfcNum,
+			to: ref,
+			type: "references",
+			metadata: { source: "content:regex" },
+		});
+	}
+
+	// Supersedes (e.g., "Supersedes RFC-0008")
+	const supersedesMatch = content.match(/supersedes\s+RFC[- ]?(\d{4})/gi);
+	if (supersedesMatch) {
+		for (const match of supersedesMatch) {
+			const numMatch = match.match(/\d{4}/);
+			if (numMatch) {
+				const superseded = `RFC-${numMatch[0].padStart(4, "0")}`;
+				edges.push({
+					from: rfcNum,
+					to: superseded,
+					type: "supersedes",
+					metadata: { source: "content:supersedes" },
+				});
+			}
+		}
+	}
+
+	return edges;
+}
+
+/**
+ * Build complete knowledge graph from directory
+ */
+export async function extractKnowledgeGraph(
+	skillsPath: string,
+	rfcPath: string,
+): Promise<KnowledgeGraph> {
+	const { readdir, readFile } = await import("fs/promises");
+	const { join } = await import("path");
+
+	const nodes: KnowledgeNode[] = [];
+	const edges: KnowledgeEdge[] = [];
+
+	// Extract skill nodes and edges
+	try {
+		const skillDirs = await readdir(skillsPath, { withFileTypes: true });
+
+		for (const dir of skillDirs) {
+			if (!dir.isDirectory()) continue;
+
+			const skillPath = join(skillsPath, dir.name, "SKILL.md");
+			try {
+				const content = await readFile(skillPath, "utf-8");
+				const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+				const frontmatter: Record<string, unknown> = {};
+
+				if (frontmatterMatch) {
+					for (const line of frontmatterMatch[1].split("\n")) {
+						const [key, ...valueParts] = line.split(":");
+						if (key && valueParts.length) {
+							const value = valueParts.join(":").trim();
+							// Handle arrays
+							if (value.startsWith("[")) {
+								frontmatter[key.trim()] = value
+									.slice(1, -1)
+									.split(",")
+									.map((v) => v.trim().replace(/['"]/g, ""));
+							} else {
+								frontmatter[key.trim()] = value.replace(/['"]/g, "");
+							}
+						}
+					}
+				}
+
+				const node = extractSkillNode(skillPath, content, frontmatter);
+				nodes.push(node);
+
+				const skillEdges = extractSkillEdges(skillPath, content, frontmatter);
+				edges.push(...skillEdges);
+			} catch {
+				// Skip files that can't be read
+			}
+		}
+	} catch {
+		// Skills directory might not exist
+	}
+
+	// Extract RFC nodes and edges
+	try {
+		const rfcFiles = await readdir(rfcPath);
+
+		for (const file of rfcFiles) {
+			if (!file.match(/^RFC[- ]?\d{4}_.*\.md$/i)) continue;
+
+			const filePath = join(rfcPath, file);
+			const content = await readFile(filePath, "utf-8");
+
+			// Extract title from first # heading
+			const titleMatch = content.match(/^#\s+(.+)$/m);
+			const title = titleMatch
+				? titleMatch[1].replace(/^RFC[-\d]+\s*[-–]\s*/, "")
+				: file;
+
+			const node = extractRFCNode(filePath, content, title);
+			nodes.push(node);
+
+			const rfcEdges = extractRFCEdges(filePath, content);
+			edges.push(...rfcEdges);
+		}
+	} catch {
+		// RFC directory might not exist
+	}
+
+	return { nodes, edges };
+}

package/packages/knowledge-graph/src/index.ts

@@ -0,0 +1,27 @@
+/**
+ * Knowledge Graph - RFC-0106
+ *
+ * Knowledge Graph extraction and provenance linking for SKILL.md files.
+ *
+ * @example
+ * ```typescript
+ * import { extractKnowledgeGraph, completeGraph, syncGraphToKnowledgeService } from '@pi-harness/knowledge-graph';
+ *
+ * // Extract graph from skills directory
+ * const graph = await extractKnowledgeGraph(
+ *   'frappe-bench/.claude-plugins/moocoding-skills/skills',
+ *   'pi-harness-runtime/RFC'
+ * );
+ *
+ * // Complete with provenance edges
+ * const fullGraph = completeGraph(graph);
+ *
+ * // Sync to TencentDB Knowledge Service
+ * await syncGraphToKnowledgeService(fullGraph, config);
+ * ```
+ */
+
+export * from "./types.js";
+export * from "./graph-extractor.js";
+export * from "./provenance-linker.js";
+export * from "./mcp-client.js";