caique 0.5.0 → 0.5.1

package/README.md

@@ -268,7 +268,7 @@ Graded by the incumbent's own test suite:
 | `clack` | 14 / 17 |
 | `inquirer-core` | 41 / 41 |
 
-Weight, installed and tree-inclusive: **122,447 bytes** against **182,472** for the incumbents it replaces — a ratio of **0.6710** (@inquirer/core measured but left out of the ceiling, so it is understated).
+Weight, installed and tree-inclusive: **123,321 bytes** against **182,472** for the incumbents it replaces — a ratio of **0.6758** (@inquirer/core measured but left out of the ceiling, so it is understated).
 ## Where it sits
 
 Plugins register under the `widgets` key, against the one schema the whole family shares.

package/dist/check.js

@@ -1,9 +1,37 @@
+import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { PluginError, register, reset, validate } from './plugin.js';
 export const EXIT_OK = 0;
 export const EXIT_RUNTIME = 1;
 export const EXIT_USAGE = 2;
+const USAGE = 'usage: caique check <plugin-file>\n';
+const HELP = `${USAGE}
+Load a plugin file, validate it against the family schema, register it, and report what
+caique does with it. Exit 0 when it contributes, 1 on a refusal (with a code and a fix), 2 on
+a usage error.
+
+  -h, --help     show this help
+  -V, --version  print the version
+`;
+function version() {
+    return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+}
+function target(arg, write) {
+    if (arg === '--help' || arg === '-h') {
+        write(HELP);
+        return EXIT_OK;
+    }
+    if (arg === '--version' || arg === '-V') {
+        write(`${version()}\n`);
+        return EXIT_OK;
+    }
+    if (arg === undefined || arg.startsWith('-')) {
+        write(arg === undefined ? USAGE : `unknown option ${arg}\n${USAGE}`);
+        return EXIT_USAGE;
+    }
+    return arg;
+}
 function refuse(code, message, fix, write) {
     write(`${code}: ${message}\n  fix: ${fix}\n`);
     return EXIT_RUNTIME;
@@ -20,11 +48,9 @@ export async function check(argv, write) {
     }
 }
 async function inspect(argv, write) {
-    const file = argv[0];
-    if (file === undefined) {
-        write('usage: caique check <plugin-file>\n');
-        return EXIT_USAGE;
-    }
+    const file = target(argv[0], write);
+    if (typeof file === 'number')
+        return file;
     const loaded = (await import(pathToFileURL(resolve(file)).href));
     const plugin = loaded.default ?? loaded;
     reset();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "caique",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "The parrot that always answers back, and the boat that goes between ship and shore. Prompts that are flags first, so agents answer before they are asked and non-TTY callers get an error naming the flag, never a hang. Drop-in path for inquirer and clack.",
   "license": "MIT",
   "type": "module",
@@ -98,8 +98,8 @@
     "ai-agent"
   ],
   "dependencies": {
-    "closeout": "^0.5.0",
-    "linegauge": "^0.5.0"
+    "closeout": "^0.5.1",
+    "linegauge": "^0.5.1"
   },
   "devDependencies": {
     "vitest": "^5.0.1"