@pushrec/skills 0.1.0 → 0.2.0

package/README.md

@@ -2,23 +2,47 @@
 
 CLI for the pushREC Agent Skills Marketplace. Install, manage, and update Claude Code skills.
 
-## Installation
+**Version:** `0.1.0` | **Published:** 2026-02-19
+
+## Quick Start
 
 ```bash
+# One-off (no install required)
+npx @pushrec/skills auth login
+
+# Or install globally
 npm install -g @pushrec/skills
+pushrec-skills auth login
 ```
 
 ## Commands
 
+### Auth
+
+| Command | Description |
+|---------|-------------|
+| `pushrec-skills auth login` | Activate your license key on this device (interactive prompt) |
+| `pushrec-skills auth logout` | Remove license key and deactivate this device |
+| `pushrec-skills auth status` | Show current license and device status |
+| `pushrec-skills auth deactivate-device` | Remove this device from license (frees a slot) |
+
+### Skills
+
+| Command | Description |
+|---------|-------------|
+| `pushrec-skills list` | Browse available skills |
+| `pushrec-skills install <name>` | Install a skill |
+| `pushrec-skills install --all` | Install all licensed skills |
+| `pushrec-skills update [name]` | Update installed skills |
+| `pushrec-skills search <query>` | Search the catalog |
+| `pushrec-skills info <name>` | Get skill details |
+| `pushrec-skills uninstall <name>` | Remove a skill |
+
+### Utility
+
 | Command | Description |
 |---------|-------------|
-| `skills auth <key>` | Activate your license key |
-| `skills list` | Browse available skills |
-| `skills install <name>` | Install a skill |
-| `skills update [name]` | Update installed skills |
-| `skills search <query>` | Search the catalog |
-| `skills info <name>` | Get skill details |
-| `skills uninstall <name>` | Remove a skill |
+| `pushrec-skills health` | Check registry connectivity |
 
 ## Registry
 

package/dist/index.js

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/index.ts
-var import_commander9 = require("commander");
+var import_commander10 = require("commander");
 
 // src/commands/auth.ts
 var import_commander = require("commander");
