singularity-forge/src/tests/docker-template.test.ts
Tom Boucher 67f47bea06 feat(docker): add official Docker sandbox template for isolated GSD auto mode (#2360)
Ship a Dockerfile.sandbox, docker-compose.yml, .env.example, and docs so
users can run GSD auto mode inside an isolated Docker sandbox (MicroVM)
without risk to the host filesystem, SSH keys, or other projects.

- Dockerfile.sandbox: Node 22 base, gsd-pi pre-installed, non-root user, port 3000
- docker-compose.yml: workspace volume mount, persistent .gsd state, env_file support
- .env.example: template for LLM provider keys and optional tool credentials
- docker/README.md: setup guide covering sandbox CLI, Compose, two-terminal workflow,
  credential injection, and network allowlisting
- .dockerignore: project-root ignore file for efficient Docker builds
- src/tests/docker-template.test.ts: 13 structural tests verifying all template files

Fixes #1544

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-24 13:57:59 -06:00

95 lines
3 KiB
TypeScript

import test from "node:test";
import assert from "node:assert/strict";
import { readFileSync, existsSync } from "node:fs";
import { resolve, dirname } from "node:path";
import { fileURLToPath } from "node:url";
const __dirname = dirname(fileURLToPath(import.meta.url));
const root = resolve(__dirname, "../..");
function readFile(relativePath: string): string {
const full = resolve(root, relativePath);
assert.ok(existsSync(full), `expected ${relativePath} to exist`);
return readFileSync(full, "utf-8");
}
// ── Dockerfile.sandbox ──
test("docker/Dockerfile.sandbox exists and uses Node 22 base", () => {
const content = readFile("docker/Dockerfile.sandbox");
assert.match(content, /FROM node:22/);
});
test("docker/Dockerfile.sandbox installs gsd-pi globally", () => {
const content = readFile("docker/Dockerfile.sandbox");
assert.match(content, /npm install -g gsd-pi/);
});
test("docker/Dockerfile.sandbox creates a non-root user", () => {
const content = readFile("docker/Dockerfile.sandbox");
assert.match(content, /useradd/);
assert.match(content, /USER gsd/);
});
test("docker/Dockerfile.sandbox exposes port 3000", () => {
const content = readFile("docker/Dockerfile.sandbox");
assert.match(content, /EXPOSE 3000/);
});
test("docker/Dockerfile.sandbox installs git", () => {
const content = readFile("docker/Dockerfile.sandbox");
assert.match(content, /git/);
});
// ── docker-compose.yml ──
test("docker/docker-compose.yml exists and defines gsd service", () => {
const content = readFile("docker/docker-compose.yml");
assert.match(content, /services:/);
assert.match(content, /gsd:/);
});
test("docker/docker-compose.yml mounts workspace volume", () => {
const content = readFile("docker/docker-compose.yml");
assert.match(content, /\/workspace/);
});
test("docker/docker-compose.yml references Dockerfile.sandbox", () => {
const content = readFile("docker/docker-compose.yml");
assert.match(content, /Dockerfile\.sandbox/);
});
test("docker/docker-compose.yml maps port 3000", () => {
const content = readFile("docker/docker-compose.yml");
assert.match(content, /3000:3000/);
});
// ── .env.example ──
test("docker/.env.example exists and lists ANTHROPIC_API_KEY", () => {
const content = readFile("docker/.env.example");
assert.match(content, /ANTHROPIC_API_KEY/);
});
test("docker/.env.example lists OPENAI_API_KEY", () => {
const content = readFile("docker/.env.example");
assert.match(content, /OPENAI_API_KEY/);
});
// ── .dockerignore ──
test(".dockerignore exists at project root", () => {
const content = readFile(".dockerignore");
assert.match(content, /node_modules/);
assert.match(content, /\.env/);
assert.match(content, /dist/);
});
// ── README ──
test("docker/README.md exists and documents sandbox usage", () => {
const content = readFile("docker/README.md");
assert.match(content, /Docker Sandbox/i);
assert.match(content, /docker sandbox create/);
assert.match(content, /Network Allowlisting/i);
});