@ai-hero/sandcastle 0.0.1

package/dist/templates/sequential-reviewer/implement-prompt.md

@@ -0,0 +1,62 @@
+# TASK
+
+Fix issue #{{ISSUE_NUMBER}}: {{ISSUE_TITLE}}
+
+Pull in the issue using `gh issue view`. If it has a parent PRD, pull that in too.
+
+Only work on the issue specified.
+
+Work on branch {{BRANCH}}. Make commits, run tests, and close the issue when done.
+
+# CONTEXT
+
+Here are the last 10 commits:
+
+<recent-commits>
+
+!`git log -n 10 --format="%H%n%ad%n%B---" --date=short`
+
+</recent-commits>
+
+# EXPLORATION
+
+Explore the repo and fill your context window with relevant information that will allow you to complete the task.
+
+Pay extra attention to test files that touch the relevant parts of the code.
+
+# EXECUTION
+
+If applicable, use RGR to complete the task.
+
+1. RED: write one test
+2. GREEN: write the implementation to pass that test
+3. REPEAT until done
+4. REFACTOR the code
+
+# FEEDBACK LOOPS
+
+Before committing, run `npm run typecheck` and `npm run test` to ensure the tests pass.
+
+# COMMIT
+
+Make a git commit. The commit message must:
+
+1. Start with `RALPH:` prefix
+2. Include task completed + PRD reference
+3. Key decisions made
+4. Files changed
+5. Blockers or notes for next iteration
+
+Keep it concise.
+
+# THE ISSUE
+
+If the task is not complete, leave a comment on the GitHub issue with what was done.
+
+Do not close the issue - this will be done later.
+
+Once complete, output <promise>COMPLETE</promise>.
+
+# FINAL RULES
+
+ONLY WORK ON A SINGLE TASK.

package/dist/templates/sequential-reviewer/main.ts

@@ -0,0 +1,102 @@
+// Sequential Reviewer — implement-then-review loop
+//
+// This template drives a two-phase workflow per issue:
+//   Phase 1 (Implement): A sonnet agent picks an open GitHub issue, works on it
+//                        on a dedicated branch, commits the changes, and signals
+//                        completion.
+//   Phase 2 (Review):    A second sonnet agent reviews the branch diff and either
+//                        approves it or makes corrections directly on the branch.
+//
+// The outer loop repeats up to MAX_ITERATIONS times, processing one issue per
+// iteration. This is a middle-complexity option between the simple-loop (no review
+// gate) and the parallel-planner (concurrent execution with a planning phase).
+//
+// Usage:
+//   npx tsx .sandcastle/main.ts
+// Or add to package.json:
+//   "scripts": { "sandcastle": "npx tsx .sandcastle/main.ts" }
+
+import * as sandcastle from "@ai-hero/sandcastle";
+
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+
+// Maximum number of implement→review cycles to run before stopping.
+// Each cycle works on one issue. Raise this to process more issues per run.
+const MAX_ITERATIONS = 10;
+
+// Hooks run inside the sandbox before the agent starts each iteration.
+// npm install ensures the sandbox always has fresh dependencies.
+const hooks = {
+  onSandboxReady: [{ command: "npm install" }],
+};
+
+// Copy node_modules from the host into the worktree before each sandbox
+// starts. Avoids a full npm install from scratch; the hook above handles
+// platform-specific binaries and any packages added since the last copy.
+const copyToSandbox = ["node_modules"];
+
+// ---------------------------------------------------------------------------
+// Main loop
+// ---------------------------------------------------------------------------
+
+for (let iteration = 1; iteration <= MAX_ITERATIONS; iteration++) {
+  console.log(`\n=== Iteration ${iteration}/${MAX_ITERATIONS} ===\n`);
+
+  // -------------------------------------------------------------------------
+  // Phase 1: Implement
+  //
+  // A sonnet agent picks the next open GitHub issue, creates a branch, writes
+  // the implementation (using RGR: Red → Green → Repeat → Refactor), and
+  // commits the result.
+  //
+  // The agent signals completion via <promise>COMPLETE</promise> when done.
+  // The result contains the branch name the agent worked on.
+  // -------------------------------------------------------------------------
+  const implement = await sandcastle.run({
+    hooks,
+    copyToSandbox,
+    name: "implementer",
+    maxIterations: 100,
+    model: "claude-sonnet-4-6",
+    promptFile: "./.sandcastle/implement-prompt.md",
+  });
+
+  // Extract the branch the agent worked on so the reviewer can target it.
+  const branch = implement.branch;
+
+  if (!implement.commits.length) {
+    console.log("Implementation agent made no commits. Skipping review.");
+    continue;
+  }
+
+  console.log(`\nImplementation complete on branch: ${branch}`);
+  console.log(`Commits: ${implement.commits.length}`);
+
+  // -------------------------------------------------------------------------
+  // Phase 2: Review
+  //
+  // A second sonnet agent reviews the diff of the branch produced by Phase 1.
+  // It uses the {{BRANCH}} prompt argument to inspect the right branch, and
+  // either approves or makes corrections directly on the branch.
+  // -------------------------------------------------------------------------
+  await sandcastle.run({
+    hooks,
+    copyToSandbox,
+    name: "reviewer",
+    maxIterations: 10,
+    model: "claude-sonnet-4-6",
+    promptFile: "./.sandcastle/review-prompt.md",
+    // Prompt arguments substitute {{BRANCH}} in review-prompt.md before the
+    // agent sees the prompt.
+    promptArgs: {
+      BRANCH: branch,
+    },
+    branch,
+  });
+
+  console.log("\nReview complete.");
+}
+
+console.log("\nAll done.");

