@hasna/testers 0.0.2 → 0.0.3

package/dist/lib/ai-client.d.ts

@@ -18,6 +18,9 @@ interface ScreenshotResult {
     width: number;
     height: number;
     timestamp: string;
+    description: string | null;
+    pageUrl: string | null;
+    thumbnailPath: string | null;
 }
 interface ToolExecutionResult {
     result: string;
@@ -49,6 +52,9 @@ interface AgentLoopResult {
         timestamp: string;
         action: string;
         stepNumber: number;
+        description: string | null;
+        pageUrl: string | null;
+        thumbnailPath: string | null;
     }>;
 }
 /**

package/dist/lib/ai-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-client.d.ts","sourceRoot":"","sources":["../../src/lib/ai-client.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI/D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKzD;AAID,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,IAAI,EAyTzC,CAAC;AAIF,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,mBAAmB;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CA8P9B;AAID,UAAU,gBAAgB;IACxB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,eAAe;IACvB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,KAAK,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAyK1B;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAQvD"}
+{"version":3,"file":"ai-client.d.ts","sourceRoot":"","sources":["../../src/lib/ai-client.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI/D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKzD;AAID,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,IAAI,EAyTzC,CAAC;AAIF,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,UAAU,mBAAmB;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CA8P9B;AAID,UAAU,gBAAgB;IACxB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,eAAe;IACvB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,KAAK,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC,CAAC;CACJ;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAyK1B;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAQvD"}

package/dist/lib/costs.d.ts

@@ -0,0 +1,36 @@
+export interface CostSummary {
+    period: string;
+    totalCostCents: number;
+    totalTokens: number;
+    runCount: number;
+    byModel: Record<string, {
+        costCents: number;
+        tokens: number;
+        runs: number;
+    }>;
+    byScenario: Array<{
+        scenarioId: string;
+        name: string;
+        costCents: number;
+        tokens: number;
+        runs: number;
+    }>;
+    avgCostPerRun: number;
+    estimatedMonthlyCents: number;
+}
+export interface BudgetConfig {
+    maxPerRunCents: number;
+    maxPerDayCents: number;
+    warnAtPercent: number;
+}
+export declare function getCostSummary(options?: {
+    projectId?: string;
+    period?: "day" | "week" | "month" | "all";
+}): CostSummary;
+export declare function checkBudget(estimatedCostCents: number): {
+    allowed: boolean;
+    warning?: string;
+};
+export declare function formatCostsTerminal(summary: CostSummary): string;
+export declare function formatCostsJSON(summary: CostSummary): string;
+//# sourceMappingURL=costs.d.ts.map

package/dist/lib/costs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costs.d.ts","sourceRoot":"","sources":["../../src/lib/costs.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,UAAU,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzG,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AA0CD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;CAC3C,GAAG,WAAW,CAyFd;AAED,wBAAgB,WAAW,CAAC,kBAAkB,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CA+B9F;AAcD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAwChE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAE5D"}

package/dist/lib/diff.d.ts

@@ -0,0 +1,25 @@
+import type { Run } from "../types/index.js";
+export interface DiffResult {
+    run1: Run;
+    run2: Run;
+    regressions: ScenarioDiff[];
+    fixes: ScenarioDiff[];
+    unchanged: ScenarioDiff[];
+    newScenarios: ScenarioDiff[];
+    removedScenarios: ScenarioDiff[];
+}
+export interface ScenarioDiff {
+    scenarioId: string;
+    scenarioName: string | null;
+    scenarioShortId: string | null;
+    status1: string | null;
+    status2: string | null;
+    duration1: number | null;
+    duration2: number | null;
+    tokens1: number | null;
+    tokens2: number | null;
+}
+export declare function diffRuns(runId1: string, runId2: string): DiffResult;
+export declare function formatDiffTerminal(diff: DiffResult): string;
+export declare function formatDiffJSON(diff: DiffResult): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/lib/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/lib/diff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAU,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,GAAG,CAAC;IACV,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAuEnE;AA6BD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAiE3D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEvD"}

package/dist/lib/init.d.ts

@@ -0,0 +1,28 @@
+import { createScenario } from "../db/scenarios.js";
+import { ensureProject } from "../db/projects.js";
+import type { CreateScenarioInput } from "../types/index.js";
+interface FrameworkInfo {
+    name: string;
+    defaultUrl: string;
+    features: string[];
+}
+export declare function detectFramework(dir: string): FrameworkInfo | null;
+export declare function getStarterScenarios(framework: {
+    name: string;
+    features: string[];
+}, projectId: string): CreateScenarioInput[];
+export interface InitOptions {
+    name?: string;
+    url?: string;
+    path?: string;
+    dir?: string;
+}
+export interface InitResult {
+    project: ReturnType<typeof ensureProject>;
+    scenarios: ReturnType<typeof createScenario>[];
+    framework: FrameworkInfo | null;
+    url: string;
+}
+export declare function initProject(options: InitOptions): InitResult;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/lib/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/lib/init.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAI7D,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAmDjE;AAID,wBAAgB,mBAAmB,CACjC,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,EAC/C,SAAS,EAAE,MAAM,GAChB,mBAAmB,EAAE,CA6DvB;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IAC1C,SAAS,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,EAAE,CAAC;IAC/C,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAuC5D"}

package/dist/lib/report.d.ts

@@ -0,0 +1,4 @@
+export declare function imageToBase64(filePath: string): string;
+export declare function generateHtmlReport(runId: string): string;
+export declare function generateLatestReport(): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/lib/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/lib/report.ts"],"names":[],"mappings":"AAOA,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAStD;AA4ED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiIxD;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C"}

package/dist/lib/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/lib/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAW/D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,gBAAgB,GAAG,eAAe,GAAG,eAAe,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,cAAc,CAAC;IACvH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAIxD,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEzD;AAMD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAiFjB;AAED,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA4D1C;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,UAAU,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACnF,OAAO,CAAC;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuB1C"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/lib/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAW/D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,gBAAgB,GAAG,eAAe,GAAG,eAAe,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,cAAc,CAAC;IACvH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAIxD,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEzD;AAMD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAoFjB;AAED,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA4D1C;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,UAAU,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACnF,OAAO,CAAC;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuB1C"}

package/dist/lib/screenshotter.d.ts

@@ -1,59 +1,61 @@
 import type { Page } from "playwright";
-/**
- * Convert arbitrary text to a URL/filesystem-safe slug.
- * Lowercases, replaces non-alphanumeric runs with a single hyphen, trims
- * leading/trailing hyphens.
- */
 export declare function slugify(text: string): string;
