@crouton-kit/capture 1.3.13 → 1.3.14

package/bin/capture

@@ -9822,7 +9822,7 @@ function validateHarAppendBatch(value, source) {
   return { entries, incompleteLifecycles };
 }
 function captureVersion() {
-  const version = "1.3.13";
+  const version = "1.3.14";
   return typeof version === "string" && version.length > 0 ? version : "development";
 }
 function token() {
@@ -11581,7 +11581,7 @@ function wallTime(value) {
   }
 }
 function captureVersion2() {
-  const version = "1.3.13";
+  const version = "1.3.14";
   return typeof version === "string" && version.length > 0 ? version : "development";
 }
 function deepFreeze(value) {
@@ -241033,6 +241033,9 @@ init_motion();
 init_cdp();
 init_lib();
 var ROOTS = ["session", "page", "tab", "measure", "motion", "cdp", "lib"];
+var GUESSABLE_HINTS = {
+  screenshot: "page shot"
+};
 var ROOT_BLOCKS = [
   COMMAND_BLOCK,
   COMMAND_BLOCK2,
@@ -241056,7 +241059,7 @@ CDP_PORT / CDP_TARGET pin the browser + tab for orchestrators \u2014 precedence:
 explicit flag > active session > env.`;
 }
 function printVersion() {
-  const declared = "1.3.13";
+  const declared = "1.3.14";
   if (declared) {
     console.log(declared);
     return;
@@ -241086,10 +241089,11 @@ async function main() {
   if (ROOTS.includes(command) || command === "__bridge-serve") {
     return cdpMain();
   }
+  const hint = GUESSABLE_HINTS[command];
   throw captureError(
     "invocation",
     "unknown_command",
-    `Unknown command ${command}; expected one of the seven roots: session, page, tab, measure, motion, cdp, lib.`
+    hint ? `Unknown command ${command}; did you mean \`capture ${hint}\`? Expected one of the seven roots: session, page, tab, measure, motion, cdp, lib.` : `Unknown command ${command}; expected one of the seven roots: session, page, tab, measure, motion, cdp, lib.`
   );
 }
 main().catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/capture",
-  "version": "1.3.13",
+  "version": "1.3.14",
   "description": "Browser automation and UI validation via CDP — session-based screenshots, HAR, a11y, click/type, and JS exec",
   "bin": {
     "capture": "./bin/capture"

package/src/capture.ts

@@ -25,6 +25,18 @@ import { COMMAND_BLOCK as LIB_BLOCK } from './cdp/commands/lib.js';
 /** The seven visible root children, in help order. */
 const ROOTS = ['session', 'page', 'tab', 'measure', 'motion', 'cdp', 'lib'] as const;
 
+/**
+ * Guessable former/legacy tokens with one unambiguous current destination —
+ * an orientation hint on the `unknown_command` error, never a second
+ * dispatchable path (the guessed token still fails; only the message
+ * changes). Deliberately small: an entry only earns a place here when its
+ * correct destination is unambiguous, so this stays a short discriminator
+ * rather than a growing synonym taxonomy.
+ */
+const GUESSABLE_HINTS: Readonly<Record<string, string>> = {
+  screenshot: 'page shot',
+};
+
 const ROOT_BLOCKS = [
   SESSION_BLOCK,
   PAGE_BLOCK,
@@ -90,10 +102,13 @@ async function main(): Promise<void> {
     return cdpMain();
   }
 
+  const hint = GUESSABLE_HINTS[command];
   throw captureError(
     'invocation',
     'unknown_command',
-    `Unknown command ${command}; expected one of the seven roots: session, page, tab, measure, motion, cdp, lib.`,
+    hint
+      ? `Unknown command ${command}; did you mean \`capture ${hint}\`? Expected one of the seven roots: session, page, tab, measure, motion, cdp, lib.`
+      : `Unknown command ${command}; expected one of the seven roots: session, page, tab, measure, motion, cdp, lib.`,
   );
 }