pi-harness-runtime 1.1.0 → 1.1.2

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

@@ -0,0 +1,86 @@
+/**
+ * Knowledge Graph - RFC-0106
+ *
+ * Typed definitions for knowledge graph nodes and edges.
+ */
+
+// --- Node Types ---
+
+export type KnowledgeNodeType =
+  | 'skill'           // SKILL.md entry
+  | 'rfc'             // RFC document
+  | 'implementation'  // IMPLEMENTATION/* entry
+  | 'concept'         // Abstract concept
+  | 'api'             // API endpoint
+  | 'cli'             // CLI command
+  | 'pattern'         // Code pattern
+  | 'workflow';       // Workflow/SOP
+
+export interface KnowledgeNode {
+  id: string;           // e.g., "skill:frappe-custom-field-lifecycle"
+  type: KnowledgeNodeType;
+  data: {
+    title: string;
+    description?: string;
+    tags: string[];
+    source?: string;     // File path
+    url?: string;        // RFC/IMPLEMENTATION URL
+  };
+}
+
+// --- Edge Types ---
+
+export type KnowledgeEdgeType =
+  | 'implements'       // Skill implements RFC
+  | 'depends_on'       // Skill A depends on Skill B
+  | 'supersedes'       // New version replaces old
+  | 'related_to'       // General relationship
+  | 'authored_by'      // Author attribution
+  | 'documents'        // RFC/Impl documents a skill
+  | 'references';      // RFC references implementation
+
+export interface KnowledgeEdge {
+  from: string;          // Node ID
+  to: string;            // Node ID
+  type: KnowledgeEdgeType;
+  metadata?: {
+    confidence?: number;  // 0-1
+    source?: string;       // How was this edge discovered
+  };
+}
+
+// --- Graph ---
+
+export interface KnowledgeGraph {
+  nodes: KnowledgeNode[];
+  edges: KnowledgeEdge[];
+}
+
+export interface ProvenanceData {
+  implements?: string;          // RFC number (e.g., "RFC-0106")
+  related_implementation?: string;  // IMPLEMENTATION path
+  author?: string;
+  version?: string;
+}
+
+// --- Search ---
+
+export interface SearchResult {
+  node: KnowledgeNode;
+  score: number;
+  highlights?: string[];
+}
+
+export interface SearchOptions {
+  limit?: number;
+  type?: KnowledgeNodeType;
+  tags?: string[];
+}
+
+// --- Config ---
+
+export interface TencentDBConfig {
+  knowledgeUrl: string;    // http://{host}:8424
+  userKey: string;
+  serviceId: string;
+}

package/packages/knowledge-retrieval/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@pi-harness/knowledge-retrieval",
+  "version": "0.10.30",
+  "description": "Knowledge retrieval via TencentDB-Agent-Memory MCP (RFC-0105)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc --skipLibCheck",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "undici": "^8.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  }
+}

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

@@ -0,0 +1,18 @@
+/**
+ * Knowledge Retrieval (RFC-0105)
+ *
+ * Centralized knowledge retrieval via TencentDB-Agent-Memory MCP.
+ */
+
+export {
+  KnowledgeRetrievalClient,
+  createKnowledgeClient,
+  type KnowledgeRetrievalConfig,
+} from "./mcp-client.js";
+export type {
+  SearchOptions,
+  SearchResult,
+  CodeGraphResult,
+  SyncResult,
+  OKFDocument,
+} from "./types.js";

package/packages/knowledge-retrieval/src/mcp-client.ts

