@rumen.rusanov/pi-github 0.1.0

package/src/settings.ts

@@ -0,0 +1,58 @@
+import { readFile as fsReadFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+export const DEFAULT_FETCH_LIMIT = 20;
+
+interface PiGithubSettings {
+	fetchLimit?: unknown;
+}
+
+interface GetFetchLimitOptions {
+	cwd: string;
+	home?: string;
+	readFile?: (path: string) => Promise<string>;
+}
+
+async function readPiGithubSettings(
+	path: string,
+	readFile: (path: string) => Promise<string>,
+): Promise<PiGithubSettings | undefined> {
+	let content: string;
+	try {
+		content = await readFile(path);
+	} catch {
+		return undefined;
+	}
+
+	try {
+		const parsed = JSON.parse(content) as Record<string, unknown>;
+		const section = parsed["pi-github"];
+		if (section && typeof section === "object") {
+			return section as PiGithubSettings;
+		}
+		return undefined;
+	} catch {
+		return undefined;
+	}
+}
+
+function asPositiveInteger(value: unknown): number | undefined {
+	return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+
+/** Reads the `pi-github.fetchLimit` setting, project settings taking precedence over global. */
+export async function getFetchLimit(options: GetFetchLimitOptions): Promise<number> {
+	const readFile = options.readFile ?? ((path: string) => fsReadFile(path, "utf8"));
+	const home = options.home ?? homedir();
+
+	const globalPath = join(home, ".pi", "agent", "settings.json");
+	const projectPath = join(options.cwd, ".pi", "settings.json");
+
+	const [global, project] = await Promise.all([
+		readPiGithubSettings(globalPath, readFile),
+		readPiGithubSettings(projectPath, readFile),
+	]);
+
+	return asPositiveInteger(project?.fetchLimit) ?? asPositiveInteger(global?.fetchLimit) ?? DEFAULT_FETCH_LIMIT;
+}

package/src/types.ts

@@ -0,0 +1,106 @@
+export interface ExecResult {
+	stdout: string;
+	stderr: string;
+	code: number;
+	killed: boolean;
+}
+
+export interface ExecOptions {
+	signal?: AbortSignal;
+	timeout?: number;
+	cwd?: string;
+}
+
+export type ExecFn = (command: string, args: string[], options?: ExecOptions) => Promise<ExecResult>;
+
+export type Result<T> = { ok: true; data: T } | { ok: false; error: string };
+
+export interface Actor {
+	login: string;
+	name?: string;
+}
+
+export interface Label {
+	name: string;
+	color?: string;
+}
+
+export interface Comment {
+	author: string;
+	body: string;
+	createdAt: string;
+}
+
+export type CheckState = "pass" | "fail" | "pending";
+
+export interface CheckRun {
+	name: string;
+	state: CheckState;
+}
+
+export type ReviewState = "APPROVED" | "CHANGES_REQUESTED" | "COMMENTED" | "DISMISSED" | "PENDING";
+
+export interface Review {
+	author: string;
+	state: ReviewState;
+}
+
+export interface FileChange {
+	path: string;
+	additions: number;
+	deletions: number;
+}
+
+export interface PullRequestSummary {
+	number: number;
+	title: string;
+	author: string;
+	isDraft: boolean;
+	checkState: CheckState | "none";
+	approvals: number;
+	changesRequested: number;
+	updatedAt: string;
+}
+
+export interface IssueSummary {
+	number: number;
+	title: string;
+	author: string;
+	commentCount: number;
+	labels: string[];
+	updatedAt: string;
+}
+
+export interface PullRequestDetail {
+	number: number;
+	title: string;
+	author: string;
+	state: string;
+	isDraft: boolean;
+	labels: string[];
+	assignees: string[];
+	createdAt: string;
+	updatedAt: string;
+	body: string;
+	comments: Comment[];
+	baseRefName: string;
+	headRefName: string;
+	checks: CheckRun[];
+	reviews: Review[];
+	files: FileChange[];
+}
+
+export interface IssueDetail {
+	number: number;
+	title: string;
+	author: string;
+	state: string;
+	labels: string[];
+	assignees: string[];
+	createdAt: string;
+	updatedAt: string;
+	body: string;
+	comments: Comment[];
+}
+
+export type MergeMethod = "squash" | "merge" | "rebase";