package/dist/templates/sequential-reviewer/review-prompt.md

@@ -0,0 +1,43 @@
+# TASK
+
+Review the code changes on branch `{{BRANCH}}` and provide actionable feedback.
+
+# CONTEXT
+
+## Branch diff
+
+!`git diff main...{{BRANCH}}`
+
+## Commits on this branch
+
+!`git log main..{{BRANCH}} --oneline`
+
+# REVIEW CHECKLIST
+
+Examine the diff above and assess:
+
+1. **Correctness** — Does the implementation match the intent of the issue? Are edge cases handled?
+2. **Tests** — Are the new/changed behaviours covered by tests? Do the tests actually exercise the right code paths?
+3. **Code quality** — Is the code clear, minimal, and consistent with the surrounding codebase? No dead code or unnecessary complexity?
+4. **Type safety** — Are there any unsafe casts, `any` types, or unchecked assumptions?
+5. **Security** — Does the change introduce injection vulnerabilities, credential leaks, or other security issues?
+
+# OUTPUT
+
+If the branch is acceptable:
+
+```
+REVIEW RESULT: APPROVED
+
+<summary of what the implementation does and why it looks good>
+```
+
+If changes are needed, make them directly on the branch, then commit and output:
+
+```
+REVIEW RESULT: CHANGES MADE
+
+<summary of what was changed and why>
+```
+
+Once your review is complete, output <promise>COMPLETE</promise>.

package/dist/templates/sequential-reviewer/template.json

@@ -0,0 +1,4 @@
+{
+  "name": "sequential-reviewer",
+  "description": "Implements issues one by one, with a code review step after each"
+}

package/dist/templates/simple-loop/main.ts

@@ -0,0 +1,37 @@
+import { run } from "@ai-hero/sandcastle";
+
+// Simple loop: an agent that picks open GitHub issues one by one and closes them.
+// Run this with: npx tsx .sandcastle/main.ts
+// Or add to package.json scripts: "sandcastle": "npx tsx .sandcastle/main.ts"
+
+await run({
+  // A name for this run, shown as a prefix in log output.
+  name: "worker",
+
+  // Path to the prompt file. Shell expressions inside are evaluated inside the
+  // sandbox at the start of each iteration, so the agent always sees fresh data.
+  promptFile: "./.sandcastle/prompt.md",
+
+  // Maximum number of iterations (agent invocations) to run in a session.
+  // Each iteration works on a single issue. Increase this to process more issues
+  // per run, or set it to 1 for a single-shot mode.
+  maxIterations: 3,
+
+  // The Claude model to use. Sonnet balances capability and speed for most tasks.
+  // Switch to claude-opus-4-6 for harder problems, or claude-haiku-4-5 for speed.
+  model: "claude-sonnet-4-6",
+
+  // Copy node_modules from the host into the worktree before the sandbox
+  // starts. This avoids a full npm install from scratch on every iteration.
+  // The onSandboxReady hook still runs npm install as a safety net to handle
+  // platform-specific binaries and any packages added since the last copy.
+  copyToSandbox: ["node_modules"],
+
+  // Lifecycle hooks — commands that run inside the sandbox at specific points.
+  hooks: {
+    // onSandboxReady runs once after the sandbox is initialised and the repo is
+    // synced in, before the agent starts. Use it to install dependencies or run
+    // any other setup steps your project needs.
+    onSandboxReady: [{ command: "npm install" }],
+  },
+});

