noconnorandClaude Opus 4.8
485e267565
Five skills covering this repo's own conventions: adding a bootstrap module, adding a CLI to bin/, bumping a pinned version, adding an MCP server, and verifying a module change. Lives in .agents/skills/ because opencode discovers that path natively alongside .opencode/skills/ and .claude/skills/, making it the most tool-neutral of the three. Distinct from the repo's skills/ tree, which ships to every covert-gpt user via sync.sh; these stay in the checkout. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
79 lines
2.9 KiB
Markdown
79 lines
2.9 KiB
Markdown
---
|
|
name: verify-module
|
|
description: Use before committing any change to a module's install.sh or to bootstrap.sh, to prove the change actually works. Covers the idempotency re-run check, shellcheck with the right shell dialect, and testing against both RHEL- and Debian-family containers.
|
|
---
|
|
|
|
# Verifying a module change
|
|
|
|
Nothing here is verified by a test suite — the only proof a module works is
|
|
running it. Three checks, cheapest first.
|
|
|
|
## 1. shellcheck
|
|
|
|
Every script is POSIX `sh`, so tell shellcheck that. Its default assumes bash
|
|
and will happily wave through `[[ ]]` and `local`, which break on a box where
|
|
`/bin/sh` is dash.
|
|
|
|
```sh
|
|
shellcheck -s sh bootstrap.sh */install.sh lib/*.sh
|
|
```
|
|
|
|
`lib/` is sourced, not executed, so keep the `# shellcheck source=../lib/fetch.sh`
|
|
directives above each `.` line or shellcheck can't follow them.
|
|
|
|
## 2. Idempotency — the re-run check
|
|
|
|
This is the one that catches real bugs. Run the module twice:
|
|
|
|
```sh
|
|
./<module>/install.sh # does the work
|
|
./<module>/install.sh # must SKIP, not redo it
|
|
```
|
|
|
|
The second run has to say "already installed" / "already present". If it
|
|
re-downloads, the guard is broken — most often a pinned `ver=` that doesn't
|
|
match the string stamped in `~/.local/bin/.versions/<tool>` (`v1.2.3` vs
|
|
`1.2.3`). That failure is silent: everything still works, it just refetches on
|
|
every bootstrap forever.
|
|
|
|
Guards must check the tool **runs**, not that a path exists. A Kasm redeploy
|
|
leaves broken trees behind, and an existence check will happily skip past one.
|
|
|
|
## 3. Both distro families
|
|
|
|
`lib/os-detect.sh` branches on dnf/yum vs apt. If your change touches
|
|
`pkg_install` or anything OS-conditional, exercise both:
|
|
|
|
```sh
|
|
docker run --rm -v "$PWD:/repo" -w /repo debian:13 sh -c \
|
|
'apt-get update -qq && apt-get install -y -qq sudo curl git >/dev/null && ./<module>/install.sh'
|
|
|
|
docker run --rm -v "$PWD:/repo" -w /repo rockylinux:9 sh -c \
|
|
'dnf install -y -q sudo curl git >/dev/null && ./<module>/install.sh'
|
|
```
|
|
|
|
Run each container's command twice in the same shell to get the idempotency
|
|
check on both families at once.
|
|
|
|
Note this runs as root in a container, which is *not* how a real box runs it —
|
|
it won't catch a missing-sudo problem. It's a portability check, not a
|
|
faithful rehearsal.
|
|
|
|
## Non-systemd hosts
|
|
|
|
Kasm has no systemd and no rootful Docker. Anything that would `systemctl` must
|
|
no-op rather than abort — you can't fully rehearse this in a container, so read
|
|
the code path and confirm the guard exists (`docker/install.sh` and
|
|
`docker-rootless-cgroup/install.sh` are the references).
|
|
|
|
## Full run
|
|
|
|
Finally, `./bootstrap.sh` end to end. It runs modules in a deliberate order and
|
|
`set -eu` means any module's failure aborts the rest — a module that passes
|
|
standalone can still break the chain if it was inserted at the wrong point.
|
|
|
|
## Report honestly
|
|
|
|
If you only ran shellcheck and the re-run check, say that. Don't describe a
|
|
change as verified on both distro families unless you actually ran both.
|