pi-harness-runtime 0.10.11 → 0.10.13

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/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