package/dist/templates/simple-loop/prompt.md

@@ -0,0 +1,51 @@
+# Context
+
+## Open issues
+
+!`gh issue list --json number,title,body --limit 20`
+
+## Recent RALPH commits (last 10)
+
+!`git log --oneline --grep="RALPH" -10`
+
+# Task
+
+You are RALPH — an autonomous coding agent working through GitHub issues one at a time.
+
+## Priority order
+
+Work on issues in this order:
+
+1. **Bug fixes** — broken behaviour affecting users
+2. **Tracer bullets** — thin end-to-end slices that prove an approach works
+3. **Polish** — improving existing functionality (error messages, UX, docs)
+4. **Refactors** — internal cleanups with no user-visible change
+
+Pick the highest-priority open issue that is not blocked by another open issue.
+
+## Workflow
+
+1. **Explore** — read the issue carefully. Pull in the parent PRD if referenced. Read the relevant source files and tests before writing any code.
+2. **Plan** — decide what to change and why. Keep the change as small as possible.
+3. **Execute** — use RGR (Red → Green → Repeat → Refactor): write a failing test first, then write the implementation to pass it.
+4. **Verify** — run `npm run typecheck` and `npm run test` before committing. Fix any failures before proceeding.
+5. **Commit** — make a single git commit. The message MUST:
+   - Start with `RALPH:` prefix
+   - Include the task completed and any PRD reference
+   - List key decisions made
+   - List files changed
+   - Note any blockers for the next iteration
+6. **Close** — close the issue with `gh issue close <number> --comment "..."` explaining what was done.
+
+## Rules
+
+- Work on **one issue per iteration**. Do not attempt multiple issues in a single iteration.
+- Do not close an issue until you have committed the fix and verified tests pass.
+- Do not leave commented-out code or TODO comments in committed code.
+- If you are blocked (missing context, failing tests you cannot fix, external dependency), leave a comment on the issue and move on — do not close it.
+
+# Done
+
+When all actionable issues are complete (or you are blocked on all remaining ones), output the completion signal:
+
+<promise>COMPLETE</promise>

package/dist/templates/simple-loop/template.json

@@ -0,0 +1,4 @@
+{
+  "name": "simple-loop",
+  "description": "Picks GitHub issues one by one and closes them"
+}

package/dist/templates.d.ts

@@ -0,0 +1,2 @@
+export declare const SKELETON_PROMPT: string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,QAyB3B,CAAC"}

package/dist/templates.js

@@ -0,0 +1,26 @@
+export const SKELETON_PROMPT = `# Context
+
+<!-- Use !` +
+    "`" +
+    `command` +
+    "`" +
+    ` to pull in dynamic context. Commands run inside the sandbox. -->
+<!-- Example: !` +
+    "`" +
+    `git log --oneline -10` +
+    "`" +
+    ` or !` +
+    "`" +
+    `gh issue list --json number,title` +
+    "`" +
+    ` -->
+
+# Task
+
+<!-- Describe what the agent should do. -->
+
+# Done
+
+<!-- When the task is complete, output <promise>COMPLETE</promise> to signal early termination. -->
+`;
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAC1B;;WAES;IACT,GAAG;IACH,SAAS;IACT,GAAG;IACH;gBACc;IACd,GAAG;IACH,uBAAuB;IACvB,GAAG;IACH,OAAO;IACP,GAAG;IACH,mCAAmC;IACnC,GAAG;IACH;;;;;;;;;CASD,CAAC"}

package/dist/terminalCleanup.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Terminal cleanup for abrupt exits.
+ *
+ * @clack/prompts' spinner and taskLog call stdin.setRawMode(true) and hide
+ * the cursor via escape sequences. When the process is killed by a signal
+ * handler that calls process.exit() directly (e.g. during Ctrl-C cleanup in
+ * SandboxFactory), clack's own cleanup is bypassed and the terminal is left
+ * in raw mode with the cursor hidden.
+ *
+ * Registering a process 'exit' listener that restores these guarantees the
+ * terminal is always left in a usable state.
+ */
+/** Escape sequence to show the cursor (DECTCEM). */
+export declare const SHOW_CURSOR = "\u001B[?25h";
+/**
+ * Creates a synchronous exit handler that restores terminal state.
+ * Extracted as a pure function so it can be unit-tested without side effects.
+ */
+export declare const makeTerminalCleanupHandler: (stdin: {
+    isTTY?: boolean | undefined;
+    setRawMode?: ((raw: boolean) => void) | undefined;
+}, stdout: {
+    write: (data: string) => boolean;
+}) => () => void;
+/**
+ * Registers the terminal cleanup handler on process 'exit'.
+ * Call once at program startup (main.ts).
+ */
+export declare const setupTerminalCleanup: () => void;
+//# sourceMappingURL=terminalCleanup.d.ts.map

