@test-lab-ai/cli 0.2.7 → 0.2.8

package/README.md

@@ -123,6 +123,9 @@ Cursor user rules are set in Cursor's Settings. Restart your agent to load it.
 It installs from the public [`Test-Lab-ai/skills`](https://github.com/Test-Lab-ai/skills)
 mirror, so you always get the latest version.
 
+`testlab skills update` refreshes every installed copy to the latest, and the CLI
+also refreshes them automatically the first time you run it after an upgrade.
+
 ## For AI agents
 
 Run **`testlab examples`** for the complete JSON reference, or read `AGENTS.md`

package/bin/testlab.mjs

@@ -23,8 +23,8 @@ import { apiFetch } from "../lib/api.mjs"
 import { loadImportFile, runImport } from "../lib/import.mjs"
 import { browserLogin } from "../lib/login.mjs"
 import { EXAMPLES_TEXT } from "../lib/examples.mjs"
-import { TESTLAB_SKILLS, AGENTS, detectAgents, installSkill } from "../lib/skills.mjs"
-import { checkForUpdate, currentVersion } from "../lib/update-check.mjs"
+import { TESTLAB_SKILLS, AGENTS, detectAgents, installSkill, installedSkillLocations } from "../lib/skills.mjs"
+import { checkForUpdate, currentVersion, previousRunVersion } from "../lib/update-check.mjs"
 
 const log = (...a) => console.log(...a)
 function errExit(msg) {
@@ -51,6 +51,7 @@ Usage:
                                            resource (designed for AI agents)
   testlab skills install [--agent ...]     Install the test-lab-plan skill (auto-detects
                                            Claude/Codex/Cursor; --agent claude|codex|cursor|all)
+  testlab skills update                    Refresh installed skills (also auto-runs after a CLI upgrade)
 
 Options:
   --key <tl_…>      API key (else $TESTLAB_API_KEY or ~/.test-lab/config.json)
@@ -392,6 +393,46 @@ function cmdSkillsList() {
   log(`\nInstall with: testlab skills install [name] [--agent ${AGENTS.join("|")}|all]`)
 }
 
+async function cmdSkillsUpdate() {
+  let refreshed = 0
+  for (const name of TESTLAB_SKILLS) {
+    for (const loc of installedSkillLocations(name)) {
+      try {
+        const res = await installSkill(name, loc.agent, { global: loc.global })
+        refreshed++
+        log(`✓ ${name} → ${loc.agent}${loc.global ? " (global)" : ""}: ${res.dest}`)
+      } catch (e) {
+        log(`  ✗ ${name} (${loc.agent}): ${e.message}`)
+      }
+    }
+  }
+  if (refreshed === 0) log("No installed skills found here. Run `testlab skills install` first.")
+  else log(`\nRefreshed ${refreshed} location(s). Restart your agent to load the changes.`)
+}
+
+// After a CLI upgrade, refresh any already-installed skills in place — runs once
+// per version bump (best effort). Skipped in CI / when NO_UPDATE_NOTIFIER is set.
+async function maybeRefreshSkillsOnUpgrade() {
+  if (process.env.CI || process.env.NO_UPDATE_NOTIFIER) return
+  const ver = currentVersion()
+  const prev = previousRunVersion(ver)
+  if (!prev || prev === ver) return
+  let refreshed = 0
+  for (const name of TESTLAB_SKILLS) {
+    for (const loc of installedSkillLocations(name)) {
+      try {
+        await installSkill(name, loc.agent, { global: loc.global })
+        refreshed++
+      } catch {
+        /* best effort — never break the actual command */
+      }
+    }
+  }
+  if (refreshed > 0) {
+    process.stderr.write(`↻ CLI upgraded ${prev} → ${ver}; refreshed ${refreshed} installed skill location(s).\n`)
+  }
+}
+
 async function main() {
   let parsed
   try {
@@ -414,6 +455,8 @@ async function main() {
     return
   }
 
+  await maybeRefreshSkillsOnUpgrade()
+
   switch (args[0]) {
     case "login":
       return cmdLogin(flags)
@@ -441,8 +484,9 @@ async function main() {
       return cmdExamples()
     case "skills":
       if (args[1] === "install") return cmdSkillsInstall(flags, args)
+      if (args[1] === "update") return cmdSkillsUpdate()
       if (args[1] === "list") return cmdSkillsList()
-      return errExit("usage: testlab skills <install|list> [name] [--global]")
+      return errExit("usage: testlab skills <install|update|list> [name] [--global]")
     case "import":
       return cmdImport(flags, args)
     default:

package/lib/skills.mjs

@@ -51,6 +51,23 @@ export function detectAgents() {
   return [...found]
 }
 
+/**
+ * Where skill `name` is already installed — project (cwd) and global locations
+ * across all agents — filtered to the paths that actually exist. Used to
+ * refresh installed skills (on `skills update` and after a CLI upgrade).
+ */
+export function installedSkillLocations(name) {
+  const home = os.homedir()
+  const cwd = process.cwd()
+  return [
+    { agent: "claude", global: false, path: path.join(cwd, ".claude", "skills", name) },
+    { agent: "codex", global: false, path: path.join(cwd, ".agents", "skills", name) },
+    { agent: "cursor", global: false, path: path.join(cwd, ".cursor", "rules", `${name}.mdc`) },
+    { agent: "claude", global: true, path: path.join(home, ".claude", "skills", name) },
+    { agent: "codex", global: true, path: path.join(home, ".agents", "skills", name) },
+  ].filter((c) => fs.existsSync(c.path))
+}
+
 /** Resolve the install target (base dir + format) for one agent. */
 export function agentTarget(agent, { global } = {}) {
   const home = os.homedir()

package/lib/update-check.mjs

@@ -2,7 +2,7 @@
  * Best-effort "update available" notice.
  *
  * Design constraints: never block, slow, or break a command. It reads a cached
- * latest-version (checked against the npm registry at most once/day), prints a
+ * latest-version (checked against the npm registry at most every few hours), prints a
  * one-line notice to STDERR when the running version is behind, and kicks off a
  * background refresh for next time. Any failure (offline, slow/forbidden
  * registry) is swallowed. Suppressed when stderr isn't a TTY (pipes / CI /
@@ -15,7 +15,7 @@ import path from "node:path"
 const PKG = "@test-lab-ai/cli"
 const REGISTRY = "https://registry.npmjs.org/@test-lab-ai%2Fcli"
 const CACHE = path.join(os.homedir(), ".test-lab", "update-check.json")
-const DAY = 24 * 60 * 60 * 1000
+const CHECK_TTL = 3 * 60 * 60 * 1000 // re-check npm at most every 3h
 
 export function currentVersion() {
   try {
@@ -70,16 +70,29 @@ export function checkForUpdate() {
   const notice = updateNotice(current, cache.latest)
   if (notice) process.stderr.write(notice + "\n")
 
-  if (!cache.lastCheck || Date.now() - cache.lastCheck > DAY) {
+  if (!cache.lastCheck || Date.now() - cache.lastCheck > CHECK_TTL) {
     const ctrl = new AbortController()
     const timer = setTimeout(() => ctrl.abort(), 2000)
     fetch(REGISTRY, { signal: ctrl.signal, headers: { Accept: "application/vnd.npm.install-v1+json" } })
       .then((r) => (r.ok ? r.json() : null))
       .then((j) => {
         const latest = j && j["dist-tags"] && j["dist-tags"].latest
-        if (latest) writeCache({ lastCheck: Date.now(), latest })
+        if (latest) writeCache({ ...cache, lastCheck: Date.now(), latest })
       })
       .catch(() => {})
       .finally(() => clearTimeout(timer))
   }
 }
+
+/**
+ * Record the running CLI version and return the version seen on the PREVIOUS
+ * run (null on first run). Lets the CLI notice "I was just upgraded" so it can
+ * refresh installed skills. Merges into the shared cache so it doesn't clobber
+ * the update-check state.
+ */
+export function previousRunVersion(current) {
+  const cache = readCache()
+  const prev = cache.cliVersion || null
+  if (prev !== current) writeCache({ ...cache, cliVersion: current })
+  return prev
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@test-lab-ai/cli",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "Import existing test plans into test-lab.ai from the command line (or an AI agent).",
   "type": "module",
   "bin": {