@vigilbase/cli 0.2.1 → 0.2.2

package/dist/local/cloudflare-checkup/errors.js

@@ -75,6 +75,8 @@ export const LOCAL_ERROR_HINTS = {
  * hint names both ways out.
  */
 export const ENV_TOKEN_AUTH_HINT = `Set ${CF_TOKEN_ENV} in this shell to a valid read-only Cloudflare API token (read -rs ${CF_TOKEN_ENV} && export ${CF_TOKEN_ENV}) and run the same command again, or unset it (or use --cf-auth profile) to sign in with your browser instead.`;
+/** SNAPSHOT_INVALID for an `inspect` or `submit` path with no file: nothing to collect again, so how to make one. */
+export const SNAPSHOT_MISSING_HINT = 'Check the file path. To collect a snapshot into a file, run `npx @vigilbase/cli cloudflare-checkup collect --out <file>`.';
 /** CF_PERMISSION_DENIED in env mode: the token lacks a read permission; the browser sign-in is the other way out. */
 export const ENV_TOKEN_PERMISSION_HINT = `The API token in ${CF_TOKEN_ENV} cannot read everything the checkup needs. Add the read permissions to it, or unset it (or use --cf-auth profile) to sign in with your browser instead, then run the same command again.`;
 export class LocalCheckupError extends Error {

package/dist/local/cloudflare-checkup/snapshot-file.js

@@ -13,7 +13,7 @@ import { createHash, randomBytes } from 'node:crypto';
 import { link, open, readFile, rename, rm, stat } from 'node:fs/promises';
 import { basename, dirname, join } from 'node:path';
 import { CloudflareCheckupSnapshotV1Schema, SNAPSHOT_LIMITS, SNAPSHOT_SCHEMA_VERSION, expandRuleRuns, snapshotIssueList, snapshotRejectReason, } from './contract.js';
-import { LocalCheckupError } from './errors.js';
+import { LocalCheckupError, SNAPSHOT_MISSING_HINT } from './errors.js';
 export function sha256Hex(bytes) {
     return createHash('sha256').update(bytes).digest('hex');
 }
@@ -90,8 +90,10 @@ export function snapshotParseError(issues) {
 /** Read, hash and validate a snapshot file against the vendored contract. */
 export async function loadSnapshotFile(path) {
     const info = await stat(path).catch(() => null);
-    if (!info || !info.isFile())
-        throw new LocalCheckupError('SNAPSHOT_INVALID', 'The snapshot file does not exist or is not a regular file.');
+    if (!info)
+        throw new LocalCheckupError('SNAPSHOT_INVALID', 'The snapshot file does not exist.', { hint: SNAPSHOT_MISSING_HINT });
+    if (!info.isFile())
+        throw new LocalCheckupError('SNAPSHOT_INVALID', 'The snapshot path is not a file.', { hint: SNAPSHOT_MISSING_HINT });
     if (info.size > SNAPSHOT_LIMITS.maxBytes) {
         throw new LocalCheckupError('SNAPSHOT_TOO_LARGE', `The snapshot is larger than the ${SNAPSHOT_LIMITS.maxBytes / 1024 / 1024} MiB contract limit.`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vigilbase/cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Vigilbase CLI — security scanners, agent tools, and Vigilbase One from the terminal.",
   "keywords": [
     "vigilbase",