@hasna/snapshots 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env bun
+import { captureSnapshot, getSnapshotEnvelope, listPolicies, listResources, listSnapshots, planSnapshotRestore, upsertPolicy } from "../runtime.js";
+import { normalizePolicyMode } from "../policy.js";
+import { applyServicePlan, planService } from "../service.js";
+import { defaultDbPath } from "../util.js";
+export async function main(argv = process.argv.slice(2)) {
+    const parsed = parseArgs(argv);
+    const [command = "help", ...rest] = parsed.positional;
+    const dbPath = stringFlag(parsed, "db") ?? defaultDbPath();
+    try {
+        switch (command) {
+            case "capture": {
+                const include = stringFlag(parsed, "include")?.split(",").map((part) => part.trim()).filter(Boolean);
+                const result = await captureSnapshot({
+                    dbPath,
+                    name: stringFlag(parsed, "name"),
+                    include
+                });
+                print(result);
+                return;
+            }
+            case "list":
+            case "snapshots": {
+                print({ snapshots: listSnapshots({ dbPath, limit: numberFlag(parsed, "limit") ?? 50 }) });
+                return;
+            }
+            case "show": {
+                const id = required(rest[0], "snapshot id");
+                print(getSnapshotEnvelope({ dbPath, id }));
+                return;
+            }
+            case "resources": {
+                print(listResources({ dbPath, limit: numberFlag(parsed, "limit") ?? 200 }));
+                return;
+            }
+            case "plan": {
+                const id = required(rest[0], "snapshot id");
+                print(planSnapshotRestore({ dbPath, id }));
+                return;
+            }
+            case "restore": {
+                const id = required(rest[0], "snapshot id");
+                print(planSnapshotRestore({
+                    dbPath,
+                    id,
+                    apply: Boolean(parsed.flags.apply),
+                    yes: Boolean(parsed.flags.yes)
+                }));
+                return;
+            }
+            case "policy":
+            case "policies": {
+                const subcommand = rest[0] ?? "list";
+                if (subcommand === "list") {
+                    print({ policies: listPolicies({ dbPath }) });
+                    return;
+                }
+                if (subcommand === "set") {
+                    const selector = required(rest[1], "selector");
+                    const mode = normalizePolicyMode(required(rest[2], "mode"));
+                    print({ policy: upsertPolicy({ dbPath, selector, mode, reason: stringFlag(parsed, "reason") }) });
+                    return;
+                }
+                throw new Error(`Unknown policy command: ${subcommand}`);
+            }
+            case "daemon": {
+                const subcommand = rest[0] ?? "once";
+                if (subcommand === "once") {
+                    print(await captureSnapshot({ dbPath, name: stringFlag(parsed, "name") ?? "daemon-once" }));
+                    return;
+                }
+                if (subcommand === "run") {
+                    await runDaemon(dbPath, numberFlag(parsed, "interval") ?? 300, numberFlag(parsed, "max-runs"));
+                    return;
+                }
+                throw new Error(`Unknown daemon command: ${subcommand}`);
+            }
+            case "service": {
+                const subcommand = rest[0] ?? "plan";
+                const servicePlan = planService({
+                    command: stringFlag(parsed, "command"),
+                    intervalSeconds: numberFlag(parsed, "interval")
+                });
+                if (subcommand === "plan") {
+                    print({ service: servicePlan });
+                    return;
+                }
+                if (subcommand === "install") {
+                    print(applyServicePlan(servicePlan, Boolean(parsed.flags.apply) && Boolean(parsed.flags.yes)));
+                    return;
+                }
+                throw new Error(`Unknown service command: ${subcommand}`);
+            }
+            case "doctor": {
+                print({
+                    ok: true,
+                    db_path: dbPath,
+                    commands: ["capture", "list", "show", "resources", "plan", "restore", "policy", "daemon", "service"]
+                });
+                return;
+            }
+            case "help":
+            default:
+                printHelp(command === "help" ? undefined : command);
+                if (command !== "help")
+                    process.exitCode = 1;
+        }
+    }
+    catch (error) {
+        process.exitCode = 1;
+        print({
+            ok: false,
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+async function runDaemon(dbPath, intervalSeconds, maxRuns) {
+    let runs = 0;
+    while (!maxRuns || runs < maxRuns) {
+        const result = await captureSnapshot({ dbPath, name: `daemon-${new Date().toISOString()}` });
+        print({ event: "snapshot", ...result });
+        runs += 1;
+        if (maxRuns && runs >= maxRuns)
+            break;
+        await new Promise((resolve) => setTimeout(resolve, Math.max(1, intervalSeconds) * 1_000));
+    }
+}
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg.startsWith("--")) {
+            const [rawKey, inlineValue] = arg.slice(2).split("=", 2);
+            if (inlineValue !== undefined) {
+                flags[rawKey] = inlineValue;
+            }
+            else if (argv[index + 1] && !argv[index + 1].startsWith("-")) {
+                flags[rawKey] = argv[index + 1];
+                index += 1;
+            }
+            else {
+                flags[rawKey] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function stringFlag(parsed, name) {
+    const value = parsed.flags[name];
+    return typeof value === "string" ? value : undefined;
+}
+function numberFlag(parsed, name) {
+    const value = stringFlag(parsed, name);
+    if (!value)
+        return undefined;
+    const parsedValue = Number(value);
+    if (!Number.isFinite(parsedValue))
+        throw new Error(`Invalid number for --${name}: ${value}`);
+    return parsedValue;
+}
+function required(value, label) {
+    if (!value)
+        throw new Error(`Missing ${label}.`);
+    return value;
+}
+function print(value) {
+    console.log(JSON.stringify(value, null, 2));
+}
+function printHelp(unknown) {
+    print({
+        ok: !unknown,
+        error: unknown ? `Unknown command: ${unknown}` : undefined,
+        usage: [
+            "snapshots capture [--name name] [--include machine,tmux,projects,processes,sessions,browser,desktop]",
+            "snapshots list [--limit n]",
+            "snapshots show <snapshot-id>",
+            "snapshots resources [--limit n]",
+            "snapshots plan <snapshot-id>",
+            "snapshots restore <snapshot-id> [--apply --yes]",
+            "snapshots policy list",
+            "snapshots policy set <selector> <observe|restore|ignore> [--reason text]",
+            "snapshots daemon once|run [--interval seconds] [--max-runs n]",
+            "snapshots service plan|install [--apply --yes]",
+            "snapshots doctor"
+        ]
+    });
+}
+if (import.meta.main) {
+    await main();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./util.js";
+export * from "./storage.js";
+export * from "./policy.js";
+export * from "./restore.js";
+export * from "./capture/index.js";
+export * from "./service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./util.js";
+export * from "./storage.js";
+export * from "./policy.js";
+export * from "./restore.js";
+export * from "./capture/index.js";
+export * from "./service.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":""}

package/dist/mcp/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env bun
+import { captureSnapshot, getSnapshotEnvelope, listSnapshots, planSnapshotRestore } from "../runtime.js";
+const tools = [
+    {
+        name: "capture_snapshot",
+        description: "Capture a local runtime snapshot.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+                include: { type: "array", items: { type: "string" } },
+                dbPath: { type: "string" }
+            }
+        }
+    },
+    {
+        name: "list_snapshots",
+        description: "List stored snapshots.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: { type: "number" },
+                dbPath: { type: "string" }
+            }
+        }
+    },
+    {
+        name: "get_snapshot",
+        description: "Get a snapshot and its resources.",
+        inputSchema: {
+            type: "object",
+            required: ["id"],
+            properties: {
+                id: { type: "string" },
+                dbPath: { type: "string" }
+            }
+        }
+    },
+    {
+        name: "plan_restore",
+        description: "Build a dry-run restore plan for a snapshot.",
+        inputSchema: {
+            type: "object",
+            required: ["id"],
+            properties: {
+                id: { type: "string" },
+                dbPath: { type: "string" }
+            }
+        }
+    }
+];
+async function handle(request) {
+    if (request.method === "initialize") {
+        return {
+            protocolVersion: "2024-11-05",
+            capabilities: { tools: {} },
+            serverInfo: { name: "@hasna/snapshots", version: "0.1.0" }
+        };
+    }
+    if (request.method === "tools/list") {
+        return { tools };
+    }
+    if (request.method === "tools/call") {
+        const name = String(request.params?.name ?? "");
+        const args = (request.params?.arguments ?? {});
+        const result = await callTool(name, args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        };
+    }
+    return {};
+}
+async function callTool(name, args) {
+    const dbPath = typeof args.dbPath === "string" ? args.dbPath : undefined;
+    if (name === "capture_snapshot") {
+        return captureSnapshot({
+            dbPath,
+            name: typeof args.name === "string" ? args.name : undefined,
+            include: Array.isArray(args.include) ? args.include.map(String) : undefined
+        });
+    }
+    if (name === "list_snapshots") {
+        return { snapshots: listSnapshots({ dbPath, limit: typeof args.limit === "number" ? args.limit : undefined }) };
+    }
+    if (name === "get_snapshot") {
+        return getSnapshotEnvelope({ dbPath, id: String(args.id) });
+    }
+    if (name === "plan_restore") {
+        return planSnapshotRestore({ dbPath, id: String(args.id) });
+    }
+    throw new Error(`Unknown tool: ${name}`);
+}
+async function main() {
+    const input = await new Response(Bun.stdin.stream()).text();
+    for (const line of input.split(/\r?\n/).filter((candidate) => candidate.trim())) {
+        const request = JSON.parse(line);
+        try {
+            const result = await handle(request);
+            console.log(JSON.stringify({ jsonrpc: "2.0", id: request.id ?? null, result }));
+        }
+        catch (error) {
+            console.log(JSON.stringify({
+                jsonrpc: "2.0",
+                id: request.id ?? null,
+                error: {
+                    code: -32000,
+                    message: error instanceof Error ? error.message : String(error)
+                }
+            }));
+        }
+    }
+}
+if (import.meta.main) {
+    await main();
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

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

package/dist/policy.d.ts

@@ -0,0 +1,5 @@
+import type { PolicyMode, RestorePolicy, StoredSnapshotResource } from "./types.js";
+export declare function selectorCandidates(resource: StoredSnapshotResource): string[];
+export declare function resolvePolicy(resource: StoredSnapshotResource, policies?: RestorePolicy[]): RestorePolicy;
+export declare function normalizePolicyMode(mode: string): PolicyMode;
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAKpF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAO7E;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,sBAAsB,EAAE,QAAQ,GAAE,aAAa,EAAO,GAAG,aAAa,CAoB7G;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAG5D"}

package/dist/policy.js

@@ -0,0 +1,38 @@
+import { nowIso } from "./util.js";
+const SAFE_DEFAULT_RESTORE_KINDS = new Set(["project", "tmux-session"]);
+export function selectorCandidates(resource) {
+    return [
+        resource.id,
+        `kind:${resource.kind}`,
+        `source:${resource.source}`,
+        "*"
+    ];
+}
+export function resolvePolicy(resource, policies = []) {
+    const bySelector = new Map(policies.map((policy) => [policy.selector, policy]));
+    for (const selector of selectorCandidates(resource)) {
+        const policy = bySelector.get(selector);
+        if (policy)
+            return policy;
+    }
+    if (SAFE_DEFAULT_RESTORE_KINDS.has(resource.kind)) {
+        return {
+            selector: `kind:${resource.kind}`,
+            mode: "restore",
+            reason: "Built-in allowlist for guarded local project/tmux restore.",
+            updatedAt: nowIso()
+        };
+    }
+    return {
+        selector: "*",
+        mode: "observe",
+        reason: "Default policy observes resources without restoring them.",
+        updatedAt: nowIso()
+    };
+}
+export function normalizePolicyMode(mode) {
+    if (mode === "observe" || mode === "restore" || mode === "ignore")
+        return mode;
+    throw new Error(`Invalid policy mode: ${mode}. Expected observe, restore, or ignore.`);
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;AAExE,MAAM,UAAU,kBAAkB,CAAC,QAAgC;IACjE,OAAO;QACL,QAAQ,CAAC,EAAE;QACX,QAAQ,QAAQ,CAAC,IAAI,EAAE;QACvB,UAAU,QAAQ,CAAC,MAAM,EAAE;QAC3B,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgC,EAAE,WAA4B,EAAE;IAC5F,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAChF,KAAK,MAAM,QAAQ,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IACD,IAAI,0BAA0B,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,OAAO;YACL,QAAQ,EAAE,QAAQ,QAAQ,CAAC,IAAI,EAAE;YACjC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,4DAA4D;YACpE,SAAS,EAAE,MAAM,EAAE;SACpB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,GAAG;QACb,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,2DAA2D;QACnE,SAAS,EAAE,MAAM,EAAE;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/E,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,yCAAyC,CAAC,CAAC;AACzF,CAAC"}

package/dist/restore.d.ts

@@ -0,0 +1,4 @@
+import type { RestoreExecutionOptions, RestorePlan, RestorePolicy, SnapshotRecord, StoredSnapshotResource } from "./types.js";
+export declare function createRestorePlan(snapshot: SnapshotRecord, resources: StoredSnapshotResource[], policies?: RestorePolicy[], options?: RestoreExecutionOptions): RestorePlan;
+export declare function executeRestorePlan(plan: RestorePlan, options?: RestoreExecutionOptions): RestorePlan;
+//# sourceMappingURL=restore.d.ts.map

package/dist/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../src/restore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EAEvB,WAAW,EACX,aAAa,EACb,cAAc,EACd,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,sBAAsB,EAAE,EACnC,QAAQ,GAAE,aAAa,EAAO,EAC9B,OAAO,GAAE,uBAA4B,GACpC,WAAW,CAqCb;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,uBAA4B,GAAG,WAAW,CAuBxG"}

package/dist/restore.js

@@ -0,0 +1,157 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { commandExists, nowIso, sha256, stableJson } from "./util.js";
+import { resolvePolicy } from "./policy.js";
+export function createRestorePlan(snapshot, resources, policies = [], options = {}) {
+    const operations = [];
+    for (const resource of resources) {
+        const policy = resolvePolicy(resource, policies);
+        if (policy.mode === "ignore") {
+            operations.push(operation(resource, "ignored", "Ignored by restore policy.", "skipped", policy.reason));
+            continue;
+        }
+        if (policy.mode !== "restore") {
+            operations.push(operation(resource, "observed", "Observed only; no restore action.", "skipped", policy.reason));
+            continue;
+        }
+        if (resource.kind === "project") {
+            operations.push(planProject(resource));
+        }
+        else if (resource.kind === "tmux-session") {
+            operations.push(planTmuxSession(resource));
+        }
+        else {
+            operations.push(operation(resource, "unsupported", "No restore adapter for this resource kind.", "skipped"));
+        }
+    }
+    const plan = {
+        id: `plan_${snapshot.id}_${sha256(stableJson(operations.map((op) => ({ id: op.id, status: op.status })))).slice(0, 12)}`,
+        snapshotId: snapshot.id,
+        createdAt: nowIso(),
+        apply: Boolean(options.apply),
+        operations,
+        summary: summarizeOperations(operations)
+    };
+    if (options.apply) {
+        return executeRestorePlan(plan, options);
+    }
+    return plan;
+}
+export function executeRestorePlan(plan, options = {}) {
+    if (!options.apply)
+        return plan;
+    if (!options.yes) {
+        const operations = plan.operations.map((op) => op.status === "planned"
+            ? { ...op, status: "blocked", reason: "Restore execution requires --apply --yes." }
+            : op);
+        return {
+            ...plan,
+            apply: true,
+            operations,
+            summary: summarizeOperations(operations)
+        };
+    }
+    const operations = plan.operations.map((op) => executeOperation(op));
+    return {
+        ...plan,
+        apply: true,
+        operations,
+        summary: summarizeOperations(operations)
+    };
+}
+function planProject(resource) {
+    const path = typeof resource.attributes.path === "string" ? resource.attributes.path : undefined;
+    if (!path) {
+        return operation(resource, "project.mkdir", "Project has no path attribute.", "blocked");
+    }
+    if (existsSync(path)) {
+        return operation(resource, "project.exists", `Project path already exists: ${path}`, "noop");
+    }
+    return operation(resource, "project.mkdir", `Create missing project directory: ${path}`, "planned", undefined, [
+        "mkdir",
+        "-p",
+        path
+    ]);
+}
+function planTmuxSession(resource) {
+    const name = resource.name;
+    if (!/^[A-Za-z0-9_.:-]+$/.test(name)) {
+        return operation(resource, "tmux.create-session", `Unsafe tmux session name: ${name}`, "blocked");
+    }
+    if (!commandExists("tmux")) {
+        return operation(resource, "tmux.create-session", "tmux is not installed or not on PATH.", "blocked");
+    }
+    const hasSession = spawnSync("tmux", ["has-session", "-t", name], {
+        stdio: "ignore",
+        timeout: 2_000
+    }).status === 0;
+    if (hasSession) {
+        return operation(resource, "tmux.exists", `tmux session already exists: ${name}`, "noop");
+    }
+    const cwd = typeof resource.attributes.cwd === "string" ? resource.attributes.cwd : process.cwd();
+    return operation(resource, "tmux.create-session", `Create detached tmux session: ${name}`, "planned", undefined, [
+        "tmux",
+        "new-session",
+        "-d",
+        "-s",
+        name,
+        "-c",
+        cwd
+    ]);
+}
+function executeOperation(op) {
+    if (op.status !== "planned")
+        return op;
+    if (op.kind === "project.mkdir") {
+        const path = op.command?.at(-1);
+        if (!path)
+            return { ...op, status: "failed", reason: "Missing project path." };
+        try {
+            mkdirSync(path, { recursive: true });
+            return { ...op, status: "applied" };
+        }
+        catch (error) {
+            return { ...op, status: "failed", reason: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    if (op.kind === "tmux.create-session" && op.command) {
+        const [command, ...args] = op.command;
+        const result = spawnSync(command, args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 5_000 });
+        if (result.status === 0)
+            return { ...op, status: "applied" };
+        return {
+            ...op,
+            status: "failed",
+            reason: result.stderr?.trim() || result.error?.message || `Command exited with ${result.status}`
+        };
+    }
+    return { ...op, status: "blocked", reason: "No executor for operation kind." };
+}
+function operation(resource, kind, summary, status, reason, command) {
+    return {
+        id: `${kind}:${resource.id}`,
+        kind,
+        resourceId: resource.id,
+        resourceKind: resource.kind,
+        summary,
+        status,
+        reason,
+        command,
+        resource
+    };
+}
+function summarizeOperations(operations) {
+    const summary = {
+        planned: 0,
+        noop: 0,
+        blocked: 0,
+        skipped: 0,
+        applied: 0,
+        failed: 0
+    };
+    for (const op of operations) {
+        summary[op.status] += 1;
+    }
+    return summary;
+}
+//# sourceMappingURL=restore.js.map

package/dist/restore.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,38 @@
+import type { CaptureOptions, RestoreExecutionOptions, RestorePlan, SnapshotRecord } from "./types.js";
+export interface RuntimeOptions {
+    dbPath?: string;
+}
+export interface CaptureSnapshotOptions extends RuntimeOptions, CaptureOptions {
+    name?: string;
+}
+export interface SnapshotEnvelope {
+    snapshot: SnapshotRecord;
+    resource_count: number;
+    diagnostic_count: number;
+    duplicate: boolean;
+}
+export declare function captureSnapshot(options?: CaptureSnapshotOptions): Promise<SnapshotEnvelope>;
+export declare function listSnapshots(options?: RuntimeOptions & {
+    limit?: number;
+}): SnapshotRecord[];
+export declare function getSnapshotEnvelope(options: RuntimeOptions & {
+    id: string;
+}): {
+    snapshot: SnapshotRecord;
+    resources: import("./types.js").StoredSnapshotResource[];
+};
+export declare function listResources(options?: RuntimeOptions & {
+    limit?: number;
+}): {
+    resources: import("./types.js").StoredSnapshotResource[];
+};
+export declare function planSnapshotRestore(options: RuntimeOptions & RestoreExecutionOptions & {
+    id: string;
+}): RestorePlan;
+export declare function upsertPolicy(options: RuntimeOptions & {
+    selector: string;
+    mode: "observe" | "restore" | "ignore";
+    reason?: string;
+}): import("./types.js").RestorePolicy;
+export declare function listPolicies(options?: RuntimeOptions): import("./types.js").RestorePolicy[];
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,uBAAuB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKnH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,cAAc,EAAE,cAAc;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBrG;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAc,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,cAAc,EAAE,CAOjG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;EAY3E;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAc,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO;;EAS9E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,uBAAuB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAYnH;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,sCAOnI;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,cAAmB,wCAOxD"}