flakelab 0.1.0 → 0.1.2

package/dist/cli-arguments.js

@@ -0,0 +1,356 @@
+import { parseArgs } from "node:util";
+import { parseAnalyzeArguments } from "./analysis/cli.js";
+import { CLI_OPTION_DEFINITIONS as DEFINITIONS, requiredOption as required, } from "./cli-option-definitions.js";
+import { parseDiagnoseArguments } from "./diagnosis/cli.js";
+import { parseProveArguments } from "./proof/cli.js";
+const NAMED_COMMANDS = [
+    "analyze",
+    "bisect",
+    "diagnose",
+    "discover",
+    "doctor",
+    "investigate",
+    "prove",
+    "repair",
+    "replay",
+    "resume",
+    "report",
+    "scan",
+];
+function oneTarget(positionals, command) {
+    if (positionals.length !== 1) {
+        throw new Error(`${command} requires exactly one target. Run flakelab --help for usage.`);
+    }
+    return positionals[0];
+}
+function noTarget(positionals, command) {
+    if (positionals.length > 0) {
+        throw new Error(`${command} does not accept a target`);
+    }
+}
+function isNamedCommand(value) {
+    return value !== undefined && NAMED_COMMANDS.some((command) => command === value);
+}
+function parseScan(args) {
+    const parsed = parseArgs({
+        args,
+        allowPositionals: true,
+        strict: true,
+        options: {
+            artifacts: DEFINITIONS.artifacts,
+            concurrency: DEFINITIONS.concurrency,
+            json: DEFINITIONS.json,
+            runs: DEFINITIONS.runs,
+            verbose: DEFINITIONS.verbose,
+        },
+    });
+    return {
+        command: "scan",
+        target: oneTarget(parsed.positionals, "scan"),
+        options: {
+            artifacts: required(parsed.values.artifacts, "artifacts"),
+            concurrency: required(parsed.values.concurrency, "concurrency"),
+            json: required(parsed.values.json, "json"),
+            runs: required(parsed.values.runs, "runs"),
+            verbose: required(parsed.values.verbose, "verbose"),
+        },
+    };
+}
+function parseDiscover(args) {
+    const parsed = parseArgs({
+        args,
+        allowPositionals: true,
+        strict: true,
+        options: {
+            "animation-rate": DEFINITIONS.animationRate,
+            "clock-offset-ms": DEFINITIONS.clockOffsetMs,
+            concurrency: DEFINITIONS.concurrency,
+            "cookie-name": DEFINITIONS.cookieName,
+            fault: DEFINITIONS.fault,
+            "jump-after-ms": DEFINITIONS.jumpAfterMs,
+            locale: DEFINITIONS.locale,
+            "max-delay": DEFINITIONS.maxDelay,
+            "max-copies": DEFINITIONS.maxCopies,
+            "max-duplicate-bytes": DEFINITIONS.maxDuplicateBytes,
+            "max-hold-ms": DEFINITIONS.maxHoldMs,
+            "max-remove-bytes": DEFINITIONS.maxRemoveBytes,
+            "max-seconds": DEFINITIONS.discoveryMaxSeconds,
+            "max-stall-ms": DEFINITIONS.maxStallMs,
+            "max-workers": DEFINITIONS.maxWorkers,
+            "min-rate": DEFINITIONS.minRate,
+            output: DEFINITIONS.output,
+            pattern: DEFINITIONS.pattern,
+            "resource-type": DEFINITIONS.resourceType,
+            seed: DEFINITIONS.seed,
+            "startup-event": DEFINITIONS.startupEvent,
+            "stall-after-ms": DEFINITIONS.stallAfterMs,
+            storage: DEFINITIONS.storage,
+            "storage-key": DEFINITIONS.storageKey,
+            timezone: DEFINITIONS.timezone,
+            trials: DEFINITIONS.trials,
+            "viewport-height": DEFINITIONS.viewportHeight,
+            "viewport-width": DEFINITIONS.viewportWidth,
+        },
+    });
+    return {
+        command: "discover",
+        target: oneTarget(parsed.positionals, "discover"),
+        options: {
+            "animation-rate": required(parsed.values["animation-rate"], "animation-rate"),
+            "clock-offset-ms": required(parsed.values["clock-offset-ms"], "clock-offset-ms"),
+            concurrency: required(parsed.values.concurrency, "concurrency"),
+            ...(parsed.values["cookie-name"]
+                ? { "cookie-name": parsed.values["cookie-name"] }
+                : {}),
+            fault: required(parsed.values.fault, "fault"),
+            "jump-after-ms": required(parsed.values["jump-after-ms"], "jump-after-ms"),
+            locale: required(parsed.values.locale, "locale"),
+            "max-delay": required(parsed.values["max-delay"], "max-delay"),
+            "max-copies": required(parsed.values["max-copies"], "max-copies"),
+            "max-duplicate-bytes": required(parsed.values["max-duplicate-bytes"], "max-duplicate-bytes"),
+            "max-hold-ms": required(parsed.values["max-hold-ms"], "max-hold-ms"),
+            "max-remove-bytes": required(parsed.values["max-remove-bytes"], "max-remove-bytes"),
+            "max-seconds": required(parsed.values["max-seconds"], "max-seconds"),
+            "max-stall-ms": required(parsed.values["max-stall-ms"], "max-stall-ms"),
+            "max-workers": required(parsed.values["max-workers"], "max-workers"),
+            "min-rate": required(parsed.values["min-rate"], "min-rate"),
+            output: required(parsed.values.output, "output"),
+            pattern: required(parsed.values.pattern, "pattern"),
+            "resource-type": required(parsed.values["resource-type"], "resource-type"),
+            seed: required(parsed.values.seed, "seed"),
+            "startup-event": required(parsed.values["startup-event"], "startup-event"),
+            "stall-after-ms": required(parsed.values["stall-after-ms"], "stall-after-ms"),
+            storage: required(parsed.values.storage, "storage"),
+            ...(parsed.values["storage-key"]
+                ? { "storage-key": parsed.values["storage-key"] }
+                : {}),
+            timezone: required(parsed.values.timezone, "timezone"),
+            trials: required(parsed.values.trials, "trials"),
+            "viewport-height": required(parsed.values["viewport-height"], "viewport-height"),
+            "viewport-width": required(parsed.values["viewport-width"], "viewport-width"),
+        },
+    };
+}
+function parseReplay(args) {
+    const parsed = parseArgs({
+        args,
+        allowPositionals: true,
+        strict: true,
+        options: { concurrency: DEFINITIONS.concurrency },
+    });
+    return {
+        command: "replay",
+        target: oneTarget(parsed.positionals, "replay"),
+        options: { concurrency: required(parsed.values.concurrency, "concurrency") },
+    };
+}
+function parseInvestigate(args) {
+    const parsed = parseArgs({
+        args,
+        allowPositionals: true,
+        strict: true,
+        options: {
+            concurrency: DEFINITIONS.concurrency,
+            "max-cost": DEFINITIONS.maxCost,
+            "max-delay": DEFINITIONS.maxDelay,
+            "max-experiments": DEFINITIONS.maxExperiments,
+            "max-seconds": DEFINITIONS.maxSeconds,
+            "max-steps": DEFINITIONS.maxSteps,
+            "max-trials": DEFINITIONS.maxTrials,
+            "min-rate": DEFINITIONS.minRate,
+            model: DEFINITIONS.model,
+            pattern: DEFINITIONS.pattern,
+            "prompt-credentials": DEFINITIONS.promptCredentials,
+            report: DEFINITIONS.report,
+            seed: DEFINITIONS.seed,
+            trials: DEFINITIONS.trials,
+        },
+    });
+    return {
+        command: "investigate",
+        target: oneTarget(parsed.positionals, "investigate"),
+        options: {
+            concurrency: required(parsed.values.concurrency, "concurrency"),
+            "max-cost": required(parsed.values["max-cost"], "max-cost"),
+            "max-delay": required(parsed.values["max-delay"], "max-delay"),
+            "max-experiments": required(parsed.values["max-experiments"], "max-experiments"),
+            "max-seconds": required(parsed.values["max-seconds"], "max-seconds"),
+            "max-steps": required(parsed.values["max-steps"], "max-steps"),
+            "max-trials": required(parsed.values["max-trials"], "max-trials"),
+            "min-rate": required(parsed.values["min-rate"], "min-rate"),
+            model: required(parsed.values.model, "model"),
+            pattern: required(parsed.values.pattern, "pattern"),
+            "prompt-credentials": required(parsed.values["prompt-credentials"], "prompt-credentials"),
+            report: required(parsed.values.report, "report"),
+            seed: required(parsed.values.seed, "seed"),
+            trials: required(parsed.values.trials, "trials"),
+        },
+    };
+}
+function parseRepair(args) {
+    const parsed = parseArgs({
+        args,
+        allowPositionals: true,
+        strict: true,
+        options: {
+            concurrency: DEFINITIONS.concurrency,
+            "max-cost": DEFINITIONS.maxCost,
+            "max-seconds": DEFINITIONS.maxSeconds,
+            model: DEFINITIONS.model,
+            patch: DEFINITIONS.patch,
+            proof: DEFINITIONS.proof,
+            "prompt-credentials": DEFINITIONS.promptCredentials,
+            reproducer: DEFINITIONS.reproducer,
+            source: DEFINITIONS.source,
+        },
+    });
+    return {
+        command: "repair",
+        target: oneTarget(parsed.positionals, "repair"),
+        options: {
+            concurrency: required(parsed.values.concurrency, "concurrency"),
+            "max-cost": required(parsed.values["max-cost"], "max-cost"),
+            "max-seconds": required(parsed.values["max-seconds"], "max-seconds"),
+            model: required(parsed.values.model, "model"),
+            patch: required(parsed.values.patch, "patch"),
+            proof: required(parsed.values.proof, "proof"),
+            "prompt-credentials": required(parsed.values["prompt-credentials"], "prompt-credentials"),
+            reproducer: required(parsed.values.reproducer, "reproducer"),
+            source: parsed.values.source ?? [],
+        },
+    };
+}
+function parseReport(args) {
+    const parsed = parseArgs({
+        args,
+        allowPositionals: true,
+        strict: true,
+        options: {
+            html: DEFINITIONS.html,
+            open: DEFINITIONS.open,
+            patch: DEFINITIONS.patch,
+            proof: DEFINITIONS.proof,
+            "prompt-credentials": DEFINITIONS.promptCredentials,
+            publish: DEFINITIONS.publish,
+            reproducer: DEFINITIONS.reproducer,
+        },
+    });
+    return {
+        command: "report",
+        target: oneTarget(parsed.positionals, "report"),
+        options: {
+            html: required(parsed.values.html, "html"),
+            open: required(parsed.values.open, "open"),
+            patch: required(parsed.values.patch, "patch"),
+            proof: required(parsed.values.proof, "proof"),
+            "prompt-credentials": required(parsed.values["prompt-credentials"], "prompt-credentials"),
+            publish: required(parsed.values.publish, "publish"),
+            reproducer: required(parsed.values.reproducer, "reproducer"),
+        },
+    };
+}
+function parseBisect(args) {
+    const parsed = parseArgs({
+        args,
+        allowPositionals: true,
+        strict: true,
+        options: {
+            bad: DEFINITIONS.bad,
+            "bisect-parallelism": DEFINITIONS.bisectParallelism,
+            "bisect-report": DEFINITIONS.bisectReport,
+            concurrency: DEFINITIONS.concurrency,
+            good: { type: "string" },
+            "max-trials": DEFINITIONS.maxTrials,
+            "min-rate": DEFINITIONS.minRate,
+            "prompt-credentials": DEFINITIONS.promptCredentials,
+            reproducer: DEFINITIONS.reproducer,
+        },
+    });
+    noTarget(parsed.positionals, "bisect");
+    if (!parsed.values.good) {
+        throw new Error("bisect requires --good <revision>");
+    }
+    return {
+        command: "bisect",
+        options: {
+            bad: required(parsed.values.bad, "bad"),
+            "bisect-parallelism": required(parsed.values["bisect-parallelism"], "bisect-parallelism"),
+            "bisect-report": required(parsed.values["bisect-report"], "bisect-report"),
+            concurrency: required(parsed.values.concurrency, "concurrency"),
+            good: parsed.values.good,
+            "max-trials": required(parsed.values["max-trials"], "max-trials"),
+            "min-rate": required(parsed.values["min-rate"], "min-rate"),
+            "prompt-credentials": required(parsed.values["prompt-credentials"], "prompt-credentials"),
+            reproducer: required(parsed.values.reproducer, "reproducer"),
+        },
+    };
+}
+function parseDoctor(args) {
+    const parsed = parseArgs({ args, allowPositionals: true, strict: true, options: {} });
+    noTarget(parsed.positionals, "doctor");
+    return { command: "doctor" };
+}
+function parseResume(args) {
+    const parsed = parseArgs({ args, allowPositionals: true, strict: true, options: {} });
+    if (parsed.positionals.length !== 1) {
+        throw new Error("resume requires exactly one diagnosis checkpoint. Run flakelab --help for usage.");
+    }
+    return { command: "resume", target: parsed.positionals[0] };
+}
+function explicitCommand(command, args) {
+    const parsers = {
+        analyze: parseAnalyzeArguments,
+        bisect: parseBisect,
+        diagnose: parseDiagnoseArguments,
+        discover: parseDiscover,
+        doctor: parseDoctor,
+        investigate: parseInvestigate,
+        prove: parseProveArguments,
+        repair: parseRepair,
+        replay: parseReplay,
+        resume: parseResume,
+        report: parseReport,
+        scan: parseScan,
+    };
+    return parsers[command](args);
+}
+function removeProveShortcut(args) {
+    const matches = args.filter((argument) => argument === "--prove").length;
+    if (matches === 0) {
+        return undefined;
+    }
+    if (matches > 1) {
+        throw new Error("--prove may be specified only once");
+    }
+    return args.filter((argument) => argument !== "--prove");
+}
+/**
+ * Help is resolved before any command parser runs, so `flakelab discover --help`
+ * never has to satisfy that command's required arguments.
+ */
+function helpInvocation(args) {
+    if (args.length === 0) {
+        return { command: "help" };
+    }
+    if (!args.includes("--help") && !args.includes("-h")) {
+        return undefined;
+    }
+    const first = args[0];
+    return isNamedCommand(first) ? { command: "help", topic: first } : { command: "help" };
+}
+export function parseCliArguments(args) {
+    const help = helpInvocation(args);
+    if (help) {
+        return help;
+    }
+    if (args.includes("--version") || args.includes("-v")) {
+        return { command: "version" };
+    }
+    const first = args[0];
+    if (isNamedCommand(first)) {
+        return explicitCommand(first, args.slice(1));
+    }
+    const proofArgs = removeProveShortcut(args);
+    return proofArgs ? parseProveArguments(proofArgs) : parseScan(args);
+}
+//# sourceMappingURL=cli-arguments.js.map

