@agents-forge/aiqa 1.0.0

package/dist/cli.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+/**
+ * @agents-forge/aiqa
+ * AI Assisted Quality Engineering — single unified agent
+ *
+ * Usage:
+ *   npx @agents-forge/aiqa                       (interactive: prompts for URL + existing requirements)
+ *   npx @agents-forge/aiqa https://my-app.com
+ *   npx @agents-forge/aiqa https://my-app.com --grep @smoke
+ *   npx @agents-forge/aiqa https://my-app.com --resume
+ */
+import { runAIQA, detectProvider } from "./agent.js";
+import { loadConfig, resolvePaths } from "./config.js";
+import * as fs from "fs";
+import * as path from "path";
+import * as readline from "node:readline/promises";
+// ─── Banner ───────────────────────────────────────────────────────────────────
+console.log(`
+╔══════════════════════════════════════════════════════════════╗
+║                                                              ║
+║   🤖  AIQA — AI Assisted Quality Engineering                ║
+║       @agents-forge/aiqa                                     ║
+║                                                              ║
+║   analyst → qa-planner → qa-engineer                        ║
+║          → qa-reviewer → qa-reporter                        ║
+║                                                              ║
+║   Powered by playwright-cli + Claude                         ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+`);
+// ─── Load .env ────────────────────────────────────────────────────────────────
+try {
+    const { config } = await import("dotenv");
+    config();
+}
+catch { }
+// ─── Parse args ───────────────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+if (args.includes("--help") || args.includes("-h")) {
+    console.log(`Usage:
+  aiqa [url] [options]
+
+Arguments:
+  url             Website URL to analyse. Omit it to be prompted interactively.
+
+Options:
+  --grep <tag>         Run only tests matching tag (@smoke, @regression, @p0 etc.)
+  --skip <agents>      Comma-separated steps to skip
+  --dir <path>         Output directory (default: current directory)
+  --resume             Resume a previous pipeline run
+  --force, --yes, -y   Skip the confirmation before overwriting an existing
+                       playwright.config.ts (for CI / unattended runs)
+  --open               When run inside VS Code, open the generated requirements,
+                       test plan and summary report in Markdown preview
+  --verbose            Show tool call details
+
+Existing requirements (optional):
+  Place an existing requirements .md file in  .aiqa/requirements/  before running.
+  The analyst will still explore the site, then MERGE your document with the newly
+  discovered requirements into .aiqa/requirements/requirements.md.
+
+Config file (optional):
+  Drop an aiqa.config.ts (or .mjs/.js/.json) in the project root to set defaults for
+  any flag, the Claude model, and the .aiqa folder/subfolder names. CLI flags win.
+    import { defineConfig } from "@agents-forge/aiqa";
+    export default defineConfig({ url: "https://my-app.com", model: "claude-sonnet-4-6" });
+
+Examples:
+  aiqa                                  (interactive: asks for the URL + existing requirements)
+  aiqa https://www.saucedemo.com
+  aiqa https://my-app.com --grep @smoke
+  aiqa https://my-app.com --grep @regression --dir ./aiqa-output
+  aiqa https://my-app.com --skip qa-reviewer,qa-reporter
+  aiqa https://my-app.com --resume
+
+Pipeline steps:
+  analyst      Explores site with playwright-cli, captures snapshots → requirements/requirements.md
+  qa-planner   Reads requirements + snapshots → test-plan/test_plan.md
+  qa-engineer  Generates test cases + Playwright scripts (snapshot-aware) → test-scripts/
+  qa-reviewer  Validates selectors against snapshots → reports/review_report.md
+  qa-reporter  Runs tests, captures failure snapshots → reports/summary_report.md
+
+Prerequisites:
+  npm install -g @playwright/cli@latest
+  playwright-cli install --skills
+  npx playwright install chromium
+
+Authentication (auto-detected):
+  1. ANTHROPIC_API_KEY in .env
+  2. claude login
+  3. gh auth login
+`);
+    process.exit(0);
+}
+// Parse flags
+const getFlag = (flag) => {
+    const idx = args.indexOf(flag);
+    return idx !== -1 ? args[idx + 1] : undefined;
+};
+// ─── Config file (aiqa.config.ts) ────────────────────────────────────────────
+// CLI flags override config-file values, which override built-in defaults.
+const flagDir = getFlag("--dir");
+const { config: cfg, file: cfgFile } = await loadConfig(flagDir ?? process.cwd());
+if (cfgFile)
+    console.log(`🛠️  Loaded config: ${path.basename(cfgFile)}`);
+const grep = getFlag("--grep") ?? cfg.grep;
+const cwd = flagDir ?? cfg.dir ?? process.cwd();
+const verbose = args.includes("--verbose") || !!cfg.verbose;
+const resume = args.includes("--resume") || !!cfg.resume;
+const force = args.includes("--force") || args.includes("--yes") || args.includes("-y") || !!cfg.force;
+const open = args.includes("--open") || !!cfg.open;
+const model = cfg.model;
+const paths = cfg.paths;
+const resolved = resolvePaths(paths);
+const validAgents = ["analyst", "qa-planner", "qa-engineer", "qa-reviewer", "qa-reporter"];
+const skipRaw = getFlag("--skip");
+const skip = skipRaw
+    ? skipRaw.split(",").map((s) => s.trim()).filter((s) => validAgents.includes(s))
+    : (cfg.skip ?? []);
+// ─── Interactive prompts ────────────────────────────────────────────────────────
+async function ask(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        return (await rl.question(question)).trim();
+    }
+    finally {
+        rl.close();
+    }
+}
+// Create the requirements drop-folder up front so users can place an existing doc there.
+const reqDir = path.join(cwd, resolved.base, resolved.requirements);
+fs.mkdirSync(reqDir, { recursive: true });
+const reqDirLabel = path.relative(cwd, reqDir) || reqDir;
+// Target URL: positional argument, config `url`, or ask for it interactively.
+let target = args[0] && !args[0].startsWith("-") ? args[0] : cfg.url;
+const interactive = !target;
+if (!target) {
+    target = await ask("🔗  Please enter the URL to analyse: ");
+    if (!target) {
+        console.error("❌ No URL provided — nothing to analyse.");
+        process.exit(1);
+    }
+}
+// Existing requirements doc (optional). The user drops a .md in .aiqa/requirements/.
+if (interactive) {
+    await ask(`📄  If you have an existing requirements document, put the .md file in '${reqDirLabel}' ` +
+        `now, then press Enter (or just press Enter to skip): `);
+}
+const allMd = fs.existsSync(reqDir)
+    ? fs.readdirSync(reqDir).filter((f) => f.toLowerCase().endsWith(".md"))
+    : [];
+// Prefer any doc that isn't named like our generated output. If the user named
+// their file requirements.md (fresh run only), still pick it up — runAIQA will
+// preserve it before writing the merged output.
+let chosen = allMd.find((f) => f !== "requirements.md");
+if (!chosen && !resume && allMd.includes("requirements.md"))
+    chosen = "requirements.md";
+const existingRequirements = chosen ? path.join(reqDir, chosen) : cfg.existingRequirements;
+if (existingRequirements) {
+    console.log(`   ↳ Existing requirements detected: ${chosen} — the analyst will merge it with what it discovers.`);
+}
+else if (interactive) {
+    console.log("   ↳ No existing requirements — the analyst will build them from exploration.");
+}
+// ─── Auth ─────────────────────────────────────────────────────────────────────
+const provider = detectProvider();
+console.log(`🔐 Auth: ${provider}`);
+if (provider === "anthropic" && !process.env.ANTHROPIC_API_KEY && !process.env.ANTHROPIC_AUTH_TOKEN) {
+    console.log("ℹ️  No API key — trying claude login session...");
+}
+// ─── Run ──────────────────────────────────────────────────────────────────────
+try {
+    const result = await runAIQA({ target, grep, skip, cwd, verbose, resume, force, existingRequirements, open, model, paths });
+    const icon = result.passed ? "✅" : "⚠️";
+    const duration = Math.floor(result.totalDuration / 1000);
+    console.log(`\n${icon} AIQA complete in ${duration}s`);
+    console.log(`📄 Session: ${result.sessionFile}`);
+    console.log(`\n💡 Next steps:`);
+    console.log(`   npx playwright test --ui                                  (run the tests in UI mode)`);
+    console.log(`   npx playwright show-report .aiqa/reports/playwright-report  (view the last HTML report)`);
+    console.log(`   npx @agents-forge/aiqa ${target} --resume                  (resume if needed)`);
+    process.exit(result.passed ? 0 : 1);
+}
+catch (err) {
+    console.error(`\n❌ ${err.message}`);
+    if (!process.env.ANTHROPIC_API_KEY) {
+        console.error(`
+No authentication found:
+  Option 1: ANTHROPIC_API_KEY=sk-ant-... in .env
+  Option 2: claude login
+  Option 3: gh auth login`);
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,59 @@
+export type AgentId = "analyst" | "qa-planner" | "qa-engineer" | "qa-reviewer" | "qa-reporter";
+/** Configurable .aiqa base + subfolder names. */
+export interface AIQAPaths {
+    /** Base output folder. Default ".aiqa" */
+    base?: string;
+    /** Requirements folder. Default "requirements" */
+    requirements?: string;
+    /** Test plan folder. Default "test-plan" */
+    plan?: string;
+    /** Test cases folder. Default "test-cases" */
+    testCases?: string;
+    /** Spec files folder. Default "test-scripts" */
+    testScripts?: string;
+    /** Reports folder. Default "reports" */
+    reports?: string;
+}
+/**
+ * aiqa.config.ts shape. Every field is optional — CLI flags always override
+ * what's set here, which overrides the built-in defaults.
+ */
+export interface AIQAConfig {
+    /** Default URL to analyse (skips the interactive prompt). */
+    url?: string;
+    /** Default test tag filter, e.g. "@smoke". */
+    grep?: string;
+    /** Subagents to skip. */
+    skip?: AgentId[];
+    /** Resume a previous run by default. */
+    resume?: boolean;
+    /** Skip the playwright.config.ts overwrite confirmation. */
+    force?: boolean;
+    /** Open the generated docs in VS Code Markdown preview after the run. */
+    open?: boolean;
+    /** Verbose tool logging. */
+    verbose?: boolean;
+    /** Output directory (where .aiqa/ is created). Default: cwd. */
+    dir?: string;
+    /** Path to an existing requirements .md to merge in. */
+    existingRequirements?: string;
+    /** Claude model id, e.g. "claude-sonnet-4-6". */
+    model?: string;
+    /** Override the .aiqa base + subfolder names. */
+    paths?: AIQAPaths;
+}
+export declare const DEFAULT_PATHS: Required<AIQAPaths>;
+/** Typed helper for authoring aiqa.config.ts. */
+export declare function defineConfig(config: AIQAConfig): AIQAConfig;
+/** Apply defaults to a partial paths config. */
+export declare function resolvePaths(paths?: AIQAPaths): Required<AIQAPaths>;
+/**
+ * Find and load aiqa.config.{ts,mts,mjs,js,json} from `dir`.
+ * .ts/.js/.mjs are loaded via jiti (no build step); .json is parsed directly.
+ * Returns {} when no config file is present.
+ */
+export declare function loadConfig(dir: string): Promise<{
+    config: AIQAConfig;
+    file?: string;
+}>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,CAAC;AAE/F,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IAEzB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAG9B,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,SAAS,CAO7C,CAAC;AAEF,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAEnE;AAUD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB5F"}

package/dist/config.js

@@ -0,0 +1,53 @@
+import * as fs from "fs";
+import * as path from "path";
+import { createJiti } from "jiti";
+export const DEFAULT_PATHS = {
+    base: ".aiqa",
+    requirements: "requirements",
+    plan: "test-plan",
+    testCases: "test-cases",
+    testScripts: "test-scripts",
+    reports: "reports",
+};
+/** Typed helper for authoring aiqa.config.ts. */
+export function defineConfig(config) {
+    return config;
+}
+/** Apply defaults to a partial paths config. */
+export function resolvePaths(paths) {
+    return { ...DEFAULT_PATHS, ...(paths ?? {}) };
+}
+const CONFIG_NAMES = [
+    "aiqa.config.ts",
+    "aiqa.config.mts",
+    "aiqa.config.mjs",
+    "aiqa.config.js",
+    "aiqa.config.json",
+];
+/**
+ * Find and load aiqa.config.{ts,mts,mjs,js,json} from `dir`.
+ * .ts/.js/.mjs are loaded via jiti (no build step); .json is parsed directly.
+ * Returns {} when no config file is present.
+ */
+export async function loadConfig(dir) {
+    for (const name of CONFIG_NAMES) {
+        const file = path.join(dir, name);
+        if (!fs.existsSync(file))
+            continue;
+        try {
+            if (name.endsWith(".json")) {
+                return { config: JSON.parse(fs.readFileSync(file, "utf-8")), file };
+            }
+            const jiti = createJiti(import.meta.url);
+            const mod = await jiti.import(file);
+            const config = (mod?.default ?? mod ?? {});
+            return { config, file };
+        }
+        catch (err) {
+            console.log(`⚠️  Failed to load ${name}: ${err?.message ?? err}`);
+            return { config: {} };
+        }
+    }
+    return { config: {} };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAoDlC,MAAM,CAAC,MAAM,aAAa,GAAwB;IAChD,IAAI,EAAE,OAAO;IACb,YAAY,EAAE,cAAc;IAC5B,IAAI,EAAE,WAAW;IACjB,SAAS,EAAE,YAAY;IACvB,WAAW,EAAE,cAAc;IAC3B,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,OAAO,EAAE,GAAG,aAAa,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,YAAY,GAAG;IACnB,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,kBAAkB;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAe,EAAE,IAAI,EAAE,CAAC;YACpF,CAAC;YACD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzC,MAAM,GAAG,GAAQ,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,OAAO,IAAI,GAAG,IAAI,EAAE,CAAe,CAAC;YACzD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,KAAK,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;YAClE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @agents-forge/aiqa
+ *
+ * Single unified AI Quality Engineering Pipeline.
+ * One Claude session — analyst → qa-planner → qa-engineer → qa-reviewer → qa-reporter
+ * Context flows in memory. playwright-cli captures snapshots used across all steps.
+ *
+ * Usage:
+ *   import { runAIQA } from "@agents-forge/aiqa";
+ *   await runAIQA({ target: "https://my-app.com", grep: "@smoke" });
+ */
+export { runAIQA, detectProvider } from "./agent.js";
+export { SessionManager } from "./session.js";
+export { defineConfig, loadConfig, resolvePaths } from "./config.js";
+export type { AIQAInput, AIQAResult, Provider } from "./agent.js";
+export type { Session, Snapshot, PipelineStatus } from "./session.js";
+export type { AIQAConfig, AIQAPaths, AgentId } from "./config.js";
+//# 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":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @agents-forge/aiqa
+ *
+ * Single unified AI Quality Engineering Pipeline.
+ * One Claude session — analyst → qa-planner → qa-engineer → qa-reviewer → qa-reporter
+ * Context flows in memory. playwright-cli captures snapshots used across all steps.
+ *
+ * Usage:
+ *   import { runAIQA } from "@agents-forge/aiqa";
+ *   await runAIQA({ target: "https://my-app.com", grep: "@smoke" });
+ */
+export { runAIQA, detectProvider } from "./agent.js";
+export { SessionManager } from "./session.js";
+export { defineConfig, loadConfig, resolvePaths } from "./config.js";
+//# 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;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,50 @@
+import { type AIQAPaths } from "./config.js";
+export type PipelineStatus = "pending" | "in-progress" | "completed" | "failed" | "skipped";
+export interface Snapshot {
+    page: string;
+    url: string;
+    filePath: string;
+    capturedAt: string;
+}
+export interface Session {
+    target: string;
+    runId: string;
+    baseUrl: string;
+    startedAt: string;
+    snapshots: Record<string, Snapshot>;
+    auth: {
+        type: "none" | "form" | "sso" | "cookies";
+        savedSession?: string;
+    };
+    outputs: {
+        requirements: string;
+        testPlan: string;
+        testCasesDir: string;
+        specsDir: string;
+        reviewReport: string;
+        summaryReport: string;
+        snapshotsDir: string;
+        sessionFile: string;
+        authState: string;
+        reportsDir: string;
+        testResultsDir: string;
+        playwrightConfig: string;
+        htmlReport: string;
+    };
+    pipeline: Record<string, PipelineStatus>;
+    modules: string[];
+}
+export declare class SessionManager {
+    private session;
+    private sessionPath;
+    constructor(workingDir: string, target: string, resume?: boolean, pathsConfig?: AIQAPaths);
+    get(): Session;
+    setStatus(step: string, status: PipelineStatus): void;
+    addSnapshot(page: string, url: string, filePath: string): void;
+    setModules(modules: string[]): void;
+    setAuth(auth: Session["auth"]): void;
+    isCompleted(step: string): boolean;
+    save(): void;
+    printStatus(): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAI5D,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,aAAa,GACb,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;QAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAS;gBAEhB,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAQ,EAAE,WAAW,GAAE,SAAc;IAsE3F,GAAG,IAAI,OAAO;IAEd,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;IAK9C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAKvD,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE;IAC5B,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC;IAC7B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAElC,IAAI;IAIJ,WAAW;CAQZ"}

package/dist/session.js

@@ -0,0 +1,99 @@
+import * as fs from "fs";
+import * as path from "path";
+import { DEFAULT_PATHS } from "./config.js";
+// ─── Session manager ──────────────────────────────────────────────────────────
+export class SessionManager {
+    session;
+    sessionPath;
+    constructor(workingDir, target, resume = false, pathsConfig = {}) {
+        const runId = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+        const p = { ...DEFAULT_PATHS, ...pathsConfig };
+        const aiqaDir = path.join(workingDir, p.base);
+        const snapshotsDir = path.join(aiqaDir, "snapshots");
+        // Everything the pipeline produces lives under the base folder (.aiqa) so it
+        // never clutters the consumer's repo root. Only playwright.config.ts stays at
+        // the root, so `npx playwright test` can auto-discover it. Folder names are
+        // configurable via aiqa.config.ts → paths.
+        const reqDir = path.join(aiqaDir, p.requirements);
+        const planDir = path.join(aiqaDir, p.plan);
+        const testCasesDir = path.join(aiqaDir, p.testCases);
+        const specsDir = path.join(aiqaDir, p.testScripts);
+        const reportsDir = path.join(aiqaDir, p.reports);
+        const testResultsDir = path.join(reportsDir, "test-results");
+        let baseUrl = target;
+        try {
+            new URL(target);
+        }
+        catch {
+            baseUrl = "http://localhost:3000";
+        }
+        this.sessionPath = path.join(aiqaDir, "session.json");
+        if (resume && fs.existsSync(this.sessionPath)) {
+            const existing = JSON.parse(fs.readFileSync(this.sessionPath, "utf-8"));
+            if (existing.target === target) {
+                console.log(`\n♻️  Resuming existing session: ${existing.runId}`);
+                this.session = existing;
+                return;
+            }
+        }
+        this.session = {
+            target,
+            runId,
+            baseUrl,
+            startedAt: new Date().toISOString(),
+            snapshots: {},
+            auth: { type: "none" },
+            outputs: {
+                requirements: path.join(reqDir, "requirements.md"),
+                testPlan: path.join(planDir, "test_plan.md"),
+                testCasesDir,
+                specsDir,
+                reviewReport: path.join(reportsDir, "review_report.md"),
+                summaryReport: path.join(reportsDir, "summary_report.md"),
+                snapshotsDir,
+                sessionFile: this.sessionPath,
+                authState: path.join(aiqaDir, "auth-state.json"),
+                reportsDir,
+                testResultsDir,
+                playwrightConfig: path.join(workingDir, "playwright.config.ts"),
+                htmlReport: path.join(reportsDir, "playwright-report", "index.html"),
+            },
+            pipeline: {
+                analyst: "pending",
+                "qa-planner": "pending",
+                "qa-engineer": "pending",
+                "qa-reviewer": "pending",
+                "qa-reporter": "pending",
+            },
+            modules: [],
+        };
+        for (const dir of [snapshotsDir, reqDir, planDir, testCasesDir, specsDir, reportsDir, testResultsDir]) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        this.save();
+    }
+    get() { return this.session; }
+    setStatus(step, status) {
+        this.session.pipeline[step] = status;
+        this.save();
+    }
+    addSnapshot(page, url, filePath) {
+        this.session.snapshots[page] = { page, url, filePath, capturedAt: new Date().toISOString() };
+        this.save();
+    }
+    setModules(modules) { this.session.modules = modules; this.save(); }
+    setAuth(auth) { this.session.auth = auth; this.save(); }
+    isCompleted(step) { return this.session.pipeline[step] === "completed"; }
+    save() {
+        fs.writeFileSync(this.sessionPath, JSON.stringify(this.session, null, 2), "utf-8");
+    }
+    printStatus() {
+        console.log("\n📊 Pipeline status:");
+        for (const [step, status] of Object.entries(this.session.pipeline)) {
+            const icon = status === "completed" ? "✅" : status === "failed" ? "❌" :
+                status === "in-progress" ? "🔄" : status === "skipped" ? "⏭️" : "⬜";
+            console.log(`   ${icon} ${step}`);
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/subagents/analyst.d.ts

@@ -0,0 +1,3 @@
+import type { Session } from "../session.js";
+export declare function buildAnalystPrompt(session: Session, existingRequirements?: string): string;
+//# sourceMappingURL=analyst.d.ts.map

package/dist/subagents/analyst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst.d.ts","sourceRoot":"","sources":["../../src/subagents/analyst.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,oBAAoB,CAAC,EAAE,MAAM,GAAG,MAAM,CA8F1F"}

package/dist/subagents/analyst.js

@@ -0,0 +1,96 @@
+export function buildAnalystPrompt(session, existingRequirements) {
+    return `You are acting as a Senior Business Analyst with 15+ years experience.
+
+TARGET: "${session.target}"
+SNAPSHOTS DIR: "${session.outputs.snapshotsDir}"
+OUTPUT: "${session.outputs.requirements}"
+${existingRequirements ? `EXISTING REQUIREMENTS DOC: "${existingRequirements}"` : ""}
+${existingRequirements ? `
+## ⚠️ An existing requirements document was provided
+Before you start exploring, use the Read tool to read the existing document:
+"${existingRequirements}"
+You will STILL fully explore the site below. Afterwards you will MERGE the existing
+document with what you discover (see Phase 2) — never just copy it, and never discard it.
+` : ""}
+## Phase 1 — Explore with playwright-cli
+
+Use the Bash tool to run playwright-cli commands.
+
+### 1. Open the target
+\`\`\`bash
+playwright-cli open "${session.target}"
+\`\`\`
+
+### 2. For EACH page/state you visit:
+a) Capture a snapshot and save it:
+\`\`\`bash
+playwright-cli snapshot > "${session.outputs.snapshotsDir}/<page-name>.yml"
+\`\`\`
+Use descriptive names: home.yml, login.yml, product-list.yml, cart.yml, checkout.yml etc.
+
+b) Navigate to next page or state:
+\`\`\`bash
+playwright-cli click <ref>        # click a button/link using ref from snapshot
+playwright-cli navigate <url>     # go to a specific URL
+playwright-cli fill <ref> <value> # fill a form field
+\`\`\`
+
+### 3. Explore ALL key areas:
+- Home / landing page
+- Navigation structure (every menu item)
+- Authentication flows (login, register, forgot password)
+- Core user journeys (search, add to cart, checkout, profile etc.)
+- Error states (invalid login, empty forms, 404)
+- Any modal dialogs or overlays
+
+### 4. If you hit a login wall:
+Use AskFollowup to ask the user for credentials, then:
+\`\`\`bash
+playwright-cli fill <username-ref> "username"
+playwright-cli fill <password-ref> "password"
+playwright-cli click <submit-ref>
+playwright-cli snapshot > "${session.outputs.snapshotsDir}/post-login.yml"
+\`\`\`
+
+### 5. Save auth state if logged in:
+\`\`\`bash
+playwright-cli storage-state > "${session.outputs.authState}"
+\`\`\`
+
+## Phase 2 — Write requirements.md
+${existingRequirements ? `
+### MERGE MODE (an existing requirements document was provided)
+Write "${session.outputs.requirements}" as a clearly-sectioned MERGE. Do NOT ask the user —
+merge automatically. Start the document with these two top-level parts BEFORE the standard
+sections below:
+
+> **## Part A — Existing Requirements (carried over)**
+> Faithfully include / normalise every requirement from the provided document. Do not drop any.
+> Tag each line with \`[existing]\`.
+>
+> **## Part B — Newly Discovered Requirements (addon from exploration)**
+> The requirements you found by exploring the site that are NOT already covered in Part A.
+> Tag each line with \`[discovered]\`.
+>
+> Then continue with the standard numbered sections below, drawing from BOTH parts.
+` : ""}
+After exploration write "${session.outputs.requirements}" with these sections:
+
+1. **Executive Summary** — what this product does in plain language
+2. **Stakeholders & User Roles** — who uses it and their goals
+3. **User Journeys & Flows** — reference ACTUAL pages you visited with URLs
+4. **Functional Requirements** — MoSCoW table (FR-001, FR-002...)
+5. **Non-Functional Requirements** — performance, security, a11y (NFR-001...)
+6. **Data Requirements** — what data is created/read/updated/deleted
+7. **Integration Points** — APIs, third-party services spotted
+8. **Snapshot Index** — list every snapshot file captured with its URL
+9. **Assumptions & Constraints**
+10. **Open Questions**
+
+## Quality standards
+- Reference REAL pages and element names from snapshots — not guessed
+- Every requirement must be numbered (FR-001, NFR-001)
+- User journeys must reference actual URLs you visited
+- The snapshot index must list every .yml file saved`;
+}
+//# sourceMappingURL=analyst.js.map

package/dist/subagents/analyst.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst.js","sourceRoot":"","sources":["../../src/subagents/analyst.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,oBAA6B;IAChF,OAAO;;WAEE,OAAO,CAAC,MAAM;kBACP,OAAO,CAAC,OAAO,CAAC,YAAY;WACnC,OAAO,CAAC,OAAO,CAAC,YAAY;EACrC,oBAAoB,CAAC,CAAC,CAAC,+BAA+B,oBAAoB,GAAG,CAAC,CAAC,CAAC,EAAE;EAClF,oBAAoB,CAAC,CAAC,CAAC;;;GAGtB,oBAAoB;;;CAGtB,CAAC,CAAC,CAAC,EAAE;;;;;;;uBAOiB,OAAO,CAAC,MAAM;;;;;;6BAMR,OAAO,CAAC,OAAO,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;6BAyB5B,OAAO,CAAC,OAAO,CAAC,YAAY;;;;;kCAKvB,OAAO,CAAC,OAAO,CAAC,SAAS;;;;EAIzD,oBAAoB,CAAC,CAAC,CAAC;;SAEhB,OAAO,CAAC,OAAO,CAAC,YAAY;;;;;;;;;;;;;CAapC,CAAC,CAAC,CAAC,EAAE;2BACqB,OAAO,CAAC,OAAO,CAAC,YAAY;;;;;;;;;;;;;;;;;qDAiBF,CAAC;AACtD,CAAC"}