@theappagency/valinor
v5.12.0
Published
Public launcher for the Valinor CLI — fetches, SHA-256-verifies, caches, and runs the proprietary Valinor bundle from downloads.valinorci.com. Zero setup, zero secrets, zero npm auth.
Readme
@theappagency/valinor
The public launcher for the Valinor CLI — Camber's CI-native quality-governance tool.
npx @theappagency/valinor@latest --version
npx @theappagency/[email protected] claims-verify claims.ymlThe launcher is trivial by design and contains no Valinor functionality itself. On each run it:
- resolves the requested version against the Valinor downloads endpoint
(
https://downloads.valinorci.com/manifest.json) — the launcher's own version pins the bundle version (the pipeline publishes them in lockstep), so@theappagency/[email protected]runs ValinorX.Y.Z; - fetches the version's bundle (
/v/<version>/valinor.tgz) and verifies its SHA-256 against the publishedSHA256SUMS, failing closed — a mismatched artifact is deleted, never executed; - caches the verified bundle at
~/.valinor/cache/<version>/— an already-cached, exactly-pinned version runs fully offline with no network I/O; - executes the cached CLI, passing through all arguments and the exit code.
No npm registry auth, no .npmrc, no tokens, no secrets — npx it anywhere, including CI.
The launcher sends no telemetry. Its only network activity is fetching the artifact above.
Environment variables
| Variable | Effect |
| --- | --- |
| VALINOR_VERSION | Run a specific version or dist-tag (e.g. 3.1.0, latest), overriding the launcher's own pinned version. |
| VALINOR_DOWNLOADS_URL | Override the downloads endpoint base URL (staging/fixtures). |
| VALINOR_CACHE_DIR | Override the cache location (default ~/.valinor/cache). |
| VALINOR_FETCH_TIMEOUT_MS | Per-request fetch timeout in milliseconds (default 30000) — a silent/blackholed endpoint aborts here rather than hanging. |
| VALINOR_LAUNCHER_DEBUG | Print full error causes (default output is the actionable message only). |
Licensing
This launcher is MIT-licensed. The Valinor CLI bundle it downloads is proprietary software of
Camber–The App Agency, licensed under the terms shipped inside the downloaded artifact (the
LICENSE file in the bundle). Installing this launcher conveys no rights to the bundle.