package/dist/cli-arguments.js.map

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

package/dist/cli-command-help.d.ts

@@ -0,0 +1,11 @@
+import type { DocumentRow } from "./ui/document.js";
+import type { TerminalTheme } from "./ui/theme.js";
+export type HelpTopic = "analyze" | "bisect" | "diagnose" | "discover" | "doctor" | "investigate" | "prove" | "repair" | "replay" | "report" | "resume" | "scan";
+export interface CommandHelp {
+    examples: string[];
+    options: DocumentRow[];
+    summary: string;
+    usage: string;
+}
+export declare const COMMAND_HELP: Record<HelpTopic, CommandHelp>;
+export declare function commandHelpText(topic: HelpTopic, theme?: TerminalTheme): string;

package/dist/cli-command-help.js

@@ -0,0 +1,211 @@
+import { TerminalDocument } from "./ui/document.js";
+import { PLAIN_THEME } from "./ui/theme.js";
+const FAULTS = "animation-speed, auth-cookie-expiry, clock-jump, event-loop-stall, locale,"
+    + " network-delay, reduced-motion, resource-loading-delay, response-duplication,"
+    + " response-reordering, response-truncation, shared-state-interference,"
+    + " startup-event-delay, storage-state-delay, timezone, viewport, worker-pressure";
+const FAULT_BOUNDS = "--max-delay, --max-duplicate-bytes, --max-hold-ms, --max-remove-bytes,"
+    + " --max-stall-ms, --stall-after-ms, --max-workers, --max-copies, --resource-type,"
+    + " --startup-event, --cookie-name, --storage, --storage-key, --clock-offset-ms,"
+    + " --jump-after-ms, --locale, --timezone, --viewport-width, --viewport-height,"
+    + " --animation-rate";
+const EVIDENCE_OPTIONS = [
+    { label: "--reproducer <path>", value: "Minimized reproducer (default: flakelab.repro.yaml)" },
+    { label: "--patch <path>", value: "Candidate diff (default: candidate.diff)" },
+    { label: "--proof <path>", value: "Proof matrix (default: flakelab.proof.json)" },
+];
+const PROVIDER_OPTIONS = [
+    { label: "--model <name>", value: "Groq model identifier" },
+    { label: "--max-cost <usd>", value: "Model spend ceiling applied before work starts" },
+    { label: "--prompt-credentials", value: "Re-enter provider keys through a hidden prompt" },
+];
+const DISCOVERY_OPTIONS = [
+    { label: "--fault <family>", value: FAULTS },
+    { label: "--pattern <glob>", value: "Request pattern the network faults apply to" },
+    { label: "--trials <number>", value: "Trials per candidate batch" },
+    { label: "--concurrency <n>", value: "Playwright workers per trial batch" },
+    { label: "--min-rate <rate>", value: "Failure rate a trigger must reach to be confirmed" },
+    { label: "--seed <number>", value: "Deterministic seed for every trial" },
+    { label: "--max-seconds <n>", value: "Elapsed-time ceiling for the search (default: 300)" },
+    { label: "Fault bounds", value: FAULT_BOUNDS },
+];
+export const COMMAND_HELP = {
+    analyze: {
+        examples: [
+            "flakelab analyze ./blob-report",
+            "flakelab analyze ./playwright-report.zip --baseline previous.json --json",
+        ],
+        options: [
+            { label: "--artifacts <dir>", value: "Evidence directory (default: .flakelab/runs)" },
+            { label: "--baseline <artifact>", value: "Rank signatures absent from an earlier artifact" },
+            { label: "--json", value: "Write only the analysis artifact JSON to stdout" },
+            { label: "--verbose", value: "Append the artifact JSON to the human summary" },
+        ],
+        summary: "Triage an existing Playwright blob report without rerunning any test.",
+        usage: "flakelab analyze <blob-report> [options]",
+    },
+    bisect: {
+        examples: ["flakelab bisect --good v1.4.0 --bad HEAD"],
+        options: [
+            { label: "--good <revision>", value: "Last revision believed to be healthy (required)" },
+            { label: "--bad <revision>", value: "Revision that shows the failure" },
+            { label: "--bisect-parallelism <n>", value: "Concurrent Solari sandboxes" },
+            { label: "--bisect-report <path>", value: "Where to write the bisect evidence" },
+            { label: "--max-trials <number>", value: "Trial ceiling per evaluated revision" },
+            { label: "--min-rate <rate>", value: "Failure rate that marks a revision bad" },
+            { label: "--reproducer <path>", value: "Reproducer that defines the failure" },
+            { label: "--prompt-credentials", value: "Re-enter provider keys through a hidden prompt" },
+        ],
+        summary: "Locate the commit that introduced a reproducer, in disposable Solari sandboxes.",
+        usage: "flakelab bisect --good <revision> [options]",
+    },
+    diagnose: {
+        examples: [
+            "flakelab diagnose tests/checkout.spec.ts",
+            "flakelab diagnose --report ./blob-report --baseline previous.json",
+            "flakelab diagnose tests/checkout.spec.ts --discover",
+        ],
+        options: [
+            { label: "--report <blob-report>", value: "Start from existing evidence instead of a scan" },
+            { label: "--runs <number>", value: "Repetitions in the bounded control scan" },
+            { label: "--discover", value: "Compare paired controls, then minimize a trigger" },
+            { label: "--investigate", value: "Explicitly enable bounded Groq investigation" },
+            { label: "--repair", value: "Explicitly enable Groq repair and isolated Solari proof" },
+            { label: "--source <file>", value: "Approve one application source file (max 7)" },
+            { label: "--evidence <path>", value: "Investigation artifact path" },
+            { label: "--html <path>", value: "Portable evidence report path" },
+            { label: "--open", value: "Open the generated report without prompting" },
+            ...EVIDENCE_OPTIONS,
+            ...PROVIDER_OPTIONS,
+            {
+                label: "Bounds",
+                value: "--trials, --concurrency, --seed, --max-delay, --min-rate, --pattern,"
+                    + " --max-seconds, --max-steps, --max-experiments, --max-trials",
+            },
+        ],
+        summary: "The primary workflow: observe first, then run only the cheapest useful next step.",
+        usage: "flakelab diagnose [test] [options]",
+    },
+    discover: {
+        examples: [
+            "flakelab discover tests/checkout.spec.ts --fault network-delay --max-delay 250",
+            "flakelab discover tests/payload.spec.ts --fault response-truncation --max-remove-bytes 64",
+        ],
+        options: [
+            ...DISCOVERY_OPTIONS,
+            { label: "--output <path>", value: "Reproducer to write (default: flakelab.repro.yaml)" },
+        ],
+        summary: "Search one fault family for the smallest deterministic trigger, then confirm it.",
+        usage: "flakelab discover <test> [options]",
+    },
+    doctor: {
+        examples: ["flakelab doctor"],
+        options: [],
+        summary: "Check Node, Playwright, Chromium, evidence privacy, and credential safety.",
+        usage: "flakelab doctor",
+    },
+    investigate: {
+        examples: ["flakelab investigate tests/checkout.spec.ts --max-cost 0.10"],
+        options: [
+            { label: "--report <path>", value: "Investigation artifact path" },
+            { label: "--max-steps <number>", value: "Agent reasoning steps" },
+            { label: "--max-experiments <n>", value: "Experiments the agent may run" },
+            { label: "--max-trials <number>", value: "Trial ceiling across the investigation" },
+            { label: "--max-seconds <number>", value: "Elapsed-time ceiling" },
+            ...PROVIDER_OPTIONS,
+            {
+                label: "Bounds",
+                value: "--trials, --concurrency, --max-delay, --min-rate, --pattern, --seed",
+            },
+        ],
+        summary: "Run the bounded Groq investigator over compact, redacted experiment results.",
+        usage: "flakelab investigate <test> [options]",
+    },
+    prove: {
+        examples: [
+            "flakelab prove tests/checkout.spec.ts",
+            "flakelab tests/checkout.spec.ts --prove --fault viewport --viewport-width 390",
+        ],
+        options: [
+            ...DISCOVERY_OPTIONS,
+            { label: "--source <file>", value: "Approve one application source file (max 7)" },
+            { label: "--html <path>", value: "Portable evidence report path" },
+            { label: "--open", value: "Open the generated report without prompting" },
+            { label: "--publish", value: "Publish the redacted report after confirmation" },
+            ...EVIDENCE_OPTIONS,
+            ...PROVIDER_OPTIONS,
+        ],
+        summary: "Run discover, replay, investigate, repair, and report as one proof pipeline.",
+        usage: "flakelab prove <test> [options]",
+    },
+    repair: {
+        examples: ["flakelab repair flakelab.investigation.json --source src/checkout.ts"],
+        options: [
+            { label: "--source <file>", value: "Approve one application source file (repeatable)" },
+            { label: "--concurrency <n>", value: "Playwright workers inside the Solari proof" },
+            { label: "--max-seconds <number>", value: "Elapsed-time ceiling for candidate generation" },
+            ...EVIDENCE_OPTIONS,
+            ...PROVIDER_OPTIONS,
+        ],
+        summary: "Generate one policy-bounded candidate and prove it in a disposable Solari microVM.",
+        usage: "flakelab repair <investigation> [options]",
+    },
+    replay: {
+        examples: ["flakelab replay flakelab.repro.yaml --concurrency 4"],
+        options: [
+            { label: "--concurrency <n>", value: "Playwright workers used for the replay trials" },
+        ],
+        summary: "Re-run a saved reproducer and check that the recorded signature still appears.",
+        usage: "flakelab replay <reproducer> [options]",
+    },
+    report: {
+        examples: ["flakelab report flakelab.investigation.json --open"],
+        options: [
+            { label: "--html <path>", value: "Output file (default: flakelab.report.html)" },
+            { label: "--open", value: "Open the generated report without prompting" },
+            { label: "--publish", value: "Publish the redacted report after confirmation" },
+            ...EVIDENCE_OPTIONS,
+            { label: "--prompt-credentials", value: "Re-enter provider keys through a hidden prompt" },
+        ],
+        summary: "Bundle validated evidence into one portable, offline HTML report.",
+        usage: "flakelab report <investigation> [options]",
+    },
+    resume: {
+        examples: ["flakelab resume .flakelab/runs/diagnose.json"],
+        options: [],
+        summary: "Continue a checkpointed diagnosis at the next safe phase, without repeating work.",
+        usage: "flakelab resume <diagnose.json>",
+    },
+    scan: {
+        examples: [
+            "flakelab tests/checkout.spec.ts --runs 20",
+            "flakelab scan tests/checkout.spec.ts --json",
+        ],
+        options: [
+            { label: "--runs <number>", value: "Repetitions to run (default: 4)" },
+            { label: "--concurrency <n>", value: "Playwright workers (default: 1)" },
+            { label: "--artifacts <dir>", value: "Evidence directory (default: .flakelab/runs)" },
+            { label: "--json", value: "Write only the scan artifact JSON to stdout" },
+            { label: "--verbose", value: "Append the artifact JSON to the human summary" },
+        ],
+        summary: "Repeat a Playwright target under normal conditions and classify what happens.",
+        usage: "flakelab scan <target> [options]",
+    },
+};
+export function commandHelpText(topic, theme = PLAIN_THEME) {
+    const help = COMMAND_HELP[topic];
+    const document = new TerminalDocument(theme);
+    document.heading(topic);
+    document.blank().text(help.summary);
+    document.section("Usage").command(help.usage);
+    if (help.options.length > 0) {
+        document.section("Options").rows(help.options);
+    }
+    document.section("Examples");
+    for (const example of help.examples) {
+        document.command(example);
+    }
+    document.section("More").command("flakelab --help");
+    return `${document.render()}\n`;
+}
+//# sourceMappingURL=cli-command-help.js.map

package/dist/cli-command-help.js.map

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

package/dist/cli-help.d.ts

@@ -1,2 +1,5 @@
-export declare const VERSION = "0.1.0";
-export declare function helpText(): string;
+import type { HelpTopic } from "./cli-command-help.js";
+import type { TerminalTheme } from "./ui/theme.js";
+export declare const VERSION: string;
+export declare function mainHelpText(theme?: TerminalTheme): string;
+export declare function helpText(topic?: HelpTopic, theme?: TerminalTheme): string;