-/**
- * Build a zero-padded screenshot filename.
- * Example: stepNumber=1, action="Navigate homepage" → "001-navigate-homepage.png"
- */
 export declare function generateFilename(stepNumber: number, action: string): string;
 /**
- * Derive the directory path for a specific scenario inside a run.
- * Layout: `<baseDir>/<runId>/<scenarioSlug>/`
- */
-export declare function getScreenshotDir(baseDir: string, runId: string, scenarioSlug: string): string;
-/**
- * Create `dirPath` (and any parents) if it does not already exist.
+ * Build the screenshot directory for a run:
+ * {baseDir}/{projectName}/{YYYY-MM-DD}/{HH-mm-ss}_{runId-8char}/{scenarioSlug}/
  */
+export declare function getScreenshotDir(baseDir: string, runId: string, scenarioSlug: string, projectName?: string, timestamp?: Date): string;
 export declare function ensureDir(dirPath: string): void;
 interface ScreenshotterOptions {
     baseDir?: string;
     format?: "png" | "jpeg";
     quality?: number;
     fullPage?: boolean;
+    projectName?: string;
 }
 interface CaptureOptions {
     runId: string;
     scenarioSlug: string;
     stepNumber: number;
     action: string;
+    description?: string;
 }
-interface CaptureResult {
+export interface CaptureResult {
     filePath: string;
     width: number;
     height: number;
     timestamp: string;
+    description: string | null;
+    pageUrl: string | null;
+    thumbnailPath: string | null;
 }
+export declare function writeRunMeta(dir: string, meta: {
+    runId: string;
+    url: string;
+    model: string;
+    status: string;
+    startedAt: string;
+    scenarioCount: number;
+}): void;
+export declare function writeScenarioMeta(dir: string, meta: {
+    scenarioId: string;
+    shortId: string;
+    name: string;
+    status: string;
+    reasoning: string | null;
+    durationMs: number;
+}): void;
 export declare class Screenshotter {
     private readonly baseDir;
     private readonly format;
     private readonly quality;
     private readonly fullPage;
+    private readonly projectName;
+    private runTimestamp;
     constructor(options?: ScreenshotterOptions);
-    /**
-     * Capture a screenshot of the current page state.
-     */
     capture(page: Page, options: CaptureOptions): Promise<CaptureResult>;
-    /**
-     * Capture a full-page screenshot regardless of the instance default.
-     */
     captureFullPage(page: Page, options: CaptureOptions): Promise<CaptureResult>;
-    /**
-     * Capture a screenshot of a specific element identified by `selector`.
-     */
     captureElement(page: Page, selector: string, options: CaptureOptions): Promise<CaptureResult>;
 }
 export {};

package/dist/lib/screenshotter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshotter.d.ts","sourceRoot":"","sources":["../../src/lib/screenshotter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOvC;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,GACnB,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAID,UAAU,oBAAoB;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAEvB,OAAO,GAAE,oBAAyB;IAO9C;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IA4BzB;;OAEG;IACG,eAAe,CACnB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IA4BzB;;OAEG;IACG,cAAc,CAClB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;CA0B1B"}
+{"version":3,"file":"screenshotter.d.ts","sourceRoot":"","sources":["../../src/lib/screenshotter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOvC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI3E;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,IAAI,GACf,MAAM,CAMR;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAID,UAAU,oBAAoB;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAuBD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC5G,IAAI,CAON;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxH,IAAI,CAON;AAkCD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,YAAY,CAAO;gBAEf,OAAO,GAAE,oBAAyB;IASxC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAkDpE,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgD5E,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA4CpG"}

package/dist/lib/smoke.d.ts

@@ -0,0 +1,25 @@
+import type { Run, Result } from "../types/index.js";
+export interface SmokeResult {
+    run: Run;
+    result: Result;
+    pagesVisited: number;
+    issuesFound: SmokeIssue[];
+}
+export interface SmokeIssue {
+    type: "js-error" | "404" | "broken-image" | "broken-link" | "visual" | "performance";
+    severity: "critical" | "high" | "medium" | "low";
+    description: string;
+    url: string;
+    screenshot?: string;
+}
+export declare function runSmoke(options: {
+    url: string;
+    model?: string;
+    headed?: boolean;
+    timeout?: number;
+    projectId?: string;
+    apiKey?: string;
+}): Promise<SmokeResult>;
+export declare function parseSmokeIssues(reasoning: string): SmokeIssue[];
+export declare function formatSmokeReport(result: SmokeResult): string;
+//# sourceMappingURL=smoke.d.ts.map

package/dist/lib/smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.d.ts","sourceRoot":"","sources":["../../src/lib/smoke.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAOrD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,aAAa,CAAC;IACrF,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAsBD,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwEvB;AAwCD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAiDhE;AA2BD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAuD7D"}

package/dist/lib/templates.d.ts

@@ -0,0 +1,5 @@
+import type { CreateScenarioInput } from "../types/index.js";
+export declare const SCENARIO_TEMPLATES: Record<string, CreateScenarioInput[]>;
+export declare function getTemplate(name: string): CreateScenarioInput[] | null;
+export declare function listTemplateNames(): string[];
+//# sourceMappingURL=templates.d.ts.map

package/dist/lib/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAyBpE,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,EAAE,GAAG,IAAI,CAEtE;AAED,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C"}

package/dist/lib/watch.d.ts

@@ -0,0 +1,9 @@
+import type { RunOptions } from "./runner.js";
+export interface WatchOptions extends RunOptions {
+    dir: string;
+    debounceMs?: number;
+    tags?: string[];
+    priority?: string;
+}
+export declare function startWatcher(options: WatchOptions): Promise<void>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/lib/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/lib/watch.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAsGvE"}

package/dist/lib/webhooks.d.ts

@@ -0,0 +1,41 @@
+import type { Run } from "../types/index.js";
+export interface Webhook {
+    id: string;
+    url: string;
+    events: string[];
+    projectId: string | null;
+    secret: string | null;
+    active: boolean;
+    createdAt: string;
+}
+export declare function createWebhook(input: {
+    url: string;
+    events?: string[];
+    projectId?: string;
+    secret?: string;
+}): Webhook;
+export declare function getWebhook(id: string): Webhook | null;
+export declare function listWebhooks(projectId?: string): Webhook[];
+export declare function deleteWebhook(id: string): boolean;
+export interface WebhookPayload {
+    event: string;
+    run: {
+        id: string;
+        url: string;
+        status: string;
+        passed: number;
+        failed: number;
+        total: number;
+    };
+    schedule?: {
+        name: string;
+        cronExpression: string;
+    };
+    timestamp: string;
+}
+export declare function dispatchWebhooks(event: string, run: Run, schedule?: {
+    name: string;
+    cronExpression: string;
+}): Promise<void>;
+export declare function testWebhook(id: string): Promise<boolean>;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/lib/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/lib/webhooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAc7C,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAYV;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAUrD;AAED,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAW1D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAMjD;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAwCD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,GAAG,EACR,QAAQ,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwB9D"}

package/dist/mcp/index.js

@@ -4080,7 +4080,10 @@ function screenshotFromRow(row) {
     filePath: row.file_path,
     width: row.width,
     height: row.height,
-    timestamp: row.timestamp
+    timestamp: row.timestamp,
+    description: row.description,
+    pageUrl: row.page_url,
+    thumbnailPath: row.thumbnail_path
   };
 }
 function scheduleFromRow(row) {
@@ -4289,6 +4292,34 @@ var MIGRATIONS = [
   CREATE INDEX IF NOT EXISTS idx_schedules_project ON schedules(project_id);
   CREATE INDEX IF NOT EXISTS idx_schedules_enabled ON schedules(enabled);
   CREATE INDEX IF NOT EXISTS idx_schedules_next_run ON schedules(next_run_at);
+  `,
+  `
+  ALTER TABLE screenshots ADD COLUMN description TEXT;
+  ALTER TABLE screenshots ADD COLUMN page_url TEXT;
+  ALTER TABLE screenshots ADD COLUMN thumbnail_path TEXT;
+  `,
+  `
+  CREATE TABLE IF NOT EXISTS auth_presets (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL UNIQUE,
+    email TEXT NOT NULL,
+    password TEXT NOT NULL,
+    login_path TEXT DEFAULT '/login',
+    metadata TEXT DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  `,
+  `
+  CREATE TABLE IF NOT EXISTS webhooks (
+    id TEXT PRIMARY KEY,
+    url TEXT NOT NULL,
+    events TEXT NOT NULL DEFAULT '["failed"]',
+    project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
+    secret TEXT,
+    active INTEGER NOT NULL DEFAULT 1,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_webhooks_active ON webhooks(active);
   `
 ];
 function applyMigrations(database) {
@@ -4686,9 +4717,9 @@ function createScreenshot(input) {
   const id = uuid();
   const timestamp = now();
   db2.query(`
-    INSERT INTO screenshots (id, result_id, step_number, action, file_path, width, height, timestamp)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(id, input.resultId, input.stepNumber, input.action, input.filePath, input.width, input.height, timestamp);
+    INSERT INTO screenshots (id, result_id, step_number, action, file_path, width, height, timestamp, description, page_url, thumbnail_path)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, input.resultId, input.stepNumber, input.action, input.filePath, input.width, input.height, timestamp, input.description ?? null, input.pageUrl ?? null, input.thumbnailPath ?? null);
   return getScreenshot(id);
 }
 function getScreenshot(id) {
@@ -4805,7 +4836,7 @@ async function closeBrowser(browser) {
 }
 
 // src/lib/screenshotter.ts
-import { mkdirSync as mkdirSync2, existsSync as existsSync2 } from "fs";
+import { mkdirSync as mkdirSync2, existsSync as existsSync2, writeFileSync } from "fs";
 import { join as join2 } from "path";
 import { homedir as homedir2 } from "os";
 function slugify(text) {
@@ -4814,16 +4845,51 @@ function slugify(text) {
 function generateFilename(stepNumber, action) {
   const padded = String(stepNumber).padStart(3, "0");
   const slug = slugify(action);
-  return `${padded}-${slug}.png`;
+  return `${padded}_${slug}.png`;
+}
+function formatDate(date) {
+  return date.toISOString().slice(0, 10);
 }
-function getScreenshotDir(baseDir, runId, scenarioSlug) {
-  return join2(baseDir, runId, scenarioSlug);
+function formatTime(date) {
+  return date.toISOString().slice(11, 19).replace(/:/g, "-");
+}
+function getScreenshotDir(baseDir, runId, scenarioSlug, projectName, timestamp) {
+  const now2 = timestamp ?? new Date;
+  const project = projectName ?? "default";
+  const dateDir = formatDate(now2);
+  const timeDir = `${formatTime(now2)}_${runId.slice(0, 8)}`;
+  return join2(baseDir, project, dateDir, timeDir, scenarioSlug);
 }
 function ensureDir(dirPath) {
   if (!existsSync2(dirPath)) {
     mkdirSync2(dirPath, { recursive: true });
   }
 }
+function writeMetaSidecar(screenshotPath, meta) {
+  const metaPath = screenshotPath.replace(/\.png$/, ".meta.json").replace(/\.jpeg$/, ".meta.json");
+  try {
+    writeFileSync(metaPath, JSON.stringify(meta, null, 2), "utf-8");
+  } catch {}
+}
+async function generateThumbnail(page, screenshotDir, filename) {
+  try {
+    const thumbDir = join2(screenshotDir, "_thumbnail");
+    ensureDir(thumbDir);
+    const thumbFilename = filename.replace(/\.(png|jpeg)$/, ".thumb.$1");
+    const thumbPath = join2(thumbDir, thumbFilename);
+    const viewport = page.viewportSize();
+    if (viewport) {
+      await page.screenshot({
+        path: thumbPath,
+        type: "png",
+        clip: { x: 0, y: 0, width: Math.min(viewport.width, 1280), height: Math.min(viewport.height, 720) }
+      });
+    }
+    return thumbPath;
+  } catch {
+    return null;
+  }
+}
 var DEFAULT_BASE_DIR = join2(homedir2(), ".testers", "screenshots");
 
 class Screenshotter {
@@ -4831,15 +4897,20 @@ class Screenshotter {
   format;
   quality;
   fullPage;
+  projectName;
+  runTimestamp;
   constructor(options = {}) {
     this.baseDir = options.baseDir ?? DEFAULT_BASE_DIR;
     this.format = options.format ?? "png";
     this.quality = options.quality ?? 90;
     this.fullPage = options.fullPage ?? false;
+    this.projectName = options.projectName ?? "default";
+    this.runTimestamp = new Date;
   }
   async capture(page, options) {
-    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug);
-    const filename = generateFilename(options.stepNumber, options.action);
+    const action = options.description ?? options.action;
+    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug, this.projectName, this.runTimestamp);
+    const filename = generateFilename(options.stepNumber, action);
     const filePath = join2(dir, filename);
     ensureDir(dir);
     await page.screenshot({
@@ -4849,16 +4920,32 @@ class Screenshotter {
       quality: this.format === "jpeg" ? this.quality : undefined
     });
     const viewport = page.viewportSize() ?? { width: 0, height: 0 };
+    const pageUrl = page.url();
+    const timestamp = new Date().toISOString();
+    writeMetaSidecar(filePath, {
+      stepNumber: options.stepNumber,
+      action: options.action,
+      description: options.description ?? null,
+      pageUrl,
+      viewport,
+      timestamp,
+      filePath
+    });
+    const thumbnailPath = await generateThumbnail(page, dir, filename);
     return {
       filePath,
       width: viewport.width,
       height: viewport.height,
-      timestamp: new Date().toISOString()
+      timestamp,
+      description: options.description ?? null,
+      pageUrl,
+      thumbnailPath
     };
   }
   async captureFullPage(page, options) {
-    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug);
-    const filename = generateFilename(options.stepNumber, options.action);
+    const action = options.description ?? options.action;
+    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug, this.projectName, this.runTimestamp);
+    const filename = generateFilename(options.stepNumber, action);
     const filePath = join2(dir, filename);
     ensureDir(dir);
     await page.screenshot({
@@ -4868,16 +4955,32 @@ class Screenshotter {
       quality: this.format === "jpeg" ? this.quality : undefined
     });
     const viewport = page.viewportSize() ?? { width: 0, height: 0 };
+    const pageUrl = page.url();
+    const timestamp = new Date().toISOString();
+    writeMetaSidecar(filePath, {
+      stepNumber: options.stepNumber,
+      action: options.action,
+      description: options.description ?? null,
+      pageUrl,
+      viewport,
+      timestamp,
+      filePath
+    });
+    const thumbnailPath = await generateThumbnail(page, dir, filename);
     return {
       filePath,
       width: viewport.width,
       height: viewport.height,
-      timestamp: new Date().toISOString()
+      timestamp,
+      description: options.description ?? null,
+      pageUrl,
+      thumbnailPath
     };
   }
   async captureElement(page, selector, options) {
-    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug);
-    const filename = generateFilename(options.stepNumber, options.action);
+    const action = options.description ?? options.action;
+    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug, this.projectName, this.runTimestamp);
+    const filename = generateFilename(options.stepNumber, action);
     const filePath = join2(dir, filename);
     ensureDir(dir);
     await page.locator(selector).screenshot({
@@ -4886,11 +4989,25 @@ class Screenshotter {
       quality: this.format === "jpeg" ? this.quality : undefined
     });
     const viewport = page.viewportSize() ?? { width: 0, height: 0 };
+    const pageUrl = page.url();
+    const timestamp = new Date().toISOString();
+    writeMetaSidecar(filePath, {
+      stepNumber: options.stepNumber,
+      action: options.action,
+      description: options.description ?? null,
+      pageUrl,
+      viewport,
+      timestamp,
+      filePath
+    });
     return {
       filePath,
       width: viewport.width,
       height: viewport.height,
-      timestamp: new Date().toISOString()
+      timestamp,
+      description: options.description ?? null,
+      pageUrl,
+      thumbnailPath: null
     };
   }
 }
@@ -5673,7 +5790,10 @@ async function runSingleScenario(scenario, runId, options) {
         action: ss.action,
         filePath: ss.filePath,
         width: ss.width,
-        height: ss.height
+        height: ss.height,
+        description: ss.description,
+        pageUrl: ss.pageUrl,
+        thumbnailPath: ss.thumbnailPath
       });
       emit({ type: "screenshot:captured", screenshotPath: ss.filePath, scenarioId: scenario.id, runId });
     }