@aldotestino/autoland 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aldotestino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,110 @@
-# Temporary Holding Version
+# autoland
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Update, approve if needed, and merge a batch of pull requests in order, one at a time. Built with
+[Effect](https://effect.website) and Bun.
+
+## Install
+
+```bash
+npm install -g @aldotestino/autoland
+```
+
+Runs on macOS and glibc Linux, on arm64 and x64. npm installs only the compiled binary for your platform (about 42-52 MB to download). Bun is not needed, and Node.js is only used to start it.
+
+Requires authenticated `gh` and `git`. Repair also requires `opencode` and SSH access to the PR repositories. Run it from the target repository.
+
+## Merge a batch of PRs
+
+After triage, pass the PR numbers or GitHub URLs:
+
+```bash
+autoland --dry-run 125 123 124
+autoland 125 123 124
+printf '125, 123\n124\n' | autoland
+autoland --label agent:ok-to-merge --label agent
+autoland
+```
+
+| Option                           | Effect                                            |
+| -------------------------------- | ------------------------------------------------- |
+| `--method squash\|merge\|rebase` | Merge method (default: `squash`)                  |
+| `--timeout SECONDS`              | Maximum wait per PR (default: `1800`)             |
+| `--label LABEL`                  | Require this label (repeatable; all must match)   |
+| `--dry-run`                      | Read-only preview; no updates, merges, or repairs |
+| `--yes`                          | Skip the initial batch confirmation               |
+| `--non-interactive`              | Skip all prompts and leave conflicts unmerged     |
+
+Run it in a terminal with no PRs and no `--label` to choose from a checkbox list of every open PR that is not a draft. Use the arrow keys or `j`/`k` to move, space to toggle, `a` to select or clear all, Enter to confirm, and `q` or Esc to cancel. Other options such as `--dry-run` and `--method` still apply. Your selection then goes through the usual batch confirmation unless you pass `--yes`. `--non-interactive` never shows the list, and piped input is always treated as the PR list. Prompts read from the controlling terminal, so a piped list does not consume their answers.
+
+PRs are deduplicated and processed in ascending numeric order. The tool updates branches that are behind their base, waits for required checks, and uses squash merges by default. Each PR must finish merging before the next PR starts, including when GitHub uses a merge queue. Branch protections are not bypassed.
+
+Before merging, it checks each reviewer's current vote. If no current approval exists, it submits an approval as your authenticated `gh` account, pinned to the checked commit. Existing approvals are not duplicated. Outstanding change requests or approval failures leave the PR unmerged. GitHub does not allow you to approve your own PR. Dry runs do not approve.
+
+The order is **update or repair → wait for required checks → approve if needed → merge**. There is no approval check before an update or conflict repair. Branches are compared against the live base branch tip, not the base SHA stored in the PR response. Approval is checked only for the merge-ready commit. If the base moves during a merge attempt, the tool retries the update instead of skipping the PR.
+
+In a terminal, each action uses a single-line spinner that becomes a green checkmark or red X when it finishes. Redirected output and dumb terminals use plain text; `NO_COLOR` disables color without disabling animation.
+
+Repeat `--label` to require **all** specified labels. Without a PR list, all matching open PRs are found across all pages. With a PR list, only matching PRs from that list are processed. Labels are checked again before each update or merge attempt. If no PRs match, it exits without changes.
+
+## Conflicts
+
+On a conflict, it sends a Ghostty desktop notification and offers OpenCode repair, retry, skip, or quit. Ghostty must have permission to send desktop notifications.
+
+Repair creates a separate worktree, leaving your checkout alone, and runs an OpenCode session there through the [Effect client](https://opencode.ai/v2/docs/build/client/effect/), starting the local background service if needed:
+
+- The session runs unattended, with the spinner showing it is working. To watch or take over, run the `opencode <worktree> --session <id>` command it prints from another terminal.
+- OpenCode's permission requests appear as prompts here. They can also be answered in an attached OpenCode UI.
+- Questions that only OpenCode's UI can show are announced with that same command. The session waits until they are answered.
+- Ctrl-C interrupts the session as well as the batch, so the agent does not keep pushing to the PR.
+- When the session finishes, its report is printed and you are asked to review the repair. The batch rechecks GitHub only once you confirm; declining returns to the conflict menu.
+
+Repair worktrees are kept for review; remove them with `git worktree remove <path>` when no longer needed.
+
+## Failure and exit status
+
+Failed checks, closed PRs, drafts, and other blocked PRs are reported, then the batch continues. If a requested merge has not finished by the wait limit, the batch stops to preserve order. Rerunning a batch skips PRs that are already merged.
+
+| Status | Meaning                               |
+| ------ | ------------------------------------- |
+| `0`    | Done, or nothing to do                |
+| `1`    | A PR was left unmerged                |
+| `2`    | Invalid input or unusable environment |
+| `130`  | Interrupted (`143` for `SIGTERM`)     |
+
+## Development
+
+```bash
+bun install
+bun link                   # puts this checkout on your PATH as `autoland`
+bun run build              # a binary for this machine, at dist/autoland
+bun run autoland --help    # from this directory, so it targets this repository
+bun run test
+bun run typecheck
+bun run lint
+bun run fmt
+```
+
+`effect`, `@effect/*`, and `@effect/platform-node-shared` are pinned to the exact version that `@opencode/client` requires as a peer. Upgrade them together.
+
+| File                      | Responsibility                              |
+| ------------------------- | ------------------------------------------- |
+| `src/cli.ts`              | Command definition, layers, exit status     |
+| `src/batch.ts`            | Input resolution and the batch loop         |
+| `src/merge-pr.ts`         | The state machine for one PR                |
+| `src/github.ts`           | `gh` calls and response schemas             |
+| `src/repair.ts`           | Worktree setup for a conflict repair        |
+| `src/opencode.ts`         | OpenCode sessions through the Effect client |
+| `src/picker.ts`           | The PR checkbox list                        |
+| `src/tty.ts`              | Prompts on the controlling terminal         |
+| `src/ui.ts`               | Output and the status line                  |
+| `scripts/npm-packages.ts` | The manifests of what gets published        |
+| `scripts/build-npm.ts`    | Compiles every platform into `dist/npm`     |
+| `scripts/launcher.cjs`    | The published `autoland` command            |
+
+## Releasing
+
+Add a changeset with `bun run changeset` and commit it with your change. Merging to `main` opens or updates a `chore: version packages` PR, and merging that PR publishes to npm with no token, through [trusted publishing](https://docs.npmjs.com/trusted-publishers). See [`.changeset/README.md`](.changeset/README.md).
+
+The repository holds one package, tagged `vX.Y.Z`. npm receives five, all generated by `bun run build:npm` at release time: `@aldotestino/autoland`, which contains only the launcher, and `@aldotestino/autoland-{darwin,linux}-{arm64,x64}`, which contain the binaries. The source is not published.
+
+A trusted publisher can only be added to a package that already exists, so [`scripts/bootstrap-npm.sh`](scripts/bootstrap-npm.sh) does that once, by hand. Run it again if a platform is added.

package/bin/autoland.cjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+// The `autoland` command. npm installs only the optional dependency matching this
+// platform, and this starts its compiled binary. Node is only needed for this file.
+"use strict";
+// This runs on plain Node before anything else, so Effect's rules cannot apply.
+// oxlint-disable effecttsgo/global-console, effecttsgo/node-builtin-import
+
+const { spawn } = require("node:child_process");
+
+const name = `@aldotestino/autoland-${process.platform}-${process.arch}`;
+
+let binary;
+try {
+  binary = require.resolve(`${name}/bin/autoland`);
+} catch {
+  console.error(
+    `autoland: ${name} is not installed.\n` +
+      "Supported platforms are macOS and glibc Linux, on arm64 and x64.\n" +
+      "On a supported platform, reinstall without omitting optional dependencies.",
+  );
+  process.exit(1);
+}
+
+const child = spawn(binary, process.argv.slice(2), { stdio: "inherit" });
+
+// Stay alive until the binary has cleaned up, so its exit status is the one reported.
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(signal, () => {
+    child.kill(signal);
+  });
+}
+
+child.on("error", (error) => {
+  console.error(`autoland: cannot start ${binary}: ${error.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal === null) process.exit(code ?? 1);
+  process.removeAllListeners(signal);
+  process.kill(process.pid, signal);
+});

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@aldotestino/autoland",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "description": "Land a batch of pull requests in order, one at a time: update, wait for checks, approve, merge.",
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aldotestino/autoland.git"
+  },
+  "homepage": "https://github.com/aldotestino/autoland#readme",
+  "bugs": {
+    "url": "https://github.com/aldotestino/autoland/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "autoland": "bin/autoland.cjs"
+  },
+  "files": [
+    "bin"
+  ],
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "optionalDependencies": {
+    "@aldotestino/autoland-darwin-arm64": "0.1.0",
+    "@aldotestino/autoland-darwin-x64": "0.1.0",
+    "@aldotestino/autoland-linux-arm64": "0.1.0",
+    "@aldotestino/autoland-linux-x64": "0.1.0"
+  }
+}