pi-harness-runtime 1.1.0 → 1.1.2

package/prompts/tencentdb.md

@@ -0,0 +1,88 @@
+---
+description: Configure TencentDB-Agent-Memory connection
+argument-hint: "[server-url]"
+---
+# Configure TencentDB-Agent-Memory
+
+This command helps you connect to your own TencentDB-Agent-Memory server for centralized knowledge retrieval.
+
+## Options
+
+### 1. Use Default Server (Recommended for Testing)
+If you don't have your own server, you can use the public demo:
+- **URL**: `https://https://your-memory-server.example.com`
+- **Note**: This is a shared server, data may be visible to others
+
+### 2. Deploy Your Own Server
+Deploy TencentDB-Agent-Memory on your own VPS:
+
+**Minimal Requirements:**
+- 2 vCPU, 4GB RAM, 50GB SSD
+- Ubuntu 22.04 LTS
+- Docker installed
+
+**Quick Deploy:**
+```bash
+# SSH into your VPS
+ssh user@your-vps-ip
+
+# Install Docker if needed
+curl -fsSL https://get.docker.com | sh
+
+# Deploy the server
+docker run -d \
+  --name tencentdb-memory \
+  -p 8080:8080 \
+  -e OPENAI_API_KEY=your-api-key \
+  ghcr.io/tencentcloud/tdai-memory:latest
+```
+
+### 3. Connect via MCP
+After deployment, configure the MCP connection:
+
+**Server URL**: `${1:-https://your-vps-ip:8080}`
+
+**Required Headers**:
+```
+x-tdai-service-id: default
+x-tdai-user-key: YOUR_USER_KEY
+```
+
+**Available Endpoints**:
+- `POST /api/v1/memory/search` - Search knowledge base
+- `POST /api/v1/memory/conversation/search` - Search conversations
+- `GET /api/v1/health` - Health check
+
+## Configuration
+
+### Quick Setup
+
+To connect to a TencentDB-Agent-Memory server, provide:
+
+1. **Server URL** (e.g., `https://memory.example.com`)
+2. **Service ID** (usually `default`)
+3. **User Key** (from your server admin)
+
+### Environment Variables
+
+Add to your `.env` or shell profile:
+
+```bash
+# TencentDB-Agent-Memory Configuration
+TENANTDB_URL=https://your-server.com
+TENANTDB_SERVICE_ID=default
+TENANTDB_USER_KEY=your-user-key
+```
+
+## Next Steps
+
+After configuration, you can:
+
+1. **Search Knowledge**: Use `/search <query>` to find skills and documentation
+2. **Sync Skills**: Upload your local skills to the centralized server
+3. **Query Code**: Search across all indexed codebases
+
+## Need Help?
+
+- **Documentation**: https://github.com/TencentCloud/TencentDB-Agent-Memory
+- **Issues**: Report bugs on the GitHub repository

package/prompts/write-review.md

@@ -0,0 +1,50 @@
+---
+description: Activate write-review loop - writer implements, reviewer checks, loop until approved
+argument-hint: "<task description>"
+---
+# Write-Review Loop
+
+Use the subagent tool with chain parameter:
+
+```
+/wr <task>
+```
+
+## How It Works
+
+1. **Writer Agent** - Reads task, implements code, writes `## WRITER_DONE`
+2. **Reviewer Agent** - Reads blackboard, reviews code quality
+3. **Loop** - If changes requested, writer updates code
+4. **Done** - When approved, writer can build/commit
+
+## Status File
+
+`{project}/.write-review/status.json` shows current phase:
+
+- `idle` - No active review
+- `writing` - Writer is implementing
+- `reviewing` - Reviewer is evaluating
+- `approved` - Ready to build/commit
+- `changes_requested` - Writer needs to update
+
+## Verdict Types
+
+| Verdict | Meaning | Action |
+|---------|---------|--------|
+| APPROVED | Code is good | Build/commit |
+| CHANGES_REQUESTED | Issues found | Update code |
+| BLOCKED | Critical issues | Human help needed |
+
+## Examples
+
+```
+/wr Create a React Button component
+/wr Fix the login bug
+/wr Add unit tests for auth module
+```
+
+## Prerequisites
+
+- `.write-review/` directory in project
+- `write-review` package installed
+- Review agent configured in pi-harness-runtime

package/scripts/check-version-sync.ts

