@neurocode-ai/core 1.18.8

package/test/skill/guidance.test.ts

@@ -0,0 +1,144 @@
+import path from "path"
+import { describe, expect } from "bun:test"
+import { Effect, Layer } from "effect"
+import { AgentV2 } from "@neurocode-ai/core/agent"
+import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
+import { AbsolutePath } from "@neurocode-ai/core/schema"
+import { SkillV2 } from "@neurocode-ai/core/skill"
+import { SystemContext } from "@neurocode-ai/core/system-context"
+import { SkillGuidance } from "@neurocode-ai/core/skill/guidance"
+import { it } from "../lib/effect"
+
+const build = AgentV2.ID.make("build")
+const effect = SkillV2.Info.make({
+  name: "effect",
+  description: "Build applications with Effect",
+  location: AbsolutePath.make(path.resolve("/skills/effect/SKILL.md")),
+  content: "Effect guidance",
+})
+const hidden = SkillV2.Info.make({
+  name: "hidden",
+  location: AbsolutePath.make(path.resolve("/skills/hidden/SKILL.md")),
+  content: "Undescribed guidance",
+})
+const denied = SkillV2.Info.make({
+  name: "denied",
+  description: "Must not be advertised",
+  location: AbsolutePath.make(path.resolve("/skills/denied/SKILL.md")),
+  content: "Denied guidance",
+})
+
+const layer = (list: () => SkillV2.Info[]) =>
+  AppNodeBuilder.build(SkillGuidance.node, [
+    [SkillV2.node, Layer.mock(SkillV2.Service, { list: () => Effect.succeed(list()) })],
+  ])
+
+describe("SkillGuidance", () => {
+  it.effect("renders described agent skills and reconciles the complete available list", () => {
+    const agent = AgentV2.Info.make({
+      ...AgentV2.Info.empty(build),
+      permissions: [{ action: "skill", resource: "denied", effect: "deny" }],
+    })
+    let skills = [hidden, denied, effect]
+    return Effect.gen(function* () {
+      const guidance = yield* SkillGuidance.Service
+      const initialized = yield* guidance
+        .load({ id: agent.id, info: agent })
+        .pipe(Effect.flatMap(SystemContext.initialize))
+
+      expect(initialized.baseline).toBe(
+        [
+          "Skills provide specialized instructions and workflows for specific tasks.",
+          "Use the skill tool to load a skill when a task matches its description.",
+          "<available_skills>",
+          "  <skill>",
+          "    <name>effect</name>",
+          "    <description>Build applications with Effect</description>",
+          "  </skill>",
+          "</available_skills>",
+        ].join("\n"),
+      )
+
+      skills = []
+      expect(
+        yield* guidance
+          .load({ id: agent.id, info: agent })
+          .pipe(Effect.flatMap((context) => SystemContext.reconcile(context, initialized.snapshot))),
+      ).toMatchObject({
+        _tag: "Updated",
+        text: expect.stringContaining("No skills are currently available."),
+      })
+    }).pipe(Effect.provide(layer(() => skills)))
+  })
+
+  it.effect("omits guidance when the selected agent denies all skills", () => {
+    const agent = AgentV2.Info.make({
+      ...AgentV2.Info.empty(build),
+      permissions: [{ action: "skill", resource: "*", effect: "deny" }],
+    })
+    return Effect.gen(function* () {
+      const guidance = yield* SkillGuidance.Service
+      expect(
+        yield* guidance.load({ id: agent.id, info: agent }).pipe(Effect.flatMap(SystemContext.initialize)),
+      ).toEqual({
+        baseline: "",
+        snapshot: {},
+      })
+    }).pipe(Effect.provide(layer(() => [effect])))
+  })
+
+  it.effect("omits guidance when a resource-specific denial follows the global denial", () => {
+    const agent = AgentV2.Info.make({
+      ...AgentV2.Info.empty(build),
+      permissions: [
+        { action: "skill", resource: "*", effect: "deny" },
+        { action: "skill", resource: "hidden", effect: "deny" },
+      ],
+    })
+    return Effect.gen(function* () {
+      const guidance = yield* SkillGuidance.Service
+      expect(
+        yield* guidance.load({ id: agent.id, info: agent }).pipe(Effect.flatMap(SystemContext.initialize)),
+      ).toEqual({
+        baseline: "",
+        snapshot: {},
+      })
+    }).pipe(Effect.provide(layer(() => [effect])))
+  })
+
+  it.effect("retains specifically allowed skills after a global denial", () => {
+    const agent = AgentV2.Info.make({
+      ...AgentV2.Info.empty(build),
+      permissions: [
+        { action: "skill", resource: "*", effect: "deny" },
+        { action: "skill", resource: "effect", effect: "allow" },
+      ],
+    })
+    return Effect.gen(function* () {
+      const guidance = yield* SkillGuidance.Service
+      expect(
+        (yield* guidance.load({ id: agent.id, info: agent }).pipe(Effect.flatMap(SystemContext.initialize))).baseline,
+      ).toContain("<name>effect</name>")
+    }).pipe(Effect.provide(layer(() => [effect])))
+  })
+
+  it.effect("omits guidance when a specifically allowed skill is denied again", () => {
+    const agent = AgentV2.Info.make({
+      ...AgentV2.Info.empty(build),
+      permissions: [
+        { action: "skill", resource: "*", effect: "deny" },
+        { action: "skill", resource: "effect", effect: "allow" },
+        { action: "skill", resource: "effect", effect: "deny" },
+      ],
+    })
+    return Effect.gen(function* () {
+      const guidance = yield* SkillGuidance.Service
+      expect(
+        yield* guidance.load({ id: agent.id, info: agent }).pipe(Effect.flatMap(SystemContext.initialize)),
+      ).toEqual({
+        baseline: "",
+        snapshot: {},
+      })
+    }).pipe(Effect.provide(layer(() => [effect])))
+  })
+})

