pi-harness-runtime 0.9.4 → 0.9.5

package/packages/cache-strategy/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pi/cache-strategy",
+  "version": "0.9.5",
+  "type": "module",
+  "description": "Smart caching with TTL and invalidation strategies (RFC-0022)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "bun-types": "^1.0.0"
+  }
+}

package/packages/cache-strategy/src/cache.ts

@@ -0,0 +1,213 @@
+/**
+ * Cache Strategy — Core (RFC-0022)
+ */
+
+import type {
+	CacheConfig,
+	CacheEntry,
+	CacheStats,
+	InvalidationResult,
+	InvalidationStrategy,
+	TagGroup,
+} from "./types.js";
+
+export class CacheStrategy<T = unknown> {
+	private entries = new Map<string, CacheEntry<T>>();
+	private config: Required<CacheConfig>;
+	private hitCount = 0;
+	private missCount = 0;
+	private evictCount = 0;
+	private tagIndex = new Map<string, Set<string>>();
+
+	constructor(config: CacheConfig) {
+		this.config = {
+			strategy: config.strategy ?? "lru",
+			defaultTtlMs: config.defaultTtlMs ?? 300_000,
+			maxSize: config.maxSize ?? 1000,
+			onEvict: config.onEvict ?? (() => {}),
+		};
+	}
+
+	set(key: string, value: T, ttlMs?: number, tags?: string[]): void {
+		const now = Date.now();
+		this.entries.set(key, {
+			key,
+			value,
+			createdAt: now,
+			accessedAt: now,
+			hits: 0,
+			ttl: ttlMs ?? this.config.defaultTtlMs,
+			tags,
+		});
+		if (tags) {
+			for (const tag of tags) {
+				if (!this.tagIndex.has(tag)) this.tagIndex.set(tag, new Set());
+				this.tagIndex.get(tag)!.add(key);
+			}
+		}
+		this.enforceMaxSize();
+	}
+
+	get(key: string): T | undefined {
+		const entry = this.entries.get(key);
+		if (!entry) {
+			this.missCount++;
+			return undefined;
+		}
+		if (this.isExpired(entry)) {
+			this.delete(key);
+			this.missCount++;
+			return undefined;
+		}
+		entry.accessedAt = Date.now();
+		entry.hits++;
+		this.hitCount++;
+		return entry.value;
+	}
+
+	has(key: string): boolean {
+		const entry = this.entries.get(key);
+		if (!entry) return false;
+		if (this.isExpired(entry)) {
+			this.delete(key);
+			return false;
+		}
+		return true;
+	}
+
+	delete(key: string): boolean {
+		const entry = this.entries.get(key);
+		if (!entry) return false;
+		if (entry.tags) {
+			for (const tag of entry.tags) {
+				this.tagIndex.get(tag)?.delete(key);
+			}
+		}
+		this.config.onEvict(key, entry);
+		this.evictCount++;
+		return this.entries.delete(key);
+	}
+
+	clear(): void {
+		this.entries.clear();
+		this.tagIndex.clear();
+	}
+
+	invalidateByTag(tag: string): InvalidationResult {
+		const keys = this.tagIndex.get(tag);
+		if (!keys) return { invalidated: 0, remaining: this.entries.size };
+		const count = keys.size;
+		for (const k of keys) {
+			this.delete(k);
+		}
+		this.tagIndex.delete(tag);
+		return { invalidated: count, remaining: this.entries.size };
+	}
+
+	invalidateByPattern(pattern: RegExp): InvalidationResult {
+		let count = 0;
+		for (const key of this.entries.keys()) {
+			if (pattern.test(key)) {
+				this.delete(key);
+				count++;
+			}
+		}
+		return { invalidated: count, remaining: this.entries.size };
+	}
+
+	stats(): CacheStats {
+		return {
+			hits: this.hitCount,
+			misses: this.missCount,
+			evictions: this.evictCount,
+			size: this.entries.size,
+			hitRate: this.hitCount + this.missCount > 0
+				? this.hitCount / (this.hitCount + this.missCount)
+				: 0,
+		};
+	}
+
+	resetStats(): void {
+		this.hitCount = 0;
+		this.missCount = 0;
+		this.evictCount = 0;
+	}
+
+	getTagGroups(): TagGroup[] {
+		const groups: TagGroup[] = [];
+		for (const [tag, keys] of this.tagIndex) {
+			groups.push({ tag, keys: [...keys] });
+		}
+		return groups;
+	}
+
+	size(): number {
+		return this.entries.size;
+	}
+
+	keys(): string[] {
+		return [...this.entries.keys()];
+	}
+
+	private isExpired(entry: CacheEntry<T>): boolean {
+		if (!entry.ttl) return false;
+		return Date.now() - entry.createdAt > entry.ttl;
+	}
+
+	private enforceMaxSize(): void {
+		if (this.entries.size <= (this.config.maxSize ?? Infinity)) return;
+
+		switch (this.config.strategy) {
+			case "lru":
+				this.evictLRU();
+				break;
+			case "lfu":
+				this.evictLFU();
+				break;
+			case "ttl":
+				this.evictTTL();
+				break;
+			default: {
+				const first = this.entries.keys().next().value;
+				if (first) this.delete(first);
+			}
+		}
+	}
+
+	private evictLRU(): void {
+		let oldest: string | undefined;
+		let oldestTime = Infinity;
+		for (const [key, entry] of this.entries) {
+			if (entry.accessedAt < oldestTime) {
+				oldestTime = entry.accessedAt;
+				oldest = key;
+			}
+		}
+		if (oldest) this.delete(oldest);
+	}
+
+	private evictLFU(): void {
+		let lowest: string | undefined;
+		let lowestHits = Infinity;
+		for (const [key, entry] of this.entries) {
+			if (entry.hits < lowestHits) {
+				lowestHits = entry.hits;
+				lowest = key;
+			}
+		}
+		if (lowest) this.delete(lowest);
+	}
+
+	private evictTTL(): void {
+		let oldest: string | undefined;
+		let oldestTime = Infinity;
+		for (const [key, entry] of this.entries) {
+			const age = Date.now() - entry.createdAt;
+			if (age > oldestTime) {
+				oldestTime = age;
+				oldest = key;
+			}
+		}
+		if (oldest) this.delete(oldest);
+	}
+}

