@ai-hero/sandcastle 0.6.5 → 0.7.0

package/dist/WorktreeManager.js

@@ -1,283 +0,0 @@
-import { Effect, Option } from "effect";
-import { FileSystem } from "@effect/platform";
-import { execFile } from "node:child_process";
-import { join, normalize } from "node:path";
-import { WorktreeError, WorktreeTimeoutError, withTimeout } from "./errors.js";
-const WORKTREE_TIMEOUT_MS = 30_000;
-/**
- * Git global flags that prevent `git worktree add -b` from writing upstream
- * tracking config to `.git/config`. Without these, a user's global
- * `branch.autoSetupMerge` or `push.autoSetupRemote` can cause a config write
- * that races with other processes holding `.git/config.lock`.
- */
-const NO_CONFIG_LOCK_FLAGS = [
-    "-c",
-    "branch.autoSetupMerge=false",
-    "-c",
-    "push.autoSetupRemote=false",
-];
-/** Format a timestamp as YYYYMMDD-HHMMSS */
-const formatTimestamp = (date) => {
-    const pad = (n) => String(n).padStart(2, "0");
-    return (`${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}-` +
-        `${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`);
-};
-/** Sanitize a name for use in branch names and directory names. */
-export const sanitizeName = (name) => name.toLowerCase().replace(/[^a-z0-9]/g, "-");
-const execGit = (args, cwd) => Effect.async((resume) => {
-    // Force the C locale so git emits English, machine-stable messages. Several
-    // callers match git's stderr (e.g. "invalid reference") to decide control
-    // flow; under a localized locale gettext translates those strings and the
-    // matches silently fail, breaking worktree creation (issue #595).
-    execFile("git", args, { cwd, env: { ...process.env, LC_ALL: "C" } }, (error, stdout, stderr) => {
-        if (error) {
-            resume(Effect.fail(new WorktreeError({
-                message: stderr?.trim() || error.message,
-            })));
-        }
-        else {
-            resume(Effect.succeed(stdout));
-        }
-    });
-});
-/**
- * Generates a temporary branch name.
- * When name is provided: `sandcastle/<sanitized-name>/<YYYYMMDD-HHMMSS>`.
- * Otherwise: `sandcastle/<YYYYMMDD-HHMMSS>`.
- */
-export const generateTempBranchName = (name) => {
-    const ts = formatTimestamp(new Date());
-    if (name) {
-        return `sandcastle/${sanitizeName(name)}/${ts}`;
-    }
-    return `sandcastle/${ts}`;
-};
-/** Returns the name of the currently checked-out branch in the given repo directory. */
-export const getCurrentBranch = (repoDir) => execGit(["rev-parse", "--abbrev-ref", "HEAD"], repoDir).pipe(Effect.map((output) => output.trim()));
-/**
- * Normalizes path separators to forward slashes.
- *
- * `git worktree list --porcelain` reports paths with forward slashes on every
- * platform, but `node:path.join` produces backslashes on Windows. Comparing
- * the two without normalizing fails on Windows, so all path comparisons in
- * this module run both sides through this first.
- */
-const normalizePath = (p) => p.replace(/\\/g, "/");
-/**
- * Finds an existing worktree that collides with `branch` or `worktreePath`.
- *
- * Matches by branch first, then falls back to a path match — covering the
- * mid-rebase detached-HEAD case where git reports a `null` branch. The path
- * fallback normalizes separators so it works on Windows.
- */
-export const findCollidingWorktree = (existing, branch, worktreePath) => existing.find((wt) => wt.branch === branch) ??
-    existing.find((wt) => normalizePath(wt.path) === normalizePath(worktreePath));
-/**
- * Whether `worktreePath` lives under `worktreesDir` (i.e. is a worktree managed
- * by sandcastle rather than the main working tree or an external worktree).
- * Separators are normalized so the check holds on Windows.
- */
-export const isManagedWorktreePath = (worktreePath, worktreesDir) => normalizePath(worktreePath).startsWith(normalizePath(worktreesDir));
-/**
- * Whether a directory entry under `.sandcastle/worktrees/` is orphaned — not
- * present in the set of active worktree paths reported by git. Both sides are
- * normalized so paths from `join` (backslashes on Windows) match git's
- * forward-slash output.
- */
-export const isOrphanedWorktreePath = (entryPath, activeWorktreePaths) => {
-    const normalizedEntry = normalizePath(entryPath);
-    for (const active of activeWorktreePaths) {
-        if (normalizePath(active) === normalizedEntry)
-            return false;
-    }
-    return true;
-};
-/** Parses `git worktree list --porcelain` output into structured entries. */
-const listWorktrees = (repoDir) => execGit(["worktree", "list", "--porcelain"], repoDir).pipe(Effect.map((output) => {
-    const entries = [];
-    let currentPath = null;
-    let currentBranch = null;
-    for (const line of output.split("\n")) {
-        if (line.startsWith("worktree ")) {
-            if (currentPath !== null) {
-                entries.push({ path: currentPath, branch: currentBranch });
-            }
-            currentPath = line.slice("worktree ".length).trim();
-            currentBranch = null;
-        }
-        else if (line.startsWith("branch ")) {
-            // "branch refs/heads/my-branch" -> "my-branch"
-            currentBranch = line.slice("branch refs/heads/".length).trim();
-        }
-    }
-    if (currentPath !== null) {
-        entries.push({ path: currentPath, branch: currentBranch });
-    }
-    return entries;
-}));
-/**
- * Creates a git worktree at `.sandcastle/worktrees/<name>/`.
- *
- * - If `branch` is specified, checks out that branch.
- * - If not, creates a temporary `sandcastle/<timestamp>` branch.
- *
- * When `branch` collides with an existing managed worktree:
- * - Clean → reuses the existing worktree.
- * - Dirty (uncommitted changes) → reuses with a console warning (ADR 0003).
- *
- * Collisions with the main working tree or external worktrees always throw.
- */
-export const create = (repoDir, opts) => Effect.gen(function* () {
-    const fs = yield* FileSystem.FileSystem;
-    const worktreesDir = join(repoDir, ".sandcastle", "worktrees");
-    yield* fs
-        .makeDirectory(worktreesDir, { recursive: true })
-        .pipe(Effect.mapError((e) => new WorktreeError({ message: e.message })));
-    let branch;
-    let worktreeName;
-    if (opts?.branch) {
-        branch = opts.branch;
-        worktreeName = branch.replace(/\//g, "-");
-    }
-    else {
-        const timestamp = formatTimestamp(new Date());
-        if (opts?.name) {
-            const sanitized = sanitizeName(opts.name);
-            branch = `sandcastle/${sanitized}/${timestamp}`;
-            worktreeName = `sandcastle-${sanitized}-${timestamp}`;
-        }
-        else {
-            branch = `sandcastle/${timestamp}`;
-            worktreeName = `sandcastle-${timestamp}`;
-        }
-    }
-    const worktreePath = join(worktreesDir, worktreeName);
-    if (opts?.branch) {
-        // Proactively detect collision before git produces a confusing error.
-        // Match by branch first; fall back to target path (covers mid-rebase
-        // detached-HEAD state where the branch field is null).
-        const existing = yield* listWorktrees(repoDir);
-        const collision = findCollidingWorktree(existing, branch, worktreePath);
-        if (collision) {
-            // Only reuse worktrees managed by sandcastle (under .sandcastle/worktrees/)
-            if (isManagedWorktreePath(collision.path, worktreesDir)) {
-                const dirty = yield* hasUncommittedChanges(collision.path);
-                if (dirty) {
-                    console.warn(`Reusing worktree at ${collision.path} (branch '${branch}') — worktree has uncommitted changes`);
-                }
-                else {
-                    console.log(`Reusing existing worktree at ${collision.path} (branch '${branch}')`);
-                }
-                // git reports forward slashes even on Windows; return a
-                // platform-native path so downstream join/fs calls stay consistent.
-                return { path: normalize(collision.path), branch };
-            }
-            // Branch is checked out in the main working tree or external worktree
-            yield* Effect.fail(new WorktreeError({
-                message: `Branch '${branch}' is already checked out in worktree at '${collision.path}'. ` +
-                    `Use a different branch name, or wait for the other run to finish.`,
-            }));
-        }
-        yield* execGit([...NO_CONFIG_LOCK_FLAGS, "worktree", "add", worktreePath, branch], repoDir).pipe(Effect.catchAll((e) => {
-            if (e.message.includes("invalid reference")) {
-                return execGit([
-                    ...NO_CONFIG_LOCK_FLAGS,
-                    "worktree",
-                    "add",
-                    "-b",
-                    branch,
-                    worktreePath,
-                    opts?.baseBranch ?? "HEAD",
-                ], repoDir);
-            }
-            return Effect.fail(e);
-        }));
-    }
-    else {
-        yield* execGit([
-            ...NO_CONFIG_LOCK_FLAGS,
-            "worktree",
-            "add",
-            "-b",
-            branch,
-            worktreePath,
-            "HEAD",
-        ], repoDir).pipe(Effect.catchAll((e) => {
-            if (e.message.includes("already checked out") ||
-                e.message.includes("already exists")) {
-                return Effect.fail(new WorktreeError({
-                    message: `Branch '${branch}' is already checked out in another worktree. ` +
-                        `Use a different branch name, or wait for the other run to finish.`,
-                }));
-            }
-            return Effect.fail(e);
-        }));
-    }
-    return { path: worktreePath, branch };
-}).pipe(withTimeout(WORKTREE_TIMEOUT_MS, () => new WorktreeTimeoutError({
-    message: `Worktree creation timed out after ${WORKTREE_TIMEOUT_MS}ms`,
-    timeoutMs: WORKTREE_TIMEOUT_MS,
-    path: repoDir,
-    operation: "create",
-})));
-/**
- * Returns true if the worktree at `worktreePath` has any uncommitted changes:
- * unstaged modifications, staged changes, or untracked files.
- */
-export const hasUncommittedChanges = (worktreePath) => execGit(["status", "--porcelain"], worktreePath).pipe(Effect.map((output) => output.trim().length > 0));
-/**
- * Removes a worktree and its git metadata.
- *
- * The `worktreePath` must be a path inside `.sandcastle/worktrees/` so that
- * the main repository directory can be derived from it.
- */
-export const remove = (worktreePath) => {
-    // Derive the main repo dir: worktreePath = <repoDir>/.sandcastle/worktrees/<name>
-    const repoDir = join(worktreePath, "..", "..", "..");
-    return execGit(["worktree", "remove", "--force", worktreePath], repoDir).pipe(Effect.asVoid);
-};
-/**
- * Prunes stale git worktree metadata and removes orphaned directories under
- * `.sandcastle/worktrees/`.
- */
-export const pruneStale = (repoDir) => Effect.gen(function* () {
-    const fs = yield* FileSystem.FileSystem;
-    // Let git clean up metadata for worktrees whose directories are gone
-    yield* execGit(["worktree", "prune"], repoDir);
-    const worktreesDir = join(repoDir, ".sandcastle", "worktrees");
-    // Read directory entries — return null if directory doesn't exist
-    const entries = yield* fs.readDirectory(worktreesDir).pipe(Effect.map((es) => es), Effect.catchSome((e) => e._tag === "SystemError" && e.reason === "NotFound"
-        ? Option.some(Effect.succeed(null))
-        : Option.none()), Effect.mapError((e) => new WorktreeError({ message: e.message })));
-    if (entries === null)
-        return;
-    // `git worktree list` canonicalizes paths via realpath. If repoDir or
-    // .sandcastle is a symlink, joining the un-canonicalized prefix produces
-    // strings that never match git's output, and every active worktree looks
-    // orphaned. Resolve the prefix once so the Set lookup below works.
-    const realWorktreesDir = yield* fs
-        .realPath(worktreesDir)
-        .pipe(Effect.catchAll(() => Effect.succeed(worktreesDir)));
-    // Get the list of active worktree paths from git
-    const worktreeList = yield* execGit(["worktree", "list", "--porcelain"], repoDir);
-    const activeWorktreePaths = new Set(worktreeList
-        .split("\n")
-        .filter((line) => line.startsWith("worktree "))
-        .map((line) => line.slice("worktree ".length).trim()));
-    // Remove any directory under .sandcastle/worktrees/ that is not an active worktree
-    for (const entry of entries) {
-        const entryPath = join(realWorktreesDir, entry);
-        const isDir = yield* fs.stat(entryPath).pipe(Effect.map((s) => s.type === "Directory"), Effect.catchAll(() => Effect.succeed(false)));
-        if (isDir && isOrphanedWorktreePath(entryPath, activeWorktreePaths)) {
-            yield* fs.remove(entryPath, { recursive: true, force: true }).pipe(Effect.mapError((e) => new WorktreeError({
-                message: `Failed to remove ${entryPath}: ${e.message}`,
-            })));
-        }
-    }
-}).pipe(withTimeout(WORKTREE_TIMEOUT_MS, () => new WorktreeTimeoutError({
-    message: `Worktree prune timed out after ${WORKTREE_TIMEOUT_MS}ms`,
-    timeoutMs: WORKTREE_TIMEOUT_MS,
-    path: repoDir,
-    operation: "prune",
-})));
-//# sourceMappingURL=WorktreeManager.js.map

package/dist/WorktreeManager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"WorktreeManager.js","sourceRoot":"","sources":["../src/WorktreeManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG;IAC3B,IAAI;IACJ,6BAA6B;IAC7B,IAAI;IACJ,4BAA4B;CAC7B,CAAC;AAEF,4CAA4C;AAC5C,MAAM,eAAe,GAAG,CAAC,IAAU,EAAU,EAAE;IAC7C,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,CACL,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG;QACzE,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAC5E,CAAC;AACJ,CAAC,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAU,EAAE,CACnD,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;AAEhD,MAAM,OAAO,GAAG,CACd,IAAc,EACd,GAAW,EAC2B,EAAE,CACxC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;IACtB,4EAA4E;IAC5E,0EAA0E;IAC1E,0EAA0E;IAC1E,kEAAkE;IAClE,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAC7C,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CACJ,MAAM,CAAC,IAAI,CACT,IAAI,aAAa,CAAC;gBAChB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO;aACzC,CAAC,CACH,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAa,EAAU,EAAE;IAC9D,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACvC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,cAAc,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,cAAc,EAAE,EAAE,CAAC;AAC5B,CAAC,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAAe,EACuB,EAAE,CACxC,OAAO,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAC1D,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CACtC,CAAC;AAcJ;;;;;;;GAOG;AACH,MAAM,aAAa,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,QAAkC,EAClC,MAAc,EACd,YAAoB,EACO,EAAE,CAC7B,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,YAAoB,EACpB,YAAoB,EACX,EAAE,CACX,aAAa,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,SAAiB,EACjB,mBAAqC,EAC5B,EAAE;IACX,MAAM,eAAe,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACjD,KAAK,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACzC,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,eAAe;YAAE,OAAO,KAAK,CAAC;IAC9D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,aAAa,GAAG,CACpB,OAAe,EACgC,EAAE,CACjD,OAAO,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CACxD,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;IACpB,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,aAAa,GAAkB,IAAI,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACjC,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACpD,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,+CAA+C;YAC/C,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACjE,CAAC;IACH,CAAC;IAED,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC,CACH,CAAC;AAEJ;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,OAAe,EACf,IAIC,EAKD,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IAC/D,KAAK,CAAC,CAAC,EAAE;SACN,aAAa,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAE3E,IAAI,MAAc,CAAC;IACnB,IAAI,YAAoB,CAAC;IAEzB,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACrB,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,GAAG,cAAc,SAAS,IAAI,SAAS,EAAE,CAAC;YAChD,YAAY,GAAG,cAAc,SAAS,IAAI,SAAS,EAAE,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,cAAc,SAAS,EAAE,CAAC;YACnC,YAAY,GAAG,cAAc,SAAS,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAEtD,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,sEAAsE;QACtE,qEAAqE;QACrE,uDAAuD;QACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QACxE,IAAI,SAAS,EAAE,CAAC;YACd,4EAA4E;YAC5E,IAAI,qBAAqB,CAAC,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;gBACxD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC3D,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,CAAC,IAAI,CACV,uBAAuB,SAAS,CAAC,IAAI,aAAa,MAAM,uCAAuC,CAChG,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CACT,gCAAgC,SAAS,CAAC,IAAI,aAAa,MAAM,IAAI,CACtE,CAAC;gBACJ,CAAC;gBACD,wDAAwD;gBACxD,oEAAoE;gBACpE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;YACrD,CAAC;YACD,sEAAsE;YACtE,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAChB,IAAI,aAAa,CAAC;gBAChB,OAAO,EACL,WAAW,MAAM,4CAA4C,SAAS,CAAC,IAAI,KAAK;oBAChF,mEAAmE;aACtE,CAAC,CACH,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,CAAC,OAAO,CACZ,CAAC,GAAG,oBAAoB,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,EAClE,OAAO,CACR,CAAC,IAAI,CACJ,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YACpB,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBAC5C,OAAO,OAAO,CACZ;oBACE,GAAG,oBAAoB;oBACvB,UAAU;oBACV,KAAK;oBACL,IAAI;oBACJ,MAAM;oBACN,YAAY;oBACZ,IAAI,EAAE,UAAU,IAAI,MAAM;iBAC3B,EACD,OAAO,CACR,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,CAAC,OAAO,CACZ;YACE,GAAG,oBAAoB;YACvB,UAAU;YACV,KAAK;YACL,IAAI;YACJ,MAAM;YACN,YAAY;YACZ,MAAM;SACP,EACD,OAAO,CACR,CAAC,IAAI,CACJ,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YACpB,IACE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC;gBACzC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EACpC,CAAC;gBACD,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,aAAa,CAAC;oBAChB,OAAO,EACL,WAAW,MAAM,gDAAgD;wBACjE,mEAAmE;iBACtE,CAAC,CACH,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC,CAAC,CAAC,IAAI,CACL,WAAW,CACT,mBAAmB,EACnB,GAAG,EAAE,CACH,IAAI,oBAAoB,CAAC;IACvB,OAAO,EAAE,qCAAqC,mBAAmB,IAAI;IACrE,SAAS,EAAE,mBAAmB;IAC9B,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,QAAQ;CACpB,CAAC,CACL,CACF,CAAC;AAEJ;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,YAAoB,EACmB,EAAE,CACzC,OAAO,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,CACnD,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CACjD,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,YAAoB,EACgB,EAAE;IACtC,kFAAkF;IAClF,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAC3E,MAAM,CAAC,MAAM,CACd,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAAe,EAKf,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IAExC,qEAAqE;IACrE,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAE/C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IAE/D,kEAAkE;IAClE,MAAM,OAAO,GAAoB,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CACzE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAmB,EAAE,CAAC,EAAE,CAAC,EACvC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CACrB,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU;QACjD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAuB,CAAC,CAAC;QACtD,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAClB,EACD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAClE,CAAC;IAEF,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO;IAE7B,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,mEAAmE;IACnE,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,EAAE;SAC/B,QAAQ,CAAC,YAAY,CAAC;SACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAE7D,iDAAiD;IACjD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,OAAO,CACjC,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EACnC,OAAO,CACR,CAAC;IACF,MAAM,mBAAmB,GAAG,IAAI,GAAG,CACjC,YAAY;SACT,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;SAC9C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CACxD,CAAC;IAEF,mFAAmF;IACnF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EACzC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAC7C,CAAC;QACF,IAAI,KAAK,IAAI,sBAAsB,CAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,CAAC;YACpE,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAChE,MAAM,CAAC,QAAQ,CACb,CAAC,CAAC,EAAE,EAAE,CACJ,IAAI,aAAa,CAAC;gBAChB,OAAO,EAAE,oBAAoB,SAAS,KAAK,CAAC,CAAC,OAAO,EAAE;aACvD,CAAC,CACL,CACF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC,CAAC,IAAI,CACL,WAAW,CACT,mBAAmB,EACnB,GAAG,EAAE,CACH,IAAI,oBAAoB,CAAC;IACvB,OAAO,EAAE,kCAAkC,mBAAmB,IAAI;IAClE,SAAS,EAAE,mBAAmB;IAC9B,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,OAAO;CACnB,CAAC,CACL,CACF,CAAC"}

package/dist/boundedTail.d.ts

@@ -1,48 +0,0 @@
-/**
- * A bounded, rolling tail of streamed output — a pure, provider-agnostic
- * utility shared by every sandbox provider that streams `exec` output.
- *
- * When a provider streams output line-by-line, it accumulates the stream only
- * to build the returned `ExecResult.stdout`/`stderr`. Consumers read just the
- * tail of that value (e.g. the last lines of an error, or a fallback for the
- * agent's final result), so retaining the whole stream is unnecessary — and,
- * once the accumulated string passes V8's ~512MB max string length, fatal: a
- * naive `chunks.join()` throws `RangeError: Invalid string length`, which on a
- * long agent run crashes the whole orchestration.
- */
-/**
- * Default maximum number of characters retained in a bounded output tail.
- *
- * 64KiB sits comfortably above any agent completion signal or structured-output
- * payload while staying far below V8's max string length.
- */
-export declare const MAX_TAIL_CHARS: number;
-/**
- * A fixed-size rolling tail of strings, bounded by total character length.
- *
- * `push` appends to the tail; once the joined length would exceed `maxChars`,
- * the oldest items are dropped from the front. A single item longer than
- * `maxChars` is truncated to its own tail, so a newline-free blob can't
- * overflow on one push. `toString` joins the retained items, and its length is
- * always at most `maxChars`.
- *
- * The running length counter is encapsulated so callers can't desync it.
- */
-export declare class BoundedTail {
-    private readonly items;
-    private totalChars;
-    private readonly maxChars;
-    private readonly separator;
-    /**
-     * @param maxChars Maximum length of the joined tail. Defaults to {@link MAX_TAIL_CHARS}.
-     * @param separator String placed between items by {@link toString}. Must match
-     *   how the caller would otherwise have joined the accumulated chunks (e.g.
-     *   `"\n"` for line streams, `""` for raw chunk streams).
-     */
-    constructor(maxChars?: number, separator?: string);
-    /** Append one item to the tail, evicting oldest items to stay within budget. */
-    push(item: string): void;
-    /** Join the retained tail into a single string (length ≤ `maxChars`). */
-    toString(): string;
-}
-//# sourceMappingURL=boundedTail.d.ts.map

package/dist/boundedTail.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"boundedTail.d.ts","sourceRoot":"","sources":["../src/boundedTail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAY,CAAC;AAExC;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;;OAKG;IACH,YAAY,QAAQ,GAAE,MAAuB,EAAE,SAAS,SAAK,EAG5D;IAED,gFAAgF;IAChF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAYvB;IAED,yEAAyE;IACzE,QAAQ,IAAI,MAAM,CAEjB;CACF"}

package/dist/boundedTail.js

@@ -1,64 +0,0 @@
-/**
- * A bounded, rolling tail of streamed output — a pure, provider-agnostic
- * utility shared by every sandbox provider that streams `exec` output.
- *
- * When a provider streams output line-by-line, it accumulates the stream only
- * to build the returned `ExecResult.stdout`/`stderr`. Consumers read just the
- * tail of that value (e.g. the last lines of an error, or a fallback for the
- * agent's final result), so retaining the whole stream is unnecessary — and,
- * once the accumulated string passes V8's ~512MB max string length, fatal: a
- * naive `chunks.join()` throws `RangeError: Invalid string length`, which on a
- * long agent run crashes the whole orchestration.
- */
-/**
- * Default maximum number of characters retained in a bounded output tail.
- *
- * 64KiB sits comfortably above any agent completion signal or structured-output
- * payload while staying far below V8's max string length.
- */
-export const MAX_TAIL_CHARS = 64 * 1024;
-/**
- * A fixed-size rolling tail of strings, bounded by total character length.
- *
- * `push` appends to the tail; once the joined length would exceed `maxChars`,
- * the oldest items are dropped from the front. A single item longer than
- * `maxChars` is truncated to its own tail, so a newline-free blob can't
- * overflow on one push. `toString` joins the retained items, and its length is
- * always at most `maxChars`.
- *
- * The running length counter is encapsulated so callers can't desync it.
- */
-export class BoundedTail {
-    items = [];
-    totalChars = 0;
-    maxChars;
-    separator;
-    /**
-     * @param maxChars Maximum length of the joined tail. Defaults to {@link MAX_TAIL_CHARS}.
-     * @param separator String placed between items by {@link toString}. Must match
-     *   how the caller would otherwise have joined the accumulated chunks (e.g.
-     *   `"\n"` for line streams, `""` for raw chunk streams).
-     */
-    constructor(maxChars = MAX_TAIL_CHARS, separator = "") {
-        this.maxChars = maxChars;
-        this.separator = separator;
-    }
-    /** Append one item to the tail, evicting oldest items to stay within budget. */
-    push(item) {
-        const bounded = item.length > this.maxChars
-            ? item.slice(item.length - this.maxChars)
-            : item;
-        this.totalChars +=
-            bounded.length + (this.items.length > 0 ? this.separator.length : 0);
-        this.items.push(bounded);
-        while (this.totalChars > this.maxChars && this.items.length > 1) {
-            const dropped = this.items.shift();
-            this.totalChars -= dropped.length + this.separator.length;
-        }
-    }
-    /** Join the retained tail into a single string (length ≤ `maxChars`). */
-    toString() {
-        return this.items.join(this.separator);
-    }
-}
-//# sourceMappingURL=boundedTail.js.map

package/dist/boundedTail.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"boundedTail.js","sourceRoot":"","sources":["../src/boundedTail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IACL,KAAK,GAAa,EAAE,CAAC;IAC9B,UAAU,GAAG,CAAC,CAAC;IACN,QAAQ,CAAS;IACjB,SAAS,CAAS;IAEnC;;;;;OAKG;IACH,YAAY,QAAQ,GAAW,cAAc,EAAE,SAAS,GAAG,EAAE;QAC3D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,gFAAgF;IAChF,IAAI,CAAC,IAAY;QACf,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ;YACzB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC;YACzC,CAAC,CAAC,IAAI,CAAC;QACX,IAAI,CAAC,UAAU;YACb,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;YACpC,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/cli.d.ts

@@ -1,30 +0,0 @@
-import { Command } from "@effect/cli";
-import { FileSystem } from "@effect/platform";
-import { Effect } from "effect";
-import { Display } from "./Display.js";
-import { ConfigDirError, InitError } from "./errors.js";
-export declare const sandcastle: Command.Command<"sandcastle", Display | FileSystem.FileSystem, ConfigDirError | import("./errors.js").DockerError | InitError | import("./errors.js").PodmanError, {
-    readonly subcommand: import("effect/Option").Option<{
-        readonly imageName: import("effect/Option").Option<string>;
-        readonly template: import("effect/Option").Option<string>;
-        readonly agent: import("effect/Option").Option<string>;
-        readonly model: import("effect/Option").Option<string>;
-        readonly sandbox: import("effect/Option").Option<string>;
-    } | {
-        readonly subcommand: import("effect/Option").Option<{
-            readonly imageName: import("effect/Option").Option<string>;
-            readonly dockerfile: import("effect/Option").Option<string>;
-        } | {
-            readonly imageName: import("effect/Option").Option<string>;
-        }>;
-    } | {
-        readonly subcommand: import("effect/Option").Option<{
-            readonly imageName: import("effect/Option").Option<string>;
-            readonly containerfile: import("effect/Option").Option<string>;
-        } | {
-            readonly imageName: import("effect/Option").Option<string>;
-        }>;
-    }>;
-}>;
-export declare const cli: (args: readonly string[]) => Effect.Effect<void, ConfigDirError | import("./errors.js").DockerError | InitError | import("./errors.js").PodmanError | import("@effect/cli/ValidationError").ValidationError, Display | import("@effect/cli/CliApp").CliApp.Environment>;
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAW,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAOhC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA2BvC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAohBxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;EAEtB,CAAC;AAEF,eAAO,MAAM,GAAG,yQAGd,CAAC"}