muagqa 1.4.0 → 1.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "muagqa",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "MuagQA CLI — Test case runner with one-time session token and Playwright recorder",
   "author": "Mary C.N. Enwezor",
   "license": "MIT",

package/src/index.js

@@ -2,11 +2,9 @@
 import { exec } from "child_process";
 import { createRequire } from "module";
 import { promisify } from "util";
-import inquirer from "inquirer";
 import chalk from "chalk";
-import yargs from "yargs";
-import { hideBin } from "yargs/helpers";
-import run from "./runner.js";
+import { startRecording } from "./recordMode.js";
+import { generateTemplateTests } from "./templateMode.js";
 
 const execAsync = promisify(exec);
 const require = createRequire(import.meta.url);
@@ -36,62 +34,44 @@ async function checkForUpdate({ force = false } = {}) {
   }
 }
 
+function extractToken(args) {
+  if (args[0] === "pull" && args[1]) {
+    return args[1];
+  }
+  return args.find(arg => !arg.startsWith("--"));
+}
+
 async function startCLI() {
-  let ranCommand = false;
+  const args = process.argv.slice(2);
+  const isTemplate = args.includes("--template");
+  const isRecord = args.includes("--record");
+  const wantsVersion = args.includes("--version") || args.includes("-v");
+  const wantsCheckUpdate = args.includes("--check-update");
+  const token = extractToken(args);
 
-  const argv = await yargs(hideBin(process.argv))
-    .scriptName("muagqa")
-    .command(
-      "pull <token>",
-      "Pull test cases and generate tests",
-      y => {
-        return y
-          .positional("token", {
-            type: "string",
-            describe: "One-time session token"
-          })
-          .option("mode", {
-            choices: ["record", "template"],
-            default: "record",
-            describe: "Execution mode"
-          });
-      },
-      async args => {
-        ranCommand = true;
-        checkForUpdate();
-        await run(args.token, args.mode);
-      }
-    )
-    .option("check-update", {
-      type: "boolean",
-      describe: "Check for updates"
-    })
-    .version(`muagqa v${pkg.version}`)
-    .alias("version", "v")
-    .help()
-    .parseAsync();
+  if (wantsVersion) {
+    console.log(`muagqa v${pkg.version}`);
+    return;
+  }
 
-  if (argv.checkUpdate) {
+  if (wantsCheckUpdate) {
     await checkForUpdate({ force: true });
     return;
   }
 
-  if (ranCommand) {
+  if (isTemplate) {
+    checkForUpdate();
+    await generateTemplateTests(token);
     return;
   }
 
-  checkForUpdate();
-
-  const { token } = await inquirer.prompt([
-    {
-      type: "input",
-      name: "token",
-      message: "Enter your one-time session token:",
-      validate: v => v.trim() !== "" || "Token is required."
-    }
-  ]);
+  if (isRecord) {
+    checkForUpdate();
+    await startRecording(token);
+    return;
+  }
 
-  await run(token, "record");
+  console.log("Please specify --template or --record mode");
 }
 
 startCLI();

package/src/recordMode.js

@@ -0,0 +1,20 @@
+import inquirer from "inquirer";
+import run from "./runner.js";
+
+export async function startRecording(sessionToken) {
+  let token = sessionToken || process.env.MUAGQA_SESSION;
+
+  if (!token) {
+    const answer = await inquirer.prompt([
+      {
+        type: "input",
+        name: "token",
+        message: "Enter your one-time session token:",
+        validate: v => v.trim() !== "" || "Token is required."
+      }
+    ]);
+    token = answer.token;
+  }
+
+  await run(token, "record");
+}

package/src/templateBuilder.js

@@ -0,0 +1,66 @@
+function formatArg(value) {
+  if (Array.isArray(value)) {
+    return value.map(formatArg).join(", ");
+  }
+  if (typeof value === "string") {
+    return JSON.stringify(value);
+  }
+  return JSON.stringify(value);
+}
+
+function formatArgs(args) {
+  if (Array.isArray(args)) {
+    return args.map(formatArg).join(", ");
+  }
+  if (args === undefined) {
+    return "";
+  }
+  return formatArg(args);
+}
+
+export function buildTemplate(testCase) {
+  const steps = Array.isArray(testCase.steps) ? testCase.steps : [];
+  const lines = steps.map(step => {
+    const action = step.action || "click";
+    const args = formatArgs(step.args);
+    const argsText = args ? `(${args})` : "()";
+    return `  await page.${action}${argsText};`;
+  });
+
+  const title = testCase.title || "Generated test";
+  const description = testCase.description || "";
+  const expected = testCase.expected || "";
+  const startUrl =
+    testCase.startUrl || testCase.url || testCase.start_url || "";
+
+  const headerLines = [];
+  if (description) {
+    headerLines.push(`// Description: ${description}`);
+  }
+  if (expected) {
+    headerLines.push(`// Expected: ${expected}`);
+  }
+  if (testCase.id) {
+    headerLines.push(`// Test case ID: ${testCase.id}`);
+  }
+
+  const header = headerLines.length ? `${headerLines.join("\n")}\n` : "";
+
+  if (lines.length === 0) {
+    lines.push("  // TODO: add steps for this test case.");
+    if (startUrl) {
+      lines.push(`  await page.goto("${startUrl}");`);
+    } else {
+      lines.push("  // await page.goto(\"https://example.com\");");
+    }
+    lines.push("  // Example:");
+    lines.push("  // await page.getByRole(\"button\", { name: \"Sign in\" }).click();");
+  }
+
+  return `import { test } from "@playwright/test";
+
+${header}test("${title}", async ({ page }) => {
+${lines.join("\n")}
+});
+`;
+}

package/src/templateMode.js

@@ -0,0 +1,35 @@
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import { validateSessionToken } from "./api.js";
+import { buildTemplate } from "./templateBuilder.js";
+
+export async function generateTemplateTests(sessionToken) {
+  const token = sessionToken || process.env.MUAGQA_SESSION;
+
+  if (!token) {
+    console.error("Missing session token. Set MUAGQA_SESSION or pass a token.");
+    return;
+  }
+
+  const result = await validateSessionToken(token);
+  if (!result.success) {
+    console.error("Unable to fetch test flows — invalid token?");
+    return;
+  }
+
+  const testCases = result.testCases || [];
+
+  const outputDir = path.resolve(process.cwd(), "muagqa-tests");
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir);
+  }
+
+  for (const tc of testCases) {
+    const template = buildTemplate(tc);
+    const slug = tc.slug || tc.id || `test-${Date.now()}`;
+    fs.writeFileSync(path.join(outputDir, `${slug}.spec.js`), template, "utf8");
+  }
+
+  console.log(chalk.green(`Generated ${testCases.length} test files in /muagqa-tests`));
+}