pi-harness-runtime 0.10.7 → 0.10.11

package/packages/checkpoint/dist/types.d.ts

@@ -1,272 +0,0 @@
-/**
- * Checkpoint Engine - Types
- *
- * Core types for the enhanced checkpoint system.
- */
-/**
- * SDK version for compatibility checks
- */
-export declare const SDK_VERSION = "1.0.0";
-/**
- * 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 status
- */
-export type JobStatus = "pending" | "running" | "blocked" | "completed" | "failed" | "cancelled" | "archived";
-/**
- * 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 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;
-}
-/**
- * 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 strategy
- */
-export type RecoveryStrategy = "latest" | "fullest" | `specific:${number}` | `timestamp:${string}` | "interactive";
-/**
- * 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[];
-}
-/**
- * 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;
-}
-/**
- * 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;
-}
-/**
- * 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 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 declare function isLegacyCheckpoint(checkpoint: unknown): checkpoint is LegacyCheckpoint;
-//# sourceMappingURL=types.d.ts.map

package/packages/checkpoint/dist/types.d.ts.map

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

package/packages/checkpoint/dist/types.js

@@ -1,25 +0,0 @@
-/**
- * Checkpoint Engine - Types
- *
- * Core types for the enhanced checkpoint system.
- */
-// --- SDK Version ------------------------------------------------------------
-/**
- * SDK version for compatibility checks
- */
-export const SDK_VERSION = "1.0.0";
-/**
- * Check if a checkpoint is in legacy format
- */
-export function isLegacyCheckpoint(checkpoint) {
-    if (typeof checkpoint !== "object" || checkpoint === null) {
-        return false;
-    }
-    const cp = checkpoint;
-    return (typeof cp.version === "number" &&
-        typeof cp.jobId === "string" &&
-        typeof cp.status === "string" &&
-        cp.state !== undefined &&
-        typeof cp.timestamp === "string");
-}
-//# sourceMappingURL=types.js.map

package/packages/checkpoint/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AA6TnC;;GAEG;AACH,MAAM,UAAU,kBAAkB,CACjC,UAAmB;IAEnB,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,EAAE,GAAG,UAAqC,CAAC;IAEjD,OAAO,CACN,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ;QAC9B,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ;QAC5B,OAAO,EAAE,CAAC,MAAM,KAAK,QAAQ;QAC7B,EAAE,CAAC,KAAK,KAAK,SAAS;QACtB,OAAO,EAAE,CAAC,SAAS,KAAK,QAAQ,CAChC,CAAC;AACH,CAAC"}

package/packages/checkpoint/package.json

@@ -1,33 +0,0 @@
-{
-  "name": "@pi/checkpoint",
-  "version": "0.10.7",
-  "description": "Enhanced checkpoint system with incremental snapshots, diff-based storage, and recovery strategies",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "bun test",
-    "test:watch": "bun test --watch",
-    "lint": "eslint src --ext .ts",
-    "clean": "rm -rf dist"
-  },
-  "keywords": [
-    "checkpoint",
-    "snapshot",
-    "recovery",
-    "state"
-  ],
-  "author": "",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^20.11.0",
-    "typescript": "^7.0.2"
-  }
-}

package/packages/checkpoint/src/checkpoint-manager.ts

@@ -1,33 +0,0 @@
-/**
- * Legacy Checkpoint Manager
- *
- * @deprecated Use CheckpointEngine instead
- */
-export class JsonCheckpointManager {
-	constructor(private readonly rootDir: string) {}
-
-	/**
-	 * Get the root directory
-	 */
-	getRootDir(): string {
-		return this.rootDir;
-	}
-
-	/**
-	 * @deprecated Use CheckpointEngine.save() instead
-	 */
-	async save(_checkpoint: unknown): Promise<void> {
-		throw new Error(
-			"Legacy JsonCheckpointManager is deprecated. Use CheckpointEngine instead.",
-		);
-	}
-
-	/**
-	 * @deprecated Use CheckpointEngine.load() instead
-	 */
-	async load(_jobId: string): Promise<unknown | null> {
-		throw new Error(
-			"Legacy JsonCheckpointManager is deprecated. Use CheckpointEngine instead.",
-		);
-	}
-}

