@ai-hero/sandcastle 0.6.4 → 0.6.6

package/dist/cli.js

@@ -1,309 +0,0 @@
-import { Command, Options } from "@effect/cli";
-import { FileSystem } from "@effect/platform";
-import { Effect } from "effect";
-import * as clack from "@clack/prompts";
-import { execSync } from "node:child_process";
-import { createRequire } from "node:module";
-import { join } from "node:path";
-import { styleText } from "node:util";
-import { Display } from "./Display.js";
-import { buildImage, removeImage } from "./DockerLifecycle.js";
-import { buildImage as podmanBuildImage, removeImage as podmanRemoveImage, } from "./PodmanLifecycle.js";
-import { scaffold, listTemplates, listAgents, getAgent, listIssueTrackers, getIssueTracker, listSandboxProviders, getSandboxProvider, getNextStepsLines, } from "./InitService.js";
-import { defaultImageName } from "./sandboxes/docker.js";
-import { ConfigDirError, InitError } from "./errors.js";
-const require = createRequire(import.meta.url);
-const VERSION = require("../package.json").version;
-// --- Shared options ---
-const imageNameOption = Options.text("image-name").pipe(Options.withDescription("Docker image name"), Options.optional);
-const resolveImageName = (cliFlag, cwd) => (cliFlag._tag === "Some" ? cliFlag.value : defaultImageName(cwd));
-// --- UID build-args ---
-/** Build-args that align the image UID/GID to the host (Linux/macOS). No-op on Windows. */
-const defaultUidBuildArgs = () => {
-    const args = {};
-    const uid = process.getuid?.();
-    const gid = process.getgid?.();
-    if (uid !== undefined)
-        args.AGENT_UID = String(uid);
-    if (gid !== undefined)
-        args.AGENT_GID = String(gid);
-    return args;
-};
-// --- Config directory check ---
-const CONFIG_DIR = ".sandcastle";
-const requireConfigDir = (cwd) => Effect.gen(function* () {
-    const fs = yield* FileSystem.FileSystem;
-    const exists = yield* fs
-        .exists(join(cwd, CONFIG_DIR))
-        .pipe(Effect.catchAll(() => Effect.succeed(false)));
-    if (!exists) {
-        yield* Effect.fail(new ConfigDirError({
-            message: "No .sandcastle/ found. Run `sandcastle init` first.",
-        }));
-    }
-});
-// --- Init command ---
-const templateOption = Options.text("template").pipe(Options.withDescription("Template to scaffold (e.g. blank, simple-loop, parallel-planner)"), Options.optional);
-const agentOption = Options.text("agent").pipe(Options.withDescription("Agent to use (e.g. claude-code)"), Options.optional);
-const initModelOption = Options.text("model").pipe(Options.withDescription("Model to use for the agent (e.g. claude-sonnet-4-6). Defaults to the agent's default model"), Options.optional);
-const sandboxOption = Options.text("sandbox").pipe(Options.withDescription("Sandbox provider to use (e.g. docker, podman)"), Options.optional);
-const initCommand = Command.make("init", {
-    imageName: imageNameOption,
-    template: templateOption,
-    agent: agentOption,
-    model: initModelOption,
-    sandbox: sandboxOption,
-}, ({ imageName: imageNameFlag, template, agent: agentFlag, model: modelFlag, sandbox: sandboxFlag, }) => Effect.gen(function* () {
-    const d = yield* Display;
-    const cwd = process.cwd();
-    const imageName = resolveImageName(imageNameFlag, cwd);
-    // Early validation of CLI flags before interactive prompts
-    const templates = listTemplates();
-    if (template._tag === "Some") {
-        const valid = templates.find((tmpl) => tmpl.name === template.value);
-        if (!valid) {
-            const names = templates.map((tmpl) => tmpl.name).join(", ");
-            yield* Effect.fail(new InitError({
-                message: `Unknown template "${template.value}". Available: ${names}`,
-            }));
-        }
-    }
-    if (sandboxFlag._tag === "Some") {
-        const valid = getSandboxProvider(sandboxFlag.value);
-        if (!valid) {
-            const names = listSandboxProviders()
-                .map((p) => p.name)
-                .join(", ");
-            yield* Effect.fail(new InitError({
-                message: `Unknown sandbox provider "${sandboxFlag.value}". Available: ${names}`,
-            }));
-        }
-    }
-    // Resolve agent: CLI flag > interactive select
-    const agents = listAgents();
-    let selectedAgent;
-    if (agentFlag._tag === "Some") {
-        const entry = getAgent(agentFlag.value);
-        if (!entry) {
-            const names = agents.map((a) => a.name).join(", ");
-            yield* Effect.fail(new InitError({
-                message: `Unknown agent "${agentFlag.value}". Available: ${names}`,
-            }));
-        }
-        selectedAgent = entry;
-    }
-    else {
-        const selected = yield* Effect.promise(() => clack.select({
-            message: "Select an agent:",
-            initialValue: "claude-code",
-            options: agents.map((a) => ({
-                value: a.name,
-                label: a.label,
-                hint: `Default model: ${a.defaultModel}`,
-            })),
-        }));
-        if (clack.isCancel(selected)) {
-            yield* Effect.fail(new InitError({ message: "Agent selection cancelled." }));
-        }
-        selectedAgent = getAgent(selected);
-    }
-    // Resolve model: CLI flag > agent default
-    const selectedModel = modelFlag._tag === "Some"
-        ? modelFlag.value
-        : selectedAgent.defaultModel;
-    // Resolve sandbox provider: CLI flag > interactive select (no default — user must choose)
-    const sandboxProviders = listSandboxProviders();
-    let selectedSandboxProvider;
-    if (sandboxFlag._tag === "Some") {
-        selectedSandboxProvider = getSandboxProvider(sandboxFlag.value);
-    }
-    else {
-        const selected = yield* Effect.promise(() => clack.select({
-            message: "Select a sandbox provider:",
-            options: sandboxProviders.map((p) => ({
-                value: p.name,
-                label: p.label,
-            })),
-        }));
-        if (clack.isCancel(selected)) {
-            yield* Effect.fail(new InitError({
-                message: "Sandbox provider selection cancelled.",
-            }));
-        }
-        selectedSandboxProvider = getSandboxProvider(selected);
-    }
-    // Resolve issue tracker: interactive select
-    const issueTrackers = listIssueTrackers();
-    let selectedIssueTracker;
-    {
-        const selected = yield* Effect.promise(() => clack.select({
-            message: "Select an issue tracker:",
-            initialValue: "github-issues",
-            options: issueTrackers.map((b) => ({
-                value: b.name,
-                label: b.label,
-            })),
-        }));
-        if (clack.isCancel(selected)) {
-            yield* Effect.fail(new InitError({
-                message: "Issue tracker selection cancelled.",
-            }));
-        }
-        selectedIssueTracker = getIssueTracker(selected);
-    }
-    // Resolve template: CLI flag > interactive select (already validated above)
-    let selectedTemplate;
-    if (template._tag === "Some") {
-        selectedTemplate = template.value;
-    }
-    else {
-        const selected = yield* Effect.promise(() => clack.select({
-            message: "Select a template:",
-            initialValue: "blank",
-            options: templates.map((tmpl) => ({
-                value: tmpl.name,
-                label: tmpl.name,
-                hint: tmpl.description,
-            })),
-        }));
-        if (clack.isCancel(selected)) {
-            yield* Effect.fail(new InitError({ message: "Template selection cancelled." }));
-        }
-        selectedTemplate = selected;
-    }
-    // Offer to create the "Sandcastle" label on the repo (skip for non-GitHub issue trackers)
-    let shouldCreateLabel = false;
-    if (selectedIssueTracker.name === "github-issues") {
-        shouldCreateLabel = yield* Effect.promise(() => clack.confirm({
-            message: 'Create a "Sandcastle" GitHub label? (Templates filter issues by this label)',
-            initialValue: true,
-        }));
-        if (shouldCreateLabel === true) {
-            yield* Effect.try({
-                try: () => execSync('gh label create "Sandcastle" --description "Issues for Sandcastle to work on" --color "F9A825" 2>/dev/null', { cwd, stdio: "ignore" }),
-                catch: () => undefined,
-            }).pipe(Effect.ignore);
-        }
-    }
-    const scaffoldResult = yield* d.spinner("Scaffolding .sandcastle/ config directory...", scaffold(cwd, {
-        agent: selectedAgent,
-        model: selectedModel,
-        templateName: selectedTemplate,
-        createLabel: shouldCreateLabel === true,
-        issueTracker: selectedIssueTracker,
-        sandboxProvider: selectedSandboxProvider,
-    }).pipe(Effect.mapError((e) => new InitError({
-        message: `${e instanceof Error ? e.message : e}`,
-    }))));
-    // Prompt user before building image. The custom issue tracker scaffolds
-    // an intentionally unfinished Dockerfile (the install block is a TODO),
-    // so there is nothing valid to build yet — skip the build prompt entirely
-    // and let the next steps point the user at the setup doc.
-    const providerLabel = selectedSandboxProvider.label;
-    if (selectedIssueTracker.name === "custom") {
-        yield* d.status("Init complete! Your custom issue tracker isn't configured yet — see the steps below before building.", "success");
-    }
-    else {
-        const shouldBuild = yield* Effect.promise(() => clack.confirm({
-            message: `Build the default ${providerLabel} image now?`,
-            initialValue: true,
-        }));
-        if (shouldBuild === true) {
-            const containerfileDir = join(cwd, CONFIG_DIR);
-            if (selectedSandboxProvider.name === "podman") {
-                yield* d.spinner(`Building ${providerLabel} image '${imageName}'...`, podmanBuildImage(imageName, containerfileDir));
-            }
-            else {
-                yield* d.spinner(`Building ${providerLabel} image '${imageName}'...`, buildImage(imageName, containerfileDir, {
-                    buildArgs: defaultUidBuildArgs(),
-                }));
-            }
-            yield* d.status("Init complete! Image built successfully.", "success");
-        }
-        else {
-            yield* d.status(`Init complete! Run \`sandcastle ${selectedSandboxProvider.cliNamespace} build-image\` to build the ${providerLabel} image later.`, "success");
-        }
-    }
-    // Show template-specific next steps
-    const nextSteps = getNextStepsLines(selectedTemplate, scaffoldResult.mainFilename, selectedIssueTracker, selectedAgent);
-    for (const [i, line] of nextSteps.entries()) {
-        yield* d.text(i === 0 ? line : styleText("dim", line));
-    }
-}));
-// --- Build-image command ---
-const dockerfileOption = Options.file("dockerfile").pipe(Options.withDescription("Path to a custom Dockerfile (build context will be the current working directory)"), Options.optional);
-const buildImageCommand = Command.make("build-image", {
-    imageName: imageNameOption,
-    dockerfile: dockerfileOption,
-}, ({ imageName: imageNameFlag, dockerfile }) => Effect.gen(function* () {
-    const d = yield* Display;
-    const cwd = process.cwd();
-    yield* requireConfigDir(cwd);
-    const imageName = resolveImageName(imageNameFlag, cwd);
-    const dockerfileDir = join(cwd, CONFIG_DIR);
-    const dockerfilePath = dockerfile._tag === "Some" ? dockerfile.value : undefined;
-    yield* d.spinner(`Building Docker image '${imageName}'...`, buildImage(imageName, dockerfileDir, {
-        dockerfile: dockerfilePath,
-        buildArgs: defaultUidBuildArgs(),
-    }));
-    yield* d.status("Build complete!", "success");
-}));
-// --- Remove-image command ---
-const removeImageCommand = Command.make("remove-image", {
-    imageName: imageNameOption,
-}, ({ imageName: imageNameFlag }) => Effect.gen(function* () {
-    const d = yield* Display;
-    const cwd = process.cwd();
-    const imageName = resolveImageName(imageNameFlag, cwd);
-    yield* d.spinner(`Removing Docker image '${imageName}'...`, removeImage(imageName));
-    yield* d.status("Image removed.", "success");
-}));
-// --- Docker namespace command ---
-const dockerCommand = Command.make("docker", {}, () => Effect.gen(function* () {
-    const d = yield* Display;
-    yield* d.status("Docker sandbox commands. Use --help to see available subcommands.", "info");
-})).pipe(Command.withSubcommands([buildImageCommand, removeImageCommand]));
-// --- Podman build-image command ---
-const containerfileOption = Options.file("containerfile").pipe(Options.withDescription("Path to a custom Containerfile (build context will be the current working directory)"), Options.optional);
-const podmanBuildImageCommand = Command.make("build-image", {
-    imageName: imageNameOption,
-    containerfile: containerfileOption,
-}, ({ imageName: imageNameFlag, containerfile }) => Effect.gen(function* () {
-    const d = yield* Display;
-    const cwd = process.cwd();
-    yield* requireConfigDir(cwd);
-    const imageName = resolveImageName(imageNameFlag, cwd);
-    const containerfileDir = join(cwd, CONFIG_DIR);
-    const containerfilePath = containerfile._tag === "Some" ? containerfile.value : undefined;
-    yield* d.spinner(`Building Podman image '${imageName}'...`, podmanBuildImage(imageName, containerfileDir, {
-        containerfile: containerfilePath,
-    }));
-    yield* d.status("Build complete!", "success");
-}));
-// --- Podman remove-image command ---
-const podmanRemoveImageCommand = Command.make("remove-image", {
-    imageName: imageNameOption,
-}, ({ imageName: imageNameFlag }) => Effect.gen(function* () {
-    const d = yield* Display;
-    const cwd = process.cwd();
-    const imageName = resolveImageName(imageNameFlag, cwd);
-    yield* d.spinner(`Removing Podman image '${imageName}'...`, podmanRemoveImage(imageName));
-    yield* d.status("Image removed.", "success");
-}));
-// --- Podman namespace command ---
-const podmanCommand = Command.make("podman", {}, () => Effect.gen(function* () {
-    const d = yield* Display;
-    yield* d.status("Podman sandbox commands. Use --help to see available subcommands.", "info");
-})).pipe(Command.withSubcommands([podmanBuildImageCommand, podmanRemoveImageCommand]));
-// --- Root command ---
-const rootCommand = Command.make("sandcastle", {}, () => Effect.gen(function* () {
-    const d = yield* Display;
-    yield* d.status(`Sandcastle v${VERSION}`, "info");
-    yield* d.status("Use --help to see available commands.", "info");
-}));
-export const sandcastle = rootCommand.pipe(Command.withSubcommands([initCommand, dockerCommand, podmanCommand]));
-export const cli = Command.run(sandcastle, {
-    name: "sandcastle",
-    version: VERSION,
-});
-//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/createSandbox.d.ts

