@test-lab-ai/cli 0.2.5 → 0.2.7

package/AGENTS.md

@@ -33,7 +33,9 @@ npx @test-lab-ai/cli --help
    - If the user's repo has a test-lab plan skill/format, prefer it.
 3. **Write** the plans to a JSON file (or a directory of `*.json`).
 4. **Run** `testlab import <path>`. Use `--dry-run` first to show the user the
-   creation order without writing anything.
+   creation order without writing anything. To file the plans under a project,
+   run `testlab projects list` and pass `--project <id|name>` (auto-picked if
+   there is only one; omit for account-level).
 
 Authentication: the user runs `testlab login` once (browser), or you set
 `TESTLAB_API_KEY` in the environment for a fully headless run.

package/bin/testlab.mjs

@@ -24,7 +24,7 @@ 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 } from "../lib/update-check.mjs"
+import { checkForUpdate, currentVersion } from "../lib/update-check.mjs"
 
 const log = (...a) => console.log(...a)
 function errExit(msg) {
@@ -41,6 +41,7 @@ Usage:
                                             (credentials, labels, fixtures, plans)
   testlab plans list                       List your test plans
   testlab plans create -f plan.json        Create one plan from JSON
+  testlab projects list                    List your projects
   testlab credentials set <key> --value <value>     Set a credential ({{credentials.<key>}})
   testlab credentials list                 List credential keys (values never shown)
   testlab labels list                      List your labels
@@ -56,6 +57,8 @@ Options:
   --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
+  --project <id|name>  (import/plans) assign plans to a project, or "none" for account-level
+  --version, -v     Print the installed CLI version
 
 Get a key at https://test-lab.ai/admin/settings/api-keys · run \`testlab examples\` for JSON shapes`
 
@@ -74,6 +77,8 @@ function parse() {
       force: { type: "boolean" },
       global: { type: "boolean" },
       agent: { type: "string" },
+      project: { type: "string" },
+      version: { type: "boolean", short: "v" },
       help: { type: "boolean", short: "h" },
     },
   })
@@ -183,7 +188,8 @@ async function cmdPlansCreate(flags) {
   } else {
     errExit("provide -f <plan.json>, or both --name and --prompt")
   }
-  const r = await apiFetch(apiUrl, apiKey, "POST", "/api/v1/test-plans", plan)
+  const projectId = plan.projectId ?? (await resolveProjectId(apiUrl, apiKey, flags))
+  const r = await apiFetch(apiUrl, apiKey, "POST", "/api/v1/test-plans", { ...plan, projectId })
   if (!r.ok) errExit(`${r.status}: ${r.json?.error || ""}`)
   log(`✓ Created plan #${r.json.testPlan.id}: ${r.json.testPlan.name}`)
 }
@@ -229,6 +235,60 @@ async function cmdLabelsList(flags) {
   log(`\n${labels.length} label(s)`)
 }
 
