breakaway 1.0.2-main.5 → 1.0.2-main.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "breakaway",
-  "version": "1.0.2-main.5",
+  "version": "1.0.2-main.7",
   "description": "The task board for you and your coding agents: a Cloudflare Worker, its web app, Taskwarrior sync, and the CLI (npx breakaway).",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",

package/scripts/tasks/cli.js

@@ -7,6 +7,7 @@ import { CLI_PACKAGE } from './init.js';
 /** The subcommands each command knows. Without one, each lists or shows (horizon needs close). */
 export const SUBCOMMANDS = {
   agents: ['next', 'start', 'refine'],
+  github: ['fix', 'review'],
   repos: ['add', 'init', 'modify', 'remove', 'setup'],
   routines: ['add', 'modify', 'run', 'trigger', 'revoke', 'pause', 'resume'],
   horizon: ['close'],
@@ -18,7 +19,6 @@ export const NO_ARGUMENTS = new Set([
   'list',
   'next',
   'activity',
-  'github',
   'health',
   'connections',
   'export',
@@ -74,6 +74,45 @@ export function githubRequest(repo, { sync = false } = {}) {
   return ['GET', repo ? `github?repo=${encodeURIComponent(repo)}` : 'github', undefined];
 }
 
+/** What `github fix` accepts for --problem: the same three the pull request page offers. */
+export const FIX_PROBLEMS = ['conflicts', 'failing', 'review'];
+
+/**
+ * The request behind `npx breakaway github fix <n>` and `github review <n>` (BRK-81): the pull request page's "Fix with an
+ * agent" and "Safe to merge?" buttons (`POST github/pulls/<n>/fix` and `/review`). It names the checkout's repository
+ * like `github` does. Returns an error message instead when the number or `problem` can't be right.
+ * @param {'fix' | 'review'} action
+ * @param {string | number | undefined} number
+ * @param {{ repo?: string | null, problem?: string, note?: string }} [options]
+ * @returns {{ error?: string, request?: [string, string, Record<string, string>] }}
+ */
+export function pullAgentRequest(action, number, { repo = null, problem, note } = {}) {
+  const n = String(number ?? '').replace(/^#/u, '');
+  if (!/^[1-9]\d{0,8}$/u.test(n)) return { error: `say which pull request: npx breakaway github ${action} <number>` };
+  if (problem !== undefined && action !== 'fix') return { error: '--problem is for github fix' };
+  if (problem !== undefined && !FIX_PROBLEMS.includes(problem))
+    return { error: `--problem is ${FIX_PROBLEMS.join(', ')}` };
+  const body = {
+    ...(repo ? { repo } : {}),
+    ...(problem ? { problem } : {}),
+    ...(typeof note === 'string' && note.trim() ? { note } : {}),
+  };
+  return { request: ['POST', `github/pulls/${n}/${action}`, body] };
+}
+
+/**
+ * What the CLI says about an answer to those requests: which task and agent took the pull request, or who already has it.
+ * @param {'fix' | 'review'} action
+ * @param {string | number} number
+ * @param {{ task: { wid?: string, short?: string }, run?: { url?: string, agent?: string } | null, already?: string | null }} answer
+ */
+export function pullAgentSummary(action, number, { task, run, already }) {
+  const id = task.wid ?? task.short;
+  if (!run) return `${id} already has it: ${already}.`;
+  const what = action === 'fix' ? `fixing #${number}` : `testing #${number}`;
+  return `Started ${run.agent ? `${run.agent}, ` : 'an agent '}${what} on ${id}${run.url ? `: ${run.url}` : ''}`;
+}
+
 /**
  * The task an idea becomes (`npx breakaway idea`): its first line, kept short, as the title, and the whole text as its
  * description. Like `add`, it lands in the repository of the checkout it was written in (BRK-71): without one, the

package/scripts/tasks.mjs

@@ -44,7 +44,14 @@ import { sessionProxy, routeThroughSessionProxy } from './tasks/proxy.js';
 import { githubFromRemote, inRepo, pickRepo } from './tasks/repo.js';
 import { NO_TERMINAL, ask as askIn } from './tasks/ask.js';
 import { CLI_PACKAGE, PROMPT_SECTIONS, initPlan, machineTaskrc, promptSections } from './tasks/init.js';
-import { githubRequest, ideaTask, staleCliWarning, unknownSubcommand } from './tasks/cli.js';
+import {
+  githubRequest,
+  ideaTask,
+  pullAgentRequest,
+  pullAgentSummary,
+  staleCliWarning,
+  unknownSubcommand,
+} from './tasks/cli.js';
 import { CLI_VERSION } from '../src/cli-version.js';
 import { LEGACY, parseInstall, secretName } from '../src/install.js';
 import {
@@ -143,6 +150,8 @@ Reading                (list, next, claim, and add work in this checkout's repos
   routines               saved prompts the owner runs with a button, and their caps
   routines run <slug>    run one now: makes a RUN task and starts an agent on it  [--note <text>]
   horizon close          close now: finished tasks go to the archive, next becomes now, later becomes next  [--dry-run]
+  github fix <n>         start an agent on a pull request's conflicts, failing checks, or review comments (owner)  [--problem conflicts|failing|review] [--note <text>] [--repo <slug>]
+  github review <n>      start an agent that tests a Dependabot pull request, as Safe to merge? does (owner)  [--note <text>] [--repo <slug>]
   github                 the checkout's repository on GitHub: open pull requests, checks, reviews, CI, deploys, alerts  [--sync] [--repo <slug>]
   hook session|wait      the Claude Code session hooks a repository's .claude/settings.json runs (npx breakaway hook session)
   health                 the server's state
@@ -1188,6 +1197,18 @@ const commands = {
     );
   },
   async github() {
+    const action = args[0];
+    if (action === 'fix' || action === 'review') {
+      const built = pullAgentRequest(action, args[1], {
+        repo: (await checkoutRepo()).slug,
+        problem: opts.problem,
+        note: opts.note,
+      });
+      if (built.error || !built.request) fail(built.error ?? 'bad request');
+      const answer = await call(...built.request);
+      print(answer, (a) => pullAgentSummary(action, args[1].replace(/^#/u, ''), a));
+      return;
+    }
     const g = await call(...githubRequest((await checkoutRepo()).slug, { sync: Boolean(opts.sync) }));
     print(g, (d) => {
       if (!d.connected) return "GitHub isn't connected yet: open the GitHub view on the board (docs/tasks.md#github).";

package/src/cli-version.js

@@ -5,5 +5,5 @@
  * bump CLI_VERSION and set CLI_FINGERPRINT to the value it prints. Constants only: the board's Worker imports it,
  * so it lives in the board's package (CLD-135) and the CLI imports it from here.
  */
-export const CLI_VERSION = 38;
-export const CLI_FINGERPRINT = 'e5cf577cb5354653';
+export const CLI_VERSION = 39;
+export const CLI_FINGERPRINT = '15250a95aca206af';