メニュー
Run tests and coverage for a package in this repo. Use when asked to run tests, check coverage, run the test suite, or verify a package's specs pass. Covers command forms, flags, pipeline selection (Lune vs Roblox Studio), and reading the output.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Work on the coverage system itself under tools/coverage (Rust full_moon engine or Lune orchestrator). Use when modifying instrumentation, probes, mutation testing, the report, adapters, or when golden tests fail. Covers building, testing, golden regeneration, and layout boundaries.
Create a new Wally package under lib/ in this repo. Use when asked to scaffold, add, or create a new package/module/library. Covers the scaffold script, the pure-Luau vs datamodel entry-point decision, and post-scaffold registration steps.
Publish or version-bump a Wally package in this repo. Use when asked to publish, release, or bump a package version. Covers the publish script's non-interactive flags, the auto-generated init.luau, and CI workflow actions.
Write or edit documentation in this repo — moonwave API docs, doc comments, or guide pages. Use when asked to document an API, add a guide, fix docs, or preview the docs site. Covers moonwave comment forms, guide-file conventions, classOrder registration, and previewing.
Write or modify tiniest test specs (.spec.luau) in this repo. Use when adding tests, fixing failing tests, or improving coverage for a package. Covers spec structure, the expect matcher API, snapshots, Roblox class shims, and the FakeIntermediary bridge for replicator tests.
| name | test-package |
| description | Run tests and coverage for a package in this repo. Use when asked to run tests, check coverage, run the test suite, or verify a package's specs pass. Covers command forms, flags, pipeline selection (Lune vs Roblox Studio), and reading the output. |
Loading Bash Secrets for Roblox API keys:
bash / git-bash: set -a && source .ci/secrets.env && set +a
The test runner IS the coverage tool. Always run from the repo root:
lune run coverage.luau package=<name> # e.g. package=tablemanager
lune run coverage.luau package=all # every lib/ package with specs
lune run coverage.luau package=last # reads test/last_tested_package.txt
<name> is a directory name under lib/. tests.luau no longer exists — do
not try to run it. To test the coverage tool's own Lune core:
lune run coverage.luau package=self --adapter=./tools/coverage/lune/adapters/coverage_self
If requires/types are broken on a fresh checkout, run npm run setup first
(installs wally deps, generates sourcemap + package types — all gitignored).
--per-file — per-file line-coverage breakdown (worst first).--per-test — per-test hit attribution (Lune pipeline only).--recommend — ranked list of concrete next steps; best flag when the goal
is "improve this package's tests".--mutate — mutation testing (Lune pipeline only; slow). --mutate-limit=<n> caps it.--json — print merged coverage.json to stdout.--timeout=<sec> — tiniest watchdog override for hanging suites.--rebuild-engine — force cargo build --release of the Rust engine.The adapter picks the pipeline automatically per package:
game,
Instance.new, ...) or contain const — Lune 0.10.4 cannot parse const.
This is expected behavior, not a hang; give it time or check the printed
pipeline reason. The transport is either local Studio via run-in-roblox
(one Studio launch) or headless Open Cloud (for CI, no Studio) — select
with --roblox-runner=studio|opencloud. Default: opencloud when
ROBLOX_API_KEY is set (plus ROBLOX_UNIVERSE_ID/ROBLOX_PLACE_ID), else
studio.For a coverage-free "do the specs pass on real Roblox?" run (all packages, one
Open Cloud task), use lune run tools/ci/run_tests.luau.
Console report ranks gaps (uncovered functions, one-sided decisions,
never-varied conditions). Artifacts land in .coverage/<package>/
(coverage.json, map.json, hits.json, instrumented build/) — all
gitignored. Full system docs: tools/coverage/README.md.