@@ -1,154 +0,0 @@
-import { Layer } from "effect";
-import type { AgentProvider } from "./AgentProvider.js";
-import { type IterationResult } from "./Orchestrator.js";
-import { type PromptArgs } from "./PromptArgumentSubstitution.js";
-import type { LoggingOption, Timeouts } from "./run.js";
-import { type SandboxHooks } from "./SandboxLifecycle.js";
-import { Sandbox as SandboxTag } from "./SandboxFactory.js";
-import type { SandboxProvider } from "./SandboxProvider.js";
-export interface CreateSandboxOptions {
-    /** Explicit branch for the worktree (required). */
-    readonly branch: string;
-    /**
-     * Ref to fork from when `branch` does not yet exist. Ignored when the branch
-     * already exists. Defaults to `HEAD`.
-     */
-    readonly baseBranch?: string;
-    /** Sandbox provider (e.g. docker({ imageName: "sandcastle:myrepo" })). */
-    readonly sandbox: SandboxProvider;
-    /**
-     * Host repo directory. Replaces `process.cwd()` as the anchor for
-     * `.sandcastle/worktrees/`, `.sandcastle/.env`, and git operations.
-     *
-     * - Relative paths are resolved against `process.cwd()`.
-     * - Absolute paths are used as-is.
-     * - Defaults to `process.cwd()` when omitted.
-     */
-    readonly cwd?: string;
-    /** Lifecycle hooks grouped by execution location (host or sandbox). */
-    readonly hooks?: SandboxHooks;
-    /** Paths relative to the host repo root to copy into the worktree at creation time. */
-    readonly copyToWorktree?: string[];
-    /** Override default timeouts for built-in lifecycle steps. Unset keys keep their defaults. */
-    readonly timeouts?: Timeouts;
-    /** @internal Test-only overrides to bypass the sandbox provider. */
-    readonly _test?: {
-        readonly buildSandboxLayer?: (sandboxDir: string) => Layer.Layer<SandboxTag>;
-    };
-}
-export interface SandboxRunOptions {
-    /** Agent provider to use (e.g. claudeCode("claude-opus-4-7")). */
-    readonly agent: AgentProvider;
-    /** Inline prompt string (mutually exclusive with promptFile). */
-    readonly prompt?: string;
-    /** Path to a prompt file (mutually exclusive with prompt). */
-    readonly promptFile?: string;
-    /** Key-value map for {{KEY}} placeholder substitution in prompts. */
-    readonly promptArgs?: PromptArgs;
-    /** Maximum iterations to run (default: 1). */
-    readonly maxIterations?: number;
-    /** Substring(s) the agent emits to stop the iteration loop early. */
-    readonly completionSignal?: string | string[];
-    /** Idle timeout in seconds. Default: 600. */
-    readonly idleTimeoutSeconds?: number;
-    /** Display name for this run. */
-    readonly name?: string;
-    /** Logging mode. */
-    readonly logging?: LoggingOption;
-    /**
-     * An `AbortSignal` that cancels the run when aborted.
-     *
-     * - Pre-aborted signal rejects immediately without setup.
-     * - Mid-iteration abort kills the in-flight agent subprocess.
-     * - The rejected promise surfaces `signal.reason` verbatim.
-     * - The `Sandbox` handle remains usable after abort — call `.run()` again
-     *   with a fresh signal, or `.close()` to tear down.
-     */
-    readonly signal?: AbortSignal;
-}
-export interface SandboxRunResult {
-    /** Per-iteration results (use `iterations.length` for the count). */
-    readonly iterations: IterationResult[];
-    /** The matched completion signal string, or undefined if none fired. */
-    readonly completionSignal?: string;
-    /** Combined stdout output from all agent iterations. */
-    readonly stdout: string;
-    /** List of commits made by the agent during the run. */
-    readonly commits: {
-        sha: string;
-    }[];
-    /** Path to the log file, if logging was drained to a file. */
-    readonly logFilePath?: string;
-}
-export interface SandboxInteractiveOptions {
-    /** Agent provider to use (e.g. claudeCode("claude-opus-4-7")). */
-    readonly agent: AgentProvider;
-    /** Inline prompt string (mutually exclusive with promptFile). */
-    readonly prompt?: string;
-    /** Path to a prompt file (mutually exclusive with prompt). */
-    readonly promptFile?: string;
-    /** Key-value map for {{KEY}} placeholder substitution in prompts. */
-    readonly promptArgs?: PromptArgs;
-    /** Display name for this interactive session. */
-    readonly name?: string;
-    /**
-     * An `AbortSignal` that cancels the interactive session when aborted.
-     *
-     * - Pre-aborted signal rejects immediately without setup.
-     * - The rejected promise surfaces `signal.reason` verbatim.
-     * - The `Sandbox` handle remains usable after abort.
-     */
-    readonly signal?: AbortSignal;
-}
-export interface SandboxInteractiveResult {
-    /** List of commits made during the interactive session. */
-    readonly commits: {
-        sha: string;
-    }[];
-    /** Exit code of the interactive process. */
-    readonly exitCode: number;
-}
-export interface CloseResult {
-    /** Host path to the preserved worktree, set when the worktree had uncommitted changes. */
-    readonly preservedWorktreePath?: string;
-}
-export interface Sandbox {
-    /** The branch the worktree is on. */
-    readonly branch: string;
-    /** Host path to the worktree. */
-    readonly worktreePath: string;
-    /** Invoke an agent inside the existing sandbox. */
-    run(options: SandboxRunOptions): Promise<SandboxRunResult>;
-    /** Launch an interactive agent session inside the existing sandbox. */
-    interactive(options: SandboxInteractiveOptions): Promise<SandboxInteractiveResult>;
-    /** Tear down the sandbox and worktree. */
-    close(): Promise<CloseResult>;
-    /** Auto teardown via `await using`. */
-    [Symbol.asyncDispose](): Promise<void>;
-}
-/** @internal Options for createSandboxFromWorktree — used by worktree.createSandbox(). */
-export interface CreateSandboxFromWorktreeOptions {
-    readonly branch: string;
-    readonly worktreePath: string;
-    readonly hostRepoDir: string;
-    readonly sandbox: SandboxProvider;
-    readonly hooks?: SandboxHooks;
-    readonly copyToWorktree?: string[];
-    readonly timeouts?: Timeouts;
-    readonly _test?: {
-        readonly buildSandboxLayer?: (sandboxDir: string) => Layer.Layer<SandboxTag>;
-    };
-}
-/**
- * @internal Creates a sandbox backed by an existing worktree.
- * Split ownership: close() tears down the container only, leaving the worktree intact.
- * Used by Worktree.createSandbox().
- */
-export declare const createSandboxFromWorktree: (options: CreateSandboxFromWorktreeOptions) => Promise<Sandbox>;
-/**
- * Eagerly creates a git worktree on the provided explicit branch and starts
- * a sandbox with the worktree bind-mounted. Returns a Sandbox handle that
- * can be reused across multiple `run()` calls.
- */
-export declare const createSandbox: (options: CreateSandboxOptions) => Promise<Sandbox>;
-//# sourceMappingURL=createSandbox.d.ts.map

package/dist/createSandbox.d.ts.map

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