@letsrunit/cli 0.0.1 → 0.2.4

package/README.md

@@ -0,0 +1,28 @@
+# CLI
+
+The `letsrunit` CLI allows you to explore websites, generate Gherkin features using AI, and run tests locally.
+
+## Commands
+
+### `explore`
+Navigates a target URL and allows interactive discovery of features.
+```bash
+yarn cli explore <url>
+```
+
+### `generate`
+Generates a `.feature` file from natural language instructions.
+```bash
+echo "Login with email and password" | yarn cli generate <url> -o ./features
+```
+
+### `run`
+Executes a Gherkin feature file against a target URL.
+```bash
+yarn cli run <url> ./features/login.feature
+```
+
+## Options
+- `-v, --verbose`: Enable verbose logging.
+- `-s, --silent`: Only output errors.
+- `-o, --save <path>`: Path to save generated artifacts/features.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+import { explore, refineSuggestion, generate, run } from '@letsrunit/executor';
+import { makeFeature } from '@letsrunit/gherkin';
+import { Journal, CliSink } from '@letsrunit/journal';
+import { getMailbox } from '@letsrunit/mailbox';
+import { asFilename, randomUUID } from '@letsrunit/utils';
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import * as fs2 from 'fs/promises';
+import fs2__default from 'fs/promises';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+function disableEcho() {
+  process.stdout.write("\x1B[?25l");
+  process.stdout.write("\x1B[8m");
+}
+function enableEcho() {
+  process.stdout.write("\x1B[0m");
+  process.stdout.write("\x1B[?25h");
+}
+function readKey() {
+  const { stdin } = process;
+  stdin.setRawMode(true);
+  stdin.resume();
+  stdin.setEncoding("utf8");
+  disableEcho();
+  return new Promise((resolve) => {
+    const handler = (pressed) => {
+      stdin.removeListener("data", handler);
+      stdin.setRawMode(false);
+      stdin.pause();
+      enableEcho();
+      resolve(pressed);
+    };
+    stdin.on("data", handler);
+  });
+}
+async function readOption(limit) {
+  while (true) {
+    const key = await readKey();
+    if (key === "") return -1;
+    const opt = key >= "0" && key <= "9" ? Number(key) : null;
+    if (!opt || opt > limit) {
+      process.stdout.write("\x1B[33mInvalid option selected\x1B[0m\n");
+      continue;
+    }
+    return opt - 1;
+  }
+}
+async function runExplore(info, actions, storagePath) {
+  const { stdout } = process;
+  while (actions.length > 0) {
+    stdout.write(`
+\x1B[1m${info.title}\x1B[0m
+`);
+    stdout.write("What do you want to test? Choose one of the following options:\n");
+    let count = 1;
+    for (const action of actions) {
+      stdout.write(`${count++}. ${action.name}
+`);
+    }
+    const opt = await readOption(actions.length);
+    if (opt < 0) return;
+    stdout.write("\n");
+    const { status, feature } = await actions[opt].run();
+    actions.splice(opt, 1);
+    if (storagePath && status === "passed" && feature) {
+      await fs2.writeFile(`${storagePath}/${asFilename(feature.name)}.feature`, makeFeature(feature));
+    }
+  }
+}
+
+// src/index.ts
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var { version } = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+var program = new Command();
+function createJournal({ verbose, silent, artifactPath }) {
+  const verbosity = verbose ? 3 : silent ? 0 : 1;
+  return new Journal(new CliSink({ verbosity, artifactPath }));
+}
+async function readStdin() {
+  return await new Promise((resolve) => {
+    let data = "";
+    process.stdin.setEncoding("utf8");
+    const isTTY = Boolean(process.stdin.isTTY);
+    if (isTTY) {
+      console.error("Enter instructions. Finish with Ctrl-D (Unix/macOS/Linux) or Ctrl-Z then Enter (Windows).");
+    }
+    process.stdin.on("data", (chunk) => data += chunk);
+    process.stdin.on("end", () => resolve(data));
+    process.stdin.resume();
+  });
+}
+program.name("letsrunit").description("Vibe testing done right").version(version);
+program.command("explore").argument("<target>", "Target URL or project").option("-v, --verbose", "Enable verbose logging", false).option("-s, --silent", "Only output errors", false).option("-o, --save <path>", "Path to save .feature file", "").action(async (target, opts) => {
+  const journal = createJournal({ ...opts, artifactPath: opts.save });
+  const { status } = await explore(target, { headless: false, journal }, async (info, actions) => {
+    journal.sink.endSection();
+    await runExplore(info, actions, opts.save);
+  });
+  process.exit(status === "passed" ? 0 : 1);
+});
+program.command("generate").argument("<target>", "Target URL or project").option("-v, --verbose", "Enable verbose logging", false).option("-s, --silent", "Only output errors", false).option("-o, --save <path>", "Path to save .feature file", "").action(async (target, opts) => {
+  const instructions = (await readStdin()).trim();
+  if (!instructions) {
+    console.error("No instructions provided");
+    process.exit(1);
+  }
+  const journal = createJournal({ ...opts, artifactPath: opts.save });
+  await journal.info("Refining test instructions");
+  const suggestion = await refineSuggestion(instructions);
+  const { feature, status } = await generate(target, suggestion, { headless: false, journal });
+  if (opts.save && feature) {
+    await fs2__default.writeFile(`${opts.save}/${asFilename(feature.name)}.feature`, makeFeature(feature));
+  }
+  process.exit(status === "passed" ? 0 : 1);
+});
+program.command("register").argument("<target>", "Target URL or project").option("-v, --verbose", "Enable verbose logging", false).option("-s, --silent", "Only output errors", false).option("-o, --save <path>", "Path to save .feature file", "").action(async (target, opts) => {
+  const journal = createJournal({ ...opts, artifactPath: opts.save });
+  const suggestion = {
+    name: "Register a new user by email",
+    description: [
+      "Locate the registration form and fill it out to create a new account.",
+      "Confirm the registration email and log in as the user"
+    ].join("\n"),
+    comments: [
+      "If no registration button is visible, try locating it through the login form.",
+      "The feature is complete when a confirmation email is received and verified and the user is logged in."
+    ].join("\n")
+  };
+  const email = getMailbox(randomUUID());
+  const { feature, status } = await generate(target, suggestion, { headless: false, journal, accounts: { email } });
+  if (opts.save && feature) {
+    await fs2__default.writeFile(`${opts.save}/${asFilename(feature.name)}.feature`, makeFeature(feature));
+  }
+  process.exit(status === "passed" ? 0 : 1);
+});
+program.command("run").argument("<target>", "Target URL or project").argument("<feature>", "Gherkin feature file").option("-v, --verbose", "Enable verbose logging", false).option("-s, --silent", "Only output errors", false).action(async (target, featureFile, opts) => {
+  const feature = await fs2__default.readFile(featureFile, "utf-8");
+  await run(target, feature, { headless: false, journal: createJournal(opts) });
+});
+program.parse();
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/run-explore.ts","../src/index.ts"],"names":["fs","asFilename","makeFeature"],"mappings":"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","file":"index.js","sourcesContent":["import type { Action, AppInfo } from '@letsrunit/executor';\nimport { makeFeature } from '@letsrunit/gherkin';\nimport { asFilename } from '@letsrunit/utils';\nimport * as fs from 'node:fs/promises';\n\nfunction disableEcho() {\n  process.stdout.write('\\x1B[?25l'); // hide cursor\n  process.stdout.write('\\x1B[8m'); // hide input\n}\n\nfunction enableEcho() {\n  process.stdout.write('\\x1B[0m');\n  process.stdout.write('\\x1B[?25h');\n}\n\nfunction readKey(): Promise<string> {\n  const { stdin } = process;\n\n  stdin.setRawMode(true);\n  stdin.resume();\n  stdin.setEncoding('utf8');\n  disableEcho();\n\n  return new Promise<string>((resolve) => {\n    const handler = (pressed: string) => {\n      stdin.removeListener('data', handler);\n      stdin.setRawMode(false);\n      stdin.pause();\n      enableEcho();\n\n      resolve(pressed);\n    };\n\n    stdin.on('data', handler);\n  });\n}\n\nasync function readOption(limit: number): Promise<number> {\n  while (true) {\n    const key = await readKey();\n    if (key === '\\u0003') return -1;\n\n    const opt = key >= '0' && key <= '9' ? Number(key) : null;\n\n    if (!opt || opt > limit) {\n      process.stdout.write('\\x1b[33mInvalid option selected\\x1b[0m\\n');\n      continue;\n    }\n\n    return opt - 1;\n  }\n}\n\nexport async function runExplore(info: AppInfo, actions: Action[], storagePath?: string) {\n  const { stdout } = process;\n\n  while (actions.length > 0) {\n    stdout.write(`\\n\\x1b[1m${info.title}\\x1b[0m\\n`);\n    stdout.write('What do you want to test? Choose one of the following options:\\n');\n\n    let count = 1;\n    for (const action of actions) {\n      stdout.write(`${count++}. ${action.name}\\n`);\n    }\n\n    const opt = await readOption(actions.length);\n    if (opt < 0) return;\n\n    stdout.write('\\n');\n    const { status, feature } = await actions[opt].run();\n\n    actions.splice(opt, 1);\n\n    if (storagePath && status === 'passed' && feature) {\n      await fs.writeFile(`${storagePath}/${asFilename(feature.name!)}.feature`, makeFeature(feature));\n    }\n  }\n}\n","import { explore, generate, refineSuggestion, run } from '@letsrunit/executor';\nimport { makeFeature } from '@letsrunit/gherkin';\nimport { CliSink, Journal } from '@letsrunit/journal';\nimport { getMailbox } from '@letsrunit/mailbox';\nimport { asFilename, randomUUID } from '@letsrunit/utils';\nimport { Command } from 'commander';\nimport { readFileSync } from 'node:fs';\nimport fs from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { runExplore } from './run-explore';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst { version } = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')) as { version: string };\n\nconst program = new Command();\n\ninterface JournalOptions {\n  verbose: boolean;\n  silent: boolean;\n  artifactPath?: string;\n}\n\nfunction createJournal({ verbose, silent, artifactPath }: JournalOptions) {\n  const verbosity = verbose ? 3 : silent ? 0 : 1;\n  return new Journal(new CliSink({ verbosity, artifactPath }));\n}\n\nasync function readStdin(): Promise<string> {\n  return await new Promise((resolve) => {\n    let data = '';\n    process.stdin.setEncoding('utf8');\n\n    const isTTY = Boolean(process.stdin.isTTY);\n    if (isTTY) {\n      // Interactive input: allow user to type multiple lines and finish with EOF\n      console.error('Enter instructions. Finish with Ctrl-D (Unix/macOS/Linux) or Ctrl-Z then Enter (Windows).');\n    }\n\n    process.stdin.on('data', (chunk) => (data += chunk));\n    process.stdin.on('end', () => resolve(data));\n    process.stdin.resume();\n  });\n}\n\nprogram.name('letsrunit').description('Vibe testing done right').version(version);\n\nprogram\n  .command('explore')\n  .argument('<target>', 'Target URL or project')\n  .option('-v, --verbose', 'Enable verbose logging', false)\n  .option('-s, --silent', 'Only output errors', false)\n  .option('-o, --save <path>', 'Path to save .feature file', '')\n  .action(async (target: string, opts: { verbose: boolean; silent: boolean; save: string }) => {\n    const journal = createJournal({ ...opts, artifactPath: opts.save });\n\n    const { status } = await explore(target, { headless: false, journal }, async (info, actions) => {\n      journal.sink.endSection();\n      await runExplore(info, actions, opts.save);\n    });\n\n    process.exit(status === 'passed' ? 0 : 1);\n  });\n\nprogram\n  .command('generate')\n  .argument('<target>', 'Target URL or project')\n  .option('-v, --verbose', 'Enable verbose logging', false)\n  .option('-s, --silent', 'Only output errors', false)\n  .option('-o, --save <path>', 'Path to save .feature file', '')\n  .action(async (target: string, opts: { verbose: boolean; silent: boolean; save: string }) => {\n    const instructions = (await readStdin()).trim();\n\n    if (!instructions) {\n      console.error('No instructions provided');\n      process.exit(1);\n    }\n\n    const journal = createJournal({ ...opts, artifactPath: opts.save });\n\n    await journal.info('Refining test instructions');\n    const suggestion = await refineSuggestion(instructions);\n\n    const { feature, status } = await generate(target, suggestion, { headless: false, journal });\n\n    if (opts.save && feature) {\n      await fs.writeFile(`${opts.save}/${asFilename(feature.name!)}.feature`, makeFeature(feature));\n    }\n\n    process.exit(status === 'passed' ? 0 : 1);\n  });\n\nprogram\n  .command('register')\n  .argument('<target>', 'Target URL or project')\n  .option('-v, --verbose', 'Enable verbose logging', false)\n  .option('-s, --silent', 'Only output errors', false)\n  .option('-o, --save <path>', 'Path to save .feature file', '')\n  .action(async (target: string, opts: { verbose: boolean; silent: boolean; save: string }) => {\n    const journal = createJournal({ ...opts, artifactPath: opts.save });\n\n    const suggestion = {\n      name: 'Register a new user by email',\n      description: [\n        'Locate the registration form and fill it out to create a new account.',\n        'Confirm the registration email and log in as the user',\n      ].join('\\n'),\n      comments: [\n        'If no registration button is visible, try locating it through the login form.',\n        'The feature is complete when a confirmation email is received and verified and the user is logged in.',\n      ].join('\\n'),\n    };\n\n    const email = getMailbox(randomUUID());\n\n    const { feature, status } = await generate(target, suggestion, { headless: false, journal, accounts: { email } });\n\n    if (opts.save && feature) {\n      await fs.writeFile(`${opts.save}/${asFilename(feature.name!)}.feature`, makeFeature(feature));\n    }\n\n    process.exit(status === 'passed' ? 0 : 1);\n  });\n\nprogram\n  .command('run')\n  .argument('<target>', 'Target URL or project')\n  .argument('<feature>', 'Gherkin feature file')\n  .option('-v, --verbose', 'Enable verbose logging', false)\n  .option('-s, --silent', 'Only output errors', false)\n  .action(async (target: string, featureFile: string, opts: { verbose: boolean; silent: boolean }) => {\n    const feature = await fs.readFile(featureFile, 'utf-8');\n    await run(target, feature, { headless: false, journal: createJournal(opts) });\n  });\n\nprogram.parse();\n"]}

package/package.json

@@ -1,4 +1,56 @@
 {
   "name": "@letsrunit/cli",
-  "version": "0.0.1"
-}
+  "version": "0.2.4",
+  "description": "Command line interface for letsrunit",
+  "keywords": [
+    "testing",
+    "cli",
+    "automation",
+    "letsrunit"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/letsrunit-hq/letsrunit.git",
+    "directory": "packages/cli"
+  },
+  "bugs": "https://github.com/letsrunit-hq/letsrunit/issues",
+  "homepage": "https://github.com/letsrunit-hq/letsrunit#readme",
+  "type": "module",
+  "bin": {
+    "letsrunit": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "bin": {
+      "letsrunit": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "../../node_modules/.bin/tsup",
+    "dev": "tsx src/index.ts",
+    "test": "echo \"No tests yet\""
+  },
+  "packageManager": "yarn@4.10.3",
+  "dependencies": {
+    "@letsrunit/executor": "0.2.4",
+    "@letsrunit/gherkin": "0.2.4",
+    "@letsrunit/journal": "0.2.4",
+    "@letsrunit/mailbox": "0.2.4",
+    "@letsrunit/utils": "0.2.4",
+    "commander": "^14.0.2"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,136 @@
+import { explore, generate, refineSuggestion, run } from '@letsrunit/executor';
+import { makeFeature } from '@letsrunit/gherkin';
+import { CliSink, Journal } from '@letsrunit/journal';
+import { getMailbox } from '@letsrunit/mailbox';
+import { asFilename, randomUUID } from '@letsrunit/utils';
+import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import fs from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runExplore } from './run-explore';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const { version } = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')) as { version: string };
+
+const program = new Command();
+
+interface JournalOptions {
+  verbose: boolean;
+  silent: boolean;
+  artifactPath?: string;
+}
+
+function createJournal({ verbose, silent, artifactPath }: JournalOptions) {
+  const verbosity = verbose ? 3 : silent ? 0 : 1;
+  return new Journal(new CliSink({ verbosity, artifactPath }));
+}
+
+async function readStdin(): Promise<string> {
+  return await new Promise((resolve) => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+
+    const isTTY = Boolean(process.stdin.isTTY);
+    if (isTTY) {
+      // Interactive input: allow user to type multiple lines and finish with EOF
+      console.error('Enter instructions. Finish with Ctrl-D (Unix/macOS/Linux) or Ctrl-Z then Enter (Windows).');
+    }
+
+    process.stdin.on('data', (chunk) => (data += chunk));
+    process.stdin.on('end', () => resolve(data));
+    process.stdin.resume();
+  });
+}
+
+program.name('letsrunit').description('Vibe testing done right').version(version);
+
+program
+  .command('explore')
+  .argument('<target>', 'Target URL or project')
+  .option('-v, --verbose', 'Enable verbose logging', false)
+  .option('-s, --silent', 'Only output errors', false)
+  .option('-o, --save <path>', 'Path to save .feature file', '')
+  .action(async (target: string, opts: { verbose: boolean; silent: boolean; save: string }) => {
+    const journal = createJournal({ ...opts, artifactPath: opts.save });
+
+    const { status } = await explore(target, { headless: false, journal }, async (info, actions) => {
+      journal.sink.endSection();
+      await runExplore(info, actions, opts.save);
+    });
+
+    process.exit(status === 'passed' ? 0 : 1);
+  });
+
+program
+  .command('generate')
+  .argument('<target>', 'Target URL or project')
+  .option('-v, --verbose', 'Enable verbose logging', false)
+  .option('-s, --silent', 'Only output errors', false)
+  .option('-o, --save <path>', 'Path to save .feature file', '')
+  .action(async (target: string, opts: { verbose: boolean; silent: boolean; save: string }) => {
+    const instructions = (await readStdin()).trim();
+
+    if (!instructions) {
+      console.error('No instructions provided');
+      process.exit(1);
+    }
+
+    const journal = createJournal({ ...opts, artifactPath: opts.save });
+
+    await journal.info('Refining test instructions');
+    const suggestion = await refineSuggestion(instructions);
+
+    const { feature, status } = await generate(target, suggestion, { headless: false, journal });
+
+    if (opts.save && feature) {
+      await fs.writeFile(`${opts.save}/${asFilename(feature.name!)}.feature`, makeFeature(feature));
+    }
+
+    process.exit(status === 'passed' ? 0 : 1);
+  });
+
+program
+  .command('register')
+  .argument('<target>', 'Target URL or project')
+  .option('-v, --verbose', 'Enable verbose logging', false)
+  .option('-s, --silent', 'Only output errors', false)
+  .option('-o, --save <path>', 'Path to save .feature file', '')
+  .action(async (target: string, opts: { verbose: boolean; silent: boolean; save: string }) => {
+    const journal = createJournal({ ...opts, artifactPath: opts.save });
+
+    const suggestion = {
+      name: 'Register a new user by email',
+      description: [
+        'Locate the registration form and fill it out to create a new account.',
+        'Confirm the registration email and log in as the user',
+      ].join('\n'),
+      comments: [
+        'If no registration button is visible, try locating it through the login form.',
+        'The feature is complete when a confirmation email is received and verified and the user is logged in.',
+      ].join('\n'),
+    };
+
+    const email = getMailbox(randomUUID());
+
+    const { feature, status } = await generate(target, suggestion, { headless: false, journal, accounts: { email } });
+
+    if (opts.save && feature) {
+      await fs.writeFile(`${opts.save}/${asFilename(feature.name!)}.feature`, makeFeature(feature));
+    }
+
+    process.exit(status === 'passed' ? 0 : 1);
+  });
+
+program
+  .command('run')
+  .argument('<target>', 'Target URL or project')
+  .argument('<feature>', 'Gherkin feature file')
+  .option('-v, --verbose', 'Enable verbose logging', false)
+  .option('-s, --silent', 'Only output errors', false)
+  .action(async (target: string, featureFile: string, opts: { verbose: boolean; silent: boolean }) => {
+    const feature = await fs.readFile(featureFile, 'utf-8');
+    await run(target, feature, { headless: false, journal: createJournal(opts) });
+  });
+
+program.parse();

package/src/run-explore.ts

@@ -0,0 +1,78 @@
+import type { Action, AppInfo } from '@letsrunit/executor';
+import { makeFeature } from '@letsrunit/gherkin';
+import { asFilename } from '@letsrunit/utils';
+import * as fs from 'node:fs/promises';
+
+function disableEcho() {
+  process.stdout.write('\x1B[?25l'); // hide cursor
+  process.stdout.write('\x1B[8m'); // hide input
+}
+
+function enableEcho() {
+  process.stdout.write('\x1B[0m');
+  process.stdout.write('\x1B[?25h');
+}
+
+function readKey(): Promise<string> {
+  const { stdin } = process;
+
+  stdin.setRawMode(true);
+  stdin.resume();
+  stdin.setEncoding('utf8');
+  disableEcho();
+
+  return new Promise<string>((resolve) => {
+    const handler = (pressed: string) => {
+      stdin.removeListener('data', handler);
+      stdin.setRawMode(false);
+      stdin.pause();
+      enableEcho();
+
+      resolve(pressed);
+    };
+
+    stdin.on('data', handler);
+  });
+}
+
+async function readOption(limit: number): Promise<number> {
+  while (true) {
+    const key = await readKey();
+    if (key === '\u0003') return -1;
+
+    const opt = key >= '0' && key <= '9' ? Number(key) : null;
+
+    if (!opt || opt > limit) {
+      process.stdout.write('\x1b[33mInvalid option selected\x1b[0m\n');
+      continue;
+    }
+
+    return opt - 1;
+  }
+}
+
+export async function runExplore(info: AppInfo, actions: Action[], storagePath?: string) {
+  const { stdout } = process;
+
+  while (actions.length > 0) {
+    stdout.write(`\n\x1b[1m${info.title}\x1b[0m\n`);
+    stdout.write('What do you want to test? Choose one of the following options:\n');
+
+    let count = 1;
+    for (const action of actions) {
+      stdout.write(`${count++}. ${action.name}\n`);
+    }
+
+    const opt = await readOption(actions.length);
+    if (opt < 0) return;
+
+    stdout.write('\n');
+    const { status, feature } = await actions[opt].run();
+
+    actions.splice(opt, 1);
+
+    if (storagePath && status === 'passed' && feature) {
+      await fs.writeFile(`${storagePath}/${asFilename(feature.name!)}.feature`, makeFeature(feature));
+    }
+  }
+}