Cli Playbooks¶
Scenarios: 15
Addon List Basic
Review the catalog-backed addon listing exposed by `pk3s`.
cd productive-k3s-cli
bash -lc './pk3s addon list'Bundle Info Local
Inspect local sibling bundle resolution for both `core` and `infra` through `pk3s`.
cd productive-k3s-cli
bash -lc 'PRODUCTIVE_K3S_SOURCE=local ./pk3s bundle core info --json && printf "\n" && PRODUCTIVE_K3S_SOURCE=local ./pk3s bundle infra info --json'Bundle Info Remote
Inspect published remote bundle resolution for both `core` and `infra` through `pk3s`.
cd productive-k3s-cli
bash -lc 'PRODUCTIVE_K3S_SOURCE=remote ./pk3s bundle core info --json && printf "\n" && PRODUCTIVE_K3S_SOURCE=remote ./pk3s bundle infra info --json'Bundle Resolution Contract
Review the recorded CLI manifest contract that ties the CLI version to one Core bundle and one Infra bundle.
cd productive-k3s-cli
bash -lc 'tmp="$(mktemp -d)"; trap '"'"'"'"'"'"'"'"'rm -rf "$tmp"'"'"'"'"'"'"'"'"' EXIT; TEST_ARTIFACTS_DIR="$tmp" bash ./tests/contracts/02-bundle-resolution-contract.sh && cat "$tmp/bundle-resolution-contract.json"'CI Workflow Contract
Review the CI wiring contract for Go tests, CLI contracts, and the GitHub-host remote validator.
cd productive-k3s-cli
bash -lc 'tmp="$(mktemp -d)"; trap '"'"'"'"'"'"'"'"'rm -rf "$tmp"'"'"'"'"'"'"'"'"' EXIT; TEST_ARTIFACTS_DIR="$tmp" bash ./tests/contracts/07-ci-workflow-contract.sh && cat "$tmp/ci-workflow-contract.json"'Core Command Mapping Review
Review the expected CLI-to-Core command delegation map.
cd productive-k3s-cli
bash -lc 'tmp="$(mktemp -d)"; trap '"'"'"'"'"'"'"'"'rm -rf "$tmp"'"'"'"'"'"'"'"'"' EXIT; TEST_ARTIFACTS_DIR="$tmp" bash ./tests/contracts/03-core-command-mapping-contract.sh && cat "$tmp/core-command-mapping-contract.json"'Help And Version
Review the top-level `pk3s` help surface and the current CLI version from a local `productive-k3s-cli` checkout.
cd productive-k3s-cli
bash -lc './pk3s help && printf "\n" && ./pk3s version'Infra Command Mapping Review
Review the expected CLI-to-Infra and CLI-to-profile command delegation map.
cd productive-k3s-cli
bash -lc 'tmp="$(mktemp -d)"; trap '"'"'"'"'"'"'"'"'rm -rf "$tmp"'"'"'"'"'"'"'"'"' EXIT; TEST_ARTIFACTS_DIR="$tmp" bash ./tests/contracts/04-infra-command-mapping-contract.sh && cat "$tmp/infra-command-mapping-contract.json"'Live Catalog Multipass
Run the live catalog-backed `multipass` lifecycle through the CLI validator.
cd productive-k3s-cli
bash ./tests/live-cli-catalog-multipass.shLive Multipass Remote
Run the live remote `multipass` lifecycle through the CLI validator.
cd productive-k3s-cli
bash ./tests/live-cli-multipass-remote.shLive Profile Export Multipass
Export a profile bundle through the CLI and replay it into a live `multipass` cluster.
cd productive-k3s-cli
bash ./tests/live-cli-profile-export-multipass.shLive Stack Export Ubuntu24
Export a stack bundle through the CLI and replay it in a fresh Ubuntu 24 VM.
cd productive-k3s-cli
bash ./tests/live-cli-stack-export-ubuntu24.shProfile Fixture Contract
Review the profile fixture contract used by CLI command tests.
cd productive-k3s-cli
bash -lc 'tmp="$(mktemp -d)"; trap '"'"'"'"'"'"'"'"'rm -rf "$tmp"'"'"'"'"'"'"'"'"' EXIT; TEST_ARTIFACTS_DIR="$tmp" bash ./tests/contracts/05-profile-command-contract.sh && cat "$tmp/profile-command-contract.json"'Profile List And Show Catalog
Review the catalog-backed profile discovery surface and one concrete published profile summary.
cd productive-k3s-cli
bash -lc './pk3s profile list && printf "\n" && ./pk3s profile show aws-single-node-basic'Unsupported Command Contract
Show the readable failure contract for an unsupported top-level `pk3s` command.
cd productive-k3s-cli
bash -lc 'set +e; ./pk3s unsupported-command; code=$?; printf "\n[expected-exit] %s\n" "${code}"; test "${code}" -ne 0'