@@ -0,0 +1,212 @@
+/**
+ * TencentDB-Agent-Memory MCP Client (RFC-0105)
+ *
+ * Client for interacting with TencentDB-Agent-Memory server via MCP protocol.
+ */
+
+import { fetch } from "undici";
+import type {
+  SearchOptions,
+  SearchResult,
+  CodeGraphResult,
+} from "./types.js";
+
+const DEFAULT_TIMEOUT_MS = 5000;
+const DEFAULT_MAX_RESULTS = 5;
+
+/**
+ * Configuration for TencentDB-Agent-Memory server connection
+ */
+export interface KnowledgeRetrievalConfig {
+  /** Server URL (e.g., http://localhost:8080 or https://memory.example.com) */
+  serverUrl: string;
+  /** Optional API key for authentication */
+  apiKey?: string;
+  /** Default max results per search */
+  maxResults?: number;
+  /** Request timeout in ms */
+  timeoutMs?: number;
+}
+
+/**
+ * MCP Client for TencentDB-Agent-Memory
+ */
+export class KnowledgeRetrievalClient {
+  private config: Required<KnowledgeRetrievalConfig>;
+
+  constructor(config: KnowledgeRetrievalConfig) {
+    this.config = {
+      serverUrl: config.serverUrl.replace(/\/$/, ""),
+      apiKey: config.apiKey ?? "",
+      maxResults: config.maxResults ?? DEFAULT_MAX_RESULTS,
+      timeoutMs: config.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+    };
+  }
+
+  /**
+   * Make MCP request to server
+   */
+  private async request<T>(
+    method: string,
+    params: Record<string, unknown> = {},
+  ): Promise<T> {
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+    };
+
+    if (this.config.apiKey) {
+      headers["Authorization"] = `Bearer ${this.config.apiKey}`;
+    }
+
+    const response = await fetch(`${this.config.serverUrl}/mcp`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method,
+        params,
+      }),
+      signal: AbortSignal.timeout(this.config.timeoutMs),
+    });
+
+    if (!response.ok) {
+      throw new Error(
+        `MCP request failed: ${response.status} ${response.statusText}`,
+      );
+    }
+
+    const data = (await response.json()) as {
+      result?: T;
+      error?: { code: number; message: string };
+    };
+
+    if (data.error) {
+      throw new Error(`MCP error: ${data.error.message}`);
+    }
+
+    return data.result as T;
+  }
+
+  /**
+   * Search skills/knowledge via hybrid retrieval
+   */
+  async search(options: SearchOptions): Promise<SearchResult[]> {
+    const limit = options.limit ?? this.config.maxResults;
+
+    const result = await this.request<{
+      results: Array<{
+        id: string;
+        title: string;
+        content: string;
+        score: number;
+        source: string;
+        tags: string[];
+        links: string[];
+        updatedAt: string;
+      }>;
+    }>("tdai_memory_search", {
+      query: options.query,
+      limit,
+      ...(options.tags && { tags: options.tags }),
+      ...(options.source && { source: options.source }),
+    });
+
+    return result.results.map((r) => ({
+      id: r.id,
+      title: r.title,
+      content: r.content,
+      score: r.score,
+      source: r.source,
+      tags: r.tags,
+      links: r.links,
+      updatedAt: r.updatedAt,
+    }));
+  }
+
+  /**
+   * Search conversations
+   */
+  async searchConversations(
+    query: string,
+    limit?: number,
+  ): Promise<SearchResult[]> {
+    const result = await this.request<{
+      results: Array<{
+        id: string;
+        title: string;
+        content: string;
+        score: number;
+        source: string;
+        tags: string[];
+        links: string[];
+        updatedAt: string;
+      }>;
+    }>("tdai_conversation_search", {
+      query,
+      limit: limit ?? this.config.maxResults,
+    });
+
+    return result.results.map((r) => ({
+      id: r.id,
+      title: r.title,
+      content: r.content,
+      score: r.score,
+      source: r.source,
+      tags: r.tags,
+      links: r.links,
+      updatedAt: r.updatedAt,
+    }));
+  }
+
+  /**
+   * Query code graph
+   */
+  async queryCodeGraph(symbol: string): Promise<CodeGraphResult> {
+    return this.request<CodeGraphResult>("tdai_codegraph_query", {
+      symbol,
+    });
+  }
+
+  /**
+   * Get list of available tools from server
+   */
+  async listTools(): Promise<
+    Array<{ name: string; description: string }>
+  > {
+    const result = await this.request<{
+      tools: Array<{ name: string; description: string }>;
+    }>("tools/list", {});
+
+    return result.tools;
+  }
+
+  /**
+   * Check server health
+   */
+  async healthCheck(): Promise<{ status: string; version?: string }> {
+    try {
+      const response = await fetch(`${this.config.serverUrl}/health`, {
+        signal: AbortSignal.timeout(2000),
+      });
+
+      if (response.ok) {
+        return response.json() as Promise<{ status: string; version?: string }>;
+      }
+
+      return { status: "unhealthy" };
+    } catch {
+      return { status: "unreachable" };
+    }
+  }
+}
+
+/**
+ * Create a KnowledgeRetrievalClient from URL string
+ */
+export function createKnowledgeClient(
+  serverUrl: string,
+  options?: Partial<Omit<KnowledgeRetrievalConfig, "serverUrl">>,
+): KnowledgeRetrievalClient {
+  return new KnowledgeRetrievalClient({ serverUrl, ...options });
+}