package/packages/cache-strategy/src/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Cache Strategy — Main Entry (RFC-0022)
+ */
+
+export { CacheStrategy } from "./cache.js";
+export type * from "./types.js";

package/packages/cache-strategy/src/types.ts

@@ -0,0 +1,40 @@
+/**
+ * Cache Strategy — Types (RFC-0022)
+ */
+
+export type InvalidationStrategy = "ttl" | "lru" | "lfu" | "manual" | "tag-based";
+
+export interface CacheEntry<T = unknown> {
+	key: string;
+	value: T;
+	createdAt: number;
+	accessedAt: number;
+	hits: number;
+	ttl?: number;
+	tags?: string[];
+}
+
+export interface CacheConfig {
+	strategy: InvalidationStrategy;
+	defaultTtlMs?: number;
+	maxSize?: number;
+	onEvict?: (key: string, entry: CacheEntry) => void;
+}
+
+export interface CacheStats {
+	hits: number;
+	misses: number;
+	evictions: number;
+	size: number;
+	hitRate: number;
+}
+
+export interface InvalidationResult {
+	invalidated: number;
+	remaining: number;
+}
+
+export interface TagGroup {
+	tag: string;
+	keys: string[];
+}

package/packages/cache-strategy/test/cache.test.ts

@@ -0,0 +1,137 @@
+/**
+ * Cache Strategy Tests (RFC-0022)
+ */
+
+import { describe, it, expect, beforeEach } from "bun:test";
+import { CacheStrategy } from "../src/index.js";
+
+describe("CacheStrategy", () => {
+  it("set and get work", () => {
+    const cache = new CacheStrategy({ strategy: "lru", maxSize: 10 });
+    cache.set("k1", "value1");
+    expect(cache.get("k1")).toBe("value1");
+  });
+
+  it("get returns undefined for missing key", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    expect(cache.get("nonexistent")).toBeUndefined();
+  });
+
+  it("has returns true for existing key", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    cache.set("k1", "v1");
+    expect(cache.has("k1")).toBe(true);
+    expect(cache.has("nonexistent")).toBe(false);
+  });
+
+  it("delete removes entry", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    cache.set("k1", "v1");
+    expect(cache.delete("k1")).toBe(true);
+    expect(cache.get("k1")).toBeUndefined();
+  });
+
+  it("clear removes all entries", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    cache.set("k1", "v1");
+    cache.set("k2", "v2");
+    cache.clear();
+    expect(cache.size()).toBe(0);
+  });
+
+  it("enforces maxSize with LRU", () => {
+    const cache = new CacheStrategy({ strategy: "lru", maxSize: 3 });
+    cache.set("k1", 1);
+    cache.set("k2", 2);
+    cache.set("k3", 3);
+    cache.set("k4", 4); // evicts k1
+    expect(cache.has("k1")).toBe(false);
+    expect(cache.has("k4")).toBe(true);
+  });
+
+  it("enforces maxSize with LFU", () => {
+    const cache = new CacheStrategy({ strategy: "lfu", maxSize: 2 });
+    cache.set("k1", 1);
+    cache.set("k2", 2);
+    cache.get("k1"); // hit k1
+    cache.get("k1");
+    cache.set("k3", 3); // evicts k2 (least hits)
+    expect(cache.has("k1")).toBe(true);
+    expect(cache.has("k2")).toBe(false);
+  });
+
+  it("TTL expiration works", () => {
+    const cache = new CacheStrategy({ strategy: "ttl", defaultTtlMs: 10 });
+    cache.set("k1", "v1", 5); // 5ms TTL
+    expect(cache.get("k1")).toBe("v1");
+    // Note: entry expires immediately or after TTL — fast TTL
+    cache.set("k2", "v2", 1000); // 1s
+    expect(cache.get("k2")).toBe("v2");
+  });
+
+  it("tag-based invalidation", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    cache.set("user:1:profile", "data1", undefined, ["user", "profile"]);
+    cache.set("user:1:settings", "data2", undefined, ["user", "settings"]);
+    cache.set("post:1:title", "title1", undefined, ["post"]);
+    const result = cache.invalidateByTag("user");
+    expect(result.invalidated).toBe(2);
+    expect(cache.has("user:1:profile")).toBe(false);
+    expect(cache.has("post:1:title")).toBe(true);
+  });
+
+  it("pattern invalidation", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    cache.set("user:1", "u1");
+    cache.set("user:2", "u2");
+    cache.set("post:1", "p1");
+    const result = cache.invalidateByPattern(/^user:/);
+    expect(result.invalidated).toBe(2);
+    expect(cache.has("post:1")).toBe(true);
+  });
+
+  it("stats track hits and misses", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    cache.set("k1", "v1");
+    cache.get("k1");
+    cache.get("nonexistent");
+    const stats = cache.stats();
+    expect(stats.hits).toBe(1);
+    expect(stats.misses).toBe(1);
+    expect(stats.hitRate).toBeCloseTo(0.5, 1);
+  });
+
+  it("resetStats clears counters", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    cache.set("k1", "v1");
+    cache.get("k1");
+    cache.get("nonexistent");
+    cache.resetStats();
+    const stats = cache.stats();
+    expect(stats.hits).toBe(0);
+    expect(stats.misses).toBe(0);
+  });
+
+  it("getTagGroups returns all tag groups", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    cache.set("k1", "v1", undefined, ["auth", "session"]);
+    cache.set("k2", "v2", undefined, ["auth"]);
+    const groups = cache.getTagGroups();
+    expect(groups.find((g) => g.tag === "auth")?.keys).toHaveLength(2);
+  });
+
+  it("size returns entry count", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    cache.set("k1", "v1");
+    cache.set("k2", "v2");
+    expect(cache.size()).toBe(2);
+  });
+
+  it("keys returns all keys", () => {
+    const cache = new CacheStrategy({ strategy: "lru" });
+    cache.set("a", 1);
+    cache.set("b", 2);
+    expect(cache.keys()).toContain("a");
+    expect(cache.keys()).toContain("b");
+  });
+});

