pi-harness-runtime 0.9.4 → 0.9.6

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-fs.d.ts","sourceRoot":"","sources":["../src/plugin-fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAG1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,GACrB,eAAe,GAAG,IAAI,CAsBxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,eAAe,GACrB,eAAe,EAAE,CAgCnB"}

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

@@ -0,0 +1,80 @@
+/**
+ * CLI Plugin SDK — Filesystem Operations (RFC-0067)
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Resolve plugin directory from config
+ */
+export function resolvePluginDir(config) {
+    return config.globalDir ?? join(config.cwd ?? process.cwd(), "node_modules");
+}
+/**
+ * Check if a plugin is installed
+ */
+export function isInstalled(name, config) {
+    const dir = join(resolvePluginDir(config), name);
+    return existsSync(dir);
+}
+/**
+ * Get installed plugin info
+ */
+export function getInstalledPlugin(name, config) {
+    const dir = join(resolvePluginDir(config), name);
+    if (!existsSync(dir))
+        return null;
+    let manifest = null;
+    const pkgPath = join(dir, "package.json");
+    if (existsSync(pkgPath)) {
+        try {
+            manifest = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        }
+        catch {
+            // ignore parse errors
+        }
+    }
+    return {
+        name,
+        version: manifest?.version ?? "unknown",
+        path: dir,
+        manifest,
+    };
+}
+/**
+ * List all installed pi-* plugins
+ */
+export function listInstalledPlugins(config) {
+    const pluginDir = resolvePluginDir(config);
+    if (!existsSync(pluginDir))
+        return [];
+    const plugins = [];
+    try {
+        const entries = readdirSync(pluginDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const name = entry.name;
+            const fullPath = join(pluginDir, name);
+            try {
+                const pkgPath = join(fullPath, "package.json");
+                if (!existsSync(pkgPath))
+                    continue;
+                const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+                if (!pkg.pi && !pkg.name?.startsWith("@pi/"))
+                    continue;
+                plugins.push({
+                    name: pkg.name ?? name,
+                    version: pkg.version ?? "unknown",
+                    path: fullPath,
+                    manifest: pkg,
+                });
+            }
+            catch { }
+        }
+    }
+    catch {
+        // dir doesn't exist
+    }
+    return plugins;
+}
+//# sourceMappingURL=plugin-fs.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * CLI Plugin SDK — NPM Registry Client (RFC-0067)
+ */
+import type { PluginSearchResult } from "./types.js";
+/**
+ * Query npm registry for plugins matching query
+ */
+export declare function searchPlugins(query: string, registry?: string): Promise<PluginSearchResult[]>;
+/**
+ * Get package info from npm
+ */
+export declare function getPackageInfo(name: string, registry?: string): Promise<{
+    version: string;
+    description: string;
+} | null>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAoB/B;AAED;;GAEG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAa1D"}

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