package/packages/knowledge-retrieval/src/types.ts

@@ -0,0 +1,112 @@
+/**
+ * Knowledge Retrieval Types (RFC-0105)
+ *
+ * Types for TencentDB-Agent-Memory MCP integration.
+ */
+
+/**
+ * Configuration for TencentDB-Agent-Memory server connection
+ */
+export interface KnowledgeRetrievalConfig {
+  /** Server URL (e.g., http://localhost:8080 or https://memory.example.com) */
+  serverUrl: string;
+  /** Optional API key for authentication */
+  apiKey?: string;
+  /** Default max results per search */
+  maxResults?: number;
+  /** Request timeout in ms */
+  timeoutMs?: number;
+}
+
+/**
+ * Search query options
+ */
+export interface SearchOptions {
+  /** Search query string */
+  query: string;
+  /** Max results to return (default: 5) */
+  limit?: number;
+  /** Filter by tags */
+  tags?: string[];
+  /** Filter by source path */
+  source?: string;
+}
+
+/**
+ * Search result item
+ */
+export interface SearchResult {
+  /** Unique result ID */
+  id: string;
+  /** Document title */
+  title: string;
+  /** Document content/summary */
+  content: string;
+  /** Relevance score (0-1) */
+  score: number;
+  /** Original source path */
+  source: string;
+  /** Document tags */
+  tags: string[];
+  /** Links to other OKF documents */
+  links: string[];
+  /** Last updated timestamp */
+  updatedAt: string;
+}
+
+/**
+ * Code graph query result
+ */
+export interface CodeGraphResult {
+  /** Symbol/function name */
+  symbol: string;
+  /** File path */
+  file: string;
+  /** Symbol type (function, class, etc.) */
+  kind: string;
+  /** Callers of this symbol */
+  callers: string[];
+  /** Callees of this symbol */
+  callees: string[];
+  /** Impact paths */
+  impactPaths: string[];
+}
+
+/**
+ * Sync result
+ */
+export interface SyncResult {
+  /** Total skills processed */
+  total: number;
+  /** Successfully synced */
+  success: number;
+  /** Failed syncs */
+  failed: number;
+  /** Errors if any */
+  errors: string[];
+}
+
+/**
+ * OKF document format for ingestion
+ */
+export interface OKFDocument {
+  id: string;
+  title: string;
+  sections: OKFSection[];
+  links: string[];
+  metadata: OKFMetadata;
+}
+
+export interface OKFSection {
+  id: string;
+  title: string;
+  content: string;
+  level: number;
+}
+
+export interface OKFMetadata {
+  source: string;
+  tags: string[];
+  created: string;
+  updated: string;
+}

package/packages/laravel-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/laravel-plugin",
-  "version": "1.1.0",
+  "version": "0.10.30",
   "description": "Laravel framework analysis — artisan commands, Eloquent models, Blade",
   "type": "module",
   "main": "./dist/index.js",

package/packages/learning-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/learning-engine",
-  "version": "1.1.0",
+  "version": "0.10.30",
   "description": "Learning engine for extracting lessons from runtime execution (RFC-0058)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/mcp-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/mcp-adapter",
-  "version": "1.1.0",
+  "version": "0.10.30",
   "type": "module",
   "description": "MCP server adapter for pi-harness — exposes harness capabilities as MCP tools/resources/prompts (RFC-0068)",
   "main": "dist/index.js",

package/packages/memory-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/memory-engine",
-  "version": "1.1.0",
+  "version": "0.10.30",
   "description": "Memory engine with OKF integration for durable knowledge management (RFC-0060)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/milestone-manager/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pi-harness/milestone-manager",
+  "version": "0.10.30",
+  "description": "Track milestones and alerts when items are at risk",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "echo \"Tests not configured\""
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  }
+}

package/packages/milestone-manager/src/engine.ts

