@hasna/testers 0.0.12 → 0.0.14

package/dist/db/agents.d.ts

@@ -7,4 +7,6 @@ export declare function registerAgent(input: {
 export declare function getAgent(id: string): Agent | null;
 export declare function getAgentByName(name: string): Agent | null;
 export declare function listAgents(): Agent[];
+export declare function heartbeatAgent(id: string): Agent | null;
+export declare function setAgentFocus(id: string, scenarioId: string | null): Agent | null;
 //# sourceMappingURL=agents.d.ts.map

package/dist/db/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/db/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EAGX,MAAM,mBAAmB,CAAC;AAG3B,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,KAAK,CA2BR;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAIjD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAIzD;AAED,wBAAgB,UAAU,IAAI,KAAK,EAAE,CAIpC"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/db/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EAGX,MAAM,mBAAmB,CAAC;AAG3B,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,KAAK,CA2BR;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAIjD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAIzD;AAED,wBAAgB,UAAU,IAAI,KAAK,EAAE,CAIpC;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAKvD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAWjF"}

package/dist/db/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOtC,iBAAS,GAAG,IAAI,MAAM,CAErB;AAED,iBAAS,IAAI,IAAI,MAAM,CAEtB;AAED,iBAAS,SAAS,IAAI,MAAM,CAE3B;AAwPD,wBAAgB,WAAW,IAAI,QAAQ,CAwBtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAepC;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAOf;AAED,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOtC,iBAAS,GAAG,IAAI,MAAM,CAErB;AAED,iBAAS,IAAI,IAAI,MAAM,CAEtB;AAED,iBAAS,SAAS,IAAI,MAAM,CAE3B;AAiRD,wBAAgB,WAAW,IAAI,QAAQ,CAwBtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAgBpC;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAOf;AAED,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC"}

package/dist/db/scan-issues.d.ts

@@ -0,0 +1,29 @@
+import { type PersistedScanIssue, type ScanIssue } from "../types/index.js";
+/**
+ * Derive a stable fingerprint from an issue.
+ * Normalises the page URL to its pathname (ignores query/fragment) so the same
+ * error on foo.com/page?x=1 and foo.com/page?x=2 is treated as the same issue.
+ */
+export declare function fingerprintIssue(issue: ScanIssue): string;
+export type UpsertOutcome = "new" | "existing" | "regressed";
+export interface UpsertResult {
+    issue: PersistedScanIssue;
+    outcome: UpsertOutcome;
+}
+/**
+ * Upsert a scan issue by fingerprint:
+ * - New (never seen): insert with status=open
+ * - Known open: bump occurrence_count + last_seen_at
+ * - Known resolved: mark as regressed (status=regressed, increment count)
+ */
+export declare function upsertScanIssue(issue: ScanIssue, projectId?: string): UpsertResult;
+export declare function resolveScanIssue(id: string): boolean;
+export declare function setScanIssueTodoTaskId(id: string, todoTaskId: string): void;
+export declare function listScanIssues(opts?: {
+    status?: string;
+    type?: string;
+    projectId?: string;
+    limit?: number;
+}): PersistedScanIssue[];
+export declare function getScanIssue(id: string): PersistedScanIssue | null;
+//# sourceMappingURL=scan-issues.d.ts.map

package/dist/db/scan-issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-issues.d.ts","sourceRoot":"","sources":["../../src/db/scan-issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAuC,MAAM,mBAAmB,CAAC;AAKjH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAezD;AAID,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,YAAY,CAoDd;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAMpD;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAG3E;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,kBAAkB,EAAE,CAc5B;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAIlE"}

package/dist/index.js

@@ -1,12 +1,16 @@
 // @bun
 var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -295,6 +299,7 @@ function resetDatabase() {
   database.exec("DELETE FROM runs");
   database.exec("DELETE FROM scenarios");
   database.exec("DELETE FROM agents");
+  database.exec("DELETE FROM scan_issues");
   database.exec("DELETE FROM projects");
 }
 function resolvePartialId(table, partialId) {
@@ -502,6 +507,29 @@ var init_database = __esm(() => {
   `,
     `
   ALTER TABLE runs ADD COLUMN is_baseline INTEGER NOT NULL DEFAULT 0;
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS scan_issues (
+    id TEXT PRIMARY KEY,
+    fingerprint TEXT NOT NULL UNIQUE,
+    type TEXT NOT NULL,
+    severity TEXT NOT NULL DEFAULT 'medium',
+    page_url TEXT NOT NULL,
+    message TEXT NOT NULL,
+    detail TEXT,
+    status TEXT NOT NULL DEFAULT 'open',
+    occurrence_count INTEGER NOT NULL DEFAULT 1,
+    first_seen_at TEXT NOT NULL DEFAULT (datetime('now')),
+    last_seen_at TEXT NOT NULL DEFAULT (datetime('now')),
+    resolved_at TEXT,
+    todo_task_id TEXT,
+    project_id TEXT REFERENCES projects(id) ON DELETE SET NULL
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_scan_issues_fingerprint ON scan_issues(fingerprint);
+  CREATE INDEX IF NOT EXISTS idx_scan_issues_status ON scan_issues(status);
+  CREATE INDEX IF NOT EXISTS idx_scan_issues_type ON scan_issues(type);
+  CREATE INDEX IF NOT EXISTS idx_scan_issues_project ON scan_issues(project_id);
   `
   ];
 });
@@ -2722,6 +2750,214 @@ async function pushFailedRunToLogs(run, failedResults, scenarios) {
   } catch {}
 }
 
+// src/lib/todos-connector.ts
+import { Database as Database2 } from "bun:sqlite";
+import { existsSync as existsSync4 } from "fs";
+import { join as join4 } from "path";
+import { homedir as homedir4 } from "os";
+init_types();
+function resolveTodosDbPath() {
+  const envPath = process.env["TODOS_DB_PATH"];
+  if (envPath)
+    return envPath;
+  return join4(homedir4(), ".todos", "todos.db");
+}
+function connectToTodos() {
+  const dbPath = resolveTodosDbPath();
+  if (!existsSync4(dbPath)) {
+    throw new TodosConnectionError(`Todos database not found at ${dbPath}. Install @hasna/todos or set TODOS_DB_PATH.`);
+  }
+  const db2 = new Database2(dbPath, { readonly: true });
+  db2.exec("PRAGMA foreign_keys = ON");
+  return db2;
+}
+function pullTasks(options = {}) {
+  const db2 = connectToTodos();
+  try {
+    let query = "SELECT id, short_id, title, description, status, priority, tags, project_id FROM tasks WHERE 1=1";
+    const params = [];
+    if (options.status) {
+      query += " AND status = ?";
+      params.push(options.status);
+    } else {
+      query += " AND status IN ('pending', 'in_progress')";
+    }
+    if (options.priority) {
+      query += " AND priority = ?";
+      params.push(options.priority);
+    }
+    if (options.projectName) {
+      const project = db2.query("SELECT id FROM projects WHERE name = ?").get(options.projectName);
+      if (project) {
+        query += " AND project_id = ?";
+        params.push(project.id);
+      }
+    }
+    query += " ORDER BY CASE priority WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 WHEN 'low' THEN 3 END";
+    const tasks = db2.query(query).all(...params);
+    if (options.tags && options.tags.length > 0) {
+      return tasks.filter((task) => {
+        const taskTags = JSON.parse(task.tags || "[]");
+        return options.tags.some((tag) => taskTags.includes(tag));
+      });
+    }
+    return tasks;
+  } finally {
+    db2.close();
+  }
+}
+function taskToScenarioInput(task, projectId) {
+  const tags = JSON.parse(task.tags || "[]");
+  const priority = ["low", "medium", "high", "critical"].includes(task.priority) ? task.priority : "medium";
+  const steps = [];
+  if (task.description) {
+    const lines = task.description.split(`
+`);
+    for (const line of lines) {
+      const match = line.match(/^\s*\d+[\.\)]\s*(.+)/);
+      if (match?.[1]) {
+        steps.push(match[1].trim());
+      }
+    }
+  }
+  return {
+    name: task.title.replace(/^(OPE\d+-\d+|[A-Z]+-\d+):\s*/, ""),
+    description: task.description || task.title,
+    steps,
+    tags,
+    priority,
+    projectId,
+    metadata: { todosTaskId: task.id, todosShortId: task.short_id }
+  };
+}
+function importFromTodos(options = {}) {
+  const tasks = pullTasks({
+    projectName: options.projectName,
+    tags: options.tags ?? ["qa", "test", "testing"],
+    priority: options.priority
+  });
+  const existing = listScenarios({ projectId: options.projectId });
+  const existingTodoIds = new Set(existing.filter((s) => s.metadata?.todosTaskId).map((s) => s.metadata.todosTaskId));
+  let imported = 0;
+  let skipped = 0;
+  for (const task of tasks) {
+    if (existingTodoIds.has(task.id)) {
+      skipped++;
+      continue;
+    }
+    const input = taskToScenarioInput(task, options.projectId);
+    createScenario(input);
+    imported++;
+  }
+  return { imported, skipped };
+}
+function markTodoDone(taskId) {
+  const dbPath = resolveTodosDbPath();
+  if (!existsSync4(dbPath))
+    return false;
+  const db2 = new Database2(dbPath);
+  try {
+    const task = db2.query("SELECT id, version FROM tasks WHERE id LIKE ? || '%'").get(taskId);
+    if (!task)
+      return false;
+    db2.query("UPDATE tasks SET status = 'completed', completed_at = datetime('now'), version = version + 1, updated_at = datetime('now') WHERE id = ? AND version = ?").run(task.id, task.version);
+    return true;
+  } finally {
+    db2.close();
+  }
+}
+
+// src/lib/failure-pipeline.ts
+async function createFailureTasks(run, failedResults, scenarios) {
+  if (failedResults.length === 0)
+    return { created: 0, skipped: 0 };
+  const projectId = process.env["TESTERS_TODOS_PROJECT_ID"];
+  if (!projectId)
+    return { created: 0, skipped: 0 };
+  let db2 = null;
+  try {
+    db2 = connectToTodos();
+  } catch {
+    return { created: 0, skipped: 0 };
+  }
+  const scenarioMap = new Map(scenarios.map((s) => [s.id, s]));
+  let created = 0;
+  let skipped = 0;
+  try {
+    for (const result of failedResults) {
+      const scenario = scenarioMap.get(result.scenarioId);
+      const title = `BUG: [testers] ${scenario?.name ?? result.scenarioId} failed`;
+      const existing = db2.query("SELECT id FROM tasks WHERE title = ? AND status NOT IN ('completed', 'cancelled') LIMIT 1").get(title);
+      if (existing) {
+        skipped++;
+        continue;
+      }
+      const id = crypto.randomUUID();
+      const now2 = new Date().toISOString();
+      const description = [
+        `Test failure detected by open-testers.`,
+        ``,
+        `**Run:** ${run.id}`,
+        `**URL:** ${run.url}`,
+        `**Scenario:** ${scenario?.name ?? result.scenarioId}`,
+        `**Status:** ${result.status}`,
+        result.error ? `**Error:** ${result.error}` : null,
+        result.reasoning ? `**Reasoning:** ${result.reasoning.slice(0, 500)}` : null,
+        `**Duration:** ${result.durationMs ? `${(result.durationMs / 1000).toFixed(1)}s` : "N/A"}`,
+        `**Tokens:** ${result.tokensUsed ?? 0}`
+      ].filter(Boolean).join(`
+`);
+      try {
+        db2.query(`
+          INSERT INTO tasks (id, short_id, title, description, status, priority, tags, project_id, version, created_at, updated_at)
+          VALUES (?, ?, ?, ?, 'pending', 'high', ?, ?, 1, ?, ?)
+        `).run(id, `BUG-${id.slice(0, 6)}`, title, description, JSON.stringify(["bug", "testers", "auto-created"]), projectId, now2, now2);
+        created++;
+      } catch {
+        skipped++;
+      }
+    }
+  } finally {
+    db2.close();
+  }
+  return { created, skipped };
+}
+async function notifyFailureToConversations(run, failedResults, scenarios) {
+  const baseUrl = process.env["TESTERS_CONVERSATIONS_URL"];
+  const space = process.env["TESTERS_CONVERSATIONS_SPACE"];
+  if (!baseUrl || !space)
+    return;
+  const scenarioMap = new Map(scenarios.map((s) => [s.id, s]));
+  const total = run.total;
+  const failedCount = failedResults.length;
+  const passedCount = run.passed;
+  const failureLines = failedResults.slice(0, 5).map((r) => {
+    const name = scenarioMap.get(r.scenarioId)?.name ?? r.scenarioId;
+    const err = r.error ? ` \u2014 ${r.error.slice(0, 120)}` : "";
+    return `  \u274C ${name}${err}`;
+  });
+  const extra = failedResults.length > 5 ? `  \u2026 and ${failedResults.length - 5} more` : "";
+  const message = [
+    `\uD83D\uDEA8 **Testers run failed** \u2014 ${failedCount}/${total} scenarios failed`,
+    ``,
+    `**URL:** ${run.url}`,
+    `**Run ID:** \`${run.id}\``,
+    `**Pass rate:** ${passedCount}/${total}`,
+    ``,
+    `**Failures:**`,
+    ...failureLines,
+    extra
+  ].filter((l) => l !== "").join(`
+`);
+  try {
+    await fetch(`${baseUrl.replace(/\/$/, "")}/api/spaces/${encodeURIComponent(space)}/messages`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ content: message, from: "testers" })
+    });
+  } catch {}
+}
+
 // src/lib/runner.ts
 var eventHandler = null;
 function onRunEvent(handler) {
@@ -2958,6 +3194,8 @@ async function runBatch(scenarios, options) {
   if (finalRun.status === "failed") {
     const failedResults = results.filter((r) => r.status === "failed" || r.status === "error");
     pushFailedRunToLogs(finalRun, failedResults, scenarios).catch(() => {});
+    createFailureTasks(finalRun, failedResults, scenarios).catch(() => {});
+    notifyFailureToConversations(finalRun, failedResults, scenarios).catch(() => {});
   }
   return { run: finalRun, results };
 }
@@ -3808,122 +4046,6 @@ function formatResultDetail(result, screenshots) {
   return lines.join(`
 `);
 }
-// src/lib/todos-connector.ts
-import { Database as Database2 } from "bun:sqlite";
-import { existsSync as existsSync4 } from "fs";
-import { join as join4 } from "path";
-import { homedir as homedir4 } from "os";
-init_types();
-function resolveTodosDbPath() {
-  const envPath = process.env["TODOS_DB_PATH"];
-  if (envPath)
-    return envPath;
-  return join4(homedir4(), ".todos", "todos.db");
-}
-function connectToTodos() {
-  const dbPath = resolveTodosDbPath();
-  if (!existsSync4(dbPath)) {
-    throw new TodosConnectionError(`Todos database not found at ${dbPath}. Install @hasna/todos or set TODOS_DB_PATH.`);
-  }
-  const db2 = new Database2(dbPath, { readonly: true });
-  db2.exec("PRAGMA foreign_keys = ON");
-  return db2;
-}
-function pullTasks(options = {}) {
-  const db2 = connectToTodos();
-  try {
-    let query = "SELECT id, short_id, title, description, status, priority, tags, project_id FROM tasks WHERE 1=1";
-    const params = [];
-    if (options.status) {
-      query += " AND status = ?";
-      params.push(options.status);
-    } else {
-      query += " AND status IN ('pending', 'in_progress')";
-    }
-    if (options.priority) {
-      query += " AND priority = ?";
-      params.push(options.priority);
-    }
-    if (options.projectName) {
-      const project = db2.query("SELECT id FROM projects WHERE name = ?").get(options.projectName);
-      if (project) {
-        query += " AND project_id = ?";
-        params.push(project.id);
-      }
-    }
-    query += " ORDER BY CASE priority WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 WHEN 'low' THEN 3 END";
-    const tasks = db2.query(query).all(...params);
-    if (options.tags && options.tags.length > 0) {
-      return tasks.filter((task) => {
-        const taskTags = JSON.parse(task.tags || "[]");
-        return options.tags.some((tag) => taskTags.includes(tag));
-      });
-    }
-    return tasks;
-  } finally {
-    db2.close();
-  }
-}
-function taskToScenarioInput(task, projectId) {
-  const tags = JSON.parse(task.tags || "[]");
-  const priority = ["low", "medium", "high", "critical"].includes(task.priority) ? task.priority : "medium";
-  const steps = [];
-  if (task.description) {
-    const lines = task.description.split(`
-`);
-    for (const line of lines) {
-      const match = line.match(/^\s*\d+[\.\)]\s*(.+)/);
-      if (match?.[1]) {
-        steps.push(match[1].trim());
-      }
-    }
-  }
-  return {
-    name: task.title.replace(/^(OPE\d+-\d+|[A-Z]+-\d+):\s*/, ""),
-    description: task.description || task.title,
-    steps,
-    tags,
-    priority,
-    projectId,
-    metadata: { todosTaskId: task.id, todosShortId: task.short_id }
-  };
-}
-function importFromTodos(options = {}) {
-  const tasks = pullTasks({
-    projectName: options.projectName,
-    tags: options.tags ?? ["qa", "test", "testing"],
-    priority: options.priority
-  });
-  const existing = listScenarios({ projectId: options.projectId });
-  const existingTodoIds = new Set(existing.filter((s) => s.metadata?.todosTaskId).map((s) => s.metadata.todosTaskId));
-  let imported = 0;
-  let skipped = 0;
-  for (const task of tasks) {
-    if (existingTodoIds.has(task.id)) {
-      skipped++;
-      continue;
-    }
-    const input = taskToScenarioInput(task, options.projectId);
-    createScenario(input);
-    imported++;
-  }
-  return { imported, skipped };
-}
-function markTodoDone(taskId) {
-  const dbPath = resolveTodosDbPath();
-  if (!existsSync4(dbPath))
-    return false;
-  const db2 = new Database2(dbPath);
-  try {
-    const task = db2.query("SELECT id, version FROM tasks WHERE id LIKE ? || '%'").get(taskId);
-    if (!task)
-      return false;
-    db2.query("UPDATE tasks SET status = 'completed', completed_at = datetime('now'), version = version + 1, updated_at = datetime('now') WHERE id = ? AND version = ?").run(task.id, task.version);
-    return true;
-  } finally {
-    db2.close();
-  }
-}
 // src/lib/scheduler.ts
 init_types();
 function parseCronField(field, min, max) {

package/dist/lib/affected.d.ts

@@ -0,0 +1,23 @@
+import type { Scenario } from "../types/index.js";
+export interface FileMapping {
+    /** Glob pattern for source files (supports * and **) */
+    glob: string;
+    /** Tags of scenarios to run when this glob matches */
+    tags: string[];
+}
+/**
+ * Given a set of changed file paths and all scenarios, return the scenarios
+ * relevant to those changes.
+ *
+ * Matching strategies (all applied, union of results):
+ * 1. Explicit glob → tag mappings: if a file matches a glob, scenarios with
+ *    any of the mapped tags are included.
+ * 2. targetPath keyword: path segments of scenario.targetPath matched against
+ *    file path components.
+ * 3. Tag keywords: scenario tags matched as substrings of file paths (>2 chars).
+ * 4. Name keywords: words in the scenario name matched against file paths (>3 chars).
+ *
+ * If filePaths is empty, all scenarios are returned (run everything).
+ */
+export declare function matchFilesToScenarios(filePaths: string[], scenarios: Scenario[], mappings?: FileMapping[]): Scenario[];
+//# sourceMappingURL=affected.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"affected.d.ts","sourceRoot":"","sources":["../../src/lib/affected.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAeD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,GAAE,WAAW,EAAO,GAC3B,QAAQ,EAAE,CA+DZ"}

package/dist/lib/failure-pipeline.d.ts

@@ -0,0 +1,20 @@
+import type { Run, Result, Scenario } from "../types/index.js";
+/**
+ * Auto-create a todo task for each failed scenario in a run.
+ * Uses the todos DB directly (like todos-connector.ts does).
+ * No-op if TODOS_DB_PATH is not set and ~/.todos/todos.db does not exist.
+ * Controlled by TESTERS_TODOS_PROJECT_ID env var (which project to create tasks in).
+ */
+export declare function createFailureTasks(run: Run, failedResults: Result[], scenarios: Scenario[]): Promise<{
+    created: number;
+    skipped: number;
+}>;
+/**
+ * Post a failure notification to a conversations space.
+ * Controlled by:
+ *   TESTERS_CONVERSATIONS_URL  — base URL of the conversations service
+ *   TESTERS_CONVERSATIONS_SPACE — space name/slug to post to
+ * No-op if either env var is missing.
+ */
+export declare function notifyFailureToConversations(run: Run, failedResults: Result[], scenarios: Scenario[]): Promise<void>;
+//# sourceMappingURL=failure-pipeline.d.ts.map

package/dist/lib/failure-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-pipeline.d.ts","sourceRoot":"","sources":["../../src/lib/failure-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAK/D;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,MAAM,EAAE,EACvB,SAAS,EAAE,QAAQ,EAAE,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyE/C;AAID;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,MAAM,EAAE,EACvB,SAAS,EAAE,QAAQ,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/lib/git-watch.d.ts

@@ -0,0 +1,16 @@
+import type { FileMapping } from "./affected.js";
+import type { RunOptions } from "./runner.js";
+export interface GitWatchOptions extends Omit<RunOptions, "url"> {
+    url: string;
+    dir?: string;
+    pollIntervalMs?: number;
+    mappings?: FileMapping[];
+    projectId?: string;
+    tags?: string[];
+}
+/**
+ * Poll git for new commits and run affected scenarios when changes land.
+ * Designed for use in CI or as a long-running watcher.
+ */
+export declare function startGitWatcher(options: GitWatchOptions): Promise<void>;
+//# sourceMappingURL=git-watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-watch.d.ts","sourceRoot":"","sources":["../../src/lib/git-watch.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAwBD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAiF7E"}

package/dist/lib/health-scan.d.ts

@@ -0,0 +1,22 @@
+import type { ScanResult } from "../types/index.js";
+export interface HealthScanOptions {
+    url: string;
+    pages?: string[];
+    projectId?: string;
+    headed?: boolean;
+    timeoutMs?: number;
+    scanners?: ("console" | "network" | "links" | "performance")[];
+    maxPages?: number;
+}
+export interface HealthScanSummary {
+    url: string;
+    scannedAt: string;
+    durationMs: number;
+    totalIssues: number;
+    newIssues: number;
+    regressedIssues: number;
+    existingIssues: number;
+    results: ScanResult[];
+}
+export declare function runHealthScan(options: HealthScanOptions): Promise<HealthScanSummary>;
+//# sourceMappingURL=health-scan.d.ts.map

package/dist/lib/health-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-scan.d.ts","sourceRoot":"","sources":["../../src/lib/health-scan.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,mBAAmB,CAAC;AAI/D,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAID,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0D1F"}

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;AAa/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,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;CACtC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EACA,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,qBAAqB,GACrB,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,eAAe,GACf,0BAA0B,CAAC;IAC/B,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;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAIxD,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEzD;AA+BD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAiHjB;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,CAsI1C;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;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,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;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAmF1C"}
+{"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;AAc/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,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;CACtC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EACA,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,qBAAqB,GACrB,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,eAAe,GACf,0BAA0B,CAAC;IAC/B,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;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAIxD,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEzD;AA+BD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAiHjB;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,CAwI1C;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;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,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;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAmF1C"}

package/dist/lib/scanners/console.d.ts

@@ -0,0 +1,12 @@
+import type { ScanResult } from "../../types/index.js";
+/**
+ * Visit each page and collect JS/React/unhandled errors from the browser console.
+ * Captures: console.error(), uncaught exceptions, unhandled promise rejections.
+ */
+export declare function scanConsoleErrors(options: {
+    url: string;
+    pages?: string[];
+    headed?: boolean;
+    timeoutMs?: number;
+}): Promise<ScanResult>;
+//# sourceMappingURL=console.d.ts.map

package/dist/lib/scanners/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/lib/scanners/console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQlE;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqEtB"}

package/dist/lib/scanners/links.d.ts

@@ -0,0 +1,12 @@
+import type { ScanResult } from "../../types/index.js";
+/**
+ * Crawl the app starting from rootUrl, follow all internal links,
+ * and flag any that return 404 or redirect loops.
+ */
+export declare function scanBrokenLinks(options: {
+    url: string;
+    maxPages?: number;
+    headed?: boolean;
+    timeoutMs?: number;
+}): Promise<ScanResult>;
+//# sourceMappingURL=links.d.ts.map

package/dist/lib/scanners/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../../src/lib/scanners/links.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElE;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0FtB"}

package/dist/lib/scanners/network.d.ts

@@ -0,0 +1,15 @@
+import type { ScanResult } from "../../types/index.js";
+/**
+ * Visit each page and intercept network requests, flagging:
+ * - HTTP 5xx (server errors)
+ * - HTTP 4xx on API routes
+ * - CORS errors
+ * - Request failures (net::ERR_*)
+ */
+export declare function scanNetworkErrors(options: {
+    url: string;
+    pages?: string[];
+    headed?: boolean;
+    timeoutMs?: number;
+}): Promise<ScanResult>;
+//# sourceMappingURL=network.d.ts.map

package/dist/lib/scanners/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/lib/scanners/network.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAWlE;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0EtB"}

package/dist/lib/scanners/performance.d.ts

@@ -0,0 +1,19 @@
+import type { ScanResult } from "../../types/index.js";
+interface PerfThresholds {
+    loadTimeMs: number;
+    domContentLoadedMs: number;
+    lcpMs: number;
+}
+/**
+ * Visit each page and collect Web Performance API metrics.
+ * Flags pages that exceed configurable thresholds.
+ */
+export declare function scanPerformance(options: {
+    url: string;
+    pages?: string[];
+    headed?: boolean;
+    timeoutMs?: number;
+    thresholds?: Partial<PerfThresholds>;
+}): Promise<ScanResult>;
+export {};
+//# sourceMappingURL=performance.d.ts.map

package/dist/lib/scanners/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../src/lib/scanners/performance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAYlE,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAQD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACtC,GAAG,OAAO,CAAC,UAAU,CAAC,CA2GtB"}