---
name: Test Environment Setup
slug: test-environment-setup
category: DevOps
description: Test Environment Setup launches the built cezar server for non-interactive test runs and fresh worktrees. It covers the boot script, build and cache requirements, and locked-model QA startup.
github: "https://github.com/open-mercato/cezar/tree/main/.ai/skills/om-prepare-test-env"
language: TypeScript
stars: 182
forks: 46
install: "npx degit https://github.com/open-mercato/cezar/tree/main/.ai/skills/om-prepare-test-env ~/.claude/skills/om-prepare-test-env"
installs_to: ~/.claude/skills/om-prepare-test-env
source_path: .ai/skills/om-prepare-test-env/SKILL.md
collection_size: 1
category_size: 1044
added: 2026-09-07T05:20:05.365Z
last_synced: 2026-09-07T05:20:05.365Z
canonical_url: "https://dirskills.com/skills/test-environment-setup"
---

# Test Environment Setup

Test Environment Setup launches the built cezar server for non-interactive test runs and fresh worktrees. It covers the boot script, build and cache requirements, and locked-model QA startup.

**Install:**

```bash
npx degit https://github.com/open-mercato/cezar/tree/main/.ai/skills/om-prepare-test-env ~/.claude/skills/om-prepare-test-env
```

## README

# Repository test-environment notes

- Launch the built cezar server through `.ai/scripts/test-env-up.sh`; its app process must use `nohup` with stdin detached so it survives non-interactive bootstrap shells. This prevents a descriptor from reporting a server that is terminated as soon as the bootstrap command exits.
- Fresh worktrees have no workspace links or runtime dependencies. The generated entrypoint must run the compound `npm ci && npm run build` chain through `sh -c`, include `packages/contract/src` in its build fingerprint, and require `node_modules/zod/package.json` as a cache artifact. This prevents `@open-mercato/cezar-contract` from resolving as missing/unknown during `tsc` and prevents a cached build from starting without runtime dependencies. Do not require `packages/api-client/dist`: the web build aliases that workspace to source and the root build does not emit that directory. Run `CEZ_AGENT_MODELS_LOCKED=1 sh .ai/scripts/test-env-up.sh --force` for locked-model QA.