@hasna/testers 0.0.25 → 0.0.27

package/dist/cli/index.js

@@ -27119,7 +27119,7 @@ import chalk6 from "chalk";
 // package.json
 var package_default = {
   name: "@hasna/testers",
-  version: "0.0.25",
+  version: "0.0.27",
   description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
   type: "module",
   main: "dist/index.js",
@@ -29607,12 +29607,48 @@ program2.command("results <run-id>").description("Show results for a test run").
     process.exit(1);
   }
 });
-program2.command("screenshots <id>").description("List screenshots for a run or result").action((id) => {
+program2.command("screenshots <id>").description("List screenshots for a run or result").option("--json", "Output as JSON", false).option("-l, --limit <n>", "Limit results", "200").option("--offset <n>", "Skip first N results", "0").action((id, opts) => {
   try {
+    const limit = Math.max(1, parseInt(opts.limit, 10) || 200);
+    const offset = Math.max(0, parseInt(opts.offset, 10) || 0);
     const run = getRun(id);
     if (run) {
       const results = getResultsByRun(run.id);
-      let total = 0;
+      const flattened = [];
+      for (const result of results) {
+        const screenshots2 = listScreenshots(result.id);
+        const scenario = getScenario(result.scenarioId);
+        for (const ss of screenshots2) {
+          flattened.push({
+            screenshotId: ss.id,
+            resultId: result.id,
+            scenarioId: result.scenarioId,
+            scenarioShortId: scenario?.shortId ?? null,
+            scenarioName: scenario?.name ?? null,
+            stepNumber: ss.stepNumber,
+            action: ss.action,
+            filePath: ss.filePath,
+            timestamp: ss.timestamp,
+            width: ss.width,
+            height: ss.height
+          });
+        }
+      }
+      const paged2 = flattened.slice(offset, offset + limit);
+      if (opts.json) {
+        log(JSON.stringify({
+          input: id,
+          type: "run",
+          runId: run.id,
+          total: flattened.length,
+          limit,
+          offset,
+          items: paged2
+        }, null, 2));
+        return;
+      }
+      let seen = 0;
+      let shown = 0;
       log("");
       log(chalk6.bold(`  Screenshots for run ${run.id.slice(0, 8)}`));
       log("");
@@ -29621,28 +29657,70 @@ program2.command("screenshots <id>").description("List screenshots for a run or
         if (screenshots2.length > 0) {
           const scenario = getScenario(result.scenarioId);
           const label = scenario ? `${scenario.shortId}: ${scenario.name}` : result.scenarioId.slice(0, 8);
-          log(chalk6.bold(`  ${label}`));
+          let sectionPrinted = false;
           for (const ss of screenshots2) {
+            if (seen < offset) {
+              seen++;
+              continue;
+            }
+            if (shown >= limit)
+              break;
+            if (!sectionPrinted) {
+              log(chalk6.bold(`  ${label}`));
+              sectionPrinted = true;
+            }
             log(`    ${chalk6.dim(String(ss.stepNumber).padStart(3, "0"))} ${ss.action} \u2014 ${chalk6.dim(ss.filePath)}`);
-            total++;
+            seen++;
+            shown++;
           }
-          log("");
+          if (sectionPrinted)
+            log("");
+          if (shown >= limit)
+            break;
         }
       }
-      if (total === 0) {
+      if (flattened.length === 0 || shown === 0) {
         log(chalk6.dim("  No screenshots found."));
         log("");
+      } else if (offset + shown < flattened.length) {
+        log(chalk6.dim(`  Showing ${shown} of ${flattened.length} screenshots (use --limit/--offset to paginate)`));
+        log("");
       }
       return;
     }
     const screenshots = listScreenshots(id);
+    const paged = screenshots.slice(offset, offset + limit);
+    if (opts.json) {
+      log(JSON.stringify({
+        input: id,
+        type: "result",
+        resultId: id,
+        total: screenshots.length,
+        limit,
+        offset,
+        items: paged.map((ss) => ({
+          screenshotId: ss.id,
+          stepNumber: ss.stepNumber,
+          action: ss.action,
+          filePath: ss.filePath,
+          timestamp: ss.timestamp,
+          width: ss.width,
+          height: ss.height
+        }))
+      }, null, 2));
+      return;
+    }
     if (screenshots.length > 0) {
       log("");
       log(chalk6.bold(`  Screenshots for result ${id.slice(0, 8)}`));
       log("");
-      for (const ss of screenshots) {
+      for (const ss of paged) {
         log(`  ${chalk6.dim(String(ss.stepNumber).padStart(3, "0"))} ${ss.action} \u2014 ${chalk6.dim(ss.filePath)}`);
       }
+      if (paged.length < screenshots.length) {
+        log("");
+        log(chalk6.dim(`  Showing ${paged.length} of ${screenshots.length} screenshots (use --limit/--offset to paginate)`));
+      }
       log("");
       return;
     }
@@ -29821,10 +29899,28 @@ projectCmd.command("create <name>").description("Create a new project").option("
     process.exit(1);
   }
 });
-projectCmd.command("list").description("List all projects").action(() => {
+projectCmd.command("list").description("List all projects").option("--json", "Output as JSON", false).option("--search <text>", "Filter by project name/path (case-insensitive substring)").option("-l, --limit <n>", "Limit results", "100").option("--offset <n>", "Skip first N results", "0").action((opts) => {
   try {
-    const projects = listProjects();
-    if (projects.length === 0) {
+    const limit = Math.max(1, parseInt(opts.limit, 10) || 100);
+    const offset = Math.max(0, parseInt(opts.offset, 10) || 0);
+    const search = typeof opts.search === "string" && opts.search.trim().length > 0 ? opts.search.trim().toLowerCase() : null;
+    const allProjects = listProjects();
+    const filtered = search ? allProjects.filter((p) => {
+      const name = p.name.toLowerCase();
+      const path = (p.path ?? "").toLowerCase();
+      return name.includes(search) || path.includes(search);
+    }) : allProjects;
+    const paged = filtered.slice(offset, offset + limit);
+    if (opts.json) {
+      log(JSON.stringify({
+        total: filtered.length,
+        limit,
+        offset,
+        items: paged
+      }, null, 2));
+      return;
+    }
+    if (filtered.length === 0) {
       log(chalk6.dim("No projects found."));
       return;
     }
@@ -29833,9 +29929,13 @@ projectCmd.command("list").description("List all projects").action(() => {
     log("");
     log(`  ${"ID".padEnd(38)} ${"Name".padEnd(24)} ${"Path".padEnd(30)} Created`);
     log(`  ${"\u2500".repeat(38)} ${"\u2500".repeat(24)} ${"\u2500".repeat(30)} ${"\u2500".repeat(20)}`);
-    for (const p of projects) {
+    for (const p of paged) {
       log(`  ${p.id.padEnd(38)} ${p.name.padEnd(24)} ${(p.path ?? chalk6.dim("\u2014")).toString().padEnd(30)} ${p.createdAt}`);
     }
+    if (offset + paged.length < filtered.length) {
+      log("");
+      log(chalk6.dim(`  Showing ${paged.length} of ${filtered.length} projects (use --limit/--offset to paginate)`));
+    }
     log("");
   } catch (error) {
     logError(chalk6.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
@@ -30615,9 +30715,13 @@ envCmd.command("add <name>").description("Add a named environment").requiredOpti
     process.exit(1);
   }
 });
-envCmd.command("list").description("List all environments").option("--project <id>", "Filter by project ID").action((opts) => {
+envCmd.command("list").description("List all environments").option("--project <id>", "Filter by project ID").option("--json", "Output as JSON", false).action((opts) => {
   try {
     const envs = listEnvironments(opts.project);
+    if (opts.json) {
+      log(JSON.stringify({ total: envs.length, items: envs }, null, 2));
+      return;
+    }
     if (envs.length === 0) {
       log(chalk6.dim("No environments configured. Add one with: testers env add <name> --url <url>"));
       return;

package/dist/mcp/index.js

@@ -22994,6 +22994,22 @@ async function runApiChecksByFilter(filter) {
 // src/mcp/index.ts
 init_personas();
 init_paths();
+var cliArgs = new Set(process.argv.slice(2));
+if (cliArgs.has("--help") || cliArgs.has("-h")) {
+  console.log(`Usage: testers-mcp [options]
+
+Open Testers MCP server (stdio transport)
+
+Options:
+  -h, --help       Show this help message
+  -V, --version    Show version
+`);
+  process.exit(0);
+}
+if (cliArgs.has("--version") || cliArgs.has("-V")) {
+  console.log("0.0.1");
+  process.exit(0);
+}
 function json(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 }
@@ -23285,18 +23301,6 @@ server.tool("list_agents", "List all registered agents", {}, async () => {
     return errorResponse(error);
   }
 });
-server.tool("import_from_todos", "Import test scenarios from the todos database", {
-  projectName: exports_external.string().optional().describe("Todos project name to filter by"),
-  tags: exports_external.array(exports_external.string()).optional().describe("Tags to filter todos tasks"),
-  projectId: exports_external.string().optional().describe("Target project ID for imported scenarios")
-}, async ({ projectName, tags, projectId }) => {
-  try {
-    const result = importFromTodos({ projectName, tags, projectId });
-    return json(result);
-  } catch (error) {
-    return errorResponse(error);
-  }
-});
 server.tool("get_status", "Get system status: DB path, API key, scenario and run counts", {}, async () => {
   try {
     const config = loadConfig();
@@ -23327,97 +23331,6 @@ server.tool("scenario_exists", "Check whether a scenario with the given name exi
     return errorResponse(error);
   }
 });
-server.tool("create_schedule", {
-  name: exports_external.string().describe("Schedule name"),
-  cronExpression: exports_external.string().describe("Cron expression (5-field)"),
-  url: exports_external.string().describe("Target URL to test"),
-  tags: exports_external.array(exports_external.string()).optional().describe("Filter scenarios by tags"),
-  priority: exports_external.string().optional().describe("Filter scenarios by priority"),
-  model: exports_external.string().optional().describe(MODEL_DESC),
-  headed: exports_external.boolean().optional().describe("Run headed"),
-  parallel: exports_external.number().optional().describe("Parallel count"),
-  projectId: exports_external.string().optional().describe("Project ID")
-}, async (params) => {
-  try {
-    const schedule = createSchedule({
-      name: params.name,
-      cronExpression: params.cronExpression,
-      url: params.url,
-      scenarioFilter: { tags: params.tags, priority: params.priority },
-      model: params.model,
-      headed: params.headed,
-      parallel: params.parallel,
-      projectId: params.projectId
-    });
-    const nextRun = getNextRunTime(schedule.cronExpression);
-    return json({ ...schedule, nextRunAt: nextRun.toISOString() });
-  } catch (e) {
-    return errorResponse(e);
-  }
-});
-server.tool("list_schedules", {
-  projectId: exports_external.string().optional(),
-  enabled: exports_external.boolean().optional(),
-  limit: exports_external.number().optional()
-}, async (params) => {
-  try {
-    const schedules = listSchedules({ projectId: params.projectId, enabled: params.enabled, limit: params.limit });
-    return json({ items: schedules, total: schedules.length });
-  } catch (e) {
-    return errorResponse(e);
-  }
-});
-server.tool("enable_schedule", { id: exports_external.string().describe("Schedule ID") }, async (params) => {
-  try {
-    const schedule = updateSchedule(params.id, { enabled: true });
-    return json(schedule);
-  } catch (e) {
-    return errorResponse(e);
-  }
-});
-server.tool("disable_schedule", { id: exports_external.string().describe("Schedule ID") }, async (params) => {
-  try {
-    const schedule = updateSchedule(params.id, { enabled: false });
-    return json(schedule);
-  } catch (e) {
-    return errorResponse(e);
-  }
-});
-server.tool("delete_schedule", { id: exports_external.string().describe("Schedule ID") }, async (params) => {
-  try {
-    const deleted = deleteSchedule(params.id);
-    if (!deleted)
-      return errorResponse(notFoundErr(params.id, "Schedule"));
-    return json({ deleted: true, id: params.id });
-  } catch (e) {
-    return errorResponse(e);
-  }
-});
-server.tool("wait_for_run", "Poll a run until it reaches a terminal status (passed, failed, error, or cancelled). Blocks until done or timeout.", {
-  runId: exports_external.string().describe("Run ID to wait for"),
-  timeoutMs: exports_external.number().optional().describe("Max wait time in ms (default 300000)"),
-  pollIntervalMs: exports_external.number().optional().describe("Poll interval in ms (default 3000)")
-}, async ({ runId, timeoutMs = 300000, pollIntervalMs = 3000 }) => {
-  try {
-    const terminalStatuses = new Set(["passed", "failed", "error", "cancelled"]);
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-      const run = getRun(runId);
-      if (!run)
-        return errorResponse(notFoundErr(runId, "Run"));
-      if (terminalStatuses.has(run.status)) {
-        const results = getResultsByRun(runId);
-        const passed = results.filter((r) => r.status === "passed").length;
-        const failed = results.filter((r) => r.status === "failed" || r.status === "error").length;
-        return json({ ...run, passedCount: passed, failedCount: failed });
-      }
-      await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
-    }
-    return errorResponse(Object.assign(new Error(`Run ${runId} did not complete within ${timeoutMs}ms`), { name: "TimeoutError" }));
-  } catch (error) {
-    return errorResponse(error);
-  }
-});
 server.tool("get_run_stats", "Get aggregate statistics for a run: pass rate, cost, token usage, duration", {
   runId: exports_external.string().describe("Run ID")
 }, async ({ runId }) => {

package/dist/server/index.js

@@ -20020,6 +20020,25 @@ function listEnvironments(projectId) {
 
 // src/server/index.ts
 init_types();
+var cliArgs = new Set(process.argv.slice(2));
+if (cliArgs.has("--help") || cliArgs.has("-h")) {
+  console.log(`Usage: testers-serve [options]
+
+Open Testers HTTP server
+
+Options:
+  -h, --help       Show this help message
+  -V, --version    Show version
+
+Environment:
+  TESTERS_PORT     Port to bind (default: 19450)
+`);
+  process.exit(0);
+}
+if (cliArgs.has("--version") || cliArgs.has("-V")) {
+  console.log("0.0.1");
+  process.exit(0);
+}
 function parseUrl(req) {
   const url = new URL(req.url);
   return { pathname: url.pathname, searchParams: url.searchParams };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/testers",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "description": "AI-powered QA testing CLI — spawns cheap AI agents to test web apps with headless browsers",
   "type": "module",
   "main": "dist/index.js",
@@ -79,4 +79,4 @@
     "cli",
     "mcp"
   ]
-}
+}