@hasna/testers 0.0.53 → 0.0.55

package/README.md

@@ -57,12 +57,16 @@ testers inventory next /path/to/app \
   --action-workflow-grouping route \
   --sandbox-provider e2b \
   --sandbox-sync rsync \
+  --sandbox-app-source /path/to/app \
+  --sandbox-app-start-command "bun install && bun dev --hostname 0.0.0.0" \
+  --sandbox-app-url http://127.0.0.1:3000 \
+  --sandbox-app-wait-url http://127.0.0.1:3000/health \
   --sandbox-env-optional OPENAI_API_KEY
 
 testers workflow fanout --project alumia --tag next-action --workers 6 --url https://preview.example.com --dry-run
 ```
 
-Use `--action-workflow-grouping route` for route-specific workflows or `--action-workflow-grouping area-kind` for broader workflows such as commerce buttons or admin API methods.
+Use `--action-workflow-grouping route` for route-specific workflows or `--action-workflow-grouping area-kind` for broader workflows such as commerce buttons or admin API methods. Add the `--sandbox-app-*` flags when the sandbox should rsync, install, start, and test the app source instead of only testing an already-running URL.
 
 ### Common Flags
 

package/dist/cli/index.js

@@ -59440,7 +59440,7 @@ function scenarioInputForNextRouteAction(item, action, index, projectId) {
     "Verify response status, JSON shape, and error messages are stable and regression-safe."
   ].filter(Boolean);
   return {
-    name: `Next ${label}: ${item.routePath} :: ${action.kind} ${action.label}`,
+    name: `Next ${label}: ${item.routePath} :: ${action.kind} ${action.label} #${index + 1}`,
     description: `Source-discovered ${label} ${index + 1} from ${action.sourceFile}. Verify ${action.kind} "${action.label}" on ${item.routePath}.`,
     steps: item.kind === "page" ? pageSteps : apiSteps,
     tags: actionTagsForRoute(item, action),