package/dist/terminalCleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalCleanup.d.ts","sourceRoot":"","sources":["../src/terminalCleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oDAAoD;AACpD,eAAO,MAAM,WAAW,gBAAc,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;gBAcpC,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,oBAAoB,YAEhC,CAAC"}

package/dist/terminalCleanup.js

@@ -0,0 +1,37 @@
+/**
+ * Terminal cleanup for abrupt exits.
+ *
+ * @clack/prompts' spinner and taskLog call stdin.setRawMode(true) and hide
+ * the cursor via escape sequences. When the process is killed by a signal
+ * handler that calls process.exit() directly (e.g. during Ctrl-C cleanup in
+ * SandboxFactory), clack's own cleanup is bypassed and the terminal is left
+ * in raw mode with the cursor hidden.
+ *
+ * Registering a process 'exit' listener that restores these guarantees the
+ * terminal is always left in a usable state.
+ */
+/** Escape sequence to show the cursor (DECTCEM). */
+export const SHOW_CURSOR = "\x1b[?25h";
+/**
+ * Creates a synchronous exit handler that restores terminal state.
+ * Extracted as a pure function so it can be unit-tested without side effects.
+ */
+export const makeTerminalCleanupHandler = (stdin, stdout) => () => {
+    if (stdin.isTTY && stdin.setRawMode) {
+        try {
+            stdin.setRawMode(false);
+        }
+        catch {
+            // Best-effort — may fail if stdin is already closed
+        }
+    }
+    stdout.write(SHOW_CURSOR);
+};
+/**
+ * Registers the terminal cleanup handler on process 'exit'.
+ * Call once at program startup (main.ts).
+ */
+export const setupTerminalCleanup = () => {
+    process.on("exit", makeTerminalCleanupHandler(process.stdin, process.stdout));
+};
+//# sourceMappingURL=terminalCleanup.js.map

package/dist/terminalCleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalCleanup.js","sourceRoot":"","sources":["../src/terminalCleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GACrC,CACE,KAA+D,EAC/D,MAA4C,EAC5C,EAAE,CACJ,GAAS,EAAE;IACT,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEJ;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAS,EAAE;IAC7C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,0BAA0B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAChF,CAAC,CAAC"}

package/dist/testSandbox.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Test helper: creates a local (filesystem-based) Sandbox layer for unit tests.
+ * This replaces FilesystemSandbox which has been removed.
+ */
+import { Layer } from "effect";
+import { Sandbox } from "./SandboxFactory.js";
+export declare const makeLocalSandboxLayer: (sandboxDir: string) => Layer.Layer<Sandbox, never, never>;
+//# sourceMappingURL=testSandbox.d.ts.map

package/dist/testSandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testSandbox.d.ts","sourceRoot":"","sources":["../src/testSandbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAQvC,OAAO,EAAmB,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAa/D,eAAO,MAAM,qBAAqB,4DA8GjC,CAAC"}

package/dist/testSandbox.js

