@gaodes/pi-gitlab 0.3.0

package/src/tools/gitlab_release_create.ts

@@ -0,0 +1,92 @@
+import type {
+	ExtensionAPI,
+	ExtensionContext,
+} from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { requireSetup, setupRequiredResult } from "../lib/errors.js";
+import { glab } from "../lib/glab.js";
+import { requireConfirm } from "../lib/confirm.js";
+import { resolveProject } from "../lib/projectFallback.js";
+import { resolveProjectId } from "../lib/resolveProjectId.js";
+import { OptionalProject } from "../lib/schemas.js";
+
+export function registerGitlabReleaseCreate(pi: ExtensionAPI) {
+	pi.registerTool({
+		name: "gitlab_release_create",
+		label: "Create Release",
+		description:
+			"Create a new release for a tag. Requires confirmation.",
+		parameters: Type.Object(
+			{
+				project: OptionalProject,
+				tagName: Type.String({ description: "Tag name (e.g. v0.3.0)" }),
+				name: Type.Optional(
+					Type.String({ description: "Release title. Defaults to tag name." }),
+				),
+				description: Type.Optional(
+					Type.String({
+						description: "Release notes in markdown.",
+					}),
+				),
+				ref: Type.Optional(
+					Type.String({
+						description:
+							"Branch, SHA, or tag to create the release from. Required when the tag does not already exist.",
+					}),
+				),
+				confirm: Type.Optional(Type.Boolean({ default: false })),
+				dryRun: Type.Optional(Type.Boolean({ default: false })),
+			},
+			{ additionalProperties: false },
+		),
+		async execute(
+			_toolCallId,
+			params,
+			_signal,
+			_onUpdate,
+			ctx: ExtensionContext,
+		) {
+			try {
+				requireSetup(ctx.cwd);
+			} catch {
+				return setupRequiredResult();
+			}
+
+			const projectPath = await resolveProject(params.project, ctx.cwd);
+			const projectId = await resolveProjectId(projectPath);
+
+			const preview = `Create release **${params.name ?? params.tagName}**\nTag: \`${params.tagName}\`${params.ref ? `\nRef: \`${params.ref}\`` : ""}\nProject: \`${projectPath}\``;
+			const blocked = requireConfirm(preview, {
+				confirm: params.confirm,
+				dryRun: params.dryRun,
+			});
+			if (blocked) return blocked;
+
+			const body: Record<string, unknown> = {
+				tag_name: params.tagName,
+			};
+			if (params.name) body.name = params.name;
+			if (params.description) body.description = params.description;
+			if (params.ref) body.ref = params.ref;
+
+			const result = await glab([
+				"api",
+				"-X",
+				"POST",
+				`projects/${projectId}/releases`,
+				...Object.entries(body).flatMap(([k, v]) => ["-f", `${k}=${v}`]),
+			]);
+
+			const release = result as Record<string, unknown>;
+			return {
+				content: [
+					{
+						type: "text",
+						text: `✅ Release created: ${release.tag_name} — ${release.name ?? release.tag_name}\n${(release._links as Record<string, unknown>)?.self ?? ""}`,
+					},
+				],
+				details: { success: true, release },
+			};
+		},
+	});
+}

package/src/tools/gitlab_release_list.ts

