@agentuity/cli 0.0.109 → 0.0.111

package/src/cmd/git/account/add.ts

@@ -0,0 +1,317 @@
+import { createSubcommand } from '../../../types';
+import type { Config } from '../../../types';
+import * as tui from '../../../tui';
+import { getCommand } from '../../../command-prefix';
+import { getAPIBaseURL } from '../../../api';
+import type { APIClient } from '../../../api';
+import { ErrorCode } from '../../../errors';
+import { listOrganizations } from '@agentuity/server';
+import enquirer from 'enquirer';
+import type { Logger } from '@agentuity/core';
+import { z } from 'zod';
+import {
+	startGithubIntegration,
+	pollForGithubIntegration,
+	getGithubIntegrationStatus,
+	getExistingGithubIntegrations,
+	copyGithubIntegration,
+} from '../../integration/api';
+
+export interface RunGitAccountConnectOptions {
+	apiClient: APIClient;
+	orgId: string;
+	orgName?: string;
+	logger: Logger;
+	config?: Config | null;
+}
+
+export interface RunGitAccountConnectResult {
+	connected: boolean;
+	cancelled?: boolean;
+}
+
+export async function runGitAccountConnect(
+	options: RunGitAccountConnectOptions
+): Promise<RunGitAccountConnectResult> {
+	const { apiClient, orgId, orgName, logger, config } = options;
+	const orgDisplay = orgName ?? orgId;
+
+	try {
+		const currentStatus = await getGithubIntegrationStatus(apiClient, orgId);
+		const initialCount = currentStatus.integrations?.length ?? 0;
+
+		const existingIntegrations = await tui.spinner({
+			message: 'Checking for existing GitHub connections...',
+			clearOnSuccess: true,
+			callback: () => getExistingGithubIntegrations(apiClient, orgId),
+		});
+
+		const alreadyConnectedNames = new Set(
+			currentStatus.integrations?.map((i) => i.githubAccountName) ?? []
+		);
+		const availableIntegrations = existingIntegrations.filter(
+			(i) => !alreadyConnectedNames.has(i.githubAccountName)
+		);
+
+		if (availableIntegrations.length > 0) {
+			tui.newline();
+
+			const integrationChoices = availableIntegrations.map((i) => ({
+				name: i.id,
+				message: `${i.githubAccountName} ${tui.muted(`(from ${i.orgName})`)}`,
+			}));
+
+			console.log(tui.muted('Press enter with none selected to add a new account'));
+			tui.newline();
+
+			const selectResponse = await enquirer.prompt<{ integrationIds: string[] }>({
+				type: 'multiselect',
+				name: 'integrationIds',
+				message: 'Select GitHub accounts to add',
+				choices: integrationChoices,
+			});
+
+			if (selectResponse.integrationIds.length > 0) {
+				const selectedIntegrations = availableIntegrations.filter((i) =>
+					selectResponse.integrationIds.includes(i.id)
+				);
+
+				const accountNames = selectedIntegrations.map((i) => i.githubAccountName).join(', ');
+
+				const confirmResponse = await enquirer.prompt<{ confirm: boolean }>({
+					type: 'confirm',
+					name: 'confirm',
+					message: `Add ${tui.bold(accountNames)} to ${tui.bold(orgDisplay)}?`,
+					initial: true,
+				});
+
+				if (confirmResponse.confirm) {
+					await tui.spinner({
+						message: `Adding ${selectedIntegrations.length} GitHub account${selectedIntegrations.length > 1 ? 's' : ''}...`,
+						clearOnSuccess: true,
+						callback: async () => {
+							for (const integration of selectedIntegrations) {
+								await copyGithubIntegration(apiClient, integration.orgId, orgId);
+							}
+						},
+					});
+
+					tui.newline();
+					tui.success(
+						`Added GitHub account${selectedIntegrations.length > 1 ? 's' : ''} to ${tui.bold(orgDisplay)}`
+					);
+					return { connected: true };
+				}
+			}
+		}
+
+		const startResult = await tui.spinner({
+			message: 'Getting GitHub authorization URL...',
+			clearOnSuccess: true,
+			callback: () => startGithubIntegration(apiClient, orgId),
+		});
+
+		if (!startResult) {
+			tui.error('Failed to start GitHub authorization');
+			return { connected: false };
+		}
+
+		const { shortId } = startResult;
+		const apiBaseUrl = getAPIBaseURL(config);
+		const url = `${apiBaseUrl}/github/connect/${shortId}`;
+
+		const copied = await tui.copyToClipboard(url);
+
+		tui.newline();
+		if (copied) {
+			console.log('GitHub authorization URL copied to clipboard! Open it in your browser:');
+		} else {
+			console.log('Open this URL in your browser to authorize GitHub access:');
+		}
+		tui.newline();
+		console.log(`  ${tui.link(url)}`);
+		tui.newline();
+		console.log(tui.muted('Press Enter to open in your browser, or Ctrl+C to cancel'));
+		tui.newline();
+
+		const result = await tui.spinner({
+			type: 'countdown',
+			message: 'Waiting for GitHub authorization',
+			timeoutMs: 600000,
+			clearOnSuccess: true,
+			onEnterPress: () => {
+				const platform = process.platform;
+				if (platform === 'win32') {
+					Bun.spawn(['cmd', '/c', 'start', '', url], {
+						stdout: 'ignore',
+						stderr: 'ignore',
+					});
+				} else {
+					const command = platform === 'darwin' ? 'open' : 'xdg-open';
+					Bun.spawn([command, url], { stdout: 'ignore', stderr: 'ignore' });
+				}
+			},
+			callback: async () => {
+				return await pollForGithubIntegration(apiClient, orgId, initialCount);
+			},
+		});
+
+		tui.newline();
+		if (result.connected) {
+			tui.success(`GitHub account added to ${tui.bold(orgDisplay)}`);
+			return { connected: true };
+		}
+
+		return { connected: false };
+	} catch (error) {
+		const isCancel =
+			error === '' ||
+			(error instanceof Error && (error.message === '' || error.message === 'User cancelled'));
+
+		if (isCancel) {
+			tui.newline();
+			tui.info('Cancelled');
+			return { connected: false, cancelled: true };
+		}
+
+		logger.trace(error);
+		throw error;
+	}
+}
+
+const AddOptionsSchema = z.object({
+	org: z.string().optional().describe('Organization ID to add the account to'),
+});
+
+const AddResponseSchema = z.object({
+	connected: z.boolean().describe('Whether the account was connected'),
+	orgId: z.string().optional().describe('Organization ID'),
+});
+
+export const addSubcommand = createSubcommand({
+	name: 'add',
+	description: 'Add a GitHub account to your organization',
+	tags: ['mutating', 'creates-resource', 'slow', 'api-intensive'],
+	idempotent: false,
+	requires: { auth: true, apiClient: true },
+	schema: {
+		options: AddOptionsSchema,
+		response: AddResponseSchema,
+	},
+	examples: [
+		{
+			command: getCommand('git account add'),
+			description: 'Add a GitHub account to your organization',
+		},
+		{
+			command: getCommand('git account add --org org_abc123'),
+			description: 'Add to a specific organization',
+		},
+	],
+
+	async handler(ctx) {
+		const { logger, apiClient, config, opts } = ctx;
+
+		try {
+			const orgs = await tui.spinner({
+				message: 'Fetching organizations...',
+				clearOnSuccess: true,
+				callback: () => listOrganizations(apiClient),
+			});
+
+			if (orgs.length === 0) {
+				tui.fatal('No organizations found for your account');
+			}
+
+			let orgId = opts.org;
+			let selectedOrg: (typeof orgs)[0] | undefined;
+
+			if (orgId) {
+				selectedOrg = orgs.find((o) => o.id === orgId);
+				if (!selectedOrg) {
+					tui.fatal(`Organization ${orgId} not found`);
+				}
+			} else {
+				const orgStatuses = await tui.spinner({
+					message: 'Checking GitHub integration status...',
+					clearOnSuccess: true,
+					callback: async () => {
+						const statuses = await Promise.all(
+							orgs.map(async (org) => {
+								const status = await getGithubIntegrationStatus(apiClient, org.id);
+								return {
+									...org,
+									connected: status.connected,
+									integrations: status.integrations,
+								};
+							})
+						);
+						return statuses;
+					},
+				});
+
+				const sortedOrgs = [...orgStatuses].sort((a, b) => a.name.localeCompare(b.name));
+
+				if (orgs.length === 1) {
+					orgId = orgs[0].id;
+					selectedOrg = orgs[0];
+				} else {
+					const choices = sortedOrgs.map((org) => {
+						const count = org.integrations.length;
+						const suffix =
+							count > 0
+								? tui.muted(` (${count} GitHub account${count > 1 ? 's' : ''})`)
+								: '';
+						return {
+							name: org.name,
+							message: `${org.name}${suffix}`,
+							value: org.id,
+						};
+					});
+
+					const response = await enquirer.prompt<{ orgName: string }>({
+						type: 'select',
+						name: 'orgName',
+						message: 'Select an organization',
+						choices,
+						result(name: string) {
+							// @ts-expect-error - this.map exists at runtime
+							return this.map(name)[name];
+						},
+					});
+
+					orgId = response.orgName;
+					selectedOrg = sortedOrgs.find((o) => o.id === orgId);
+				}
+			}
+
+			const result = await runGitAccountConnect({
+				apiClient,
+				orgId: orgId!,
+				orgName: selectedOrg?.name,
+				logger,
+				config,
+			});
+
+			return { connected: result.connected, orgId };
+		} catch (error) {
+			const isCancel =
+				error === '' ||
+				(error instanceof Error &&
+					(error.message === '' || error.message === 'User cancelled'));
+
+			if (isCancel) {
+				tui.newline();
+				tui.info('Cancelled');
+				return { connected: false };
+			}
+
+			logger.trace(error);
+			return logger.fatal(
+				'Failed to add GitHub account: %s',
+				error,
+				ErrorCode.INTEGRATION_FAILED
+			);
+		}
+	},
+});

