Testing and Validation

Purpose

This document runs the Go unit test suite. The unit tests use contract-validated fake servers (backed by the OpenAPI spec in protocol/public-api-v1.openapi.yaml) to verify CLI behavior without any external dependencies, including strict Bearer auth handling and the SSH certificate request defaults.

Repo preflight

Verify essential source files exist

test -f go.mod
test -f cmd/craken/main.go
test -f cmd/craken/fake_server_test.go
test -f protocol/public-api-v1.openapi.yaml
command -v go >/dev/null 2>&1

run:shell

Unit tests

Run Go unit tests with contract-validated fakes (The protocol sync test self-skips when the sibling checkout is absent.)

# (The protocol sync test self-skips when the sibling checkout is absent.)
go test ./...

run:shell