flakelab 0.1.0 → 0.1.1

package/dist/cli-help.js

@@ -1,47 +1,76 @@
-export const VERSION = "0.1.0";
-export function helpText() {
-    return `FlakeLab ${VERSION} — find and prove flaky Playwright tests
-
-Usage
-  flakelab <path> [options]
-  flakelab <command> <target> [options]
-
-Easiest run
-  npx flakelab@latest .
-
-Common examples
-  npx flakelab@latest tests/checkout.spec.ts --runs 20
-  npx flakelab@latest tests/checkout.spec.ts --verbose
-  npx flakelab@latest tests/checkout.spec.ts --prove --pattern "**/api/checkout"
-
-Default scan options
-  --runs <number>          Repetitions to run (default: 4)
-  --concurrency <number>   Parallel test processes (default: 4)
-  --seed <number>          Deterministic seed (default: 1)
-  --artifacts <directory>  Evidence directory (default: .flakelab/runs)
-  --verbose                Include machine-readable evidence
-  --prove                  Run discovery, AI investigation, isolated repair, and report
-  --prompt-credentials     Securely replace provider keys for this run
-  --open                   Open the generated report
-
-Advanced commands
-  doctor                   Check local readiness and credential safety
-  diagnose <test>          Compare control and network-delay trials
-  discover <test>          Minimize a reproducible network trigger
-  replay <reproducer>      Verify a saved reproducer
-  investigate <test>       Run the bounded Groq investigator
-  repair <investigation>   Prove a candidate repair in Solari
-  report <investigation>   Build the portable evidence report
-  bisect --good <revision> Locate the introducing commit in Solari
-
-Environment
-  GROQ_API_KEY             Required for investigate, repair, and --prove
-  SOLARI_API_KEY           Required for repair, bisect, publish, and --prove
-  Missing keys are requested through hidden, run-once terminal prompts.
-  Provider keys are never passed to Playwright test processes.
-
-Detailed command documentation
-https://github.com/Astraque-Softwares/solari-cookbook/tree/main/projects/flakelab
-`;
+import { commandHelpText } from "./cli-command-help.js";
+import { labelColumn, TerminalDocument } from "./ui/document.js";
+import { PLAIN_THEME } from "./ui/theme.js";
+export const VERSION = "0.1.1";
+const DOCUMENTATION = "https://github.com/Astraque-Softwares/solari-cookbook/tree/main/projects/flakelab";
+const COMMAND_GROUPS = [
+    {
+        rows: [
+            { label: "scan <target>", value: "Run a bounded stability scan" },
+            { label: "analyze <blob-report>", value: "Triage an existing Playwright blob report" },
+            { label: "doctor", value: "Check local readiness and credential safety" },
+        ],
+        title: "Observe",
+    },
+    {
+        rows: [
+            { label: "diagnose [test]", value: "Explain evidence and run the next bounded step" },
+            { label: "discover <test>", value: "Minimize a reproducible causal fault" },
+            { label: "replay <reproducer>", value: "Verify a saved reproducer" },
+            { label: "resume <diagnose.json>", value: "Continue a checkpointed diagnosis" },
+        ],
+        title: "Reproduce",
+    },
+    {
+        rows: [
+            { label: "investigate <test>", value: "Run the bounded Groq investigator" },
+            { label: "repair <investigation>", value: "Prove a candidate repair in Solari" },
+            { label: "prove <test>", value: "Run discover, investigate, repair, and report" },
+            { label: "report <investigation>", value: "Build the portable evidence report" },
+            { label: "bisect --good <rev>", value: "Locate the introducing commit in Solari" },
+        ],
+        title: "Explain and prove",
+    },
+];
+const WORKFLOWS = [
+    { label: "Measure stability", value: "flakelab tests/checkout.spec.ts --runs 20" },
+    { label: "Triage CI evidence", value: "flakelab analyze ./blob-report" },
+    { label: "Find a trigger", value: "flakelab diagnose tests/checkout.spec.ts --discover" },
+    { label: "Prove a fix", value: "flakelab prove tests/checkout.spec.ts" },
+];
+const EXIT_CODES = [
+    { label: "0", value: "No failure observed" },
+    { label: "1", value: "Mixed outcomes, failure in every run, or command error" },
+    { label: "2", value: "Inconclusive scan caused by test or Playwright infrastructure" },
+];
+const CREDENTIALS = [
+    { label: "GROQ_API_KEY", value: "investigate, repair, prove" },
+    { label: "SOLARI_API_KEY", value: "repair, bisect, publish, prove" },
+];
+function appendCommands(document) {
+    const column = labelColumn(COMMAND_GROUPS.flatMap((group) => group.rows));
+    for (const group of COMMAND_GROUPS) {
+        document.section(group.title).rows(group.rows, column);
+    }
+}
+export function mainHelpText(theme = PLAIN_THEME) {
+    const document = new TerminalDocument(theme);
+    document.banner(`FlakeLab ${VERSION} — find and prove flaky Playwright tests`);
+    document.section("Usage");
+    document.command("flakelab <target> [scan options]");
+    document.command("flakelab <command> [command options]");
+    appendCommands(document);
+    document.section("Common workflows").rows(WORKFLOWS);
+    document.section("Exit codes").rows(EXIT_CODES);
+    document.section("Credentials").rows(CREDENTIALS);
+    document.note("Missing keys are requested through hidden, run-once terminal prompts and are never"
+        + " passed to Playwright test processes.");
+    document.section("More");
+    document.command("flakelab <command> --help");
+    document.note(DOCUMENTATION);
+    return `${document.render()}\n`;
+}
+export function helpText(topic, theme = PLAIN_THEME) {
+    return topic ? commandHelpText(topic, theme) : mainHelpText(theme);
 }
 //# sourceMappingURL=cli-help.js.map

package/dist/cli-help.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA;AAE9B,MAAM,UAAU,QAAQ;IACtB,OAAO,YAAY,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0C3B,CAAA;AACD,CAAC"}
+{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"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"}

package/dist/cli-option-definitions.d.ts

@@ -0,0 +1,202 @@
+export declare const CLI_OPTION_DEFINITIONS: {
+    readonly animationRate: {
+        readonly type: "string";
+        readonly default: "5";
+    };
+    readonly artifacts: {
+        readonly type: "string";
+        readonly default: ".flakelab/runs";
+    };
+    readonly bad: {
+        readonly type: "string";
+        readonly default: "HEAD";
+    };
+    readonly bisectParallelism: {
+        readonly type: "string";
+        readonly default: "2";
+    };
+    readonly bisectReport: {
+        readonly type: "string";
+        readonly default: "flakelab.bisect.json";
+    };
+    readonly concurrency: {
+        readonly type: "string";
+        readonly default: "1";
+    };
+    readonly clockOffsetMs: {
+        readonly type: "string";
+        readonly default: "3600000";
+    };
+    readonly cookieName: {
+        readonly type: "string";
+    };
+    readonly fault: {
+        readonly type: "string";
+        readonly default: "network-delay";
+    };
+    readonly html: {
+        readonly type: "string";
+        readonly default: "flakelab.report.html";
+    };
+    readonly json: {
+        readonly type: "boolean";
+        readonly default: false;
+    };
+    readonly jumpAfterMs: {
+        readonly type: "string";
+        readonly default: "0";
+    };
+    readonly locale: {
+        readonly type: "string";
+        readonly default: "fr-FR";
+    };
+    readonly maxCost: {
+        readonly type: "string";
+        readonly default: "0.25";
+    };
+    readonly maxCopies: {
+        readonly type: "string";
+        readonly default: "4";
+    };
+    readonly maxDelay: {
+        readonly type: "string";
+        readonly default: "250";
+    };
+    readonly discoveryMaxSeconds: {
+        readonly type: "string";
+        readonly default: "300";
+    };
+    readonly maxDuplicateBytes: {
+        readonly type: "string";
+        readonly default: "1024";
+    };
+    readonly maxHoldMs: {
+        readonly type: "string";
+        readonly default: "250";
+    };
+    readonly maxRemoveBytes: {
+        readonly type: "string";
+        readonly default: "1024";
+    };
+    readonly maxStallMs: {
+        readonly type: "string";
+        readonly default: "500";
+    };
+    readonly maxExperiments: {
+        readonly type: "string";
+        readonly default: "3";
+    };
+    readonly maxSeconds: {
+        readonly type: "string";
+        readonly default: "90";
+    };
+    readonly maxSteps: {
+        readonly type: "string";
+        readonly default: "3";
+    };
+    readonly maxTrials: {
+        readonly type: "string";
+        readonly default: "12";
+    };
+    readonly maxWorkers: {
+        readonly type: "string";
+        readonly default: "4";
+    };
+    readonly minRate: {
+        readonly type: "string";
+        readonly default: "0.7";
+    };
+    readonly model: {
+        readonly type: "string";
+        readonly default: "qwen/qwen3.8-27b";
+    };
+    readonly open: {
+        readonly type: "boolean";
+        readonly default: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly default: "flakelab.repro.yaml";
+    };
+    readonly patch: {
+        readonly type: "string";
+        readonly default: "candidate.diff";
+    };
+    readonly pattern: {
+        readonly type: "string";
+        readonly default: "**/api/checkout";
+    };
+    readonly proof: {
+        readonly type: "string";
+        readonly default: "flakelab.proof.json";
+    };
+    readonly promptCredentials: {
+        readonly type: "boolean";
+        readonly default: false;
+    };
+    readonly publish: {
+        readonly type: "boolean";
+        readonly default: false;
+    };
+    readonly report: {
+        readonly type: "string";
+        readonly default: "flakelab.investigation.json";
+    };
+    readonly reproducer: {
+        readonly type: "string";
+        readonly default: "flakelab.repro.yaml";
+    };
+    readonly resourceType: {
+        readonly type: "string";
+        readonly default: "script";
+    };
+    readonly runs: {
+        readonly type: "string";
+        readonly default: "4";
+    };
+    readonly seed: {
+        readonly type: "string";
+        readonly default: "1";
+    };
+    readonly source: {
+        readonly type: "string";
+        readonly multiple: true;
+        readonly default: string[];
+    };
+    readonly startupEvent: {
+        readonly type: "string";
+        readonly default: "dom-content-loaded";
+    };
+    readonly storage: {
+        readonly type: "string";
+        readonly default: "local-storage";
+    };
+    readonly storageKey: {
+        readonly type: "string";
+    };
+    readonly timezone: {
+        readonly type: "string";
+        readonly default: "America/New_York";
+    };
+    readonly stallAfterMs: {
+        readonly type: "string";
+        readonly default: "0";
+    };
+    readonly trials: {
+        readonly type: "string";
+        readonly default: "4";
+    };
+    readonly verbose: {
+        readonly type: "boolean";
+        readonly default: false;
+    };
+    readonly viewportHeight: {
+        readonly type: "string";
+        readonly default: "667";
+    };
+    readonly viewportWidth: {
+        readonly type: "string";
+        readonly default: "375";
+    };
+};
+export declare function requiredOption<T>(value: T | undefined, name: string): T;

package/dist/cli-option-definitions.js

@@ -0,0 +1,59 @@
+export const CLI_OPTION_DEFINITIONS = {
+    animationRate: { type: "string", default: "5" },
+    artifacts: { type: "string", default: ".flakelab/runs" },
+    bad: { type: "string", default: "HEAD" },
+    bisectParallelism: { type: "string", default: "2" },
+    bisectReport: { type: "string", default: "flakelab.bisect.json" },
+    concurrency: { type: "string", default: "1" },
+    clockOffsetMs: { type: "string", default: "3600000" },
+    cookieName: { type: "string" },
+    fault: { type: "string", default: "network-delay" },
+    html: { type: "string", default: "flakelab.report.html" },
+    json: { type: "boolean", default: false },
+    jumpAfterMs: { type: "string", default: "0" },
+    locale: { type: "string", default: "fr-FR" },
+    maxCost: { type: "string", default: "0.25" },
+    maxCopies: { type: "string", default: "4" },
+    maxDelay: { type: "string", default: "250" },
+    discoveryMaxSeconds: { type: "string", default: "300" },
+    maxDuplicateBytes: { type: "string", default: "1024" },
+    maxHoldMs: { type: "string", default: "250" },
+    maxRemoveBytes: { type: "string", default: "1024" },
+    maxStallMs: { type: "string", default: "500" },
+    maxExperiments: { type: "string", default: "3" },
+    maxSeconds: { type: "string", default: "90" },
+    maxSteps: { type: "string", default: "3" },
+    maxTrials: { type: "string", default: "12" },
+    maxWorkers: { type: "string", default: "4" },
+    minRate: { type: "string", default: "0.7" },
+    model: { type: "string", default: "qwen/qwen3.8-27b" },
+    open: { type: "boolean", default: false },
+    output: { type: "string", default: "flakelab.repro.yaml" },
+    patch: { type: "string", default: "candidate.diff" },
+    pattern: { type: "string", default: "**/api/checkout" },
+    proof: { type: "string", default: "flakelab.proof.json" },
+    promptCredentials: { type: "boolean", default: false },
+    publish: { type: "boolean", default: false },
+    report: { type: "string", default: "flakelab.investigation.json" },
+    reproducer: { type: "string", default: "flakelab.repro.yaml" },
+    resourceType: { type: "string", default: "script" },
+    runs: { type: "string", default: "4" },
+    seed: { type: "string", default: "1" },
+    source: { type: "string", multiple: true, default: [] },
+    startupEvent: { type: "string", default: "dom-content-loaded" },
+    storage: { type: "string", default: "local-storage" },
+    storageKey: { type: "string" },
+    timezone: { type: "string", default: "America/New_York" },
+    stallAfterMs: { type: "string", default: "0" },
+    trials: { type: "string", default: "4" },
+    verbose: { type: "boolean", default: false },
+    viewportHeight: { type: "string", default: "667" },
+    viewportWidth: { type: "string", default: "375" },
+};
+export function requiredOption(value, name) {
+    if (value === undefined) {
+        throw new Error(`Internal CLI default is missing for --${name}`);
+    }
+    return value;
+}
+//# sourceMappingURL=cli-option-definitions.js.map

package/dist/cli-option-definitions.js.map

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

package/dist/cli.js

@@ -1,121 +1,121 @@
-import { parseArgs } from "node:util";
+import { parseCliArguments } from "./cli-arguments.js";
 import { helpText, VERSION } from "./cli-help.js";
-import { bisect } from "./commands/bisect.js";
-import { diagnose } from "./commands/diagnose.js";
-import { discover } from "./commands/discover.js";
-import { doctor } from "./commands/doctor.js";
-import { investigate } from "./commands/investigate.js";
-import { prove } from "./commands/prove.js";
-import { repair } from "./commands/repair.js";
-import { replay } from "./commands/replay.js";
-import { generateReport } from "./commands/report.js";
-import { scan } from "./commands/scan.js";
-import { cliErrorMessage } from "./providers/errors.js";
-const ADVANCED_COMMANDS = new Set([
+import { writeStderr, writeStdout } from "./ui/console.js";
+import { TerminalDocument } from "./ui/document.js";
+import { stderrTheme, stdoutTheme } from "./ui/theme.js";
+const PROVIDER_COMMANDS = new Set([
     "bisect",
-    "diagnose",
-    "discover",
-    "doctor",
     "investigate",
+    "prove",
     "repair",
-    "replay",
     "report",
-    "scan",
 ]);
-async function runAdvanced(command, target, values) {
-    if (command === "doctor") {
-        if (target) {
-            throw new Error("doctor does not accept a target");
+async function runNonScanCommand(invocation) {
+    switch (invocation.command) {
+        case "bisect": {
+            const { bisect } = await import("./commands/bisect.js");
+            await bisect(invocation.options);
+            return;
+        }
+        case "diagnose": {
+            const { diagnose } = await import("./commands/diagnose.js");
+            await diagnose(invocation.target, invocation.options);
+            return;
+        }
+        case "discover": {
+            const { discover } = await import("./commands/discover.js");
+            await discover(invocation.target, invocation.options);
+            return;
+        }
+        case "doctor": {
+            const { doctor } = await import("./commands/doctor.js");
+            await doctor();
+            return;
+        }
+        case "investigate": {
+            const { investigate } = await import("./commands/investigate.js");
+            await investigate(invocation.target, invocation.options);
+            return;
+        }
+        case "prove": {
+            const { prove } = await import("./commands/prove.js");
+            await prove(invocation.target, invocation.options);
+            return;
+        }
+        case "repair": {
+            const { repair } = await import("./commands/repair.js");
+            await repair(invocation.target, invocation.options);
+            return;
+        }
+        case "replay": {
+            const { replay } = await import("./commands/replay.js");
+            await replay(invocation.target, invocation.options);
+            return;
+        }
+        case "report": {
+            const { generateReport } = await import("./commands/report.js");
+            await generateReport(invocation.target, invocation.options);
+            return;
         }
-        await doctor();
-        return;
-    }
-    if (command === "bisect") {
-        await bisect(values);
-        return;
-    }
-    const selectedTarget = target ?? (command === "scan" ? "." : undefined);
-    if (!selectedTarget) {
-        throw new Error(`${command} requires a target. Run flakelab --help for examples.`);
     }
-    const commands = {
-        diagnose,
-        discover,
-        investigate,
-        repair,
-        replay,
-        report: generateReport,
-        scan: async (value, options) => {
-            await scan(value, options);
-        },
-    };
-    await commands[command](selectedTarget, values);
 }
-async function main() {
-    const { positionals, values } = parseArgs({
-        allowPositionals: true,
-        options: {
-            artifacts: { type: "string", default: ".flakelab/runs" },
-            bad: { type: "string", default: "HEAD" },
-            "bisect-parallelism": { type: "string", default: "2" },
-            "bisect-report": { type: "string", default: "flakelab.bisect.json" },
-            concurrency: { type: "string", default: "4" },
-            "delay-ms": { type: "string", default: "250" },
-            "max-cost": { type: "string", default: "0.25" },
-            "max-delay": { type: "string", default: "250" },
-            "max-experiments": { type: "string", default: "3" },
-            "max-seconds": { type: "string", default: "90" },
-            "max-steps": { type: "string", default: "3" },
-            "max-trials": { type: "string", default: "12" },
-            "min-rate": { type: "string", default: "0.7" },
-            html: { type: "string", default: "flakelab.report.html" },
-            good: { type: "string", default: "" },
-            help: { type: "boolean", short: "h", default: false },
-            model: { type: "string", default: "qwen/qwen3.8-27b" },
-            open: { type: "boolean", default: false },
-            output: { type: "string", default: "flakelab.repro.yaml" },
-            patch: { type: "string", default: "candidate.diff" },
-            pattern: { type: "string", default: "**/api/checkout" },
-            publish: { type: "boolean", default: false },
-            proof: { type: "string", default: "flakelab.proof.json" },
-            "prompt-credentials": { type: "boolean", default: false },
-            prove: { type: "boolean", default: false },
-            report: { type: "string", default: "flakelab.investigation.json" },
-            reproducer: { type: "string", default: "flakelab.repro.yaml" },
-            runs: { type: "string", default: "4" },
-            seed: { type: "string", default: "1" },
-            trials: { type: "string", default: "4" },
-            verbose: { type: "boolean", default: false },
-            version: { type: "boolean", short: "v", default: false },
-        },
-    });
-    if (values.version) {
-        process.stdout.write(`${VERSION}\n`);
+async function runCommand(invocation) {
+    if (invocation.command === "analyze") {
+        const { analyze } = await import("./commands/analyze.js");
+        await analyze(invocation.target, invocation.options);
         return;
     }
-    if (values.help || positionals.length === 0) {
-        process.stdout.write(helpText());
+    if (invocation.command === "scan") {
+        const { scan } = await import("./commands/scan.js");
+        await scan(invocation.target, invocation.options);
         return;
     }
-    const [first, second] = positionals;
-    if (ADVANCED_COMMANDS.has(first)) {
-        await runAdvanced(first, second, values);
+    if (invocation.command === "resume") {
+        const { resumeDiagnosis } = await import("./commands/diagnose.js");
+        await resumeDiagnosis(invocation.target);
         return;
     }
-    if (second) {
-        throw new Error("Default scan accepts one path. Run flakelab --help for command usage.");
+    await runNonScanCommand(invocation);
+}
+async function providerErrorMessage(error) {
+    try {
+        const { cliErrorMessage } = await import("./providers/errors.js");
+        return cliErrorMessage(error);
     }
-    if (values.prove) {
-        await prove(first, values);
-        return;
+    catch {
+        return error.message;
     }
-    await scan(first, values);
 }
-try {
-    await main();
+/**
+ * Command failures use the same status vocabulary as successful output, on
+ * stderr, so a machine-readable stdout stream stays clean.
+ */
+function failureText(message) {
+    return new TerminalDocument(stderrTheme()).entry("failure", message).render();
 }
-catch (error) {
-    console.error(error instanceof Error ? cliErrorMessage(error) : "FlakeLab failed");
-    process.exitCode = 1;
+async function main() {
+    let providerCommand = false;
+    try {
+        const invocation = parseCliArguments(process.argv.slice(2));
+        if (invocation.command === "help") {
+            process.stdout.write(helpText(invocation.topic, stdoutTheme()));
+            return;
+        }
+        if (invocation.command === "version") {
+            writeStdout(VERSION);
+            return;
+        }
+        providerCommand = PROVIDER_COMMANDS.has(invocation.command);
+        await runCommand(invocation);
+    }
+    catch (error) {
+        let message = "FlakeLab failed";
+        if (error instanceof Error) {
+            message = providerCommand ? await providerErrorMessage(error) : error.message;
+        }
+        writeStderr(failureText(message));
+        process.exitCode = 1;
+    }
 }
+await main();
 //# sourceMappingURL=cli.js.map