@@ -0,0 +1,101 @@
+/**
+ * Test helper: creates a local (filesystem-based) Sandbox layer for unit tests.
+ * This replaces FilesystemSandbox which has been removed.
+ */
+import { Effect, Layer } from "effect";
+import { execFile, spawn } from "node:child_process";
+import { copyFile, mkdir } from "node:fs/promises";
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { createInterface } from "node:readline";
+import { CopyError, ExecError } from "./errors.js";
+import { Sandbox } from "./SandboxFactory.js";
+/**
+ * Creates an isolated git global config env so that test sandbox
+ * `git config --global` writes don't corrupt the developer's real ~/.gitconfig.
+ */
+const createIsolatedGitEnv = () => {
+    const tmpDir = mkdtempSync(join(tmpdir(), "test-gitconfig-"));
+    const globalConfigPath = join(tmpDir, ".gitconfig");
+    writeFileSync(globalConfigPath, "");
+    return { GIT_CONFIG_GLOBAL: globalConfigPath };
+};
+export const makeLocalSandboxLayer = (sandboxDir) => {
+    const gitEnv = createIsolatedGitEnv();
+    const env = { ...process.env, ...gitEnv };
+    return Layer.succeed(Sandbox, {
+        exec: (command, options) => Effect.async((resume) => {
+            execFile("sh", ["-c", command], {
+                cwd: options?.cwd ?? sandboxDir,
+                maxBuffer: 10 * 1024 * 1024,
+                env,
+            }, (error, stdout, stderr) => {
+                if (error && error.code === undefined) {
+                    resume(Effect.fail(new ExecError({
+                        command,
+                        message: `Failed to exec: ${error.message}`,
+                    })));
+                }
+                else {
+                    resume(Effect.succeed({
+                        stdout: stdout.toString(),
+                        stderr: stderr.toString(),
+                        exitCode: typeof error?.code === "number"
+                            ? error.code
+                            : 0,
+                    }));
+                }
+            });
+        }),
+        execStreaming: (command, onStdoutLine, options) => Effect.async((resume) => {
+            const proc = spawn("sh", ["-c", command], {
+                cwd: options?.cwd ?? sandboxDir,
+                stdio: ["ignore", "pipe", "pipe"],
+                env,
+            });
+            const stdoutChunks = [];
+            const stderrChunks = [];
+            const rl = createInterface({ input: proc.stdout });
+            rl.on("line", (line) => {
+                stdoutChunks.push(line);
+                onStdoutLine(line);
+            });
+            proc.stderr.on("data", (chunk) => {
+                stderrChunks.push(chunk.toString());
+            });
+            proc.on("error", (error) => {
+                resume(Effect.fail(new ExecError({
+                    command,
+                    message: `Failed to exec: ${error.message}`,
+                })));
+            });
+            proc.on("close", (code) => {
+                resume(Effect.succeed({
+                    stdout: stdoutChunks.join("\n"),
+                    stderr: stderrChunks.join(""),
+                    exitCode: code ?? 0,
+                }));
+            });
+        }),
+        copyIn: (hostPath, sandboxPath) => Effect.tryPromise({
+            try: async () => {
+                await mkdir(dirname(sandboxPath), { recursive: true });
+                await copyFile(hostPath, sandboxPath);
+            },
+            catch: (e) => new CopyError({
+                message: `Failed to copy ${hostPath} -> ${sandboxPath}: ${e}`,
+            }),
+        }),
+        copyOut: (sandboxPath, hostPath) => Effect.tryPromise({
+            try: async () => {
+                await mkdir(dirname(hostPath), { recursive: true });
+                await copyFile(sandboxPath, hostPath);
+            },
+            catch: (e) => new CopyError({
+                message: `Failed to copy ${sandboxPath} -> ${hostPath}: ${e}`,
+            }),
+        }),
+    });
+};
+//# sourceMappingURL=testSandbox.js.map

package/dist/testSandbox.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@ai-hero/sandcastle",
+  "version": "0.0.1",
+  "description": "CLI for orchestrating AI agents in isolated sandbox environments",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "sandcastle": "dist/main.js"
+  },
+  "scripts": {
+    "build": "tsgo --project tsconfig.build.json",
+    "postbuild": "rm -rf dist/templates && cp -r src/templates dist/templates",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsgo --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepare": "husky",
+    "release": "changeset publish",
+    "run-sandcastle": "tsx .sandcastle/run.ts"
+  },
+  "keywords": [
+    "cli",
+    "sandbox",
+    "docker",
+    "ai",
+    "agent"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@changesets/cli": "^2.30.0",
+    "@effect/vitest": "^0.28.0",
+    "@typescript/native-preview": "^7.0.0-dev.20260317.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.5.1",
+    "prettier": "^3.5.3",
+    "tsx": "^4.21.0",
+    "vitest": "^3.2.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "@effect/cli": "^0.74.0",
+    "@effect/platform": "^0.95.0",
+    "@effect/platform-node": "^0.105.0",
+    "@effect/printer": "^0.48.0",
+    "@effect/printer-ansi": "^0.48.0",
+    "effect": "^3.20.0"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,json,md}": "prettier --write"
+  },
+  "files": [
+    "dist"
+  ]
+}