vantage-check
The agent-facing CLI for Vantage: it emits the Markdown conventions Vantage's renderer expects, and checks that a document really renders.
$ vantage-check docs/ # check every Markdown file under docs/
$ vantage-check check docs/design/api.md --format json
$ vantage-check style-guide # print the conventions
Design: ../../docs/design/agent-cli.md.
User documentation: ../../userguide/vantage-check.md.
Why this package is shaped the way it is
- Never published to npm.
vantage-mdon npm stays a pure rendering library; this package is"private": trueand ships only as a compiled binary. That keeps a lint-time dependency tree out of the library. - It imports
vantage-md's TypeScript source by relative path rather than depending on the built package. Acheckthat answers "will this render in Vantage" has to run the code the viewer runs; a second implementation would drift invisibly and pass documents the viewer breaks on. - It never needs a server. Every command works offline against files on disk — no port, no socket, no "is Vantage running" check.
Layout
| Path | What lives there |
|---|---|
src/cli.ts |
Argument parsing and dispatch — no filesystem, no process |
src/commands/ |
One file per command |
src/core/ |
Config, file discovery, document parsing, heading slugs |
src/core/runner.ts |
Every rule over every file, in one thread |
src/core/parallel.ts |
Sharding that file list across worker threads |
src/rules/ |
One file per rule family; each owns its failure classification |
src/report/ |
Text and JSON output |
scripts/ |
The single-file binary and the Python wheel |
Building the binary
$ npm run build # dist/vantage-check for this host, ~90 MB
$ bun ./scripts/build.ts --target bun-darwin-arm64 # or any other platform
npm run build is bun build --compile: the whole program and a bun runtime in
one file, with the version and commit inlined at compile time. The size is the
runtime; it is the price of a tool that runs in a sandbox with nothing
installed.
bun cross-compiles, so one host builds every platform — that is why the
release job is a single runner rather than one per OS. Release CI wraps each
binary in a platform wheel (../../scripts/build-wheel.py) so uvx vantage-check
works, and attaches the archives to a GitHub release for the curl path.
1 maintainer
Metadata
1 maintainer
Release files for vantage-check 0.6.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| vantage_check-0.6.2-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details |
| vantage_check-0.6.2-py3-none-manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64 | Details |
| vantage_check-0.6.2-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details |
| vantage_check-0.6.2-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 138.5 MB
Release files / vantage_check-0.6.2-py3-none-manylinux_2_28_x86_64.whl
| Download URL | vantage_check-0.6.2-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 39.3 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
584ebb4ae21c0acdf59e51ff37a8caa450ca07cb9d8e463373f4f663a1b72d0a
|
|
BLAKE2b-256 checksum How to use checksums |
24c9f2f31e253df7c2c426144232a623c1a4870de9d84c444dcbb7b58580b7c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / vantage_check-0.6.2-py3-none-manylinux_2_28_aarch64.whl
| Download URL | vantage_check-0.6.2-py3-none-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 39.3 MB |
| Tags | Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
825cba540d29b40483173599f1eb0a0c021cd2dd397e6f702a2721b9f178aec6
|
|
BLAKE2b-256 checksum How to use checksums |
db52e9b5f13db6aeb3d733b7441b21d31c16ff755773c21f1726c0c2ac27a91d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / vantage_check-0.6.2-py3-none-macosx_11_0_x86_64.whl
| Download URL | vantage_check-0.6.2-py3-none-macosx_11_0_x86_64.whl |
|---|---|
| Size | 31.2 MB |
| Tags | Python 3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
37a70b0a381ba9228c4b1d7755aa05ea722beff117794d8bfc0dc5f9d594b876
|
|
BLAKE2b-256 checksum How to use checksums |
8342668c47f5643253525566edb8d6b05226d04f8e233be46c0e747c272b866b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / vantage_check-0.6.2-py3-none-macosx_11_0_arm64.whl
| Download URL | vantage_check-0.6.2-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 28.7 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a1c5761b5dc72abaec4840009a93dd538dcb422e6ba9c0bc5194666046df9764
|
|
BLAKE2b-256 checksum How to use checksums |
202fcdf972d7d795684e57de3a73dd6bb9884adb4fad8b332e45c9e9be81f7a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
