@zosmaai/zosma-qa-cli 0.0.4

package/LICENSE

@@ -0,0 +1,178 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and derivative works thereof.
+
+      "Contribution" shall mean, as submitted to the Licensor for inclusion
+      in the Work by the copyright owner or by an individual or Legal Entity
+      authorized to submit on behalf of the copyright owner. For the purposes
+      of this definition, "submitted" means any form of electronic, verbal,
+      or written communication sent to the Licensor or its representatives,
+      including but not limited to communication on electronic mailing lists,
+      source code control systems, and issue tracking systems that are managed
+      by, or on behalf of, the Licensor for the purpose of discussing and
+      improving the Work, but excluding communication that is conspicuously
+      marked or otherwise designated in writing by the copyright owner as
+      "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and subsequently
+      incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by the combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a cross-claim
+      or counterclaim in a lawsuit) alleging that the Work or any
+      Contribution embodied within the Work constitutes direct or contributory
+      patent infringement, then any patent licenses granted to You under
+      this License for that Work shall terminate as of the date such
+      litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative Works
+          a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works that
+          You distribute, all copyright, patent, trademark, and attribution
+          notices from the Source form of the Work, excluding those notices
+          that do not pertain to any part of the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the attribution
+          notices contained within such NOTICE file, in at least one of
+          the following places: within a NOTICE text provided as part of
+          the Derivative Works; within the Source form or documentation,
+          if provided along with the Derivative Works; or, within a display
+          generated by the Derivative Works, if and wherever such
+          third-party notices normally appear. The contents of the NOTICE
+          file are for informational purposes only and do not modify the
+          License. You may add Your own attribution notices within
+          Derivative Works that You distribute, alongside or as an addendum
+          to the NOTICE text from the Work, provided that such additional
+          attribution notices cannot be construed as modifying the License.
+
+      You may add Your own license statement for Your modifications and
+      may provide additional grant of rights to use, copy, modify, merge,
+      publish, distribute, sublicense, and/or sell copies of the
+      Contribution, and to permit persons to whom the Contribution is
+      furnished to do so.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or reproducing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or all other
+      commercial damages or losses), even if such Contributor has been
+      advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may offer only
+      conditions that are completely consistent with this License.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Zosma AI
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,63 @@
+# @zosmaai/zosma-qa-cli
+
+Interactive CLI for [zosma-qa](https://github.com/zosmaai/zosma-qa) — the zero-config QA platform.
+
+```bash
+npx zosma-qa init
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `npx zosma-qa init` | Interactive setup — configures baseURL, browsers, and AI agents |
+| `npx zosma-qa run` | Run all tests (delegates to Playwright, all flags forwarded) |
+| `npx zosma-qa run --project firefox` | Run tests in a specific browser |
+| `npx zosma-qa run --grep "checkout"` | Run tests matching a pattern |
+| `npx zosma-qa run --headed` | Run in headed (visible) browser mode |
+| `npx zosma-qa agents init` | Set up Playwright AI agent definitions |
+| `npx zosma-qa report` | Open the HTML test report |
+
+## Quick start
+
+```bash
+# Clone the repo
+git clone https://github.com/zosmaai/zosma-qa.git
+cd zosma-qa
+pnpm install
+npx playwright install
+
+# Interactive setup
+npx zosma-qa init
+
+# Add your tests to tests/, then run
+npx zosma-qa run
+```
+
+## AI agents
+
+`zosma-qa agents init` sets up Playwright's built-in **planner**, **generator**, and **healer** agents for your AI coding tool:
+
+```bash
+npx zosma-qa agents init
+# Prompts: OpenCode (default) / Claude Code / VS Code (Copilot)
+```
+
+Once configured, prompt your AI tool:
+
+```
+Use the planner agent. Seed: tests/seed.spec.ts.
+Generate a plan for the guest checkout flow.
+```
+
+## Part of zosma-qa
+
+- [`@zosmaai/zosma-qa-core`](https://www.npmjs.com/package/@zosmaai/zosma-qa-core) — shared types and plugin interface
+- [`@zosmaai/zosma-qa-playwright`](https://www.npmjs.com/package/@zosmaai/zosma-qa-playwright) — Playwright runner and base config
+- [`@zosmaai/zosma-qa-cli`](https://www.npmjs.com/package/@zosmaai/zosma-qa-cli) — this package
+
+Full documentation: [github.com/zosmaai/zosma-qa](https://github.com/zosmaai/zosma-qa)
+
+## License
+
+Apache-2.0

package/bin/zosma-qa.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+'use strict';
+
+// Resolve the compiled CLI entry from dist/
+require('../dist/index.js');

package/dist/commands/agents.d.ts

@@ -0,0 +1,9 @@
+import type { AgentLoop } from '@zosmaai/zosma-qa-core';
+/**
+ * `zosma-qa agents init` — prompts the user to choose their AI coding tool
+ * and runs `npx playwright init-agents --loop=<choice>`.
+ *
+ * Supports: OpenCode (default), Claude Code, VS Code (Copilot).
+ */
+export declare function initAgents(loopOverride?: AgentLoop): Promise<void>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/commands/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,YAAY,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAuExE"}

package/dist/commands/agents.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initAgents = initAgents;
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const prompts_1 = require("@inquirer/prompts");
+/**
+ * `zosma-qa agents init` — prompts the user to choose their AI coding tool
+ * and runs `npx playwright init-agents --loop=<choice>`.
+ *
+ * Supports: OpenCode (default), Claude Code, VS Code (Copilot).
+ */
+async function initAgents(loopOverride) {
+    let loop;
+    if (loopOverride) {
+        loop = loopOverride;
+    }
+    else {
+        console.log('');
+        console.log(chalk_1.default.bold.cyan('  zosma-qa agents') + chalk_1.default.dim(' — Playwright AI agent setup'));
+        console.log('');
+        console.log(chalk_1.default.dim('  This generates agent definitions that let your AI tool act as a\n' +
+            '  Playwright planner, generator, and healer.\n'));
+        loop = await (0, prompts_1.select)({
+            message: 'Which AI coding tool are you using?',
+            choices: [
+                {
+                    name: 'OpenCode  (default)',
+                    value: 'opencode',
+                    description: 'opencode.ai — the AI coding agent',
+                },
+                {
+                    name: 'Claude Code',
+                    value: 'claude',
+                    description: 'Anthropic\'s Claude Code CLI (claude.ai/code)',
+                },
+                {
+                    name: 'VS Code  (Copilot)',
+                    value: 'vscode',
+                    description: 'GitHub Copilot agent mode inside VS Code',
+                },
+            ],
+            default: 'opencode',
+        });
+    }
+    console.log('');
+    console.log(chalk_1.default.dim(`  Running: npx playwright init-agents --loop=${loop}`));
+    console.log('');
+    const exitCode = await spawnAsync('npx', ['playwright', 'init-agents', `--loop=${loop}`]);
+    if (exitCode === 0) {
+        console.log('');
+        console.log(chalk_1.default.bold.green('  Agent definitions generated!'));
+        console.log('');
+        console.log(chalk_1.default.dim('  Three agents are now available:\n'));
+        console.log(`  ${chalk_1.default.bold('🎭 planner')}    explores your app and writes a Markdown test plan`);
+        console.log(`  ${chalk_1.default.bold('🎭 generator')}  turns the plan into Playwright test files`);
+        console.log(`  ${chalk_1.default.bold('🎭 healer')}     runs failing tests and repairs them automatically`);
+        console.log('');
+        console.log(chalk_1.default.dim('  Prompt your AI tool:\n' +
+            `    "${chalk_1.default.white('Use the planner agent. Seed: tests/seed.spec.ts')}"\n`));
+    }
+    else {
+        console.log('');
+        console.log(chalk_1.default.yellow('  Could not run playwright init-agents.'));
+        console.log(chalk_1.default.dim('  Make sure Playwright is installed:\n' +
+            '    pnpm install && npx playwright install\n'));
+        process.exit(exitCode);
+    }
+}
+function spawnAsync(cmd, args) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(cmd, args, {
+            stdio: 'inherit',
+            cwd: process.cwd(),
+            env: { ...process.env },
+        });
+        child.on('close', (code) => resolve(code ?? 1));
+        child.on('error', reject);
+    });
+}
+//# sourceMappingURL=agents.js.map

package/dist/commands/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function runInit(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA0DA,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA+I7C"}

package/dist/commands/init.js

@@ -0,0 +1,191 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const prompts_1 = require("@inquirer/prompts");
+// ─── Template content ─────────────────────────────────────────────────────────
+function seedSpecTemplate(baseURL) {
+    return `import { test, expect } from '@playwright/test';
+
+/**
+ * seed.spec.ts — entry point for Playwright AI agents.
+ *
+ * This test bootstraps the page context that the planner, generator,
+ * and healer agents use as their starting point.
+ *
+ * How to use with agents:
+ *   npx zosma-qa agents init        # set up agent definitions
+ *   # Then prompt your AI tool:
+ *   #   "Use the planner agent. Seed: tests/seed.spec.ts"
+ */
+test('seed', async ({ page }) => {
+  await page.goto('${baseURL}');
+  await expect(page).toHaveTitle(/.+/);
+});
+`;
+}
+function playwrightConfigTemplate(baseURL, browsers) {
+    const browsersJson = JSON.stringify(browsers);
+    return `import { defineConfig } from '@zosmaai/zosma-qa-playwright';
+
+export default defineConfig({
+  use: {
+    baseURL: '${baseURL}',
+  },
+  browsers: ${browsersJson},
+});
+`;
+}
+function zosmaConfigTemplate(baseURL, browsers) {
+    const browsersJson = JSON.stringify(browsers);
+    return `import { defineConfig } from '@zosmaai/zosma-qa-core';
+
+export default defineConfig({
+  plugins: ['playwright'],
+  baseURL: '${baseURL}',
+  browsers: ${browsersJson},
+});
+`;
+}
+// ─── Main init command ────────────────────────────────────────────────────────
+async function runInit() {
+    const cwd = process.cwd();
+    console.log('');
+    console.log(chalk_1.default.bold.cyan('  zosma-qa') + chalk_1.default.dim(' — zero-config QA platform'));
+    console.log('');
+    // ── Gather inputs ──────────────────────────────────────────────────────────
+    const baseURL = await (0, prompts_1.input)({
+        message: 'Base URL of the app under test:',
+        default: 'http://localhost:3000',
+        validate: (v) => (v.startsWith('http') ? true : 'Must start with http:// or https://'),
+    });
+    const browsers = await (0, prompts_1.checkbox)({
+        message: 'Which browsers to test? (space to select)',
+        choices: [
+            { name: 'Chromium  (recommended)', value: 'chromium', checked: true },
+            { name: 'Firefox', value: 'firefox', checked: false },
+            { name: 'WebKit  (Safari)', value: 'webkit', checked: false },
+        ],
+        validate: (v) => (v.length > 0 ? true : 'Select at least one browser'),
+    });
+    const agentLoop = await (0, prompts_1.select)({
+        message: 'Set up AI agents for test generation?',
+        choices: [
+            {
+                name: 'OpenCode  (default)',
+                value: 'opencode',
+                description: 'Initialise agent definitions for the OpenCode AI coding tool',
+            },
+            {
+                name: 'Claude Code',
+                value: 'claude',
+                description: 'Initialise agent definitions for Claude Code (claude.ai/code)',
+            },
+            {
+                name: 'VS Code  (Copilot)',
+                value: 'vscode',
+                description: 'Initialise agent definitions for GitHub Copilot in VS Code',
+            },
+            {
+                name: 'Skip for now',
+                value: 'skip',
+                description: 'You can always run `npx zosma-qa agents init` later',
+            },
+        ],
+        default: 'opencode',
+    });
+    console.log('');
+    // ── Scaffold files ─────────────────────────────────────────────────────────
+    const spinner = (0, ora_1.default)();
+    // tests/
+    const testsDir = path_1.default.join(cwd, 'tests');
+    ensureDir(testsDir);
+    const seedPath = path_1.default.join(testsDir, 'seed.spec.ts');
+    if (!fs_1.default.existsSync(seedPath)) {
+        fs_1.default.writeFileSync(seedPath, seedSpecTemplate(baseURL), 'utf8');
+        spinner.succeed(chalk_1.default.green(`Created  tests/seed.spec.ts`));
+    }
+    else {
+        spinner.info(chalk_1.default.dim(`Skipped  tests/seed.spec.ts  (already exists)`));
+        spinner.stop();
+    }
+    // specs/
+    const specsDir = path_1.default.join(cwd, 'specs');
+    ensureDir(specsDir);
+    const specsKeep = path_1.default.join(specsDir, '.gitkeep');
+    if (!fs_1.default.existsSync(specsKeep)) {
+        fs_1.default.writeFileSync(specsKeep, '', 'utf8');
+    }
+    spinner.succeed(chalk_1.default.green(`Created  specs/  (AI planner writes test plans here)`));
+    // playwright.config.ts
+    const pwConfigPath = path_1.default.join(cwd, 'playwright.config.ts');
+    if (!fs_1.default.existsSync(pwConfigPath)) {
+        fs_1.default.writeFileSync(pwConfigPath, playwrightConfigTemplate(baseURL, browsers), 'utf8');
+        spinner.succeed(chalk_1.default.green(`Created  playwright.config.ts`));
+    }
+    else {
+        spinner.info(chalk_1.default.dim(`Skipped  playwright.config.ts  (already exists)`));
+        spinner.stop();
+    }
+    // zosma.config.ts
+    const zosmaConfigPath = path_1.default.join(cwd, 'zosma.config.ts');
+    if (!fs_1.default.existsSync(zosmaConfigPath)) {
+        fs_1.default.writeFileSync(zosmaConfigPath, zosmaConfigTemplate(baseURL, browsers), 'utf8');
+        spinner.succeed(chalk_1.default.green(`Created  zosma.config.ts`));
+    }
+    else {
+        spinner.info(chalk_1.default.dim(`Skipped  zosma.config.ts  (already exists)`));
+        spinner.stop();
+    }
+    // .github/agents/
+    const agentsDir = path_1.default.join(cwd, '.github', 'agents');
+    ensureDir(path_1.default.join(cwd, '.github'));
+    ensureDir(agentsDir);
+    const agentsKeep = path_1.default.join(agentsDir, '.gitkeep');
+    if (!fs_1.default.existsSync(agentsKeep)) {
+        fs_1.default.writeFileSync(agentsKeep, '', 'utf8');
+    }
+    // ── Run playwright init-agents ─────────────────────────────────────────────
+    if (agentLoop !== 'skip') {
+        console.log('');
+        const agentSpinner = (0, ora_1.default)(`Running: npx playwright init-agents --loop=${agentLoop}`).start();
+        try {
+            await spawnAsync('npx', ['playwright', 'init-agents', `--loop=${agentLoop}`], cwd);
+            agentSpinner.succeed(chalk_1.default.green(`Agent definitions written to .github/agents/  (loop: ${agentLoop})`));
+        }
+        catch (err) {
+            agentSpinner.warn(chalk_1.default.yellow(`Could not run playwright init-agents. Run manually:\n` +
+                `  npx playwright install && npx playwright init-agents --loop=${agentLoop}`));
+        }
+    }
+    // ── Summary ────────────────────────────────────────────────────────────────
+    console.log('');
+    console.log(chalk_1.default.bold.green('  Ready!') + '  Here\'s what to do next:\n');
+    console.log(`  ${chalk_1.default.cyan('npx zosma-qa run')}          run your tests`);
+    console.log(`  ${chalk_1.default.cyan('npx zosma-qa agents init')}  re-run agent setup for a different AI tool`);
+    console.log(`  ${chalk_1.default.cyan('npx zosma-qa report')}       open the HTML report`);
+    console.log('');
+    console.log(chalk_1.default.dim(`  Tip: open ${chalk_1.default.white('tests/seed.spec.ts')} and prompt your AI agent:\n` +
+        `       "Use the planner agent. Seed: tests/seed.spec.ts"\n`));
+}
+// ─── Utilities ────────────────────────────────────────────────────────────────
+function ensureDir(dir) {
+    if (!fs_1.default.existsSync(dir)) {
+        fs_1.default.mkdirSync(dir, { recursive: true });
+    }
+}
+function spawnAsync(cmd, args, cwd) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(cmd, args, { stdio: 'inherit', cwd });
+        child.on('close', (code) => (code === 0 ? resolve() : reject(new Error(`exit ${code}`))));
+        child.on('error', reject);
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/report.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `zosma-qa report` — opens the Playwright HTML report in the default browser.
+ */
+export declare function openReport(): Promise<void>;
+//# sourceMappingURL=report.d.ts.map

package/dist/commands/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAYhD"}

package/dist/commands/report.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openReport = openReport;
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * `zosma-qa report` — opens the Playwright HTML report in the default browser.
+ */
+async function openReport() {
+    console.log('');
+    console.log(chalk_1.default.bold.cyan('  zosma-qa') + chalk_1.default.dim('  opening HTML report…'));
+    console.log('');
+    const exitCode = await spawnAsync('npx', ['playwright', 'show-report']);
+    if (exitCode !== 0) {
+        console.log(chalk_1.default.yellow('\n  No report found. Run tests first:'));
+        console.log(chalk_1.default.dim('    npx zosma-qa run\n'));
+        process.exit(exitCode);
+    }
+}
+function spawnAsync(cmd, args) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(cmd, args, {
+            stdio: 'inherit',
+            cwd: process.cwd(),
+            env: { ...process.env },
+        });
+        child.on('close', (code) => resolve(code ?? 1));
+        child.on('error', reject);
+    });
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":";;;;;AAMA,gCAYC;AAlBD,iDAAsC;AACtC,kDAA0B;AAE1B;;GAEG;AACI,KAAK,UAAU,UAAU;IAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,eAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IAExE,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,uCAAuC,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,GAAW,EAAE,IAAc;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,GAAG,EAAE,IAAI,EAAE;YAC7B,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/run.d.ts

@@ -0,0 +1,15 @@
+export interface RunOptions {
+    project?: string;
+    grep?: string;
+    headed?: boolean;
+    debug?: boolean;
+    workers?: string;
+    shard?: string;
+    reporter?: string;
+}
+/**
+ * `zosma-qa run` — delegates to `npx playwright test` with all flags
+ * forwarded so the full Playwright feature set remains available.
+ */
+export declare function runTests(options?: RunOptions): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBtE"}

package/dist/commands/run.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTests = runTests;
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * `zosma-qa run` — delegates to `npx playwright test` with all flags
+ * forwarded so the full Playwright feature set remains available.
+ */
+async function runTests(options = {}) {
+    const args = buildArgs(options);
+    console.log('');
+    console.log(chalk_1.default.bold.cyan('  zosma-qa') +
+        chalk_1.default.dim('  running: ') +
+        chalk_1.default.white(`npx playwright ${args.join(' ')}`));
+    console.log('');
+    const exitCode = await spawnPlaywright(args);
+    if (exitCode !== 0) {
+        console.log('');
+        console.log(chalk_1.default.dim(`  View the report: `) + chalk_1.default.cyan('npx zosma-qa report'));
+        process.exit(exitCode);
+    }
+}
+// ─── helpers ──────────────────────────────────────────────────────────────────
+function buildArgs(options) {
+    const args = ['test'];
+    if (options.project)
+        args.push('--project', options.project);
+    if (options.grep)
+        args.push('--grep', options.grep);
+    if (options.headed)
+        args.push('--headed');
+    if (options.debug)
+        args.push('--debug');
+    if (options.workers)
+        args.push('--workers', options.workers);
+    if (options.shard)
+        args.push('--shard', options.shard);
+    if (options.reporter)
+        args.push('--reporter', options.reporter);
+    return args;
+}
+function spawnPlaywright(args) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)('npx', ['playwright', ...args], {
+            stdio: 'inherit',
+            cwd: process.cwd(),
+            env: { ...process.env },
+        });
+        child.on('close', (code) => resolve(code ?? 1));
+        child.on('error', reject);
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":";;;;;AAiBA,4BAoBC;AArCD,iDAAsC;AACtC,kDAA0B;AAY1B;;;GAGG;AACI,KAAK,UAAU,QAAQ,CAAC,UAAsB,EAAE;IACrD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAEhC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;QAC3B,eAAK,CAAC,GAAG,CAAC,aAAa,CAAC;QACxB,eAAK,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAClD,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAE7C,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CACrE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,SAAS,SAAS,CAAC,OAAmB;IACpC,MAAM,IAAI,GAAa,CAAC,MAAM,CAAC,CAAC;IAEhC,IAAI,OAAO,CAAC,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,OAAO,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEhE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,IAAc;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,KAAK,EAAE,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,EAAE;YAClD,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const init_1 = require("./commands/init");
+const run_1 = require("./commands/run");
+const agents_1 = require("./commands/agents");
+const report_1 = require("./commands/report");
+const program = new commander_1.Command();
+program
+    .name('zosma-qa')
+    .description('Zero-config QA platform — Playwright, AI agents, and more')
+    .version('0.1.0');
+// ─── init ─────────────────────────────────────────────────────────────────────
+program
+    .command('init')
+    .description('Scaffold tests/, specs/, playwright.config.ts and set up AI agents')
+    .action(async () => {
+    await (0, init_1.runInit)();
+});
+// ─── run ──────────────────────────────────────────────────────────────────────
+program
+    .command('run')
+    .description('Run all Playwright tests (delegates to npx playwright test)')
+    .option('-p, --project <name>', 'Run a specific Playwright project (browser)')
+    .option('-g, --grep <pattern>', 'Only run tests matching this pattern')
+    .option('--headed', 'Run tests in headed (visible) browser mode')
+    .option('--debug', 'Run tests in Playwright debug mode')
+    .option('-w, --workers <n>', 'Number of parallel workers')
+    .option('--shard <shard>', 'Shard tests (e.g. 1/3)')
+    .option('--reporter <reporter>', 'Override reporter (e.g. list, dot, html)')
+    .action(async (options) => {
+    await (0, run_1.runTests)(options);
+});
+// ─── agents ───────────────────────────────────────────────────────────────────
+const agentsCmd = program
+    .command('agents')
+    .description('Manage Playwright AI agent definitions');
+agentsCmd
+    .command('init')
+    .description('Generate Playwright AI agent definitions for your AI coding tool')
+    .option('--loop <loop>', 'AI loop to use: opencode | claude | vscode')
+    .action(async (options) => {
+    await (0, agents_1.initAgents)(options.loop);
+});
+// ─── report ───────────────────────────────────────────────────────────────────
+program
+    .command('report')
+    .description('Open the latest Playwright HTML report in the browser')
+    .action(async () => {
+    await (0, report_1.openReport)();
+});
+// ─── fallback ─────────────────────────────────────────────────────────────────
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAAA,yCAAoC;AACpC,0CAA0C;AAC1C,wCAA0C;AAC1C,8CAA+C;AAC/C,8CAA+C;AAE/C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,2DAA2D,CAAC;KACxE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,iFAAiF;AAEjF,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,oEAAoE,CAAC;KACjF,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,cAAO,GAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEL,iFAAiF;AAEjF,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,6DAA6D,CAAC;KAC1E,MAAM,CAAC,sBAAsB,EAAE,6CAA6C,CAAC;KAC7E,MAAM,CAAC,sBAAsB,EAAE,sCAAsC,CAAC;KACtE,MAAM,CAAC,UAAU,EAAE,4CAA4C,CAAC;KAChE,MAAM,CAAC,SAAS,EAAE,oCAAoC,CAAC;KACvD,MAAM,CAAC,mBAAmB,EAAE,4BAA4B,CAAC;KACzD,MAAM,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;KACnD,MAAM,CAAC,uBAAuB,EAAE,0CAA0C,CAAC;KAC3E,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,IAAA,cAAQ,EAAC,OAAO,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEL,iFAAiF;AAEjF,MAAM,SAAS,GAAG,OAAO;KACtB,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,wCAAwC,CAAC,CAAC;AAEzD,SAAS;KACN,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,kEAAkE,CAAC;KAC/E,MAAM,CAAC,eAAe,EAAE,4CAA4C,CAAC;KACrE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,IAAA,mBAAU,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEL,iFAAiF;AAEjF,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,uDAAuD,CAAC;KACpE,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,mBAAU,GAAE,CAAC;AACrB,CAAC,CAAC,CAAC;AAEL,iFAAiF;AAEjF,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@zosmaai/zosma-qa-cli",
+  "version": "0.0.4",
+  "description": "CLI for zosma-qa — zero-config QA platform",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zosmaai/zosma-qa.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/zosmaai/zosma-qa#readme",
+  "bugs": {
+    "url": "https://github.com/zosmaai/zosma-qa/issues"
+  },
+  "keywords": [
+    "playwright",
+    "testing",
+    "qa",
+    "e2e",
+    "cli",
+    "zero-config",
+    "ai-agents"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "zosma-qa": "bin/zosma-qa.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "ora": "^8.1.1",
+    "@zosmaai/zosma-qa-playwright": "0.0.4",
+    "@zosmaai/zosma-qa-core": "0.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}