dsh-pstack 0.3.0-beta.1 → 0.3.1

package/dist/pstack/skills/poteto-mode/scripts/watch-pr/github.mjs

@@ -1,626 +0,0 @@
-import { nonEmpty, parsePrNumber } from "./types.mjs";
-import { spawn } from "node:child_process";
-// runtime/skills/poteto-mode/scripts/watch-pr/github.ts
-const REVIEW_THREADS_QUERY = "\nquery ReviewThreads($owner: String!, $repo: String!, $pr: Int!, $after: String) {\n  repository(owner: $owner, name: $repo) {\n    pullRequest(number: $pr) {\n      reviewThreads(first: 100, after: $after) {\n        pageInfo {\n          hasNextPage\n          endCursor\n        }\n        nodes {\n          id\n          isResolved\n          comments(first: 10) {\n            nodes {\n              body\n              createdAt\n              path\n              line\n              author { login }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n";
-const PR_COMMIT_STATUS_QUERY = "\nquery PrCommitStatuses($owner: String!, $repo: String!, $pr: Int!) {\n  repository(owner: $owner, name: $repo) {\n    pullRequest(number: $pr) {\n      commits(last: 50) {\n        nodes {\n          commit {\n            oid\n            statusCheckRollup {\n              state\n            }\n          }\n        }\n      }\n    }\n  }\n}\n";
-const PR_CHECK_ROLLUP_QUERY = "\nquery PrCheckRollup($owner: String!, $repo: String!, $pr: Int!, $after: String) {\n  repository(owner: $owner, name: $repo) {\n    pullRequest(number: $pr) {\n      commits(last: 1) {\n        nodes {\n          commit {\n            statusCheckRollup {\n              contexts(first: 100, after: $after) {\n                pageInfo {\n                  hasNextPage\n                  endCursor\n                }\n                nodes {\n                  __typename\n                  ... on CheckRun {\n                    name\n                    status\n                    conclusion\n                    detailsUrl\n                  }\n                  ... on StatusContext {\n                    context\n                    state\n                    targetUrl\n                  }\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n";
-var WatcherQueryError = class extends Error {
-	failure;
-	constructor(failure) {
-		super(failure.detail);
-		this.name = "WatcherQueryError";
-		this.failure = failure;
-	}
-};
-var ChecksUnavailable = class extends WatcherQueryError {
-	constructor(detail) {
-		super({
-			kind: "checks-unavailable",
-			retryable: true,
-			detail
-		});
-		this.name = "ChecksUnavailable";
-	}
-};
-const firstLine = (value) => value.trim().split(/\r?\n/, 1)[0]?.slice(0, 240) ?? "";
-function run(argv) {
-	return new Promise((resolve, reject) => {
-		const child = spawn(argv[0], argv.slice(1), { stdio: [
-			"ignore",
-			"pipe",
-			"pipe"
-		] });
-		let stdout = "";
-		let stderr = "";
-		child.stdout.setEncoding("utf8");
-		child.stderr.setEncoding("utf8");
-		child.stdout.on("data", (chunk) => {
-			stdout += chunk;
-		});
-		child.stderr.on("data", (chunk) => {
-			stderr += chunk;
-		});
-		child.on("error", reject);
-		child.on("close", (code) => resolve({
-			code: code ?? -1,
-			stdout,
-			stderr
-		}));
-	});
-}
-function parseJson(text, label) {
-	try {
-		return JSON.parse(text);
-	} catch (error) {
-		throw new WatcherQueryError({
-			kind: "json-parse",
-			retryable: true,
-			detail: `${label}: ${error instanceof Error ? error.message : String(error)}`
-		});
-	}
-}
-async function runJson(argv) {
-	const result = await run(argv);
-	if (result.code !== 0) throw new WatcherQueryError({
-		kind: "command-exit",
-		retryable: true,
-		code: result.code,
-		detail: firstLine(result.stderr) || `${argv.join(" ")} exited ${result.code}`
-	});
-	return parseJson(result.stdout, argv.join(" "));
-}
-function raw(value) {
-	try {
-		return JSON.stringify(value);
-	} catch {
-		return String(value);
-	}
-}
-function missing(path, value) {
-	throw new WatcherQueryError({
-		kind: "missing-key",
-		retryable: true,
-		detail: value === void 0 ? `missing ${path}` : `invalid ${path}: ${raw(value)}`,
-		...value === void 0 ? {} : { rawValue: raw(value) }
-	});
-}
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function record(value, path) {
-	if (!isRecord(value)) missing(path, value);
-	return value;
-}
-function list(value, path) {
-	if (!Array.isArray(value)) missing(path, value);
-	return value;
-}
-function at(value, path) {
-	let current = value;
-	for (const key of path) {
-		const object = record(current, path.join("."));
-		if (!(key in object)) missing(path.join("."));
-		current = object[key];
-	}
-	return current;
-}
-function string(value, path) {
-	if (typeof value !== "string") missing(path, value);
-	return value;
-}
-const optionalString = (value, path) => value === null ? null : string(value, path);
-function enumValue(value, values, path) {
-	if (typeof value === "string") {
-		for (const candidate of values) if (candidate === value) return candidate;
-	}
-	return missing(path, value);
-}
-const nullableEnum = (value, values, path) => value === null ? null : enumValue(value, values, path);
-const MERGE_STATES = [
-	"BEHIND",
-	"BLOCKED",
-	"CLEAN",
-	"CONFLICTING",
-	"DIRTY",
-	"DRAFT",
-	"HAS_HOOKS",
-	"UNKNOWN",
-	"UNSTABLE"
-];
-const ROLLUP_STATES = [
-	"ERROR",
-	"EXPECTED",
-	"FAILURE",
-	"PENDING",
-	"SUCCESS"
-];
-const REVIEW_DECISIONS = [
-	"APPROVED",
-	"CHANGES_REQUESTED",
-	"REVIEW_REQUIRED"
-];
-const reviewDecision = (value) => nullableEnum(value === "" ? null : value, REVIEW_DECISIONS, "pull request.reviewDecision");
-function parseRemote(value) {
-	let normalized = value.trim();
-	if (normalized.startsWith("git@github.com:")) normalized = `https://github.com/${normalized.slice(15)}`;
-	if (normalized.startsWith("ssh://git@github.com/")) normalized = `https://github.com/${normalized.slice(21)}`;
-	try {
-		const url = new URL(normalized);
-		const parts = url.pathname.replace(/\.git$/, "").split("/").filter(Boolean);
-		if (url.protocol !== "https:" || url.hostname !== "github.com" || url.port || url.username || url.password || url.search || url.hash || parts.length !== 2) return null;
-		return {
-			owner: parts[0],
-			repo: parts[1]
-		};
-	} catch {
-		return null;
-	}
-}
-function parsePrUrl(value) {
-	try {
-		const url = new URL(value);
-		const parts = url.pathname.split("/").filter(Boolean);
-		if (url.protocol !== "https:" || url.hostname !== "github.com" || url.port || url.username || url.password || url.search || url.hash || parts.length !== 4 || parts[2] !== "pull") throw new Error("not a canonical GitHub pull URL");
-		return {
-			owner: parts[0],
-			repo: parts[1],
-			number: parsePrNumber(Number(parts[3]))
-		};
-	} catch (error) {
-		throw new WatcherQueryError({
-			kind: "invalid-context-url",
-			retryable: false,
-			rawValue: value,
-			detail: `could not infer owner/repo from PR URL: ${value} (${error instanceof Error ? error.message : String(error)})`
-		});
-	}
-}
-function checkDetails(value, nameKey) {
-	return {
-		name: string(value[nameKey], nameKey),
-		description: typeof value.description === "string" ? value.description : "",
-		link: typeof value.link === "string" ? value.link : typeof value.detailsUrl === "string" ? value.detailsUrl : "",
-		workflow: typeof value.workflow === "string" ? value.workflow : ""
-	};
-}
-function parseFastCheck(value) {
-	const object = record(value, "check");
-	const details = checkDetails(object, "name");
-	const state = string(object.state, "check.state").toUpperCase();
-	const bucket = string(object.bucket, "check.bucket");
-	if (state === "ACTION_REQUIRED") return gateOr("failed", details, state);
-	if (bucket === "fail" || ["FAILURE", "ERROR"].includes(state)) return {
-		...details,
-		kind: "failed",
-		reportedState: state
-	};
-	if (bucket === "pending") return gateOr("pending", details, state);
-	if (bucket === "pass") return {
-		...details,
-		kind: "passed",
-		reportedState: state
-	};
-	if (bucket === "skipping") return {
-		...details,
-		kind: "skipped",
-		reportedState: state
-	};
-	return {
-		...details,
-		kind: "failed",
-		reportedState: state
-	};
-}
-function gateOr(kind, details, reportedState) {
-	return details.name === "Code Review Gate" ? {
-		...details,
-		kind: "code-review-gate",
-		name: "Code Review Gate",
-		reportedState
-	} : {
-		...details,
-		kind,
-		reportedState
-	};
-}
-function mapRollupNode(value) {
-	const object = record(value, "rollup node");
-	const typename = object.__typename;
-	if (typename !== "CheckRun" && typename !== "StatusContext") return null;
-	const details = checkDetails(object, typename === "CheckRun" ? "name" : "context");
-	const link = typeof object.targetUrl === "string" ? object.targetUrl : details.link;
-	if (typename === "CheckRun") {
-		const status = typeof object.status === "string" ? object.status.toUpperCase() : "";
-		const conclusion = typeof object.conclusion === "string" ? object.conclusion.toUpperCase() : "";
-		if (status !== "COMPLETED") return gateOr("pending", {
-			...details,
-			link
-		}, "PENDING");
-		if (conclusion === "SUCCESS") return {
-			...details,
-			link,
-			kind: "passed",
-			reportedState: "SUCCESS"
-		};
-		if (conclusion === "NEUTRAL" || conclusion === "SKIPPED") return {
-			...details,
-			link,
-			kind: "skipped",
-			reportedState: conclusion
-		};
-		if (conclusion === "ACTION_REQUIRED") return gateOr("failed", {
-			...details,
-			link
-		}, conclusion);
-		return {
-			...details,
-			link,
-			kind: "failed",
-			reportedState: "FAILURE"
-		};
-	}
-	const state = typeof object.state === "string" ? object.state.toUpperCase() : "";
-	if (state === "PENDING" || state === "EXPECTED") return gateOr("pending", {
-		...details,
-		link
-	}, "PENDING");
-	return state === "SUCCESS" ? {
-		...details,
-		link,
-		kind: "passed",
-		reportedState: state
-	} : {
-		...details,
-		link,
-		kind: "failed",
-		reportedState: state || "FAILURE"
-	};
-}
-function parseComment(value) {
-	const object = record(value, "review comment");
-	const author = object.author === null ? null : record(object.author, "review comment.author");
-	return {
-		authorLogin: author === null ? null : optionalString(author.login, "review comment.author.login"),
-		body: string(object.body, "review comment.body"),
-		path: optionalString(object.path, "review comment.path"),
-		line: object.line === null ? null : Number.isInteger(object.line) ? Number(object.line) : missing("review comment.line", object.line),
-		createdAt: string(object.createdAt, "review comment.createdAt")
-	};
-}
-function isBugbot(comment) {
-	if (comment === null) return false;
-	const author = (comment.authorLogin ?? "").toLowerCase();
-	const body = comment.body.toLowerCase();
-	return author.includes("bugbot") || author === "cursor" && [
-		"bugbot",
-		"cursor_automation_id",
-		"agentic security review",
-		"description start",
-		"severity"
-	].some((token) => body.includes(token));
-}
-function passKey(comment) {
-	if (comment === null) return null;
-	for (const pattern of [/RUN_ID:\s*([a-zA-Z0-9_.:-]+)/, /CURSOR_AUTOMATION_ID:\s*([a-zA-Z0-9_.:-]+)/]) {
-		const match = pattern.exec(comment.body);
-		if (match?.[1]) return match[1];
-	}
-	return null;
-}
-function parseReviewThreadPage(value) {
-	const reviewThreads = record(at(value, [
-		"data",
-		"repository",
-		"pullRequest",
-		"reviewThreads"
-	]), "reviewThreads");
-	const nodes = list(reviewThreads.nodes, "reviewThreads.nodes");
-	const threads = [];
-	for (const node of nodes) {
-		const thread = record(node, "review thread");
-		if (typeof thread.isResolved !== "boolean") missing("review thread.isResolved", thread.isResolved);
-		const comments = list(at(thread, ["comments", "nodes"]), "review thread.comments.nodes");
-		threads.push({
-			id: string(thread.id, "review thread.id"),
-			firstComment: comments.length === 0 ? null : parseComment(comments[0]),
-			resolved: thread.isResolved
-		});
-	}
-	const page = record(reviewThreads.pageInfo, "reviewThreads.pageInfo");
-	if (typeof page.hasNextPage !== "boolean") missing("reviewThreads.pageInfo.hasNextPage", page.hasNextPage);
-	const cursor = optionalString(page.endCursor, "reviewThreads.pageInfo.endCursor");
-	return {
-		threads,
-		endCursor: page.hasNextPage && cursor ? cursor : null
-	};
-}
-function buildReviewThreads(threads) {
-	const keys = /* @__PURE__ */ new Set();
-	let keyless = false;
-	for (const thread of threads) {
-		if (!isBugbot(thread.firstComment)) continue;
-		const key = passKey(thread.firstComment);
-		if (key === null) keyless = true;
-		else keys.add(key);
-	}
-	const passes = keys.size > 0 ? keys.size : keyless ? 1 : 0;
-	return threads.filter((thread) => !thread.resolved).map(({ id, firstComment }) => ({
-		id,
-		firstComment,
-		isBugbot: isBugbot(firstComment),
-		bugbotReviewPasses: passes
-	}));
-}
-function parsePullRequest(value, context) {
-	const object = record(value, "pull request");
-	if (typeof object.isDraft !== "boolean") missing("pull request.isDraft", object.isDraft);
-	return {
-		context,
-		mergeable: enumValue(object.mergeable, [
-			"MERGEABLE",
-			"CONFLICTING",
-			"UNKNOWN"
-		], "pull request.mergeable"),
-		mergeStateStatus: enumValue(object.mergeStateStatus, MERGE_STATES, "pull request.mergeStateStatus"),
-		reviewDecision: reviewDecision(object.reviewDecision),
-		headRefOid: optionalString(object.headRefOid, "pull request.headRefOid"),
-		headRefName: string(object.headRefName, "pull request.headRefName"),
-		baseRefName: string(object.baseRefName, "pull request.baseRefName"),
-		state: enumValue(object.state, [
-			"OPEN",
-			"CLOSED",
-			"MERGED"
-		], "pull request.state"),
-		mergedAt: optionalString(object.mergedAt, "pull request.mergedAt"),
-		isDraft: object.isDraft
-	};
-}
-function graphqlArgs(query, context) {
-	return [
-		"gh",
-		"api",
-		"graphql",
-		"-f",
-		`query=${query}`,
-		"-f",
-		`owner=${context.owner}`,
-		"-f",
-		`repo=${context.repo}`,
-		"-F",
-		`pr=${context.number}`
-	];
-}
-var GhGitHubReader = class {
-	async originRepo() {
-		const result = await run([
-			"git",
-			"remote",
-			"get-url",
-			"origin"
-		]);
-		return result.code === 0 ? parseRemote(result.stdout) : null;
-	}
-	async currentPr(pr) {
-		const argv = [
-			"gh",
-			"pr",
-			"view"
-		];
-		if (pr !== null) argv.push(String(pr));
-		argv.push("--json", "number,url");
-		const object = record(await runJson(argv), "current PR");
-		return {
-			...parsePrUrl(string(object.url, "current PR.url")),
-			number: pr ?? parsePrNumber(object.number, "current PR.number")
-		};
-	}
-	async pullRequest(context) {
-		return parsePullRequest(await runJson([
-			"gh",
-			"pr",
-			"view",
-			String(context.number),
-			"--repo",
-			`${context.owner}/${context.repo}`,
-			"--json",
-			"mergeable,mergeStateStatus,reviewDecision,headRefOid,headRefName,baseRefName,state,mergedAt,isDraft"
-		]), context);
-	}
-	async openPullRequests(repository) {
-		return list(await runJson([
-			"gh",
-			"pr",
-			"list",
-			"--repo",
-			`${repository.owner}/${repository.repo}`,
-			"--state",
-			"open",
-			"--limit",
-			"300",
-			"--json",
-			"number,headRefName,baseRefName,isCrossRepository"
-		]), "open PRs").map((item, index) => {
-			const object = record(item, `open PRs[${index}]`);
-			if (typeof object.isCrossRepository !== "boolean") missing(`open PRs[${index}].isCrossRepository`, object.isCrossRepository);
-			return {
-				isCrossRepository: object.isCrossRepository,
-				number: parsePrNumber(object.number, `open PRs[${index}].number`),
-				headRefName: string(object.headRefName, `open PRs[${index}].headRefName`),
-				baseRefName: string(object.baseRefName, `open PRs[${index}].baseRefName`)
-			};
-		});
-	}
-	async checksFastPath(context) {
-		const result = await run([
-			"gh",
-			"pr",
-			"checks",
-			String(context.number),
-			"--repo",
-			`${context.owner}/${context.repo}`,
-			"--json",
-			"name,state,description,link,workflow,bucket"
-		]);
-		if ([
-			0,
-			1,
-			8
-		].includes(result.code) && result.stdout.trim()) try {
-			const value = parseJson(result.stdout, "gh pr checks");
-			if (Array.isArray(value)) return {
-				kind: "checks",
-				checks: value.map(parseFastCheck)
-			};
-		} catch (error) {
-			if (!(error instanceof WatcherQueryError)) throw error;
-		}
-		return {
-			kind: "unusable",
-			exitCode: result.code,
-			stderr: result.stderr
-		};
-	}
-	async checkRollupPage(context, after) {
-		const argv = graphqlArgs(PR_CHECK_ROLLUP_QUERY, context);
-		if (after !== null) argv.push("-f", `after=${after}`);
-		const commits = list(at(await runJson(argv), [
-			"data",
-			"repository",
-			"pullRequest",
-			"commits",
-			"nodes"
-		]), "commits.nodes");
-		if (commits.length === 0) return {
-			checks: [],
-			endCursor: null
-		};
-		const commit = record(at(commits[commits.length - 1], ["commit"]), "commit");
-		if (commit.statusCheckRollup === null) return {
-			checks: [],
-			endCursor: null
-		};
-		const contexts = record(at(commit, ["statusCheckRollup", "contexts"]), "contexts");
-		const checks = list(contexts.nodes, "contexts.nodes").map(mapRollupNode).filter((check) => check !== null);
-		const page = record(contexts.pageInfo, "contexts.pageInfo");
-		if (typeof page.hasNextPage !== "boolean") missing("contexts.pageInfo.hasNextPage", page.hasNextPage);
-		const cursor = optionalString(page.endCursor, "contexts.pageInfo.endCursor");
-		return {
-			checks,
-			endCursor: page.hasNextPage && cursor ? cursor : null
-		};
-	}
-	async reviewThreadPage(context, after) {
-		const argv = graphqlArgs(REVIEW_THREADS_QUERY, context);
-		if (after !== null) argv.push("-f", `after=${after}`);
-		return parseReviewThreadPage(await runJson(argv));
-	}
-	async commitRollups(context) {
-		return list(at(await runJson(graphqlArgs(PR_COMMIT_STATUS_QUERY, context)), [
-			"data",
-			"repository",
-			"pullRequest",
-			"commits",
-			"nodes"
-		]), "commits.nodes").map((item, index) => {
-			const commit = record(at(item, ["commit"]), `commits[${index}].commit`);
-			const rollup = commit.statusCheckRollup;
-			return {
-				oid: string(commit.oid, `commits[${index}].oid`),
-				state: rollup === null ? null : nullableEnum(at(rollup, ["state"]), ROLLUP_STATES, `commits[${index}].statusCheckRollup.state`)
-			};
-		});
-	}
-};
-async function resolveChecks(reader, context) {
-	const fast = await reader.checksFastPath(context);
-	const direct = fast.kind === "checks" ? nonEmpty(fast.checks) : null;
-	if (direct !== null) return {
-		source: "gh-pr-checks",
-		checks: direct
-	};
-	const checks = [];
-	let after = null;
-	do {
-		const page = await reader.checkRollupPage(context, after);
-		checks.push(...page.checks);
-		after = page.endCursor;
-	} while (after !== null);
-	const fallback = nonEmpty(checks);
-	if (fallback !== null) return {
-		source: "graphql-rollup",
-		checks: fallback
-	};
-	throw new ChecksUnavailable(`could not read PR checks: ${fast.kind === "unusable" ? `fast path exit=${fast.exitCode}; GraphQL rollup was empty${firstLine(fast.stderr) ? `; ${firstLine(fast.stderr)}` : ""}` : "fast path and GraphQL rollup were empty"}`);
-}
-async function resolveReviewThreads(reader, context) {
-	const threads = [];
-	let after = null;
-	do {
-		const page = await reader.reviewThreadPage(context, after);
-		threads.push(...page.threads);
-		after = page.endCursor;
-	} while (after !== null);
-	return buildReviewThreads(threads);
-}
-async function resolveContext(args) {
-	if (args.pr !== null && args.owner !== null && args.repo !== null) return {
-		owner: args.owner,
-		repo: args.repo,
-		number: args.pr
-	};
-	if (args.pr !== null) {
-		const origin = await args.reader.originRepo();
-		if (origin !== null) return {
-			owner: args.owner ?? origin.owner,
-			repo: args.repo ?? origin.repo,
-			number: args.pr
-		};
-	}
-	const inferred = await args.reader.currentPr(args.pr);
-	return {
-		owner: args.owner ?? inferred.owner,
-		repo: args.repo ?? inferred.repo,
-		number: args.pr ?? inferred.number
-	};
-}
-function orderStack(context, open) {
-	const byNumber = new Map(open.map((pr) => [pr.number, pr]));
-	const byHead = new Map(open.filter((pr) => !pr.isCrossRepository).map((pr) => [pr.headRefName, pr]));
-	const children = /* @__PURE__ */ new Map();
-	for (const pr of open) children.set(pr.baseRefName, [...children.get(pr.baseRefName) ?? [], pr]);
-	for (const values of children.values()) values.sort((a, b) => a.number - b.number);
-	const start = byNumber.get(context.number);
-	if (start === void 0) return [context];
-	const down = [];
-	let current = start;
-	while (byHead.has(current.baseRefName)) {
-		const parent = byHead.get(current.baseRefName);
-		if (parent === void 0) break;
-		down.push(parent);
-		current = parent;
-	}
-	const seen = /* @__PURE__ */ new Set([...down.map((pr) => pr.number), start.number]);
-	const up = [];
-	const visit = (parent) => {
-		if (parent.isCrossRepository) return;
-		for (const child of children.get(parent.headRefName) ?? []) {
-			if (seen.has(child.number)) continue;
-			seen.add(child.number);
-			up.push(child);
-			visit(child);
-		}
-	};
-	visit(start);
-	return nonEmpty([
-		...down.reverse(),
-		start,
-		...up
-	].map((pr) => ({
-		...context,
-		number: pr.number
-	}))) ?? [context];
-}
-async function discoverStack(reader, context) {
-	return orderStack(context, await reader.openPullRequests(context));
-}
-export { ChecksUnavailable, GhGitHubReader, PR_CHECK_ROLLUP_QUERY, PR_COMMIT_STATUS_QUERY, REVIEW_THREADS_QUERY, WatcherQueryError, buildReviewThreads, discoverStack, mapRollupNode, orderStack, parseFastCheck, parsePullRequest, parseReviewThreadPage, resolveChecks, resolveContext, resolveReviewThreads };