package/packages/cache-strategy/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": { "outDir": "dist", "rootDir": "src" },
+  "include": ["src/**/*"]
+}

package/packages/capability-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/capability-registry",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Capability Registry for pi-harness-runtime — tracks model capabilities and enables capability-based routing",
   "type": "module",
   "main": "./dist/index.js",

package/packages/checkpoint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/checkpoint",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Enhanced checkpoint system with incremental snapshots, diff-based storage, and recovery strategies",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cli-plugin-sdk/README.md

@@ -0,0 +1,48 @@
+# @pi/cli-plugin-sdk
+
+CLI Plugin SDK for pi-harness — install, list, remove, update, and invoke plugins.
+
+## Installation
+
+```bash
+npm install @pi/cli-plugin-sdk
+```
+
+## Usage
+
+```typescript
+import { PluginCLI } from "@pi/cli-plugin-sdk";
+
+const cli = new PluginCLI({ cwd: "./my-project" });
+
+// Install a plugin
+await cli.install("@pi/frappe-plugin");
+
+// List installed plugins
+const plugins = await cli.list();
+console.log(plugins);
+
+// Invoke a plugin command
+const result = await cli.invoke("my-plugin", "analyze", { path: "./src" });
+
+// Remove a plugin
+await cli.remove("my-plugin");
+
+// Update plugins
+await cli.update();
+await cli.update("my-plugin");
+
+// Search npm for plugins
+const results = await cli.search("frappe");
+```
+
+## CLI
+
+```bash
+npx pi-plugin install <name>
+npx pi-plugin list
+npx pi-plugin remove <name>
+npx pi-plugin update [name]
+npx pi-plugin invoke <name> <command> --args <json>
+npx pi-plugin search <query>
+```

