pi-harness-runtime 0.10.11 → 0.10.13

package/packages/checkpoint/src/types.ts

@@ -0,0 +1,348 @@
+/**
+ * Checkpoint Engine - Types
+ *
+ * Core types for the enhanced checkpoint system.
+ */
+
+// --- SDK Version ------------------------------------------------------------
+
+/**
+ * SDK version for compatibility checks
+ */
+export const SDK_VERSION = "1.0.0";
+
+// --- Task Types ---------------------------------------------------------
+
+/**
+ * Task status
+ */
+export type TaskStatus = "pending" | "running" | "done" | "failed" | "blocked";
+
+/**
+ * Runtime task
+ */
+export interface RuntimeTask {
+	id: string;
+	title: string;
+	description: string;
+	status: TaskStatus;
+	assignedProvider?: string;
+	worktreePath?: string;
+	acceptanceCriteria?: string[];
+}
+
+// --- Job Types ----------------------------------------------------------
+
+/**
+ * Job status
+ */
+export type JobStatus =
+	| "pending"
+	| "running"
+	| "blocked"
+	| "completed"
+	| "failed"
+	| "cancelled"
+	| "archived";
+
+// --- State Types ---------------------------------------------------------
+
+/**
+ * Runtime state to be checkpointed
+ */
+export interface RuntimeState {
+	version: number;
+	jobId: string;
+	status: JobStatus;
+	requirement: string;
+	currentTaskId?: string;
+	provider?: string;
+	resumeAt?: string;
+	lastError?: string;
+	tasks: RuntimeTask[];
+	createdAt: string;
+	updatedAt: string;
+	metadata?: Record<string, unknown>;
+}
+
+// --- Checkpoint Types ----------------------------------------------------
+
+/**
+ * Checkpoint type
+ */
+export type CheckpointType = "full" | "incremental";
+
+/**
+ * Checkpoint metadata
+ */
+export interface CheckpointMetadata {
+	jobId: string;
+	version: number;
+	type: CheckpointType;
+	sizeBytes: number;
+	compressed: boolean;
+	checksum: string;
+	taskProgress: {
+		total: number;
+		completed: number;
+		failed: number;
+		running: number;
+	};
+	createdAt: string;
+	expiresAt?: string;
+	baseVersion?: number; // For incremental checkpoints
+}
+
+/**
+ * Full checkpoint data
+ */
+export interface FullCheckpoint {
+	jobId: string;
+	version: number;
+	type: "full";
+	state: RuntimeState;
+	metadata: CheckpointMetadata;
+}
+
+/**
+ * State delta for incremental checkpoints
+ */
+export interface StateDelta {
+	jobId: string;
+	baseVersion: number;
+	targetVersion: number;
+	changes: {
+		status?: JobStatus;
+		tasks?: TaskDelta[];
+		context?: ContextDiff;
+		errors?: ErrorEntry[];
+		metadata?: Record<string, unknown>;
+	};
+	timestamp: string;
+	checksum: string;
+}
+
+/**
+ * Task delta
+ */
+export interface TaskDelta {
+	taskId: string;
+	action: "added" | "updated" | "removed";
+	before?: Partial<RuntimeTask>;
+	after?: Partial<RuntimeTask>;
+}
+
+/**
+ * Context diff
+ */
+export interface ContextDiff {
+	added?: Record<string, unknown>;
+	removed?: string[];
+	updated?: Record<string, { before: unknown; after: unknown }>;
+}
+
+/**
+ * Error entry
+ */
+export interface ErrorEntry {
+	taskId?: string;
+	error: string;
+	timestamp: string;
+	recoverable: boolean;
+}
+
+/**
+ * Incremental checkpoint data
+ */
+export interface IncrementalCheckpoint {
+	jobId: string;
+	version: number;
+	type: "incremental";
+	delta: StateDelta;
+	metadata: CheckpointMetadata;
+}
+
+// --- Recovery Types ------------------------------------------------------
+
+/**
+ * Recovery strategy
+ */
+export type RecoveryStrategy =
+	| "latest" // Use most recent checkpoint
+	| "fullest" // Use checkpoint with most completed tasks
+	| `specific:${number}` // Use specific version number
+	| `timestamp:${string}` // Use checkpoint closest to timestamp
+	| "interactive"; // User selects from list
+
+/**
+ * Recovery result
+ */
+export interface RecoveryResult {
+	success: boolean;
+	recoveredVersion: number;
+	recoveredState?: RuntimeState;
+	lostEvents: number;
+	recoveryTimeMs: number;
+	errors?: string[];
+	warnings?: string[];
+}
+
+/**
+ * Verification result
+ */
+export interface VerificationResult {
+	valid: boolean;
+	checksumMatch: boolean;
+	corruptionDetails?: string[];
+}
+
+/**
+ * Prune result
+ */
+export interface PruneResult {
+	deletedCount: number;
+	freedBytes: number;
+	remainingCount: number;
+	errors?: string[];
+}
+
+// --- Storage Types -------------------------------------------------------
+
+/**
+ * Checkpoint file stored on disk
+ */
+export interface CheckpointFile {
+	jobId: string;
+	version: number;
+	type: CheckpointType;
+	data: string;
+	metadata: CheckpointMetadata;
+}
+
+/**
+ * Index entry for a checkpoint
+ */
+export interface IndexEntry {
+	jobId: string;
+	version: number;
+	type: CheckpointType;
+	path: string;
+	compressed: boolean;
+	checksum: string;
+	size: number;
+	createdAt: string;
+	baseVersion?: number;
+}
+
+/**
+ * Checkpoint index for a job
+ */
+export interface CheckpointIndex {
+	jobId: string;
+	entries: IndexEntry[];
+	currentVersion: number;
+	lastUpdated: string;
+}
+
+// --- Configuration --------------------------------------------------------
+
+/**
+ * Checkpoint engine configuration
+ */
+export interface CheckpointEngineConfig {
+	/**
+	 * Root directory for checkpoint storage
+	 */
+	rootDir?: string;
+
+	/**
+	 * Enable compression for checkpoints
+	 */
+	compression?: boolean;
+
+	/**
+	 * Enable incremental checkpoints
+	 */
+	incremental?: boolean;
+
+	/**
+	 * Maximum number of checkpoints to keep
+	 */
+	maxCheckpoints?: number;
+
+	/**
+	 * Automatically prune old checkpoints on save
+	 */
+	autoPrune?: boolean;
+
+	/**
+	 * Checksum algorithm
+	 */
+	checksumAlgorithm?: "md5" | "sha256";
+
+	/**
+	 * Enable parallel file writes
+	 */
+	parallelWrites?: boolean;
+
+	/**
+	 * Build metadata index
+	 */
+	metadataIndex?: boolean;
+}
+
+// --- Event Types ---------------------------------------------------------
+
+/**
+ * Checkpoint event
+ */
+export interface CheckpointEvent {
+	type: "checkpoint" | "recovery" | "prune" | "verify";
+	jobId: string;
+	version?: number;
+	timestamp: string;
+	data?: Record<string, unknown>;
+}
+
+/**
+ * Event log entry
+ */
+export interface EventLogEntry {
+	id: string;
+	event: CheckpointEvent;
+	correlationId?: string;
+}
+
+// --- Legacy Types --------------------------------------------------------
+
+/**
+ * Legacy checkpoint format
+ */
+export interface LegacyCheckpoint {
+	version: number;
+	jobId: string;
+	status: string;
+	state: Record<string, unknown>;
+	timestamp: string;
+}
+
+/**
+ * Check if a checkpoint is in legacy format
+ */
+export function isLegacyCheckpoint(
+	checkpoint: unknown,
+): checkpoint is LegacyCheckpoint {
+	if (typeof checkpoint !== "object" || checkpoint === null) {
+		return false;
+	}
+
+	const cp = checkpoint as Record<string, unknown>;
+
+	return (
+		typeof cp.version === "number" &&
+		typeof cp.jobId === "string" &&
+		typeof cp.status === "string" &&
+		cp.state !== undefined &&
+		typeof cp.timestamp === "string"
+	);
+}

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

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