Merge pull request #1 from git-stunts/feature/setup-docker-guard

chore: initial docker guard

Author: flyingrobots

.gitignore

@@ -0,0 +1,38 @@
+.git
+node_modules/
+jspm_packages/
+.bun
+.bun_modules/
+deno.lock
+.dist
+dist/
+build/
+.cache/
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+pids
+*.pid
+*.seed
+*.pid.lock
+lib-cov
+coverage
+*.lcov
+.nyc_output
+.grunt
+.serverless
+.next
+.nuxt/
+.output/
+out/
+.parcel-cache
+.vscode/
+.idea/
+.DS_Store
+node_modules.bun/
+_test

README.md

@@ -0,0 +1,23 @@
+# @git-stunts/docker-guard
+
+Tiny guard that ensures tests and benchmarks only execute inside Docker. Each git-stunts package can import the guard, then call `ensureDocker()` before any runtime work begins.
+
+## Usage
+
+```javascript
+import { ensureDocker } from '@git-stunts/docker-guard';
+
+ensureDocker();
+```
+
+You can also pass overrides for testing:
+
+```javascript
+import { ensureDocker } from '@git-stunts/docker-guard';
+
+ensureDocker({
+  env: { GIT_STUNTS_DOCKER: '1' },
+  logger: () => {},
+  exit: () => {}
+});
+```