package/packages/cli-plugin-sdk/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CLI Plugin SDK — Main Entry (RFC-0067)
+ */
+import type { PluginCLIConfig, InstalledPlugin, PluginSearchResult, InvokeResult } from "./types.js";
+export type { PluginCLIConfig, InstalledPlugin, PluginSearchResult, InvokeResult, };
+/**
+ * CLI SDK for managing pi-harness plugins
+ */
+export declare class PluginCLI {
+    private readonly config;
+    constructor(config?: PluginCLIConfig);
+    /** Install a plugin from npm */
+    install(name: string, options?: {
+        version?: string;
+        global?: boolean;
+    }): Promise<void>;
+    /** Remove an installed plugin */
+    remove(name: string): Promise<void>;
+    /** List all installed plugins */
+    list(): Promise<InstalledPlugin[]>;
+    /** Update plugin(s) */
+    update(name?: string): Promise<void>;
+    /** Search npm for plugins */
+    search(query: string): Promise<PluginSearchResult[]>;
+    /** Invoke a plugin exported function */
+    invoke(pluginName: string, command: string, args?: Record<string, unknown>): Promise<InvokeResult>;
+    /** Get path to an installed plugin */
+    getPluginPath(name: string): string | null;
+}
+//# sourceMappingURL=index.d.ts.map

package/packages/cli-plugin-sdk/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,KAAK,EACX,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACX,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,YAAY,GACZ,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD,YAAY,MAAM,GAAE,eAAoB,EAOvC;IAED,gCAAgC;IAC1B,OAAO,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAClD,OAAO,CAAC,IAAI,CAAC,CA0Bf;IAED,iCAAiC;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASxC;IAED,iCAAiC;IAC3B,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAEvC;IAED,uBAAuB;IACjB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUzC;IAED,6BAA6B;IACvB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAgBzD;IAED,wCAAwC;IAClC,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAChC,OAAO,CAAC,YAAY,CAAC,CAiCvB;IAED,sCAAsC;IACtC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzC;CACD"}

package/packages/cli-plugin-sdk/dist/index.js

