prose-qa 0.1.0

package/dist/cache/hash.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.test.js","sourceRoot":"","sources":["../../src/cache/hash.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,SAAS,YAAY,CAAC,YAA+B,EAAE;IACrD,OAAO;QACL,QAAQ,EAAE,iBAAiB;QAC3B,WAAW,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;QACtC,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,6BAA6B;QACnC,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,CAAC,2BAA2B,CAAC;QACnC,cAAc,EAAE,CAAC,2BAA2B,CAAC;QAC7C,WAAW,EAAE;YACX,EAAE,GAAG,EAAE,2BAA2B,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE;SAChF;QACD,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,GAAG,YAAY,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,YAAY,CAAC;YACzB,IAAI,EAAE,CAAC,mBAAmB,CAAC;YAC3B,cAAc,EAAE,CAAC,mBAAmB,CAAC;YACrC,WAAW,EAAE;gBACX,EAAE,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE;aAChE;SACF,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cache/resolve.d.ts

@@ -0,0 +1,5 @@
+import type { PqaConfig } from "../types/config.js";
+import { resolveCacheConfig } from "../config/load.js";
+export { resolveCacheConfig };
+export declare function isCacheEnabled(config: PqaConfig, noCache?: boolean): boolean;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/cache/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/cache/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAGT"}

package/dist/cache/resolve.js