package/src/cmd/git/account/index.ts

@@ -0,0 +1,12 @@
+import { createCommand } from '../../../types';
+import { addSubcommand } from './add';
+import { removeSubcommand } from './remove';
+import { listSubcommand } from './list';
+
+export const accountCommand = createCommand({
+	name: 'account',
+	description: 'Manage GitHub accounts connected to your organization',
+	subcommands: [addSubcommand, removeSubcommand, listSubcommand],
+});
+
+export default accountCommand;

package/src/cmd/git/account/list.ts

@@ -0,0 +1,139 @@
+import { createSubcommand } from '../../../types';
+import * as tui from '../../../tui';
+import { getCommand } from '../../../command-prefix';
+import { ErrorCode } from '../../../errors';
+import { listOrganizations } from '@agentuity/server';
+import { getGithubIntegrationStatus } from '../../integration/api';
+import { z } from 'zod';
+
+const ListResponseSchema = z.array(
+	z.object({
+		orgId: z.string().describe('Organization ID'),
+		orgName: z.string().describe('Organization name'),
+		integrations: z.array(
+			z.object({
+				id: z.string().describe('Integration ID'),
+				githubAccountName: z.string().describe('GitHub account name'),
+				githubAccountType: z.enum(['user', 'org']).describe('Account type'),
+			})
+		),
+	})
+);
+
+export const listSubcommand = createSubcommand({
+	name: 'list',
+	description: 'List GitHub accounts connected to your organizations',
+	aliases: ['ls'],
+	tags: ['read-only'],
+	idempotent: true,
+	requires: { auth: true, apiClient: true },
+	schema: {
+		response: ListResponseSchema,
+	},
+	examples: [
+		{
+			command: getCommand('git account list'),
+			description: 'List all connected GitHub accounts',
+		},
+		{
+			command: getCommand('--json git account list'),
+			description: 'List accounts in JSON format',
+		},
+	],
+
+	async handler(ctx) {
+		const { logger, apiClient, options } = ctx;
+
+		try {
+			// Fetch organizations
+			const orgs = await tui.spinner({
+				message: 'Fetching organizations...',
+				clearOnSuccess: true,
+				callback: () => listOrganizations(apiClient),
+			});
+
+			if (orgs.length === 0) {
+				tui.fatal('No organizations found for your account');
+			}
+
+			// Check GitHub status for each org
+			const orgStatuses = await tui.spinner({
+				message: 'Checking GitHub integration status...',
+				clearOnSuccess: true,
+				callback: async () => {
+					const statuses = await Promise.all(
+						orgs.map(async (org) => {
+							const status = await getGithubIntegrationStatus(apiClient, org.id);
+							return {
+								...org,
+								connected: status.connected,
+								integrations: status.integrations,
+							};
+						})
+					);
+					return statuses;
+				},
+			});
+
+			// Sort orgs alphabetically
+			const sortedOrgs = [...orgStatuses].sort((a, b) => a.name.localeCompare(b.name));
+
+			const result = sortedOrgs.map((org) => ({
+				orgId: org.id,
+				orgName: org.name,
+				integrations: org.integrations.map((i) => ({
+					id: i.id,
+					githubAccountName: i.githubAccountName,
+					githubAccountType: i.githubAccountType,
+				})),
+			}));
+
+			if (options.json) {
+				return result;
+			}
+
+			tui.newline();
+			console.log(tui.bold('GitHub Accounts'));
+			tui.newline();
+
+			let totalCount = 0;
+
+			for (const org of sortedOrgs) {
+				if (org.integrations.length === 0) {
+					console.log(`  ${org.name} ${tui.muted('(no accounts connected)')}`);
+				} else {
+					console.log(`  ${org.name}`);
+					for (const integration of org.integrations) {
+						const typeLabel = integration.githubAccountType === 'org' ? 'org' : 'user';
+						console.log(
+							`    ${tui.colorSuccess('✓')} ${integration.githubAccountName} ${tui.muted(`(${typeLabel})`)}`
+						);
+						totalCount++;
+					}
+				}
+			}
+
+			tui.newline();
+			if (totalCount === 0) {
+				console.log(
+					tui.muted(
+						`No GitHub accounts connected. Run ${tui.bold('agentuity git account add')} to add one.`
+					)
+				);
+			} else {
+				console.log(
+					tui.muted(`${totalCount} GitHub account${totalCount > 1 ? 's' : ''} connected`)
+				);
+			}
+
+			return result;
+		} catch (error) {
+			logger.trace(error);
+			return logger.fatal(
+				'Failed to list GitHub accounts: %s',
+				error,
+				ErrorCode.INTEGRATION_FAILED
+			);
+		}
+	},
+});

