wyvrnpm 2.17.0 → 2.18.0

package/README.md

@@ -473,6 +473,62 @@ Everything after `--` is forwarded verbatim to `cmake --build` (e.g. `-j 8`).
 
 ---
 
+### `wyvrnpm test` (2.18.0+)
+
+Runs ctest against the wyvrnpm-generated test preset (`wyvrn-<profile>-<config>`). Auto-runs `wyvrnpm build` first if the toolchain or build outputs are stale — disable with `--no-build` for a pure ctest pass.
+
+```bash
+wyvrnpm test                                  # Release config, auto-builds if stale
+wyvrnpm test --all-configs                    # Loop over every recipe config
+wyvrnpm test --config Debug,Release           # Comma-separated config list
+wyvrnpm test -R BasicSpatialGrid              # Filter by test-name regex
+wyvrnpm test -L fast                          # Filter by label
+wyvrnpm test --format json                    # JSON summary on stdout for CI
+wyvrnpm test --no-build                       # Skip auto-build, just run ctest
+wyvrnpm test -- --output-on-failure -j 8      # Passthru to ctest
+```
+
+| Flag | Default | Description |
+|---|---|---|
+| `--preset` / `-P` | `wyvrn-<profile>-<config>` | Override the test preset name |
+| `--profile` / `-p` | *(config)* | Build profile — selects the preset family |
+| `--config` / `-c` | `Release` | Single or comma-separated config list |
+| `--all-configs` | `false` | Loop over every config the recipe declares (or all four canonical configs) |
+| `--verbose` / `-v` | `false` | Forwards `-V` to ctest (per-test detail) |
+| `--tests-regex` / `-R` | — | Run only tests whose name matches the regex |
+| `--label-regex` / `-L` | — | Run only tests whose label matches the regex |
+| `--auto-build` | `true` | Auto-run `wyvrnpm build` when toolchain is stale. `--no-build` opts out. |
+| `--source` / `-s` | *(config)* | Forwarded to auto-build when triggered |
+| `--build-dir` | `build` | Must match the value used at install time. Persist via `wyvrn.local.json:binaryDirRoot`. |
+| `--format` | `text` | `text` (default) streams ctest verbatim; `json` emits a structured summary on stdout, logs to stderr |
+
+Everything after `--` is forwarded verbatim to `ctest` (e.g. `--repeat until-pass:3`, `--output-junit results.xml`).
+
+**`--format json` summary**:
+
+```json
+{
+  "command":        "test",
+  "wyvrnpmVersion": "2.18.0",
+  "profile":        "default",
+  "configs": [
+    { "config": "Release", "preset": "wyvrn-default-release",
+      "total": 42, "passed": 40, "failed": 2,
+      "durationMs": 1234, "exitCode": 8 }
+  ],
+  "totalConfigs":  1,
+  "passedConfigs": 0,
+  "failedConfigs": 1,
+  "ok": false
+}
+```
+
+Exit code is `0` iff every config passes; `1` otherwise. CI scripts should gate on the `ok` field or the exit code, not on the text output.
+
+**Test-only deps pattern.** For projects that need a test framework like Catch2 / GoogleTest only during the build, the canonical recipe is to declare an `options.tests` toggle and list the framework in `buildDependencies` with `whenOption: "tests"` (see §4.1 of [CLAUDE.md](CLAUDE.md)). Consumers pulling the prebuilt artefact never see the test deps; running `wyvrnpm install -o <Pkg>:tests=true && wyvrnpm test` from the project root fetches them and runs the suite.
+
+---
+
 ### `wyvrnpm publish`
 
 Zips the project directory and uploads `wyvrn.json` + `wyvrn.zip` to the destination source, tagged with the active build profile.

package/bin/wyvrnpm.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 'use strict';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wyvrnpm",
-  "version": "2.17.0",
+  "version": "2.18.0",
   "description": "A simple, static-hosting-compatible C++ package manager",
   "keywords": [
     "c++",