@@ -0,0 +1,8 @@
+import { resolveCacheConfig } from "../config/load.js";
+export { resolveCacheConfig };
+export function isCacheEnabled(config, noCache) {
+    if (noCache)
+        return false;
+    return resolveCacheConfig(config).enabled;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/cache/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/cache/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,MAAM,UAAU,cAAc,CAC5B,MAAiB,EACjB,OAAiB;IAEjB,IAAI,OAAO;QAAE,OAAO,KAAK,CAAC;IAC1B,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;AAC5C,CAAC"}

package/dist/cache/store.d.ts

@@ -0,0 +1,20 @@
+import type { PqaConfig } from "../types/config.js";
+import type { Scenario } from "../types/scenario.js";
+export interface ScenarioCacheMeta {
+    scenarioName: string;
+    contentHash: string;
+    updatedAt: string;
+    version: number;
+    passCount: number;
+}
+export declare function safeScenarioDirName(name: string): string;
+export declare function resolveCacheRoot(cwd: string, config: PqaConfig): string;
+export declare function scenarioCacheDir(cwd: string, config: PqaConfig, scenarioName: string): string;
+export declare function invalidateScenarioCache(cwd: string, config: PqaConfig, scenarioName: string): void;
+/** Load hints when content hash matches; otherwise invalidate and return undefined. */
+export declare function loadScenarioCache(cwd: string, config: PqaConfig, scenario: Scenario): string | undefined;
+export declare function writeScenarioCache(cwd: string, config: PqaConfig, scenario: Scenario, hints: string, existingMeta?: ScenarioCacheMeta): void;
+export declare function readScenarioCacheMeta(cwd: string, config: PqaConfig, scenarioName: string): ScenarioCacheMeta | undefined;
+export declare function listCachedScenarios(cwd: string, config: PqaConfig): string[];
+export declare function clearCache(cwd: string, config: PqaConfig, scenarioName?: string): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/cache/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/cache/store.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIrD,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAGvE;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR;AAoBD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,GACnB,IAAI,CAKN;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,QAAQ,GACjB,MAAM,GAAG,SAAS,CAgBpB;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,iBAAiB,GAC/B,IAAI,CAeN;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,GACnB,iBAAiB,GAAG,SAAS,CAG/B;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,GAChB,MAAM,EAAE,CAOV;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAUN"}

package/dist/cache/store.js

@@ -0,0 +1,90 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import path from "node:path";
+import { hashScenarioContent } from "./hash.js";
+import { resolveCacheConfig } from "./resolve.js";
+export function safeScenarioDirName(name) {
+    return name.replace(/[^a-z0-9-]/gi, "-").toLowerCase();
+}
+export function resolveCacheRoot(cwd, config) {
+    const { dir } = resolveCacheConfig(config);
+    return path.isAbsolute(dir) ? dir : path.resolve(cwd, dir);
+}
+export function scenarioCacheDir(cwd, config, scenarioName) {
+    return path.join(resolveCacheRoot(cwd, config), safeScenarioDirName(scenarioName));
+}
+function metaPath(cacheDir) {
+    return path.join(cacheDir, "meta.json");
+}
+function hintsPath(cacheDir) {
+    return path.join(cacheDir, "hints.md");
+}
+function readMeta(cacheDir) {
+    const file = metaPath(cacheDir);
+    if (!existsSync(file))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(file, "utf-8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function invalidateScenarioCache(cwd, config, scenarioName) {
+    const dir = scenarioCacheDir(cwd, config, scenarioName);
+    if (existsSync(dir)) {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+/** Load hints when content hash matches; otherwise invalidate and return undefined. */
+export function loadScenarioCache(cwd, config, scenario) {
+    const name = scenario.frontmatter.name;
+    const dir = scenarioCacheDir(cwd, config, name);
+    const expectedHash = hashScenarioContent(scenario);
+    const meta = readMeta(dir);
+    if (!meta || !existsSync(hintsPath(dir))) {
+        return undefined;
+    }
+    if (meta.contentHash !== expectedHash) {
+        invalidateScenarioCache(cwd, config, name);
+        return undefined;
+    }
+    return readFileSync(hintsPath(dir), "utf-8").trim() || undefined;
+}
+export function writeScenarioCache(cwd, config, scenario, hints, existingMeta) {
+    const name = scenario.frontmatter.name;
+    const dir = scenarioCacheDir(cwd, config, name);
+    mkdirSync(dir, { recursive: true });
+    const meta = {
+        scenarioName: name,
+        contentHash: hashScenarioContent(scenario),
+        updatedAt: new Date().toISOString(),
+        version: 1,
+        passCount: (existingMeta?.passCount ?? 0) + 1,
+    };
+    writeFileSync(hintsPath(dir), `${hints.trim()}\n`, "utf-8");
+    writeFileSync(metaPath(dir), `${JSON.stringify(meta, null, 2)}\n`, "utf-8");
+}
+export function readScenarioCacheMeta(cwd, config, scenarioName) {
+    const dir = scenarioCacheDir(cwd, config, scenarioName);
+    return readMeta(dir);
+}
+export function listCachedScenarios(cwd, config) {
+    const root = resolveCacheRoot(cwd, config);
+    if (!existsSync(root))
+        return [];
+    return readdirSync(root, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name)
+        .sort();
+}
+export function clearCache(cwd, config, scenarioName) {
+    if (scenarioName) {
+        invalidateScenarioCache(cwd, config, scenarioName);
+        return;
+    }
+    const root = resolveCacheRoot(cwd, config);
+    if (existsSync(root)) {
+        rmSync(root, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/cache/store.js.map

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

package/dist/cache/store.test.d.ts

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

package/dist/cache/store.test.d.ts.map

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

package/dist/cache/store.test.js

@@ -0,0 +1,101 @@
+import assert from "node:assert/strict";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { describe, it } from "node:test";
+import { hashScenarioContent } from "./hash.js";
+import { isCacheEnabled } from "./resolve.js";
+import { clearCache, loadScenarioCache, safeScenarioDirName, writeScenarioCache, } from "./store.js";
+const baseConfig = {
+    llm: { provider: "anthropic", model: "claude-sonnet-4-20250514" },
+    browser: { headed: false, sessionName: "pqa", defaultTimeout: 25_000, engine: "chrome" },
+    skills: { dirs: [], preloads: [] },
+    agent: { maxTurns: 100, bashTimeoutMs: 120_000 },
+    auth: {},
+    cache: { dir: ".pqa/cache", enabled: true },
+};
+function makeScenario(overrides = {}) {
+    return {
+        filePath: "/tmp/example.md",
+        frontmatter: { name: "example-smoke" },
+        skills: [],
+        goal: "Goal",
+        steps: "Steps",
+        then: ["then one"],
+        rawCheckpoints: ["then one"],
+        checkpoints: [{ raw: "then one", kind: "unknown" }],
+        ...overrides,
+    };
+}
+describe("isCacheEnabled", () => {
+    it("returns false when noCache is set", () => {
+        assert.equal(isCacheEnabled(baseConfig, true), false);
+    });
+    it("returns false when cache.enabled is false", () => {
+        assert.equal(isCacheEnabled({ ...baseConfig, cache: { enabled: false } }), false);
+    });
+});
+describe("scenario cache store", () => {
+    it("writes and loads hints when hash matches", () => {
+        const cwd = mkdtempSync(path.join(tmpdir(), "pqa-cache-"));
+        const scenario = makeScenario();
+        writeScenarioCache(cwd, baseConfig, scenario, "## Effective actions\n- click @e1");
+        const loaded = loadScenarioCache(cwd, baseConfig, scenario);
+        assert.match(loaded ?? "", /Effective actions/);
+        rmSync(cwd, { recursive: true, force: true });
+    });
+    it("invalidates cache when expanded content changes", () => {
+        const cwd = mkdtempSync(path.join(tmpdir(), "pqa-cache-"));
+        const scenario = makeScenario();
+        writeScenarioCache(cwd, baseConfig, scenario, "old hints");
+        const dir = path.join(cwd, ".pqa", "cache", safeScenarioDirName("example-smoke"));
+        assert.ok(existsSync(dir));
+        const changed = makeScenario({ steps: "New steps" });
+        const loaded = loadScenarioCache(cwd, baseConfig, changed);
+        assert.equal(loaded, undefined);
+        assert.equal(existsSync(dir), false);
+        rmSync(cwd, { recursive: true, force: true });
+    });
+    it("clearCache removes one or all entries", () => {
+        const cwd = mkdtempSync(path.join(tmpdir(), "pqa-cache-"));
+        writeScenarioCache(cwd, baseConfig, makeScenario({ frontmatter: { name: "a" } }), "a");
+        writeScenarioCache(cwd, baseConfig, makeScenario({ frontmatter: { name: "b" } }), "b");
+        clearCache(cwd, baseConfig, "a");
+        assert.equal(loadScenarioCache(cwd, baseConfig, makeScenario({ frontmatter: { name: "a" } })), undefined);
+        assert.ok(loadScenarioCache(cwd, baseConfig, makeScenario({ frontmatter: { name: "b" } })));
+        clearCache(cwd, baseConfig);
+        assert.equal(existsSync(path.join(cwd, ".pqa", "cache")), false);
+        rmSync(cwd, { recursive: true, force: true });
+    });
+    it("ignores stale meta hash on disk without matching scenario", () => {
+        const cwd = mkdtempSync(path.join(tmpdir(), "pqa-cache-"));
+        const scenario = makeScenario();
+        const dir = path.join(cwd, ".pqa", "cache", safeScenarioDirName("example-smoke"));
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(path.join(dir, "hints.md"), "stale\n");
+        writeFileSync(path.join(dir, "meta.json"), `${JSON.stringify({
+            scenarioName: "example-smoke",
+            contentHash: "deadbeef",
+            updatedAt: new Date().toISOString(),
+            version: 1,
+            passCount: 1,
+        })}\n`);
+        assert.equal(loadScenarioCache(cwd, baseConfig, scenario), undefined);
+        assert.equal(existsSync(dir), false);
+        rmSync(cwd, { recursive: true, force: true });
+    });
+    it("increments passCount on write", () => {
+        const cwd = mkdtempSync(path.join(tmpdir(), "pqa-cache-"));
+        const scenario = makeScenario();
+        writeScenarioCache(cwd, baseConfig, scenario, "v1");
+        const dir = path.join(cwd, ".pqa", "cache", safeScenarioDirName("example-smoke"));
+        const meta1 = JSON.parse(readFileSync(path.join(dir, "meta.json"), "utf-8"));
+        assert.equal(meta1.passCount, 1);
+        assert.equal(meta1.contentHash, hashScenarioContent(scenario));
+        writeScenarioCache(cwd, baseConfig, scenario, "v2", meta1);
+        const meta2 = JSON.parse(readFileSync(path.join(dir, "meta.json"), "utf-8"));
+        assert.equal(meta2.passCount, 2);
+        rmSync(cwd, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=store.test.js.map

package/dist/cache/store.test.js.map

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

package/dist/cli/analyze.d.ts

@@ -0,0 +1,21 @@
+import { type AnalyzeReport } from "../analyze/index.js";
+import type { ScenarioFixProposal } from "../analyze/parse-proposal.js";
+export interface AnalyzeOptions {
+    configPath?: string;
+    last?: number;
+}
+export interface LlmAnalyzeEntry {
+    scenario: string;
+    filePath: string;
+    proposal: ScenarioFixProposal | null;
+    parseError?: string;
+    applied?: boolean;
+}
+export interface LlmAnalyzeReport {
+    runId: string;
+    analyzedAt: string;
+    entries: LlmAnalyzeEntry[];
+}
+export declare function executeAnalyze(runIds: string[], options: AnalyzeOptions): Promise<number>;
+export type { AnalyzeReport };
+//# sourceMappingURL=analyze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/cli/analyze.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAW7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAOxE,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAmMD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/cli/analyze.js

@@ -0,0 +1,148 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import ora from "ora";
+import { analyzeRun, loadRunReport, resolveRunDirs, } from "../analyze/index.js";
+import { buildFlakyAnalyzeContext, buildLlmAnalyzeContext, flakyFindingToAnalyzeFinding, } from "../analyze/build-context.js";
+import { compareRuns } from "../analyze/compare-runs.js";
+import { proposeFlakyScenarioFixWithLlm, proposeScenarioFixWithLlm, } from "../analyze/llm-fix.js";
+import { runAnalyzeRepl } from "../analyze/repl.js";
+import { loadConfig, missingLlmApiKey, } from "../config/load.js";
+function analyzeOutputDir(cwd) {
+    const ts = new Date().toISOString().replace(/[:.]/g, "-");
+    const dir = path.join(cwd, ".pqa", "analyze", ts);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+async function executeSingleRunAnalyze(runDir, cwd, configPath) {
+    const report = analyzeRun(runDir, cwd);
+    const runReport = loadRunReport(runDir);
+    writeFileSync(path.join(runDir, "analyze.json"), `${JSON.stringify(report, null, 2)}\n`);
+    const config = await loadConfig(configPath, cwd);
+    if (report.findings.length > 0) {
+        const missingKey = missingLlmApiKey(config);
+        if (missingKey) {
+            throw new Error(missingKey);
+        }
+    }
+    const llmReport = {
+        runId: report.runId,
+        analyzedAt: new Date().toISOString(),
+        entries: [],
+    };
+    const replEntries = [];
+    for (const finding of report.findings) {
+        const result = runReport.results.find((r) => r.scenario === finding.scenario);
+        if (!result)
+            continue;
+        const spinner = ora(`LLM analysis: ${finding.scenario}`).start();
+        const context = buildLlmAnalyzeContext(finding, result, cwd);
+        const llmResult = await proposeScenarioFixWithLlm(config, context, cwd);
+        spinner.stop();
+        const entry = {
+            scenario: finding.scenario,
+            filePath: finding.filePath,
+            proposal: llmResult.proposal,
+            parseError: llmResult.parseError,
+        };
+        replEntries.push({
+            finding,
+            proposal: llmResult.proposal,
+            parseError: llmResult.parseError,
+        });
+        llmReport.entries.push(entry);
+    }
+    writeFileSync(path.join(runDir, "analyze-llm.json"), `${JSON.stringify(llmReport, null, 2)}\n`);
+    const replResult = await runAnalyzeRepl({
+        heuristicReport: report,
+        llmEntries: replEntries,
+        cwd,
+    });
+    for (const entry of llmReport.entries) {
+        const target = path.resolve(cwd, entry.filePath);
+        entry.applied = replResult.appliedFiles.some((p) => path.resolve(p) === target);
+    }
+    writeFileSync(path.join(runDir, "analyze-llm.json"), `${JSON.stringify(llmReport, null, 2)}\n`);
+    console.log(chalk.dim(`\nReports: ${path.join(runDir, "analyze.json")}, ${path.join(runDir, "analyze-llm.json")}`));
+    return 0;
+}
+async function executeMultiRunAnalyze(runDirs, cwd, configPath) {
+    const flakyReport = compareRuns(runDirs, cwd);
+    const outDir = analyzeOutputDir(cwd);
+    writeFileSync(path.join(outDir, "analyze-flaky.json"), `${JSON.stringify(flakyReport, null, 2)}\n`);
+    if (flakyReport.findings.length === 0) {
+        console.log(chalk.green(`\nNo flaky scenarios across ${flakyReport.runIds.length} run(s).`));
+        console.log(chalk.dim(`Report: ${path.join(outDir, "analyze-flaky.json")}`));
+        return 0;
+    }
+    const config = await loadConfig(configPath, cwd);
+    const missingKey = missingLlmApiKey(config);
+    if (missingKey) {
+        throw new Error(missingKey);
+    }
+    const llmReport = {
+        runId: flakyReport.runIds.join(","),
+        analyzedAt: new Date().toISOString(),
+        entries: [],
+    };
+    const replEntries = [];
+    for (const finding of flakyReport.findings) {
+        const spinner = ora(`LLM flaky analysis: ${finding.scenario}`).start();
+        const context = buildFlakyAnalyzeContext(finding, runDirs, cwd);
+        const llmResult = await proposeFlakyScenarioFixWithLlm(config, context, cwd);
+        spinner.stop();
+        const analyzeFinding = flakyFindingToAnalyzeFinding(finding);
+        const entry = {
+            scenario: finding.scenario,
+            filePath: finding.filePath,
+            proposal: llmResult.proposal,
+            parseError: llmResult.parseError,
+        };
+        replEntries.push({
+            finding: analyzeFinding,
+            proposal: llmResult.proposal,
+            parseError: llmResult.parseError,
+        });
+        llmReport.entries.push(entry);
+    }
+    writeFileSync(path.join(outDir, "analyze-llm.json"), `${JSON.stringify(llmReport, null, 2)}\n`);
+    const placeholderReport = {
+        runId: flakyReport.runIds.join(","),
+        analyzedAt: flakyReport.analyzedAt,
+        findings: replEntries.map((e) => e.finding),
+    };
+    const replResult = await runAnalyzeRepl({
+        heuristicReport: placeholderReport,
+        flakyReport,
+        llmEntries: replEntries,
+        cwd,
+    });
+    for (const entry of llmReport.entries) {
+        const target = path.resolve(cwd, entry.filePath);
+        entry.applied = replResult.appliedFiles.some((p) => path.resolve(p) === target);
+    }
+    writeFileSync(path.join(outDir, "analyze-llm.json"), `${JSON.stringify(llmReport, null, 2)}\n`);
+    console.log(chalk.dim(`\nReports: ${path.join(outDir, "analyze-flaky.json")}, ${path.join(outDir, "analyze-llm.json")}`));
+    return 0;
+}
+export async function executeAnalyze(runIds, options) {
+    const cwd = process.cwd();
+    try {
+        if (!process.stdin.isTTY) {
+            throw new Error("pqa analyze requires an interactive terminal");
+        }
+        const runDirs = resolveRunDirs(cwd, runIds, options.last);
+        if (runDirs.length === 1) {
+            return await executeSingleRunAnalyze(runDirs[0], cwd, options.configPath);
+        }
+        if (runDirs.length < 2) {
+            throw new Error("Multi-run analysis requires at least 2 run sessions");
+        }
+        return await executeMultiRunAnalyze(runDirs, cwd, options.configPath);
+    }
+    catch (err) {
+        console.error(chalk.red(String(err)));
+        return 2;
+    }
+}
+//# sourceMappingURL=analyze.js.map

package/dist/cli/analyze.js.map

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

package/dist/cli/concurrency.d.ts

@@ -0,0 +1,17 @@
+import type { Scenario } from "../types/scenario.js";
+import type { ScenarioResult } from "../types/verdict.js";
+export declare const FAIL_FAST_SKIP_REASON = "Not run (--fail-fast stopped the run)";
+export declare function emptyTranscript(): ScenarioResult["transcript"];
+export declare function createSkippedScenarioResult(scenario: Scenario, reason?: string): ScenarioResult;
+/** Fill holes left when parallel fail-fast stops scheduling new work. */
+export declare function alignScenarioResults(scenarios: Scenario[], results: (ScenarioResult | undefined)[]): ScenarioResult[];
+/**
+ * Run `fn` over `items` with at most `limit` in-flight tasks at once.
+ * When a task finishes, the next item is started immediately on that slot
+ * (worker pool), not in fixed batches of `limit`.
+ */
+export declare function mapWithConcurrency<T, R>(items: T[], limit: number, fn: (item: T, index: number) => Promise<R>, options?: {
+    failFast?: boolean;
+    isFailure?: (result: R) => boolean;
+}): Promise<(R | undefined)[]>;
+//# sourceMappingURL=concurrency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/cli/concurrency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,eAAO,MAAM,qBAAqB,0CACO,CAAC;AAE1C,wBAAgB,eAAe,IAAI,cAAc,CAAC,YAAY,CAAC,CAE9D;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,EAClB,MAAM,GAAE,MAA8B,GACrC,cAAc,CAUhB;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,GACtC,cAAc,EAAE,CAQlB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;CACpC,GACA,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,CA0B5B"}

package/dist/cli/concurrency.js

@@ -0,0 +1,56 @@
+export const FAIL_FAST_SKIP_REASON = "Not run (--fail-fast stopped the run)";
+export function emptyTranscript() {
+    return { entries: [] };
+}
+export function createSkippedScenarioResult(scenario, reason = FAIL_FAST_SKIP_REASON) {
+    return {
+        scenario: scenario.frontmatter.name,
+        filePath: scenario.filePath,
+        status: "skipped",
+        durationMs: 0,
+        verdict: null,
+        transcript: emptyTranscript(),
+        error: reason,
+    };
+}
+/** Fill holes left when parallel fail-fast stops scheduling new work. */
+export function alignScenarioResults(scenarios, results) {
+    return scenarios.map((scenario, index) => {
+        const result = results[index];
+        if (result !== undefined) {
+            return result;
+        }
+        return createSkippedScenarioResult(scenario);
+    });
+}
+/**
+ * Run `fn` over `items` with at most `limit` in-flight tasks at once.
+ * When a task finishes, the next item is started immediately on that slot
+ * (worker pool), not in fixed batches of `limit`.
+ */
+export async function mapWithConcurrency(items, limit, fn, options) {
+    if (items.length === 0)
+        return [];
+    const concurrency = Number.isFinite(limit)
+        ? Math.min(limit, items.length)
+        : items.length;
+    const results = new Array(items.length);
+    const pendingIndices = Array.from({ length: items.length }, (_, i) => i);
+    let stopScheduling = false;
+    async function worker() {
+        while (true) {
+            if (options?.failFast && stopScheduling)
+                return;
+            const index = pendingIndices.shift();
+            if (index === undefined)
+                return;
+            results[index] = await fn(items[index], index);
+            if (options?.failFast && options.isFailure?.(results[index])) {
+                stopScheduling = true;
+            }
+        }
+    }
+    await Promise.all(Array.from({ length: concurrency }, () => worker()));
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/cli/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/cli/concurrency.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qBAAqB,GAChC,uCAAuC,CAAC;AAE1C,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,QAAkB,EAClB,SAAiB,qBAAqB;IAEtC,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI;QACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,eAAe,EAAE;QAC7B,KAAK,EAAE,MAAM;KACd,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAClC,SAAqB,EACrB,OAAuC;IAEvC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAU,EACV,KAAa,EACb,EAA0C,EAC1C,OAGC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;QAC/B,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IACjB,MAAM,OAAO,GAAsB,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,KAAK,UAAU,MAAM;QACnB,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,OAAO,EAAE,QAAQ,IAAI,cAAc;gBAAE,OAAO;YAChD,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO;YAChC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAE,EAAE,KAAK,CAAC,CAAC;YAChD,IAAI,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,KAAK,CAAE,CAAC,EAAE,CAAC;gBAC9D,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CACpD,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

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

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

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

package/dist/cli/concurrency.test.js

@@ -0,0 +1,74 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { FAIL_FAST_SKIP_REASON, alignScenarioResults, mapWithConcurrency, } from "./concurrency.js";
+function stubScenario(name) {
+    return {
+        filePath: `scenarios/${name}.md`,
+        frontmatter: { name, tags: [], url: "http://localhost" },
+        goal: "",
+        steps: "",
+        then: [],
+        rawCheckpoints: [],
+        checkpoints: [],
+        skills: [],
+    };
+}
+describe("mapWithConcurrency slot pool", () => {
+    it("starts the next item as soon as a worker slot frees", async () => {
+        const delays = [20, 80, 20];
+        const started = [];
+        await mapWithConcurrency([0, 1, 2], 2, async (item) => {
+            started.push(item);
+            await new Promise((r) => setTimeout(r, delays[item]));
+            return item;
+        });
+        assert.deepEqual(started.slice(0, 2).sort(), [0, 1]);
+        assert.equal(started[2], 2);
+        assert.ok(started.indexOf(2) < started.length);
+        assert.equal(started.length, 3);
+    });
+});
+describe("mapWithConcurrency fail-fast", () => {
+    it("leaves undefined slots for work never scheduled", async () => {
+        const results = await mapWithConcurrency([0, 1, 2, 3], 1, async (item) => {
+            if (item === 0)
+                return "fail";
+            return "pass";
+        }, {
+            failFast: true,
+            isFailure: (r) => r === "fail",
+        });
+        assert.equal(results[0], "fail");
+        assert.equal(results[1], undefined);
+        assert.equal(results[2], undefined);
+        assert.equal(results[3], undefined);
+    });
+});
+describe("alignScenarioResults", () => {
+    it("replaces undefined slots with skipped scenario results", () => {
+        const scenarios = [
+            stubScenario("alpha"),
+            stubScenario("beta"),
+            stubScenario("gamma"),
+        ];
+        const aligned = alignScenarioResults(scenarios, [
+            {
+                scenario: "alpha",
+                filePath: scenarios[0].filePath,
+                status: "fail",
+                durationMs: 1,
+                verdict: null,
+                transcript: { entries: [] },
+            },
+            undefined,
+            undefined,
+        ]);
+        assert.equal(aligned.length, 3);
+        assert.equal(aligned[0].status, "fail");
+        assert.equal(aligned[1].status, "skipped");
+        assert.equal(aligned[2].status, "skipped");
+        assert.equal(aligned[1].error, FAIL_FAST_SKIP_REASON);
+        assert.equal(aligned[1].scenario, "beta");
+    });
+});
+//# sourceMappingURL=concurrency.test.js.map