bughunters 0.1.0 → 0.1.1

package/dist/bin.js

@@ -364,7 +364,12 @@ var agentsSchema = z.object({
   patrol: z.object({
     intervalMinutes: z.number().positive().default(30),
     /** Stop after this many cycles; 0 means run until stopped. */
-    cycles: z.number().int().nonnegative().default(0)
+    cycles: z.number().int().nonnegative().default(0),
+    /**
+     * At the start of each cycle, fetch this `remote/branch` and check out its
+     * latest commit (detached) in the source repository. false keeps the checkout.
+     */
+    pull: z.union([z.string().regex(/^[^/]+\/.+$/, "Use remote/branch, e.g. origin/main"), z.literal(false)]).default("origin/main")
   }).default({})
 }).default({});
 var bughuntersConfigSchema = z.object({
@@ -697,7 +702,7 @@ Agents
   bughunters publish [--issue <id>] [--dry-run]
   bughunters github sync
   bughunters worktrees clean
-  bughunters patrol [--once]
+  bughunters patrol [--once] [--force]
   bughunters replay <routine-id>
   bughunters issue list | dismiss <id> --reason "..." [--by name] | reopen <id>
   bughunters memory list [--role r] | add --role r "text" [--scope s]
@@ -772,10 +777,12 @@ var COMMAND_HELP = {
   --dry-run       write the reports to .bughunters/runs/publish/, and open nothing
   --issue <id>    publish this issue only
 `,
-  patrol: `bughunters patrol [--once]
+  patrol: `bughunters patrol [--once] [--force]
   Run the full cycle again and again: setup, explore, judge, teardown, fix, retest, publish.
   The fixer and GitHub steps run only when you turn them on.
+  A cycle runs only when the commit changed since the last full cycle. Otherwise it only syncs GitHub.
   --once          run one cycle, then stop
+  --force         run the first cycle also when the commit did not change
 `,
   github: `bughunters github sync
   Read the state of each PR and issue from GitHub. A closed PR becomes a lesson. An issue closed as not planned becomes a dismissal.
@@ -910,9 +917,9 @@ async function startApp(app, opts) {
         if (command2.readyWhen) {
           const ready = new RegExp(command2.readyWhen);
           await new Promise((done, reject) => {
-            const wait = setTimeout(() => finish(new Error("timed out waiting for ready output")), command2.timeoutMs);
+            const wait2 = setTimeout(() => finish(new Error("timed out waiting for ready output")), command2.timeoutMs);
             const finish = (error) => {
-              clearTimeout(wait);
+              clearTimeout(wait2);
               child.stdout?.off("data", check);
               child.stderr?.off("data", check);
               child.off("exit", onExit);
@@ -3227,12 +3234,12 @@ function stepWords(step) {
 }
 
 // ../agents/dist/github.js
-var defaultGh = (args2, opts) => new Promise((resolve10, reject) => {
+var defaultGh = (args2, opts) => new Promise((resolve11, reject) => {
   const child = execFile2("gh", args2, { cwd: opts?.cwd, maxBuffer: 16 * 1024 * 1024 }, (error, stdout, stderr) => {
     if (error)
       reject(Object.assign(error, { stderr, stdout }));
     else
-      resolve10(stdout.trim());
+      resolve11(stdout.trim());
   });
   child.stdin?.end(opts?.input);
 });
@@ -4851,7 +4858,7 @@ async function actWhenReady(driver, action, session, windowMs) {
     if (result3.ok || !retry || Date.now() >= deadline || session.cancelled) {
       return { ...result3, degraded };
     }
-    await new Promise((resolve10) => setTimeout(resolve10, 500));
+    await new Promise((resolve11) => setTimeout(resolve11, 500));
   }
 }
 function toAction(step, session) {
@@ -6952,7 +6959,7 @@ var MaestroDriver = class {
     await this.run([`openLink: ${yamlString(action.url)}`]);
   }
   async wait(action) {
-    await new Promise((resolve10) => setTimeout(resolve10, action.ms));
+    await new Promise((resolve11) => setTimeout(resolve11, action.ms));
   }
   async switchWindow() {
     throw new Error("Window switching is unsupported on mobile");
@@ -7013,7 +7020,7 @@ var MaestroDriver = class {
         return { frames, stable: true };
       }
       previous = current;
-      await new Promise((resolve10) => setTimeout(resolve10, interval));
+      await new Promise((resolve11) => setTimeout(resolve11, interval));
     }
     return { frames, stable: false };
   }
@@ -7952,9 +7959,75 @@ ${items.map((item) => `${item.issue.id}: ${item.issue.title}`).join("\n")}`),
 }
 
 // ../agents/dist/patrol.js
+import { execFile as execFile6 } from "node:child_process";
+import { resolve as resolve9 } from "node:path";
+import { promisify as promisify6 } from "node:util";
+var exec5 = promisify6(execFile6);
+async function git4(cwd, ...args2) {
+  return (await exec5("git", args2, { cwd })).stdout.trim();
+}
+async function pullSource(root2, config, onLog) {
+  const target = config.agents.patrol.pull;
+  if (!target)
+    return false;
+  const slash = target.indexOf("/");
+  const remote = target.slice(0, slash);
+  const branch = target.slice(slash + 1);
+  const source = resolve9(root2, config.app.source);
+  try {
+    if (await git4(source, "status", "--porcelain", "--untracked-files=no")) {
+      onLog?.(`Did not pull ${target}: the source repository has uncommitted changes.`);
+      return false;
+    }
+    await git4(source, "fetch", "-q", remote, `+refs/heads/${branch}:refs/remotes/${remote}/${branch}`);
+    await git4(source, "checkout", "-q", "--detach", `${remote}/${branch}`);
+    onLog?.(`Pulled ${target} at ${await git4(source, "rev-parse", "--short", "HEAD")}.`);
+    return true;
+  } catch (error) {
+    const reason = error.stderr?.trim() || error.message;
+    onLog?.(`Did not pull ${target}: ${reason}. The cycle uses the current checkout.`);
+    return false;
+  }
+}
+async function sourceCommit(root2, config) {
+  const source = resolve9(root2, config.app.source);
+  try {
+    if (await git4(source, "status", "--porcelain", "--untracked-files=no"))
+      return void 0;
+    return await git4(source, "rev-parse", "HEAD");
+  } catch {
+    return void 0;
+  }
+}
+function alive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function wait(minutes) {
+  return new Promise((done) => {
+    const finish = () => {
+      clearTimeout(timer);
+      process.off("SIGINT", finish);
+      process.off("SIGTERM", finish);
+      done();
+    };
+    const timer = setTimeout(finish, minutes * 6e4);
+    process.once("SIGINT", finish);
+    process.once("SIGTERM", finish);
+  });
+}
 async function runPatrol(options) {
   const { root: root2, config } = options;
   const workspace = new Workspace(root2);
+  const previous = (await workspace.readAgents()).patrol;
+  if (previous?.state === "running" && previous.pid && previous.pid !== process.pid && alive(previous.pid)) {
+    options.onLog?.(`A patrol already runs (pid ${previous.pid}): did not start another.`);
+    return;
+  }
   const runtime = options.createRuntime ?? createRuntime;
   let interrupted = false;
   let activeSession;
@@ -7964,6 +8037,11 @@ async function runPatrol(options) {
       activeSession.cancelled = true;
     }
   };
+  const idle = () => workspace.setPatrol({
+    state: "stopped",
+    nextAt: new Date(Date.now() + config.agents.patrol.intervalMinutes * 6e4).toISOString()
+  });
+  let tested = options.force ? void 0 : previous?.commit;
   process.on("SIGINT", onSignal);
   process.on("SIGTERM", onSignal);
   try {
@@ -7971,10 +8049,24 @@ async function runPatrol(options) {
       if (config.agents.patrol.cycles && cycle > config.agents.patrol.cycles) {
         break;
       }
+      if (cycle > 1) {
+        await wait(config.agents.patrol.intervalMinutes);
+        if (interrupted)
+          break;
+      }
       await workspace.setPatrol({ state: "running", cycle, startedAt: (/* @__PURE__ */ new Date()).toISOString() });
+      await pullSource(root2, config, options.onLog);
       if (config.agents.github.enabled)
         await syncGitHub(root2, config, { onLog: options.onLog });
       await cleanWorktrees(root2, config, { onLog: options.onLog });
+      const commit = await sourceCommit(root2, config);
+      if (commit && commit === tested) {
+        options.onLog?.(`No new commit since the last cycle (${commit.slice(0, 7)}): skipped the cycle.`);
+        await idle();
+        if (options.once)
+          break;
+        continue;
+      }
       for (const role of ["explorer", "judge", "fixer"]) {
         if (!config.agents[role].enabled) {
           await workspace.setAgentStatus(role, { state: "off" });
@@ -8044,26 +8136,17 @@ async function runPatrol(options) {
         });
       if (!interrupted && config.agents.github.enabled)
         await syncGitHub(root2, config, { onLog: options.onLog });
-      const nextAt = new Date(Date.now() + config.agents.patrol.intervalMinutes * 6e4).toISOString();
-      await workspace.setPatrol({ state: "stopped", nextAt });
+      if (!interrupted && commit) {
+        tested = commit;
+        await workspace.setPatrol({ commit });
+      }
+      await idle();
       if (options.once || interrupted) {
         break;
       }
-      await new Promise((done) => {
-        const finish = () => {
-          clearTimeout(timer);
-          process.off("SIGINT", stop);
-          process.off("SIGTERM", stop);
-          done();
-        };
-        const timer = setTimeout(finish, config.agents.patrol.intervalMinutes * 6e4);
-        const stop = () => finish();
-        process.once("SIGINT", stop);
-        process.once("SIGTERM", stop);
-      });
     }
   } finally {
-    await workspace.setPatrol({ state: "stopped" });
+    await workspace.setPatrol({ state: "stopped", nextAt: void 0 });
     process.off("SIGINT", onSignal);
     process.off("SIGTERM", onSignal);
   }
@@ -8243,9 +8326,9 @@ var JEV_ROUTES2 = {
 };
 var CLI_LABELS = { claude: "Claude Code", codex: "Codex", kimi: "Kimi CLI", pi: "pi" };
 var run = (command2, args2) => spawnSync2(command2, args2, { encoding: "utf8", timeout: 1e4 }).stdout ?? "";
-function detectProviders(env = process.env, exec5 = run) {
+function detectProviders(env = process.env, exec6 = run) {
   const found = CLI_AGENTS.filter((agent) => onPath(agent, env));
-  const piList = found.includes("pi") ? exec5("pi", ["list"]) : "";
+  const piList = found.includes("pi") ? exec6("pi", ["list"]) : "";
   const piWithoutMcp = found.includes("pi") && !piList.includes("pi-mcp-adapter");
   return {
     clis: found.filter((agent) => agent !== "pi" || !piWithoutMcp),
@@ -9215,7 +9298,7 @@ function bodyMentions(body, selector) {
 async function stopProcess(child) {
   if (child.exitCode !== null || child.pid === void 0)
     return;
-  const done = new Promise((resolve10) => child.once("exit", () => resolve10()));
+  const done = new Promise((resolve11) => child.once("exit", () => resolve11()));
   try {
     process.kill(-child.pid, "SIGTERM");
   } catch {
@@ -10241,7 +10324,7 @@ function formatRunSummary(result3) {
 // ../dashboard/dist/server.js
 import { createServer as createServer2 } from "node:http";
 import { createReadStream, existsSync as existsSync10, realpathSync, statSync as statSync2, watch } from "node:fs";
-import { extname, join as join18, relative as relative4, resolve as resolve9, sep as sep3 } from "node:path";
+import { extname, join as join18, relative as relative4, resolve as resolve10, sep as sep3 } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // ../dashboard/dist/project.js
@@ -10859,7 +10942,7 @@ function hostOf(href) {
 }
 
 // ../dashboard/dist/server.js
-var UI_DIR = resolve9(fileURLToPath(new URL(".", import.meta.url)), "..", "src", "ui");
+var UI_DIR = resolve10(fileURLToPath(new URL(".", import.meta.url)), "..", "src", "ui");
 var MIME = {
   ".html": "text/html; charset=utf-8",
   ".js": "text/javascript; charset=utf-8",
@@ -10870,7 +10953,7 @@ var MIME = {
   ".json": "application/json; charset=utf-8"
 };
 async function startDashboard(options) {
-  const root2 = resolve9(options.root);
+  const root2 = resolve10(options.root);
   const host = options.host ?? "127.0.0.1";
   const reader = new ProjectReader(root2);
   const agents = new AgentReader(root2);
@@ -10965,7 +11048,7 @@ async function handle2(req, res, ctx) {
   return serveUi(res, path);
 }
 function resolveArtifactPath(root2, requested) {
-  const candidate = resolve9(root2, requested);
+  const candidate = resolve10(root2, requested);
   if (!existsSync10(candidate))
     return void 0;
   let real;
@@ -10998,7 +11081,7 @@ function serveArtifact(res, root2, requested) {
 }
 function serveUi(res, path) {
   const name = path === "/" ? "index.html" : path.replace(/^\//, "");
-  const file = resolve9(UI_DIR, name);
+  const file = resolve10(UI_DIR, name);
   if (!file.startsWith(UI_DIR) || !existsSync10(file) || !statSync2(file).isFile()) {
     return serveUi(res, "/");
   }
@@ -11137,8 +11220,8 @@ function parseAgentFlags(command2, args2) {
     throw new ConfigError(`Unknown agent command ${command2}`);
   for (let index = 0; index < args2.length; index++) {
     const flag2 = args2[index];
-    if (command2 === "patrol" && flag2 === "--once") {
-      flags.once = true;
+    if (command2 === "patrol" && (flag2 === "--once" || flag2 === "--force")) {
+      flags[flag2.slice(2)] = true;
       continue;
     }
     if (command2 === "publish" && flag2 === "--dry-run") {
@@ -11200,7 +11283,7 @@ async function runAgentCommand(command2, args2, root2, config, log) {
     log(line);
   const workspace = new Workspace(root2);
   if (command2 === "patrol") {
-    await runPatrol({ root: root2, config, once: Boolean(flags.once), onLog: log });
+    await runPatrol({ root: root2, config, once: Boolean(flags.once), force: Boolean(flags.force), onLog: log });
     return;
   }
   if (command2 === "publish") {
@@ -11449,7 +11532,7 @@ var [command, ...args] = process.argv.slice(2);
 var root = findProjectRoot(process.cwd());
 function version() {
   if (true)
-    return "0.1.0";
+    return "0.1.1";
   try {
     return JSON.parse(readFileSync10(new URL("../package.json", import.meta.url), "utf8")).version;
   } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bughunters",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "AI agents that explore your app, find bugs, and fix them.",
   "license": "Apache-2.0",
   "type": "module",

package/src/ui/app.js

@@ -562,7 +562,7 @@ function renderOverview() {
       data.patrol?.nextAt ? el('p', { class: 'muted',
         text: `Next patrol at ${new Date(data.patrol.nextAt).toLocaleTimeString([], {
           hour: '2-digit', minute: '2-digit',
-        })}`,
+        })}${data.patrol.commit ? ` · last tested commit ${data.patrol.commit.slice(0, 7)}` : ''}`,
       }) : null,
     ]),
   ]);