runbot-next 0.1.0 → 0.1.1

package/README.md

@@ -1,45 +1,67 @@
 # runbot-next
 
-Bun CLI and reusable function definitions for reading public Odoo Runbot pages.
+Fast local console for public Odoo Runbot pages.
 
-The core functions live in `src/runbot/tools.ts`. Each tool has:
+Runbot Next gives you a focused UI for branches, batches, builds, logs, and test failures without asking the browser to scrape Runbot directly. The local server fetches Runbot HTML, parses it, and serves the app plus API from one port.
 
-- `name`
-- `summary`
-- `description`
-- Zod `inputSchema`
-- async `handler`
+![Runbot Next app screenshot](docs/assets/runbot-next-app.png)
 
-That single definition list is used by the CLI and can also be adapted for MCP or oRPC via `src/adapters`.
+## Run
 
-## Usage
+```sh
+npx runbot-next
+```
 
-Run the web app locally from the published package:
+or:
 
 ```sh
-npx runbot-next
 bunx runbot-next
 ```
 
-Use `PORT` to choose a port:
+The server starts on `http://127.0.0.1:3000`. If the port is busy, it tries the next available port, up to 100 ports.
+
+Use `PORT` to choose the starting port:
 
 ```sh
 PORT=5173 npx runbot-next
-PORT=5173 bunx runbot-next
 ```
 
-Develop or use the CLI from the repo:
+## Features
+
+- Browse Runbot projects, branches, and batches.
+- Open build slots, commits, logs, and run links quickly.
+- Parse visible test failures from Runbot logs.
+- Record proxied Runbot traffic while debugging.
+- Runs locally through `npx` or `bunx`.
+
+## Develop
 
 ```sh
 bun install
+bun run dev
+PORT=3001 bun run serve
+```
+
+For production-package checks:
+
+```sh
+bun run build
+bun run build:server
+npm pack --dry-run
+```
+
+## CLI
+
+The reusable tool definitions live in `src/runbot/tools.ts`.
+
+```sh
 bun run src/cli.ts projects
 bun run src/cli.ts batches /runbot/rd-1 --search master
 bun run src/cli.ts batch 2526059 --json
 bun run src/cli.ts build 110606813
 bun run src/cli.ts tests --batch 2413720 --slot "Enterprise Tests" --unparsed
-bun run src/cli.ts link 110606813 log run
 ```
 
-## Notes
+## Note
 
-Runbot's public pages are server-rendered HTML. The tool parses public links and text from those pages instead of relying on a JSON API.
+Runbot public pages are server-rendered HTML. This app intentionally uses a local server because Runbot does not expose permissive browser CORS headers for direct client-side scraping.

package/dist-server/runbot-next.js

@@ -5136,7 +5136,8 @@ class TrafficRecorder {
 }
 
 // src/server-node.ts
-var port = Number(process.env.PORT ?? 3000);
+var initialPort = Number(process.env.PORT ?? 3000);
+var maxPortAttempts = 100;
 var host = process.env.HOST ?? "127.0.0.1";
 var procedures = toOrpcProcedures();
 var traffic = new TrafficRecorder;
@@ -5188,10 +5189,10 @@ function sendStatic(response, pathname) {
   });
   createReadStream(resolved).pipe(response);
 }
-createServer(async (request, response) => {
+async function handleRequest(request, response) {
   if (request.method === "OPTIONS")
     return sendJson(response, {});
-  const url = new URL(request.url ?? "/", `http://${request.headers.host ?? `${host}:${port}`}`);
+  const url = new URL(request.url ?? "/", `http://${request.headers.host ?? `${host}:${initialPort}`}`);
   if (url.pathname === "/orpc/tools") {
     return sendJson(response, Object.keys(procedures).map((name) => ({ name })));
   }
@@ -5218,6 +5219,23 @@ createServer(async (request, response) => {
     }
   }
   return sendStatic(response, url.pathname);
-}).listen(port, host, () => {
-  console.log(`Runbot Next listening on http://${host}:${port}`);
-});
+}
+function listen(port, attemptsLeft = maxPortAttempts) {
+  const server = createServer(handleRequest);
+  server.once("error", (error) => {
+    if (error.code === "EADDRINUSE" && attemptsLeft > 0) {
+      server.close();
+      listen(port + 1, attemptsLeft - 1);
+      return;
+    }
+    if (error.code === "EADDRINUSE") {
+      console.error(`No available port found from ${initialPort} to ${initialPort + maxPortAttempts}.`);
+      process.exit(1);
+    }
+    throw error;
+  });
+  server.listen(port, host, () => {
+    console.log(`Runbot Next listening on http://${host}:${port}`);
+  });
+}
+listen(initialPort);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runbot-next",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "private": false,
   "bin": {
@@ -9,7 +9,8 @@
   "files": [
     "dist",
     "dist-server",
-    "README.md"
+    "README.md",
+    "docs/assets/runbot-next-app.png"
   ],
   "scripts": {
     "dev": "vite --host 127.0.0.1",