prose-qa 0.2.0 → 0.2.2

package/dist/skills/on-demand.js

@@ -0,0 +1,225 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { resolveBundledPath } from "../paths.js";
+import { discoverSkills, getSkill } from "./loader.js";
+const DEFAULT_MAX_CHARS = 50_000;
+export function resolveAgentBrowserSkillRoot(cwd) {
+    return resolveBundledPath(cwd, path.join("skills", "agent-browser"));
+}
+export function readSkillManifest(cwd) {
+    const manifestPath = path.join(resolveAgentBrowserSkillRoot(cwd), "manifest.json");
+    if (!existsSync(manifestPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(manifestPath, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function truncate(content, maxChars) {
+    if (content.length <= maxChars) {
+        return { content, truncated: false };
+    }
+    return {
+        content: `${content.slice(0, maxChars)}\n\n[… truncated at ${maxChars} characters — use a narrower reference]`,
+        truncated: true,
+    };
+}
+function readReference(root, name) {
+    const filePath = path.join(root, "references", `${name}.md`);
+    if (!existsSync(filePath)) {
+        throw new Error(`Reference not found: ${name}`);
+    }
+    return readFileSync(filePath, "utf8").trim();
+}
+function readTemplate(root, name) {
+    const filePath = path.join(root, "templates", `${name}.sh`);
+    if (!existsSync(filePath)) {
+        throw new Error(`Template not found: ${name}`);
+    }
+    return readFileSync(filePath, "utf8").trim();
+}
+function readBundledSkill(root, name) {
+    const filePath = path.join(root, "bundled", name, "SKILL.md");
+    if (!existsSync(filePath))
+        return null;
+    const raw = readFileSync(filePath, "utf8");
+    return raw.replace(/^---[\s\S]*?---\r?\n?/, "").trim();
+}
+function readCustomSkill(cwd, skillDirs, name) {
+    const skills = discoverSkills(skillDirs, cwd);
+    const skill = getSkill(skills, name);
+    if (!skill) {
+        throw new Error(`Custom skill not found: ${name}. Add a SKILL.md under skills.dirs (configured in pqa.config) with matching frontmatter name.`);
+    }
+    return skill.body;
+}
+export function listLoadableCustomSkills(cwd, skillDirs, preloadedNames) {
+    return discoverSkills(skillDirs, cwd).filter((s) => !preloadedNames.has(s.name));
+}
+export class SkillLoadRegistry {
+    loaded = new Set();
+    maxChars;
+    skillDirs;
+    preloadedNames;
+    constructor(options = {}) {
+        const resolved = typeof options === "number" ? { maxChars: options } : options;
+        this.maxChars = resolved.maxChars ?? DEFAULT_MAX_CHARS;
+        this.skillDirs = resolved.skillDirs ?? [];
+        this.preloadedNames = new Set(resolved.preloadedNames ?? []);
+    }
+    key(kind, name) {
+        return `${kind}:${name}`;
+    }
+    has(kind, name) {
+        return this.loaded.has(this.key(kind, name));
+    }
+    mark(kind, name) {
+        this.loaded.add(this.key(kind, name));
+    }
+    alreadyPreloaded(kind, name) {
+        if (kind !== "skill" && kind !== "custom")
+            return false;
+        return this.preloadedNames.has(name);
+    }
+    load(cwd, kind, name) {
+        const normalized = name.trim();
+        const key = this.key(kind, normalized);
+        if (this.loaded.has(key)) {
+            return {
+                kind,
+                name: normalized,
+                content: `Already loaded: ${kind} "${normalized}". Use the content from the earlier load_skill result.`,
+                truncated: false,
+                alreadyLoaded: true,
+            };
+        }
+        if (this.alreadyPreloaded(kind, normalized)) {
+            return {
+                kind,
+                name: normalized,
+                content: `Skill "${normalized}" is already preloaded in the system prompt.`,
+                truncated: false,
+                alreadyLoaded: true,
+            };
+        }
+        const root = resolveAgentBrowserSkillRoot(cwd);
+        let raw;
+        switch (kind) {
+            case "reference":
+                raw = readReference(root, normalized);
+                break;
+            case "template":
+                raw = readTemplate(root, normalized);
+                break;
+            case "custom":
+                raw = readCustomSkill(cwd, this.skillDirs, normalized);
+                break;
+            case "skill": {
+                const bundled = readBundledSkill(root, normalized);
+                if (bundled) {
+                    raw = bundled;
+                    break;
+                }
+                raw = readCustomSkill(cwd, this.skillDirs, normalized);
+                break;
+            }
+            default:
+                throw new Error(`Unknown skill load kind: ${kind}`);
+        }
+        const { content, truncated } = truncate(raw, this.maxChars);
+        this.loaded.add(key);
+        return {
+            kind,
+            name: normalized,
+            content,
+            truncated,
+            alreadyLoaded: false,
+        };
+    }
+}
+export function formatOnDemandCatalog(cwd, skills, options) {
+    const core = skills.find((s) => s.name === "core");
+    if (!core)
+        return "";
+    const skillDirs = options?.skillDirs ?? [];
+    const preloaded = new Set(skills.map((s) => s.name));
+    const customSkills = listLoadableCustomSkills(cwd, skillDirs, preloaded);
+    const manifest = readSkillManifest(cwd);
+    if (!manifest) {
+        const customLines = customSkills
+            .map((s) => `- custom \`${s.name}\` — ${s.description}`)
+            .join("\n");
+        return [
+            "## On-demand skill loading",
+            "",
+            "Use the `load_skill` tool when you need detailed agent-browser docs beyond this core summary.",
+            "Run `pqa skills sync` (or `npm install`) if references are missing.",
+            "",
+            "**Custom skills** (load_skill kind=custom or kind=skill):",
+            customLines || "- (none — add SKILL.md under skills.dirs)",
+        ].join("\n");
+    }
+    const refLines = manifest.core.references.map((r) => `- reference \`${r}\``).join("\n");
+    const tplLines = manifest.core.templates.map((t) => `- template \`${t}\``).join("\n");
+    const bundledLines = manifest.bundled
+        .map((b) => `- skill \`${b.name}\` — ${b.description || "bundled skill"}`)
+        .join("\n");
+    const customLines = customSkills
+        .map((s) => `- custom \`${s.name}\` — ${s.description}`)
+        .join("\n");
+    return [
+        "## On-demand skill loading",
+        "",
+        "Only preloaded skills appear in the system prompt above. Load everything else with `load_skill`",
+        "— do **not** run `agent-browser skills get` in bash (wastes turns).",
+        "",
+        "**Available references** (load_skill kind=reference):",
+        refLines || "- (none)",
+        "",
+        "**Available templates** (load_skill kind=template):",
+        tplLines || "- (none)",
+        "",
+        "**Bundled agent-browser skills** (load_skill kind=skill):",
+        bundledLines || "- (none)",
+        "",
+        "**Custom project skills** (load_skill kind=custom, or kind=skill as fallback):",
+        customLines || "- (none — add SKILL.md under skills.dirs in pqa.config)",
+        "",
+        "Load sparingly: one item at a time, only when the current step requires it.",
+    ].join("\n");
+}
+/** References the harness auto-injects before the agent runs (context-aware). */
+export function inferAutoSkillLoads(options) {
+    const loads = [];
+    // Consumer scenarios with auth: use preloaded state — no auth reference needed.
+    const needsAuth = Boolean(options.authProfile) ||
+        options.scenario.frontmatter.tags?.includes("auth") ||
+        options.scenario.frontmatter.name?.startsWith("login-");
+    if (needsAuth) {
+        loads.push({
+            kind: "reference",
+            name: "authentication",
+            reason: "scenario uses authentication",
+        });
+    }
+    return loads;
+}
+export function formatAutoLoadedMessage(loads) {
+    if (loads.length === 0)
+        return null;
+    const blocks = loads
+        .filter((l) => !l.alreadyLoaded)
+        .map((l) => `### Auto-loaded ${l.kind}: ${l.name}\n\n${l.content}`);
+    if (blocks.length === 0)
+        return null;
+    return [
+        "## Harness auto-loaded skill references",
+        "",
+        "The harness preloaded these references for this scenario. Do not reload them.",
+        "",
+        blocks.join("\n\n---\n\n"),
+    ].join("\n");
+}
+//# sourceMappingURL=on-demand.js.map

package/dist/skills/on-demand.js.map

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

package/dist/skills/on-demand.test.d.ts

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

package/dist/skills/on-demand.test.d.ts.map

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

package/dist/skills/on-demand.test.js

@@ -0,0 +1,111 @@
+import assert from "node:assert/strict";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, it } from "node:test";
+import { SkillLoadRegistry, formatOnDemandCatalog, inferAutoSkillLoads, readSkillManifest, } from "./on-demand.js";
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+function makeScenario(overrides = {}) {
+    return {
+        filePath: "/tmp/example.md",
+        frontmatter: { name: "example" },
+        skills: ["core"],
+        goal: "Goal",
+        steps: "1. Step",
+        then: ['page shows "ok"'],
+        rawCheckpoints: ['page shows "ok"'],
+        checkpoints: [{ raw: 'page shows "ok"', kind: "page_shows", value: "ok" }],
+        ...overrides,
+    };
+}
+describe("readSkillManifest", () => {
+    it("reads manifest after sync-skills", () => {
+        const manifest = readSkillManifest(repoRoot);
+        assert.ok(manifest);
+        assert.ok(manifest.core.references.includes("authentication"));
+        assert.ok(manifest.bundled.length > 0);
+    });
+});
+describe("SkillLoadRegistry", () => {
+    it("loads a reference and deduplicates subsequent loads", () => {
+        const registry = new SkillLoadRegistry();
+        const first = registry.load(repoRoot, "reference", "authentication");
+        assert.equal(first.alreadyLoaded, false);
+        assert.match(first.content, /auth/i);
+        const second = registry.load(repoRoot, "reference", "authentication");
+        assert.equal(second.alreadyLoaded, true);
+    });
+    it("throws for unknown reference via error message in load path", () => {
+        const registry = new SkillLoadRegistry();
+        assert.throws(() => registry.load(repoRoot, "reference", "does-not-exist-xyz"), /not found/i);
+    });
+    it("loads a custom skill from skills.dirs", () => {
+        const registry = new SkillLoadRegistry({
+            skillDirs: ["skills"],
+            preloadedNames: ["core"],
+        });
+        const result = registry.load(repoRoot, "custom", "prose-qa");
+        assert.equal(result.alreadyLoaded, false);
+        assert.match(result.content, /Prose-QA scenario authoring/i);
+    });
+    it("falls back to custom skill when bundled skill is missing", () => {
+        const registry = new SkillLoadRegistry({
+            skillDirs: ["skills"],
+            preloadedNames: ["core"],
+        });
+        const result = registry.load(repoRoot, "skill", "prose-qa");
+        assert.equal(result.alreadyLoaded, false);
+        assert.match(result.content, /scenario authoring/i);
+    });
+    it("returns alreadyLoaded for skills preloaded in the system prompt", () => {
+        const registry = new SkillLoadRegistry({
+            skillDirs: ["skills"],
+            preloadedNames: ["core", "prose-qa"],
+        });
+        const result = registry.load(repoRoot, "custom", "prose-qa");
+        assert.equal(result.alreadyLoaded, true);
+        assert.match(result.content, /already preloaded/i);
+    });
+});
+describe("inferAutoSkillLoads", () => {
+    it("auto-loads authentication for auth scenarios", () => {
+        const loads = inferAutoSkillLoads({
+            scenario: makeScenario({
+                frontmatter: { name: "login-admin", tags: ["auth"] },
+            }),
+            authProfile: "admin",
+        });
+        assert.deepEqual(loads, [
+            { kind: "reference", name: "authentication", reason: "scenario uses authentication" },
+        ]);
+    });
+    it("does not auto-load authentication for consumer scenarios with auth profile", () => {
+        const loads = inferAutoSkillLoads({
+            scenario: makeScenario({
+                frontmatter: { name: "checkout", auth: "admin" },
+            }),
+        });
+        assert.deepEqual(loads, []);
+    });
+});
+describe("formatOnDemandCatalog", () => {
+    it("lists references and bundled skills for core", () => {
+        const skills = [
+            {
+                name: "core",
+                description: "core skill",
+                dir: path.join(repoRoot, "skills/agent-browser"),
+                frontmatter: { name: "core", description: "core skill" },
+                body: "minimal core body",
+            },
+        ];
+        const catalog = formatOnDemandCatalog(repoRoot, skills, {
+            skillDirs: ["skills"],
+        });
+        assert.match(catalog, /load_skill/);
+        assert.match(catalog, /authentication/);
+        assert.match(catalog, /Custom project skills/);
+        assert.match(catalog, /prose-qa/);
+        assert.match(catalog, /do \*\*not\*\* run `agent-browser skills get`/);
+    });
+});
+//# sourceMappingURL=on-demand.test.js.map

package/dist/skills/on-demand.test.js.map

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

package/dist/types/config.d.ts

@@ -35,7 +35,7 @@ export type BrowserEngine = "chrome" | "lightpanda";
 /** Options when browser.engine is lightpanda (AGENT_BROWSER_EXECUTABLE_PATH, telemetry). */
 export interface LightpandaBrowserConfig {
     /**
-     * Path to the lightpanda binary, or a directory containing it (e.g. ".bin").
+     * Path to the lightpanda binary, or a directory containing it (e.g. "./.pqa/engine").
      * Relative paths resolve from the project cwd. Maps to AGENT_BROWSER_EXECUTABLE_PATH.
      */
     executablePath?: string;
@@ -75,8 +75,19 @@ export interface PqaConfig {
         lightpanda?: LightpandaBrowserConfig;
     };
     skills: {
-        dirs: string[];
-        preloads: string[];
+        /** Directories scanned for custom SKILL.md files. Default: [] */
+        dirs?: string[];
+        /** Extra skill names always appended to the system prompt (core is always loaded). Default: [] */
+        preloads?: string[];
+        /** On-demand loading of agent-browser references and bundled skills. */
+        onDemand?: {
+            /** Master switch for load_skill tool and auto-load. Default: true */
+            enabled?: boolean;
+            /** Max characters returned per load_skill call. Default: 50000 */
+            maxChars?: number;
+            /** Harness auto-injects context-aware references before the run. Default: true */
+            autoLoad?: boolean;
+        };
     };
     agent: {
         maxTurns: number;

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

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

package/dist/types/verdict.d.ts

@@ -18,8 +18,28 @@ export declare const VerdictSchema: z.ZodObject<{
     }, z.core.$strip>>;
     summary: z.ZodString;
 }, z.core.$strip>;
+export declare const VerdictStatsSchema: z.ZodObject<{
+    durationMs: z.ZodNumber;
+    llmTurns: z.ZodNumber;
+    userTurns: z.ZodNumber;
+    toolCalls: z.ZodNumber;
+    failedToolCalls: z.ZodNumber;
+    llmDurationMs: z.ZodNumber;
+    bashDurationMs: z.ZodNumber;
+    healing: z.ZodOptional<z.ZodObject<{
+        used: z.ZodBoolean;
+        recoveryTurns: z.ZodNumber;
+        scenarioRetries: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type CheckpointResult = z.infer<typeof CheckpointResultSchema>;
-export type Verdict = z.infer<typeof VerdictSchema>;
+/** Parsed agent verdict (LLM output). */
+export type ParsedVerdict = z.infer<typeof VerdictSchema>;
+export type VerdictStats = z.infer<typeof VerdictStatsSchema>;
+/** Harness-enriched verdict written to verdict.json and report.json. */
+export type Verdict = ParsedVerdict & {
+    stats?: VerdictStats;
+};
 export type FailureKind = "transient" | "scenario_issue" | "product" | "unknown";
 export interface HealingMeta {
     used: boolean;

package/dist/types/verdict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../src/types/verdict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;iBAIxB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}
+{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../src/types/verdict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;iBAIxB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;iBAe7B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,yCAAyC;AACzC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,wEAAwE;AACxE,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG;IAAE,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/types/verdict.js

@@ -10,4 +10,20 @@ export const VerdictSchema = z.object({
     checkpoints: z.array(CheckpointResultSchema),
     summary: z.string(),
 });
+export const VerdictStatsSchema = z.object({
+    durationMs: z.number(),
+    llmTurns: z.number(),
+    userTurns: z.number(),
+    toolCalls: z.number(),
+    failedToolCalls: z.number(),
+    llmDurationMs: z.number(),
+    bashDurationMs: z.number(),
+    healing: z
+        .object({
+        used: z.boolean(),
+        recoveryTurns: z.number(),
+        scenarioRetries: z.number(),
+    })
+        .optional(),
+});
 //# sourceMappingURL=verdict.js.map

package/dist/types/verdict.js.map

@@ -1 +1 @@
-{"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../src/types/verdict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC"}
+{"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../src/types/verdict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;QACjB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;KAC5B,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** Package version from package.json (resolved at runtime from package root). */
+export declare const PACKAGE_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAIA,iFAAiF;AACjF,eAAO,MAAM,eAAe,EAAE,MAEX,CAAC"}

package/dist/version.js

@@ -0,0 +1,6 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { getPackageRoot } from "./paths.js";
+/** Package version from package.json (resolved at runtime from package root). */
+export const PACKAGE_VERSION = JSON.parse(readFileSync(join(getPackageRoot(), "package.json"), "utf8")).version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAW,IAAI,CAAC,KAAK,CAC/C,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAC7D,CAAC,OAAiB,CAAC"}

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "prose-qa",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "ProseQA — agent harness for NL E2E regression testing via agent-browser",
   "type": "module",
   "bin": {
-    "pqa": "./dist/cli/index.js"
+    "pqa": "dist/cli/index.js"
   },
   "files": [
     "dist",
     "prompt",
     "skills",
+    "scripts/sync-skills.mjs",
+    "scripts/install-lightpanda.mjs",
     "pqa.config.ts"
   ],
   "scripts": {
@@ -17,7 +19,7 @@
     "test": "node --import tsx --test src/**/*.test.ts",
     "dev": "tsx src/cli/index.ts",
     "mcp": "tsx src/cli/index.ts mcp",
-    "postinstall": "mkdir -p ./skills/agent-browser && agent-browser skills get core --full > ./skills/agent-browser/SKILL.md",
+    "postinstall": "node scripts/sync-skills.mjs",
     "install-chrome": "agent-browser install --with-deps",
     "install-lightpanda": "node scripts/install-lightpanda.mjs",
     "demo:server": "node scripts/demo-server.mjs",
@@ -29,7 +31,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/FreakDev/Prose-QA.git"
+    "url": "git+https://github.com/FreakDev/Prose-QA.git"
   },
   "homepage": "https://github.com/FreakDev/Prose-QA#readme",
   "bugs": {

package/pqa.config.ts

@@ -17,15 +17,20 @@ const config = {
     defaultTimeout: 25_000,
     engine: "chrome",
     lightpanda: {
-      executablePath: "./bin",
+      executablePath: "./.pqa/engine",
       telemetry: false,
     },
   },
   envVars: [],
   sensitiveEnvVars: [],
   skills: {
-    dirs: ["skills"],
-    preloads: ["core"],
+    dirs: [".pqa/skills"],
+    preloads: [],
+    onDemand: {
+      enabled: true,
+      autoLoad: true,
+      maxChars: 50_000,
+    },
   },
   agent: {
     parallel: 0,

package/prompt/SYSTEM.md

@@ -5,7 +5,8 @@ You are ProseQA, an E2E regression testing agent. Execute scenarios using
 
 ## Rules
 
-- Use `agent-browser` CLI for all browser interactions (see the core skill below).
+- Use `agent-browser` CLI for all browser interactions (see the minimal core skill below).
+- Use the `load_skill` tool for detailed references and custom project skills — do **not** run `agent-browser skills get` in bash.
 - Do NOT use curl, wget, or other HTTP clients to test the web UI.
 - After completing Steps, verify every Then checkpoint using agent-browser CLI.
 - On failure, save screenshot and snapshot to `$PQA_ARTIFACT_DIR`.