Local Development

Prerequisites

• Node.js >= 22.14.0 and pnpm 11.25.0 through Corepack.
• Rust and Cargo for launcher and sandbox crates.
• Docker Desktop or Colima for local Postgres, Redis, and object storage.
• Git plus standard shell tools such as bash, awk, find, grep, tar, and checksum utilities.

Standard Commands

corepack enable
corepack prepare pnpm@11.25.0 --activate
pnpm install --frozen-lockfile --ignore-scripts
pnpm run dev:full
pnpm run health:local

Secure Windows WSL Local Qualification

Run the sole onboarding entrypoint from native Windows PowerShell. It keeps the ordinary Ubuntu distro as the local Sigroom host and imports a separate signed windows.wsl2.runsc appliance. The wizard writes a protected marker-owned local profile that later dev:full and health:local commands load automatically after the base and TLS environments; never source or copy that file. This qualification supports only the default local-process stack. Docker/hybrid application-service modes are not claimed for WSL L5, and hosted values are intentionally deferred.

powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File "\\wsl.localhost\<Ubuntu-distro>\home\<linux-user>\code\teamwork\ops\hacp-control\onboard-wsl-hacp.ps1"

Validation Before Handoff

pnpm run type-check
pnpm run test
pnpm run lint
cargo test --manifest-path rust/Cargo.toml --workspace
pnpm run guard:no-genesys