gitpadi 2.0.7 → 2.1.2

package/src/commands/drips.ts

@@ -0,0 +1,408 @@
+// commands/drips.ts — Apply for bounty issues on Drips Network from your terminal
+//
+// API reverse-engineered from https://github.com/drips-network/app
+// Base: https://wave-api.drips.network
+// Auth: GitHub OAuth → JWT cookie (wave_access_token)
+
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import os from 'node:os';
+
+const DRIPS_API = 'https://wave-api.drips.network';
+const DRIPS_WEB = 'https://www.drips.network';
+const CONFIG_DIR = path.join(os.homedir(), '.gitpadi');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+const dim = chalk.dim;
+const cyan = chalk.cyanBright;
+const yellow = chalk.yellowBright;
+const green = chalk.greenBright;
+const bold = chalk.bold;
+const red = chalk.redBright;
+
+// ── Types ─────────────────────────────────────────────────────────────────────
+
+interface DripsIssue {
+    id: string;
+    title: string;
+    state: string;
+    points: number | null;
+    complexity: string | null;
+    labels: Array<{ id: string; name: string }>;
+    repo: { name: string; fullName: string; url: string } | null;
+    assignedApplicant: any | null;
+    pendingApplicationsCount: number;
+    waveProgramId: string | null;
+    gitHubIssueUrl: string | null;
+    gitHubIssueNumber: number | null;
+    updatedAt: string;
+}
+
+interface DripsPagination {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}
+
+interface DripsProgram {
+    id: string;
+    name: string;
+    slug: string;
+    description: string;
+    issueCount: number;
+    approvedRepoCount: number;
+    presetBudgetUSD: string;
+}
+
+// ── Config ────────────────────────────────────────────────────────────────────
+
+function loadConfig(): Record<string, any> {
+    if (!fs.existsSync(CONFIG_FILE)) return {};
+    try { return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8')); } catch { return {}; }
+}
+
+function saveDripsToken(token: string): void {
+    const current = loadConfig();
+    if (!fs.existsSync(CONFIG_DIR)) fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify({ ...current, dripsToken: token }, null, 2));
+}
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function truncate(text: string, max: number): string {
+    return text.length <= max ? text : text.slice(0, max - 1) + '…';
+}
+
+function diffDays(dateStr: string): number {
+    return Math.floor((Date.now() - new Date(dateStr).getTime()) / 86_400_000);
+}
+
+function openBrowser(url: string): void {
+    try {
+        if (process.platform === 'darwin') execSync(`open "${url}"`, { stdio: 'ignore' });
+        else if (process.platform === 'win32') execSync(`start "" "${url}"`, { stdio: 'ignore' });
+        else execSync(`xdg-open "${url}"`, { stdio: 'ignore' });
+    } catch { /* ignore */ }
+}
+
+function parseSlug(input: string): string {
+    const m = input.match(/drips\.network\/wave\/([^/?#\s]+)/);
+    if (m) return m[1];
+    return input.replace(/^\/+|\/+$/g, '').split('/').pop() || input;
+}
+
+// ── API ───────────────────────────────────────────────────────────────────────
+
+async function dripsGet(endpoint: string, token?: string): Promise<any> {
+    const headers: Record<string, string> = { Accept: 'application/json' };
+    if (token) headers['Cookie'] = `wave_access_token=${token}`;
+    const res = await fetch(`${DRIPS_API}${endpoint}`, { headers });
+    if (!res.ok) throw new Error(`Drips API ${res.status} on ${endpoint}`);
+    return res.json();
+}
+
+async function dripsPost(endpoint: string, body: any, token: string): Promise<any> {
+    const res = await fetch(`${DRIPS_API}${endpoint}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+            Cookie: `wave_access_token=${token}`,
+        },
+        body: JSON.stringify(body),
+    });
+    const text = await res.text();
+    if (!res.ok) {
+        let msg = text;
+        try { msg = JSON.parse(text)?.message || text; } catch { }
+        throw new Error(`${res.status}: ${msg}`);
+    }
+    try { return JSON.parse(text); } catch { return {}; }
+}
+
+// ── Auth ──────────────────────────────────────────────────────────────────────
+
+export async function ensureDripsAuth(): Promise<string> {
+    const config = loadConfig();
+
+    if (config.dripsToken) {
+        // Validate by hitting a quota endpoint that requires auth
+        try {
+            const res = await fetch(
+                `${DRIPS_API}/api/wave-programs/fdc01c95-806f-4b6a-998b-a6ed37e0d81b/quotas/applications`,
+                { headers: { Cookie: `wave_access_token=${config.dripsToken}`, Accept: 'application/json' } }
+            );
+            if (res.status !== 401) return config.dripsToken as string;
+        } catch { /* network issue, let user try anyway */ }
+    }
+
+    // Show how-to instructions
+    console.log();
+    console.log(dim('  ┌─ Connect your Drips Network account ────────────────────────┐'));
+    console.log(dim('  │'));
+    console.log(dim('  │  Drips uses GitHub OAuth. Here\'s how to get your token:'));
+    console.log(dim('  │'));
+    console.log(dim('  │  1. Log in at: ') + cyan(DRIPS_WEB + '/wave/login'));
+    console.log(dim('  │     (GitPadi will open it in your browser now)'));
+    console.log(dim('  │'));
+    console.log(dim('  │  2. After logging in with GitHub, open DevTools:'));
+    console.log(dim('  │     ') + bold('F12') + dim(' (or Cmd+Option+I on Mac)'));
+    console.log(dim('  │     → ') + bold('Application') + dim(' tab'));
+    console.log(dim('  │     → ') + bold('Cookies') + dim(' → ') + cyan('www.drips.network'));
+    console.log(dim('  │'));
+    console.log(dim('  │  3. Find the cookie named ') + yellow('wave_access_token'));
+    console.log(dim('  │     Copy the full value (it starts with ') + dim('eyJ...') + dim(')'));
+    console.log(dim('  │'));
+    console.log(dim('  │  GitPadi saves it once — you won\'t need to do this again.'));
+    console.log(dim('  │'));
+    console.log(dim('  └─────────────────────────────────────────────────────────────┘'));
+    console.log();
+
+    const { launch } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'launch',
+        message: 'Open drips.network login in your browser?',
+        default: true,
+    }]);
+
+    if (launch) {
+        openBrowser(`${DRIPS_WEB}/wave/login?skipWelcome=false`);
+        console.log(dim('\n  Browser opened. Log in with GitHub, then come back here.\n'));
+    } else {
+        console.log(dim(`\n  Open manually: ${cyan(DRIPS_WEB + '/wave/login')}\n`));
+    }
+
+    const { token } = await inquirer.prompt([{
+        type: 'password',
+        name: 'token',
+        message: cyan('Paste your wave_access_token cookie value:'),
+        mask: '•',
+        validate: (v: string) => {
+            if (!v || v.trim().length < 20) return 'Token seems too short — copy the full value from DevTools';
+            if (!v.trim().startsWith('eyJ')) return 'Expected a JWT starting with eyJ — make sure you copied wave_access_token, not another cookie';
+            return true;
+        },
+    }]);
+
+    const t = token.trim();
+    saveDripsToken(t);
+    console.log(green('\n  ✅ Drips session saved — you\'re all set!\n'));
+    return t;
+}
+
+// ── Program lookup ────────────────────────────────────────────────────────────
+
+async function getWaveProgram(slug: string): Promise<DripsProgram> {
+    const data = await dripsGet(`/api/wave-programs?slug=${encodeURIComponent(slug)}`);
+    if (data?.id) return data as DripsProgram;
+    if (Array.isArray(data?.data) && data.data.length > 0) return data.data[0] as DripsProgram;
+    throw new Error(`Wave program "${slug}" not found. Check the slug or URL.`);
+}
+
+// ── Issues ────────────────────────────────────────────────────────────────────
+
+async function getIssues(
+    programId: string,
+    page: number,
+): Promise<{ data: DripsIssue[]; pagination: DripsPagination }> {
+    return dripsGet(
+        `/api/issues?waveProgramId=${programId}&state=open&page=${page}&limit=20&sortBy=updatedAt`,
+    );
+}
+
+// ── Main menu ─────────────────────────────────────────────────────────────────
+
+export async function dripsMenu(): Promise<void> {
+    console.log();
+    console.log(bold('  Drips Network — Apply for bounty issues from your terminal'));
+    console.log(dim('  Browse issues from any Wave program and apply in seconds.'));
+    console.log();
+
+    const { input } = await inquirer.prompt([{
+        type: 'input',
+        name: 'input',
+        message: bold('Enter Drips Wave URL or program slug:'),
+        default: 'stellar',
+        validate: (v: string) => v.trim().length > 0 || 'Required',
+    }]);
+
+    const slug = parseSlug(input.trim());
+
+    const progSpinner = ora(dim(`  Loading "${slug}" wave program…`)).start();
+    let program: DripsProgram;
+    try {
+        program = await getWaveProgram(slug);
+        progSpinner.succeed(
+            `  ${bold(program.name)} · ${cyan(program.issueCount.toLocaleString() + ' open issues')} · ${green(program.presetBudgetUSD + '/mo')} · ${dim(program.approvedRepoCount + ' repos')}`
+        );
+    } catch (e: any) {
+        progSpinner.fail(`  ${e.message}`);
+        return;
+    }
+
+    let page = 1;
+
+    while (true) {
+        const issSpinner = ora(dim(`  Fetching issues (page ${page})…`)).start();
+        let issues: DripsIssue[];
+        let pagination: DripsPagination;
+        try {
+            const res = await getIssues(program.id, page);
+            issues = res.data;
+            pagination = res.pagination;
+            issSpinner.succeed(
+                `  Showing ${((page - 1) * 20) + 1}–${Math.min(page * 20, pagination.total)} of ${pagination.total.toLocaleString()} open issues`
+            );
+        } catch (e: any) {
+            issSpinner.fail(`  ${e.message}`);
+            return;
+        }
+
+        console.log();
+
+        const choices = issues.map((issue) => {
+            const age = diffDays(issue.updatedAt);
+            const ageStr = age === 0 ? dim('today') : dim(`${age}d ago`);
+            const pts = issue.points ? green(`+${issue.points}pts`) : dim(' — pts');
+            const applicants = issue.pendingApplicationsCount > 0
+                ? yellow(`${issue.pendingApplicationsCount} applied`)
+                : dim('0 applied');
+            const taken = issue.assignedApplicant ? red(' [assigned]') : '';
+            const title = truncate(issue.title, 48);
+            return {
+                name: `  ${pts}  ${bold(title)}  ${applicants}${taken}  ${ageStr}`,
+                value: issue,
+                short: issue.title,
+            };
+        });
+
+        const nav: any[] = [
+            new inquirer.Separator(dim('  ─────────────────────────────────────────────────────')),
+        ];
+        if (pagination.hasNextPage) nav.push({ name: `  ${dim('→  Next page')}`, value: '__next__' });
+        if (page > 1) nav.push({ name: `  ${dim('←  Previous page')}`, value: '__prev__' });
+        nav.push({ name: `  ${dim('⬅  Back')}`, value: '__back__' });
+
+        const { selected } = await inquirer.prompt([{
+            type: 'list',
+            name: 'selected',
+            message: bold(`${program.name} Wave — choose an issue to apply for:`),
+            choices: [...choices, ...nav],
+            pageSize: 18,
+        }]);
+
+        if (selected === '__back__') return;
+        if (selected === '__next__') { page++; continue; }
+        if (selected === '__prev__') { page = Math.max(1, page - 1); continue; }
+
+        await applyToDripsIssue(program, selected as DripsIssue);
+    }
+}
+
+// ── Apply ─────────────────────────────────────────────────────────────────────
+
+async function applyToDripsIssue(program: DripsProgram, issue: DripsIssue): Promise<void> {
+    console.log();
+    console.log(`  ${bold(cyan(truncate(issue.title, 72)))}`);
+    if (issue.repo) console.log(`  ${dim('Repo:    ')} ${issue.repo.fullName}`);
+    console.log(`  ${dim('Points:  ')} ${issue.points ? green('+' + issue.points + ' pts') : dim('—')}`);
+    console.log(`  ${dim('Applied: ')} ${issue.pendingApplicationsCount} applicant(s)`);
+    if (issue.assignedApplicant) {
+        console.log(`  ${yellow('⚠  Already assigned — you can still apply as a backup')}`);
+    }
+    if (issue.gitHubIssueUrl) {
+        console.log(`  ${dim('GitHub:  ')} ${dim(issue.gitHubIssueUrl)}`);
+    }
+    console.log();
+
+    const { style } = await inquirer.prompt([{
+        type: 'list',
+        name: 'style',
+        message: bold('How would you like to apply?'),
+        choices: [
+            { name: `  ${green('⚡')}  Quick apply — standard intro message`, value: 'quick' },
+            { name: `  ${cyan('📝')}  Custom message — write your own`, value: 'custom' },
+            new inquirer.Separator(dim('  ─────────────────────────────────')),
+            { name: `  ${dim('⬅  Cancel')}`, value: 'cancel' },
+        ],
+    }]);
+
+    if (style === 'cancel') return;
+
+    let applicationText: string;
+
+    if (style === 'quick') {
+        applicationText = [
+            `Hi! I'd like to work on this issue.`,
+            ``,
+            `I'm available to start right away and will keep you updated on progress. Please consider assigning this to me.`,
+            ``,
+            `*Applied via [GitPadi](https://github.com/Netwalls/contributor-agent)*`,
+        ].join('\n');
+    } else {
+        const { msg } = await inquirer.prompt([{
+            type: 'input',
+            name: 'msg',
+            message: bold('Your application message (min 10 chars):'),
+            validate: (v: string) => v.trim().length >= 10 || 'Please write at least 10 characters',
+        }]);
+        applicationText = [
+            msg.trim(),
+            ``,
+            `*Applied via [GitPadi](https://github.com/Netwalls/contributor-agent)*`,
+        ].join('\n');
+    }
+
+    // Preview
+    console.log();
+    console.log(dim('  ── Preview ───────────────────────────────────────────────────'));
+    applicationText.split('\n').forEach(l => console.log(`  ${dim(l)}`));
+    console.log(dim('  ──────────────────────────────────────────────────────────────'));
+    console.log();
+
+    const { confirm } = await inquirer.prompt([{
+        type: 'list',
+        name: 'confirm',
+        message: bold('Submit this application?'),
+        choices: [
+            { name: `  ${green('✅  Yes, apply')}`, value: 'yes' },
+            { name: `  ${dim('❌  Cancel')}`, value: 'no' },
+        ],
+    }]);
+
+    if (confirm === 'no') return;
+
+    // Ensure auth only when the user actually commits to applying
+    let token: string;
+    try {
+        token = await ensureDripsAuth();
+    } catch {
+        console.log(red('\n  Authentication cancelled.\n'));
+        return;
+    }
+
+    const spinner = ora('  Submitting application…').start();
+    try {
+        await dripsPost(
+            `/api/wave-programs/${program.id}/issues/${issue.id}/applications`,
+            { applicationText },
+            token,
+        );
+        spinner.succeed(green(`  Applied for: ${bold(issue.title)}`));
+        console.log(dim(`\n  Track your applications:`));
+        console.log(dim(`  ${cyan(DRIPS_WEB + '/wave/' + program.slug)}\n`));
+    } catch (e: any) {
+        spinner.fail(red(`  Failed: ${e.message}`));
+        if (e.message.startsWith('401')) {
+            saveDripsToken('');
+            console.log(yellow('\n  Session expired — run again to re-authenticate.\n'));
+        }
+    }
+}

package/src/commands/gitlab-issues.ts

@@ -0,0 +1,87 @@
+// commands/gitlab-issues.ts — GitLab issue management for GitPadi
+
+import chalk from 'chalk';
+import ora from 'ora';
+import Table from 'cli-table3';
+import {
+    getNamespace, getProject, getFullProject, requireGitLabProject,
+    listGitLabIssues, createGitLabIssue, updateGitLabIssue, createGitLabIssueNote,
+    withGitLabRetry,
+} from '../core/gitlab.js';
+
+export async function listIssues(opts: { state?: string; limit?: number } = {}) {
+    requireGitLabProject();
+    const spinner = ora(`Fetching issues from ${chalk.cyan(getFullProject())}...`).start();
+    try {
+        const state = (opts.state === 'closed' ? 'closed' : opts.state === 'all' ? 'all' : 'opened') as 'opened' | 'closed' | 'all';
+        const issues = await withGitLabRetry(() =>
+            listGitLabIssues(getNamespace(), getProject(), { state, per_page: opts.limit || 50 })
+        );
+        spinner.stop();
+
+        if (!issues.length) { console.log(chalk.yellow('\n  No issues found.\n')); return; }
+
+        const table = new Table({
+            head: ['#', 'Title', 'Author', 'State', 'Labels'].map(h => chalk.cyan(h)),
+            style: { head: [], border: [] },
+        });
+
+        issues.forEach(issue => {
+            const stateLabel = issue.state === 'opened' ? chalk.green('open') : chalk.red('closed');
+            table.push([
+                `#${issue.iid}`,
+                issue.title.substring(0, 50),
+                `@${issue.author.username}`,
+                stateLabel,
+                issue.labels.slice(0, 3).join(', ') || '-',
+            ]);
+        });
+
+        console.log(`\n${chalk.bold(`📋 Issues — ${getFullProject()}`)} (${issues.length})\n`);
+        console.log(table.toString());
+        console.log('');
+    } catch (e: any) { spinner.fail(e.message); }
+}
+
+export async function createIssue(opts: { title: string; description?: string; labels?: string }) {
+    requireGitLabProject();
+    const spinner = ora('Creating issue...').start();
+    try {
+        const issue = await withGitLabRetry(() =>
+            createGitLabIssue(getNamespace(), getProject(), {
+                title: opts.title,
+                description: opts.description,
+                labels: opts.labels,
+            })
+        );
+        spinner.succeed(`Created issue ${chalk.green(`#${issue.iid}`)}: ${issue.title}`);
+        console.log(chalk.dim(`  ${issue.web_url}\n`));
+    } catch (e: any) { spinner.fail(e.message); }
+}
+
+export async function closeIssue(iid: number) {
+    requireGitLabProject();
+    const spinner = ora(`Closing issue #${iid}...`).start();
+    try {
+        await withGitLabRetry(() => updateGitLabIssue(getNamespace(), getProject(), iid, { state_event: 'close' }));
+        spinner.succeed(`Closed issue ${chalk.red(`#${iid}`)}`);
+    } catch (e: any) { spinner.fail(e.message); }
+}
+
+export async function reopenIssue(iid: number) {
+    requireGitLabProject();
+    const spinner = ora(`Reopening issue #${iid}...`).start();
+    try {
+        await withGitLabRetry(() => updateGitLabIssue(getNamespace(), getProject(), iid, { state_event: 'reopen' }));
+        spinner.succeed(`Reopened issue ${chalk.green(`#${iid}`)}`);
+    } catch (e: any) { spinner.fail(e.message); }
+}
+
+export async function commentOnIssue(iid: number, body: string) {
+    requireGitLabProject();
+    const spinner = ora(`Posting comment on issue #${iid}...`).start();
+    try {
+        await withGitLabRetry(() => createGitLabIssueNote(getNamespace(), getProject(), iid, body));
+        spinner.succeed(`Comment posted on issue #${iid}`);
+    } catch (e: any) { spinner.fail(e.message); }
+}

package/src/commands/gitlab-mrs.ts

@@ -0,0 +1,185 @@
+// commands/gitlab-mrs.ts — GitLab Merge Request management for GitPadi
+
+import chalk from 'chalk';
+import ora from 'ora';
+import Table from 'cli-table3';
+import {
+    getNamespace, getProject, getFullProject, requireGitLabProject,
+    listGitLabMRs, getGitLabMR, createGitLabMR, mergeGitLabMR, updateGitLabMR,
+    listGitLabMRChanges, listGitLabMRNotes, createGitLabMRNote, updateGitLabMRNote,
+    getGitLabMRPipelineStatus, withGitLabRetry,
+} from '../core/gitlab.js';
+
+export async function listMRs(opts: { state?: string; limit?: number } = {}) {
+    requireGitLabProject();
+    const spinner = ora(`Fetching MRs from ${chalk.cyan(getFullProject())}...`).start();
+    try {
+        const state = (['opened', 'closed', 'merged', 'all'].includes(opts.state || '')
+            ? opts.state : 'opened') as 'opened' | 'closed' | 'merged' | 'all';
+
+        const mrs = await withGitLabRetry(() =>
+            listGitLabMRs(getNamespace(), getProject(), { state, per_page: opts.limit || 50 })
+        );
+        spinner.stop();
+
+        if (!mrs.length) { console.log(chalk.yellow('\n  No merge requests found.\n')); return; }
+
+        const table = new Table({
+            head: ['#', 'Title', 'Author', 'Branch', 'State'].map(h => chalk.cyan(h)),
+            style: { head: [], border: [] },
+        });
+
+        mrs.forEach(mr => {
+            const stateLabel = mr.state === 'opened' ? chalk.green('open')
+                : mr.state === 'merged' ? chalk.magenta('merged') : chalk.red(mr.state);
+            table.push([
+                `!${mr.iid}`,
+                mr.title.substring(0, 50),
+                `@${mr.author.username}`,
+                mr.source_branch.substring(0, 25),
+                stateLabel,
+            ]);
+        });
+
+        console.log(`\n${chalk.bold(`🔀 Merge Requests — ${getFullProject()}`)} (${mrs.length})\n`);
+        console.log(table.toString());
+        console.log('');
+    } catch (e: any) { spinner.fail(e.message); }
+}
+
+export async function mergeMR(iid: number, opts: { squash?: boolean; message?: string; force?: boolean } = {}) {
+    requireGitLabProject();
+
+    if (opts.force) {
+        const spinner = ora(`Force merging MR !${iid}...`).start();
+        try {
+            const result = await withGitLabRetry(() =>
+                mergeGitLabMR(getNamespace(), getProject(), iid, { squash: opts.squash ?? true, message: opts.message })
+            );
+            spinner.succeed(`Force merged MR ${chalk.green(`!${iid}`)} ${chalk.yellow('(CI skipped)')}`);
+            console.log(chalk.dim(`  SHA: ${result.sha}\n`));
+        } catch (e: any) { spinner.fail(e.message); }
+        return;
+    }
+
+    const spinner = ora(`Checking CI status for MR !${iid}...`).start();
+    try {
+        // Poll up to 15 min (90 × 10s)
+        let attempts = 0;
+        const maxAttempts = 90;
+        let ciStatus: string | null = null;
+
+        while (attempts < maxAttempts) {
+            const pipeline = await withGitLabRetry(() => getGitLabMRPipelineStatus(getNamespace(), getProject(), iid));
+
+            if (!pipeline) {
+                spinner.info(chalk.dim('No CI pipeline found — proceeding without check.'));
+                break;
+            }
+
+            ciStatus = pipeline.status;
+
+            if (['success', 'failed', 'canceled', 'skipped'].includes(ciStatus)) break;
+
+            spinner.text = chalk.dim(`Pipeline ${ciStatus}... (${attempts * 10}s elapsed)`);
+            await new Promise(r => setTimeout(r, 10000));
+            attempts++;
+        }
+
+        spinner.stop();
+
+        if (ciStatus === 'failed' || ciStatus === 'canceled') {
+            console.log(chalk.red(`  ❌ Pipeline ${ciStatus} — merge blocked. Fix the pipeline and retry.\n`));
+            return;
+        }
+        if (attempts >= maxAttempts) {
+            console.log(chalk.yellow(`  ⚠️  Pipeline still running after 15 min. Try again later.\n`));
+            return;
+        }
+        if (ciStatus === 'success') {
+            console.log(chalk.green(`  ✅ Pipeline passed!\n`));
+        }
+
+        const mergeSpinner = ora(`Merging MR !${iid}...`).start();
+        const result = await withGitLabRetry(() =>
+            mergeGitLabMR(getNamespace(), getProject(), iid, { squash: opts.squash ?? true, message: opts.message })
+        );
+        mergeSpinner.succeed(`Merged MR ${chalk.green(`!${iid}`)}`);
+        console.log(chalk.dim(`  SHA: ${result.sha}\n`));
+    } catch (e: any) { spinner.fail(e.message); }
+}
+
+export async function closeMR(iid: number) {
+    requireGitLabProject();
+    const spinner = ora(`Closing MR !${iid}...`).start();
+    try {
+        await withGitLabRetry(() => updateGitLabMR(getNamespace(), getProject(), iid, { state_event: 'close' }));
+        spinner.succeed(`Closed MR ${chalk.red(`!${iid}`)}`);
+    } catch (e: any) { spinner.fail(e.message); }
+}
+
+export async function reviewMR(iid: number) {
+    requireGitLabProject();
+    const spinner = ora(`Reviewing MR !${iid}...`).start();
+    try {
+        const mr = await withGitLabRetry(() => getGitLabMR(getNamespace(), getProject(), iid));
+        const changes = await withGitLabRetry(() => listGitLabMRChanges(getNamespace(), getProject(), iid));
+        spinner.stop();
+
+        console.log(`\n${chalk.bold(`🔍 MR Review — !${iid}: ${mr.title}`)}`);
+        console.log(chalk.dim(`  Author: @${mr.author.username}  Branch: ${mr.source_branch} → ${mr.target_branch}\n`));
+
+        const checks: Array<{ name: string; icon: string; detail: string }> = [];
+
+        // Linked issues
+        const linked = mr.description?.match(/(fix(es|ed)?|clos(e[sd]?)|resolv(e[sd]?))\s+#\d+/gi) || [];
+        checks.push({ name: 'Linked Issues', icon: linked.length ? '✅' : '⚠️', detail: linked.length ? linked.join(', ') : 'None found — use "Fixes #N"' });
+
+        // Size
+        const totalLines = changes.reduce((sum, f) => {
+            const adds = (f.diff.match(/^\+/gm) || []).length;
+            const dels = (f.diff.match(/^-/gm) || []).length;
+            return sum + adds + dels;
+        }, 0);
+        checks.push({ name: 'MR Size', icon: totalLines > 1000 ? '❌' : totalLines > 500 ? '⚠️' : '✅', detail: `~${totalLines} lines changed (${changes.length} files)` });
+
+        // Tests
+        const srcFiles = changes.filter(f => !f.new_path.includes('test') && !f.new_path.includes('spec') && /\.(ts|rs|js|py)$/.test(f.new_path));
+        const testFiles = changes.filter(f => f.new_path.includes('test') || f.new_path.includes('spec'));
+        checks.push({ name: 'Tests', icon: srcFiles.length > 0 && testFiles.length === 0 ? '⚠️' : '✅', detail: `${testFiles.length} test file(s), ${srcFiles.length} source file(s)` });
+
+        // Sensitive files
+        const sensitive = changes.filter(f => /(\.env|secret|credential|password|\.key|\.pem)/i.test(f.new_path));
+        checks.push({ name: 'Security', icon: sensitive.length ? '❌' : '✅', detail: sensitive.length ? `Flagged: ${sensitive.map(f => f.new_path).join(', ')}` : 'Clean' });
+
+        // Draft
+        checks.push({ name: 'Draft Status', icon: mr.draft ? '⚠️' : '✅', detail: mr.draft ? 'MR is a draft — not ready to merge' : 'Ready for review' });
+
+        checks.forEach(c => console.log(`  ${c.icon}  ${chalk.bold(c.name)}: ${c.detail}`));
+        console.log('');
+    } catch (e: any) { spinner.fail(e.message); }
+}
+
+export async function diffMR(iid: number) {
+    requireGitLabProject();
+    const spinner = ora(`Fetching diff for MR !${iid}...`).start();
+    try {
+        const changes = await withGitLabRetry(() => listGitLabMRChanges(getNamespace(), getProject(), iid));
+        spinner.stop();
+
+        console.log(`\n${chalk.bold(`📄 MR !${iid} — Changed Files`)} (${changes.length})\n`);
+
+        const table = new Table({
+            head: ['File', 'Status'].map(h => chalk.cyan(h)),
+            style: { head: [], border: [] },
+        });
+
+        changes.forEach(f => {
+            const status = f.new_file ? chalk.green('added') : f.deleted_file ? chalk.red('removed') : chalk.yellow('modified');
+            table.push([f.new_path.substring(0, 70), status]);
+        });
+
+        console.log(table.toString());
+        console.log('');
+    } catch (e: any) { spinner.fail(e.message); }
+}