package/packages/checkpoint/src/differ.ts

@@ -1,281 +0,0 @@
-/**
- * Checkpoint Engine - Differ
- *
- * Calculate state diffs for incremental checkpoints.
- */
-
-import type {
-	RuntimeState,
-	StateDelta,
-	TaskDelta,
-	RuntimeTask,
-} from "./types.js";
-import { createHash } from "node:crypto";
-
-// --- Diff Calculator -----------------------------------------------------
-
-export class DiffCalculator {
-	/**
-	 * Calculate diff between two states
-	 */
-	calculateDiff(
-		jobId: string,
-		baseVersion: number,
-		targetVersion: number,
-		baseState: RuntimeState,
-		targetState: RuntimeState,
-	): StateDelta {
-		const changes: StateDelta["changes"] = {};
-
-		// Check status change
-		if (baseState.status !== targetState.status) {
-			changes.status = targetState.status;
-		}
-
-		// Calculate task changes
-		const taskDeltas = this.calculateTaskDeltas(
-			baseState.tasks,
-			targetState.tasks,
-		);
-		if (taskDeltas.length > 0) {
-			changes.tasks = taskDeltas;
-		}
-
-		// Check metadata changes
-		if (
-			JSON.stringify(baseState.metadata) !==
-			JSON.stringify(targetState.metadata)
-		) {
-			changes.metadata = targetState.metadata;
-		}
-
-		// Check for errors
-		if (baseState.lastError !== targetState.lastError) {
-			changes.errors = [
-				{
-					error: targetState.lastError ?? "",
-					timestamp: targetState.updatedAt,
-					recoverable: targetState.status === "blocked",
-				},
-			];
-		}
-
-		const timestamp = new Date().toISOString();
-		const checksum = this.calculateChecksum(
-			jobId,
-			baseVersion,
-			targetVersion,
-			changes,
-		);
-
-		return {
-			jobId,
-			baseVersion,
-			targetVersion,
-			changes,
-			timestamp,
-			checksum,
-		};
-	}
-
-	/**
-	 * Calculate task deltas
-	 */
-	private calculateTaskDeltas(
-		baseTasks: RuntimeTask[],
-		targetTasks: RuntimeTask[],
-	): TaskDelta[] {
-		const deltas: TaskDelta[] = [];
-		const baseMap = new Map(baseTasks.map((t) => [t.id, t]));
-		const targetMap = new Map(targetTasks.map((t) => [t.id, t]));
-
-		// Find added and updated tasks
-		for (const [taskId, targetTask] of targetMap) {
-			const baseTask = baseMap.get(taskId);
-
-			if (!baseTask) {
-				// Task was added
-				deltas.push({
-					taskId,
-					action: "added",
-					after: targetTask,
-				});
-			} else if (this.tasksAreDifferent(baseTask, targetTask)) {
-				// Task was updated
-				deltas.push({
-					taskId,
-					action: "updated",
-					before: baseTask,
-					after: targetTask,
-				});
-			}
-		}
-
-		// Find removed tasks
-		for (const [taskId, baseTask] of baseMap) {
-			if (!targetMap.has(taskId)) {
-				deltas.push({
-					taskId,
-					action: "removed",
-					before: baseTask,
-				});
-			}
-		}
-
-		return deltas;
-	}
-
-	/**
-	 * Check if two tasks are different
-	 */
-	private tasksAreDifferent(a: RuntimeTask, b: RuntimeTask): boolean {
-		return (
-			a.status !== b.status ||
-			a.title !== b.title ||
-			a.description !== b.description ||
-			a.assignedProvider !== b.assignedProvider ||
-			a.worktreePath !== b.worktreePath
-		);
-	}
-
-	/**
-	 * Calculate checksum for delta
-	 */
-	private calculateChecksum(
-		jobId: string,
-		baseVersion: number,
-		targetVersion: number,
-		changes: StateDelta["changes"],
-	): string {
-		const data = JSON.stringify({
-			jobId,
-			baseVersion,
-			targetVersion,
-			changes,
-			timestamp: new Date().toISOString(),
-		});
-		return createHash("sha256").update(data).digest("hex");
-	}
-
-	/**
-	 * Apply delta to base state
-	 */
-	applyDelta(baseState: RuntimeState, delta: StateDelta): RuntimeState {
-		const result: RuntimeState = { ...baseState };
-
-		// Apply status change
-		if (delta.changes.status !== undefined) {
-			result.status = delta.changes.status;
-		}
-
-		// Apply task changes
-		if (delta.changes.tasks) {
-			result.tasks = this.applyTaskDeltas(baseState.tasks, delta.changes.tasks);
-		}
-
-		// Apply metadata changes
-		if (delta.changes.metadata !== undefined) {
-			result.metadata = delta.changes.metadata;
-		}
-
-		// Apply error changes
-		if (delta.changes.errors && delta.changes.errors.length > 0) {
-			const lastError = delta.changes.errors[delta.changes.errors.length - 1];
-			result.lastError = lastError.error;
-		}
-
-		// Update version and timestamp
-		result.version = delta.targetVersion;
-		result.updatedAt = new Date().toISOString();
-
-		return result;
-	}
-
-	/**
-	 * Apply task deltas to task list
-	 */
-	private applyTaskDeltas(
-		tasks: RuntimeTask[],
-		taskDeltas: TaskDelta[],
-	): RuntimeTask[] {
-		const taskMap = new Map(tasks.map((t) => [t.id, { ...t }]));
-
-		for (const delta of taskDeltas) {
-			switch (delta.action) {
-				case "added":
-					if (delta.after) {
-						taskMap.set(delta.taskId, delta.after as RuntimeTask);
-					}
-					break;
-
-				case "updated":
-					if (delta.after) {
-						taskMap.set(delta.taskId, delta.after as RuntimeTask);
-					}
-					break;
-
-				case "removed":
-					taskMap.delete(delta.taskId);
-					break;
-			}
-		}
-
-		return Array.from(taskMap.values());
-	}
-
-	/**
-	 * Reconstruct state from incremental checkpoints
-	 */
-	async reconstructState(
-		fullCheckpoint: RuntimeState,
-		deltas: StateDelta[],
-	): Promise<RuntimeState> {
-		// Sort deltas by version
-		const sortedDeltas = [...deltas].sort(
-			(a, b) => a.targetVersion - b.targetVersion,
-		);
-
-		// Apply each delta in order
-		let state = fullCheckpoint;
-		for (const delta of sortedDeltas) {
-			state = this.applyDelta(state, delta);
-		}
-
-		return state;
-	}
-
-	/**
-	 * Estimate size of delta vs full checkpoint
-	 */
-	estimateDeltaSavings(
-		fullSize: number,
-		baseState: RuntimeState,
-		targetState: RuntimeState,
-	): { deltaSize: number; savingsPercent: number } {
-		const delta = this.calculateDiff(
-			targetState.jobId,
-			baseState.version,
-			targetState.version,
-			baseState,
-			targetState,
-		);
-
-		const deltaJson = JSON.stringify(delta);
-		const deltaSize = Buffer.byteLength(deltaJson);
-		const savingsPercent = ((fullSize - deltaSize) / fullSize) * 100;
-
-		return {
-			deltaSize,
-			savingsPercent: Math.max(0, savingsPercent),
-		};
-	}
-}
-
-// --- Factory Function ----------------------------------------------------
-
-/**
- * Create a diff calculator
- */
-export function createDiffCalculator(): DiffCalculator {
-	return new DiffCalculator();
-}