@@ -95551,7 +95551,7 @@ import chalk6 from "chalk";
 // package.json
 var package_default = {
   name: "@hasna/testers",
-  version: "0.0.53",
+  version: "0.0.55",
   description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
   type: "module",
   main: "dist/index.js",
@@ -101176,14 +101176,17 @@ Imported ${imported} scenarios from API spec:`));
   }
 });
 var inventoryCmd = program2.command("inventory").description("Discover source-derived app route/action inventories");
-inventoryCmd.command("next [root]").description("Discover Next.js app routes and optionally import route coverage scenarios").option("--app-dir <path>", "Next.js app directory relative to root (default: packages/web/app or app)").option("--project <id>", "Project ID").option("--no-pages", "Do not include page.tsx/page.ts routes").option("--no-api", "Do not include route.ts/route.js API routes").option("--limit <n>", "Limit discovered routes").option("--create-scenarios", "Upsert source-derived route coverage scenarios", false).option("--create-action-scenarios", "Upsert one source-derived scenario per discovered page/API action", false).option("--create-workflows", "Upsert grouped workflows by area and route kind", false).option("--create-action-workflows", "Upsert action-focused workflows for discovered action scenarios", false).option("--action-workflow-grouping <mode>", "Action workflow grouping: route or area-kind", "route").option("--workflow-target <target>", "Workflow execution target: local or sandbox", "sandbox").option("--sandbox-provider <provider>", "Sandbox provider for created workflows", "e2b").option("--sandbox-cleanup <mode>", "Sandbox cleanup mode: delete, stop, or keep", "delete").option("--sandbox-sync <strategy>", "Sandbox upload sync strategy: rsync or archive", "rsync").option("--sandbox-env-optional <name>", "Optional sandbox env var; forwards host NAME only when set (repeatable)", (val, acc) => {
+inventoryCmd.command("next [root]").description("Discover Next.js app routes and optionally import route coverage scenarios").option("--app-dir <path>", "Next.js app directory relative to root (default: packages/web/app or app)").option("--project <id>", "Project ID").option("--no-pages", "Do not include page.tsx/page.ts routes").option("--no-api", "Do not include route.ts/route.js API routes").option("--limit <n>", "Limit discovered routes").option("--create-scenarios", "Upsert source-derived route coverage scenarios", false).option("--create-action-scenarios", "Upsert one source-derived scenario per discovered page/API action", false).option("--create-workflows", "Upsert grouped workflows by area and route kind", false).option("--create-action-workflows", "Upsert action-focused workflows for discovered action scenarios", false).option("--action-workflow-grouping <mode>", "Action workflow grouping: route or area-kind", "route").option("--workflow-target <target>", "Workflow execution target: local or sandbox", "sandbox").option("--sandbox-provider <provider>", "Sandbox provider for created workflows", "e2b").option("--sandbox-image <image>", "Sandbox image/template for created workflows").option("--sandbox-remote-dir <path>", "Remote working directory for sandbox runs").option("--sandbox-cleanup <mode>", "Sandbox cleanup mode: delete, stop, or keep", "delete").option("--sandbox-sync <strategy>", "Sandbox upload sync strategy: rsync or archive", "rsync").option("--sandbox-setup-command <command>", "Shell command to run before testers in the sandbox").option("--sandbox-package <spec>", "Package spec to execute in the sandbox", "@hasna/testers").option("--sandbox-env <assignment>", "Sandbox env var; KEY forwards host KEY, KEY=value stores value (repeatable)", (val, acc) => {
   acc.push(val);
   return acc;
-}, []).option("--timeout <ms>", "Workflow timeout in milliseconds").option("--json", "Output as JSON", false).action(async (root, opts) => {
+}, []).option("--sandbox-env-optional <name>", "Optional sandbox env var; forwards host NAME only when set (repeatable)", (val, acc) => {
+  acc.push(val);
+  return acc;
+}, []).option("--sandbox-app-source <path>", "Local app source directory to upload into the sandbox").option("--sandbox-app-remote-dir <path>", "Remote app directory inside the sandbox (default: <sandbox-remote-dir>/app)").option("--sandbox-app-start-command <command>", "Shell command to start the app before testers runs").option("--sandbox-app-url <url>", "URL testers should target inside the sandbox after the app starts").option("--sandbox-app-wait-url <url>", "URL to poll before starting testers (defaults to --sandbox-app-url)").option("--sandbox-app-wait-timeout <ms>", "App readiness wait timeout in milliseconds").option("--timeout <ms>", "Workflow timeout in milliseconds").option("--json", "Output as JSON", false).action(async (root, opts) => {
   try {
     const { importNextRouteInventory: importNextRouteInventory2 } = await Promise.resolve().then(() => (init_next_route_inventory(), exports_next_route_inventory));
     const projectId = resolveProject2(opts.project) ?? undefined;
-    const env = parseSandboxEnv(undefined, opts.sandboxEnvOptional);
+    const env = parseSandboxEnv(opts.sandboxEnv, opts.sandboxEnvOptional);
     if (!["route", "area-kind"].includes(opts.actionWorkflowGrouping)) {
       throw new Error("--action-workflow-grouping must be route or area-kind");
     }
@@ -101204,10 +101207,20 @@ inventoryCmd.command("next [root]").description("Discover Next.js app routes and
       workflowExecution: {
         target: opts.workflowTarget,
         provider: opts.workflowTarget === "sandbox" ? opts.sandboxProvider : undefined,
+        sandboxImage: opts.sandboxImage,
+        sandboxRemoteDir: opts.sandboxRemoteDir,
         sandboxCleanup: opts.sandboxCleanup,
         sandboxSyncStrategy: opts.sandboxSync,
+        setupCommand: opts.sandboxSetupCommand,
+        packageSpec: opts.sandboxPackage,
         timeoutMs: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
-        env
+        env,
+        appSourceDir: opts.sandboxAppSource,
+        appRemoteDir: opts.sandboxAppRemoteDir,
+        appStartCommand: opts.sandboxAppStartCommand,
+        appUrl: opts.sandboxAppUrl,
+        appWaitUrl: opts.sandboxAppWaitUrl,
+        appWaitTimeoutMs: opts.sandboxAppWaitTimeout ? parseInt(opts.sandboxAppWaitTimeout, 10) : undefined
       }
     });
     if (opts.json) {

package/dist/mcp/index.js

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/testers",
-    version: "0.0.53",
+    version: "0.0.55",
     description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
     type: "module",
     main: "dist/index.js",

package/dist/server/index.js

@@ -47090,7 +47090,7 @@ import { join as join14 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/testers",
-  version: "0.0.53",
+  version: "0.0.55",
   description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
   type: "module",
   main: "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/testers",
-  "version": "0.0.53",
+  "version": "0.0.55",
   "description": "AI-powered QA testing CLI — spawns cheap AI agents to test web apps with headless browsers",
   "type": "module",
   "main": "dist/index.js",