pi-harness-runtime 1.1.0 → 1.1.2

package/packages/tencentdb-sync/src/client.ts

@@ -0,0 +1,268 @@
+/**
+ * TencentDB Knowledge Service Client (RFC-0105/0106)
+ *
+ * Client for TencentDB-Agent-Memory Knowledge Service
+ * Base URL: https://your-memory-server.example.com/v3/
+ */
+
+export interface ApiResponse<T> {
+  code: number;
+  message: string;
+  request_id?: string;
+  data?: T;
+}
+
+export interface Skill {
+  skill_id: string;
+  name: string;
+  description: string;
+  version: number;
+  is_head: boolean;
+  status: string;
+  owner_user_id: string;
+  owner_agent_id: string;
+  team_id: string;
+  task_id: string;
+  created_at_ms: number;
+  updated_at_ms: number;
+}
+
+export interface SkillSearchResult extends Skill {
+  score: number;
+  snippet?: string;
+}
+
+export interface Knowledge {
+  id: string;
+  title: string;
+  content: string;
+  team_id: string;
+  created_at_ms: number;
+  updated_at_ms: number;
+}
+
+export interface HealthStatus {
+  status: string;
+  version?: string;
+  uptime?: number;
+  stores?: { vectorStore?: boolean };
+}
+
+/**
+ * TencentDB Knowledge Service API Client
+ */
+export class TencentDBClient {
+  private baseUrl: string;
+  private userKey: string;
+  private serviceId: string;
+
+  constructor(options: {
+    serverUrl: string;
+    userKey: string;
+    serviceId?: string;
+  }) {
+    // Remove trailing slash and ensure /v3/ path
+    this.baseUrl = options.serverUrl.replace(/\/$/, "") + "/v3";
+    this.userKey = options.userKey;
+    this.serviceId = options.serviceId || "default";
+  }
+
+  private headers(): Record<string, string> {
+    return {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${this.userKey}`,
+      "x-tdai-service-id": this.serviceId,
+    };
+  }
+
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: unknown,
+  ): Promise<T> {
+    const url = `${this.baseUrl}${path}`;
+    const response = await fetch(url, {
+      method,
+      headers: this.headers(),
+      body: body ? JSON.stringify(body) : undefined,
+      signal: AbortSignal.timeout(30000),
+    });
+
+    const result = await response.json() as ApiResponse<T>;
+
+    if (result.code !== 0) {
+      throw new Error(`API error ${result.code}: ${result.message}`);
+    }
+
+    return result.data as T;
+  }
+
+  /**
+   * Health check
+   */
+  async health(): Promise<HealthStatus> {
+    // Try /v3/health first, then fall back to root /health
+    try {
+      return await this.request<HealthStatus>("GET", "/health");
+    } catch {
+      // If that fails, try the root endpoint
+      const url = `${this.baseUrl.replace("/v3", "")}/health`;
+      const response = await fetch(url, {
+        headers: this.headers(),
+        signal: AbortSignal.timeout(5000),
+      });
+      if (!response.ok) {
+        return { status: "error" };
+      }
+      return response.json() as Promise<HealthStatus>;
+    }
+  }
+
+  // ==================== Skills API ====================
+
+  /**
+   * List all skills
+   */
+  async skillList(): Promise<{ items: Skill[]; total: number }> {
+    const result = await this.request<{ items: Skill[]; total: number }>(
+      "POST",
+      "/skill/list",
+      {},
+    );
+    return result;
+  }
+
+  /**
+   * Get skill by name
+   */
+  async skillGet(name: string): Promise<Skill | null> {
+    try {
+      return await this.request<Skill>("POST", "/skill/get", { name });
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Create or update skill
+   */
+  async skillCreate(options: {
+    name: string;
+    content: string;
+    description?: string;
+    tags?: string[];
+  }): Promise<Skill> {
+    return this.request<Skill>("POST", "/skill/create", {
+      name: options.name,
+      content: options.content,
+      description: options.description,
+      tags: options.tags,
+    });
+  }
+
+  /**
+   * Update skill
+   */
+  async skillUpdate(options: {
+    name: string;
+    content: string;
+    description?: string;
+  }): Promise<Skill> {
+    return this.request<Skill>("POST", "/skill/update", {
+      name: options.name,
+      content: options.content,
+      description: options.description,
+    });
+  }
+
+  /**
+   * Delete skill
+   */
+  async skillDelete(name: string): Promise<void> {
+    await this.request("POST", "/skill/delete", { name });
+  }
+
+  /**
+   * Search skills
+   */
+  async skillSearch(query: string, limit = 10): Promise<SkillSearchResult[]> {
+    const result = await this.request<{ items: SkillSearchResult[] }>(
+      "POST",
+      "/skill/search",
+      { query, limit },
+    );
+    return result?.items || [];
+  }
+
+  // ==================== Knowledge API ====================
+
+  /**
+   * List knowledge items
+   */
+  async knowledgeList(teamId?: string): Promise<{ items: Knowledge[]; total: number }> {
+    return this.request<{ items: Knowledge[]; total: number }>(
+      "POST",
+      "/knowledge/list",
+      { team_id: teamId || this.serviceId },
+    );
+  }
+
+  /**
+   * Get knowledge by ID
+   */
+  async knowledgeGet(id: string): Promise<Knowledge | null> {
+    try {
+      return await this.request<Knowledge>("POST", "/knowledge/get", { id });
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Create knowledge
+   */
+  async knowledgeCreate(options: {
+    title: string;
+    content: string;
+    teamId?: string;
+  }): Promise<Knowledge> {
+    return this.request<Knowledge>("POST", "/knowledge/create", {
+      title: options.title,
+      content: options.content,
+      team_id: options.teamId || this.serviceId,
+    });
+  }
+
+  /**
+   * Update knowledge
+   */
+  async knowledgeUpdate(options: {
+    id: string;
+    title?: string;
+    content?: string;
+  }): Promise<Knowledge> {
+    return this.request<Knowledge>("POST", "/knowledge/update", {
+      id: options.id,
+      title: options.title,
+      content: options.content,
+    });
+  }
+
+  /**
+   * Delete knowledge
+   */
+  async knowledgeDelete(id: string): Promise<void> {
+    await this.request("POST", "/knowledge/delete", { id });
+  }
+}
+
+/**
+ * Create TencentDB client
+ */
+export function createTencentDBClient(options: {
+  serverUrl: string;
+  userKey: string;
+  serviceId?: string;
+}): TencentDBClient {
+  return new TencentDBClient(options);
+}

package/packages/tencentdb-sync/src/config.ts

@@ -0,0 +1,139 @@
+/**
+ * TencentDB Sync Config (RFC-0105/0106)
+ *
+ * Loads configuration from env vars or .pi/settings.json
+ */
+
+export interface SyncConfig {
+	// Server connection
+	serverUrl: string; // e.g., "https://your-memory-server.example.com"
+	knowledgeUrl: string; // e.g., "https://your-memory-server.example.com:8424"
+	userKey: string; // sk-mem-xxx
+	serviceId: string; // default
+
+	// Skills source
+	skillsSource: string; // e.g., "~/frappe-bench/.claude-plugins/moocoding-skills/skills"
+
+	// Sync options
+	autoSync: boolean;
+	syncIntervalMs: number;
+	watchMode: boolean;
+}
+
+const DEFAULT_CONFIG: Partial<SyncConfig> = {
+	serviceId: "default",
+	autoSync: false,
+	syncIntervalMs: 3600000, // 1 hour
+	watchMode: false,
+};
+
+/**
+ * Load config from environment variables
+ */
+export function loadConfigFromEnv(): Partial<SyncConfig> {
+	return {
+		serverUrl: process.env.TENANTDB_URL || process.env.MEMORY_SERVER_URL,
+		knowledgeUrl: process.env.TENANTDB_KNOWLEDGE_URL,
+		userKey: process.env.TENANTDB_USER_KEY || process.env.TENANTDB_KEY,
+		serviceId: process.env.TENANTDB_SERVICE_ID || "default",
+		skillsSource: process.env.TENANTDB_SKILLS_SOURCE,
+		autoSync: process.env.TENANTDB_AUTO_SYNC === "true",
+		syncIntervalMs: process.env.TENANTDB_SYNC_INTERVAL
+			? parseInt(process.env.TENANTDB_SYNC_INTERVAL) * 1000
+			: undefined,
+	};
+}
+
+/**
+ * Load config from .pi/settings.json
+ */
+export async function loadConfigFromSettings(): Promise<Partial<SyncConfig>> {
+	const fs = await import("node:fs");
+	const path = await import("node:path");
+	const homedir = process.env.HOME || process.env.USERPROFILE || "~";
+
+	const settingsPath = path.join(homedir, ".pi", "settings.json");
+
+	if (!fs.existsSync(settingsPath)) {
+		return {};
+	}
+
+	try {
+		const content = fs.readFileSync(settingsPath, "utf-8");
+		const settings = JSON.parse(content);
+
+		if (settings.tencentdb) {
+			return {
+				serverUrl: settings.tencentdb.url || settings.tencentdb.serverUrl,
+				knowledgeUrl: settings.tencentdb.knowledgeUrl,
+				userKey: settings.tencentdb.userKey || settings.tencentdb.key,
+				serviceId: settings.tencentdb.serviceId || "default",
+				skillsSource: settings.tencentdb.skillsSource,
+				autoSync: settings.tencentdb.autoSync,
+				syncIntervalMs: settings.tencentdb.syncIntervalMs
+					? settings.tencentdb.syncIntervalMs * 1000
+					: undefined,
+			};
+		}
+	} catch {
+		// Ignore parse errors
+	}
+
+	return {};
+}
+
+/**
+ * Merge configs (env > settings > defaults)
+ */
+export async function loadConfig(): Promise<SyncConfig> {
+	const defaults = DEFAULT_CONFIG;
+	const fromSettings = await loadConfigFromSettings();
+	const fromEnv = loadConfigFromEnv();
+
+	// Knowledge URL defaults to serverUrl if not specified
+	const serverUrl = fromEnv.serverUrl || fromSettings.serverUrl || "";
+	const knowledgeUrl =
+		fromEnv.knowledgeUrl ||
+		fromSettings.knowledgeUrl ||
+		`${serverUrl.replace(/:\d+$/, "")}:8424`;
+
+	return {
+		serverUrl,
+		knowledgeUrl,
+		userKey: fromEnv.userKey || fromSettings.userKey || "",
+		serviceId: fromEnv.serviceId || fromSettings.serviceId || "default",
+		skillsSource: fromEnv.skillsSource || fromSettings.skillsSource || "",
+		autoSync: fromEnv.autoSync ?? fromSettings.autoSync ?? defaults.autoSync!,
+		syncIntervalMs:
+			fromEnv.syncIntervalMs ||
+			fromSettings.syncIntervalMs ||
+			defaults.syncIntervalMs!,
+		watchMode:
+			fromEnv.watchMode ?? fromSettings.watchMode ?? defaults.watchMode!,
+	};
+}
+
+/**
+ * Validate config
+ */
+export function validateConfig(config: SyncConfig): string[] {
+	const errors: string[] = [];
+
+	if (!config.serverUrl) {
+		errors.push("TENANTDB_URL is required (set env var or .pi/settings.json)");
+	}
+
+	if (!config.userKey) {
+		errors.push(
+			"TENANTDB_USER_KEY is required (set env var or .pi/settings.json)",
+		);
+	}
+
+	if (!config.skillsSource) {
+		errors.push(
+			"TENANTDB_SKILLS_SOURCE is required (set env var or .pi/settings.json)",
+		);
+	}
+
+	return errors;
+}

package/packages/tencentdb-sync/src/index.ts

@@ -0,0 +1,15 @@
+/**
+ * TencentDB Sync (RFC-0105/0106)
+ *
+ * Syncs SKILL.md files to TencentDB-Agent-Memory server.
+ */
+
+export { createTencentDBClient, TencentDBClient } from "./client.js";
+export type {
+  Skill,
+  SkillSearchResult,
+  Knowledge,
+  HealthStatus,
+} from "./client.js";
+
+export { loadConfig, validateConfig, type SyncConfig } from "./config.js";

package/packages/test-data-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/test-data-generator",
-  "version": "1.1.0",
+  "version": "0.10.30",
   "description": "Test data generation for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/test-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/test-generator",
-  "version": "1.1.0",
+  "version": "0.10.30",
   "description": "Auto-Test Generator — generate unit and E2E tests from source code (RFC-0013)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/todo-bd-sync/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/todo-bd-sync",
-  "version": "1.1.0",
+  "version": "0.10.30",
   "description": "Two-way sync between rpiv-todo overlay and bd issue tracker",
   "type": "module",
   "main": "src/index.ts",

package/packages/todo-bd-sync/src/detector.ts

@@ -91,6 +91,16 @@ export function isBdInstalled(): boolean {
 	}
 }
 
+/**
+ * Check if bd is initialized in the current project
+ * (i.e., .beads/ directory exists)
+ */
+export function isBdInitialized(cwd?: string): boolean {
+	const projectDir = cwd || process.cwd();
+	const beadsDir = join(projectDir, ".beads");
+	return existsSync(beadsDir);
+}
+
 /**
  * Get the version of bd CLI if installed
  */
@@ -106,6 +116,9 @@ export function getBdVersion(): string | null {
 	}
 }
 
+/**
+ * Get installation status of both dependencies
+ */
 /**
  * Get installation status of both dependencies
  */
@@ -118,10 +131,13 @@ export interface DependencyStatus {
 	bd: {
 		installed: boolean;
 		version: string | null;
+		initialized: boolean;
+		installUrl: string;
 	};
 }
 
-export function getDependencyStatus(): DependencyStatus {
+export function getDependencyStatus(cwd?: string): DependencyStatus {
+	const installed = isBdInstalled();
 	return {
 		rpivTodo: {
 			installed: isRpivTodoInstalled(),
@@ -129,8 +145,10 @@ export function getDependencyStatus(): DependencyStatus {
 			loaded: isRpivTodoLoaded(),
 		},
 		bd: {
-			installed: isBdInstalled(),
-			version: getBdVersion(),
+			installed,
+			version: installed ? getBdVersion() : null,
+			initialized: installed ? isBdInitialized(cwd) : false,
+			installUrl: "https://github.com/beads/bd#installation",
 		},
 	};
 }
@@ -145,6 +163,9 @@ export function logDependencyStatus(): void {
 		`  rpiv-todo: installed=${status.rpivTodo.installed}, version=${status.rpivTodo.version}, loaded=${status.rpivTodo.loaded}`,
 	);
 	console.log(
-		`  bd: installed=${status.bd.installed}, version=${status.bd.version}`,
+		`  bd: installed=${status.bd.installed}, version=${status.bd.version}, initialized=${status.bd.initialized}`,
 	);
+	if (!status.bd.installed) {
+		console.log(`  bd install: ${status.bd.installUrl}`);
+	}
 }

package/packages/todo-bd-sync/src/extension.ts

@@ -1,101 +1,23 @@
 /**
  * todo-bd-sync extension entry point
  *
- * This is the pi-coding-agent extension that:
- * 1. Auto-injects "todo-list" to prompt to enable rpiv-todo
- * 2. Sets up two-way sync between rpiv-todo and bd
- * 3. Loads existing bd issues on session start
- *
- * To use this extension:
- * 1. Install dependencies:
- *    pi install npm:@juicesharp/rpiv-todo
- *    (bd should already be installed)
- *
- * 2. The extension auto-enables when rpiv-todo is detected
+ * NOTE: Auto-injection disabled - was causing noisy output.
+ * Only provides dependency detection status.
  */
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import {
-	createTodoBdSync,
-	type TodoBdSync,
-	type TodoBdSyncConfig,
-} from "./index.js";
-import { getDependencyStatus, logDependencyStatus } from "./detector.js";
-import { createCustomReminder } from "./todo-reminder.js";
-import { getOpenBdIssues } from "./sync.js";
 
 /**
  * Register the todo-bd-sync extension
+ *
+ * NOTE: Auto-injection disabled - was causing issues with bd working.
+ * The todo tool call injection has been removed.
  */
-export function registerTodoBdSync(
-	pi: ExtensionAPI,
-	config?: TodoBdSyncConfig,
-): TodoBdSync | null {
-	const deps = getDependencyStatus();
-
-	// Check if bd is installed
-	if (!deps.bd.installed) {
-		console.log("[DEBUG todo-bd-sync] bd CLI not found - skipping todo sync");
-		console.log(
-			"[todo-bd-sync] Install bd: see https://github.com/gastownhall/beads",
-		);
-		return null;
-	}
-
-	// Log dependency status for debugging
-	if (config?.debug) {
-		logDependencyStatus();
-	}
-
-	// Check if rpiv-todo is installed
-	const rpivTodoStatus = deps.rpivTodo.installed
-		? "installed"
-		: "not installed (using fallback)";
-
-	console.log(`[todo-bd-sync] rpiv-todo: ${rpivTodoStatus}`);
-	console.log("[DEBUG todo-bd-sync] bd CLI: installed");
-
-	// Create and start sync
-	const sync = createTodoBdSync(pi, {
-		autoInjectPrompt: true,
-		syncDirection: "both",
-		loadOnSessionStart: true,
-		...config,
-	});
-
-	sync.start();
-
-	// Start todo reminder (DISABLED by default — Phase 1 emergency containment)
-	// Reminder spam was causing transcript growth. Enable only after proper task scoping.
-	const reminder = createCustomReminder(
-		pi,
-		() => {
-			// Get remaining todos from bd
-			const issues = getOpenBdIssues();
-			return issues
-				.filter((i) => i.status !== "closed")
-				.map((i) => ({
-					id: i.id,
-					title: i.title,
-					status: i.status,
-				}));
-		},
-		{
-			autoRemind: false, // DISABLED — fix reminder spam before re-enabling
-			minPendingTasks: 1,
-		},
-	);
-	reminder.start();
-
-	console.log("[DEBUG todo-bd-sync] Enabled - two-way sync active");
-	console.log(
-		"[todo-bd-sync] Reminder DISABLED — set autoRemind: true to enable",
-	);
-
-	return sync;
+export function registerTodoBdSync(_pi: ExtensionAPI): void {
+	// Silent - no registration, no injection, no console output
 }
 
 // Default export for pi extension loading
 export default function todoBdSyncExtension(pi: ExtensionAPI): void {
-	registerTodoBdSync(pi, { debug: false });
+	registerTodoBdSync(pi);
 }