package/test/skill-discovery.test.ts

@@ -0,0 +1,165 @@
+import fs from "fs/promises"
+import path from "path"
+import { describe, expect, test } from "bun:test"
+import { Effect, Layer } from "effect"
+import { HttpClient, HttpClientResponse } from "effect/unstable/http"
+import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
+import { LayerNodePlatform } from "@neurocode-ai/core/effect/app-node-platform"
+import { LayerNode } from "@neurocode-ai/core/effect/layer-node"
+import { Global } from "@neurocode-ai/core/global"
+import { SkillDiscovery } from "@neurocode-ai/core/skill/discovery"
+import { tmpdir } from "./fixture/tmpdir"
+
+const base = "https://skills.example.test/catalog/"
+
+async function pull(skills: unknown[], files: Record<string, string> = {}, cache?: Awaited<ReturnType<typeof tmpdir>>) {
+  const tmp = cache ?? (await tmpdir())
+  const requests: string[] = []
+  const http = Layer.succeed(
+    HttpClient.HttpClient,
+    HttpClient.make((request) =>
+      Effect.sync(() => requests.push(request.url)).pipe(
+        Effect.map(() => {
+          const body = request.url === `${base}index.json` ? JSON.stringify({ skills }) : files[request.url]
+          return HttpClientResponse.fromWeb(
+            request,
+            new Response(body ?? "Not Found", { status: body === undefined ? 404 : 200 }),
+          )
+        }),
+      ),
+    ),
+  )
+  const skillDiscoveryLayer = AppNodeBuilder.build(SkillDiscovery.node, [
+    [LayerNodePlatform.httpClient, http],
+    [Global.node, Global.layerWith({ cache: tmp.path })],
+  ])
+  const directories = await Effect.runPromise(
+    Effect.gen(function* () {
+      return yield* (yield* SkillDiscovery.Service).pull(base)
+    }).pipe(Effect.provide(skillDiscoveryLayer)),
+  )
+  return { tmp, requests, directories }
+}
+
+describe("SkillDiscovery.pull", () => {
+  test("rejects skill name traversal without fetching files", async () => {
+    const result = await pull([{ name: "../outside", files: ["SKILL.md"] }])
+    try {
+      expect(result.directories).toEqual([])
+      expect(result.requests).toEqual([`${base}index.json`])
+      expect(await fs.readdir(result.tmp.path)).toEqual([])
+    } finally {
+      await result.tmp[Symbol.asyncDispose]()
+    }
+  })
+
+  test("rejects file traversal without fetching files", async () => {
+    const result = await pull([{ name: "deploy", files: ["SKILL.md", "../outside.md"] }])
+    try {
+      expect(result.directories).toEqual([])
+      expect(result.requests).toEqual([`${base}index.json`])
+      expect(await fs.readdir(result.tmp.path)).toEqual([])
+    } finally {
+      await result.tmp[Symbol.asyncDispose]()
+    }
+  })
+
+  test("rejects absolute file paths without fetching files", async () => {
+    const result = await pull([{ name: "deploy", files: ["SKILL.md", "/tmp/outside.md"] }])
+    try {
+      expect(result.directories).toEqual([])
+      expect(result.requests).toEqual([`${base}index.json`])
+      expect(await fs.readdir(result.tmp.path)).toEqual([])
+    } finally {
+      await result.tmp[Symbol.asyncDispose]()
+    }
+  })
+
+  test("rejects cross-origin file URLs without fetching files", async () => {
+    const result = await pull([{ name: "deploy", files: ["SKILL.md", "https://evil.example.test/outside.md"] }])
+    try {
+      expect(result.directories).toEqual([])
+      expect(result.requests).toEqual([`${base}index.json`])
+      expect(await fs.readdir(result.tmp.path)).toEqual([])
+    } finally {
+      await result.tmp[Symbol.asyncDispose]()
+    }
+  })
+
+  test("downloads safe nested files under the skill root", async () => {
+    const result = await pull([{ name: "deploy", files: ["SKILL.md", "references/guide.md"] }], {
+      [`${base}deploy/SKILL.md`]: "# Deploy",
+      [`${base}deploy/references/guide.md`]: "# Guide",
+    })
+    try {
+      expect(result.directories).toHaveLength(1)
+      expect(result.requests.toSorted()).toEqual(
+        [`${base}index.json`, `${base}deploy/SKILL.md`, `${base}deploy/references/guide.md`].toSorted(),
+      )
+      expect(await fs.readFile(path.join(result.directories[0], "SKILL.md"), "utf8")).toBe("# Deploy")
+      expect(await fs.readFile(path.join(result.directories[0], "references", "guide.md"), "utf8")).toBe("# Guide")
+    } finally {
+      await result.tmp[Symbol.asyncDispose]()
+    }
+  })
+
+  test("refreshes cached files when the version changes", async () => {
+    const tmp = await tmpdir()
+    try {
+      const first = await pull(
+        [{ name: "deploy", version: "1", files: ["SKILL.md"] }],
+        {
+          [`${base}deploy/SKILL.md`]: "# Old",
+        },
+        tmp,
+      )
+      const second = await pull(
+        [{ name: "deploy", version: "2", files: ["SKILL.md"] }],
+        {
+          [`${base}deploy/SKILL.md`]: "# New",
+        },
+        tmp,
+      )
+
+      expect(await fs.readFile(path.join(first.directories[0], "SKILL.md"), "utf8")).toBe("# New")
+      expect(second.requests).toContain(`${base}deploy/SKILL.md`)
+      const third = await pull(
+        [{ name: "deploy", version: "2", files: ["SKILL.md"] }],
+        { [`${base}deploy/SKILL.md`]: "# Ignored" },
+        tmp,
+      )
+      expect(third.requests).toEqual([`${base}index.json`])
+    } finally {
+      await tmp[Symbol.asyncDispose]()
+    }
+  })
+
+  test("publishes complete updates and removes stale files", async () => {
+    const tmp = await tmpdir()
+    try {
+      const first = await pull(
+        [{ name: "deploy", version: "1", files: ["SKILL.md", "old.md"] }],
+        {
+          [`${base}deploy/SKILL.md`]: "# Old",
+          [`${base}deploy/old.md`]: "old reference",
+        },
+        tmp,
+      )
+      const root = first.directories[0]
+
+      await pull(
+        [{ name: "deploy", version: "2", files: ["SKILL.md", "missing.md"] }],
+        { [`${base}deploy/SKILL.md`]: "# Partial" },
+        tmp,
+      )
+      expect(await fs.readFile(path.join(root, "SKILL.md"), "utf8")).toBe("# Old")
+      expect(await fs.readFile(path.join(root, "old.md"), "utf8")).toBe("old reference")
+
+      await pull([{ name: "deploy", version: "3", files: ["SKILL.md"] }], { [`${base}deploy/SKILL.md`]: "# New" }, tmp)
+      expect(await fs.readFile(path.join(root, "SKILL.md"), "utf8")).toBe("# New")
+      expect(await Bun.file(path.join(root, "old.md")).exists()).toBe(false)
+    } finally {
+      await tmp[Symbol.asyncDispose]()
+    }
+  })
+})

