mocklet_cli

mocklet-cli

Thin Go CLI wrapper for the Mocklet HTTP API, aligned with cli_arch_draft.md.

Current status:

• Sprint 1 foundation is complete;
• Sprint 2 platform baseline is implemented (generated client, cobra shell, config/profile/token/output scaffolding);
• Sprint 3 auth MVP is implemented (auth login/whoami/logout/token set --stdin, including CLI Google flow);
• Sprint 4 upload MVP is implemented (mock validate and mock create with file + raw/stdin transport paths);
• Sprint 5 lifecycle and release hardening is implemented (mock list/get/stats/restart/delete, output stabilization, release smoke checks);
• command surface v1 is fixed in docs/commands.md;
• local runtime scope is removed from CLI v1;
• CI uses GitLab (.gitlab-ci.yml) with baseline quality gates;
• OpenAPI generation workflow is fixed and documented.

Layout

Key paths:

• cmd/mocklet: binary entrypoint
• internal/cli: CLI command routing and UX shell
• internal/cloud/openapi: reserved package for generated OpenAPI client code
• internal/cloud: thin wrappers and transport error classification
• internal/output: exit code mapping and renderer skeleton
• internal/auth: token store abstraction (flag/env/keyring/file)
• internal/config: profiles and precedence resolution (flags > env > profile > defaults)
• docs: architecture and contract notes
• scripts: local quality and generation helpers
• Makefile: reproducible local workflow entrypoints
• .gitlab-ci.yml: GitLab CI checks and tag-based release workflow

Commands

Auth commands are implemented and ready for manual and CI usage:

go run ./cmd/mocklet auth login --email user@example.com --password-stdin
go run ./cmd/mocklet auth login --google
go run ./cmd/mocklet auth whoami
go run ./cmd/mocklet auth token set --stdin
go run ./cmd/mocklet auth logout

Mock upload commands are implemented:

go run ./cmd/mocklet mock validate ./sample.har
cat ./sample.har | go run ./cmd/mocklet mock validate --stdin --output json
go run ./cmd/mocklet mock create ./sample.har --ttl-seconds 86400 --latency-emulation
cat ./sample.har | go run ./cmd/mocklet mock create --stdin --matching-rules-file ./matching_rules.json --output json

Mock lifecycle commands are implemented:

go run ./cmd/mocklet mock list --limit 20 --output table
go run ./cmd/mocklet mock get abc123 --output json
go run ./cmd/mocklet mock stats abc123 --history-limit 20 --output json
go run ./cmd/mocklet mock restart abc123
go run ./cmd/mocklet mock delete abc123 --yes

Command tree and flags are documented in docs/commands.md.

Local workflow

make build
make test
make vet
make lint
make security
make coverage
make race
make openapi-smoke
make release-smoke

CI-equivalent local check:

make ci

OpenAPI generation

Use:

make openapi-smoke
make openapi-generate

Details are documented in docs/openapi-generation.md.

Notes

• Module path is currently gitlab.com/KeyStorke/mocklet_cli.
• Backend contract status is tracked in docs/api-contract-status.md.
• Auth strategy is fixed in docs/auth-strategy.md.
• Release flow is documented in docs/release-process.md.
• Tool versions are pinned in Makefile and CI variables in .gitlab-ci.yml.
• Coverage gate excludes generated OpenAPI package and uses configurable minimum (COVERAGE_MIN, default 50.0).