@@ -0,0 +1,128 @@
+/**
+ * CLI Plugin SDK — Main Entry (RFC-0067)
+ */
+import { execa } from "execa";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { searchPlugins } from "./registry.js";
+import { isInstalled, getInstalledPlugin, listInstalledPlugins, } from "./plugin-fs.js";
+/**
+ * CLI SDK for managing pi-harness plugins
+ */
+export class PluginCLI {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            cwd: config.cwd ?? process.cwd(),
+            globalDir: config.globalDir ?? "",
+            registry: config.registry ?? "https://registry.npmjs.org",
+            npmBin: config.npmBin ?? "npm",
+        };
+    }
+    /** Install a plugin from npm */
+    async install(name, options = {}) {
+        const { version, global = false } = options;
+        let normalizedName = name;
+        if (!name.startsWith("@") && !name.startsWith("pi-")) {
+            normalizedName = name.startsWith("plugin-")
+                ? `@pi/${name}`
+                : `@pi/plugin-${name}`;
+            console.warn(`Normalizing "${name}" to "${normalizedName}"`);
+        }
+        const pkgSpec = version ? `${normalizedName}@${version}` : normalizedName;
+        const args = [
+            this.config.npmBin,
+            "install",
+            pkgSpec,
+            global ? "--global" : "--save",
+        ];
+        if (this.config.registry) {
+            args.push("--registry", this.config.registry);
+        }
+        await execa(args[0], args.slice(1), {
+            cwd: this.config.cwd,
+            stdio: "inherit",
+        });
+    }
+    /** Remove an installed plugin */
+    async remove(name) {
+        if (!isInstalled(name, this.config)) {
+            throw new Error(`Plugin "${name}" is not installed`);
+        }
+        await execa(this.config.npmBin, ["uninstall", name, "--save"], {
+            cwd: this.config.cwd,
+            stdio: "inherit",
+        });
+    }
+    /** List all installed plugins */
+    async list() {
+        return listInstalledPlugins(this.config);
+    }
+    /** Update plugin(s) */
+    async update(name) {
+        const args = [this.config.npmBin, "update"];
+        if (name)
+            args.push(name);
+        else
+            args.push("@pi/*");
+        if (this.config.registry)
+            args.push("--registry", this.config.registry);
+        await execa(args[0], args.slice(1), {
+            cwd: this.config.cwd,
+            stdio: "inherit",
+        });
+    }
+    /** Search npm for plugins */
+    async search(query) {
+        const results = await Promise.all([
+            searchPlugins(`@pi/plugin-${query}`, this.config.registry),
+            searchPlugins(`@pi/${query}-plugin`, this.config.registry),
+            searchPlugins(query, this.config.registry),
+        ]);
+        const seen = new Set();
+        const deduped = [];
+        for (const r of results.flat()) {
+            if (!seen.has(r.name)) {
+                seen.add(r.name);
+                deduped.push(r);
+            }
+        }
+        return deduped.slice(0, 20);
+    }
+    /** Invoke a plugin exported function */
+    async invoke(pluginName, command, args = {}) {
+        const plugin = getInstalledPlugin(pluginName, this.config);
+        if (!plugin) {
+            return { success: false, error: `Plugin "${pluginName}" not found` };
+        }
+        try {
+            const pluginPath = join(plugin.path, plugin.manifest?.entryPoint ?? "dist/index.js");
+            if (!existsSync(pluginPath)) {
+                return {
+                    success: false,
+                    error: `Plugin entry not found at ${pluginPath}`,
+                };
+            }
+            const mod = await import(pluginPath);
+            const fn = mod[command] ?? mod.default?.[command];
+            if (typeof fn !== "function") {
+                return {
+                    success: false,
+                    error: `Function "${command}" not found in plugin`,
+                };
+            }
+            const result = await fn(args);
+            return { success: true, result };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { success: false, error: message };
+        }
+    }
+    /** Get path to an installed plugin */
+    getPluginPath(name) {
+        const plugin = getInstalledPlugin(name, this.config);
+        return plugin?.path ?? null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/packages/cli-plugin-sdk/dist/index.js.map

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

package/packages/cli-plugin-sdk/dist/plugin-fs.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI Plugin SDK — Filesystem Operations (RFC-0067)
+ */
+import type { InstalledPlugin, PluginCLIConfig } from "./types.js";
+/**
+ * Resolve plugin directory from config
+ */
+export declare function resolvePluginDir(config: PluginCLIConfig): string;
+/**
+ * Check if a plugin is installed
+ */
+export declare function isInstalled(name: string, config: PluginCLIConfig): boolean;
+/**
+ * Get installed plugin info
+ */
+export declare function getInstalledPlugin(name: string, config: PluginCLIConfig): InstalledPlugin | null;
+/**
+ * List all installed pi-* plugins
+ */
+export declare function listInstalledPlugins(config: PluginCLIConfig): InstalledPlugin[];
+//# sourceMappingURL=plugin-fs.d.ts.map