+// Resolve which project imported plans go into.
+//   --project none        -> null (account-level, no project)
+//   --project <id|name>   -> that project
+//   (no flag)             -> 0 projects: null; 1 project: auto; many: prompt (TTY)
+//                            or, for an agent/CI (no TTY), error listing the choices.
+async function resolveProjectId(apiUrl, apiKey, flags) {
+  const flag = flags.project
+  if (flag === "none" || flag === "null") return null
+  const r = await apiFetch(apiUrl, apiKey, "GET", "/api/v1/projects")
+  if (!r.ok) errExit(`could not list projects (${r.status}): ${r.json?.error || ""}`)
+  const projects = r.json?.projects || []
+  if (flag) {
+    const match = /^\d+$/.test(flag)
+      ? projects.find((p) => p.id === parseInt(flag, 10))
+      : projects.find((p) => p.name.toLowerCase() === flag.toLowerCase())
+    if (!match) {
+      errExit(`project "${flag}" not found. Available: ${projects.map((p) => p.name).join(", ") || "(none)"}`)
+    }
+    return match.id
+  }
+  if (projects.length === 0) return null
+  if (projects.length === 1) {
+    log(`Using project: ${projects[0].name} (#${projects[0].id})`)
+    return projects[0].id
+  }
+  if (!process.stdin.isTTY) {
+    errExit(
+      `You have ${projects.length} projects — pick one with --project <id|name> (or --project none):\n` +
+        projects.map((p) => `  ${p.id}  ${p.name}`).join("\n")
+    )
+  }
+  log(`Which project should these plans go in?`)
+  projects.forEach((p, i) => log(`  ${i + 1}. ${p.name}  (#${p.id})`))
+  log(`  0. None (account-level)`)
+  const ans = await promptLine("Project [number]: ")
+  if (ans === "0") return null
+  const idx = parseInt(ans, 10)
+  if (idx >= 1 && idx <= projects.length) return projects[idx - 1].id
+  errExit("invalid selection")
+}
+
+async function cmdProjectsList(flags) {
+  const { apiKey, apiUrl } = requireAuth(flags)
+  const r = await apiFetch(apiUrl, apiKey, "GET", "/api/v1/projects")
+  if (!r.ok) errExit(`${r.status}: ${r.json?.error || ""}`)
+  const projects = r.json?.projects || []
+  if (projects.length === 0) {
+    log("No projects yet. Imported plans stay account-level unless you create a project in the dashboard.")
+    return
+  }
+  for (const p of projects) log(`  #${p.id}  ${p.name}`)
+  log(`\n${projects.length} project(s)`)
+}
+
 async function cmdImport(flags, args) {
   const target = args[1]
   if (!target) errExit("usage: testlab import <path> [--dry-run]")
@@ -241,8 +301,10 @@ async function cmdImport(flags, args) {
   const dryRun = flags["dry-run"]
   // --dry-run validates locally and never calls the API, so it doesn't need auth.
   const { apiKey, apiUrl } = dryRun ? resolveAuth(flags) : requireAuth(flags)
+  // Resolve the target project (auto-pick / prompt / --project) for real imports only.
+  const projectId = dryRun || loaded.plans.length === 0 ? null : await resolveProjectId(apiUrl, apiKey, flags)
   log(`Importing from ${target}: ${loaded.plans.length} plan(s), ${loaded.credentials.length} credential(s), ${loaded.labels.length} label(s), ${loaded.fixtures.length} fixture(s)`)
-  const res = await runImport({ apiUrl, apiKey, ...loaded, dryRun, log })
+  const res = await runImport({ apiUrl, apiKey, projectId, ...loaded, dryRun, log })
   if (!res.ok && !res.dryRun) process.exit(1)
 }
 
@@ -342,6 +404,11 @@ async function main() {
 
   checkForUpdate() // best-effort "update available" notice (cached, non-blocking)
 
+  if (flags.version || args[0] === "version") {
+    log(currentVersion() || "unknown")
+    return
+  }
+
   if (flags.help || args.length === 0 || args[0] === "help") {
     log(HELP)
     return
@@ -356,6 +423,9 @@ async function main() {
       if (args[1] === "list") return cmdPlansList(flags)
       if (args[1] === "create") return cmdPlansCreate(flags)
       return errExit("usage: testlab plans <list|create>")
+    case "projects":
+      if (args[1] === "list") return cmdProjectsList(flags)
+      return errExit("usage: testlab projects list")
     case "credentials":
       if (args[1] === "set") return cmdCredentialsSet(flags, args)
       if (args[1] === "list") return cmdCredentialsList(flags)

package/lib/examples.mjs

@@ -71,6 +71,7 @@ JSON (under "plans"):
     "agentType": "functional",             // functional|accessibility|uiux|exploratory|performance|security
     "devices": ["Desktop Chrome"],         // or ["iPhone 15 Pro"]
     "labels": ["smoke", "auth"],
+    "projectId": 12,                       // optional: assign to a project (else account-level)
     "failOnPreStepFailure": true
   }
 Pre-steps (run another plan first, sharing browser state):
@@ -80,6 +81,7 @@ Pre-steps (run another plan first, sharing browser state):
     { "testPlanId": 42 }                   // an existing plan by id
   ]
 Rules: name <=200 chars; prompt <=32KB; <=25 labels; <=25 preSteps.
+Projects: omit projectId to import account-level. Run "testlab projects list" for ids; "testlab import --project <id|name>" (or --project none) sets it for the whole import, and is auto-picked when you have exactly one.
 
 ═══════════════════════════════════════════════════════════════════════════
 IMPORT BUNDLE  — create everything at once:  testlab import ./bundle.json

package/lib/import.mjs

@@ -90,6 +90,7 @@ export async function runImport({
   labels = [],
   fixtures = [],
   plans = [],
+  projectId = null,
   dryRun = false,
   log = console.log,
 }) {
@@ -187,6 +188,7 @@ export async function runImport({
       cookies: plan.cookies,
       headers: plan.headers,
       failOnPreStepFailure: plan.failOnPreStepFailure,
+      projectId: plan.projectId ?? projectId, // per-plan id wins, else the resolved import-wide project
       preSteps: normalizePreSteps(plan.preSteps, refToId),
     }
     const r = await apiFetch(apiUrl, apiKey, "POST", "/api/v1/test-plans", payload)

package/package.json

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