@test-lab-ai/cli 0.2.0 → 0.2.2

package/README.md

@@ -100,6 +100,19 @@ in the file doesn't matter. Re-running is safe for credentials/labels/fixtures
 - `{{data.FIXTURE.FIELD}}` — a value from a data fixture (generated test data).
 - `{{run.shortId}}` — a unique per-run id (for unique emails, names, etc.).
 
+## Install the test-lab-plan skill (Claude Code)
+
+The companion skill that *writes* test-lab plans — so an AI agent can design a
+plan, then this CLI imports it:
+
+```bash
+testlab skills install            # into ./.claude/skills (this project)
+testlab skills install --global   # into ~/.claude/skills (all projects)
+```
+
+Restart Claude Code to load it. It installs from the public skills mirror, so
+you always get the latest version. (Targets Claude Code's `.claude/skills/` layout.)
+
 ## For AI agents
 
 Run **`testlab examples`** for the complete JSON reference, or read `AGENTS.md`
@@ -108,10 +121,8 @@ convert each into the plan/fixture JSON above (explicit URL in the prompt,
 secrets as `{{credentials.X}}`, generated data as `{{data.X.Y}}`) →
 `testlab import`.
 
-## Advanced
+## Under the hood
 
-- `--api-url <url>` (or `TESTLAB_API_URL`) targets a non-prod instance (local dev
-  / self-hosted). Normal users never need it.
-- Every command is a thin wrapper over the public
-  [Import API](https://test-lab.ai/docs/api/test-plans); an agent can call that
-  directly instead of shelling out to the CLI.
+Every command is a thin wrapper over the public
+[Import API](https://test-lab.ai/docs/api/test-plans); an agent can call that
+directly instead of shelling out to the CLI.

package/bin/testlab.mjs

@@ -23,6 +23,7 @@ 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, resolveSkillsDir, installSkill } from "../lib/skills.mjs"
 
 const log = (...a) => console.log(...a)
 function errExit(msg) {
@@ -44,15 +45,15 @@ Usage:
   testlab data create -f fixture.json      Create a data fixture ({{data.KEY.FIELD}})
   testlab examples                         Print the full JSON reference for every
                                            resource (designed for AI agents)
+  testlab skills install [--global]        Install the test-lab-plan skill into Claude Code
 
 Options:
   --key <tl_…>      API key (else $TESTLAB_API_KEY or ~/.test-lab/config.json)
   --stdin           Read the value (key/credential) from stdin
   --force           (login) re-authenticate even if a stored key still works
   --dry-run         (import) validate + print plan order without writing
-  --api-url <url>   Target a non-prod instance (default https://www.test-lab.ai)
 
-Get a key at <api-url>/admin/settings/api-keys · run \`testlab examples\` for JSON shapes`
+Get a key at https://test-lab.ai/admin/settings/api-keys · run \`testlab examples\` for JSON shapes`
 
 function parse() {
   return parseArgs({
@@ -67,6 +68,8 @@ function parse() {
       "dry-run": { type: "boolean" },
       stdin: { type: "boolean" },
       force: { type: "boolean" },
+      global: { type: "boolean" },
+      dir: { type: "string" },
       help: { type: "boolean", short: "h" },
     },
   })
@@ -249,6 +252,26 @@ function cmdExamples() {
   log(EXAMPLES_TEXT)
 }
 
+async function cmdSkillsInstall(flags, args) {
+  const requested = args[2] ? [args[2]] : TESTLAB_SKILLS
+  const targetDir = resolveSkillsDir({ global: flags.global, dir: flags.dir })
+  for (const name of requested) {
+    try {
+      const res = await installSkill(name, targetDir)
+      log(`✓ Installed ${res.name} (${res.count} file${res.count === 1 ? "" : "s"}) → ${res.dir}`)
+    } catch (e) {
+      errExit(`failed to install ${name}: ${e.message}`)
+    }
+  }
+  log(`\nRestart Claude Code (start a new session) to load the skill.`)
+}
+
+function cmdSkillsList() {
+  log(`Available test-lab skills:`)
+  for (const s of TESTLAB_SKILLS) log(`  ${s}`)
+  log(`\nInstall with: testlab skills install [name] [--global]`)
+}
+
 async function main() {
   let parsed
   try {
@@ -282,6 +305,10 @@ async function main() {
       return errExit("usage: testlab data <list|create>")
     case "examples":
       return cmdExamples()
+    case "skills":
+      if (args[1] === "install") return cmdSkillsInstall(flags, args)
+      if (args[1] === "list") return cmdSkillsList()
+      return errExit("usage: testlab skills <install|list> [name] [--global]")
     case "import":
       return cmdImport(flags, args)
     default:

package/lib/config.mjs

@@ -36,9 +36,6 @@ export function saveConfig(cfg) {
 export function resolveAuth(flags) {
   const cfg = loadConfig()
   const apiKey = flags.key || process.env.TESTLAB_API_KEY || cfg.apiKey || null
-  const apiUrl = (flags["api-url"] || process.env.TESTLAB_API_URL || cfg.apiUrl || DEFAULT_API_URL).replace(
-    /\/+$/,
-    ""
-  )
+  const apiUrl = (flags["api-url"] || cfg.apiUrl || DEFAULT_API_URL).replace(/\/+$/, "")
   return { apiKey, apiUrl }
 }

package/lib/login.mjs

@@ -38,7 +38,7 @@ function openBrowser(url) {
   }
 }
 
-export function browserLogin(apiUrl, { timeoutMs = 180000 } = {}) {
+export function browserLogin(apiUrl, { timeoutMs = 600000 } = {}) {
   const state = crypto.randomBytes(16).toString("hex")
 
   return new Promise((resolve, reject) => {
@@ -80,13 +80,14 @@ export function browserLogin(apiUrl, { timeoutMs = 180000 } = {}) {
 
     const timer = setTimeout(() => {
       server.close()
-      reject(new Error("login timed out after 3 minutes"))
+      reject(new Error("login timed out after 10 minutes"))
     }, timeoutMs)
 
     server.listen(0, "127.0.0.1", () => {
       const { port } = server.address()
       const authUrl = `${apiUrl}/cli/authorize?state=${state}&port=${port}`
       console.log(`Opening your browser to authorize the CLI:\n  ${authUrl}\n`)
+      console.log(`Waiting for you to approve in the browser (up to 10 minutes)…\n`)
       openBrowser(authUrl)
     })
   })

package/lib/skills.mjs

@@ -0,0 +1,61 @@
+/**
+ * Install test-lab skills (e.g. test-lab-plan) into a local agent's skills
+ * directory by fetching them from the public Test-Lab-ai/skills mirror.
+ *
+ * Zero-dep: global fetch + node:fs. Targets Claude Code's
+ * .claude/skills/<name>/ layout — project dir by default, ~/.claude with
+ * --global, or an explicit --dir. The mirror is the single source of truth,
+ * so this always installs the latest published skill.
+ */
+import fs from "node:fs"
+import os from "node:os"
+import path from "node:path"
+
+const MIRROR = "Test-Lab-ai/skills"
+const MIRROR_BRANCH = "main"
+
+// Skills published by test-lab. Add new skill directory names here.
+export const TESTLAB_SKILLS = ["test-lab-plan"]
+
+export function resolveSkillsDir({ global, dir } = {}) {
+  if (dir) return path.resolve(dir)
+  if (global) return path.join(os.homedir(), ".claude", "skills")
+  return path.join(process.cwd(), ".claude", "skills")
+}
+
+const UA = { "User-Agent": "test-lab-cli" }
+
+// List the blob paths under skills/<name>/ in the mirror's tree.
+async function listSkillFiles(name) {
+  const r = await fetch(
+    `https://api.github.com/repos/${MIRROR}/git/trees/${MIRROR_BRANCH}?recursive=1`,
+    { headers: { ...UA, Accept: "application/vnd.github+json" } }
+  )
+  if (!r.ok) throw new Error(`could not list ${MIRROR} (${r.status})`)
+  const tree = await r.json()
+  const prefix = `skills/${name}/`
+  return (tree.tree || [])
+    .filter((e) => e.type === "blob" && typeof e.path === "string" && e.path.startsWith(prefix))
+    .map((e) => e.path)
+}
+
+/** Fetch every file of one skill from the mirror and write it under targetDir/<name>/. */
+export async function installSkill(name, targetDir) {
+  const files = await listSkillFiles(name)
+  if (files.length === 0) throw new Error(`skill "${name}" not found in ${MIRROR}`)
+  const prefix = `skills/${name}/`
+  let count = 0
+  for (const p of files) {
+    const rel = p.slice(prefix.length)
+    const raw = await fetch(`https://raw.githubusercontent.com/${MIRROR}/${MIRROR_BRANCH}/${p}`, {
+      headers: UA,
+    })
+    if (!raw.ok) throw new Error(`could not fetch ${p} (${raw.status})`)
+    const body = await raw.text()
+    const dest = path.join(targetDir, name, rel)
+    fs.mkdirSync(path.dirname(dest), { recursive: true })
+    fs.writeFileSync(dest, body)
+    count++
+  }
+  return { name, count, dir: path.join(targetDir, name) }
+}

package/package.json

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