prose-qa 0.1.0

package/dist/cli/concurrency.test.js.map

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

package/dist/cli/config.d.ts

@@ -0,0 +1,2 @@
+export declare function executeConfig(key: string, value: string): Promise<number>;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAEA,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU/E"}

package/dist/cli/config.js

@@ -0,0 +1,14 @@
+import { setConfigValue } from "../config/set.js";
+export async function executeConfig(key, value) {
+    try {
+        await setConfigValue(key, value);
+        console.log(`Set ${key} = ${value}`);
+        return 0;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(message);
+        return 2;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,KAAa;IAC5D,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/cli/help.d.ts

@@ -0,0 +1,23 @@
+export interface CliArgument {
+    name: string;
+    description: string;
+    defaultValue?: string;
+}
+export interface CliOption {
+    flags: string;
+    description: string;
+    defaultValue?: string;
+}
+export interface CliCommandHelp {
+    name: string;
+    summary: string;
+    usage: string;
+    description: string;
+    arguments?: CliArgument[];
+    options?: CliOption[];
+    subcommands?: CliCommandHelp[];
+}
+export declare const CLI_REFERENCE: CliCommandHelp[];
+export declare function printTopLevelHelp(): void;
+export declare function executeHelp(args: string[]): number;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;CAChC;AAED,eAAO,MAAM,aAAa,EAAE,cAAc,EA2YzC,CAAC;AAwEF,wBAAgB,iBAAiB,IAAI,IAAI,CAexC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAgBlD"}

package/dist/cli/help.js

@@ -0,0 +1,458 @@
+export const CLI_REFERENCE = [
+    {
+        name: "run",
+        summary: "Run E2E scenarios (CI mode)",
+        usage: "pqa run [patterns...] [options]",
+        description: "Execute scenario files against your app. Headless by default; suited for CI.",
+        arguments: [
+            {
+                name: "patterns",
+                description: "Glob patterns for scenario markdown files",
+                defaultValue: "<scenariosDir>/**/*.md from pqa.config when omitted",
+            },
+        ],
+        options: [
+            {
+                flags: "-c, --config <path>",
+                description: "Path to pqa.config.json (or .mjs / .ts / .js)",
+            },
+            {
+                flags: "--tags <tags>",
+                description: "Comma-separated tags matched with AND; repeat for OR; prefix ! to exclude",
+            },
+            {
+                flags: "--tag <tag>",
+                description: "Single tag matched with OR; repeat for OR; prefix ! to match absence",
+            },
+            {
+                flags: "--skills-dir <dirs>",
+                description: "Extra skill directories, comma-separated",
+            },
+            {
+                flags: "--retries <n>",
+                description: "Retry count per failed scenario",
+                defaultValue: "0",
+            },
+            {
+                flags: "--retries-policy <policy>",
+                description: "When healing is enabled: retry only transient failures (transient) or any failure (always)",
+                defaultValue: "transient",
+            },
+            {
+                flags: "--no-healing",
+                description: "Disable in-run recovery and transient-only retry gating (retries apply to all failures)",
+            },
+            {
+                flags: "--no-cache",
+                description: "Do not load or write scenario replay hints cache",
+            },
+            {
+                flags: "--artifacts <mode>",
+                description: "When to keep artifacts: on-failure, always, or never",
+                defaultValue: "on-failure",
+            },
+            { flags: "--headed", description: "Run the browser in headed (visible) mode" },
+            {
+                flags: "--keep-browser",
+                description: "Leave the browser open after each scenario for inspection",
+            },
+            {
+                flags: "--auth-refresh",
+                description: "Re-run auth scenarios and refresh the auth store",
+            },
+            {
+                flags: "--parallel [n]",
+                description: "Run scenarios in parallel subprocesses; optional max concurrency (omit n for unlimited). Keeps up to n scenarios running and starts the next as soon as a slot frees.",
+            },
+            {
+                flags: "--fail-fast",
+                description: "Stop on first failure instead of running all scenarios",
+            },
+            {
+                flags: "--report-output <path>",
+                description: "Report output path; trailing / creates a runId-named folder or zip inside, otherwise uses the full path",
+            },
+            {
+                flags: "--report-zip",
+                description: "Emit the report as a zip archive instead of a directory",
+            },
+        ],
+    },
+    {
+        name: "debug",
+        summary: "Run scenarios with verbose output (local debug)",
+        usage: "pqa debug [patterns...] [options]",
+        description: "Same as run, but verbose logging and headed browser by default. Use for local troubleshooting.",
+        arguments: [
+            {
+                name: "patterns",
+                description: "Glob patterns for scenario markdown files",
+                defaultValue: "<scenariosDir>/**/*.md from pqa.config when omitted",
+            },
+        ],
+        options: [
+            {
+                flags: "-c, --config <path>",
+                description: "Path to pqa.config.json (or .mjs / .ts / .js)",
+            },
+            {
+                flags: "--tags <tags>",
+                description: "Comma-separated tags matched with AND; repeat for OR; prefix ! to exclude",
+            },
+            {
+                flags: "--tag <tag>",
+                description: "Single tag matched with OR; repeat for OR; prefix ! to match absence",
+            },
+            {
+                flags: "--skills-dir <dirs>",
+                description: "Extra skill directories, comma-separated",
+            },
+            {
+                flags: "--pause",
+                description: "Pause between agent turns (press Enter to continue)",
+            },
+            {
+                flags: "--keep-browser",
+                description: "Leave the browser open after each scenario for inspection",
+            },
+            {
+                flags: "--auth-refresh",
+                description: "Re-run auth scenarios and refresh the auth store",
+            },
+            {
+                flags: "--retries <n>",
+                description: "Retry count per failed scenario",
+                defaultValue: "0",
+            },
+            {
+                flags: "--retries-policy <policy>",
+                description: "When healing is enabled: retry only transient failures (transient) or any failure (always)",
+                defaultValue: "transient",
+            },
+            { flags: "--no-healing", description: "Disable in-run recovery and transient-only retries" },
+            {
+                flags: "--no-cache",
+                description: "Do not load or write scenario replay hints cache",
+            },
+            {
+                flags: "--parallel [n]",
+                description: "Run scenarios in parallel subprocesses; optional max concurrency (omit n for unlimited). Keeps up to n scenarios running and starts the next as soon as a slot frees.",
+            },
+            {
+                flags: "--fail-fast",
+                description: "Stop on first failure instead of running all scenarios",
+            },
+            {
+                flags: "--no-headed",
+                description: "Run the browser headless instead of the debug default (headed)",
+            },
+            {
+                flags: "--report-output <path>",
+                description: "Report output path; trailing / creates a runId-named folder or zip inside, otherwise uses the full path",
+            },
+            {
+                flags: "--report-zip",
+                description: "Emit the report as a zip archive instead of a directory",
+            },
+        ],
+    },
+    {
+        name: "clear-cache",
+        summary: "Clear scenario replay hints cache",
+        usage: "pqa clear-cache [scenario] [options]",
+        description: "Remove cached replay hints for one scenario (by frontmatter name) or all scenarios.",
+        arguments: [
+            {
+                name: "scenario",
+                description: "Scenario name to clear; omit to clear all caches",
+            },
+        ],
+        options: [
+            {
+                flags: "-c, --config <path>",
+                description: "Path to pqa.config.json (or .mjs / .ts / .js)",
+            },
+        ],
+    },
+    {
+        name: "config",
+        summary: "Set a value in pqa.config.json",
+        usage: "pqa config <key> <value>",
+        description: "Write a configuration override to pqa.config.json in the current directory. Creates an empty file when missing. Use dot notation for nested keys (e.g. browser.headed true). Keys must exist in the bundled reference config.",
+        arguments: [
+            {
+                name: "key",
+                description: "Config key, dot-separated for nested properties (e.g. browser.headed)",
+            },
+            {
+                name: "value",
+                description: "Value to set (booleans, numbers, JSON arrays/objects, or strings)",
+            },
+        ],
+    },
+    {
+        name: "analyze",
+        summary: "Analyze run(s) and review scenario fixes interactively",
+        usage: "pqa analyze [runPathOrId...] [options]",
+        description: "Single run: heuristic classification and LLM analysis on failed scenarios, then interactive patch review ([y/n/e/s/q/?]). Multiple runs or --last N: detect flaky scenarios with inconsistent verdicts, compare pass vs fail transcripts, and propose stabilizing edits.",
+        arguments: [
+            {
+                name: "runPathOrId...",
+                description: "One or more run directories or ids under .pqa/runs/ (default: latest run; 2+ ids or --last N enables multi-run flaky analysis)",
+            },
+        ],
+        options: [
+            { flags: "--config <path>", description: "Path to pqa.config file" },
+            {
+                flags: "--last <n>",
+                description: "Compare the N most recent runs for flaky scenarios (requires n ≥ 2)",
+            },
+        ],
+    },
+    {
+        name: "record",
+        summary: "Record browser sessions and generate scenarios",
+        usage: "pqa record <subcommand>",
+        description: "Capture user actions in a headed browser (or Chrome via --connect), then generate scenario markdown with the configured LLM.",
+        subcommands: [
+            {
+                name: "start",
+                summary: "Start recording",
+                usage: "pqa record start [options]",
+                description: "Open a headed browser with the recorder script and local event bridge.",
+                options: [
+                    { flags: "-c, --config <path>", description: "Config file path" },
+                    { flags: "--url <url>", description: "URL to open when recording starts" },
+                    { flags: "--no-headed", description: "Run headless (not recommended)" },
+                    { flags: "--session <name>", description: "agent-browser session name" },
+                    {
+                        flags: "--connect <port>",
+                        description: "Connect to Chrome CDP port instead of launching",
+                    },
+                ],
+            },
+            {
+                name: "note",
+                summary: "Add a comment to the active recording",
+                usage: "pqa record note <text>",
+                description: "Append a free-form note for scenario generation.",
+                arguments: [{ name: "text", description: "Comment text" }],
+            },
+            {
+                name: "checkpoint",
+                summary: "Add a Then-section hint",
+                usage: "pqa record checkpoint <text>",
+                description: "Append a checkpoint hint for the generated Then section.",
+                arguments: [{ name: "text", description: "Checkpoint hint" }],
+            },
+            {
+                name: "stop",
+                summary: "Stop recording and generate scenario",
+                usage: "pqa record stop [options]",
+                description: "Close the browser and generate scenarios/recorded/<name>.md.",
+                options: [
+                    { flags: "--name <name>", description: "Scenario name (kebab-case)" },
+                    { flags: "--out <path>", description: "Output markdown path" },
+                    { flags: "--no-generate", description: "Save events only, skip LLM" },
+                ],
+            },
+            {
+                name: "generate",
+                summary: "Generate scenario from a saved recording",
+                usage: "pqa record generate <recordingDir>",
+                description: "Regenerate scenario markdown from .pqa/recordings/<id>/.",
+                arguments: [
+                    {
+                        name: "recordingDir",
+                        description: "Path to a recording directory",
+                    },
+                ],
+                options: [
+                    { flags: "--name <name>", description: "Scenario name" },
+                    { flags: "--out <path>", description: "Output markdown path" },
+                ],
+            },
+        ],
+    },
+    {
+        name: "skills",
+        summary: "Manage agent skills",
+        usage: "pqa skills <subcommand>",
+        description: "Inspect and sync Anthropic-compatible SKILL.md files.",
+        subcommands: [
+            {
+                name: "list",
+                summary: "List discovered skills",
+                usage: "pqa skills list [options]",
+                description: "Print skill names, descriptions, and source directories.",
+                options: [
+                    {
+                        flags: "--skills-dir <dirs>",
+                        description: "Skill directories to scan (comma-separated)",
+                        defaultValue: "skills, .agents/skills",
+                    },
+                ],
+            },
+            {
+                name: "show",
+                summary: "Show full skill content",
+                usage: "pqa skills show <name> [options]",
+                description: "Print the full body of a skill by name.",
+                arguments: [{ name: "name", description: "Skill name to display" }],
+                options: [
+                    {
+                        flags: "--skills-dir <dirs>",
+                        description: "Skill directories to scan (comma-separated)",
+                        defaultValue: "skills, .agents/skills",
+                    },
+                ],
+            },
+            {
+                name: "sync",
+                summary: "Sync agent-browser skill from pinned npm version",
+                usage: "pqa skills sync",
+                description: "Re-vendor the agent-browser skill into skills/agent-browser/ (dev repo workflow).",
+            },
+        ],
+    },
+    {
+        name: "auth",
+        summary: "Authentication helpers",
+        usage: "pqa auth <subcommand>",
+        description: "Manage cached browser auth state for scenario profiles.",
+        subcommands: [
+            {
+                name: "list",
+                summary: "List cached auth profiles",
+                usage: "pqa auth list",
+                description: "Show profiles stored in the auth store with paths and timestamps.",
+            },
+            {
+                name: "clear",
+                summary: "Clear cached auth state",
+                usage: "pqa auth clear [profile]",
+                description: "Remove one profile or all profiles from the auth store.",
+                arguments: [
+                    {
+                        name: "profile",
+                        description: "Profile name to clear; omit to clear all",
+                    },
+                ],
+            },
+            {
+                name: "save",
+                summary: "Run auth scenario and save state",
+                usage: "pqa auth save <name> [options]",
+                description: "Execute the configured auth scenario for a profile and persist browser state.",
+                arguments: [{ name: "name", description: "Auth profile name from config" }],
+                options: [
+                    {
+                        flags: "-c, --config <path>",
+                        description: "Path to pqa.config.json (or .mjs / .ts / .js)",
+                    },
+                    { flags: "-v, --verbose", description: "Enable verbose agent output" },
+                ],
+            },
+        ],
+    },
+    {
+        name: "mcp",
+        summary: "Start MCP server (stdio)",
+        usage: "pqa mcp",
+        description: "Expose the create-pqa-scenario skill and tools to validate or run inline scenario markdown for Cursor and other MCP clients. Uses stdio transport; configure the client to spawn this command in your project directory (where pqa.config and env vars live).",
+    },
+    {
+        name: "help",
+        summary: "Show help for commands and options",
+        usage: "pqa help [command]",
+        description: "List all commands or show detailed help for one command.",
+        arguments: [
+            {
+                name: "command",
+                description: "Command name (e.g. run, debug, skills, auth)",
+            },
+        ],
+    },
+];
+const GLOBAL_OPTIONS = [
+    { flags: "-V, --version", description: "Print the CLI version" },
+    { flags: "-h, --help", description: "Show help for a command" },
+];
+function findCommand(path) {
+    if (path.length === 0)
+        return undefined;
+    const [head, ...rest] = path;
+    const top = CLI_REFERENCE.find((c) => c.name === head);
+    if (!top)
+        return undefined;
+    if (rest.length === 0)
+        return top;
+    const sub = top.subcommands?.find((c) => c.name === rest[0]);
+    if (!sub)
+        return undefined;
+    if (rest.length === 1)
+        return sub;
+    return undefined;
+}
+function formatDefault(value) {
+    return ` (default: ${value})`;
+}
+function printSection(title, lines) {
+    if (lines.length === 0)
+        return;
+    console.log(`\n${title}:`);
+    for (const line of lines) {
+        console.log(`  ${line}`);
+    }
+}
+function printCommandHelp(cmd) {
+    console.log(`\n${cmd.usage}\n`);
+    console.log(cmd.description);
+    if (cmd.arguments?.length) {
+        printSection("Arguments", cmd.arguments.map((arg) => {
+            const suffix = arg.defaultValue
+                ? formatDefault(arg.defaultValue)
+                : "";
+            return `${arg.name.padEnd(14)} ${arg.description}${suffix}`;
+        }));
+    }
+    if (cmd.options?.length) {
+        printSection("Options", cmd.options.map((opt) => {
+            const suffix = opt.defaultValue
+                ? formatDefault(opt.defaultValue)
+                : "";
+            return `${opt.flags.padEnd(22)} ${opt.description}${suffix}`;
+        }));
+    }
+    if (cmd.subcommands?.length) {
+        printSection("Subcommands", cmd.subcommands.map((sub) => `${sub.name.padEnd(14)} ${sub.summary}`));
+        console.log("\nRun `pqa help <command> <subcommand>` for subcommand options.");
+    }
+}
+export function printTopLevelHelp() {
+    console.log("ProseQA — agent harness for NL E2E regression testing\n");
+    console.log("Usage: pqa <command> [options]\n");
+    console.log("Commands:");
+    for (const cmd of CLI_REFERENCE) {
+        console.log(`  ${cmd.name.padEnd(14)} ${cmd.summary}`);
+    }
+    printSection("Global options", GLOBAL_OPTIONS.map((opt) => `${opt.flags.padEnd(22)} ${opt.description}`));
+    console.log("\nRun `pqa help <command>` for command-specific options.");
+    console.log("Exit codes: 0 pass · 1 failure · 2 config/harness error");
+}
+export function executeHelp(args) {
+    const path = args.filter(Boolean);
+    if (path.length === 0) {
+        printTopLevelHelp();
+        return 0;
+    }
+    const cmd = findCommand(path);
+    if (!cmd) {
+        console.error(`Unknown command: ${path.join(" ")}`);
+        console.error("Run `pqa help` for a list of commands.");
+        return 2;
+    }
+    printCommandHelp(cmd);
+    return 0;
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

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

package/dist/cli/help.test.d.ts

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

package/dist/cli/help.test.d.ts.map

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

package/dist/cli/help.test.js

@@ -0,0 +1,41 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { executeHelp, printTopLevelHelp } from "./help.js";
+describe("executeHelp", () => {
+    it("returns 0 for top-level help", () => {
+        assert.equal(executeHelp([]), 0);
+    });
+    it("returns 0 for known command", () => {
+        assert.equal(executeHelp(["run"]), 0);
+        assert.equal(executeHelp(["skills", "list"]), 0);
+    });
+    it("returns 2 for unknown command", () => {
+        assert.equal(executeHelp(["nope"]), 2);
+        assert.equal(executeHelp(["skills", "nope"]), 2);
+    });
+});
+describe("printTopLevelHelp", () => {
+    it("lists every command", () => {
+        const lines = [];
+        const log = console.log;
+        console.log = (...args) => {
+            lines.push(args.map(String).join(" "));
+        };
+        try {
+            printTopLevelHelp();
+        }
+        finally {
+            console.log = log;
+        }
+        const text = lines.join("\n");
+        assert.match(text, /run/);
+        assert.match(text, /debug/);
+        assert.match(text, /skills/);
+        assert.match(text, /auth/);
+        assert.match(text, /config/);
+        assert.match(text, /mcp/);
+        assert.match(text, /help/);
+        assert.match(text, /--version/);
+    });
+});
+//# sourceMappingURL=help.test.js.map

package/dist/cli/help.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.test.js","sourceRoot":"","sources":["../../src/cli/help.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE3D,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACxB,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YACnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC;QACF,IAAI,CAAC;YACH,iBAAiB,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;QACpB,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

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