@@ -1470,8 +1470,12 @@ function createUninstallCommand() {
 
 // src/commands/health.ts
 var import_commander8 = require("commander");
+var import_chalk3 = __toESM(require("chalk"));
 function healthCommand() {
-  const cmd = new import_commander8.Command("health").description("Check registry server health").option("--json", "Output as JSON").action(async (opts) => {
+  const cmd = new import_commander8.Command("health").description("Check registry server health").option("--full", "Run full diagnostic (registry + license + device + skills)").option("--json", "Output as JSON").action(async (opts) => {
+    if (opts.full) {
+      return runFullDiagnostic(opts.json ?? false);
+    }
     let response;
     try {
       response = await registryFetch("/api/health");
@@ -1514,12 +1518,285 @@ function healthCommand() {
   });
   return cmd;
 }
+async function runFullDiagnostic(json) {
+  const checks = [];
+  try {
+    const response = await registryFetch("/api/health");
+    if (response.ok) {
+      checks.push({ name: "Registry", status: "pass", detail: `OK (${response.status})` });
+    } else {
+      checks.push({ name: "Registry", status: "fail", detail: `Unhealthy (${response.status})` });
+    }
+  } catch (err) {
+    checks.push({ name: "Registry", status: "fail", detail: `Unreachable: ${err instanceof Error ? err.message : String(err)}` });
+  }
+  const key = await retrieveLicenseKey();
+  if (!key) {
+    checks.push({ name: "License", status: "fail", detail: "No license key found. Run: pushrec-skills setup" });
+    checks.push({ name: "Device", status: "skip", detail: "Skipped (no license)" });
+    checks.push({ name: "Skills", status: "skip", detail: "Skipped (no license)" });
+    return printDiagnostic(checks, json);
+  }
+  const offlineResult = await verifyOffline(key);
+  if (!offlineResult.valid) {
+    checks.push({ name: "License", status: "fail", detail: `Invalid signature: ${offlineResult.error}` });
+    checks.push({ name: "Device", status: "skip", detail: "Skipped (invalid license)" });
+    checks.push({ name: "Skills", status: "skip", detail: "Skipped (invalid license)" });
+    return printDiagnostic(checks, json);
+  }
+  const fingerprint = getMachineFingerprint();
+  try {
+    const onlineResult = await verifyLicenseOnline(key, fingerprint);
+    if (onlineResult.valid) {
+      const status = onlineResult.status ?? "active";
+      const devices = `${onlineResult.deviceCount ?? "?"}/${onlineResult.maxDevices ?? "?"}`;
+      checks.push({ name: "License", status: "pass", detail: `${status} | devices: ${devices}` });
+      checks.push({ name: "Device", status: "pass", detail: `Registered (${devices} slots)` });
+    } else {
+      checks.push({ name: "License", status: "fail", detail: `Server rejected: ${onlineResult.error}` });
+      checks.push({ name: "Device", status: "fail", detail: "Not verified (license rejected)" });
+    }
+  } catch {
+    const cache = loadLicenseCache();
+    if (cache) {
+      const offlineStatus = checkOfflineStatus(cache);
+      if (offlineStatus.status === "disabled") {
+        checks.push({ name: "License", status: "fail", detail: `Offline too long: ${offlineStatus.message}` });
+        checks.push({ name: "Device", status: "fail", detail: "Cannot verify offline" });
+      } else {
+        checks.push({ name: "License", status: "warn", detail: `Cached (${offlineStatus.status}): ${offlineStatus.message ?? "OK"}` });
+        checks.push({ name: "Device", status: "warn", detail: "Using cached verification" });
+      }
+    } else {
+      checks.push({ name: "License", status: "fail", detail: "Cannot reach server and no cached verification" });
+      checks.push({ name: "Device", status: "fail", detail: "Cannot verify" });
+    }
+  }
+  const config = loadConfig();
+  const skillCount = Object.keys(config.installedSkills).length;
+  if (skillCount > 0) {
+    const names = Object.keys(config.installedSkills).join(", ");
+    checks.push({ name: "Skills", status: "pass", detail: `${skillCount} installed: ${names}` });
+  } else {
+    checks.push({ name: "Skills", status: "warn", detail: "No skills installed. Run: pushrec-skills install --all" });
+  }
+  printDiagnostic(checks, json);
+}
+function printDiagnostic(checks, json) {
+  if (json) {
+    const allPass = checks.every((c) => c.status === "pass" || c.status === "skip");
+    console.log(JSON.stringify({ ok: allPass, checks }, null, 2));
+    if (!allPass) process.exit(1);
+    return;
+  }
+  console.log("");
+  console.log(import_chalk3.default.bold("Pushrec Skills Health Check"));
+  console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log("");
+  let hasFailure = false;
+  for (const check of checks) {
+    const icon = check.status === "pass" ? import_chalk3.default.green("PASS") : check.status === "fail" ? import_chalk3.default.red("FAIL") : check.status === "warn" ? import_chalk3.default.yellow("WARN") : import_chalk3.default.dim("SKIP");
+    console.log(`  ${icon}  ${check.name}: ${check.detail}`);
+    if (check.status === "fail") hasFailure = true;
+  }
+  console.log("");
+  if (hasFailure) {
+    console.log(import_chalk3.default.red("Some checks failed. Fix the issues above and run again."));
+    process.exit(1);
+  } else {
+    console.log(import_chalk3.default.green("All systems go!"));
+  }
+}
+
+// src/commands/setup.ts
+var import_commander9 = require("commander");
+var import_readline2 = require("readline");
+var import_chalk4 = __toESM(require("chalk"));
+var import_ora2 = __toESM(require("ora"));
+function readInput2(question) {
+  const rl = (0, import_readline2.createInterface)({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve2, reject) => {
+    rl.on("error", (err) => {
+      rl.close();
+      reject(err);
+    });
+    rl.on("close", () => {
+      resolve2("");
+    });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve2(answer.trim());
+    });
+  });
+}
+function setupCommand() {
+  const cmd = new import_commander9.Command("setup").description("One-command onboarding: verify license, activate device, install all skills").option("--key <license-key>", "License key (or enter interactively)").option("--json", "Output JSON").action(async (opts) => {
+    const existing = await retrieveLicenseKey();
+    if (existing) {
+      if (opts.json) {
+        console.log(JSON.stringify({ ok: true, message: "Already set up" }));
+      } else {
+        console.log(import_chalk4.default.green("Already set up!") + " Run " + import_chalk4.default.cyan("pushrec-skills auth status") + " to check your license.");
+        console.log("To re-setup, run " + import_chalk4.default.cyan("pushrec-skills auth logout") + " first.");
+      }
+      return;
+    }
+    if (!opts.json) {
+      console.log("");
+      console.log(import_chalk4.default.bold("Pushrec Skills Setup"));
+      console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+      console.log("");
+    }
+    const key = opts.key ?? await readInput2("Paste your license key: ");
+    if (!key) {
+      if (opts.json) {
+        console.log(JSON.stringify({ ok: false, error: "No license key provided" }));
+      } else {
+        console.error("No license key provided.");
+      }
+      process.exit(1);
+    }
+    const verifySpinner = opts.json ? null : (0, import_ora2.default)("Verifying license signature...").start();
+    const offlineResult = await verifyOffline(key);
+    if (!offlineResult.valid) {
+      verifySpinner?.fail(`Invalid license key: ${offlineResult.error}`);
+      if (opts.json) {
+        console.log(JSON.stringify({ ok: false, error: `Invalid license key: ${offlineResult.error}` }));
+      }
+      process.exit(1);
+    }
+    verifySpinner?.succeed("License signature valid");
+    const onlineSpinner = opts.json ? null : (0, import_ora2.default)("Checking with server...").start();
+    const fingerprint = getMachineFingerprint();
+    let onlineResult;
+    try {
+      onlineResult = await verifyLicenseOnline(key, fingerprint);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      onlineSpinner?.fail(`Could not reach server: ${message}`);
+      if (opts.json) {
+        console.log(JSON.stringify({ ok: false, error: `Could not reach server: ${message}` }));
+      }
+      process.exit(1);
+    }
+    if (!onlineResult.valid) {
+      onlineSpinner?.fail(`License rejected: ${onlineResult.error}`);
+      if (opts.json) {
+        console.log(JSON.stringify({ ok: false, error: `License rejected: ${onlineResult.error}` }));
+      }
+      process.exit(1);
+    }
+    onlineSpinner?.succeed("Server confirmed license active");
+    await storeLicenseKey(key);
+    const deviceSpinner = opts.json ? null : (0, import_ora2.default)("Activating this device...").start();
+    let activation;
+    try {
+      activation = await activateDevice(
+        key,
+        fingerprint,
+        getPlatformName(),
+        getHostname()
+      );
+      deviceSpinner?.succeed(`Device activated (${activation.deviceCount}/${activation.maxDevices} slots used)`);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      deviceSpinner?.fail(`Device activation failed: ${message}`);
+      if (opts.json) {
+        console.log(JSON.stringify({ ok: false, error: `Device activation failed: ${message}` }));
+      }
+      process.exit(1);
+    }
+    const cache = {
+      verifiedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      expiresAt: onlineResult.updatesExpireAt ?? null,
+      fingerprint,
+      payload: {
+        buyerId: onlineResult.buyerId ?? 0,
+        email: onlineResult.email ?? "",
+        maxDevices: onlineResult.maxDevices ?? 3,
+        status: onlineResult.status ?? "active",
+        hasUpdates: onlineResult.hasUpdates ?? true,
+        deviceCount: onlineResult.deviceCount ?? 1
+      }
+    };
+    saveLicenseCache(cache);
+    if (!opts.json) {
+      console.log("");
+      console.log(import_chalk4.default.bold("Installing skills..."));
+    }
+    let catalog;
+    try {
+      catalog = await fetchSkillCatalog();
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      if (opts.json) {
+        console.log(JSON.stringify({ ok: true, activated: true, installed: 0, error: `Could not fetch catalog: ${message}` }));
+      } else {
+        console.error(`Could not fetch catalog: ${message}`);
+        console.log(import_chalk4.default.yellow("License activated but skill install failed. Run ") + import_chalk4.default.cyan("pushrec-skills install --all") + import_chalk4.default.yellow(" to retry."));
+      }
+      return;
+    }
+    const toInstall = catalog.items.filter((s) => !isSkillInstalled(s.name));
+    let installed = 0;
+    let failed = 0;
+    for (let i = 0; i < toInstall.length; i++) {
+      const skill = toInstall[i];
+      const prefix = opts.json ? "" : `[${i + 1}/${toInstall.length}] `;
+      const spinner = opts.json ? null : (0, import_ora2.default)(`${prefix}Installing ${skill.name}...`).start();
+      try {
+        const manifest = await fetchSkillManifest(skill.name);
+        const archive = await downloadSkill(skill.name);
+        const { path } = await installSkill(skill.name, archive);
+        const now = (/* @__PURE__ */ new Date()).toISOString();
+        const config = loadConfig();
+        config.installedSkills[skill.name] = {
+          name: skill.name,
+          version: manifest.currentVersion ?? "0.0.0",
+          installedAt: config.installedSkills[skill.name]?.installedAt ?? now,
+          updatedAt: now
+        };
+        updateConfig({ installedSkills: config.installedSkills });
+        spinner?.succeed(`${prefix}${skill.name} v${manifest.currentVersion ?? "latest"} installed to ${path}`);
+        installed++;
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        spinner?.fail(`${prefix}Failed to install ${skill.name}: ${message}`);
+        failed++;
+      }
+    }
+    const skipped = catalog.items.length - toInstall.length;
+    if (opts.json) {
+      console.log(JSON.stringify({
+        ok: true,
+        activated: true,
+        installed,
+        failed,
+        skipped,
+        total: catalog.items.length
+      }));
+    } else {
+      console.log("");
+      console.log(import_chalk4.default.green.bold("Setup complete!"));
+      console.log(`  ${import_chalk4.default.green("+")} ${installed} skills installed`);
+      if (skipped > 0) console.log(`  ${import_chalk4.default.dim("-")} ${skipped} already installed`);
+      if (failed > 0) console.log(`  ${import_chalk4.default.red("x")} ${failed} failed`);
+      console.log("");
+      console.log("Your skills are ready. Use " + import_chalk4.default.cyan("/<skill-name>") + " in your next Claude Code session.");
+      console.log("Run " + import_chalk4.default.cyan("pushrec-skills health --full") + " to verify everything works.");
+    }
+  });
+  return cmd;
+}
 
 // src/index.ts
-var program = new import_commander9.Command();
+var program = new import_commander10.Command();
 program.name("pushrec-skills").description(
   "Install, update, and manage premium Claude Code skills from Pushrec"
-).version("0.1.0");
+).version("0.2.0");
 program.addCommand(authCommand());
 program.addCommand(installCommand());
 program.addCommand(updateCommand());
@@ -1528,6 +1805,7 @@ program.addCommand(searchCommand());
 program.addCommand(infoCommand());
 program.addCommand(createUninstallCommand());
 program.addCommand(healthCommand());
+program.addCommand(setupCommand());
 program.parseAsync().catch((err) => {
   console.error(err instanceof Error ? err.message : String(err));
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushrec/skills",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Install, update, and manage premium Claude Code skills from Pushrec",
   "license": "UNLICENSED",
   "bin": {