@yuaone/core 0.9.7 → 0.9.9

package/dist/capability-self-model.js

@@ -0,0 +1,312 @@
+/**
+ * @module capability-self-model
+ * @description Capability-Aware Self Model — tracks tool availability, environment
+ * strengths/weaknesses, and generates self-assessments for planning.
+ *
+ * Reduces overconfidence and improves plan quality by surfacing:
+ * - Which tools are available and which require approval
+ * - Which environment+taskType combinations have low success rates
+ * - Human-readable planning constraints derived from recorded outcomes
+ *
+ * Storage: ~/.yuan/self-model/capability-state.json
+ *
+ * @example
+ * ```typescript
+ * const model = new CapabilitySelfModel();
+ *
+ * // Record outcomes over time
+ * model.recordOutcome("typescript", "bugfix", true);
+ * model.recordOutcome("python", "refactor", false);
+ *
+ * // Check tool availability before planning
+ * const check = model.canUse("shell_exec");
+ * // { allowed: true, requiresApproval: true }
+ *
+ * // Generate self-assessment at planning time
+ * const assessment = model.assess();
+ * // assessment.planningConstraints → ["Weak at Python refactor (40% success)", ...]
+ * // assessment.overallConfidence   → 0.67
+ * ```
+ */
+import { EventEmitter } from "node:events";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const DEFAULT_TOOLS = {
+    read_file: { requiresApproval: false, isReadOnly: true },
+    write_file: { requiresApproval: true, isReadOnly: false },
+    shell_exec: { requiresApproval: true, isReadOnly: false },
+    grep: { requiresApproval: false, isReadOnly: true },
+    glob: { requiresApproval: false, isReadOnly: true },
+    git_ops: { requiresApproval: true, isReadOnly: false },
+};
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/** Laplace-smoothed success rate: (successes + 1) / (total + 2) */
+function laplaceRate(successCount, totalCount) {
+    return (successCount + 1) / (totalCount + 2);
+}
+/** Derive a rating from a smoothed success rate and raw sample count. */
+function deriveRating(successRate, sampleCount) {
+    if (sampleCount < 3)
+        return "unknown";
+    if (successRate >= 0.75)
+        return "strong";
+    if (successRate >= 0.50)
+        return "adequate";
+    if (successRate >= 0.25)
+        return "weak";
+    return "weak";
+}
+/** Composite key for environment+taskType lookup. */
+function envKey(environment, taskType) {
+    return `${environment}::${taskType}`;
+}
+// ─── Class ───────────────────────────────────────────────────────────────────
+/**
+ * Capability-Aware Self Model.
+ *
+ * Maintains an in-memory + persisted record of:
+ * 1. Tool availability (registered via `registerTool`)
+ * 2. Environment+taskType success rates (updated via `recordOutcome`)
+ *
+ * Emits `agent:self_model_updated` whenever state changes.
+ */
+export class CapabilitySelfModel extends EventEmitter {
+    storageFile;
+    tools;
+    environments;
+    constructor(storageDir) {
+        super();
+        const dir = storageDir ?? join(homedir(), ".yuan", "self-model");
+        this.storageFile = join(dir, "capability-state.json");
+        const loaded = this._load(dir);
+        this.tools = loaded.tools;
+        this.environments = loaded.environments;
+        // Pre-register default tools only if they weren't already in persisted state.
+        for (const [name, opts] of Object.entries(DEFAULT_TOOLS)) {
+            if (!this.tools.has(name)) {
+                this._upsertTool(name, {
+                    requiresApproval: opts.requiresApproval,
+                    isReadOnly: opts.isReadOnly,
+                    isAvailable: true,
+                });
+            }
+        }
+    }
+    // ─── Public API ────────────────────────────────────────────────────────────
+    /**
+     * Register (or update) a tool's availability metadata.
+     *
+     * @param toolName - Unique tool identifier.
+     * @param opts - Approval/read-only/availability flags.
+     */
+    registerTool(toolName, opts) {
+        this._upsertTool(toolName, opts);
+        this._save();
+        this.emit("agent:self_model_updated", {
+            kind: "agent:self_model_updated",
+            action: "tool_registered",
+            toolName,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Record a success or failure for a specific environment+taskType combination.
+     * Updates the Laplace-smoothed success rate and re-derives the rating.
+     *
+     * @param environment - e.g. "typescript", "python"
+     * @param taskType    - e.g. "bugfix", "refactor"
+     * @param success     - Whether the task succeeded.
+     */
+    recordOutcome(environment, taskType, success) {
+        const key = envKey(environment, taskType);
+        const existing = this.environments.get(key) ?? {
+            environment,
+            taskType,
+            successRate: 0.5,
+            sampleCount: 0,
+            rating: "unknown",
+        };
+        // Track raw counts (store them as hidden fields via type cast).
+        const raw = existing;
+        const successCount = (raw._successCount ?? 0) + (success ? 1 : 0);
+        const totalCount = (raw._totalCount ?? 0) + 1;
+        const smoothed = laplaceRate(successCount, totalCount);
+        const rating = deriveRating(smoothed, totalCount);
+        const updated = {
+            environment,
+            taskType,
+            successRate: smoothed,
+            sampleCount: totalCount,
+            rating,
+            _successCount: successCount,
+            _totalCount: totalCount,
+        };
+        this.environments.set(key, updated);
+        this._save();
+        this.emit("agent:self_model_updated", {
+            kind: "agent:self_model_updated",
+            action: "outcome_recorded",
+            environment,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Generate a self-assessment snapshot.
+     * Intended to be called at planning time to inform plan quality.
+     */
+    assess() {
+        const now = new Date().toISOString();
+        const availableTools = Array.from(this.tools.values());
+        const allEnvs = Array.from(this.environments.values());
+        const strengths = allEnvs.filter((e) => e.rating === "strong" || e.rating === "adequate");
+        const weaknesses = allEnvs.filter((e) => e.rating === "weak" || (e.rating === "unknown" && e.sampleCount >= 3));
+        const planningConstraints = this._buildConstraints(availableTools, allEnvs);
+        const overallConfidence = this._computeConfidence(allEnvs);
+        return {
+            availableTools,
+            strengths,
+            weaknesses,
+            planningConstraints,
+            overallConfidence,
+            generatedAt: now,
+        };
+    }
+    /**
+     * Check whether a specific tool can be used.
+     *
+     * @param toolName - Tool to check.
+     * @returns `{ allowed, requiresApproval, reason? }`
+     */
+    canUse(toolName) {
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            return {
+                allowed: false,
+                requiresApproval: false,
+                reason: `Tool "${toolName}" is not registered.`,
+            };
+        }
+        if (!tool.isAvailable) {
+            return {
+                allowed: false,
+                requiresApproval: tool.requiresApproval,
+                reason: `Tool "${toolName}" is currently unavailable.`,
+            };
+        }
+        return {
+            allowed: true,
+            requiresApproval: tool.requiresApproval,
+        };
+    }
+    /**
+     * Return weak and unknown (with sufficient samples) environment+taskType areas.
+     * Use this to add caution to planning prompts.
+     */
+    getWeakAreas() {
+        return Array.from(this.environments.values()).filter((e) => e.rating === "weak" ||
+            (e.rating === "unknown" && e.sampleCount >= 3));
+    }
+    // ─── Internal ──────────────────────────────────────────────────────────────
+    /** Upsert a tool into the in-memory map (does NOT save or emit). */
+    _upsertTool(toolName, opts) {
+        const now = new Date().toISOString();
+        const existing = this.tools.get(toolName);
+        this.tools.set(toolName, {
+            toolName,
+            isAvailable: opts.isAvailable ?? existing?.isAvailable ?? true,
+            requiresApproval: opts.requiresApproval,
+            isReadOnly: opts.isReadOnly,
+            lastChecked: now,
+        });
+    }
+    /**
+     * Build human-readable planning constraints from tool and environment state.
+     */
+    _buildConstraints(tools, envs) {
+        const constraints = [];
+        // Tool constraints
+        for (const tool of tools) {
+            if (!tool.isAvailable) {
+                constraints.push(`Tool "${tool.toolName}" is currently unavailable.`);
+            }
+            else if (tool.requiresApproval) {
+                constraints.push(`"${tool.toolName}" requires approval before use.`);
+            }
+        }
+        // Environment weakness constraints
+        for (const env of envs) {
+            if (env.rating === "weak") {
+                const pct = Math.round(env.successRate * 100);
+                constraints.push(`Weak at ${env.environment} ${env.taskType} (${pct}% success, n=${env.sampleCount}) — apply extra caution.`);
+            }
+            else if (env.rating === "unknown" && env.sampleCount >= 3) {
+                const pct = Math.round(env.successRate * 100);
+                constraints.push(`Uncertain performance in ${env.environment} ${env.taskType} (${pct}% success, n=${env.sampleCount}).`);
+            }
+        }
+        return constraints;
+    }
+    /**
+     * Compute overall confidence as a weighted average of environment success rates.
+     * Weights are proportional to sample counts.
+     * Returns 0.5 if no environment data is available.
+     */
+    _computeConfidence(envs) {
+        if (envs.length === 0)
+            return 0.5;
+        let weightedSum = 0;
+        let totalWeight = 0;
+        for (const env of envs) {
+            const w = Math.max(env.sampleCount, 1);
+            weightedSum += env.successRate * w;
+            totalWeight += w;
+        }
+        return totalWeight > 0 ? weightedSum / totalWeight : 0.5;
+    }
+    /** Load persisted state from disk. Non-fatal on any error. */
+    _load(storageDir) {
+        const empty = {
+            tools: new Map(),
+            environments: new Map(),
+        };
+        try {
+            if (!existsSync(storageDir)) {
+                mkdirSync(storageDir, { recursive: true });
+            }
+            if (!existsSync(this.storageFile))
+                return empty;
+            const raw = readFileSync(this.storageFile, "utf8");
+            const parsed = JSON.parse(raw);
+            const tools = new Map();
+            for (const t of parsed.tools ?? []) {
+                tools.set(t.toolName, t);
+            }
+            const environments = new Map();
+            for (const e of parsed.environments ?? []) {
+                environments.set(envKey(e.environment, e.taskType), e);
+            }
+            return { tools, environments };
+        }
+        catch {
+            // Non-fatal: storage failures should not crash the agent loop
+            return empty;
+        }
+    }
+    /** Atomically persist current state to disk. Non-fatal on any error. */
+    _save() {
+        const tmpFile = `${this.storageFile}.tmp`;
+        try {
+            const state = {
+                tools: Array.from(this.tools.values()),
+                environments: Array.from(this.environments.values()),
+            };
+            writeFileSync(tmpFile, JSON.stringify(state, null, 2), "utf8");
+            renameSync(tmpFile, this.storageFile);
+        }
+        catch {
+            // Non-fatal: storage failures should not crash the agent loop
+        }
+    }
+}
+//# sourceMappingURL=capability-self-model.js.map

package/dist/capability-self-model.js.map

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

package/dist/checkpoint-manager.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @module checkpoint-manager
+ * @description Task-level Checkpoint / Rollback / Resume Manager (Phase 6).
+ *
+ * Saves git-backed snapshots at key task milestones so that interrupted tasks
+ * can be resumed or rolled back mid-execution.  Complements session-persistence
+ * (which handles session-level replay) — this module focuses on intra-task
+ * rollback using git stash as a workspace snapshot mechanism.
+ *
+ * Storage: ~/.yuan/checkpoints/{taskId}.json  (array of TaskCheckpoint)
+ * All writes are atomic (write to .tmp then renameSync).
+ * All git operations are wrapped in try/catch — git failures are non-fatal.
+ */
+import { EventEmitter } from "node:events";
+export interface TaskCheckpoint {
+    /** UUID */
+    id: string;
+    taskId: string;
+    sessionId: string;
+    /** Human-readable label, e.g. "after_plan", "pre_verification" */
+    label: string;
+    iteration: number;
+    completedSteps: string[];
+    pendingSteps: string[];
+    /** git stash hash or tag captured at save time, if git is available */
+    gitRef?: string;
+    /** Serializable agent state snapshot */
+    agentState: Record<string, unknown>;
+    tokenUsed: number;
+    createdAt: string;
+}
+export interface RollbackResult {
+    success: boolean;
+    restoredTo: string;
+    gitRestored: boolean;
+    error?: string;
+}
+export interface CheckpointManagerConfig {
+    /** Directory where checkpoint files are stored. Default: ~/.yuan/checkpoints */
+    storageDir?: string;
+    /** Project root used for git operations. Default: process.cwd() */
+    projectPath?: string;
+    /** Max checkpoints kept per task (oldest removed first). Default: 5 */
+    maxCheckpoints?: number;
+}
+export declare class CheckpointManager extends EventEmitter {
+    private readonly storageDir;
+    private readonly projectPath;
+    private readonly maxCheckpoints;
+    constructor(config?: CheckpointManagerConfig);
+    /**
+     * Save a checkpoint at current state.
+     * Attempts a git stash to capture workspace state; falls back gracefully if
+     * git is unavailable or the working tree is clean.
+     */
+    save(taskId: string, sessionId: string, label: string, state: {
+        iteration: number;
+        completedSteps: string[];
+        pendingSteps: string[];
+        agentState: Record<string, unknown>;
+        tokenUsed: number;
+    }): Promise<TaskCheckpoint>;
+    /**
+     * List all checkpoints for a task, oldest first.
+     */
+    list(taskId: string): TaskCheckpoint[];
+    /**
+     * Return the most recent checkpoint for a task, or null if none.
+     */
+    latest(taskId: string): TaskCheckpoint | null;
+    /**
+     * Roll back workspace to the state captured in a checkpoint.
+     * If `gitRef` is present, applies the stash via `git stash apply`.
+     */
+    rollback(checkpointId: string): Promise<RollbackResult>;
+    /**
+     * Delete all checkpoints for a task (call after successful completion).
+     */
+    clear(taskId: string): void;
+    /**
+     * Attempt `git stash` and return the stash ref (e.g. "stash@{0}").
+     * Returns undefined if git is unavailable, not a repo, or the tree is clean.
+     */
+    private tryGitStash;
+    private checkpointFilePath;
+    private loadFile;
+    private writeFile;
+    /**
+     * Scan all checkpoint files to find a checkpoint by its ID.
+     * Returns the checkpoint and its taskId, or undefined if not found.
+     */
+    private findCheckpoint;
+}
+//# sourceMappingURL=checkpoint-manager.d.ts.map

package/dist/checkpoint-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../src/checkpoint-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,uBAAuB;IACtC,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,GAAE,uBAA4B;IAWhD;;;;OAIG;IACG,IAAI,CACR,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,cAAc,CAAC;IAqC1B;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAItC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAM7C;;;OAGG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA6C7D;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa3B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,SAAS;IASjB;;;OAGG;IACH,OAAO,CAAC,cAAc;CA+BvB"}

package/dist/checkpoint-manager.js

@@ -0,0 +1,225 @@
+/**
+ * @module checkpoint-manager
+ * @description Task-level Checkpoint / Rollback / Resume Manager (Phase 6).
+ *
+ * Saves git-backed snapshots at key task milestones so that interrupted tasks
+ * can be resumed or rolled back mid-execution.  Complements session-persistence
+ * (which handles session-level replay) — this module focuses on intra-task
+ * rollback using git stash as a workspace snapshot mechanism.
+ *
+ * Storage: ~/.yuan/checkpoints/{taskId}.json  (array of TaskCheckpoint)
+ * All writes are atomic (write to .tmp then renameSync).
+ * All git operations are wrapped in try/catch — git failures are non-fatal.
+ */
+import { EventEmitter } from "node:events";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { execSync } from "node:child_process";
+import { randomUUID } from "node:crypto";
+export class CheckpointManager extends EventEmitter {
+    storageDir;
+    projectPath;
+    maxCheckpoints;
+    constructor(config = {}) {
+        super();
+        this.storageDir =
+            config.storageDir ?? path.join(os.homedir(), ".yuan", "checkpoints");
+        this.projectPath = config.projectPath ?? process.cwd();
+        this.maxCheckpoints = config.maxCheckpoints ?? 5;
+        fs.mkdirSync(this.storageDir, { recursive: true });
+    }
+    // ─── Public API ─────────────────────────────────────────────────────────────
+    /**
+     * Save a checkpoint at current state.
+     * Attempts a git stash to capture workspace state; falls back gracefully if
+     * git is unavailable or the working tree is clean.
+     */
+    async save(taskId, sessionId, label, state) {
+        const gitRef = this.tryGitStash();
+        const checkpoint = {
+            id: randomUUID(),
+            taskId,
+            sessionId,
+            label,
+            iteration: state.iteration,
+            completedSteps: [...state.completedSteps],
+            pendingSteps: [...state.pendingSteps],
+            agentState: { ...state.agentState },
+            tokenUsed: state.tokenUsed,
+            createdAt: new Date().toISOString(),
+            ...(gitRef !== undefined ? { gitRef } : {}),
+        };
+        // Load existing, append, cap, and write back atomically.
+        const existing = this.loadFile(taskId);
+        existing.push(checkpoint);
+        if (existing.length > this.maxCheckpoints) {
+            existing.splice(0, existing.length - this.maxCheckpoints);
+        }
+        this.writeFile(taskId, existing);
+        this.emit("event", {
+            kind: "agent:checkpoint_saved",
+            checkpointId: checkpoint.id,
+            taskId,
+            label,
+            iteration: state.iteration,
+            timestamp: Date.now(),
+        });
+        return checkpoint;
+    }
+    /**
+     * List all checkpoints for a task, oldest first.
+     */
+    list(taskId) {
+        return this.loadFile(taskId);
+    }
+    /**
+     * Return the most recent checkpoint for a task, or null if none.
+     */
+    latest(taskId) {
+        const checkpoints = this.loadFile(taskId);
+        if (checkpoints.length === 0)
+            return null;
+        return checkpoints[checkpoints.length - 1];
+    }
+    /**
+     * Roll back workspace to the state captured in a checkpoint.
+     * If `gitRef` is present, applies the stash via `git stash apply`.
+     */
+    async rollback(checkpointId) {
+        // Search all task files for the checkpoint.
+        const found = this.findCheckpoint(checkpointId);
+        if (!found) {
+            return {
+                success: false,
+                restoredTo: "",
+                gitRestored: false,
+                error: `Checkpoint ${checkpointId} not found`,
+            };
+        }
+        const { checkpoint } = found;
+        let gitRestored = false;
+        let error;
+        if (checkpoint.gitRef) {
+            try {
+                execSync(`git stash apply ${checkpoint.gitRef}`, {
+                    cwd: this.projectPath,
+                    stdio: "pipe",
+                });
+                gitRestored = true;
+            }
+            catch (err) {
+                error = err instanceof Error ? err.message : String(err);
+            }
+        }
+        this.emit("event", {
+            kind: "agent:checkpoint_restored",
+            checkpointId,
+            taskId: checkpoint.taskId,
+            label: checkpoint.label,
+            gitRestored,
+            timestamp: Date.now(),
+        });
+        return {
+            success: true,
+            restoredTo: checkpoint.label,
+            gitRestored,
+            ...(error !== undefined ? { error } : {}),
+        };
+    }
+    /**
+     * Delete all checkpoints for a task (call after successful completion).
+     */
+    clear(taskId) {
+        const filePath = this.checkpointFilePath(taskId);
+        try {
+            if (fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+            }
+        }
+        catch {
+            // Non-fatal: best-effort cleanup.
+        }
+    }
+    // ─── Private Helpers ────────────────────────────────────────────────────────
+    /**
+     * Attempt `git stash` and return the stash ref (e.g. "stash@{0}").
+     * Returns undefined if git is unavailable, not a repo, or the tree is clean.
+     */
+    tryGitStash() {
+        try {
+            const output = execSync("git stash", {
+                cwd: this.projectPath,
+                stdio: "pipe",
+                encoding: "utf-8",
+            });
+            // "No local changes to save" means nothing was stashed.
+            if (output.includes("No local changes to save"))
+                return undefined;
+            // git stash outputs "Saved working directory and index state ..."
+            // The most recent stash is always stash@{0}.
+            return "stash@{0}";
+        }
+        catch {
+            return undefined;
+        }
+    }
+    checkpointFilePath(taskId) {
+        // Sanitize taskId to prevent path traversal.
+        const safe = taskId.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 80);
+        return path.join(this.storageDir, `${safe}.json`);
+    }
+    loadFile(taskId) {
+        const filePath = this.checkpointFilePath(taskId);
+        try {
+            if (!fs.existsSync(filePath))
+                return [];
+            const raw = fs.readFileSync(filePath, "utf-8");
+            const parsed = JSON.parse(raw);
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    writeFile(taskId, checkpoints) {
+        const filePath = this.checkpointFilePath(taskId);
+        const tmpPath = `${filePath}.${Date.now()}-${Math.random()
+            .toString(36)
+            .slice(2, 8)}.tmp`;
+        fs.writeFileSync(tmpPath, JSON.stringify(checkpoints), "utf-8");
+        fs.renameSync(tmpPath, filePath);
+    }
+    /**
+     * Scan all checkpoint files to find a checkpoint by its ID.
+     * Returns the checkpoint and its taskId, or undefined if not found.
+     */
+    findCheckpoint(checkpointId) {
+        let files;
+        try {
+            files = fs
+                .readdirSync(this.storageDir)
+                .filter((f) => f.endsWith(".json"));
+        }
+        catch {
+            return undefined;
+        }
+        for (const file of files) {
+            try {
+                const raw = fs.readFileSync(path.join(this.storageDir, file), "utf-8");
+                const checkpoints = JSON.parse(raw);
+                if (!Array.isArray(checkpoints))
+                    continue;
+                const match = checkpoints.find((c) => c.id === checkpointId);
+                if (match) {
+                    return { checkpoint: match, taskId: match.taskId };
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=checkpoint-manager.js.map

package/dist/checkpoint-manager.js.map

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

package/dist/continuation-engine.js

@@ -116,7 +116,7 @@ export class ContinuationEngine {
                 ...safeCheckpoint,
                 createdAt: (safeCheckpoint.createdAt ?? new Date()).toISOString(),
             };
-            const json = JSON.stringify(serialized, null, 2);
+            const json = JSON.stringify(serialized);
             // Atomic write: tmp에 쓰고 rename
             await writeFile(tmpPath, json, "utf-8");
             await rename(tmpPath, filePath);