muagqa 1.3.0 → 1.4.1

package/package.json

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

package/src/fileManager.js

@@ -3,3 +3,7 @@ import fs from "fs-extra";
 export function ensureFolder(path) {
   fs.ensureDirSync(path);
 }
+
+export function writeFileSafe(path, content) {
+  fs.writeFileSync(path, content, "utf-8");
+}

package/src/index.js

@@ -2,9 +2,9 @@
 import { exec } from "child_process";
 import { createRequire } from "module";
 import { promisify } from "util";
-import inquirer from "inquirer";
 import chalk from "chalk";
-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);
@@ -34,32 +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() {
-  const args = new Set(process.argv.slice(2));
+  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);
 
-  if (args.has("--version") || args.has("-v")) {
+  if (wantsVersion) {
     console.log(`muagqa v${pkg.version}`);
     return;
   }
 
-  if (args.has("--check-update")) {
+  if (wantsCheckUpdate) {
     await checkForUpdate({ force: true });
     return;
   }
 
-  // Fire-and-forget update check to avoid slowing down the prompt.
-  checkForUpdate();
+  if (isTemplate) {
+    checkForUpdate();
+    await generateTemplateTests(token);
+    return;
+  }
 
-  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);
+  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/runner.js

@@ -1,11 +1,24 @@
 import chalk from "chalk";
 import ora from "ora";
 import { validateSessionToken } from "./api.js";
-import { ensureFolder } from "./fileManager.js";
+import { ensureFolder, writeFileSafe } from "./fileManager.js";
 import { openCodegenForTest } from "./playwrightRunner.js";
 import { ensurePlaywrightInstalled } from "./playwrightInstaller.js";
+import { buildTemplateTest } from "./templateGenerator.js";
 
-export default async function run(token) {
+function getSafeSlug(testCase) {
+  const base =
+    testCase.slug ||
+    testCase.id ||
+    testCase.title ||
+    `test-${Date.now().toString(36)}`;
+  return String(base)
+    .toLowerCase()
+    .replace(/[^a-z0-9-_]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+export default async function run(token, mode = "record") {
   const spinner = ora("Validating token...").start();
 
   try {
@@ -26,6 +39,24 @@ export default async function run(token) {
       return;
     }
 
+    ensureFolder("./generated-tests");
+
+    if (mode === "template") {
+      console.log(chalk.cyan("\nMode: template (no browser)\n"));
+      console.log(chalk.cyan("Generating template-based Playwright tests...\n"));
+
+      for (const testCase of testCases) {
+        const slug = getSafeSlug(testCase);
+        const code = buildTemplateTest(testCase);
+        writeFileSafe(`./generated-tests/${slug}.spec.js`, code);
+        console.log(chalk.green(`Created ${slug}.spec.js`));
+      }
+
+      console.log(chalk.green.bold("\nTemplate tests generated successfully!\n"));
+      return;
+    }
+
+    console.log(chalk.cyan("\nMode: record (browser opens)\n"));
     console.log(chalk.green(`\n${testCases.length} test cases found.\n`));
 
     const ok = ensurePlaywrightInstalled();
@@ -33,8 +64,6 @@ export default async function run(token) {
       return;
     }
 
-    ensureFolder("./generated-tests");
-
     for (const testCase of testCases) {
       await openCodegenForTest(testCase);
     }

package/src/templateBuilder.js

@@ -0,0 +1,38 @@
+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";
+
+  return `import { test } from "@playwright/test";
+
+test("${title}", async ({ page }) => {
+${lines.join("\n")}
+});
+`;
+}

package/src/templateGenerator.js

@@ -0,0 +1,28 @@
+export function buildTemplateTest(testCase) {
+  const title = testCase.title || "Generated test";
+  const description = testCase.description || "";
+  const startUrl =
+    testCase.startUrl || testCase.url || testCase.start_url || "about:blank";
+
+  const commentLines = [];
+  if (description) {
+    commentLines.push(`// Description: ${description}`);
+  }
+  if (testCase.id) {
+    commentLines.push(`// Test case ID: ${testCase.id}`);
+  }
+
+  const commentBlock = commentLines.length ? `${commentLines.join("\n")}\n` : "";
+
+  return `import { test, expect } from "@playwright/test";
+
+${commentBlock}test("${title}", async ({ page }) => {
+  await page.goto("${startUrl}");
+
+  // TODO: add actions/assertions based on your test steps.
+  // Example:
+  // await page.getByRole("button", { name: "Sign in" }).click();
+  // await expect(page).toHaveURL(/dashboard/);
+});
+`;
+}

package/src/templateMode.js

@@ -0,0 +1,38 @@
+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 || [];
+  if (testCases.length > 0) {
+    console.log("Sample test case schema:", JSON.stringify(testCases[0], null, 2));
+  }
+
+  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`));
+}