@@ -0,0 +1,105 @@
+/**
+ * Milestone Manager - RFC-0075
+ *
+ * Track milestones and calculate status.
+ */
+
+import type { Milestone, MilestoneStatus, MilestoneManagerOptions } from './types.js';
+
+const DEFAULT_OPTIONS: MilestoneManagerOptions = {
+  atRiskThreshold: 80,
+  missedThreshold: 0,
+};
+
+/**
+ * Calculate milestone status based on progress and time
+ */
+export function calculateMilestoneStatus(
+  milestone: Milestone,
+  options: MilestoneManagerOptions = {}
+): MilestoneStatus {
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  const totalItems = milestone.items.length;
+  const completedItems = milestone.completedItems;
+
+  if (completedItems >= totalItems) {
+    return 'completed';
+  }
+
+  // Check if past target date
+  const targetDate = new Date(milestone.targetDate);
+  const today = new Date();
+  const daysPast = Math.floor((today.getTime() - targetDate.getTime()) / (1000 * 60 * 60 * 24));
+
+  if (opts.missedThreshold && daysPast > opts.missedThreshold) {
+    return 'missed';
+  }
+
+  // Check progress percentage
+  const progressPct = totalItems > 0 ? (completedItems / totalItems) * 100 : 0;
+
+  // Calculate expected progress based on time
+  const startDate = new Date(milestone.targetDate);
+  startDate.setDate(startDate.getDate() - 14); // Assume 2-week sprints
+  const totalDays = 14;
+  const daysElapsed = Math.max(0, Math.min(totalDays, totalDays - daysPast));
+  const expectedPct = (daysElapsed / totalDays) * 100;
+
+  if (progressPct < expectedPct * (1 - opts.atRiskThreshold! / 100)) {
+    return 'at-risk';
+  }
+
+  return 'on-track';
+}
+
+/**
+ * Milestone Manager
+ */
+export class MilestoneManager {
+  private milestones: Map<string, Milestone> = new Map();
+  private options: MilestoneManagerOptions;
+
+  constructor(options: MilestoneManagerOptions = {}) {
+    this.options = { ...DEFAULT_OPTIONS, ...options };
+  }
+
+  addMilestone(milestone: Milestone): void {
+    this.milestones.set(milestone.id, milestone);
+  }
+
+  removeMilestone(id: string): void {
+    this.milestones.delete(id);
+  }
+
+  getMilestone(id: string): Milestone | undefined {
+    return this.milestones.get(id);
+  }
+
+  listMilestones(): Milestone[] {
+    return [...this.milestones.values()];
+  }
+
+  updateMilestone(id: string, update: Partial<Milestone>): void {
+    const milestone = this.milestones.get(id);
+    if (milestone) {
+      this.milestones.set(id, { ...milestone, ...update });
+    }
+  }
+
+  getStatus(id: string): MilestoneStatus | undefined {
+    const milestone = this.milestones.get(id);
+    return milestone ? calculateMilestoneStatus(milestone, this.options) : undefined;
+  }
+
+  getAtRiskMilestones(): Milestone[] {
+    return this.listMilestones().filter(
+      m => calculateMilestoneStatus(m, this.options) === 'at-risk'
+    );
+  }
+
+  getMissedMilestones(): Milestone[] {
+    return this.listMilestones().filter(
+      m => calculateMilestoneStatus(m, this.options) === 'missed'
+    );
+  }
+}

package/packages/milestone-manager/src/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Milestone Manager - RFC-0075
+ */
+
+export * from './types.js';
+export * from './engine.js';

package/packages/milestone-manager/src/types.ts

@@ -0,0 +1,28 @@
+/**
+ * Milestone Manager - RFC-0075
+ *
+ * Track milestones against progress and alert when items are at risk.
+ */
+
+export type MilestoneStatus = 'on-track' | 'at-risk' | 'missed' | 'completed';
+
+export interface Milestone {
+  id: string;
+  title: string;
+  targetDate: string;
+  description?: string;
+  items: string[];  // Item IDs (e.g., task IDs, issue IDs)
+  status: MilestoneStatus;
+  completedItems: number;
+}
+
+export interface MilestoneManagerOptions {
+  atRiskThreshold?: number;  // Percentage (default: 80%)
+  missedThreshold?: number;   // Days past target (default: 0)
+}
+
+export interface MilestoneUpdate {
+  itemId: string;
+  status: 'added' | 'completed' | 'removed';
+  milestoneId: string;
+}

package/packages/model-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/model-registry",
-  "version": "1.1.0",
+  "version": "0.10.30",
   "description": "Model Registry for pi-harness-runtime — centralized model metadata with pricing",
   "type": "module",
   "main": "./dist/index.js",

package/packages/nextjs-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/nextjs-plugin",
-  "version": "1.1.0",
+  "version": "0.10.30",
   "description": "Next.js framework detection and analysis for pi-harness-runtime (RFC-0062)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/notification/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/notification",
-  "version": "1.1.0",
+  "version": "0.10.30",
   "description": "pi-harness-runtime — notification",
   "type": "module",
   "main": "./dist/index.js",