@sentropic/h2a-runtime 0.81.0

package/dist/workspace-sync-incremental.js

@@ -0,0 +1,199 @@
+import { createHash } from "node:crypto";
+import { readFileSync, statSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { join } from "node:path";
+const FILE_SIZE_LIMIT = 10_000_000; // 10 MB per file
+// ---------------------------------------------------------------------------
+// Hashing helpers
+// ---------------------------------------------------------------------------
+export function sha256Buf(buf) {
+    return createHash("sha256").update(buf).digest("hex");
+}
+export function sha256File(path) {
+    return sha256Buf(readFileSync(path));
+}
+// ---------------------------------------------------------------------------
+// Git introspection
+// ---------------------------------------------------------------------------
+export function isGitRepo(cwd) {
+    return (spawnSync("git", ["rev-parse", "--git-dir"], { cwd, encoding: "utf8" })
+        .status === 0);
+}
+export function getHeadSha(cwd) {
+    const r = spawnSync("git", ["rev-parse", "HEAD"], {
+        cwd,
+        encoding: "utf8",
+    });
+    return r.status === 0 ? r.stdout.trim() : undefined;
+}
+// ---------------------------------------------------------------------------
+// Bootstrap: full git bundle
+// ---------------------------------------------------------------------------
+/**
+ * Create a git bundle of all local refs (HEAD + all branches).
+ * Used for the first-time push when no base commit is known on the CP side.
+ */
+export function buildGitBundle(cwd) {
+    const r = spawnSync("git", ["bundle", "create", "-", "--all"], {
+        cwd,
+        maxBuffer: 512 * 1024 * 1024,
+    });
+    if (r.status !== 0) {
+        throw new Error(`git bundle failed: ${r.stderr?.toString()?.slice(0, 200) ?? "unknown error"}`);
+    }
+    return r.stdout;
+}
+// ---------------------------------------------------------------------------
+// Incremental: tracked diff (committed + staged changes since baseSha)
+// ---------------------------------------------------------------------------
+/**
+ * Build a binary git diff between baseSha and HEAD (committed changes) plus
+ * staged index changes, combined and base64-encoded for transport.
+ */
+export function buildTrackedDiff(cwd, baseSha) {
+    const opts = {
+        cwd,
+        maxBuffer: 256 * 1024 * 1024,
+    };
+    // Committed changes between baseSha and HEAD
+    const rCommitted = spawnSync("git", ["diff", "--binary", baseSha, "HEAD"], opts);
+    // Staged (index) changes not yet committed
+    const rStaged = spawnSync("git", ["diff", "--binary", "--cached", "HEAD"], opts);
+    const combined = Buffer.concat([
+        rCommitted.stdout ?? Buffer.alloc(0),
+        rStaged.stdout ?? Buffer.alloc(0),
+    ]);
+    return combined.toString("base64");
+}
+/**
+ * Build the full incremental manifest: tracked diff + untracked file list.
+ * Does NOT build the tarball (caller calls buildUntrackedTarball separately).
+ */
+export function buildIncrementalManifest(cwd, baseSha) {
+    const tracked = buildTrackedDiff(cwd, baseSha);
+    // List untracked files not excluded by .gitignore
+    const utR = spawnSync("git", ["ls-files", "-o", "--exclude-standard", "-z"], {
+        cwd,
+        encoding: "buffer",
+    });
+    const untrackedPaths = utR.stdout
+        .toString("utf8")
+        .split("\0")
+        .map((p) => p.trim())
+        .filter(Boolean);
+    const untrackedManifest = untrackedPaths.map((p) => {
+        const abs = join(cwd, p);
+        return { path: p, sha256: sha256File(abs), size: statSync(abs).size };
+    });
+    return {
+        base: baseSha,
+        tracked,
+        untrackedManifest,
+        deleted: [],
+        renames: [],
+        modes: [],
+    };
+}
+/**
+ * Build a gzip tarball of the specified untracked file paths relative to cwd.
+ * Returns an empty Buffer if paths is empty.
+ */
+export function buildUntrackedTarball(cwd, paths) {
+    if (paths.length === 0)
+        return Buffer.alloc(0);
+    const input = paths.join("\0");
+    // Note: -C must precede -T on GNU tar (positional option ordering).
+    const r = spawnSync("tar", ["-czf", "-", "-C", cwd, "--null", "-T", "-"], {
+        input: Buffer.from(input),
+        maxBuffer: 256 * 1024 * 1024,
+    });
+    if (r.status !== 0) {
+        throw new Error(`tar untracked failed: ${r.stderr?.toString()?.slice(0, 200) ?? "unknown error"}`);
+    }
+    return r.stdout;
+}
+/**
+ * Classifies the working set into hot/cold.
+ *
+ * Hot = git-tracked modified files (git diff --name-only HEAD)
+ *       ∪ untracked recent files (mtime < hotSetMtimeSec seconds ago)
+ *       where size ≤ 10 MB each.
+ * Cap: total hot-set bytes ≤ hotSetMaxBytes (default 50 MB).
+ * Files exceeding the size limit or pushed beyond the cap go to cold.
+ * Within the cap, candidates are sorted by mtime descending (newest first).
+ */
+export async function classifyWorkingSet(args) {
+    const { cwd } = args;
+    const hotSetMaxBytes = args.hotSetMaxBytes ?? 50_000_000;
+    const hotSetMtimeSec = args.hotSetMtimeSec ?? 86_400;
+    const nowMs = Date.now();
+    const mtimeCutoffMs = nowMs - hotSetMtimeSec * 1000;
+    // Tracked modified files (git diff --name-only HEAD)
+    const diffR = spawnSync("git", ["diff", "--name-only", "HEAD"], {
+        cwd,
+        encoding: "utf8",
+        maxBuffer: 8 * 1024 * 1024,
+    });
+    const trackedModified = diffR.status === 0
+        ? diffR.stdout
+            .split("\n")
+            .map((p) => p.trim())
+            .filter(Boolean)
+        : [];
+    // Untracked files (not ignored by .gitignore)
+    const utR = spawnSync("git", ["ls-files", "-o", "--exclude-standard", "-z"], { cwd, encoding: "buffer", maxBuffer: 8 * 1024 * 1024 });
+    const untracked = utR.status === 0
+        ? utR.stdout
+            .toString("utf8")
+            .split("\0")
+            .map((p) => p.trim())
+            .filter(Boolean)
+        : [];
+    // Filter untracked by mtime recency
+    const recentUntracked = untracked.filter((p) => {
+        try {
+            return statSync(join(cwd, p)).mtimeMs >= mtimeCutoffMs;
+        }
+        catch {
+            return false;
+        }
+    });
+    // Union: tracked modified + recent untracked, deduplicated
+    const candidateSet = new Set([...trackedModified, ...recentUntracked]);
+    const candidates = Array.from(candidateSet);
+    const entries = [];
+    const coldFromSize = [];
+    for (const p of candidates) {
+        let st;
+        try {
+            st = statSync(join(cwd, p));
+        }
+        catch {
+            continue; // file disappeared — skip
+        }
+        if (st.size > FILE_SIZE_LIMIT) {
+            coldFromSize.push(p);
+        }
+        else {
+            entries.push({ path: p, size: st.size, mtimeMs: st.mtimeMs });
+        }
+    }
+    // Sort by mtime descending (newest first) to prioritize recent files within cap
+    entries.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    // Apply cap: fill hot up to hotSetMaxBytes, overflow → cold
+    const hot = [];
+    const coldFromCap = [];
+    let hotBytes = 0;
+    for (const e of entries) {
+        if (hotBytes + e.size <= hotSetMaxBytes) {
+            hot.push(e.path);
+            hotBytes += e.size;
+        }
+        else {
+            coldFromCap.push(e.path);
+        }
+    }
+    const cold = [...coldFromSize, ...coldFromCap];
+    return { hot, cold, estimatedHotBytes: hotBytes };
+}
+//# sourceMappingURL=workspace-sync-incremental.js.map

package/dist/workspace-sync-incremental.js.map

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

package/dist/workspace-sync.d.ts

@@ -0,0 +1,3 @@
+export declare function buildWorkspaceArchive(cwd: string): Promise<Buffer>;
+export declare function uploadWorkspaceArchive(baseUrl: string, sessionId: string, archive: Buffer, fetchImpl?: typeof fetch, extraHeaders?: Record<string, string>): Promise<void>;
+//# sourceMappingURL=workspace-sync.d.ts.map

package/dist/workspace-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-sync.d.ts","sourceRoot":"","sources":["../src/workspace-sync.ts"],"names":[],"mappings":"AA8FA,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8FxE;AA6BD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,OAAO,KAAa,EAC/B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/workspace-sync.js

@@ -0,0 +1,187 @@
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { authHeaders } from "./config.js";
+// Largest .git we ship in the workspace archive. Over this, the repo history is
+// not transferred (the user restores it in-Pod via git fetch/clone).
+const MAX_GIT_BYTES = 128 * 1024 * 1024; // 128 MiB
+/** Best-effort directory size in bytes via `du -sk`. Infinity on failure (so we skip). */
+async function dirSizeBytes(absPath) {
+    const r = await run("du", ["-sk", absPath], dirname(absPath));
+    if (r.status !== 0)
+        return Number.POSITIVE_INFINITY;
+    const kb = parseInt(r.stdout.toString("utf8").trim().split(/\s+/)[0] ?? "", 10);
+    return Number.isFinite(kb) ? kb * 1024 : Number.POSITIVE_INFINITY;
+}
+// Safety cap against accidentally pushing huge directories. Generous because a
+// legitimate migrated conversation (.remote/sessions) can be large — claude
+// transcripts embed base64 images that do not compress.
+const MAX_ARCHIVE_BYTES = 256 * 1024 * 1024; // 256 MiB
+function run(command, args, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(command, [...args], { cwd });
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on("data", (c) => stdout.push(c));
+        child.stderr.on("data", (c) => stderr.push(c));
+        child.on("error", () => resolve({ status: 127, stdout: Buffer.concat(stdout), stderr: "spawn error" }));
+        child.on("close", (code) => resolve({
+            status: code ?? 1,
+            stdout: Buffer.concat(stdout),
+            stderr: Buffer.concat(stderr).toString("utf8"),
+        }));
+    });
+}
+async function isGitRepo(cwd) {
+    const result = await run("git", ["rev-parse", "--is-inside-work-tree"], cwd);
+    return result.status === 0 && result.stdout.toString("utf8").trim() === "true";
+}
+/**
+ * Build a gzip tarball of the working directory to seed a remote /workspace.
+ *
+ * In a git repo, uses `git ls-files -co --exclude-standard` so the archive
+ * honors .gitignore precisely AND includes uncommitted working-tree files.
+ * Outside a git repo, falls back to tar with a coarse exclude list.
+ */
+/**
+ * Approximate .gitignore in the non-git tar fallback: each plain pattern of
+ * the ROOT .gitignore becomes a tar --exclude. Comments and `!` negations are
+ * skipped; a trailing `/` is dropped (tar excludes match path components at
+ * any depth, like unanchored gitignore dir patterns); a leading `/` anchors
+ * the pattern to the archive root (`./`). Patterns that would drop migrated
+ * session state (`.remote`, `.claude`) are ignored — the conversation under
+ * .remote/sessions must always travel with the workspace.
+ */
+function rootGitignoreExcludes(cwd) {
+    let raw;
+    try {
+        raw = readFileSync(join(cwd, ".gitignore"), "utf8");
+    }
+    catch {
+        return [];
+    }
+    const excludes = [];
+    for (const line of raw.split("\n")) {
+        const pattern = line.trim();
+        if (!pattern || pattern.startsWith("#") || pattern.startsWith("!"))
+            continue;
+        const cleaned = pattern.replace(/\/+$/, "");
+        if (!cleaned)
+            continue;
+        const bare = cleaned.replace(/^\/+/, "");
+        if (bare === ".remote" || bare === ".claude")
+            continue;
+        excludes.push(`--exclude=${cleaned.startsWith("/") ? `./${bare}` : cleaned}`);
+    }
+    return excludes;
+}
+export async function buildWorkspaceArchive(cwd) {
+    const git = await isGitRepo(cwd);
+    let archive;
+    if (git) {
+        const list = await run("git", ["ls-files", "-co", "--exclude-standard", "-z"], cwd);
+        if (list.status !== 0) {
+            throw new Error(`git ls-files failed: ${list.stderr}`);
+        }
+        if (list.stdout.byteLength === 0) {
+            throw new Error("no files to sync (git ls-files returned nothing)");
+        }
+        // Force-include persisted conversation state under .remote/sessions even
+        // though .gitignore typically excludes it (the nested `.claude/` path
+        // segment trips a `.claude/` ignore rule). This is how a migrated session
+        // carries its in-progress conversation onto the remote workspace PVC, where
+        // the session-agent restores it into HOME before the CLI starts.
+        //
+        // SECURITY: .claude/settings.local.json is intentionally excluded — it
+        // contains machine-local API keys and MCP secrets that must not transit the
+        // control-plane. The remote session sources credentials via `remote
+        // push-creds` instead.
+        const sessionState = await run("git", [
+            "ls-files",
+            "-o",
+            "-z",
+            "--",
+            ".remote/sessions",
+            ".remote/git.json",
+            ".claude/settings.json",
+        ], cwd);
+        // Force-include the .git directory (git ls-files never lists it) so the
+        // remote workspace is a real git repo — commit/push works in the Pod and
+        // the remote/branch config travels. Size-gated: huge histories blow the
+        // archive cap and the tunnel, so over MAX_GIT_BYTES we skip the objects and
+        // let the user restore git in-Pod (git fetch/clone — gh auth is bundled).
+        let gitDir = Buffer.alloc(0);
+        if (existsSync(join(cwd, ".git"))) {
+            const gitBytes = await dirSizeBytes(join(cwd, ".git"));
+            if (gitBytes <= MAX_GIT_BYTES) {
+                gitDir = Buffer.from(".git\0", "utf8");
+            }
+            else {
+                process.stderr.write(`[remote] .git is ${(gitBytes / 1024 / 1024).toFixed(0)} MiB (> ${MAX_GIT_BYTES / 1024 / 1024} MiB) — not shipped; ` +
+                    `restore git in the Pod with 'git fetch'/'git clone' (gh auth is bundled if you pass --with gh)\n`);
+            }
+        }
+        const fileList = Buffer.concat([
+            list.stdout,
+            sessionState.status === 0 ? sessionState.stdout : Buffer.alloc(0),
+            gitDir,
+        ]);
+        // SECURITY: exclude machine-local secrets even if they slip through
+        // git ls-files (e.g. when not in .gitignore). Belt-and-suspenders guard.
+        const tar = await runWithStdin("tar", ["-czf", "-", "--exclude=./.claude/settings.local.json", "--null", "-T", "-"], cwd, fileList);
+        if (tar.status !== 0)
+            throw new Error(`tar failed: ${tar.stderr}`);
+        archive = tar.stdout;
+    }
+    else {
+        const tar = await run("tar", [
+            "-czf",
+            "-",
+            "--exclude=./.git",
+            "--exclude=./node_modules",
+            // SECURITY: exclude machine-local secrets regardless of .gitignore state
+            "--exclude=./.claude/settings.local.json",
+            ...rootGitignoreExcludes(cwd),
+            ".",
+        ], cwd);
+        if (tar.status !== 0)
+            throw new Error(`tar failed: ${tar.stderr}`);
+        archive = tar.stdout;
+    }
+    if (archive.byteLength > MAX_ARCHIVE_BYTES) {
+        throw new Error(`workspace archive is ${(archive.byteLength / 1024 / 1024).toFixed(1)} MiB, over the ${MAX_ARCHIVE_BYTES / 1024 / 1024} MiB cap; add large paths to .gitignore`);
+    }
+    return archive;
+}
+function runWithStdin(command, args, cwd, input) {
+    return new Promise((resolve) => {
+        const child = spawn(command, [...args], { cwd });
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on("data", (c) => stdout.push(c));
+        child.stderr.on("data", (c) => stderr.push(c));
+        child.on("error", () => resolve({ status: 127, stdout: Buffer.concat(stdout), stderr: "spawn error" }));
+        child.on("close", (code) => resolve({
+            status: code ?? 1,
+            stdout: Buffer.concat(stdout),
+            stderr: Buffer.concat(stderr).toString("utf8"),
+        }));
+        child.stdin.write(input);
+        child.stdin.end();
+    });
+}
+export async function uploadWorkspaceArchive(baseUrl, sessionId, archive, fetchImpl = fetch, extraHeaders) {
+    const response = await fetchImpl(`${baseUrl.replace(/\/$/, "")}/sessions/${sessionId}/workspace`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/gzip",
+            ...authHeaders(),
+            ...(extraHeaders ?? {}),
+        },
+        body: archive,
+    });
+    if (!response.ok) {
+        throw new Error(`workspace upload failed: ${response.status} ${response.statusText}`);
+    }
+}
+//# sourceMappingURL=workspace-sync.js.map