package/src/cmd/git/account/remove.ts

@@ -0,0 +1,212 @@
+import { createSubcommand } from '../../../types';
+import * as tui from '../../../tui';
+import { getCommand } from '../../../command-prefix';
+import { ErrorCode } from '../../../errors';
+import { listOrganizations } from '@agentuity/server';
+import enquirer from 'enquirer';
+import { z } from 'zod';
+import {
+	getGithubIntegrationStatus,
+	disconnectGithubIntegration,
+	type GithubIntegration,
+} from '../../integration/api';
+
+const RemoveOptionsSchema = z.object({
+	org: z.string().optional().describe('Organization ID'),
+	account: z.string().optional().describe('GitHub integration ID to remove'),
+	confirm: z.boolean().optional().describe('Skip confirmation prompt'),
+});
+
+const RemoveResponseSchema = z.object({
+	removed: z.boolean().describe('Whether the account was removed'),
+	orgId: z.string().optional().describe('Organization ID'),
+	integrationId: z.string().optional().describe('Integration ID that was removed'),
+});
+
+export const removeSubcommand = createSubcommand({
+	name: 'remove',
+	description: 'Remove a GitHub account from your organization',
+	tags: ['mutating', 'destructive', 'slow'],
+	idempotent: false,
+	requires: { auth: true, apiClient: true },
+	schema: {
+		options: RemoveOptionsSchema,
+		response: RemoveResponseSchema,
+	},
+	examples: [
+		{
+			command: getCommand('git account remove'),
+			description: 'Remove a GitHub account from your organization',
+		},
+		{
+			command: getCommand('git account remove --org org_abc --account int_xyz --confirm'),
+			description: 'Remove a specific account without prompts',
+		},
+		{
+			command: getCommand('--json git account remove --org org_abc --account int_xyz --confirm'),
+			description: 'Remove and return JSON result',
+		},
+	],
+
+	async handler(ctx) {
+		const { logger, apiClient, opts, options } = ctx;
+
+		try {
+			// If both org and account provided, skip interactive flow
+			if (opts.org && opts.account) {
+				if (!opts.confirm) {
+					const confirmed = await tui.confirm(
+						`Are you sure you want to remove this GitHub account?`
+					);
+					if (!confirmed) {
+						tui.info('Cancelled');
+						return { removed: false };
+					}
+				}
+
+				await tui.spinner({
+					message: 'Removing GitHub account...',
+					clearOnSuccess: true,
+					callback: () => disconnectGithubIntegration(apiClient, opts.org!, opts.account!),
+				});
+
+				if (!options.json) {
+					tui.newline();
+					tui.success('Removed GitHub account');
+				}
+
+				return { removed: true, orgId: opts.org, integrationId: opts.account };
+			}
+
+			// Fetch organizations
+			const orgs = await tui.spinner({
+				message: 'Fetching organizations...',
+				clearOnSuccess: true,
+				callback: () => listOrganizations(apiClient),
+			});
+
+			if (orgs.length === 0) {
+				tui.fatal('No organizations found for your account');
+			}
+
+			// Check GitHub status for each org
+			const orgStatuses = await tui.spinner({
+				message: 'Checking GitHub integration status...',
+				clearOnSuccess: true,
+				callback: async () => {
+					const statuses = await Promise.all(
+						orgs.map(async (org) => {
+							const status = await getGithubIntegrationStatus(apiClient, org.id);
+							return {
+								...org,
+								connected: status.connected,
+								integrations: status.integrations,
+							};
+						})
+					);
+					return statuses;
+				},
+			});
+
+			// Flatten all integrations across orgs
+			const allIntegrations: Array<{
+				orgId: string;
+				orgName: string;
+				integration: GithubIntegration;
+			}> = [];
+
+			for (const org of orgStatuses) {
+				for (const integration of org.integrations) {
+					allIntegrations.push({
+						orgId: org.id,
+						orgName: org.name,
+						integration,
+					});
+				}
+			}
+
+			if (allIntegrations.length === 0) {
+				if (!options.json) {
+					tui.newline();
+					tui.info('No GitHub accounts are connected.');
+				}
+				return { removed: false };
+			}
+
+			// Build choices showing GitHub account and org
+			const choices = allIntegrations.map((item) => ({
+				name: `${tui.bold(item.integration.githubAccountName)} ${tui.muted(`(${item.integration.githubAccountType})`)} → ${tui.bold(item.orgName)}`,
+				value: `${item.orgId}:${item.integration.id}`,
+			}));
+
+			// Show picker
+			const response = await enquirer.prompt<{ selection: string }>({
+				type: 'select',
+				name: 'selection',
+				message: 'Select a GitHub account to remove',
+				choices,
+				result(name: string) {
+					// Return the value (IDs) instead of the display name
+					const choice = choices.find((c) => c.name === name);
+					return choice?.value ?? name;
+				},
+			});
+
+			const colonIdx = response.selection.indexOf(':');
+			if (colonIdx === -1) {
+				logger.fatal('Invalid selection format');
+			}
+			const orgId = response.selection.slice(0, colonIdx);
+			const integrationId = response.selection.slice(colonIdx + 1);
+			const selected = allIntegrations.find(
+				(i) => i.orgId === orgId && i.integration.id === integrationId
+			);
+			const displayName = selected
+				? `${tui.bold(selected.integration.githubAccountName)} from ${tui.bold(selected.orgName)}`
+				: response.selection;
+
+			// Confirm
+			if (!opts.confirm) {
+				const confirmed = await tui.confirm(`Are you sure you want to remove ${displayName}?`);
+
+				if (!confirmed) {
+					tui.newline();
+					tui.info('Cancelled');
+					return { removed: false };
+				}
+			}
+
+			await tui.spinner({
+				message: 'Removing GitHub account...',
+				clearOnSuccess: true,
+				callback: () => disconnectGithubIntegration(apiClient, orgId, integrationId),
+			});
+
+			if (!options.json) {
+				tui.newline();
+				tui.success(`Removed ${displayName}`);
+			}
+
+			return { removed: true, orgId, integrationId };
+		} catch (error) {
+			// Handle user cancellation (Ctrl+C)
+			const isCancel =
+				error === '' ||
+				(error instanceof Error &&
+					(error.message === '' || error.message === 'User cancelled'));
+
+			if (isCancel) {
+				tui.newline();
+				tui.info('Cancelled');
+				return { removed: false };
+			}
+
+			logger.trace(error);
+			return logger.fatal(
+				'Failed to remove GitHub account: %s',
+				error,
+				ErrorCode.INTEGRATION_FAILED
+			);
+		}
+	},
+});

package/src/cmd/git/index.ts

@@ -0,0 +1,20 @@
+import { createCommand } from '../../types';
+import { accountCommand } from './account';
+import { linkSubcommand } from './link';
+import { listSubcommand } from './list';
+import { unlinkSubcommand } from './unlink';
+import { statusSubcommand } from './status';
+
+export const gitCommand = createCommand({
+	name: 'git',
+	description: 'Manage GitHub integration and repository connections',
+	subcommands: [
+		accountCommand,
+		linkSubcommand,
+		listSubcommand,
+		unlinkSubcommand,
+		statusSubcommand,
+	],
+});
+
+export default gitCommand;