pulls.review 0.2.0 → 0.3.0

package/dist/devframe.mjs

@@ -0,0 +1,2 @@
+import { t as devframe_default } from "./devframe-D66W-pHy.mjs";
+export { devframe_default as default };

package/dist/index.mjs

@@ -0,0 +1,110 @@
+import { t as devframe_default } from "./devframe-D66W-pHy.mjs";
+import { readFile } from "node:fs/promises";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+import { createDevServer } from "devframe/adapters/dev";
+import { H3 } from "h3";
+import { isLocalBranch, parseTarget, readCurrentBranch, resolveDefaultBranch } from "@pulls.review/core/local";
+import { parseGithubUrl } from "@pulls.review/core/github";
+//#region src/page.ts
+/** The site's `/gh/...` routes, which the `PR_LOCAL` build serves too. */
+function githubPage(location) {
+	const repo = `/gh/${location.owner}/${location.repo}`;
+	switch (location.kind) {
+		case "github-pr": return `${repo}/${location.number}`;
+		case "github-compare": return `${repo}/compare/${location.base}...${location.head}`;
+		case "github-commit": return `${repo}/commit/${location.sha}`;
+		case "github-repo": return repo;
+	}
+}
+/** The page an argument opens (see the app's local routes). */
+async function pageFor(cwd, arg, worktree) {
+	if (worktree) return "/worktree";
+	if (!arg) {
+		const [current, defaultBranch] = await Promise.all([readCurrentBranch(cwd), resolveDefaultBranch(cwd)]);
+		return current && defaultBranch && current !== defaultBranch.name ? `/branch/${current}` : "/";
+	}
+	const github = parseGithubUrl(arg);
+	if (github) return githubPage(github);
+	if (parseTarget(arg).kind === "range") return `/compare/${arg}`;
+	return await isLocalBranch(cwd, arg) ? `/branch/${arg}` : `/commit/${arg}`;
+}
+//#endregion
+//#region src/index.ts
+const HELP = `Usage: pulls.review [target] [options]
+
+Reviews local git changes - or any GitHub pull request - in the browser, grouped
+and summarized. Run it inside a git repository. The target only picks the page
+that opens; any other can be picked from the browser.
+
+Target (git revision syntax):
+  (none)     the current branch against the default branch, or the ref picker
+             when the default branch itself is checked out
+  <branch>   what a branch adds since it forked from the default branch
+  <rev>      one commit against its parent
+  A...B      what B adds since it forked from A
+  A..B       the tree diff between two revisions
+
+Target (GitHub):
+  owner/repo#123, or a github.com pull request, compare, commit or repo URL.
+  Uses the GitHub token from GITHUB_TOKEN, else from \`gh auth token\`.
+
+AI analysis uses a key from Settings, or a coding agent installed here (Claude
+Code, OpenCode) when "Local agent" is the provider in Settings.
+
+Options:
+  --worktree     open the uncommitted changes against HEAD
+  --port <port>  port to listen on
+  --no-open      do not open the browser
+  -h, --help
+
+To analyze a GitHub pull request from CI, use @pulls.review/actions.
+`;
+/**
+* devframe's SPA fallback skips any path that looks like a file, and refs do: `main...feat`
+* ends in `.feat`, `v1.2` in `.2`. Pages whose path carries a ref (local ones, and GitHub
+* compares under `/gh/`) get the SPA's `index.html` here, before devframe's static handler sees them.
+*/
+function createAppWithRefRoutes() {
+	const app = new H3();
+	const index = fileURLToPath(new URL("./client/index.html", import.meta.url));
+	app.use(async (event, next) => {
+		if (!/^\/(?:compare|branch|commit|gh)\//.test(event.url.pathname) || !event.req.headers.get("accept")?.includes("text/html")) return next();
+		return new Response(await readFile(index, "utf8"), { headers: { "Content-Type": "text/html; charset=utf-8" } });
+	});
+	return app;
+}
+async function main() {
+	const { values: flags, positionals } = parseArgs({
+		options: {
+			"worktree": { type: "boolean" },
+			"port": { type: "string" },
+			"no-open": { type: "boolean" },
+			"help": {
+				type: "boolean",
+				short: "h"
+			}
+		},
+		allowPositionals: true
+	});
+	if (flags.help) {
+		process.stdout.write(HELP);
+		return;
+	}
+	const page = encodeURI(await pageFor(process.cwd(), positionals[0], !!flags.worktree));
+	await createDevServer(devframe_default, {
+		app: createAppWithRefRoutes(),
+		port: flags.port ? Number(flags.port) : void 0,
+		openBrowser: flags["no-open"] ? false : page,
+		onReady: ({ origin }) => {
+			process.stdout.write(`pulls.review is serving ${origin}${page}\n`);
+		}
+	});
+}
+main().catch((error) => {
+	console.error(error instanceof Error ? error.message : error);
+	process.exitCode = 1;
+});
+//#endregion
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pulls.review",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Review local git changes - the working tree, a commit or any range - grouped and summarized in the browser.",
   "author": "Anthony Fu <hi@antfu.me>",
   "license": "MIT",
@@ -34,13 +34,17 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@pulls.review/core": "^0.2.0",
+    "@pulls.review/core": "^0.3.0",
     "devframe": "^1.2.0",
     "h3": "^2.0.1-rc.32",
-    "unstorage": "^1.17.5"
+    "unstorage": "^1.17.5",
+    "valibot": "^1.5.0"
   },
   "devDependencies": {
+    "@earendil-works/pi-agent-core": "^0.87.1",
+    "@earendil-works/pi-ai": "^0.87.1",
     "@types/node": "^26.6.4",
+    "@valibot/to-json-schema": "^1.8.0",
     "tsdown": "^0.23.0",
     "typescript": "^6.0.3",
     "vitest": "^5.0.3"