pi-harness-runtime 0.10.11 → 0.10.13

package/packages/checkpoint/dist/storage.js

@@ -0,0 +1,365 @@
+/**
+ * Checkpoint Engine - Storage
+ *
+ * File I/O with compression and checksum verification.
+ */
+import { createHash } from "node:crypto";
+import { readFile, writeFile, mkdir, rename, stat, unlink, readdir, } from "node:fs/promises";
+import { dirname, join } from "node:path";
+// --- Default Configuration -------------------------------------------------
+const DEFAULT_CONFIG = {
+    compression: true,
+    checksumAlgorithm: "sha256",
+};
+// --- Storage Manager ------------------------------------------------------
+export class StorageManager {
+    rootDir;
+    compression;
+    checksumAlgorithm;
+    indices = new Map();
+    constructor(rootDir, options = {}) {
+        this.rootDir = rootDir;
+        this.compression = options.compression ?? DEFAULT_CONFIG.compression;
+        this.checksumAlgorithm =
+            options.checksumAlgorithm ?? DEFAULT_CONFIG.checksumAlgorithm;
+    }
+    /**
+     * Ensure directory exists
+     */
+    async ensureDir(dir) {
+        await mkdir(dir, { recursive: true });
+    }
+    /**
+     * Get job directory path
+     */
+    jobDir(jobId) {
+        return join(this.rootDir, "jobs", jobId);
+    }
+    /**
+     * Get checkpoint file path
+     */
+    checkpointPath(jobId, version) {
+        return join(this.jobDir(jobId), `checkpoint-${version}.json`);
+    }
+    /**
+     * Get incremental checkpoint path
+     */
+    incrementalPath(jobId, version) {
+        return join(this.jobDir(jobId), `checkpoint-${version}.delta.json`);
+    }
+    /**
+     * Get index file path
+     */
+    indexPath(jobId) {
+        return join(this.jobDir(jobId), "index.json");
+    }
+    /**
+     * Generate checksum for data
+     */
+    async generateChecksum(data) {
+        return createHash(this.checksumAlgorithm).update(data).digest("hex");
+    }
+    /**
+     * Verify checksum
+     */
+    async verifyChecksum(data, expected) {
+        const actual = await this.generateChecksum(data);
+        return actual === expected;
+    }
+    /**
+     * Compress data using simple encoding (in production, use zlib)
+     */
+    async compress(data) {
+        // Simple Base64 encoding as placeholder
+        // In production, use: import { gzip, gunzip } from 'zlib' and convert to base64
+        return Buffer.from(data).toString("base64");
+    }
+    /**
+     * Decompress data
+     */
+    async decompress(data) {
+        // In production, use: import { gzip, gunzip } from 'zlib'
+        return Buffer.from(data, "base64").toString("utf-8");
+    }
+    /**
+     * Load index for a job
+     */
+    async loadIndex(jobId) {
+        const path = this.indexPath(jobId);
+        try {
+            const content = await readFile(path, "utf-8");
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Save index for a job
+     */
+    async saveIndex(jobId, index) {
+        const path = this.indexPath(jobId);
+        await this.ensureDir(dirname(path));
+        await writeFile(path, JSON.stringify(index, null, 2), "utf-8");
+        this.indices.set(jobId, index);
+    }
+    /**
+     * Get or create index for a job
+     */
+    async getOrCreateIndex(jobId) {
+        const cached = this.indices.get(jobId);
+        if (cached)
+            return cached;
+        const loaded = await this.loadIndex(jobId);
+        if (loaded) {
+            this.indices.set(jobId, loaded);
+            return loaded;
+        }
+        const newIndex = {
+            jobId,
+            entries: [],
+            currentVersion: 0,
+            lastUpdated: new Date().toISOString(),
+        };
+        await this.saveIndex(jobId, newIndex);
+        return newIndex;
+    }
+    /**
+     * Save a full checkpoint
+     */
+    async saveFullCheckpoint(checkpoint) {
+        const { jobId, version, state, metadata } = checkpoint;
+        const dir = this.jobDir(jobId);
+        await this.ensureDir(dir);
+        // Serialize state
+        const jsonData = JSON.stringify(state);
+        const checksum = await this.generateChecksum(jsonData);
+        // Compress if enabled
+        const data = this.compression ? await this.compress(jsonData) : jsonData;
+        // Create checkpoint file
+        const checkpointFile = {
+            jobId,
+            version,
+            type: "full",
+            data,
+            metadata: {
+                ...metadata,
+                checksum,
+                compressed: this.compression,
+                sizeBytes: Buffer.byteLength(data),
+            },
+        };
+        // Write with atomic rename
+        const path = this.checkpointPath(jobId, version);
+        const tmpPath = `${path}.tmp`;
+        await writeFile(tmpPath, JSON.stringify(checkpointFile, null, 2), "utf-8");
+        await rename(tmpPath, path);
+        // Update index
+        const index = await this.getOrCreateIndex(jobId);
+        index.entries.push({
+            jobId,
+            version,
+            type: "full",
+            path,
+            compressed: this.compression,
+            checksum,
+            size: Buffer.byteLength(data),
+            createdAt: metadata.createdAt,
+        });
+        index.currentVersion = version;
+        index.lastUpdated = new Date().toISOString();
+        await this.saveIndex(jobId, index);
+    }
+    /**
+     * Save an incremental checkpoint
+     */
+    async saveIncrementalCheckpoint(checkpoint) {
+        const { jobId, version, delta, metadata } = checkpoint;
+        const dir = this.jobDir(jobId);
+        await this.ensureDir(dir);
+        // Serialize delta
+        const jsonData = JSON.stringify(delta);
+        const checksum = await this.generateChecksum(jsonData);
+        // Compress if enabled
+        const data = this.compression ? await this.compress(jsonData) : jsonData;
+        // Create checkpoint file
+        const checkpointFile = {
+            jobId,
+            version,
+            type: "incremental",
+            data,
+            metadata: {
+                ...metadata,
+                checksum,
+                compressed: this.compression,
+                sizeBytes: Buffer.byteLength(data),
+                baseVersion: delta.baseVersion,
+            },
+        };
+        // Write with atomic rename
+        const path = this.incrementalPath(jobId, version);
+        const tmpPath = `${path}.tmp`;
+        await writeFile(tmpPath, JSON.stringify(checkpointFile, null, 2), "utf-8");
+        await rename(tmpPath, path);
+        // Update index
+        const index = await this.getOrCreateIndex(jobId);
+        index.entries.push({
+            jobId,
+            version,
+            type: "incremental",
+            path,
+            compressed: this.compression,
+            checksum,
+            size: Buffer.byteLength(data),
+            createdAt: metadata.createdAt,
+            baseVersion: delta.baseVersion,
+        });
+        index.currentVersion = version;
+        index.lastUpdated = new Date().toISOString();
+        await this.saveIndex(jobId, index);
+    }
+    /**
+     * Load a checkpoint by version
+     */
+    async loadCheckpoint(jobId, version) {
+        // Try full checkpoint first (only if it's actually a full checkpoint)
+        const fullPath = this.checkpointPath(jobId, version);
+        try {
+            const content = await readFile(fullPath, "utf-8");
+            const file = JSON.parse(content);
+            if (file.type !== "full") {
+                // Not a full checkpoint at this path — fall through to incremental
+                throw new Error("Not a full checkpoint");
+            }
+            let data = file.data;
+            if (file.metadata.compressed) {
+                data = await this.decompress(data);
+            }
+            // Verify checksum
+            const checksum = await this.generateChecksum(data);
+            if (checksum !== file.metadata.checksum) {
+                throw new Error(`Checksum mismatch for checkpoint ${version}`);
+            }
+            const state = JSON.parse(data);
+            return {
+                jobId,
+                version,
+                type: "full",
+                state,
+                metadata: file.metadata,
+            };
+        }
+        catch (fullError) {
+            // Try incremental checkpoint
+            const incPath = this.incrementalPath(jobId, version);
+            try {
+                const content = await readFile(incPath, "utf-8");
+                const file = JSON.parse(content);
+                let data = file.data;
+                if (file.metadata.compressed) {
+                    data = await this.decompress(data);
+                }
+                const checksum = await this.generateChecksum(data);
+                if (checksum !== file.metadata.checksum) {
+                    throw new Error(`Checksum mismatch for incremental checkpoint ${version}`);
+                }
+                const delta = JSON.parse(data);
+                return {
+                    jobId,
+                    version,
+                    type: "incremental",
+                    delta,
+                    metadata: file.metadata,
+                };
+            }
+            catch {
+                // Neither found
+                return null;
+            }
+        }
+    }
+    /**
+     * List all checkpoints for a job
+     */
+    async listCheckpoints(jobId) {
+        const index = await this.loadIndex(jobId);
+        if (!index)
+            return [];
+        return index.entries
+            .map((entry) => ({
+            jobId: entry.jobId,
+            version: entry.version,
+            type: entry.type,
+            sizeBytes: entry.size,
+            compressed: entry.compressed,
+            checksum: entry.checksum,
+            taskProgress: { total: 0, completed: 0, failed: 0, running: 0 }, // Would need to load to get actual
+            createdAt: entry.createdAt,
+            baseVersion: entry.baseVersion,
+        }))
+            .sort((a, b) => a.version - b.version);
+    }
+    /**
+     * Delete a checkpoint
+     */
+    async deleteCheckpoint(jobId, version) {
+        // Try both paths
+        const paths = [
+            this.checkpointPath(jobId, version),
+            this.incrementalPath(jobId, version),
+        ];
+        for (const path of paths) {
+            try {
+                await unlink(path);
+            }
+            catch {
+                // Ignore if not found
+            }
+        }
+        // Update index
+        const index = await this.getOrCreateIndex(jobId);
+        index.entries = index.entries.filter((e) => e.version !== version);
+        if (index.entries.length > 0) {
+            index.currentVersion = Math.max(...index.entries.map((e) => e.version));
+        }
+        else {
+            index.currentVersion = 0;
+        }
+        index.lastUpdated = new Date().toISOString();
+        await this.saveIndex(jobId, index);
+    }
+    /**
+     * Delete all checkpoints for a job
+     */
+    async deleteAllCheckpoints(jobId) {
+        const dir = this.jobDir(jobId);
+        try {
+            const files = await readdir(dir);
+            await Promise.all(files.map((file) => unlink(join(dir, file))));
+        }
+        catch {
+            // Ignore if directory doesn't exist
+        }
+        this.indices.delete(jobId);
+    }
+    /**
+     * Get file size
+     */
+    async getFileSize(path) {
+        try {
+            const stats = await stat(path);
+            return stats.size;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+// --- Factory Function ----------------------------------------------------
+/**
+ * Create a storage manager
+ */
+export function createStorageManager(rootDir, options) {
+    return new StorageManager(rootDir, options);
+}
+//# sourceMappingURL=storage.js.map

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

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

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

@@ -0,0 +1,272 @@
+/**
+ * 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

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

package/packages/checkpoint/dist/types.js

@@ -0,0 +1,25 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}