@@ -0,0 +1,80 @@
+#!/usr/bin/env bun
+/**
+ * Check that all version files match the latest git tag.
+ * Usage: bun scripts/check-version-sync.ts
+ *
+ * Exits 0 if all versions match, exits 1 if mismatch.
+ */
+
+import { execSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { resolve } from "path";
+
+const repoRoot = resolve(import.meta.dir, "..");
+
+function git(args: string[]): string {
+	try {
+		return execSync(`git ${args.join(" ")}`, {
+			cwd: repoRoot,
+			encoding: "utf-8",
+			stdio: ["pipe", "pipe", "pipe"],
+		}).trim();
+	} catch (e) {
+		const err = e as { status?: number };
+		if (err.status === 128) return ""; // no tags
+		throw e;
+	}
+}
+
+interface PackageJson {
+	version: string;
+	workspaces?: string[];
+}
+
+function readJson(path: string): PackageJson | null {
+	try {
+		return JSON.parse(readFileSync(resolve(repoRoot, path), "utf-8"));
+	} catch {
+		return null;
+	}
+}
+
+// Get latest git tag
+const tags = git(["tag", "--sort=-v:refname"]);
+const latestTag = tags.split("\n")[0] || "";
+const latestVersion = latestTag.startsWith("v")
+	? latestTag.slice(1)
+	: latestTag;
+
+console.log(`Git tag (latest): ${latestVersion}`);
+
+// Check root package.json
+const rootPkg = readJson("package.json");
+if (!rootPkg) {
+	console.error("Cannot read package.json");
+	process.exit(1);
+}
+console.log(`package.json     : ${rootPkg.version}`);
+
+// Check all workspace packages
+let hasMismatch = rootPkg.version !== latestVersion;
+
+const workspaces = rootPkg.workspaces ?? [];
+for (const ws of workspaces) {
+	const pkgPath = ws.replace(/\/\*$/, "/package.json");
+	const pkg = readJson(pkgPath);
+	if (pkg && pkg.version !== latestVersion) {
+		console.log(`${pkgPath} : ${pkg.version} ❌`);
+		hasMismatch = true;
+	}
+}
+
+// Result
+if (hasMismatch) {
+	console.log("\n❌ Version files do not match latest git tag.");
+	console.log(`\nTo fix: bun run release:patch\n`);
+	process.exit(1);
+} else {
+	console.log("\n✅ All versions match git tag");
+	process.exit(0);
+}

package/scripts/convert-skills-to-okf.ts

@@ -0,0 +1,168 @@
+#!/usr/bin/env bun
+/**
+ * Skills to OKF Converter
+ *
+ * Converts frappe-bench skills to OKF format for pi-harness-runtime
+ * - Sanitizes sensitive info (IPs, URLs, API keys)
+ * - Converts to OKF markdown format
+ * - Preserves procedures and best practices
+ */
+
+import { readdir, readFile, writeFile, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+
+const SOURCE_DIR =
+	"/home/frappe/frappe-bench/.claude-plugins/moocoding-skills/skills";
+const OUTPUT_DIR = "./OKF/skills";
+
+// Sensitive patterns to sanitize
+const SANITIZE_PATTERNS: [RegExp, string][] = [
+	// IP addresses
+	[/(\b\d{1,3}\.){3}\d{1,3}\b/g, "{IP}"],
+	// Specific domains (high priority - before generic)
+	[/grist\.bunchee\.online/gi, "{GRIST_DOMAIN}"],
+	[
+		/(https?:\/\/)?[\w.-]+\.(bunchee\.online|hetzner\.com|digitalocean\.com)/gi,
+		"{DOMAIN}",
+	],
+	// API keys (generic pattern - 32+ chars)
+	[/(?<![a-zA-Z0-9])[a-zA-Z0-9]{32,}(?![a-zA-Z0-9])/g, "{API_KEY}"],
+	// Bearer tokens
+	[/Bearer [a-zA-Z0-9._-]+/g, "Bearer {TOKEN}"],
+	// NPM tokens
+	[/npm_[a-zA-Z0-9]{36}/gi, "npm_{TOKEN}"],
+	// Frappe sites
+	[/frappe-bench\/sites\/[\w.-]+/g, "frappe-bench/sites/{SITE}"],
+	// Server paths
+	[/\/home\/frappe\/[\w-]+/g, "/home/{USER}"],
+];
+
+interface SkillMetadata {
+	name: string;
+	description: string;
+	scope?: string;
+}
+
+function sanitize(text: string): string {
+	let result = text;
+	for (const [pattern, replacement] of SANITIZE_PATTERNS) {
+		result = result.replace(pattern, replacement);
+	}
+	return result;
+}
+
+function parseSkillMetadata(content: string): SkillMetadata | null {
+	const nameMatch = content.match(/^name:\s*(.+)$/m);
+	const descMatch = content.match(/^description:\s*(.+)$/m);
+	const scopeMatch = content.match(/^scope:\s*(.+)$/m);
+
+	if (!nameMatch || !descMatch) return null;
+
+	return {
+		name: sanitize(nameMatch[1].trim()),
+		description: sanitize(descMatch[1].trim()),
+		scope: scopeMatch?.[1]?.trim(),
+	};
+}
+
+function convertToOKF(skillPath: string, content: string): string {
+	const metadata = parseSkillMetadata(content);
+	if (!metadata) return "";
+
+	const sanitized = sanitize(content);
+
+	// Convert YAML frontmatter to OKF header
+	let okf = `# ${metadata.name}\n\n`;
+	okf += `## Overview\n\n`;
+	okf += `${metadata.description}\n\n`;
+
+	// Extract key sections
+	const sections = extractSections(sanitized);
+
+	for (const [title, body] of Object.entries(sections)) {
+		okf += `## ${title}\n\n`;
+		okf += body.trim() + "\n\n";
+	}
+
+	// Add provenance
+	okf += `---\n\n`;
+	okf += `**Source:** ${skillPath}\n`;
+	okf += `**Scope:** ${metadata.scope || "global"}\n`;
+	okf += `**Converted:** ${new Date().toISOString().split("T")[0]}\n`;
+
+	return okf;
+}
+
+function extractSections(content: string): Record<string, string> {
+	const sections: Record<string, string> = {};
+	const lines = content.split("\n");
+	let currentSection = "Details";
+	let currentBody: string[] = [];
+
+	for (const line of lines) {
+		const h2Match = line.match(/^## (.+)$/);
+		const h3Match = line.match(/^### (.+)$/);
+
+		if (h2Match) {
+			if (currentBody.length > 0) {
+				sections[currentSection] = currentBody.join("\n");
+			}
+			currentSection = h2Match[1];
+			currentBody = [];
+		} else if (h3Match) {
+			currentBody.push(`### ${h3Match[1]}`);
+		} else if (
+			!line.startsWith("---") &&
+			!line.match(/^name:|^description:|^scope:/)
+		) {
+			currentBody.push(line);
+		}
+	}
+
+	if (currentBody.length > 0) {
+		sections[currentSection] = currentBody.join("\n");
+	}
+
+	return sections;
+}
+
+async function convertSkills(): Promise<void> {
+	if (!existsSync(OUTPUT_DIR)) {
+		await mkdir(OUTPUT_DIR, { recursive: true });
+	}
+
+	const skillDirs = await readdir(SOURCE_DIR);
+	let converted = 0;
+	let skipped = 0;
+
+	for (const dir of skillDirs) {
+		const skillFile = `${SOURCE_DIR}/${dir}/SKILL.md`;
+
+		if (!existsSync(skillFile)) {
+			skipped++;
+			continue;
+		}
+
+		try {
+			const content = await readFile(skillFile, "utf-8");
+			const okfContent = convertToOKF(skillFile, content);
+
+			if (okfContent) {
+				const outputPath = `${OUTPUT_DIR}/${dir}.md`;
+				await writeFile(outputPath, okfContent);
+				console.log(`✅ Converted: ${dir}`);
+				converted++;
+			} else {
+				console.log(`⚠️ Skipped (no metadata): ${dir}`);
+				skipped++;
+			}
+		} catch (err) {
+			console.error(`❌ Error converting ${dir}:`, err);
+			skipped++;
+		}
+	}
+
+	console.log(`\n📊 Results: ${converted} converted, ${skipped} skipped`);
+}
+
+convertSkills();

package/scripts/copy-plugins.js

@@ -0,0 +1,56 @@
+/**
+ * Copy herdr plugins to runtime directory
+ * 
+ * Copies herdr plugins from .pi/plugins/ to ~/.config/herdr/plugins/
+ * The source .pi/plugins/ is gitignored but included in npm package via files array.
+ */
+
+import { copyFileSync, mkdirSync, existsSync, readdirSync, cpSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const SOURCE_PLUGINS_DIR = join(__dirname, "..", ".pi", "plugins");
+const HERDR_PLUGINS_DIR = join(process.env.HOME || "~", ".config", "herdr", "plugins");
+
+function ensureDir(dir) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+function copyPlugin(pluginName) {
+  const srcDir = join(SOURCE_PLUGINS_DIR, pluginName);
+  const destDir = join(HERDR_PLUGINS_DIR, pluginName);
+  
+  if (!existsSync(srcDir)) {
+    console.log(`[copy-plugins] No source plugin: ${pluginName}, skipping`);
+    return;
+  }
+  
+  ensureDir(destDir);
+  cpSync(srcDir, destDir, { recursive: true });
+  
+  console.log(`[copy-plugins] Copied ${pluginName} to ${destDir}`);
+}
+
+function main() {
+  if (!existsSync(SOURCE_PLUGINS_DIR)) {
+    console.log("[copy-plugins] No .pi/plugins/ directory found, skipping");
+    return;
+  }
+  
+  ensureDir(HERDR_PLUGINS_DIR);
+  console.log(`[copy-plugins] Herdr plugins dir: ${HERDR_PLUGINS_DIR}`);
+  
+  const plugins = readdirSync(SOURCE_PLUGINS_DIR);
+  for (const plugin of plugins) {
+    copyPlugin(plugin);
+  }
+  
+  console.log("[copy-plugins] Done!");
+}
+
+main();

package/scripts/gist-auth.ts

@@ -0,0 +1,64 @@
+/**
+ * Gist Auth Setup
+ *
+ * Usage:
+ *   bun run gist-auth
+ *
+ * Prompts for GitHub PAT and creates a secret Gist for clipboard sync.
+ */
+
+import { readline } from "bun";
+import {
+	createGist,
+	isConfigured,
+} from "../packages/clipboard/src/gist-relay.ts";
+
+async function main() {
+	console.log("\n=== pi-harness-runtime Gist Clipboard Sync Setup ===\n");
+
+	if (isConfigured()) {
+		console.log("Gist clipboard sync is already configured.");
+		console.log("Run with --reset to reconfigure.\n");
+		const rl = new readline.Interface({ input: stdin, output: stdout });
+		const answer = await rl.question("Reset configuration? (y/N): ");
+		rl.close();
+		if (answer.toLowerCase() !== "y") {
+			console.log("Aborted.\n");
+			return;
+		}
+	}
+
+	console.log("To enable clipboard sync to GitHub Gist:\n");
+	console.log("1. Go to https://github.com/settings/tokens");
+	console.log("2. Click 'Generate new token (classic)'");
+	console.log("3. Select scopes: 'gist' (read and write gists)");
+	console.log("4. Copy the token\n");
+
+	const rl = new readline.Interface({ input: stdin, output: stdout });
+	const token = await rl.question("GitHub Personal Access Token: ");
+	rl.close();
+
+	if (!token.trim()) {
+		console.log("No token provided. Aborted.\n");
+		return;
+	}
+
+	console.log("\nCreating secret Gist...\n");
+
+	const testContent = `pi-harness-runtime clipboard sync active
+Timestamp: ${new Date().toISOString()}
+`;
+
+	const result = await createGist(token.trim(), testContent);
+
+	if (result) {
+		console.log("✅ Gist clipboard sync configured!");
+		console.log(`   Gist URL: ${result.gistUrl}`);
+		console.log("\nClient devices can poll this Gist for clipboard content.");
+		console.log("See scripts/gist-poll.sh for client setup.\n");
+	} else {
+		console.log("❌ Failed to create Gist. Check your token and try again.\n");
+	}
+}
+
+main().catch(console.error);

package/scripts/gist-poll.sh

@@ -0,0 +1,127 @@
+#!/bin/bash
+# =============================================================================
+# gist-poll.sh — Client clipboard poller for pi-harness-runtime Gist sync
+# =============================================================================
+# Cross-platform clipboard sync via GitHub Gist.
+# Run this on Mac/iPad/Ubuntu to receive clipboard content from the server.
+#
+# Setup:
+#   1. Run /github-login on the server (pi session)
+#   2. Copy Gist ID from the confirmation message
+#   3. Export GITHUB_TOKEN and GIST_ID below, or pass as arguments
+#   4. Run this script: bash gist-poll.sh
+#
+# Usage:
+#   bash gist-poll.sh                    # Uses env vars or prompts
+#   bash gist-poll.sh <token> <gist-id> # Arguments
+#   GITHUB_TOKEN=xxx GIST_ID=xxx bash gist-poll.sh  # Env vars
+# =============================================================================
+
+set -euo pipefail
+
+# ── Config ────────────────────────────────────────────────────────────────────
+POLL_INTERVAL="${POLL_INTERVAL:-2}" # seconds between polls
+TIMEOUT_SEC=10                      # curl timeout
+
+# ── Colors ─────────────────────────────────────────────────────────────────────
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# ── Helpers ───────────────────────────────────────────────────────────────────
+log_info() { echo -e "${GREEN}[gist-poll]${NC} $*"; }
+log_warn() { echo -e "${YELLOW}[gist-poll]${NC} $*" >&2; }
+log_error() { echo -e "${RED}[gist-poll]${NC} $*" >&2; }
+
+# ── Argument parsing ───────────────────────────────────────────────────────────
+GITHUB_TOKEN="${1:-${GITHUB_TOKEN:-}}"
+GIST_ID="${2:-${GIST_ID:-}}"
+
+if [[ -z "$GITHUB_TOKEN" ]] || [[ -z "$GIST_ID" ]]; then
+	echo ""
+	echo "=== pi-harness-runtime Gist Clipboard Poller ==="
+	echo ""
+	echo "Configure one of:"
+	echo "  1. Export variables: export GITHUB_TOKEN=xxx GIST_ID=xxx"
+	echo "  2. Pass arguments:  bash gist-poll.sh <token> <gist-id>"
+	echo ""
+	echo "Get these from the /github-login confirmation message on the server."
+	echo ""
+	echo "The /github-login command shows the Gist URL like:"
+	echo "  https://gist.github.com/<username>/<GIST_ID>"
+	echo ""
+	echo "Example:"
+	echo "  bash gist-poll.sh ghp_xxxxx abc123def456"
+	echo ""
+	exit 1
+fi
+
+# ── Detect clipboard tool ───────────────────────────────────────────────────────
+detect_clipboard_tool() {
+	if command -v pbcopy >/dev/null 2>&1; then
+		echo "pbcopy"
+	elif command -v xclip >/dev/null 2>&1; then
+		echo "xclip"
+	elif command -v xsel >/dev/null 2>&1; then
+		echo "xsel"
+	else
+		log_error "No clipboard tool found (pbcopy, xclip, xsel)"
+		log_error "Install one of: pbcopy (macOS), xclip (Linux), xsel (Linux)"
+		exit 1
+	fi
+}
+
+write_clipboard() {
+	local content="$1"
+	local tool
+	tool=$(detect_clipboard_tool)
+
+	case "$tool" in
+	pbcopy)
+		echo "$content" | pbcopy
+		;;
+	xclip)
+		echo "$content" | xclip -selection clipboard -in
+		;;
+	xsel)
+		echo "$content" | xsel --clipboard --input
+		;;
+	esac
+	log_info "Updated clipboard (${tool}): ${#content} chars"
+}
+
+# ── Fetch from Gist ───────────────────────────────────────────────────────────
+fetch_gist_content() {
+	curl -s \
+		--max-time "$TIMEOUT_SEC" \
+		-H "Authorization: Bearer $GITHUB_TOKEN" \
+		-H "Accept: application/vnd.github+json" \
+		-H "X-GitHub-Api-Version: 2022-11-28" \
+		"https://api.github.com/gists/$GIST_ID" |
+		grep -o '"content":"[^"]*"' |
+		sed 's/"content":"//;s/"$//' |
+		head -1
+}
+
+# ── Main loop ─────────────────────────────────────────────────────────────────
+log_info "Starting Gist clipboard poller..."
+log_info "Poll interval: ${POLL_INTERVAL}s"
+log_info "Gist: https://gist.github.com/${GIST_ID}"
+log_info "Clipboard tool: $(detect_clipboard_tool)"
+log_info ""
+log_info "Press Ctrl+C to stop."
+log_info "Any text copied on the server (Ctrl+Shift+C) will appear here."
+
+LAST_CONTENT=""
+
+while true; do
+	CURRENT_CONTENT=$(fetch_gist_content 2>/dev/null || echo "")
+
+	if [[ -n "$CURRENT_CONTENT" ]] && [[ "$CURRENT_CONTENT" != "$LAST_CONTENT" ]]; then
+		LAST_CONTENT="$CURRENT_CONTENT"
+		write_clipboard "$CURRENT_CONTENT"
+	fi
+
+	sleep "$POLL_INTERVAL"
+done