package/dist/workspace-sync.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,70 @@
+export declare function baseSnapshotPath(cwd: string): string;
+export declare function readBaseSnapshot(cwd: string): Buffer | null;
+export declare function writeBaseSnapshot(cwd: string, archive: Buffer): void;
+export type WorkspaceMarker = {
+    readonly remote: string;
+    readonly workspaceId: string;
+    /**
+     * Environment parity (the "feel at home" config): the absolute path the
+     * project lives at locally, reproduced as the workspace mount path inside the
+     * remote Pod, and the local HOME to reproduce. Captured at link/migrate time
+     * so every session bound to this workspace resumes with identical paths.
+     */
+    readonly path?: string;
+    readonly home?: string;
+};
+export declare function markerPath(cwd: string): string;
+export declare function readWorkspaceMarker(cwd: string): WorkspaceMarker | undefined;
+export declare function writeWorkspaceMarker(cwd: string, marker: WorkspaceMarker): void;
+export type LineageRecord = {
+    readonly lineageId: string;
+    readonly remoteSessionId?: string;
+};
+export declare function readLineageRecord(cwd: string, workspaceId: string): LineageRecord | undefined;
+export declare function writeLineageRecord(cwd: string, workspaceId: string, record: LineageRecord): void;
+type WorkspaceDescriptor = {
+    id: string;
+    createdAt: string;
+    displayName?: string;
+};
+export declare function createWorkspace(baseUrl: string, body?: {
+    displayName?: string;
+}, fetchImpl?: typeof fetch): Promise<WorkspaceDescriptor>;
+export declare function listWorkspaces(baseUrl: string, fetchImpl?: typeof fetch): Promise<ReadonlyArray<WorkspaceDescriptor>>;
+export declare function deleteWorkspace(baseUrl: string, workspaceId: string, fetchImpl?: typeof fetch): Promise<boolean>;
+export declare function downloadWorkspaceExport(baseUrl: string, sessionId: string, fetchImpl?: typeof fetch): Promise<Buffer | null>;
+export type LockResult = {
+    readonly acquired: true;
+} | {
+    readonly acquired: false;
+    readonly holder: string;
+    readonly since: string;
+};
+export declare function acquireWorkspaceLock(baseUrl: string, workspaceId: string, holder: string, ttlSeconds?: number, fetchImpl?: typeof fetch): Promise<LockResult>;
+export declare function releaseWorkspaceLock(baseUrl: string, workspaceId: string, fetchImpl?: typeof fetch): Promise<void>;
+export declare function lockHolderId(): string;
+export type WorkspaceGcCandidate = {
+    readonly id: string;
+    readonly sizeH: string;
+    readonly lastModified: string;
+    readonly archivedTo?: string;
+};
+export type WorkspaceGcReport = {
+    readonly candidates: ReadonlyArray<WorkspaceGcCandidate>;
+    readonly applied: boolean;
+    readonly failed?: ReadonlyArray<{
+        readonly id: string;
+        readonly reason: string;
+    }>;
+};
+/**
+ * POST /workspaces/gc. Without `apply` this is a PURE dry-run on the server
+ * (the janitor only lists + sizes candidates); with `apply: true` candidates
+ * are archived to the volume's own .trash/ before being removed.
+ */
+export declare function requestWorkspaceGc(baseUrl: string, body: {
+    olderThanDays?: number;
+    apply?: boolean;
+}, fetchImpl?: typeof fetch): Promise<WorkspaceGcReport>;
+export {};
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

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