lazy-skill 0.1.3 → 0.2.0

package/dist/index.js

@@ -8,7 +8,8 @@ import { skillsCommand } from "./commands/skills.js";
 import { installCommand } from "./commands/install.js";
 import { themeCommand } from "./commands/theme.js";
 import { listenCommand } from "./commands/listen.js";
-const VERSION = "0.1.0";
+import { warnIfOutdated } from "./lib/version-check.js";
+const VERSION = "0.2.0";
 function help() {
     const theme = THEMES[readConfig().theme];
     const cmd = (name) => rgb(theme.accent, name.padEnd(26));
@@ -16,7 +17,8 @@ function help() {
   ${style.bold("LAZY")} ${rgb(theme.accent, style.bold("SKILL"))}${rgb(theme.support, " Zz")}   ${style.gray("See it. Search it. Install it.")}
 
   ${style.bold("Usage")}
-    ${cmd("lazy-skill connect")}Pair, then wait for installs
+    ${cmd("lazy-skill")}Connect, or listen if already paired
+    ${cmd("lazy-skill connect")}Pair again, then wait for installs
     ${cmd("lazy-skill listen")}Wait for installs sent from your phone
     ${cmd("lazy-skill status")}Show connection and detected tools
     ${cmd("lazy-skill skills")}List skills installed on this computer
@@ -46,11 +48,25 @@ async function main() {
         console.log(VERSION);
         return 0;
     }
-    if (!command || flags.has("-h") || flags.has("--help") || command === "help") {
+    if (flags.has("-h") || flags.has("--help") || command === "help") {
         help();
         return 0;
     }
     const verbose = flags.has("-v") || flags.has("--verbose");
+    // Bare `npx lazy-skill` does the thing rather than printing a menu. The
+    // product is one command, a QR, and you are done — making people discover a
+    // subcommand first is the friction it exists to remove. An already-paired
+    // computer skips straight to listening instead of pairing again.
+    // Only for the long-running commands: a stale copy matters most when the
+    // user is about to sit and wait for something that will never work.
+    const longRunning = !command || command === "connect" || command === "listen";
+    if (longRunning)
+        await warnIfOutdated(VERSION, THEMES[readConfig().theme]);
+    if (!command) {
+        if (readConfig().deviceToken)
+            return listenCommand({ once: flags.has("--once") });
+        return connectCommand({ verbose, listen: !flags.has("--no-listen") });
+    }
     switch (command) {
         case "connect":
             return connectCommand({

package/dist/lib/version-check.js

@@ -0,0 +1,47 @@
+import { style, rgb } from "../ui/theme.js";
+/**
+ * Warns when the running copy is behind the published one.
+ *
+ * npx caches by package name, so `npx lazy-skill` happily keeps running a
+ * version it fetched days ago. That turns a fixed bug into a mystery: the
+ * user hits something already solved and has no way to know. Telling them
+ * plainly costs one request and saves the whole debugging detour.
+ *
+ * Best-effort by design — never blocks startup, never fails the command.
+ */
+const REGISTRY = "https://registry.npmjs.org/lazy-skill/latest";
+const TIMEOUT_MS = 2500;
+function isOlder(current, latest) {
+    const parse = (v) => v.split(".").map((n) => Number.parseInt(n, 10) || 0);
+    const [a, b] = [parse(current), parse(latest)];
+    for (let i = 0; i < 3; i++) {
+        if ((a[i] ?? 0) < (b[i] ?? 0))
+            return true;
+        if ((a[i] ?? 0) > (b[i] ?? 0))
+            return false;
+    }
+    return false;
+}
+export async function warnIfOutdated(current, theme) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        const res = await fetch(REGISTRY, {
+            signal: controller.signal,
+            headers: { Accept: "application/vnd.npm.install-v1+json" },
+        });
+        clearTimeout(timer);
+        if (!res.ok)
+            return;
+        const { version } = (await res.json());
+        if (!version || !isOlder(current, version))
+            return;
+        console.log(`  ${style.yellow("!")} You are running ${current}; ${style.bold(version)} is out.`);
+        console.log(`    ${style.gray("npx caches, so run")} ${rgb(theme.accent, `npx lazy-skill@${version}`)} ${style.gray("to update.")}`);
+        console.log();
+    }
+    catch {
+        // Offline, slow, or the registry is down. None of that should stop a
+        // pairing that would otherwise work.
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lazy-skill",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Found an AI skill while scrolling? Install it to your computer from your phone.",
   "type": "module",
   "bin": {