@@ -0,0 +1,97 @@
+import type {
+	ExtensionAPI,
+	ExtensionContext,
+} from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { requireSetup, setupRequiredResult } from "../lib/errors.js";
+import { glab } from "../lib/glab.js";
+import { limitRows } from "../lib/pagination.js";
+import { resolveProject } from "../lib/projectFallback.js";
+import { resolveProjectId } from "../lib/resolveProjectId.js";
+import { MaxRows, OptionalProject } from "../lib/schemas.js";
+
+interface Release {
+	tag_name: string;
+	name?: string;
+	author?: { name?: string };
+	created_at?: string;
+	upcoming_release?: boolean;
+	assets?: { count?: number };
+}
+
+export function registerGitlabReleaseList(pi: ExtensionAPI) {
+	pi.registerTool({
+		name: "gitlab_release_list",
+		label: "List Releases",
+		description:
+			"List releases for a project with transparent pagination.",
+		parameters: Type.Object(
+			{
+				project: OptionalProject,
+				sort: Type.Optional(
+					Type.Union(
+						[
+							Type.Literal("desc"),
+							Type.Literal("asc"),
+						],
+						{ default: "desc" },
+					),
+				),
+				maxRows: MaxRows,
+			},
+			{ additionalProperties: false },
+		),
+		async execute(
+			_toolCallId,
+			params,
+			_signal,
+			_onUpdate,
+			ctx: ExtensionContext,
+		) {
+			try {
+				requireSetup(ctx.cwd);
+			} catch {
+				return setupRequiredResult();
+			}
+
+			const projectPath = await resolveProject(params.project, ctx.cwd);
+			const projectId = await resolveProjectId(projectPath);
+
+			const query = new URLSearchParams();
+			query.set("sort", params.sort ?? "desc");
+			query.set("per_page", "100");
+
+			const releases = (await glab([
+				"api",
+				"--paginate",
+				`projects/${projectId}/releases?${query.toString()}`,
+			])) as Release[];
+
+			const limited = limitRows(releases, params.maxRows ?? 25);
+			if (limited.length === 0) {
+				return {
+					content: [{ type: "text", text: "No releases found." }],
+					details: { success: true, count: 0, releases: [] },
+				};
+			}
+
+			const lines = [
+				"| Tag | Name | Author | Date | Upcoming |",
+				"|---|---|---|---|---|",
+			];
+			for (const rel of limited) {
+				const date = rel.created_at
+					? new Date(rel.created_at).toISOString().split("T")[0]
+					: "-";
+				lines.push(
+					`| ${rel.tag_name} | ${rel.name ?? "-"} | ${rel.author?.name ?? "-"} | ${date} | ${rel.upcoming_release ? "yes" : "no"} |`,
+				);
+			}
+
+			return {
+				content: [{ type: "text", text: lines.join("\n") }],
+				details: { success: true, count: limited.length, releases: limited },
+			};
+		},
+	});
+}

package/src/tools/gitlab_release_view.ts

@@ -0,0 +1,78 @@
+import type {
+	ExtensionAPI,
+	ExtensionContext,
+} from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { requireSetup, setupRequiredResult } from "../lib/errors.js";
+import { glab } from "../lib/glab.js";
+import { resolveProject } from "../lib/projectFallback.js";
+import { resolveProjectId } from "../lib/resolveProjectId.js";
+import { OptionalProject } from "../lib/schemas.js";
+
+export function registerGitlabReleaseView(pi: ExtensionAPI) {
+	pi.registerTool({
+		name: "gitlab_release_view",
+		label: "View Release",
+		description:
+			"View a single release by tag name, including description and asset links.",
+		parameters: Type.Object(
+			{
+				project: OptionalProject,
+				tagName: Type.String({ description: "Release tag name (e.g. v1.0.0)" }),
+			},
+			{ additionalProperties: false },
+		),
+		async execute(
+			_toolCallId,
+			params,
+			_signal,
+			_onUpdate,
+			ctx: ExtensionContext,
+		) {
+			try {
+				requireSetup(ctx.cwd);
+			} catch {
+				return setupRequiredResult();
+			}
+
+			const projectPath = await resolveProject(params.project, ctx.cwd);
+			const projectId = await resolveProjectId(projectPath);
+
+			const release = (await glab([
+				"api",
+				`projects/${projectId}/releases/${encodeURIComponent(params.tagName)}`,
+			])) as Record<string, unknown>;
+
+			const assets = release.assets as Record<string, unknown> | undefined;
+			const links = (assets?.links as Array<Record<string, unknown>> | undefined) ?? [];
+
+			const lines: string[] = [];
+			lines.push(`## Release: ${release.tag_name}`);
+			if (release.name) lines.push(`**Name:** ${release.name}`);
+			lines.push(`**Author:** ${(release.author as Record<string, unknown>)?.name ?? "-"}`);
+			if (release.created_at)
+				lines.push(`**Created:** ${new Date(release.created_at as string).toISOString()}`);
+			if (release.upcoming_release) lines.push("**Upcoming release:** yes");
+
+			if (release.description) {
+				lines.push(`\n### Description\n${release.description}`);
+			}
+
+			if (links.length > 0) {
+				lines.push("\n### Asset Links");
+				for (const link of links) {
+					lines.push(`- [${link.name ?? link.url}](${link.url})`);
+				}
+			}
+
+			if (assets?.count !== undefined) {
+				lines.push(`\n**Assets count:** ${assets.count}`);
+			}
+
+			return {
+				content: [{ type: "text", text: lines.join("\n") }],
+				details: { success: true, release },
+			};
+		},
+	});
+}