package/test/skill.test.ts

@@ -0,0 +1,125 @@
+import fs from "fs/promises"
+import path from "path"
+import { describe, expect } from "bun:test"
+import { Effect, Layer } from "effect"
+import { AgentV2 } from "@neurocode-ai/core/agent"
+import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
+import { LayerNode } from "@neurocode-ai/core/effect/layer-node"
+import { FSUtil } from "@neurocode-ai/core/fs-util"
+import { AbsolutePath } from "@neurocode-ai/core/schema"
+import { SkillV2 } from "@neurocode-ai/core/skill"
+import { SkillDiscovery } from "@neurocode-ai/core/skill/discovery"
+import { tmpdir } from "./fixture/tmpdir"
+import { testEffect } from "./lib/effect"
+
+const urls = new Map<string, AbsolutePath[]>()
+let pulls = 0
+const discovery = Layer.succeed(
+  SkillDiscovery.Service,
+  SkillDiscovery.Service.of({
+    pull: (url) => {
+      pulls++
+      return Effect.succeed(urls.get(url) ?? [])
+    },
+  }),
+)
+const it = testEffect(
+  AppNodeBuilder.build(LayerNode.group([SkillV2.node, AgentV2.node]), [[SkillDiscovery.node, discovery]]),
+)
+
+function write(directory: string, name: string, description: string) {
+  return fs.writeFile(
+    path.join(directory, name, "SKILL.md"),
+    `---
+name: ${name}
+description: ${description}
+---
+# ${name}`,
+  )
+}
+
+describe("SkillV2", () => {
+  it.live("registers sources and resolves later source precedence", () =>
+    Effect.acquireRelease(
+      Effect.promise(() => tmpdir()),
+      (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
+    ).pipe(
+      Effect.flatMap((tmp) =>
+        Effect.gen(function* () {
+          const first = path.join(tmp.path, "first")
+          const second = path.join(tmp.path, "second")
+          yield* Effect.promise(async () => {
+            await fs.mkdir(path.join(first, "review"), { recursive: true })
+            await fs.mkdir(path.join(second, "review"), { recursive: true })
+            await write(first, "review", "First")
+            await write(second, "review", "Second")
+            await fs.writeFile(path.join(first, "foo.md"), "---\nslash: true\n---\n# foo")
+          })
+
+          const skill = yield* SkillV2.Service
+          yield* skill.transform((editor) => {
+            editor.source({ type: "directory", path: AbsolutePath.make(first) })
+            editor.source({ type: "directory", path: AbsolutePath.make(first) })
+            editor.source({ type: "directory", path: AbsolutePath.make(second) })
+            expect(editor.list()).toEqual([
+              { type: "directory", path: AbsolutePath.make(first) },
+              { type: "directory", path: AbsolutePath.make(second) },
+            ])
+          })
+
+          expect(yield* skill.sources()).toEqual([
+            { type: "directory", path: AbsolutePath.make(first) },
+            { type: "directory", path: AbsolutePath.make(second) },
+          ])
+          expect(yield* skill.list()).toEqual([
+            SkillV2.Info.make({
+              name: "foo",
+              slash: true,
+              location: AbsolutePath.make(path.join(first, "foo.md")),
+              content: "# foo",
+            }),
+            {
+              name: "review",
+              description: "Second",
+              location: AbsolutePath.make(path.join(second, "review", "SKILL.md")),
+              content: "# review",
+            },
+          ])
+        }),
+      ),
+    ),
+  )
+
+  it.live("loads URL sources and filters skills for agents", () =>
+    Effect.acquireRelease(
+      Effect.promise(() => tmpdir()),
+      (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
+    ).pipe(
+      Effect.flatMap((tmp) =>
+        Effect.gen(function* () {
+          yield* Effect.promise(async () => {
+            await fs.mkdir(path.join(tmp.path, "deploy"), { recursive: true })
+            await write(tmp.path, "deploy", "Deploy production")
+          })
+          pulls = 0
+          urls.set("https://example.test/skills/", [AbsolutePath.make(tmp.path)])
+
+          const agents = yield* AgentV2.Service
+          yield* agents.transform((editor) =>
+            editor.update(AgentV2.ID.make("reviewer"), (agent) => {
+              agent.permissions.push({ action: "skill", resource: "deploy", effect: "deny" })
+            }),
+          )
+
+          const skill = yield* SkillV2.Service
+          yield* skill.transform((editor) => editor.source({ type: "url", url: "https://example.test/skills/" }))
+
+          expect((yield* skill.list()).map((item) => item.name)).toEqual(["deploy"])
+          expect((yield* skill.list()).map((item) => item.name)).toEqual(["deploy"])
+          expect(pulls).toBe(1)
+          expect(SkillV2.available(yield* skill.list(), (yield* agents.get(AgentV2.ID.make("reviewer")))!)).toEqual([])
+        }),
+      ),
+    ),
+  )
+})

package/test/snapshot.test.ts

@@ -0,0 +1,178 @@
+import { $ } from "bun"
+import { describe, expect } from "bun:test"
+import fs from "fs/promises"
+import path from "path"
+import { Effect, Layer } from "effect"
+import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
+import { Global } from "@neurocode-ai/core/global"
+import { Location } from "@neurocode-ai/core/location"
+import { AbsolutePath, RelativePath } from "@neurocode-ai/core/schema"
+import { Snapshot } from "@neurocode-ai/core/snapshot"
+import { Hash } from "@neurocode-ai/core/util/hash"
+import { tmpdir } from "./fixture/tmpdir"
+import { testEffect } from "./lib/effect"
+
+describe("Snapshot", () => {
+  testEffect(Layer.empty).live("captures and restores Location-scoped changes", () =>
+    Effect.acquireUseRelease(
+      Effect.promise(() => tmpdir()),
+      (tmp) =>
+        Effect.gen(function* () {
+          const project = path.join(tmp.path, "project")
+          const location = path.join(project, "scope")
+          yield* Effect.promise(async () => {
+            await fs.mkdir(location, { recursive: true })
+            await fs.writeFile(path.join(location, "tracked.txt"), "one\n")
+            await fs.writeFile(path.join(project, "outside.txt"), "outside\n")
+            await $`git init`.cwd(project).quiet()
+            await $`git config core.fsmonitor false`.cwd(project).quiet()
+            await $`git config commit.gpgsign false`.cwd(project).quiet()
+            await $`git config user.email test@neurocode.test`.cwd(project).quiet()
+            await $`git config user.name Test`.cwd(project).quiet()
+            await $`git add .`.cwd(project).quiet()
+            await $`git commit -m initial`.cwd(project).quiet()
+          })
+
+          const layer = snapshotLayer(tmp.path, location)
+          yield* Effect.gen(function* () {
+            const snapshot = yield* Snapshot.Service
+            const before = yield* snapshot.capture()
+            expect(before).toBeDefined()
+            if (!before) return
+
+            yield* Effect.promise(async () => {
+              await fs.writeFile(path.join(location, "tracked.txt"), "two\n")
+              await fs.writeFile(path.join(location, "added.txt"), "added\n")
+              await fs.writeFile(path.join(project, "outside.txt"), "changed outside\n")
+            })
+            const after = yield* snapshot.capture()
+            expect(after).toBeDefined()
+            if (!after) return
+
+            expect(yield* snapshot.files({ from: before, to: after })).toEqual([
+              RelativePath.make("scope/added.txt"),
+              RelativePath.make("scope/tracked.txt"),
+            ])
+            const plan = new Map([[RelativePath.make("scope/tracked.txt"), before]])
+            const preview = yield* snapshot.preview({ files: plan, context: 1 })
+            expect(preview).toHaveLength(1)
+            expect(preview[0]?.path).toBe(RelativePath.make("scope/tracked.txt"))
+            yield* snapshot.restore({ files: plan })
+            expect(yield* read(path.join(location, "tracked.txt"))).toBe("one\n")
+            expect(yield* read(path.join(location, "added.txt"))).toBe("added\n")
+            expect(yield* read(path.join(project, "outside.txt"))).toBe("changed outside\n")
+          }).pipe(Effect.provide(layer))
+        }),
+      (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
+    ),
+  )
+
+  testEffect(Layer.empty).live("treats capture outside Git as unavailable", () =>
+    Effect.acquireUseRelease(
+      Effect.promise(() => tmpdir()),
+      (tmp) =>
+        Effect.gen(function* () {
+          expect(
+            yield* Effect.gen(function* () {
+              const snapshot = yield* Snapshot.Service
+              return yield* snapshot.capture()
+            }).pipe(Effect.provide(snapshotLayer(tmp.path, tmp.path))),
+          ).toBeUndefined()
+        }),
+      (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
+    ),
+  )
+
+  testEffect(Layer.empty).live("isolates snapshot indexes by canonical Git worktree", () =>
+    Effect.acquireUseRelease(
+      Effect.promise(() => tmpdir()),
+      (tmp) =>
+        Effect.gen(function* () {
+          const project = path.join(tmp.path, "project")
+          const linked = path.join(tmp.path, "linked")
+          yield* Effect.promise(async () => {
+            await fs.mkdir(project)
+            await fs.writeFile(path.join(project, "tracked.txt"), "main\n")
+            await $`git init`.cwd(project).quiet()
+            await $`git config core.fsmonitor false`.cwd(project).quiet()
+            await $`git config commit.gpgsign false`.cwd(project).quiet()
+            await $`git config user.email test@neurocode.test`.cwd(project).quiet()
+            await $`git config user.name Test`.cwd(project).quiet()
+            await $`git add .`.cwd(project).quiet()
+            await $`git commit -m initial`.cwd(project).quiet()
+            await $`git worktree add --detach ${linked} HEAD`.cwd(project).quiet()
+          })
+
+          const capture = (directory: string) =>
+            Effect.gen(function* () {
+              const snapshot = yield* Snapshot.Service
+              return yield* snapshot.capture()
+            }).pipe(Effect.provide(snapshotLayer(tmp.path, directory)))
+          expect(yield* capture(project)).toBeDefined()
+          expect(yield* capture(linked)).toBeDefined()
+
+          const projectID = yield* Effect.gen(function* () {
+            return (yield* Location.Service).project.id
+          }).pipe(
+            Effect.provide(
+              AppNodeBuilder.build(Location.boundNode(Location.Ref.make({ directory: AbsolutePath.make(project) }))),
+            ),
+          )
+          expect(
+            yield* Effect.promise(() => fs.stat(path.join(tmp.path, "snapshot", projectID, Hash.fast(project)))),
+          ).toBeDefined()
+          expect(
+            yield* Effect.promise(() => fs.stat(path.join(tmp.path, "snapshot", projectID, Hash.fast(linked)))),
+          ).toBeDefined()
+        }),
+      (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
+    ),
+  )
+
+  testEffect(Layer.empty).live("checks out a legacy revert snapshot without removing unrelated files", () =>
+    Effect.acquireUseRelease(
+      Effect.promise(() => tmpdir()),
+      (tmp) =>
+        Effect.gen(function* () {
+          const project = path.join(tmp.path, "project")
+          yield* Effect.promise(async () => {
+            await fs.mkdir(project)
+            await fs.writeFile(path.join(project, "tracked.txt"), "one\n")
+            await $`git init`.cwd(project).quiet()
+            await $`git config core.fsmonitor false`.cwd(project).quiet()
+            await $`git config commit.gpgsign false`.cwd(project).quiet()
+            await $`git config user.email test@neurocode.test`.cwd(project).quiet()
+            await $`git config user.name Test`.cwd(project).quiet()
+            await $`git add .`.cwd(project).quiet()
+            await $`git commit -m initial`.cwd(project).quiet()
+          })
+
+          yield* Effect.gen(function* () {
+            const snapshot = yield* Snapshot.Service
+            const before = yield* snapshot.capture()
+            expect(before).toBeDefined()
+            if (!before) return
+            yield* Effect.promise(async () => {
+              await fs.writeFile(path.join(project, "tracked.txt"), "two\n")
+              await fs.writeFile(path.join(project, "unrelated.txt"), "keep\n")
+            })
+            yield* snapshot.checkout(before)
+            expect(yield* read(path.join(project, "tracked.txt"))).toBe("one\n")
+            expect(yield* read(path.join(project, "unrelated.txt"))).toBe("keep\n")
+          }).pipe(Effect.provide(snapshotLayer(tmp.path, project)))
+        }),
+      (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
+    ),
+  )
+})
+
+function snapshotLayer(data: string, directory: string) {
+  return AppNodeBuilder.build(Snapshot.node, [
+    [Location.node, Location.boundNode(Location.Ref.make({ directory: AbsolutePath.make(directory) }))],
+    [Global.node, Global.layerWith({ data, config: path.join(data, "config") })],
+  ])
+}
+
+function read(file: string) {
+  return Effect.promise(() => fs.readFile(file, "utf8")).pipe(Effect.map((content) => content.replaceAll("\r\n", "\n")))
+}