@@ -0,0 +1,45 @@
+/**
+ * CLI Plugin SDK — NPM Registry Client (RFC-0067)
+ */
+import { execa } from "execa";
+/**
+ * Query npm registry for plugins matching query
+ */
+export async function searchPlugins(query, registry) {
+    try {
+        const args = ["search", query, "--json", "--prefer-online"];
+        if (registry)
+            args.push("--registry", registry);
+        const { stdout } = await execa("npm", args);
+        const results = JSON.parse(stdout);
+        return results.slice(0, 20).map((r) => ({
+            name: r.name,
+            version: r.version,
+            description: r.description || "",
+            downloads: r.downloads ?? 0,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get package info from npm
+ */
+export async function getPackageInfo(name, registry) {
+    try {
+        const args = ["view", name, "version", "description", "--json"];
+        if (registry)
+            args.push("--registry", registry);
+        const { stdout } = await execa("npm", args);
+        const info = JSON.parse(stdout);
+        return {
+            version: info.version ?? "0.0.0",
+            description: info.description ?? "",
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAG9B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,KAAa,EACb,QAAiB;IAEjB,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC5D,IAAI,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAK/B,CAAC;QACH,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;YAChC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC;SAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,IAAY,EACZ,QAAiB;IAEjB,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;QAChE,IAAI,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO;YACN,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO;YAChC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;SACnC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * CLI Plugin SDK — Types (RFC-0067)
+ */
+import type { PluginManifest } from "../../framework-plugin-sdk/src/types.js";
+export interface PluginCLIConfig {
+    cwd?: string;
+    globalDir?: string;
+    registry?: string;
+    npmBin?: string;
+}
+export interface InstalledPlugin {
+    name: string;
+    version: string;
+    path: string;
+    manifest: PluginManifest | null;
+}
+export interface PluginSearchResult {
+    name: string;
+    version: string;
+    description: string;
+    downloads: number;
+}
+export interface InvokeResult {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}

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

@@ -0,0 +1,5 @@
+/**
+ * CLI Plugin SDK — Types (RFC-0067)
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/packages/cli-plugin-sdk/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@pi/cli-plugin-sdk",
+  "version": "0.9.6",
+  "type": "module",
+  "description": "CLI Plugin SDK for pi-harness — install, list, remove, update, invoke plugins",
+  "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"
+  },
+  "dependencies": {
+    "execa": "^9.5.2"
+  },
+  "devDependencies": {
+    "bun-types": "^1.3.14"
+  }
+}

package/packages/cli-plugin-sdk/src/index.ts

@@ -0,0 +1,169 @@
+/**
+ * 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";
+import type {
+	PluginCLIConfig,
+	InstalledPlugin,
+	PluginSearchResult,
+	InvokeResult,
+} from "./types.js";
+
+export type {
+	PluginCLIConfig,
+	InstalledPlugin,
+	PluginSearchResult,
+	InvokeResult,
+};
+
+/**
+ * CLI SDK for managing pi-harness plugins
+ */
+export class PluginCLI {
+	private readonly config: Required<PluginCLIConfig>;
+
+	constructor(config: PluginCLIConfig = {}) {
+		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: string,
+		options: { version?: string; global?: boolean } = {},
+	): Promise<void> {
+		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: string): Promise<void> {
+		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(): Promise<InstalledPlugin[]> {
+		return listInstalledPlugins(this.config);
+	}
+
+	/** Update plugin(s) */
+	async update(name?: string): Promise<void> {
+		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: string): Promise<PluginSearchResult[]> {
+		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<string>();
+		const deduped: PluginSearchResult[] = [];
+		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: string,
+		command: string,
+		args: Record<string, unknown> = {},
+	): Promise<InvokeResult> {
+		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: string): string | null {
+		const plugin = getInstalledPlugin(name, this.config);
+		return plugin?.path ?? null;
+	}
+}

package/packages/cli-plugin-sdk/src/plugin-fs.ts

@@ -0,0 +1,91 @@
+/**
+ * CLI Plugin SDK — Filesystem Operations (RFC-0067)
+ */
+
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import type { InstalledPlugin, PluginCLIConfig } from "./types.js";
+
+/**
+ * Resolve plugin directory from config
+ */
+export function resolvePluginDir(config: PluginCLIConfig): string {
+	return config.globalDir ?? join(config.cwd ?? process.cwd(), "node_modules");
+}
+
+/**
+ * Check if a plugin is installed
+ */
+export function isInstalled(name: string, config: PluginCLIConfig): boolean {
+	const dir = join(resolvePluginDir(config), name);
+	return existsSync(dir);
+}
+
+/**
+ * Get installed plugin info
+ */
+export function getInstalledPlugin(
+	name: string,
+	config: PluginCLIConfig,
+): InstalledPlugin | null {
+	const dir = join(resolvePluginDir(config), name);
+	if (!existsSync(dir)) return null;
+
+	let manifest: InstalledPlugin["manifest"] = null;
+	const pkgPath = join(dir, "package.json");
+	if (existsSync(pkgPath)) {
+		try {
+			manifest = JSON.parse(
+				readFileSync(pkgPath, "utf-8"),
+			) as InstalledPlugin["manifest"];
+		} catch {
+			// ignore parse errors
+		}
+	}
+
+	return {
+		name,
+		version: manifest?.version ?? "unknown",
+		path: dir,
+		manifest,
+	};
+}
+
+/**
+ * List all installed pi-* plugins
+ */
+export function listInstalledPlugins(
+	config: PluginCLIConfig,
+): InstalledPlugin[] {
+	const pluginDir = resolvePluginDir(config);
+	if (!existsSync(pluginDir)) return [];
+
+	const plugins: InstalledPlugin[] = [];
+	try {
+		const entries = readdirSync(pluginDir, { withFileTypes: true });
+		for (const entry of entries) {
+			if (!entry.isDirectory()) continue;
+			const name = entry.name;
+			const fullPath = join(pluginDir, name);
+			try {
+				const pkgPath = join(fullPath, "package.json");
+				if (!existsSync(pkgPath)) continue;
+				const pkg = JSON.parse(readFileSync(pkgPath, "utf-8")) as {
+					version?: string;
+					pi?: { sdkVersion?: string };
+					name?: string;
+				};
+				if (!pkg.pi && !pkg.name?.startsWith("@pi/")) continue;
+				plugins.push({
+					name: pkg.name ?? name,
+					version: pkg.version ?? "unknown",
+					path: fullPath,
+					manifest: pkg as InstalledPlugin["manifest"],
+				});
+			} catch {}
+		}
+	} catch {
+		// dir doesn't exist
+	}
+	return plugins;
+}

package/packages/cli-plugin-sdk/src/registry.ts

@@ -0,0 +1,55 @@
+/**
+ * CLI Plugin SDK — NPM Registry Client (RFC-0067)
+ */
+
+import { execa } from "execa";
+import type { PluginSearchResult } from "./types.js";
+
+/**
+ * Query npm registry for plugins matching query
+ */
+export async function searchPlugins(
+	query: string,
+	registry?: string,
+): Promise<PluginSearchResult[]> {
+	try {
+		const args = ["search", query, "--json", "--prefer-online"];
+		if (registry) args.push("--registry", registry);
+		const { stdout } = await execa("npm", args);
+		const results = JSON.parse(stdout) as Array<{
+			name: string;
+			version: string;
+			description: string;
+			downloads?: number;
+		}>;
+		return results.slice(0, 20).map((r) => ({
+			name: r.name,
+			version: r.version,
+			description: r.description || "",
+			downloads: r.downloads ?? 0,
+		}));
+	} catch {
+		return [];
+	}
+}
+
+/**
+ * Get package info from npm
+ */
+export async function getPackageInfo(
+	name: string,
+	registry?: string,
+): Promise<{ version: string; description: string } | null> {
+	try {
+		const args = ["view", name, "version", "description", "--json"];
+		if (registry) args.push("--registry", registry);
+		const { stdout } = await execa("npm", args);
+		const info = JSON.parse(stdout);
+		return {
+			version: info.version ?? "0.0.0",
+			description: info.description ?? "",
+		};
+	} catch {
+		return null;
+	}
+}

package/packages/cli-plugin-sdk/src/types.ts

@@ -0,0 +1,32 @@
+/**
+ * CLI Plugin SDK — Types (RFC-0067)
+ */
+
+import type { PluginManifest } from "../../framework-plugin-sdk/src/types.js";
+
+export interface PluginCLIConfig {
+	cwd?: string;
+	globalDir?: string;
+	registry?: string;
+	npmBin?: string;
+}
+
+export interface InstalledPlugin {
+	name: string;
+	version: string;
+	path: string;
+	manifest: PluginManifest | null;
+}
+
+export interface PluginSearchResult {
+	name: string;
+	version: string;
+	description: string;
+	downloads: number;
+}
+
+export interface InvokeResult {
+	success: boolean;
+	result?: unknown;
+	error?: string;
+}

package/packages/cli-plugin-sdk/test/cli.test.ts

@@ -0,0 +1,45 @@
+/**
+ * CLI Plugin SDK Tests (RFC-0067)
+ */
+
+import { describe, it, expect } from "bun:test";
+import { PluginCLI } from "../src/index.js";
+
+describe("PluginCLI", () => {
+	const cli = new PluginCLI({ cwd: "/tmp/test-cli-plugins" });
+
+	it("creates instance with defaults", () => {
+		const c = new PluginCLI();
+		expect(c).toBeDefined();
+	});
+
+	it("creates instance with custom config", () => {
+		const c = new PluginCLI({
+			cwd: "/custom/path",
+			globalDir: "/custom/global",
+			registry: "https://custom.registry",
+		});
+		expect(c).toBeDefined();
+	});
+
+	it("getPluginPath returns null for non-existent plugin", () => {
+		const path = cli.getPluginPath("nonexistent-plugin");
+		expect(path).toBeNull();
+	});
+
+	it("list returns empty array for non-plugin dir", async () => {
+		const plugins = await cli.list();
+		expect(Array.isArray(plugins)).toBe(true);
+	});
+
+	it("search returns array", async () => {
+		const results = await cli.search("frappe");
+		expect(Array.isArray(results)).toBe(true);
+	});
+
+	it("invoke returns error for non-existent plugin", async () => {
+		const result = await cli.invoke("nonexistent-plugin", "analyze");
+		expect(result.success).toBe(false);
+		expect(result.error).toContain("not found");
+	});
+});

package/packages/cli-plugin-sdk/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "references": [
+    { "path": "../framework-plugin-sdk" }
+  ]
+}

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Code generation pipeline for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/code-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-review",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Automated code review engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/codex-adapter/dist/executor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Codex Adapter — Execution Sandbox (RFC-0070)
+ */
+import type { ExecutionResult, ExecutionConfig } from "./types.js";
+/**
+ * Execute code in a sandboxed environment
+ */
+export declare class ExecutionSandbox {
+    private config;
+    constructor(config?: ExecutionConfig);
+    execute(command: string): Promise<ExecutionResult>;
+    executeCode(code: string, language: "python" | "javascript" | "bash"): Promise<ExecutionResult>;
+}
+//# sourceMappingURL=executor.d.ts.map

package/packages/codex-adapter/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAInE;;GAEG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,MAAM,CAA4B;IAE1C,YAAY,MAAM,GAAE,eAAoB,EAOvC;IAEK,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA2CvD;IAEK,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,GACxC,OAAO,CAAC,eAAe,CAAC,CAS1B;CACD"}